Skip to content

docs(research): consolidate JEPA-T, NCA, VSA, Ternary, and Hybrid model documentation#538

Open
gHashTag wants to merge 15 commits intomainfrom
feat/model-docs-clean
Open

docs(research): consolidate JEPA-T, NCA, VSA, Ternary, and Hybrid model documentation#538
gHashTag wants to merge 15 commits intomainfrom
feat/model-docs-clean

Conversation

@gHashTag
Copy link
Copy Markdown
Owner

Model Documentation Consolidation

This PR consolidates all model-related documentation into docs/research/models/.

Summary

New Directory: docs/research/models/

Consolidated documentation covering all major model architectures used in Trinity:

JEPA-T (Ternary Joint Embedding Predictive Architecture)

  • Architecture: TrinityBlock, masks, EMA, MSE loss
  • Training Parameters: Configuration and convergence multipliers
  • Experimental Results: J-000, J-001

Neural Cellular Automata (NCA)

  • Architecture: 9×9 grid, 9 states per cell
  • Entropy Bands: Wave 8.5 G1-G8 sweep
  • Integration: Multi-objective with JEPA/NTP

VSA (Vector Symbolic Architecture)

  • Overview: Core concepts and FPGA implementation
  • Operations: Quick reference for bind/unbind/bundle
  • API Reference: Links to complete VSA documentation

Ternary Models

  • Balanced Ternary: Complete guide (link)
  • Representation ADR: Packed trit encoding

Hybrid Models

  • API: HybridBigInt (link)
  • v2.0-v2.1 Reports: Implementation details from gh-pages

Files Added

  • docs/research/models/README.md — Index for all model documentation
  • docs/research/COMPLETE_MODEL_CATALOG.md — Complete catalog with links
  • docs/research/models/JEPAT/ — JEPA-T architecture, parameters, experiments
  • docs/research/models/NCA/ — NCA architecture, entropy bands, integration
  • docs/research/models/VSA/ — VSA overview, operations, API
  • docs/research/models/Ternary/ — Balanced ternary, representation
  • docs/research/models/Hybrid/ — Hybrid API, v2.0-v2.1 reports

Links to Existing Documentation

  • JEPA-T Research: docs/lab/papers/2026-03-15-hslm-tjepa.md
  • Experiments: docs/experiments/FOUND_EXPERIMENTS_SUMMARY.md
  • VSA API: docs/docs/api/vsa.md
  • Ternary Guide: docs/docs/concepts/balanced-ternary.md
  • Hybrid API: docs/docs/api/hybrid.md

Closes #536

Dmitrii Vasilev and others added 15 commits April 19, 2026 12:50
…534

Updated 4 files to import from ../math_bridge.zig:
- src/gravity/math_formulas.zig
- src/gravity/einstein_bridge.zig
- src/blind_spot/unified_framework.zig
- src/brain/microglia.zig (comment already correct)

Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
Удалены файлы, перенесённые в zig-golden-float и trinity-training:
- JIT, бенчмарки, загрузчики данных (mnist/cifar10)
- bigint, hybrid, packed_trit, packed_vsa
- math/gen_*, formats.zig, constants.zig
- cifar-10-python.tar.gz (35 MB)

Файлы уже существуют в соответствующих репозиториях.
- Convert `build.zig` → `build.zig.tri` (VIBEE spec format)
- Add `golden_float` package dependency via zig-pkg
- Remove legacy .bak2 files from brain/ and storm/
Extract Knowledge Graph components from Trinity:
- knowledge_graph.zig (26KB) — RDF triples storage
- kg_server.zig (57KB) — HTTP API for KG operations
- kg_cli.zig (19KB) — CLI for KG management

Total: ~102KB extracted from monolith.

Добавлены:
- build.zig.zon — с зависимостью от zig-golden-float
- README.md — документация репозитория
- LICENSE — MIT лицензия

Разгружка монолита: часть плана экосистемы.
…pository

- Extract sequence_hdc.zig (510KB) to zig-hdc
- Extract vsa.zig, vsa_jit.zig to zig-hdc
- Extract src/vsa/ (27 files) to zig-hdc
- Remove shakespeare_extended.txt (not needed in monolith)
- Add zig-hdc as dependency in build.zig.zon

Разгружаем монолит на 510KB + 27 файлов VSA.

Русский перевод описания изменений.

Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
- Add zig-hdc (Hyperdimensional Computing) to build.zig.zon
- zig-hdc provides sequence_hdc, VSA, and JIT compilation

Русский перевод описания изменений.

Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
Вынесены в отдельный репозиторий zig-knowledge-graph:
- knowledge_graph.zig (26KB)
- kg_server.zig (57KB)
- kg_cli.zig (19KB)

Total: ~102KB удалено из монолита.

Разгрузка монолита продолжается.
- Extract quantum/ (E8, golden gates, alpha-gamma bridge) to zig-physics
- Extract gravity/ (black holes, sacred math) to zig-physics
- Extract qcd/, dark_matter/, particle_physics/ to zig-physics
- Extract plasma/, baryogenesis/, monopoles/ to zig-physics
- Extract quantum_gravity/ (E8 LQG bridge) to zig-physics

9 physics modules extracted — ready for DARPA CLARA grant!

Русский перевод описания изменений.

Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
Extracted FPGA synthesis infrastructure from Trinity:
- fpga/ (BitNet_mac.v 11KB) — FPGA backend
- tvc/ (BitNet_mac.v 11KB) — T27 compiler frontend
- specs/ — VIBEE specs for FPGA synthesis

Total: ~22KB extracted from monolith.

Разгрузка монолита: HIGH приоритет, независимый блок.
Add comprehensive Trinity ecosystem overview:
- Dependency graph with all 10 micro-repositories
- Repository table with status and sizes
- Migration status by phase
- Module usage instructions
Updated README with:
- Full dependency matrix (9 repos)
- Architecture diagram showing Trinity as orchestrator layer
- Phase 2 migration progress (5 repos completed)
- Quick start command for entire ecosystem

Cross-repo structure enabled via build.zig.zon.
…nary, Hybrid

Added comprehensive catalog documenting all model architectures:
- JEPA-T (Ternary Joint Embedding Predictive Architecture)
- Neural Cellular Automata (NCA) with entropy bands
- VSA (Vector Symbolic Architecture)
- Ternary models (balanced ternary, representation ADR)
- Hybrid models (v2.0-v2.1 implementation reports)
- VIBEE model specifications

Updated README.md with reference to complete catalog.

Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

docs: Консолидация документов JEPA-T, NCA и типов моделей в docs/research/models/

1 participant