Skip to content

[ARCH] Унификация всех 36 crates по образцу trios-a2a — ring-архитектура Gold/Silver/Bronze #238

Closed

Description

@gHashTag

🏗️ [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 check output: 0 errors для каждого crate
  • Список файлов: find crates/ -name 'AGENTS.md' | wc -l → N (соответствует числу колец)
  • .trinity/experience/arch-unification-236.md — experience record

🔗 References


Priority

P1-HIGH — без унификации армия агентов работает в хаосе. Единая архитектура = единый язык команд.

Kingdom: Cross-kingdom (затрагивает все 9 царств)

Soul-name агента: "Architect" — строит фундамент, на котором стоят все царства.

Activity

  1. added a commit that references this issue on Apr 22, 2026
  2. gHashTag commented on Apr 22, 2026

    @gHashTag
    CollaboratorAuthor

    🐝 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-OUTPUT
    • crates/trios-ternary → TR-00, TR-01, BR-OUTPUT
    • crates/trios-sacred → SC-00, SC-01, BR-OUTPUT
    • crates/trios-physics → PH-00, PH-01, BR-OUTPUT

    Каждое кольцо должно содержать:

    rings/XX-00/README.md   ← что делает кольцо, API, зависимости
    rings/XX-00/TASK.md     ← чеклист задач
    rings/XX-00/AGENTS.md   ← инструкции агенту
    

    Эталон

    Смотри crates/trios-a2a/rings/ — именно такая структура нужна.

    Инварианты

    • cargo check -p <crate> = 0 errors
    • cargo clippy -p <crate> = 0 warnings
    • README + TASK + AGENTS в каждом кольце
    • PR body: Closes #238

    PHI LOOP

    CLAIM → NAME → SPEC → SEAL → GEN → TEST → VERDICT → EXPERIENCE → REPORT → COMMIT → PUSH
    

    Ветка: bee/238-gold-math-batch2

    Полный промпт: .trinity/prompts/agent-dispatch.md

  3. gHashTag commented on Apr 29, 2026

    @gHashTag
    CollaboratorAuthor

    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.

  4. gHashTag commented on Apr 29, 2026

    @gHashTag
    CollaboratorAuthor

    L7 · scaffold(trios-bridge) · rings=BR-00, BR-01, BR-02, BR-OUTPUT · cargo_check=ok · PR=#336 · phi^2+phi^-2=3

  5. gHashTag commented on Apr 29, 2026

    @gHashTag
    CollaboratorAuthor

    L7 · scaffold(trios-data) · rings=DT-00, DT-01, DT-02, BR-OUTPUT · cargo_check=ok · PR=#339 · phi^2+phi^-2=3

  6. gHashTag commented on Apr 29, 2026

    @gHashTag
    CollaboratorAuthor

    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.

  7. gHashTag commented on Apr 29, 2026

    @gHashTag
    CollaboratorAuthor

    L7 · scaffold(trios-model) · rings=MD-00, MD-01, BR-OUTPUT · cargo_check=fail · PR=#341 · phi^2+phi^-2=3

  8. gHashTag commented on Apr 29, 2026

    @gHashTag
    CollaboratorAuthor

    L7 · scaffold(trios-kg) · rings=KG-00, KG-01, KG-02, BR-OUTPUT · cargo_check=fail · PR=#346 · phi^2+phi^-2=3

  9. gHashTag commented on Apr 29, 2026

    @gHashTag
    CollaboratorAuthor

    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.

  10. gHashTag commented on Apr 29, 2026

    @gHashTag
    CollaboratorAuthor

    L7 · scaffold(trios-claude) · rings=CL-00, CL-01, CL-02, BR-OUTPUT · cargo_check=ok · PR=#352 · phi^2+phi^-2=3

  11. 84 remaining items

  12. added 15 commits that reference this issue on May 19, 2026
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Metadata

Metadata

Assignees

No one assigned

    Type

    No type

    Projects

    No projects

      Milestone

      No milestone

      Relationships

      None yet

      Development

      No branches or pull requests

      Issue actions