Skip to content

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

Closed
gHashTag wants to merge 15 commits into
mainfrom
feat/model-docs-clean
Closed

gHashTag wants to merge 15 commits into
mainfrom
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

gHashTag 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>
@gHashTag

Copy link
Copy Markdown
Owner Author

Закрываю без мержа. Две причины, обе по существу:

  1. Объём: из затронутых файлов 976 — vendored-содержимое zig-pkg/. Такой мерж не проверяем на ревью и перекрывает историю репозитория.
  2. Регресс по честности: мерж вернул бы SU3MiningRealitySection.tsx и ещё 9 разделов сайта с заявлениями про кремний и майнинг. Эти разделы были удалены намеренно — действующий PIVOT: только FPGA AX7203, заявлений о кристалле нет.

Если из ветки нужны конкретные полезные правки — выделить их отдельным маленьким PR без vendored-файлов и без возврата удалённых разделов.

@gHashTag gHashTag closed this Aug 14, 2026
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