Files
oikos/docs/adr
dtoro a39e67b6e9
Some checks failed
ci / build-test (push) Has been cancelled
ci / docker-build (push) Has been cancelled
adr: convert all diagrams to Mermaid (sequenceDiagram, stateDiagram-v2, flowchart, erDiagram, graph)
0013-signal-triggers.md:
- Thermals query: sequenceDiagram (Nomos→API→Scheduler→Hubris→TimescaleDB)
- Script deployment: sequenceDiagram
- Signal lifecycle: stateDiagram-v2
- DB data flow: flowchart

0014-entity-model.md:
- Entity type hierarchy: graph (56 types, 3 layers, 7 domains)
- Machine onboarding: sequenceDiagram
- OODA loop (5 phases): flowchart with color-coded subgraphs
- Infrastructure topology: graph
- Network relationships: graph
- Service dependencies: graph
- Cognition OODA edges: graph
- Governance: graph
- Infrastructure lifecycle: stateDiagram-v2
- Signal lifecycle: stateDiagram-v2
- Execution lifecycle: stateDiagram-v2
- Approval lifecycle: stateDiagram-v2
- DB physical schema: erDiagram
- Thermals query trace: sequenceDiagram
2026-07-08 22:38:19 +02:00
..

Architecture Decision Records

MADR-style records for Oikos. One decision per file, numbered, never edited after acceptance — superseding decisions get a new ADR that links back. Statuses: proposed | accepted | superseded-by-NNNN.

ADR Title
0001 Go with single-binary role packaging
0002 PostgreSQL + TimescaleDB as the only datastore
0003 DB-native ontology with YAML seed manifests
0004 Contract-first OpenAPI API
0005 UUIDv7 + slug entity identity
0006 Learning is proposal-only (no self-authorization)
0007 Threat model and trust zones
0008 Forward-only migrations
0009 SSE over WebSocket for the event stream
0010 Infisical secrets with SOPS DR fallback
0011 Client lifecycle flows — enrollment, bootstrap, sync
0012 HermesOikos interactions — agent/OS contract
0013 Signal triggers — host health checks via scheduler
0014 Entity model — types, relationships, state machines, OODA loop