Research & References¶
This section is the trade-space view of the platform. Where ADRs say what we decided, these pages say what the alternatives were, what bedrock standards we anchor to, and what literature each choice descends from. They're meant to be read by external architects, ontologists, security reviewers, and engineering leaders who want to verify our choices were considered — not invented.
How this section relates to ADRs
Each research page sits one altitude above a family of ADRs. The ADR records the decision and its consequences for this system; the research page records the landscape the decision was made inside — competing options, governing standards, canonical literature.
Pages¶
| Page | Covers | Anchors |
|---|---|---|
| Ontology Foundations | UFO + BFO as dual foundations, OWL 2 / SHACL, n-ary reification, competency questions, OBO Foundry. | ADR-016, 019, 032, 033, 039, 043 |
| Ontology Stack | Runtime tooling — Fuseki, Oxigraph, N3.js, reasoners, SHACL, RML, authoring tooling. | ADR-019, 040, 046, 051, 072 |
| Persistence & Time | Stamp-first temporal model, Data Vault 2.1, ArcadeDB multi-model, Apache Arrow, pace-layered projection. | ADR-009, 026, 038, 041, 042, 055 |
| Graph Visualization & UI | React Flow vs the field, layout engines, the W3C DTCG tokens contract, WCAG 2.2 AA. | ADR-040, 046, 072 |
| LLM & Agent Stack | Cerebras + gateway, MCP, A2A, streaming, embeddings, capability gating, swarm orchestration. | ADR-003, 004, 007, 008, 021, 028, 044, 052 |
| Coordination & VFS | Holonic board, HVFS, file-first registry, NATS event bus, self-healing harness. | ADR-022, 034, 035, 047–058, 071 |
| Generative Pipeline | Ontology-driven generative programming, F# compiler core, forge, MBSE+PPM, byte-identical emission. | ADR-029, 032, 033, 036, 039, 043, 057 |
| Standards Index | Catalog of every external standard / spec / methodology we anchor to, with version + use site + link. | All of the above |
How to read this section¶
- If you're auditing a decision — start from the relevant ADR, then jump to the research page named at the top of that ADR for the trade-space. The research page will name the alternatives we passed over and why.
- If you're new to the platform — read Ontology Foundations and Standards Index first. They frame everything else.
- If you're evaluating us as a vendor or partner — the Standards Index is the bedrock list. Every row is a real specification with a real version, used at a real site in the codebase.
What's not here¶
- Operational runbooks — those live under Fleet Operations.
- Per-spoke implementation guides — those live under Platform Capabilities.
- Roadmap commitments — those live under Roadmap and the Release Trains.
The research section is stable reading: it changes when a foundational choice changes, not when a deployment changes.