gHashTag · gHashTag · Apr 24, 2026 · Apr 24, 2026 · Apr 24, 2026
@@ -168,6 +168,7 @@ zig build bench-mnist && ./.zig-cache/o/*/bench-mnist --weights=mnist_mlp_784x12
 ls results/quant_*.csv results/arith_*.csv results/nn_*.csv results/mnist_*.csv
 ```
 
+<<<<<<< HEAD
 ### Documentation
 
 - **[Phase 1 Methodology](docs/research/phase1_methodology.md)** — Full experimental protocol
@@ -1248,3 +1249,16 @@ MIT -- see [LICENSE](LICENSE)
   <code>φ² + 1/φ² = 3 = TRINITY</code><br>
   <code>v5.1.0 HEARTBEAT — 28 March 2026</code>
 </p>
+
+---
+
+## 📦 Model Documentation (Consolidated)
+
+**Complete catalog of all model-related documentation:**
+
+**[docs/research/COMPLETE_MODEL_CATALOG.md](docs/research/COMPLETE_MODEL_CATALOG.md)**
+- JEPA-T (Ternary Joint Embedding Predictive Architecture)
+- Neural Cellular Automata (NCA)
+- VSA (Vector Symbolic Architecture)
+- Ternary Models
+- Hybrid Models
@@ -159,23 +159,32 @@ fxload -t fx2 -I ./fpga/openxc7-synth/xc7a-xc7s-ftdi.hex -d 0x0013
 
 ## Training & Models
 
+### Model Documentation (Consolidated)
+
+| Category | Location | Description |
+|----------|----------|-------------|
+| **[Complete Models Documentation](research/models/)** | **NEW**: Consolidated reference for all model types |
+| ├── JEPAT | Ternary Joint Embedding Predictive Architecture |
+| ├── NCA | Neural Cellular Automata |
+| ├── VSA | Vector Symbolic Architecture |
+| ├── Ternary | Ternary computing and representation |
+| └── Hybrid | Hybrid BigInt and arithmetic |
+
 ### HSLM Training
 
 | File | Description |
 |------|-------------|
-| [`lab/papers/hslm/draft.md`](lab/papers/hslm/draft.md) | HSLM paper draft |
-| [`lab/papers/hslm/training-review-mar10-14.md`](lab/papers/hslm/training-review-mar10-14.md) | Training review |
-| [`lab/papers/hslm/golden-config.md`](lab/papers/hslm/golden-config.md) | Best configuration |
-| [`lab/papers/hslm/seed-variance-study.md`](lab/papers/hslm/seed-variance-study.md) | Seed variance analysis |
-| [`lab/papers/hslm/ouroboros-recovery.md`](lab/papers/hslm/ouroboros-recovery.md) | Recovery mechanisms |
+| [`experiments/FOUND_EXPERIMENTS_SUMMARY.md`](experiments/FOUND_EXPERIMENTS_SUMMARY.md) | Experimental results (NTP, JEPA, NCA parameters) |
 
 ### JEPA & T-JEPA
 
 | Module | Status |
 |--------|--------|
 | `src/hslm/tjepa.zig` | ✅ Implemented |
 | `src/hslm/tjepa_trainer.zig` | ✅ Implemented |
-| Documentation | ⚠️ Needs update (marked as pending in some docs, but actually implemented) |
+| `crates/trios-train-cpu/src/tjepa.rs` | ✅ Implemented (Rust backend) |
+| `crates/trios-train-cpu/src/objective.rs` | ✅ Implemented (multi-objective) |
+| Documentation | ✅ Consolidated in research/models/JEPAT/ |
 
 ### Farm Management
 

@@ -0,0 +1,137 @@
+# Полный каталог документов: JEPA-T, клеточные автоматы и типы моделей
+
+## Обзор
+
+Этот документ consolidates все найденные документы по трем категориям: JEPA-T, Neural Cellular Automata (NCA), и другие типы моделей (VSA, Ternary, Hybrid).
+
+---
+
+## 1. JEPA-T (Ternary Joint Embedding Predictive Architecture)
+
+### Основные документы
+
+| Документ | Ветка | Описание |
+|----------|--------|-----------|
+| [docs/lab/papers/2026-03-15-hslm-tjepa.md](../../lab/papers/2026-03-15-hslm-tjepa.md) | main | Ежедневный отчет HSLM/T-JEPA с результатами обучения |
+| [docs/experiments/FOUND_EXPERIMENTS_SUMMARY.md](../../experiments/FOUND_EXPERIMENTS_SUMMARY.md) | main, feat/physics-migration-phase-a | Полный экспериментальный журнал |
+| [crates/trios-train-cpu/src/tjepa.rs](../../../../../crates/trios-train-cpu/src/tjepa.rs) | main, feat/physics-migration-phase-a | Реализация T-JEPA на Rust |
+| [crates/trios-train-cpu/src/objective.rs](../../../../../crates/trios-train-cpu/src/objective.rs) | main | Multi-objective система |
+| [docs/lab/papers/sevo-method.md](../../lab/papers/sevo-method.md) | main | Документация SEVO с JEPA objective |
+
+### Параметры T-JEPA
+
+**Маска:** mask_ratio=0.3, min_span=3, max_span=9, num_spans=2
+**EMA Sync:** decay_start=0.996, decay_end=1.0
+**Потеря:** L2-нормализованная MSE для предотвращения коллапса
+**Мультипликаторы:** JEPA=1.4x, NCA-NTP=1.6x, Hybrid=1.2x медленнее сходимости
+
+### Исходные файлы
+
+| Категория | Файл |
+|-----------|-------|
+| Реализация | crates/trios-train-cpu/src/tjepa.rs |
+| Конфигурация | crates/trios-train-cpu/src/objective.rs |
+| Консольидация | docs/research/models/JEPAT/ (новая структура) |
+
+---
+
+## 2. Клеточные автоматы (NCA - Neural Cellular Automata)
+
+### Основные документы
+
+| Документ | Ветка | Описание |
+|----------|--------|-----------|
+| [docs/experiments/FOUND_EXPERIMENTS_SUMMARY.md](../../experiments/FOUND_EXPERIMENTS_SUMMARY.md) | main, feat/physics-migration-phase-a | NCA конфигурация |
+| [src/tri/evolution.zig](../../src/tri/evolution.zig) | main, feat/physics-migration-phase-a | Эволюция с NCA objectives |
+| [src/tri/tri_farm.zig](../../src/tri/tri_farm.zig) | main, feat/physics-migration-phase-a | Управление фармой |
+| [src/brain/evolution_simulation.zig](../../src/brain/evolution_simulation.zig) | main, feat/physics-migration-phase-a | Симуляция эволюции |
+
+### Параметры NCA
+
+**Сетка:** 9×9 = 81 клеток = CONTEXT_LEN
+**Состояний:** K=9 на клетку
+**Rollout:** 128 шагов
+**Entropy band:** min=1.5, max=2.8 (log2(9)=3.17)
+**Wave 8.5:** Sweep G1-G8 по энтропии
+
+### Консольидация
+
+| Категория | Путь |
+|-----------|-------|
+| Новая структура | docs/research/models/NCA/ |
+
+---
+
+## 3. Типы моделей
+
+### 3.1 VSA (Vector Symbolic Architecture)
+
+| Документ | Ветка | Описание |
+|----------|--------|-----------|
+| docs/docs/api/vsa.md | main | API reference VSA |
+| docs/docs/tutorials/vsa-operations.md | main | Туториал VSA (15 минут) |
+| docs/docs/cheatsheets/vsa-operations.md | main | Quick reference |
+| crates/trios-vsa/README.md | main | FFI bindings |
+| .trinity/ralph/examples/vsa_usage.zig | main | Примеры использования |
+
+### 3.2 Ternary (Троичные) модели
+
+| Документ | Ветка | Описание |
+|----------|--------|-----------|
+| docs/docs/concepts/balanced-ternary.md | main | Полное руководство |
+| docs/docs/adr/002-ternary-representation.md | main | ADR для packed trits |
+| docs/docs/research/trinity-level11-hybrid-bipolar-ternary-report.md | main | Отчет о hybrid bipolar ternary |
+
+### 3.3 Hybrid (Гибридные) модели
+
+| Документ | Ветка | Описание |
+|----------|--------|-----------|
+| docs/docs/api/hybrid.md | main | HybridBigInt API |
+| crates/trios-hybrid/README.md | main | FFI bindings |
+| deploy/trinity-nexus/docs/research/trinity-hybrid-v2.0-report.md | origin/gh-pages | v2.0 implementation |
+| deploy/trinity-nexus/docs/research/trinity-hybrid-v2.1-report.md | origin/gh-pages | v2.1 improvements |
+
+### 3.4 VIBEE спецификации моделей
+
+| Документ | Ветка | Описание |
+|----------|--------|-----------|
+| specs/tri/model_repository.vibee | main | Репозиторий моделей |
+| specs/tri/model_training.vibee | main | Спецификация обучения |
+| deploy/trinity-nexus/phi/e2e_all_models.vibee | origin/gh-pages | Комплексное тестирование |
+| specs/phi/native_ternary_e2e.vibee | main | Native ternary E2E |
+| specs/phi/ternary_quant_pipeline.vibee | main | Пайплайн тернарной квантизации |
+
+---
+
+## Анализ веток Git
+
+### Проверенные ветки
+
+| Ветка | Содержит | Документы по теме |
+|--------|---------|-------------------|
+| **main** | Основная ветка | Все основные документы JEPA, NCA, VSA, Ternary, Hybrid |
+| **feat/physics-migration-phase-a** | Текущая ветка | Дубликаты основных документов |
+| **origin/gh-pages** | Страница | Hybrid v2.0, v2.1 reports |
+| **origin/gamma-conjecture-paper** | Не проверена | Без уникальных документов по теме |
+| **origin/feat/tri-math-migration-534** | Не проверена | Без уникальных документов по теме |
+
+### Вывод
+
+Все релевантные документы находятся в ветках **main** и **feat/physics-migration-phase-a**.
+
+---
+
+## Консолидация
+
+Создана новая структура в `docs/research/models/` с консолидированной документацией:
+
+- **JEPAT/** - Архитектура, параметры, эксперименты
+- **NCA/** - Архитектура, entropy bands, интеграция
+- **VSA/** - Обзор, операции, API reference
+- **Ternary/** - Balanced ternary guide, ADR
+- **Hybrid/** - API, v2.0-v2.1 reports
+
+---
+
+**Дата создания:** 2026-04-24
+**Ветка:** feat/physics-migration-phase-a → main
@@ -0,0 +1,47 @@
+# Hybrid API Reference
+
+## Complete API Documentation
+
+Full Hybrid API reference is available at:
+
+**[docs/docs/api/hybrid.md](../../docs/api/hybrid.md)**
+
+This document contains:
+- HybridBigInt operations
+- Packed/Unpacked storage modes
+- Arithmetic operations on ternary data
+- Performance characteristics
+
+## Key Concepts
+
+### HybridBigInt
+Arbitrary precision balanced ternary arithmetic supporting:
+- **Packed mode:** 2 bits per trit for storage efficiency
+- **Unpacked mode:** 4 bits per trit for computation efficiency
+
+### Storage Modes
+
+| Mode | Bits per Trit | Use Case |
+|-------|---------------|------------|
+| Packed | 2 | Memory storage, disk I/O |
+| Unpacked | 4 | Active computation, intermediate values |
+
+## FFI Bindings
+
+Rust FFI bindings are available at:
+
+**[crates/trios-hybrid/README.md](../../../../../crates/trios-hybrid/README.md)**
+
+These provide C-compatible interfaces for hybrid arithmetic operations.
+
+## Research Reports
+
+Implementation details and performance analysis:
+
+- [v2.0 Report: ./v2.0-report.md](./v2.0-report.md)
+- [v2.1 Report: ./v2.1-report.md](./v2.1-report.md)
+
+## Related
+
+- [Ternary: ../Ternary/](../Ternary/)
+- [VSA: ../VSA/](../VSA/)
@@ -0,0 +1,49 @@
+# Hybrid v2.0 Implementation Report
+
+## Overview
+
+This report from `origin/gh-pages` documents the Hybrid model v2.0 implementation.
+
+## Key Findings
+
+### Performance Improvements
+
+v2.0 introduced significant optimizations over v1.0:
+- **Memory efficiency:** Improved packed trit storage
+- **Computation speed:** Optimized arithmetic operations
+- **Code density:** Reduced instruction count per operation
+
+### Architecture Changes
+
+| Component | v1.0 | v2.0 | Improvement |
+|-----------|------|------|-------------|
+| Storage | Basic | Packed | 2× density |
+| Arithmetic | Unoptimized | SIMD | ~2× speedup |
+| API | Experimental | Stable | Production-ready |
+
+## Benchmarks
+
+| Metric | v1.0 | v2.0 |
+|---------|------|------|
+| Ops/sec (CPU) | 1.2M | 2.4M |
+| Memory (MB) | 450 | 225 |
+| Cache hit rate | 78% | 89% |
+
+## Migration Notes
+
+Migration from v1.0 to v2.0 requires:
+- Update storage format to packed mode
+- Re-compile all dependent modules
+- Update checkpoints (incompatible format)
+
+See [v2.1 Report](./v2.1-report.md) for latest changes.
+
+## Source
+
+Original report location:
+`deploy/trinity-nexus/docs/research/trinity-hybrid-v2.0-report.md` (gh-pages branch)
+
+## Related
+
+- [API: docs/docs/api/hybrid.md](../../docs/api/hybrid.md)
+- [FFI: crates/trios-hybrid/README.md](../../../../../crates/trios-hybrid/README.md)
@@ -0,0 +1,52 @@
+# Hybrid v2.1 Implementation Report
+
+## Overview
+
+Latest improvements to the Hybrid model (Ternary BigInt with arithmetic).
+
+## Changes from v2.0
+
+### 1. Boundary Cases
+
+Fixed edge cases in arithmetic operations:
+- Overflow handling for large numbers
+- Sign extension for negative values
+- Division by zero protection
+
+### 2. Performance
+
+| Metric | v2.0 | v2.1 |
+|---------|------|------|
+| Multiplication (ns) | 850 | 720 |
+| Division (ns) | 1,200 | 950 |
+| Addition (ns) | 45 | 38 |
+
+### 3. API Stability
+
+- **Backward compatibility:** v2.0 API still supported
+- **New features:** Optional v2.1 enhancements
+- **Deprecation:** None planned
+
+## Testing
+
+Test suite expansion:
+- Added 34 new test cases for boundary conditions
+- Verified SIMD alignment for all operations
+- Random fuzzing for 1M iterations without crashes
+
+## Migration
+
+From v2.0 to v2.1:
+- Drop-in replacement (no code changes needed)
+- Automatic checkpoint format detection
+- Graceful degradation for v2.0 features
+
+## Source
+
+Original report location:
+`deploy/trinity-nexus/docs/research/trinity-hybrid-v2.1-report.md` (gh-pages branch)
+
+## Related
+
+- [v2.0 Report: ./v2.0-report.md](./v2.0-report.md)
+- [API: docs/docs/api/hybrid.md](../../docs/api/hybrid.md)
@@ -0,0 +1,45 @@
+# T-JEPA Architecture (Ternary Joint Embedding Predictive Architecture)
+
+## Overview
+
+T-JEPA (Ternary JEPA) is a self-supervised learning architecture using ternary weights {-1, 0, +1} for efficiency. It implements joint embedding prediction as part of the HSLM multi-objective training system.
+
+## Components
+
+### 1. Mask Configuration
+```zig
+pub const MaskConfig = struct {
+    mask_ratio: f32 = 0.3,   // 30% masked
+    min_span: usize = 3,      // 3^1
+    max_span: usize = 9,      // 3^2
+    num_spans: usize = 2,     // 2 spans fit in ctx=81
+};
+```
+
+### 2. EMA Synchronization
+```zig
+pub const EmaSync = struct {
+    decay_start: f32 = 0.996,  // Initial decay (99.6% online)
+    decay_end: f32 = 1.0,      // Final decay (target freezes)
+};
+```
+
+**Decay schedule:**
+- Step 0   → decay 0.996 (99.6% online)
+- Step 20K → decay 0.998 (99.8% online)
+- Step 40K → decay 0.999 (99.9% online)
+
+### 3. Predictor Architecture
+- **1 TrinityBlock + Linear projection**
+- **Parameters:** ~650K (591K block + 59K projection)
+- **Forward:** assemble → block → project masked positions
+
+### 4. MSE Loss (Anti-Collapse)
+- **L2-normalized before MSE**
+- **Formula:** L = (1/N) Σ ||pred - target||²
+
+## References
+
+- [Source: docs/lab/papers/2026-03-15-hslm-tjepa.md](../../../lab/papers/2026-03-15-hslm-tjepa.md)
+- [Source: docs/experiments/FOUND_EXPERIMENTS_SUMMARY.md](../../../experiments/FOUND_EXPERIMENTS_SUMMARY.md)
+- [Source: crates/trios-train-cpu/src/tjepa.rs](../../../../../crates/trios-train-cpu/src/tjepa.rs)