tigrbl · cobycloud · Apr 15, 2026 · Apr 15, 2026
diff --git a/.ssot/adr/ADR-0001-canonical-json-registry.md b/.ssot/adr/ADR-0001-canonical-json-registry.md
@@ -0,0 +1,11 @@
+# ADR-0001: Canonical registry is a single JSON document
+
+## Status
+Accepted
+
+## Decision
+The only authored machine-readable source of truth is `.ssot/registry.json`.
+
+## Consequences
+- Split manifests, spreadsheets, and parallel mapping files are non-canonical.
+- Reports, graphs, CSV projections, Markdown summaries, and SQLite mirrors are generated.
diff --git a/.ssot/adr/ADR-0002-features-are-targetable-units.md b/.ssot/adr/ADR-0002-features-are-targetable-units.md
@@ -0,0 +1,11 @@
+# ADR-0002: Features are the targetable units
+
+## Status
+Accepted
+
+## Decision
+Features are the only targetable implementation units. There is no separate `targets[]` section.
+
+## Consequences
+- Planning horizon and target claim tier live on feature rows.
+- Scope is defined by selected feature IDs inside boundaries.
diff --git a/.ssot/adr/ADR-0003-issues-are-plannable-work-items.md b/.ssot/adr/ADR-0003-issues-are-plannable-work-items.md
@@ -0,0 +1,11 @@
+# ADR-0003: Issues are plannable work items
+
+## Status
+Accepted
+
+## Decision
+Issues and tickets can be planned as current, next, future, explicit, backlog, or out-of-bounds, but they are not substitute targets for features.
+
+## Consequences
+- Delivery scope and remediation scope remain distinct.
+- Issues may still block certification and release.
diff --git a/.ssot/adr/ADR-0004-entity-centric-registry-derived-graph.md b/.ssot/adr/ADR-0004-entity-centric-registry-derived-graph.md
@@ -0,0 +1,11 @@
+# ADR-0004: Entity-centric registry with a derived graph export
+
+## Status
+Accepted
+
+## Decision
+The canonical registry is entity-centric JSON with explicit references. A graph export is derived from it.
+
+## Consequences
+- Authoring stays practical in Git.
+- Programmatic graph traversal remains available.
diff --git a/.ssot/adr/ADR-0005-normalized-prefixed-ids.md b/.ssot/adr/ADR-0005-normalized-prefixed-ids.md
@@ -0,0 +1,11 @@
+# ADR-0005: Normalized prefixed IDs
+
+## Status
+Accepted
+
+## Decision
+Every first-class entity uses a normalized prefixed ID.
+
+## Consequences
+- Stable references across repositories and generated artifacts.
+- Easy namespace validation and filesystem-safe projection.
diff --git a/.ssot/adr/ADR-0006-claim-status-vs-tier.md b/.ssot/adr/ADR-0006-claim-status-vs-tier.md
@@ -0,0 +1,11 @@
+# ADR-0006: Claim status and claim tier are orthogonal
+
+## Status
+Accepted
+
+## Decision
+Claim status expresses lifecycle progression. Claim tier expresses assurance strength.
+
+## Consequences
+- Workflow and assurance are not conflated.
+- Tiers remain stable while statuses advance.
diff --git a/.ssot/adr/ADR-0007-feature-implementation-vs-lifecycle.md b/.ssot/adr/ADR-0007-feature-implementation-vs-lifecycle.md
@@ -0,0 +1,11 @@
+# ADR-0007: Feature implementation state is separate from lifecycle state
+
+## Status
+Accepted
+
+## Decision
+`implementation_status` and `lifecycle.stage` are distinct fields.
+
+## Consequences
+- Deprecation, obsolescence, and removal are modeled cleanly.
+- Implementation readiness is not overloaded with support-state semantics.
diff --git a/.ssot/adr/ADR-0008-immutable-boundary-and-release-snapshots.md b/.ssot/adr/ADR-0008-immutable-boundary-and-release-snapshots.md
@@ -0,0 +1,11 @@
+# ADR-0008: Immutable boundary and release snapshots
+
+## Status
+Accepted
+
+## Decision
+Frozen boundaries and promoted/published releases emit immutable snapshots with hashes.
+
+## Consequences
+- Auditable, reproducible release state.
+- Clear separation between authored truth and frozen evidence.
diff --git a/.ssot/adr/ADR-0009-fail-closed-guards.md b/.ssot/adr/ADR-0009-fail-closed-guards.md
@@ -0,0 +1,11 @@
+# ADR-0009: Fail-closed guards
+
+## Status
+Accepted
+
+## Decision
+Validation, certification, promotion, publication, and lifecycle transitions refuse to proceed on guard violations.
+
+## Consequences
+- No silent drift.
+- No optimistic release progression.
diff --git a/.ssot/adr/ADR-0010-generated-projections-are-non-canonical.md b/.ssot/adr/ADR-0010-generated-projections-are-non-canonical.md
@@ -0,0 +1,11 @@
+# ADR-0010: Generated projections are non-canonical
+
+## Status
+Accepted
+
+## Decision
+DOT, JSON graph exports, CSV files, Markdown summaries, and SQLite mirrors are generated views.
+
+## Consequences
+- Canonical authorship remains singular.
+- Regeneration is deterministic.
diff --git a/.ssot/adr/ADR-0011-explicit-schema-versioning.md b/.ssot/adr/ADR-0011-explicit-schema-versioning.md
@@ -0,0 +1,11 @@
+# ADR-0011: Explicit schema versioning
+
+## Status
+Accepted
+
+## Decision
+Breaking schema changes increment `schema_version` and require migration.
+
+## Consequences
+- No compatibility shims.
+- No ambiguous reader behavior.
diff --git a/.ssot/adr/ADR-0012-portable-core-repo-specific-evidence-adapters.md b/.ssot/adr/ADR-0012-portable-core-repo-specific-evidence-adapters.md
@@ -0,0 +1,11 @@
+# ADR-0012: Portable core with repo-specific evidence generation outside the core
+
+## Status
+Accepted
+
+## Decision
+The core package validates and governs the registry graph, while repository-specific evidence generation remains external or adapter-driven.
+
+## Consequences
+- The package stays portable.
+- Evidence generation does not hard-code repository-specific build logic.
diff --git a/docs/adr/0001-preserve-asgi-boundary.md → .ssot/adr/ADR-1001-preserve-asgi-boundary.md b/docs/adr/0001-preserve-asgi-boundary.md → .ssot/adr/ADR-1001-preserve-asgi-boundary.md
@@ -1,4 +1,6 @@
-# ADR 0001 — preserve the ASGI boundary
+# ADR-1001: preserve the ASGI boundary
+
+# ADR 1001 — preserve the ASGI boundary
 
 Decision: TigrCorn remains an ASGI server at its public boundary.
 

diff --git a/...adr/0002-transport-protocol-separation.md → ...ADR-1002-transport-protocol-separation.md b/...adr/0002-transport-protocol-separation.md → ...ADR-1002-transport-protocol-separation.md
@@ -1,4 +1,6 @@
-# ADR 0002 — separate transport and protocol
+# ADR-1002: separate transport and protocol
+
+# ADR 1002 — separate transport and protocol
 
 Decision: transport code and protocol code live in separate module trees.
 

diff --git a/docs/adr/0003-scheduler-and-backpressure.md → ...dr/ADR-1003-scheduler-and-backpressure.md b/docs/adr/0003-scheduler-and-backpressure.md → ...dr/ADR-1003-scheduler-and-backpressure.md
@@ -1,4 +1,6 @@
-# ADR 0003 — scheduler and backpressure are separate concerns
+# ADR-1003: scheduler and backpressure are separate concerns
+
+# ADR 1003 — scheduler and backpressure are separate concerns
 
 Decision: concurrency and flow control belong in explicit scheduler and flow modules.
 

diff --git a/docs/adr/0004-custom-scope-types.md → .ssot/adr/ADR-1004-custom-scope-types.md b/docs/adr/0004-custom-scope-types.md → .ssot/adr/ADR-1004-custom-scope-types.md
@@ -1,4 +1,6 @@
-# ADR 0004 — custom scope types are allowed behind the ASGI surface
+# ADR-1004: custom scope types are allowed behind the ASGI surface
+
+# ADR 1004 — custom scope types are allowed behind the ASGI surface
 
 Decision: custom transports may expose custom scope types in the future.
 

diff --git a/docs/adr/0005-doc-gov.md → .ssot/adr/ADR-1005-doc-gov.md b/docs/adr/0005-doc-gov.md → .ssot/adr/ADR-1005-doc-gov.md
@@ -1,4 +1,6 @@
-# ADR 0005 — doc governance tree
+# ADR-1005: doc governance tree
+
+# ADR 1005 — doc governance tree
 
 ## Status
 

diff --git a/docs/adr/0006-mutable.md → .ssot/adr/ADR-1006-mutable.md b/docs/adr/0006-mutable.md → .ssot/adr/ADR-1006-mutable.md
@@ -1,4 +1,6 @@
-# ADR 0006 — mutable and immutable marks
+# ADR-1006: mutable and immutable marks
+
+# ADR 1006 — mutable and immutable marks
 
 ## Status
 

diff --git a/docs/adr/0007-gov-auth.md → .ssot/adr/ADR-1007-gov-auth.md b/docs/adr/0007-gov-auth.md → .ssot/adr/ADR-1007-gov-auth.md
@@ -1,4 +1,6 @@
-# ADR 0007: Governance Authority
+# ADR-1007: : Governance Authority
+
+# ADR 1007: Governance Authority
 
 Status: accepted
 

diff --git a/docs/adr/0008-gate-graph.md → .ssot/adr/ADR-1008-gate-graph.md b/docs/adr/0008-gate-graph.md → .ssot/adr/ADR-1008-gate-graph.md
@@ -1,4 +1,6 @@
-# ADR 0008: Release Gate Graph
+# ADR-1008: : Release Gate Graph
+
+# ADR 1008: Release Gate Graph
 
 Status: accepted