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 | Hermes–Oikos interactions — agent/OS contract | |
| 0013 | Signal triggers — host health checks via scheduler | |
| 0014 | Entity model — types, relationships, state machines, OODA loop |