sica-fondt/docs/plans

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 ·
2. Interface contract (language-agnostic data shapes — integrate against this) ·
3. 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
A1	Drive-Box hub / input-slot	Drive-Box	WORKING	R	A1
A2	Energy (E) driver	Drive-Box	structure WORKING · numbers DISOWNED	R	A2
A3	PS+ driver	Drive-Box	structure WORKING · numbers DISOWNED	R	A3
A4	Endomotiv array (30-ch)	Drive-Box	WORKING · channels partial	R	A4
A5	Priors database	Drive-Box	structure WORKING	R	A5
A6	Eth-Int driver	Drive-Box	structure WORKING · numbers DISOWNED	R	A6
A7	Conviction array	Drive-Box / Eth-Int	DESIGN-FIRST	R	A7
A8	ETR (torus)	Drive-Box	SCAFFOLD	Octave	A8
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.