Deleted stale (Python-era artifacts, superseded by DB): - archive/oikos-cards/ (46 files, predecessor to DB entity graph) - archive/ledger/ (5-line JSONL fragment, superseded by DB audit log) Moved to docs/ (actual, current architecture docs): - docs/infrastructure/ — 12 infrastructure docs (network, DNS, mesh, SSH, ingress, media-permissions, backups, homelab-context, auto-deploy, VPS-hardening, monitoring, check-lifecycle) - docs/secrets/ — secrets README and rotation runbook - docs/GLOSSARY.md — 28-term homelab glossary Added STALE.md markers to hermes-plans/ and secrets-issuance/. Added MOVED.md pointers in archive sources. Updated docs/index.md to include new paths.
1.1 KiB
1.1 KiB
Docs
Long-form reference material for the Oikos platform and homelab infrastructure.
Operational state and topology live in the DB (seeded from seeds/); these docs
cover architecture, decisions, procedures, and the system model.
| Path | Contents |
|---|---|
| adr/ | Architecture Decision Records (numbered, append-only) |
| infrastructure/ | Homelab infrastructure architecture — network, DNS, mesh, ingress, backups, SSH, VPS hardening, auto-deploy, monitoring |
| mbse/ | Model-Based Systems Engineering views of the platform |
| mascot/ | MBSE subsystem model for the desktop mascot (planned) |
| operations/ | Operator runbooks (deploy, rollback, recovery) |
| secrets/ | Secret management procedures and rotation runbook |
| GLOSSARY.md | Term definitions across the homelab |
For agent orientation see AGENTS.md; for the operating model see .agents/OIKOS.md; for development see CONTRIBUTING.md. Design plans live in plans/, not here.