Epic: Hypatia architecture reconciliation & neurosymbolic activation

Parent tracking issue. Ground-truth audit (2026-05-18) of hypatia vs. intended design found: (1) neural organs wired but UNFED — nothing triggers Coordinator.force_cycle / Persistence.load_all (root cause of token/scattergun cost); (2) store is local flat files, not a private verisimdb via snif (snif boundary is pure aspiration; freestanding-wasm cannot reach verisimdb — architectural gap); (3) cicd-hyper-a name pervasive (513 occ/88 files), ArangoDB framed as persistence though ditched; (4) no UML 2.3/MOF/TOGAF — only stale Mermaid. Sub-issues track each remediation. As-built evidence: ~/dev/repos/HYPATIA-ARCHITECTURE-ASBUILT.adoc.

fix(neural): wire LearningScheduler→force_cycle + RBF restore at init (…

Four-gap status update (2026-05-21)

Gap	What	State	Artefact
(1)	Neural organs UNFED: no `Coordinator.force_cycle` / `Persistence.load_all` caller	Done on `main`	PR #275 (merged 2026-05-18). `lib/learning_scheduler.ex:125` → `force_cycle()`; `lib/neural/coordinator.ex:90` → `load_all()` + RBF hydrate. Closure-recommendation comment posted on #274.
(2)	snif boundary / private verisimdb -- "pure aspiration"	Decision-ready, awaiting owner ruling	Sub-issue #294 (A / B / C ruling) + companion PR #295 (in-tree memo).
(3)	`cicd-hyper-a` name pervasive	Mechanical sweep landed in branch	Sub-issue #292 + PR #293 (1-to-1 rename, 87 files / 477 lines, `cargo check -p hypatia-cli` green).
(4)	No UML 2.3 / MOF / TOGAF -- only stale Mermaid	Docs landed in branch	PR #291 (TOGAF-style overview + OMG MOF M2 metamodel, citation-by-`lib/...:N`).

Cross-PR coordination

PR docs(arch): add as-built MOF M2 metamodel + TOGAF overview (#273 gap 4) #291 modifies docs/architecture/README.md to add togaf-overview.adoc and mof-metamodel.adoc rows. PR docs(arch): add boundary-design-options.adoc (#273 gap 2, decision-ready) #295 deliberately does not touch README to avoid a textual conflict -- whichever PR merges second should add a one-line row for boundary-design-options.adoc.
PR chore: purge legacy cicd-hyper-a name (#292) #293 is mechanical and orthogonal to the docs PRs; no cross-PR conflict expected.

What's still open under this epic

Neural organs wired but UNFED: no caller for Coordinator.force_cycle / Persistence.load_all #274 (gap 1): close once PR fix(neural): wire LearningScheduler→force_cycle + RBF restore at init #275 merge is verified -- left open per ISSUE-CLOSURE policy.
Gap (3) of #273: purge legacy cicd-hyper-a name (477 occ / 87 files) #292 (gap 3): close when PR chore: purge legacy cicd-hyper-a name (#292) #293 merges.
Gap (2) of #273: rule on the verisimdb-via-SNIF boundary (A / B / C) #294 (gap 2): open until owner rules on A / B / C.
This epic (Epic: Hypatia architecture reconciliation & neurosymbolic activation #273): close after gaps (2) and (3) resolve and (4)'s docs are merged.

No additional code work scheduled this session.

docs(arch): add boundary-design-options.adoc (#273 gap 2, decision-re…

docs(arch): add as-built MOF M2 metamodel + TOGAF overview (#273 gap …

chore: purge legacy `cicd-hyper-a` name (#292) (#293)

chore(arch): session record (#273 four-gap landing) + README boundary…

@hyperpolymath

Epic status — 2026-05-25

Per-gap remediation status after PRs #275, #291, #293, #295, #309, #313, #314, #315:

Gap 1: Neural organs UNFED → ✅ resolved

See Neural organs wired but UNFED: no caller for Coordinator.force_cycle / Persistence.load_all #274 (closing) for full chain. RBF + MoE + trust_graph + GNN + VAE + Sequence hydration all wired. LSM and ESN summary-only by reservoir-state design.

Gap 2: SNIF / verisimdb boundary → ⏳ awaiting ruling

See Gap (2) of #273: rule on the verisimdb-via-SNIF boundary (A / B / C) #294. Decision-ready memo at docs/architecture/boundary-design-options.adoc; recommendation memo at docs/operations/issue-294-boundary-recommendation.adoc argues for Option A (split).

Gap 3: `cicd-hyper-a` name purge → ✅ resolved

Merged via PR chore: purge legacy cicd-hyper-a name (#292) #293. 0 occurrences remaining outside .git/.

Gap 4: No UML 2.3 / MOF / TOGAF → ✅ resolved

Merged via PR docs(arch): add as-built MOF M2 metamodel + TOGAF overview (#273 gap 4) #291. docs/architecture/togaf-overview.adoc (TOGAF baseline + ADR-001..ADR-006) and docs/architecture/mof-metamodel.adoc (OMG MOF M2 metamodel).

Tech-debt cleanups that landed adjacent to the epic

ROADMAP / STATE.a2ml synced through PR Fix recipe matching for scorecard and workflow patterns #309 + Post-#313: M17 + M18 + M9 longitudinal + container hardening + 5 design memos #314: M7/M8/M11/M12/M13/M14/M15/M16/M17/M18 done; M19/M20/M21 added as planned. completion-percentage 87 → 97.
ArangoDB framed as persistence though ditched (gap 1 sub-symptom): README badge + "Graph Intelligence" line corrected to verisim-data in PR docs: tidy root + adopt rsr-template-repo doc taxonomy #315.
Doc tidy (PR docs: tidy root + adopt rsr-template-repo doc taxonomy #315): root went from ~30 mixed .md/.adoc files → 9 standard project chrome. Full taxonomy aligned with rsr-template-repo under docs/.

Suggested next action: this epic can be closed once #294 is ruled on. Three of four gaps are done; the fourth is unblocked by a single decision.

@hyperpolymath — your call on whether to close-now-and-track-#294-standalone or wait for #294 ruling.

Generated by Claude Code

docs(wiki): sync wiki page sources into docs/wiki-pages/

docs: tidy root + adopt rsr-template-repo doc taxonomy (#315)

docs: comprehensive session summary + STATE bump (97 → 98)

All 4 architecture gaps now resolved:

Gap 1 (neural organs unfed) — PR fix(neural): wire LearningScheduler→force_cycle + RBF restore at init #275
Gap 2 (SNIF / verisimdb boundary) — ruled A on Gap (2) of #273: rule on the verisimdb-via-SNIF boundary (A / B / C) #294 (2026-05-27); execution at hypatia#367 + verisimdb#61
Gap 3 (cicd-hyper-a name drift) — PR chore: purge legacy cicd-hyper-a name (#292) #293 (87-file rename)
Gap 4 (UML/MOF/TOGAF docs) — PR docs(arch): add as-built MOF M2 metamodel + TOGAF overview (#273 gap 4) #291 (togaf-overview.adoc + mof-metamodel.adoc)

Closing the architecture-reconciliation epic. Execution issues track the remaining work.

docs: authoritative debt register; fix legally incoherent NOTICE; dro…

docs: rewrite README (562->177 lines); fix crg recipes and root-hygie…

Navigation Menu

Repository navigation

Epic: Hypatia architecture reconciliation & neurosymbolic activation #273

Four-gap status update (2026-05-21)

Cross-PR coordination

What's still open under this epic

Epic status — 2026-05-25

Gap 1: Neural organs UNFED → ✅ resolved

Gap 2: SNIF / verisimdb boundary → ⏳ awaiting ruling

Gap 3: `cicd-hyper-a` name purge → ✅ resolved

Gap 4: No UML 2.3 / MOF / TOGAF → ✅ resolved

Tech-debt cleanups that landed adjacent to the epic

Metadata

Assignees

Labels

Projects

Milestone

Relationships

Development

Epic: Hypatia architecture reconciliation & neurosymbolic activation #273

Description

Activity

hyperpolymath commented on May 20, 2026

Four-gap status update (2026-05-21)

Cross-PR coordination

What's still open under this epic

hyperpolymath commented on May 25, 2026

Epic status — 2026-05-25

Gap 1: Neural organs UNFED → ✅ resolved

Gap 2: SNIF / verisimdb boundary → ⏳ awaiting ruling

Gap 3: cicd-hyper-a name purge → ✅ resolved

Gap 4: No UML 2.3 / MOF / TOGAF → ✅ resolved

Tech-debt cleanups that landed adjacent to the epic

hyperpolymath commented on May 27, 2026

Metadata

Metadata

Assignees

Labels

Projects

Milestone

Relationships

Development

Issue actions

Gap 3: `cicd-hyper-a` name purge → ✅ resolved