mirror of
https://github.com/SHOGGOTH-SECTOR/sica-fondt.git
synced 2026-07-31 16:16:26 +00:00
169ff3e21a
Per-sub-organ build plans so each organ can be made independently. Each spec follows a shared 10-section template (contract + stubs => standalone build/test). - README.md: index, template, integration DAG, build waves - C1: OpenHermes Agent <-> metacognitive cycling (priority) - A1 hub, A2 Energy, A3 PS+, A4 endomotiv array, A5 priors, A6 Eth-Int, A7 conviction array, A8 ETR Numbers stay disowned per restart discipline; unfitted constants marked C1. https://claude.ai/code/session_015hmgREHNsxYCuim33yUF2c
72 lines
4.8 KiB
Markdown
72 lines
4.8 KiB
Markdown
# Gen.03 — Component Build Plans
|
||
|
||
One spec per **sub-organ**, each self-contained so it can be built and tested **independently**
|
||
(against stubs) with no other organ present. These are the *build* layer beneath the canonical
|
||
design docs (`../gen03_state_of_architecture.md`, `../gen03_body.md`, `../gen03_self.md`) and
|
||
`../../src/endocrine/etr/etr_invariants.md`.
|
||
|
||
## How to read a spec
|
||
Every `NN-<organ>.md` has the same 10 sections:
|
||
1. **Component** · 2. **Status/certainty** · 3. **Language & location** · 4. **Does / does-not** ·
|
||
5. **Interface contract** (language-agnostic data shapes — integrate against *this*) ·
|
||
6. **Dependencies & stubs** · 7. **Invariants/laws** (certainty-tagged) · 8. **Build steps**
|
||
(invariants-first: laws → tests → fit) · 9. **Tests** (standalone command) · 10. **Open items**.
|
||
|
||
## Conventions
|
||
- **Certainty tags** (from arch doc): C5 ratified · C4 drafted · C3 partial · C2 explored · C1 stub.
|
||
- **Invariants-first / restart discipline:** no curve/bound/threshold/sign carried forward
|
||
unverified. Any unfitted constant is marked **C1**, never asserted ahead of a test.
|
||
- **Independence:** a spec depends only on the *contracts* (§5) of other organs, never their code,
|
||
and never the still-unnamed medium (D2). §6 ships a canned stub for each upstream input.
|
||
|
||
## Index
|
||
| # | Component | System | Status | Lang | Spec |
|
||
|---|-----------|--------|--------|------|------|
|
||
| C1 | **OpenHermes ↔ metacog** | Cognition | DESIGN-FIRST (priority) | OpenHermes/Ada | [C1](C1-openhermes-metacog.md) |
|
||
| A1 | Drive-Box hub / input-slot | Drive-Box | WORKING | R | [A1](A1-drivebox-hub.md) |
|
||
| A2 | Energy (E) driver | Drive-Box | structure WORKING · numbers DISOWNED | R | [A2](A2-energy.md) |
|
||
| A3 | PS+ driver | Drive-Box | structure WORKING · numbers DISOWNED | R | [A3](A3-psplus.md) |
|
||
| A4 | Endomotiv array (30-ch) | Drive-Box | WORKING · channels partial | R | [A4](A4-endomotiv-array.md) |
|
||
| A5 | Priors database | Drive-Box | structure WORKING | R | [A5](A5-priors.md) |
|
||
| A6 | Eth-Int driver | Drive-Box | structure WORKING · numbers DISOWNED | R | [A6](A6-ethint.md) |
|
||
| A7 | Conviction array | Drive-Box / Eth-Int | DESIGN-FIRST | R | [A7](A7-conviction-array.md) |
|
||
| A8 | ETR (torus) | Drive-Box | SCAFFOLD | Octave | [A8](A8-etr.md) |
|
||
| B1 | Tarot deck hi-fi emulator | Identity | exists (defunct-flagged) | TBD | _wave 1_ |
|
||
| B2 | SOUL.md identity + Big-3 | Identity | exists (defunct-flagged) | TBD | _wave 1_ |
|
||
| B3 | Celtic Cross spread | Identity | exists (defunct-flagged) | TBD | _wave 1_ |
|
||
| C2 | 4+4 Metacognition cycle | Cognition | partial (orchestration) | — | _wave 1_ |
|
||
| C3 | Inference cycle orchestration | Cognition | exists (defunct-flagged) | Ada | _wave 1_ |
|
||
| C4 | Brain (swappable LLM) | Cognition | STUB/external | — | _wave 1_ |
|
||
| D1 | Ada border (immune+BBB) | Border | WORKING | Ada/SPARK | _wave 1_ |
|
||
| D2 | The medium / "the blood" | Border | DESIGN-FIRST | — | _wave 2_ |
|
||
| D3 | Mini-rag / toolschema | Border | STUB | GNU Guile | _wave 1_ |
|
||
| E1 | 3 GnuCOBOL invariant stores | Storage | DESIGN-FIRST | GnuCOBOL | _wave 2_ |
|
||
| E2 | VARIANT stores | Storage | DESIGN-FIRST | TBD | _wave 2_ |
|
||
| E3 | RAG family + cross-store | Storage | DESIGN-FIRST | TBD | _wave 2_ |
|
||
| F1 | MoRAG (BERT+LoRA) | Periphery | DESIGN-FIRST | TBD | _wave 2_ |
|
||
| F2 | SAE monitor | Periphery | DESIGN-FIRST | TBD | _wave 2_ |
|
||
| F3 | Subagents framework | Periphery | DESIGN-FIRST | TBD | _wave 2_ |
|
||
| G1 | Stress-loop contract | Cross-cut | C1/C2 | — | _wave 2_ |
|
||
| G2 | Governance | Cross-cut | DESIGN-FIRST (C2) | TBD | _wave 2_ |
|
||
| G3 | Defense model | Cross-cut | emergent | — | _wave 2_ |
|
||
|
||
## Integration DAG (who feeds whom)
|
||
```
|
||
Hermes ──> [C1] ──> Inference cycle [C3] ──┬─ pulls Drive-Box snapshot [A1]
|
||
│ A1 ← A2,A3,A6,A8 ; A3 ← A4,A5 ; A6 ← A7
|
||
├─ draws Tarot [B1] → Big-3/SOUL [B2], Celtic Cross [B3]
|
||
├─ runs 4+4 metacog [C2] (iterative B3 cards)
|
||
├─ MoRAG injects [F1] ─┐
|
||
│ Drive-Box secretes [A1] ─┤→ Ada border [D1] polices → Brain [C4]
|
||
├─ mini-rag packs schema [D3]
|
||
└─ Ada routes tools [D1]
|
||
SAE [F2] watches Subagents [F3]; stress-loop [G1]: F2 → A7 (EthInt) → stress endomotiv (A4) → A8 drift + full reshuffle (B2)
|
||
Storage: INVARIANT [E1] / VARIANT [E2] / RAG+cross-store [E3] sit behind D1. Medium [D2] = the perfusion bus (unnamed).
|
||
```
|
||
|
||
## Build waves
|
||
- **Wave 0** — this README + **C1** (priority).
|
||
- **Wave 1 (buildable-now)** — A1–A8, B1–B3, C2–C4, D1, D3.
|
||
- **Wave 2 (design-first)** — D2, E1–E3, F1–F3, G1–G3.
|
||
Each spec is independent; review as they land.
|