Start the arc42 contract and publish the first ADR set
Add the owner-facing publication contract, a regenerable ADR review ledger, and publication entries for this repo's ADR-0001 plus the eight ready railiance-master ADRs.
This commit is contained in:
parent
7a24e9107f
commit
a8fb62a3bc
34 changed files with 9669 additions and 28 deletions
42
docs/adr-review/SUMMARY.md
Normal file
42
docs/adr-review/SUMMARY.md
Normal file
|
|
@ -0,0 +1,42 @@
|
|||
# ADR review ledger summary
|
||||
|
||||
Rows: 125
|
||||
|
||||
## Inventory dispositions
|
||||
|
||||
- `excluded`: 2
|
||||
- `metadata-pending`: 105
|
||||
- `published`: 10
|
||||
- `unsupported-format`: 8
|
||||
|
||||
## Proposed dispositions
|
||||
|
||||
- `publish`: 9
|
||||
- `unreviewed`: 116
|
||||
|
||||
## Front-matter `id` collisions
|
||||
|
||||
- `ADR-001`: coulomb-loop/docs/adr/ADR-001-workplan-prefix.md, kaizen-agentic/docs/adr/ADR-001-workplan-convention.md, rein-aharness/docs/adr/ADR-001-agent-harness-architecture.md, the-custodian/canon/architecture/adr-001-workplans-as-repo-artefacts.md
|
||||
- `ADR-002`: coulomb-loop/docs/adr/ADR-002-customer-supplier-boundary.md, kaizen-agentic/docs/adr/ADR-002-project-memory-convention.md, the-custodian/canon/architecture/adr-002-custodian-agent-runtime-design.md
|
||||
- `ADR-003`: coulomb-loop/docs/adr/ADR-003-cadence-ramp-policy.md, kaizen-agentic/docs/adr/ADR-003-protocols-artifact-convention.md, the-custodian/canon/architecture/adr-003-materialized-derived-state.md
|
||||
- `ADR-004`: coulomb-loop/docs/adr/ADR-004-repo-rotation-on-diminishing-returns.md, kaizen-agentic/docs/adr/ADR-004-project-metrics-convention.md, the-custodian/canon/architecture/adr-004-connectivity-first-network-posture.md
|
||||
- `ADR-0001`: coulomb-social/docs/adr/ADR-0001-netkingdom-identity.md, key-cape/docs/adr/ADR-0001-choose-go-for-keycape.md, target-revenue/docs/adr/ADR-0001-stage0-library-stack.md
|
||||
- `ADR-005`: kaizen-agentic/docs/adr/ADR-005-scheduled-agent-execution.md, the-custodian/canon/architecture/adr-005-cross-repo-workplans-project-repos.md
|
||||
- `netkingdom-iam-profile`: net-kingdom/canon/standards/iam-profile_v0.2.md, net-kingdom/canon/standards/iam-profile_v0.3.md
|
||||
|
||||
## Bare ADR-NNNN collisions
|
||||
|
||||
- `ADR-0001`: activity-core/docs/adr/adr-001-event-bridge-architecture.md, coulomb-loop/docs/adr/ADR-001-workplan-prefix.md, coulomb-social/docs/adr/ADR-0001-netkingdom-identity.md, evidence-binder/docs/adr/ADR-0001-reference-ui-surface.md, glas-harness/docs/adr/ADR-001-rein-harness-family.md, kaizen-agentic/docs/adr/ADR-001-workplan-convention.md, key-cape/docs/adr/ADR-0001-choose-go-for-keycape.md, markitect-main/docs/adr/ADR-001-client-side-debug-storage.md, policy-nexus/docs/adr/ADR-0001-addressing-and-permanence.md, railiance-master/docs/adr/ADR-0001-repository-prefix-architecture.md, railiance-platform/docs/adr/ADR-0001-s3-platform-service-boundary.md, rapp-postgres/docs/adr/ADR-0001-consumer-boundary-and-tenant-isolation.md, rein-aharness/docs/adr/ADR-001-agent-harness-architecture.md, target-revenue/docs/adr/ADR-0001-stage0-library-stack.md, the-custodian/canon/architecture/adr-001-workplans-as-repo-artefacts.md
|
||||
- `ADR-0002`: activity-core/docs/adr/adr-002-definition-format.md, coulomb-loop/docs/adr/ADR-002-customer-supplier-boundary.md, coulomb-social/docs/adr/ADR-0002-space-content-forgejo-markdown.md, glas-harness/docs/adr/ADR-002-credential-brokering-and-composable-reins.md, kaizen-agentic/docs/adr/ADR-002-project-memory-convention.md, markitect-main/docs/adr/ADR-002-robustness-principle-for-production-use.md, railiance-hosts/docs/adr/ADR-002-repo-boundary-hosts-vs-bootstrap.md, railiance-infra/docs/adr/ADR-002-repo-boundary-hosts-vs-bootstrap.md, railiance-master/docs/adr/ADR-0002-rail-kubernetes-wave-1-boundary.md, railiance-platform/docs/adr/ADR-0002-placement-policy-ownership.md, rapp-postgres/docs/adr/ADR-0002-data-retention-and-erasure.md, target-revenue/docs/adr/ADR-0002-hosted-trust-service-stack.md, the-custodian/canon/architecture/adr-002-custodian-agent-runtime-design.md
|
||||
- `ADR-0003`: activity-core/docs/adr/adr-003-rule-instruction-model.md, coulomb-loop/docs/adr/ADR-003-cadence-ramp-policy.md, coulomb-social/docs/adr/ADR-0003-page-centric-markdown-sor.md, glas-harness/docs/adr/ADR-003-scheduling-and-blueprint-sourcing-stay-rein-local.md, kaizen-agentic/docs/adr/ADR-003-protocols-artifact-convention.md, railiance-hosts/docs/adr/ADR-003-railiance-5repo-stack-architecture.md, railiance-infra/docs/adr/ADR-003-railiance-5repo-stack-architecture.md, railiance-master/docs/adr/ADR-0003-rapp-first-wave-selection.md, railiance-platform/docs/adr/ADR-0003-decisions-live-in-the-repo.md, rapp-postgres/docs/adr/ADR-0003-e3-row-level-security-contract.md, the-custodian/canon/architecture/adr-003-materialized-derived-state.md
|
||||
- `ADR-0004`: activity-core/docs/adr/adr-004-producer-trust-boundary.md, coulomb-loop/docs/adr/ADR-004-repo-rotation-on-diminishing-returns.md, coulomb-social/docs/adr/ADR-0004-content-plane-thin-git-upgrades.md, glas-harness/docs/adr/ADR-004-composable-reins-stay-deferred.md, kaizen-agentic/docs/adr/ADR-004-project-metrics-convention.md, railiance-hosts/docs/adr/ADR-004-forgejo-in-cluster-actions-runner.md, railiance-infra/docs/adr/ADR-004-forgejo-in-cluster-actions-runner.md, railiance-master/docs/adr/ADR-0004-first-wave-reef-rollout.md, rapp-postgres/docs/adr/ADR-0004-platform-pg-cell-ceiling.md, the-custodian/canon/architecture/adr-004-connectivity-first-network-posture.md
|
||||
- `ADR-0005`: activity-core/docs/adr/adr-005-ops-runs-vs-dev-work-records.md, kaizen-agentic/docs/adr/ADR-005-scheduled-agent-execution.md, railiance-infra/docs/adr/ADR-005-k3s-api-tunnel-only.md, railiance-master/docs/adr/ADR-0005-derived-rail-composition.md, the-custodian/canon/architecture/adr-005-cross-repo-workplans-project-repos.md
|
||||
- `ADR-0006`: kaizen-agentic/docs/adr/ADR-006-customer-engagement-convention.md, net-kingdom/docs/adr/ADR-0006-recursive-multi-tenant-identity-authorization.md, railiance-master/docs/adr/ADR-0006-reef-production-admission.md, the-custodian/canon/architecture/adr-006-canon-federation-concept-ownership.md
|
||||
- `ADR-0007`: kaizen-agentic/docs/adr/ADR-007-forward-deployed-engagement-convention.md, net-kingdom/docs/adr/ADR-0007-security-orchestration-boundary.md, railiance-master/docs/adr/ADR-0007-rapp-declaration-contract.md, the-custodian/canon/architecture/adr-007-workplan-identity-and-repo-worker-topology.md
|
||||
- `ADR-0008`: net-kingdom/docs/adr/ADR-0008-object-storage-sts-credential-vending.md, railiance-master/docs/adr/ADR-0008-private-by-default-exposure.md, the-custodian/canon/architecture/adr-008-multi-tenancy-model.md
|
||||
- `ADR-0010`: net-kingdom/docs/adr/ADR-0010-orchestration-vs-dependency-self-coherent-intent.md, the-custodian/canon/architecture/adr-010-hub-authority-and-local-cache-model.md
|
||||
- `ADR-0011`: net-kingdom/docs/adr/ADR-0011-iam-profile-ownership-and-version-governance.md, the-custodian/canon/architecture/adr-011-federated-namespaces-and-reconciliation-limits.md
|
||||
|
||||
## Missing files
|
||||
|
||||
None.
|
||||
4742
docs/adr-review/ledger.json
Normal file
4742
docs/adr-review/ledger.json
Normal file
File diff suppressed because it is too large
Load diff
83
docs/adr-review/protocol.md
Normal file
83
docs/adr-review/protocol.md
Normal file
|
|
@ -0,0 +1,83 @@
|
|||
# ADR review protocol
|
||||
|
||||
Working protocol for POLICY-NEXUS-WP-0003. The ledger in this directory
|
||||
is a work artefact. It is not published on `policy.coulomb.social`.
|
||||
|
||||
Input is `source-inventory.json` only. Do not rediscover by glob.
|
||||
|
||||
Refresh the ledger with:
|
||||
|
||||
```sh
|
||||
python3 tools/adr_review_ledger.py
|
||||
```
|
||||
|
||||
## Authority
|
||||
|
||||
- The **owning repo** decides whether an ADR still governs and writes
|
||||
the cleanup.
|
||||
- **the-custodian** decides estate-level canon.
|
||||
- **This repo** records the review and publishes. It does not edit
|
||||
another repo's ADR body.
|
||||
|
||||
## Review dispositions
|
||||
|
||||
Every inventoried source that is not already `published` gets exactly
|
||||
one proposed disposition. `unreviewed` means T02 has mapped the file
|
||||
and T03/T04 have not yet ruled.
|
||||
|
||||
| Disposition | Meaning | Publication |
|
||||
| --- | --- | --- |
|
||||
| `unreviewed` | Facts recorded; relevance not ruled. | no |
|
||||
| `publish` | Still governs. Front-matter complete. | `publication.json` entry |
|
||||
| `superseded` | Replaced. Point at the successor. | only if a public URL exists or the successor needs the pointer live |
|
||||
| `withdrawn` | No longer governs, no successor. | same as superseded |
|
||||
| `local` | Useful in its repo, not governing for anyone else. | inventory `excluded` |
|
||||
| `conflict` | Contradicts another ADR or the estate arc42; owner has not ruled. | no |
|
||||
|
||||
## Conflict kinds
|
||||
|
||||
1. **Identifier collision** — same publication `id`, or the same bare
|
||||
`ADR-NNNN` in two repos. Publication ids must be globally unique.
|
||||
2. **Status lie** — body says superseded/relocated, front-matter still
|
||||
`accepted` (or the reverse).
|
||||
3. **Missing successor** — status `superseded` with no target.
|
||||
4. **Contradicting decisions** — two accepted ADRs that cannot both be
|
||||
true.
|
||||
5. **Architecture miss** — an accepted ADR that the matching first-wave
|
||||
arc42 does not mention in chapter 9. Waits on WP-0002-T04/T05.
|
||||
6. **Duplicate claim** — two documents claiming to be the current
|
||||
decision on the same question.
|
||||
|
||||
## Ledger row
|
||||
|
||||
`ledger.json` holds one object per inventory source.
|
||||
|
||||
| Field | Set by | Meaning |
|
||||
| --- | --- | --- |
|
||||
| `source_repo`, `source_path` | inventory | Identity |
|
||||
| `inventory_disposition`, `inventory_reason` | inventory | Current source-inventory state |
|
||||
| `file_present` | T02 | Source file readable in the sibling checkout |
|
||||
| `frontmatter` | T02 | Parsed fields used by the builder |
|
||||
| `missing_fields` | T02 | Publication-contract gaps |
|
||||
| `bare_adr` | T02 | `ADR-NNNN` extracted from id or filename, if any |
|
||||
| `id_collisions` | T02 | Other sources sharing the same front-matter `id` |
|
||||
| `bare_adr_collisions` | T02 | Other sources sharing the same bare `ADR-NNNN` |
|
||||
| `notes` | T02 | Known specials |
|
||||
| `proposed_disposition` | T03/T04 | Review ruling; `unreviewed` until then |
|
||||
| `conflict_kinds` | T03 | List of kind numbers, or empty |
|
||||
| `successor` | T03/T04 | Target when superseded |
|
||||
| `review_notes` | T03/T04 | One-sentence contradiction or rationale |
|
||||
|
||||
T02 fills facts and leaves `proposed_disposition` as `unreviewed`
|
||||
except for the first publish set named in WP-0003 (this repo's
|
||||
ADR-0001 and the eight railiance-master ADRs), which start as
|
||||
`publish` because they are already relevance-obvious.
|
||||
|
||||
## First publish set
|
||||
|
||||
- `policy-nexus` `docs/adr/ADR-0001-addressing-and-permanence.md`
|
||||
- `railiance-master` `docs/adr/ADR-0001` through `ADR-0008`
|
||||
|
||||
Known duplicate-claim candidate: custodian
|
||||
`canon/architecture/adr-008-multi-tenancy-model.md` vs published
|
||||
Tenancy Posture.
|
||||
Loading…
Add table
Add a link
Reference in a new issue