the-custodian/canon/architecture
codex 9162f7e530
All checks were successful
CI Smoke / host-smoke (push) Successful in 0s
CI Smoke / container-smoke (push) Successful in 1s
docs(canon): ADR-012 — require a routine reset of the projection from the forge
Adds decision 7: the projection must be discardable and rebuildable from what
Forgejo holds, per repository and fleet-wide.

This is what makes the other decisions checkable. A read model that cannot be
rebuilt from its source is a database with a projection's reputation, and the
difference only surfaces when someone needs to rebuild it. ADR-010 already
asserts a cache may be reconstructed at any time; that claim has never been
executed.

Three properties keep it real: routine rather than emergency, scoped per
repository, and idempotent enough to verify against the forge — which derived
identifiers make possible.

Two refusals are explicit. Reset cannot restore the preliminary overlay, since
the forge does not hold it. And reset must refuse when records exist only in
the projection: on 2026-08-25 that was 111 work records, which a rebuild would
have erased while reporting success.

Also flags an unresolved boundary: hub-native records are not forge-derived and
must survive a rebuild of forge-derived state.

Co-Authored-By: Claude Opus 5 <noreply@anthropic.com>
2026-08-25 21:36:21 +02:00
..
infospace Add pointer infospace for the first-wave architecture collection 2026-08-19 00:17:13 +02:00
adr-001-workplans-as-repo-artefacts.md Add publication ids and metadata to estate ADRs 2026-08-19 01:09:18 +02:00
adr-002-custodian-agent-runtime-design.md Add publication ids and metadata to estate ADRs 2026-08-19 01:09:18 +02:00
adr-003-materialized-derived-state.md Add publication ids and metadata to estate ADRs 2026-08-19 01:09:18 +02:00
adr-004-connectivity-first-network-posture.md Add publication ids and metadata to estate ADRs 2026-08-19 01:09:18 +02:00
adr-005-cross-repo-workplans-project-repos.md Add publication ids and metadata to estate ADRs 2026-08-19 01:09:18 +02:00
adr-006-canon-federation-concept-ownership.md Add publication ids and metadata to estate ADRs 2026-08-19 01:09:18 +02:00
adr-007-workplan-identity-and-repo-worker-topology.md canon(ADR-007): rule derivation scope for C2 -- live records only 2026-08-21 06:36:06 +02:00
adr-008-multi-tenancy-model.md ADR-008: relocate the multi-tenancy framework to NetKingdom canon 2026-08-17 15:40:59 +02:00
adr-010-hub-authority-and-local-cache-model.md docs(canon): correct ADR-010 on divergence shapes, mechanism, and outcome 2026-08-24 23:46:33 +02:00
adr-011-federated-namespaces-and-reconciliation-limits.md Add publication ids and metadata to estate ADRs 2026-08-19 01:09:18 +02:00
adr-012-projection-source-and-preliminary-overlay.md docs(canon): ADR-012 — require a routine reset of the projection from the forge 2026-08-25 21:36:21 +02:00
coulomb-estate_v0.1.md Add publication ids and metadata to estate ADRs 2026-08-19 01:09:18 +02:00