Repository navigation
Closed
Description
🏗️ [ARCH] Унификация всех crates по образцу trios-a2a
"Every agent is a temporary citizen with bounded authority. Every task has a contract. Every mutation leaves evidence." — LAWS.md
🎯 Goal
Привести все 36 crates репозитория к единой ring-архитектуре по образцу trios-a2a — единственного crate, реализованного строго по правилам Gold/Silver/Bronze уровней с нумерованными кольцами (00..N), документацией и инвариантами.
🚫 Non-Goals
- Не изменять бизнес-логику существующих crates
- Не трогать
trios-a2a(эталон — только читать) - Не объединять crates в один
- Не менять публичный API без явного указания
📐 Эталон: trios-a2a структура
crates/trios-a2a/
├── Cargo.toml # workspace root
├── src/lib.rs # re-exports всех rings
├── README.md # обзор crate
├── TASK.md # статус задач
├── AGENTS.md # инструкции для агентов
└── rings/
├── SR-00/ # Ring 00 — нижний уровень
│ ├── Cargo.toml
│ ├── src/lib.rs
│ ├── README.md
│ ├── TASK.md
│ └── AGENTS.md
├── SR-01/ # Ring 01
│ └── ...
└── BR-OUTPUT/ # Binary Ring — артефакты
└── ...
Правила нумерации колец
| Префикс | Значение | Пример |
|---|---|---|
XX-00 |
Identity / Core types | SR-00, UR-00 |
XX-01..N |
Последовательные слои | SR-01, SR-02... |
BR-OUTPUT |
Binary Ring, финальный артефакт | BR-OUTPUT, BR-APP |
Инвариант I5 (обязателен для каждого кольца)
Каждое кольцо ДОЛЖНО содержать:
README.md— что это кольцо делает, API, примерыTASK.md— статус задач кольцаAGENTS.md— инструкции агента для этого кольца
📋 Crates для унификации (36 total)
Tier 1 — GOLD (core, математика, типы)
trios-core → rings: CR-00 (constants), CR-01 (types), CR-02 (math), BR-OUTPUT
trios-golden-float → rings: GF-00 (phi), GF-01 (operations), BR-OUTPUT
trios-ternary → rings: TR-00 (ternary types), TR-01 (ops), BR-OUTPUT
trios-sacred → rings: SC-00 (geometry), SC-01 (ratios), BR-OUTPUT
trios-physics → rings: PH-00 (constants), PH-01 (equations), BR-OUTPUT
trios-crypto → rings: CY-00 (identity), CY-01 (signing), CY-02 (verify), BR-OUTPUT
trios-hdc → rings: HD-00 (vectors), HD-01 (ops), BR-OUTPUT
trios-vsa → rings: VS-00 (algebra), VS-01 (binding), BR-OUTPUT
Tier 2 — SILVER (сервисы, протоколы)
trios-server → rings: SV-00 (router), SV-01 (mcp), SV-02 (ws), SV-03 (rest), BR-OUTPUT
trios-agents → rings: AG-00 (registry), AG-01 (lifecycle), AG-02 (skills), BR-OUTPUT
trios-bridge → rings: BR-00 (transport), BR-01 (mcp-bridge), BR-02 (sse), BR-OUTPUT
trios-llm → rings: LM-00 (client), LM-01 (streaming), LM-02 (context), BR-OUTPUT
trios-data → rings: DT-00 (store), DT-01 (query), DT-02 (sync), BR-OUTPUT
trios-model → rings: MD-00 (schema), MD-01 (validation), BR-OUTPUT
trios-kg → rings: KG-00 (graph), KG-01 (query), KG-02 (index), BR-OUTPUT
trios-claude → rings: CL-00 (client), CL-01 (tools), CL-02 (dispatch), BR-OUTPUT
trios-sdk → rings: SD-00 (api), SD-01 (client), SD-02 (auth), BR-OUTPUT
trios-hybrid → rings: HY-00 (runtime), HY-01 (dispatch), BR-OUTPUT
trios-precision-router → rings: PR-00 (rules), PR-01 (router), BR-OUTPUT
Tier 3 — SILVER/BRONZE (специализированные)
trios-ext → rings: EX-00 (wasm), EX-01 (dom), EX-02 (mcp), EX-03 (bridge), BR-EXT
trios-vm → rings: VM-00 (bytecode), VM-01 (executor), VM-02 (memory), BR-OUTPUT
trios-tri → rings: TI-00 (parser), TI-01 (compiler), TI-02 (codegen), BR-OUTPUT
trios-cli → rings: CI-00 (commands), CI-01 (repl), CI-02 (output), BR-BIN
trios-git → rings: GT-00 (ops), GT-01 (hooks), BR-OUTPUT
trios-gb → rings: GB-00 (branches), GB-01 (diff), BR-OUTPUT
trios-phi-schedule → rings: PS-00 (schedule), PS-01 (executor), BR-OUTPUT
trios-doctor → rings: DC-00 (checks), DC-01 (fixes), BR-OUTPUT
trios-operator-smoke → rings: OS-00 (smoke), OS-01 (report), BR-OUTPUT
Tier 4 — BRONZE (ML, FPGA, специализированные)
trios-training → rings: TN-00 (dataset), TN-01 (trainer), TN-02 (eval), BR-MODEL
trios-train-cpu → rings: TC-00 (cpu-ops), TC-01 (batch), BR-MODEL
trios-training-ffi → rings: TF-00 (ffi-bridge), TF-01 (bindings), BR-FFI
trios-igla-trainer → rings: IT-00 (igla), IT-01 (schedule), BR-MODEL
trios-fpga → rings: FP-00 (hdl), FP-01 (synthesis), FP-02 (bitstream), BR-BITSTREAM
trios-ca-mask → rings: CM-00 (mask), CM-01 (apply), BR-OUTPUT
trios-trinity-brain → rings: TB-00 (memory), TB-01 (reasoning), TB-02 (planning), BR-OUTPUT
trios-trinity-init → rings: TI-00 (bootstrap), TI-01 (config), BR-OUTPUT
trios-zig-agents → rings: ZA-00 (zig-runtime), ZA-01 (agents), BR-ZIG
zig-knowledge-graph → rings: ZK-00 (graph), ZK-01 (zig-query), BR-ZIG
✅ Acceptance Criteria
Для КАЖДОГО из 36 crates:
- [ ] rings/ директория создана
- [ ] Кольца пронумерованы XX-00..XX-N последовательно
- [ ] Каждое кольцо: README.md + TASK.md + AGENTS.md (Инвариант I5)
- [ ] Каждое кольцо: src/lib.rs с типами и тестами
- [ ] Каждое кольцо: Cargo.toml с правильными зависимостями
- [ ] BR-OUTPUT / BR-BIN / BR-MODEL кольцо как финальный артефакт
- [ ] Корневой Cargo.toml crate содержит workspace с members
- [ ] cargo check --target wasm32-unknown-unknown (для WASM-совместимых)
- [ ] cargo check (для native crates: server, cli, fpga, training)
- [ ] 0 clippy warnings на всех кольцах
- [ ] raw-строки r##"..."## без HTML-экранирования (&, <, >)
- [ ] Корневой README.md crate обновлён с ring-диаграммой зависимостей
🔒 Инварианты (из LAWS.md)
| ID | Правило | Проверка |
|---|---|---|
| I1 | cargo build exits 0 | cargo build --all |
| I2 | Тесты проходят | cargo test --all |
| I3 | clippy 0 warnings | cargo clippy --all-targets |
| I5 | Каждое кольцо: README + TASK + AGENTS | ls rings/XX-*/README.md |
| I15 | Zero handwritten JS в WASM crates | grep JS в src/ |
🏗️ Шаблон для каждого кольца
rings/XX-00/src/lib.rs
//! XX-00 — <Название кольца>
//! <Crate> Ring 00 — core types and identity
#[derive(Debug, Clone, PartialEq)]
pub struct <MainType> {
// ...
}
#[cfg(test)]
mod tests {
use super::*;
#[test]
fn test_<name>_creates() {
// ...
}
}rings/XX-00/README.md
# XX-00 — <Название>
## Назначение
<Что делает это кольцо>
## API
<Ключевые типы и функции>
## Зависимости
<От каких других колец зависит>
## Инварианты
<Специфичные для кольца инварианты>rings/XX-00/AGENTS.md
# Agent Instructions — XX-00
## Контекст
<Что агент должен знать>
## Файлы для изменения
- `src/lib.rs` — основная логика
## Запрещено
- Изменять публичный API без обновления README
- Добавлять зависимости без обновления Cargo.toml
## Верификация
```bash
cargo test -p <crate-XX-00>
cargo clippy -p <crate-XX-00>
---
## 📦 Стратегия выполнения (батчи по 4 crate)
Выполнять батчами, каждый батч = отдельный PR:
| Батч | Crates | Приоритет |
|------|--------|-----------|
| **Batch 1** | trios-core, trios-golden-float, trios-ternary, trios-sacred | P0 — GOLD core |
| **Batch 2** | trios-crypto, trios-physics, trios-hdc, trios-vsa | P0 — GOLD math |
| **Batch 3** | trios-server, trios-agents, trios-bridge, trios-llm | P1 — SILVER services |
| **Batch 4** | trios-data, trios-model, trios-kg, trios-claude | P1 — SILVER data |
| **Batch 5** | trios-sdk, trios-hybrid, trios-precision-router, trios-ext | P1 — SILVER runtime |
| **Batch 6** | trios-vm, trios-tri, trios-cli, trios-git | P2 — tools |
| **Batch 7** | trios-gb, trios-phi-schedule, trios-doctor, trios-operator-smoke | P2 — tooling |
| **Batch 8** | trios-training, trios-train-cpu, trios-training-ffi, trios-igla-trainer | P3 — ML |
| **Batch 9** | trios-fpga, trios-ca-mask, trios-trinity-brain, trios-trinity-init | P3 — specialized |
| **Batch 10** | trios-zig-agents, zig-knowledge-graph | P3 — Zig |
---
## 🤖 Инструкция агенту
### Перед началом КАЖДОГО батча:
1. `cargo check -p <crate>` — зафиксировать текущее состояние
2. Прочитать существующий `src/lib.rs` — определить публичные типы
3. Разбить типы по кольцам логически (dependency order = ring number)
4. Проверить raw-строки: `r##"..."##` без HTML-эскейпинга
### Для КАЖДОГО кольца:
```bash
# 1. Создать структуру
mkdir -p rings/XX-00/src
# 2. Написать Cargo.toml, src/lib.rs, README.md, TASK.md, AGENTS.md
# 3. Проверить
cargo check -p <crate-xx-00>
cargo test -p <crate-xx-00>
cargo clippy -p <crate-xx-00> -- -D warnings
После батча:
- Один PR на батч
- PR body:
Closes #236 - Evidence: список всех созданных файлов
📄 Evidence Required
- PR per batch с diff всех созданных rings/
-
cargo checkoutput: 0 errors для каждого crate - Список файлов:
find crates/ -name 'AGENTS.md' | wc -l→ N (соответствует числу колец) -
.trinity/experience/arch-unification-236.md— experience record
🔗 References
- Эталон:
crates/trios-a2a/(8 SR-rings + BR-OUTPUT, 84 tests) - Эталон UI:
crates/trios-ui/(10 UR-rings + BR-APP) - LAWS.md — Invariant I5, L1–L20
- Issue TRIOS A2A — Лучшая в мире Agent-to-Agent архитектура #234 (trios-a2a completed — образец победы)
- Issue [AMEND] Implement LAWS.md v2.0 — Constitutional Document with NASA-grade Protection, CI Gates & Nine Kingdoms Invariants #235 (LAWS.md v2.0 — конституционная защита)
Priority
P1-HIGH — без унификации армия агентов работает в хаосе. Единая архитектура = единый язык команд.
Kingdom: Cross-kingdom (затрагивает все 9 царств)
Soul-name агента: "Architect" — строит фундамент, на котором стоят все царства.
Activity
feat(#238): scaffold rings/ structure for all 36 crates — README+TASK…
gHashTag commentedon Apr 22, 2026
🐝 IN-FLIGHT — Agent: Architect
Batch 1 (DONE): trios-core (CR-00, CR-01, BR), trios-server (SV-00..SV-02, BR), trios-agents (AG-00), trios-llm (LM-00) — commit
4fb9f13🧠 DISPATCH — Batch 2: GOLD math crates
Солдаты, заберите эти задачи:
Цель
Создать
rings/структуру для четырёх GOLD crates:crates/trios-golden-float→ GF-00, GF-01, BR-OUTPUTcrates/trios-ternary→ TR-00, TR-01, BR-OUTPUTcrates/trios-sacred→ SC-00, SC-01, BR-OUTPUTcrates/trios-physics→ PH-00, PH-01, BR-OUTPUTКаждое кольцо должно содержать:
Эталон
Смотри
crates/trios-a2a/rings/— именно такая структура нужна.Инварианты
cargo check -p <crate>= 0 errorscargo clippy -p <crate>= 0 warningsCloses #238PHI LOOP
Ветка:
bee/238-gold-math-batch2Полный промпт:
.trinity/prompts/agent-dispatch.mdfeat(arch): AGENTS.md v2 + arch-guard.yml + scripts/pre-commit — ARCH…
gHashTag commentedon Apr 29, 2026
L7 · trios-golden-float scaffolded — GF-00 (phi/GF16), GF-01 (ops), BR-OUTPUT (assembly). Each ring green standalone (cargo check + tests). Legacy src/ FFI preserved. Anchor phi^2 + phi^-2 = 3 verified. Draft PR #335.
gHashTag commentedon Apr 29, 2026
L7 · scaffold(trios-bridge) · rings=BR-00, BR-01, BR-02, BR-OUTPUT · cargo_check=ok · PR=#336 · phi^2+phi^-2=3
gHashTag commentedon Apr 29, 2026
L7 · scaffold(trios-data) · rings=DT-00, DT-01, DT-02, BR-OUTPUT · cargo_check=ok · PR=#339 · phi^2+phi^-2=3
gHashTag commentedon Apr 29, 2026
L7 · trios-ternary scaffolded — TR-00 (Trit/Tryte types), TR-01 (neg/add), BR-OUTPUT (assembly + TRINITY_SUM witness). Each ring green standalone. Legacy src/ preserved. Anchor verified. Draft PR #338.
gHashTag commentedon Apr 29, 2026
L7 · scaffold(trios-model) · rings=MD-00, MD-01, BR-OUTPUT · cargo_check=fail · PR=#341 · phi^2+phi^-2=3
gHashTag commentedon Apr 29, 2026
L7 · scaffold(trios-kg) · rings=KG-00, KG-01, KG-02, BR-OUTPUT · cargo_check=fail · PR=#346 · phi^2+phi^-2=3
gHashTag commentedon Apr 29, 2026
L7 · trios-sacred scaffolded — SC-00 (geometry: Vec2/Triangle/Circle), SC-01 (ratios: PHI/SQRT2/SQRT3/PI), BR-OUTPUT (assembly + Sacred::anchor()). Each ring green. Legacy FFI to zig-sacred-geometry preserved. Anchor verified. Draft PR #349.
gHashTag commentedon Apr 29, 2026
L7 · scaffold(trios-claude) · rings=CL-00, CL-01, CL-02, BR-OUTPUT · cargo_check=ok · PR=#352 · phi^2+phi^-2=3
84 remaining items
feat(#238): scaffold rings/ for trios-igla-race — IR-00 IR-01 BR-OUTPUT
feat(#238): scaffold rings/ for trios-sdk — SD-00, SD-01, SD-02, BR-O…
feat(#238): scaffold rings/ for trios-sdk — SD-00, SD-01, SD-02, BR-O…
feat(#238): scaffold rings/ for trios-hybrid — HY-00, HY-01, BR-OUTPUT
feat(#238): scaffold rings/ for trios-hybrid — HY-00, HY-01, BR-OUTPUT
feat(#238): scaffold rings/ for trios-precision-router — PR-00, PR-01…
feat(#238): scaffold rings/ for trios-precision-router — PR-00, PR-01…
feat(#238): scaffold rings/ for trios-physics — PH-00, PH-01, BR-OUTPUT
feat(#238): scaffold rings/ for trios-physics — PH-00, PH-01, BR-OUTPUT
feat(#238): scaffold rings/ for trios-crypto — CY-00, CY-01, CY-02, B…
feat(#238): scaffold rings/ for trios-crypto — CY-00, CY-01, CY-02, B…
feat(#238): scaffold rings/ for trios-hdc — HD-00, HD-01, BR-OUTPUT
feat(#238): scaffold rings/ for trios-hdc — HD-00, HD-01, BR-OUTPUT
feat(#238): scaffold rings/ for trios-vsa — VS-00, VS-01, BR-OUTPUT
feat(#238): scaffold rings/ for trios-vsa — VS-00, VS-01, BR-OUTPUT