diff --git a/.claude/rules/session-protocol.md b/.claude/rules/session-protocol.md
index 5bcebbc..d7f51bb 100644
--- a/.claude/rules/session-protocol.md
+++ b/.claude/rules/session-protocol.md
@@ -42,6 +42,14 @@ ls workplans/
 For each file with `status: ready`, `active`, or `blocked`, note pending
 `wait`/`todo`/`progress` tasks.
 
+Optional quality debt (STATE-WP-0077):
+```bash
+statehub quality-debt --repo-path .
+```
+Prefer **DoR-Ok** before heavy implementation on ready plans; **DoC-Ok** before
+confident intake promote; record with `quality_dor` / `quality_doc` /
+`quality_dod` fields — see `docs/work-record-quality-gates.md`.
+
 **Step 4 — Present brief**
 
 1. **Active workplans** for `infotech` — title, task counts, blocking decisions
diff --git a/.custodian-brief.md b/.custodian-brief.md
index 7c62258..853aa59 100644
--- a/.custodian-brief.md
+++ b/.custodian-brief.md
@@ -2,25 +2,25 @@
 # Custodian Brief — state-hub
 
 **Domain:** infotech  
-**Last synced:** 2026-07-10 13:22 UTC  
+**Last synced:** 2026-09-14 08:15 UTC  
 **State Hub:** http://127.0.0.1:8000 *(adjust if running on a remote machine)*
 
 ## Active Workstreams
 
-### Workplan terminology phase-2 legacy retirement
-Progress: 2/5 done  |  workplan_id: `9aa92529-6ee8-4b3f-b573-78b0ef8d9788`
+### State Hub retirement strangler and disposition execution
+Progress: 4/9 done  |  workplan_id: `ed077b62-7048-5752-bf65-f90471f45854`
 
 **Open tasks:**
-- ► Task: MCP alias removal (Phase 2)  `e2b9015a`
-- ► Task: Internal dual-key and param alias cleanup  `18af98bf`
-- · Task: Closeout and fleet gate  `dcc81665`
+- ! Execute move/replace slices  `3a454438`
+- ! Retire legacy surfaces  `f6cf8c01`
+- ! Stabilization window and archive prep  `9230c99b`
+- ! Attribute and finish migrating remaining legacy readers  `2ac16837`
+- ! Gate the production inbox reader switch  `da1d9a95`
 
 ## Inbox Hygiene
 
-**Stale unread:** 4 message(s) older than 3 day(s) — triage at session start.
-**Missing thread_id:** 4 unread message(s) lack supersession chains.
-- ! activity-core: Optional pattern suggestion: standardized deployment evidence handoff  `10d37752`
-- ! inter-hub: Suggestion: document cross-repo coordination in State Hub suggestions handling  `6e8510b1`
+**Stale unread:** 2 message(s) older than 3 day(s) — triage at session start.
+**Missing thread_id:** 1 unread message(s) lack supersession chains.
 
 ---
 ## MCP Orientation (when available)
diff --git a/.env.example b/.env.example
index 3c94cbf..7d011c3 100644
--- a/.env.example
+++ b/.env.example
@@ -12,6 +12,13 @@ PGADMIN_PASSWORD=admin
 # API
 API_BASE=http://127.0.0.1:8000
 
+# Read-only activity-core ops_run projection (STATE-WP-0078).
+ACTIVITY_CORE_URL=http://127.0.0.1:8010
+# Inject from OpenBao/ESO in production; never commit the value.
+ACTIVITY_CORE_WORKER_TOKEN=
+OPS_RUN_PROJECTION_TTL_SECONDS=15
+OPS_RUN_SLA_HOURS=1
+
 # Gitea (for gitea_inventory.py)
 GITEA_URL=http://92.205.130.254:32166
 GITEA_TOKEN=
diff --git a/.forgejo/workflows/image.yaml b/.forgejo/workflows/image.yaml
index 3dc9af2..d99cd16 100644
--- a/.forgejo/workflows/image.yaml
+++ b/.forgejo/workflows/image.yaml
@@ -9,11 +9,24 @@ on:
   push:
     branches:
       - main
+    # Must list every path the Dockerfile COPYs, or a change ships to git
+    # without ever reaching the image. This previously covered only api/**,
+    # so edits to mcp_server/ and — more seriously — migrations/ produced no
+    # rebuild (CUST-WP-0067-T08).
     paths:
       - ".forgejo/workflows/image.yaml"
       - "Dockerfile"
+      - "alembic.ini"
       - "api/**"
+      - "flows/**"
+      - "mcp_server/**"
+      - "migrations/**"
+      - "policies/**"
+      - "prompts/**"
       - "pyproject.toml"
+      - "scripts/**"
+      - "task_flow_engine/**"
+      - "templates/**"
       - "uv.lock"
   workflow_dispatch:
 
diff --git a/.gitignore b/.gitignore
index 4b8a2da..4c0f900 100644
--- a/.gitignore
+++ b/.gitignore
@@ -18,6 +18,7 @@ __pycache__/
 .pytest_cache/
 .mypy_cache/
 .ruff_cache/
+/docs/architecture/.ast_cache/
 .coverage
 .coverage.*
 htmlcov/
diff --git a/AGENTS.md b/AGENTS.md
index 1daf1e5..2bbd630 100644
--- a/AGENTS.md
+++ b/AGENTS.md
@@ -13,13 +13,15 @@
 
 ## State Hub Integration
 
-The Custodian State Hub tracks work across all domains. Interact via HTTP REST —
-there is no MCP server for Codex agents.
+The Custodian State Hub tracks work across all domains. Codex uses HTTP REST and
+the `statehub` CLI by default. MCP is opt-in because the current Codex MCP bridge
+adds severe call latency; the full administrative MCP surface remains available
+to clients that need it.
 
 | Context | URL |
 |---------|-----|
 | Local workstation | `http://127.0.0.1:8000` |
-| Remote via tunnel | `http://127.0.0.1:18000` |
+| Remote (railiance01, in-cluster) | `http://10.43.68.154:8000` |
 | Optional local edge relay | http://127.0.0.1:18080 |
 
 When an operator has enabled the edge relay, set API_BASE to the relay URL.
@@ -27,21 +29,46 @@ Queueable writes return an explicit queued receipt if the central hub is
 unreachable. Treat that as pending local evidence, then ask the operator to run
 statehub outbox status/replay after connectivity returns.
 
+Codex workspace-write sandboxes need network access enabled to reach the host's
+loopback listener. Bootstrap this once with `make -C ~/state-hub configure-codex`
+and restart Codex. The canonical REST health endpoint is `/state/health`, not
+`/health`. If a sandboxed loopback probe fails, retry it with escalated execution
+before declaring State Hub unavailable; a managed Codex permission profile may
+still enforce isolated networking. Experimental MCP can be enabled explicitly
+with `make -C ~/state-hub configure-codex WITH_MCP=1`.
+
 ### Orient at session start
 
 ```bash
 # Offline brief — works without hub connection
 cat .custodian-brief.md
 
-# Active workplans for this domain
+# Active workplans for this domain (default summary omits flavor: residual)
 curl -s "http://127.0.0.1:8000/workplans/?topic_id=cee7bedf-2b48-46ef-8601-006474f2ad7a&status=active" \
   | python3 -m json.tool
+# Residuals are not implementation demand unless promoted:
+# GET /state/summary  (open_workplans omits flavor=residual)
+# GET /workplans/?flavor=residual
 
 # Check inbox
 curl -s "http://127.0.0.1:8000/messages/?to_agent=state-hub&unread_only=true" \
   | python3 -m json.tool
+
+# Optional: DoX quality debt (ready without DoR-Ok, finished without DoD-Ok, …)
+statehub quality-debt --repo-path .
 ```
 
+### Definition quality (DoC / DoR / DoD)
+
+Lifecycle `status` is independent of quality badges. Prefer:
+
+- **DoC-Ok** on intakes before confident promote (`quality_doc` or note)
+- **DoR-Ok** on workplans/tasks before heavy implementation (`quality_dor`)
+- **DoD-Ok** when claiming quality-complete finish (`quality_dod`)
+
+Recording form and examples: `docs/work-record-quality-gates.md`.
+Policies: `policies/intake-doc.md`, `work-item-dor.md`, `workstream-dod.md`.
+
 Mark a message read:
 ```bash
 curl -s -X PATCH "http://127.0.0.1:8000/messages/<id>/read" \
@@ -97,13 +124,19 @@ curl -s -X PATCH "http://127.0.0.1:8000/tasks/<task_id>" \
 
 **Close:**
 1. Update workplan file task statuses to reflect progress
-2. Log: `POST /progress/` with a summary of what changed
-3. After workplan file changes, run:
+2. If finishing a workplan: hand off **residuals** as live work records first
+   (intake with `origin: residual` + `origin_ref: <WP-id>`, or a next workplan /
+   decision / engagement). Do not park leftovers only in prose or `SCOPE.md`.
+   Canon: `the-custodian/canon/standards/work-record-types_v0.1.md` § Residuals.
+3. Log: `POST /progress/` with a summary of what changed (name handoff ids)
+4. After workplan file changes, run the fast authoritative projection path:
    ```bash
-   statehub fix-consistency
+   uv run --project ~/repo-manager rmgr sync --path . --push
    ```
-   Coding agents should run this directly; ask the operator only if the CLI or
-   State Hub API is unavailable. This syncs task status from files into the hub DB.
+   This assigns only missing deterministic identifiers, verifies the pushed
+   Forgejo commit, verifies `primary/railliance01`, and reconciles the repository
+   in one request. A queued result is pending evidence; retry after connectivity
+   returns. Run `statehub fix-consistency` separately when a deep audit is needed.
 
 ---
 
@@ -176,9 +209,12 @@ read/cache/index layer that rebuilds from files.
 the completion/archive date; the frontmatter `id` does not change.
 
 **Ad Hoc Tasks:** small opportunistic fixes discovered during a session use
-`workplans/ADHOC-YYYY-MM-DD.md` with task ids `ADHOC-YYYY-MM-DD-T01`, etc. Use
-this only for low-risk work completed directly; create a normal workplan for
-anything needing analysis, design, approval, dependencies, or multiple phases.
+`workplans/ADHOC-YYYY-MM-DD.md`, workplan id
+`STATE-WP-ADHOC-YYYY-MM-DD`, and task ids
+`STATE-WP-ADHOC-YYYY-MM-DD-T01`, etc. Unqualified historic `ADHOC-*` ids are
+grandfathered and must not be copied into new records. Use this only for
+low-risk work completed directly; create a normal workplan for anything needing
+analysis, design, approval, dependencies, or multiple phases.
 
 **Frontmatter:**
 
@@ -194,7 +230,7 @@ owner: codex
 topic_slug: ...
 created: "YYYY-MM-DD"
 updated: "YYYY-MM-DD"
-state_hub_workstream_id: "<uuid>"   # written by fix-consistency — do not edit
+state_hub_workstream_id: "<uuid>"   # deterministic UUIDv5; managed by Repo Manager
 ---
 ```
 
@@ -211,7 +247,7 @@ derived health labels, not frontmatter statuses.
 id: STATE-WP-NNNN-T01
 status: wait | todo | progress | done | cancel
 priority: high | medium | low
-state_hub_task_id: "<uuid>"         # written by fix-consistency — do not edit
+state_hub_task_id: "<uuid>"         # deterministic UUIDv5; managed by Repo Manager
 ` ` `
 
 Task description text.
@@ -219,7 +255,19 @@ Task description text.
 
 Status progression: `todo` → `progress` → `done`; use `wait` for waiting/blocked work and `cancel` for stopped work.
 
+**Residuals when finishing:** actionable leftovers become live work records
+before `status: finished` — usually an intake (`origin: residual`,
+`origin_ref: STATE-WP-NNNN`) or a spawned workplan. Residual is a *role*,
+not a kind. Fleet list lives on State Hub, not in `SCOPE.md`.
+
 To create a new workplan:
 1. Write the file following the format above
-2. Run `statehub fix-consistency` locally; ask the operator only if the CLI or
-   State Hub API is unavailable.
+2. Run `uv run --project ~/repo-manager rmgr sync --path . --push`.
+3. Use `statehub fix-consistency` only for a separate deep consistency audit.
+
+## Repository / cluster boundary
+
+Workstation agents commit and push to Forgejo. Cluster infrastructure reads a
+verified Forge commit into ephemeral storage. Neither side reads or writes the
+other side's checkout. `local_path` and `host_paths` are host observations, not
+central storage configuration. See `docs/adr/ADR-002-forge-repository-boundary.md`.
diff --git a/Dockerfile b/Dockerfile
index b1cfbd3..5833f0f 100644
--- a/Dockerfile
+++ b/Dockerfile
@@ -39,6 +39,9 @@ COPY policies/ ./policies/
 COPY prompts/ ./prompts/
 COPY scripts/ ./scripts/
 COPY task_flow_engine/ ./task_flow_engine/
+# ACTIVITY-WP-0021 / ROS hourly: domain-digest.md must exist at
+# templates/recently-on-scope/ for /recently-on-scope/hourly rendering.
+COPY templates/ ./templates/
 
 EXPOSE 8000
 
diff --git a/INTENT.md b/INTENT.md
index 18b9cfa..de2fa78 100644
--- a/INTENT.md
+++ b/INTENT.md
@@ -9,6 +9,26 @@ updated: "2026-05-17"
 > This file explains why State Hub exists, where its authority begins and ends,
 > and why it is now separate from the-custodian.
 
+## Retirement status
+
+State Hub is a legacy service in active retirement planning. It remains
+operational during the migration, but it is not the target home for new
+cross-domain capabilities.
+
+The replacement program is coordinated in
+`/home/worsch/prj-state-hub-retirement`, whose `GOAL.md` defines the migration
+and retirement gates. Repository representation, file-backed record indexing,
+consistency reconciliation, and governed repository changes are moving toward
+`/home/worsch/repo-manager`. Cross-domain identity, communication, interaction,
+state projections, telemetry, and domain-extension composition are moving
+toward the consolidated `hub-core` framework.
+
+Until the retirement gates are met, State Hub remains authoritative only where
+the current contracts and repository-backed workflows require it. Changes made
+during this period should preserve compatibility, enable extraction, reduce
+scope, or address operational risk; they should not establish new permanent
+architectural ownership here.
+
 ---
 
 ## Why it exists
@@ -126,4 +146,3 @@ visible rather than fail opaquely when one component is unavailable.
 
 **Narrow authority.** State Hub coordinates and exposes state; it does not make
 irreversible human decisions or become the owner of every adjacent system.
-
diff --git a/LICENSE b/LICENSE
index a4e9dc9..7e08e28 100644
--- a/LICENSE
+++ b/LICENSE
@@ -1,16 +1,151 @@
-MIT No Attribution
+# Target Revenue Source License
 
-Copyright <YEAR> <COPYRIGHT HOLDER>
+**Version 1.0, Candidate 1 (V1C1)**
 
-Permission is hereby granted, free of charge, to any person obtaining a copy of this
-software and associated documentation files (the "Software"), to deal in the Software
-without restriction, including without limitation the rights to use, copy, modify,
-merge, publish, distribute, sublicense, and/or sell copies of the Software, and to
-permit persons to whom the Software is furnished to do so.
+---
 
-THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR IMPLIED,
-INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, FITNESS FOR A
-PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT
-HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION
-OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE
-SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.
+> **PRELIMINARY CANDIDATE — SUBJECT TO CHANGE — NOT FINAL**
+>
+> This repository is governed by the Target Revenue Source License
+> (TRSL), Version 1, Candidate 1. This is the framework's first working
+> candidate, adopted as the org's preliminary operating license across
+> all repos (maintainer decision, 2026-07-29) during the build/alpha
+> stage — see `SCOPE.md` §1 and Appendix A of the canonical text (link
+> below) for the alpha/beta risk-acceptance decision this reflects and
+> what it does and does not mean. Full specialist legal review is
+> explicitly deferred until the framework moves out of beta.
+>
+> **Canonical source, full candidate-status banner, and Appendix A
+> (non-normative candidate notes tracking every open item):** the
+> `coulomb` org's `target-revenue` repository,
+> `specs/TargetRevenueSourceLicense-V1C1.md` — this file is the operative
+> legal text (Preamble through Section 11) only; the canonical document
+> is authoritative if this copy and that document ever diverge.
+
+---
+
+## Preamble
+
+This Target Revenue Source License ("**License**") governs the Software identified in the applicable Phase Manifest. It implements the Target Revenue Framework: a defined development Phase accumulates Development Credit and Remission Credit against an immutable Initial Target until the Milestone Release automatically and irrevocably converts to a declared permissive Future License.
+
+Commercial beneficiaries fund the creation and early availability of a software improvement; once the declared target is satisfied, the governed release becomes permissively open source.
+
+## 1. Definitions
+
+Capitalized terms used in this License have the meanings given below. Where a term is also defined in the Phase Manifest or Target Ledger for a specific Phase, the Phase Manifest and Target Ledger govern the *values* (amounts, dates, identifiers) and this License governs the *legal effect* of those values — the two must not be read as conflicting definitions of the same concept.
+
+**"Commercial Entitlement"** means a right, purchased or otherwise granted under a Commercial Use Agreement, to make Commercial Use of the Software during a Phase.
+
+**"Commercial Use"** means billing, invoicing, or otherwise charging any customer a fee, subscription, license fee, or other consideration for or in connection with use of the Software, at any time before the Conversion Event for the applicable Phase, regardless of whether the person or organization billed would otherwise qualify for Noncommercial Use. Commercial Use occurs by virtue of such billing alone, whether or not the resulting payment is registered with the Trust Service; in particular, billing a customer for pre-conversion use of the Software without recording the corresponding payment in the applicable Phase's Target Ledger is Commercial Use without a valid Commercial Entitlement — a violation of Section 3, addressed under Section 7 and, where applicable, the Enforcement Network described in the canonical repository's `specs/EnforcementNetworkConcept.md`.
+
+**"Commercial Use Agreement"** means the separate agreement, referenced by the applicable Phase Manifest, under which a Commercial Entitlement is purchased or granted. This License does not itself set pricing, metering, or payment terms — those are governed by the Commercial Use Agreement.
+
+**"Conversion Event"** means the moment the Outstanding Target for a Phase reaches zero, as computed from the Phase Manifest and Target Ledger per the Target Ledger Specification. The Conversion Event occurs automatically and is not conditioned on any declaration, attestation, or other act by the Licensor or any Trust Service.
+
+**"Development Credit"** means the portion of a collected and settled payment explicitly allocated toward satisfying the Initial Target of a specific Phase, as recorded in that Phase's Target Ledger.
+
+**"Future License"** means the permissive license identified in the applicable Phase Manifest, being either the MIT License or the Apache License, Version 2.0, which applies to the Milestone Release upon the Conversion Event.
+
+**"Initial Target"** means the immutable monetary target declared for a Phase in its Phase Manifest.
+
+**"Licensor"** means **Binky Hedgehog GmbH**, the party that publishes the Phase Manifest and holds the rights necessary to grant this License and the Future License for the Milestone Release.
+
+**"Milestone Release"** means the precisely identified software release designated in the applicable Phase Manifest, identified by an immutable source revision, release artifact, or cryptographic digest.
+
+**"Noncommercial Use"** means use of the Software for personal purposes, private study, hobby or amateur projects; use by any charitable organization, educational institution, public research organization, or government institution acting in a non-revenue-generating capacity; or other use of a materially similar character.
+
+**"Outstanding Target"** means, at any time, `max(0, Initial Target − cumulative Development Credit − cumulative Remission Credit)` for a Phase, as computed from that Phase's Target Ledger.
+
+**"Phase"** means a bounded development undertaking governed by one Initial Target, one Milestone Release, one degeneration policy, and one Future License declaration, as declared in a Phase Manifest.
+
+**"Phase Manifest"** means the published, immutable declaration identifying a Phase, its Milestone Release, Initial Target, Future License, degeneration policy, and Target Ledger location, as specified in the Phase Manifest Specification.
+
+**"Remission Credit"** means a transparent, non-revenue reduction of a Phase's Outstanding Target, generated under that Phase's published degeneration policy and recorded in the Target Ledger.
+
+**"Settled Payment"** means a payment that has cleared through its payment processor and is no longer subject to reversal in the ordinary course (chargeback, dispute, or equivalent), as further specified by the applicable Commercial Use Agreement or monetization extension.
+
+**"Software"** means the source code, object code, and associated documentation of the Milestone Release identified in the applicable Phase Manifest.
+
+**"Target Ledger"** means the append-only record of Development Credit, Remission Credit, and correction entries for a Phase, as specified in the Target Ledger Specification.
+
+**"You"** or **"Licensee"** means the individual or entity exercising rights under this License.
+
+## 2. Grant of Rights for Noncommercial Use
+
+Subject to the terms of this License, the Licensor grants You a worldwide, royalty-free, non-exclusive license, during the applicable Phase, to:
+
+(a) use, reproduce, and study the Software for any Noncommercial Use;
+
+(b) modify the Software and create derivative works of it for any Noncommercial Use; and
+
+(c) redistribute the Software and Your modifications, in source or object form, for any Noncommercial Use, provided that You include this License, unmodified, with any such redistribution, and that You do not remove or alter any copyright, patent, trademark, or attribution notices contained in the Software.
+
+This grant does not extend to Commercial Use. Commercial Use requires a Commercial Entitlement under Section 3.
+
+## 3. Commercial Use
+
+You may not make Commercial Use of the Software during the applicable Phase unless You hold a valid, current Commercial Entitlement under a Commercial Use Agreement with the Licensor covering the applicable Phase. A Commercial Entitlement granted under one Phase's Commercial Use Agreement does not extend to a later Phase's Milestone Release unless the Commercial Use Agreement expressly says so.
+
+This Section 3 states the existence and boundary of the commercial-use restriction. It does not itself set pricing, invoicing, metering, audit rights, or payment terms — those are governed exclusively by the applicable Commercial Use Agreement.
+
+## 4. Patent License
+
+Subject to the terms of this License, each contributor to the Software grants You, during the applicable Phase and solely to the extent of rights granted under Sections 2 and 3, a perpetual (subject to the termination below), worldwide, non-exclusive, no-charge, royalty-free patent license to make, have made, use, offer to sell, sell, import, and otherwise transfer the Software, limited to those patent claims licensable by that contributor that are necessarily infringed by their contribution(s) alone or by combination of their contribution(s) with the Software.
+
+If You institute patent litigation against any entity (including a cross-claim or counterclaim in a lawsuit) alleging that the Software or a contribution incorporated within it constitutes direct or contributory patent infringement, then any patent licenses granted to You under this Section 4 for the Software shall terminate as of the date such litigation is filed.
+
+## 5. Automatic Conversion to the Future License
+
+**5.1 Automatic effect.** Upon the Conversion Event for a Phase, the rights and restrictions in Sections 3 (Commercial Use) of this License, as they apply to that Phase's Milestone Release, terminate automatically. In their place, the Milestone Release is licensed under the Future License identified in that Phase's Phase Manifest, effective as of the Conversion Event, without any further act, declaration, or attestation required by the Licensor, any Trust Service, or any other party.
+
+**5.2 Irrevocability.** Once a valid Conversion Event has occurred for a Phase, no subsequent refund, chargeback, accounting correction, dispute, or termination of this License for an unrelated breach shall revoke, suspend, or otherwise impair the Future License grant for that Phase's Milestone Release. Any shortfall or dispute arising after a Conversion Event is a commercial or accounting matter between the relevant parties and does not reinstate a commercial-use restriction over already-converted Software.
+
+**5.3 Prior freedom preserved.** A later Phase covering subsequent improvements to the Software does not restrict, withdraw, or otherwise affect the rights granted under the Future License for an earlier Phase's already-converted Milestone Release.
+
+**5.4 Evidence, not cause.** A Trust Service may publish a Conversion Attestation documenting a Conversion Event. Such an attestation is evidence that the Conversion Event occurred; it is not a condition of, and its absence or delay does not postpone, the automatic effect described in Section 5.1. Any person may independently verify whether a Conversion Event has occurred directly from the Phase Manifest and Target Ledger.
+
+## 6. Successive Phases
+
+The Licensor may declare a new Phase covering subsequent improvements to the Software following a Milestone Release's Conversion Event. Each Phase is independently governed by its own Phase Manifest, Initial Target, degeneration policy, and Target Ledger. Nothing in a later Phase's Phase Manifest may be construed to reduce or withdraw rights already granted under Section 5 for an earlier Phase's Milestone Release.
+
+## 7. Term and Termination
+
+**7.1 Term.** This License applies to the Software for the duration of the applicable Phase, and, for the Milestone Release, indefinitely following that Phase's Conversion Event under the Future License.
+
+**7.2 Termination for breach.** If You breach Section 3 (Commercial Use) or Section 2(c) (redistribution notice requirement), the Licensor may terminate this License as to You. Before such termination becomes effective, the Licensor shall provide You written notice of the breach; if You cure the breach within thirty (30) days of that notice, this License continues in effect. A second breach of the same provision within twelve (12) months may be terminated immediately without a further cure opportunity.
+
+**7.3 Effect of termination.** Termination under this Section 7 affects only Your rights under Sections 2 and 3 for the Phase in which the breach occurred. It does not affect any rights already vested under Section 5 (Automatic Conversion) for a Milestone Release whose Conversion Event has already occurred, per Section 5.2.
+
+**7.4 Public record of breach and resolution.** The Licensor shall cause the Trust Service to publish, as part of the public record for the affected Phase, notice of: (a) any breach notice issued under Section 7.2, stating the general nature of the breach and the date of notice; (b) whether the breach was cured within the applicable cure period, and the date of cure; and (c) any termination determination made under this Section 7, including its effective date and scope. This public record exists to give the ecosystem a transparent, verifiable conformity signal for the Phase, distinct from and in addition to the Development Credit and Remission Credit facts already published under Section 5.4 and the Target Ledger Specification.
+
+A breach that You dispute, and that has not been finally determined, shall be recorded as **alleged**; it shall be recorded as **determined** only once the cure period has run without cure, or the dispute has been resolved against You under the applicable Commercial Use Agreement's dispute process, if any. The Trust Service shall update the record promptly upon resolution in either direction. Recording an alleged or determined breach under this Section 7.4 is a ministerial act of publishing the Licensor's determination (or a dispute process's outcome); it does not give the Trust Service discretionary authority to decide whether a breach occurred, consistent with Section 5.4's evidence-not-cause principle.
+
+Whether, and under what conditions, the public record identifies a Commercial Entitlement holder by name is governed exclusively by the applicable Commercial Use Agreement, which the Licensor and that Commercial Entitlement holder negotiate and agree to directly. This License does not itself set a naming default. Where no Commercial Use Agreement addresses the question, or where the affected party has no Commercial Use Agreement at all (for example, a Section 2(c) breach by a Noncommercial Use licensee), the public record states the Phase and breach category only, without naming the party.
+
+## 8. Disclaimer of Warranty
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE, AND NONINFRINGEMENT. THE LICENSOR DOES NOT WARRANT THAT THE SOFTWARE WILL BE ERROR-FREE OR THAT ANY PHASE WILL REACH ITS CONVERSION EVENT.
+
+## 9. Limitation of Liability
+
+IN NO EVENT SHALL THE LICENSOR OR ANY CONTRIBUTOR BE LIABLE FOR ANY CLAIM, DAMAGES, OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT, OR OTHERWISE, ARISING FROM, OUT OF, OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE, EXCEPT TO THE EXTENT SUCH LIMITATION IS PROHIBITED BY APPLICABLE LAW.
+
+## 10. Trademarks
+
+This License does not grant permission to use the trade names, trademarks, service marks, or product names of the Licensor, except as required for reasonable and customary attribution.
+
+## 11. General Provisions
+
+**11.1 Governing law and venue.** Adopted for alpha/beta 2026-07-29: disputes arising under this License shall be resolved by binding arbitration, seated at a neutral, arbitration-mature venue (Singapore or London are the two candidates concretely supported by current research), rather than by litigation in a national court. The specific arbitral institution and substantive governing law remain a per-deployment blank pending final selection; they are not fixed by this candidate. See the canonical repository's `history/260729-TRSL-Jurisdiction-Synthesis.md` §2.
+
+**11.2 Severability.** If any provision of this License is held unenforceable, the remaining provisions remain in full force, and the unenforceable provision shall be reformed to the minimum extent necessary to make it enforceable.
+
+**11.3 No waiver.** Failure to enforce any provision of this License is not a waiver of future enforcement of that or any other provision.
+
+**11.4 Entire agreement (as to licensing).** This License, together with the applicable Phase Manifest and, where applicable, the Commercial Use Agreement, constitutes the entire agreement between You and the Licensor regarding the Software's licensing terms. Operations, service, and consulting arrangements are governed by separate agreements, if any, and are not part of this License.
+
+**11.5 Definitions control.** Marketing materials, documentation, or other non-normative communications about the Software must not describe pre-Conversion-Event Software as "Open Source," "free software," or "open core." Pre-conversion Noncommercial Use is **source-available**; pre-conversion Commercial Use requires a **Commercial Entitlement**; only post-conversion Software may be described as Open Source, under the Future License.
+
+---
+
+**No Phase is currently declared for this repository under this License.** Until a Phase Manifest is published and registered with the Trust Service for a Milestone Release in this repository, Sections 2–7 above have no operative subject matter here — this License establishes the governing framework in advance of that declaration, consistent with the org-wide rollout decision recorded in `target-revenue`'s `workplans/TREV-WP-0008-governance-and-pilot-rollout.md`.
diff --git a/Makefile b/Makefile
index 887a37c..52c2458 100644
--- a/Makefile
+++ b/Makefile
@@ -1,4 +1,4 @@
-.PHONY: install install-cli dashboard-install dashboard-check db db-tools migrate seed api dashboard check test test-python clean register-project register-codex-project register-mcp bootstrap-env dev-hub edge-relay mcp-profile validate-adr add-domain rename-domain add-repo list-repos register-path register-from-classification register-from-classification-all cleanup-stale tunnels-up tunnels-status tunnels-check bridges install-hooks install-hooks-all gitea-inventory token-reconcile railiance-state-hub-render railiance-state-hub-client-dry-run railiance-state-hub-server-dry-run
+.PHONY: start install install-cli dashboard-install dashboard-check db db-tools migrate seed api dashboard dashboard-local sync check-primary primary-port-clear check check-local test test-python clean register-project register-codex-project register-mcp configure-codex bootstrap-env dev-hub edge-relay mcp-profile validate-adr add-domain rename-domain add-repo list-repos register-path register-from-classification register-from-classification-all cleanup-stale tunnels-up tunnels-status tunnels-check bridges install-hooks install-hooks-all gitea-inventory token-reconcile railiance-state-hub-render railiance-state-hub-client-dry-run railiance-state-hub-server-dry-run railiance-state-hub-headroom
 
 COMPOSE = docker compose -f infra/docker-compose.yml --env-file .env
 PYTHON ?= python3
@@ -9,19 +9,28 @@ RAILIANCE_STATE_HUB_RELEASE ?= state-hub
 RAILIANCE_STATE_HUB_NAMESPACE ?= state-hub
 RAILIANCE_STATE_HUB_CHART ?= deploy/railiance/apps/charts/state-hub
 RAILIANCE_STATE_HUB_VALUES ?= deploy/railiance/apps/helm/state-hub-values.yaml
-RAILIANCE_STATE_HUB_IMAGE_TAG ?= f2e042a
+RAILIANCE_STATE_HUB_IMAGE_TAG ?= main-0747b4d
 RAILIANCE_STATE_HUB_PLATFORM_DIR ?= deploy/railiance/platform
 RAILIANCE_STATE_HUB_APP_MANIFESTS ?= deploy/railiance/apps/manifests
 # Codex/WSL non-login shells may not source ~/.profile; keep uv discoverable.
 UV ?= $(shell command -v uv 2>/dev/null || if [ -x "$$HOME/.local/bin/uv" ]; then printf "%s" "$$HOME/.local/bin/uv"; else printf "%s" "uv"; fi)
+RMGR ?= $(shell command -v rmgr 2>/dev/null || if [ -x "$$HOME/repo-manager/.venv/bin/rmgr" ]; then printf "%s" "$$HOME/repo-manager/.venv/bin/rmgr"; else printf "%s" "rmgr"; fi)
+STATE_HUB_API_BASE ?= http://127.0.0.1:8000
+SYNC_PATH ?= .
+SYNC_PUSH ?= 1
 
 start:
-	@echo "# run in different terminals" 
-	@echo "make db           # docker compose up postgres"
-	@echo "make api          # start backend api"
-	@echo "make mcp-http     # start state-hub mcp service"
-	@echo "make dashboard    # Observable dev server on :3000"
-	@echo "make bridges      # Set up ssh bridges for cross machines access"
+	@echo "# Normal production UI access (run in order)"
+	@echo "make bridges      # connect local :8000 to the railiance01 primary"
+	@echo "make dashboard    # verify the primary, then serve the UI on :3000"
+	@echo "make sync         # push file-backed records and reconcile the exact forge commit"
+	@echo ""
+	@echo "# Optional local MCP adapter"
+	@echo "make mcp-http     # local SSE adapter on :8001; not needed by the UI"
+	@echo ""
+	@echo "# Local fallback/development only"
+	@echo "make api          # local Postgres + API; conflicts with the production :8000 tunnel"
+	@echo "make dashboard-local  # dashboard against the deliberate local API"
 
 install:
 	$(UV) sync
@@ -63,15 +72,80 @@ mcp-http:
 	@fuser -k 8001/tcp 2>/dev/null && echo "Stopped running MCP server" || true
 	MCP_TRANSPORT=sse MCP_PORT=8001 $(UV) run python mcp_server/server.py
 
-dashboard:
+## Require the production identity before serving the normal dashboard. This
+## prevents an accidental local `make api` from presenting an empty fallback DB
+## as the live State Hub.
+check-primary:
+	@health="$$(curl -fsS --max-time 5 http://127.0.0.1:8000/state/health 2>/dev/null)" || { \
+		echo "ERROR: State Hub primary is not reachable on 127.0.0.1:8000." >&2; \
+		echo "Run 'make bridges' first." >&2; \
+		exit 1; \
+	}; \
+	identity="$$(printf '%s' "$$health" | $(PYTHON) -c 'import json, sys; d=json.load(sys.stdin); print("{}/{}".format(d.get("instance_role", ""), d.get("instance_label", "")))')"; \
+	if [ "$$identity" != "primary/railiance01" ]; then \
+		echo "ERROR: 127.0.0.1:8000 is '$$identity', not the primary/railiance01 State Hub." >&2; \
+		echo "Stop the local API, then run 'make bridges'. Use 'make dashboard-local' only for intentional local development." >&2; \
+		exit 1; \
+	fi
+
+## Refuse to start the production tunnel when a non-primary API already owns
+## port 8000. With no listener, bridge is free to establish the tunnel.
+primary-port-clear:
+	@if health="$$(curl -fsS --max-time 2 http://127.0.0.1:8000/state/health 2>/dev/null)"; then \
+		identity="$$(printf '%s' "$$health" | $(PYTHON) -c 'import json, sys; d=json.load(sys.stdin); print("{}/{}".format(d.get("instance_role", ""), d.get("instance_label", "")))')"; \
+		if [ "$$identity" != "primary/railiance01" ]; then \
+			echo "ERROR: port 8000 is occupied by '$$identity'." >&2; \
+			echo "Stop the local 'make api' process before starting the production tunnel." >&2; \
+			exit 1; \
+		fi; \
+	fi
+
+dashboard: check-primary
 	@fuser -k 3000/tcp 2>/dev/null && echo "Stopped running dashboard" || true
 	$(MAKE) dashboard-install
 	cd dashboard && npm run dev
 
-check:
+## Deliberate local-development dashboard; bypasses the production identity gate.
+dashboard-local:
+	@echo "WARNING: serving the dashboard against the local/fallback API on :8000."
+	@fuser -k 3000/tcp 2>/dev/null && echo "Stopped running dashboard" || true
+	$(MAKE) dashboard-install
+	cd dashboard && npm run dev
+
+## Fast work-record path. Repo Manager assigns only missing deterministic IDs,
+## verifies the primary/railliance01 bridge, and asks central to derive the
+## exact pushed Forgejo commit in one transactional request.
+sync:
+	$(RMGR) sync --path "$(SYNC_PATH)" --api-base "$(STATE_HUB_API_BASE)" $(if $(filter 1 true yes,$(SYNC_PUSH)),--push,)
+
+check: check-primary
+	@echo "State Hub primary/railiance01 is healthy."
+
+check-local:
 	curl -sf http://127.0.0.1:8000/state/health | python3 -m json.tool
 
-railiance-state-hub-render:
+# CUST-WP-0067-T09. The chart ships a copy of the-custodian canon allowed-values
+# because a container has no checkout to read it from. Regenerate after any
+# canon vocabulary change; the -check target fails on drift so a release cannot
+# validate classification against a stale vocabulary.
+sync-classification-allowed:
+	python3 scripts/sync_classification_allowed.py
+
+check-classification-allowed:
+	python3 scripts/sync_classification_allowed.py --check
+
+# STATE-WP-0091: read-only surge-headroom check. Does not start Helm.
+# Live: make railiance-state-hub-headroom
+# Fixtures: make railiance-state-hub-headroom HEADROOM_FIXTURE=tests/fixtures/release_headroom/rev63-105m.json
+HEADROOM_FIXTURE ?=
+railiance-state-hub-headroom:
+	@if [ -n "$(HEADROOM_FIXTURE)" ]; then \
+		$(PYTHON) scripts/release_headroom_preflight.py --fixture "$(HEADROOM_FIXTURE)"; \
+	else \
+		$(PYTHON) scripts/release_headroom_preflight.py --kubectl "$(KUBECTL)"; \
+	fi
+
+railiance-state-hub-render: check-classification-allowed
 	$(HELM) template $(RAILIANCE_STATE_HUB_RELEASE) $(RAILIANCE_STATE_HUB_CHART) \
 		--namespace $(RAILIANCE_STATE_HUB_NAMESPACE) \
 		-f $(RAILIANCE_STATE_HUB_VALUES) \
@@ -126,7 +200,7 @@ benchmark-summary-cache:
 
 ## ops-bridge managed tunnels
 ## Requires ops-bridge: bridge is at /home/worsch/.local/bin/bridge
-tunnels-up:
+tunnels-up: primary-port-clear
 	bridge up
 
 tunnels-status:
@@ -139,7 +213,7 @@ tunnels-check:
 
 ## Ensure all ops-bridge tunnels are up and healthy.
 ## Brings up any stopped/stale tunnels, shows final status, exits non-zero if anything is still down.
-bridges:
+bridges: primary-port-clear
 	@echo "==> Bringing up all tunnels..."
 	bridge up
 	@echo ""
@@ -149,9 +223,10 @@ bridges:
 	@echo "==> Checking tunnel health..."
 	bridge check
 
-## Start (or restart) the full backend — db + migrate + uvicorn.
-## Stops uvicorn on :8000 if already running, then starts fresh.
+## Start (or restart) the LOCAL FALLBACK backend — db + migrate + uvicorn.
+## This replaces anything on :8000, including the production State Hub tunnel.
 api: db
+	@echo "WARNING: starting the local fallback API; this is not the railiance01 primary."
 	@echo "Waiting for postgres..."; \
 	for i in 1 2 3 4 5 6 7 8 9 10; do \
 	  nc -z 127.0.0.1 5432 2>/dev/null && break; \
@@ -180,6 +255,14 @@ register-mcp:
 	  $(if $(API_BASE),--api-base "$(API_BASE)",) \
 	  $(if $(DRY_RUN),--dry-run,)
 
+## Configure Codex workspace-write networking for local State Hub access.
+configure-codex:
+	scripts/configure-codex.sh \
+	  $(if $(CODEX_HOME),--codex-home "$(CODEX_HOME)",) \
+	  $(if $(API_BASE),--api-base "$(API_BASE)",) \
+	  $(if $(WITH_MCP),--with-mcp,) \
+	  $(if $(DRY_RUN),--dry-run,)
+
 ## Bootstrap a new operator/collaborator environment. Optional: make bootstrap-env ARGS="--install-missing"
 bootstrap-env:
 	scripts/bootstrap-env.sh $(ARGS)
diff --git a/README.md b/README.md
index 8dbe5b6..7193dbd 100644
--- a/README.md
+++ b/README.md
@@ -64,11 +64,15 @@ then run consistency sync.
 
 All services bind to `127.0.0.1` only — nothing exposed to the network.
 
-**Production:** the primary State Hub API runs on coulombcore-k3s. Workstation
-port `8000` reaches it through the ops-bridge `state-hub-primary` tunnel. See
+**Production:** the primary State Hub API runs in the railiance01-hosted k3s
+cluster. Workstation port `8000` reaches it through the ops-bridge
+`state-hub-primary` tunnel. See
 [`docs/cluster-operating-model.md`](docs/cluster-operating-model.md) for access,
 rollback, backups, and pragmatic limitations.
 
+Repository rename operations use the phased, UUID-preserving workflow in
+[`docs/repository-rename-operations.md`](docs/repository-rename-operations.md).
+
 ---
 
 ## Setup
@@ -79,7 +83,11 @@ rollback, backups, and pragmatic limitations.
 - Python 3.12+ with `uv` (`pip install uv`)
 - Node.js 18+ (dashboard only)
 
-### First-time
+### First-time local development setup
+
+The local database and API are retained for development and disaster fallback.
+They are not the normal production access path and conflict with the production
+tunnel on port `8000`.
 
 ```bash
 cd /home/worsch/state-hub
@@ -89,27 +97,51 @@ make install                  # uv sync
 make db                       # docker compose up postgres
 make migrate                  # alembic upgrade head
 make seed                     # insert 6 canonical topics
-make api                      # db + migrate + uvicorn :8000 (restarts if running)
+make api                      # LOCAL fallback: db + migrate + uvicorn :8000
 ```
 
-### Dashboard
+For a dashboard against that deliberate local backend, use
+`make dashboard-local`.
+
+### Production dashboard (normal operation)
+
+The dashboard remains a workstation process, but its API is the primary State
+Hub on railiance01. Start the tunnel first, then start the dashboard:
 
 ```bash
-make dashboard    # installs dashboard deps if needed, then Observable dev server on :3000
-make dashboard-check  # installs deps if needed, then runs Observable build
+make bridges      # connect workstation :8000 to primary/railiance01
+make dashboard    # verify the primary identity, then serve http://127.0.0.1:3000
 ```
 
-### Start Everything
+`make dashboard` refuses to start if port `8000` is unreachable or identifies
+itself as anything other than `primary/railiance01`. This prevents the empty
+local fallback database from being mistaken for production.
 
-To start all the infrastructure on separate consoles do:
+The MCP adapter is optional and is not required by the dashboard:
 
 ```bash
-make db           # docker compose up postgres
-make mcp-http     # start state-hub mcp service
-make dashboard    # Observable dev server on :3000
-make bridges      # Set up ssh bridges for cross machines access
+make mcp-http     # optional local SSE adapter on :8001
 ```
 
+### Fast work-record synchronization
+
+Workplan files remain authoritative. Repo Manager assigns missing UUIDv5
+identifiers locally, pushes the file commit, and asks the primary State Hub to
+derive that exact commit from Forgejo in one transactional request:
+
+```bash
+make bridges
+make sync
+```
+
+The sync refuses an uncommitted or behind branch and will not write to a local
+empty database: the API must identify itself as `primary/railliance01`. If the
+primary is unavailable, Repo Manager writes an explicit pending receipt under
+the checkout's local `.git/repo-manager/` state; rerunning `make sync` safely
+replays the current pushed state.
+
+Use `statehub fix-consistency` only for the broader consistency/quality audit.
+It is no longer the normal registration and task-update path.
 
 ### CLI
 
@@ -127,17 +159,22 @@ custodian register-project    # register cwd as a Custodian project
 |--------|-------------|
 | `make install` | `uv sync` — install Python deps + entry points |
 | `make install-cli` | Symlink `custodian` to `~/.local/bin` |
-| `make db` | Start postgres container |
+| `make start` | Print the production UI and local fallback startup paths |
+| `make bridges` | Connect managed tunnels, including workstation `:8000` to the railiance01 primary |
+| `make db` | Start the local fallback/development Postgres container |
 | `make db-tools` | Start postgres + pgadmin (http://127.0.0.1:5050) |
 | `make migrate` | `alembic upgrade head` |
 | `make seed` | Insert 6 canonical topics (legacy bootstrap) |
 | `make register-from-classification REPO=slug` | Upsert repo from `.repo-classification.yaml` |
 | `make register-from-classification-all` | Bulk reclassify all repos with classification files |
-| `make api` | `db` + wait + `migrate` + `uvicorn` (restarts if running) |
+| `make api` | Start the local fallback API; replaces the production tunnel on `:8000` |
 | `make dashboard-install` | Install dashboard npm deps from `dashboard/package-lock.json` |
 | `make dashboard-check` | Build the Observable dashboard as a smoke/regression check |
-| `make dashboard` | Install deps if needed, then start Observable dev server (restarts if running) |
-| `make check` | `curl /state/health` |
+| `make dashboard` | Verify `primary/railiance01`, then start the Observable dashboard |
+| `make dashboard-local` | Start the dashboard against an intentional local/fallback API |
+| `make sync` | Push missing deterministic IDs and reconcile this repo from the exact Forgejo commit |
+| `make check` | Require a healthy `primary/railiance01` on workstation `:8000` |
+| `make check-local` | Print `/state/health` without enforcing production identity |
 | `make test` | Python test suite plus `make dashboard-check` |
 | `make register-project DOMAIN=x PROJECT_PATH=y` | Register a project |
 | `make clean` | `docker compose down -v` (destroys DB volume) |
@@ -219,7 +256,7 @@ use `/state/health`, not `/state/summary`.
 |--------|-----------|
 | `/topics` | CRUD (soft-delete: `archived`) |
 | `/workplans` | Preferred CRUD surface for repo-backed workplans (soft-delete: `archived`) |
-| `/workstreams` | Legacy compatibility CRUD surface; usage is recorded by legacy-meter |
+| `/workstreams` | Retired REST routes (410); use `/workplans`. Rejected calls remain metered |
 | `/tasks` | CRUD (soft-delete: `cancel`); `PATCH` updates status |
 | `/decisions` | CRUD (soft-delete: `superseded`); auto-escalation |
 | `/progress` | `GET` list + `POST` append — no DELETE |
@@ -227,7 +264,8 @@ use `/state/health`, not `/state/summary`.
 | `/state/summary` | Full snapshot |
 | `/state/health` | DB connectivity check |
 
-See `docs/workplan-terminology-transition.md` for the workstream-to-workplan
+See `docs/work-record-flavor.md` for flavor buckets and residual
+default-exclusion (STATE-WP-0092). See `docs/workplan-terminology-transition.md` for the workstream-to-workplan
 compatibility policy and retirement criteria.
 
 ---
@@ -285,7 +323,7 @@ Prints API health, totals, and any blocking decisions.
 
 ### What `register-project` does
 
-1. Verifies the API is reachable (fails fast with `make api` hint)
+1. Verifies the API is reachable
 2. Looks up the topic ID for the domain via `/topics/?status=active`
 3. Checks that `state-hub` is in `~/.claude.json`
 4. Writes `$PROJECT_PATH/CLAUDE.md` from `scripts/project_claude_md.template`
diff --git a/SCOPE.md b/SCOPE.md
index 51a2cbb..87155e2 100644
--- a/SCOPE.md
+++ b/SCOPE.md
@@ -2,9 +2,10 @@
 
 ## One-Liner
 
-State Hub is the local-first coordination service for repo-anchored workplans,
+State Hub is the transitional coordination service for repo-anchored workplans,
 tasks, decisions, progress events, repo classification and metadata, MCP
-tooling, and dashboard telemetry.
+tooling, and dashboard telemetry. Its primary runtime is on railiance01; local
+repository files remain authoritative for repository-owned work records.
 
 ## In Scope
 
@@ -23,13 +24,16 @@ tooling, and dashboard telemetry.
 
 | Repo | Role |
 | --- | --- |
-| `hub-core` | Shared library — State Hub mounts router factories and MCP from `hub_core` |
-| `state-hub` | This repo — dev coordination host, workplan file authority |
-| `core-hub` | Production framework — `/api/v2` at `hub.coulomb.social`; does not replace State Hub dev MCP |
+| `hub-core` | Shared library and selected target runtime for capabilities retained after State Hub retirement |
+| `state-hub` | This repo — transitional coordination runtime and read projection; repository files retain work-record authority |
+| `core-hub` | Production `/api/v2` compatibility runtime on railiance01 during consolidation into `hub-core` |
 
 Canon: `/home/worsch/the-custodian/docs/hub-ecosystem-architecture.md`
 
 State Hub does **not** implement Inter-Hub `/api/v2` routes; those belong to core-hub.
+New permanent cross-domain capability should land in its disposition owner, not
+expand State Hub. The retirement program is governed by
+`prj-state-hub-retirement`.
 
 ## Out Of Scope
 
diff --git a/WORK-RECORDS.md b/WORK-RECORDS.md
new file mode 100644
index 0000000..ba57372
--- /dev/null
+++ b/WORK-RECORDS.md
@@ -0,0 +1,365 @@
+# Work Records — state-hub
+
+> Generated by `statehub fix-consistency` (CUST-WP-0061-T04, work-record
+> stage 3). Do not edit by hand — edit the source file/block listed for
+> each record and re-run fix-consistency to refresh this index. Archived
+> workplans are omitted; closed decisions/intakes/engagements stay listed
+> so recently-resolved work is still visible. [auto]
+
+| Kind | ID | Status | Lane | Source |
+| --- | --- | --- | --- | --- |
+| workplan | STATE-WP-ADHOC-2026-06-04 | finished | — | workplans/ADHOC-2026-06-04.md |
+| workplan | STATE-WP-ADHOC-2026-07-01 | finished | — | workplans/ADHOC-2026-07-01.md |
+| workplan | STATE-WP-ADHOC-2026-08-08 | finished | — | workplans/ADHOC-2026-08-08.md |
+| workplan | STATE-WP-ADHOC-2026-08-23 | finished | — | workplans/ADHOC-2026-08-23.md |
+| workplan | STATE-WP-ADHOC-2026-08-30 | finished | — | workplans/ADHOC-2026-08-30.md |
+| workplan | STATE-WP-ADHOC-2026-09-04 | finished | — | workplans/ADHOC-2026-09-04.md |
+| workplan | CUST-WP-0003 | finished | — | workplans/CUST-WP-0003-whi-kpi-card.md |
+| workplan | CUST-WP-0012 | finished | — | workplans/CUST-WP-0012-multi-user-onboarding.md |
+| workplan | CUST-WP-0038 | backlog | — | workplans/CUST-WP-0038-state-hub-threephoenix-ha.md |
+| workplan | CUST-WP-0042 | finished | — | workplans/CUST-WP-0042-workplan-state-model-cleanup.md |
+| workplan | STATE-WP-0043 | finished | — | workplans/STATE-WP-0043-dashboard-ui-experience.md |
+| workplan | STATE-WP-0044 | finished | — | workplans/STATE-WP-0044-recently-on-scope-digest.md |
+| workplan | STATE-WP-0045 | finished | — | workplans/STATE-WP-0045-token-measurement-accuracy.md |
+| workplan | STATE-WP-0046 | finished | — | workplans/STATE-WP-0046-workplan-id-normalization.md |
+| workplan | STATE-WP-0047 | finished | — | workplans/STATE-WP-0047-lifecycle-assertions-and-renormalization.md |
+| workplan | STATE-WP-0048 | finished | — | workplans/STATE-WP-0048-ui-state-change-reconciliation.md |
+| workplan | STATE-WP-0049 | finished | — | workplans/STATE-WP-0049-workplan-execution-queue.md |
+| workplan | STATE-WP-0050 | finished | — | workplans/STATE-WP-0050-railiance-fabric-graph-read-model-ingest.md |
+| workplan | STATE-WP-0051 | finished | — | workplans/STATE-WP-0051-financial-fabric-read-model-adaptation.md |
+| workplan | STATE-WP-0052 | finished | — | workplans/STATE-WP-0052-task-state-canon-adaptation.md |
+| workplan | STATE-WP-0053 | finished | — | workplans/STATE-WP-0053-wsjf-triage-review-page.md |
+| workplan | STATE-WP-0054 | finished | — | workplans/STATE-WP-0054-workplan-terminology-transition-legacy-meter.md |
+| workplan | STATE-WP-0055 | finished | — | workplans/STATE-WP-0055-statehub-register-cli.md |
+| workplan | STATE-WP-0056 | finished | — | workplans/STATE-WP-0056-dashboard-loading-robustness.md |
+| workplan | STATE-WP-0057 | finished | — | workplans/STATE-WP-0057-overview-workstream-stage-counts.md |
+| workplan | STATE-WP-0058 | finished | — | workplans/STATE-WP-0058-agent-skill-hub-interaction.md |
+| workplan | STATE-WP-0059 | finished | — | workplans/STATE-WP-0059-mcp-write-layer-reliability.md |
+| workplan | STATE-WP-0060 | finished | — | workplans/STATE-WP-0060-fix-consistency-cross-flavor.md |
+| workplan | STATE-WP-0062 | finished | — | workplans/STATE-WP-0062-service-catalog-two-dimensions.md |
+| workplan | STATE-WP-0063 | finished | — | workplans/STATE-WP-0063-weekend-automation-repair.md |
+| workplan | STATE-WP-0064 | finished | — | workplans/STATE-WP-0064-statehub-consistency-sync-railiance01.md |
+| workplan | STATE-WP-0065 | finished | — | workplans/STATE-WP-0065-repo-anchored-classification-spine.md |
+| workplan | STATE-WP-0066 | finished | — | workplans/STATE-WP-0066-state-summary-revision-cache.md |
+| workplan | STATE-WP-0067 | finished | — | workplans/STATE-WP-0067-attached-repo-agent-normalization.md |
+| workplan | STATE-WP-0068 | finished | — | workplans/STATE-WP-0068-offline-write-buffer-and-edge-relay.md |
+| workplan | STATE-WP-0071 | finished | — | workplans/STATE-WP-0071-railiance01-workstream-caller-deploy.md |
+| workplan | STATE-WP-0072 | finished | — | workplans/STATE-WP-0072-workstream-caller-remediation.md |
+| workplan | STATE-WP-0073 | finished | — | workplans/STATE-WP-0073-legacy-meter-decline-and-remote-audit.md |
+| workplan | STATE-WP-0074 | finished | — | workplans/STATE-WP-0074-hub-ecosystem-boundary-alignment.md |
+| workplan | STATE-WP-0075 | finished | — | workplans/STATE-WP-0075-workstream-route-410-stranglers.md |
+| workplan | STATE-WP-0076 | finished | — | workplans/STATE-WP-0076-definition-of-ready-and-comprehension.md |
+| workplan | STATE-WP-0077 | finished | — | workplans/STATE-WP-0077-dox-assessment-recording-and-soft-visibility.md |
+| workplan | STATE-WP-0078 | finished | — | workplans/STATE-WP-0078-ops-run-read-projection.md |
+| workplan | STATE-WP-0079 | blocked | — | workplans/STATE-WP-0079-retirement-strangler.md |
+| workplan | STATE-WP-0080 | finished | — | workplans/STATE-WP-0080-register-project-flavor-awareness.md |
+| workplan | STATE-WP-0081 | finished | — | workplans/STATE-WP-0081-cluster-self-sufficiency-and-registrar.md |
+| workplan | STATE-WP-0082 | finished | — | workplans/STATE-WP-0082-multi-owner-review-contracts-and-receipts.md |
+| workplan | STATE-WP-0083 | finished | — | workplans/STATE-WP-0083-forge-derived-projection-reset.md |
+| workplan | STATE-WP-0084 | finished | — | workplans/STATE-WP-0084-forge-read-for-private-repositories.md |
+| workplan | STATE-WP-0085 | finished | — | workplans/STATE-WP-0085-repository-lineage-preserving-rename.md |
+| workplan | STATE-WP-0086 | finished | — | workplans/STATE-WP-0086-fast-forge-projection-reconcile.md |
+| workplan | STATE-WP-0087 | finished | — | workplans/STATE-WP-0087-bounded-repository-collection-projection.md |
+| workplan | STATE-WP-0088 | finished | — | workplans/STATE-WP-0088-preflight-signing-runtime-acceptance.md |
+| workplan | STATE-WP-0089 | finished | — | workplans/STATE-WP-0089-rename-redirect-recovery.md |
+| workplan | STATE-WP-0090 | finished | — | workplans/STATE-WP-0090-projection-task-field-convergence.md |
+| workplan | STATE-WP-0091 | finished | — | workplans/STATE-WP-0091-release-headroom.md |
+| workplan | STATE-WP-0092 | finished | — | workplans/STATE-WP-0092-workplan-flavor-and-depends-on-policy.md |
+| task | STATE-WP-ADHOC-2026-06-04-T01 | done | — | workplans/ADHOC-2026-06-04.md |
+| task | STATE-WP-ADHOC-2026-07-01-T01 | done | — | workplans/ADHOC-2026-07-01.md |
+| task | STATE-WP-ADHOC-2026-07-01-T02 | done | — | workplans/ADHOC-2026-07-01.md |
+| task | STATE-WP-ADHOC-2026-08-08-T01 | done | — | workplans/ADHOC-2026-08-08.md |
+| task | STATE-WP-ADHOC-2026-08-08-T02 | done | — | workplans/ADHOC-2026-08-08.md |
+| task | STATE-WP-ADHOC-2026-08-08-T03 | done | — | workplans/ADHOC-2026-08-08.md |
+| task | STATE-WP-ADHOC-2026-08-08-T04 | done | — | workplans/ADHOC-2026-08-08.md |
+| task | STATE-WP-ADHOC-2026-08-23-T01 | done | — | workplans/ADHOC-2026-08-23.md |
+| task | STATE-WP-ADHOC-2026-08-30-T01 | done | — | workplans/ADHOC-2026-08-30.md |
+| task | STATE-WP-ADHOC-2026-08-30-T02 | done | — | workplans/ADHOC-2026-08-30.md |
+| task | STATE-WP-ADHOC-2026-09-04-T01 | done | — | workplans/ADHOC-2026-09-04.md |
+| task | CUST-WP-0003-T01 | done | — | workplans/CUST-WP-0003-whi-kpi-card.md |
+| task | CUST-WP-0003-T02 | done | — | workplans/CUST-WP-0003-whi-kpi-card.md |
+| task | CUST-WP-0003-T03 | done | — | workplans/CUST-WP-0003-whi-kpi-card.md |
+| task | CUST-WP-0003-T04 | done | — | workplans/CUST-WP-0003-whi-kpi-card.md |
+| task | CUST-WP-0003-T05 | done | — | workplans/CUST-WP-0003-whi-kpi-card.md |
+| task | CUST-WP-0003-T06 | done | — | workplans/CUST-WP-0003-whi-kpi-card.md |
+| task | CUST-WP-0003-T07 | done | — | workplans/CUST-WP-0003-whi-kpi-card.md |
+| task | CUST-WP-0003-T08 | done | — | workplans/CUST-WP-0003-whi-kpi-card.md |
+| task | CUST-WP-0003-T09 | done | — | workplans/CUST-WP-0003-whi-kpi-card.md |
+| task | CUST-WP-0012-T01 | done | — | workplans/CUST-WP-0012-multi-user-onboarding.md |
+| task | CUST-WP-0012-T02 | done | — | workplans/CUST-WP-0012-multi-user-onboarding.md |
+| task | CUST-WP-0012-T03 | done | — | workplans/CUST-WP-0012-multi-user-onboarding.md |
+| task | CUST-WP-0012-T04 | done | — | workplans/CUST-WP-0012-multi-user-onboarding.md |
+| task | CUST-WP-0012-T05 | done | — | workplans/CUST-WP-0012-multi-user-onboarding.md |
+| task | CUST-WP-0012-T06 | done | — | workplans/CUST-WP-0012-multi-user-onboarding.md |
+| task | CUST-WP-0038-T01 | todo | — | workplans/CUST-WP-0038-state-hub-threephoenix-ha.md |
+| task | CUST-WP-0038-T02 | todo | — | workplans/CUST-WP-0038-state-hub-threephoenix-ha.md |
+| task | CUST-WP-0038-T03 | todo | — | workplans/CUST-WP-0038-state-hub-threephoenix-ha.md |
+| task | CUST-WP-0038-T04 | todo | — | workplans/CUST-WP-0038-state-hub-threephoenix-ha.md |
+| task | CUST-WP-0038-T05 | todo | — | workplans/CUST-WP-0038-state-hub-threephoenix-ha.md |
+| task | CUST-WP-0038-T06 | todo | — | workplans/CUST-WP-0038-state-hub-threephoenix-ha.md |
+| task | CUST-WP-0038-T07 | todo | — | workplans/CUST-WP-0038-state-hub-threephoenix-ha.md |
+| task | CUST-WP-0038-T08 | todo | — | workplans/CUST-WP-0038-state-hub-threephoenix-ha.md |
+| task | CUST-WP-0042-T01 | done | — | workplans/CUST-WP-0042-workplan-state-model-cleanup.md |
+| task | CUST-WP-0042-T02 | done | — | workplans/CUST-WP-0042-workplan-state-model-cleanup.md |
+| task | CUST-WP-0042-T03 | done | — | workplans/CUST-WP-0042-workplan-state-model-cleanup.md |
+| task | CUST-WP-0042-T04 | done | — | workplans/CUST-WP-0042-workplan-state-model-cleanup.md |
+| task | CUST-WP-0042-T05 | done | — | workplans/CUST-WP-0042-workplan-state-model-cleanup.md |
+| task | CUST-WP-0042-T06 | done | — | workplans/CUST-WP-0042-workplan-state-model-cleanup.md |
+| task | CUST-WP-0042-T07 | done | — | workplans/CUST-WP-0042-workplan-state-model-cleanup.md |
+| task | CUST-WP-0042-T08 | done | — | workplans/CUST-WP-0042-workplan-state-model-cleanup.md |
+| task | STATE-WP-0043-T01 | done | — | workplans/STATE-WP-0043-dashboard-ui-experience.md |
+| task | STATE-WP-0043-T02 | done | — | workplans/STATE-WP-0043-dashboard-ui-experience.md |
+| task | STATE-WP-0043-T03 | done | — | workplans/STATE-WP-0043-dashboard-ui-experience.md |
+| task | STATE-WP-0043-T04 | done | — | workplans/STATE-WP-0043-dashboard-ui-experience.md |
+| task | STATE-WP-0043-T05 | done | — | workplans/STATE-WP-0043-dashboard-ui-experience.md |
+| task | STATE-WP-0043-T06 | done | — | workplans/STATE-WP-0043-dashboard-ui-experience.md |
+| task | STATE-WP-0043-T07 | done | — | workplans/STATE-WP-0043-dashboard-ui-experience.md |
+| task | STATE-WP-0043-T08 | done | — | workplans/STATE-WP-0043-dashboard-ui-experience.md |
+| task | STATE-WP-0044-T01 | done | — | workplans/STATE-WP-0044-recently-on-scope-digest.md |
+| task | STATE-WP-0044-T02 | done | — | workplans/STATE-WP-0044-recently-on-scope-digest.md |
+| task | STATE-WP-0044-T03 | done | — | workplans/STATE-WP-0044-recently-on-scope-digest.md |
+| task | STATE-WP-0044-T04 | done | — | workplans/STATE-WP-0044-recently-on-scope-digest.md |
+| task | STATE-WP-0044-T05 | done | — | workplans/STATE-WP-0044-recently-on-scope-digest.md |
+| task | STATE-WP-0044-T06 | done | — | workplans/STATE-WP-0044-recently-on-scope-digest.md |
+| task | STATE-WP-0045-T01 | done | — | workplans/STATE-WP-0045-token-measurement-accuracy.md |
+| task | STATE-WP-0045-T02 | done | — | workplans/STATE-WP-0045-token-measurement-accuracy.md |
+| task | STATE-WP-0045-T03 | done | — | workplans/STATE-WP-0045-token-measurement-accuracy.md |
+| task | STATE-WP-0045-T04 | done | — | workplans/STATE-WP-0045-token-measurement-accuracy.md |
+| task | STATE-WP-0045-T05 | done | — | workplans/STATE-WP-0045-token-measurement-accuracy.md |
+| task | STATE-WP-0045-T06 | done | — | workplans/STATE-WP-0045-token-measurement-accuracy.md |
+| task | STATE-WP-0045-T07 | done | — | workplans/STATE-WP-0045-token-measurement-accuracy.md |
+| task | STATE-WP-0045-T08 | done | — | workplans/STATE-WP-0045-token-measurement-accuracy.md |
+| task | STATE-WP-0046-T01 | done | — | workplans/STATE-WP-0046-workplan-id-normalization.md |
+| task | STATE-WP-0046-T02 | done | — | workplans/STATE-WP-0046-workplan-id-normalization.md |
+| task | STATE-WP-0046-T03 | done | — | workplans/STATE-WP-0046-workplan-id-normalization.md |
+| task | STATE-WP-0046-T04 | done | — | workplans/STATE-WP-0046-workplan-id-normalization.md |
+| task | STATE-WP-0046-T05 | done | — | workplans/STATE-WP-0046-workplan-id-normalization.md |
+| task | STATE-WP-0046-T06 | done | — | workplans/STATE-WP-0046-workplan-id-normalization.md |
+| task | STATE-WP-0047-T01 | done | — | workplans/STATE-WP-0047-lifecycle-assertions-and-renormalization.md |
+| task | STATE-WP-0047-T02 | done | — | workplans/STATE-WP-0047-lifecycle-assertions-and-renormalization.md |
+| task | STATE-WP-0047-T03 | done | — | workplans/STATE-WP-0047-lifecycle-assertions-and-renormalization.md |
+| task | STATE-WP-0047-T04 | done | — | workplans/STATE-WP-0047-lifecycle-assertions-and-renormalization.md |
+| task | STATE-WP-0047-T05 | done | — | workplans/STATE-WP-0047-lifecycle-assertions-and-renormalization.md |
+| task | STATE-WP-0047-T06 | done | — | workplans/STATE-WP-0047-lifecycle-assertions-and-renormalization.md |
+| task | STATE-WP-0047-T07 | done | — | workplans/STATE-WP-0047-lifecycle-assertions-and-renormalization.md |
+| task | STATE-WP-0048-T01 | done | — | workplans/STATE-WP-0048-ui-state-change-reconciliation.md |
+| task | STATE-WP-0048-T02 | done | — | workplans/STATE-WP-0048-ui-state-change-reconciliation.md |
+| task | STATE-WP-0048-T03 | done | — | workplans/STATE-WP-0048-ui-state-change-reconciliation.md |
+| task | STATE-WP-0048-T04 | done | — | workplans/STATE-WP-0048-ui-state-change-reconciliation.md |
+| task | STATE-WP-0048-T05 | done | — | workplans/STATE-WP-0048-ui-state-change-reconciliation.md |
+| task | STATE-WP-0048-T06 | done | — | workplans/STATE-WP-0048-ui-state-change-reconciliation.md |
+| task | STATE-WP-0048-T07 | done | — | workplans/STATE-WP-0048-ui-state-change-reconciliation.md |
+| task | STATE-WP-0049-T01 | done | — | workplans/STATE-WP-0049-workplan-execution-queue.md |
+| task | STATE-WP-0049-T02 | done | — | workplans/STATE-WP-0049-workplan-execution-queue.md |
+| task | STATE-WP-0049-T03 | done | — | workplans/STATE-WP-0049-workplan-execution-queue.md |
+| task | STATE-WP-0049-T04 | done | — | workplans/STATE-WP-0049-workplan-execution-queue.md |
+| task | STATE-WP-0049-T05 | done | — | workplans/STATE-WP-0049-workplan-execution-queue.md |
+| task | STATE-WP-0049-T06 | done | — | workplans/STATE-WP-0049-workplan-execution-queue.md |
+| task | STATE-WP-0049-T07 | done | — | workplans/STATE-WP-0049-workplan-execution-queue.md |
+| task | STATE-WP-0050-T01 | done | — | workplans/STATE-WP-0050-railiance-fabric-graph-read-model-ingest.md |
+| task | STATE-WP-0050-T02 | done | — | workplans/STATE-WP-0050-railiance-fabric-graph-read-model-ingest.md |
+| task | STATE-WP-0050-T03 | done | — | workplans/STATE-WP-0050-railiance-fabric-graph-read-model-ingest.md |
+| task | STATE-WP-0050-T04 | done | — | workplans/STATE-WP-0050-railiance-fabric-graph-read-model-ingest.md |
+| task | STATE-WP-0051-T01 | done | — | workplans/STATE-WP-0051-financial-fabric-read-model-adaptation.md |
+| task | STATE-WP-0051-T02 | done | — | workplans/STATE-WP-0051-financial-fabric-read-model-adaptation.md |
+| task | STATE-WP-0051-T03 | done | — | workplans/STATE-WP-0051-financial-fabric-read-model-adaptation.md |
+| task | STATE-WP-0051-T04 | done | — | workplans/STATE-WP-0051-financial-fabric-read-model-adaptation.md |
+| task | STATE-WP-0051-T05 | done | — | workplans/STATE-WP-0051-financial-fabric-read-model-adaptation.md |
+| task | STATE-WP-0051-T06 | done | — | workplans/STATE-WP-0051-financial-fabric-read-model-adaptation.md |
+| task | STATE-WP-0052-T01 | done | — | workplans/STATE-WP-0052-task-state-canon-adaptation.md |
+| task | STATE-WP-0052-T02 | done | — | workplans/STATE-WP-0052-task-state-canon-adaptation.md |
+| task | STATE-WP-0052-T03 | done | — | workplans/STATE-WP-0052-task-state-canon-adaptation.md |
+| task | STATE-WP-0052-T04 | done | — | workplans/STATE-WP-0052-task-state-canon-adaptation.md |
+| task | STATE-WP-0052-T05 | done | — | workplans/STATE-WP-0052-task-state-canon-adaptation.md |
+| task | STATE-WP-0052-T06 | done | — | workplans/STATE-WP-0052-task-state-canon-adaptation.md |
+| task | STATE-WP-0052-T07 | done | — | workplans/STATE-WP-0052-task-state-canon-adaptation.md |
+| task | STATE-WP-0052-T08 | done | — | workplans/STATE-WP-0052-task-state-canon-adaptation.md |
+| task | STATE-WP-0052-T09 | done | — | workplans/STATE-WP-0052-task-state-canon-adaptation.md |
+| task | STATE-WP-0052-T10 | done | — | workplans/STATE-WP-0052-task-state-canon-adaptation.md |
+| task | STATE-WP-0053-T01 | done | — | workplans/STATE-WP-0053-wsjf-triage-review-page.md |
+| task | STATE-WP-0053-T02 | done | — | workplans/STATE-WP-0053-wsjf-triage-review-page.md |
+| task | STATE-WP-0053-T03 | done | — | workplans/STATE-WP-0053-wsjf-triage-review-page.md |
+| task | STATE-WP-0053-T04 | done | — | workplans/STATE-WP-0053-wsjf-triage-review-page.md |
+| task | STATE-WP-0053-T05 | done | — | workplans/STATE-WP-0053-wsjf-triage-review-page.md |
+| task | STATE-WP-0053-T06 | done | — | workplans/STATE-WP-0053-wsjf-triage-review-page.md |
+| task | STATE-WP-0054-T01 | done | — | workplans/STATE-WP-0054-workplan-terminology-transition-legacy-meter.md |
+| task | STATE-WP-0054-T02 | done | — | workplans/STATE-WP-0054-workplan-terminology-transition-legacy-meter.md |
+| task | STATE-WP-0054-T03 | done | — | workplans/STATE-WP-0054-workplan-terminology-transition-legacy-meter.md |
+| task | STATE-WP-0054-T04 | done | — | workplans/STATE-WP-0054-workplan-terminology-transition-legacy-meter.md |
+| task | STATE-WP-0054-T05 | done | — | workplans/STATE-WP-0054-workplan-terminology-transition-legacy-meter.md |
+| task | STATE-WP-0054-T06 | done | — | workplans/STATE-WP-0054-workplan-terminology-transition-legacy-meter.md |
+| task | STATE-WP-0054-T07 | done | — | workplans/STATE-WP-0054-workplan-terminology-transition-legacy-meter.md |
+| task | STATE-WP-0054-T08 | done | — | workplans/STATE-WP-0054-workplan-terminology-transition-legacy-meter.md |
+| task | STATE-WP-0055-T01 | done | — | workplans/STATE-WP-0055-statehub-register-cli.md |
+| task | STATE-WP-0056-T01 | done | — | workplans/STATE-WP-0056-dashboard-loading-robustness.md |
+| task | STATE-WP-0056-T02 | done | — | workplans/STATE-WP-0056-dashboard-loading-robustness.md |
+| task | STATE-WP-0056-T03 | done | — | workplans/STATE-WP-0056-dashboard-loading-robustness.md |
+| task | STATE-WP-0056-T04 | done | — | workplans/STATE-WP-0056-dashboard-loading-robustness.md |
+| task | STATE-WP-0056-T05 | done | — | workplans/STATE-WP-0056-dashboard-loading-robustness.md |
+| task | STATE-WP-0056-T06 | done | — | workplans/STATE-WP-0056-dashboard-loading-robustness.md |
+| task | STATE-WP-0056-T07 | done | — | workplans/STATE-WP-0056-dashboard-loading-robustness.md |
+| task | STATE-WP-0056-T08 | done | — | workplans/STATE-WP-0056-dashboard-loading-robustness.md |
+| task | STATE-WP-0057-T01 | done | — | workplans/STATE-WP-0057-overview-workstream-stage-counts.md |
+| task | STATE-WP-0057-T02 | done | — | workplans/STATE-WP-0057-overview-workstream-stage-counts.md |
+| task | STATE-WP-0057-T03 | done | — | workplans/STATE-WP-0057-overview-workstream-stage-counts.md |
+| task | STATE-WP-0057-T04 | done | — | workplans/STATE-WP-0057-overview-workstream-stage-counts.md |
+| task | STATE-WP-0057-T05 | done | — | workplans/STATE-WP-0057-overview-workstream-stage-counts.md |
+| task | STATE-WP-0057-T06 | done | — | workplans/STATE-WP-0057-overview-workstream-stage-counts.md |
+| task | STATE-WP-0058-T01 | done | — | workplans/STATE-WP-0058-agent-skill-hub-interaction.md |
+| task | STATE-WP-0058-T02 | done | — | workplans/STATE-WP-0058-agent-skill-hub-interaction.md |
+| task | STATE-WP-0058-T03 | done | — | workplans/STATE-WP-0058-agent-skill-hub-interaction.md |
+| task | STATE-WP-0059-T01 | done | — | workplans/STATE-WP-0059-mcp-write-layer-reliability.md |
+| task | STATE-WP-0059-T02 | done | — | workplans/STATE-WP-0059-mcp-write-layer-reliability.md |
+| task | STATE-WP-0059-T03 | done | — | workplans/STATE-WP-0059-mcp-write-layer-reliability.md |
+| task | STATE-WP-0060-T01 | done | — | workplans/STATE-WP-0060-fix-consistency-cross-flavor.md |
+| task | STATE-WP-0060-T02 | done | — | workplans/STATE-WP-0060-fix-consistency-cross-flavor.md |
+| task | STATE-WP-0060-T03 | done | — | workplans/STATE-WP-0060-fix-consistency-cross-flavor.md |
+| task | STATE-WP-0062-T01 | done | — | workplans/STATE-WP-0062-service-catalog-two-dimensions.md |
+| task | STATE-WP-0062-T02 | done | — | workplans/STATE-WP-0062-service-catalog-two-dimensions.md |
+| task | STATE-WP-0062-T03 | done | — | workplans/STATE-WP-0062-service-catalog-two-dimensions.md |
+| task | STATE-WP-0062-T04 | done | — | workplans/STATE-WP-0062-service-catalog-two-dimensions.md |
+| task | STATE-WP-0062-T05 | done | — | workplans/STATE-WP-0062-service-catalog-two-dimensions.md |
+| task | STATE-WP-0063-T01 | done | — | workplans/STATE-WP-0063-weekend-automation-repair.md |
+| task | STATE-WP-0063-T02 | done | — | workplans/STATE-WP-0063-weekend-automation-repair.md |
+| task | STATE-WP-0063-T03 | done | — | workplans/STATE-WP-0063-weekend-automation-repair.md |
+| task | STATE-WP-0063-T04 | done | — | workplans/STATE-WP-0063-weekend-automation-repair.md |
+| task | STATE-WP-0063-T05 | done | — | workplans/STATE-WP-0063-weekend-automation-repair.md |
+| task | STATE-WP-0064-T01 | done | — | workplans/STATE-WP-0064-statehub-consistency-sync-railiance01.md |
+| task | STATE-WP-0064-T02 | done | — | workplans/STATE-WP-0064-statehub-consistency-sync-railiance01.md |
+| task | STATE-WP-0064-T03 | done | — | workplans/STATE-WP-0064-statehub-consistency-sync-railiance01.md |
+| task | STATE-WP-0064-T04 | done | — | workplans/STATE-WP-0064-statehub-consistency-sync-railiance01.md |
+| task | STATE-WP-0064-T05 | done | — | workplans/STATE-WP-0064-statehub-consistency-sync-railiance01.md |
+| task | STATE-WP-0065-T01 | done | — | workplans/STATE-WP-0065-repo-anchored-classification-spine.md |
+| task | STATE-WP-0065-T02 | done | — | workplans/STATE-WP-0065-repo-anchored-classification-spine.md |
+| task | STATE-WP-0065-T03 | done | — | workplans/STATE-WP-0065-repo-anchored-classification-spine.md |
+| task | STATE-WP-0065-T04 | done | — | workplans/STATE-WP-0065-repo-anchored-classification-spine.md |
+| task | STATE-WP-0066-T01 | done | — | workplans/STATE-WP-0066-state-summary-revision-cache.md |
+| task | STATE-WP-0066-T02 | done | — | workplans/STATE-WP-0066-state-summary-revision-cache.md |
+| task | STATE-WP-0066-T03 | done | — | workplans/STATE-WP-0066-state-summary-revision-cache.md |
+| task | STATE-WP-0066-T04 | done | — | workplans/STATE-WP-0066-state-summary-revision-cache.md |
+| task | STATE-WP-0066-T05 | done | — | workplans/STATE-WP-0066-state-summary-revision-cache.md |
+| task | STATE-WP-0066-T06 | done | — | workplans/STATE-WP-0066-state-summary-revision-cache.md |
+| task | STATE-WP-0066-T07 | done | — | workplans/STATE-WP-0066-state-summary-revision-cache.md |
+| task | STATE-WP-0066-T08 | done | — | workplans/STATE-WP-0066-state-summary-revision-cache.md |
+| task | STATE-WP-0067-T01 | done | — | workplans/STATE-WP-0067-attached-repo-agent-normalization.md |
+| task | STATE-WP-0067-T02 | done | — | workplans/STATE-WP-0067-attached-repo-agent-normalization.md |
+| task | STATE-WP-0067-T03 | done | — | workplans/STATE-WP-0067-attached-repo-agent-normalization.md |
+| task | STATE-WP-0067-T04 | done | — | workplans/STATE-WP-0067-attached-repo-agent-normalization.md |
+| task | STATE-WP-0067-T05 | done | — | workplans/STATE-WP-0067-attached-repo-agent-normalization.md |
+| task | STATE-WP-0067-T06 | done | — | workplans/STATE-WP-0067-attached-repo-agent-normalization.md |
+| task | STATE-WP-0068-T01 | done | — | workplans/STATE-WP-0068-offline-write-buffer-and-edge-relay.md |
+| task | STATE-WP-0068-T02 | done | — | workplans/STATE-WP-0068-offline-write-buffer-and-edge-relay.md |
+| task | STATE-WP-0068-T03 | done | — | workplans/STATE-WP-0068-offline-write-buffer-and-edge-relay.md |
+| task | STATE-WP-0068-T04 | done | — | workplans/STATE-WP-0068-offline-write-buffer-and-edge-relay.md |
+| task | STATE-WP-0068-T05 | done | — | workplans/STATE-WP-0068-offline-write-buffer-and-edge-relay.md |
+| task | STATE-WP-0068-T06 | done | — | workplans/STATE-WP-0068-offline-write-buffer-and-edge-relay.md |
+| task | STATE-WP-0068-T07 | done | — | workplans/STATE-WP-0068-offline-write-buffer-and-edge-relay.md |
+| task | STATE-WP-0068-T08 | done | — | workplans/STATE-WP-0068-offline-write-buffer-and-edge-relay.md |
+| task | STATE-WP-0068-T09 | done | — | workplans/STATE-WP-0068-offline-write-buffer-and-edge-relay.md |
+| task | STATE-WP-0071-T01 | done | — | workplans/STATE-WP-0071-railiance01-workstream-caller-deploy.md |
+| task | STATE-WP-0071-T02 | done | — | workplans/STATE-WP-0071-railiance01-workstream-caller-deploy.md |
+| task | STATE-WP-0071-T03 | done | — | workplans/STATE-WP-0071-railiance01-workstream-caller-deploy.md |
+| task | STATE-WP-0071-T04 | done | — | workplans/STATE-WP-0071-railiance01-workstream-caller-deploy.md |
+| task | STATE-WP-0071-T05 | done | — | workplans/STATE-WP-0071-railiance01-workstream-caller-deploy.md |
+| task | STATE-WP-0071-T06 | done | — | workplans/STATE-WP-0071-railiance01-workstream-caller-deploy.md |
+| task | STATE-WP-0072-T01 | done | — | workplans/STATE-WP-0072-workstream-caller-remediation.md |
+| task | STATE-WP-0072-T02 | done | — | workplans/STATE-WP-0072-workstream-caller-remediation.md |
+| task | STATE-WP-0072-T03 | done | — | workplans/STATE-WP-0072-workstream-caller-remediation.md |
+| task | STATE-WP-0072-T04 | done | — | workplans/STATE-WP-0072-workstream-caller-remediation.md |
+| task | STATE-WP-0073-T01 | done | — | workplans/STATE-WP-0073-legacy-meter-decline-and-remote-audit.md |
+| task | STATE-WP-0073-T02 | done | — | workplans/STATE-WP-0073-legacy-meter-decline-and-remote-audit.md |
+| task | STATE-WP-0073-T03 | done | — | workplans/STATE-WP-0073-legacy-meter-decline-and-remote-audit.md |
+| task | STATE-WP-0073-T04 | done | — | workplans/STATE-WP-0073-legacy-meter-decline-and-remote-audit.md |
+| task | STATE-WP-0073-T05 | cancel | — | workplans/STATE-WP-0073-legacy-meter-decline-and-remote-audit.md |
+| task | STATE-WP-0074-T01 | done | — | workplans/STATE-WP-0074-hub-ecosystem-boundary-alignment.md |
+| task | STATE-WP-0074-T02 | done | — | workplans/STATE-WP-0074-hub-ecosystem-boundary-alignment.md |
+| task | STATE-WP-0074-T03 | done | — | workplans/STATE-WP-0074-hub-ecosystem-boundary-alignment.md |
+| task | STATE-WP-0074-T04 | done | — | workplans/STATE-WP-0074-hub-ecosystem-boundary-alignment.md |
+| task | STATE-WP-0074-T05 | done | — | workplans/STATE-WP-0074-hub-ecosystem-boundary-alignment.md |
+| task | STATE-WP-0075-T01 | done | — | workplans/STATE-WP-0075-workstream-route-410-stranglers.md |
+| task | STATE-WP-0075-T02 | done | — | workplans/STATE-WP-0075-workstream-route-410-stranglers.md |
+| task | STATE-WP-0075-T03 | done | — | workplans/STATE-WP-0075-workstream-route-410-stranglers.md |
+| task | STATE-WP-0075-T04 | done | — | workplans/STATE-WP-0075-workstream-route-410-stranglers.md |
+| task | STATE-WP-0076-T01 | done | — | workplans/STATE-WP-0076-definition-of-ready-and-comprehension.md |
+| task | STATE-WP-0076-T02 | done | — | workplans/STATE-WP-0076-definition-of-ready-and-comprehension.md |
+| task | STATE-WP-0076-T03 | done | — | workplans/STATE-WP-0076-definition-of-ready-and-comprehension.md |
+| task | STATE-WP-0076-T04 | done | — | workplans/STATE-WP-0076-definition-of-ready-and-comprehension.md |
+| task | STATE-WP-0076-T05 | cancel | — | workplans/STATE-WP-0076-definition-of-ready-and-comprehension.md |
+| task | STATE-WP-0076-T06 | cancel | — | workplans/STATE-WP-0076-definition-of-ready-and-comprehension.md |
+| task | STATE-WP-0077-T01 | done | — | workplans/STATE-WP-0077-dox-assessment-recording-and-soft-visibility.md |
+| task | STATE-WP-0077-T02 | done | — | workplans/STATE-WP-0077-dox-assessment-recording-and-soft-visibility.md |
+| task | STATE-WP-0077-T03 | done | — | workplans/STATE-WP-0077-dox-assessment-recording-and-soft-visibility.md |
+| task | STATE-WP-0077-T04 | done | — | workplans/STATE-WP-0077-dox-assessment-recording-and-soft-visibility.md |
+| task | STATE-WP-0078-T01 | done | — | workplans/STATE-WP-0078-ops-run-read-projection.md |
+| task | STATE-WP-0078-T02 | done | — | workplans/STATE-WP-0078-ops-run-read-projection.md |
+| task | STATE-WP-0078-T03 | done | — | workplans/STATE-WP-0078-ops-run-read-projection.md |
+| task | STATE-WP-0079-T01 | done | — | workplans/STATE-WP-0079-retirement-strangler.md |
+| task | STATE-WP-0079-T02 | done | — | workplans/STATE-WP-0079-retirement-strangler.md |
+| task | STATE-WP-0079-T03 | done | — | workplans/STATE-WP-0079-retirement-strangler.md |
+| task | STATE-WP-0079-T04 | wait | — | workplans/STATE-WP-0079-retirement-strangler.md |
+| task | STATE-WP-0079-T05 | wait | — | workplans/STATE-WP-0079-retirement-strangler.md |
+| task | STATE-WP-0079-T06 | wait | — | workplans/STATE-WP-0079-retirement-strangler.md |
+| task | STATE-WP-0079-T07 | wait | — | workplans/STATE-WP-0079-retirement-strangler.md |
+| task | STATE-WP-0079-T08 | done | — | workplans/STATE-WP-0079-retirement-strangler.md |
+| task | STATE-WP-0079-T09 | wait | — | workplans/STATE-WP-0079-retirement-strangler.md |
+| task | STATE-WP-0080-T01 | done | — | workplans/STATE-WP-0080-register-project-flavor-awareness.md |
+| task | STATE-WP-0080-T02 | done | — | workplans/STATE-WP-0080-register-project-flavor-awareness.md |
+| task | STATE-WP-0080-T03 | done | — | workplans/STATE-WP-0080-register-project-flavor-awareness.md |
+| task | STATE-WP-0080-T04 | cancel | — | workplans/STATE-WP-0080-register-project-flavor-awareness.md |
+| task | STATE-WP-0080-T05 | cancel | — | workplans/STATE-WP-0080-register-project-flavor-awareness.md |
+| task | STATE-WP-0080-T06 | cancel | — | workplans/STATE-WP-0080-register-project-flavor-awareness.md |
+| task | STATE-WP-0080-T07 | cancel | — | workplans/STATE-WP-0080-register-project-flavor-awareness.md |
+| task | STATE-WP-0080-T08 | cancel | — | workplans/STATE-WP-0080-register-project-flavor-awareness.md |
+| task | STATE-WP-0081-T01 | cancel | — | workplans/STATE-WP-0081-cluster-self-sufficiency-and-registrar.md |
+| task | STATE-WP-0081-T02 | cancel | — | workplans/STATE-WP-0081-cluster-self-sufficiency-and-registrar.md |
+| task | STATE-WP-0081-T03 | done | — | workplans/STATE-WP-0081-cluster-self-sufficiency-and-registrar.md |
+| task | STATE-WP-0081-T04 | done | — | workplans/STATE-WP-0081-cluster-self-sufficiency-and-registrar.md |
+| task | STATE-WP-0081-T05 | done | — | workplans/STATE-WP-0081-cluster-self-sufficiency-and-registrar.md |
+| task | STATE-WP-0081-T06 | done | — | workplans/STATE-WP-0081-cluster-self-sufficiency-and-registrar.md |
+| task | STATE-WP-0081-T07 | done | — | workplans/STATE-WP-0081-cluster-self-sufficiency-and-registrar.md |
+| task | STATE-WP-0081-T08 | done | — | workplans/STATE-WP-0081-cluster-self-sufficiency-and-registrar.md |
+| task | STATE-WP-0082-T01 | done | — | workplans/STATE-WP-0082-multi-owner-review-contracts-and-receipts.md |
+| task | STATE-WP-0082-T02 | done | — | workplans/STATE-WP-0082-multi-owner-review-contracts-and-receipts.md |
+| task | STATE-WP-0082-T03 | done | — | workplans/STATE-WP-0082-multi-owner-review-contracts-and-receipts.md |
+| task | STATE-WP-0082-T04 | done | — | workplans/STATE-WP-0082-multi-owner-review-contracts-and-receipts.md |
+| task | STATE-WP-0082-T05 | done | — | workplans/STATE-WP-0082-multi-owner-review-contracts-and-receipts.md |
+| task | STATE-WP-0082-T06 | done | — | workplans/STATE-WP-0082-multi-owner-review-contracts-and-receipts.md |
+| task | STATE-WP-0083-T01 | done | — | workplans/STATE-WP-0083-forge-derived-projection-reset.md |
+| task | STATE-WP-0083-T02 | done | — | workplans/STATE-WP-0083-forge-derived-projection-reset.md |
+| task | STATE-WP-0083-T03 | done | — | workplans/STATE-WP-0083-forge-derived-projection-reset.md |
+| task | STATE-WP-0083-T04 | done | — | workplans/STATE-WP-0083-forge-derived-projection-reset.md |
+| task | STATE-WP-0083-T05 | done | — | workplans/STATE-WP-0083-forge-derived-projection-reset.md |
+| task | STATE-WP-0083-T06 | done | — | workplans/STATE-WP-0083-forge-derived-projection-reset.md |
+| task | STATE-WP-0083-T07 | done | — | workplans/STATE-WP-0083-forge-derived-projection-reset.md |
+| task | STATE-WP-0083-T08 | done | — | workplans/STATE-WP-0083-forge-derived-projection-reset.md |
+| task | STATE-WP-0084-T01 | done | — | workplans/STATE-WP-0084-forge-read-for-private-repositories.md |
+| task | STATE-WP-0084-T02 | done | — | workplans/STATE-WP-0084-forge-read-for-private-repositories.md |
+| task | STATE-WP-0084-T03 | done | — | workplans/STATE-WP-0084-forge-read-for-private-repositories.md |
+| task | STATE-WP-0084-T04 | done | — | workplans/STATE-WP-0084-forge-read-for-private-repositories.md |
+| task | STATE-WP-0085-T01 | done | — | workplans/STATE-WP-0085-repository-lineage-preserving-rename.md |
+| task | STATE-WP-0085-T02 | done | — | workplans/STATE-WP-0085-repository-lineage-preserving-rename.md |
+| task | STATE-WP-0085-T03 | done | — | workplans/STATE-WP-0085-repository-lineage-preserving-rename.md |
+| task | STATE-WP-0085-T04 | done | — | workplans/STATE-WP-0085-repository-lineage-preserving-rename.md |
+| task | STATE-WP-0085-T05 | done | — | workplans/STATE-WP-0085-repository-lineage-preserving-rename.md |
+| task | STATE-WP-0085-T06 | done | — | workplans/STATE-WP-0085-repository-lineage-preserving-rename.md |
+| task | STATE-WP-0085-T07 | done | — | workplans/STATE-WP-0085-repository-lineage-preserving-rename.md |
+| task | STATE-WP-0085-T08 | done | — | workplans/STATE-WP-0085-repository-lineage-preserving-rename.md |
+| task | STATE-WP-0085-T09 | done | — | workplans/STATE-WP-0085-repository-lineage-preserving-rename.md |
+| task | STATE-WP-0086-T01 | done | — | workplans/STATE-WP-0086-fast-forge-projection-reconcile.md |
+| task | STATE-WP-0086-T02 | done | — | workplans/STATE-WP-0086-fast-forge-projection-reconcile.md |
+| task | STATE-WP-0086-T03 | done | — | workplans/STATE-WP-0086-fast-forge-projection-reconcile.md |
+| task | STATE-WP-0087-T01 | done | — | workplans/STATE-WP-0087-bounded-repository-collection-projection.md |
+| task | STATE-WP-0088-T01 | done | — | workplans/STATE-WP-0088-preflight-signing-runtime-acceptance.md |
+| task | STATE-WP-0088-T02 | done | — | workplans/STATE-WP-0088-preflight-signing-runtime-acceptance.md |
+| task | STATE-WP-0089-T01 | done | — | workplans/STATE-WP-0089-rename-redirect-recovery.md |
+| task | STATE-WP-0089-T02 | done | — | workplans/STATE-WP-0089-rename-redirect-recovery.md |
+| task | STATE-WP-0090-T01 | done | — | workplans/STATE-WP-0090-projection-task-field-convergence.md |
+| task | STATE-WP-0090-T02 | done | — | workplans/STATE-WP-0090-projection-task-field-convergence.md |
+| task | STATE-WP-0090-T03 | done | — | workplans/STATE-WP-0090-projection-task-field-convergence.md |
+| task | STATE-WP-0091-T01 | done | — | workplans/STATE-WP-0091-release-headroom.md |
+| task | STATE-WP-0091-T02 | done | — | workplans/STATE-WP-0091-release-headroom.md |
+| task | STATE-WP-0092-T01 | done | — | workplans/STATE-WP-0092-workplan-flavor-and-depends-on-policy.md |
+| task | STATE-WP-0092-T02 | done | — | workplans/STATE-WP-0092-workplan-flavor-and-depends-on-policy.md |
+| task | STATE-WP-0092-T03 | done | — | workplans/STATE-WP-0092-workplan-flavor-and-depends-on-policy.md |
+| task | STATE-WP-0092-T04 | done | — | workplans/STATE-WP-0092-workplan-flavor-and-depends-on-policy.md |
+| task | STATE-WP-0092-T05 | done | — | workplans/STATE-WP-0092-workplan-flavor-and-depends-on-policy.md |
diff --git a/api/classification.py b/api/classification.py
index a2955bb..43aef85 100644
--- a/api/classification.py
+++ b/api/classification.py
@@ -9,8 +9,16 @@ import re
 from dataclasses import dataclass, field
 from pathlib import Path
 
+import os
+
 import yaml
 
+# Explicit override first — every other candidate below is a developer
+# workstation path, so in a container none of them exist and classification
+# validation fails outright. Set REPO_CLASSIFICATION_ALLOWED_PATH in any
+# deployment that does not carry a the-custodian checkout (CUST-WP-0067-T04).
+_ENV_ALLOWED = os.environ.get("REPO_CLASSIFICATION_ALLOWED_PATH")
+
 # Workstation checkout, railiance01 fleet checkout, then state-hub sibling fallback.
 _PRIMARY_ALLOWED = Path(
     "/home/worsch/the-custodian/canon/standards/repo-classification.allowed.yaml"
@@ -70,12 +78,21 @@ class ClassificationData:
 
 
 def _allowed_path() -> Path:
+    if _ENV_ALLOWED:
+        candidate = Path(_ENV_ALLOWED)
+        if candidate.is_file():
+            return candidate
+        raise FileNotFoundError(
+            f"REPO_CLASSIFICATION_ALLOWED_PATH is set to {candidate}, which is not a file"
+        )
     for candidate in (_PRIMARY_ALLOWED, _RAILIANCE_ALLOWED, _FALLBACK_ALLOWED):
         if candidate.is_file():
             return candidate
     raise FileNotFoundError(
         "repo-classification.allowed.yaml not found at "
-        f"{_PRIMARY_ALLOWED}, {_RAILIANCE_ALLOWED}, or {_FALLBACK_ALLOWED}"
+        f"{_PRIMARY_ALLOWED}, {_RAILIANCE_ALLOWED}, or {_FALLBACK_ALLOWED}. "
+        "Set REPO_CLASSIFICATION_ALLOWED_PATH when running without a "
+        "the-custodian checkout (for example in a container)."
     )
 
 
diff --git a/api/config.py b/api/config.py
index 14d7798..05a0c36 100644
--- a/api/config.py
+++ b/api/config.py
@@ -1,3 +1,5 @@
+from typing import Literal
+
 from pydantic_settings import BaseSettings, SettingsConfigDict
 
 
@@ -10,9 +12,36 @@ class Settings(BaseSettings):
 
     database_url: str = "postgresql+asyncpg://custodian:changeme@127.0.0.1:5432/custodian"
     api_base: str = "http://127.0.0.1:8000"
+    # What this instance claims to be. Deliberately defaults to "unknown":
+    # an instance that has not declared itself is not the primary, and callers
+    # that need the authoritative hub must be able to tell the difference.
+    # Answering on a port is not evidence of authority — that assumption cost
+    # seven weeks of onboarding (CUST-WP-0067-T03, ADR-010).
+    state_hub_instance_role: Literal["primary", "cache", "unknown"] = "unknown"
+    # Env vars are STATE_HUB_INSTANCE_ROLE / STATE_HUB_INSTANCE_LABEL — the
+    # field name *is* the binding, so renaming either breaks the deployment
+    # silently. Covered by tests/test_instance_identity.py.
+    # Free-form label to name *which* instance answered, e.g. "railiance01".
+    state_hub_instance_label: str | None = None
     debug: bool = False
     state_hub_report_dir: str = "reports/recently-on-scope"
     state_hub_markitect_cli_path: str | None = None
+    activity_core_url: str | None = None
+    activity_core_worker_token: str | None = None
+    ops_run_projection_ttl_seconds: float = 15.0
+    ops_run_sla_hours: float = 1.0
+    sbom_nexus_url: str | None = None
+    sbom_nexus_read_mode: Literal["legacy", "nexus"] = "legacy"
+    sbom_nexus_write_mode: Literal["legacy", "nexus"] = "legacy"
+    sbom_nexus_timeout_seconds: float = 5.0
+    # Repository renames are central-only, compare-and-set operations.  The
+    # secret signs short-lived, non-persistent preflight evidence; it must be
+    # supplied by the deployment (normally through OpenBao), never recorded in
+    # State Hub.  With no secret the read-only report remains available but no
+    # mutation token can be issued.
+    repository_rename_preflight_secret: str | None = None
+    repository_rename_preflight_ttl_seconds: int = 900
+    repository_rename_forge_timeout_seconds: float = 10.0
 
 
 settings = Settings()
diff --git a/api/main.py b/api/main.py
index db63efc..fecd89c 100644
--- a/api/main.py
+++ b/api/main.py
@@ -12,7 +12,7 @@ from starlette.responses import Response as StarletteResponse
 from api.database import engine
 from api.events import shutdown_publisher
 from api.services.write_idempotency import WriteIdempotencyMiddleware
-from api.routers import decisions, extension_points, progress, state, suggestions, tasks, technical_debt, topics, workstreams, workstream_dependencies
+from api.routers import decisions, extension_points, intake, ops_runs, progress, state, suggestions, tasks, technical_debt, topics, workstreams, workstream_dependencies
 from api.routers import domains, repos, contributions, sbom, policy, domain_goals, repo_goals, messages, capability_requests, tpsc, services
 from api.routers import token_events
 from api.routers import interface_changes
@@ -23,6 +23,10 @@ from api.routers import reconciliation
 from api.routers import execution
 from api.routers import fabric
 from api.routers import legacy_meter
+from api.routers import review_contracts
+from api.routers import identifier_migrations
+from api.routers import repository_renames
+from api.routers import work_record_projection
 
 
 class ETagMiddleware(BaseHTTPMiddleware):
@@ -107,6 +111,9 @@ app.include_router(recently_on_scope.hourly_router)
 app.include_router(recently_on_scope.router)
 app.include_router(consistency_sweep.router)
 app.include_router(repos.router)
+app.include_router(repository_renames.router)
+app.include_router(repository_renames.operation_router)
+app.include_router(work_record_projection.router)
 app.include_router(topics.router)
 app.include_router(workstreams.router)
 app.include_router(workstreams.workplan_router)
@@ -114,6 +121,7 @@ app.include_router(workstream_dependencies.router)
 app.include_router(workstream_dependencies.workplan_router)
 app.include_router(tasks.router)
 app.include_router(decisions.router)
+app.include_router(intake.router)
 app.include_router(extension_points.router)
 app.include_router(technical_debt.router)
 app.include_router(progress.router)
@@ -133,7 +141,10 @@ app.include_router(reconciliation.router)
 app.include_router(execution.router)
 app.include_router(fabric.router)
 app.include_router(legacy_meter.router)
+app.include_router(review_contracts.router)
+app.include_router(identifier_migrations.router)
 app.include_router(state.router)
+app.include_router(ops_runs.router)
 app.include_router(policy.router)
 
 
diff --git a/api/models/__init__.py b/api/models/__init__.py
index 522c3b0..1f8b110 100644
--- a/api/models/__init__.py
+++ b/api/models/__init__.py
@@ -10,6 +10,13 @@ from api.models.workstream import Workstream
 from api.models.workstream_dependency import WorkstreamDependency
 from api.models.task import Task, TaskStatus, TaskPriority
 from api.models.decision import Decision, DecisionType, DecisionStatus
+from api.models.intake import (
+    Intake,
+    IntakeNote,
+    IntakeLane,
+    IntakeStatus,
+    IntakeOutcome,
+)
 from api.models.progress_event import ProgressEvent
 from api.models.extension_point import ExtensionPoint, EPStatus
 from api.models.technical_debt import TechnicalDebt, TDStatus
@@ -34,6 +41,13 @@ from api.models.workplan_launch_request import WorkplanLaunchRequest
 from api.models.fabric_graph import FabricGraphImport, FabricGraphNode, FabricGraphEdge
 from api.models.legacy_meter import LegacyInterface, LegacyInterfaceUsageBucket
 from api.models.write_idempotency_key import WriteIdempotencyKey
+from api.models.work_record_identifier_alias import WorkRecordIdentifierAlias
+from api.models.review_contract import ReviewContract, ReviewReceipt
+from api.models.repository_rename import (
+    RepositoryForgeIdentity,
+    RepositoryRenameOperation,
+    RepositorySlug,
+)
 from api.models.suggestion import (
     Suggestion,
     SuggestionNote,
@@ -54,6 +68,7 @@ __all__ = [
     "WorkstreamDependency",
     "Task", "TaskStatus", "TaskPriority",
     "Decision", "DecisionType", "DecisionStatus",
+    "Intake", "IntakeNote", "IntakeLane", "IntakeStatus", "IntakeOutcome",
     "ProgressEvent",
     "ExtensionPoint", "EPStatus",
     "TechnicalDebt", "TDStatus",
@@ -73,5 +88,8 @@ __all__ = [
     "FabricGraphImport", "FabricGraphNode", "FabricGraphEdge",
     "LegacyInterface", "LegacyInterfaceUsageBucket",
     "WriteIdempotencyKey",
+    "WorkRecordIdentifierAlias",
+    "ReviewContract", "ReviewReceipt",
+    "RepositoryForgeIdentity", "RepositoryRenameOperation", "RepositorySlug",
     "Suggestion", "SuggestionNote", "SuggestionRelevanceBump", "SuggestionStage",
-]
\ No newline at end of file
+]
diff --git a/api/models/base.py b/api/models/base.py
index 4dfbd1c..578c4d5 100644
--- a/api/models/base.py
+++ b/api/models/base.py
@@ -1,3 +1,5 @@
+import os
+import time
 import uuid
 from datetime import datetime
 
@@ -24,3 +26,28 @@ class TimestampMixin:
 
 def new_uuid() -> uuid.UUID:
     return uuid.uuid4()
+
+
+def new_uuid7() -> uuid.UUID:
+    """Generate a UUIDv7 (RFC 9562): 48-bit big-endian ms timestamp, version
+    and variant bits, remaining bits random. Time-sortable, so primary keys
+    generated with this helper order chronologically without a separate
+    created_at index lookup — the identity layering canon
+    (work-record-types_v0.1.md) calls this out as the primary internal key
+    for new work-record entities.
+
+    Dependency-free (no uuid7 in stdlib before Python 3.14, no third-party
+    lib added for a ~15-line, non-cryptographic layout).
+    """
+    unix_ts_ms = int(time.time() * 1000)
+    rand = int.from_bytes(os.urandom(10), "big")
+    rand_a = (rand >> 62) & 0x0FFF          # top 12 bits of the 80 random bits
+    rand_b = rand & 0x3FFFFFFFFFFFFFFF       # bottom 62 bits
+    value = (
+        (unix_ts_ms << 80)
+        | (0x7 << 76)       # version 7
+        | (rand_a << 64)
+        | (0x2 << 62)        # variant 10
+        | rand_b
+    )
+    return uuid.UUID(int=value)
diff --git a/api/models/capability_request.py b/api/models/capability_request.py
index 8117375..7fdaba1 100644
--- a/api/models/capability_request.py
+++ b/api/models/capability_request.py
@@ -33,7 +33,7 @@ class CapabilityRequest(Base, TimestampMixin):
     )
     requesting_workplan_id: Mapped[uuid.UUID | None] = mapped_column(
         UUID(as_uuid=True),
-        ForeignKey("workplans.id", ondelete="SET NULL"),
+        ForeignKey("workplans.id", ondelete="SET NULL", onupdate="CASCADE"),
         nullable=True,
     )
     requesting_agent: Mapped[str] = mapped_column(String(100), nullable=False)
@@ -47,7 +47,7 @@ class CapabilityRequest(Base, TimestampMixin):
     )
     fulfilling_workplan_id: Mapped[uuid.UUID | None] = mapped_column(
         UUID(as_uuid=True),
-        ForeignKey("workplans.id", ondelete="SET NULL"),
+        ForeignKey("workplans.id", ondelete="SET NULL", onupdate="CASCADE"),
         nullable=True,
     )
     fulfilling_agent: Mapped[str | None] = mapped_column(String(100), nullable=True)
@@ -55,7 +55,7 @@ class CapabilityRequest(Base, TimestampMixin):
     # Links
     blocking_task_id: Mapped[uuid.UUID | None] = mapped_column(
         UUID(as_uuid=True),
-        ForeignKey("tasks.id", ondelete="SET NULL"),
+        ForeignKey("tasks.id", ondelete="SET NULL", onupdate="CASCADE"),
         nullable=True,
     )
     catalog_entry_id: Mapped[uuid.UUID | None] = mapped_column(
diff --git a/api/models/contribution.py b/api/models/contribution.py
index 46b934e..0596784 100644
--- a/api/models/contribution.py
+++ b/api/models/contribution.py
@@ -2,7 +2,7 @@ import enum
 import uuid
 from datetime import datetime
 
-from sqlalchemy import Boolean, DateTime, Enum, ForeignKey, String, Text
+from sqlalchemy import DateTime, Enum, ForeignKey, String, Text
 from sqlalchemy.dialects.postgresql import UUID
 from sqlalchemy.orm import Mapped, mapped_column, relationship
 
@@ -48,7 +48,9 @@ class Contribution(Base, TimestampMixin):
         UUID(as_uuid=True), ForeignKey("topics.id", ondelete="SET NULL"), nullable=True
     )
     related_workplan_id: Mapped[uuid.UUID | None] = mapped_column(
-        UUID(as_uuid=True), ForeignKey("workplans.id", ondelete="SET NULL"), nullable=True
+        UUID(as_uuid=True),
+        ForeignKey("workplans.id", ondelete="SET NULL", onupdate="CASCADE"),
+        nullable=True,
     )
     repo_id: Mapped[uuid.UUID | None] = mapped_column(
         UUID(as_uuid=True), ForeignKey("managed_repos.id", ondelete="SET NULL"), nullable=True
diff --git a/api/models/decision.py b/api/models/decision.py
index 08ae0ed..1e9a2c6 100644
--- a/api/models/decision.py
+++ b/api/models/decision.py
@@ -37,7 +37,10 @@ class Decision(Base, TimestampMixin):
         UUID(as_uuid=True), ForeignKey("topics.id", ondelete="RESTRICT"), nullable=True, index=True
     )
     workplan_id: Mapped[uuid.UUID | None] = mapped_column(
-        UUID(as_uuid=True), ForeignKey("workplans.id", ondelete="RESTRICT"), nullable=True, index=True
+        UUID(as_uuid=True),
+        ForeignKey("workplans.id", ondelete="RESTRICT", onupdate="CASCADE"),
+        nullable=True,
+        index=True,
     )
     title: Mapped[str] = mapped_column(String(255), nullable=False)
     description: Mapped[str | None] = mapped_column(Text, nullable=True)
diff --git a/api/models/extension_point.py b/api/models/extension_point.py
index 84f6c2a..532ade4 100644
--- a/api/models/extension_point.py
+++ b/api/models/extension_point.py
@@ -45,7 +45,9 @@ class ExtensionPoint(Base, TimestampMixin):
         UUID(as_uuid=True), ForeignKey("topics.id", ondelete="SET NULL"), nullable=True
     )
     workplan_id: Mapped[uuid.UUID | None] = mapped_column(
-        UUID(as_uuid=True), ForeignKey("workplans.id", ondelete="SET NULL"), nullable=True
+        UUID(as_uuid=True),
+        ForeignKey("workplans.id", ondelete="SET NULL", onupdate="CASCADE"),
+        nullable=True,
     )
 
     domain: Mapped["Domain"] = relationship("Domain", lazy="selectin")  # noqa: F821
diff --git a/api/models/fabric_graph.py b/api/models/fabric_graph.py
index 850616c..746447b 100644
--- a/api/models/fabric_graph.py
+++ b/api/models/fabric_graph.py
@@ -23,7 +23,7 @@ class FabricGraphImport(Base, TimestampMixin):
     )
     source_repo_slug: Mapped[str] = mapped_column(String(100), nullable=False, index=True)
     source_url: Mapped[str | None] = mapped_column(Text, nullable=True)
-    source_commit: Mapped[str | None] = mapped_column(String(80), nullable=True, index=True)
+    source_commit: Mapped[str | None] = mapped_column(String(255), nullable=True, index=True)
     source_path: Mapped[str | None] = mapped_column(Text, nullable=True)
     api_version: Mapped[str | None] = mapped_column(String(100), nullable=True)
     schema_version: Mapped[str | None] = mapped_column(String(100), nullable=True, index=True)
diff --git a/api/models/intake.py b/api/models/intake.py
new file mode 100644
index 0000000..a9cc84f
--- /dev/null
+++ b/api/models/intake.py
@@ -0,0 +1,129 @@
+import enum
+import uuid
+from datetime import datetime
+
+from sqlalchemy import CheckConstraint, DateTime, Enum, ForeignKey, String, Text
+from sqlalchemy.dialects.postgresql import UUID
+from sqlalchemy.orm import Mapped, mapped_column, relationship
+from sqlalchemy.sql import func
+
+from api.models.base import Base, TimestampMixin, new_uuid7
+
+
+class IntakeLane(str, enum.Enum):
+    green = "green"
+    blue = "blue"
+    yellow = "yellow"
+    orange = "orange"
+    red = "red"
+
+
+class IntakeStatus(str, enum.Enum):
+    open = "open"
+    vetted = "vetted"
+    routed = "routed"
+    closed = "closed"
+
+
+class IntakeOutcome(str, enum.Enum):
+    promoted = "promoted"
+    declined = "declined"
+    absorbed = "absorbed"
+
+
+OPEN_INTAKE_STATUSES = (IntakeStatus.open, IntakeStatus.vetted, IntakeStatus.routed)
+
+
+class Intake(Base, TimestampMixin):
+    """A `kind: intake` work record — a spark: idea, finding, directive, or
+    request, per canon/standards/work-record-types_v0.1.md. Lifecycle:
+    open -> vetted -> routed -> closed(promoted|declined|absorbed).
+
+    Fresh entity per the founder-reviewed architecture draft (2026-07-20,
+    WorkOrchestrationArchitectureDraft.md §8 item 6): not a rename/reuse of
+    the legacy `suggestions` table.
+    """
+
+    __tablename__ = "intakes"
+    __table_args__ = (
+        CheckConstraint(
+            "topic_id IS NOT NULL OR workplan_id IS NOT NULL OR repo_id IS NOT NULL",
+            name="ck_intakes_topic_or_workplan_or_repo",
+        ),
+        CheckConstraint(
+            "(status != 'closed') OR (outcome IS NOT NULL)",
+            name="ck_intakes_closed_requires_outcome",
+        ),
+        CheckConstraint(
+            "(outcome != 'promoted') OR (promoted_to IS NOT NULL)",
+            name="ck_intakes_promoted_requires_promoted_to",
+        ),
+    )
+
+    id: Mapped[uuid.UUID] = mapped_column(
+        UUID(as_uuid=True), primary_key=True, default=new_uuid7
+    )
+    topic_id: Mapped[uuid.UUID | None] = mapped_column(
+        UUID(as_uuid=True), ForeignKey("topics.id", ondelete="SET NULL"), nullable=True, index=True
+    )
+    workplan_id: Mapped[uuid.UUID | None] = mapped_column(
+        UUID(as_uuid=True),
+        ForeignKey("workplans.id", ondelete="SET NULL", onupdate="CASCADE"),
+        nullable=True,
+        index=True,
+    )
+    repo_id: Mapped[uuid.UUID | None] = mapped_column(
+        UUID(as_uuid=True), ForeignKey("managed_repos.id", ondelete="SET NULL"), nullable=True, index=True
+    )
+    title: Mapped[str] = mapped_column(String(500), nullable=False)
+    description: Mapped[str | None] = mapped_column(Text, nullable=True)
+    lane: Mapped[IntakeLane] = mapped_column(
+        Enum(IntakeLane, name="intakelane"), nullable=False, default=IntakeLane.green
+    )
+    status: Mapped[IntakeStatus] = mapped_column(
+        Enum(IntakeStatus, name="intakestatus"),
+        nullable=False,
+        default=IntakeStatus.open,
+        index=True,
+    )
+    outcome: Mapped[IntakeOutcome | None] = mapped_column(
+        Enum(IntakeOutcome, name="intakeoutcome"), nullable=True
+    )
+    origin: Mapped[str | None] = mapped_column(String(200), nullable=True)
+    origin_ref: Mapped[str | None] = mapped_column(String(200), nullable=True, index=True)
+    promoted_to: Mapped[str | None] = mapped_column(String(200), nullable=True)
+    source_repo_path: Mapped[str | None] = mapped_column(
+        Text, nullable=True, doc="Repo-relative path of the source file this record was authored in."
+    )
+    routed_note: Mapped[str | None] = mapped_column(Text, nullable=True)
+    closed_at: Mapped[datetime | None] = mapped_column(DateTime(timezone=True), nullable=True)
+
+    topic: Mapped["Topic | None"] = relationship("Topic", lazy="selectin")  # noqa: F821
+    workplan: Mapped["Workplan | None"] = relationship("Workplan", lazy="selectin")  # noqa: F821
+    repo: Mapped["ManagedRepo | None"] = relationship("ManagedRepo", lazy="selectin")  # noqa: F821
+    notes: Mapped[list["IntakeNote"]] = relationship(
+        "IntakeNote",
+        back_populates="intake",
+        lazy="selectin",
+        order_by="IntakeNote.created_at",
+        cascade="all, delete-orphan",
+    )
+
+
+class IntakeNote(Base):
+    __tablename__ = "intake_notes"
+
+    id: Mapped[uuid.UUID] = mapped_column(UUID(as_uuid=True), primary_key=True, default=new_uuid7)
+    intake_id: Mapped[uuid.UUID] = mapped_column(
+        UUID(as_uuid=True),
+        ForeignKey("intakes.id", ondelete="CASCADE"),
+        nullable=False,
+        index=True,
+    )
+    author: Mapped[str | None] = mapped_column(String(100), nullable=True)
+    content: Mapped[str] = mapped_column(Text, nullable=False)
+    created_at: Mapped[datetime] = mapped_column(
+        DateTime(timezone=True), server_default=func.now(), nullable=False
+    )
+
+    intake: Mapped["Intake"] = relationship("Intake", back_populates="notes")
diff --git a/api/models/managed_repo.py b/api/models/managed_repo.py
index edf4034..993e236 100644
--- a/api/models/managed_repo.py
+++ b/api/models/managed_repo.py
@@ -53,6 +53,21 @@ class ManagedRepo(Base, TimestampMixin):
         "RepoGoal", back_populates="repo", lazy="selectin"
     )
 
+    forge_identity: Mapped["RepositoryForgeIdentity | None"] = relationship(  # noqa: F821
+        "RepositoryForgeIdentity",
+        back_populates="repo",
+        lazy="selectin",
+        uselist=False,
+    )
+
+    slug_records: Mapped[list["RepositorySlug"]] = relationship(  # noqa: F821
+        "RepositorySlug", back_populates="repo", lazy="selectin"
+    )
+
+    rename_operations: Mapped[list["RepositoryRenameOperation"]] = relationship(  # noqa: F821
+        "RepositoryRenameOperation", back_populates="repo", lazy="selectin"
+    )
+
     @property
     def domain_slug(self) -> str:
         return self.domain.slug if self.domain is not None else ""
diff --git a/api/models/progress_event.py b/api/models/progress_event.py
index ca11ffd..b73fe60 100644
--- a/api/models/progress_event.py
+++ b/api/models/progress_event.py
@@ -20,10 +20,16 @@ class ProgressEvent(Base):
         UUID(as_uuid=True), ForeignKey("topics.id", ondelete="RESTRICT"), nullable=True, index=True
     )
     workplan_id: Mapped[uuid.UUID | None] = mapped_column(
-        UUID(as_uuid=True), ForeignKey("workplans.id", ondelete="RESTRICT"), nullable=True, index=True
+        UUID(as_uuid=True),
+        ForeignKey("workplans.id", ondelete="RESTRICT", onupdate="CASCADE"),
+        nullable=True,
+        index=True,
     )
     task_id: Mapped[uuid.UUID | None] = mapped_column(
-        UUID(as_uuid=True), ForeignKey("tasks.id", ondelete="RESTRICT"), nullable=True, index=True
+        UUID(as_uuid=True),
+        ForeignKey("tasks.id", ondelete="RESTRICT", onupdate="CASCADE"),
+        nullable=True,
+        index=True,
     )
     decision_id: Mapped[uuid.UUID | None] = mapped_column(
         UUID(as_uuid=True), ForeignKey("decisions.id", ondelete="RESTRICT"), nullable=True, index=True
diff --git a/api/models/repository_rename.py b/api/models/repository_rename.py
new file mode 100644
index 0000000..b27a92c
--- /dev/null
+++ b/api/models/repository_rename.py
@@ -0,0 +1,292 @@
+import uuid
+from datetime import datetime
+
+from sqlalchemy import (
+    BigInteger,
+    Boolean,
+    CheckConstraint,
+    DateTime,
+    ForeignKey,
+    ForeignKeyConstraint,
+    Index,
+    String,
+    Text,
+    UniqueConstraint,
+    text,
+)
+from sqlalchemy.dialects.postgresql import JSONB, UUID
+from sqlalchemy.orm import Mapped, mapped_column, relationship
+
+from api.models.base import Base, TimestampMixin, new_uuid
+
+
+FORGE_IDENTITY_STATES = ("unverified", "verified")
+REPOSITORY_SLUG_KINDS = ("canonical", "alias")
+REPOSITORY_RENAME_PHASES = (
+    "draft",
+    "preflighted",
+    "forge-renamed",
+    "statehub-rebound",
+    "source-synced",
+    "consumers-verified",
+    "completed",
+    "rollback-preflight",
+    "rolled-back",
+)
+TERMINAL_REPOSITORY_RENAME_PHASES = ("completed", "rolled-back")
+
+
+class RepositoryForgeIdentity(Base, TimestampMixin):
+    """One explicitly verified (or explicitly unverified) Forge identity per repo."""
+
+    __tablename__ = "repository_forge_identities"
+    __table_args__ = (
+        UniqueConstraint("repo_id", name="uq_repository_forge_identities_repo_id"),
+        UniqueConstraint(
+            "id",
+            "repo_id",
+            "verification_state",
+            name="uq_repository_forge_identity_verified_ref",
+        ),
+        UniqueConstraint(
+            "provider",
+            "forge_instance",
+            "forge_owner",
+            "forge_repository_id",
+            name="uq_repository_forge_identity_tuple",
+        ),
+        CheckConstraint(
+            "verification_state IN ('unverified', 'verified')",
+            name="ck_repository_forge_identity_state",
+        ),
+        CheckConstraint(
+            "forge_repository_id IS NULL OR forge_repository_id > 0",
+            name="ck_repository_forge_id_positive",
+        ),
+        CheckConstraint(
+            "verification_state != 'verified' OR "
+            "(provider IS NOT NULL AND forge_instance IS NOT NULL "
+            "AND forge_owner IS NOT NULL AND forge_repository_id IS NOT NULL "
+            "AND verified_at IS NOT NULL AND verified_by IS NOT NULL)",
+            name="ck_repository_forge_verified_complete",
+        ),
+        CheckConstraint(
+            "verification_state = 'verified' OR "
+            "(verified_at IS NULL AND verified_by IS NULL)",
+            name="ck_repository_forge_unverified_has_no_attestation",
+        ),
+    )
+
+    id: Mapped[uuid.UUID] = mapped_column(
+        UUID(as_uuid=True), primary_key=True, default=new_uuid
+    )
+    repo_id: Mapped[uuid.UUID] = mapped_column(
+        UUID(as_uuid=True),
+        ForeignKey("managed_repos.id", ondelete="RESTRICT"),
+        nullable=False,
+    )
+    provider: Mapped[str | None] = mapped_column(String(40), nullable=True)
+    forge_instance: Mapped[str | None] = mapped_column(String(255), nullable=True)
+    forge_owner: Mapped[str | None] = mapped_column(String(255), nullable=True)
+    forge_repository_id: Mapped[int | None] = mapped_column(BigInteger, nullable=True)
+    verification_state: Mapped[str] = mapped_column(
+        String(20), nullable=False, default="unverified", server_default="unverified"
+    )
+    verified_at: Mapped[datetime | None] = mapped_column(
+        DateTime(timezone=True), nullable=True
+    )
+    verified_by: Mapped[str | None] = mapped_column(String(160), nullable=True)
+    verification_evidence: Mapped[dict] = mapped_column(
+        JSONB, nullable=False, default=dict, server_default="{}"
+    )
+
+    repo: Mapped["ManagedRepo"] = relationship(  # noqa: F821
+        "ManagedRepo", back_populates="forge_identity", lazy="selectin"
+    )
+    rename_operations: Mapped[list["RepositoryRenameOperation"]] = relationship(
+        "RepositoryRenameOperation",
+        back_populates="forge_identity",
+        lazy="selectin",
+        viewonly=True,
+    )
+
+
+class RepositoryRenameOperation(Base, TimestampMixin):
+    """Append-preserving journal for one phased canonical-coordinate change."""
+
+    __tablename__ = "repository_rename_operations"
+    __table_args__ = (
+        CheckConstraint(
+            "phase IN ('draft', 'preflighted', 'forge-renamed', "
+            "'statehub-rebound', 'source-synced', 'consumers-verified', "
+            "'completed', 'rollback-preflight', 'rolled-back')",
+            name="ck_repository_rename_phase",
+        ),
+        CheckConstraint(
+            "old_slug != new_slug", name="ck_repository_rename_distinct_slugs"
+        ),
+        CheckConstraint(
+            "expected_forge_repository_id > 0",
+            name="ck_repository_rename_forge_id_positive",
+        ),
+        CheckConstraint(
+            "forge_identity_state = 'verified'",
+            name="ck_repository_rename_verified_identity",
+        ),
+        CheckConstraint(
+            "phase = 'draft' OR preflighted_at IS NOT NULL",
+            name="ck_repository_rename_preflight_timestamp",
+        ),
+        CheckConstraint(
+            "phase != 'completed' OR completed_at IS NOT NULL",
+            name="ck_repository_rename_completed_timestamp",
+        ),
+        CheckConstraint(
+            "phase != 'rolled-back' OR rolled_back_at IS NOT NULL",
+            name="ck_repository_rename_rollback_timestamp",
+        ),
+        Index(
+            "uq_repository_rename_active_repo",
+            "repo_id",
+            unique=True,
+            postgresql_where=text("phase NOT IN ('completed', 'rolled-back')"),
+        ),
+        Index(
+            "uq_repository_rename_active_new_slug",
+            "new_slug",
+            unique=True,
+            postgresql_where=text("phase NOT IN ('completed', 'rolled-back')"),
+        ),
+        Index(
+            "ix_repository_rename_phase", "phase"
+        ),
+        ForeignKeyConstraint(
+            ["forge_identity_id", "repo_id", "forge_identity_state"],
+            [
+                "repository_forge_identities.id",
+                "repository_forge_identities.repo_id",
+                "repository_forge_identities.verification_state",
+            ],
+            name="fk_repository_rename_verified_identity",
+            ondelete="RESTRICT",
+        ),
+    )
+
+    id: Mapped[uuid.UUID] = mapped_column(
+        UUID(as_uuid=True), primary_key=True, default=new_uuid
+    )
+    repo_id: Mapped[uuid.UUID] = mapped_column(
+        UUID(as_uuid=True),
+        ForeignKey("managed_repos.id", ondelete="RESTRICT"),
+        nullable=False,
+        index=True,
+    )
+    forge_identity_id: Mapped[uuid.UUID] = mapped_column(
+        UUID(as_uuid=True), nullable=False
+    )
+    forge_identity_state: Mapped[str] = mapped_column(
+        String(20), nullable=False, default="verified", server_default="verified"
+    )
+    expected_provider: Mapped[str] = mapped_column(String(40), nullable=False)
+    expected_forge_instance: Mapped[str] = mapped_column(String(255), nullable=False)
+    expected_forge_owner: Mapped[str] = mapped_column(String(255), nullable=False)
+    expected_forge_repository_id: Mapped[int] = mapped_column(
+        BigInteger, nullable=False
+    )
+    expected_source_commit: Mapped[str] = mapped_column(String(64), nullable=False)
+    expected_default_branch: Mapped[str] = mapped_column(String(255), nullable=False)
+    old_slug: Mapped[str] = mapped_column(String(100), nullable=False, index=True)
+    new_slug: Mapped[str] = mapped_column(String(100), nullable=False, index=True)
+    old_coordinates: Mapped[dict] = mapped_column(JSONB, nullable=False)
+    new_coordinates: Mapped[dict] = mapped_column(JSONB, nullable=False)
+    phase: Mapped[str] = mapped_column(
+        String(32), nullable=False, default="draft", server_default="draft"
+    )
+    actor: Mapped[str] = mapped_column(String(160), nullable=False)
+    phase_changed_at: Mapped[datetime] = mapped_column(
+        DateTime(timezone=True), nullable=False
+    )
+    preflighted_at: Mapped[datetime | None] = mapped_column(
+        DateTime(timezone=True), nullable=True
+    )
+    preflight_expires_at: Mapped[datetime | None] = mapped_column(
+        DateTime(timezone=True), nullable=True
+    )
+    completed_at: Mapped[datetime | None] = mapped_column(
+        DateTime(timezone=True), nullable=True
+    )
+    rolled_back_at: Mapped[datetime | None] = mapped_column(
+        DateTime(timezone=True), nullable=True
+    )
+    evidence: Mapped[dict] = mapped_column(
+        JSONB, nullable=False, default=dict, server_default="{}"
+    )
+    error_code: Mapped[str | None] = mapped_column(String(80), nullable=True)
+    error_message: Mapped[str | None] = mapped_column(Text, nullable=True)
+    error_details: Mapped[dict | None] = mapped_column(JSONB, nullable=True)
+    error_at: Mapped[datetime | None] = mapped_column(
+        DateTime(timezone=True), nullable=True
+    )
+
+    repo: Mapped["ManagedRepo"] = relationship(  # noqa: F821
+        "ManagedRepo", back_populates="rename_operations", lazy="selectin"
+    )
+    forge_identity: Mapped[RepositoryForgeIdentity] = relationship(
+        "RepositoryForgeIdentity",
+        back_populates="rename_operations",
+        lazy="selectin",
+        viewonly=True,
+    )
+    slugs: Mapped[list["RepositorySlug"]] = relationship(
+        "RepositorySlug", back_populates="source_operation", lazy="selectin"
+    )
+
+
+class RepositorySlug(Base, TimestampMixin):
+    """Global uniqueness boundary for current and protected prior slugs."""
+
+    __tablename__ = "repository_slugs"
+    __table_args__ = (
+        UniqueConstraint("slug", name="uq_repository_slugs_slug"),
+        CheckConstraint(
+            "kind IN ('canonical', 'alias')", name="ck_repository_slug_kind"
+        ),
+        CheckConstraint(
+            "kind != 'alias' OR protected",
+            name="ck_repository_slug_alias_protected",
+        ),
+        Index(
+            "uq_repository_slugs_one_canonical",
+            "repo_id",
+            unique=True,
+            postgresql_where=text("kind = 'canonical'"),
+        ),
+        Index("ix_repository_slugs_repo_kind", "repo_id", "kind"),
+    )
+
+    id: Mapped[uuid.UUID] = mapped_column(
+        UUID(as_uuid=True), primary_key=True, default=new_uuid
+    )
+    repo_id: Mapped[uuid.UUID] = mapped_column(
+        UUID(as_uuid=True),
+        ForeignKey("managed_repos.id", ondelete="RESTRICT"),
+        nullable=False,
+    )
+    slug: Mapped[str] = mapped_column(String(100), nullable=False)
+    kind: Mapped[str] = mapped_column(String(16), nullable=False)
+    protected: Mapped[bool] = mapped_column(
+        Boolean, nullable=False, default=True, server_default="true"
+    )
+    source_operation_id: Mapped[uuid.UUID | None] = mapped_column(
+        UUID(as_uuid=True),
+        ForeignKey("repository_rename_operations.id", ondelete="RESTRICT"),
+        nullable=True,
+        index=True,
+    )
+
+    repo: Mapped["ManagedRepo"] = relationship(  # noqa: F821
+        "ManagedRepo", back_populates="slug_records", lazy="selectin"
+    )
+    source_operation: Mapped[RepositoryRenameOperation | None] = relationship(
+        "RepositoryRenameOperation", back_populates="slugs", lazy="selectin"
+    )
diff --git a/api/models/review_contract.py b/api/models/review_contract.py
new file mode 100644
index 0000000..392235e
--- /dev/null
+++ b/api/models/review_contract.py
@@ -0,0 +1,128 @@
+import uuid
+from datetime import datetime
+
+from sqlalchemy import (
+    Boolean,
+    DateTime,
+    ForeignKey,
+    Index,
+    String,
+    Text,
+    UniqueConstraint,
+)
+from sqlalchemy.dialects.postgresql import JSONB, UUID
+from sqlalchemy.orm import Mapped, mapped_column, relationship
+
+from api.models.base import Base, TimestampMixin, new_uuid7
+
+
+class ReviewContract(Base, TimestampMixin):
+    """Replaceable projection of one authoritative review-contract revision."""
+
+    __tablename__ = "review_contracts"
+
+    id: Mapped[uuid.UUID] = mapped_column(
+        UUID(as_uuid=True), primary_key=True, default=new_uuid7
+    )
+    contract_key: Mapped[str] = mapped_column(String(160), nullable=False, index=True)
+    schema_version: Mapped[str] = mapped_column(String(40), nullable=False)
+    contract_digest: Mapped[str] = mapped_column(
+        String(64), nullable=False, unique=True
+    )
+    source_repo: Mapped[str] = mapped_column(String(100), nullable=False)
+    source_path: Mapped[str] = mapped_column(Text, nullable=False)
+    source_revision: Mapped[str] = mapped_column(String(64), nullable=False)
+    document: Mapped[dict] = mapped_column(JSONB, nullable=False)
+    active: Mapped[bool] = mapped_column(
+        Boolean, nullable=False, default=True, index=True
+    )
+    required_for_decision: Mapped[bool] = mapped_column(
+        Boolean, nullable=False, default=False
+    )
+    decision_id: Mapped[uuid.UUID | None] = mapped_column(
+        UUID(as_uuid=True),
+        ForeignKey("decisions.id", ondelete="RESTRICT"),
+        nullable=True,
+        index=True,
+    )
+    workplan_id: Mapped[uuid.UUID | None] = mapped_column(
+        UUID(as_uuid=True),
+        ForeignKey("workplans.id", ondelete="RESTRICT", onupdate="CASCADE"),
+        nullable=True,
+        index=True,
+    )
+    task_id: Mapped[uuid.UUID | None] = mapped_column(
+        UUID(as_uuid=True),
+        ForeignKey("tasks.id", ondelete="RESTRICT", onupdate="CASCADE"),
+        nullable=True,
+        index=True,
+    )
+    projected_at: Mapped[datetime] = mapped_column(
+        DateTime(timezone=True), nullable=False
+    )
+
+    receipts: Mapped[list["ReviewReceipt"]] = relationship(
+        "ReviewReceipt", back_populates="contract", lazy="selectin"
+    )
+
+    __table_args__ = (
+        UniqueConstraint(
+            "contract_key",
+            "source_repo",
+            "source_path",
+            "source_revision",
+            name="uq_review_contract_source_revision",
+        ),
+        Index("ix_review_contract_key_active", "contract_key", "active"),
+    )
+
+
+class ReviewReceipt(Base, TimestampMixin):
+    """Immutable evidence submitted against an exact contract digest."""
+
+    __tablename__ = "review_receipts"
+
+    id: Mapped[uuid.UUID] = mapped_column(
+        UUID(as_uuid=True), primary_key=True, default=new_uuid7
+    )
+    contract_id: Mapped[uuid.UUID] = mapped_column(
+        UUID(as_uuid=True),
+        ForeignKey("review_contracts.id", ondelete="RESTRICT"),
+        nullable=False,
+        index=True,
+    )
+    owner_id: Mapped[str] = mapped_column(String(160), nullable=False, index=True)
+    actor: Mapped[str] = mapped_column(String(160), nullable=False)
+    disposition: Mapped[str] = mapped_column(String(32), nullable=False)
+    contract_digest: Mapped[str] = mapped_column(String(64), nullable=False, index=True)
+    receipt_digest: Mapped[str] = mapped_column(String(64), nullable=False, unique=True)
+    artifact_hashes: Mapped[dict] = mapped_column(JSONB, nullable=False, default=dict)
+    assertion_ids: Mapped[list] = mapped_column(JSONB, nullable=False, default=list)
+    checks: Mapped[list] = mapped_column(JSONB, nullable=False, default=list)
+    note: Mapped[str | None] = mapped_column(Text, nullable=True)
+    source_repo: Mapped[str] = mapped_column(String(100), nullable=False)
+    source_path: Mapped[str] = mapped_column(Text, nullable=False)
+    source_revision: Mapped[str] = mapped_column(String(64), nullable=False)
+    submitted_at: Mapped[datetime] = mapped_column(
+        DateTime(timezone=True), nullable=False, index=True
+    )
+    document: Mapped[dict] = mapped_column(JSONB, nullable=False)
+
+    contract: Mapped[ReviewContract] = relationship(
+        "ReviewContract", back_populates="receipts"
+    )
+
+    __table_args__ = (
+        UniqueConstraint(
+            "source_repo",
+            "source_path",
+            "source_revision",
+            name="uq_review_receipt_source_revision",
+        ),
+        Index(
+            "ix_review_receipt_contract_owner_time",
+            "contract_id",
+            "owner_id",
+            "submitted_at",
+        ),
+    )
diff --git a/api/models/suggestion.py b/api/models/suggestion.py
index df5a791..7b46abc 100644
--- a/api/models/suggestion.py
+++ b/api/models/suggestion.py
@@ -36,7 +36,9 @@ class Suggestion(Base, TimestampMixin):
         UUID(as_uuid=True), ForeignKey("topics.id", ondelete="SET NULL"), nullable=True
     )
     workplan_id: Mapped[uuid.UUID | None] = mapped_column(
-        UUID(as_uuid=True), ForeignKey("workplans.id", ondelete="SET NULL"), nullable=True
+        UUID(as_uuid=True),
+        ForeignKey("workplans.id", ondelete="SET NULL", onupdate="CASCADE"),
+        nullable=True,
     )
     title: Mapped[str] = mapped_column(String(500), nullable=False)
     description: Mapped[str | None] = mapped_column(Text, nullable=True)
@@ -61,7 +63,9 @@ class Suggestion(Base, TimestampMixin):
         Float, nullable=False, default=1.0, server_default="1"
     )
     promoted_task_id: Mapped[uuid.UUID | None] = mapped_column(
-        UUID(as_uuid=True), ForeignKey("tasks.id", ondelete="SET NULL"), nullable=True
+        UUID(as_uuid=True),
+        ForeignKey("tasks.id", ondelete="SET NULL", onupdate="CASCADE"),
+        nullable=True,
     )
 
     domain: Mapped["Domain"] = relationship("Domain", lazy="selectin")  # noqa: F821
@@ -117,4 +121,4 @@ class SuggestionRelevanceBump(Base):
     reason: Mapped[str | None] = mapped_column(Text, nullable=True)
     created_at: Mapped[datetime] = mapped_column(
         DateTime(timezone=True), server_default=func.now(), nullable=False
-    )
\ No newline at end of file
+    )
diff --git a/api/models/task.py b/api/models/task.py
index ecdb35b..b91d14e 100644
--- a/api/models/task.py
+++ b/api/models/task.py
@@ -31,8 +31,18 @@ class Task(Base, TimestampMixin):
         UUID(as_uuid=True), primary_key=True, default=new_uuid
     )
     workplan_id: Mapped[uuid.UUID] = mapped_column(
-        UUID(as_uuid=True), ForeignKey("workplans.id", ondelete="RESTRICT"), nullable=False, index=True
+        UUID(as_uuid=True),
+        ForeignKey("workplans.id", ondelete="RESTRICT", onupdate="CASCADE"),
+        nullable=False,
+        index=True,
     )
+    # Canonical work-record identifier, e.g. "CUST-WP-0067-T01" (ADR-007).
+    # Nullable because rows created before STATE-WP-0083-T06 have none; only the
+    # repository files know the mapping. Without it a task can be matched only by
+    # title, so renaming a heading looks like one task vanishing and another
+    # appearing.
+    record_id: Mapped[str | None] = mapped_column(String(120), nullable=True, index=True)
+    flavor: Mapped[str | None] = mapped_column(String(32), nullable=True, index=True)
     title: Mapped[str] = mapped_column(String(255), nullable=False)
     description: Mapped[str | None] = mapped_column(Text, nullable=True)
     status: Mapped[TaskStatus] = mapped_column(
@@ -47,7 +57,9 @@ class Task(Base, TimestampMixin):
     needs_human: Mapped[bool] = mapped_column(Boolean, default=False, nullable=False, index=True)
     intervention_note: Mapped[str | None] = mapped_column(Text, nullable=True)
     parent_task_id: Mapped[uuid.UUID | None] = mapped_column(
-        UUID(as_uuid=True), ForeignKey("tasks.id", ondelete="SET NULL"), nullable=True
+        UUID(as_uuid=True),
+        ForeignKey("tasks.id", ondelete="SET NULL", onupdate="CASCADE"),
+        nullable=True,
     )
 
     workplan: Mapped["Workplan"] = relationship("Workplan", back_populates="tasks")  # noqa: F821
diff --git a/api/models/technical_debt.py b/api/models/technical_debt.py
index d501f60..334bf6a 100644
--- a/api/models/technical_debt.py
+++ b/api/models/technical_debt.py
@@ -77,7 +77,9 @@ class TechnicalDebt(Base, TimestampMixin):
         UUID(as_uuid=True), ForeignKey("topics.id", ondelete="SET NULL"), nullable=True
     )
     workplan_id: Mapped[uuid.UUID | None] = mapped_column(
-        UUID(as_uuid=True), ForeignKey("workplans.id", ondelete="SET NULL"), nullable=True
+        UUID(as_uuid=True),
+        ForeignKey("workplans.id", ondelete="SET NULL", onupdate="CASCADE"),
+        nullable=True,
     )
 
     domain: Mapped["Domain"] = relationship("Domain", lazy="selectin")  # noqa: F821
diff --git a/api/models/token_event.py b/api/models/token_event.py
index cc85825..f1dfe79 100644
--- a/api/models/token_event.py
+++ b/api/models/token_event.py
@@ -1,9 +1,16 @@
 import uuid
 from datetime import datetime
-
 from typing import Any
 
-from sqlalchemy import DateTime, Float, ForeignKey, Integer, Text, UniqueConstraint, func
+from sqlalchemy import (
+    DateTime,
+    Float,
+    ForeignKey,
+    Integer,
+    Text,
+    UniqueConstraint,
+    func,
+)
 from sqlalchemy.dialects.postgresql import JSONB, UUID
 from sqlalchemy.orm import Mapped, mapped_column, relationship
 
@@ -25,10 +32,16 @@ class TokenEvent(Base):
         UUID(as_uuid=True), primary_key=True, default=new_uuid
     )
     task_id: Mapped[uuid.UUID | None] = mapped_column(
-        UUID(as_uuid=True), ForeignKey("tasks.id", ondelete="SET NULL"), nullable=True, index=True
+        UUID(as_uuid=True),
+        ForeignKey("tasks.id", ondelete="SET NULL", onupdate="CASCADE"),
+        nullable=True,
+        index=True,
     )
     workplan_id: Mapped[uuid.UUID | None] = mapped_column(
-        UUID(as_uuid=True), ForeignKey("workplans.id", ondelete="SET NULL"), nullable=True, index=True
+        UUID(as_uuid=True),
+        ForeignKey("workplans.id", ondelete="SET NULL", onupdate="CASCADE"),
+        nullable=True,
+        index=True,
     )
     repo_id: Mapped[uuid.UUID | None] = mapped_column(
         UUID(as_uuid=True), ForeignKey("managed_repos.id", ondelete="SET NULL"), nullable=True, index=True
diff --git a/api/models/work_record_identifier_alias.py b/api/models/work_record_identifier_alias.py
new file mode 100644
index 0000000..23f389c
--- /dev/null
+++ b/api/models/work_record_identifier_alias.py
@@ -0,0 +1,44 @@
+from __future__ import annotations
+
+import uuid
+from datetime import datetime
+
+from sqlalchemy import CheckConstraint, DateTime, String, UniqueConstraint
+from sqlalchemy.dialects.postgresql import UUID
+from sqlalchemy.orm import Mapped, mapped_column
+
+from api.models.base import Base, TimestampMixin, new_uuid
+
+
+class WorkRecordIdentifierAlias(Base, TimestampMixin):
+    """Durable provenance for a canonical work-record UUID replacement."""
+
+    __tablename__ = "work_record_identifier_aliases"
+    __table_args__ = (
+        CheckConstraint(
+            "record_kind IN ('workplan', 'task')",
+            name="ck_work_record_identifier_aliases_kind",
+        ),
+        CheckConstraint(
+            "migration_status IN ('prepared', 'applied', 'reversed')",
+            name="ck_work_record_identifier_aliases_status",
+        ),
+        UniqueConstraint("old_id", name="uq_work_record_identifier_aliases_old_id"),
+        UniqueConstraint("new_id", name="uq_work_record_identifier_aliases_new_id"),
+    )
+
+    id: Mapped[uuid.UUID] = mapped_column(
+        UUID(as_uuid=True), primary_key=True, default=new_uuid
+    )
+    old_id: Mapped[uuid.UUID] = mapped_column(UUID(as_uuid=True), nullable=False)
+    new_id: Mapped[uuid.UUID] = mapped_column(UUID(as_uuid=True), nullable=False)
+    record_kind: Mapped[str] = mapped_column(String(20), nullable=False)
+    record_id: Mapped[str] = mapped_column(String(160), nullable=False, index=True)
+    repo_slug: Mapped[str] = mapped_column(String(100), nullable=False, index=True)
+    namespace: Mapped[str] = mapped_column(String(64), nullable=False)
+    plan_sha256: Mapped[str] = mapped_column(String(64), nullable=False, index=True)
+    migration_status: Mapped[str] = mapped_column(
+        String(20), nullable=False, default="prepared", server_default="prepared"
+    )
+    applied_at: Mapped[datetime | None] = mapped_column(DateTime(timezone=True), nullable=True)
+    reversed_at: Mapped[datetime | None] = mapped_column(DateTime(timezone=True), nullable=True)
diff --git a/api/models/workplan.py b/api/models/workplan.py
index 7fcf51f..8006b28 100644
--- a/api/models/workplan.py
+++ b/api/models/workplan.py
@@ -39,6 +39,9 @@ class Workplan(Base, TimestampMixin):
     queue_rank: Mapped[int | None] = mapped_column(Integer, nullable=True, index=True)
     execution_group: Mapped[str | None] = mapped_column(String(100), nullable=True, index=True)
     scheduled_for: Mapped[datetime | None] = mapped_column(DateTime(timezone=True), nullable=True, index=True)
+    flavor: Mapped[str | None] = mapped_column(String(32), nullable=True, index=True)
+    flavor_promotion_reason: Mapped[str | None] = mapped_column(String(32), nullable=True)
+    flavor_promoted_from: Mapped[str | None] = mapped_column(String(32), nullable=True)
 
     repo_id: Mapped[uuid.UUID] = mapped_column(
         UUID(as_uuid=True),
@@ -53,6 +56,16 @@ class Workplan(Base, TimestampMixin):
         index=True,
     )
     backing_filename: Mapped[str | None] = mapped_column(String(255), nullable=True)
+    # Projection provenance and retirement (ADR-012 decisions 2 and 7).
+    # A retired record is one the forge no longer derives. It is not deleted:
+    # hub-native records reference it with RESTRICT and must survive. It is not
+    # `archived` either — that says the owner closed the work, which is a
+    # different fact.
+    projection_retired_at: Mapped["datetime | None"] = mapped_column(  # noqa: F821
+        DateTime(timezone=True), nullable=True, index=True
+    )
+    projection_retired_reason: Mapped[str | None] = mapped_column(String(255), nullable=True)
+    derived_from_commit: Mapped[str | None] = mapped_column(String(40), nullable=True)
     backing_relative_path: Mapped[str | None] = mapped_column(Text, nullable=True)
     backing_archived: Mapped[bool | None] = mapped_column(nullable=True)
     backing_synced_at: Mapped[datetime | None] = mapped_column(
diff --git a/api/models/workplan_dependency.py b/api/models/workplan_dependency.py
index 4ec5391..d74b6e0 100644
--- a/api/models/workplan_dependency.py
+++ b/api/models/workplan_dependency.py
@@ -45,19 +45,19 @@ class WorkplanDependency(Base, TimestampMixin):
     )
     from_workplan_id: Mapped[uuid.UUID] = mapped_column(
         UUID(as_uuid=True),
-        ForeignKey("workplans.id", ondelete="CASCADE"),
+        ForeignKey("workplans.id", ondelete="CASCADE", onupdate="CASCADE"),
         nullable=False,
         index=True,
     )
     to_workplan_id: Mapped[uuid.UUID | None] = mapped_column(
         UUID(as_uuid=True),
-        ForeignKey("workplans.id", ondelete="CASCADE"),
+        ForeignKey("workplans.id", ondelete="CASCADE", onupdate="CASCADE"),
         nullable=True,
         index=True,
     )
     to_task_id: Mapped[uuid.UUID | None] = mapped_column(
         UUID(as_uuid=True),
-        ForeignKey("tasks.id", ondelete="CASCADE"),
+        ForeignKey("tasks.id", ondelete="CASCADE", onupdate="CASCADE"),
         nullable=True,
         index=True,
     )
@@ -72,4 +72,4 @@ class WorkplanDependency(Base, TimestampMixin):
     to_workplan: Mapped["Workplan | None"] = relationship(  # noqa: F821
         "Workplan", foreign_keys=[to_workplan_id]
     )
-    to_task: Mapped["Task | None"] = relationship("Task", foreign_keys=[to_task_id])  # noqa: F821
\ No newline at end of file
+    to_task: Mapped["Task | None"] = relationship("Task", foreign_keys=[to_task_id])  # noqa: F821
diff --git a/api/models/workplan_launch_request.py b/api/models/workplan_launch_request.py
index dec994d..284bd37 100644
--- a/api/models/workplan_launch_request.py
+++ b/api/models/workplan_launch_request.py
@@ -15,7 +15,7 @@ class WorkplanLaunchRequest(Base, TimestampMixin):
     )
     workplan_id: Mapped[uuid.UUID] = mapped_column(
         UUID(as_uuid=True),
-        ForeignKey("workplans.id", ondelete="CASCADE"),
+        ForeignKey("workplans.id", ondelete="CASCADE", onupdate="CASCADE"),
         nullable=False,
         index=True,
     )
diff --git a/api/routers/capability_requests.py b/api/routers/capability_requests.py
index 3192004..271ed41 100644
--- a/api/routers/capability_requests.py
+++ b/api/routers/capability_requests.py
@@ -1,7 +1,7 @@
 import re
 import uuid
 from datetime import datetime, timezone
-from fastapi import HTTPException
+from fastapi import APIRouter, Depends, HTTPException, Query, status
 from sqlalchemy import select
 from sqlalchemy.ext.asyncio import AsyncSession
 
@@ -11,7 +11,6 @@ from api.models.agent_message import AgentMessage
 from api.models.capability_catalog import CapabilityCatalog
 from api.models.capability_request import CapabilityRequest
 from api.models.domain import Domain
-from api.models.managed_repo import ManagedRepo
 from api.models.task import Task
 from api.services.suggestion_relevance import bump_matching_for_capability_request
 from api.schemas.capability_request import (
@@ -22,12 +21,15 @@ from api.schemas.capability_request import (
     CapabilityRequestRead,
     CapabilityRequestReroute,
     CapabilityRequestStatusPatch,
+    CatalogCreate,
+    CatalogPatch,
+    CatalogRead,
 )
 from hub_core.routers.capabilities import (
-    create_capability_catalog_router,
     create_capability_request_read_router,
     create_capability_request_write_router,
 )
+from api.services.repository_aliases import resolve_repository_slug
 
 
 # ---------------------------------------------------------------------------
@@ -394,12 +396,102 @@ def _check_transition(current: str, target: str) -> None:
         )
 
 
-router = create_capability_catalog_router(
-    get_session,
-    domain_model=Domain,
-    repo_model=ManagedRepo,
-    catalog_model=CapabilityCatalog,
+router = APIRouter(tags=["capability-requests"])
+
+
+async def _catalog_domain(slug: str, session: AsyncSession) -> Domain:
+    domain = (
+        await session.execute(select(Domain).where(Domain.slug == slug))
+    ).scalar_one_or_none()
+    if domain is None:
+        raise HTTPException(status_code=404, detail=f"Domain '{slug}' not found")
+    return domain
+
+
+@router.post(
+    "/capability-catalog/",
+    response_model=CatalogRead,
+    status_code=status.HTTP_201_CREATED,
 )
+async def create_catalog_entry(
+    body: CatalogCreate,
+    session: AsyncSession = Depends(get_session),
+) -> CapabilityCatalog:
+    domain = await _catalog_domain(body.domain, session)
+    repo_id = None
+    if body.repo_slug:
+        repo_id = (await resolve_repository_slug(session, body.repo_slug)).repo.id
+    entry = CapabilityCatalog(
+        domain_id=domain.id,
+        repo_id=repo_id,
+        capability_type=body.capability_type,
+        title=body.title,
+        description=body.description,
+        keywords=body.keywords,
+    )
+    session.add(entry)
+    try:
+        await session.commit()
+    except Exception:
+        await session.rollback()
+        raise HTTPException(
+            status_code=409,
+            detail=(
+                f"Catalog entry '{body.title}' for type '{body.capability_type}' "
+                f"already exists in domain '{body.domain}'"
+            ),
+        )
+    await session.refresh(entry)
+    return entry
+
+
+@router.get("/capability-catalog/", response_model=list[CatalogRead])
+async def list_catalog(
+    domain: str | None = Query(None),
+    capability_type: str | None = Query(None),
+    status_filter: str | None = Query(None, alias="status"),
+    repo_slug: str | None = Query(None),
+    session: AsyncSession = Depends(get_session),
+) -> list[CapabilityCatalog]:
+    query = select(CapabilityCatalog).order_by(CapabilityCatalog.created_at.desc())
+    if domain:
+        query = query.where(
+            CapabilityCatalog.domain_id == (await _catalog_domain(domain, session)).id
+        )
+    if capability_type:
+        query = query.where(CapabilityCatalog.capability_type == capability_type)
+    if repo_slug:
+        query = query.where(
+            CapabilityCatalog.repo_id
+            == (await resolve_repository_slug(session, repo_slug)).repo.id
+        )
+    if status_filter and status_filter != "all":
+        query = query.where(CapabilityCatalog.status == status_filter)
+    elif not status_filter:
+        query = query.where(CapabilityCatalog.status == "active")
+    return list((await session.execute(query)).scalars().all())
+
+
+@router.patch("/capability-catalog/{entry_id}", response_model=CatalogRead)
+async def patch_catalog_entry(
+    entry_id: uuid.UUID,
+    body: CatalogPatch,
+    session: AsyncSession = Depends(get_session),
+) -> CapabilityCatalog:
+    entry = await session.get(CapabilityCatalog, entry_id)
+    if entry is None:
+        raise HTTPException(status_code=404, detail=f"Catalog entry '{entry_id}' not found")
+    if body.repo_slug is not None:
+        entry.repo_id = (await resolve_repository_slug(session, body.repo_slug)).repo.id
+    for field in ("description", "keywords", "status"):
+        value = getattr(body, field)
+        if value is not None:
+            setattr(entry, field, value)
+    await session.commit()
+    await session.refresh(entry)
+    return entry
+
+
 router.include_router(
     create_capability_request_read_router(
         get_session,
@@ -432,4 +524,4 @@ router.include_router(
         after_dispute=_notify_on_dispute,
         after_reroute=_notify_on_reroute,
     )
-)
\ No newline at end of file
+)
diff --git a/api/routers/decisions.py b/api/routers/decisions.py
index 9e777b7..069e9a0 100644
--- a/api/routers/decisions.py
+++ b/api/routers/decisions.py
@@ -6,7 +6,6 @@ from pathlib import Path
 
 from fastapi import APIRouter, Depends, HTTPException, Request, Response, status
 
-logger = logging.getLogger(__name__)
 from sqlalchemy import select
 from sqlalchemy.ext.asyncio import AsyncSession
 
@@ -14,9 +13,12 @@ from api.database import get_session
 from api.events import EventEnvelope, publish_event
 from api.models.decision import Decision, DecisionStatus, DecisionType
 from api.models.progress_event import ProgressEvent
+from api.models.review_contract import ReviewContract
 from api.schemas.decision import DecisionCreate, DecisionRead, DecisionResolve, DecisionUpdate
 from api.services.legacy_compat import meter_legacy_body_from_model, meter_legacy_query_param
+from api.services.review_contracts import aggregate
 
+logger = logging.getLogger(__name__)
 router = APIRouter(prefix="/decisions", tags=["decisions"])
 
 _FINANCIAL_LEGAL_KEYWORDS = (
@@ -154,6 +156,25 @@ async def resolve_decision_action(
     if decision.status == DecisionStatus.resolved:
         raise HTTPException(status_code=409, detail="Decision already resolved")
 
+    review_rows = await session.execute(
+        select(ReviewContract).where(
+            ReviewContract.decision_id == decision.id,
+            ReviewContract.active.is_(True),
+            ReviewContract.required_for_decision.is_(True),
+        )
+    )
+    for contract in review_rows.scalars():
+        review_state = await aggregate(session, contract)
+        if not review_state.satisfied:
+            raise HTTPException(
+                status_code=409,
+                detail={
+                    "message": "required multi-owner review is not satisfied",
+                    "contract_key": contract.contract_key,
+                    "contract_digest": contract.contract_digest,
+                },
+            )
+
     decision.status = DecisionStatus.resolved
     decision.decision_type = DecisionType.made
     decision.rationale = body.rationale
diff --git a/api/routers/execution.py b/api/routers/execution.py
index 9f8adbc..c55a519 100644
--- a/api/routers/execution.py
+++ b/api/routers/execution.py
@@ -21,9 +21,9 @@ from api.services.execution_queue import (
     ACTIVITY_CORE_RESPONSIBILITIES,
     CONCURRENCY_MODES,
     EXECUTION_STATES,
+    EXECUTION_REPLACEMENTS,
     LAUNCH_MODES,
     STATE_HUB_RESPONSIBILITIES,
-    execution_state_for_launch,
     queue_sort_key,
     workplan_blockers,
 )
@@ -43,6 +43,8 @@ async def execution_semantics() -> ExecutionSemantics:
         concurrency_modes=CONCURRENCY_MODES,
         state_hub_responsibility=STATE_HUB_RESPONSIBILITIES,
         activity_core_responsibility=ACTIVITY_CORE_RESPONSIBILITIES,
+        launch_requests_accepted=False,
+        replacements=EXECUTION_REPLACEMENTS,
     )
 
 
@@ -161,37 +163,27 @@ async def workplan_stack(
 
 @router.post(
     "/launch-requests",
-    response_model=LaunchRequestRead,
-    status_code=status.HTTP_201_CREATED,
+    status_code=status.HTTP_410_GONE,
 )
 async def create_launch_request(
+    request: Request,
+    response: Response,
     body: LaunchRequestCreate,
     session: AsyncSession = Depends(get_session),
-) -> WorkplanLaunchRequest:
-    ws = await session.get(Workplan, body.workplan_id)
-    if ws is None:
-        raise HTTPException(status_code=404, detail="Workplan not found")
-
-    launch_request = WorkplanLaunchRequest(
-        workplan_id=ws.id,
-        requested_by=body.requested_by,
-        requested_actor=body.requested_actor,
-        launch_mode=body.launch_mode,
-        concurrency_mode=body.concurrency_mode,
-        priority=body.priority or ws.planning_priority,
-        repo_id=body.repo_id or ws.repo_id,
-        branch_preference=body.branch_preference,
-        immediate_pickup=body.immediate_pickup,
-        notes=body.notes,
-        request_metadata=body.request_metadata,
+) -> None:
+    del body  # Request shape stays documented while the retired route returns 410.
+    await retire_legacy_route(
+        session=session,
+        request=request,
+        response=response,
+        interface_key="rest_api:POST /execution/launch-requests",
+        replacement_ref="repo file queue or activity-core ActivityDefinition + ops_run",
+        detail=(
+            "State Hub workplan launch requests are retired: no consumer picks up these rows. "
+            "Queue development work in the authoritative repository file; use an "
+            "ActivityDefinition and activity-core ops_run only for recurring or operational fires."
+        ),
     )
-    ws.launch_mode = body.launch_mode
-    ws.concurrency_mode = body.concurrency_mode
-    ws.execution_state = execution_state_for_launch(body.launch_mode, body.immediate_pickup)
-    session.add(launch_request)
-    await session.commit()
-    await session.refresh(launch_request)
-    return launch_request
 
 
 @router.get("/launch-requests", response_model=list[LaunchRequestRead])
diff --git a/api/routers/fabric.py b/api/routers/fabric.py
index c389342..98e704b 100644
--- a/api/routers/fabric.py
+++ b/api/routers/fabric.py
@@ -1,5 +1,6 @@
 from __future__ import annotations
 
+import uuid
 from typing import Any
 
 import httpx
@@ -10,6 +11,8 @@ from sqlalchemy.ext.asyncio import AsyncSession
 from api.database import get_session
 from api.models.fabric_graph import FabricGraphEdge, FabricGraphImport, FabricGraphNode
 from api.schemas.fabric_graph import (
+    FabricGraphActivationRequest,
+    FabricGraphActivationResult,
     FabricGraphEdgeRead,
     FabricGraphImportRead,
     FabricGraphIngestResult,
@@ -19,10 +22,12 @@ from api.schemas.fabric_graph import (
 )
 from api.services.fabric_graph import (
     FabricGraphValidationError,
+    activate_fabric_graph_import,
     ingest_fabric_graph_export,
     record_fabric_graph_error,
     split_graph_ingest_body,
 )
+from api.services.repository_aliases import resolve_repository_slug
 
 router = APIRouter(prefix="/fabric", tags=["fabric"])
 
@@ -131,6 +136,34 @@ async def latest_graph_import(
     return FabricGraphImportRead.model_validate(import_run)
 
 
+@router.post(
+    "/graph-exports/{import_id}/activate",
+    response_model=FabricGraphActivationResult,
+)
+async def activate_graph_import(
+    import_id: uuid.UUID,
+    body: FabricGraphActivationRequest | None = None,
+    session: AsyncSession = Depends(get_session),
+) -> FabricGraphActivationResult:
+    request = body or FabricGraphActivationRequest()
+    try:
+        import_run, previous_import_id, activated = await activate_fabric_graph_import(
+            session,
+            import_id,
+            requested_by=request.requested_by,
+        )
+    except ValueError as exc:
+        raise HTTPException(status_code=409, detail=str(exc)) from exc
+    if import_run is None:
+        raise HTTPException(status_code=404, detail=f"Fabric graph import '{import_id}' not found")
+    return FabricGraphActivationResult(
+        import_run=FabricGraphImportRead.model_validate(import_run),
+        previous_import_id=previous_import_id,
+        activated=activated,
+        idempotent=not activated,
+    )
+
+
 @router.get("/graph/nodes", response_model=list[FabricGraphNodeRead])
 async def list_graph_nodes(
     source_repo_slug: str = "railiance-fabric",
@@ -157,7 +190,12 @@ async def list_graph_nodes(
     if domain:
         query = query.where(FabricGraphNode.domain_slug == domain)
     if repo:
-        query = query.where(FabricGraphNode.repo_slug == repo)
+        resolution = await resolve_repository_slug(session, repo, required=False)
+        query = query.where(
+            FabricGraphNode.repo_slug.in_(
+                resolution.slug_values if resolution else (repo,)
+            )
+        )
     if canonical_category:
         query = query.where(FabricGraphNode.canon_category == canonical_category)
     if fabric_id:
diff --git a/api/routers/identifier_migrations.py b/api/routers/identifier_migrations.py
new file mode 100644
index 0000000..95cd647
--- /dev/null
+++ b/api/routers/identifier_migrations.py
@@ -0,0 +1,118 @@
+from dataclasses import asdict
+
+from fastapi import APIRouter, Depends, HTTPException
+from sqlalchemy.ext.asyncio import AsyncSession
+
+from api.database import get_session
+from api.config import settings
+from api.schemas.identifier_migration import (
+    IdentifierMigrationApplySubmit,
+    SealedProjectionRepairReceiptRead,
+    SealedProjectionRepairSubmit,
+)
+from api.services.work_record_identifier_migration import (
+    IdentifierMigrationError,
+    apply_repository_identifier_migration,
+    repair_absent_prederivation_projection,
+    reverse_repository_identifier_migration,
+)
+
+router = APIRouter(prefix="/identifier-migrations", tags=["identifier-migrations"])
+
+
+@router.post("/repositories/{repo_slug}/apply")
+async def apply_identifier_migration(
+    repo_slug: str,
+    body: IdentifierMigrationApplySubmit,
+    session: AsyncSession = Depends(get_session),
+) -> dict:
+    """Apply one sealed repository-atomic identifier convergence transaction."""
+    if settings.state_hub_instance_role != "primary":
+        raise HTTPException(
+            status_code=409,
+            detail={
+                "message": "identifier migration writes require the primary State Hub",
+                "instance_role": settings.state_hub_instance_role,
+                "instance_label": settings.state_hub_instance_label,
+            },
+        )
+    if not body.primary_confirmed:
+        raise HTTPException(status_code=409, detail="explicit primary confirmation is required")
+    if body.plan.get("plan_sha256") != body.expected_plan_sha256:
+        raise HTTPException(status_code=409, detail="explicit plan SHA-256 does not match sealed plan")
+    try:
+        result = await apply_repository_identifier_migration(session, body.plan, repo_slug)
+    except IdentifierMigrationError as exc:
+        raise HTTPException(status_code=409, detail=str(exc)) from exc
+    from api.routers.workstreams import _invalidate_workplan_index_cache
+
+    _invalidate_workplan_index_cache()
+    return {
+        "schema": "state-hub.identifier-migration-apply.v1",
+        "instance_role": settings.state_hub_instance_role,
+        "instance_label": settings.state_hub_instance_label,
+        "result": asdict(result),
+    }
+
+
+@router.post("/repositories/{repo_slug}/reverse")
+async def reverse_identifier_migration(
+    repo_slug: str,
+    body: IdentifierMigrationApplySubmit,
+    session: AsyncSession = Depends(get_session),
+) -> dict:
+    """Reverse one sealed repository migration after a failed file phase."""
+    if settings.state_hub_instance_role != "primary":
+        raise HTTPException(
+            status_code=409,
+            detail={
+                "message": "identifier migration writes require the primary State Hub",
+                "instance_role": settings.state_hub_instance_role,
+                "instance_label": settings.state_hub_instance_label,
+            },
+        )
+    if not body.primary_confirmed:
+        raise HTTPException(status_code=409, detail="explicit primary confirmation is required")
+    if body.plan.get("plan_sha256") != body.expected_plan_sha256:
+        raise HTTPException(status_code=409, detail="explicit plan SHA-256 does not match sealed plan")
+    try:
+        result = await reverse_repository_identifier_migration(session, body.plan, repo_slug)
+    except IdentifierMigrationError as exc:
+        raise HTTPException(status_code=409, detail=str(exc)) from exc
+    from api.routers.workstreams import _invalidate_workplan_index_cache
+
+    _invalidate_workplan_index_cache()
+    return {
+        "schema": "state-hub.identifier-migration-reverse.v1",
+        "instance_role": settings.state_hub_instance_role,
+        "instance_label": settings.state_hub_instance_label,
+        "result": asdict(result),
+    }
+
+
+@router.post(
+    "/sealed-projection-repairs",
+    response_model=SealedProjectionRepairReceiptRead,
+)
+async def repair_sealed_projection(
+    body: SealedProjectionRepairSubmit,
+    session: AsyncSession = Depends(get_session),
+) -> dict:
+    """Restore one exact pre-derivation workplan unit into an absent projection."""
+    try:
+        receipt = await repair_absent_prederivation_projection(
+            session,
+            body.plan,
+            body.repo_slug,
+            body.unit,
+            expected_plan_sha256=body.expected_plan_sha256,
+            source_revision=body.source_revision,
+            source_fingerprint=body.source_fingerprint,
+            source_clean=body.source_clean,
+            source_synchronized=body.source_synchronized,
+            primary_confirmed=body.primary_confirmed,
+            projection_identity=body.projection_identity,
+        )
+    except IdentifierMigrationError as exc:
+        raise HTTPException(status_code=409, detail=str(exc)) from exc
+    return asdict(receipt)
diff --git a/api/routers/intake.py b/api/routers/intake.py
new file mode 100644
index 0000000..2301205
--- /dev/null
+++ b/api/routers/intake.py
@@ -0,0 +1,173 @@
+import uuid
+from datetime import datetime, timezone
+
+from fastapi import APIRouter, Depends, HTTPException, status
+from sqlalchemy import select
+from sqlalchemy.ext.asyncio import AsyncSession
+
+from api.database import get_session
+from api.models.intake import Intake, IntakeNote, IntakeOutcome, IntakeStatus
+from api.models.progress_event import ProgressEvent
+from api.schemas.intake import (
+    IntakeClose,
+    IntakeCreate,
+    IntakeNoteCreate,
+    IntakeRead,
+    IntakeRoute,
+    IntakeUpdate,
+)
+
+router = APIRouter(prefix="/intakes", tags=["intakes"])
+
+_ALLOWED_ROUTE_FROM = {IntakeStatus.open, IntakeStatus.vetted}
+_ALLOWED_CLOSE_FROM = {IntakeStatus.open, IntakeStatus.vetted, IntakeStatus.routed}
+
+
+def _reject_status(intake: Intake, allowed: set[IntakeStatus], action: str) -> None:
+    if intake.status not in allowed:
+        raise HTTPException(
+            status_code=status.HTTP_409_CONFLICT,
+            detail=(
+                f"Cannot {action} intake in status '{intake.status.value}'; "
+                f"allowed from: {sorted(s.value for s in allowed)}"
+            ),
+        )
+
+
+@router.get("/", response_model=list[IntakeRead])
+async def list_intakes(
+    topic_id: uuid.UUID | None = None,
+    workplan_id: uuid.UUID | None = None,
+    repo_id: uuid.UUID | None = None,
+    status_: IntakeStatus | None = None,
+    session: AsyncSession = Depends(get_session),
+) -> list[Intake]:
+    q = select(Intake)
+    if topic_id:
+        q = q.where(Intake.topic_id == topic_id)
+    if workplan_id:
+        q = q.where(Intake.workplan_id == workplan_id)
+    if repo_id:
+        q = q.where(Intake.repo_id == repo_id)
+    if status_:
+        q = q.where(Intake.status == status_)
+    q = q.order_by(Intake.created_at)
+    result = await session.execute(q)
+    return list(result.scalars().all())
+
+
+@router.post("/", response_model=IntakeRead, status_code=status.HTTP_201_CREATED)
+async def create_intake(
+    body: IntakeCreate,
+    session: AsyncSession = Depends(get_session),
+) -> Intake:
+    intake = Intake(**body.model_dump())
+    session.add(intake)
+    await session.commit()
+    await session.refresh(intake)
+    return intake
+
+
+@router.get("/{intake_id}", response_model=IntakeRead)
+async def get_intake(
+    intake_id: uuid.UUID,
+    session: AsyncSession = Depends(get_session),
+) -> Intake:
+    intake = await session.get(Intake, intake_id)
+    if intake is None:
+        raise HTTPException(status_code=404, detail="Intake not found")
+    return intake
+
+
+@router.patch("/{intake_id}", response_model=IntakeRead)
+async def update_intake(
+    intake_id: uuid.UUID,
+    body: IntakeUpdate,
+    session: AsyncSession = Depends(get_session),
+) -> Intake:
+    intake = await session.get(Intake, intake_id)
+    if intake is None:
+        raise HTTPException(status_code=404, detail="Intake not found")
+    for field, value in body.model_dump(exclude_unset=True).items():
+        setattr(intake, field, value)
+    await session.commit()
+    await session.refresh(intake)
+    return intake
+
+
+@router.post("/{intake_id}/route", response_model=IntakeRead)
+async def route_intake(
+    intake_id: uuid.UUID,
+    body: IntakeRoute,
+    session: AsyncSession = Depends(get_session),
+) -> Intake:
+    """Move an intake into `routed` — eligible for the promotion transition."""
+    intake = await session.get(Intake, intake_id)
+    if intake is None:
+        raise HTTPException(status_code=404, detail="Intake not found")
+    _reject_status(intake, _ALLOWED_ROUTE_FROM, "route")
+
+    intake.status = IntakeStatus.routed
+    if body.routed_note:
+        intake.routed_note = body.routed_note
+    await session.commit()
+    await session.refresh(intake)
+    return intake
+
+
+@router.post("/{intake_id}/close", response_model=IntakeRead)
+async def close_intake(
+    intake_id: uuid.UUID,
+    body: IntakeClose,
+    session: AsyncSession = Depends(get_session),
+) -> Intake:
+    """Close an intake with an outcome. `outcome=promoted` requires
+    `promoted_to` (the canonical id of the record it became) — this is
+    normally called by the promotion transition (CUST-WP-0061-T03), not by
+    hand, but a manual close (declined/absorbed, or a promotion recorded
+    after the fact) is supported directly."""
+    intake = await session.get(Intake, intake_id)
+    if intake is None:
+        raise HTTPException(status_code=404, detail="Intake not found")
+    _reject_status(intake, _ALLOWED_CLOSE_FROM, "close")
+
+    intake.status = IntakeStatus.closed
+    intake.outcome = body.outcome
+    intake.closed_at = datetime.now(tz=timezone.utc)
+    if body.promoted_to:
+        intake.promoted_to = body.promoted_to
+    await session.commit()
+    await session.refresh(intake)
+
+    event = ProgressEvent(
+        topic_id=intake.topic_id,
+        workplan_id=intake.workplan_id,
+        event_type="intake_closed",
+        summary=f"Intake closed ({body.outcome.value}): {intake.title}",
+        detail={
+            "intake_id": str(intake.id),
+            "outcome": body.outcome.value,
+            "promoted_to": body.promoted_to,
+            "note": body.note,
+        },
+    )
+    session.add(event)
+    await session.commit()
+
+    return intake
+
+
+@router.post("/{intake_id}/notes", response_model=IntakeRead, status_code=status.HTTP_201_CREATED)
+async def add_intake_note(
+    intake_id: uuid.UUID,
+    body: IntakeNoteCreate,
+    session: AsyncSession = Depends(get_session),
+) -> Intake:
+    intake = await session.get(Intake, intake_id)
+    if intake is None:
+        raise HTTPException(status_code=404, detail="Intake not found")
+    note = IntakeNote(intake_id=intake.id, author=body.author, content=body.content)
+    session.add(note)
+    await session.commit()
+    await session.refresh(intake)
+    return intake
diff --git a/api/routers/interface_changes.py b/api/routers/interface_changes.py
index d4985a3..078557e 100644
--- a/api/routers/interface_changes.py
+++ b/api/routers/interface_changes.py
@@ -8,13 +8,17 @@ from sqlalchemy.ext.asyncio import AsyncSession
 from api.database import get_session
 from api.models.agent_message import AgentMessage
 from api.models.interface_change import InterfaceChange
-from api.models.managed_repo import ManagedRepo
 from api.models.progress_event import ProgressEvent
 from api.schemas.interface_change import (
     InterfaceChangeCreate,
     InterfaceChangePatch,
     InterfaceChangeRead,
 )
+from api.services.repository_aliases import (
+    affected_slug_predicate,
+    canonicalize_repository_slug,
+    resolve_repository_slug,
+)
 
 router = APIRouter(prefix="/interface-changes", tags=["interface-changes"])
 
@@ -32,7 +36,12 @@ async def create_interface_change(
     if body.change_type not in _VALID_CHANGE_TYPES:
         raise HTTPException(status_code=422, detail=f"change_type must be one of {sorted(_VALID_CHANGE_TYPES)}")
 
-    repo = await _repo_by_slug(body.repo_slug, session)
+    resolution = await resolve_repository_slug(session, body.repo_slug)
+    repo = resolution.repo
+    affected_repo_slugs = [
+        await canonicalize_repository_slug(session, slug)
+        for slug in body.affected_repo_slugs
+    ]
     change = InterfaceChange(
         repo_id=repo.id,
         interface_type=body.interface_type,
@@ -40,7 +49,7 @@ async def create_interface_change(
         title=body.title,
         description=body.description,
         affected_paths=body.affected_paths,
-        affected_repo_slugs=body.affected_repo_slugs,
+        affected_repo_slugs=affected_repo_slugs,
         planned_for=body.planned_for,
         author=body.author,
         status="draft",
@@ -68,7 +77,11 @@ async def list_interface_changes(
     if change_type:
         q = q.where(InterfaceChange.change_type == change_type)
     if affected_repo:
-        q = q.where(InterfaceChange.affected_repo_slugs.contains([affected_repo]))
+        resolution = await resolve_repository_slug(
+            session, affected_repo, required=False
+        )
+        values = resolution.slug_values if resolution else (affected_repo,)
+        q = q.where(affected_slug_predicate(InterfaceChange.affected_repo_slugs, values))
     result = await session.execute(q)
     return [InterfaceChangeRead.from_orm_with_slug(c) for c in result.scalars().all()]
 
@@ -94,7 +107,13 @@ async def patch_interface_change(
             status_code=409,
             detail=f"Cannot edit a change with status '{change.status}'. Only draft records are mutable.",
         )
-    for field, value in body.model_dump(exclude_unset=True).items():
+    payload = body.model_dump(exclude_unset=True)
+    if payload.get("affected_repo_slugs") is not None:
+        payload["affected_repo_slugs"] = [
+            await canonicalize_repository_slug(session, slug)
+            for slug in payload["affected_repo_slugs"]
+        ]
+    for field, value in payload.items():
         setattr(change, field, value)
     await session.commit()
     await session.refresh(change)
@@ -119,12 +138,13 @@ async def publish_interface_change(
     # Send inbox notifications to agents of affected repos
     affected = change.affected_repo_slugs or []
     for slug in affected:
+        target_slug = await canonicalize_repository_slug(session, slug)
         paths_summary = ", ".join(change.affected_paths[:5]) if change.affected_paths else "see description"
         if len(change.affected_paths) > 5:
             paths_summary += f" (+{len(change.affected_paths) - 5} more)"
         msg = AgentMessage(
             from_agent=change.repo.slug,
-            to_agent=slug,
+            to_agent=target_slug,
             subject=f"[{change.change_type.upper()}] {change.title}",
             body=(
                 f"**Interface change published by `{change.repo.slug}`**\n\n"
@@ -174,12 +194,9 @@ async def resolve_interface_change(
     return InterfaceChangeRead.from_orm_with_slug(change)
 
 
-async def _repo_by_slug(slug: str, session: AsyncSession) -> ManagedRepo:
-    result = await session.execute(select(ManagedRepo).where(ManagedRepo.slug == slug))
-    repo = result.scalar_one_or_none()
-    if repo is None:
-        raise HTTPException(status_code=404, detail=f"Repo '{slug}' not found")
-    return repo
+async def _repo_by_slug(slug: str, session: AsyncSession):
+    resolution = await resolve_repository_slug(session, slug)
+    return resolution.repo
 
 
 async def _get_or_404(change_id: uuid.UUID, session: AsyncSession) -> InterfaceChange:
diff --git a/api/routers/messages.py b/api/routers/messages.py
index 6da5630..d8334cb 100644
--- a/api/routers/messages.py
+++ b/api/routers/messages.py
@@ -1,7 +1,153 @@
+from datetime import datetime, timezone
+
+from fastapi import APIRouter, Depends, HTTPException, status
+from sqlalchemy import or_, select
+from sqlalchemy.ext.asyncio import AsyncSession
+
 from api.database import get_session
 from api.models.agent_message import AgentMessage
-from hub_core.routers.messages import create_messages_router
+from api.schemas.agent_message import MessageCreate, MessageRead, MessageReply
+from api.services.repository_aliases import (
+    canonicalize_repository_slug,
+    resolve_repository_slug,
+)
+from hub_core.message_identity import resolve_message_reference
+from hub_core.models.message_identity_alias import MessageIdentityAlias
+
+router = APIRouter(prefix="/messages", tags=["messages"])
+
+
+async def _get_message(reference: str, session: AsyncSession) -> AgentMessage:
+    message_id = await resolve_message_reference(
+        session, reference, alias_model=MessageIdentityAlias
+    )
+    if message_id is None:
+        raise HTTPException(
+            status_code=404, detail=f"Message reference {reference!r} not found"
+        )
+    message = await session.get(AgentMessage, message_id)
+    if message is None:
+        raise HTTPException(
+            status_code=404, detail=f"Message reference {reference!r} not found"
+        )
+    return message
+
+
+@router.post("/", response_model=MessageRead, status_code=status.HTTP_201_CREATED)
+async def send_message(
+    body: MessageCreate,
+    session: AsyncSession = Depends(get_session),
+) -> AgentMessage:
+    if body.thread_id and await session.get(AgentMessage, body.thread_id) is None:
+        raise HTTPException(status_code=404, detail=f"Thread root {body.thread_id} not found")
+    payload = body.model_dump()
+    payload["from_agent"] = await canonicalize_repository_slug(session, body.from_agent)
+    payload["to_agent"] = await canonicalize_repository_slug(session, body.to_agent)
+    message = AgentMessage(**payload)
+    session.add(message)
+    await session.commit()
+    await session.refresh(message)
+    return message
+
+
+@router.get("/", response_model=list[MessageRead])
+async def list_messages(
+    to_agent: str | None = None,
+    from_agent: str | None = None,
+    unread_only: bool = False,
+    limit: int = 50,
+    session: AsyncSession = Depends(get_session),
+) -> list[AgentMessage]:
+    query = select(AgentMessage).where(AgentMessage.archived_at.is_(None))
+    if to_agent:
+        resolution = await resolve_repository_slug(session, to_agent, required=False)
+        values = resolution.slug_values if resolution else (to_agent,)
+        query = query.where(
+            or_(AgentMessage.to_agent.in_(values), AgentMessage.to_agent == "broadcast")
+        )
+    if from_agent:
+        resolution = await resolve_repository_slug(session, from_agent, required=False)
+        values = resolution.slug_values if resolution else (from_agent,)
+        query = query.where(AgentMessage.from_agent.in_(values))
+    if unread_only:
+        query = query.where(AgentMessage.read_at.is_(None))
+    result = await session.execute(
+        query.order_by(AgentMessage.created_at.desc()).limit(limit)
+    )
+    return list(result.scalars().all())
+
+
+@router.get("/thread/{thread_id}", response_model=list[MessageRead])
+async def get_thread(
+    thread_id: str,
+    session: AsyncSession = Depends(get_session),
+) -> list[AgentMessage]:
+    resolved = await resolve_message_reference(
+        session, thread_id, alias_model=MessageIdentityAlias
+    )
+    if resolved is None:
+        raise HTTPException(
+            status_code=404, detail=f"Message reference {thread_id!r} not found"
+        )
+    result = await session.execute(
+        select(AgentMessage)
+        .where(or_(AgentMessage.id == resolved, AgentMessage.thread_id == resolved))
+        .order_by(AgentMessage.created_at)
+    )
+    return list(result.scalars().all())
+
+
+@router.patch("/{message_id}/read", response_model=MessageRead)
+async def mark_read(
+    message_id: str,
+    session: AsyncSession = Depends(get_session),
+) -> AgentMessage:
+    message = await _get_message(message_id, session)
+    if message.read_at is None:
+        message.read_at = datetime.now(timezone.utc)
+        await session.commit()
+        await session.refresh(message)
+    return message
+
+
+@router.patch("/{message_id}/archive", response_model=MessageRead)
+async def archive_message(
+    message_id: str,
+    session: AsyncSession = Depends(get_session),
+) -> AgentMessage:
+    message = await _get_message(message_id, session)
+    message.archived_at = datetime.now(timezone.utc)
+    if message.read_at is None:
+        message.read_at = message.archived_at
+    await session.commit()
+    await session.refresh(message)
+    return message
+
+
+@router.post(
+    "/{message_id}/reply",
+    response_model=MessageRead,
+    status_code=status.HTTP_201_CREATED,
+)
+async def reply_to_message(
+    message_id: str,
+    body: MessageReply,
+    session: AsyncSession = Depends(get_session),
+) -> AgentMessage:
+    original = await _get_message(message_id, session)
+    if original.read_at is None:
+        original.read_at = datetime.now(timezone.utc)
+    reply = AgentMessage(
+        from_agent=await canonicalize_repository_slug(session, body.from_agent),
+        to_agent=await canonicalize_repository_slug(session, original.from_agent),
+        subject=f"Re: {original.subject}",
+        body=body.body,
+        thread_id=original.thread_id or original.id,
+    )
+    session.add(reply)
+    await session.commit()
+    await session.refresh(reply)
+    return reply
 
-router = create_messages_router(get_session, message_model=AgentMessage)
 
 __all__ = ["router"]
diff --git a/api/routers/ops_runs.py b/api/routers/ops_runs.py
new file mode 100644
index 0000000..7f0d283
--- /dev/null
+++ b/api/routers/ops_runs.py
@@ -0,0 +1,13 @@
+from fastapi import APIRouter
+
+from api.schemas.ops_run import OpsRunProjection
+from api.services.ops_run_projection import get_ops_run_projection
+
+
+router = APIRouter(prefix="/ops-runs", tags=["ops-runs"])
+
+
+@router.get("/summary", response_model=OpsRunProjection)
+async def get_ops_runs_summary(refresh: bool = False) -> OpsRunProjection:
+    """Project activity-core queue health; State Hub never claims ops runs."""
+    return await get_ops_run_projection(refresh=refresh)
diff --git a/api/routers/repo_goals.py b/api/routers/repo_goals.py
index f836b91..601684e 100644
--- a/api/routers/repo_goals.py
+++ b/api/routers/repo_goals.py
@@ -8,16 +8,14 @@ from api.database import get_session
 from api.models.managed_repo import ManagedRepo
 from api.models.repo_goal import RepoGoal, RepoGoalStatus
 from api.schemas.repo_goal import RepoGoalCreate, RepoGoalRead, RepoGoalUpdate
+from api.services.repository_aliases import resolve_repository_slug
 
 router = APIRouter(prefix="/repo-goals", tags=["repo-goals"])
 
 
 async def _resolve_repo(repo_slug: str, session: AsyncSession) -> ManagedRepo:
-    result = await session.execute(select(ManagedRepo).where(ManagedRepo.slug == repo_slug))
-    repo = result.scalar_one_or_none()
-    if repo is None:
-        raise HTTPException(status_code=404, detail=f"Repo '{repo_slug}' not found")
-    return repo
+    resolution = await resolve_repository_slug(session, repo_slug)
+    return resolution.repo
 
 
 @router.get("/", response_model=list[RepoGoalRead])
diff --git a/api/routers/repos.py b/api/routers/repos.py
index c9c9e9f..af88a8c 100644
--- a/api/routers/repos.py
+++ b/api/routers/repos.py
@@ -11,8 +11,9 @@ from pathlib import Path
 
 from fastapi import APIRouter, Depends, HTTPException, Response, status
 from sqlalchemy import case, func, or_, select
+from sqlalchemy.exc import IntegrityError
 from sqlalchemy.ext.asyncio import AsyncSession
-from sqlalchemy.orm import noload
+from sqlalchemy.orm import joinedload, noload
 
 from api.config import settings
 from api.database import get_session
@@ -28,6 +29,7 @@ from api.models.domain import Domain
 from api.models.interface_change import InterfaceChange
 from api.models.managed_repo import ManagedRepo
 from api.models.repo_goal import RepoGoal
+from api.models.repository_rename import RepositorySlug
 from api.models.tpsc import TPSCSnapshot
 from api.models.task import Task
 from api.models.workplan import Workplan
@@ -48,6 +50,18 @@ from api.schemas.managed_repo import (
     classification_fields_set,
     validate_repo_classification_fields,
 )
+from api.services.sbom_nexus import SBOMNexusError
+from api.services.sbom_nexus import get_json as get_sbom_nexus_json
+from api.services.sbom_nexus import reads_from_nexus
+from api.services.repository_identity import stage_initial_repository_identity
+from api.services.repository_aliases import (
+    RepositorySlugResolution,
+    affected_slug_predicate,
+    repository_resolutions_for_repositories,
+    repository_resolution_for_id,
+    resolve_repository_slug,
+    stale_external_references,
+)
 from hub_core.routers.repos import create_repos_router
 
 router = APIRouter(prefix="/repos", tags=["repos"])
@@ -108,22 +122,25 @@ async def list_repos(
     capability_tag: str | None = None,
     business_stake: str | None = None,
     session: AsyncSession = Depends(get_session),
-) -> list[ManagedRepo]:
+) -> list[RepoRead]:
     """List repos with optional domain and classification filters."""
     response.headers["Cache-Control"] = "max-age=60, stale-while-revalidate=30"
     q = (
         select(ManagedRepo)
-        .options(noload(ManagedRepo.goals))
+        .options(
+            noload("*"),
+            joinedload(ManagedRepo.domain).noload("*"),
+        )
         .order_by(ManagedRepo.name)
     )
     if domain:
-        domain_result = await session.execute(select(Domain).where(Domain.slug == domain))
-        domain_obj = domain_result.scalar_one_or_none()
-        if domain_obj is None:
+        domain_result = await session.execute(select(Domain.id).where(Domain.slug == domain))
+        domain_id = domain_result.scalar_one_or_none()
+        if domain_id is None:
             raise HTTPException(status_code=404, detail=f"Domain '{domain}' not found")
         q = q.where(
             or_(
-                ManagedRepo.domain_id == domain_obj.id,
+                ManagedRepo.domain_id == domain_id,
                 ManagedRepo.secondary_domains.contains([domain]),
             )
         )
@@ -134,20 +151,25 @@ async def list_repos(
     if business_stake:
         q = q.where(ManagedRepo.business_stake.contains([business_stake]))
     result = await session.execute(q)
-    return list(result.scalars().all())
+    repositories = list(result.scalars().all())
+    resolutions = await repository_resolutions_for_repositories(session, repositories)
+    return await _project_repo_reads(session, repositories, resolutions=resolutions)
 
 
 @router.post("/", response_model=RepoRead, status_code=status.HTTP_201_CREATED)
 async def register_repo(
     body: RepoCreate,
     session: AsyncSession = Depends(get_session),
-) -> ManagedRepo:
+) -> RepoRead:
     domain_result = await session.execute(select(Domain).where(Domain.slug == body.domain_slug))
     domain_obj = domain_result.scalar_one_or_none()
     if domain_obj is None:
         raise HTTPException(status_code=404, detail=f"Domain '{body.domain_slug}' not found")
     existing = await session.execute(select(ManagedRepo).where(ManagedRepo.slug == body.slug))
-    if existing.scalar_one_or_none():
+    claimed_slug = await session.execute(
+        select(RepositorySlug).where(RepositorySlug.slug == body.slug)
+    )
+    if existing.scalar_one_or_none() or claimed_slug.scalar_one_or_none():
         raise HTTPException(status_code=409, detail=f"Repo slug '{body.slug}' already exists")
 
     payload = body.model_dump()
@@ -176,10 +198,19 @@ async def register_repo(
         standard_version=body.standard_version,
     )
     session.add(repo)
-    await session.commit()
+    await session.flush()
+    stage_initial_repository_identity(session, repo)
+    try:
+        await session.commit()
+    except IntegrityError as exc:
+        await session.rollback()
+        raise HTTPException(
+            status_code=409,
+            detail=f"Repo slug '{body.slug}' is already claimed",
+        ) from exc
     await session.refresh(repo)
     await _publish_repo_registered(repo, body, domain_obj)
-    return repo
+    return (await _project_repo_reads(session, [repo]))[0]
 
 
 @router.post("/onboard", response_model=RepoOnboardResult)
@@ -330,6 +361,7 @@ async def doi_summary(session: AsyncSession = Depends(get_session)) -> list[DoIS
         select(ManagedRepo).where(ManagedRepo.status == "active").order_by(ManagedRepo.name)
     )
     repos = list(repos_result.scalars().all())
+    sbom_projections = await _sbom_projection_map()
     repo_ids = [r.id for r in repos]
     id_to_slug = {r.id: r.slug for r in repos}
 
@@ -385,7 +417,7 @@ async def doi_summary(session: AsyncSession = Depends(get_session)) -> list[DoIS
             "local_path": repo.local_path,
             "remote_url": repo.remote_url,
             "host_paths": repo.host_paths or {},
-            "last_sbom_at": str(repo.last_sbom_at) if repo.last_sbom_at else None,
+            "last_sbom_at": _projected_last_sbom_at(repo, sbom_projections),
             "updated_at": str(repo.updated_at) if repo.updated_at else "",
         }
         fp = compute_fingerprint(
@@ -464,7 +496,9 @@ async def get_repo_doi(
 
     Results are cached by fingerprint. Pass ?force_refresh=true to bypass the cache.
     """
-    repo = await _get_repo_by_slug(slug, session)
+    resolution = await resolve_repository_slug(session, slug)
+    repo = resolution.repo
+    sbom_projections = await _sbom_projection_map()
     domain_result = await session.execute(select(Domain).where(Domain.id == repo.domain_id))
     domain_obj = domain_result.scalar_one_or_none()
 
@@ -484,7 +518,7 @@ async def get_repo_doi(
         "local_path": repo.local_path,
         "remote_url": repo.remote_url,
         "host_paths": repo.host_paths or {},
-        "last_sbom_at": str(repo.last_sbom_at) if repo.last_sbom_at else None,
+        "last_sbom_at": _projected_last_sbom_at(repo, sbom_projections),
         "updated_at": str(repo.updated_at) if repo.updated_at else "",
     }
     fp = compute_fingerprint(repo_dict, str(tpsc_row.latest) if tpsc_row.latest else None,
@@ -497,7 +531,7 @@ async def get_repo_doi(
 
     if not force_refresh and cached and cached.fingerprint == fp and cached.criteria:
         return DoIReport(
-            repo_slug=slug,
+            repo_slug=repo.slug,
             tier=cached.tier,
             core_pass=cached.core_pass,
             standard_pass=cached.standard_pass,
@@ -536,11 +570,11 @@ async def get_repo_doi(
 async def get_repo_by_id(
     repo_id: uuid.UUID,
     session: AsyncSession = Depends(get_session),
-) -> ManagedRepo:
+) -> RepoRead:
     repo = await session.get(ManagedRepo, repo_id)
     if repo is None:
         raise HTTPException(status_code=404, detail=f"Repo '{repo_id}' not found")
-    return repo
+    return (await _project_repo_reads(session, [repo]))[0]
 
 
 @router.get("/scope-health", response_model=list[RepoScopeHealth])
@@ -595,14 +629,32 @@ async def update_repo_with_classification(
     slug: str,
     body: RepoUpdate,
     session: AsyncSession = Depends(get_session),
-) -> ManagedRepo:
+) -> RepoRead:
     """Patch repo metadata including classification spine fields."""
-    repo = await _get_repo_by_slug(slug, session)
+    resolution = await resolve_repository_slug(session, slug)
+    repo = resolution.repo
     payload = body.model_dump(exclude_unset=True)
-    domain_result = await session.execute(select(Domain).where(Domain.id == repo.domain_id))
-    domain_obj = domain_result.scalar_one_or_none()
+    requested_domain_slug = payload.pop("domain_slug", None)
+    if requested_domain_slug is not None:
+        domain_result = await session.execute(
+            select(Domain).where(Domain.slug == requested_domain_slug)
+        )
+        domain_obj = domain_result.scalar_one_or_none()
+        if domain_obj is None:
+            raise HTTPException(
+                status_code=404,
+                detail=f"Domain '{requested_domain_slug}' not found",
+            )
+    else:
+        domain_result = await session.execute(
+            select(Domain).where(Domain.id == repo.domain_id)
+        )
+        domain_obj = domain_result.scalar_one_or_none()
     domain_slug = domain_obj.slug if domain_obj else ""
-    if classification_fields_set(payload):
+    classification_requested = classification_fields_set(payload)
+    if classification_requested or (
+        requested_domain_slug is not None and repo.category is not None
+    ):
         merged = {
             "category": payload.get("category", repo.category),
             "secondary_domains": payload.get("secondary_domains", repo.secondary_domains),
@@ -615,31 +667,67 @@ async def update_repo_with_classification(
             fields=merged,
             require_complete=True,
         )
+    if requested_domain_slug is not None:
+        repo.domain_id = domain_obj.id
     for field, value in payload.items():
         setattr(repo, field, value)
     await session.commit()
     await session.refresh(repo)
-    return repo
+    return (await _project_repo_reads(session, [repo], requested=resolution))[0]
+
+
+@router.get("/{slug}", response_model=RepoRead)
+async def get_repo_with_sbom_projection(
+    slug: str,
+    session: AsyncSession = Depends(get_session),
+) -> RepoRead:
+    resolution = await resolve_repository_slug(session, slug)
+    return (
+        await _project_repo_reads(
+            session,
+            [resolution.repo],
+            requested=resolution,
+            include_stale_external=True,
+        )
+    )[0]
 
 
 router.include_router(
     _core_repo_router(
         include_collection_routes=False,
         include_lookup_routes=False,
+        include_slug_routes=False,
     )
 )
 
 
+@router.post("/{slug}/paths", response_model=RepoRead)
+async def register_repo_path(
+    slug: str,
+    body: RepoPathRegister,
+    session: AsyncSession = Depends(get_session),
+) -> RepoRead:
+    resolution = await resolve_repository_slug(session, slug)
+    repo = resolution.repo
+    host_paths = dict(repo.host_paths or {})
+    host_paths[body.host] = body.path
+    repo.host_paths = host_paths
+    await session.commit()
+    await session.refresh(repo)
+    return (await _project_repo_reads(session, [repo], requested=resolution))[0]
+
+
 @router.patch("/{slug}/archive", response_model=RepoRead)
 async def archive_repo(
     slug: str,
     session: AsyncSession = Depends(get_session),
-) -> ManagedRepo:
-    repo = await _get_repo_by_slug(slug, session)
+) -> RepoRead:
+    resolution = await resolve_repository_slug(session, slug)
+    repo = resolution.repo
     repo.status = "archived"
     await session.commit()
     await session.refresh(repo)
-    return repo
+    return (await _project_repo_reads(session, [repo], requested=resolution))[0]
 
 
 @router.get("/{slug}/dispatch", response_model=RepoDispatch)
@@ -653,7 +741,8 @@ async def get_repo_dispatch(
     call it at session start to discover what work is pending without needing to
     read state-hub summary or scan workplan files manually.
     """
-    repo = await _get_repo_by_slug(slug, session)
+    resolution = await resolve_repository_slug(session, slug)
+    repo = resolution.repo
 
     # Active goal
     goal_result = await session.execute(
@@ -717,7 +806,9 @@ async def get_repo_dispatch(
     ic_result = await session.execute(
         select(InterfaceChange).where(
             InterfaceChange.status == "published",
-            InterfaceChange.affected_repo_slugs.contains([slug]),
+            affected_slug_predicate(
+                InterfaceChange.affected_repo_slugs, resolution.slug_values
+            ),
         ).order_by(InterfaceChange.published_at.desc())
     )
     pending_changes = [
@@ -746,7 +837,12 @@ async def get_repo_dispatch(
     )
 
     return RepoDispatch(
-        repo_slug=slug,
+        repo_slug=resolution.canonical_slug,
+        requested_slug=resolution.requested_slug,
+        canonical_slug=resolution.canonical_slug,
+        slug_status=resolution.slug_status,
+        aliases=list(resolution.aliases),
+        stale_external_references=await stale_external_references(session, resolution),
         active_goal=active_goal,
         active_workplans=dispatch_workstreams,
         human_interventions=all_interventions,
@@ -771,7 +867,8 @@ async def sync_repo_consistency(
     Returns the raw JSON output from consistency_check.py.
     Query param ?fix=false to run check-only without writing.
     """
-    repo = await _get_repo_by_slug(slug, session)
+    resolution = await resolve_repository_slug(session, slug)
+    repo = resolution.repo
 
     hostname = socket.gethostname()
     host_paths = repo.host_paths or {}
@@ -780,13 +877,13 @@ async def sync_repo_consistency(
         raise HTTPException(
             status_code=503,
             detail=(
-                f"No accessible path for repo '{slug}' on host '{hostname}'. "
-                f"Register with: POST /repos/{slug}/paths/"
+                f"No accessible path for repo '{repo.slug}' on host '{hostname}'. "
+                f"Register with: POST /repos/{repo.slug}/paths/"
             ),
         )
 
     script = Path(__file__).parent.parent.parent / "scripts" / "consistency_check.py"
-    cmd = [sys.executable, str(script), "--repo", slug, "--json",
+    cmd = [sys.executable, str(script), "--repo", repo.slug, "--json",
            "--api-base", settings.api_base]
     if fix:
         cmd.append("--fix")
@@ -805,11 +902,8 @@ async def sync_repo_consistency(
 
 
 async def _get_repo_by_slug(slug: str, session: AsyncSession) -> ManagedRepo:
-    result = await session.execute(select(ManagedRepo).where(ManagedRepo.slug == slug))
-    repo = result.scalar_one_or_none()
-    if repo is None:
-        raise HTTPException(status_code=404, detail=f"Repo '{slug}' not found")
-    return repo
+    resolution = await resolve_repository_slug(session, slug)
+    return resolution.repo
 
 
 def _repo_doi_dict(repo: ManagedRepo, domain_slug: str | None) -> dict:
@@ -822,3 +916,77 @@ def _repo_doi_dict(repo: ManagedRepo, domain_slug: str | None) -> dict:
         "last_sbom_at": str(repo.last_sbom_at) if repo.last_sbom_at else None,
         "updated_at": str(repo.updated_at) if repo.updated_at else "",
     }
+
+
+async def _sbom_projection_map() -> dict[str, datetime | None]:
+    if not reads_from_nexus():
+        return {}
+    try:
+        repositories = await get_sbom_nexus_json("/repositories/")
+    except SBOMNexusError as exc:
+        raise HTTPException(status_code=exc.status_code, detail=exc.detail) from exc
+    return {
+        repository["slug"]: (
+            datetime.fromisoformat(repository["last_attempt_at"].replace("Z", "+00:00"))
+            if repository.get("last_attempt_at")
+            else None
+        )
+        for repository in repositories
+    }
+
+
+def _projected_last_sbom_at(
+    repo: ManagedRepo,
+    projections: dict[str, datetime | None],
+) -> str | None:
+    if repo.slug in projections:
+        projected = projections[repo.slug]
+        return projected.isoformat() if projected else None
+    return str(repo.last_sbom_at) if repo.last_sbom_at else None
+
+
+async def _project_repo_reads(
+    session: AsyncSession,
+    repositories: list[ManagedRepo],
+    *,
+    requested: RepositorySlugResolution | None = None,
+    resolutions: dict[uuid.UUID, RepositorySlugResolution] | None = None,
+    include_stale_external: bool = False,
+) -> list[RepoRead]:
+    projections = await _sbom_projection_map()
+    result: list[RepoRead] = []
+    for repository in repositories:
+        resolution = (
+            requested
+            if requested is not None and requested.repo.id == repository.id
+            else (
+                resolutions[repository.id]
+                if resolutions is not None
+                else await repository_resolution_for_id(session, repository)
+            )
+        )
+        read = RepoRead.model_validate(repository)
+        read = read.model_copy(
+            update={
+                "requested_slug": resolution.requested_slug,
+                "canonical_slug": resolution.canonical_slug,
+                "slug_status": resolution.slug_status,
+                "aliases": list(resolution.aliases),
+                "stale_external_references": (
+                    await stale_external_references(session, resolution)
+                    if include_stale_external
+                    else []
+                ),
+            }
+        )
+        if repository.slug in projections:
+            read = read.model_copy(
+                update={
+                    "last_sbom_at": projections[repository.slug],
+                    "sbom_source": "sbom-nexus"
+                    if projections[repository.slug]
+                    else None,
+                }
+            )
+        result.append(read)
+    return result
diff --git a/api/routers/repository_renames.py b/api/routers/repository_renames.py
new file mode 100644
index 0000000..cfdef31
--- /dev/null
+++ b/api/routers/repository_renames.py
@@ -0,0 +1,359 @@
+from __future__ import annotations
+
+import asyncio
+import uuid
+from typing import Any
+
+from fastapi import APIRouter, Depends, HTTPException, status
+from fastapi.encoders import jsonable_encoder
+from sqlalchemy.ext.asyncio import AsyncSession
+
+from api.database import get_session
+from api.events import EventEnvelope, publish_event
+from api.models.repository_rename import RepositoryRenameOperation
+from api.schemas.repository_rename import (
+    ForgeIdentityVerifyRequest,
+    RepositoryRenameOperationCreate,
+    RepositoryRenameOperationRead,
+    RepositoryRenamePhaseApply,
+    RepositoryRenamePreflightRead,
+    RepositoryRenamePreflightRequest,
+    RepositoryRenameRollbackPreflightRead,
+    RepositoryRenameRollbackRequest,
+    RepositoryRenameVerificationRead,
+)
+from api.services.forge_repository import (
+    ForgeRepositoryGateway,
+    get_forge_repository_gateway,
+)
+from api.services.repository_rename import (
+    RenameLifecycleError,
+    apply_phase,
+    apply_rollback,
+    build_preflight,
+    create_operation,
+    list_operations,
+    load_operation,
+    load_operation_by_id,
+    rollback_preflight,
+    verify_forge_identity,
+    verify_operation,
+)
+
+
+router = APIRouter(prefix="/repos/{repo_id}", tags=["repository-renames"])
+operation_router = APIRouter(
+    prefix="/repository-renames", tags=["repository-renames"]
+)
+
+
+def repository_rename_events(
+    operation: RepositoryRenameOperation,
+    *,
+    outcome: str,
+    no_op: bool = False,
+    verification: dict[str, Any] | None = None,
+) -> list[tuple[str, EventEnvelope]]:
+    """Build credential-free lifecycle events from the durable journal."""
+    telemetry = (operation.evidence or {}).get("telemetry") or {}
+    phase_durations = telemetry.get("phase_durations_ms") or {}
+    attributes = {
+        "operation_id": str(operation.id),
+        "repo_id": str(operation.repo_id),
+        "forge_repository_id": operation.expected_forge_repository_id,
+        "old_slug": operation.old_slug,
+        "new_slug": operation.new_slug,
+        "phase": operation.phase,
+        "actor": operation.actor,
+        "expected_source_commit": operation.expected_source_commit,
+        "outcome": outcome,
+        "no_op": no_op,
+        "phase_duration_ms": int(phase_durations.get(operation.phase) or 0),
+        "retries": int(telemetry.get("retries") or 0),
+        "failures": int(telemetry.get("failures") or 0),
+        "rollback_attempts": int(telemetry.get("rollback_attempts") or 0),
+        "rollback_outcome": telemetry.get("rollback_outcome"),
+        "verification_outcome": (
+            "passed" if verification and verification.get("ok") else
+            "failed" if verification else
+            telemetry.get("verification_outcome", "pending")
+        ),
+        "error_code": operation.error_code if outcome == "failed" else None,
+        "evidence_ref": f"repository-renames/operations/{operation.id}",
+    }
+    subject = (
+        "org.statehub.repo.rename.failed"
+        if outcome == "failed"
+        else "org.statehub.repo.rename.verified"
+        if verification is not None
+        else "org.statehub.repo.rename.rolled_back"
+        if operation.phase == "rolled-back"
+        else "org.statehub.repo.rename.phase"
+    )
+    events = [(subject, EventEnvelope.new(subject, attributes=attributes))]
+    if operation.phase == "completed" and outcome == "succeeded":
+        renamed_subject = "org.statehub.repo.renamed"
+        events.append(
+            (renamed_subject, EventEnvelope.new(renamed_subject, attributes=attributes))
+        )
+    return events
+
+
+def _publish_rename_events(
+    operation: RepositoryRenameOperation,
+    *,
+    outcome: str,
+    no_op: bool = False,
+    verification: dict[str, Any] | None = None,
+) -> None:
+    for subject, envelope in repository_rename_events(
+        operation, outcome=outcome, no_op=no_op, verification=verification
+    ):
+        asyncio.create_task(publish_event(subject, envelope))
+
+
+def _raise(exc: RenameLifecycleError) -> None:
+    raise HTTPException(
+        status_code=exc.status_code,
+        detail=jsonable_encoder(
+            {"code": exc.code, "message": str(exc), "details": exc.details}
+        ),
+    ) from exc
+
+
+def _operation_read(operation: RepositoryRenameOperation, *, no_op: bool = False) -> dict[str, Any]:
+    return {
+        "id": operation.id,
+        "repo_id": operation.repo_id,
+        "phase": operation.phase,
+        "old_slug": operation.old_slug,
+        "new_slug": operation.new_slug,
+        "expected_forge_repository_id": operation.expected_forge_repository_id,
+        "expected_source_commit": operation.expected_source_commit,
+        "expected_default_branch": operation.expected_default_branch,
+        "actor": operation.actor,
+        "phase_changed_at": operation.phase_changed_at,
+        "preflighted_at": operation.preflighted_at,
+        "preflight_expires_at": operation.preflight_expires_at,
+        "completed_at": operation.completed_at,
+        "rolled_back_at": operation.rolled_back_at,
+        "evidence": operation.evidence,
+        "error_code": operation.error_code,
+        "error_message": operation.error_message,
+        "error_details": operation.error_details,
+        "error_at": operation.error_at,
+        "no_op": no_op,
+    }
+
+
+@router.post("/forge-identity/verify")
+async def verify_repository_forge_identity(
+    repo_id: uuid.UUID,
+    body: ForgeIdentityVerifyRequest,
+    session: AsyncSession = Depends(get_session),
+    gateway: ForgeRepositoryGateway = Depends(get_forge_repository_gateway),
+) -> dict[str, Any]:
+    try:
+        identity = await verify_forge_identity(session, gateway, repo_id, body)
+    except RenameLifecycleError as exc:
+        _raise(exc)
+    return {
+        "id": identity.id,
+        "repo_id": identity.repo_id,
+        "provider": identity.provider,
+        "forge_instance": identity.forge_instance,
+        "forge_owner": identity.forge_owner,
+        "forge_repository_id": identity.forge_repository_id,
+        "verification_state": identity.verification_state,
+        "verified_at": identity.verified_at,
+        "verified_by": identity.verified_by,
+        "verification_evidence": identity.verification_evidence,
+    }
+
+
+@router.post("/rename/preflight", response_model=RepositoryRenamePreflightRead)
+async def repository_rename_preflight(
+    repo_id: uuid.UUID,
+    body: RepositoryRenamePreflightRequest,
+    session: AsyncSession = Depends(get_session),
+    gateway: ForgeRepositoryGateway = Depends(get_forge_repository_gateway),
+) -> dict[str, Any]:
+    try:
+        return await build_preflight(session, gateway, repo_id, body)
+    except RenameLifecycleError as exc:
+        _raise(exc)
+
+
+@router.post(
+    "/rename/operations",
+    response_model=RepositoryRenameOperationRead,
+    status_code=status.HTTP_201_CREATED,
+)
+async def create_repository_rename_operation(
+    repo_id: uuid.UUID,
+    body: RepositoryRenameOperationCreate,
+    session: AsyncSession = Depends(get_session),
+    gateway: ForgeRepositoryGateway = Depends(get_forge_repository_gateway),
+) -> dict[str, Any]:
+    try:
+        operation, no_op = await create_operation(session, gateway, repo_id, body)
+    except RenameLifecycleError as exc:
+        _raise(exc)
+    _publish_rename_events(operation, outcome="succeeded", no_op=no_op)
+    return _operation_read(operation, no_op=no_op)
+
+
+@operation_router.get(
+    "/operations/{operation_id}", response_model=RepositoryRenameOperationRead
+)
+async def get_repository_rename_operation_by_id(
+    operation_id: uuid.UUID,
+    session: AsyncSession = Depends(get_session),
+) -> dict[str, Any]:
+    """Resolve an operation journal without requiring its repository UUID."""
+    try:
+        operation = await load_operation_by_id(session, operation_id)
+    except RenameLifecycleError as exc:
+        _raise(exc)
+    return _operation_read(operation)
+
+
+@router.get(
+    "/rename/operations", response_model=list[RepositoryRenameOperationRead]
+)
+async def list_repository_rename_operations(
+    repo_id: uuid.UUID,
+    active_only: bool = False,
+    session: AsyncSession = Depends(get_session),
+) -> list[dict[str, Any]]:
+    try:
+        operations = await list_operations(session, repo_id, active_only=active_only)
+    except RenameLifecycleError as exc:
+        _raise(exc)
+    return [_operation_read(operation) for operation in operations]
+
+
+@router.get(
+    "/rename/operations/{operation_id}", response_model=RepositoryRenameOperationRead
+)
+async def get_repository_rename_operation(
+    repo_id: uuid.UUID,
+    operation_id: uuid.UUID,
+    session: AsyncSession = Depends(get_session),
+) -> dict[str, Any]:
+    try:
+        operation = await load_operation(session, repo_id, operation_id)
+    except RenameLifecycleError as exc:
+        _raise(exc)
+    return _operation_read(operation)
+
+
+@router.post(
+    "/rename/operations/{operation_id}/phases/{phase}",
+    response_model=RepositoryRenameOperationRead,
+)
+async def apply_repository_rename_phase(
+    repo_id: uuid.UUID,
+    operation_id: uuid.UUID,
+    phase: str,
+    body: RepositoryRenamePhaseApply,
+    session: AsyncSession = Depends(get_session),
+    gateway: ForgeRepositoryGateway = Depends(get_forge_repository_gateway),
+) -> dict[str, Any]:
+    try:
+        operation, no_op = await apply_phase(
+            session, gateway, repo_id, operation_id, phase, body
+        )
+    except RenameLifecycleError as exc:
+        failed = await session.get(RepositoryRenameOperation, operation_id)
+        if failed is not None:
+            _publish_rename_events(failed, outcome="failed")
+        _raise(exc)
+    _publish_rename_events(operation, outcome="succeeded", no_op=no_op)
+    return _operation_read(operation, no_op=no_op)
+
+
+@router.get(
+    "/rename/operations/{operation_id}/verify",
+    response_model=RepositoryRenameVerificationRead,
+)
+async def verify_repository_rename_operation(
+    repo_id: uuid.UUID,
+    operation_id: uuid.UUID,
+    session: AsyncSession = Depends(get_session),
+    gateway: ForgeRepositoryGateway = Depends(get_forge_repository_gateway),
+) -> dict[str, Any]:
+    try:
+        operation = await load_operation(session, repo_id, operation_id)
+        verification = await verify_operation(session, gateway, operation)
+    except RenameLifecycleError as exc:
+        _raise(exc)
+    _publish_rename_events(
+        operation,
+        outcome="succeeded" if verification["ok"] else "failed",
+        verification=verification,
+    )
+    return verification
+
+
+@router.post(
+    "/rename/operations/{operation_id}/rollback-preflight",
+    response_model=RepositoryRenameRollbackPreflightRead,
+)
+async def preflight_repository_rename_rollback(
+    repo_id: uuid.UUID,
+    operation_id: uuid.UUID,
+    body: RepositoryRenameRollbackRequest,
+    session: AsyncSession = Depends(get_session),
+    gateway: ForgeRepositoryGateway = Depends(get_forge_repository_gateway),
+) -> dict[str, Any]:
+    try:
+        operation, report = await rollback_preflight(
+            session,
+            gateway,
+            repo_id,
+            operation_id,
+            expected_phase=body.expected_phase,
+            confirmation=body.confirmation,
+        )
+    except RenameLifecycleError as exc:
+        failed = await session.get(RepositoryRenameOperation, operation_id)
+        if failed is not None:
+            _publish_rename_events(failed, outcome="failed")
+        _raise(exc)
+    _publish_rename_events(operation, outcome="succeeded")
+    return {
+        "operation_id": operation.id,
+        "repo_id": operation.repo_id,
+        **report,
+        "operation": _operation_read(operation),
+    }
+
+
+@router.post(
+    "/rename/operations/{operation_id}/rollback",
+    response_model=RepositoryRenameOperationRead,
+)
+async def rollback_repository_rename_operation(
+    repo_id: uuid.UUID,
+    operation_id: uuid.UUID,
+    body: RepositoryRenameRollbackRequest,
+    session: AsyncSession = Depends(get_session),
+    gateway: ForgeRepositoryGateway = Depends(get_forge_repository_gateway),
+) -> dict[str, Any]:
+    try:
+        operation, no_op = await apply_rollback(
+            session,
+            gateway,
+            repo_id,
+            operation_id,
+            expected_phase=body.expected_phase,
+            confirmation=body.confirmation,
+        )
+    except RenameLifecycleError as exc:
+        failed = await session.get(RepositoryRenameOperation, operation_id)
+        if failed is not None:
+            _publish_rename_events(failed, outcome="failed")
+        _raise(exc)
+    _publish_rename_events(operation, outcome="succeeded", no_op=no_op)
+    return _operation_read(operation, no_op=no_op)
diff --git a/api/routers/review_contracts.py b/api/routers/review_contracts.py
new file mode 100644
index 0000000..19d2bd8
--- /dev/null
+++ b/api/routers/review_contracts.py
@@ -0,0 +1,190 @@
+import uuid
+
+from fastapi import APIRouter, Depends, HTTPException, Query, status
+from sqlalchemy import select, update
+from sqlalchemy.exc import IntegrityError
+from sqlalchemy.ext.asyncio import AsyncSession
+
+from api.database import get_session
+from api.models.review_contract import ReviewContract, ReviewReceipt
+from api.schemas.review_contract import (
+    ReviewAggregateRead,
+    ReviewContractProject,
+    ReviewContractRead,
+    ReviewReceiptRead,
+    ReviewReceiptSubmit,
+)
+from api.services.review_contracts import (
+    active_contract,
+    aggregate,
+    digest_document,
+    normalize_contract,
+    utc_now,
+    validate_receipt,
+)
+
+router = APIRouter(prefix="/review-contracts", tags=["review-contracts"])
+
+
+@router.post(
+    "/projections",
+    response_model=ReviewContractRead,
+    status_code=status.HTTP_201_CREATED,
+)
+async def project_contract(
+    body: ReviewContractProject,
+    session: AsyncSession = Depends(get_session),
+) -> ReviewContract:
+    document, contract_digest = normalize_contract(body.contract)
+    existing = (
+        await session.execute(
+            select(ReviewContract).where(
+                ReviewContract.contract_digest == contract_digest
+            )
+        )
+    ).scalar_one_or_none()
+    if existing:
+        if (
+            existing.source_repo != body.source.repo
+            or existing.source_path != body.source.path
+            or existing.source_revision != body.source.revision
+        ):
+            raise HTTPException(
+                409, "contract digest is already projected from a different source"
+            )
+        return existing
+    contract_key = document["contract_key"]
+    await session.execute(
+        update(ReviewContract)
+        .where(
+            ReviewContract.contract_key == contract_key, ReviewContract.active.is_(True)
+        )
+        .values(active=False)
+    )
+    contract = ReviewContract(
+        contract_key=contract_key,
+        schema_version="review-contract/v1",
+        contract_digest=contract_digest,
+        source_repo=body.source.repo,
+        source_path=body.source.path,
+        source_revision=body.source.revision,
+        document=document,
+        active=True,
+        required_for_decision=body.required_for_decision,
+        decision_id=body.decision_id,
+        workplan_id=body.workplan_id,
+        task_id=body.task_id,
+        projected_at=utc_now(),
+    )
+    session.add(contract)
+    try:
+        await session.commit()
+    except IntegrityError as exc:
+        await session.rollback()
+        raise HTTPException(
+            409, "source revision is already projected with different content"
+        ) from exc
+    await session.refresh(contract)
+    return contract
+
+
+@router.get("/", response_model=list[ReviewContractRead])
+async def list_contracts(
+    contract_key: str | None = Query(None),
+    active: bool | None = Query(None),
+    decision_id: uuid.UUID | None = Query(None),
+    session: AsyncSession = Depends(get_session),
+) -> list[ReviewContract]:
+    query = select(ReviewContract).order_by(ReviewContract.projected_at.desc())
+    if contract_key:
+        query = query.where(ReviewContract.contract_key == contract_key)
+    if active is not None:
+        query = query.where(ReviewContract.active == active)
+    if decision_id:
+        query = query.where(ReviewContract.decision_id == decision_id)
+    return list((await session.execute(query)).scalars())
+
+
+@router.get("/{contract_key}", response_model=ReviewContractRead)
+async def get_active_contract(
+    contract_key: str,
+    session: AsyncSession = Depends(get_session),
+) -> ReviewContract:
+    return await active_contract(session, contract_key)
+
+
+@router.get("/{contract_key}/aggregate", response_model=ReviewAggregateRead)
+async def get_aggregate(
+    contract_key: str,
+    session: AsyncSession = Depends(get_session),
+) -> ReviewAggregateRead:
+    return await aggregate(session, await active_contract(session, contract_key))
+
+
+@router.get("/{contract_key}/receipts", response_model=list[ReviewReceiptRead])
+async def list_receipts(
+    contract_key: str,
+    include_stale: bool = Query(True),
+    session: AsyncSession = Depends(get_session),
+) -> list[ReviewReceipt]:
+    contract = await active_contract(session, contract_key)
+    query = (
+        select(ReviewReceipt)
+        .join(ReviewContract)
+        .where(
+            ReviewContract.contract_key == contract_key
+            if include_stale
+            else ReviewReceipt.contract_id == contract.id
+        )
+        .order_by(ReviewReceipt.submitted_at)
+    )
+    return list((await session.execute(query)).scalars())
+
+
+@router.post(
+    "/{contract_key}/receipts",
+    response_model=ReviewReceiptRead,
+    status_code=status.HTTP_201_CREATED,
+)
+async def submit_receipt(
+    contract_key: str,
+    body: ReviewReceiptSubmit,
+    session: AsyncSession = Depends(get_session),
+) -> ReviewReceipt:
+    contract = await active_contract(session, contract_key)
+    document = validate_receipt(contract, body)
+    receipt_digest = digest_document(document)
+    existing = (
+        await session.execute(
+            select(ReviewReceipt).where(ReviewReceipt.receipt_digest == receipt_digest)
+        )
+    ).scalar_one_or_none()
+    if existing:
+        return existing
+    receipt = ReviewReceipt(
+        contract_id=contract.id,
+        owner_id=body.owner_id,
+        actor=body.actor,
+        disposition=body.disposition,
+        contract_digest=body.contract_digest,
+        receipt_digest=receipt_digest,
+        artifact_hashes=body.artifact_hashes,
+        assertion_ids=body.assertion_ids,
+        checks=body.checks,
+        note=body.note,
+        source_repo=body.source.repo,
+        source_path=body.source.path,
+        source_revision=body.source.revision,
+        submitted_at=utc_now(),
+        document=document,
+    )
+    session.add(receipt)
+    try:
+        await session.commit()
+    except IntegrityError as exc:
+        await session.rollback()
+        raise HTTPException(
+            409, "receipt source revision already contains different evidence"
+        ) from exc
+    await session.refresh(receipt)
+    return receipt
diff --git a/api/routers/sbom.py b/api/routers/sbom.py
index ee9bf1e..a5cb550 100644
--- a/api/routers/sbom.py
+++ b/api/routers/sbom.py
@@ -1,7 +1,8 @@
 import uuid
+import logging
 from datetime import datetime, timezone
 
-from fastapi import APIRouter, Depends, HTTPException, Query
+from fastapi import APIRouter, Depends, HTTPException, Query, Request
 from sqlalchemy import and_, func, select
 from sqlalchemy.ext.asyncio import AsyncSession
 
@@ -18,8 +19,18 @@ from api.schemas.sbom import (
     SBOMSnapshotDetail,
     SBOMSnapshotRead,
 )
+from api.services.legacy_meter import identity_from_request, record_legacy_usage
+from api.services.sbom_nexus import (
+    SBOMNexusError,
+    get_json,
+    post_json,
+    reads_from_nexus,
+    writes_to_nexus,
+)
+from api.services.repository_aliases import resolve_repository_slug
 
 router = APIRouter(prefix="/sbom", tags=["sbom"])
+logger = logging.getLogger(__name__)
 
 _COPYLEFT_PATTERNS = {"GPL", "AGPL", "LGPL", "EUPL", "CDDL", "MPL"}
 
@@ -54,10 +65,37 @@ def _latest_snapshot_ids_subquery():
 @router.post("/ingest/")
 async def ingest_sbom(
     body: SBOMIngest,
+    request: Request,
     session: AsyncSession = Depends(get_session),
 ) -> dict:
     """Create a new SBOM snapshot for a repo. Previous snapshots are retained."""
-    repo = await _get_repo_by_slug(body.repo_slug, session)
+    resolution = await resolve_repository_slug(session, body.repo_slug)
+    repo = resolution.repo
+    if writes_to_nexus():
+        nexus_body = body.model_dump(mode="json")
+        nexus_body["repo_slug"] = resolution.canonical_slug
+        payload = await _nexus_post("/sbom/ingest/", body=nexus_body)
+        try:
+            snapshot_at = datetime.fromisoformat(
+                payload["snapshot_at"].replace("Z", "+00:00")
+            )
+            result = {
+                "repo_slug": payload["repo_slug"],
+                "snapshot_id": payload["snapshot_id"],
+                "ingested": payload["ingested"],
+                "snapshot_at": payload["snapshot_at"],
+            }
+        except (AttributeError, KeyError, TypeError, ValueError) as exc:
+            raise HTTPException(
+                status_code=502,
+                detail="SBOM Nexus returned an invalid ingest response",
+            ) from exc
+        repo.last_sbom_at = snapshot_at
+        repo.sbom_source = "sbom-nexus"
+        await session.commit()
+        await _meter_compat(session, request, "POST", "/sbom/ingest/")
+        return result
+
     now = datetime.now(tz=timezone.utc)
 
     snap = SBOMSnapshot(
@@ -90,8 +128,9 @@ async def ingest_sbom(
         repo.sbom_source = "manual"
 
     await session.commit()
+    await _meter_compat(session, request, "POST", "/sbom/ingest/")
     return {
-        "repo_slug": body.repo_slug,
+        "repo_slug": resolution.canonical_slug,
         "snapshot_id": str(snap.id),
         "ingested": len(body.entries),
         "snapshot_at": now.isoformat(),
@@ -100,10 +139,23 @@ async def ingest_sbom(
 
 @router.get("/snapshots/", response_model=list[SBOMSnapshotRead])
 async def list_snapshots(
+    request: Request,
     repo_slug: str | None = Query(None),
     session: AsyncSession = Depends(get_session),
 ) -> list[SBOMSnapshotRead]:
     """List SBOM snapshots, newest first. Optionally filter by repo."""
+    await _meter_compat(session, request, "GET", "/sbom/snapshots/")
+    if reads_from_nexus():
+        if repo_slug:
+            repo_slug = (
+                await resolve_repository_slug(session, repo_slug)
+            ).canonical_slug
+        payload = await _nexus_get(
+            "/sbom/snapshots/",
+            params={"repo_slug": repo_slug} if repo_slug else None,
+        )
+        return await _translate_snapshots(payload, session)
+
     q = select(SBOMSnapshot).order_by(SBOMSnapshot.snapshot_at.desc())
     if repo_slug:
         repo = await _get_repo_by_slug(repo_slug, session)
@@ -115,9 +167,21 @@ async def list_snapshots(
 @router.get("/snapshots/{snapshot_id}", response_model=SBOMSnapshotDetail)
 async def get_snapshot(
     snapshot_id: uuid.UUID,
+    request: Request,
     session: AsyncSession = Depends(get_session),
 ) -> SBOMSnapshotDetail:
     """Get a snapshot with its full entry list."""
+    await _meter_compat(session, request, "GET", "/sbom/snapshots/{snapshot_id}")
+    if reads_from_nexus():
+        payload = await _nexus_get(f"/sbom/snapshots/{snapshot_id}")
+        repo_ids = await _local_repo_ids([payload], session)
+        repo_id = repo_ids[payload["repo_slug"]]
+        translated = _translate_snapshot(payload, repo_id)
+        translated["entries"] = [
+            _translate_entry(entry, repo_id) for entry in payload.get("entries", [])
+        ]
+        return SBOMSnapshotDetail.model_validate(translated)
+
     snap = await session.get(SBOMSnapshot, snapshot_id)
     if snap is None:
         raise HTTPException(status_code=404, detail=f"Snapshot '{snapshot_id}' not found")
@@ -140,6 +204,7 @@ async def get_snapshot(
 
 @router.get("/")
 async def list_sbom_entries(
+    request: Request,
     repo_slug: str | None = Query(None),
     ecosystem: Ecosystem | None = Query(None),
     license_spdx: str | None = Query(None),
@@ -148,6 +213,30 @@ async def list_sbom_entries(
     session: AsyncSession = Depends(get_session),
 ) -> list[SBOMEntryRead]:
     """Return entries from the latest snapshot per repo (default) or filter by repo."""
+    await _meter_compat(session, request, "GET", "/sbom/")
+    if reads_from_nexus():
+        if repo_slug:
+            repo_slug = (
+                await resolve_repository_slug(session, repo_slug)
+            ).canonical_slug
+        params = {
+            key: value
+            for key, value in {
+                "repo_slug": repo_slug,
+                "ecosystem": ecosystem.value if ecosystem is not None else None,
+                "license_spdx": license_spdx,
+                "is_direct": is_direct,
+                "is_dev": is_dev,
+            }.items()
+            if value is not None
+        }
+        payload = await _nexus_get("/sbom/", params=params)
+        repo_ids = await _local_repo_ids(payload, session)
+        return [
+            SBOMEntryRead.model_validate(_translate_entry(entry, repo_ids[entry["repo_slug"]]))
+            for entry in payload
+        ]
+
     if repo_slug:
         repo = await _get_repo_by_slug(repo_slug, session)
         latest_snap_id_sq = (
@@ -177,9 +266,15 @@ async def list_sbom_entries(
 
 @router.get("/report/licences/", response_model=LicenceReport)
 async def licence_report(
+    request: Request,
     session: AsyncSession = Depends(get_session),
 ) -> LicenceReport:
     """Group latest-snapshot SBOM entries by SPDX licence identifier, flag copyleft."""
+    await _meter_compat(session, request, "GET", "/sbom/report/licences/")
+    if reads_from_nexus():
+        payload = await _nexus_get("/sbom/report/licences/")
+        return LicenceReport.model_validate(payload)
+
     latest_ids_sq = _latest_snapshot_ids_subquery()
     rows = await session.execute(
         select(SBOMEntry, ManagedRepo.slug)
@@ -212,10 +307,20 @@ async def licence_report(
 @router.get("/{repo_slug}", response_model=SBOMRepoView)
 async def get_repo_sbom(
     repo_slug: str,
+    request: Request,
     session: AsyncSession = Depends(get_session),
 ) -> SBOMRepoView:
     """Return the latest snapshot entries for a specific repo."""
-    repo = await _get_repo_by_slug(repo_slug, session)
+    resolution = await resolve_repository_slug(session, repo_slug)
+    repo = resolution.repo
+    await _meter_compat(session, request, "GET", "/sbom/{repo_slug}")
+    if reads_from_nexus():
+        payload = await _nexus_get(f"/sbom/{resolution.canonical_slug}")
+        payload["entries"] = [
+            _translate_entry(entry, repo.id) for entry in payload.get("entries", [])
+        ]
+        return SBOMRepoView.model_validate(payload)
+
     latest_snap_id_sq = (
         select(SBOMSnapshot.id)
         .where(SBOMSnapshot.repo_id == repo.id)
@@ -230,7 +335,7 @@ async def get_repo_sbom(
     )
     entries = list(rows.scalars().all())
     return SBOMRepoView(
-        repo_slug=repo_slug,
+        repo_slug=resolution.canonical_slug,
         last_sbom_at=repo.last_sbom_at,
         entry_count=len(entries),
         entries=[SBOMEntryRead.model_validate(e) for e in entries],
@@ -238,8 +343,86 @@ async def get_repo_sbom(
 
 
 async def _get_repo_by_slug(slug: str, session: AsyncSession) -> ManagedRepo:
-    result = await session.execute(select(ManagedRepo).where(ManagedRepo.slug == slug))
-    repo = result.scalar_one_or_none()
-    if repo is None:
-        raise HTTPException(status_code=404, detail=f"Repo '{slug}' not found")
-    return repo
+    resolution = await resolve_repository_slug(session, slug)
+    return resolution.repo
+
+
+async def _nexus_get(path: str, *, params: dict | None = None):
+    try:
+        return await get_json(path, params=params)
+    except SBOMNexusError as exc:
+        raise HTTPException(status_code=exc.status_code, detail=exc.detail) from exc
+
+
+async def _nexus_post(path: str, *, body: dict):
+    try:
+        return await post_json(path, body=body)
+    except SBOMNexusError as exc:
+        raise HTTPException(status_code=exc.status_code, detail=exc.detail) from exc
+
+
+async def _local_repo_ids(items: list[dict], session: AsyncSession) -> dict[str, uuid.UUID]:
+    slugs = {item.get("repo_slug") for item in items}
+    if None in slugs:
+        raise HTTPException(status_code=502, detail="SBOM Nexus response omitted repo_slug")
+    repo_ids: dict[str, uuid.UUID] = {}
+    for slug in slugs:
+        resolution = await resolve_repository_slug(session, slug, required=False)
+        if resolution is not None:
+            repo_ids[slug] = resolution.repo.id
+    missing = sorted(slugs - repo_ids.keys())
+    if missing:
+        raise HTTPException(
+            status_code=502,
+            detail=f"SBOM Nexus returned repositories absent from State Hub: {', '.join(missing)}",
+        )
+    return repo_ids
+
+
+async def _translate_snapshots(
+    items: list[dict], session: AsyncSession
+) -> list[SBOMSnapshotRead]:
+    repo_ids = await _local_repo_ids(items, session)
+    return [
+        SBOMSnapshotRead.model_validate(_translate_snapshot(item, repo_ids[item["repo_slug"]]))
+        for item in items
+    ]
+
+
+def _translate_snapshot(item: dict, repo_id: uuid.UUID) -> dict:
+    translated = {**item, "repo_id": repo_id}
+    source = translated.get("source")
+    if (
+        translated.get("legacy_id")
+        and isinstance(source, str)
+        and source.startswith("state-hub:")
+    ):
+        translated["source"] = source.removeprefix("state-hub:")
+    return translated
+
+
+def _translate_entry(item: dict, repo_id: uuid.UUID) -> dict:
+    return {**item, "repo_id": repo_id}
+
+
+async def _meter_compat(
+    session: AsyncSession,
+    request: Request,
+    method: str,
+    route: str,
+) -> None:
+    """Meter the compatibility surface without making route success depend on it."""
+    interface_key = f"rest_api:{method} {route}"
+    try:
+        await record_legacy_usage(
+            session,
+            interface_key=interface_key,
+            interface_kind="rest_api",
+            replacement_ref="sbom-nexus:/sbom/",
+            owner_component="state-hub.sbom-compat",
+            replacement_verified=reads_from_nexus(),
+            identity=identity_from_request(request),
+        )
+    except Exception:
+        await session.rollback()
+        logger.warning("legacy-meter failed to record %s", interface_key, exc_info=True)
diff --git a/api/routers/services.py b/api/routers/services.py
index 763da99..982ab1b 100644
--- a/api/routers/services.py
+++ b/api/routers/services.py
@@ -13,7 +13,6 @@ from sqlalchemy.ext.asyncio import AsyncSession
 from sqlalchemy.orm import selectinload
 
 from api.database import get_session
-from api.models.managed_repo import ManagedRepo
 from api.models.service_catalog import (
     ServiceCatalog,
     ServiceCloud,
@@ -22,6 +21,7 @@ from api.models.service_catalog import (
     ServiceThirdParty,
 )
 from api.schemas.service import ServiceCatalogRead, ServiceUpsert
+from api.services.repository_aliases import resolve_repository_slug
 
 router = APIRouter(prefix="/services", tags=["services"])
 
@@ -42,6 +42,7 @@ async def list_services(
     development_type: str | None = None,
     maturity_level: int | None = None,
     status: str | None = None,
+    repo_slug: str | None = None,
     session: AsyncSession = Depends(get_session),
 ) -> list[ServiceCatalog]:
     q = select(ServiceCatalog).options(*_WITH_EXTENSIONS)
@@ -53,6 +54,11 @@ async def list_services(
         q = q.where(ServiceCatalog.maturity_level == maturity_level)
     if status:
         q = q.where(ServiceCatalog.status == status)
+    if repo_slug:
+        resolution = await resolve_repository_slug(session, repo_slug)
+        q = q.join(ServiceFirstParty).where(
+            ServiceFirstParty.repo_id == resolution.repo.id
+        )
     q = q.order_by(ServiceCatalog.name.asc())
     result = await session.execute(q)
     return list(result.scalars().all())
@@ -131,12 +137,10 @@ async def _apply_extensions(svc: ServiceCatalog, body: ServiceUpsert, session: A
     if body.first_party is not None:
         data = body.first_party.model_dump(exclude={"repo_slug"})
         if body.first_party.repo_slug and not data.get("repo_id"):
-            repo = (await session.execute(
-                select(ManagedRepo).where(ManagedRepo.slug == body.first_party.repo_slug)
-            )).scalar_one_or_none()
-            if repo is None:
-                raise HTTPException(status_code=404, detail=f"Repo '{body.first_party.repo_slug}' not found")
-            data["repo_id"] = repo.id
+            resolution = await resolve_repository_slug(
+                session, body.first_party.repo_slug
+            )
+            data["repo_id"] = resolution.repo.id
         await _upsert_ext(ServiceFirstParty, svc.id, data, session)
 
 
diff --git a/api/routers/state.py b/api/routers/state.py
index 7e5e01d..c78f238 100644
--- a/api/routers/state.py
+++ b/api/routers/state.py
@@ -1,13 +1,15 @@
 import time
 from datetime import datetime, timedelta, timezone
 
-from fastapi import APIRouter, Depends, Request, Response
+from fastapi import APIRouter, Depends, HTTPException, Query, Request, Response
 from fastapi.responses import JSONResponse
 from sqlalchemy import func, select, text
 from sqlalchemy.ext.asyncio import AsyncSession
 from sqlalchemy.orm import noload, selectinload
 
+from api.config import settings
 from api.database import get_session
+from api.services.schema_state import schema_state
 from api.flow_defs import assertion_result_to_dict, load_flow
 from api.models.capability_request import CapabilityRequest
 from api.models.contribution import Contribution, ContributionStatus, ContributionType
@@ -53,6 +55,9 @@ from api.services.summary_cache import (
     get_summary_cache,
     register_summary_cache_invalidation,
 )
+from api.services.ops_run_projection import get_ops_run_projection
+from api.services.sbom_nexus import get_json as get_sbom_nexus_json
+from api.services.sbom_nexus import reads_from_nexus
 
 
 def _dual_workplan_refs(
@@ -70,6 +75,12 @@ def _dual_workplan_refs(
         "workstream_slug": slug,
     }
 from api.task_status import TERMINAL_TASK_STATUSES, status_value
+from api.work_record_flavor import (
+    RESIDUAL_FLAVOR,
+    WORK_RECORD_FLAVORS,
+    is_residual_flavor,
+    normalize_flavor,
+)
 from api.workplan_status import (
     CLOSED_WORKPLAN_STATUSES,
     OPEN_WORKPLAN_STATUSES,
@@ -95,12 +106,44 @@ def _summary_cache_headers(
     response.headers["Cache-Control"] = "max-age=15, stale-while-revalidate=120"
 
 
+def _apply_summary_flavor_view(
+    summary: StateSummary,
+    *,
+    include_residuals: bool,
+    flavor: str | None,
+) -> StateSummary:
+    """Default views omit residual workplans; totals.residual_open stays honest."""
+    wanted = normalize_flavor(flavor)
+    if wanted is not None and wanted not in WORK_RECORD_FLAVORS:
+        raise HTTPException(
+            status_code=422,
+            detail=(
+                f"Unknown work-record flavor {wanted!r}; "
+                f"expected one of {', '.join(WORK_RECORD_FLAVORS)}"
+            ),
+        )
+    show_residuals = include_residuals or wanted == RESIDUAL_FLAVOR
+    residual_rows = list(summary.residual_open_workplans)
+    open_rows = list(summary.open_workplans)
+    if wanted is not None:
+        open_rows = [row for row in open_rows if row.flavor == wanted]
+        residual_rows = [row for row in residual_rows if row.flavor == wanted]
+    return summary.model_copy(
+        update={
+            "open_workplans": open_rows,
+            "residual_open_workplans": residual_rows if show_residuals else [],
+        }
+    )
+
+
 @router.get("/summary", response_model=StateSummary)
 async def get_summary(
     request: Request,
     response: Response,
     session: AsyncSession = Depends(get_session),
     refresh: bool = False,
+    include_residuals: bool = Query(False),
+    flavor: str | None = Query(None),
 ) -> StateSummary:
     revision = await fetch_summary_revision(session)
     revision_token = revision.combined_fingerprint()
@@ -111,22 +154,38 @@ async def get_summary(
 
     if cache_status == "hit-revision" and cached is not None:
         _summary_cache_headers(response, cache_status="hit-revision", revision=revision_token)
-        return cached
+        return _apply_summary_flavor_view(
+            cached.model_copy(update={"ops_runs": await get_ops_run_projection()}),
+            include_residuals=include_residuals,
+            flavor=flavor,
+        )
 
     if cache_status == "progress-section" and cached is not None:
         result = await apply_progress_section(session, cached, revision)
         _summary_cache_headers(response, cache_status="hit-revision", revision=revision_token)
-        return result
+        return _apply_summary_flavor_view(
+            result.model_copy(update={"ops_runs": await get_ops_run_projection()}),
+            include_residuals=include_residuals,
+            flavor=flavor,
+        )
 
     if cache_status == "stale" and cached is not None:
         cache.schedule_refresh(revision)
         _summary_cache_headers(response, cache_status="stale", revision=revision_token)
-        return cached
+        return _apply_summary_flavor_view(
+            cached.model_copy(update={"ops_runs": await get_ops_run_projection()}),
+            include_residuals=include_residuals,
+            flavor=flavor,
+        )
 
     result = await build_state_summary(session)
     cache.store(result, revision)
     _summary_cache_headers(response, cache_status="miss", revision=revision_token)
-    return result
+    return _apply_summary_flavor_view(
+        result.model_copy(update={"ops_runs": await get_ops_run_projection(refresh=force_refresh)}),
+        include_residuals=include_residuals,
+        flavor=flavor,
+    )
 
 
 async def build_state_summary(session: AsyncSession) -> StateSummary:
@@ -331,6 +390,7 @@ async def build_state_summary(session: AsyncSession) -> StateSummary:
             ),
             archived=ws_counts.get("archived", 0),
             total=sum(ws_counts.values()),
+            residual_open=0,
         ),
         tasks=TaskTotals(
             wait=task_counts.get(TaskStatus.wait, 0),
@@ -363,23 +423,7 @@ async def build_state_summary(session: AsyncSession) -> StateSummary:
     )}
     contribution_counts = {**contrib_type_counts, **contrib_status_counts}
 
-    # Licence risk: copyleft packages in direct prod deps
-    _COPYLEFT_PATS = ("GPL", "AGPL", "LGPL", "EUPL", "CDDL", "MPL")
-    copyleft_risk_rows = await session.execute(
-        select(func.count()).select_from(SBOMEntry)
-        .where(SBOMEntry.is_direct.is_(True))
-        .where(SBOMEntry.is_dev.is_(False))
-    )
-    # Filter in Python since ILIKE across multiple patterns is verbose in SQLAlchemy
-    all_direct_prod_rows = await session.execute(
-        select(SBOMEntry.license_spdx)
-        .where(SBOMEntry.is_direct.is_(True))
-        .where(SBOMEntry.is_dev.is_(False))
-    )
-    licence_risk_count = sum(
-        1 for (lic,) in all_direct_prod_rows.all()
-        if lic and any(pat in lic.upper() for pat in _COPYLEFT_PATS)
-    )
+    licence_risk_count, _, _ = await _sbom_metrics(session)
 
     # Open capability requests (non-terminal statuses)
     open_cap_req_count = (await session.execute(
@@ -408,6 +452,15 @@ async def build_state_summary(session: AsyncSession) -> StateSummary:
         )
         for w in open_ws
     ]
+    relevant_rows = [
+        row for row, w in zip(open_workplan_rows, open_ws)
+        if not is_residual_flavor(w.flavor)
+    ]
+    residual_rows = [
+        row for row, w in zip(open_workplan_rows, open_ws)
+        if is_residual_flavor(w.flavor)
+    ]
+    totals.workstreams.residual_open = len(residual_rows)
 
     result = StateSummary(
         generated_at=datetime.now(tz=timezone.utc),
@@ -429,7 +482,8 @@ async def build_state_summary(session: AsyncSession) -> StateSummary:
         licence_risk_count=licence_risk_count,
         open_capability_requests=open_cap_req_count,
         ranked_suggestions=ranked_suggestions,
-        open_workplans=open_workplan_rows,
+        open_workplans=relevant_rows,
+        residual_open_workplans=residual_rows,
     )
     return result
 
@@ -532,6 +586,7 @@ async def _build_dashboard_overview(session: AsyncSession) -> DashboardOverview:
         w for w in workstreams_all
         if normalize_workplan_status(w.status) in OPEN_WORKPLAN_STATUSES
     ]
+    residual_open = sum(1 for w in open_ws if is_residual_flavor(w.flavor))
     open_ws_ids = [w.id for w in open_ws]
     dep_rows = []
     if open_ws_ids:
@@ -591,6 +646,7 @@ async def _build_dashboard_overview(session: AsyncSession) -> DashboardOverview:
             ),
             archived=ws_counts.get("archived", 0),
             total=sum(ws_counts.values()),
+            residual_open=residual_open,
         ),
         tasks=TaskTotals(
             wait=task_totals_by_status.get("wait", 0),
@@ -645,23 +701,7 @@ async def _build_dashboard_overview(session: AsyncSession) -> DashboardOverview:
     )}
     contribution_counts = {**contrib_type_counts, **contrib_status_counts}
 
-    _COPYLEFT_PATS = ("GPL", "AGPL", "LGPL", "EUPL", "CDDL", "MPL")
-    all_direct_prod_rows = await session.execute(
-        select(SBOMEntry.license_spdx)
-        .where(SBOMEntry.is_direct.is_(True))
-        .where(SBOMEntry.is_dev.is_(False))
-    )
-    licence_risk_count = sum(
-        1 for (lic,) in all_direct_prod_rows.all()
-        if lic and any(pat in lic.upper() for pat in _COPYLEFT_PATS)
-    )
-
-    snapshot_count, package_total = (await session.execute(
-        select(
-            func.count(SBOMSnapshot.id),
-            func.coalesce(func.sum(SBOMSnapshot.entry_count), 0),
-        )
-    )).one()
+    licence_risk_count, snapshot_count, package_total = await _sbom_metrics(session)
 
     open_cap_req_count = (await session.execute(
         select(func.count()).select_from(CapabilityRequest).where(
@@ -695,6 +735,7 @@ async def _build_dashboard_overview(session: AsyncSession) -> DashboardOverview:
             id=w.id,
             title=w.title,
             status=normalize_workplan_status(w.status),
+            flavor=w.flavor,
             domain=repo["domain_slug"] if repo else (topic.domain_slug if topic else "unknown"),
             repo_label=repo["slug"] if repo else workplan.get("repo_slug", "unassigned"),
             workplan_filename=workplan.get("filename"),
@@ -741,6 +782,39 @@ async def _build_dashboard_overview(session: AsyncSession) -> DashboardOverview:
     )
 
 
+async def _sbom_metrics(session: AsyncSession) -> tuple[int, int, int]:
+    """Return compatibility summary metrics from the selected SBOM authority."""
+    if reads_from_nexus():
+        snapshots = await get_sbom_nexus_json("/sbom/snapshots/")
+        report = await get_sbom_nexus_json("/sbom/report/licences/")
+        return (
+            int(report.get("copyleft_direct_count") or 0),
+            len(snapshots),
+            sum(int(snapshot.get("entry_count") or 0) for snapshot in snapshots),
+        )
+
+    copyleft_patterns = ("GPL", "AGPL", "LGPL", "EUPL", "CDDL", "MPL")
+    rows = await session.execute(
+        select(SBOMEntry.license_spdx)
+        .where(SBOMEntry.is_direct.is_(True))
+        .where(SBOMEntry.is_dev.is_(False))
+    )
+    licence_risk_count = sum(
+        1
+        for (licence,) in rows.all()
+        if licence and any(pattern in licence.upper() for pattern in copyleft_patterns)
+    )
+    snapshot_count, package_total = (
+        await session.execute(
+            select(
+                func.count(SBOMSnapshot.id),
+                func.coalesce(func.sum(SBOMSnapshot.entry_count), 0),
+            )
+        )
+    ).one()
+    return licence_risk_count, int(snapshot_count or 0), int(package_total or 0)
+
+
 async def _build_domain_summaries(session: AsyncSession) -> list[DomainSummary]:
     """Compute per-domain stats for the state summary."""
     domains_rows = await session.execute(
@@ -789,7 +863,10 @@ async def _build_domain_summaries(session: AsyncSession) -> list[DomainSummary]:
 
 
 @router.get("/deps", response_model=list[WorkstreamWithDeps])
-async def get_deps(session: AsyncSession = Depends(get_session)) -> list[WorkstreamWithDeps]:
+async def get_deps(
+    session: AsyncSession = Depends(get_session),
+    include_residuals: bool = Query(False),
+) -> list[WorkstreamWithDeps]:
     """Lightweight dep-graph endpoint: open workstreams with their dependency edges only.
 
     Returns the same structure as open_workplans in /state/summary but skips
@@ -803,6 +880,8 @@ async def get_deps(session: AsyncSession = Depends(get_session)) -> list[Workstr
         .order_by(Workplan.due_date.asc().nullslast(), Workplan.created_at)
     )
     open_ws = list(open_ws_rows.scalars().all())
+    if not include_residuals:
+        open_ws = [w for w in open_ws if not is_residual_flavor(w.flavor)]
 
     open_ws_ids = [w.id for w in open_ws]
     dep_rows = []
@@ -938,6 +1017,10 @@ async def _derive_next_steps(session: AsyncSession) -> tuple[list[NextStep], lis
         if task.id in seen_task_ids:
             continue
         ws = await session.get(Workplan, decision.workplan_id, options=[noload("*")])
+        if ws is not None and is_residual_flavor(ws.flavor):
+            continue
+        if is_residual_flavor(task.flavor):
+            continue
         domain_slug = await _get_domain_slug_for_workplan(ws, session)
         steps.append(NextStep(
             type="resolved_decision",
@@ -982,6 +1065,7 @@ async def _derive_next_steps(session: AsyncSession) -> tuple[list[NextStep], lis
                 Workplan.title,
                 Workplan.slug,
                 Workplan.topic_id,
+                Workplan.flavor,
             ).where(Workplan.id.in_(dep_ws_ids))
         )
         ws_info = {
@@ -990,8 +1074,9 @@ async def _derive_next_steps(session: AsyncSession) -> tuple[list[NextStep], lis
                 "title": title,
                 "slug": slug,
                 "topic_id": topic_id,
+                "flavor": flavor,
             }
-            for ws_id, status, title, slug, topic_id in ws_rows
+            for ws_id, status, title, slug, topic_id, flavor in ws_rows
         }
 
     ready_from_ws_ids = [
@@ -1017,12 +1102,16 @@ async def _derive_next_steps(session: AsyncSession) -> tuple[list[NextStep], lis
 
     for from_ws_id in ready_from_ws_ids:
         from_ws = ws_info.get(from_ws_id, {})
+        if is_residual_flavor(from_ws.get("flavor")):
+            continue
         todo_tasks = todo_by_ws.get(from_ws_id, [])
         if not todo_tasks:
             continue
         task = min(todo_tasks, key=lambda t: (_PRIORITY_RANK.get(t.priority, 99), t.created_at))
         if task.id in seen_task_ids:
             continue
+        if is_residual_flavor(task.flavor):
+            continue
         domain_slug = await _get_domain_slug_for_topic(from_ws.get("topic_id"), session)
         _blocker_slugs = []
         for tid in dep_map[from_ws_id]:
@@ -1104,7 +1193,16 @@ async def get_next_steps(session: AsyncSession = Depends(get_session)) -> list[N
 async def health_check(session: AsyncSession = Depends(get_session)) -> dict:
     try:
         await session.execute(text("SELECT 1"))
-        return {"status": "ok", "db": "connected"}
+        return {
+            "status": "ok",
+            "db": "connected",
+            # Identity, so a caller can verify it reached the hub it meant to.
+            "instance_role": settings.state_hub_instance_role,
+            "instance_label": settings.state_hub_instance_label,
+            # Surfaced, not merely logged: a schema behind the code is a fault
+            # the operator must be able to see (STATE-WP-0083-T07).
+            "schema": await schema_state(session),
+        }
     except Exception as exc:
         return JSONResponse(
             status_code=503,
diff --git a/api/routers/suggestions.py b/api/routers/suggestions.py
index b04c044..ed5df8c 100644
--- a/api/routers/suggestions.py
+++ b/api/routers/suggestions.py
@@ -1,259 +1,45 @@
-import uuid
+"""Retired: the suggestion backlog.
 
-from fastapi import APIRouter, Depends, HTTPException, Query, status
-from sqlalchemy import select
-from sqlalchemy.ext.asyncio import AsyncSession
+Slice E1 of the State Hub retirement (`STATE-WP-0079-T05`). The capability was
+superseded by the **intake** work-record entity; mutations were retired
+2026-07-21 under `CUST-WP-0061-T06`, and the reads were kept live only so the
+historical record stayed reachable.
 
-from api.database import get_session
-from api.models.domain import Domain
-from api.models.suggestion import (
-    OPEN_SUGGESTION_STAGES,
-    Suggestion,
-    SuggestionNote,
-    SuggestionStage,
-)
-from api.models.task import Task, TaskPriority, TaskStatus
-from api.schemas.suggestion import (
-    SuggestionBumpRelevance,
-    SuggestionCreate,
-    SuggestionDecline,
-    SuggestionNoteRead,
-    SuggestionPromote,
-    SuggestionRead,
-    SuggestionVet,
-)
-from api.services.suggestion_relevance import bump_relevance
-from api.services.suggestion_wsjf import compute_wsjf, cost_of_delay, suggestion_sort_key
-from api.task_status import normalize_task_status
+That history is now archived at
+`the-custodian/docs/archived-suggestion-backlog.md` — all 10 suggestions, 10
+notes and 5 relevance bumps, every one closed as `declined` during the intake
+migration and none promoted. With a durable record outside this repo, the read
+surface has no remaining job, so the whole router answers 410.
+
+The `suggestions`, `suggestion_notes` and `suggestion_relevance_bumps` tables
+are deliberately left in place: they are `retire`/`archive` in `SHR-INV-0001`
+and are captured by the final dump at `STATE-WP-0079-T06`. Dropping them here
+would remove data ahead of the dump for no gain.
+"""
+
+from fastapi import APIRouter, HTTPException
 
 router = APIRouter(prefix="/suggestions", tags=["suggestions"])
 
-_ALLOWED_VET_FROM = {SuggestionStage.suggestion}
-_ALLOWED_DECLINE_FROM = {SuggestionStage.suggestion, SuggestionStage.requirement}
-_ALLOWED_PROMOTE_FROM = {SuggestionStage.requirement}
+_DETAIL = (
+    "suggestions are retired (STATE-WP-0079-T05, slice E1). "
+    "Use POST /intakes/ for new discovery work. The historical backlog is "
+    "archived at the-custodian/docs/archived-suggestion-backlog.md — see also "
+    "the-custodian/intake-legacy-suggestions-migration.md and "
+    "canon/standards/work-record-types_v0.1.md."
+)
 
 
-async def _resolve_domain_id(slug: str, session: AsyncSession) -> uuid.UUID:
-    row = await session.execute(
-        select(Domain.id).where(Domain.slug == slug, Domain.status == "active")
-    )
-    domain_id = row.scalar_one_or_none()
-    if domain_id is None:
-        valid = [r[0] for r in (await session.execute(
-            select(Domain.slug).where(Domain.status == "active")
-        )).all()]
-        raise HTTPException(
-            status_code=422,
-            detail=f"Unknown domain '{slug}'. Valid domains: {sorted(valid)}",
-        )
-    return domain_id
+def _retired() -> HTTPException:
+    return HTTPException(status_code=410, detail=_DETAIL)
 
 
-def _enrich_read(suggestion: Suggestion) -> SuggestionRead:
-    data = SuggestionRead.model_validate(suggestion)
-    data.cost_of_delay = cost_of_delay(suggestion)
-    data.wsjf = compute_wsjf(suggestion)
-    return data
-
-
-async def _get_suggestion_or_404(
-    suggestion_id: uuid.UUID,
-    session: AsyncSession,
-) -> Suggestion:
-    suggestion = await session.get(Suggestion, suggestion_id)
-    if suggestion is None:
-        raise HTTPException(status_code=404, detail="Suggestion not found")
-    return suggestion
-
-
-def _reject_stage(suggestion: Suggestion, allowed: set[SuggestionStage], action: str) -> None:
-    if suggestion.stage not in allowed:
-        raise HTTPException(
-            status_code=409,
-            detail=f"Cannot {action} suggestion in stage '{suggestion.stage.value}'",
-        )
-
-
-@router.get("/", response_model=list[SuggestionRead])
-async def list_suggestions(
-    domain: str | None = None,
-    stage: SuggestionStage | None = None,
-    include_terminal: bool = Query(False),
-    rank: str | None = Query(None),
-    limit: int = Query(100, ge=1, le=500),
-    session: AsyncSession = Depends(get_session),
-) -> list[SuggestionRead]:
-    q = select(Suggestion)
-    if domain:
-        domain_id = await _resolve_domain_id(domain, session)
-        q = q.where(Suggestion.domain_id == domain_id)
-    if stage:
-        q = q.where(Suggestion.stage == stage)
-    elif not include_terminal:
-        q = q.where(Suggestion.stage.in_(OPEN_SUGGESTION_STAGES))
-    result = await session.execute(q)
-    suggestions = list(result.scalars().all())
-    if rank == "wsjf":
-        suggestions.sort(key=suggestion_sort_key)
-    else:
-        suggestions.sort(key=lambda s: s.created_at)
-    return [_enrich_read(s) for s in suggestions[:limit]]
-
-
-@router.post("/", response_model=SuggestionRead, status_code=status.HTTP_201_CREATED)
-async def create_suggestion(
-    body: SuggestionCreate,
-    session: AsyncSession = Depends(get_session),
-) -> SuggestionRead:
-    domain_id = await _resolve_domain_id(body.domain, session)
-    suggestion = Suggestion(
-        domain_id=domain_id,
-        topic_id=body.topic_id,
-        workplan_id=body.workplan_id,
-        title=body.title,
-        description=body.description,
-        origin=body.origin,
-        origin_ref=body.origin_ref,
-        base_value=body.base_value,
-        job_size=body.job_size,
-        relevance_weight=body.relevance_weight,
-    )
-    session.add(suggestion)
-    await session.commit()
-    await session.refresh(suggestion)
-    return _enrich_read(suggestion)
-
-
-@router.get("/{suggestion_id}", response_model=SuggestionRead)
-async def get_suggestion(
-    suggestion_id: uuid.UUID,
-    session: AsyncSession = Depends(get_session),
-) -> SuggestionRead:
-    suggestion = await _get_suggestion_or_404(suggestion_id, session)
-    return _enrich_read(suggestion)
-
-
-@router.post("/{suggestion_id}/vet", response_model=SuggestionRead)
-async def vet_suggestion(
-    suggestion_id: uuid.UUID,
-    body: SuggestionVet,
-    session: AsyncSession = Depends(get_session),
-) -> SuggestionRead:
-    suggestion = await _get_suggestion_or_404(suggestion_id, session)
-    _reject_stage(suggestion, _ALLOWED_VET_FROM, "vet")
-    suggestion.stage = SuggestionStage.requirement
-    if body.base_value is not None:
-        suggestion.base_value = body.base_value
-    if body.job_size is not None:
-        suggestion.job_size = body.job_size
-    if body.relevance_weight is not None:
-        suggestion.relevance_weight = body.relevance_weight
-    if body.workplan_id is not None:
-        suggestion.workplan_id = body.workplan_id
-    session.add(
-        SuggestionNote(
-            suggestion_id=suggestion.id,
-            stage=SuggestionStage.requirement.value,
-            author=body.author,
-            content=body.note,
-        )
-    )
-    await session.commit()
-    await session.refresh(suggestion)
-    return _enrich_read(suggestion)
-
-
-@router.post("/{suggestion_id}/decline", response_model=SuggestionRead)
-async def decline_suggestion(
-    suggestion_id: uuid.UUID,
-    body: SuggestionDecline,
-    session: AsyncSession = Depends(get_session),
-) -> SuggestionRead:
-    suggestion = await _get_suggestion_or_404(suggestion_id, session)
-    _reject_stage(suggestion, _ALLOWED_DECLINE_FROM, "decline")
-    suggestion.stage = SuggestionStage.declined
-    session.add(
-        SuggestionNote(
-            suggestion_id=suggestion.id,
-            stage=SuggestionStage.declined.value,
-            author=body.author,
-            content=body.note,
-        )
-    )
-    await session.commit()
-    await session.refresh(suggestion)
-    return _enrich_read(suggestion)
-
-
-@router.post("/{suggestion_id}/promote", response_model=SuggestionRead)
-async def promote_suggestion_to_task(
-    suggestion_id: uuid.UUID,
-    body: SuggestionPromote,
-    session: AsyncSession = Depends(get_session),
-) -> SuggestionRead:
-    suggestion = await _get_suggestion_or_404(suggestion_id, session)
-    _reject_stage(suggestion, _ALLOWED_PROMOTE_FROM, "promote")
-    if suggestion.workplan_id is None:
-        raise HTTPException(
-            status_code=409,
-            detail="Suggestion must have workplan_id before promotion",
-        )
-
-    task = Task(
-        workplan_id=suggestion.workplan_id,
-        title=body.task_title or suggestion.title,
-        description=body.task_description or suggestion.description,
-        status=TaskStatus(normalize_task_status(body.task_status)),
-        priority=TaskPriority(body.task_priority),
-    )
-    session.add(task)
-    await session.flush()
-
-    suggestion.stage = SuggestionStage.promoted
-    suggestion.promoted_task_id = task.id
-    if body.note:
-        session.add(
-            SuggestionNote(
-                suggestion_id=suggestion.id,
-                stage=SuggestionStage.promoted.value,
-                author=body.author,
-                content=body.note,
-            )
-        )
-    await session.commit()
-    await session.refresh(suggestion)
-    return _enrich_read(suggestion)
-
-
-@router.post("/{suggestion_id}/bump-relevance", response_model=SuggestionRead)
-async def bump_suggestion_relevance(
-    suggestion_id: uuid.UUID,
-    body: SuggestionBumpRelevance,
-    session: AsyncSession = Depends(get_session),
-) -> SuggestionRead:
-    suggestion = await _get_suggestion_or_404(suggestion_id, session)
-    source_key = body.author or "explicit"
-    await bump_relevance(
-        session,
-        suggestion,
-        source="explicit",
-        source_key=source_key,
-        reason=body.reason,
-    )
-    await session.commit()
-    await session.refresh(suggestion)
-    return _enrich_read(suggestion)
-
-
-@router.get("/{suggestion_id}/notes", response_model=list[SuggestionNoteRead])
-async def list_suggestion_notes(
-    suggestion_id: uuid.UUID,
-    session: AsyncSession = Depends(get_session),
-) -> list[SuggestionNote]:
-    await _get_suggestion_or_404(suggestion_id, session)
-    result = await session.execute(
-        select(SuggestionNote)
-        .where(SuggestionNote.suggestion_id == suggestion_id)
-        .order_by(SuggestionNote.created_at)
-    )
-    return list(result.scalars().all())
\ No newline at end of file
+@router.api_route(
+    "/{path:path}",
+    methods=["GET", "POST", "PATCH", "PUT", "DELETE"],
+    include_in_schema=False,
+)
+@router.api_route("/", methods=["GET", "POST", "PATCH", "PUT", "DELETE"])
+async def suggestions_retired(path: str = "") -> None:
+    """Every suggestion route is retired; see module docstring."""
+    raise _retired()
diff --git a/api/routers/tasks.py b/api/routers/tasks.py
index b13eb06..b76746c 100644
--- a/api/routers/tasks.py
+++ b/api/routers/tasks.py
@@ -169,6 +169,8 @@ async def bulk_status_sync(
     updated: list[Task] = []
     events: list[ProgressEvent] = []
     author = body.author or "custodian"
+    # Cache repo resolution for dual-run writeback (RMGR-WP-0003)
+    repo_cache: dict = {}
     for update in body.updates:
         task = tasks_by_id[update.task_id]
         previous_status = status_value(task.status)
@@ -182,6 +184,32 @@ async def bulk_status_sync(
             parent_workstream=ws,
             previous_task_status=previous_status,
         )
+        if target_status != previous_status:
+            try:
+                from api.models.managed_repo import ManagedRepo
+                from api.services.repo_manager_dual_run import try_writeback_for_task
+                from api.services.workplan_files import resolve_repo_path
+
+                repo_id = ws.repo_id if ws else None
+                if repo_id is not None:
+                    if repo_id not in repo_cache:
+                        repo_cache[repo_id] = await session.get(ManagedRepo, repo_id)
+                    repo = repo_cache[repo_id]
+                    if repo is not None:
+                        try_writeback_for_task(
+                            repo_path=resolve_repo_path(repo),
+                            repo_slug=repo.slug,
+                            task_id=str(task.id),
+                            status=target_status,
+                            reason="state-hub bulk-status-sync dual-run",
+                        )
+            except Exception:
+                import logging
+
+                logging.getLogger(__name__).exception(
+                    "repo-manager dual-run bulk writeback failed for task %s",
+                    update.task_id,
+                )
         event = ProgressEvent(
             task_id=task.id,
             workplan_id=task.workplan_id,
@@ -263,6 +291,33 @@ async def update_task(
             parent_workstream=ws,
             previous_task_status=previous_status,
         )
+        # RMGR-WP-0002 dual-run: optional checkout writeback via repo-manager
+        if new_status != previous_status:
+            try:
+                from api.models.managed_repo import ManagedRepo
+                from api.services.repo_manager_dual_run import try_writeback_for_task
+                from api.services.workplan_files import resolve_repo_path
+
+                ws_full = ws or await session.get(Workplan, task.workplan_id)
+                repo = None
+                if ws_full and ws_full.repo_id:
+                    repo = await session.get(ManagedRepo, ws_full.repo_id)
+                if repo is not None:
+                    repo_path = resolve_repo_path(repo)
+                    try_writeback_for_task(
+                        repo_path=repo_path,
+                        repo_slug=repo.slug,
+                        task_id=str(task.id),
+                        status=new_status,
+                        reason="state-hub PATCH /tasks dual-run",
+                    )
+            except Exception:
+                # Dual-run must not break native DB update path
+                import logging
+
+                logging.getLogger(__name__).exception(
+                    "repo-manager dual-run writeback failed for task %s", task_id
+                )
     await session.commit()
     await session.refresh(task)
 
diff --git a/api/routers/token_events.py b/api/routers/token_events.py
index 6dcd853..802e173 100644
--- a/api/routers/token_events.py
+++ b/api/routers/token_events.py
@@ -13,6 +13,7 @@ from api.models.task import Task
 from api.models.token_event import TokenEvent
 from api.models.workplan import Workplan
 from api.services.legacy_compat import meter_legacy_query_param
+from api.services.repository_aliases import resolve_repository_slug
 from api.schemas.token_event import (
     RepoTokenSummary,
     TokenAggregateRow,
@@ -288,6 +289,7 @@ async def get_token_summary(
 
 @router.get("/by-repo/", response_model=list[RepoTokenSummary])
 async def get_tokens_by_repo(
+    repo_slug: str | None = None,
     measurement_kind: str | None = None,
     source_provider: str | None = None,
     since: datetime | None = None,
@@ -304,6 +306,12 @@ async def get_tokens_by_repo(
 
     Only events that resolve to a repo are included.
     """
+    requested_repo_id = None
+    if repo_slug:
+        requested_repo_id = (
+            await resolve_repository_slug(session, repo_slug)
+        ).repo.id
+
     # Fetch all events, workstreams, repos in three queries (avoids N+1)
     events_result = await session.execute(
         _filter_query(
@@ -341,6 +349,8 @@ async def get_tokens_by_repo(
         rid = resolve_repo_id(e)
         if not rid or rid not in repo_map:
             continue
+        if requested_repo_id is not None and rid != requested_repo_id:
+            continue
         if rid not in groups:
             groups[rid] = {
                 "repo_id": rid,
diff --git a/api/routers/work_record_projection.py b/api/routers/work_record_projection.py
new file mode 100644
index 0000000..ae16d86
--- /dev/null
+++ b/api/routers/work_record_projection.py
@@ -0,0 +1,151 @@
+"""Primary-only fast path for one forge-derived repository projection."""
+
+from __future__ import annotations
+
+import asyncio
+
+from fastapi import APIRouter, Depends, HTTPException
+from sqlalchemy import select
+from sqlalchemy.ext.asyncio import AsyncSession
+
+from api.config import settings
+from api.database import get_session
+from api.models.task import Task
+from api.models.workplan import Workplan
+from api.models.workplan_dependency import WorkplanDependency
+from api.schemas.work_record_projection import (
+    RepositoryProjectionReconcile,
+    RepositoryProjectionSnapshot,
+)
+from api.services.forge_projection import (
+    ForgeDeriveError,
+    ForgeUnreadableError,
+    derive_from_forge,
+    reset_repository_projection,
+)
+from api.services.repository_aliases import resolve_repository_slug
+
+router = APIRouter(prefix="/repos", tags=["repository-work-record-projection"])
+
+
+@router.get(
+    "/{slug}/work-record-projection/snapshot",
+    response_model=RepositoryProjectionSnapshot,
+)
+async def repository_work_record_snapshot(
+    slug: str,
+    session: AsyncSession = Depends(get_session),
+) -> RepositoryProjectionSnapshot:
+    """Return all consistency-check inputs for one repository in one request."""
+    resolution = await resolve_repository_slug(session, slug)
+    workplans = list(
+        (
+            await session.execute(
+                select(Workplan)
+                .where(Workplan.repo_id == resolution.repo.id)
+                .order_by(Workplan.slug)
+            )
+        ).scalars()
+    )
+    workplan_ids = [workplan.id for workplan in workplans]
+    tasks: list[Task] = []
+    dependencies: list[WorkplanDependency] = []
+    if workplan_ids:
+        tasks = list(
+            (
+                await session.execute(
+                    select(Task)
+                    .where(Task.workplan_id.in_(workplan_ids))
+                    .order_by(Task.workplan_id, Task.id)
+                )
+            ).scalars()
+        )
+        dependencies = list(
+            (
+                await session.execute(
+                    select(WorkplanDependency)
+                    .where(WorkplanDependency.from_workplan_id.in_(workplan_ids))
+                    .order_by(
+                        WorkplanDependency.from_workplan_id, WorkplanDependency.id
+                    )
+                )
+            ).scalars()
+        )
+    return RepositoryProjectionSnapshot(
+        schema="state-hub.repository-projection-snapshot.v1",
+        repo_slug=resolution.canonical_slug,
+        repo_id=resolution.repo.id,
+        workplans=workplans,
+        tasks=tasks,
+        dependencies=dependencies,
+    )
+
+
+@router.post("/{slug}/work-record-projection/reconcile")
+async def reconcile_repository_work_records(
+    slug: str,
+    body: RepositoryProjectionReconcile,
+    session: AsyncSession = Depends(get_session),
+) -> dict:
+    """Derive an exact pushed commit centrally and apply it transactionally."""
+    if settings.state_hub_instance_role != "primary":
+        raise HTTPException(
+            status_code=409,
+            detail={
+                "message": "repository projection writes require the primary State Hub",
+                "instance_role": settings.state_hub_instance_role,
+                "instance_label": settings.state_hub_instance_label,
+            },
+        )
+
+    try:
+        derived = await asyncio.to_thread(derive_from_forge, slug)
+    except ForgeUnreadableError as exc:
+        raise HTTPException(
+            status_code=424,
+            detail={
+                "message": "repository is unreadable from the forge",
+                "detail": str(exc)[:300],
+            },
+        ) from exc
+    except ForgeDeriveError as exc:
+        raise HTTPException(
+            status_code=502,
+            detail={
+                "message": "forge projection derivation failed",
+                "detail": str(exc)[:300],
+            },
+        ) from exc
+
+    if derived.commit.lower() != body.expected_commit:
+        raise HTTPException(
+            status_code=409,
+            detail={
+                "message": "forge default branch is not at the expected commit",
+                "expected_commit": body.expected_commit,
+                "derived_commit": derived.commit,
+            },
+        )
+
+    outcome = await reset_repository_projection(
+        session,
+        slug,
+        acknowledge_retirements=body.acknowledge_retirements,
+        derived=derived,
+    )
+    if outcome.status in {"applied", "noop"} or outcome.released:
+        await session.commit()
+    else:
+        await session.rollback()
+
+    from api.routers.workstreams import _invalidate_workplan_index_cache
+
+    _invalidate_workplan_index_cache()
+    return {
+        "schema": "state-hub.repository-projection-reconcile.v1",
+        "instance_role": settings.state_hub_instance_role,
+        "instance_label": settings.state_hub_instance_label,
+        "expected_commit": body.expected_commit,
+        "derived_commit": derived.commit,
+        "outcome": outcome.to_dict(),
+    }
diff --git a/api/routers/workstreams.py b/api/routers/workstreams.py
index 5ee52c4..bd636cd 100644
--- a/api/routers/workstreams.py
+++ b/api/routers/workstreams.py
@@ -9,7 +9,7 @@ from typing import Any
 
 import yaml
 from fastapi import APIRouter, Depends, HTTPException, Query, Request, Response, status
-from sqlalchemy import select
+from sqlalchemy import or_, select
 from sqlalchemy.ext.asyncio import AsyncSession
 
 from api.database import get_session
@@ -24,6 +24,11 @@ from api.schemas.workplan import (
 )
 from api.services.lifecycle import transition_workplan_status
 from api.services.legacy_compat import retire_legacy_route
+from api.work_record_flavor import (
+    RESIDUAL_FLAVOR,
+    WORK_RECORD_FLAVORS,
+    normalize_flavor,
+)
 from api.workplan_status import (
     is_supported_workplan_status,
     normalize_workplan_status,
@@ -88,6 +93,8 @@ async def _list_workplans(
     status_filter: str | None,
     owner: str | None,
     slug: str | None,
+    flavor: str | None = None,
+    include_residuals: bool = True,
     session: AsyncSession,
 ) -> list[Workplan]:
     q = select(Workplan)
@@ -106,6 +113,19 @@ async def _list_workplans(
         q = q.where(Workplan.owner == owner)
     if slug:
         q = q.where(Workplan.slug == slug)
+    wanted = normalize_flavor(flavor)
+    if wanted is not None:
+        if wanted not in WORK_RECORD_FLAVORS:
+            raise HTTPException(
+                status_code=422,
+                detail=(
+                    f"Unknown work-record flavor {wanted!r}; "
+                    f"expected one of {', '.join(WORK_RECORD_FLAVORS)}"
+                ),
+            )
+        q = q.where(Workplan.flavor == wanted)
+    elif not include_residuals:
+        q = q.where(or_(Workplan.flavor.is_(None), Workplan.flavor != RESIDUAL_FLAVOR))
     q = q.order_by(
         Workplan.planning_priority.asc().nullslast(),
         Workplan.planning_order.asc().nullslast(),
@@ -365,6 +385,8 @@ async def list_workplans(
     status: str | None = None,
     owner: str | None = None,
     slug: str | None = None,
+    flavor: str | None = Query(None),
+    include_residuals: bool = Query(True),
     session: AsyncSession = Depends(get_session),
 ) -> list[Workplan]:
     return await _list_workplans(
@@ -374,6 +396,8 @@ async def list_workplans(
         status_filter=status,
         owner=owner,
         slug=slug,
+        flavor=flavor,
+        include_residuals=include_residuals,
         session=session,
     )
 
@@ -411,8 +435,11 @@ async def sync_workplan_bindings(
     """Upsert workstation workplan file bindings for remote API index fallback."""
     synced_at = datetime.now(timezone.utc)
     updated = 0
+    requested_ids = {entry.workplan_id for entry in body.bindings}
+    rows = await session.execute(select(Workplan).where(Workplan.id.in_(requested_ids)))
+    workplans = {workplan.id: workplan for workplan in rows.scalars().all()}
     for entry in body.bindings:
-        wp = await session.get(Workplan, entry.workplan_id)
+        wp = workplans.get(entry.workplan_id)
         if wp is None:
             continue
         wp.backing_filename = entry.filename
@@ -524,4 +551,4 @@ async def archive_workplan(
     workplan_id: uuid.UUID,
     session: AsyncSession = Depends(get_session),
 ) -> Workplan:
-    return await _archive_workplan(workplan_id=workplan_id, session=session)
\ No newline at end of file
+    return await _archive_workplan(workplan_id=workplan_id, session=session)
diff --git a/api/schemas/decision.py b/api/schemas/decision.py
index 09e5260..edba07e 100644
--- a/api/schemas/decision.py
+++ b/api/schemas/decision.py
@@ -9,6 +9,7 @@ from pydantic import AliasChoices, Field
 
 
 class DecisionCreate(LegacyWorkstreamIdBodyMixin, BaseModel):
+    id: uuid.UUID | None = None
     topic_id: uuid.UUID | None = None
     workplan_id: uuid.UUID | None = Field(
         default=None,
@@ -65,4 +66,4 @@ class DecisionRead(OptionalWorkplanIdCompatMixin, BaseModel):
     escalation_note: str | None = None
     superseded_by: uuid.UUID | None = None
     created_at: datetime
-    updated_at: datetime
\ No newline at end of file
+    updated_at: datetime
diff --git a/api/schemas/execution.py b/api/schemas/execution.py
index 3e0df39..68f282f 100644
--- a/api/schemas/execution.py
+++ b/api/schemas/execution.py
@@ -104,3 +104,5 @@ class ExecutionSemantics(BaseModel):
     concurrency_modes: dict[str, str]
     state_hub_responsibility: list[str]
     activity_core_responsibility: list[str]
+    launch_requests_accepted: bool = False
+    replacements: dict[str, str] = Field(default_factory=dict)
diff --git a/api/schemas/fabric_graph.py b/api/schemas/fabric_graph.py
index b1ea79e..6afe417 100644
--- a/api/schemas/fabric_graph.py
+++ b/api/schemas/fabric_graph.py
@@ -27,7 +27,10 @@ class FabricGraphSource(BaseModel):
     repo: str | None = None
     producer: str | None = None
     registry: str | None = None
-    commit: str | None = None
+    # Accepted-snapshot-set revisions include the algorithm and digest, for
+    # example ``snapshot-set:sha256:<64 hex chars>``. They are intentionally
+    # longer than a Git SHA but still bounded before persistence.
+    commit: str | None = Field(default=None, max_length=255)
     path: str | None = None
     generation_reason: str | None = None
 
@@ -98,6 +101,18 @@ class FabricGraphAccountingPayload(BaseModel):
     valid_until: str | None = None
 
 
+class FabricGraphDeploymentOverlayPayload(BaseModel):
+    model_config = ConfigDict(extra="forbid")
+
+    deployment_environment: str | None = None
+    deployment_scenario: str | None = None
+    routing_authority: str | None = None
+    access_zone: str | None = None
+    policy_authority: str | None = None
+    exposure_class: str | None = None
+    route_evidence: dict[str, str | int | float | bool | None] = Field(default_factory=dict)
+
+
 class FabricGraphEvidencePayload(BaseModel):
     model_config = ConfigDict(extra="forbid")
 
@@ -154,6 +169,7 @@ class FabricGraphNodePayload(BaseModel):
     containment: FabricGraphContainmentPayload | None = None
     ownership: FabricGraphOwnershipPayload | None = None
     accounting: FabricGraphAccountingPayload | None = None
+    deployment_overlay: FabricGraphDeploymentOverlayPayload | None = None
     evidence: FabricGraphEvidencePayload | None = None
     canon_category: str | None = None
     canon_anchor: str | None = None
@@ -180,6 +196,7 @@ class FabricGraphEdgePayload(BaseModel):
     boundary: FabricGraphBoundaryPayload | None = None
     utility: FabricGraphUtilityPayload | None = None
     accounting: FabricGraphAccountingPayload | None = None
+    deployment_overlay: FabricGraphDeploymentOverlayPayload | None = None
     evidence: FabricGraphEvidencePayload | None = None
     attributes: dict[str, Any] = Field(default_factory=dict)
 
@@ -244,6 +261,17 @@ class FabricGraphIngestResult(BaseModel):
     edge_count: int
 
 
+class FabricGraphActivationRequest(BaseModel):
+    requested_by: str = "operator"
+
+
+class FabricGraphActivationResult(BaseModel):
+    import_run: FabricGraphImportRead
+    previous_import_id: uuid.UUID | None = None
+    activated: bool
+    idempotent: bool
+
+
 class FabricGraphNodeRead(BaseModel):
     model_config = ConfigDict(from_attributes=True)
 
diff --git a/api/schemas/identifier_migration.py b/api/schemas/identifier_migration.py
new file mode 100644
index 0000000..8b06629
--- /dev/null
+++ b/api/schemas/identifier_migration.py
@@ -0,0 +1,39 @@
+from typing import Any
+
+from pydantic import BaseModel, ConfigDict, Field
+
+
+class SealedProjectionRepairSubmit(BaseModel):
+    plan: dict[str, Any]
+    repo_slug: str = Field(pattern=r"^[a-z0-9][a-z0-9-]{0,99}$")
+    unit: dict[str, Any]
+    expected_plan_sha256: str = Field(pattern=r"^[0-9a-f]{64}$")
+    source_revision: str = Field(pattern=r"^[0-9a-f]{40}$")
+    source_fingerprint: str = Field(pattern=r"^[0-9a-f]{64}$")
+    source_clean: bool
+    source_synchronized: bool
+    primary_confirmed: bool
+    projection_identity: str = Field(min_length=1, max_length=200)
+
+
+class SealedProjectionRepairReceiptRead(BaseModel):
+    model_config = ConfigDict(populate_by_name=True)
+
+    schema_version: str = Field(alias="schema")
+    outcome: str
+    repo_slug: str
+    repository_id: str
+    workplan_record_id: str
+    workplan_old_id: str
+    task_records: list[tuple[str, str]]
+    plan_sha256: str
+    source_revision: str
+    source_fingerprint: str
+    projection_identity: str
+    observed_at: str
+
+
+class IdentifierMigrationApplySubmit(BaseModel):
+    plan: dict[str, Any]
+    expected_plan_sha256: str = Field(pattern=r"^[0-9a-f]{64}$")
+    primary_confirmed: bool
diff --git a/api/schemas/intake.py b/api/schemas/intake.py
new file mode 100644
index 0000000..54ff1ca
--- /dev/null
+++ b/api/schemas/intake.py
@@ -0,0 +1,89 @@
+import uuid
+from datetime import datetime
+
+from pydantic import BaseModel, ConfigDict, model_validator
+
+from api.models.intake import IntakeLane, IntakeOutcome, IntakeStatus
+
+
+class IntakeCreate(BaseModel):
+    id: uuid.UUID | None = None
+    topic_id: uuid.UUID | None = None
+    workplan_id: uuid.UUID | None = None
+    repo_id: uuid.UUID | None = None
+    title: str
+    description: str | None = None
+    lane: IntakeLane = IntakeLane.green
+    origin: str | None = None
+    origin_ref: str | None = None
+    source_repo_path: str | None = None
+
+    @model_validator(mode="after")
+    def scope_required(self) -> "IntakeCreate":
+        if self.topic_id is None and self.workplan_id is None and self.repo_id is None:
+            raise ValueError("At least one of topic_id, workplan_id, or repo_id must be set")
+        return self
+
+
+class IntakeUpdate(BaseModel):
+    title: str | None = None
+    description: str | None = None
+    lane: IntakeLane | None = None
+    status: IntakeStatus | None = None
+    origin: str | None = None
+    origin_ref: str | None = None
+    routed_note: str | None = None
+
+
+class IntakeRoute(BaseModel):
+    """Move an intake from open/vetted into routed — the state that makes
+    it eligible for the promotion transition (CUST-WP-0061-T03)."""
+
+    routed_note: str | None = None
+
+
+class IntakeClose(BaseModel):
+    outcome: IntakeOutcome
+    promoted_to: str | None = None
+    note: str | None = None
+
+    @model_validator(mode="after")
+    def promoted_requires_target(self) -> "IntakeClose":
+        if self.outcome == IntakeOutcome.promoted and not self.promoted_to:
+            raise ValueError("outcome=promoted requires promoted_to")
+        return self
+
+
+class IntakeNoteCreate(BaseModel):
+    content: str
+    author: str | None = None
+
+
+class IntakeNoteRead(BaseModel):
+    model_config = ConfigDict(from_attributes=True)
+    id: uuid.UUID
+    author: str | None = None
+    content: str
+    created_at: datetime
+
+
+class IntakeRead(BaseModel):
+    model_config = ConfigDict(from_attributes=True)
+    id: uuid.UUID
+    topic_id: uuid.UUID | None = None
+    workplan_id: uuid.UUID | None = None
+    repo_id: uuid.UUID | None = None
+    title: str
+    description: str | None = None
+    lane: IntakeLane
+    status: IntakeStatus
+    outcome: IntakeOutcome | None = None
+    origin: str | None = None
+    origin_ref: str | None = None
+    promoted_to: str | None = None
+    source_repo_path: str | None = None
+    routed_note: str | None = None
+    closed_at: datetime | None = None
+    created_at: datetime
+    updated_at: datetime
+    notes: list[IntakeNoteRead] = []
diff --git a/api/schemas/managed_repo.py b/api/schemas/managed_repo.py
index 82d619e..ff1f5cf 100644
--- a/api/schemas/managed_repo.py
+++ b/api/schemas/managed_repo.py
@@ -80,6 +80,7 @@ class RepoCreate(CoreRepoCreate, ClassificationFields):
 
 
 class RepoUpdate(ClassificationFields):
+    domain_slug: str | None = None
     name: str | None = None
     local_path: str | None = None
     remote_url: str | None = None
@@ -113,6 +114,11 @@ class RepoRead(CoreRepoRead, ClassificationFields):
     last_state_synced_at: datetime | None = None
     created_at: datetime
     updated_at: datetime
+    requested_slug: str | None = None
+    canonical_slug: str | None = None
+    slug_status: Literal["canonical", "alias"] = "canonical"
+    aliases: list[str] = Field(default_factory=list)
+    stale_external_references: list[dict[str, Any]] = Field(default_factory=list)
 
 
 class DispatchTask(BaseModel):
@@ -157,6 +163,11 @@ class ScopeIssueDetail(BaseModel):
 
 class RepoDispatch(BaseModel):
     repo_slug: str
+    requested_slug: str
+    canonical_slug: str
+    slug_status: Literal["canonical", "alias"]
+    aliases: list[str] = Field(default_factory=list)
+    stale_external_references: list[dict[str, Any]] = Field(default_factory=list)
     active_goal: dict[str, Any] | None
     active_workplans: list[DispatchWorkplan]
     human_interventions: list[DispatchTask]
@@ -176,4 +187,4 @@ class RepoScopeHealth(BaseModel):
     local_path: str | None = None
     path_available: bool
     scope_needs_review: bool
-    scope_issue_details: list[ScopeIssueDetail]
\ No newline at end of file
+    scope_issue_details: list[ScopeIssueDetail]
diff --git a/api/schemas/ops_run.py b/api/schemas/ops_run.py
new file mode 100644
index 0000000..6cad88d
--- /dev/null
+++ b/api/schemas/ops_run.py
@@ -0,0 +1,27 @@
+from datetime import datetime
+from typing import Any
+
+from pydantic import BaseModel, Field
+
+
+class OpsRunProjectionItem(BaseModel):
+    id: str
+    definition: str | None = None
+    target_repo: str | None = None
+    state: str
+    lease: dict[str, Any] | None = None
+    updated_at: datetime | None = None
+    last_error: str | None = None
+
+
+class OpsRunProjection(BaseModel):
+    available: bool = False
+    stale: bool = False
+    source: str = "activity-core"
+    generated_at: datetime
+    open: int = 0
+    claimed: int = 0
+    failed_24h: int = 0
+    stuck_open_or_claimed: int = 0
+    items: list[OpsRunProjectionItem] = Field(default_factory=list)
+    error: str | None = None
diff --git a/api/schemas/repository_rename.py b/api/schemas/repository_rename.py
new file mode 100644
index 0000000..aed4083
--- /dev/null
+++ b/api/schemas/repository_rename.py
@@ -0,0 +1,114 @@
+from __future__ import annotations
+
+import uuid
+from datetime import datetime
+from typing import Any, Literal
+
+from pydantic import BaseModel, Field
+
+
+class EdgeWriteEvidence(BaseModel):
+    id: str
+    status: str = "queued"
+    source_host: str | None = None
+    path: str | None = None
+
+
+class RepositoryRenamePreflightRequest(BaseModel):
+    new_slug: str = Field(min_length=1, max_length=100, pattern=r"^[a-z0-9][a-z0-9-]*$")
+    queued_edge_writes: list[EdgeWriteEvidence] = Field(default_factory=list)
+
+
+class RepositoryRenamePreflightRead(BaseModel):
+    schema_version: Literal["state-hub.repository-rename-preflight.v1"]
+    repo_id: uuid.UUID
+    old_slug: str
+    new_slug: str
+    safe_to_apply: bool
+    blockers: list[dict[str, Any]]
+    warnings: list[dict[str, Any]]
+    current: dict[str, Any]
+    target: dict[str, Any]
+    baselines: dict[str, Any]
+    active_work: dict[str, Any]
+    affected: dict[str, Any]
+    queued_edge_writes: list[dict[str, Any]]
+    proposed_mutations: list[dict[str, Any]]
+    retained_history: list[dict[str, Any]]
+    report_checksum: str
+    preflight_token: str | None
+    preflighted_at: datetime
+    expires_at: datetime | None
+
+
+class ForgeIdentityVerifyRequest(BaseModel):
+    provider: Literal["forgejo"] = "forgejo"
+    forge_instance: str
+    forge_owner: str
+    forge_repository_id: int = Field(gt=0)
+    verified_by: str = Field(min_length=1, max_length=160)
+
+
+class RepositoryRenameOperationCreate(BaseModel):
+    operation_id: uuid.UUID | None = None
+    new_slug: str = Field(min_length=1, max_length=100, pattern=r"^[a-z0-9][a-z0-9-]*$")
+    preflight_token: str
+    confirmation: str
+    actor: str = Field(min_length=1, max_length=160)
+    queued_edge_writes: list[EdgeWriteEvidence] = Field(default_factory=list)
+
+
+class RepositoryRenamePhaseApply(BaseModel):
+    expected_phase: str
+    confirmation: str
+    checks: dict[str, bool] = Field(default_factory=dict)
+    evidence: dict[str, Any] = Field(default_factory=dict)
+
+
+class RepositoryRenameRollbackRequest(BaseModel):
+    expected_phase: str
+    confirmation: str
+
+
+class RepositoryRenameOperationRead(BaseModel):
+    id: uuid.UUID
+    repo_id: uuid.UUID
+    phase: str
+    old_slug: str
+    new_slug: str
+    expected_forge_repository_id: int
+    expected_source_commit: str
+    expected_default_branch: str
+    actor: str
+    phase_changed_at: datetime
+    preflighted_at: datetime | None
+    preflight_expires_at: datetime | None
+    completed_at: datetime | None
+    rolled_back_at: datetime | None
+    evidence: dict[str, Any]
+    error_code: str | None
+    error_message: str | None
+    error_details: dict[str, Any] | None
+    error_at: datetime | None
+    no_op: bool = False
+
+
+class RepositoryRenameVerificationRead(BaseModel):
+    operation_id: uuid.UUID
+    repo_id: uuid.UUID
+    phase: str
+    ok: bool
+    checks: list[dict[str, Any]]
+    baseline_checksum: str
+    current_checksum: str
+    relationship_checksums: dict[str, dict[str, str]]
+
+
+class RepositoryRenameRollbackPreflightRead(BaseModel):
+    operation_id: uuid.UUID
+    repo_id: uuid.UUID
+    rollback_from_phase: str
+    safe_to_rollback: bool
+    blockers: list[dict[str, Any]]
+    irreversible: list[dict[str, Any]]
+    operation: RepositoryRenameOperationRead
diff --git a/api/schemas/review_contract.py b/api/schemas/review_contract.py
new file mode 100644
index 0000000..c5556fd
--- /dev/null
+++ b/api/schemas/review_contract.py
@@ -0,0 +1,96 @@
+import uuid
+from datetime import datetime
+from typing import Any, Literal
+
+from pydantic import BaseModel, ConfigDict, Field
+
+
+class SourceRef(BaseModel):
+    repo: str = Field(min_length=1, max_length=100)
+    path: str = Field(min_length=1, max_length=1000)
+    revision: str = Field(pattern=r"^[0-9a-f]{40,64}$")
+
+
+class ReviewContractProject(BaseModel):
+    contract: dict[str, Any]
+    source: SourceRef
+    decision_id: uuid.UUID | None = None
+    workplan_id: uuid.UUID | None = None
+    task_id: uuid.UUID | None = None
+    required_for_decision: bool = False
+
+
+class ReviewContractRead(BaseModel):
+    model_config = ConfigDict(from_attributes=True)
+    id: uuid.UUID
+    contract_key: str
+    schema_version: str
+    contract_digest: str
+    source_repo: str
+    source_path: str
+    source_revision: str
+    document: dict[str, Any]
+    active: bool
+    required_for_decision: bool
+    decision_id: uuid.UUID | None
+    workplan_id: uuid.UUID | None
+    task_id: uuid.UUID | None
+    projected_at: datetime
+    created_at: datetime
+    updated_at: datetime
+
+
+class ReviewReceiptSubmit(BaseModel):
+    owner_id: str = Field(min_length=1, max_length=160)
+    actor: str = Field(min_length=2, max_length=160)
+    disposition: Literal["approve", "request_changes"]
+    contract_digest: str = Field(pattern=r"^[0-9a-f]{64}$")
+    artifact_hashes: dict[str, str] = Field(default_factory=dict)
+    assertion_ids: list[str] = Field(default_factory=list)
+    checks: list[dict[str, Any]] = Field(default_factory=list)
+    note: str | None = Field(default=None, max_length=2000)
+    source: SourceRef
+
+
+class ReviewReceiptRead(BaseModel):
+    model_config = ConfigDict(from_attributes=True)
+    id: uuid.UUID
+    contract_id: uuid.UUID
+    owner_id: str
+    actor: str
+    disposition: str
+    contract_digest: str
+    receipt_digest: str
+    artifact_hashes: dict[str, str]
+    assertion_ids: list[str]
+    checks: list[dict[str, Any]]
+    note: str | None
+    source_repo: str
+    source_path: str
+    source_revision: str
+    submitted_at: datetime
+    created_at: datetime
+
+
+class OwnerReviewState(BaseModel):
+    owner_id: str
+    status: Literal["missing", "approved", "request_changes", "stale"]
+    receipt_id: uuid.UUID | None = None
+    receipt_digest: str | None = None
+    submitted_at: datetime | None = None
+
+
+class GateReviewState(BaseModel):
+    gate_id: str
+    policy: Literal["all_required"]
+    owners: list[str]
+    satisfied: bool
+
+
+class ReviewAggregateRead(BaseModel):
+    contract_key: str
+    contract_digest: str
+    satisfied: bool
+    authorizes_execution: Literal[False] = False
+    owners: list[OwnerReviewState]
+    gates: list[GateReviewState]
diff --git a/api/schemas/state.py b/api/schemas/state.py
index d665585..3b9e53e 100644
--- a/api/schemas/state.py
+++ b/api/schemas/state.py
@@ -11,6 +11,7 @@ from api.schemas.task import TaskRead
 from api.schemas.topic import TopicWithWorkstreams
 from api.schemas.suggestion import RankedSuggestionDigest
 from api.schemas.workstream import WorkstreamWithDeps
+from api.schemas.ops_run import OpsRunProjection
 
 
 class TopicTotals(BaseModel):
@@ -29,6 +30,7 @@ class WorkstreamTotals(BaseModel):
     finished: int = 0
     archived: int = 0
     total: int = 0
+    residual_open: int = 0
 
 
 class TaskTotals(BaseModel):
@@ -84,18 +86,21 @@ class StateSummary(BaseModel):
     blocked_tasks: list[TaskRead] = []
     recent_progress: list[ProgressEventRead]
     open_workplans: list[WorkstreamWithDeps] = []
+    residual_open_workplans: list[WorkstreamWithDeps] = []
     next_steps: list[NextStep] = []
     domains: list[DomainSummary] = []
     contribution_counts: dict[str, int] = {}
     licence_risk_count: int = 0
     open_capability_requests: int = 0
     ranked_suggestions: list[RankedSuggestionDigest] = []
+    ops_runs: OpsRunProjection | None = None
 
 
 class DashboardWorkplanRow(BaseModel):
     id: uuid.UUID
     title: str
     status: str
+    flavor: str | None = None
     domain: str = "unknown"
     repo_label: str = "unassigned"
     workplan_filename: str | None = None
diff --git a/api/schemas/task.py b/api/schemas/task.py
index ef1c608..31bf85d 100644
--- a/api/schemas/task.py
+++ b/api/schemas/task.py
@@ -7,6 +7,7 @@ from pydantic import BaseModel, ConfigDict, field_validator, model_validator
 from api.models.task import TaskPriority, TaskStatus
 from api.schemas.compat import WorkplanIdCompatMixin, WorkplanIdCreateMixin
 from api.task_status import normalize_task_status
+from api.work_record_flavor import WORK_RECORD_FLAVORS, normalize_flavor
 
 
 class TaskStatusMixin(BaseModel):
@@ -18,7 +19,23 @@ class TaskStatusMixin(BaseModel):
         return normalize_task_status(value)
 
 
-class TaskCreate(TaskStatusMixin, WorkplanIdCreateMixin):
+class TaskFlavorMixin(BaseModel):
+    @field_validator("flavor", mode="before", check_fields=False)
+    @classmethod
+    def _normalize_flavor(cls, value):
+        flavor = normalize_flavor(value)
+        if flavor is not None and flavor not in WORK_RECORD_FLAVORS:
+            raise ValueError(
+                f"Unknown work-record flavor {flavor!r}; "
+                f"expected one of {', '.join(WORK_RECORD_FLAVORS)}"
+            )
+        return flavor
+
+
+class TaskCreate(TaskStatusMixin, TaskFlavorMixin, WorkplanIdCreateMixin):
+    id: uuid.UUID | None = None
+    record_id: str | None = None
+    flavor: str | None = None
     title: str
     description: str | None = None
     status: TaskStatus = TaskStatus.todo
@@ -37,8 +54,9 @@ class TaskCreate(TaskStatusMixin, WorkplanIdCreateMixin):
         return self
 
 
-class TaskUpdate(TaskStatusMixin):
+class TaskUpdate(TaskStatusMixin, TaskFlavorMixin):
     title: str | None = None
+    flavor: str | None = None
     description: str | None = None
     status: TaskStatus | None = None
     priority: TaskPriority | None = None
@@ -99,6 +117,8 @@ class TaskStatusBulkSync(BaseModel):
 class TaskRead(TaskStatusMixin, WorkplanIdCompatMixin):
     model_config = ConfigDict(from_attributes=True)
     id: uuid.UUID
+    record_id: str | None = None
+    flavor: str | None = None
     title: str
     description: str | None = None
     status: TaskStatus
diff --git a/api/schemas/work_record_projection.py b/api/schemas/work_record_projection.py
new file mode 100644
index 0000000..7167cbf
--- /dev/null
+++ b/api/schemas/work_record_projection.py
@@ -0,0 +1,38 @@
+from __future__ import annotations
+
+import re
+import uuid
+from typing import Literal
+
+from pydantic import BaseModel, Field, field_validator
+
+from api.schemas.task import TaskRead
+from api.schemas.workplan import WorkplanRead
+from api.schemas.workplan_dependency import WorkplanDependencyRead
+
+
+class RepositoryProjectionReconcile(BaseModel):
+    expected_commit: str
+    acknowledge_retirements: bool = False
+
+    @field_validator("expected_commit")
+    @classmethod
+    def validate_commit(cls, value: str) -> str:
+        value = value.strip().lower()
+        if not re.fullmatch(r"[0-9a-f]{40}", value):
+            raise ValueError("expected_commit must be a full 40-character Git SHA")
+        return value
+
+
+class RepositoryProjectionSnapshot(BaseModel):
+    """One bounded read of a repository's complete work-record projection."""
+
+    schema_version: Literal["state-hub.repository-projection-snapshot.v1"] = Field(
+        validation_alias="schema",
+        serialization_alias="schema",
+    )
+    repo_slug: str
+    repo_id: uuid.UUID
+    workplans: list[WorkplanRead]
+    tasks: list[TaskRead]
+    dependencies: list[WorkplanDependencyRead]
diff --git a/api/schemas/workplan.py b/api/schemas/workplan.py
index 90be8b8..31bf49c 100644
--- a/api/schemas/workplan.py
+++ b/api/schemas/workplan.py
@@ -5,6 +5,12 @@ from typing import Literal
 from pydantic import BaseModel, ConfigDict, field_validator
 
 from api.schemas.workplan_dependency import WorkplanDepStub
+from api.work_record_flavor import (
+    FLAVOR_PROMOTION_REASONS,
+    WORK_RECORD_FLAVORS,
+    normalize_flavor,
+    normalize_promotion_reason,
+)
 from api.workplan_status import normalize_workplan_status
 
 WorkplanStatus = Literal[
@@ -28,7 +34,43 @@ class WorkplanStatusMixin(BaseModel):
         return normalize_workplan_status(value)
 
 
-class WorkplanCreate(WorkplanStatusMixin):
+class WorkplanFlavorMixin(BaseModel):
+    @field_validator("flavor", mode="before", check_fields=False)
+    @classmethod
+    def _normalise_flavor(cls, value):
+        flavor = normalize_flavor(value)
+        if flavor is not None and flavor not in WORK_RECORD_FLAVORS:
+            raise ValueError(
+                f"Unknown work-record flavor {flavor!r}; "
+                f"expected one of {', '.join(WORK_RECORD_FLAVORS)}"
+            )
+        return flavor
+
+    @field_validator("flavor_promotion_reason", mode="before", check_fields=False)
+    @classmethod
+    def _normalise_promotion_reason(cls, value):
+        reason = normalize_promotion_reason(value)
+        if reason is not None and reason not in FLAVOR_PROMOTION_REASONS:
+            raise ValueError(
+                f"Unknown flavor_promotion_reason {reason!r}; "
+                f"expected one of {', '.join(FLAVOR_PROMOTION_REASONS)}"
+            )
+        return reason
+
+    @field_validator("flavor_promoted_from", mode="before", check_fields=False)
+    @classmethod
+    def _normalise_promoted_from(cls, value):
+        flavor = normalize_flavor(value)
+        if flavor is not None and flavor not in WORK_RECORD_FLAVORS:
+            raise ValueError(
+                f"Unknown flavor_promoted_from {flavor!r}; "
+                f"expected one of {', '.join(WORK_RECORD_FLAVORS)}"
+            )
+        return flavor
+
+
+class WorkplanCreate(WorkplanStatusMixin, WorkplanFlavorMixin):
+    id: uuid.UUID | None = None
     repo_id: uuid.UUID
     topic_id: uuid.UUID | None = None
     slug: str
@@ -39,6 +81,9 @@ class WorkplanCreate(WorkplanStatusMixin):
     due_date: date | None = None
     planning_priority: str | None = None
     planning_order: int | None = None
+    flavor: str | None = None
+    flavor_promotion_reason: str | None = None
+    flavor_promoted_from: str | None = None
     execution_state: ExecutionState = "manual"
     launch_mode: LaunchMode = "manual"
     concurrency_mode: ConcurrencyMode = "sequential"
@@ -48,7 +93,7 @@ class WorkplanCreate(WorkplanStatusMixin):
     repo_goal_id: uuid.UUID | None = None
 
 
-class WorkplanUpdate(WorkplanStatusMixin):
+class WorkplanUpdate(WorkplanStatusMixin, WorkplanFlavorMixin):
     title: str | None = None
     description: str | None = None
     status: WorkplanStatus | None = None
@@ -56,6 +101,9 @@ class WorkplanUpdate(WorkplanStatusMixin):
     due_date: date | None = None
     planning_priority: str | None = None
     planning_order: int | None = None
+    flavor: str | None = None
+    flavor_promotion_reason: str | None = None
+    flavor_promoted_from: str | None = None
     execution_state: ExecutionState | None = None
     launch_mode: LaunchMode | None = None
     concurrency_mode: ConcurrencyMode | None = None
@@ -94,6 +142,9 @@ class WorkplanRead(WorkplanStatusMixin):
     due_date: date | None = None
     planning_priority: str | None = None
     planning_order: int | None = None
+    flavor: str | None = None
+    flavor_promotion_reason: str | None = None
+    flavor_promoted_from: str | None = None
     execution_state: ExecutionState = "manual"
     launch_mode: LaunchMode = "manual"
     concurrency_mode: ConcurrencyMode = "sequential"
@@ -121,4 +172,4 @@ class WorkplanWithDeps(WorkplanWithTaskCounts):
     """WorkplanWithTaskCounts enriched with dependency graph edges."""
     depends_on: list[WorkplanDepStub] = []
     blocks: list[WorkplanDepStub] = []
-    blocked_reasons: list[dict] = []
\ No newline at end of file
+    blocked_reasons: list[dict] = []
diff --git a/api/services/execution_queue.py b/api/services/execution_queue.py
index 01a5263..afd4dba 100644
--- a/api/services/execution_queue.py
+++ b/api/services/execution_queue.py
@@ -9,7 +9,7 @@ EXECUTION_STATES = {
     "manual": "Not queued for autonomous pickup; humans or agents may still work manually.",
     "queued": "Candidate for ordered pickup when dependencies and concurrency allow it.",
     "scheduled": "Waiting for an external launch window; State Hub stores the requested time.",
-    "launching": "A launch request asks for immediate pickup or has been handed off.",
+    "launching": "Legacy state only; it does not prove that any consumer accepted pickup.",
     "paused": "Temporarily held outside the pickup stack.",
     "completed": "Execution intent is closed; lifecycle status remains authoritative.",
     "cancelled": "Execution intent was cancelled without changing lifecycle status.",
@@ -19,7 +19,7 @@ LAUNCH_MODES = {
     "manual": "Do not request automation; keep intent visible only.",
     "queued": "Place in the prioritized stack for later pickup.",
     "scheduled": "Request pickup at or after a selected time.",
-    "immediate": "Request prompt activity-core or agent pickup.",
+    "immediate": "Legacy intent only; workplan launch-request pickup is retired.",
 }
 
 CONCURRENCY_MODES = {
@@ -30,16 +30,26 @@ CONCURRENCY_MODES = {
 STATE_HUB_RESPONSIBILITIES = [
     "store lifecycle status separately from execution intent",
     "rank candidate workplans and expose dependency-aware eligibility",
-    "record launch requests and handoff metadata durably",
-    "surface manual, queued, scheduled, and immediate intent to operators",
+    "preserve historical launch-request and execution-intent rows during retirement",
+    "reject new workplan launch requests because no pickup consumer exists",
 ]
 
 ACTIVITY_CORE_RESPONSIBILITIES = [
     "own schedules, wakeups, and recurring automation",
-    "dispatch coding agents and coordinate parallel execution",
-    "acknowledge, run, and complete launch requests when available",
+    "claim and complete ops runs created by ActivityDefinition fires",
+    "do not consume State Hub workplan launch requests",
 ]
 
+EXECUTION_REPLACEMENTS = {
+    "POST /execution/launch-requests": (
+        "Queue work in the authoritative repository file; for recurring or operational "
+        "fires use an ActivityDefinition and activity-core ops_run"
+    ),
+    "GET /execution/launch-requests": "GET /ops-runs on activity-core for automation history",
+    "GET /execution/workplan-stack": "Repo Manager work index or hub-core projection",
+    "PATCH /execution/workplans/{id}/intent": "Edit the authoritative workplan file",
+}
+
 EXECUTION_STATE_RANK = {
     "launching": 0,
     "queued": 1,
diff --git a/api/services/fabric_graph.py b/api/services/fabric_graph.py
index d8a5f56..48f1fef 100644
--- a/api/services/fabric_graph.py
+++ b/api/services/fabric_graph.py
@@ -221,6 +221,55 @@ async def ingest_fabric_graph_export(
     return import_run, True, False
 
 
+async def activate_fabric_graph_import(
+    session: AsyncSession,
+    import_id: Any,
+    *,
+    requested_by: str,
+) -> tuple[FabricGraphImport | None, Any | None, bool]:
+    """Select a retained valid import as the active read model.
+
+    Imports are immutable. Activation only moves the per-source ``is_latest``
+    marker, which makes cutover rollback fast and avoids re-fetching an older
+    authority payload during an incident.
+    """
+    result = await session.execute(
+        select(FabricGraphImport).where(FabricGraphImport.id == import_id)
+    )
+    import_run = result.scalar_one_or_none()
+    if import_run is None:
+        return None, None, False
+    if import_run.validation_status != "valid":
+        raise ValueError("Only a valid Fabric graph import can be activated.")
+
+    previous_result = await session.execute(
+        select(FabricGraphImport).where(
+            FabricGraphImport.source_repo_slug == import_run.source_repo_slug,
+            FabricGraphImport.is_latest.is_(True),
+        )
+    )
+    previous = previous_result.scalars().first()
+    if previous is not None and previous.id == import_run.id:
+        return import_run, previous.id, False
+
+    await _mark_latest(session, import_run)
+    import_run.last_seen_at = datetime.now(timezone.utc)
+    await _record_progress(
+        session,
+        "Fabric graph read model activation changed.",
+        {
+            "source_repo_slug": import_run.source_repo_slug,
+            "import_id": str(import_run.id),
+            "previous_import_id": str(previous.id) if previous else None,
+            "content_hash": import_run.content_hash,
+            "requested_by": requested_by,
+        },
+    )
+    await session.commit()
+    await session.refresh(import_run)
+    return import_run, previous.id if previous else None, True
+
+
 def validate_fabric_graph_export(payload: dict[str, Any]) -> FabricGraphExportPayload:
     try:
         export = FabricGraphExportPayload.model_validate(payload)
@@ -324,7 +373,10 @@ async def _record_invalid_import(
         import_run = FabricGraphImport(
             source_repo_slug=source_repo_slug,
             source_url=source_url,
-            source_commit=_source_value(payload, "commit"),
+            # Invalid payloads are retained for diagnostics, but their
+            # denormalized provenance must not make the rejection path fail.
+            # The complete input remains available in ``graph_json``.
+            source_commit=_bounded_source_value(payload, "commit", max_length=255),
             source_path=_source_value(payload, "path"),
             api_version=str(payload.get("apiVersion")) if payload.get("apiVersion") else None,
             export_kind=str(payload.get("kind")) if payload.get("kind") else None,
@@ -620,6 +672,13 @@ def _source_value(payload: dict[str, Any], field: str) -> str | None:
     return str(value) if value else None
 
 
+def _bounded_source_value(
+    payload: dict[str, Any], field: str, *, max_length: int
+) -> str | None:
+    value = _source_value(payload, field)
+    return value[:max_length] if value is not None else None
+
+
 def _parse_datetime(value: Any) -> datetime | None:
     if not isinstance(value, str) or not value:
         return None
diff --git a/api/services/forge_credential.py b/api/services/forge_credential.py
new file mode 100644
index 0000000..5714b65
--- /dev/null
+++ b/api/services/forge_credential.py
@@ -0,0 +1,122 @@
+"""Resolve the forge read credential (STATE-WP-0084-T03, MASON-WP-0003-T05).
+
+Three sources, tried in order: a mounted file, an environment variable, and
+OpenBao via Kubernetes auth. Production uses the third — this cluster has no
+agent injector and no secrets-store CSI driver, so the pod authenticates with
+its projected ServiceAccount token and reads the KV path itself, which is what
+`MASON-WP-0003-T02` built the Kubernetes auth role for. The first two exist so
+the code is runnable and testable outside the cluster.
+
+**Absent is a supported state, never an error.** A hub with no credential still
+derives every public repository; only private ones become unreadable, and
+`STATE-WP-0084-T01` already reports that as its own named condition rather than
+as records that stopped deriving. So every failure here — no configuration, no
+network, OpenBao down, permission denied — resolves to `None`. Raising would
+convert "cannot read nine repositories" into "the whole pass failed".
+"""
+
+from __future__ import annotations
+
+import logging
+import os
+import time
+from pathlib import Path
+
+import httpx
+
+logger = logging.getLogger(__name__)
+
+TOKEN_ENV = "FORGE_READ_TOKEN"
+TOKEN_FILE_ENV = "FORGE_READ_TOKEN_FILE"
+OPENBAO_ADDR_ENV = "OPENBAO_ADDR"
+OPENBAO_ROLE_ENV = "OPENBAO_K8S_ROLE"
+OPENBAO_JWT_PATH_ENV = "OPENBAO_K8S_TOKEN_PATH"
+OPENBAO_AUTH_MOUNT_ENV = "OPENBAO_K8S_AUTH_MOUNT"
+SECRET_PATH_ENV = "FORGE_READ_SECRET_PATH"
+SECRET_KEY_ENV = "FORGE_READ_SECRET_KEY"
+
+# Long enough that a fleet reset of 121 repositories does not re-authenticate
+# 121 times; short enough that a rotated token is picked up without a redeploy,
+# which is what MASON-WP-0003-T02 requires of this lane.
+CACHE_TTL_SECONDS = 300.0
+
+_cache: tuple[float, str | None] | None = None
+
+
+def reset_cache() -> None:
+    global _cache
+    _cache = None
+
+
+def _from_file() -> str | None:
+    path = os.environ.get(TOKEN_FILE_ENV)
+    if not path:
+        return None
+    try:
+        return Path(path).read_text(encoding="utf-8").strip() or None
+    except OSError:
+        # Deliberately not falling through to the environment: a broken mount
+        # that silently used a stale value would look like success.
+        logger.warning("forge credential: token file %s is unreadable", path)
+        return None
+
+
+def _from_env() -> str | None:
+    return (os.environ.get(TOKEN_ENV) or "").strip() or None
+
+
+def _from_openbao() -> str | None:
+    addr = (os.environ.get(OPENBAO_ADDR_ENV) or "").strip().rstrip("/")
+    secret_path = (os.environ.get(SECRET_PATH_ENV) or "").strip().strip("/")
+    role = (os.environ.get(OPENBAO_ROLE_ENV) or "").strip()
+    jwt_path = os.environ.get(OPENBAO_JWT_PATH_ENV) or "/var/run/secrets/openbao/token"
+    mount = (os.environ.get(OPENBAO_AUTH_MOUNT_ENV) or "kubernetes").strip("/")
+    key = (os.environ.get(SECRET_KEY_ENV) or "token").strip()
+    if not (addr and secret_path and role):
+        return None
+    try:
+        jwt = Path(jwt_path).read_text(encoding="utf-8").strip()
+    except OSError:
+        logger.warning("forge credential: no ServiceAccount token at %s", jwt_path)
+        return None
+    try:
+        with httpx.Client(timeout=10.0) as client:
+            login = client.post(
+                f"{addr}/v1/auth/{mount}/login", json={"role": role, "jwt": jwt}
+            )
+            login.raise_for_status()
+            client_token = login.json()["auth"]["client_token"]
+            read = client.get(
+                f"{addr}/v1/{secret_path}", headers={"X-Vault-Token": client_token}
+            )
+            read.raise_for_status()
+            data = read.json()["data"]
+            # KV v2 nests the payload under a second "data"; v1 does not.
+            if isinstance(data.get("data"), dict):
+                data = data["data"]
+    except (httpx.HTTPError, KeyError, ValueError) as exc:
+        # Never include the response body: a failed KV read can echo content.
+        logger.warning("forge credential: OpenBao lookup failed (%s)", type(exc).__name__)
+        return None
+    value = data.get(key)
+    if not isinstance(value, str) or not value.strip():
+        logger.warning("forge credential: key %r absent at the KV path", key)
+        return None
+    return value.strip()
+
+
+def forge_read_token(*, use_cache: bool = True) -> str | None:
+    """The forge read credential, or `None` if this instance has none."""
+    global _cache
+    now = time.monotonic()
+    if use_cache and _cache is not None and now - _cache[0] < CACHE_TTL_SECONDS:
+        return _cache[1]
+    if os.environ.get(TOKEN_FILE_ENV):
+        # Configured to use a file means *that* file and nothing else. Falling
+        # back would let a broken mount quietly resolve to a stale environment
+        # value that nobody knows is in use.
+        token = _from_file()
+    else:
+        token = _from_env() or _from_openbao()
+    _cache = (now, token)
+    return token
diff --git a/api/services/forge_projection.py b/api/services/forge_projection.py
new file mode 100644
index 0000000..2071da1
--- /dev/null
+++ b/api/services/forge_projection.py
@@ -0,0 +1,1499 @@
+"""Derive a repository's work-record projection from the forge (STATE-WP-0083-T01).
+
+`ADR-012` decision 1 makes the forge the projection source. Central does its own
+reading: it clones the repository's default branch and derives from that, rather
+than accepting a projection computed elsewhere — which `ADR-010` decision 5
+forbids.
+
+This module is read-only. Deriving must be safe to run at any time, because it is
+what makes the reset in `T03` verifiable: you can always ask what the projection
+*should* be without changing anything.
+"""
+
+from __future__ import annotations
+
+import os
+import base64
+import re
+import subprocess
+import tempfile
+import uuid
+from dataclasses import dataclass, field
+from pathlib import Path
+from typing import Any
+
+import yaml
+
+# Same derivation as ADR-007 / repo-manager, so a forge-derived projection and a
+# preliminary overlay compute identical identities for the same record.
+from api.services.task_record_id_backfill import qualify_task_id
+
+_WORK_RECORD_NAMESPACE = uuid.UUID("a4058507-5c4a-5a00-ab06-fffa4fb46009")
+_TASK_BLOCK_RE = re.compile(r"```task\s*\n(.*?)\n```", re.DOTALL)
+_HEADING_RE = re.compile(r"^(#{1,6})\s+(.+?)$", re.MULTILINE)
+DEFAULT_FORGE_BASE = "https://forgejo.coulomb.social/coulomb"
+
+
+_IDENTIFIER_SLUG = re.compile(
+    r"^[a-z0-9-]*-wp-\d{3,}(?:-t\d{2})?$"          # PREFIX-WP-0001, -T01
+    r"|^[a-z0-9-]*adhoc[a-z0-9-]*?-\d{4}-\d{2}-\d{2}(?:-t\d{2})?$"  # daily ad-hoc, qualified either side
+)
+
+
+def _slug_is_identifier(slug: str) -> bool:
+    """Whether a row's slug is a work-record identifier or a title slug.
+
+    This is what separates a re-key from a rename when the path cannot. A row
+    whose slug is an identifier is *claiming* to be that record, so if the forge
+    derives a different identifier for the same file, they are two records and
+    the old one retires. A row whose slug is a title (`three-phoenix-ha-cluster`
+    for `RCLUSTER-WP-0007`) never claimed one: those are hub-first rows from
+    before ADR-001, where the backing path is the only link there has ever been,
+    and path matching is the only thing that can hold them together.
+    """
+    return bool(_IDENTIFIER_SLUG.match((slug or "").strip().lower()))
+
+
+def _identity_is_derived(row: Any) -> bool:
+    """Whether this row's UUID was derived from its identifier (ADR-007).
+
+    Derived rows are UUIDv5 over the work-record namespace. Rows predating
+    derived identity carry a random v4 UUID, and for those the identifier is a
+    label rather than the identity — so the path fallback still applies, which
+    is what keeps rename detection working for legacy records.
+    """
+    rid = getattr(row, "id", None)
+    return getattr(rid, "version", None) == 5
+
+
+def derived_record_uuid(record_id: str) -> str:
+    return str(uuid.uuid5(_WORK_RECORD_NAMESPACE, f"helixforge\n{record_id}"))
+
+
+class ForgeDeriveError(RuntimeError):
+    """The repository could not be read from the forge."""
+
+
+class ForgeUnreadableError(ForgeDeriveError):
+    """Central is not permitted to read this repository — a policy, not a fault.
+
+    `ADR-012`'s premise (the forge is the projection source) holds only for
+    repositories central can read, and until `STATE-WP-0084` nothing said so:
+    a private repository failed the same way a broken one did, so "cannot read"
+    and "does not exist" were indistinguishable from the outside.
+
+    They must never be confused, because they authorise opposite things. A
+    repository that does not derive may have had its files removed deliberately;
+    a repository we cannot read tells us nothing at all about its files. Only
+    the first can justify retiring a record.
+
+    Forgejo answers an unauthenticated request for a private repository with a
+    404, so "not found" is classified as unreadable too. That is deliberate: the
+    two cases are genuinely indistinguishable at this layer, and the safe
+    reading of an ambiguous answer is the one that cannot destroy a record.
+    """
+
+
+# git says this in several ways depending on version, transport, and whether a
+# credential helper is installed; all of them mean the same thing here.
+_UNREADABLE_MARKERS = (
+    "could not read username",
+    "could not read password",
+    "authentication failed",
+    "terminal prompts disabled",
+    "invalid username or password",
+    "403 forbidden",
+    "the requested url returned error: 403",
+    "the requested url returned error: 401",
+    "repository not found",
+    "remote: not found",
+    "does not appear to be a git repository",
+)
+
+
+def _is_unreadable(message: str) -> bool:
+    low = message.lower()
+    if "not found" in low and "fatal: repository" in low:
+        return True
+    return any(marker in low for marker in _UNREADABLE_MARKERS)
+
+
+@dataclass
+class DerivedTask:
+    record_id: str
+    uuid: str
+    title: str | None
+    status: str | None
+    priority: str | None
+    description: str | None = None
+    needs_human: bool = False
+    intervention_note: str | None = None
+    blocking_reason: str | None = None
+
+
+@dataclass
+class DerivedWorkplan:
+    record_id: str
+    uuid: str
+    title: str | None
+    status: str | None
+    relative_path: str
+    archived: bool
+    owner: str | None = None
+    description: str | None = None
+    tasks: list[DerivedTask] = field(default_factory=list)
+
+
+@dataclass
+class DerivedProjection:
+    repo_slug: str
+    commit: str
+    workplans: list[DerivedWorkplan] = field(default_factory=list)
+    # False when the checkout has no `workplans/` directory at all. An empty
+    # projection then means "we did not find the records", which is not the same
+    # claim as "this repository has no records" — and only the second one could
+    # ever justify retiring anything.
+    records_source_present: bool = True
+
+    @property
+    def task_count(self) -> int:
+        return sum(len(w.tasks) for w in self.workplans)
+
+    @property
+    def retirement_eligible(self) -> bool:
+        """Whether an absence in this projection is evidence of an absence.
+
+        A projection that could not be read never reaches this: it raises. What
+        this rules out is the quieter case — a clone that succeeded and returned
+        nothing, which is what would have retired every record in a repository
+        had a clone ever come back empty instead of failing (`STATE-WP-0084-T01`;
+        the near-miss was `vergabe-teilnahme`).
+        """
+        return self.records_source_present
+
+    def to_dict(self) -> dict[str, Any]:
+        return {
+            "schema": "state-hub.forge-projection.v1",
+            "repo_slug": self.repo_slug,
+            # Provenance is not optional: a projection that cannot name the
+            # commit it came from cannot be audited (ADR-012 decision 2).
+            "commit": self.commit,
+            "records_source_present": self.records_source_present,
+            "retirement_eligible": self.retirement_eligible,
+            "workplans": [
+                {
+                    "record_id": w.record_id,
+                    "uuid": w.uuid,
+                    "title": w.title,
+                    "status": w.status,
+                    "owner": w.owner,
+                    "description": w.description,
+                    "relative_path": w.relative_path,
+                    "archived": w.archived,
+                    "tasks": [
+                        {
+                            "record_id": t.record_id,
+                            "uuid": t.uuid,
+                            "title": t.title,
+                            "status": t.status,
+                            "priority": t.priority,
+                            "description": t.description,
+                            "needs_human": t.needs_human,
+                            "intervention_note": t.intervention_note,
+                            "blocking_reason": t.blocking_reason,
+                        }
+                        for t in w.tasks
+                    ],
+                }
+                for w in self.workplans
+            ],
+        }
+
+
+from api.services.forge_credential import forge_read_token  # noqa: F401
+
+# Kept as module attributes so callers and tests that reached for them here
+# still resolve after the sources moved to `forge_credential`.
+FORGE_TOKEN_ENV = "FORGE_READ_TOKEN"
+FORGE_TOKEN_FILE_ENV = "FORGE_READ_TOKEN_FILE"
+
+
+def _credential_env(token: str | None) -> dict[str, str]:
+    """Git config carrying the credential, passed by environment not argv.
+
+    `-c http.extraHeader=...` would place the token in the process command line,
+    where it is readable by anything that can run `ps` and lands in any log that
+    records invocations. GIT_CONFIG_* achieves the same configuration without
+    that exposure.
+    """
+    if not token:
+        return {}
+    header = base64.b64encode(f"x-access-token:{token}".encode()).decode()
+    return {
+        "GIT_CONFIG_COUNT": "1",
+        "GIT_CONFIG_KEY_0": "http.extraHeader",
+        "GIT_CONFIG_VALUE_0": f"Authorization: Basic {header}",
+    }
+
+
+def _run_git(
+    *args: str, cwd: str | None = None, timeout: float = 120.0, token: str | None = None
+) -> str:
+    # Without this a clone of a private repository blocks on a username prompt
+    # instead of failing, and an unattended derivation pass hangs rather than
+    # reporting. Failing fast is what makes the unreadable case observable.
+    env = {**os.environ, "GIT_TERMINAL_PROMPT": "0", "GIT_ASKPASS": "", "GCM_INTERACTIVE": "never"}
+    env.update(_credential_env(token))
+    proc = subprocess.run(
+        ["git", *args], cwd=cwd, capture_output=True, text=True, timeout=timeout, env=env
+    )
+    if proc.returncode != 0:
+        detail = (proc.stderr or proc.stdout).strip()[:400]
+        if token:
+            # Never let a credential reach an exception that is logged, stored
+            # in a reset outcome, or returned over the API.
+            detail = detail.replace(token, "***")
+        raise ForgeDeriveError(detail)
+    return proc.stdout.strip()
+
+
+def _split_frontmatter(text: str) -> tuple[dict, str]:
+    if not text.startswith("---"):
+        return {}, text
+    end = text.find("\n---", 3)
+    if end == -1:
+        return {}, text
+    raw = text[3:end]
+    body = text[end + 4 :]
+    try:
+        meta = yaml.safe_load(raw) or {}
+    except yaml.YAMLError:
+        return {}, text
+    return (meta if isinstance(meta, dict) else {}), body
+
+
+def _clean_task_description(raw: str) -> str | None:
+    """Match the file-authoritative consistency parser's section boundaries."""
+    lines = raw.splitlines()
+    while lines and (not lines[0].strip() or lines[0].strip() in {"---", "***", "___"}):
+        lines.pop(0)
+    while lines and (not lines[-1].strip() or lines[-1].strip() in {"---", "***", "___"}):
+        lines.pop()
+    return "\n".join(lines).strip() or None
+
+
+def _parse_tasks(body: str, workplan_id: str) -> list[DerivedTask]:
+    headings = [
+        (m.start(), len(m.group(1)), m.group(2).strip()) for m in _HEADING_RE.finditer(body)
+    ]
+    out: list[DerivedTask] = []
+    task_matches = list(_TASK_BLOCK_RE.finditer(body))
+    for index, m in enumerate(task_matches):
+        try:
+            block = yaml.safe_load(m.group(1).strip()) or {}
+        except yaml.YAMLError:
+            continue
+        if not isinstance(block, dict):
+            continue
+        rid = str(block.get("id") or "").strip()
+        if not rid:
+            continue
+        prev = [(pos, level, text) for pos, level, text in headings if pos < m.start()]
+        heading = prev[-1] if prev else None
+        title = block.get("title") or (heading[2] if heading else None)
+        # Nested evidence belongs to this task. Stop at the next peer/ancestor
+        # heading or task block, as the ordinary consistency path does.
+        description_end = task_matches[index + 1].start() if index + 1 < len(task_matches) else len(body)
+        following_heading = next((
+            pos for pos, level, _text in headings
+            if pos > m.end() and (heading is None or level <= heading[1])
+        ), None)
+        if following_heading is not None:
+            description_end = min(description_end, following_heading)
+        description = _clean_task_description(body[m.end():description_end])
+        if description is None and block.get("description") is not None:
+            description = str(block["description"])
+        out.append(
+            DerivedTask(
+                # A bare `T01` is not an identifier: it is unique only within
+                # its workplan, so `uuid5("T01")` is the same UUID for every
+                # workplan in the fleet. llm-connect's 91 task blocks derive
+                # just 49 distinct UUIDs unqualified, and creating its
+                # workplans fails on a duplicate task primary key.
+                #
+                # Qualifying with the owning workplan is the same rule
+                # `task_record_id_backfill.qualify_task_id` applies to stored
+                # ids; both must agree or the backfill and the projection
+                # disagree about what a task is called.
+                record_id=qualify_task_id(rid, workplan_id) or rid,
+                # Derived, not read from the file: the forge projection must not
+                # inherit an identifier the file happens to carry.
+                uuid=derived_record_uuid(qualify_task_id(rid, workplan_id) or rid),
+                title=title,
+                status=(str(block["status"]).strip() if block.get("status") else None),
+                priority=(str(block["priority"]).strip() if block.get("priority") else None),
+                description=description,
+                needs_human=bool(block.get("needs_human", False)),
+                intervention_note=(
+                    str(block["intervention_note"])
+                    if block.get("intervention_note") is not None
+                    else None
+                ),
+                blocking_reason=(
+                    str(block["blocking_reason"])
+                    if block.get("blocking_reason") is not None
+                    else None
+                ),
+            )
+        )
+    return out
+
+
+def _workplan_description(body: str) -> str | None:
+    """Return bounded prose under ``## Goal`` when one is present."""
+    match = re.search(r"^##\s+Goal\s*$", body, re.MULTILINE | re.IGNORECASE)
+    if match is None:
+        return None
+    remainder = body[match.end() :]
+    next_heading = re.search(r"^##\s+", remainder, re.MULTILINE)
+    if next_heading is not None:
+        remainder = remainder[: next_heading.start()]
+    value = remainder.strip()
+    return value[:4000] or None
+
+
+def derive_from_checkout(repo_root: Path, repo_slug: str, commit: str) -> DerivedProjection:
+    """Derive a projection from an already-materialised checkout."""
+    proj = DerivedProjection(repo_slug=repo_slug, commit=commit)
+    wp_dir = repo_root / "workplans"
+    if not wp_dir.is_dir():
+        proj.records_source_present = False
+        return proj
+    for path in sorted(wp_dir.rglob("*.md")):
+        if path.name.startswith("."):
+            continue
+        try:
+            text = path.read_text(encoding="utf-8")
+        except (OSError, UnicodeDecodeError):
+            continue
+        meta, body = _split_frontmatter(text)
+        if str(meta.get("type") or "").strip() != "workplan":
+            continue
+        rid = str(meta.get("id") or "").strip()
+        if not rid:
+            continue
+        proj.workplans.append(
+            DerivedWorkplan(
+                record_id=rid,
+                uuid=derived_record_uuid(rid),
+                title=(str(meta["title"]).strip() if meta.get("title") else None),
+                status=(str(meta["status"]).strip() if meta.get("status") else None),
+                relative_path=str(path.relative_to(repo_root).as_posix()),
+                archived=path.parent.name == "archived",
+                owner=(str(meta["owner"]).strip() if meta.get("owner") else None),
+                description=(
+                    str(meta["description"]).strip()
+                    if meta.get("description")
+                    else _workplan_description(body)
+                ),
+                tasks=_parse_tasks(body, rid),
+            )
+        )
+    proj.workplans.sort(key=lambda w: w.record_id)
+    return proj
+
+
+def derive_from_forge(
+    repo_slug: str, *, forge_base: str = DEFAULT_FORGE_BASE, ref: str | None = None
+) -> DerivedProjection:
+    """Clone the repository's default branch from the forge and derive from it.
+
+    A fresh shallow clone every time, deliberately: the source is what the forge
+    holds now, and a reused working copy is how a projection ends up reflecting
+    someone's local state instead (ADR-012 context).
+    """
+    url = f"{forge_base.rstrip('/')}/{repo_slug}.git"
+    token = forge_read_token()
+    with tempfile.TemporaryDirectory(prefix=f"forge-{repo_slug}-") as tmp:
+        args = ["clone", "--depth", "1", "--quiet"]
+        if ref:
+            args += ["--branch", ref]
+        try:
+            _run_git(*args, url, tmp, token=token)
+        except subprocess.TimeoutExpired as exc:
+            raise ForgeDeriveError(f"clone timed out for {repo_slug}") from exc
+        except ForgeDeriveError as exc:
+            # Classify before propagating. A caller that cannot tell "not
+            # permitted" from "broken" will eventually treat one as the other.
+            if _is_unreadable(str(exc)):
+                raise ForgeUnreadableError(
+                    f"{repo_slug} could not be read from the forge: {exc}"
+                ) from exc
+            raise
+        commit = _run_git("rev-parse", "HEAD", cwd=tmp)
+        return derive_from_checkout(Path(tmp), repo_slug, commit)
+
+
+# ---------------------------------------------------------------------------
+# Comparison against what the hub currently holds (STATE-WP-0083-T02)
+# ---------------------------------------------------------------------------
+
+
+
+_ARCHIVE_PREFIX_RE = re.compile(r"^\d{6}-")
+
+
+def _path_key(path: str) -> str:
+    """Normalise a workplan path so an archived copy matches its live one."""
+    name = path.rsplit("/", 1)[-1]
+    return _ARCHIVE_PREFIX_RE.sub("", name).strip().lower()
+
+
+@dataclass
+class ProjectionDiff:
+    """What a reset would change, computed without changing anything.
+
+    This is what makes `ADR-012` decision 7's "verifiable" real: the reset can
+    always be inspected before it runs, and its result compared against the forge
+    afterwards.
+    """
+
+    repo_slug: str
+    commit: str
+    missing: list[dict[str, Any]] = field(default_factory=list)   # forge has, hub lacks
+    stale: list[dict[str, Any]] = field(default_factory=list)     # hub has, forge lacks
+    differing: list[dict[str, Any]] = field(default_factory=list) # both, fields differ
+    # More than one row/file claims one canonical identity. Choosing a winner
+    # would turn a diagnostic into an implicit identity decision.
+    ambiguous: list[dict[str, Any]] = field(default_factory=list)
+    # Set when the source could not support a claim of absence, so `stale` was
+    # deliberately left empty rather than computed (`STATE-WP-0084-T01`).
+    stale_withheld: str | None = None
+
+    @property
+    def clean(self) -> bool:
+        return not (self.missing or self.stale or self.differing or self.ambiguous)
+
+    @property
+    def would_remove(self) -> int:
+        return len(self.stale)
+
+    def to_dict(self) -> dict[str, Any]:
+        return {
+            "schema": "state-hub.projection-diff.v1",
+            "repo_slug": self.repo_slug,
+            "commit": self.commit,
+            "clean": self.clean,
+            "counts": {
+                "missing": len(self.missing),
+                "stale": len(self.stale),
+                "differing": len(self.differing),
+                "ambiguous": len(self.ambiguous),
+            },
+            "stale_withheld": self.stale_withheld,
+            "missing": self.missing,
+            "stale": self.stale,
+            "differing": self.differing,
+            "ambiguous": self.ambiguous,
+        }
+
+
+def _derived_identity_ambiguities(derived: DerivedProjection) -> list[dict[str, Any]]:
+    """Return duplicate canonical identities declared by one forge projection."""
+    workplans: dict[str, list[DerivedWorkplan]] = {}
+    tasks: dict[str, list[tuple[DerivedWorkplan, DerivedTask]]] = {}
+    for workplan in derived.workplans:
+        workplans.setdefault(workplan.record_id.strip().lower(), []).append(workplan)
+        for task in workplan.tasks:
+            tasks.setdefault(task.record_id.strip().lower(), []).append((workplan, task))
+
+    out: list[dict[str, Any]] = []
+    for rows in workplans.values():
+        if len(rows) > 1:
+            out.append(
+                {
+                    "kind": "workplan",
+                    "record_id": rows[0].record_id,
+                    "source": "forge",
+                    "paths": [row.relative_path for row in rows],
+                }
+            )
+    for rows in tasks.values():
+        if len(rows) > 1:
+            out.append(
+                {
+                    "kind": "task",
+                    "record_id": rows[0][1].record_id,
+                    "source": "forge",
+                    "workplans": [row[0].record_id for row in rows],
+                }
+            )
+    return out
+
+
+def diff_against_hub(
+    derived: DerivedProjection,
+    hub_workplans: list[dict[str, Any]],
+    hub_tasks_by_workplan: dict[str, list[dict[str, Any]]],
+) -> ProjectionDiff:
+    """Compare a derived projection with the hub's current records.
+
+    Pure: takes the hub's state as data rather than reading it, so the comparison
+    is testable without a database and cannot accidentally mutate anything.
+    """
+    d = ProjectionDiff(repo_slug=derived.repo_slug, commit=derived.commit)
+    d.ambiguous.extend(_derived_identity_ambiguities(derived))
+    if not derived.retirement_eligible:
+        # Compute what is missing and what differs as usual — those only ever
+        # add or correct. Absence is the one conclusion this source cannot
+        # support, so it is not drawn at all rather than drawn and then filtered.
+        d.stale_withheld = (
+            "the checkout has no workplans/ directory, so an absent record is "
+            "unexplained rather than evidence of removal"
+        )
+
+    # Match on canonical identity, never on UUID. Most hub records still carry
+    # pre-ADR-007 random identifiers, so a UUID-keyed comparison reports every
+    # record as simultaneously missing and stale — and a reset built on that
+    # would destroy and recreate the entire projection. The canonical record id
+    # is what is stable across the identifier migration; the backing file is the
+    # fallback when a hub slug was derived from a filename rather than an id.
+    def _wp_key(record_id: str | None, slug: str | None, path: str | None) -> str:
+        if record_id:
+            return record_id.strip().lower()
+        if path:
+            return _path_key(path)
+        return (slug or "").strip().lower()
+
+    want_wp = {w.record_id.strip().lower(): w for w in derived.workplans}
+    have_wp: dict[str, dict[str, Any]] = {}
+    want_paths = {_path_key(w.relative_path): k for k, w in want_wp.items()}
+    for w in hub_workplans:
+        slug = str(w.get("slug") or "")
+        key = slug.strip().lower()
+        if key not in want_wp:
+            # Slugs were not always the canonical id; fall back to the file.
+            bp = w.get("backing_relative_path")
+            if bp and _path_key(bp) in want_paths:
+                key = want_paths[_path_key(bp)]
+            else:
+                cand = [k for k in want_wp if slug.lower().startswith(k + "-")]
+                if len(cand) == 1:
+                    key = cand[0]
+        have_wp[key] = w
+
+    for key, w in want_wp.items():
+        if key not in have_wp:
+            d.missing.append({"kind": "workplan", "record_id": w.record_id, "uuid": w.uuid})
+    for key, w in have_wp.items():
+        if key not in want_wp:
+            if d.stale_withheld:
+                continue
+            uid = str(w["id"])
+            d.stale.append(
+                {
+                    "kind": "workplan",
+                    "uuid": uid,
+                    "slug": w.get("slug"),
+                    "status": w.get("status"),
+                    # A stale record with no backing file is the case that must
+                    # never be destroyed silently (ADR-012 decision 7).
+                    "has_backing_file": bool(
+                        w.get("backing_filename") or w.get("backing_relative_path")
+                    ),
+                }
+            )
+    for key, w in want_wp.items():
+        cur = have_wp.get(key)
+        uid = str(cur["id"]) if cur else w.uuid
+        if not cur:
+            continue
+        changed = {}
+        if (cur.get("status") or None) != (w.status or None):
+            changed["status"] = {"hub": cur.get("status"), "forge": w.status}
+        cur_path = cur.get("backing_relative_path") or None
+        if cur_path != w.relative_path:
+            changed["backing_relative_path"] = {"hub": cur_path, "forge": w.relative_path}
+        if changed:
+            d.differing.append(
+                {"kind": "workplan", "record_id": w.record_id, "uuid": uid, "changed": changed}
+            )
+
+    for w in derived.workplans:
+        hub_rows = hub_tasks_by_workplan.get(w.uuid, [])
+        if not hub_rows:
+            cur = have_wp.get(w.record_id.strip().lower())
+            if cur:
+                hub_rows = hub_tasks_by_workplan.get(str(cur["id"]), [])
+        # Match on the canonical record id where the hub has one. Rows created
+        # before STATE-WP-0083-T06 fall back to title, which is why those are
+        # reported rather than acted on: a renamed heading is indistinguishable
+        # from a replaced task under title matching.
+        def _task_key(record_id: str | None, title: str | None) -> str:
+            if record_id:
+                return record_id.strip().lower()
+            return "title:" + (title or "").strip().lower()
+
+        have_groups: dict[str, list[dict[str, Any]]] = {}
+        for task in hub_rows:
+            have_groups.setdefault(
+                _task_key(task.get("record_id"), task.get("title")), []
+            ).append(task)
+        for key, rows in have_groups.items():
+            if len(rows) > 1:
+                d.ambiguous.append(
+                    {
+                        "kind": "task",
+                        "record_id": rows[0].get("record_id"),
+                        "source": "hub",
+                        "workplan": w.record_id,
+                        "uuids": [str(row["id"]) for row in rows],
+                        "match_key": key,
+                    }
+                )
+        # Keep one representative so the rest of the diff remains useful, but
+        # `ambiguous` makes the result non-clean and forbids treating it as an
+        # actionable reset plan.
+        have = {key: rows[0] for key, rows in have_groups.items()}
+        want = {_task_key(t.record_id, t.title): t for t in w.tasks}
+        for key, t in want.items():
+            if key not in have:
+                d.missing.append(
+                    {"kind": "task", "record_id": t.record_id, "uuid": t.uuid,
+                     "workplan": w.record_id}
+                )
+        for key, t in have.items():
+            if key not in want:
+                if d.stale_withheld:
+                    continue
+                uid = str(t["id"])
+                d.stale.append(
+                    {"kind": "task", "uuid": uid, "title": t.get("title"),
+                     "status": t.get("status"), "workplan": w.record_id,
+                     "has_backing_file": False}
+                )
+        for key, t in want.items():
+            cur = have.get(key)
+            if cur and (cur.get("status") or None) != (t.status or None):
+                d.differing.append(
+                    {"kind": "task", "record_id": t.record_id, "uuid": t.uuid,
+                     "workplan": w.record_id,
+                     "changed": {"status": {"hub": cur.get("status"), "forge": t.status}}}
+                )
+    return d
+
+
+# ---------------------------------------------------------------------------
+# Applying the reset (STATE-WP-0083-T03)
+# ---------------------------------------------------------------------------
+
+
+@dataclass
+class ResetOutcome:
+    repo_slug: str
+    commit: str
+    status: str                      # applied | refused | noop | unreadable
+    created: list[str] = field(default_factory=list)
+    updated: list[str] = field(default_factory=list)
+    retired: list[str] = field(default_factory=list)
+    refused: list[dict[str, Any]] = field(default_factory=list)
+    # Identifiers freed from rows retired before retirement released them.
+    released: list[str] = field(default_factory=list)
+    created_tasks: list[str] = field(default_factory=list)
+    updated_tasks: list[str] = field(default_factory=list)
+    cancelled_tasks: list[str] = field(default_factory=list)
+    notes: list[str] = field(default_factory=list)
+
+    def to_dict(self) -> dict[str, Any]:
+        return {
+            "schema": "state-hub.projection-reset.v1",
+            "repo_slug": self.repo_slug,
+            "commit": self.commit,
+            "status": self.status,
+            "counts": {
+                "created": len(self.created),
+                "updated": len(self.updated),
+                "retired": len(self.retired),
+                "refused": len(self.refused),
+                "released": len(self.released),
+                "created_tasks": len(self.created_tasks),
+                "updated_tasks": len(self.updated_tasks),
+                "cancelled_tasks": len(self.cancelled_tasks),
+            },
+            "created": self.created,
+            "updated": self.updated,
+            "retired": self.retired,
+            "released": self.released,
+            "created_tasks": self.created_tasks,
+            "updated_tasks": self.updated_tasks,
+            "cancelled_tasks": self.cancelled_tasks,
+            "refused": self.refused,
+            "notes": self.notes,
+        }
+
+
+RETIRED_SLUG_MARK = "@retired-"
+
+
+def _tombstone_slug(slug: str, when: datetime) -> str:
+    """Release the identifier a retired row was holding.
+
+    `slug` is unique across the whole table, so retirement that only sets a
+    timestamp leaves the identifier locked to a record nothing derives any
+    more — and the repository that legitimately owns it can never claim it.
+    That is what kept repo-seed refused after core-hub's inherited REPO-WP rows
+    were retired.
+
+    The row, its UUID, and its progress events are untouched; only the
+    human-facing identifier is stamped, so history stays attached to the record
+    it happened under. Re-retiring an already-stamped row must not stack marks,
+    or the column overflows after a few passes.
+    """
+    base = (slug or "").split(RETIRED_SLUG_MARK)[0]
+    stamped = f"{base}{RETIRED_SLUG_MARK}{when:%Y%m%d}"
+    return stamped[:100]
+
+
+RETIRE_REASON = "no longer derived from the forge"
+
+
+def _coerce_task_status(raw: str | None) -> Any:
+    from api.models.task import TaskStatus
+
+    if not raw:
+        return None
+    try:
+        return TaskStatus(str(raw).strip().lower())
+    except ValueError:
+        return None
+
+
+def _task_status_value(status: Any) -> str:
+    return str(getattr(status, "value", status) or "")
+
+
+def _sync_existing_workplan_tasks(
+    session: Any,
+    row: Any,
+    derived_wp: DerivedWorkplan,
+    hub_tasks: list[Any],
+    outcome: ResetOutcome,
+) -> None:
+    """Match identified tasks of an existing workplan by record_id.
+
+    Rows with no ``record_id`` predate the backfill and cannot be qualified
+    from the file alone (CUST-WP-0068-T09). They are not cancelled or
+    overwritten.
+    """
+    from api.models.task import Task, TaskPriority, TaskStatus
+
+    want = {
+        t.record_id.strip().lower(): t
+        for t in derived_wp.tasks
+        if t.record_id and t.record_id.strip()
+    }
+    matched: dict[str, Any] = {}
+    claimed: set[str] = set()
+    stale: list[Any] = []
+    by_uuid = {str(ht.id): ht for ht in hub_tasks}
+    for ht in hub_tasks:
+        rid = (ht.record_id or "").strip().lower()
+        if rid and rid in want:
+            matched[rid] = ht
+            claimed.add(str(ht.id))
+        elif rid:
+            stale.append(ht)
+
+    for key, dt in want.items():
+        ht = matched.get(key)
+        if ht is None and dt.uuid in by_uuid:
+            # Already on the hub under the derived UUID, but record_id was never
+            # written (the registrar-minted case). Overwriting would collide.
+            ht = by_uuid[dt.uuid]
+            matched[key] = ht
+            claimed.add(str(ht.id))
+        if ht is None:
+            kwargs: dict[str, Any] = {
+                "id": uuid.UUID(dt.uuid),
+                "workplan_id": row.id,
+                "record_id": dt.record_id,
+                "title": (dt.title or dt.record_id),
+                "description": dt.description,
+                "needs_human": dt.needs_human,
+                "intervention_note": dt.intervention_note,
+                "blocking_reason": dt.blocking_reason,
+            }
+            st = _coerce_task_status(dt.status)
+            if st is not None:
+                kwargs["status"] = st
+            if dt.priority:
+                try:
+                    kwargs["priority"] = TaskPriority(dt.priority.strip().lower())
+                except ValueError:
+                    pass
+            session.add(Task(**kwargs))
+            outcome.created_tasks.append(dt.record_id)
+            continue
+        changed = False
+        if not (ht.record_id or "").strip():
+            ht.record_id = dt.record_id
+            changed = True
+        if dt.title and dt.title.strip() and ht.title != dt.title.strip():
+            ht.title = dt.title.strip()
+            changed = True
+        if getattr(ht, "description", None) != dt.description:
+            ht.description = dt.description
+            changed = True
+        st = _coerce_task_status(dt.status)
+        if st is not None and ht.status != st:
+            ht.status = st
+            changed = True
+        if getattr(ht, "needs_human", False) != dt.needs_human:
+            ht.needs_human = dt.needs_human
+            changed = True
+        if getattr(ht, "intervention_note", None) != dt.intervention_note:
+            ht.intervention_note = dt.intervention_note
+            changed = True
+        if getattr(ht, "blocking_reason", None) != dt.blocking_reason:
+            ht.blocking_reason = dt.blocking_reason
+            changed = True
+        if dt.priority:
+            try:
+                task_priority = TaskPriority(dt.priority.strip().lower())
+            except ValueError:
+                task_priority = None
+            if task_priority is not None and getattr(ht, "priority", None) != task_priority:
+                ht.priority = task_priority
+                changed = True
+        if changed:
+            outcome.updated_tasks.append(dt.record_id)
+
+    for ht in stale:
+        if _task_status_value(ht.status) in {"wait", "todo", "progress"}:
+            ht.status = TaskStatus.cancel
+            outcome.cancelled_tasks.append(ht.record_id or str(ht.id))
+
+
+async def reset_repository_projection(
+    session: Any,
+    repo_slug: str,
+    *,
+    acknowledge_retirements: bool = False,
+    forge_base: str = DEFAULT_FORGE_BASE,
+    derived: DerivedProjection | None = None,
+) -> ResetOutcome:
+    """Reconcile one repository's workplan projection against the forge.
+
+    Creates what the forge has and the hub lacks, updates what differs, and
+    retires what no longer derives. It does not delete: hub-native records
+    reference workplans with `ON DELETE RESTRICT`, and destroying a progress
+    event to tidy a derived projection would lose hub-native truth to fix a
+    derived-state problem (`ADR-012` decision 7 as amended).
+
+    Retirement is refused by default. A record that stops deriving may mean the
+    file was removed deliberately — or that someone pointed this at the wrong
+    branch. The caller must say which.
+
+    Scope: workplans, and their tasks. Tasks of existing workplans are matched
+    by ``record_id`` (STATE-WP-0083-T06); rows with no ``record_id`` are left
+    alone. A derived task the hub lacks is created; an identified hub task the
+    forge no longer derives is cancelled if it is still open.
+    """
+    from datetime import datetime, timezone
+
+    from sqlalchemy import select
+
+    from api.models.managed_repo import ManagedRepo
+    from api.models.task import Task
+    from api.models.workplan import Workplan
+
+    if derived is None:
+        try:
+            derived = derive_from_forge(repo_slug, forge_base=forge_base)
+        except ForgeUnreadableError as exc:
+            # Not an error: a statement about what central is permitted to see.
+            # Reported as its own status so a caller cannot mistake it for a
+            # repository whose records stopped deriving (`STATE-WP-0084-T01`).
+            out = ResetOutcome(repo_slug=repo_slug, commit="", status="unreadable")
+            out.refused.append(
+                {"reason": "repository could not be read from the forge", "slug": repo_slug,
+                 "detail": str(exc)[:300]}
+            )
+            out.notes.append(
+                "Nothing was changed and nothing was retired. This says nothing "
+                "about whether the repository's records still exist."
+            )
+            return out
+    outcome = ResetOutcome(repo_slug=repo_slug, commit=derived.commit, status="noop")
+
+    repo = (
+        await session.execute(select(ManagedRepo).where(ManagedRepo.slug == repo_slug))
+    ).scalar_one_or_none()
+    if repo is None:
+        outcome.status = "refused"
+        outcome.refused.append({"reason": "repository is not registered", "slug": repo_slug})
+        return outcome
+
+    source_ambiguities = _derived_identity_ambiguities(derived)
+    if source_ambiguities:
+        outcome.status = "refused"
+        for ambiguity in source_ambiguities:
+            outcome.refused.append(
+                {
+                    "reason": "forge projection contains duplicate canonical identity",
+                    **ambiguity,
+                }
+            )
+        outcome.notes.append(
+            "Duplicate identities in the authoritative projection require a file-level "
+            "decision; the reset will not choose a winner."
+        )
+        return outcome
+
+    rows = list(
+        (
+            await session.execute(select(Workplan).where(Workplan.repo_id == repo.id))
+        ).scalars()
+    )
+
+    want = {w.record_id.strip().lower(): w for w in derived.workplans}
+    want_paths = {_path_key(w.relative_path): k for k, w in want.items()}
+
+    # The derived UUID is the strongest key there is: if a row's id equals
+    # uuid5 of a wanted record's identifier, that row *is* that record, whatever
+    # its slug says. Checking it first is what stops a correct record with a
+    # legacy title slug — `testdrive-jsui-publication` for MARKITECT-WP-0002 —
+    # from being read as a re-key and proposed for retirement.
+    want_by_uuid = {w.uuid: k for k, w in want.items()}
+
+    # Release identifiers held by rows retired before retirement freed them.
+    # This runs ahead of every refusal path, because it completes a decision
+    # already taken rather than making a new one — gating it behind an unrelated
+    # pending decision left four identifiers locked in repositories refusing for
+    # reasons having nothing to do with them.
+    #
+    # A row the forge still derives is exempt: stamping it would change the slug
+    # out from under the matching below, so the record would fail to match its
+    # own file and never be un-retired.
+    for r in rows:
+        if r.projection_retired_at is None or RETIRED_SLUG_MARK in (r.slug or ""):
+            continue
+        if (r.slug or "").strip().lower() in want or str(r.id) in want_by_uuid:
+            continue
+        before = r.slug
+        r.slug = _tombstone_slug(r.slug or str(r.id), r.projection_retired_at)
+        outcome.released.append(before)
+
+    # How a row came to claim a key, strongest first. Two rows can claim the
+    # same record — `cust-wp-0010` by its own identifier and
+    # `workstream-lifecycle-documentation` by path, both pointing at
+    # CUST-WP-0010's file. Assigning into `matched` unconditionally let the
+    # later one win and dropped the other silently: never matched, so never
+    # stale, so never reported by any pass.
+    UUID_MATCH, SLUG_MATCH, PATH_MATCH, PREFIX_MATCH = 0, 1, 2, 3
+
+    matched: dict[str, Any] = {}
+    claim: dict[str, int] = {}
+    displaced: list[Any] = []
+
+    def _claim(key: str, row: Any, strength: int) -> None:
+        held = claim.get(key)
+        if held is None:
+            matched[key], claim[key] = row, strength
+            return
+        if strength < held:
+            # The new claim is stronger; the incumbent loses the record and
+            # becomes a retirement candidate rather than disappearing.
+            displaced.append(matched[key])
+            matched[key], claim[key] = row, strength
+        else:
+            displaced.append(row)
+
+    for row in rows:
+        key = (row.slug or "").strip().lower()
+        by_uuid = want_by_uuid.get(str(row.id))
+        if by_uuid is not None:
+            _claim(by_uuid, row, UUID_MATCH)
+            continue
+        if key in want:
+            # The identifier itself derives again — including for a retired row,
+            # which is then deliberately un-retired below.
+            _claim(key, row, SLUG_MATCH)
+            continue
+        if row.projection_retired_at is None and RETIRED_SLUG_MARK in (row.slug or ""):
+            # A stamped slug with a cleared flag is a resurrected row: the mark
+            # is evidence a retirement happened and the flag says it did not.
+            # It must land in `matched` under its own key so it shows up as
+            # stale — skipping it outright, as a genuinely retired row is
+            # skipped, is what left these reporting `noop` forever.
+            matched[key] = row
+            continue
+        if row.projection_retired_at is not None:
+            # Already retired: nothing to do, and nothing to re-decide.
+            #
+            # Past this point only the heuristics remain, and a retired row must
+            # not be matched by those. Retirement is a
+            # decision, and re-deriving the same file must not silently undo it.
+            #
+            # Releasing the identifier makes this necessary: the tombstoned slug
+            # is no longer an identifier and a legacy row is not UUID-derived, so
+            # both re-key guards fall through to path matching — which matches
+            # the file the row was retired *for* and resurrects it, alongside the
+            # correct record already created from that same file.
+            #
+            # A record that genuinely returns matches by UUID or by its own
+            # identifier above, and is un-retired there.
+            continue
+        if key not in want:
+            if _identity_is_derived(row) or _slug_is_identifier(row.slug or ""):
+                # ADR-007: a record identified by an identifier *is* that
+                # identifier. Two cases reach here — a derived (v5) row, and a
+                # legacy row whose slug is still a work-record identifier. Both
+                # are re-keys, not renames.
+                #
+                # ADR-007: a derived record's identity *is* a function of its
+                # identifier, so a changed identifier means a different record —
+                # the old one retires and the new one is created. Matching it to
+                # the file by path instead would update the row in place while
+                # its UUID still encodes the old identifier, leaving the file
+                # and the hub disagreeing about what the record is called.
+                #
+                # This is not hypothetical: the ad-hoc requalification
+                # (CUST-WP-0066) deliberately keeps the filename, so for those
+                # records a re-key *never* changes the path. Path matching
+                # cannot tell a re-key from a rename there, and silently chose
+                # rename for all 30 of them.
+                #
+                # The row keeps its own slug as key, so it lands in `stale` and
+                # becomes a retirement candidate rather than vanishing.
+                matched[key] = row
+                continue
+            bp = row.backing_relative_path
+            if bp and _path_key(bp) in want_paths:
+                _claim(want_paths[_path_key(bp)], row, PATH_MATCH)
+                continue
+            cand = [k for k in want if key.startswith(k + "-")]
+            if len(cand) == 1:
+                _claim(cand[0], row, PREFIX_MATCH)
+                continue
+        matched[key] = row
+
+    # An identifier this repository would create may already belong to another
+    # repository. Two repositories creating the same daily identifier on the
+    # same day is a documented case (CUST-WP-0066), and the derivation is
+    # deliberately deterministic, so the collision is real rather than
+    # incidental. Refuse and say so: a constraint violation is a stack trace,
+    # a refusal is something the caller can rule on.
+    creating = [w for k, w in want.items() if k not in matched]
+    if creating:
+        foreign = list(
+            (
+                await session.execute(
+                    select(Workplan).where(
+                        Workplan.id.in_([uuid.UUID(w.uuid) for w in creating]),
+                        Workplan.repo_id != repo.id,
+                    )
+                )
+            ).scalars()
+        )
+        # `slug` carries its own unique constraint across the whole table, so an
+        # identifier check alone is not enough: two repositories can derive
+        # different identifiers whose slugs still collide. Missing this is what
+        # left disaster-control raising IntegrityError after the identifier
+        # refusal was added.
+        slug_clash = list(
+            (
+                await session.execute(
+                    select(Workplan).where(
+                        Workplan.slug.in_([w.record_id.lower() for w in creating]),
+                        Workplan.repo_id != repo.id,
+                    )
+                )
+            ).scalars()
+        )
+        if slug_clash:
+            held = {(r.slug or "").lower(): r for r in slug_clash}
+            outcome.status = "refused"
+            for w in creating:
+                row = held.get(w.record_id.lower())
+                if row is None:
+                    continue
+                outcome.refused.append(
+                    {
+                        "reason": "slug already belongs to another repository",
+                        "record_id": w.record_id,
+                        "slug": w.record_id.lower(),
+                        "held_by_id": str(row.id),
+                    }
+                )
+            outcome.notes.append(
+                "Identifier collision is an identity decision, not a projection "
+                "one; acknowledging retirements does not authorise it."
+            )
+            return outcome
+
+        if foreign:
+            owned = {str(r.id): r for r in foreign}
+            outcome.status = "refused"
+            for w in creating:
+                held = owned.get(w.uuid)
+                if held is None:
+                    continue
+                outcome.refused.append(
+                    {
+                        "reason": "derived identifier already belongs to another repository",
+                        "record_id": w.record_id,
+                        "uuid": w.uuid,
+                        "held_by_slug": held.slug,
+                    }
+                )
+            outcome.notes.append(
+                "Identifier collision is an identity decision, not a projection "
+                "one; acknowledging retirements does not authorise it."
+            )
+            return outcome
+
+    stale = [
+        r for k, r in matched.items()
+        if k not in want and r.projection_retired_at is None
+    ] + [r for r in displaced if r.projection_retired_at is None]
+    if stale and not derived.retirement_eligible:
+        # Acknowledgement cannot authorise this. The caller is confirming that
+        # records which stopped deriving should be retired; here nothing has
+        # been shown to have stopped deriving, because the source produced no
+        # records to compare against. Consenting to a conclusion is not the
+        # same as the evidence for it existing.
+        outcome.status = "refused"
+        for r in stale:
+            outcome.refused.append(
+                {
+                    "reason": "source produced no records; absence is unexplained",
+                    "slug": r.slug,
+                    "status": r.status,
+                    "backing_relative_path": r.backing_relative_path,
+                }
+            )
+        outcome.notes.append(
+            "The checkout has no workplans/ directory. Retirement withheld "
+            "regardless of acknowledgement (STATE-WP-0084-T01)."
+        )
+        return outcome
+    if stale and not acknowledge_retirements:
+        outcome.status = "refused"
+        for r in stale:
+            outcome.refused.append(
+                {
+                    "reason": "would be retired; the forge no longer derives it",
+                    "slug": r.slug,
+                    "status": r.status,
+                    "backing_relative_path": r.backing_relative_path,
+                }
+            )
+        outcome.notes.append(
+            "Re-run with acknowledgement to retire these. Nothing was changed."
+        )
+        return outcome
+
+    now = datetime.now(tz=timezone.utc)
+
+    existing_ids = [matched[k].id for k, _w in want.items() if k in matched]
+    tasks_by_wp: dict[Any, list[Any]] = {}
+    if existing_ids:
+        loaded = list(
+            (
+                await session.execute(select(Task).where(Task.workplan_id.in_(existing_ids)))
+            ).scalars()
+        )
+        for task_row in loaded:
+            tasks_by_wp.setdefault(task_row.workplan_id, []).append(task_row)
+
+    # Canonical task identity is scoped to the matched current workplan while
+    # reconciling. Duplicate rows attached to a retired/displaced workplan are
+    # historical evidence and are deliberately not loaded above. Two rows with
+    # one identity inside the matched workplan, however, are genuinely
+    # ambiguous: the reset cannot know which row owns progress or dependencies.
+    current_task_ambiguities: list[dict[str, Any]] = []
+    for key, workplan in want.items():
+        row = matched.get(key)
+        if row is None:
+            continue
+        desired_record_ids = {
+            task.record_id.strip().lower() for task in workplan.tasks
+        }
+        groups: dict[str, list[Any]] = {}
+        for task_row in tasks_by_wp.get(row.id, []):
+            record_id = (task_row.record_id or "").strip().lower()
+            if record_id and record_id in desired_record_ids:
+                groups.setdefault(record_id, []).append(task_row)
+        for task_rows in groups.values():
+            if len(task_rows) > 1:
+                current_task_ambiguities.append(
+                    {
+                        "reason": "current workplan contains duplicate canonical task identity",
+                        "kind": "task",
+                        "record_id": task_rows[0].record_id,
+                        "workplan": workplan.record_id,
+                        "uuids": [str(task_row.id) for task_row in task_rows],
+                    }
+                )
+    if current_task_ambiguities:
+        outcome.status = "refused"
+        outcome.refused.extend(current_task_ambiguities)
+        outcome.notes.append(
+            "Retired workplan copies do not block reset, but duplicate identities "
+            "inside the matched current workplan require manual disposition."
+        )
+        return outcome
+
+    # Check every task the reset would create in one query. A derived UUID held
+    # by another workplan is a global identity collision. A repeated record_id
+    # on a different workplan is not sufficient by itself: terminal rows from
+    # older, wrong projections retain that label as history and tasks have no
+    # projection-retirement marker. Letting the INSERT discover a UUID collision
+    # would turn a deterministic refusal into an IntegrityError.
+    creating_tasks: dict[str, tuple[DerivedWorkplan, DerivedTask]] = {}
+    for key, workplan in want.items():
+        row = matched.get(key)
+        local_rows = tasks_by_wp.get(row.id, []) if row is not None else []
+        local_record_ids = {
+            (task_row.record_id or "").strip().lower()
+            for task_row in local_rows
+            if (task_row.record_id or "").strip()
+        }
+        local_uuids = {str(task_row.id) for task_row in local_rows}
+        for task in workplan.tasks:
+            if (
+                task.record_id.strip().lower() not in local_record_ids
+                and task.uuid not in local_uuids
+            ):
+                creating_tasks[task.uuid] = (workplan, task)
+
+    if creating_tasks:
+        current_holder_filters = [Workplan.projection_retired_at.is_(None)]
+        if stale:
+            # The caller has already acknowledged these retirements (the
+            # unacknowledged path returned above). Their tasks are preserved as
+            # history, but must not prevent the replacement projection from
+            # claiming its deterministic identities in the same transaction.
+            current_holder_filters.append(
+                Workplan.id.not_in([workplan.id for workplan in stale])
+            )
+        task_holders = list(
+            (
+                await session.execute(
+                    select(Task)
+                    .join(Workplan, Workplan.id == Task.workplan_id)
+                    .where(
+                        *current_holder_filters,
+                        Task.id.in_(
+                            [uuid.UUID(task_id) for task_id in creating_tasks]
+                        ),
+                    )
+                )
+            ).scalars()
+        )
+        if task_holders:
+            outcome.status = "refused"
+            for holder in task_holders:
+                workplan, task = creating_tasks[str(holder.id)]
+                outcome.refused.append(
+                    {
+                        "reason": "derived task identifier already belongs to another current workplan",
+                        "kind": "task",
+                        "record_id": task.record_id,
+                        "uuid": task.uuid,
+                        "workplan": workplan.record_id,
+                        "held_by_workplan_id": str(holder.workplan_id),
+                    }
+                )
+            outcome.notes.append(
+                "Task identity collisions require an identity decision; the reset "
+                "will not overwrite or move the existing row."
+            )
+            return outcome
+
+    for key, w in want.items():
+        row = matched.get(key)
+        if row is None:
+            row = Workplan(
+                id=uuid.UUID(w.uuid),
+                repo_id=repo.id,
+                topic_id=repo.topic_id,
+                slug=w.record_id.lower(),
+                title=w.title or w.record_id,
+                description=w.description,
+                status=w.status or "proposed",
+                owner=w.owner,
+                backing_filename=w.relative_path.rsplit("/", 1)[-1],
+                backing_relative_path=w.relative_path,
+                backing_archived=w.archived,
+                derived_from_commit=derived.commit,
+            )
+            session.add(row)
+            await session.flush()
+            for t in w.tasks:
+                # Safe only because nothing exists to mis-match against: this
+                # workplan is new to the hub.
+                session.add(
+                    Task(
+                        id=uuid.UUID(t.uuid),
+                        workplan_id=row.id,
+                        record_id=t.record_id,
+                        title=t.title or t.record_id,
+                        description=t.description,
+                        status=t.status or "todo",
+                        priority=t.priority or "medium",
+                        needs_human=t.needs_human,
+                        intervention_note=t.intervention_note,
+                        blocking_reason=t.blocking_reason,
+                    )
+                )
+            outcome.created.append(w.record_id)
+            continue
+
+        changed = False
+        # The title is derived like every other field, and not syncing it left
+        # `cust-wp-0010` reading "Domain and Repository Goals" while its file
+        # said "Workplan Lifecycle Documentation" — a record correctly
+        # identified and correctly backed, describing the wrong work.
+        #
+        # An empty derived title is not an answer: three activity-core files
+        # parse to no title at all, and blanking a real one is worse than
+        # leaving it stale.
+        if w.title and w.title.strip() and row.title != w.title.strip():
+            row.title = w.title.strip()
+            changed = True
+        if w.description and getattr(row, "description", None) != w.description:
+            row.description = w.description
+            changed = True
+        if getattr(row, "owner", None) != w.owner:
+            row.owner = w.owner
+            changed = True
+        if w.status and row.status != w.status:
+            row.status = w.status
+            changed = True
+        if row.backing_relative_path != w.relative_path:
+            row.backing_relative_path = w.relative_path
+            row.backing_filename = w.relative_path.rsplit("/", 1)[-1]
+            row.backing_archived = w.archived
+            changed = True
+        if row.projection_retired_at is not None:
+            # It derives again; un-retire rather than leaving a contradiction.
+            row.projection_retired_at = None
+            row.projection_retired_reason = None
+            changed = True
+        if row.derived_from_commit != derived.commit:
+            row.derived_from_commit = derived.commit
+            changed = True
+        if changed:
+            outcome.updated.append(w.record_id)
+        _sync_existing_workplan_tasks(
+            session, row, w, tasks_by_wp.get(row.id, []), outcome
+        )
+
+    for r in stale:
+        outcome.retired.append(r.slug or str(r.id))
+        r.projection_retired_at = now
+        r.projection_retired_reason = RETIRE_REASON
+        r.slug = _tombstone_slug(r.slug or str(r.id), now)
+
+    if (
+        outcome.created
+        or outcome.updated
+        or outcome.retired
+        or outcome.released
+        or outcome.created_tasks
+        or outcome.updated_tasks
+        or outcome.cancelled_tasks
+    ):
+        outcome.status = "applied"
+    return outcome
+
+
+# ---------------------------------------------------------------------------
+# Fleet form (STATE-WP-0083-T04)
+# ---------------------------------------------------------------------------
+
+
+@dataclass
+class FleetResetOutcome:
+    results: dict[str, dict[str, Any]] = field(default_factory=dict)
+    errors: dict[str, str] = field(default_factory=dict)
+    # Kept apart from `errors` on purpose. Nine repositories sitting in an error
+    # bucket read as nine broken repositories; they were nine we were not
+    # allowed to read, which is a different thing to go and fix
+    # (`STATE-WP-0083-T04`, 2026-08-26).
+    unreadable: dict[str, str] = field(default_factory=dict)
+
+    def to_dict(self) -> dict[str, Any]:
+        by_status: dict[str, int] = {}
+        for r in self.results.values():
+            by_status[r["status"]] = by_status.get(r["status"], 0) + 1
+        return {
+            "schema": "state-hub.fleet-projection-reset.v1",
+            "repositories": len(self.results) + len(self.errors) + len(self.unreadable),
+            "by_status": by_status,
+            "errored": len(self.errors),
+            "unreadable_count": len(self.unreadable),
+            "unreadable": self.unreadable,
+            "totals": {
+                k: sum(r["counts"][k] for r in self.results.values())
+                for k in ("created", "updated", "retired", "released", "refused")
+            },
+            "results": self.results,
+            "errors": self.errors,
+        }
+
+
+async def reset_fleet_projection(
+    session_factory: Any,
+    repo_slugs: list[str],
+    *,
+    acknowledge_retirements: bool = False,
+    forge_base: str = DEFAULT_FORGE_BASE,
+) -> FleetResetOutcome:
+    """Reset every repository, one at a time, sharing the per-repository path.
+
+    The fleet form is a loop over the repository form and nothing else
+    (`ADR-012` decision 7). The rarely-run wide operation must be the frequently
+    run narrow one, or the wide one is trusted on the strength of never having
+    been exercised.
+
+    A repository that refuses or errors is recorded and the pass continues.
+    Aborting on the first refusal would mean one unresolved repository blocks
+    reconstruction everywhere — which in practice means permanently.
+
+    Each repository gets its own session, so one failure cannot roll back
+    another's work or leave a poisoned transaction behind.
+    """
+    outcome = FleetResetOutcome()
+    for slug in repo_slugs:
+        try:
+            async with session_factory() as session:
+                result = await reset_repository_projection(
+                    session,
+                    slug,
+                    acknowledge_retirements=acknowledge_retirements,
+                    forge_base=forge_base,
+                )
+                # A released identifier is a repair that stands on its own, so
+                # it must survive a refusal in the same repository — otherwise
+                # moving the release ahead of the refusal returns achieves
+                # nothing and the rollback quietly undoes it.
+                if result.status == "applied" or result.released:
+                    await session.commit()
+                else:
+                    await session.rollback()
+                if result.status == "unreadable":
+                    detail = next(
+                        (r.get("detail", "") for r in result.refused), ""
+                    )
+                    outcome.unreadable[slug] = detail or "could not be read from the forge"
+                else:
+                    outcome.results[slug] = result.to_dict()
+        except ForgeUnreadableError as exc:
+            # Reachable when the caller supplied its own derivation path.
+            outcome.unreadable[slug] = str(exc)[:300]
+        except Exception as exc:  # noqa: BLE001 - one repo must not end the pass
+            outcome.errors[slug] = f"{type(exc).__name__}: {exc}"[:300]
+    return outcome
diff --git a/api/services/forge_repository.py b/api/services/forge_repository.py
new file mode 100644
index 0000000..1565cdb
--- /dev/null
+++ b/api/services/forge_repository.py
@@ -0,0 +1,215 @@
+"""Narrow Forgejo repository boundary used by repository rename operations.
+
+The lifecycle service depends on this protocol instead of calling Forgejo
+directly.  Tests replace it with an in-memory gateway, which makes interruption
+and resume tests deterministic and guarantees that API tests cannot rename a
+live repository.
+"""
+
+from __future__ import annotations
+
+import os
+from dataclasses import dataclass
+from pathlib import Path
+from typing import Protocol
+from urllib.parse import quote, urljoin
+
+import httpx
+
+from api.config import settings
+from api.services.forge_credential import forge_read_token
+
+
+WRITE_TOKEN_ENV = "FORGE_RENAME_TOKEN"
+WRITE_TOKEN_FILE_ENV = "FORGE_RENAME_TOKEN_FILE"
+
+
+class ForgeRepositoryError(RuntimeError):
+    pass
+
+
+class ForgeRepositoryUnreadable(ForgeRepositoryError):
+    pass
+
+
+class ForgeRepositoryRedirected(ForgeRepositoryUnreadable):
+    """Requested coordinate redirects; no credentials are forwarded."""
+
+    def __init__(self, source_url: str, location: str):
+        super().__init__("Forge repository coordinate redirects")
+        self.target_url = urljoin(source_url, location) if location else None
+
+
+class ForgeRepositoryConflict(ForgeRepositoryError):
+    pass
+
+
+@dataclass(frozen=True)
+class ForgeRepositorySnapshot:
+    repository_id: int
+    owner: str
+    name: str
+    full_name: str
+    default_branch: str
+    head_commit: str
+    clone_url: str | None
+    html_url: str | None
+    projection_readable: bool
+    projection_source_present: bool
+    projection_entry_count: int | None
+
+    def as_dict(self) -> dict:
+        return {
+            "repository_id": self.repository_id,
+            "owner": self.owner,
+            "name": self.name,
+            "full_name": self.full_name,
+            "default_branch": self.default_branch,
+            "head_commit": self.head_commit,
+            "clone_url": self.clone_url,
+            "html_url": self.html_url,
+            "projection_readable": self.projection_readable,
+            "projection_source_present": self.projection_source_present,
+            "projection_entry_count": self.projection_entry_count,
+        }
+
+
+class ForgeRepositoryGateway(Protocol):
+    async def inspect(
+        self, *, instance: str, owner: str, name: str
+    ) -> ForgeRepositorySnapshot | None: ...
+
+    async def rename(
+        self, *, instance: str, owner: str, old_name: str, new_name: str
+    ) -> ForgeRepositorySnapshot: ...
+
+
+def _write_token() -> str | None:
+    path = os.environ.get(WRITE_TOKEN_FILE_ENV)
+    if path:
+        try:
+            return Path(path).read_text(encoding="utf-8").strip() or None
+        except OSError:
+            return None
+    return (os.environ.get(WRITE_TOKEN_ENV) or "").strip() or None
+
+
+class ForgejoRepositoryGateway:
+    """Forgejo v1 API adapter with separate read and rename credentials."""
+
+    @staticmethod
+    def _headers(token: str | None) -> dict[str, str]:
+        return {"Authorization": f"token {token}"} if token else {}
+
+    @staticmethod
+    def _api(instance: str, owner: str, name: str) -> str:
+        base = instance.rstrip("/")
+        return f"{base}/api/v1/repos/{quote(owner, safe='')}/{quote(name, safe='')}"
+
+    async def _inspect_with_token(
+        self, *, instance: str, owner: str, name: str, token: str | None
+    ) -> ForgeRepositorySnapshot | None:
+        url = self._api(instance, owner, name)
+        timeout = settings.repository_rename_forge_timeout_seconds
+        try:
+            async with httpx.AsyncClient(timeout=timeout) as client:
+                response = await client.get(url, headers=self._headers(token))
+                if response.status_code in {301, 302, 303, 307, 308}:
+                    raise ForgeRepositoryRedirected(
+                        url, response.headers.get("location", "")
+                    )
+                if response.status_code == 404:
+                    if token is None:
+                        raise ForgeRepositoryUnreadable(
+                            "Forge returned not-found without an authenticated absence proof"
+                        )
+                    return None
+                response.raise_for_status()
+                repo = response.json()
+                branch_name = str(repo.get("default_branch") or "")
+                if not branch_name:
+                    raise ForgeRepositoryUnreadable("Forge repository has no default branch")
+                branch = await client.get(
+                    f"{url}/branches/{quote(branch_name, safe='')}",
+                    headers=self._headers(token),
+                )
+                branch.raise_for_status()
+                branch_data = branch.json()
+                commit = branch_data.get("commit") or {}
+                head = str(commit.get("id") or commit.get("sha") or "")
+                if not head:
+                    raise ForgeRepositoryUnreadable("Forge default branch has no readable head")
+                projection = await client.get(
+                    f"{url}/contents/workplans",
+                    params={"ref": head},
+                    headers=self._headers(token),
+                )
+                source_present = projection.status_code == 200
+                if projection.status_code not in {200, 404}:
+                    projection.raise_for_status()
+                entries = projection.json() if source_present else None
+        except ForgeRepositoryError:
+            raise
+        except (httpx.HTTPError, ValueError, KeyError) as exc:
+            raise ForgeRepositoryUnreadable(
+                f"Forge repository inspection failed ({type(exc).__name__})"
+            ) from exc
+        return ForgeRepositorySnapshot(
+            repository_id=int(repo["id"]),
+            owner=str((repo.get("owner") or {}).get("login") or owner),
+            name=str(repo["name"]),
+            full_name=str(repo.get("full_name") or f"{owner}/{name}"),
+            default_branch=branch_name,
+            head_commit=head,
+            clone_url=repo.get("clone_url"),
+            html_url=repo.get("html_url"),
+            projection_readable=True,
+            projection_source_present=source_present,
+            projection_entry_count=(len(entries) if isinstance(entries, list) else None),
+        )
+
+    async def inspect(
+        self, *, instance: str, owner: str, name: str
+    ) -> ForgeRepositorySnapshot | None:
+        return await self._inspect_with_token(
+            instance=instance, owner=owner, name=name, token=forge_read_token()
+        )
+
+    async def rename(
+        self, *, instance: str, owner: str, old_name: str, new_name: str
+    ) -> ForgeRepositorySnapshot:
+        token = _write_token()
+        if not token:
+            raise ForgeRepositoryUnreadable("Forge rename credential is unavailable")
+        url = self._api(instance, owner, old_name)
+        try:
+            async with httpx.AsyncClient(
+                timeout=settings.repository_rename_forge_timeout_seconds
+            ) as client:
+                response = await client.patch(
+                    url,
+                    json={"name": new_name},
+                    headers=self._headers(token),
+                )
+                if response.status_code in {409, 422}:
+                    raise ForgeRepositoryConflict("Forge rejected the target repository name")
+                response.raise_for_status()
+        except ForgeRepositoryError:
+            raise
+        except httpx.HTTPError as exc:
+            raise ForgeRepositoryUnreadable(
+                f"Forge repository rename failed ({type(exc).__name__})"
+            ) from exc
+        renamed = await self._inspect_with_token(
+            instance=instance, owner=owner, name=new_name, token=token
+        )
+        if renamed is None:
+            raise ForgeRepositoryUnreadable("Renamed Forge repository is not readable")
+        return renamed
+
+
+_gateway = ForgejoRepositoryGateway()
+
+
+def get_forge_repository_gateway() -> ForgeRepositoryGateway:
+    return _gateway
diff --git a/api/services/legacy_meter.py b/api/services/legacy_meter.py
index 5528443..de8f1bd 100644
--- a/api/services/legacy_meter.py
+++ b/api/services/legacy_meter.py
@@ -305,7 +305,13 @@ def _summarize_interface(
     ]
     window = _counters(window_buckets)
     last_seen = max((bucket.last_seen_at for bucket in buckets), default=None)
-    retirement_candidate, reason = _retirement_state(interface, window.calls)
+    retirement_candidate, reason = _retirement_state(
+        interface,
+        window.calls,
+        all_time_calls=all_time.calls,
+        last_seen_at=last_seen,
+        window_end=window_end,
+    )
     return LegacyInterfaceSummary(
         interface=LegacyInterfaceRead.model_validate(interface),
         all_time=all_time,
@@ -340,7 +346,34 @@ def _bucket_counts(buckets: list[LegacyInterfaceUsageBucket], bucket_kind: str)
     return counts
 
 
-def _retirement_state(interface: LegacyInterface, window_calls: int) -> tuple[bool, str]:
+# Minimum quiet period before an interface may be retired, scaled to how much
+# traffic it ever carried. A review window only proves the interface was silent
+# for that window; for a high-volume interface that is weak evidence, since a
+# monthly or quarterly caller can easily fall outside it. Thresholds are
+# (all-time calls, minimum days since last_seen_at).
+RETIREMENT_QUIET_LADDER: tuple[tuple[int, int], ...] = (
+    (10_000, 60),
+    (100, 30),
+    (1, 7),
+)
+
+
+def _required_quiet_days(all_time_calls: int) -> int:
+    """Days of silence required before retirement, by all-time call volume."""
+    for threshold, days in RETIREMENT_QUIET_LADDER:
+        if all_time_calls >= threshold:
+            return days
+    return 0
+
+
+def _retirement_state(
+    interface: LegacyInterface,
+    window_calls: int,
+    *,
+    all_time_calls: int = 0,
+    last_seen_at: datetime | None = None,
+    window_end: datetime | None = None,
+) -> tuple[bool, str]:
     if interface.status == "retired":
         return False, "already retired"
     if interface.manual_hold:
@@ -351,6 +384,19 @@ def _retirement_state(interface: LegacyInterface, window_calls: int) -> tuple[bo
         return False, "replacement not verified"
     if window_calls > 0:
         return False, f"{window_calls} call(s) in review window"
+
+    required_days = _required_quiet_days(all_time_calls)
+    if required_days and last_seen_at is not None and window_end is not None:
+        quiet_days = (window_end - _ensure_datetime(last_seen_at)).days
+        if quiet_days < required_days:
+            return False, (
+                f"quiet {quiet_days}d of {required_days}d required "
+                f"for {all_time_calls} all-time call(s)"
+            )
+        return True, (
+            f"no usage in review window; quiet {quiet_days}d "
+            f"(>= {required_days}d required for {all_time_calls} all-time call(s))"
+        )
     return True, "no measured usage in review window"
 
 
diff --git a/api/services/ops_run_projection.py b/api/services/ops_run_projection.py
new file mode 100644
index 0000000..5632aa6
--- /dev/null
+++ b/api/services/ops_run_projection.py
@@ -0,0 +1,130 @@
+"""Read-only activity-core ops_run projection (STATE-WP-0078)."""
+
+from __future__ import annotations
+
+import asyncio
+import time
+from datetime import datetime, timedelta, timezone
+from typing import Any
+
+import httpx
+
+from api.config import settings
+from api.schemas.ops_run import OpsRunProjection, OpsRunProjectionItem
+
+
+_cache: OpsRunProjection | None = None
+_cache_at: float = 0.0
+_lock = asyncio.Lock()
+
+
+def reset_ops_run_projection_cache() -> None:
+    global _cache, _cache_at
+    _cache = None
+    _cache_at = 0.0
+
+
+def _parse_datetime(value: Any) -> datetime | None:
+    if not value or not isinstance(value, str):
+        return None
+    try:
+        parsed = datetime.fromisoformat(value.replace("Z", "+00:00"))
+    except ValueError:
+        return None
+    return parsed if parsed.tzinfo else parsed.replace(tzinfo=timezone.utc)
+
+
+async def _fetch_ops_runs() -> dict[str, Any]:
+    if not settings.activity_core_url:
+        raise RuntimeError("ACTIVITY_CORE_URL is not configured")
+    headers = {}
+    if settings.activity_core_worker_token:
+        headers["X-Worker-Token"] = settings.activity_core_worker_token
+    async with httpx.AsyncClient(
+        base_url=settings.activity_core_url.rstrip("/"),
+        timeout=10.0,
+        follow_redirects=True,
+        trust_env=False,
+        headers=headers,
+    ) as client:
+        response = await client.get("/ops-runs", params={"limit": 200})
+        response.raise_for_status()
+        return response.json()
+
+
+def _project(payload: dict[str, Any], now: datetime) -> OpsRunProjection:
+    raw_items = payload.get("items") or []
+    counts = payload.get("counts") or {}
+    failed_cutoff = now - timedelta(hours=24)
+    stuck_cutoff = now - timedelta(hours=max(0.1, settings.ops_run_sla_hours))
+    failed_24h = 0
+    stuck = 0
+    items: list[OpsRunProjectionItem] = []
+
+    for raw in raw_items:
+        state = str(raw.get("state") or "unknown")
+        updated_at = _parse_datetime(raw.get("updated_at"))
+        created_at = _parse_datetime(raw.get("created_at"))
+        if state == "failed" and updated_at and updated_at >= failed_cutoff:
+            failed_24h += 1
+        if state in {"open", "claimed"} and (created_at or updated_at):
+            if (created_at or updated_at) < stuck_cutoff:
+                stuck += 1
+
+        result = raw.get("result") if isinstance(raw.get("result"), dict) else {}
+        last_error = result.get("error") or raw.get("last_error")
+        if state in {"open", "claimed", "failed"}:
+            items.append(OpsRunProjectionItem(
+                id=str(raw.get("id")),
+                definition=str(raw.get("activity_definition_id")) if raw.get("activity_definition_id") else None,
+                target_repo=raw.get("target_repo"),
+                state=state,
+                lease={
+                    "owner": raw.get("claim_owner"),
+                    "until": raw.get("lease_until"),
+                    "attempt": raw.get("attempt", 0),
+                } if raw.get("claim_owner") or raw.get("lease_until") else None,
+                updated_at=updated_at,
+                last_error=str(last_error) if last_error else None,
+            ))
+
+    items.sort(key=lambda item: item.updated_at or datetime.min.replace(tzinfo=timezone.utc), reverse=True)
+    return OpsRunProjection(
+        available=True,
+        generated_at=now,
+        open=int(counts.get("open", sum(item.state == "open" for item in items))),
+        claimed=int(counts.get("claimed", sum(item.state == "claimed" for item in items))),
+        failed_24h=failed_24h,
+        stuck_open_or_claimed=stuck,
+        items=items[:50],
+    )
+
+
+async def get_ops_run_projection(*, refresh: bool = False) -> OpsRunProjection:
+    global _cache, _cache_at
+    now_mono = time.monotonic()
+    ttl = max(1.0, settings.ops_run_projection_ttl_seconds)
+    if not refresh and _cache is not None and now_mono - _cache_at < ttl:
+        return _cache
+
+    async with _lock:
+        now_mono = time.monotonic()
+        if not refresh and _cache is not None and now_mono - _cache_at < ttl:
+            return _cache
+        now = datetime.now(timezone.utc)
+        try:
+            projection = _project(await _fetch_ops_runs(), now)
+        except Exception as exc:
+            if _cache is not None and _cache.available:
+                projection = _cache.model_copy(update={
+                    "stale": True,
+                    "error": f"activity-core refresh failed: {exc}",
+                })
+            else:
+                projection = OpsRunProjection(
+                    generated_at=now,
+                    error=f"activity-core unavailable: {exc}",
+                )
+        _cache = projection
+        _cache_at = now_mono
+        return projection
diff --git a/api/services/repo_manager_dual_run.py b/api/services/repo_manager_dual_run.py
new file mode 100644
index 0000000..4cc98f2
--- /dev/null
+++ b/api/services/repo_manager_dual_run.py
@@ -0,0 +1,544 @@
+"""State Hub dual-run adapter → Repo Manager (RMGR-WP-0002/0003 Stage B).
+
+Config file (same as repo-manager): ~/.repo-manager/dual-run.yaml
+or RM_DUAL_RUN_CONFIG. Env overrides when set:
+
+  RM_WRITEBACK, RM_RECONCILE, RM_WRITEBACK_PUSH, RM_PILOT_REPOS, RM_METER_PATH
+
+Rollback: disable in config / unset env → native State Hub path.
+"""
+
+from __future__ import annotations
+
+import json
+import logging
+import os
+import subprocess
+import sys
+import uuid
+from functools import lru_cache
+from pathlib import Path
+from typing import Any
+
+import yaml
+
+logger = logging.getLogger(__name__)
+
+_TRUE = frozenset({"1", "true", "yes", "on"})
+_FALSE = frozenset({"0", "false", "no", "off"})
+
+
+def config_path() -> Path:
+    raw = os.environ.get("RM_DUAL_RUN_CONFIG", "~/.repo-manager/dual-run.yaml")
+    return Path(raw).expanduser()
+
+
+@lru_cache(maxsize=1)
+def _load_file_config() -> dict[str, Any]:
+    path = config_path()
+    if not path.is_file():
+        return {}
+    try:
+        data = yaml.safe_load(path.read_text(encoding="utf-8")) or {}
+    except (OSError, yaml.YAMLError):
+        return {}
+    return data if isinstance(data, dict) else {}
+
+
+def reload_config() -> None:
+    _load_file_config.cache_clear()
+
+
+def _env_bool(name: str) -> bool | None:
+    raw = os.environ.get(name)
+    if raw is None or raw.strip() == "":
+        return None
+    v = raw.strip().lower()
+    if v in _TRUE:
+        return True
+    if v in _FALSE:
+        return False
+    return None
+
+
+def _cfg_bool(key: str, env_name: str, default: bool = False) -> bool:
+    ev = _env_bool(env_name)
+    if ev is not None:
+        return ev
+    cfg = _load_file_config()
+    if key in cfg:
+        val = cfg[key]
+        if isinstance(val, bool):
+            return val
+        if isinstance(val, str):
+            return val.strip().lower() in _TRUE
+    return default
+
+
+def writeback_enabled() -> bool:
+    return _cfg_bool("writeback", "RM_WRITEBACK", False)
+
+
+def reconcile_enabled() -> bool:
+    return _cfg_bool("reconcile", "RM_RECONCILE", False)
+
+
+def writeback_push_enabled() -> bool:
+    return _cfg_bool("writeback_push", "RM_WRITEBACK_PUSH", False)
+
+
+def pilot_slugs() -> set[str] | None:
+    raw = os.environ.get("RM_PILOT_REPOS")
+    if raw is not None:
+        raw = raw.strip()
+        if not raw:
+            return set()
+        return {s.strip() for s in raw.split(",") if s.strip()}
+    cfg = _load_file_config()
+    if "pilot_repos" not in cfg:
+        return None
+    val = cfg["pilot_repos"]
+    if val is None:
+        return None
+    if isinstance(val, str):
+        if not val.strip():
+            return set()
+        return {s.strip() for s in val.split(",") if s.strip()}
+    if isinstance(val, list):
+        return {str(s).strip() for s in val if str(s).strip()}
+    return None
+
+
+def slug_allowed(slug: str | None) -> bool:
+    if not slug:
+        return False
+    pilots = pilot_slugs()
+    if pilots is None:
+        return True
+    return slug in pilots
+
+
+def writeback_for_repo(slug: str | None) -> bool:
+    return writeback_enabled() and slug_allowed(slug)
+
+
+def reconcile_for_repo(slug: str | None) -> bool:
+    return reconcile_enabled() and slug_allowed(slug)
+
+
+def meter_path() -> Path:
+    raw = os.environ.get("RM_METER_PATH")
+    if raw:
+        return Path(raw).expanduser()
+    cfg = _load_file_config()
+    if cfg.get("meter_path"):
+        return Path(str(cfg["meter_path"])).expanduser()
+    return Path("~/.repo-manager/mutation-meter.jsonl").expanduser()
+
+
+def record_mutation(
+    *,
+    source: str,
+    kind: str,
+    repo_slug: str | None,
+    detail: dict[str, Any] | None = None,
+) -> None:
+    try:
+        from datetime import UTC, datetime
+
+        path = meter_path()
+        path.parent.mkdir(parents=True, exist_ok=True)
+        row = {
+            "ts": datetime.now(UTC).isoformat().replace("+00:00", "Z"),
+            "source": source,
+            "kind": kind,
+            "repo_slug": repo_slug,
+            "detail": detail or {},
+        }
+        with path.open("a", encoding="utf-8") as fh:
+            fh.write(json.dumps(row, default=str) + "\n")
+    except OSError:
+        pass
+
+
+def run_rmgr(args: list[str], *, timeout: int = 120) -> tuple[int, str, str]:
+    env = os.environ.copy()
+    custom = os.environ.get("RMGR_BIN", "").strip()
+    if custom:
+        cmd = custom.split() + args
+    else:
+        src = os.environ.get("REPO_MANAGER_SRC", "").strip()
+        sibling = Path(src) if src else (Path.home() / "repo-manager" / "src")
+        if not sibling.is_dir() and (Path.home() / "repo-manager" / "src").is_dir():
+            sibling = Path.home() / "repo-manager" / "src"
+        if sibling.is_dir():
+            env["PYTHONPATH"] = str(sibling) + (
+                os.pathsep + env["PYTHONPATH"] if env.get("PYTHONPATH") else ""
+            )
+            cmd = [
+                sys.executable,
+                "-c",
+                "from repo_manager.cli import main; import sys; raise SystemExit(main(sys.argv[1:]))",
+                *args,
+            ]
+        else:
+            cmd = ["rmgr", *args]
+
+    proc = subprocess.run(
+        cmd,
+        capture_output=True,
+        text=True,
+        timeout=timeout,
+        check=False,
+        env=env,
+    )
+    return proc.returncode, proc.stdout, proc.stderr
+
+
+def rm_update_task_status(
+    *,
+    repo_path: str | Path,
+    task_id: str,
+    status: str,
+    repo_slug: str | None = None,
+    reason: str = "state-hub dual-run",
+    push: bool | None = None,
+    correlation_id: str | None = None,
+) -> dict[str, Any]:
+    correlation_id = correlation_id or str(uuid.uuid4())
+    if push is None:
+        push = writeback_push_enabled()
+    args = [
+        "update-task-status",
+        "--path",
+        str(repo_path),
+        "--task-id",
+        str(task_id),
+        "--status",
+        status,
+        "--reason",
+        reason,
+        "--correlation-id",
+        correlation_id,
+        "--idempotency-key",
+        f"sh-dual-{task_id}-{status}-{correlation_id}",
+    ]
+    if repo_slug:
+        args.extend(["--slug", repo_slug])
+    if push:
+        args.append("--push")
+
+    code, out, err = run_rmgr(args)
+    try:
+        result = json.loads(out.strip() or "{}")
+    except json.JSONDecodeError:
+        result = {
+            "status": "failed",
+            "error": {
+                "code": "internal",
+                "message": f"rmgr non-json exit={code} stderr={err!r} stdout={out[:500]!r}",
+            },
+            "correlation_id": correlation_id,
+        }
+    if code != 0 and result.get("status") not in ("applied", "rejected"):
+        result.setdefault("status", "failed")
+        result.setdefault(
+            "error",
+            {"code": "internal", "message": f"rmgr exit={code} stderr={err!r}"},
+        )
+    return result
+
+
+def rm_update_workplan(
+    *,
+    repo_path: str | Path,
+    workplan_id: str,
+    operation: str = "update",
+    title: str | None = None,
+    goal: str | None = None,
+    status: str | None = None,
+    owner: str | None = None,
+    domain: str | None = None,
+    topic_slug: str | None = None,
+    repo_slug: str | None = None,
+    reason: str = "state-hub dual-run",
+    push: bool | None = None,
+    correlation_id: str | None = None,
+    confirm_archive: bool = False,
+) -> dict[str, Any]:
+    """Delegate a file-backed workplan mutation to Repo Manager.
+
+    ``operation=archive`` is the recoverable counterpart of State Hub's
+    DELETE workplan route; it never erases repository history.
+    """
+    correlation_id = correlation_id or str(uuid.uuid4())
+    if operation not in {"create", "update", "archive"}:
+        return {
+            "status": "rejected",
+            "correlation_id": correlation_id,
+            "error": {"code": "validation_error", "message": f"invalid operation {operation!r}"},
+        }
+    if push is None:
+        push = writeback_push_enabled()
+    cli_operation = "delete" if operation == "archive" else operation
+    args = [
+        "workplan",
+        cli_operation,
+        "--path",
+        str(repo_path),
+        "--workplan-id",
+        str(workplan_id),
+        "--reason",
+        reason,
+        "--correlation-id",
+        correlation_id,
+        "--idempotency-key",
+        f"sh-dual-workplan-{operation}-{workplan_id}-{correlation_id}",
+    ]
+    for flag, value in (
+        ("--title", title),
+        ("--goal", goal),
+        ("--status", status),
+        ("--owner", owner),
+        ("--domain", domain),
+        ("--topic-slug", topic_slug),
+        ("--slug", repo_slug),
+    ):
+        if value is not None:
+            args.extend([flag, value])
+    if operation == "archive" and confirm_archive:
+        args.append("--confirm")
+    if push:
+        args.append("--push")
+
+    code, out, err = run_rmgr(args)
+    try:
+        result = json.loads(out.strip() or "{}")
+    except json.JSONDecodeError:
+        result = {
+            "status": "failed",
+            "error": {
+                "code": "internal",
+                "message": f"rmgr non-json exit={code} stderr={err!r} stdout={out[:500]!r}",
+            },
+            "correlation_id": correlation_id,
+        }
+    if code != 0 and result.get("status") not in ("applied", "rejected"):
+        result.setdefault("status", "failed")
+        result.setdefault(
+            "error",
+            {"code": "internal", "message": f"rmgr exit={code} stderr={err!r}"},
+        )
+    return result
+
+
+def rm_update_register_entry(
+    *,
+    repo_path: str | Path,
+    kind: str,
+    entry_id: str,
+    operation: str = "put",
+    title: str | None = None,
+    status: str | None = None,
+    data: dict[str, Any] | None = None,
+    note: str | None = None,
+    author: str | None = None,
+    repo_slug: str | None = None,
+    reason: str = "state-hub retirement adapter",
+    push: bool | None = None,
+    correlation_id: str | None = None,
+) -> dict[str, Any]:
+    """Delegate register create/update/defer/note to Repo Manager."""
+    correlation_id = correlation_id or str(uuid.uuid4())
+    if operation not in {"put", "defer", "note"}:
+        return {
+            "status": "rejected",
+            "correlation_id": correlation_id,
+            "error": {"code": "validation_error", "message": f"invalid operation {operation!r}"},
+        }
+    if push is None:
+        push = writeback_push_enabled()
+    args = [
+        "register",
+        operation,
+        "--path",
+        str(repo_path),
+        "--kind",
+        kind,
+        "--entry-id",
+        entry_id,
+        "--reason",
+        reason,
+        "--correlation-id",
+        correlation_id,
+        "--idempotency-key",
+        f"sh-dual-register-{operation}-{kind}-{entry_id}-{correlation_id}",
+    ]
+    for flag, value in (
+        ("--title", title),
+        ("--status", status),
+        ("--note", note),
+        ("--author", author),
+        ("--slug", repo_slug),
+    ):
+        if value is not None:
+            args.extend([flag, value])
+    if data is not None:
+        args.extend(["--data-json", json.dumps(data, separators=(",", ":"))])
+    if push:
+        args.append("--push")
+
+    code, out, err = run_rmgr(args)
+    try:
+        result = json.loads(out.strip() or "{}")
+    except json.JSONDecodeError:
+        result = {
+            "status": "failed",
+            "error": {
+                "code": "internal",
+                "message": f"rmgr non-json exit={code} stderr={err!r} stdout={out[:500]!r}",
+            },
+            "correlation_id": correlation_id,
+        }
+    if code != 0 and result.get("status") not in ("applied", "rejected"):
+        result.setdefault("status", "failed")
+        result.setdefault(
+            "error",
+            {"code": "internal", "message": f"rmgr exit={code} stderr={err!r}"},
+        )
+    return result
+
+
+def rm_scan_sbom(
+    *,
+    repo_path: str | Path,
+    repo_slug: str | None = None,
+) -> dict[str, Any]:
+    """Derive a versioned SBOM snapshot from repository-owned sources."""
+    args = ["sbom", "scan", "--path", str(repo_path)]
+    if repo_slug:
+        args.extend(["--slug", repo_slug])
+
+    code, out, err = run_rmgr(args)
+    try:
+        result = json.loads(out.strip() or "{}")
+    except json.JSONDecodeError:
+        result = {
+            "ok": False,
+            "error": f"rmgr non-json exit={code} stderr={err!r} stdout={out[:500]!r}",
+        }
+    if code != 0:
+        result.setdefault("ok", False)
+        result.setdefault("error", f"rmgr exit={code} stderr={err!r}")
+    result["exit_code"] = code
+    return result
+
+
+def rm_scaffold(
+    *,
+    repo_path: str | Path,
+    flavor: str,
+    wp_prefix: str | None = None,
+    slug: str | None = None,
+    domain: str = "infotech",
+    force: bool = False,
+    commit: bool = False,
+) -> dict[str, Any]:
+    """Delegate repository scaffolding to ``rmgr scaffold`` (STATE-WP-0080-T02)."""
+    args = [
+        "scaffold",
+        "--path",
+        str(repo_path),
+        "--flavor",
+        flavor,
+        "--domain",
+        domain,
+    ]
+    if slug:
+        args.extend(["--slug", slug])
+    if wp_prefix:
+        args.extend(["--wp-prefix", wp_prefix])
+    if force:
+        args.append("--force")
+    if not commit:
+        args.append("--no-commit")
+    code, out, err = run_rmgr(args)
+    try:
+        result = json.loads(out.strip() or "{}")
+    except json.JSONDecodeError:
+        result = {
+            "status": "failed",
+            "error": {
+                "code": "internal",
+                "message": f"rmgr non-json exit={code} stderr={err!r} stdout={out[:500]!r}",
+            },
+        }
+    if code != 0 and result.get("status") not in ("applied", "rejected"):
+        result.setdefault("status", "failed")
+        result.setdefault(
+            "error",
+            {"code": "internal", "message": f"rmgr exit={code} stderr={err!r}"},
+        )
+    result["exit_code"] = code
+    return result
+
+
+def rm_reconcile(*, repo_path: str | Path, repo_slug: str | None = None) -> dict[str, Any]:
+    args = ["reconcile", "--path", str(repo_path)]
+    if repo_slug:
+        args.extend(["--slug", repo_slug])
+    code, out, err = run_rmgr(args)
+    try:
+        result = json.loads(out.strip() or "{}")
+    except json.JSONDecodeError:
+        result = {"ok": False, "error": err or out, "exit_code": code}
+    result["exit_code"] = code
+    return result
+
+
+def try_writeback_for_task(
+    *,
+    repo_path: str | Path | None,
+    repo_slug: str | None,
+    task_id: str,
+    status: str,
+    reason: str = "state-hub dual-run PATCH /tasks",
+) -> dict[str, Any] | None:
+    if not writeback_for_repo(repo_slug):
+        return None
+    if not repo_path:
+        logger.warning("RM dual-run writeback skipped: no repo_path for %s", repo_slug)
+        return None
+    path = Path(repo_path)
+    if not path.is_dir():
+        logger.warning("RM dual-run writeback skipped: missing path %s", path)
+        return None
+
+    result = rm_update_task_status(
+        repo_path=path,
+        task_id=task_id,
+        status=status,
+        repo_slug=repo_slug,
+        reason=reason,
+        push=writeback_push_enabled(),
+    )
+    if result.get("status") == "applied":
+        record_mutation(
+            source="repo-manager",
+            kind="task_status_writeback_via_sh_facade",
+            repo_slug=repo_slug,
+            detail={
+                "task_id": task_id,
+                "status": status,
+                "git_sha": (result.get("evidence") or {}).get("git_sha"),
+                "push_ok": (result.get("evidence") or {}).get("push_ok"),
+            },
+        )
+    else:
+        logger.warning(
+            "RM dual-run writeback failed for %s task=%s: %s",
+            repo_slug,
+            task_id,
+            result.get("error") or result,
+        )
+    return result
diff --git a/api/services/repository_aliases.py b/api/services/repository_aliases.py
new file mode 100644
index 0000000..a0e6e2d
--- /dev/null
+++ b/api/services/repository_aliases.py
@@ -0,0 +1,229 @@
+"""Canonical repository identity resolution across current and prior slugs.
+
+The slug registry is the lookup boundary.  Historical records deliberately keep
+the slug they recorded; callers use ``slug_values`` when they need an identity-
+wide read and ``canonical_slug`` when they create a new reference.
+"""
+
+from __future__ import annotations
+
+import uuid
+from dataclasses import dataclass
+
+from fastapi import HTTPException
+from sqlalchemy import func, or_, select
+from sqlalchemy.ext.asyncio import AsyncSession
+from sqlalchemy.orm import noload
+
+from api.models.fabric_graph import FabricGraphEdge, FabricGraphImport, FabricGraphNode
+from api.models.managed_repo import ManagedRepo
+from api.models.repository_rename import RepositorySlug
+
+
+@dataclass(frozen=True)
+class RepositorySlugResolution:
+    repo: ManagedRepo
+    requested_slug: str
+    canonical_slug: str
+    slug_status: str
+    aliases: tuple[str, ...]
+    source_operation_id: uuid.UUID | None = None
+
+    @property
+    def slug_values(self) -> tuple[str, ...]:
+        return (self.canonical_slug, *self.aliases)
+
+
+async def resolve_repository_slug(
+    session: AsyncSession,
+    slug: str,
+    *,
+    required: bool = True,
+) -> RepositorySlugResolution | None:
+    """Resolve a current or protected prior slug to one repository UUID."""
+
+    record = (
+        await session.execute(
+            select(RepositorySlug).where(RepositorySlug.slug == slug)
+        )
+    ).scalar_one_or_none()
+
+    # Compatibility for databases upgraded before the identity backfill has run.
+    if record is None:
+        repo = (
+            await session.execute(select(ManagedRepo).where(ManagedRepo.slug == slug))
+        ).scalar_one_or_none()
+        if repo is None:
+            if required:
+                raise HTTPException(status_code=404, detail=f"Repo '{slug}' not found")
+            return None
+        return RepositorySlugResolution(
+            repo=repo,
+            requested_slug=slug,
+            canonical_slug=repo.slug,
+            slug_status="canonical",
+            aliases=(),
+        )
+
+    repo = await session.get(ManagedRepo, record.repo_id)
+    if repo is None:
+        raise HTTPException(
+            status_code=409,
+            detail=f"Repository slug registry entry '{slug}' has no repository",
+        )
+    records = list(
+        (
+            await session.execute(
+                select(RepositorySlug)
+                .where(RepositorySlug.repo_id == repo.id)
+                .order_by(RepositorySlug.kind.desc(), RepositorySlug.slug)
+            )
+        ).scalars()
+    )
+    canonicals = [item for item in records if item.kind == "canonical"]
+    if len(canonicals) != 1 or canonicals[0].slug != repo.slug:
+        raise HTTPException(
+            status_code=409,
+            detail=f"Repository '{repo.id}' has inconsistent canonical slug state",
+        )
+    return RepositorySlugResolution(
+        repo=repo,
+        requested_slug=slug,
+        canonical_slug=repo.slug,
+        slug_status=record.kind,
+        aliases=tuple(item.slug for item in records if item.kind == "alias"),
+        source_operation_id=record.source_operation_id,
+    )
+
+
+async def repository_resolutions_for_repositories(
+    session: AsyncSession,
+    repositories: list[ManagedRepo],
+) -> dict[uuid.UUID, RepositorySlugResolution]:
+    """Resolve a repository collection with one slug-registry query.
+
+    Collection callers already hold canonical ``ManagedRepo`` rows. Resolving
+    every row through :func:`resolve_repository_slug` would issue two identity
+    queries per repository. Load the complete alias sets once instead while
+    retaining the pre-registry compatibility behavior.
+    """
+
+    if not repositories:
+        return {}
+
+    repository_ids = [repository.id for repository in repositories]
+    records = list(
+        (
+            await session.execute(
+                select(RepositorySlug)
+                .options(
+                    noload(RepositorySlug.repo),
+                    noload(RepositorySlug.source_operation),
+                )
+                .where(RepositorySlug.repo_id.in_(repository_ids))
+                .order_by(RepositorySlug.repo_id, RepositorySlug.kind.desc(), RepositorySlug.slug)
+            )
+        ).scalars()
+    )
+    records_by_repository: dict[uuid.UUID, list[RepositorySlug]] = {
+        repository_id: [] for repository_id in repository_ids
+    }
+    for record in records:
+        records_by_repository[record.repo_id].append(record)
+
+    resolutions: dict[uuid.UUID, RepositorySlugResolution] = {}
+    for repository in repositories:
+        repository_records = records_by_repository[repository.id]
+        requested_record = next(
+            (record for record in repository_records if record.slug == repository.slug),
+            None,
+        )
+        if requested_record is None:
+            # Compatibility for databases upgraded before the identity backfill.
+            resolutions[repository.id] = RepositorySlugResolution(
+                repo=repository,
+                requested_slug=repository.slug,
+                canonical_slug=repository.slug,
+                slug_status="canonical",
+                aliases=(),
+            )
+            continue
+
+        canonicals = [record for record in repository_records if record.kind == "canonical"]
+        if len(canonicals) != 1 or canonicals[0].slug != repository.slug:
+            raise HTTPException(
+                status_code=409,
+                detail=f"Repository '{repository.id}' has inconsistent canonical slug state",
+            )
+        resolutions[repository.id] = RepositorySlugResolution(
+            repo=repository,
+            requested_slug=repository.slug,
+            canonical_slug=repository.slug,
+            slug_status=requested_record.kind,
+            aliases=tuple(
+                record.slug for record in repository_records if record.kind == "alias"
+            ),
+            source_operation_id=requested_record.source_operation_id,
+        )
+
+    return resolutions
+
+
+async def canonicalize_repository_slug(session: AsyncSession, value: str) -> str:
+    """Canonicalize a value only when it is a registered repository identity."""
+
+    resolution = await resolve_repository_slug(session, value, required=False)
+    return resolution.canonical_slug if resolution is not None else value
+
+
+async def repository_resolution_for_id(
+    session: AsyncSession, repo: ManagedRepo
+) -> RepositorySlugResolution:
+    return await resolve_repository_slug(session, repo.slug)  # type: ignore[return-value]
+
+
+async def stale_external_references(
+    session: AsyncSession,
+    resolution: RepositorySlugResolution,
+) -> list[dict[str, object]]:
+    """Name external projections that still contain an historical slug.
+
+    These are handoffs to the projection owner, never implicit rewrite targets.
+    """
+
+    if not resolution.aliases:
+        return []
+    aliases = list(resolution.aliases)
+    checks = (
+        (FabricGraphImport, "source_repo_slug"),
+        (FabricGraphNode, "source_repo_slug"),
+        (FabricGraphNode, "repo_slug"),
+        (FabricGraphEdge, "source_repo_slug"),
+    )
+    stale: list[dict[str, object]] = []
+    for model, field_name in checks:
+        field = getattr(model, field_name)
+        rows = (
+            await session.execute(
+                select(field, func.count()).where(field.in_(aliases)).group_by(field)
+            )
+        ).all()
+        for value, count in rows:
+            stale.append(
+                {
+                    "owner": "railiance-fabric",
+                    "surface": model.__tablename__,
+                    "field": field_name,
+                    "value": value,
+                    "count": count,
+                    "status": "stale",
+                    "handoff": "owner update or re-ingest required",
+                }
+            )
+    return stale
+
+
+def affected_slug_predicate(field: object, slugs: tuple[str, ...]):
+    """Match a JSONB slug-list against any name in one repository lineage."""
+
+    return or_(*(field.contains([slug]) for slug in slugs))
diff --git a/api/services/repository_identity.py b/api/services/repository_identity.py
new file mode 100644
index 0000000..3eb2e09
--- /dev/null
+++ b/api/services/repository_identity.py
@@ -0,0 +1,23 @@
+from sqlalchemy.ext.asyncio import AsyncSession
+
+from api.models.managed_repo import ManagedRepo
+from api.models.repository_rename import RepositoryForgeIdentity, RepositorySlug
+
+
+def stage_initial_repository_identity(
+    session: AsyncSession, repo: ManagedRepo
+) -> None:
+    """Attach non-guessed identity state to a newly flushed repository row."""
+    if repo.id is None:
+        raise ValueError("repository must be flushed before identity records are staged")
+    session.add_all(
+        [
+            RepositoryForgeIdentity(repo_id=repo.id),
+            RepositorySlug(
+                repo_id=repo.id,
+                slug=repo.slug,
+                kind="canonical",
+                protected=True,
+            ),
+        ]
+    )
diff --git a/api/services/repository_rename.py b/api/services/repository_rename.py
new file mode 100644
index 0000000..7065353
--- /dev/null
+++ b/api/services/repository_rename.py
@@ -0,0 +1,1784 @@
+"""Fail-closed, UUID-addressed repository rename lifecycle (STATE-WP-0085-T03)."""
+
+from __future__ import annotations
+
+import base64
+import hashlib
+import hmac
+import json
+import uuid
+from copy import deepcopy
+from dataclasses import dataclass
+from datetime import datetime, timedelta, timezone
+from typing import Any
+from urllib.parse import quote
+
+from sqlalchemy import or_, select
+from sqlalchemy.exc import IntegrityError
+from sqlalchemy.ext.asyncio import AsyncSession
+
+from api.config import settings
+from api.models.agent_message import AgentMessage
+from api.models.capability_catalog import CapabilityCatalog
+from api.models.decision import Decision
+from api.models.fabric_graph import FabricGraphNode
+from api.models.interface_change import InterfaceChange
+from api.models.managed_repo import ManagedRepo
+from api.models.progress_event import ProgressEvent
+from api.models.repository_rename import (
+    RepositoryForgeIdentity,
+    RepositoryRenameOperation,
+    RepositorySlug,
+)
+from api.models.sbom_entry import SBOMEntry
+from api.models.sbom_snapshot import SBOMSnapshot
+from api.models.service_catalog import ServiceFirstParty
+from api.models.task import Task
+from api.models.token_event import TokenEvent
+from api.models.workplan import Workplan
+from api.schemas.repository_rename import (
+    ForgeIdentityVerifyRequest,
+    RepositoryRenameOperationCreate,
+    RepositoryRenamePhaseApply,
+    RepositoryRenamePreflightRequest,
+)
+from api.services.forge_repository import (
+    ForgeRepositoryConflict,
+    ForgeRepositoryGateway,
+    ForgeRepositoryRedirected,
+    ForgeRepositorySnapshot,
+    ForgeRepositoryUnreadable,
+)
+
+
+ACTIVE_OPERATION_PHASES = {
+    "draft",
+    "preflighted",
+    "forge-renamed",
+    "statehub-rebound",
+    "source-synced",
+    "consumers-verified",
+    "rollback-preflight",
+}
+FORWARD_PHASES = [
+    "preflighted",
+    "forge-renamed",
+    "statehub-rebound",
+    "source-synced",
+    "consumers-verified",
+    "completed",
+]
+
+
+class RenameLifecycleError(RuntimeError):
+    status_code = 409
+    code = "repository_rename_conflict"
+
+    def __init__(self, message: str, *, details: dict[str, Any] | None = None):
+        super().__init__(message)
+        self.details = details or {}
+
+
+class RenameNotFound(RenameLifecycleError):
+    status_code = 404
+    code = "repository_rename_not_found"
+
+
+class RenamePreconditionFailed(RenameLifecycleError):
+    status_code = 412
+    code = "repository_rename_precondition_failed"
+
+
+class RenameServiceUnavailable(RenameLifecycleError):
+    status_code = 503
+    code = "repository_rename_service_unavailable"
+
+
+def utcnow() -> datetime:
+    return datetime.now(timezone.utc)
+
+
+def _json_default(value: Any) -> str:
+    if isinstance(value, datetime):
+        return value.astimezone(timezone.utc).isoformat()
+    if isinstance(value, uuid.UUID):
+        return str(value)
+    if hasattr(value, "value"):
+        return str(value.value)
+    return str(value)
+
+
+def canonical_json(value: Any) -> bytes:
+    return json.dumps(
+        value,
+        sort_keys=True,
+        separators=(",", ":"),
+        ensure_ascii=True,
+        default=_json_default,
+    ).encode("utf-8")
+
+
+def checksum(value: Any) -> str:
+    return hashlib.sha256(canonical_json(value)).hexdigest()
+
+
+def _b64encode(value: bytes) -> str:
+    return base64.urlsafe_b64encode(value).rstrip(b"=").decode("ascii")
+
+
+def _b64decode(value: str) -> bytes:
+    return base64.urlsafe_b64decode(value + "=" * (-len(value) % 4))
+
+
+def _sign_preflight(payload: dict[str, Any]) -> str:
+    secret = settings.repository_rename_preflight_secret
+    if not secret:
+        raise RenameServiceUnavailable(
+            "Repository rename preflight signing is not configured"
+        )
+    encoded = _b64encode(canonical_json(payload))
+    signature = hmac.new(secret.encode(), encoded.encode(), hashlib.sha256).digest()
+    return f"{encoded}.{_b64encode(signature)}"
+
+
+def _verify_preflight_token(token: str) -> dict[str, Any]:
+    secret = settings.repository_rename_preflight_secret
+    if not secret:
+        raise RenameServiceUnavailable(
+            "Repository rename preflight signing is not configured"
+        )
+    try:
+        encoded, supplied = token.split(".", 1)
+        expected = hmac.new(secret.encode(), encoded.encode(), hashlib.sha256).digest()
+        if not hmac.compare_digest(expected, _b64decode(supplied)):
+            raise ValueError("signature")
+        payload = json.loads(_b64decode(encoded))
+        expires_at = datetime.fromisoformat(payload["expires_at"])
+    except (ValueError, KeyError, json.JSONDecodeError) as exc:
+        raise RenamePreconditionFailed("Invalid repository rename preflight token") from exc
+    if expires_at <= utcnow():
+        raise RenamePreconditionFailed("Repository rename preflight token has expired")
+    return payload
+
+
+def confirmation_for(repo_id: uuid.UUID, old_slug: str, new_slug: str) -> str:
+    return f"rename:{repo_id}:{old_slug}:{new_slug}"
+
+
+def rollback_confirmation_for(operation_id: uuid.UUID) -> str:
+    return f"rollback:{operation_id}"
+
+
+async def _id_rows(session: AsyncSession, query) -> list[str]:
+    result = await session.execute(query)
+    return sorted(str(value) for value in result.scalars().all())
+
+
+def _record_summary(ids: list[str]) -> dict[str, Any]:
+    return {"count": len(ids), "ids": ids, "checksum": checksum(ids)}
+
+
+async def _relationship_rows(
+    session: AsyncSession, query, fields: tuple[str, ...]
+) -> list[dict[str, Any]]:
+    def normalize(value: Any) -> Any:
+        if value is None or isinstance(value, (str, int, float, bool)):
+            return value
+        if isinstance(value, datetime):
+            return value.astimezone(timezone.utc).isoformat()
+        if isinstance(value, uuid.UUID):
+            return str(value)
+        if hasattr(value, "value"):
+            return value.value
+        return str(value)
+
+    result = await session.execute(query)
+    rows = [
+        {field: normalize(getattr(row, field)) for field in fields}
+        for row in result.all()
+    ]
+    return sorted(rows, key=lambda row: canonical_json(row))
+
+
+def _relationship_summary(
+    rows: list[dict[str, Any]], *, totals: dict[str, int] | None = None
+) -> dict[str, Any]:
+    ids = sorted(row["id"] for row in rows)
+    result = {
+        "count": len(rows),
+        "ids": ids,
+        "checksum": checksum(ids),
+        "relationships": rows,
+        "relationship_checksum": checksum(rows),
+    }
+    if totals is not None:
+        result["totals"] = totals
+        result["totals_checksum"] = checksum(totals)
+    return result
+
+
+async def collect_continuity_baseline(
+    session: AsyncSession, repo_id: uuid.UUID
+) -> dict[str, Any]:
+    workplans = await _relationship_rows(
+        session,
+        select(
+            Workplan.id.label("id"),
+            Workplan.repo_id.label("repo_id"),
+            Workplan.slug.label("slug"),
+        ).where(Workplan.repo_id == repo_id),
+        ("id", "repo_id", "slug"),
+    )
+    workplan_uuids = [uuid.UUID(row["id"]) for row in workplans]
+    tasks = await _relationship_rows(
+        session,
+        select(
+            Task.id.label("id"),
+            Task.workplan_id.label("workplan_id"),
+            Task.record_id.label("record_id"),
+        ).where(
+            Task.workplan_id.in_(workplan_uuids) if workplan_uuids else False
+        ),
+        ("id", "workplan_id", "record_id"),
+    )
+    task_uuids = [uuid.UUID(row["id"]) for row in tasks]
+    progress = await _relationship_rows(
+        session,
+        select(
+            ProgressEvent.id.label("id"),
+            ProgressEvent.workplan_id.label("workplan_id"),
+            ProgressEvent.task_id.label("task_id"),
+            ProgressEvent.decision_id.label("decision_id"),
+        ).where(
+            or_(
+                ProgressEvent.workplan_id.in_(workplan_uuids)
+                if workplan_uuids
+                else False,
+                ProgressEvent.task_id.in_(task_uuids) if task_uuids else False,
+            )
+        ),
+        ("id", "workplan_id", "task_id", "decision_id"),
+    )
+    decisions = await _relationship_rows(
+        session,
+        select(
+            Decision.id.label("id"),
+            Decision.workplan_id.label("workplan_id"),
+        ).where(
+            Decision.workplan_id.in_(workplan_uuids) if workplan_uuids else False
+        ),
+        ("id", "workplan_id"),
+    )
+    token_events = await _relationship_rows(
+        session,
+        select(
+            TokenEvent.id.label("id"),
+            TokenEvent.repo_id.label("repo_id"),
+            TokenEvent.workplan_id.label("workplan_id"),
+            TokenEvent.task_id.label("task_id"),
+            TokenEvent.tokens_in.label("tokens_in"),
+            TokenEvent.tokens_out.label("tokens_out"),
+            TokenEvent.cached_input_tokens.label("cached_input_tokens"),
+            TokenEvent.reasoning_output_tokens.label("reasoning_output_tokens"),
+            TokenEvent.raw_total_tokens.label("raw_total_tokens"),
+        ).where(
+            or_(
+                TokenEvent.repo_id == repo_id,
+                TokenEvent.workplan_id.in_(workplan_uuids)
+                if workplan_uuids
+                else False,
+                TokenEvent.task_id.in_(task_uuids) if task_uuids else False,
+            )
+        ),
+        (
+            "id",
+            "repo_id",
+            "workplan_id",
+            "task_id",
+            "tokens_in",
+            "tokens_out",
+            "cached_input_tokens",
+            "reasoning_output_tokens",
+            "raw_total_tokens",
+        ),
+    )
+    token_totals = {
+        field: sum(int(row[field]) for row in token_events if row[field] is not None)
+        for field in (
+            "tokens_in",
+            "tokens_out",
+            "cached_input_tokens",
+            "reasoning_output_tokens",
+            "raw_total_tokens",
+        )
+    }
+    sbom_snapshots = await _relationship_rows(
+        session,
+        select(
+            SBOMSnapshot.id.label("id"),
+            SBOMSnapshot.repo_id.label("repo_id"),
+        ).where(SBOMSnapshot.repo_id == repo_id),
+        ("id", "repo_id"),
+    )
+    sbom_entries = await _relationship_rows(
+        session,
+        select(
+            SBOMEntry.id.label("id"),
+            SBOMEntry.repo_id.label("repo_id"),
+            SBOMEntry.snapshot_id.label("snapshot_id"),
+        ).where(SBOMEntry.repo_id == repo_id),
+        ("id", "repo_id", "snapshot_id"),
+    )
+    services = await _relationship_rows(
+        session,
+        select(
+            ServiceFirstParty.service_id.label("id"),
+            ServiceFirstParty.repo_id.label("repo_id"),
+        ).where(ServiceFirstParty.repo_id == repo_id),
+        ("id", "repo_id"),
+    )
+    capabilities = await _relationship_rows(
+        session,
+        select(
+            CapabilityCatalog.id.label("id"),
+            CapabilityCatalog.repo_id.label("repo_id"),
+        ).where(CapabilityCatalog.repo_id == repo_id),
+        ("id", "repo_id"),
+    )
+    interface_changes = await _relationship_rows(
+        session,
+        select(
+            InterfaceChange.id.label("id"),
+            InterfaceChange.repo_id.label("repo_id"),
+        ).where(InterfaceChange.repo_id == repo_id),
+        ("id", "repo_id"),
+    )
+    bindings = await _relationship_rows(
+        session,
+        select(
+            Workplan.id.label("id"),
+            Workplan.repo_id.label("repo_id"),
+            Workplan.backing_relative_path.label("backing_relative_path"),
+            Workplan.backing_filename.label("backing_filename"),
+        ).where(
+            Workplan.repo_id == repo_id,
+            Workplan.backing_relative_path.is_not(None),
+        ),
+        ("id", "repo_id", "backing_relative_path", "backing_filename"),
+    )
+    slug_rows = await _relationship_rows(
+        session,
+        select(
+            RepositorySlug.id.label("id"),
+            RepositorySlug.repo_id.label("repo_id"),
+            RepositorySlug.slug.label("slug"),
+            RepositorySlug.kind.label("kind"),
+        ).where(RepositorySlug.repo_id == repo_id),
+        ("id", "repo_id", "slug", "kind"),
+    )
+    known_slugs = [row["slug"] for row in slug_rows]
+    messages = await _relationship_rows(
+        session,
+        select(
+            AgentMessage.id.label("id"),
+            AgentMessage.from_agent.label("from_agent"),
+            AgentMessage.to_agent.label("to_agent"),
+            AgentMessage.thread_id.label("thread_id"),
+        ).where(
+            or_(
+                AgentMessage.from_agent.in_(known_slugs),
+                AgentMessage.to_agent.in_(known_slugs),
+            )
+            if known_slugs
+            else False
+        ),
+        ("id", "from_agent", "to_agent", "thread_id"),
+    )
+    active_work = await _active_work(session, repo_id)
+    active_dispatch = [
+        {"id": row["id"], "repo_id": str(repo_id), "kind": "workplan"}
+        for row in active_work["workplans"]
+    ] + [
+        {
+            "id": row["id"],
+            "workplan_id": row["workplan_id"],
+            "kind": "task",
+        }
+        for row in active_work["tasks"]
+    ]
+    active_dispatch = sorted(active_dispatch, key=lambda row: canonical_json(row))
+    records = {
+        "repository": _relationship_summary(
+            [{"id": str(repo_id), "repo_id": str(repo_id)}]
+        ),
+        "workplans": _relationship_summary(workplans),
+        "tasks": _relationship_summary(tasks),
+        "progress_events": _relationship_summary(progress),
+        "decisions": _relationship_summary(decisions),
+        "token_events": _relationship_summary(token_events, totals=token_totals),
+        "sbom_snapshots": _relationship_summary(sbom_snapshots),
+        "sbom_entries": _relationship_summary(sbom_entries),
+        "services": _relationship_summary(services),
+        "capabilities": _relationship_summary(capabilities),
+        "interface_changes": _relationship_summary(interface_changes),
+        "workplan_bindings": _relationship_summary(bindings),
+        "active_dispatch": _relationship_summary(active_dispatch),
+        "aliases": _relationship_summary(slug_rows),
+        "messages": _relationship_summary(messages),
+    }
+    records["continuity_checksum"] = checksum(records)
+    return records
+
+
+async def _active_work(session: AsyncSession, repo_id: uuid.UUID) -> dict[str, Any]:
+    workplans_result = await session.execute(
+        select(Workplan.id, Workplan.slug, Workplan.status)
+        .where(
+            Workplan.repo_id == repo_id,
+            Workplan.status.not_in(("finished", "archived")),
+        )
+        .order_by(Workplan.slug)
+    )
+    workplans = [
+        {"id": str(row.id), "slug": row.slug, "status": row.status}
+        for row in workplans_result.all()
+    ]
+    workplan_ids = [uuid.UUID(row["id"]) for row in workplans]
+    tasks_result = await session.execute(
+        select(Task.id, Task.workplan_id, Task.record_id, Task.status)
+        .where(
+            Task.workplan_id.in_(workplan_ids) if workplan_ids else False,
+            Task.status.not_in(("done", "cancel")),
+        )
+        .order_by(Task.id)
+    )
+    tasks = [
+        {
+            "id": str(row.id),
+            "workplan_id": str(row.workplan_id),
+            "record_id": row.record_id,
+            "status": getattr(row.status, "value", str(row.status)),
+        }
+        for row in tasks_result.all()
+    ]
+    return {"workplans": workplans, "tasks": tasks}
+
+
+async def _affected_records(
+    session: AsyncSession, repo_id: uuid.UUID, old_slug: str
+) -> dict[str, Any]:
+    messages = await _id_rows(
+        session,
+        select(AgentMessage.id).where(
+            or_(AgentMessage.from_agent == old_slug, AgentMessage.to_agent == old_slug)
+        ),
+    )
+    interface_mentions = await _id_rows(
+        session,
+        select(InterfaceChange.id).where(
+            InterfaceChange.affected_repo_slugs.contains([old_slug])
+        ),
+    )
+    fabric_nodes = await _id_rows(
+        session,
+        select(FabricGraphNode.id).where(
+            or_(
+                FabricGraphNode.repo_slug == old_slug,
+                FabricGraphNode.source_repo_slug == old_slug,
+            )
+        ),
+    )
+    return {
+        "messages": _record_summary(messages),
+        "interface_change_mentions": _record_summary(interface_mentions),
+        "fabric_nodes": _record_summary(fabric_nodes),
+        "external_handoffs": [
+            item
+            for item, ids in (
+                ("interface-change-consumers", interface_mentions),
+                ("fabric-graph-projections", fabric_nodes),
+            )
+            if ids
+        ],
+    }
+
+
+def _new_remote_url(repo: ManagedRepo, identity: RepositoryForgeIdentity, new_slug: str) -> str:
+    base = str(identity.forge_instance).rstrip("/")
+    suffix = ".git" if (repo.remote_url or "").endswith(".git") else ""
+    return f"{base}/{identity.forge_owner}/{new_slug}{suffix}"
+
+
+async def _load_repo_identity(
+    session: AsyncSession, repo_id: uuid.UUID
+) -> tuple[ManagedRepo, RepositoryForgeIdentity | None]:
+    repo = await session.get(ManagedRepo, repo_id)
+    if repo is None:
+        raise RenameNotFound(f"Repository {repo_id} was not found")
+    result = await session.execute(
+        select(RepositoryForgeIdentity).where(
+            RepositoryForgeIdentity.repo_id == repo_id
+        )
+    )
+    return repo, result.scalar_one_or_none()
+
+
+async def verify_forge_identity(
+    session: AsyncSession,
+    gateway: ForgeRepositoryGateway,
+    repo_id: uuid.UUID,
+    body: ForgeIdentityVerifyRequest,
+) -> RepositoryForgeIdentity:
+    repo, identity = await _load_repo_identity(session, repo_id)
+    if identity is None:
+        raise RenamePreconditionFailed("Repository has no Forge identity row")
+    try:
+        snapshot = await gateway.inspect(
+            instance=body.forge_instance,
+            owner=body.forge_owner,
+            name=repo.slug,
+        )
+    except ForgeRepositoryUnreadable as exc:
+        raise RenamePreconditionFailed(str(exc)) from exc
+    if snapshot is None:
+        raise RenamePreconditionFailed("Forge repository is absent or unreadable")
+    if snapshot.name != repo.slug:
+        raise RenamePreconditionFailed(
+            "Forge identity verification followed a repository redirect",
+            details={"expected_name": repo.slug, "actual_name": snapshot.name},
+        )
+    if snapshot.repository_id != body.forge_repository_id:
+        raise RenamePreconditionFailed(
+            "Forge repository ID does not match the asserted immutable ID",
+            details={
+                "expected_forge_repository_id": body.forge_repository_id,
+                "actual_forge_repository_id": snapshot.repository_id,
+            },
+        )
+    if identity.verification_state == "verified":
+        actual = (
+            identity.provider,
+            identity.forge_instance,
+            identity.forge_owner,
+            identity.forge_repository_id,
+        )
+        supplied = (
+            body.provider,
+            body.forge_instance.rstrip("/"),
+            body.forge_owner,
+            body.forge_repository_id,
+        )
+        if actual != supplied:
+            raise RenamePreconditionFailed("Verified Forge identity is immutable")
+        return identity
+    identity.provider = body.provider
+    identity.forge_instance = body.forge_instance.rstrip("/")
+    identity.forge_owner = body.forge_owner
+    identity.forge_repository_id = body.forge_repository_id
+    identity.verification_state = "verified"
+    identity.verified_at = utcnow()
+    identity.verified_by = body.verified_by
+    identity.verification_evidence = {
+        "forge_snapshot": snapshot.as_dict(),
+        "verified_repo_slug": repo.slug,
+    }
+    await session.commit()
+    await session.refresh(identity)
+    return identity
+
+
+async def build_preflight(
+    session: AsyncSession,
+    gateway: ForgeRepositoryGateway,
+    repo_id: uuid.UUID,
+    body: RepositoryRenamePreflightRequest,
+    *,
+    issue_token: bool = True,
+) -> dict[str, Any]:
+    repo, identity = await _load_repo_identity(session, repo_id)
+    now = utcnow()
+    blockers: list[dict[str, Any]] = []
+    warnings: list[dict[str, Any]] = []
+    old_snapshot: ForgeRepositorySnapshot | None = None
+    target_snapshot: ForgeRepositorySnapshot | None = None
+
+    if issue_token and not settings.repository_rename_preflight_secret:
+        blockers.append(
+            {
+                "code": "preflight_signing_unavailable",
+                "message": "Repository rename preflight signing is not configured",
+            }
+        )
+
+    if repo.slug == body.new_slug:
+        blockers.append({"code": "same_slug", "message": "Target slug equals canonical slug"})
+    claimed = await session.execute(
+        select(RepositorySlug).where(RepositorySlug.slug == body.new_slug)
+    )
+    claimed_row = claimed.scalar_one_or_none()
+    old_claim = await session.execute(
+        select(RepositorySlug).where(RepositorySlug.slug == repo.slug)
+    )
+    old_claim_row = old_claim.scalar_one_or_none()
+    if (
+        old_claim_row is None
+        or old_claim_row.repo_id != repo.id
+        or old_claim_row.kind != "canonical"
+    ):
+        blockers.append(
+            {
+                "code": "statehub_canonical_inconsistent",
+                "message": "Managed repository slug is not its protected canonical route",
+            }
+        )
+    if claimed_row is not None:
+        blockers.append(
+            {
+                "code": "statehub_slug_claimed",
+                "message": "Target slug is already protected in State Hub",
+                "repo_id": str(claimed_row.repo_id),
+                "kind": claimed_row.kind,
+            }
+        )
+    active_result = await session.execute(
+        select(RepositoryRenameOperation).where(
+            RepositoryRenameOperation.repo_id == repo_id,
+            RepositoryRenameOperation.phase.in_(ACTIVE_OPERATION_PHASES),
+        )
+    )
+    active_operations = list(active_result.scalars().all())
+    if active_operations:
+        blockers.append(
+            {
+                "code": "active_rename_operation",
+                "message": "Repository already has an active rename operation",
+                "operation_ids": [str(item.id) for item in active_operations],
+            }
+        )
+    target_operation_result = await session.execute(
+        select(RepositoryRenameOperation.id, RepositoryRenameOperation.repo_id).where(
+            RepositoryRenameOperation.new_slug == body.new_slug,
+            RepositoryRenameOperation.phase.in_(ACTIVE_OPERATION_PHASES),
+            RepositoryRenameOperation.repo_id != repo_id,
+        )
+    )
+    target_operations = list(target_operation_result.all())
+    if target_operations:
+        blockers.append(
+            {
+                "code": "target_held_by_active_operation",
+                "message": "Target slug is reserved by another active rename operation",
+                "operations": [
+                    {"operation_id": str(row.id), "repo_id": str(row.repo_id)}
+                    for row in target_operations
+                ],
+            }
+        )
+    if body.queued_edge_writes:
+        blockers.append(
+            {
+                "code": "queued_edge_writes",
+                "message": "Caller reported edge writes that must be replayed or resolved first",
+                "count": len(body.queued_edge_writes),
+            }
+        )
+    if identity is None or identity.verification_state != "verified":
+        blockers.append(
+            {
+                "code": "forge_identity_unverified",
+                "message": "Repository Forge identity is not verified",
+            }
+        )
+    else:
+        try:
+            old_snapshot = await gateway.inspect(
+                instance=str(identity.forge_instance),
+                owner=str(identity.forge_owner),
+                name=repo.slug,
+            )
+            target_snapshot = await gateway.inspect(
+                instance=str(identity.forge_instance),
+                owner=str(identity.forge_owner),
+                name=body.new_slug,
+            )
+        except ForgeRepositoryUnreadable as exc:
+            blockers.append(
+                {"code": "forge_unreadable", "message": str(exc)}
+            )
+        if old_snapshot is None:
+            blockers.append(
+                {"code": "forge_source_absent", "message": "Canonical Forge repository is absent or unreadable"}
+            )
+        else:
+            if old_snapshot.name != repo.slug:
+                blockers.append(
+                    {
+                        "code": "forge_redirected",
+                        "message": "Forge source lookup resolved to another coordinate",
+                        "expected": repo.slug,
+                        "actual": old_snapshot.name,
+                    }
+                )
+            if old_snapshot.repository_id != identity.forge_repository_id:
+                blockers.append(
+                    {
+                        "code": "wrong_forge_repository_id",
+                        "message": "Forge repository ID differs from verified identity",
+                        "expected": identity.forge_repository_id,
+                        "actual": old_snapshot.repository_id,
+                    }
+                )
+            if not old_snapshot.projection_readable or not old_snapshot.projection_source_present:
+                blockers.append(
+                    {
+                        "code": "projection_unreadable",
+                        "message": "Forge work-record projection source is not readable",
+                    }
+                )
+        if target_snapshot is not None:
+            blockers.append(
+                {
+                    "code": "forge_target_claimed",
+                    "message": "Target Forge repository name is already claimed",
+                    "forge_repository_id": target_snapshot.repository_id,
+                }
+            )
+
+    baselines = await collect_continuity_baseline(session, repo_id)
+    active_work = await _active_work(session, repo_id)
+    affected = await _affected_records(session, repo_id, repo.slug)
+    affected.update(
+        {
+            "workplan_bindings": baselines["workplan_bindings"],
+            "workplans": baselines["workplans"],
+            "tasks": baselines["tasks"],
+            "progress_events": baselines["progress_events"],
+            "decisions": baselines["decisions"],
+            "token_events": baselines["token_events"],
+            "interface_changes": baselines["interface_changes"],
+            "sbom_snapshots": baselines["sbom_snapshots"],
+            "sbom_entries": baselines["sbom_entries"],
+            "services": baselines["services"],
+            "capability_entries": baselines["capabilities"],
+        }
+    )
+    if active_work["workplans"]:
+        warnings.append(
+            {
+                "code": "active_work_present",
+                "message": "Active work must be quiesced or explicitly coordinated during cutover",
+                "workplan_count": len(active_work["workplans"]),
+                "task_count": len(active_work["tasks"]),
+            }
+        )
+
+    identity_dict = (
+        {
+            "id": str(identity.id),
+            "verification_state": identity.verification_state,
+            "provider": identity.provider,
+            "forge_instance": identity.forge_instance,
+            "forge_owner": identity.forge_owner,
+            "forge_repository_id": identity.forge_repository_id,
+        }
+        if identity is not None
+        else None
+    )
+    new_remote = _new_remote_url(repo, identity, body.new_slug) if identity else None
+    proposed = [
+        {"phase": "forge-renamed", "system": "forgejo", "field": "name", "from": repo.slug, "to": body.new_slug},
+        {"phase": "statehub-rebound", "system": "state-hub", "field": "managed_repos.slug", "from": repo.slug, "to": body.new_slug},
+        {"phase": "statehub-rebound", "system": "state-hub", "field": "managed_repos.remote_url", "from": repo.remote_url, "to": new_remote},
+        {"phase": "statehub-rebound", "system": "state-hub", "field": "repository_slugs", "from": f"{repo.slug}:canonical", "to": f"{repo.slug}:alias,{body.new_slug}:canonical"},
+    ]
+    retained = [
+        {"field": "managed_repos.id", "value": str(repo.id)},
+        {"field": "repository_forge_identities.forge_repository_id", "value": identity.forge_repository_id if identity else None},
+        {"field": "repository_slugs.alias", "value": repo.slug},
+        {"field": "managed_repos.local_path", "value": repo.local_path},
+        {"field": "managed_repos.host_paths", "value": repo.host_paths},
+        {"field": "telemetry_and_work_record_ids", "value": baselines["continuity_checksum"]},
+    ]
+    stable_report = {
+        "schema_version": "state-hub.repository-rename-preflight.v1",
+        "repo_id": str(repo.id),
+        "old_slug": repo.slug,
+        "new_slug": body.new_slug,
+        "safe_to_apply": not blockers,
+        "blockers": blockers,
+        "warnings": warnings,
+        "current": {
+            "statehub": {
+                "repo_id": str(repo.id),
+                "slug": repo.slug,
+                "name": repo.name,
+                "remote_url": repo.remote_url,
+                "local_path": repo.local_path,
+                "host_paths": repo.host_paths,
+                "canonical_available": bool(
+                    old_claim_row
+                    and old_claim_row.repo_id == repo.id
+                    and old_claim_row.kind == "canonical"
+                ),
+                "slug_registry": (
+                    {
+                        "id": str(old_claim_row.id),
+                        "kind": old_claim_row.kind,
+                        "protected": old_claim_row.protected,
+                    }
+                    if old_claim_row
+                    else None
+                ),
+            },
+            "forge_identity": identity_dict,
+            "forge_available": old_snapshot is not None,
+            "forge": old_snapshot.as_dict() if old_snapshot else None,
+        },
+        "target": {
+            "slug": body.new_slug,
+            "statehub_available": claimed_row is None,
+            "forge_available": target_snapshot is None,
+            "forge": target_snapshot.as_dict() if target_snapshot else None,
+        },
+        "baselines": baselines,
+        "active_work": active_work,
+        "affected": affected,
+        "queued_edge_writes": [item.model_dump(mode="json") for item in body.queued_edge_writes],
+        "proposed_mutations": proposed,
+        "retained_history": retained,
+    }
+    report_checksum = checksum(stable_report)
+    expires_at = now + timedelta(seconds=settings.repository_rename_preflight_ttl_seconds)
+    token = None
+    if issue_token and not blockers:
+        token = _sign_preflight(
+            {
+                "version": 1,
+                "repo_id": str(repo.id),
+                "old_slug": repo.slug,
+                "new_slug": body.new_slug,
+                "forge_repository_id": identity.forge_repository_id if identity else None,
+                "source_commit": old_snapshot.head_commit if old_snapshot else None,
+                "report_checksum": report_checksum,
+                "issued_at": now.isoformat(),
+                "expires_at": expires_at.isoformat(),
+            }
+        )
+    return {
+        **stable_report,
+        "report_checksum": report_checksum,
+        "preflight_token": token,
+        "preflighted_at": now,
+        "expires_at": expires_at if token else None,
+    }
+
+
+async def create_operation(
+    session: AsyncSession,
+    gateway: ForgeRepositoryGateway,
+    repo_id: uuid.UUID,
+    body: RepositoryRenameOperationCreate,
+) -> tuple[RepositoryRenameOperation, bool]:
+    if body.operation_id is not None:
+        existing = await session.get(RepositoryRenameOperation, body.operation_id)
+        if existing is not None:
+            if (
+                existing.repo_id != repo_id
+                or existing.new_slug != body.new_slug
+                or existing.actor != body.actor
+                or body.confirmation
+                != confirmation_for(repo_id, existing.old_slug, existing.new_slug)
+            ):
+                raise RenamePreconditionFailed(
+                    "Repository rename operation ID is already bound to another request"
+                )
+            return existing, True
+
+    token = _verify_preflight_token(body.preflight_token)
+    if token.get("repo_id") != str(repo_id) or token.get("new_slug") != body.new_slug:
+        raise RenamePreconditionFailed("Preflight token does not address this rename")
+    preflight = await build_preflight(
+        session,
+        gateway,
+        repo_id,
+        RepositoryRenamePreflightRequest(
+            new_slug=body.new_slug, queued_edge_writes=body.queued_edge_writes
+        ),
+        issue_token=False,
+    )
+    if not preflight["safe_to_apply"]:
+        raise RenamePreconditionFailed(
+            "Repository rename preflight is no longer safe",
+            details={"blockers": preflight["blockers"]},
+        )
+    if preflight["report_checksum"] != token.get("report_checksum"):
+        raise RenamePreconditionFailed(
+            "Repository rename preflight evidence is stale",
+            details={
+                "expected_report_checksum": token.get("report_checksum"),
+                "actual_report_checksum": preflight["report_checksum"],
+            },
+        )
+    old_slug = preflight["old_slug"]
+    if body.confirmation != confirmation_for(repo_id, old_slug, body.new_slug):
+        raise RenamePreconditionFailed("Explicit repository rename confirmation is incorrect")
+    repo, identity = await _load_repo_identity(session, repo_id)
+    if identity is None or identity.verification_state != "verified":
+        raise RenamePreconditionFailed("Repository Forge identity is not verified")
+    forge = preflight["current"]["forge"]
+    now = utcnow()
+    operation = RepositoryRenameOperation(
+        id=body.operation_id or uuid.uuid4(),
+        repo_id=repo.id,
+        forge_identity_id=identity.id,
+        forge_identity_state="verified",
+        expected_provider=str(identity.provider),
+        expected_forge_instance=str(identity.forge_instance),
+        expected_forge_owner=str(identity.forge_owner),
+        expected_forge_repository_id=int(identity.forge_repository_id),
+        expected_source_commit=forge["head_commit"],
+        expected_default_branch=forge["default_branch"],
+        old_slug=repo.slug,
+        new_slug=body.new_slug,
+        old_coordinates={
+            "slug": repo.slug,
+            "name": repo.name,
+            "remote_url": repo.remote_url,
+            "local_path": repo.local_path,
+            "host_paths": repo.host_paths,
+        },
+        new_coordinates={
+            "slug": body.new_slug,
+            "name": body.new_slug,
+            "remote_url": _new_remote_url(repo, identity, body.new_slug),
+            "local_path": repo.local_path,
+            "host_paths": repo.host_paths,
+        },
+        phase="preflighted",
+        actor=body.actor,
+        phase_changed_at=now,
+        preflighted_at=datetime.fromisoformat(token["issued_at"]),
+        preflight_expires_at=datetime.fromisoformat(token["expires_at"]),
+        evidence={
+            "preflight": {
+                "report_checksum": preflight["report_checksum"],
+                "baselines": preflight["baselines"],
+                "affected": preflight["affected"],
+                "warnings": preflight["warnings"],
+            },
+            "phases": {
+                "preflighted": {"at": now.isoformat(), "resumed": False}
+            },
+            "telemetry": {
+                "started_at": now.isoformat(),
+                "phase_attempts": {"preflighted": 1},
+                "phase_durations_ms": {"preflighted": 0},
+                "retries": 0,
+                "failures": 0,
+                "rollback_attempts": 0,
+                "verification_outcome": "pending",
+            },
+        },
+    )
+    session.add(operation)
+    try:
+        await session.commit()
+    except IntegrityError as exc:
+        await session.rollback()
+        if body.operation_id is not None:
+            existing = await session.get(RepositoryRenameOperation, body.operation_id)
+            if (
+                existing is not None
+                and existing.repo_id == repo_id
+                and existing.new_slug == body.new_slug
+                and existing.actor == body.actor
+                and body.confirmation
+                == confirmation_for(repo_id, existing.old_slug, existing.new_slug)
+            ):
+                return existing, True
+        raise RenamePreconditionFailed(
+            "A conflicting repository rename operation was created"
+        ) from exc
+    await session.refresh(operation)
+    return operation, False
+
+
+async def load_operation_by_id(
+    session: AsyncSession,
+    operation_id: uuid.UUID,
+) -> RepositoryRenameOperation:
+    operation = await session.get(RepositoryRenameOperation, operation_id)
+    if operation is None:
+        raise RenameNotFound(
+            f"Repository rename operation {operation_id} was not found"
+        )
+    return operation
+
+
+async def load_operation(
+    session: AsyncSession,
+    repo_id: uuid.UUID,
+    operation_id: uuid.UUID,
+    *,
+    for_update: bool = False,
+) -> RepositoryRenameOperation:
+    query = select(RepositoryRenameOperation).where(
+        RepositoryRenameOperation.id == operation_id,
+        RepositoryRenameOperation.repo_id == repo_id,
+    )
+    if for_update:
+        query = query.with_for_update()
+    result = await session.execute(query)
+    operation = result.scalar_one_or_none()
+    if operation is None:
+        raise RenameNotFound(f"Repository rename operation {operation_id} was not found")
+    return operation
+
+
+async def list_operations(
+    session: AsyncSession, repo_id: uuid.UUID, *, active_only: bool = False
+) -> list[RepositoryRenameOperation]:
+    repo = await session.get(ManagedRepo, repo_id)
+    if repo is None:
+        raise RenameNotFound(f"Repository {repo_id} was not found")
+    query = (
+        select(RepositoryRenameOperation)
+        .where(RepositoryRenameOperation.repo_id == repo_id)
+        .order_by(RepositoryRenameOperation.created_at.desc())
+    )
+    if active_only:
+        query = query.where(RepositoryRenameOperation.phase.in_(ACTIVE_OPERATION_PHASES))
+    result = await session.execute(query)
+    return list(result.scalars().all())
+
+
+def _assert_snapshot(
+    operation: RepositoryRenameOperation,
+    snapshot: ForgeRepositorySnapshot,
+    *,
+    expected_name: str | None = None,
+) -> None:
+    if snapshot.repository_id != operation.expected_forge_repository_id:
+        raise RenamePreconditionFailed(
+            "Forge repository ID changed",
+            details={
+                "expected": operation.expected_forge_repository_id,
+                "actual": snapshot.repository_id,
+            },
+        )
+    if snapshot.default_branch != operation.expected_default_branch:
+        raise RenamePreconditionFailed("Forge default branch changed")
+    if snapshot.head_commit != operation.expected_source_commit:
+        raise RenamePreconditionFailed(
+            "Forge default-branch head moved",
+            details={
+                "expected": operation.expected_source_commit,
+                "actual": snapshot.head_commit,
+            },
+        )
+    if not snapshot.projection_readable or not snapshot.projection_source_present:
+        raise RenamePreconditionFailed("Forge work-record projection is unreadable")
+    if expected_name is not None and snapshot.name != expected_name:
+        raise RenamePreconditionFailed(
+            "Forge response resolved to a different repository coordinate",
+            details={"expected_name": expected_name, "actual_name": snapshot.name},
+        )
+
+
+async def _forge_at(
+    gateway: ForgeRepositoryGateway,
+    operation: RepositoryRenameOperation,
+    name: str,
+) -> ForgeRepositorySnapshot | None:
+    try:
+        return await gateway.inspect(
+            instance=operation.expected_forge_instance,
+            owner=operation.expected_forge_owner,
+            name=name,
+        )
+    except ForgeRepositoryUnreadable as exc:
+        raise RenamePreconditionFailed(str(exc)) from exc
+
+
+async def _apply_forge_rename(
+    gateway: ForgeRepositoryGateway, operation: RepositoryRenameOperation
+) -> dict[str, Any]:
+    new = await _forge_at(gateway, operation, operation.new_slug)
+    if new is not None:
+        # A redirect is compatibility evidence only. Establish immutable identity
+        # at the requested new coordinate before accepting the old-name alias.
+        _assert_snapshot(operation, new, expected_name=operation.new_slug)
+        try:
+            old = await gateway.inspect(
+                instance=operation.expected_forge_instance,
+                owner=operation.expected_forge_owner,
+                name=operation.old_slug,
+            )
+        except ForgeRepositoryRedirected as exc:
+            canonical_api = (
+                operation.expected_forge_instance.rstrip("/")
+                + "/api/v1/repos/"
+                + quote(operation.expected_forge_owner, safe="")
+                + "/"
+                + quote(operation.new_slug, safe="")
+            )
+            if exc.target_url != canonical_api:
+                raise RenamePreconditionFailed(
+                    "Old Forge name redirects outside the verified new coordinate"
+                ) from exc
+            old = None
+        except ForgeRepositoryUnreadable as exc:
+            raise RenamePreconditionFailed(str(exc)) from exc
+        if old is not None:
+            raise RenamePreconditionFailed("Both old and new Forge names are claimed")
+        return {"resumed": True, "forge": new.as_dict()}
+    old = await _forge_at(gateway, operation, operation.old_slug)
+    if old is None:
+        raise RenamePreconditionFailed("Forge repository is absent at both expected names")
+    _assert_snapshot(operation, old, expected_name=operation.old_slug)
+    try:
+        renamed = await gateway.rename(
+            instance=operation.expected_forge_instance,
+            owner=operation.expected_forge_owner,
+            old_name=operation.old_slug,
+            new_name=operation.new_slug,
+        )
+    except (ForgeRepositoryUnreadable, ForgeRepositoryConflict) as exc:
+        raise RenamePreconditionFailed(str(exc)) from exc
+    _assert_snapshot(operation, renamed, expected_name=operation.new_slug)
+    return {"resumed": False, "forge": renamed.as_dict()}
+
+
+async def _apply_statehub_rebind(
+    session: AsyncSession, operation: RepositoryRenameOperation
+) -> dict[str, Any]:
+    repo = await session.get(ManagedRepo, operation.repo_id, with_for_update=True)
+    if repo is None:
+        raise RenameNotFound("Managed repository disappeared")
+    if repo.id != operation.repo_id:
+        raise RenamePreconditionFailed("Managed repository UUID changed")
+    old_result = await session.execute(
+        select(RepositorySlug)
+        .where(RepositorySlug.slug == operation.old_slug)
+        .with_for_update()
+    )
+    new_result = await session.execute(
+        select(RepositorySlug)
+        .where(RepositorySlug.slug == operation.new_slug)
+        .with_for_update()
+    )
+    old_slug = old_result.scalar_one_or_none()
+    new_slug = new_result.scalar_one_or_none()
+    if repo.slug == operation.new_slug:
+        if (
+            old_slug is None
+            or old_slug.repo_id != repo.id
+            or old_slug.kind != "alias"
+            or new_slug is None
+            or new_slug.repo_id != repo.id
+            or new_slug.kind != "canonical"
+        ):
+            raise RenamePreconditionFailed("State Hub rename state is internally inconsistent")
+        return {"resumed": True, "repo_id": str(repo.id)}
+    if repo.slug != operation.old_slug:
+        raise RenamePreconditionFailed("Managed repository slug changed outside this operation")
+    if old_slug is None or old_slug.repo_id != repo.id or old_slug.kind != "canonical":
+        raise RenamePreconditionFailed("Old canonical slug record is missing")
+    if new_slug is not None:
+        raise RenamePreconditionFailed("Target State Hub slug became claimed")
+    old_slug.kind = "alias"
+    old_slug.protected = True
+    old_slug.source_operation_id = operation.id
+    await session.flush()
+    session.add(
+        RepositorySlug(
+            repo_id=repo.id,
+            slug=operation.new_slug,
+            kind="canonical",
+            protected=True,
+            source_operation_id=operation.id,
+        )
+    )
+    repo.slug = operation.new_slug
+    repo.name = operation.new_coordinates["name"]
+    repo.remote_url = operation.new_coordinates["remote_url"]
+    await session.flush()
+    return {"resumed": False, "repo_id": str(repo.id)}
+
+
+async def verify_operation(
+    session: AsyncSession,
+    gateway: ForgeRepositoryGateway,
+    operation: RepositoryRenameOperation,
+) -> dict[str, Any]:
+    checks: list[dict[str, Any]] = []
+
+    def add(name: str, ok: bool, expected: Any, actual: Any) -> None:
+        checks.append({"name": name, "ok": ok, "expected": expected, "actual": actual})
+
+    repo = await session.get(ManagedRepo, operation.repo_id)
+    add("managed_repository_exists", repo is not None, str(operation.repo_id), str(repo.id) if repo else None)
+    add("managed_repository_uuid", bool(repo and repo.id == operation.repo_id), str(operation.repo_id), str(repo.id) if repo else None)
+    expected_name = operation.old_slug if operation.phase == "preflighted" else operation.new_slug
+    if operation.phase == "rolled-back":
+        expected_name = operation.old_slug
+    try:
+        forge = await _forge_at(gateway, operation, expected_name)
+    except RenameLifecycleError as exc:
+        forge = None
+        add("forge_readable", False, True, str(exc))
+    else:
+        add("forge_readable", forge is not None, True, forge is not None)
+    if forge is not None:
+        add("forge_coordinate", forge.name == expected_name, expected_name, forge.name)
+        add("forge_repository_id", forge.repository_id == operation.expected_forge_repository_id, operation.expected_forge_repository_id, forge.repository_id)
+        add("source_commit", forge.head_commit == operation.expected_source_commit, operation.expected_source_commit, forge.head_commit)
+        add("default_branch", forge.default_branch == operation.expected_default_branch, operation.expected_default_branch, forge.default_branch)
+        add("projection_readable", forge.projection_readable and forge.projection_source_present, True, forge.projection_readable and forge.projection_source_present)
+    expected_canonical = operation.old_slug if operation.phase in {"preflighted", "forge-renamed", "rolled-back"} else operation.new_slug
+    canonical_result = await session.execute(
+        select(RepositorySlug).where(
+            RepositorySlug.repo_id == operation.repo_id,
+            RepositorySlug.kind == "canonical",
+        )
+    )
+    canonical = canonical_result.scalar_one_or_none()
+    add("canonical_route", bool(canonical and canonical.slug == expected_canonical), expected_canonical, canonical.slug if canonical else None)
+    current = await collect_continuity_baseline(session, operation.repo_id)
+    baseline = (operation.evidence.get("preflight") or {}).get("baselines") or {}
+    expected_checksum = baseline.get("continuity_checksum", "")
+    missing: dict[str, list[str]] = {}
+    changed_relationships: dict[str, list[str]] = {}
+    preserved_relationship_checksums: dict[str, str] = {}
+    counts: dict[str, dict[str, int]] = {}
+    for record_type, baseline_record in baseline.items():
+        if record_type == "continuity_checksum" or not isinstance(baseline_record, dict):
+            continue
+        current_record = current.get(record_type) or {"ids": [], "count": 0}
+        absent = sorted(set(baseline_record.get("ids") or []) - set(current_record.get("ids") or []))
+        if absent:
+            missing[record_type] = absent
+        if record_type != "aliases":
+            baseline_rows = {
+                row["id"]: row
+                for row in baseline_record.get("relationships") or []
+            }
+            current_rows = {
+                row["id"]: row
+                for row in current_record.get("relationships") or []
+            }
+            changed = sorted(
+                record_id
+                for record_id, baseline_row in baseline_rows.items()
+                if current_rows.get(record_id) != baseline_row
+            )
+            if changed:
+                changed_relationships[record_type] = changed
+            preserved_rows = [
+                current_rows[record_id]
+                for record_id in baseline_rows
+                if record_id in current_rows
+            ]
+            preserved_relationship_checksums[record_type] = checksum(
+                sorted(preserved_rows, key=lambda row: canonical_json(row))
+            )
+        counts[record_type] = {
+            "baseline": int(baseline_record.get("count") or 0),
+            "current": int(current_record.get("count") or 0),
+        }
+    # New telemetry may legitimately arrive while a phased operation is being
+    # executed.  Continuity means every baseline identity still exists; it does
+    # not freeze the repository's append-only history at the preflight count.
+    add(
+        "relationship_continuity",
+        not missing and not changed_relationships,
+        {"missing": {}, "changed": {}},
+        {"missing": missing, "changed": changed_relationships},
+    )
+    add(
+        "record_counts_non_decreasing",
+        all(item["current"] >= item["baseline"] for item in counts.values()),
+        {name: item["baseline"] for name, item in counts.items()},
+        {name: item["current"] for name, item in counts.items()},
+    )
+    baseline_token_totals = (baseline.get("token_events") or {}).get("totals") or {}
+    current_token_totals = (current.get("token_events") or {}).get("totals") or {}
+    add(
+        "token_totals_non_decreasing",
+        all(
+            int(current_token_totals.get(name) or 0) >= int(value or 0)
+            for name, value in baseline_token_totals.items()
+        ),
+        baseline_token_totals,
+        current_token_totals,
+    )
+    slug_result = await session.execute(
+        select(RepositorySlug).where(
+            RepositorySlug.repo_id == operation.repo_id,
+            RepositorySlug.slug.in_((operation.old_slug, operation.new_slug)),
+        )
+    )
+    slug_routes = {row.slug: row.kind for row in slug_result.scalars().all()}
+    if operation.phase in {"preflighted", "forge-renamed"}:
+        expected_routes = {operation.old_slug: "canonical"}
+    elif operation.phase == "rolled-back":
+        expected_routes = {
+            operation.old_slug: "canonical",
+            operation.new_slug: "alias",
+        }
+    else:
+        expected_routes = {
+            operation.old_slug: "alias",
+            operation.new_slug: "canonical",
+        }
+    add(
+        "slug_routes",
+        all(slug_routes.get(slug) == kind for slug, kind in expected_routes.items()),
+        expected_routes,
+        slug_routes,
+    )
+    return {
+        "operation_id": operation.id,
+        "repo_id": operation.repo_id,
+        "phase": operation.phase,
+        "ok": all(item["ok"] for item in checks),
+        "checks": checks,
+        "baseline_checksum": expected_checksum,
+        "current_checksum": current["continuity_checksum"],
+        "relationship_checksums": {
+            "baseline": {
+                name: value.get("relationship_checksum")
+                for name, value in baseline.items()
+                if isinstance(value, dict) and name != "aliases"
+            },
+            "preserved": preserved_relationship_checksums,
+        },
+    }
+
+
+def _telemetry(operation: RepositoryRenameOperation) -> tuple[dict[str, Any], dict[str, Any]]:
+    journal = deepcopy(operation.evidence or {})
+    telemetry = dict(journal.get("telemetry") or {})
+    telemetry.setdefault("started_at", operation.preflighted_at.isoformat())
+    telemetry.setdefault("phase_attempts", {})
+    telemetry.setdefault("phase_durations_ms", {})
+    telemetry.setdefault("retries", 0)
+    telemetry.setdefault("failures", 0)
+    telemetry.setdefault("rollback_attempts", 0)
+    telemetry.setdefault("verification_outcome", "pending")
+    return journal, telemetry
+
+
+def _record_retry(operation: RepositoryRenameOperation, phase: str) -> None:
+    journal, telemetry = _telemetry(operation)
+    attempts = dict(telemetry["phase_attempts"])
+    attempts[phase] = int(attempts.get(phase) or 0) + 1
+    telemetry["phase_attempts"] = attempts
+    telemetry["retries"] = int(telemetry["retries"]) + 1
+    telemetry["last_retry"] = {"phase": phase, "at": utcnow().isoformat()}
+    journal["telemetry"] = telemetry
+    operation.evidence = journal
+
+
+def _record_failure(
+    operation: RepositoryRenameOperation, phase: str, exc: RenameLifecycleError
+) -> None:
+    journal, telemetry = _telemetry(operation)
+    failures_by_phase = dict(telemetry.get("failures_by_phase") or {})
+    failures_by_phase[phase] = int(failures_by_phase.get(phase) or 0) + 1
+    telemetry["failures_by_phase"] = failures_by_phase
+    telemetry["failures"] = int(telemetry["failures"]) + 1
+    telemetry["last_failure"] = {
+        "phase": phase,
+        "code": exc.code,
+        "at": utcnow().isoformat(),
+    }
+    if phase.startswith("rollback"):
+        telemetry["rollback_outcome"] = "failed"
+    journal["telemetry"] = telemetry
+    operation.evidence = journal
+
+
+def _record_phase(operation: RepositoryRenameOperation, phase: str, evidence: dict[str, Any]) -> None:
+    now = utcnow()
+    journal, telemetry = _telemetry(operation)
+    phases = dict(journal.get("phases") or {})
+    # Verification payloads use native UUID/datetime values for API response
+    # typing.  The operation journal is JSONB, so normalize at the boundary
+    # instead of leaking storage concerns through every verifier.
+    safe_evidence = json.loads(canonical_json(evidence))
+    phases[phase] = {"at": now.isoformat(), **safe_evidence}
+    journal["phases"] = phases
+    attempts = dict(telemetry["phase_attempts"])
+    attempts[phase] = int(attempts.get(phase) or 0) + 1
+    telemetry["phase_attempts"] = attempts
+    durations = dict(telemetry["phase_durations_ms"])
+    durations[phase] = max(
+        0, int((now - operation.phase_changed_at).total_seconds() * 1000)
+    )
+    telemetry["phase_durations_ms"] = durations
+    telemetry["last_phase"] = phase
+    if phase == "rollback-preflight":
+        telemetry["rollback_attempts"] = int(telemetry["rollback_attempts"]) + 1
+        telemetry["rollback_outcome"] = "approved"
+    elif phase == "rolled-back":
+        telemetry["rollback_outcome"] = "completed"
+    verification = evidence.get("verification")
+    if isinstance(verification, dict):
+        telemetry["verification_outcome"] = (
+            "passed" if verification.get("ok") else "failed"
+        )
+    journal["telemetry"] = telemetry
+    operation.evidence = journal
+    operation.phase = phase
+    operation.phase_changed_at = now
+    operation.error_code = None
+    operation.error_message = None
+    operation.error_details = None
+    operation.error_at = None
+    if phase == "completed":
+        operation.completed_at = now
+    if phase == "rolled-back":
+        operation.rolled_back_at = now
+
+
+def _phase_index(phase: str) -> int:
+    try:
+        return FORWARD_PHASES.index(phase)
+    except ValueError:
+        return -1
+
+
+async def apply_phase(
+    session: AsyncSession,
+    gateway: ForgeRepositoryGateway,
+    repo_id: uuid.UUID,
+    operation_id: uuid.UUID,
+    requested_phase: str,
+    body: RepositoryRenamePhaseApply,
+) -> tuple[RepositoryRenameOperation, bool]:
+    if requested_phase not in FORWARD_PHASES[1:]:
+        raise RenamePreconditionFailed(f"Unsupported forward phase '{requested_phase}'")
+    operation = await load_operation(session, repo_id, operation_id, for_update=True)
+    if body.confirmation != confirmation_for(repo_id, operation.old_slug, operation.new_slug):
+        raise RenamePreconditionFailed("Explicit repository rename confirmation is incorrect")
+    current_index = _phase_index(operation.phase)
+    requested_index = _phase_index(requested_phase)
+    if current_index >= requested_index >= 0:
+        _record_retry(operation, requested_phase)
+        await session.commit()
+        await session.refresh(operation)
+        return operation, True
+    if operation.phase != body.expected_phase:
+        raise RenamePreconditionFailed(
+            "Repository rename phase compare-and-set failed",
+            details={"expected": body.expected_phase, "actual": operation.phase},
+        )
+    if requested_index != current_index + 1:
+        raise RenamePreconditionFailed(
+            "Repository rename phases cannot be skipped",
+            details={"current": operation.phase, "requested": requested_phase},
+        )
+    try:
+        if requested_phase == "forge-renamed":
+            evidence = await _apply_forge_rename(gateway, operation)
+        elif requested_phase == "statehub-rebound":
+            forge = await _forge_at(gateway, operation, operation.new_slug)
+            if forge is None:
+                raise RenamePreconditionFailed("Forge rename is not observable")
+            _assert_snapshot(operation, forge, expected_name=operation.new_slug)
+            evidence = await _apply_statehub_rebind(session, operation)
+        elif requested_phase == "source-synced":
+            if not body.evidence or body.evidence.get("fresh_clone") is not True:
+                raise RenamePreconditionFailed(
+                    "Source synchronization requires fresh-clone operator evidence"
+                )
+            clone_repository_id = body.evidence.get("forge_repository_id")
+            if clone_repository_id != operation.expected_forge_repository_id:
+                raise RenamePreconditionFailed(
+                    "Fresh clone points at the wrong Forge repository ID",
+                    details={
+                        "expected": operation.expected_forge_repository_id,
+                        "actual": clone_repository_id,
+                    },
+                )
+            clone_head = body.evidence.get("head_commit")
+            if clone_head != operation.expected_source_commit:
+                raise RenamePreconditionFailed(
+                    "Fresh clone head does not match the rename baseline",
+                    details={
+                        "expected": operation.expected_source_commit,
+                        "actual": clone_head,
+                    },
+                )
+            forge = await _forge_at(gateway, operation, operation.new_slug)
+            if forge is None:
+                raise RenamePreconditionFailed("Renamed Forge repository is absent")
+            _assert_snapshot(operation, forge, expected_name=operation.new_slug)
+            evidence = {"forge": forge.as_dict(), "operator_evidence": body.evidence}
+        elif requested_phase == "consumers-verified":
+            if not body.checks or not all(body.checks.values()):
+                raise RenamePreconditionFailed(
+                    "Consumer verification requires a non-empty set of passing checks",
+                    details={"checks": body.checks},
+                )
+            verification = await verify_operation(session, gateway, operation)
+            if not verification["ok"]:
+                raise RenamePreconditionFailed(
+                    "Continuity verification failed before consumer acceptance",
+                    details=verification,
+                )
+            evidence = {"checks": body.checks, "verification": verification, "operator_evidence": body.evidence}
+        else:  # completed
+            verification = await verify_operation(session, gateway, operation)
+            if not verification["ok"]:
+                raise RenamePreconditionFailed(
+                    "Repository rename verification failed", details=verification
+                )
+            evidence = {"verification": verification}
+        _record_phase(operation, requested_phase, evidence)
+        await session.commit()
+        await session.refresh(operation)
+        return operation, False
+    except RenameLifecycleError as exc:
+        # Roll back every State Hub write attempted by the phase.  A Forge
+        # rename may already have committed externally; the unchanged journal
+        # phase is precisely what lets the next request discover and resume it.
+        await session.rollback()
+        failed = await load_operation(session, repo_id, operation_id, for_update=True)
+        _record_failure(failed, requested_phase, exc)
+        failed.error_code = exc.code
+        failed.error_message = str(exc)
+        failed.error_details = json.loads(canonical_json(exc.details))
+        failed.error_at = utcnow()
+        await session.commit()
+        raise
+    except IntegrityError as exc:
+        await session.rollback()
+        failure = RenamePreconditionFailed(
+            "Repository rename phase lost a database compare-and-set race"
+        )
+        failed = await load_operation(session, repo_id, operation_id, for_update=True)
+        _record_failure(failed, requested_phase, failure)
+        failed.error_code = failure.code
+        failed.error_message = str(failure)
+        failed.error_details = json.loads(canonical_json(failure.details))
+        failed.error_at = utcnow()
+        await session.commit()
+        raise failure from exc
+
+
+async def rollback_preflight(
+    session: AsyncSession,
+    gateway: ForgeRepositoryGateway,
+    repo_id: uuid.UUID,
+    operation_id: uuid.UUID,
+    *,
+    expected_phase: str,
+    confirmation: str,
+) -> tuple[RepositoryRenameOperation, dict[str, Any]]:
+    operation = await load_operation(session, repo_id, operation_id, for_update=True)
+    if operation.phase == "rolled-back":
+        return operation, {"rollback_from_phase": "rolled-back", "safe_to_rollback": True, "blockers": [], "irreversible": []}
+    if confirmation != rollback_confirmation_for(operation.id):
+        raise RenamePreconditionFailed("Explicit rollback confirmation is incorrect")
+    if operation.phase != expected_phase:
+        raise RenamePreconditionFailed(
+            "Rollback preflight phase compare-and-set failed",
+            details={"expected": expected_phase, "actual": operation.phase},
+        )
+    if operation.phase == "rollback-preflight":
+        rollback_data = (operation.evidence or {}).get("rollback_preflight") or {}
+        return operation, rollback_data
+    competing_result = await session.execute(
+        select(RepositoryRenameOperation.id).where(
+            RepositoryRenameOperation.repo_id == repo_id,
+            RepositoryRenameOperation.id != operation.id,
+            RepositoryRenameOperation.phase.in_(ACTIVE_OPERATION_PHASES),
+        )
+    )
+    competing = [str(value) for value in competing_result.scalars().all()]
+    old = await _forge_at(gateway, operation, operation.old_slug)
+    new = await _forge_at(gateway, operation, operation.new_slug)
+    blockers: list[dict[str, Any]] = []
+    if competing:
+        blockers.append(
+            {
+                "code": "newer_active_rename_operation",
+                "operation_ids": competing,
+            }
+        )
+    rollback_from_phase = operation.phase
+    if operation.phase == "preflighted":
+        if old is not None and new is None:
+            try:
+                _assert_snapshot(operation, old, expected_name=operation.old_slug)
+            except RenameLifecycleError as exc:
+                blockers.append({"code": exc.code, "message": str(exc), **exc.details})
+        elif old is None and new is not None:
+            # Forge committed but the phase journal did not.  This is the
+            # principal interruption case the operation ID must recover from.
+            rollback_from_phase = "forge-renamed-unrecorded"
+            try:
+                _assert_snapshot(operation, new, expected_name=operation.new_slug)
+            except RenameLifecycleError as exc:
+                blockers.append({"code": exc.code, "message": str(exc), **exc.details})
+        elif old is None:
+            blockers.append({"code": "forge_repository_absent_at_both_names"})
+        else:
+            blockers.append({"code": "both_forge_slugs_claimed"})
+    else:
+        if old is not None:
+            blockers.append({"code": "old_forge_slug_claimed", "forge_repository_id": old.repository_id})
+        if new is None:
+            blockers.append({"code": "renamed_forge_repository_absent"})
+        else:
+            try:
+                _assert_snapshot(operation, new, expected_name=operation.new_slug)
+            except RenameLifecycleError as exc:
+                blockers.append({"code": exc.code, "message": str(exc), **exc.details})
+    irreversible = [
+        {"code": "external_caches", "message": "External caches and redirects may retain the new coordinate."},
+        {"code": "consumer_changes", "message": "Consumer commits made after cutover are not rewritten automatically."},
+        {"code": "telemetry_history", "message": "The attempted operation and phase evidence remain durable."},
+    ]
+    data = {
+        "rollback_from_phase": rollback_from_phase,
+        "safe_to_rollback": not blockers,
+        "blockers": blockers,
+        "irreversible": irreversible,
+    }
+    if blockers:
+        failure = RenamePreconditionFailed(
+            "Repository rename rollback is unsafe", details=data
+        )
+        _record_failure(operation, "rollback-preflight", failure)
+        operation.error_code = failure.code
+        operation.error_message = str(failure)
+        operation.error_details = json.loads(canonical_json(failure.details))
+        operation.error_at = utcnow()
+        await session.commit()
+        raise failure
+    journal = deepcopy(operation.evidence or {})
+    journal["rollback_preflight"] = data
+    operation.evidence = journal
+    _record_phase(operation, "rollback-preflight", data)
+    await session.commit()
+    await session.refresh(operation)
+    return operation, data
+
+
+async def _rollback_statehub(
+    session: AsyncSession, operation: RepositoryRenameOperation
+) -> dict[str, Any]:
+    repo = await session.get(ManagedRepo, operation.repo_id, with_for_update=True)
+    if repo is None:
+        raise RenameNotFound("Managed repository disappeared")
+    if repo.slug == operation.old_slug:
+        return {"resumed": True, "repo_id": str(repo.id)}
+    if repo.slug != operation.new_slug:
+        raise RenamePreconditionFailed("Managed repository slug changed outside this operation")
+    old_result = await session.execute(
+        select(RepositorySlug).where(RepositorySlug.slug == operation.old_slug).with_for_update()
+    )
+    new_result = await session.execute(
+        select(RepositorySlug).where(RepositorySlug.slug == operation.new_slug).with_for_update()
+    )
+    old_slug = old_result.scalar_one_or_none()
+    new_slug = new_result.scalar_one_or_none()
+    if not old_slug or old_slug.repo_id != repo.id or old_slug.kind != "alias":
+        raise RenamePreconditionFailed("Protected old alias is unavailable for rollback")
+    if not new_slug or new_slug.repo_id != repo.id or new_slug.kind != "canonical":
+        raise RenamePreconditionFailed("New canonical slug is unavailable for rollback")
+    new_slug.kind = "alias"
+    new_slug.protected = True
+    new_slug.source_operation_id = operation.id
+    await session.flush()
+    old_slug.kind = "canonical"
+    old_slug.protected = True
+    old_slug.source_operation_id = operation.id
+    repo.slug = operation.old_slug
+    repo.name = operation.old_coordinates["name"]
+    repo.remote_url = operation.old_coordinates["remote_url"]
+    await session.flush()
+    return {"resumed": False, "repo_id": str(repo.id)}
+
+
+async def apply_rollback(
+    session: AsyncSession,
+    gateway: ForgeRepositoryGateway,
+    repo_id: uuid.UUID,
+    operation_id: uuid.UUID,
+    *,
+    expected_phase: str,
+    confirmation: str,
+) -> tuple[RepositoryRenameOperation, bool]:
+    operation = await load_operation(session, repo_id, operation_id, for_update=True)
+    if operation.phase == "rolled-back":
+        _record_retry(operation, "rolled-back")
+        await session.commit()
+        await session.refresh(operation)
+        return operation, True
+    if operation.phase != expected_phase or operation.phase != "rollback-preflight":
+        raise RenamePreconditionFailed(
+            "Rollback phase compare-and-set failed",
+            details={"expected": expected_phase, "actual": operation.phase},
+        )
+    if confirmation != rollback_confirmation_for(operation.id):
+        raise RenamePreconditionFailed("Explicit rollback confirmation is incorrect")
+    rollback_from = ((operation.evidence or {}).get("rollback_preflight") or {}).get("rollback_from_phase")
+    if not rollback_from:
+        raise RenamePreconditionFailed("Rollback preflight evidence is missing")
+    try:
+        old = await _forge_at(gateway, operation, operation.old_slug)
+        new = await _forge_at(gateway, operation, operation.new_slug)
+        forge_resumed = False
+        if rollback_from != "preflighted":
+            if old is not None:
+                _assert_snapshot(operation, old, expected_name=operation.old_slug)
+                if new is not None:
+                    raise RenamePreconditionFailed(
+                        "Both Forge coordinates are claimed during rollback"
+                    )
+                forge_resumed = True
+            else:
+                if new is None:
+                    raise RenamePreconditionFailed(
+                        "Forge repository is absent during rollback"
+                    )
+                _assert_snapshot(operation, new, expected_name=operation.new_slug)
+                try:
+                    restored = await gateway.rename(
+                        instance=operation.expected_forge_instance,
+                        owner=operation.expected_forge_owner,
+                        old_name=operation.new_slug,
+                        new_name=operation.old_slug,
+                    )
+                except (ForgeRepositoryUnreadable, ForgeRepositoryConflict) as exc:
+                    raise RenamePreconditionFailed(str(exc)) from exc
+                _assert_snapshot(
+                    operation, restored, expected_name=operation.old_slug
+                )
+        statehub = await _rollback_statehub(session, operation)
+        _record_phase(
+            operation,
+            "rolled-back",
+            {
+                "rollback_from_phase": rollback_from,
+                "forge_resumed": forge_resumed,
+                "statehub": statehub,
+            },
+        )
+        await session.commit()
+        await session.refresh(operation)
+        return operation, False
+    except RenameLifecycleError as exc:
+        await session.rollback()
+        failed = await load_operation(session, repo_id, operation_id, for_update=True)
+        _record_failure(failed, "rolled-back", exc)
+        failed.error_code = exc.code
+        failed.error_message = str(exc)
+        failed.error_details = json.loads(canonical_json(exc.details))
+        failed.error_at = utcnow()
+        await session.commit()
+        raise
diff --git a/api/services/review_contracts.py b/api/services/review_contracts.py
new file mode 100644
index 0000000..0db02be
--- /dev/null
+++ b/api/services/review_contracts.py
@@ -0,0 +1,336 @@
+from __future__ import annotations
+
+import hashlib
+import json
+from datetime import datetime, timezone
+from typing import Any
+
+from fastapi import HTTPException
+from sqlalchemy import select
+from sqlalchemy.ext.asyncio import AsyncSession
+
+from api.models.review_contract import ReviewContract, ReviewReceipt
+from api.schemas.review_contract import (
+    GateReviewState,
+    OwnerReviewState,
+    ReviewAggregateRead,
+)
+
+
+def canonical_json(value: Any) -> bytes:
+    return json.dumps(
+        value, sort_keys=True, separators=(",", ":"), ensure_ascii=True
+    ).encode()
+
+
+def digest_document(value: Any) -> str:
+    return hashlib.sha256(canonical_json(value)).hexdigest()
+
+
+def _assertion_id(text: str) -> str:
+    return "assertion:" + hashlib.sha256(text.encode()).hexdigest()[:20]
+
+
+def normalize_contract(raw: dict[str, Any]) -> tuple[dict[str, Any], str]:
+    """Validate v1 or adapt the WP-0024 prototype without executing its checks."""
+    digest = digest_document(raw)
+    if raw.get("interface") == "railiance.owner-review" and raw.get("version") == 1:
+        owners_raw = raw.get("owners")
+        task_owners = raw.get("task_owners")
+        hashes = raw.get("artifact_sha256")
+        if (
+            not isinstance(owners_raw, dict)
+            or not owners_raw
+            or not isinstance(task_owners, dict)
+            or not task_owners
+        ):
+            raise HTTPException(
+                422, "legacy contract requires non-empty owners and task_owners"
+            )
+        if not isinstance(hashes, dict):
+            raise HTTPException(422, "legacy contract requires artifact_sha256")
+        owners = []
+        for owner_id, scope in owners_raw.items():
+            artifacts = scope.get("artifacts") or []
+            assertions = scope.get("assertions") or []
+            checks = scope.get("checks") or []
+            if (
+                not artifacts
+                or not assertions
+                or not checks
+                or any(path not in hashes for path in artifacts)
+            ):
+                raise HTTPException(422, f"{owner_id}: incomplete legacy owner scope")
+            owners.append(
+                {
+                    "id": owner_id,
+                    "artifact_ids": artifacts,
+                    "assertions": [
+                        {"id": _assertion_id(text), "statement": text}
+                        for text in assertions
+                    ],
+                    "check_ids": checks,
+                }
+            )
+        owner_ids = {item["id"] for item in owners}
+        gates = []
+        for gate_id, required in task_owners.items():
+            if (
+                not required
+                or len(required) != len(set(required))
+                or not set(required) <= owner_ids
+            ):
+                raise HTTPException(422, f"{gate_id}: invalid legacy owner set")
+            gates.append({"id": gate_id, "policy": "all_required", "owners": required})
+        normalized = {
+            "schema_version": "review-contract/v1",
+            "contract_key": raw.get("workplan_id"),
+            "subject": {"kind": "workplan", "id": raw.get("workplan_id")},
+            "owners": owners,
+            "gates": gates,
+            "artifacts": {
+                path: {"algorithm": "sha256", "digest": value}
+                for path, value in hashes.items()
+            },
+            "allowed_dispositions": [
+                item.replace("-", "_") for item in (raw.get("decisions") or [])
+            ],
+            "legacy": {
+                "interface": raw["interface"],
+                "version": 1,
+                "source_digest": digest,
+            },
+        }
+        return validate_v1(normalized), digest
+    if raw.get("schema_version") != "review-contract/v1":
+        raise HTTPException(422, "schema_version must be review-contract/v1")
+    return validate_v1(raw), digest
+
+
+def validate_v1(doc: dict[str, Any]) -> dict[str, Any]:
+    contract_key, subject = doc.get("contract_key"), doc.get("subject")
+    owners, gates, artifacts = doc.get("owners"), doc.get("gates"), doc.get("artifacts")
+    dispositions = doc.get("allowed_dispositions")
+    if not isinstance(contract_key, str) or not contract_key:
+        raise HTTPException(422, "contract_key is required")
+    if (
+        not isinstance(subject, dict)
+        or not subject.get("kind")
+        or not subject.get("id")
+    ):
+        raise HTTPException(422, "typed subject kind and id are required")
+    if (
+        not isinstance(owners, list)
+        or not owners
+        or not isinstance(gates, list)
+        or not gates
+    ):
+        raise HTTPException(422, "non-empty owners and gates are required")
+    if not isinstance(artifacts, dict) or not artifacts:
+        raise HTTPException(422, "revision-pinned artifacts are required")
+    if (
+        set(dispositions or []) != {"approve", "request_changes"}
+        or len(dispositions) != 2
+    ):
+        raise HTTPException(
+            422, "allowed_dispositions must contain approve and request_changes only"
+        )
+    owner_ids: set[str] = set()
+    for owner in owners:
+        if not isinstance(owner, dict):
+            raise HTTPException(422, "owner entries must be objects")
+        owner_id = owner.get("id")
+        artifact_ids = owner.get("artifact_ids") or []
+        assertions = owner.get("assertions") or []
+        checks = owner.get("check_ids") or []
+        assertion_ids = [
+            item.get("id") for item in assertions if isinstance(item, dict)
+        ]
+        if (
+            not owner_id
+            or owner_id in owner_ids
+            or not artifact_ids
+            or not checks
+            or not assertion_ids
+        ):
+            raise HTTPException(
+                422,
+                "each owner needs a unique id and non-empty artifact/assertion/check scope",
+            )
+        if len(assertion_ids) != len(set(assertion_ids)) or any(
+            path not in artifacts for path in artifact_ids
+        ):
+            raise HTTPException(422, f"{owner_id}: invalid assertion or artifact scope")
+        owner_ids.add(owner_id)
+    for artifact_id, artifact in artifacts.items():
+        if (
+            not isinstance(artifact, dict)
+            or artifact.get("algorithm") != "sha256"
+            or not _is_sha256(artifact.get("digest"))
+        ):
+            raise HTTPException(
+                422, f"{artifact_id}: only sha256 artifacts are supported"
+            )
+    gate_ids: set[str] = set()
+    for gate in gates:
+        if not isinstance(gate, dict):
+            raise HTTPException(422, "gate entries must be objects")
+        required = gate.get("owners") or []
+        if (
+            gate.get("policy") != "all_required"
+            or not gate.get("id")
+            or gate["id"] in gate_ids
+        ):
+            raise HTTPException(
+                422, "v1 gates require unique ids and all_required policy"
+            )
+        if (
+            not required
+            or len(required) != len(set(required))
+            or not set(required) <= owner_ids
+        ):
+            raise HTTPException(422, f"{gate.get('id')}: gate owner set is invalid")
+        gate_ids.add(gate["id"])
+    return doc
+
+
+def _is_sha256(value: Any) -> bool:
+    return (
+        isinstance(value, str)
+        and len(value) == 64
+        and all(c in "0123456789abcdef" for c in value)
+    )
+
+
+def owner_scope(contract: ReviewContract, owner_id: str) -> dict[str, Any]:
+    for owner in contract.document["owners"]:
+        if owner["id"] == owner_id:
+            return owner
+    raise HTTPException(422, f"unknown owner: {owner_id}")
+
+
+def validate_receipt(contract: ReviewContract, body: Any) -> dict[str, Any]:
+    if body.contract_digest != contract.contract_digest:
+        raise HTTPException(
+            409, "contract digest mismatch; re-review the active contract"
+        )
+    scope = owner_scope(contract, body.owner_id)
+    if body.disposition == "request_changes":
+        if not body.note or not body.note.strip():
+            raise HTTPException(422, "request_changes requires a note")
+    else:
+        expected_artifacts = {
+            key: contract.document["artifacts"][key]["digest"]
+            for key in scope["artifact_ids"]
+        }
+        if body.artifact_hashes != expected_artifacts:
+            raise HTTPException(
+                422, "approval artifact hashes do not exactly match the owner scope"
+            )
+        expected_assertions = {item["id"] for item in scope["assertions"]}
+        if set(body.assertion_ids) != expected_assertions or len(
+            body.assertion_ids
+        ) != len(expected_assertions):
+            raise HTTPException(
+                422, "approval assertions do not exactly match the owner scope"
+            )
+        expected_checks = set(scope["check_ids"])
+        actual_checks = {
+            item.get("id") for item in body.checks if isinstance(item, dict)
+        }
+        if actual_checks != expected_checks or len(body.checks) != len(expected_checks):
+            raise HTTPException(
+                422, "approval checks do not exactly match the owner scope"
+            )
+        if any(
+            item.get("passed") is not True or item.get("read_only") is not True
+            for item in body.checks
+        ):
+            raise HTTPException(
+                422, "every approval check must be passed and explicitly read_only"
+            )
+    return {
+        "owner_id": body.owner_id,
+        "actor": body.actor,
+        "disposition": body.disposition,
+        "contract_digest": body.contract_digest,
+        "artifact_hashes": body.artifact_hashes,
+        "assertion_ids": body.assertion_ids,
+        "checks": body.checks,
+        "note": body.note,
+        "source": body.source.model_dump(),
+    }
+
+
+async def active_contract(session: AsyncSession, contract_key: str) -> ReviewContract:
+    result = await session.execute(
+        select(ReviewContract).where(
+            ReviewContract.contract_key == contract_key, ReviewContract.active.is_(True)
+        )
+    )
+    contract = result.scalar_one_or_none()
+    if contract is None:
+        raise HTTPException(404, f"active review contract not found: {contract_key}")
+    return contract
+
+
+async def aggregate(
+    session: AsyncSession, contract: ReviewContract
+) -> ReviewAggregateRead:
+    rows = await session.execute(
+        select(ReviewReceipt)
+        .where(ReviewReceipt.contract_id == contract.id)
+        .order_by(ReviewReceipt.submitted_at.desc(), ReviewReceipt.id.desc())
+    )
+    latest: dict[str, ReviewReceipt] = {}
+    for receipt in rows.scalars():
+        latest.setdefault(receipt.owner_id, receipt)
+    prior = await session.execute(
+        select(ReviewReceipt.owner_id)
+        .join(ReviewContract)
+        .where(
+            ReviewContract.contract_key == contract.contract_key,
+            ReviewContract.id != contract.id,
+        )
+        .distinct()
+    )
+    stale_owners = set(prior.scalars())
+    owner_states, statuses = [], {}
+    for owner in contract.document["owners"]:
+        owner_id, receipt = owner["id"], latest.get(owner["id"])
+        state = (
+            receipt.disposition.replace("approve", "approved")
+            if receipt
+            else ("stale" if owner_id in stale_owners else "missing")
+        )
+        statuses[owner_id] = state
+        owner_states.append(
+            OwnerReviewState(
+                owner_id=owner_id,
+                status=state,
+                receipt_id=receipt.id if receipt else None,
+                receipt_digest=receipt.receipt_digest if receipt else None,
+                submitted_at=receipt.submitted_at if receipt else None,
+            )
+        )
+    gates = [
+        GateReviewState(
+            gate_id=gate["id"],
+            policy="all_required",
+            owners=gate["owners"],
+            satisfied=all(statuses[owner] == "approved" for owner in gate["owners"]),
+        )
+        for gate in contract.document["gates"]
+    ]
+    return ReviewAggregateRead(
+        contract_key=contract.contract_key,
+        contract_digest=contract.contract_digest,
+        satisfied=all(gate.satisfied for gate in gates),
+        authorizes_execution=False,
+        owners=owner_states,
+        gates=gates,
+    )
+
+
+def utc_now() -> datetime:
+    return datetime.now(timezone.utc)
diff --git a/api/services/sbom_nexus.py b/api/services/sbom_nexus.py
new file mode 100644
index 0000000..229a43e
--- /dev/null
+++ b/api/services/sbom_nexus.py
@@ -0,0 +1,70 @@
+"""Read-only client for the reversible SBOM Nexus compatibility facade."""
+from __future__ import annotations
+
+from typing import Any
+
+import httpx
+
+from api.config import settings
+
+
+class SBOMNexusError(RuntimeError):
+    """An SBOM Nexus request failed without a usable compatibility response."""
+
+    def __init__(self, status_code: int, detail: str):
+        super().__init__(detail)
+        self.status_code = status_code
+        self.detail = detail
+
+
+def reads_from_nexus() -> bool:
+    return settings.sbom_nexus_read_mode == "nexus"
+
+
+def writes_to_nexus() -> bool:
+    return settings.sbom_nexus_write_mode == "nexus"
+
+
+async def request_json(
+    method: str,
+    path: str,
+    *,
+    params: dict[str, Any] | None = None,
+    body: dict[str, Any] | None = None,
+) -> Any:
+    """Call Nexus; never fall back silently to legacy storage."""
+    if not settings.sbom_nexus_url:
+        raise SBOMNexusError(503, "SBOM Nexus read mode is enabled without SBOM_NEXUS_URL")
+
+    try:
+        async with httpx.AsyncClient(
+            base_url=settings.sbom_nexus_url.rstrip("/"),
+            timeout=settings.sbom_nexus_timeout_seconds,
+        ) as client:
+            response = await client.request(method, path, params=params, json=body)
+    except httpx.RequestError as exc:
+        raise SBOMNexusError(502, f"SBOM Nexus is unavailable: {exc.__class__.__name__}") from exc
+
+    if response.status_code >= 400:
+        detail = f"SBOM Nexus returned HTTP {response.status_code}"
+        try:
+            payload = response.json()
+            if isinstance(payload, dict) and isinstance(payload.get("detail"), str):
+                detail = payload["detail"]
+        except ValueError:
+            pass
+        status_code = 404 if response.status_code == 404 else 502
+        raise SBOMNexusError(status_code, detail)
+
+    try:
+        return response.json()
+    except ValueError as exc:
+        raise SBOMNexusError(502, "SBOM Nexus returned invalid JSON") from exc
+
+
+async def get_json(path: str, *, params: dict[str, Any] | None = None) -> Any:
+    return await request_json("GET", path, params=params)
+
+
+async def post_json(path: str, *, body: dict[str, Any]) -> Any:
+    return await request_json("POST", path, body=body)
diff --git a/api/services/schema_state.py b/api/services/schema_state.py
new file mode 100644
index 0000000..24ba58a
--- /dev/null
+++ b/api/services/schema_state.py
@@ -0,0 +1,63 @@
+"""Report whether the database schema matches the code (STATE-WP-0083-T07).
+
+Central ran two revisions behind the code it was serving, and `review_contracts`
+did not exist there although its migration shipped inside the running image.
+Nothing surfaced that: the API starts happily against a schema it was not built
+for, and only fails when a request happens to touch the missing table.
+
+A hub that cannot say which schema it is running has the same problem as a
+projection that cannot name its source commit — it is asserting correctness it
+cannot demonstrate.
+"""
+
+from __future__ import annotations
+
+from functools import lru_cache
+from pathlib import Path
+from typing import Any
+
+from sqlalchemy import text
+from sqlalchemy.ext.asyncio import AsyncSession
+
+_MIGRATIONS = Path(__file__).resolve().parents[2] / "migrations"
+
+
+@lru_cache(maxsize=1)
+def code_head_revision() -> str | None:
+    """The head revision the shipped migration scripts define.
+
+    Read from the migration files rather than the database: this is what the
+    code expects, and it must be knowable without a working connection.
+    """
+    try:
+        from alembic.config import Config
+        from alembic.script import ScriptDirectory
+
+        cfg = Config()
+        cfg.set_main_option("script_location", str(_MIGRATIONS))
+        heads = ScriptDirectory.from_config(cfg).get_heads()
+        return heads[0] if len(heads) == 1 else ",".join(sorted(heads)) or None
+    except Exception:
+        return None
+
+
+async def db_revision(session: AsyncSession) -> str | None:
+    try:
+        result = await session.execute(text("select version_num from alembic_version"))
+        return result.scalar()
+    except Exception:
+        return None
+
+
+async def schema_state(session: AsyncSession) -> dict[str, Any]:
+    applied = await db_revision(session)
+    expected = code_head_revision()
+    # "unknown" is deliberately not "ok": an instance that cannot determine its
+    # own schema state must not report agreement it has not established.
+    if applied is None or expected is None:
+        status = "unknown"
+    elif applied == expected:
+        status = "ok"
+    else:
+        status = "behind"
+    return {"status": status, "applied": applied, "expected": expected}
diff --git a/api/services/summary_cache.py b/api/services/summary_cache.py
index 4061f55..55c6e29 100644
--- a/api/services/summary_cache.py
+++ b/api/services/summary_cache.py
@@ -27,6 +27,8 @@ from api.models.workplan import Workplan
 from api.models.workplan_dependency import WorkplanDependency
 from api.schemas.progress_event import ProgressEventRead
 from api.schemas.state import StateSummary
+from api.services.sbom_nexus import get_json as get_sbom_nexus_json
+from api.services.sbom_nexus import reads_from_nexus
 
 logger = logging.getLogger(__name__)
 
@@ -88,9 +90,17 @@ async def fetch_summary_revision(session: AsyncSession) -> SummaryRevision:
         if value is not None:
             core_parts.append(value)
 
-    sbom_at = (
-        await session.execute(select(func.max(SBOMSnapshot.snapshot_at)))
-    ).scalar_one_or_none()
+    if reads_from_nexus():
+        snapshots = await get_sbom_nexus_json("/sbom/snapshots/")
+        snapshot_times = [
+            datetime.fromisoformat(item["snapshot_at"].replace("Z", "+00:00"))
+            for item in snapshots
+        ]
+        sbom_at = max(snapshot_times, default=None)
+    else:
+        sbom_at = (
+            await session.execute(select(func.max(SBOMSnapshot.snapshot_at)))
+        ).scalar_one_or_none()
 
     progress_at = (
         await session.execute(select(func.max(ProgressEvent.created_at)))
@@ -285,4 +295,4 @@ async def apply_progress_section(
         cache._entry.progress_revision = revision.progress_fingerprint()
     else:
         cache.store(merged, revision)
-    return merged
\ No newline at end of file
+    return merged
diff --git a/api/services/task_record_id_backfill.py b/api/services/task_record_id_backfill.py
new file mode 100644
index 0000000..c2ff3c4
--- /dev/null
+++ b/api/services/task_record_id_backfill.py
@@ -0,0 +1,214 @@
+"""Backfill canonical record ids onto existing task rows (STATE-WP-0083-T06).
+
+Only the repository files hold the mapping. A file task declares both its
+canonical id and the projection UUID it was registered under:
+
+    ```task
+    id: CUST-WP-0067-T01
+    state_hub_task_id: "f3608db4-..."
+    ```
+
+so the pairing can be read directly rather than guessed from titles. Anything a
+file does not claim is left alone: a task row whose canonical id cannot be
+established keeps `record_id` null, and the reset continues to refuse to act on
+it. An unknown identity must stay unknown rather than be inferred.
+"""
+
+from __future__ import annotations
+
+import re
+from dataclasses import dataclass, field
+from pathlib import Path
+from typing import Any
+
+_TASK_BLOCK_RE = re.compile(r"```task\s*\n(.*?)\n```", re.DOTALL)
+_ID_RE = re.compile(r"^id:\s*(\S+)", re.MULTILINE)
+_UUID_RE = re.compile(r'state_hub_task_id:\s*"?([0-9a-f-]{36})"?')
+_FRONTMATTER_ID_RE = re.compile(r"^id:\s*(\S+)", re.MULTILINE)
+# A task id written as a bare "T01" is unique only inside its own workplan.
+# Storing it as a canonical identifier makes every workplan's first task share
+# one identity — 51 such ids were assigned to 148 rows before this was caught.
+_SHORT_TASK_ID_RE = re.compile(r"^T\d+$", re.IGNORECASE)
+
+
+def qualify_task_id(task_id: str, workplan_id: str | None) -> str | None:
+    """Return a canonical task id, or None when identity cannot be established."""
+    task_id = task_id.strip()
+    if not _SHORT_TASK_ID_RE.fullmatch(task_id):
+        return task_id
+    if not workplan_id:
+        # Unqualifiable: leaving it unidentified is correct, since an identity
+        # that is not unique is worse than none.
+        return None
+    return f"{workplan_id.strip()}-{task_id.upper()}"
+
+
+@dataclass
+class BackfillReport:
+    scanned_files: int = 0
+    pairs_found: int = 0
+    updated: int = 0
+    already_set: int = 0
+    conflicts: list[dict[str, str]] = field(default_factory=list)
+    unmatched_uuids: int = 0
+
+    def to_dict(self) -> dict[str, Any]:
+        return {
+            "schema": "state-hub.task-record-id-backfill.v1",
+            "scanned_files": self.scanned_files,
+            "pairs_found": self.pairs_found,
+            "updated": self.updated,
+            "already_set": self.already_set,
+            "unmatched_uuids": self.unmatched_uuids,
+            "conflicts": self.conflicts,
+        }
+
+
+def collect_pairs(roots: list[Path]) -> tuple[dict[str, str], BackfillReport]:
+    """Map projection UUID -> canonical record id, from workplan files."""
+    report = BackfillReport()
+    pairs: dict[str, str] = {}
+    for root in roots:
+        wp_dir = root / "workplans"
+        if not wp_dir.is_dir():
+            continue
+        for path in sorted(wp_dir.rglob("*.md")):
+            if path.name.startswith("."):
+                continue
+            try:
+                text = path.read_text(encoding="utf-8")
+            except (OSError, UnicodeDecodeError):
+                continue
+            report.scanned_files += 1
+            head = text.split("---", 2)[1] if text.startswith("---") and text.count("---") >= 2 else ""
+            wp_match = _FRONTMATTER_ID_RE.search(head)
+            workplan_id = wp_match.group(1).strip() if wp_match else None
+            for block in _TASK_BLOCK_RE.finditer(text):
+                body = block.group(1)
+                rid = _ID_RE.search(body)
+                uid = _UUID_RE.search(body)
+                if not rid or not uid:
+                    continue
+                record_id = qualify_task_id(rid.group(1), workplan_id)
+                if record_id is None:
+                    continue
+                task_uuid = uid.group(1)
+                prior = pairs.get(task_uuid)
+                if prior and prior != record_id:
+                    # One UUID claimed by two canonical ids: a duplicate
+                    # registration. Recording it and skipping is the only safe
+                    # option — picking one would fabricate an identity.
+                    report.conflicts.append(
+                        {"uuid": task_uuid, "first": prior, "second": record_id}
+                    )
+                    continue
+                pairs[task_uuid] = record_id
+    report.pairs_found = len(pairs)
+    return pairs, report
+
+
+async def backfill_task_record_ids(
+    session: Any, roots: list[Path], *, dry_run: bool = True
+) -> BackfillReport:
+    from sqlalchemy import select
+
+    from api.models.task import Task
+
+    pairs, report = collect_pairs(roots)
+    if not pairs:
+        return report
+
+    rows = list((await session.execute(select(Task))).scalars())
+    by_id = {str(r.id): r for r in rows}
+    for task_uuid, record_id in pairs.items():
+        row = by_id.get(task_uuid)
+        if row is None:
+            report.unmatched_uuids += 1
+            continue
+        if row.record_id == record_id:
+            report.already_set += 1
+            continue
+        if row.record_id and row.record_id != record_id:
+            report.conflicts.append(
+                {"uuid": task_uuid, "first": row.record_id, "second": record_id}
+            )
+            continue
+        report.updated += 1
+        if not dry_run:
+            row.record_id = record_id
+    return report
+
+
+async def backfill_from_forge(
+    session: Any,
+    repo_slugs: list[str],
+    *,
+    forge_base: str | None = None,
+    dry_run: bool = True,
+) -> BackfillReport:
+    """Backfill from repositories cloned out of the forge.
+
+    The local-path variant above needs a workstation checkout, which central
+    does not have and should not depend on: `ADR-012` decision 1 makes the forge
+    the projection source, and a backfill sourced from someone's laptop would
+    reintroduce exactly the coupling that ADR removes.
+
+    Central can clone the forge directly, so it reads the pairing from the same
+    place it derives everything else.
+    """
+    import tempfile
+
+    from api.services.forge_projection import (
+        DEFAULT_FORGE_BASE,
+        ForgeDeriveError,
+        _run_git,
+    )
+
+    base = forge_base or DEFAULT_FORGE_BASE
+    report = BackfillReport()
+    pairs: dict[str, str] = {}
+
+    for slug in repo_slugs:
+        url = f"{base.rstrip('/')}/{slug}.git"
+        with tempfile.TemporaryDirectory(prefix=f"backfill-{slug}-") as tmp:
+            try:
+                _run_git("clone", "--depth", "1", "--quiet", url, tmp)
+            except (ForgeDeriveError, Exception):
+                # A repository that cannot be read contributes nothing. It must
+                # not silently reduce what the rest can identify.
+                continue
+            repo_pairs, repo_report = collect_pairs([Path(tmp)])
+            report.scanned_files += repo_report.scanned_files
+            report.conflicts.extend(repo_report.conflicts)
+            for uid, rid in repo_pairs.items():
+                prior = pairs.get(uid)
+                if prior and prior != rid:
+                    report.conflicts.append({"uuid": uid, "first": prior, "second": rid})
+                    continue
+                pairs[uid] = rid
+
+    report.pairs_found = len(pairs)
+    if not pairs:
+        return report
+
+    from sqlalchemy import select
+
+    from api.models.task import Task
+
+    rows = list((await session.execute(select(Task))).scalars())
+    by_id = {str(r.id): r for r in rows}
+    for uid, rid in pairs.items():
+        row = by_id.get(uid)
+        if row is None:
+            report.unmatched_uuids += 1
+            continue
+        if row.record_id == rid:
+            report.already_set += 1
+            continue
+        if row.record_id and row.record_id != rid:
+            report.conflicts.append({"uuid": uid, "first": row.record_id, "second": rid})
+            continue
+        report.updated += 1
+        if not dry_run:
+            row.record_id = rid
+    return report
diff --git a/api/services/work_record_identifier_migration.py b/api/services/work_record_identifier_migration.py
new file mode 100644
index 0000000..f0d2a4d
--- /dev/null
+++ b/api/services/work_record_identifier_migration.py
@@ -0,0 +1,799 @@
+"""Transactional State Hub projection migration for deterministic work-record UUIDs."""
+
+from __future__ import annotations
+
+import hashlib
+import json
+import re
+import uuid
+from dataclasses import dataclass
+from datetime import UTC, datetime
+from typing import Any
+
+from sqlalchemy import func, select, text
+from sqlalchemy.ext.asyncio import AsyncSession
+
+from api.models.managed_repo import ManagedRepo
+from api.models.task import Task, TaskPriority, TaskStatus
+from api.models.work_record_identifier_alias import WorkRecordIdentifierAlias
+from api.services.repository_aliases import resolve_repository_slug
+from api.models.workplan import Workplan
+
+PLAN_SCHEMA = "repo-manager.identifier-migration-plan.v1"
+FLEET_NAMESPACE = "helixforge"
+DERIVATION_NAMESPACE_UUID = uuid.UUID("a4058507-5c4a-5a00-ab06-fffa4fb46009")
+_RECORD_ID_RE = re.compile(r"^[A-Z][A-Z0-9-]*-WP-[0-9]{4}(?:-T[0-9]{2,})?$")
+
+
+class IdentifierMigrationError(ValueError):
+    """The signed plan or current projection is unsafe to migrate."""
+
+
+@dataclass(frozen=True)
+class IdentifierMigrationResult:
+    repo_slug: str
+    plan_sha256: str
+    direction: str
+    replacements: int
+    migrated: int
+    already_derived: int
+    assignments_deferred: int
+
+
+@dataclass(frozen=True)
+class SealedProjectionRepairReceipt:
+    """Non-secret evidence for one bounded pre-derivation projection repair."""
+
+    schema: str
+    outcome: str
+    repo_slug: str
+    repository_id: str
+    workplan_record_id: str
+    workplan_old_id: str
+    task_records: tuple[tuple[str, str], ...]
+    plan_sha256: str
+    source_revision: str
+    source_fingerprint: str
+    projection_identity: str
+    observed_at: str
+
+
+def verify_plan(plan: dict[str, Any]) -> str:
+    """Validate the immutable plan envelope and deterministic UUID mappings."""
+    if plan.get("schema") != PLAN_SCHEMA:
+        raise IdentifierMigrationError("unsupported identifier migration plan schema")
+    if plan.get("namespace") != FLEET_NAMESPACE:
+        raise IdentifierMigrationError(
+            f"plan namespace must be {FLEET_NAMESPACE!r}"
+        )
+    if plan.get("apply_policy") != "all-or-nothing per repository":
+        raise IdentifierMigrationError("plan does not declare repository-atomic apply")
+    if plan.get("ready_to_apply") is not True:
+        raise IdentifierMigrationError("plan is not ready_to_apply")
+
+    expected = plan.get("plan_sha256")
+    if not isinstance(expected, str) or not re.fullmatch(r"[0-9a-f]{64}", expected):
+        raise IdentifierMigrationError("plan has no valid SHA-256 seal")
+    unsealed = {key: value for key, value in plan.items() if key != "plan_sha256"}
+    canonical = json.dumps(unsealed, sort_keys=True, separators=(",", ":")).encode()
+    actual = hashlib.sha256(canonical).hexdigest()
+    if actual != expected:
+        raise IdentifierMigrationError("plan SHA-256 mismatch")
+    return expected
+
+
+def _repository_mappings(
+    plan: dict[str, Any], repo_slug: str
+) -> tuple[list[dict[str, Any]], int]:
+    matches = [item for item in plan.get("repositories", []) if item.get("repo") == repo_slug]
+    if len(matches) != 1:
+        raise IdentifierMigrationError(
+            f"repository {repo_slug!r} must occur exactly once in plan"
+        )
+    repository = matches[0]
+    if repository.get("eligible") is not True or repository.get("atomic_unit") is not True:
+        raise IdentifierMigrationError(f"repository {repo_slug!r} is not eligible and atomic")
+
+    replacements: list[dict[str, Any]] = []
+    assignments = 0
+    seen_old: set[uuid.UUID] = set()
+    seen_new: set[uuid.UUID] = set()
+    for raw in repository.get("mappings", []):
+        action = raw.get("action")
+        if action == "assign":
+            assignments += 1
+            continue
+        if action == "unchanged":
+            continue
+        if action != "replace":
+            raise IdentifierMigrationError(f"unsupported mapping action {action!r}")
+        if raw.get("repo") != repo_slug:
+            raise IdentifierMigrationError("mapping repository does not match atomic unit")
+        kind = raw.get("kind")
+        record_id = raw.get("record_id")
+        if kind not in {"workplan", "task"}:
+            raise IdentifierMigrationError(f"unsupported record kind {kind!r}")
+        if not isinstance(record_id, str) or not _RECORD_ID_RE.fullmatch(record_id):
+            raise IdentifierMigrationError(f"noncanonical record id {record_id!r}")
+        try:
+            old_id = uuid.UUID(str(raw.get("current_uuid")))
+            new_id = uuid.UUID(str(raw.get("derived_uuid")))
+        except (TypeError, ValueError) as exc:
+            raise IdentifierMigrationError(f"invalid UUID mapping for {record_id}") from exc
+        expected_new = uuid.uuid5(
+            DERIVATION_NAMESPACE_UUID,
+            f"{FLEET_NAMESPACE}\n{record_id}",
+        )
+        if new_id != expected_new:
+            raise IdentifierMigrationError(f"derived UUID mismatch for {record_id}")
+        if old_id == new_id or old_id in seen_old or new_id in seen_new:
+            raise IdentifierMigrationError(f"non-unique replacement for {record_id}")
+        seen_old.add(old_id)
+        seen_new.add(new_id)
+        replacements.append(
+            {
+                "kind": kind,
+                "record_id": record_id,
+                "old_id": old_id,
+                "new_id": new_id,
+            }
+        )
+    return replacements, assignments
+
+
+def _repository_entry(plan: dict[str, Any], repo_slug: str) -> dict[str, Any]:
+    matches = [item for item in plan.get("repositories", []) if item.get("repo") == repo_slug]
+    if len(matches) != 1:
+        raise IdentifierMigrationError(
+            f"repository {repo_slug!r} must occur exactly once in plan"
+        )
+    return matches[0]
+
+
+def _repair_unit_mappings(
+    plan: dict[str, Any], repo_slug: str, unit: dict[str, Any]
+) -> tuple[dict[str, Any], list[dict[str, Any]]]:
+    replacements, _assignments = _repository_mappings(plan, repo_slug)
+    workplan = unit.get("workplan")
+    tasks = unit.get("tasks")
+    if not isinstance(workplan, dict) or not isinstance(tasks, list):
+        raise IdentifierMigrationError("repair unit requires one workplan and a task list")
+
+    workplan_record_id = workplan.get("record_id")
+    workplan_matches = [
+        mapping
+        for mapping in replacements
+        if mapping["kind"] == "workplan" and mapping["record_id"] == workplan_record_id
+    ]
+    if len(workplan_matches) != 1:
+        raise IdentifierMigrationError(
+            "repair workplan must occur exactly once as a replacement in the sealed plan"
+        )
+    workplan_mapping = workplan_matches[0]
+    raw_workplan_mapping = next(
+        raw
+        for raw in _repository_entry(plan, repo_slug).get("mappings", [])
+        if raw.get("kind") == "workplan" and raw.get("record_id") == workplan_record_id
+    )
+    authoritative_path = raw_workplan_mapping.get("path")
+    if not isinstance(authoritative_path, str) or not authoritative_path:
+        raise IdentifierMigrationError("sealed workplan mapping has no authoritative path")
+
+    task_record_ids = [task.get("record_id") for task in tasks if isinstance(task, dict)]
+    if len(task_record_ids) != len(tasks) or len(set(task_record_ids)) != len(tasks):
+        raise IdentifierMigrationError("repair task record ids must be explicit and unique")
+    task_mappings = [
+        mapping
+        for mapping in replacements
+        if mapping["kind"] == "task" and mapping["record_id"] in task_record_ids
+    ]
+    mapped_task_ids = {mapping["record_id"] for mapping in task_mappings}
+    if mapped_task_ids != set(task_record_ids):
+        raise IdentifierMigrationError(
+            "repair tasks do not exactly match replacement mappings in the sealed plan"
+        )
+
+    raw_unit_task_ids = {
+        raw.get("record_id")
+        for raw in _repository_entry(plan, repo_slug).get("mappings", [])
+        if raw.get("kind") == "task"
+        and raw.get("action") == "replace"
+        and raw.get("path") == authoritative_path
+    }
+    if raw_unit_task_ids != set(task_record_ids):
+        raise IdentifierMigrationError(
+            "repair must include every replaced task in the sealed workplan unit"
+        )
+    return workplan_mapping, task_mappings
+
+
+def _uuid_field(value: Any, label: str) -> uuid.UUID:
+    try:
+        return uuid.UUID(str(value))
+    except (TypeError, ValueError) as exc:
+        raise IdentifierMigrationError(f"invalid UUID for {label}") from exc
+
+
+def _repair_payloads(
+    unit: dict[str, Any],
+    workplan_mapping: dict[str, Any],
+    task_mappings: list[dict[str, Any]],
+) -> tuple[dict[str, Any], list[dict[str, Any]]]:
+    raw_workplan = unit["workplan"]
+    if _uuid_field(raw_workplan.get("id"), "workplan") != workplan_mapping["old_id"]:
+        raise IdentifierMigrationError("repair workplan UUID does not match sealed old UUID")
+    slug = raw_workplan.get("slug")
+    title = raw_workplan.get("title")
+    status = raw_workplan.get("status")
+    if not isinstance(slug, str) or not slug or not isinstance(title, str) or not title:
+        raise IdentifierMigrationError("repair workplan requires explicit slug and title")
+    if status not in {
+        "proposed", "ready", "active", "blocked", "backlog", "finished", "archived"
+    }:
+        raise IdentifierMigrationError(f"unsupported repair workplan status {status!r}")
+    workplan_payload = {
+        "id": workplan_mapping["old_id"],
+        "topic_id": _uuid_field(raw_workplan.get("topic_id"), "workplan topic"),
+        "slug": slug,
+        "title": title,
+        "description": raw_workplan.get("description"),
+        "status": status,
+        "owner": raw_workplan.get("owner"),
+        "planning_priority": raw_workplan.get("planning_priority"),
+        "planning_order": raw_workplan.get("planning_order"),
+    }
+
+    mappings_by_record = {mapping["record_id"]: mapping for mapping in task_mappings}
+    task_payloads: list[dict[str, Any]] = []
+    for raw_task in unit["tasks"]:
+        mapping = mappings_by_record[raw_task["record_id"]]
+        if _uuid_field(raw_task.get("id"), raw_task["record_id"]) != mapping["old_id"]:
+            raise IdentifierMigrationError(
+                f"repair task UUID does not match sealed old UUID for {raw_task['record_id']}"
+            )
+        title = raw_task.get("title")
+        if not isinstance(title, str) or not title:
+            raise IdentifierMigrationError(
+                f"repair task {raw_task['record_id']} requires an explicit title"
+            )
+        try:
+            status_value = TaskStatus(raw_task.get("status", "todo"))
+            priority_value = TaskPriority(raw_task.get("priority", "medium"))
+        except ValueError as exc:
+            raise IdentifierMigrationError(
+                f"invalid task state for {raw_task['record_id']}"
+            ) from exc
+        parent_record_id = raw_task.get("parent_record_id")
+        if parent_record_id is not None and parent_record_id not in mappings_by_record:
+            raise IdentifierMigrationError(
+                f"parent task for {raw_task['record_id']} is outside the sealed repair unit"
+            )
+        task_payloads.append(
+            {
+                "record_id": raw_task["record_id"],
+                "id": mapping["old_id"],
+                "title": title,
+                "description": raw_task.get("description"),
+                "status": status_value,
+                "priority": priority_value,
+                "assignee": raw_task.get("assignee"),
+                "blocking_reason": raw_task.get("blocking_reason"),
+                "needs_human": bool(raw_task.get("needs_human", False)),
+                "intervention_note": raw_task.get("intervention_note"),
+                "parent_task_id": (
+                    mappings_by_record[parent_record_id]["old_id"]
+                    if parent_record_id is not None
+                    else None
+                ),
+            }
+        )
+        if task_payloads[-1]["needs_human"] and not task_payloads[-1]["intervention_note"]:
+            raise IdentifierMigrationError(
+                f"repair task {raw_task['record_id']} needs an intervention note"
+            )
+        if (
+            task_payloads[-1]["status"] == TaskStatus.wait
+            and task_payloads[-1]["needs_human"]
+            and not task_payloads[-1]["blocking_reason"]
+        ):
+            raise IdentifierMigrationError(
+                f"repair task {raw_task['record_id']} needs a blocking reason"
+            )
+
+    pending = list(task_payloads)
+    ordered: list[dict[str, Any]] = []
+    emitted: set[uuid.UUID] = set()
+    while pending:
+        ready = [
+            task
+            for task in pending
+            if task["parent_task_id"] is None or task["parent_task_id"] in emitted
+        ]
+        if not ready:
+            raise IdentifierMigrationError("repair task parentage contains a cycle")
+        for task in ready:
+            pending.remove(task)
+            ordered.append(task)
+            emitted.add(task["id"])
+    return workplan_payload, ordered
+
+
+def _same_workplan(row: Workplan, expected: dict[str, Any], repo_id: uuid.UUID) -> bool:
+    fields = (
+        "id", "topic_id", "slug", "title", "description", "status", "owner",
+        "planning_priority", "planning_order",
+    )
+    return row.repo_id == repo_id and all(
+        getattr(row, field) == expected[field] for field in fields
+    )
+
+
+def _same_task(row: Task, expected: dict[str, Any], workplan_id: uuid.UUID) -> bool:
+    fields = (
+        "id", "title", "description", "status", "priority", "assignee",
+        "blocking_reason", "needs_human", "intervention_note", "parent_task_id",
+    )
+    return row.workplan_id == workplan_id and all(
+        getattr(row, field) == expected[field] for field in fields
+    )
+
+
+_TASK_DUPLICATE_FIELDS = (
+    "workplan_id",
+    "title",
+    "description",
+    "status",
+    "priority",
+    "assignee",
+    "due_date",
+    "blocking_reason",
+    "needs_human",
+    "intervention_note",
+    "parent_task_id",
+)
+
+
+def _same_duplicate_task(
+    legacy: Task,
+    derived: Task,
+    record_id: str,
+) -> bool:
+    """Accept only a deterministic duplicate of an otherwise identical legacy row."""
+    return (
+        legacy.record_id in {None, record_id}
+        and derived.record_id == record_id
+        and all(
+            getattr(legacy, field) == getattr(derived, field)
+            for field in _TASK_DUPLICATE_FIELDS
+        )
+    )
+
+
+async def _task_reference_count(session: AsyncSession, task_id: uuid.UUID) -> int:
+    """Count every inbound task reference before duplicate coalescence.
+
+    Coalescence deliberately refuses referenced legacy rows. Updating references
+    could collide with relationships already attached to the deterministic row;
+    a zero-reference proof keeps the repair lossless and reversible.
+    """
+    return int(
+        await session.scalar(
+            text(
+                "SELECT "
+                "(SELECT count(*) FROM token_events WHERE task_id = :task_id) + "
+                "(SELECT count(*) FROM tasks WHERE parent_task_id = :task_id) + "
+                "(SELECT count(*) FROM review_contracts WHERE task_id = :task_id) + "
+                "(SELECT count(*) FROM progress_events WHERE task_id = :task_id) + "
+                "(SELECT count(*) FROM capability_requests WHERE blocking_task_id = :task_id) + "
+                "(SELECT count(*) FROM workplan_dependencies WHERE to_task_id = :task_id) + "
+                "(SELECT count(*) FROM suggestions WHERE promoted_task_id = :task_id)"
+            ),
+            {"task_id": task_id},
+        )
+        or 0
+    )
+
+
+async def repair_absent_prederivation_projection(
+    session: AsyncSession,
+    plan: dict[str, Any],
+    repo_slug: str,
+    unit: dict[str, Any],
+    *,
+    expected_plan_sha256: str,
+    source_revision: str,
+    source_fingerprint: str,
+    source_clean: bool,
+    source_synchronized: bool,
+    primary_confirmed: bool,
+    projection_identity: str,
+    observed_at: datetime | None = None,
+) -> SealedProjectionRepairReceipt:
+    """Restore one exact random-ID workplan unit into an absent projection.
+
+    This is intentionally separate from ordinary consistency repair. The caller
+    must independently prove Git cleanliness/synchronization and provide the
+    authoritative unit parsed from the pinned source revision.
+    """
+    plan_sha256 = verify_plan(plan)
+    if plan_sha256 != expected_plan_sha256:
+        raise IdentifierMigrationError("explicit plan SHA-256 does not match sealed plan")
+    if not primary_confirmed:
+        raise IdentifierMigrationError("projection repair requires explicit primary confirmation")
+    if not source_clean or not source_synchronized:
+        raise IdentifierMigrationError("projection repair requires a clean synchronized source")
+    if not re.fullmatch(r"[0-9a-f]{40}", source_revision):
+        raise IdentifierMigrationError("source revision must be a full Git SHA")
+    if not re.fullmatch(r"[0-9a-f]{64}", source_fingerprint):
+        raise IdentifierMigrationError("source fingerprint must be SHA-256")
+    if not projection_identity.strip():
+        raise IdentifierMigrationError("projection identity is required")
+
+    repository_entry = _repository_entry(plan, repo_slug)
+    if source_revision != repository_entry.get("planned_head_sha"):
+        raise IdentifierMigrationError("source revision drifted from sealed plan")
+    if source_fingerprint != repository_entry.get("source_fingerprint"):
+        raise IdentifierMigrationError("source fingerprint drifted from sealed plan")
+    workplan_mapping, task_mappings = _repair_unit_mappings(plan, repo_slug, unit)
+    workplan_payload, task_payloads = _repair_payloads(
+        unit, workplan_mapping, task_mappings
+    )
+    if session.in_transaction():
+        raise IdentifierMigrationError("projection repair requires a fresh database session")
+
+    outcome = "repaired"
+    async with session.begin():
+        resolution = await resolve_repository_slug(session, repo_slug, required=False)
+        if resolution is None:
+            raise IdentifierMigrationError(f"repository projection is absent: {repo_slug}")
+        repo = await session.scalar(
+            select(ManagedRepo)
+            .where(ManagedRepo.id == resolution.repo.id)
+            .with_for_update()
+        )
+        if repo.topic_id != workplan_payload["topic_id"]:
+            raise IdentifierMigrationError("repair topic does not match repository projection")
+
+        old_ids = [workplan_mapping["old_id"], *(m["old_id"] for m in task_mappings)]
+        new_workplan = await session.get(Workplan, workplan_mapping["new_id"])
+        new_tasks = [await session.get(Task, mapping["new_id"]) for mapping in task_mappings]
+        if new_workplan is not None or any(task is not None for task in new_tasks):
+            raise IdentifierMigrationError("derived target presence blocks projection repair")
+        alias_count = await session.scalar(
+            select(func.count()).select_from(WorkRecordIdentifierAlias).where(
+                WorkRecordIdentifierAlias.old_id.in_(old_ids)
+            )
+        )
+        if alias_count:
+            raise IdentifierMigrationError("durable alias presence blocks projection repair")
+
+        old_workplan = await session.get(Workplan, workplan_mapping["old_id"])
+        old_tasks = [await session.get(Task, mapping["old_id"]) for mapping in task_mappings]
+        present_count = int(old_workplan is not None) + sum(task is not None for task in old_tasks)
+        expected_count = 1 + len(task_mappings)
+        if present_count not in {0, expected_count}:
+            raise IdentifierMigrationError("partial old projection presence blocks repair")
+
+        if present_count == expected_count:
+            if not _same_workplan(old_workplan, workplan_payload, repo.id):
+                raise IdentifierMigrationError(
+                    "existing old workplan differs from sealed repair unit"
+                )
+            expected_tasks = {task["id"]: task for task in task_payloads}
+            if any(
+                not _same_task(task, expected_tasks[task.id], workplan_mapping["old_id"])
+                for task in old_tasks
+            ):
+                raise IdentifierMigrationError("existing old tasks differ from sealed repair unit")
+            outcome = "verified_noop"
+        else:
+            slug_conflict = await session.scalar(
+                select(Workplan.id).where(Workplan.slug == workplan_payload["slug"])
+            )
+            if slug_conflict is not None:
+                raise IdentifierMigrationError("workplan slug is already projected")
+            session.add(
+                Workplan(repo_id=repo.id, **workplan_payload)
+            )
+            await session.flush()
+            for task_payload in task_payloads:
+                values = {key: value for key, value in task_payload.items() if key != "record_id"}
+                session.add(Task(workplan_id=workplan_mapping["old_id"], **values))
+            await session.flush()
+
+    timestamp = observed_at or datetime.now(UTC)
+    if timestamp.tzinfo is None:
+        raise IdentifierMigrationError("receipt observation time must be timezone-aware")
+    return SealedProjectionRepairReceipt(
+        schema="state-hub.sealed-prederivation-projection-repair-receipt.v1",
+        outcome=outcome,
+        repo_slug=repo_slug,
+        repository_id=str(repo.id),
+        workplan_record_id=workplan_mapping["record_id"],
+        workplan_old_id=str(workplan_mapping["old_id"]),
+        task_records=tuple(
+            (mapping["record_id"], str(mapping["old_id"])) for mapping in task_mappings
+        ),
+        plan_sha256=plan_sha256,
+        source_revision=source_revision,
+        source_fingerprint=source_fingerprint,
+        projection_identity=projection_identity,
+        observed_at=timestamp.astimezone(UTC).isoformat().replace("+00:00", "Z"),
+    )
+
+
+async def _assert_projection_preconditions(
+    session: AsyncSession,
+    repository_id: uuid.UUID,
+    repo_slug: str,
+    replacements: list[dict[str, Any]],
+    *,
+    reverse: bool,
+) -> dict[str, str]:
+    states: dict[str, str] = {}
+    for mapping in replacements:
+        source_id = mapping["new_id"] if reverse else mapping["old_id"]
+        target_id = mapping["old_id"] if reverse else mapping["new_id"]
+        if mapping["kind"] == "workplan":
+            query = text(
+                "SELECT workplans.id, workplans.repo_id, workplans.slug "
+                "FROM workplans WHERE workplans.id = :record_id FOR UPDATE"
+            )
+        else:
+            query = text(
+                "SELECT tasks.id, workplans.repo_id, tasks.record_id "
+                "FROM tasks "
+                "JOIN workplans ON workplans.id = tasks.workplan_id "
+                "WHERE tasks.id = :record_id FOR UPDATE"
+            )
+        source = (await session.execute(query, {"record_id": source_id})).one_or_none()
+        target = (await session.execute(query, {"record_id": target_id})).one_or_none()
+        for label, row in (("source", source), ("target", target)):
+            if row is not None and row.repo_id != repository_id:
+                raise IdentifierMigrationError(
+                    f"{label} {mapping['kind']} {row.id} belongs to another repository"
+                )
+
+        if reverse:
+            if source is None:
+                raise IdentifierMigrationError(
+                    f"source {mapping['kind']} {source_id} is absent from repository {repo_slug}"
+                )
+            if target is not None:
+                raise IdentifierMigrationError(
+                    f"target {mapping['kind']} {target_id} already exists"
+                )
+            states[mapping["record_id"]] = "derived_source"
+            continue
+
+        if source is not None and target is not None:
+            if mapping["kind"] != "task":
+                raise IdentifierMigrationError(
+                    f"both legacy and derived {mapping['kind']} rows exist for {mapping['record_id']}"
+                )
+            legacy_task = await session.scalar(
+                select(Task).where(Task.id == source_id).with_for_update()
+            )
+            derived_task = await session.scalar(
+                select(Task).where(Task.id == target_id).with_for_update()
+            )
+            if (
+                legacy_task is None
+                or derived_task is None
+                or not _same_duplicate_task(
+                    legacy_task, derived_task, mapping["record_id"]
+                )
+            ):
+                raise IdentifierMigrationError(
+                    f"legacy and derived task rows differ for {mapping['record_id']}"
+                )
+            references = await _task_reference_count(session, source_id)
+            if references:
+                raise IdentifierMigrationError(
+                    f"legacy duplicate task has {references} inbound references for "
+                    f"{mapping['record_id']}"
+                )
+            states[mapping["record_id"]] = "duplicate_target"
+            continue
+        if source is None and target is None:
+            raise IdentifierMigrationError(
+                f"neither legacy nor derived {mapping['kind']} row exists for {mapping['record_id']}"
+            )
+        if source is not None:
+            states[mapping["record_id"]] = "legacy_source"
+            continue
+
+        # A pre-existing derived target is safe only when it already represents
+        # the canonical record from this repository. This is the state produced
+        # when forge reconciliation reached a partial projection before the
+        # sealed file migration did.
+        identity = target.slug if mapping["kind"] == "workplan" else target.record_id
+        if not isinstance(identity, str) or identity.strip().lower() != mapping["record_id"].lower():
+            raise IdentifierMigrationError(
+                f"derived target identity mismatch for {mapping['record_id']}"
+            )
+        states[mapping["record_id"]] = "derived_target"
+    return states
+
+
+async def apply_repository_identifier_migration(
+    session: AsyncSession,
+    plan: dict[str, Any],
+    repo_slug: str,
+) -> IdentifierMigrationResult:
+    """Replace one repository's projected UUIDs in one database transaction."""
+    plan_sha256 = verify_plan(plan)
+    replacements, assignments = _repository_mappings(plan, repo_slug)
+    if session.in_transaction():
+        raise IdentifierMigrationError("migration requires a fresh database session")
+
+    async with session.begin():
+        resolution = await resolve_repository_slug(session, repo_slug, required=False)
+        if resolution is None:
+            raise IdentifierMigrationError(f"repository projection is absent: {repo_slug}")
+        projection_states = await _assert_projection_preconditions(
+            session, resolution.repo.id, repo_slug, replacements, reverse=False
+        )
+        aliases = {
+            alias.old_id: alias
+            for alias in (
+                await session.execute(
+                    select(WorkRecordIdentifierAlias).where(
+                        WorkRecordIdentifierAlias.old_id.in_(
+                            [mapping["old_id"] for mapping in replacements]
+                        )
+                    )
+                )
+            ).scalars()
+        }
+        for mapping in replacements:
+            alias = aliases.get(mapping["old_id"])
+            if alias is None:
+                alias = WorkRecordIdentifierAlias(
+                    old_id=mapping["old_id"],
+                    new_id=mapping["new_id"],
+                    record_kind=mapping["kind"],
+                    record_id=mapping["record_id"],
+                    repo_slug=repo_slug,
+                    namespace=FLEET_NAMESPACE,
+                    plan_sha256=plan_sha256,
+                )
+                session.add(alias)
+                aliases[mapping["old_id"]] = alias
+            elif (
+                alias.new_id != mapping["new_id"]
+                or alias.record_kind != mapping["kind"]
+                or alias.record_id != mapping["record_id"]
+                or alias.repo_slug != repo_slug
+                or alias.namespace != FLEET_NAMESPACE
+                or alias.plan_sha256 != plan_sha256
+                or alias.migration_status not in {"reversed", "applied"}
+            ):
+                raise IdentifierMigrationError(
+                    f"conflicting durable alias for {mapping['old_id']}"
+                )
+        await session.flush()
+
+        for mapping in (
+            item
+            for item in replacements
+            if projection_states[item["record_id"]] == "duplicate_target"
+        ):
+            result = await session.execute(
+                text("DELETE FROM tasks WHERE id = :old_id"),
+                {"old_id": mapping["old_id"]},
+            )
+            if result.rowcount != 1:
+                raise IdentifierMigrationError(
+                    f"failed to coalesce duplicate {mapping['record_id']}"
+                )
+
+        for kind in ("workplan", "task"):
+            table = "workplans" if kind == "workplan" else "tasks"
+            for mapping in (
+                item
+                for item in replacements
+                if item["kind"] == kind
+                and projection_states[item["record_id"]] == "legacy_source"
+            ):
+                result = await session.execute(
+                    text(f"UPDATE {table} SET id = :new_id WHERE id = :old_id"),
+                    {"old_id": mapping["old_id"], "new_id": mapping["new_id"]},
+                )
+                if result.rowcount != 1:
+                    raise IdentifierMigrationError(
+                        f"failed to replace {mapping['record_id']}"
+                    )
+
+        now = datetime.now(UTC)
+        for alias in aliases.values():
+            alias.migration_status = "applied"
+            alias.applied_at = now
+            alias.reversed_at = None
+
+    return IdentifierMigrationResult(
+        repo_slug=repo_slug,
+        plan_sha256=plan_sha256,
+        direction="forward",
+        replacements=len(replacements),
+        migrated=sum(
+            state in {"legacy_source", "duplicate_target"}
+            for state in projection_states.values()
+        ),
+        already_derived=sum(
+            state == "derived_target" for state in projection_states.values()
+        ),
+        assignments_deferred=assignments,
+    )
+
+
+async def reverse_repository_identifier_migration(
+    session: AsyncSession,
+    plan: dict[str, Any],
+    repo_slug: str,
+) -> IdentifierMigrationResult:
+    """Restore one repository's prior projected UUIDs and retain aliases."""
+    plan_sha256 = verify_plan(plan)
+    replacements, assignments = _repository_mappings(plan, repo_slug)
+    if session.in_transaction():
+        raise IdentifierMigrationError("migration requires a fresh database session")
+
+    async with session.begin():
+        resolution = await resolve_repository_slug(session, repo_slug, required=False)
+        if resolution is None:
+            raise IdentifierMigrationError(f"repository projection is absent: {repo_slug}")
+        aliases = list(
+            (
+                await session.execute(
+                    select(WorkRecordIdentifierAlias).where(
+                        WorkRecordIdentifierAlias.plan_sha256 == plan_sha256,
+                        WorkRecordIdentifierAlias.repo_slug == repo_slug,
+                    )
+                )
+            ).scalars()
+        )
+        aliases_by_old = {alias.old_id: alias for alias in aliases}
+        if len(aliases_by_old) != len(replacements):
+            raise IdentifierMigrationError("durable alias set is incomplete")
+        for mapping in replacements:
+            alias = aliases_by_old.get(mapping["old_id"])
+            if (
+                alias is None
+                or alias.new_id != mapping["new_id"]
+                or alias.record_kind != mapping["kind"]
+                or alias.record_id != mapping["record_id"]
+                or alias.migration_status != "applied"
+            ):
+                raise IdentifierMigrationError(
+                    f"durable alias is not applied for {mapping['record_id']}"
+                )
+        await _assert_projection_preconditions(
+            session, resolution.repo.id, repo_slug, replacements, reverse=True
+        )
+
+        for kind in ("task", "workplan"):
+            table = "tasks" if kind == "task" else "workplans"
+            for mapping in (item for item in replacements if item["kind"] == kind):
+                result = await session.execute(
+                    text(f"UPDATE {table} SET id = :old_id WHERE id = :new_id"),
+                    {"old_id": mapping["old_id"], "new_id": mapping["new_id"]},
+                )
+                if result.rowcount != 1:
+                    raise IdentifierMigrationError(
+                        f"failed to reverse {mapping['record_id']}"
+                    )
+
+        now = datetime.now(UTC)
+        for alias in aliases:
+            alias.migration_status = "reversed"
+            alias.reversed_at = now
+
+    return IdentifierMigrationResult(
+        repo_slug=repo_slug,
+        plan_sha256=plan_sha256,
+        direction="reverse",
+        replacements=len(replacements),
+        migrated=len(replacements),
+        already_derived=0,
+        assignments_deferred=assignments,
+    )
diff --git a/api/services/write_idempotency.py b/api/services/write_idempotency.py
index fb0c646..7d8c543 100644
--- a/api/services/write_idempotency.py
+++ b/api/services/write_idempotency.py
@@ -41,15 +41,16 @@ WRITE_ROUTE_RULES: tuple[WriteRouteRule, ...] = (
     WriteRouteRule("POST", r"/decisions", "append", "record decision"),
     WriteRouteRule("PATCH", r"/tasks/[^/]+", "replace", "update task"),
     WriteRouteRule("POST", r"/tasks/bulk-status-sync", "replace", "bulk task status sync"),
+    WriteRouteRule(
+        "POST",
+        r"/repos/[^/]+/work-record-projection/reconcile",
+        "replace",
+        "reconcile one forge-derived repository projection",
+    ),
     WriteRouteRule("PATCH", r"/decisions/[^/]+", "replace", "update decision"),
     WriteRouteRule("POST", r"/decisions/[^/]+/resolve", "replace", "resolve decision"),
     WriteRouteRule("PATCH", r"/workplans/[^/]+", "replace", "update workplan"),
     WriteRouteRule("PATCH", r"/workstreams/[^/]+", "replace", "update legacy workstream alias"),
-    WriteRouteRule("POST", r"/suggestions", "append", "create suggestion"),
-    WriteRouteRule("POST", r"/suggestions/[^/]+/vet", "replace", "vet suggestion"),
-    WriteRouteRule("POST", r"/suggestions/[^/]+/decline", "replace", "decline suggestion"),
-    WriteRouteRule("POST", r"/suggestions/[^/]+/promote", "replace", "promote suggestion to task"),
-    WriteRouteRule("POST", r"/suggestions/[^/]+/bump-relevance", "append", "bump suggestion relevance"),
 )
 
 
diff --git a/api/work_record_flavor.py b/api/work_record_flavor.py
new file mode 100644
index 0000000..5fc9fe3
--- /dev/null
+++ b/api/work_record_flavor.py
@@ -0,0 +1,48 @@
+"""Work-record flavor (STATE-WP-0092).
+
+Flavor is a closed bucket on workplans and tasks, orthogonal to kind and
+status. Unset flavor is not residual.
+"""
+
+from __future__ import annotations
+
+from typing import Any
+
+WORK_RECORD_FLAVORS: tuple[str, ...] = (
+    "planning",
+    "implementation",
+    "refactoring",
+    "extension",
+    "residual",
+)
+RESIDUAL_FLAVOR = "residual"
+FLAVOR_PROMOTION_REASONS: tuple[str, ...] = ("demand", "risk")
+
+_EMPTY = {"", "~", "null", "none", "nil"}
+
+
+def normalize_flavor(value: Any) -> str | None:
+    if value is None:
+        return None
+    text = str(value).strip().lower()
+    if text in _EMPTY:
+        return None
+    return text
+
+
+def is_known_flavor(value: Any) -> bool:
+    flavor = normalize_flavor(value)
+    return flavor is None or flavor in WORK_RECORD_FLAVORS
+
+
+def is_residual_flavor(value: Any) -> bool:
+    return normalize_flavor(value) == RESIDUAL_FLAVOR
+
+
+def normalize_promotion_reason(value: Any) -> str | None:
+    if value is None:
+        return None
+    text = str(value).strip().lower()
+    if text in _EMPTY:
+        return None
+    return text
diff --git a/custodian_cli.py b/custodian_cli.py
index f0638b9..f777e44 100644
--- a/custodian_cli.py
+++ b/custodian_cli.py
@@ -18,9 +18,11 @@ import re
 import subprocess
 import sys
 import urllib.error
+import urllib.parse
 import urllib.request
 from pathlib import Path
 
+from repository_rename_cli import configure_repo_commands
 from statehub_register import run_register as run_statehub_register
 
 STATE_HUB_DIR = Path(__file__).resolve().parent
@@ -402,6 +404,8 @@ def cmd_fix_consistency(args: argparse.Namespace) -> None:
         cmd.append("--remote")
     if args.no_writeback:
         cmd.append("--no-writeback")
+    if getattr(args, "bootstrap_empty_projection", False):
+        cmd.append("--bootstrap-empty-projection")
     if args.archive_closed:
         cmd.append("--archive-closed")
     if args.archive_workplan:
@@ -422,6 +426,53 @@ def cmd_fix_consistency(args: argparse.Namespace) -> None:
     sys.exit(exit_code)
 
 
+def cmd_quality_debt(args: argparse.Namespace) -> None:
+    """List DoX quality debt (STATE-WP-0077) — ready without DoR-Ok, etc."""
+    script = STATE_HUB_DIR / "scripts" / "quality_debt.py"
+    if not script.exists():
+        print(f"ERROR: quality_debt.py not found at {script}")
+        sys.exit(1)
+    cmd = [sys.executable, str(script)]
+    if args.repo_path:
+        cmd.extend(["--repo-path", str(Path(args.repo_path).expanduser().resolve())])
+    else:
+        cmd.append("--here")
+    if args.api_base:
+        cmd.extend(["--api-base", args.api_base])
+    if args.no_hub:
+        cmd.append("--no-hub")
+    if args.as_json:
+        cmd.append("--json")
+    if args.strict:
+        cmd.append("--strict")
+    result = subprocess.run(cmd)
+    sys.exit(result.returncode)
+
+
+def cmd_promote_intake(args: argparse.Namespace) -> None:
+    """Promote a routed intake into a workplan, task, decision, or engagement."""
+    script = STATE_HUB_DIR / "scripts" / "promote_intake.py"
+    if not script.exists():
+        print(f"ERROR: promote_intake.py not found at {script}")
+        sys.exit(1)
+
+    cmd = [
+        sys.executable, str(script), args.intake_id,
+        "--to", args.to,
+        "--repo-path", str(Path(args.repo_path).expanduser().resolve()),
+        "--repo-slug", args.repo_slug,
+        "--domain", args.domain,
+        "--api-base", args.api_base,
+    ]
+    if args.target_file:
+        cmd.extend(["--target-file", args.target_file])
+    if args.workplan_file:
+        cmd.extend(["--workplan-file", args.workplan_file])
+
+    result = subprocess.run(cmd)
+    sys.exit(result.returncode)
+
+
 def cmd_create_workstream(args: argparse.Namespace) -> None:
     """Create a workstream under a domain's topic."""
     _api_get("/state/health")
@@ -508,12 +559,22 @@ def cmd_status(_args: argparse.Namespace) -> None:
     """Quick status: API health + summary totals."""
     health = _api_get("/state/health")
     print(f"API: {health.get('status', '?')}  DB: {health.get('db', '?')}")
+    # Which instance answered, not merely that one did.
+    role = health.get("instance_role") or "undeclared"
+    label = health.get("instance_label")
+    print(f"Instance: {role}{f' ({label})' if label else ''}")
     summary = _api_get("/state/summary")
     t = summary["totals"]
-    print(f"Topics: {t['topics']['active']} active")
-    print(f"Workstreams: {t['workstreams']['active']} active, {t['workstreams']['blocked']} blocked")
-    print(f"Tasks: {t['tasks']['in_progress']} in-progress, {t['tasks']['todo']} todo, {t['tasks']['blocked']} blocked")
-    print(f"Decisions: {t['decisions']['open']} open, {t['decisions']['escalated']} escalated")
+    topics = t.get("topics", {})
+    workplans = t.get("workplans") or t.get("workstreams", {})
+    tasks = t.get("tasks", {})
+    decisions = t.get("decisions", {})
+    print(f"API base: {API_BASE}")
+    print(f"Topics: {topics.get('active', 0)} active")
+    print(f"Workplans: {workplans.get('active', 0)} active, {workplans.get('blocked', 0)} blocked")
+    # Task statuses are wait|todo|progress|done|cancel (see workplan-convention.md).
+    print(f"Tasks: {tasks.get('progress', 0)} in-progress, {tasks.get('todo', 0)} todo, {tasks.get('wait', 0)} waiting")
+    print(f"Decisions: {decisions.get('open', 0)} open, {decisions.get('escalated', 0)} escalated")
     blocking = summary.get("blocking_decisions", [])
     if blocking:
         print(f"\nBlocking decisions ({len(blocking)}):")
@@ -522,6 +583,73 @@ def cmd_status(_args: argparse.Namespace) -> None:
             print(f"  [{deadline}] {d['title']}")
 
 
+def _load_json_file(path: str) -> dict:
+    target = Path(path)
+    try:
+        value = json.loads(target.read_text(encoding="utf-8"))
+    except (OSError, json.JSONDecodeError) as exc:
+        print(f"ERROR: invalid JSON file {target}: {exc}")
+        sys.exit(2)
+    if not isinstance(value, dict):
+        print(f"ERROR: {target} must contain a JSON object")
+        sys.exit(2)
+    return value
+
+
+def _git_source(path: str, repo_slug: str | None = None) -> tuple[Path, dict]:
+    target = Path(path).resolve()
+    try:
+        root = Path(subprocess.check_output(
+            ["git", "-C", str(target.parent), "rev-parse", "--show-toplevel"],
+            text=True,
+        ).strip())
+        revision = subprocess.check_output(
+            ["git", "-C", str(root), "rev-parse", "HEAD"], text=True
+        ).strip()
+        relative = target.relative_to(root).as_posix()
+    except (subprocess.CalledProcessError, ValueError) as exc:
+        print(f"ERROR: {target} must be inside a Git repository: {exc}")
+        sys.exit(2)
+    return target, {"repo": repo_slug or root.name, "path": relative, "revision": revision}
+
+
+def cmd_review_project(args: argparse.Namespace) -> None:
+    """Project a file-authoritative contract wrapper through the direct API."""
+    target, source = _git_source(args.file, args.source_repo)
+    contract = _load_json_file(str(target))
+    payload = contract if "contract" in contract and "source" in contract else {
+        "contract": contract,
+        "source": source,
+        "decision_id": args.decision_id,
+        "workplan_id": args.workplan_id,
+        "task_id": args.task_id,
+        "required_for_decision": args.required_for_decision,
+    }
+    print(json.dumps(
+        _api_post("/review-contracts/projections", payload),
+        indent=2,
+    ))
+
+
+def cmd_review_submit(args: argparse.Namespace) -> None:
+    """Submit a file-authoritative receipt against an active contract."""
+    key = urllib.parse.quote(args.contract_key, safe="")
+    target, source = _git_source(args.file, args.source_repo)
+    receipt = _load_json_file(str(target))
+    if "source" not in receipt:
+        receipt["source"] = source
+    print(json.dumps(
+        _api_post(f"/review-contracts/{key}/receipts", receipt),
+        indent=2,
+    ))
+
+
+def cmd_review_status(args: argparse.Namespace) -> None:
+    """Print the derived owner and gate matrix; never an execution authorization."""
+    key = urllib.parse.quote(args.contract_key, safe="")
+    print(json.dumps(_api_get(f"/review-contracts/{key}/aggregate"), indent=2))
+
+
 
 def _outbox_store(args):
     from api.edge.outbox import OutboxStore, default_outbox_path
@@ -601,6 +729,8 @@ def main() -> None:
     )
     sub = parser.add_subparsers(dest="command", required=True)
 
+    configure_repo_commands(sub)
+
     # register
     statehub_reg = sub.add_parser(
         "register",
@@ -608,6 +738,11 @@ def main() -> None:
     )
     statehub_reg.add_argument("--path", default=os.getcwd(), help="Repo directory (defaults to cwd)")
     statehub_reg.add_argument("--domain", default=None, help="State Hub domain slug")
+    statehub_reg.add_argument(
+        "--topic",
+        default=None,
+        help="Existing active topic slug within the selected domain",
+    )
     statehub_reg.add_argument("--repo-slug", default=None, help="Repo slug (auto-detected if omitted)")
     statehub_reg.add_argument("--wp-prefix", default=None, help="Workplan prefix, e.g. STATE-WP")
     statehub_reg.add_argument("--description", default=None, help="One-sentence repo description")
@@ -673,6 +808,11 @@ def main() -> None:
     fix.add_argument("--remote", action="store_true", help="Pull before fixing; requires --repo or --all")
     fix.add_argument("--max-seconds", type=int, default=None, help="Wall-clock budget for --remote --all")
     fix.add_argument("--no-writeback", action="store_true", help="Disable DB-to-file status writeback")
+    fix.add_argument(
+        "--bootstrap-empty-projection",
+        action="store_true",
+        help="Rebuild file UUIDs only after proving the repo projection is empty",
+    )
     fix.add_argument("--archive-closed", action="store_true", help="Archive closed root workplans after fixing")
     fix.add_argument("--archive-workplan", default=None, help="Archive only the matching workplan id or filename")
     fix.add_argument("--archive-date", default=None, help="YYMMDD archive prefix for --archive-closed")
@@ -684,6 +824,32 @@ def main() -> None:
         help="Preserve checker exit code 2 for warnings-only runs",
     )
 
+    # quality-debt (STATE-WP-0077)
+    qdebt = sub.add_parser(
+        "quality-debt",
+        help="List DoX quality debt: ready without DoR-Ok, finished without DoD-Ok, intakes without DoC-Ok",
+    )
+    qdebt.add_argument("--repo-path", default=None, help="Repo root (default: cwd)")
+    qdebt.add_argument("--api-base", default=API_BASE, help="State Hub API base URL")
+    qdebt.add_argument("--no-hub", action="store_true", help="Skip hub intake scan")
+    qdebt.add_argument("--json", action="store_true", dest="as_json")
+    qdebt.add_argument("--strict", action="store_true", help="Exit 1 if any debt found")
+    qdebt.set_defaults(func=cmd_quality_debt)
+
+    # promote-intake
+    promote = sub.add_parser(
+        "promote-intake",
+        help="Promote a routed intake into a workplan, task, decision, or engagement (CUST-WP-0061-T03)",
+    )
+    promote.add_argument("intake_id", help="UUID of the routed intake")
+    promote.add_argument("--to", required=True, choices=["workplan", "task", "decision", "engagement"])
+    promote.add_argument("--repo-path", default=os.getcwd(), help="Local checkout of the target repo")
+    promote.add_argument("--repo-slug", required=True, help="Registered repo slug")
+    promote.add_argument("--domain", required=True, help="Market domain slug, e.g. infotech")
+    promote.add_argument("--target-file", default=None, help="Repo-relative path (required for decision/engagement)")
+    promote.add_argument("--workplan-file", default=None, help="Repo-relative workplan file path (required for task)")
+    promote.add_argument("--api-base", default=API_BASE, help="State Hub API base URL")
+
     # create-workstream
     cws = sub.add_parser("create-workstream", help="Create a workstream under a domain topic")
     cws.add_argument("--domain", required=True, help="Domain slug to create the workstream under")
@@ -736,6 +902,26 @@ def main() -> None:
     # status
     sub.add_parser("status", help="Show State Hub health and summary totals")
 
+    # review — file-backed multi-owner review projection
+    review = sub.add_parser("review", help="Project and inspect multi-owner review evidence")
+    review_sub = review.add_subparsers(dest="review_command", required=True)
+    review_project = review_sub.add_parser("project", help="Project an authoritative contract wrapper")
+    review_project.add_argument("file")
+    review_project.add_argument("--source-repo", default=None)
+    review_project.add_argument("--decision-id", default=None)
+    review_project.add_argument("--workplan-id", default=None)
+    review_project.add_argument("--task-id", default=None)
+    review_project.add_argument("--required-for-decision", action="store_true")
+    review_project.set_defaults(func=cmd_review_project)
+    review_submit = review_sub.add_parser("submit", help="Submit an authoritative receipt file")
+    review_submit.add_argument("contract_key")
+    review_submit.add_argument("file")
+    review_submit.add_argument("--source-repo", default=None)
+    review_submit.set_defaults(func=cmd_review_submit)
+    review_status = review_sub.add_parser("status", help="Print owner and gate status")
+    review_status.add_argument("contract_key")
+    review_status.set_defaults(func=cmd_review_status)
+
     # dev up — files-first local hub (CUST-WP-0054-T07)
     dev = sub.add_parser("dev", help="Local dev-hub commands")
     dev_sub = dev.add_subparsers(dest="dev_command", required=True)
@@ -767,6 +953,8 @@ def main() -> None:
         cmd_ingest_sbom(args)
     elif args.command == "fix-consistency":
         cmd_fix_consistency(args)
+    elif args.command == "promote-intake":
+        cmd_promote_intake(args)
     elif args.command == "create-workstream":
         cmd_create_workstream(args)
     elif args.command == "create-task":
diff --git a/dashboard/observablehq.config.js b/dashboard/observablehq.config.js
index e30abbe..b749881 100644
--- a/dashboard/observablehq.config.js
+++ b/dashboard/observablehq.config.js
@@ -10,7 +10,9 @@ const _configDir = dirname(fileURLToPath(import.meta.url));
 const _modalScript = readFileSync(
   join(_configDir, "src/components/improvement-modal.js"), "utf-8"
 )
-  .replace(/^export function /gm, "function ")   // strip ES module export
+  // Strip ES module exports so the file can run as a plain <script>.
+  .replace(/^export function /gm, "function ")
+  .replace(/^export const /gm, "const ")
   + "\ninitImprovementModal();\n";               // auto-initialise
 
 export default {
@@ -54,6 +56,8 @@ export default {
       pages: [
         { name: "Repository DoI",  path: "/policy/repo-doi" },
         { name: "Service DoM",     path: "/policy/service-dom" },
+        { name: "Intake DoC",      path: "/policy/intake-doc" },
+        { name: "Work-item DoR",   path: "/policy/work-item-dor" },
         { name: "Workplan DoD", path: "/policy/workstream-dod" },
       ],
     },
@@ -81,7 +85,6 @@ export default {
         { name: "Interventions", path: "/interventions" },
         { name: "Tasks",         path: "/tasks" },
         { name: "UI Feedback",   path: "/ui-feedback" },
-        { name: "Suggestions",   path: "/suggestions" },
         { name: "WSJF Triage",   path: "/wsjf-triage" },
       ],
     },
@@ -102,6 +105,7 @@ export default {
         { name: "Domains",                  path: "/docs/domains" },
         { name: "Goals",                    path: "/docs/goals" },
         { name: "Extension Points",         path: "/docs/extensions" },
+        { name: "Intakes",                  path: "/docs/intakes" },
         { name: "Inter-Repo Communication", path: "/docs/inter-repo-communication" },
         { name: "Interventions",            path: "/docs/interventions" },
         { name: "Live Data",                path: "/docs/live-data" },
@@ -115,15 +119,16 @@ export default {
         { name: "SBOM",                     path: "/docs/sbom" },
         { name: "SCOPE.md",                 path: "/docs/scope" },
         { name: "Service Catalog",          path: "/docs/services" },
+        { name: "Suggestions (archived)",    path: "/docs/suggestions" },
         { name: "Tasks",                    path: "/docs/tasks" },
         { name: "TPSC",                     path: "/docs/tpsc" },
         { name: "TPSC — GDPR Maturity",     path: "/docs/gdpr-maturity" },
         { name: "Technical Debt",           path: "/docs/debt" },
         { name: "Todo",                     path: "/docs/todo" },
+        { name: "Work Records",             path: "/docs/work-records" },
         { name: "Workplan Health",        path: "/docs/workstream-health-index" },
         { name: "Workplan Lifecycle",     path: "/docs/workstream-lifecycle" },
         { name: "Workplans",              path: "/docs/workstreams" },
-        { name: "Suggestions",              path: "/docs/suggestions" },
         { name: "WSJF Triage",              path: "/docs/wsjf-triage" },
       ],
     },
diff --git a/dashboard/src/components/improvement-modal.js b/dashboard/src/components/improvement-modal.js
index c2cdb51..133bc00 100644
--- a/dashboard/src/components/improvement-modal.js
+++ b/dashboard/src/components/improvement-modal.js
@@ -12,10 +12,59 @@
  * Submissions are stored as technical-debt items with debt_type="dashboard-improvement".
  *
  * Interaction:
- *   - Hold Shift → cursor changes to crosshair across the entire page
+ *   - Hold Shift 1s → cursor changes to copy/highlight mode (shift-wait-click)
  *   - Shift+click any element (except form controls) → opens suggestion modal
  */
 
+/** Domain slug for dashboard-improvement TD records (state-hub lives under infotech). */
+export const DEFAULT_IMPROVEMENT_DOMAIN = "infotech";
+const DEFAULT_API = "http://127.0.0.1:8000";
+const API_STORAGE_KEY = "stateHubApiBase";
+
+/**
+ * Resolve API base when init is called without an explicit apiBase.
+ * Mirrors dashboard/src/components/config.js so the modal works when the
+ * dashboard is not on 127.0.0.1 (remote host, tunnel, storage override).
+ */
+export function resolveImprovementApiBase({
+  location = globalThis.location,
+  storage = globalThis.localStorage,
+} = {}) {
+  const clean = (value) => {
+    if (typeof value !== "string") return null;
+    const cleaned = value.trim().replace(/\/+$/, "");
+    return cleaned || null;
+  };
+  try {
+    if (location?.href) {
+      const url = new URL(location.href);
+      for (const name of ["api_base", "apiBase"]) {
+        const q = clean(url.searchParams.get(name));
+        if (q) return q;
+      }
+    }
+  } catch { /* ignore */ }
+  const fromGlobal = clean(globalThis.STATE_HUB_API_BASE);
+  if (fromGlobal) return fromGlobal;
+  try {
+    const fromStorage = clean(storage?.getItem?.(API_STORAGE_KEY));
+    if (fromStorage) return fromStorage;
+  } catch { /* ignore */ }
+  try {
+    if (location?.href) {
+      const url = new URL(location.href);
+      if (!["http:", "https:"].includes(url.protocol)) return DEFAULT_API;
+      if (url.hostname === "::1" || url.hostname === "[::1]") return DEFAULT_API;
+      url.port = globalThis.STATE_HUB_API_PORT || "8000";
+      url.pathname = "";
+      url.search = "";
+      url.hash = "";
+      return url.origin;
+    }
+  } catch { /* ignore */ }
+  return DEFAULT_API;
+}
+
 const _STYLE_ID = "improvement-modal-styles";
 
 function _ensureStyles() {
@@ -239,10 +288,13 @@ let _initialized = false;
  * Safe to call multiple times — only the first call takes effect.
  *
  * @param {object} opts
- * @param {string} opts.apiBase  State Hub API base URL (default: "http://127.0.0.1:8000")
- * @param {string} opts.domain   Domain slug for the TD record  (default: "custodian")
+ * @param {string} [opts.apiBase]  State Hub API base URL (resolved like config.js if omitted)
+ * @param {string} [opts.domain]   Domain slug for the TD record (default: "infotech")
  */
-export function initImprovementModal({ apiBase = "http://127.0.0.1:8000", domain = "custodian" } = {}) {
+export function initImprovementModal({
+  apiBase = resolveImprovementApiBase(),
+  domain = DEFAULT_IMPROVEMENT_DOMAIN,
+} = {}) {
   if (_initialized) return;
   _initialized = true;
   _ensureStyles();
@@ -391,7 +443,10 @@ export function initImprovementModal({ apiBase = "http://127.0.0.1:8000", domain
       try {
         const r = await fetch(`${apiBase}/technical-debt/`, {
           method: "POST",
-          headers: { "Content-Type": "application/json" },
+          headers: {
+            "Content-Type": "application/json",
+            "X-StateHub-Component": "state-hub.dashboard.improvement-modal",
+          },
           body: JSON.stringify(payload),
         });
         if (r.ok) {
@@ -400,7 +455,13 @@ export function initImprovementModal({ apiBase = "http://127.0.0.1:8000", domain
         } else {
           submitBtn.disabled = false;
           submitBtn.textContent = "Submit suggestion";
-          _toast(`⚠ Submission failed (HTTP ${r.status})`);
+          let detail = `HTTP ${r.status}`;
+          try {
+            const body = await r.json();
+            if (typeof body?.detail === "string") detail = body.detail;
+            else if (body?.detail != null) detail = JSON.stringify(body.detail);
+          } catch { /* keep status-only detail */ }
+          _toast(`⚠ Submission failed (${detail})`);
         }
       } catch {
         submitBtn.disabled = false;
diff --git a/dashboard/src/components/workplan-search.js b/dashboard/src/components/workplan-search.js
new file mode 100644
index 0000000..aa355e0
--- /dev/null
+++ b/dashboard/src/components/workplan-search.js
@@ -0,0 +1,22 @@
+/**
+ * Case-insensitive substring match for Overview "Workplans by Repository".
+ * Matches title, repo, domain, filename, owner, and id.
+ *
+ * @param {object} workplan  Row from overview workplan_rows
+ * @param {string} query     Free-text filter
+ * @returns {boolean}
+ */
+export function workplanMatchesSearch(workplan, query) {
+  const q = String(query ?? "").trim().toLowerCase();
+  if (!q) return true;
+  if (!workplan || typeof workplan !== "object") return false;
+  const haystack = [
+    workplan.title,
+    workplan.repo_label,
+    workplan.domain,
+    workplan.workplan_filename,
+    workplan.owner,
+    workplan.id,
+  ].filter(Boolean).join("\n").toLowerCase();
+  return haystack.includes(q);
+}
diff --git a/dashboard/src/decisions.md b/dashboard/src/decisions.md
index e23c8f5..029addf 100644
--- a/dashboard/src/decisions.md
+++ b/dashboard/src/decisions.md
@@ -330,7 +330,13 @@ if (filtered.length === 0) {
 } else {
   display(html`<div class="dec-list">${filtered.map(d => {
     const border  = STATUS_BORDER[d.status] ?? "#ccc";
-    const snippet = (d.description || d.rationale || "").slice(0, 200);
+    const _desc = d.description || "";
+    const _rat  = d.rationale || "";
+    const _primary = _desc || _rat;
+    const snippet = _primary.slice(0, 200);
+    // Expandable when text is truncated, or when both fields exist (the
+    // collapsed view only shows one of them).
+    const _needsExpand = _primary.length > 200 || (_desc && _rat && _desc !== _rat);
     const due     = fmtDate(d.deadline);
     const decided = fmtDate(d.decided_at);
     const overdue = isOverdue(d.deadline);
@@ -375,7 +381,18 @@ if (filtered.length === 0) {
         ${_isOpen ? html`<button class="dec-resolve-btn" onclick=${onResolve}>Resolve</button>` : ""}
       </div>
       <div class="dec-title">${d.title}</div>
-      ${snippet ? html`<div class="dec-snippet">${snippet}${snippet.length < (d.description || d.rationale || "").length ? "…" : ""}</div>` : ""}
+      ${_primary ? (_needsExpand
+        ? html`<details class="dec-expand">
+            <summary>
+              <span class="dec-snippet dec-snippet-collapsed">${snippet}${_primary.length > 200 ? "…" : ""}</span>
+              <span class="dec-more"></span>
+            </summary>
+            <div class="dec-fulltext">
+              ${_desc ? html`<div class="dec-fulltext-section"><div class="dec-fulltext-label">Description</div><div class="dec-snippet">${_desc}</div></div>` : ""}
+              ${_rat  ? html`<div class="dec-fulltext-section"><div class="dec-fulltext-label">Rationale</div><div class="dec-snippet">${_rat}</div></div>` : ""}
+            </div>
+          </details>`
+        : html`<div class="dec-snippet">${_primary}</div>`) : ""}
       ${d.decided_by ? html`<div class="dec-resolved-by">✓ ${d.decided_by}${decided ? " · " + decided : ""}</div>` : ""}
       ${d.escalation_note && !["resolved", "superseded"].includes(d.status) ? html`<div class="dec-escalation-note">${d.escalation_note}</div>` : ""}
     </div>`;
@@ -458,6 +475,18 @@ if (escalated.length > 0) {
 .dec-title { font-weight: 600; font-size: 0.95rem; margin-bottom: 0.2rem; }
 .dec-snippet { font-size: 0.82rem; color: var(--theme-foreground-muted); line-height: 1.45; white-space: pre-wrap; }
 .dec-resolved-by { font-size: 0.78rem; color: #22c55e; margin-top: 0.3rem; }
+
+/* ── Expandable full text ─────────────────────────────────────────────────── */
+.dec-expand summary { list-style: none; cursor: pointer; }
+.dec-expand summary::-webkit-details-marker { display: none; }
+.dec-expand[open] .dec-snippet-collapsed { display: none; }
+.dec-more::after { content: "Show full text ▾"; }
+.dec-expand[open] .dec-more::after { content: "Show less ▴"; }
+.dec-more { display: inline-block; margin-left: 0.35rem; font-size: 0.72rem; font-weight: 600; color: steelblue; white-space: nowrap; }
+.dec-more:hover { text-decoration: underline; }
+.dec-expand[open] .dec-more { display: block; margin: 0.15rem 0 0.35rem; }
+.dec-fulltext-section + .dec-fulltext-section { margin-top: 0.5rem; }
+.dec-fulltext-label { font-size: 0.65rem; font-weight: 700; text-transform: uppercase; letter-spacing: 0.06em; color: var(--theme-foreground-faint, #aaa); margin-bottom: 0.1rem; }
 .dec-escalation-note { font-size: 0.78rem; color: #b45309; margin-top: 0.3rem; background: #fef3c7; border-radius: 4px; padding: 0.25rem 0.5rem; }
 
 /* ── Resolve button ───────────────────────────────────────────────────────── */
diff --git a/dashboard/src/docs/capabilities.md b/dashboard/src/docs/capabilities.md
index e4af82a..c0b89f1 100644
--- a/dashboard/src/docs/capabilities.md
+++ b/dashboard/src/docs/capabilities.md
@@ -227,8 +227,9 @@ and age in days.
 ---
 
 *Capability requests are a sanctioned write use case of the State Hub alongside
-`resolve_decision`, `get_next_steps`, and the suggestion backlog writes
-(`create_suggestion`, `vet_suggestion`, `decline_suggestion`,
-`promote_suggestion_to_task`, `bump_suggestion_relevance`). They do not
-originate in workplan files —
-they are operational coordination.*
+`resolve_decision`, `get_next_steps`, and intake capture (`create_intake`,
+`route_intake`, `close_intake`; promotion via `statehub promote-intake`). The
+legacy suggestion mutation tools (`create_suggestion`, `vet_suggestion`, …)
+return HTTP 410. Capability requests do not originate in workplan files —
+they are operational coordination. See [Work Records](/docs/work-records) and
+[Intakes](/docs/intakes).*
diff --git a/dashboard/src/docs/contributions.md b/dashboard/src/docs/contributions.md
index 9736a74..bc537b3 100644
--- a/dashboard/src/docs/contributions.md
+++ b/dashboard/src/docs/contributions.md
@@ -4,10 +4,16 @@ title: Contributions — Reference
 
 # Contributions — Reference
 
-Contributions track **outbound upstream work** — things the Custodian has
-identified that belong in a repo it does not own or control. Each contribution
-is a structured artifact filed locally in the repo's `contrib/` directory and
-registered in the state hub so it is never lost.
+Contributions track **outbound upstream work** — things identified for a
+repository the fleet does not own or control. Each contribution is a
+structured artifact filed locally under `contrib/` and registered in State Hub
+so it is not lost.
+
+Contributions are **not** a work-record kind in the fleet registry
+(`work-record-types_v0.1.md`). They are a separate hub entity and dashboard
+surface used for third-party coordination. Work-record kinds cover internal
+coordination (workplan, task, intake, decision, engagement, register-entry).
+See [Work Records](/docs/work-records).
 
 ---
 
@@ -15,22 +21,26 @@ registered in the state hub so it is never lost.
 
 | Type | Full name | Use when |
 |------|-----------|----------|
-| `br` | Bug Report | You found a defect in an upstream tool or library |
-| `fr` | Feature Request | You need functionality that upstream does not yet provide |
-| `ep` | Extension Point | You identified a future enhancement opportunity in upstream code |
-| `upr` | Upstream PR | You have written (or are writing) a patch for an upstream repo |
+| `br` | Bug Report | Defect in an upstream tool or library |
+| `fr` | Feature Request | Functionality upstream does not yet provide |
+| `ep` | Extension Point | Future enhancement opportunity in upstream code |
+| `upr` | Upstream PR | Patch written (or being written) for an upstream repo |
 
 ---
 
-## Flow workstations
+## Lifecycle (workstations)
 
-```
+Contribution status is evaluated by the task-flow engine
+(`flows/contribution.yaml`). The stored field is `status`; flow tooling may
+call the same value a **workstation**.
+
+```text
 draft → submitted → acknowledged → accepted → merged
                  ↘               ↘
                rejected        withdrawn
 ```
 
-| Workstation | Meaning |
+| Status | Meaning |
 |--------|---------|
 | **draft** | Artifact written locally; not yet sent upstream |
 | **submitted** | Filed as a GitHub issue, PR, or email — awaiting upstream response |
@@ -40,36 +50,42 @@ draft → submitted → acknowledged → accepted → merged
 | **rejected** | Upstream declined; record kept for future reference |
 | **withdrawn** | We decided not to pursue it |
 
-Contribution movement is evaluated by the task-flow engine. The API asks
-whether the target workstation is reachable from the current information
-object; if not, it returns structured blocking assertions instead of a generic
-"transition not allowed" message. `submitted_at` is stamped automatically when
-the contribution reaches `submitted`; `resolved_at` is stamped when it reaches
-`merged`, `rejected`, or `withdrawn`.
+Reachability is assertion-based. For example, `rejected` is only enterable from
+`submitted` or `acknowledged`; `merged` only from `accepted`. If a target is
+not reachable, the API returns structured blocking assertions rather than a
+generic “transition not allowed” message.
+
+Timestamps: `submitted_at` is stamped when status becomes `submitted`;
+`resolved_at` is stamped when status becomes `merged`, `rejected`, or
+`withdrawn` (and related terminal paths as implemented on the status patch).
 
 ---
 
 ## Relation to the Todo classification
 
-Contributions map directly to the **Third-party** class in the inter-repo
-communication taxonomy:
+Contributions map to the **Third-party** class in the inter-repo communication
+taxonomy:
 
 | Todo class | Mechanism |
 |------------|-----------|
-| Internal | Workplan file + task in this repo's workplan |
+| Internal | Workplan file + task in this repo |
 | Ecosystem | State hub task with `[repo:<slug>]` prefix |
-| **Third-party** | **Contribution artifact in `contrib/` + state hub registration** |
+| **Third-party** | **Contribution artifact in `contrib/` + hub registration** |
 
-Contributions in `draft`, `submitted`, or `acknowledged` workstations appear as
-open Third-party todos on the [Todo](/todo) page.
+Open third-party items are contributions in `draft`, `submitted`, or
+`acknowledged`. They appear on the [Todo](/todo) page until the upstream loop
+closes (`merged`, `rejected`, or `withdrawn`).
+
+Intakes are **not** third-party contributions: an intake is internal capture of
+a spark; a contribution is outbound work aimed at someone else’s repo.
 
 ---
 
 ## File layout
 
-Each artifact lives in the current repo under `contrib/`:
+Each artifact lives in the **current** repo under `contrib/`:
 
-```
+```text
 contrib/
   bug-reports/        br-YYYY-MM-DD--<org>--<repo>--<slug>.md
   feature-requests/   fr-YYYY-MM-DD--<org>--<repo>--<slug>.md
@@ -77,8 +93,8 @@ contrib/
   upstream-prs/       upr-YYYY-MM-DD--<org>--<repo>--<slug>.md
 ```
 
-Templates live in `~/the-custodian/canon/standards/contrib-templates/`.
-Convention details: `~/the-custodian/canon/standards/contribution-convention_v0.1.md`.
+Templates: `~/the-custodian/canon/standards/contrib-templates/`.
+Convention: `~/the-custodian/canon/standards/contribution-convention_v0.1.md`.
 
 ---
 
@@ -86,38 +102,52 @@ Convention details: `~/the-custodian/canon/standards/contribution-convention_v0.
 
 **1. Write the artifact file** using the appropriate template.
 
-**2. Register it in the state hub** via MCP:
+**2. Register it in the state hub** (MCP):
 
-```
+```text
 register_contribution(
-  type               = "fr",
-  title              = "Add sidebar TOC injection API",
-  target_org         = "observablehq",
-  target_repo        = "framework",
-  body_path          = "contrib/feature-requests/fr-2026-02-26--observablehq--framework--toc.md",
-  related_workstream_id = "<uuid>"
+  type                 = "fr",
+  title                = "Add sidebar TOC injection API",
+  target_org           = "observablehq",
+  target_repo          = "framework",
+  body_path            = "contrib/feature-requests/fr-2026-02-26--observablehq--framework--toc.md",
+  related_workplan_id  = "<uuid>"   # preferred; related_workstream_id still accepted as alias
 )
 ```
 
-**3. Close the loop** when you file it upstream:
+REST: `POST /contributions/` with the same fields.
 
-```
+**3. Close the loop** when filed upstream — advance via flow tooling or status
+patch:
+
+```text
 advance_workstation(entity_type="contribution", entity_id="<uuid>", target_workstation="submitted")
 ```
 
-**4. Keep updating** as upstream responds — `acknowledged`, `accepted`, `merged`.
+```bash
+curl -X PATCH "http://127.0.0.1:8000/contributions/<uuid>/status" \
+  -H "Content-Type: application/json" \
+  -d '{"status": "submitted"}'
+```
+
+**4. Keep updating** as upstream responds — `acknowledged`, `accepted`,
+`merged` (or `rejected` / `withdrawn`).
+
+Optional links: `related_topic_id`, `related_workplan_id`, `repo_id` (managed
+repo that owns the local artifact).
 
 ---
 
 ## Kanban board
 
 The Contributions page groups artifacts by status column. Only columns with at
-least one entry are shown. The **⚠ follow-up banner** appears when any
+least one entry are shown. The **follow-up banner** appears when any
 contribution has been in `submitted` or `acknowledged` for an extended period
 without further movement — a prompt to check in with upstream.
 
+Data source: `GET /contributions/`.
+
 ---
 
-*Contributions are append-only. Rejected or withdrawn artifacts are retained as
-institutional memory — they explain why certain approaches were tried and
-dropped.*
+*Contributions are retained after rejection or withdrawal — institutional
+memory for why certain approaches were tried and dropped.*
diff --git a/dashboard/src/docs/goals.md b/dashboard/src/docs/goals.md
index 39a4a20..5ee237c 100644
--- a/dashboard/src/docs/goals.md
+++ b/dashboard/src/docs/goals.md
@@ -127,7 +127,7 @@ The Goals page groups everything by domain:
 
 Workplans carry an optional `repo_goal_id` field. Setting it traces *why* a workplan exists — which specific repo goal it contributes to. This connection is currently recorded in the DB but is not yet visualised in the Workplans page.
 
-To set the link when creating a workplan through the preferred API, pass `repo_goal_id`. To update an existing one, use `PATCH /workplans/{id}/` with `{"repo_goal_id": "<uuid>"}`. Legacy `create_workstream` and `/workstreams/{id}/` callers remain compatibility-supported while they are metered.
+To set the link when creating a workplan through the preferred API, pass `repo_goal_id`. To update an existing one, use `PATCH /workplans/{id}/` with `{"repo_goal_id": "<uuid>"}`. The legacy `create_workstream` tool is removed and `/workstreams/{id}` returns 410; use `create_workplan` and `/workplans/{id}`.
 
 ---
 
diff --git a/dashboard/src/docs/intakes.md b/dashboard/src/docs/intakes.md
new file mode 100644
index 0000000..91fdfb8
--- /dev/null
+++ b/dashboard/src/docs/intakes.md
@@ -0,0 +1,185 @@
+---
+title: Intakes — Reference
+---
+
+# Intakes — Reference
+
+An **intake** is a work-record kind for a **spark**: an idea, finding,
+directive, or request that is not yet a workplan, task, decision, or
+engagement. Intakes hold early signal until someone vets, routes, and either
+promotes or closes them.
+
+Canon: `the-custodian/canon/standards/work-record-types_v0.1.md`
+(`kind: intake`, id scheme `{PREFIX}-IN-NNNN`).
+Umbrella: [Work Records](/docs/work-records).
+
+Intakes **replace** the retired hub **suggestion** backlog for new work. See
+[Suggestions (legacy)](/docs/suggestions).
+
+**Quality:** discovery comprehension is governed by
+[Definition of Comprehension (DoC)](/policy/intake-doc) (`DoC-Ok` /
+`DoC-Failed` / unassessed). DoC is independent of lifecycle `status` and is
+**not** implementation readiness ([DoR](/policy/work-item-dor)). Model:
+`docs/work-record-quality-gates.md`.
+
+---
+
+## Lifecycle
+
+```text
+open -> vetted -> routed -> closed(promoted | declined | absorbed)
+```
+
+| Status | Meaning |
+|--------|---------|
+| **open** | Captured; not yet fully vetted |
+| **vetted** | Reviewed; structure and intent are clear enough to route |
+| **routed** | Assigned a destination / owner path; eligible for promotion |
+| **closed** | Terminal; requires an **outcome** |
+
+| Outcome (only when `closed`) | Meaning |
+|------------------------------|---------|
+| **promoted** | Became another work record; `promoted_to` holds the new canonical id |
+| **declined** | Explicitly not pursued |
+| **absorbed** | Already covered by existing work; no new record needed |
+
+Database constraints (what the API enforces):
+
+- At least one of `topic_id`, `workplan_id`, or `repo_id` is set (scope).
+- `closed` requires `outcome`.
+- `outcome = promoted` requires `promoted_to`.
+
+Route action: only from `open` or `vetted` → `routed`.
+Close action: from `open`, `vetted`, or `routed` → `closed`.
+
+---
+
+## Fields that matter
+
+| Field | Role |
+|-------|------|
+| `title` / `description` | Human-readable content |
+| `lane` | Autonomy lane: `green` \| `blue` \| `yellow` \| `orange` \| `red` |
+| `status` / `outcome` | Lifecycle |
+| `origin` / `origin_ref` | Where the spark came from. **Residuals:** `origin: residual` (or `handoff`) and `origin_ref: <parent-WP-id>` (e.g. `BINKY-WP-0006`). Also e.g. `legacy-suggestion:<uuid>`, mail-triage ids |
+| `promoted_to` | Canonical id of the record this became after promotion |
+| `source_repo_path` | Repo-relative path of the YAML block / file when file-authored |
+| `routed_note` | Free-text routing context |
+| `notes` | Append-only note list via `POST /intakes/{id}/notes` |
+
+Identity: hub rows use UUIDv7 primary keys. File-backed blocks use fleet ids
+such as `CUST-IN-0004` and receive `state_hub_intake_id` write-back from
+`fix-consistency`.
+
+---
+
+## How intakes enter the hub
+
+**1. File-backed (preferred for lasting work)**
+
+Author a schema-valid YAML block in any repo markdown file (canon schemas under
+`the-custodian/canon/standards/schemas/work-records/`). Commit, then run
+`statehub fix-consistency` so the hub registers the record and writes the UUID
+back.
+
+**2. Hub API / MCP (capture path)**
+
+```text
+create_intake(title=..., topic_id=... | workplan_id=... | repo_id=..., lane="green", ...)
+# REST: POST /intakes/
+```
+
+```text
+list_intakes(status="open")
+route_intake(intake_id, routed_note=...)
+close_intake(intake_id, outcome="declined"|"absorbed"|"promoted", promoted_to=...)
+```
+
+REST mirrors: `GET/POST /intakes/`, `PATCH /intakes/{id}`,
+`POST /intakes/{id}/route`, `POST /intakes/{id}/close`,
+`POST /intakes/{id}/notes`.
+
+---
+
+## Promotion (intake → another kind)
+
+Promotion is the sanctioned path from a **routed** intake into a durable
+work-record kind:
+
+```text
+intake.routed  →  workplan | task | decision | engagement
+```
+
+Implemented by:
+
+```bash
+# via CLI (statehub entrypoint wraps scripts/promote_intake.py)
+statehub promote-intake <intake-id-or-uuid> --to workplan --repo <path>
+statehub promote-intake <id> --to task --workplan-file workplans/….md
+statehub promote-intake <id> --to decision --target-file <md>
+statehub promote-intake <id> --to engagement --target-file <md>
+```
+
+What the promotion transition does today:
+
+1. Validates the intake is **routed**.
+2. Writes the target artefact (ADR-001 workplan file, task block, or
+   decision/engagement YAML block).
+3. Sets intake `promoted_to` and closes with `outcome=promoted`.
+4. Sets `origin: intake:<…>` on the new record for back-link.
+5. Registers / syncs with the hub where a hub entity exists.
+
+**Engagements:** promotion can write the file block; a first-class hub
+engagement entity is not present yet — the CLI reports that limitation rather
+than inventing silent hub rows.
+
+Closing with `outcome=promoted` by hand is supported for after-the-fact
+recording, but the promote CLI is the intended path for both artefacts.
+
+---
+
+## What is not wired yet
+
+These are present limitations of the current hub surface (not aspirations):
+
+| Area | Current behaviour |
+|------|-------------------|
+| **Dashboard** | No dedicated Intakes page yet; legacy [Suggestions](/suggestions) still reads the old table |
+| **Next-steps / summary** | `ranked_suggestions` and open-suggestion signals in `GET /state/summary` and `get_next_steps` still read the **suggestion** table, not intakes |
+| **WSJF on intakes** | Suggestion WSJF fields (`base_value`, `relevance`, …) are not part of the intake model |
+| **Task-flow YAML** | Workplan, task, and contribution have `flows/*.yaml`; intake advances via dedicated route/close endpoints rather than `advance_workstation` |
+
+Use `GET /intakes/` or MCP `list_intakes` for the live backlog.
+
+---
+
+## Residuals as intakes
+
+When a workplan finishes with leftover work that is not large enough for an
+immediate child workplan, author an **intake** with:
+
+```yaml
+origin: residual
+origin_ref: BINKY-WP-0006   # parent workplan id
+lane: green                 # or blue/yellow/…
+status: open                # or vetted/routed when ready
+```
+
+Promote with `statehub promote-intake` when structure is ready (e.g. to a
+workplan). Listing open residual intakes across domains is a State Hub read
+concern (`list_intakes` + origin filters; planned `statehub residuals` CLI).
+See [Work Records — Residuals](/docs/work-records#residuals-role-not-kind).
+
+## Relation to other kinds
+
+| Kind | Boundary |
+|------|----------|
+| **workplan / task** | Durable planned work; intake is the pre-plan capture form |
+| **decision** | Approval package; an intake may promote *into* a decision |
+| **contribution** | Outbound third-party artefact — different entity; not an intake outcome |
+| **suggestion (legacy)** | Superseded capture mechanism; do not create new ones |
+| **residual** | Not a kind — role of intake/WP/decision with `origin: residual` |
+
+---
+
+*Intakes are a fresh entity (CUST-WP-0061), not a rename of `suggestions`.*
diff --git a/dashboard/src/docs/overview.md b/dashboard/src/docs/overview.md
index ce827ac..c25808d 100644
--- a/dashboard/src/docs/overview.md
+++ b/dashboard/src/docs/overview.md
@@ -24,6 +24,13 @@ by repository. Each bar is broken into four task-status segments:
 | orange | wait |
 | light grey | todo |
 
+Above the chart:
+
+- **Mode selector** — lifecycle, health, or recently-changed windows (with
+  matching workplan counts in each option).
+- **Text filter** — case-insensitive substring match on title, repository,
+  domain, workplan filename, and owner. Useful when many rows share a mode.
+
 The left axis shows the `domain / repository` label once per repository group.
 The `done/total` count is printed to the right of each bar. Workplans with no
 tasks yet show a grey "— no tasks yet" label.
diff --git a/dashboard/src/docs/ralph-workplan.md b/dashboard/src/docs/ralph-workplan.md
index a6970a7..3636033 100644
--- a/dashboard/src/docs/ralph-workplan.md
+++ b/dashboard/src/docs/ralph-workplan.md
@@ -90,7 +90,7 @@ cd ~/ralph-workplan && ./install.sh --uninstall
 
 ```markdown
 ---
-id: WP-0001
+id: EXAMPLE-WP-0001
 title: "Build a thing"
 status: ready
 ---
@@ -100,7 +100,7 @@ Optional description.
 ## Task: Do the first thing
 
 ​```task
-id: T-01
+id: EXAMPLE-WP-0001-T01
 status: todo
 priority: high
 ​```
@@ -108,7 +108,7 @@ priority: high
 ## Task: Do the second thing
 
 ​```task
-id: T-02
+id: EXAMPLE-WP-0001-T02
 status: todo
 priority: medium
 ​```
diff --git a/dashboard/src/docs/repos.md b/dashboard/src/docs/repos.md
index 83fa7bf..45befb0 100644
--- a/dashboard/src/docs/repos.md
+++ b/dashboard/src/docs/repos.md
@@ -27,6 +27,11 @@ be followed by classification registration.
 
 For the full onboarding journey see **[Repo Integration](/docs/repo-integration)**.
 
+For a lineage-preserving Forgejo coordinate change, see
+**[Repository Renames](/docs/repository-renames)**. The old repository route
+continues to resolve through a protected alias; the dashboard is verification,
+not the mutation surface.
+
 ---
 
 ## KPI row
@@ -86,4 +91,4 @@ Use the **Add Repo** form or:
 # 2. Register / reclassify
 make register-from-classification PATH=/path/to/repo
 statehub fix-consistency
-```
\ No newline at end of file
+```
diff --git a/dashboard/src/docs/repository-renames.md b/dashboard/src/docs/repository-renames.md
new file mode 100644
index 0000000..3e92dbe
--- /dev/null
+++ b/dashboard/src/docs/repository-renames.md
@@ -0,0 +1,70 @@
+---
+title: Repository Renames — Operator Reference
+---
+
+# Repository renames
+
+State Hub preserves repository history across a Forgejo name change by keeping
+the repository UUID and Forge numeric ID unchanged. The new slug becomes
+canonical and the former slug remains a protected alias.
+
+The dashboard is a read surface. Execute and recover renames with the
+`statehub repo rename` CLI and the repository-owned migration workplan.
+
+## What to inspect here
+
+After the `statehub-rebound` phase:
+
+1. Open `/repos/<old-slug>`. An amber banner must identify the requested slug
+   as an alias and link to the canonical repository page.
+2. Open `/repos/<new-slug>`. Both pages must report the same repository UUID;
+   the canonical page lists the old alias.
+3. Review workplans/tasks, dispatch, token totals, SBOM, services,
+   capabilities, inbox, interface changes, and stale external references.
+4. Treat stale Fabric or external projections as owner handoffs. Their source
+   is not silently rewritten by State Hub.
+
+Matching dashboard counts are useful but insufficient. Final verification uses
+the per-record relationship checksums returned by:
+
+```text
+statehub repo rename verify <operation-id> --json
+```
+
+## Read the achieved phase
+
+```text
+statehub repo rename status <operation-id> --json
+```
+
+The `phase` is the last durable achievement. An `error_code` describes the last
+failed attempt and does not advance the phase. Follow `next_safe_action`; reuse
+the same operation UUID for retries.
+
+| Phase | Next normal action |
+| --- | --- |
+| `preflighted` | Apply `forge-renamed`. |
+| `forge-renamed` | Apply `statehub-rebound`; never register a replacement repository. |
+| `statehub-rebound` | Verify/register a fresh canonical clone, then apply `source-synced`. |
+| `source-synced` | Collect owner handoff evidence and apply `consumers-verified`. |
+| `consumers-verified` | Re-run verification and apply `completed`. |
+| `completed` | Soak, hand off residuals, then request cleanup approval. |
+| `rollback-preflight` | Review blockers and irreversible effects before `--execute`. |
+| `rolled-back` | Verify old canonical routes and affected consumers. |
+
+## Safety boundaries
+
+- Repository rename approval does not rename products, packages, APIs,
+  namespaces, environment variables, policies, or telemetry labels.
+- Forgejo credentials stay in their approved custodian; they never enter State
+  Hub commands or evidence.
+- External repositories own and close their own file-backed handoff tasks.
+- Rollback does not undo consumer commits, deployments, published artifacts,
+  external caches, or historical telemetry.
+- The old checkout is removed last, after terminal verification, soak, live
+  residual handoffs, and explicit path-specific approval.
+- The protected old alias remains. Alias retirement is a separate decision.
+
+The complete source runbook is `docs/repository-rename-operations.md`; its
+versioned handoff contract is
+`docs/schemas/repository-rename-handoff-v1.schema.json`.
diff --git a/dashboard/src/docs/suggestions.md b/dashboard/src/docs/suggestions.md
index a512418..ff3b08e 100644
--- a/dashboard/src/docs/suggestions.md
+++ b/dashboard/src/docs/suggestions.md
@@ -1,49 +1,61 @@
-# Demand-Weighted Suggestion Backlog
+---
+title: Suggestions (archived) — Reference
+---
 
-The `/suggestions` page shows persisted **gated needs** that are not yet real
-tasks. Each unmet lookup increments `relevance`, which raises WSJF ranking.
+# Suggestions (archived) — Reference
 
-## Stages
+The **suggestion** entity is **retired**. It predates the fleet **work-record**
+model. Gated needs, findings, and unvetted sparks are recorded as **intake**
+work records (`kind: intake`).
 
-| Stage | Meaning |
-|-------|---------|
-| `suggestion` | Recorded need, not yet vetted |
-| `requirement` | Vetted with structured fields and notes |
-| `promoted` | Became a real `Task` (`promoted_task_id` set) |
-| `declined` | Rejected; terminal |
+| Use | Path |
+|-----|------|
+| **Current** | [Intakes](/docs/intakes) · `POST /intakes/` · MCP `create_intake` |
+| **Canon** | `the-custodian/canon/standards/work-record-types_v0.1.md` |
+| **Archived record** | `the-custodian/docs/archived-suggestion-backlog.md` |
 
-## WSJF projection
+Umbrella: [Work Records](/docs/work-records).
 
-```text
-cost_of_delay = base_value + (relevance_weight × relevance)
-wsjf = cost_of_delay / job_size
-```
+---
 
-`GET /suggestions?rank=wsjf` returns open suggestions/requirements ordered by
-score. Promoted and declined entries are excluded unless
-`include_terminal=true`.
+## What happened
 
-## Sanctioned writes
+The suggestion backlog was a demand-weighted queue: agents that hit an unmet
+need raised a suggestion, repeat encounters bumped its relevance, and WSJF
+scoring ordered what to build. Intake covers the same discovery step inside the
+work-record framework rather than beside it.
 
-MCP and REST:
+| Date | Step |
+|------|------|
+| 2026-07-21 | Mutations retired (`CUST-WP-0061-T06`) — every write returns HTTP 410. Reads kept live so the history stayed reachable. |
+| 2026-08-20 | History archived to `the-custodian`; read routes, MCP tools, and this dashboard page retired (`STATE-WP-0079-T05`, slice E1). |
 
-- `create_suggestion` / `POST /suggestions/`
-- `vet_suggestion` / `POST /suggestions/{id}/vet`
-- `decline_suggestion` / `POST /suggestions/{id}/decline`
-- `promote_suggestion_to_task` / `POST /suggestions/{id}/promote`
-- `bump_suggestion_relevance` / `POST /suggestions/{id}/bump-relevance`
+Every route under `/suggestions` now returns **HTTP 410** with a pointer to
+intake and to the archive.
 
-Relevance also bumps automatically when:
+## The archived record
 
-- `GET /state/next_steps` surfaces open suggestions
-- A `CapabilityRequest` matches an open suggestion
+All 10 suggestions, 10 notes, and 5 relevance bumps are preserved in
+`the-custodian/docs/archived-suggestion-backlog.md`, with each entry's origin,
+WSJF inputs, and migration target.
 
-## Daily triage
+Every entry was closed as `declined` during the intake migration and **none was
+promoted** — the backlog was drained deliberately, not abandoned. The per-entry
+notes name each one's successor intake (`CUST-IN-0001`, `CUST-IN-0002`, …).
 
-`GET /state/summary` includes `ranked_suggestions` for the activity-core
-`daily_triage_digest` resolver. See [WSJF Triage](/docs/wsjf-triage).
+The record lives in `the-custodian` rather than here because State Hub is being
+archived under `STATE-WP-0079`; a record kept inside the component it documents
+disappears with it.
 
-## Origin
+## What is not retired
 
-Motivated by ops-warden `WARDEN-WP-0012` gated routing scenarios. Example
-backfill: `scripts/seed_wp0012_suggestions.py`.
\ No newline at end of file
+**Dashboard UI feedback** — the Shift+click suggestions on
+[Todo](/docs/todo) and the UI Feedback page — is a *different* entity backed by
+`technical_debt`, and is unaffected. The shared word is a coincidence of naming.
+
+## Data
+
+The `suggestions`, `suggestion_notes`, and `suggestion_relevance_bumps` tables
+are intentionally still present. They are `retire`/`archive` in `SHR-INV-0001`
+and are captured by the final dump at `STATE-WP-0079-T06`; dropping them ahead
+of that dump would remove data for no gain.
diff --git a/dashboard/src/docs/tasks.md b/dashboard/src/docs/tasks.md
index d6f11f8..3923ac8 100644
--- a/dashboard/src/docs/tasks.md
+++ b/dashboard/src/docs/tasks.md
@@ -8,12 +8,16 @@ The Tasks page shows all tasks across every workplan and domain, with live
 filtering, a workstation distribution chart, and a waiting-tasks highlight
 section.
 
+A **task** is a work-record kind: the smallest executable unit (work-item).
+Tasks always belong to a workplan. Umbrella: [Work Records](/docs/work-records).
+Implementation-readiness: [DoR](/policy/work-item-dor).
+
 ---
 
 ## Task workstations
 
-Tasks still expose their current workstation through the `status` field for API
-compatibility.
+Tasks expose their current lifecycle position through the `status` field (flow
+tooling may call that position a workstation).
 
 | Workstation | Meaning |
 |--------|---------|
diff --git a/dashboard/src/docs/work-records.md b/dashboard/src/docs/work-records.md
new file mode 100644
index 0000000..88405bb
--- /dev/null
+++ b/dashboard/src/docs/work-records.md
@@ -0,0 +1,222 @@
+---
+title: Work Records — Reference
+---
+
+# Work Records — Reference
+
+A **work record** is any identified, lifecycle-bearing **coordination artefact**
+indexed by State Hub. The term is intentionally **generic**: the same
+framework covers individual units of work or discovery, **collections and
+plans**, and related artefacts (decisions, engagements, register entries). It
+is a mode of organising coordination — not a single product page and not a
+synonym for “task.”
+
+Fleet canon (normative):
+`the-custodian/canon/standards/work-record-types_v0.1.md` and the machine
+registry `work-record-types.yaml`. This page describes what State Hub
+implements and exposes today.
+
+---
+
+## Units and structure
+
+Kinds share one spine and registry, but they play different **roles**:
+
+| Role | What it is | Kinds today | Everyday gloss |
+|------|------------|-------------|----------------|
+| **Unit** | A single coordination atom | `task`, `intake`, `decision`, `engagement`, many `register-entry` rows | work-item (task); find / spark (intake) |
+| **Structure** | A collection or plan with relations | `workplan` | delivery plan over tasks (and dependencies between plans) |
+
+A **workplan is a work record** in the mechanical sense (id, status, hub index).
+It is **not** a large task: it is **structure** over unit records. Calling both
+“work records” means they use the same identity and reconciliation machinery,
+not that they feel the same in day-to-day language.
+
+Generated views (for example a per-repo work-record index, or a future
+“discovery map” over intakes) organise records **without** needing a new kind
+until a real aggregate must be owned as its own artefact.
+
+---
+
+## Kind registry (closed list)
+
+| Kind | Role | Id scheme (typical) | Meaning in State Hub today |
+|------|------|---------------------|----------------------------|
+| **workplan** | structure | `{PREFIX}-WP-NNNN` | Dependency-bearing plan; file under `workplans/` (ADR-001) |
+| **task** | unit | `{WP-ID}-TNN` · `ADHOC-YYYY-MM-DD-TNN` | Smallest executable delivery unit; lives in a workplan file |
+| **intake** | unit | `{PREFIX}-IN-NNNN` | Discovery spark: idea, finding, directive, or request |
+| **decision** | unit | `{PREFIX}-DEC-YYYY-NNN` (file) · hub decision entity | Approval package / recorded choice |
+| **engagement** | unit | `{PREFIX}-ENG-YYYY-NNN` | Scheduled external interaction (file-backed; hub entity not yet first-class) |
+| **register-entry** | unit (mostly) | `RISK-…`, `TD-…`, `CAP-…`, `CCR-…`, `ADR-…` | Risks, debt, capability requests, credential change requests, ADRs |
+
+Unregistered id patterns are rejected by CI and `statehub fix-consistency`
+(sidetrack detector). New kinds are added only via the canon registry.
+
+**Not a work-record kind today:** **contributions** (outbound third-party BR/FR/EP/UPR
+artifacts). They remain a separate hub entity and dashboard surface — see
+[Contributions](/docs/contributions).
+
+---
+
+## Lifecycle vs quality (Definition-of-X)
+
+Two independent axes:
+
+| Axis | Answers | Examples |
+|------|---------|----------|
+| **Lifecycle** (`status`) | Where is this in process? | workplan `active` / `finished`; intake `routed`; task `progress` |
+| **Definition assessment** | Did it pass a named quality policy when assessed? | DoC / DoR / DoD (and DoI / DoM for repos/services) |
+
+Assessments do **not** invent extra lifecycle states. Outcomes are:
+
+- **unassessed** — no Definition-of-X assessment recorded yet  
+- **`DoX-Ok`** (tiered policies may use `DoM-Ok-1`, …) — last assessment passed  
+- **`DoX-Failed`** — assessment ran and failed  
+
+A workplan may be `status=finished` without **DoD-Ok**, or `status=ready`
+without **DoR-Ok**. That is allowed: process can advance while quality debt
+stays visible. Policies live under `policies/` (same pattern as Repository DoI
+and Service DoM):
+
+| Policy | Dashboard | Rates |
+|--------|-----------|-------|
+| **DoC** | [Intake DoC](/policy/intake-doc) | Discovery quality (`intake`) |
+| **DoR** | [Work-item DoR](/policy/work-item-dor) | Implementation-readiness (`task`, `workplan`) |
+| **DoD** | [Workplan DoD](/policy/workstream-dod) | Completion quality (workplan) |
+
+Full matrix, badge spelling, and **recording fields**
+(`quality_doc` / `quality_dor` / `quality_dod`): repo doc
+`docs/work-record-quality-gates.md`. Soft list: `statehub quality-debt`.
+
+Discovery quality (intake) is **not** the same as implementation-readiness
+(task/workplan). Outside or sparse-context signals should be comprehended
+(DoC) before they are promoted into structured delivery work.
+
+---
+
+## Conventional spine
+
+Every work record carries the same conceptual fields (kind-specific fields
+extend them; they do not replace them):
+
+| Field | Role |
+|-------|------|
+| `id` | Human/agent canonical name (`STATE-WP-0074`, `CUST-IN-0004`, …) |
+| `uuid` | Hub-assigned identity for relations and history (UUIDv7 for new intake and related entities; older tables may still use UUIDv4) |
+| `kind` | One of the registered kinds |
+| `lane` | Autonomy lane (`green` … `red`) where the entity supports it |
+| `status` | Kind-specific lifecycle position |
+| `owner` | Agent or human |
+| `repo` | Owning repo (ADR-001 / ADR-005 anchor) |
+| `tags` | Policy and derived labels — not lifecycle states |
+| `created` / `updated` | Dates |
+
+Hub write-back of UUIDs into source files uses the familiar
+`state_hub_*_id` fields (for workplans the frontmatter key is still
+`state_hub_workstream_id` for compatibility).
+
+---
+
+## Abstract lifecycles
+
+| Kind | Lifecycle (stored `status` / outcome) |
+|------|----------------------------------------|
+| task | `wait → todo → progress → done \| cancel` |
+| workplan | `proposed → ready → active → blocked → backlog → finished → archived` |
+| intake | `open → vetted → routed → closed(promoted \| declined \| absorbed)` |
+| decision | Canon file lifecycle: `prepared → resolved(…)`; hub decision page still uses its own status vocabulary — see [Decisions](/docs/decisions) |
+| engagement | `queued → prepared → done` (file convention) |
+| register-entry | Per existing register conventions |
+
+Detail pages:
+
+- [Workplan Lifecycle](/docs/workstream-lifecycle)
+- [Tasks](/docs/tasks)
+- [Intakes](/docs/intakes)
+- [Decisions](/docs/decisions)
+
+---
+
+## Source files, registration, and index
+
+1. **Workplans and tasks** are authored in dedicated `workplans/*.md` files
+   (ADR-001). `fix-consistency` (C-06 and related checks) registers them and
+   writes hub IDs back into the files.
+2. **Intakes, decisions, and engagements** may appear as schema-valid YAML
+   blocks in any repo markdown file. `fix-consistency` registers intake and
+   decision blocks and writes `state_hub_intake_id` (and decision IDs) back when
+   present.
+3. **Generated index:** each repo may have a `WORK-RECORDS.md` (or equivalent)
+   produced by fix-consistency — a read-only orientation table of indexed
+   records and their source paths. Do not hand-edit it.
+4. The hub remains a **read model** for formal structure: files are source of
+   truth for workplans/tasks; hub-first bootstrap tools exist but are not the
+   steady-state path.
+
+Promotion from intake to another kind is a first-class operation
+(`statehub promote-intake` / `scripts/promote_intake.py`): it writes the target
+artefact, sets `promoted_to` / `origin` links, and closes the intake as
+`promoted`. Manual copy-paste between kinds is treated as a process defect.
+
+---
+
+## Residuals (role, not kind)
+
+**Residual** means work deliberately left when finishing a workplan. It is
+**not** a kind in the registry. Do not invent a parallel residuals file or park
+leftovers only in `SCOPE.md` or finished-workplan prose.
+
+| Shape | Capture as | Links |
+|-------|------------|--------|
+| Parkable Green/Blue | **intake** | `origin: residual` (or `handoff`), `origin_ref: <parent-WP-id>` |
+| Multi-step | **workplan** (next WP) | Name parent WP; promote from residual intake when useful |
+| Founder gate / time | **decision** / **engagement** | Same origin fields when from residual intake |
+| Persistent gap | **register-entry** | Cross-link parent in notes |
+
+**Before** setting a workplan to `finished`, promote each actionable residual
+into a live record. Optional narrative under the closing task is fine for
+humans; the backlog is the work record. Fleet listing (intakes + open WPs with
+those origin fields) belongs on State Hub — future `statehub residuals` /
+`GET …` filters — not in domain repos. Canon:
+`the-custodian/canon/standards/work-record-types_v0.1.md` § Residuals.
+
+---
+
+## Tags vs status
+
+| Class | Examples | Rule |
+|-------|----------|------|
+| **Derived tags** | `stalled`, `stale`, `orphaned`, … | Computed; not written as workplan `status` |
+| **Policy tags** | `needs-human`, `automatable`, `compliance-relevant`, `residual`, … | Assigned under policy |
+
+Situational labels are tags (or derived health filters). Lifecycle position is
+`status` only. Workplan health filters `needs_review` and `stalled` are
+documented under [Workplan Lifecycle](/docs/workstream-lifecycle).
+
+---
+
+## Legacy names still visible in State Hub
+
+| Legacy surface | Current meaning |
+|----------------|-----------------|
+| **workstream** | Compatibility name for **workplan** (some frontmatter keys, retired or metered API aliases) |
+| **suggestion** | Pre–work-record hub entity for gated needs; **mutations retired** (HTTP 410). Use **intake**. Reads may remain for history. See [Suggestions (legacy)](/docs/suggestions). |
+| Dashboard **Suggestions** page | Still lists the legacy table via `GET /suggestions/`; open backlog has been migrated to file-backed intakes |
+
+---
+
+## Related APIs (orientation)
+
+| Kind / surface | Primary REST | MCP (preferred) |
+|----------------|--------------|-----------------|
+| workplan | `GET/POST/PATCH /workplans/` | `list_workplans`, `create_workplan`, `update_workplan` |
+| task | `GET/PATCH /tasks/` | `list_tasks`, `create_task`, `update_task_status` |
+| intake | `GET/POST /intakes/`, `…/route`, `…/close` | `create_intake`, `list_intakes`, `route_intake`, `close_intake` |
+| decision | `/decisions/` | `record_decision`, `resolve_decision` |
+| contribution (not a work-record kind) | `/contributions/` | `register_contribution` |
+| suggestion (legacy, read-only writes) | `GET /suggestions/` | mutation tools return 410 |
+
+---
+
+*Canon and registry live in `the-custodian`. State Hub implements registration,
+read model, flow evaluation for some kinds, and the intake promotion CLI.*
diff --git a/dashboard/src/docs/workstream-lifecycle.md b/dashboard/src/docs/workstream-lifecycle.md
index 49860fd..24ac4b7 100644
--- a/dashboard/src/docs/workstream-lifecycle.md
+++ b/dashboard/src/docs/workstream-lifecycle.md
@@ -1,30 +1,46 @@
 ---
-title: Workplan Lifecycle - Reference
+title: Workplan Lifecycle — Reference
 ---
 
-# Workplan Lifecycle - Reference
+# Workplan Lifecycle — Reference
 
-A workplan is an information object that occupies a named lifecycle state.
-The stored `status` field keeps that state, while the task-flow engine derives
-which other states are reachable and which exit assertions are blocking
-movement. Dashboard health filters such as `needs_review` and `stalled` are
-derived labels, not stored lifecycle values.
+A **workplan** is a work-record kind: a structured, dependency-bearing body of
+work. In State Hub it is an information object whose current position is the
+stored `status` field. The task-flow engine can derive which other positions
+are reachable and which exit assertions are blocking movement.
+
+Umbrella vocabulary: [Work Records](/docs/work-records).
+File convention: ADR-001 / [Workplans](/docs/workstreams).
+
+The product term is **workplan**. **Workstream** remains a legacy compatibility
+name in some fields (notably frontmatter `state_hub_workstream_id`) and
+historical URLs; it refers to the same entity.
+
+**Quality vs lifecycle:** `status=ready` or `status=finished` is process state.
+Implementation-readiness and completion quality are separate assessments —
+[DoR](/policy/work-item-dor) (`DoR-Ok` / `DoR-Failed`) and
+[DoD](/policy/workstream-dod) (`DoD-Ok` / `DoD-Failed`). A finished workplan
+without DoD-Ok is allowed quality debt. See
+`docs/work-record-quality-gates.md`.
 
 ---
 
-## Stored Lifecycle States
+## Stored lifecycle states
 
 | State | Source | Meaning |
 |---|---|---|
-| **proposed** | DB `status = proposed` | Plan exists, but must be reviewed against current repo state |
-| **ready** | DB `status = ready` | Plan has been reviewed and is ready to execute |
-| **active** | DB `status = active` | Work is in progress |
-| **blocked** | DB `status = blocked` | Work cannot proceed until a dependency, decision, or input clears |
-| **backlog** | DB `status = backlog` | Intentionally parked so it stays out of current work views |
-| **finished** | DB `status = finished` | Implementation is complete |
-| **archived** | DB `status = archived` | Historical record outside normal planning and execution |
+| **proposed** | `status = proposed` | Plan exists, but must be reviewed against current repo state |
+| **ready** | `status = ready` | Plan has been reviewed and is ready to execute |
+| **active** | `status = active` | Work is in progress |
+| **blocked** | `status = blocked` | Work cannot proceed until a dependency, decision, or input clears |
+| **backlog** | `status = backlog` | Intentionally parked so it stays out of current work views |
+| **finished** | `status = finished` | Implementation is complete |
+| **archived** | `status = archived` | Historical record outside normal planning and execution |
 
-Normal progression:
+These values are the canonical set for workplan frontmatter, the workplan API,
+consistency checks, and dashboard status filters.
+
+Normal progression (informal path; the flow definition may constrain moves):
 
 ```text
 backlog -> proposed -> ready -> active -> finished -> archived
@@ -33,22 +49,37 @@ backlog -> proposed -> ready -> active -> finished -> archived
                       -> backlog
 ```
 
+Flow definition: `flows/workplan.yaml` (`entity_type: workplan`). Notable
+assertions in the live definition:
+
+- Entering **finished** requires all child tasks in `done` or `cancel`.
+- **blocked** / leaving **active** can depend on dependency workplans reaching
+  `finished` or `archived`.
+
+**Residuals on finish (process, not a flow assertion yet):** before
+`status: finished`, any intentional leftover work must be captured as a **live
+work record** (intake with `origin: residual` + `origin_ref: <this-WP-id>`, or
+a spawned child workplan / decision / engagement / register entry). Prose in
+the finished file is narrative only — not the fleet backlog. See
+[Work Records — Residuals](/docs/work-records#residuals-role-not-kind) and
+fleet canon `work-record-types_v0.1.md` § Residuals.
+
 ---
 
-## Health Labels
+## Health labels (not stored status)
 
 | Label | Source | Meaning |
 |---|---|---|
 | **needs_review** | Ready-review metadata + git diff | A `ready` workplan may be stale because relevant files changed since review |
 | **stalled** | Task counts + timestamp | Work started, but there has been no meaningful progress after the threshold |
 
-`needs_review` and `stalled` can appear beside lifecycle states. They should
-not be written into workplan frontmatter or directly into the workplan
-`status` field.
+`needs_review` and `stalled` can appear beside lifecycle states. They are not
+written into workplan frontmatter `status` and are not workplan lifecycle
+values.
 
 ---
 
-## Ready Review Metadata
+## Ready review metadata
 
 Ready workplans may include optional frontmatter:
 
@@ -67,7 +98,17 @@ behind explicit tooling, not done silently.
 
 ---
 
-## Flow Operations
+## Relation to tasks and intakes
+
+| Relation | What happens today |
+|----------|--------------------|
+| **Tasks** | Own lifecycle (`wait` / `todo` / `progress` / `done` / `cancel`). Starting real work (`todo` → `progress`) can activate a parent workplan that is still in `proposed`, `ready`, or `backlog`. |
+| **Intake promotion** | A routed intake can be promoted into a new workplan (or task/decision/engagement) via `scripts/promote_intake.py` / `statehub promote-intake`. The intake closes as `promoted` with `promoted_to` set to the new canonical id. |
+| **File backing** | Workplans originate as repo files; the hub indexes them. Manual hub-only create tools exist for bootstrap; steady-state structure is file → `fix-consistency`. |
+
+---
+
+## Flow operations
 
 ```text
 get_flow_state(entity_type="workplan", entity_id="<uuid>")
@@ -82,5 +123,15 @@ curl -X PATCH http://127.0.0.1:8000/workplans/<uuid>/ \
   -d '{"status": "finished"}'
 ```
 
-Workplans are never hard-deleted. Use `finished` for completed
-implementation and `archived` for historical records outside normal planning.
+Preferred list/update routes are under `/workplans/`. Some older
+`/workstreams/` aliases were retired (410) or remain metered; see
+`docs/workplan-terminology-transition.md`.
+
+Workplans are not hard-deleted in normal operation. Use `finished` for
+completed implementation and `archived` for historical records outside normal
+planning.
+
+---
+
+*Workstation* in API/tool names means the current lifecycle label of an
+information object — for workplans that label is the `status` field.
diff --git a/dashboard/src/docs/workstreams.md b/dashboard/src/docs/workstreams.md
index fcd4382..22cdf26 100644
--- a/dashboard/src/docs/workstreams.md
+++ b/dashboard/src/docs/workstreams.md
@@ -4,11 +4,14 @@ title: Workplans — Reference
 
 # Workplans — Reference
 
-A workplan is a bounded unit of work within a topic. It carries a stored
-workstation label in the `status` field, an optional owner and due date, and
-belongs to exactly one project domain. The Workplans page gives you a
-filtered, visual overview of active work, derived blocked state, and the
-dependency graph between workplans.
+A **workplan** is a work-record kind: a bounded, dependency-bearing unit of
+work within a topic. It carries a stored lifecycle label in the `status`
+field, an optional owner and due date, and belongs to exactly one project
+domain. The Workplans page gives you a filtered, visual overview of active
+work, derived blocked state, and the dependency graph between workplans.
+
+Umbrella: [Work Records](/docs/work-records). Lifecycle detail:
+[Workplan Lifecycle](/docs/workstream-lifecycle).
 
 The [Daily WSJF Triage](/wsjf-triage) page is a companion review surface for
 activity-core's daily recommendations. It links recommendation candidates back
diff --git a/dashboard/src/docs/wsjf-triage.md b/dashboard/src/docs/wsjf-triage.md
index ec714a4..20e5718 100644
--- a/dashboard/src/docs/wsjf-triage.md
+++ b/dashboard/src/docs/wsjf-triage.md
@@ -55,3 +55,12 @@ that keep surfacing as the next best piece of work.
 
 No write controls live on this page. It is intentionally a review page so the
 daily runner remains a focus surface, not an execution loop.
+
+## Suggestions vs intakes
+
+The triage page and some summary digests historically linked a ranked
+**suggestion** backlog. That entity is retired for writes; open gated needs
+are **intake** work records. `ranked_suggestions` on the state summary still
+reads the legacy suggestion table (typically empty after migration). Live
+intake backlog: `GET /intakes/` — see [Intakes](/docs/intakes) and
+[Suggestions (legacy)](/docs/suggestions).
diff --git a/dashboard/src/index.md b/dashboard/src/index.md
index 3a8edc4..7deb975 100644
--- a/dashboard/src/index.md
+++ b/dashboard/src/index.md
@@ -151,6 +151,8 @@ display(html`<div class="warning" style="display:${summary.error ? '' : 'none'}"
 ## Workplans by Repository
 
 ```js
+import {workplanMatchesSearch} from "./components/workplan-search.js";
+
 // ── Filter workplans by selected mode ───────────────────────────────────────
 // Lifecycle modes match stored canonical status values.
 // Health modes are derived labels; they are not stored lifecycle states.
@@ -246,6 +248,18 @@ function _setChartMode(value) {
   globalThis.__stateHubOverviewChartMode = mode;
   _chartModeState.value = mode;
 }
+
+// Free-text filter over title / repo / domain / workplan filename (persists in-tab).
+const _savedChartSearch = typeof globalThis.__stateHubOverviewChartSearch === "string"
+  ? globalThis.__stateHubOverviewChartSearch
+  : "";
+const _chartSearchState = Mutable(_savedChartSearch);
+
+function _setChartSearch(value) {
+  const q = String(value ?? "");
+  globalThis.__stateHubOverviewChartSearch = q;
+  _chartSearchState.value = q;
+}
 ```
 
 ```js
@@ -265,14 +279,32 @@ _modeSelect.addEventListener("input", () => {
 _modeSelect.addEventListener("change", () => {
   _setChartMode(_modeSelect.value);
 });
-display(_modeSelect);
+
+const _searchInput = html`<input
+  type="search"
+  class="ws-search-input"
+  placeholder="Filter by title, repo, domain…"
+  aria-label="Filter workplans by text"
+  title="Show only workplans matching this text (title, repository, domain, filename)"
+/>`;
+_searchInput.value = String(_chartSearchState ?? "");
+_searchInput.addEventListener("input", () => {
+  _setChartSearch(_searchInput.value);
+});
+
+display(html`<div class="filter-bar ws-mode-bar" data-widget-name="Workplans by Repository">
+  ${_modeSelect}
+  <div class="filter-text-input">${_searchInput}</div>
+</div>`);
 ```
 
 ```js
 import * as Plot from "npm:@observablehq/plot";
 
 const _chartModeValue = _modeValue(_chartModeState);
-const _chartWsFiltered = _workstreamsForMode(_chartModeValue, wsAll);
+const _chartSearchValue = String(_chartSearchState ?? "");
+const _chartWsFiltered = _workstreamsForMode(_chartModeValue, wsAll)
+  .filter(w => workplanMatchesSearch(w, _chartSearchValue));
 
 // Sort by domain, then repository, then most recently updated workplan.
 // The axis labels show each domain/repo group once.
@@ -320,6 +352,10 @@ function _wsTitle(d) {
 
 // ── Render ────────────────────────────────────────────────────────────────────
 if (chartWs.length === 0) {
+  const _searchQ = _chartSearchValue.trim();
+  if (_searchQ) {
+    display(html`<p style="color:gray">No workplans match “${_searchQ}” for the selected mode.</p>`);
+  } else {
   const _emptyMsg = {
     proposed: "No proposed workplans.",
     ready: "No ready workplans.",
@@ -339,6 +375,7 @@ if (chartWs.length === 0) {
     month: "No workplans changed this month.",
   };
   display(html`<p style="color:gray">${_emptyMsg[_chartModeValue] ?? "No workplans."}</p>`);
+  }
 } else {
   display(Plot.plot({
     y: {
@@ -680,6 +717,7 @@ display(Inputs.table((summary.recent_progress ?? []).map(e => ({
 .live-indicator { font-size: 0.8rem; color: gray; position: relative; padding: 0.55rem 1.8rem 0.55rem 0.7rem; margin-bottom: 0.75rem; }
 .ws-mode-bar { margin-bottom: 0.75rem; }
 .ws-mode-select { min-width: 18rem; max-width: 100%; padding: 0.35rem 0.5rem; border-radius: 4px; border: 1px solid var(--theme-foreground-faint, #ddd); background: var(--theme-background); color: var(--theme-foreground); font: inherit; }
+.ws-search-input { min-width: 14rem; max-width: 100%; height: 30px; font-size: 0.85rem; padding: 0.25rem 0.5rem; border-radius: 6px; border: 1px solid var(--theme-foreground-faint, #ccc); background: var(--theme-background, #fff); font-family: inherit; color: inherit; }
 .card { background: var(--theme-background-alt); border-radius: 8px; padding: 1rem; }
 .card.warn { border: 2px solid orange; }
 .card-link { cursor: pointer; transition: box-shadow 0.15s, transform 0.1s; text-decoration: none; color: inherit; display: block; }
diff --git a/dashboard/src/policy/intake-doc.md b/dashboard/src/policy/intake-doc.md
new file mode 100644
index 0000000..9a3e563
--- /dev/null
+++ b/dashboard/src/policy/intake-doc.md
@@ -0,0 +1,92 @@
+---
+title: Intake Definition of Comprehension (DoC)
+---
+
+```js
+import {API} from "../components/config.js";
+```
+
+```js
+import {marked} from "npm:marked";
+
+const _resp = await fetch(`${API}/policy/intake-doc`);
+if (!_resp.ok) throw new Error(`Failed to load policy: ${_resp.status}`);
+const _policy = await _resp.json();
+```
+
+```js
+let _content = _policy.content;
+let _editing = false;
+
+const _root = display(html`<div></div>`);
+
+async function _save(text) {
+  const r = await fetch(`${API}/policy/intake-doc`, {
+    method: "PUT",
+    headers: {"Content-Type": "application/json"},
+    body: JSON.stringify({content: text}),
+  });
+  if (!r.ok) throw new Error(`Save failed: ${r.status}`);
+  _content = text;
+}
+
+function _toolbar(...nodes) {
+  return html`<div style="display:flex;gap:0.5rem;margin-bottom:1rem">${nodes}</div>`;
+}
+
+function _btn(label, primary = false) {
+  return html`<button style="
+    padding:0.35rem 0.9rem;border-radius:4px;cursor:pointer;font-size:13px;
+    background:${primary ? "#1e293b" : "#f1f5f9"};
+    color:${primary ? "#f8fafc" : "#1e293b"};
+    border:1px solid ${primary ? "#1e293b" : "#cbd5e1"};
+  ">${label}</button>`;
+}
+
+function _render() {
+  _root.innerHTML = "";
+
+  if (_editing) {
+    const area = html`<textarea style="
+      width:100%;box-sizing:border-box;height:520px;
+      font-family:ui-monospace,monospace;font-size:13px;line-height:1.6;
+      padding:0.75rem;border:1px solid #cbd5e1;border-radius:4px;
+      background:#f8fafc;color:#1e293b;resize:vertical;
+    ">${_content}</textarea>`;
+
+    const saveBtn  = _btn("Save", true);
+    const cancelBtn = _btn("Cancel");
+
+    saveBtn.onclick = async () => {
+      saveBtn.disabled = true;
+      saveBtn.textContent = "Saving…";
+      try {
+        await _save(area.value);
+        _editing = false;
+        _render();
+      } catch (e) {
+        saveBtn.disabled = false;
+        saveBtn.textContent = "Save";
+        alert(e.message);
+      }
+    };
+
+    cancelBtn.onclick = () => { _editing = false; _render(); };
+
+    _root.append(_toolbar(saveBtn, cancelBtn), area);
+
+  } else {
+    const editBtn = _btn("Edit");
+    editBtn.onclick = () => { _editing = true; _render(); };
+
+    const body = html`<div style="
+      max-width:720px;line-height:1.7;
+    "></div>`;
+    body.innerHTML = marked.parse(_content);
+
+    _root.append(_toolbar(editBtn), body);
+  }
+}
+
+_render();
+```
diff --git a/dashboard/src/policy/work-item-dor.md b/dashboard/src/policy/work-item-dor.md
new file mode 100644
index 0000000..d160123
--- /dev/null
+++ b/dashboard/src/policy/work-item-dor.md
@@ -0,0 +1,92 @@
+---
+title: Definition of Ready (DoR)
+---
+
+```js
+import {API} from "../components/config.js";
+```
+
+```js
+import {marked} from "npm:marked";
+
+const _resp = await fetch(`${API}/policy/work-item-dor`);
+if (!_resp.ok) throw new Error(`Failed to load policy: ${_resp.status}`);
+const _policy = await _resp.json();
+```
+
+```js
+let _content = _policy.content;
+let _editing = false;
+
+const _root = display(html`<div></div>`);
+
+async function _save(text) {
+  const r = await fetch(`${API}/policy/work-item-dor`, {
+    method: "PUT",
+    headers: {"Content-Type": "application/json"},
+    body: JSON.stringify({content: text}),
+  });
+  if (!r.ok) throw new Error(`Save failed: ${r.status}`);
+  _content = text;
+}
+
+function _toolbar(...nodes) {
+  return html`<div style="display:flex;gap:0.5rem;margin-bottom:1rem">${nodes}</div>`;
+}
+
+function _btn(label, primary = false) {
+  return html`<button style="
+    padding:0.35rem 0.9rem;border-radius:4px;cursor:pointer;font-size:13px;
+    background:${primary ? "#1e293b" : "#f1f5f9"};
+    color:${primary ? "#f8fafc" : "#1e293b"};
+    border:1px solid ${primary ? "#1e293b" : "#cbd5e1"};
+  ">${label}</button>`;
+}
+
+function _render() {
+  _root.innerHTML = "";
+
+  if (_editing) {
+    const area = html`<textarea style="
+      width:100%;box-sizing:border-box;height:520px;
+      font-family:ui-monospace,monospace;font-size:13px;line-height:1.6;
+      padding:0.75rem;border:1px solid #cbd5e1;border-radius:4px;
+      background:#f8fafc;color:#1e293b;resize:vertical;
+    ">${_content}</textarea>`;
+
+    const saveBtn  = _btn("Save", true);
+    const cancelBtn = _btn("Cancel");
+
+    saveBtn.onclick = async () => {
+      saveBtn.disabled = true;
+      saveBtn.textContent = "Saving…";
+      try {
+        await _save(area.value);
+        _editing = false;
+        _render();
+      } catch (e) {
+        saveBtn.disabled = false;
+        saveBtn.textContent = "Save";
+        alert(e.message);
+      }
+    };
+
+    cancelBtn.onclick = () => { _editing = false; _render(); };
+
+    _root.append(_toolbar(saveBtn, cancelBtn), area);
+
+  } else {
+    const editBtn = _btn("Edit");
+    editBtn.onclick = () => { _editing = true; _render(); };
+
+    const body = html`<div style="
+      max-width:720px;line-height:1.7;
+    "></div>`;
+    body.innerHTML = marked.parse(_content);
+
+    _root.append(_toolbar(editBtn), body);
+  }
+}
+
+_render();
+```
diff --git a/dashboard/src/reference.md b/dashboard/src/reference.md
index 25ec465..dd96ce2 100644
--- a/dashboard/src/reference.md
+++ b/dashboard/src/reference.md
@@ -21,22 +21,25 @@ convention used in the Custodian State Hub.
 | Page | What it covers |
 |------|---------------|
 | [Connecting to the Hub](/docs/connecting) | Local and remote connection setup, ops-bridge tunnels, MCP transports |
-| [Contributions](/docs/contributions) | Contribution types, lifecycle, third-party todo workflow |
+| [Contributions](/docs/contributions) | Outbound third-party BR/FR/EP/UPR artifacts, lifecycle, todo class (not a work-record kind) |
 | [Decision Health](/docs/decisions-kpi) | KPI formula, avg resolve time, open-age colour thresholds |
 | [Decisions](/docs/decisions) | Decision types, statuses, escalation rules, filter bar |
 | [Dependencies](/docs/dependencies) | Dependency edges, registration, cycle detection |
 | [Domains](/docs/domains) | Domain model, statuses, cards with repos |
 | [Extension Points](/docs/extensions) | EP types, statuses, priorities, registration |
+| [Intakes](/docs/intakes) | Work-record kind for sparks; lifecycle, promotion, API/MCP |
 | [Inter-Repo Communication](/docs/inter-repo-communication) | Boundary rule, Internal/Ecosystem/Third-party taxonomy, routing workflows |
 | [Live Data](/docs/live-data) | Poll interval, live indicator states, offline recovery |
 | [Overview](/docs/overview) | State summary sections, workplan chart, blocking decisions, next steps |
 | [Progress Log](/docs/progress-log) | Event types, append-only policy, session protocol |
 | [Repos](/docs/repos) | Repo registry, SBOM coverage map, ingestion commands |
 | [SBOM](/docs/sbom) | Lockfile ingestion, licence report, copyleft detection |
+| [Suggestions (archived)](/docs/suggestions) | Retired backlog; archived record and pointer to intakes |
 | [Tasks](/docs/tasks) | Task statuses, priorities, filter bar, status distribution chart |
 | [Technical Debt](/docs/debt) | Debt types, severities, statuses, registration |
 | [Todo](/docs/todo) | Internal/Ecosystem/Third-party classification, data sources |
 | [Workplan Health](/docs/workstream-health-index) | WHI formula, six base metrics, per-domain breakdown |
+| [Workplan Lifecycle](/docs/workstream-lifecycle) | Workplan stored states, health labels, flow operations |
 | [Workplans](/docs/workstreams) | Workplan statuses, dependency edges, WHI KPI card |
 | [WSJF Triage](/docs/wsjf-triage) | Daily triage reports, action vocabulary, advisory review workflow |
 
@@ -46,6 +49,7 @@ convention used in the Custodian State Hub.
 
 | Topic | What it covers |
 |-------|---------------|
+| [Work Records](/docs/work-records) | Umbrella term, unit vs structure, spine, lifecycle vs DoX quality badges |
 | [State Hub](/docs/state-hub) | Why/how/what — Derived Data Store principle, orchestrator role, architecture diagram, design principles |
 | [TPSC](/docs/tpsc) | Third-Party Services Catalog — tpsc.yaml format, ingest, MCP tools |
 | [TPSC — GDPR Maturity](/docs/gdpr-maturity) | 7-level CNIL/IAPP scale, per-level guidance, key GDPR concepts |
diff --git a/dashboard/src/repos.md b/dashboard/src/repos.md
index e9b11ef..fbf041d 100644
--- a/dashboard/src/repos.md
+++ b/dashboard/src/repos.md
@@ -268,7 +268,7 @@ if (domainBlocks.length === 0) {
             </tr></thead>
             <tbody>
               ${rows.map(r => html`<tr class="${r._integrating ? 'row-integrating' : r._hasSbom ? '' : 'row-gap'}">
-                <td class="repo-cell"><code>${r.repo}</code></td>
+                <td class="repo-cell"><a href=${`/repos/${encodeURIComponent(r.repo)}`}><code>${r.repo}</code></a></td>
                 <td>${r.category}</td>
                 <td class="path-cell" title=${r.capTags}>${r.capTags}</td>
                 <td>${_doiBadge(r._doiTier)}</td>
diff --git a/dashboard/src/repos/[slug].md b/dashboard/src/repos/[slug].md
index 3a090d6..73a6b89 100644
--- a/dashboard/src/repos/[slug].md
+++ b/dashboard/src/repos/[slug].md
@@ -21,9 +21,17 @@ if (raw.error) {
   const name = raw.name || raw.slug || repoSlug;
   display(html`<h1 style="font-size:1.1rem;margin-bottom:0.25rem">Repo · <em>${name}</em></h1>`);
   display(html`<p style="margin-top:0"><a href="/repos">← Repos</a> &nbsp;|&nbsp; <a href="/token-cost">← Token Cost</a></p>`);
+  if (raw.slug_status === "alias") {
+    display(html`<div style="border:1px solid #f59e0b;background:#fffbeb;padding:0.75rem 1rem;margin:0.75rem 0;max-width:640px">
+      <strong>Repository alias:</strong> <code>${raw.requested_slug}</code> now resolves to
+      <a href=${`/repos/${encodeURIComponent(raw.canonical_slug)}`}><code>${raw.canonical_slug}</code></a>.
+      Historical records keep the former value.
+    </div>`);
+  }
 
   const FIELD_ORDER = [
-    "id","slug","name","domain_slug","status","description",
+    "id","slug","requested_slug","canonical_slug","slug_status","aliases",
+    "name","domain_slug","status","description",
     "local_path","remote_url","git_fingerprint",
     "sbom_source","last_sbom_at","last_state_synced_at",
     "created_at","updated_at",
diff --git a/dashboard/src/suggestions.md b/dashboard/src/suggestions.md
deleted file mode 100644
index 291385c..0000000
--- a/dashboard/src/suggestions.md
+++ /dev/null
@@ -1,79 +0,0 @@
----
-title: Suggestions
----
-
-```js
-import {apiFetch, pollDelay, waitForVisible} from "./components/config.js";
-const POLL = 30_000;
-```
-
-```js
-const sugState = (async function*() {
-  let failures = 0;
-  while (true) {
-    let data = [], ok = false;
-    try {
-      const r = await apiFetch("/suggestions/?rank=wsjf&limit=100");
-      ok = r.ok;
-      data = ok ? await r.json() : [];
-    } catch {}
-    failures = ok ? 0 : failures + 1;
-    yield {data, ok, ts: new Date()};
-    await waitForVisible(pollDelay({ok, base: POLL, failures}));
-  }
-})();
-```
-
-```js
-const suggestions = sugState.data ?? [];
-const _ok = sugState.ok ?? false;
-const _ts = sugState.ts;
-```
-
-# Demand-Weighted Suggestions
-
-```js
-import {injectTocTop} from "./components/toc-sidebar.js";
-import {withDocHelp} from "./components/doc-overlay.js";
-
-const _liveEl = html`<div class="live-indicator">
-  <span style="color:${_ok ? 'var(--theme-foreground-focus)' : 'red'}">●</span>
-  ${_ok ? `Live · ${_ts?.toLocaleTimeString()}` : html`<span style="color:red">API offline</span>`}
-</div>`;
-withDocHelp(_liveEl, "/docs/live-data");
-injectTocTop("live-indicator", _liveEl);
-
-const _h1 = document.querySelector("#observablehq-main h1");
-if (_h1) { _h1.style.position = "relative"; withDocHelp(_h1, "/docs/suggestions"); }
-
-display(html`<p class="dim">Ranked by WSJF = (base_value + relevance_weight × relevance) / job_size. Gated needs accrue relevance when unmet.</p>`);
-display(html`<p class="dim"><a href="/wsjf-triage">Daily WSJF triage</a> consumes this backlog in its digest.</p>`);
-```
-
-```js
-const stageBadge = (stage) => {
-  const colors = {
-    suggestion: "#6b7280",
-    requirement: "#2563eb",
-    promoted: "#059669",
-    declined: "#9ca3af",
-  };
-  return html`<span style="font-size:0.75rem;padding:0.1rem 0.45rem;border-radius:4px;background:${colors[stage] ?? "#ccc'};color:#fff">${stage}</span>`;
-};
-
-const rows = suggestions.map((s) => html`<tr>
-  <td>${stageBadge(s.stage)}</td>
-  <td><strong>${s.title}</strong>${s.origin_ref ? html`<br/><code style="font-size:0.75rem">${s.origin_ref}</code>` : ""}</td>
-  <td>${s.domain_slug || "—"}</td>
-  <td style="text-align:right">${s.relevance}</td>
-  <td style="text-align:right">${s.wsjf?.toFixed?.(1) ?? s.wsjf}</td>
-  <td style="font-size:0.8rem">${s.last_requested_at ? new Date(s.last_requested_at).toLocaleString() : "—"}</td>
-</tr>`);
-
-display(html`<table class="dashboard-table" style="width:100%;font-size:0.88rem">
-  <thead><tr>
-    <th>Stage</th><th>Title</th><th>Domain</th><th>Relevance</th><th>WSJF</th><th>Last requested</th>
-  </tr></thead>
-  <tbody>${rows.length ? rows : html`<tr><td colspan="6" class="dim">No open suggestions yet.</td></tr>`}</tbody>
-</table>`);
-```
\ No newline at end of file
diff --git a/dashboard/src/workstreams.md b/dashboard/src/workstreams.md
index 16e699f..b9cebe0 100644
--- a/dashboard/src/workstreams.md
+++ b/dashboard/src/workstreams.md
@@ -234,11 +234,13 @@ const _filtersForm = Inputs.form(
     domain: MultiSelect(DOMAINS,  {label: "Domain",  placeholder: "All domains"}),
     status: MultiSelect(STATUSES, {label: "Status",  placeholder: "All statuses"}),
     owner:  Inputs.text({placeholder: "Owner…", style: "width:120px"}),
+    include_residuals: Inputs.toggle({label: "Include residuals", value: false}),
   },
   {
-    template: ({domain, status, owner}) => html`<div class="filter-bar">
+    template: ({domain, status, owner, include_residuals}) => html`<div class="filter-bar">
       ${domain}${status}
       <div class="filter-text-input">${owner}</div>
+      ${include_residuals}
     </div>`,
   }
 );
@@ -253,7 +255,8 @@ const filters = Generators.input(_filtersForm);
 const filtered = data.filter(w =>
   (filters.domain.length === 0 || filters.domain.includes(w.domain)) &&
   (filters.status.length === 0 || filters.status.includes(w.status)) &&
-  (!filters.owner || (w.owner ?? "").toLowerCase().includes(filters.owner.toLowerCase()))
+  (!filters.owner || (w.owner ?? "").toLowerCase().includes(filters.owner.toLowerCase())) &&
+  (filters.include_residuals || w.flavor !== "residual")
 );
 ```
 
diff --git a/dashboard/src/wsjf-triage.md b/dashboard/src/wsjf-triage.md
index c593923..bf991ca 100644
--- a/dashboard/src/wsjf-triage.md
+++ b/dashboard/src/wsjf-triage.md
@@ -219,7 +219,7 @@ injectTocTop("live-indicator", _liveEl);
 const _h1 = document.querySelector("#observablehq-main h1");
 if (_h1) { _h1.style.position = "relative"; withDocHelp(_h1, "/docs/wsjf-triage"); }
 
-display(html`<p class="triage-subtitle">Daily State Hub triage from activity-core. Recommendations are advisory; the operator and workplan owners decide what to act on. Ranked <a href="/suggestions">suggestion backlog</a> feeds the digest.</p>`);
+display(html`<p class="triage-subtitle">Daily State Hub triage from activity-core. Recommendations are advisory; the operator and workplan owners decide what to act on. The ranked suggestion backlog that once fed this digest is retired (slice E1); the digest now stands on workplan and task state alone.</p>`);
 display(html`<div class="triage-latest">
   <span>Last updated</span>
   <strong>${latestReport ? fmtDateTime(latestReport.created_at) : "No daily_triage events yet"}</strong>
diff --git a/dashboard/test/improvement-modal.test.mjs b/dashboard/test/improvement-modal.test.mjs
new file mode 100644
index 0000000..8fe6019
--- /dev/null
+++ b/dashboard/test/improvement-modal.test.mjs
@@ -0,0 +1,46 @@
+import assert from "node:assert/strict";
+import test from "node:test";
+import {readFileSync} from "node:fs";
+import {dirname, join} from "node:path";
+import {fileURLToPath} from "node:url";
+
+import {
+  DEFAULT_IMPROVEMENT_DOMAIN,
+  resolveImprovementApiBase,
+} from "../src/components/improvement-modal.js";
+
+const root = dirname(fileURLToPath(import.meta.url));
+const modalSource = readFileSync(
+  join(root, "../src/components/improvement-modal.js"),
+  "utf-8",
+);
+
+test("dashboard-improvement default domain is the live infotech slug", () => {
+  assert.equal(DEFAULT_IMPROVEMENT_DOMAIN, "infotech");
+  // Regression: custodian was retired from the domain registry; POST /technical-debt/
+  // returns 422 for unknown domain, so the shift-wait-click modal must not use it.
+  assert.doesNotMatch(modalSource, /domain\s*=\s*["']custodian["']/);
+  assert.match(modalSource, /domain\s*=\s*DEFAULT_IMPROVEMENT_DOMAIN/);
+  assert.match(modalSource, /debt_type:\s*["']dashboard-improvement["']/);
+});
+
+test("improvement modal api base mirrors dashboard config resolution", () => {
+  assert.equal(
+    resolveImprovementApiBase({location: null, storage: null}),
+    "http://127.0.0.1:8000",
+  );
+  assert.equal(
+    resolveImprovementApiBase({
+      location: new URL("http://localhost:3000/workstreams"),
+      storage: null,
+    }),
+    "http://localhost:8000",
+  );
+  assert.equal(
+    resolveImprovementApiBase({
+      location: new URL("http://localhost:3000/?api_base=http%3A%2F%2F127.0.0.1%3A18000%2F"),
+      storage: {getItem: () => "http://ignored.example:8000"},
+    }),
+    "http://127.0.0.1:18000",
+  );
+});
diff --git a/dashboard/test/workplan-search.test.mjs b/dashboard/test/workplan-search.test.mjs
new file mode 100644
index 0000000..33f5940
--- /dev/null
+++ b/dashboard/test/workplan-search.test.mjs
@@ -0,0 +1,42 @@
+import assert from "node:assert/strict";
+import test from "node:test";
+import {readFileSync} from "node:fs";
+import {dirname, join} from "node:path";
+import {fileURLToPath} from "node:url";
+
+import {workplanMatchesSearch} from "../src/components/workplan-search.js";
+
+const root = dirname(fileURLToPath(import.meta.url));
+const indexMd = readFileSync(join(root, "../src/index.md"), "utf-8");
+
+const sample = {
+  id: "abc-123",
+  title: "Overview Workstream Stage Counts",
+  repo_label: "state-hub",
+  domain: "infotech",
+  workplan_filename: "STATE-WP-0057-overview-workstream-stage-counts.md",
+  owner: "codex",
+};
+
+test("empty query matches all workplans", () => {
+  assert.equal(workplanMatchesSearch(sample, ""), true);
+  assert.equal(workplanMatchesSearch(sample, "   "), true);
+  assert.equal(workplanMatchesSearch(sample, null), true);
+});
+
+test("matches title, repo, domain, filename, owner, and id", () => {
+  assert.equal(workplanMatchesSearch(sample, "stage counts"), true);
+  assert.equal(workplanMatchesSearch(sample, "STATE-HUB"), true);
+  assert.equal(workplanMatchesSearch(sample, "Infotech"), true);
+  assert.equal(workplanMatchesSearch(sample, "wp-0057"), true);
+  assert.equal(workplanMatchesSearch(sample, "codex"), true);
+  assert.equal(workplanMatchesSearch(sample, "abc-123"), true);
+  assert.equal(workplanMatchesSearch(sample, "railiance"), false);
+});
+
+test("overview chart wires the text filter into Workplans by Repository", () => {
+  assert.match(indexMd, /workplanMatchesSearch/);
+  assert.match(indexMd, /ws-search-input/);
+  assert.match(indexMd, /Filter by title, repo, domain/);
+  assert.match(indexMd, /## Workplans by Repository/);
+});
diff --git a/deploy/railiance/README.md b/deploy/railiance/README.md
index f34f3fc..1439b77 100644
--- a/deploy/railiance/README.md
+++ b/deploy/railiance/README.md
@@ -21,7 +21,7 @@ boundaries used for the actual cluster rollout.
 The current image is pinned to:
 
 ```text
-forgejo.coulomb.social/coulomb/state-hub:f2e042a
+forgejo.coulomb.social/coulomb/state-hub:main-cdff3b7
 ```
 
 railiance01 has already pulled this tag with `crictl`, and the image serves
@@ -87,4 +87,4 @@ DATABASE_URL=postgresql+asyncpg://state_hub:<url-encoded-password>@state-hub-db-
 Optional runtime settings such as `CORS_ORIGINS` can live in the chart
 ConfigMap. The default chart keeps public ingress disabled; access should use
 the existing private tunnel/ops-bridge path until a separate exposure decision
-is recorded.
\ No newline at end of file
+is recorded.
diff --git a/deploy/railiance/apps/charts/state-hub/Chart.yaml b/deploy/railiance/apps/charts/state-hub/Chart.yaml
index c7942d4..eeaef29 100644
--- a/deploy/railiance/apps/charts/state-hub/Chart.yaml
+++ b/deploy/railiance/apps/charts/state-hub/Chart.yaml
@@ -3,4 +3,4 @@ name: state-hub
 description: State Hub API service for private Railiance operation
 type: application
 version: 0.1.0
-appVersion: "f2e042a"
\ No newline at end of file
+appVersion: "main-0747b4d"
diff --git a/deploy/railiance/apps/charts/state-hub/PROMOTE.md b/deploy/railiance/apps/charts/state-hub/PROMOTE.md
new file mode 100644
index 0000000..7a59369
--- /dev/null
+++ b/deploy/railiance/apps/charts/state-hub/PROMOTE.md
@@ -0,0 +1,51 @@
+# state-hub image promotion (Forgejo)
+
+The state-hub container image is built and published by CI
+(`.forgejo/workflows/image.yaml`) to the **Forgejo** registry on every `main`
+push that touches the app:
+
+- `forgejo.coulomb.social/coulomb/state-hub:main-<short-sha>` — immutable, promotable
+- `forgejo.coulomb.social/coulomb/state-hub:latest` — moving pointer to newest main
+
+The chart's `image.repository` defaults to `forgejo.coulomb.social/coulomb/state-hub`.
+
+## Promote a build to the cluster
+
+0. **Headroom preflight (STATE-WP-0091).** Read-only. Does not lower requests
+   and does not start Helm. Refuse if remaining CPU cannot cover the API
+   `maxSurge=1` pod (100m), the migrate hook (50m), or unrelated pending demand.
+   Aggregate remaining millicores is **not** a scheduling guarantee. Keep
+   `--atomic` so a failed pull/roll rolls back.
+   ```
+   make railiance-state-hub-headroom
+   # fixture replay of revision 61/63:
+   make railiance-state-hub-headroom HEADROOM_FIXTURE=tests/fixtures/release_headroom/rev61-65m.json
+   ```
+   Do not proceed if the report `ok` is false.
+
+1. Pick a CI-produced tag to promote — **use an immutable `main-<sha>`**, not
+   `latest` (avoid surprise upgrades). List candidates:
+   ```
+   # requires a Forgejo read token
+   curl -s -u <user>:<token> \
+     "https://forgejo.coulomb.social/api/v1/packages/coulomb?type=container&q=state-hub"
+   ```
+2. Upgrade the release (rolling, `maxUnavailable=0` → zero downtime; `--atomic`
+   auto-rolls-back if the pull fails):
+   ```
+   helm -n state-hub upgrade state-hub <chart-path> \
+     --reuse-values \
+     --set image.tag=main-<sha> \
+     --atomic --timeout 3m
+   ```
+3. Update this chart's `appVersion` to the promoted `main-<sha>` and commit, so the
+   declared version matches what's deployed.
+
+## History
+
+- **2026-07-16:** the deployed release pinned the gitea-era tag `f2e042a`, which
+  Forgejo CI never produced. The running image was preserved by a one-off
+  gitea→Forgejo copy of `f2e042a` and the release repointed to Forgejo
+  (CUST-WP-0059). Going forward, promotions use CI `main-<sha>` tags — no manual
+  image copies. The next promotion should move off `f2e042a` onto a `main-<sha>`
+  and update `appVersion` accordingly.
diff --git a/deploy/railiance/apps/charts/state-hub/files/repo-classification.allowed.yaml b/deploy/railiance/apps/charts/state-hub/files/repo-classification.allowed.yaml
new file mode 100644
index 0000000..a29137c
--- /dev/null
+++ b/deploy/railiance/apps/charts/state-hub/files/repo-classification.allowed.yaml
@@ -0,0 +1,124 @@
+# GENERATED — do not edit.
+# Synced from the-custodian/canon/standards/repo-classification.allowed.yaml
+# by scripts/sync_classification_allowed.py (CUST-WP-0067-T09).
+# Canon is authoritative; this copy exists only so the container has one.
+# Machine-readable allowed-values for the Repo Classification Standard.
+#
+# Single source of truth for the standard's controlled vocabularies, derived
+# from canon/standards/repo-classification-standard_v1.0.md. Consumed by:
+#   - the per-repo .repo-classification.yaml linter (tools/validate_repo_classification.py)
+#   - the State Hub registration validator (CUST-WP-0050 T04)
+#
+# When the standard's vocabularies change, update this file and bump `version`
+# to match the standard version. CUST-WP-0050 T01.
+
+standard: "Repo Classification Standard"
+version: "1.0"
+canon_id: "canon-repo-classification"
+
+# category — exactly 1 required (§5)
+categories:
+  - experimental
+  - research
+  - project
+  - tooling
+  - product
+  - business
+
+# domain / secondary_domains — primary exactly 1; secondaries 0..n (§6)
+domains:
+  - infotech
+  - financials
+  - communication
+  - consumer
+  - health
+  - industrials
+  - energy
+  - utilities
+  - materials
+  - realestate
+  - crypto
+  - agents
+  - space
+  - government
+
+# business_stake — 0..n; 2..6 recommended (§8)
+business_stake:
+  - execution
+  - intelligence
+  - finance
+  - legal
+  - sales
+  - experience
+  - technology
+  - operations
+  - product
+  - people
+  - procurement
+  - sustainability
+  - automation
+
+# business_mechanics — 0..n, optional (§9)
+business_mechanics:
+  - intention
+  - control
+  - coordination
+  - operation
+  - adaptation
+
+# capability_tags are intentionally OPEN-ENDED (§7): lowercase kebab-case, not
+# restricted to this set. The families below are the standard's recommended
+# canonical tags — used to warn on likely synonyms/typos, never to reject.
+capability_families:
+  identity_and_access:
+    - identity
+    - authentication
+    - authorization
+    - access-control
+    - user-management
+    - tenancy
+  knowledge_and_evidence:
+    - knowledge
+    - citations
+    - evidence
+    - source-management
+    - traceability
+    - documentation
+    - decision-support
+  platform_and_operations:
+    - platform
+    - deployment
+    - operations
+    - observability
+    - feature-control
+    - configuration
+    - orchestration
+  market_and_coordination:
+    - marketplace
+    - pricing
+    - monetization
+    - reputation
+    - challenges
+    - bounties
+    - collaboration
+    - coordination
+  product_and_lifecycle:
+    - product-development
+    - lifecycle
+  governance_and_control:
+    - governance
+    - policy
+    - compliance
+    - risk
+    - audit
+    - control
+  games_and_entertainment:
+    - game
+    - entertainment
+
+# Validation guidance (advisory bounds the linter applies as warnings)
+guidance:
+  secondary_domains_max: 3
+  business_stake_recommended_min: 2
+  business_stake_recommended_max: 6
+  capability_tag_pattern: "^[a-z0-9]+(-[a-z0-9]+)*$"
diff --git a/deploy/railiance/apps/charts/state-hub/templates/_helpers.tpl b/deploy/railiance/apps/charts/state-hub/templates/_helpers.tpl
index f02f9f4..d6af21c 100644
--- a/deploy/railiance/apps/charts/state-hub/templates/_helpers.tpl
+++ b/deploy/railiance/apps/charts/state-hub/templates/_helpers.tpl
@@ -23,4 +23,32 @@ app: {{ include "statehub.fullname" . }}
 {{- fail "image.tag is required - pin it in deploy/railiance/apps/helm/state-hub-values.yaml or pass --set image.tag=<sha>" -}}
 {{- end -}}
 {{- printf "%s:%s" .Values.image.repository .Values.image.tag -}}
-{{- end -}}
\ No newline at end of file
+{{- end -}}
+
+{{- define "statehub.mcpFullname" -}}
+{{- printf "%s-mcp" (include "statehub.fullname" .) | trunc 63 | trimSuffix "-" -}}
+{{- end -}}
+
+{{- define "statehub.mcpLabels" -}}
+app: {{ include "statehub.mcpFullname" . }}
+app.kubernetes.io/name: {{ include "statehub.mcpFullname" . }}
+app.kubernetes.io/component: mcp
+app.kubernetes.io/instance: {{ .Release.Name }}
+app.kubernetes.io/managed-by: {{ .Release.Service }}
+app.kubernetes.io/version: {{ .Chart.AppVersion | quote }}
+app.kubernetes.io/part-of: railiance-apps
+helm.sh/chart: {{ printf "%s-%s" .Chart.Name .Chart.Version | replace "+" "_" }}
+railiance.io/layer: s5-app
+{{- end -}}
+
+{{- define "statehub.mcpSelectorLabels" -}}
+app: {{ include "statehub.mcpFullname" . }}
+{{- end -}}
+
+{{- define "statehub.mcpApiBase" -}}
+{{- if .Values.mcp.apiBase -}}
+{{- .Values.mcp.apiBase -}}
+{{- else -}}
+{{- printf "http://%s:%v" (include "statehub.fullname" .) .Values.service.port -}}
+{{- end -}}
+{{- end -}}
diff --git a/deploy/railiance/apps/charts/state-hub/templates/classification-configmap.yaml b/deploy/railiance/apps/charts/state-hub/templates/classification-configmap.yaml
new file mode 100644
index 0000000..b471c69
--- /dev/null
+++ b/deploy/railiance/apps/charts/state-hub/templates/classification-configmap.yaml
@@ -0,0 +1,12 @@
+{{- if .Values.classificationAllowed.enabled }}
+apiVersion: v1
+kind: ConfigMap
+metadata:
+  name: {{ .Values.classificationAllowed.name | quote }}
+  labels: {{- include "statehub.labels" . | nindent 4 }}
+data:
+  # Generated copy of the-custodian canon allowed-values. Kept in sync by
+  # scripts/sync_classification_allowed.py; `--check` fails the release on drift.
+  repo-classification.allowed.yaml: |
+{{ .Files.Get "files/repo-classification.allowed.yaml" | indent 4 }}
+{{- end }}
diff --git a/deploy/railiance/apps/charts/state-hub/templates/configmap.yaml b/deploy/railiance/apps/charts/state-hub/templates/configmap.yaml
index 69de021..8604514 100644
--- a/deploy/railiance/apps/charts/state-hub/templates/configmap.yaml
+++ b/deploy/railiance/apps/charts/state-hub/templates/configmap.yaml
@@ -6,4 +6,11 @@ metadata:
   labels: {{- include "statehub.labels" . | nindent 4 }}
 data:
   CORS_ORIGINS: {{ .Values.config.corsOrigins | quote }}
-{{- end }}
\ No newline at end of file
+  SBOM_NEXUS_URL: {{ .Values.config.sbomNexusUrl | quote }}
+  SBOM_NEXUS_READ_MODE: {{ .Values.config.sbomNexusReadMode | quote }}
+  SBOM_NEXUS_WRITE_MODE: {{ .Values.config.sbomNexusWriteMode | quote }}
+  # What this instance claims to be. Callers that need the authoritative hub
+  # check this rather than assuming whatever answered is central.
+  STATE_HUB_INSTANCE_ROLE: {{ .Values.config.instanceRole | quote }}
+  STATE_HUB_INSTANCE_LABEL: {{ .Values.config.instanceLabel | quote }}
+{{- end }}
diff --git a/deploy/railiance/apps/charts/state-hub/templates/deployment.yaml b/deploy/railiance/apps/charts/state-hub/templates/deployment.yaml
index f931fe2..41c1faf 100644
--- a/deploy/railiance/apps/charts/state-hub/templates/deployment.yaml
+++ b/deploy/railiance/apps/charts/state-hub/templates/deployment.yaml
@@ -14,14 +14,21 @@ spec:
       maxUnavailable: 0
   template:
     metadata:
+      annotations:
+        checksum/config: {{ include (print $.Template.BasePath "/configmap.yaml") . | sha256sum }}
       labels: {{- include "statehub.labels" . | nindent 8 }}
     spec:
+      {{- if .Values.serviceAccount.name }}
+      serviceAccountName: {{ .Values.serviceAccount.name | quote }}
+      {{- end }}
       securityContext: {{- toYaml .Values.podSecurityContext | nindent 8 }}
       {{- with .Values.imagePullSecrets }}
       imagePullSecrets: {{- toYaml . | nindent 8 }}
       {{- end }}
-      {{- if .Values.sweep.enabled }}
       volumes:
+        - name: runtime-tmp
+          emptyDir: {}
+        {{- if .Values.sweep.enabled }}
         - name: sweep-repos
           hostPath:
             path: {{ .Values.sweep.hostPath | quote }}
@@ -30,7 +37,27 @@ spec:
           hostPath:
             path: {{ .Values.sweep.sshHostPath | quote }}
             type: DirectoryOrCreate
-      {{- end }}
+        {{- end }}
+        {{- if .Values.classificationAllowed.enabled }}
+        - name: classification-allowed
+          configMap:
+            name: {{ .Values.classificationAllowed.name | quote }}
+        {{- end }}
+        {{- if .Values.forgeRead.enabled }}
+        # A projected token with an explicit audience, not the legacy
+        # auto-mounted one: the auto-mounted token has the API server as its
+        # audience, so a copy of it is a credential for the cluster. This one is
+        # only accepted by OpenBao, and the kubelet rotates it in place.
+        - name: openbao-token
+          projected:
+            sources:
+              - serviceAccountToken:
+                  path: token
+                  {{- with .Values.forgeRead.openbao.audience }}
+                  audience: {{ . | quote }}
+                  {{- end }}
+                  expirationSeconds: {{ .Values.forgeRead.openbao.expirationSeconds }}
+        {{- end }}
       containers:
         - name: state-hub
           image: {{ include "statehub.image" . | quote }}
@@ -48,18 +75,64 @@ spec:
                   - /bin/sh
                   - -c
                   - git config --global --add safe.directory '*'
+          {{- end }}
           volumeMounts:
+            - name: runtime-tmp
+              mountPath: /tmp
+            {{- if .Values.sweep.enabled }}
             - name: sweep-repos
               mountPath: {{ .Values.sweep.hostPath | quote }}
             - name: sweep-ssh
               mountPath: /root/.ssh
               readOnly: true
+            {{- end }}
+            {{- if .Values.classificationAllowed.enabled }}
+            - name: classification-allowed
+              mountPath: {{ .Values.classificationAllowed.mountPath | quote }}
+              readOnly: true
+            {{- end }}
+            {{- if .Values.forgeRead.enabled }}
+            - name: openbao-token
+              mountPath: /var/run/secrets/openbao
+              readOnly: true
+            {{- end }}
           env:
+            {{- if .Values.renamePreflight.enabled }}
+            - name: REPOSITORY_RENAME_PREFLIGHT_SECRET
+              valueFrom:
+                secretKeyRef:
+                  name: {{ .Values.renamePreflight.secretName | quote }}
+                  key: REPOSITORY_RENAME_PREFLIGHT_SECRET
+                  optional: false
+            {{- end }}
+            - name: HOME
+              value: /tmp
+            {{- if .Values.sweep.enabled }}
             - name: STATE_HUB_SWEEP_HOSTNAME
               value: {{ .Values.sweep.hostname | quote }}
             - name: GIT_SSH_COMMAND
               value: "ssh -o StrictHostKeyChecking=accept-new -F /root/.ssh/config"
-          {{- end }}
+            {{- end }}
+            {{- if .Values.classificationAllowed.enabled }}
+            - name: REPO_CLASSIFICATION_ALLOWED_PATH
+              value: {{ printf "%s/repo-classification.allowed.yaml" .Values.classificationAllowed.mountPath | quote }}
+            {{- end }}
+            {{- if .Values.forgeRead.enabled }}
+            # Coordinates only. The token itself is never a chart value, never
+            # in the image, and never in a Kubernetes Secret in this release.
+            - name: OPENBAO_ADDR
+              value: {{ .Values.forgeRead.openbao.addr | quote }}
+            - name: OPENBAO_K8S_ROLE
+              value: {{ .Values.forgeRead.openbao.role | quote }}
+            - name: OPENBAO_K8S_AUTH_MOUNT
+              value: {{ .Values.forgeRead.openbao.authMount | quote }}
+            - name: OPENBAO_K8S_TOKEN_PATH
+              value: /var/run/secrets/openbao/token
+            - name: FORGE_READ_SECRET_PATH
+              value: {{ .Values.forgeRead.openbao.secretPath | quote }}
+            - name: FORGE_READ_SECRET_KEY
+              value: {{ .Values.forgeRead.openbao.secretKey | quote }}
+            {{- end }}
           envFrom:
             {{- if .Values.config.enabled }}
             - configMapRef:
@@ -94,4 +167,4 @@ spec:
       {{- end }}
       {{- with .Values.tolerations }}
       tolerations: {{- toYaml . | nindent 8 }}
-      {{- end }}
\ No newline at end of file
+      {{- end }}
diff --git a/deploy/railiance/apps/charts/state-hub/templates/mcp-deployment.yaml b/deploy/railiance/apps/charts/state-hub/templates/mcp-deployment.yaml
new file mode 100644
index 0000000..dc104b0
--- /dev/null
+++ b/deploy/railiance/apps/charts/state-hub/templates/mcp-deployment.yaml
@@ -0,0 +1,83 @@
+{{- if .Values.mcp.enabled }}
+apiVersion: apps/v1
+kind: Deployment
+metadata:
+  name: {{ include "statehub.mcpFullname" . }}
+  labels: {{- include "statehub.mcpLabels" . | nindent 4 }}
+spec:
+  replicas: {{ .Values.mcp.replicaCount }}
+  selector:
+    matchLabels: {{- include "statehub.mcpSelectorLabels" . | nindent 6 }}
+  strategy:
+    type: RollingUpdate
+    rollingUpdate:
+      maxSurge: 1
+      maxUnavailable: 0
+  template:
+    metadata:
+      labels: {{- include "statehub.mcpLabels" . | nindent 8 }}
+    spec:
+      securityContext: {{- toYaml .Values.podSecurityContext | nindent 8 }}
+      {{- with .Values.imagePullSecrets }}
+      imagePullSecrets: {{- toYaml . | nindent 8 }}
+      {{- end }}
+      volumes:
+        - name: runtime-tmp
+          emptyDir: {}
+      containers:
+        - name: state-hub-mcp
+          image: {{ include "statehub.image" . | quote }}
+          imagePullPolicy: {{ .Values.image.pullPolicy }}
+          securityContext: {{- toYaml .Values.securityContext | nindent 12 }}
+          # The image CMD serves the API; this pod runs the MCP layer instead.
+          # Use -m so the WORKDIR (/app) lands on sys.path — invoking the file
+          # directly would put /app/mcp_server there and break its own imports.
+          command: ["/app/.venv/bin/python", "-m", "mcp_server.server"]
+          volumeMounts:
+            - name: runtime-tmp
+              mountPath: /tmp
+          ports:
+            - name: sse
+              containerPort: {{ .Values.mcp.service.targetPort }}
+              protocol: TCP
+          env:
+            - name: HOME
+              value: /tmp
+            - name: MCP_TRANSPORT
+              value: {{ .Values.mcp.transport | quote }}
+            - name: MCP_PORT
+              value: {{ .Values.mcp.service.targetPort | quote }}
+            # A Service routes to the pod IP, so the default loopback bind
+            # would be unreachable.
+            - name: MCP_HOST
+              value: "0.0.0.0"
+            # Stateless HTTP client over the API — no database access.
+            - name: API_BASE
+              value: {{ include "statehub.mcpApiBase" . | quote }}
+          {{- if .Values.mcp.probes.enabled }}
+          readinessProbe:
+            tcpSocket:
+              port: {{ .Values.mcp.service.targetPort }}
+            initialDelaySeconds: {{ .Values.mcp.probes.readiness.initialDelaySeconds }}
+            periodSeconds: {{ .Values.mcp.probes.readiness.periodSeconds }}
+            timeoutSeconds: {{ .Values.mcp.probes.readiness.timeoutSeconds }}
+            failureThreshold: {{ .Values.mcp.probes.readiness.failureThreshold }}
+          livenessProbe:
+            tcpSocket:
+              port: {{ .Values.mcp.service.targetPort }}
+            initialDelaySeconds: {{ .Values.mcp.probes.liveness.initialDelaySeconds }}
+            periodSeconds: {{ .Values.mcp.probes.liveness.periodSeconds }}
+            timeoutSeconds: {{ .Values.mcp.probes.liveness.timeoutSeconds }}
+            failureThreshold: {{ .Values.mcp.probes.liveness.failureThreshold }}
+          {{- end }}
+          resources: {{- toYaml .Values.mcp.resources | nindent 12 }}
+      {{- with .Values.nodeSelector }}
+      nodeSelector: {{- toYaml . | nindent 8 }}
+      {{- end }}
+      {{- with .Values.affinity }}
+      affinity: {{- toYaml . | nindent 8 }}
+      {{- end }}
+      {{- with .Values.tolerations }}
+      tolerations: {{- toYaml . | nindent 8 }}
+      {{- end }}
+{{- end }}
diff --git a/deploy/railiance/apps/charts/state-hub/templates/mcp-service.yaml b/deploy/railiance/apps/charts/state-hub/templates/mcp-service.yaml
new file mode 100644
index 0000000..7b6ce33
--- /dev/null
+++ b/deploy/railiance/apps/charts/state-hub/templates/mcp-service.yaml
@@ -0,0 +1,17 @@
+{{- if .Values.mcp.enabled }}
+apiVersion: v1
+kind: Service
+metadata:
+  name: {{ include "statehub.mcpFullname" . }}
+  labels: {{- include "statehub.mcpLabels" . | nindent 4 }}
+spec:
+  # ClusterIP only, and deliberately no Ingress: the MCP layer proxies an
+  # unauthenticated API and must not be reachable from outside the cluster.
+  type: ClusterIP
+  ports:
+    - port: {{ .Values.mcp.service.port }}
+      targetPort: {{ .Values.mcp.service.targetPort }}
+      protocol: TCP
+      name: sse
+  selector: {{- include "statehub.mcpSelectorLabels" . | nindent 4 }}
+{{- end }}
diff --git a/deploy/railiance/apps/charts/state-hub/templates/migrate-job.yaml b/deploy/railiance/apps/charts/state-hub/templates/migrate-job.yaml
new file mode 100644
index 0000000..ff8488d
--- /dev/null
+++ b/deploy/railiance/apps/charts/state-hub/templates/migrate-job.yaml
@@ -0,0 +1,51 @@
+{{- if .Values.migrations.enabled }}
+apiVersion: batch/v1
+kind: Job
+metadata:
+  name: {{ include "statehub.fullname" . }}-migrate
+  labels: {{- include "statehub.labels" . | nindent 4 }}
+  annotations:
+    # Run before the API starts serving, and before an upgrade swaps the image.
+    # A deployment that can serve against a schema it was not built for is the
+    # same class of defect as a projection that cannot name its source commit
+    # (STATE-WP-0083-T07).
+    "helm.sh/hook": pre-install,pre-upgrade
+    "helm.sh/hook-weight": "-5"
+    # Keep a failed job for inspection; a silent migration failure is how the
+    # schema drifted two revisions behind the code in the first place.
+    "helm.sh/hook-delete-policy": before-hook-creation,hook-succeeded
+spec:
+  backoffLimit: {{ .Values.migrations.backoffLimit }}
+  template:
+    metadata:
+      labels: {{- include "statehub.labels" . | nindent 8 }}
+    spec:
+      restartPolicy: Never
+      securityContext: {{- toYaml .Values.podSecurityContext | nindent 8 }}
+      {{- with .Values.imagePullSecrets }}
+      imagePullSecrets: {{- toYaml . | nindent 8 }}
+      {{- end }}
+      volumes:
+        - name: runtime-tmp
+          emptyDir: {}
+      containers:
+        - name: migrate
+          image: {{ include "statehub.image" . | quote }}
+          imagePullPolicy: {{ .Values.image.pullPolicy }}
+          securityContext: {{- toYaml .Values.securityContext | nindent 12 }}
+          command: ["/app/.venv/bin/python", "-m", "alembic", "upgrade", "head"]
+          volumeMounts:
+            - name: runtime-tmp
+              mountPath: /tmp
+          env:
+            - name: HOME
+              value: /tmp
+          envFrom:
+            {{- if .Values.config.enabled }}
+            - configMapRef:
+                name: {{ .Values.config.name | quote }}
+            {{- end }}
+            - secretRef:
+                name: {{ .Values.secret.name | quote }}
+          resources: {{- toYaml .Values.migrations.resources | nindent 12 }}
+{{- end }}
diff --git a/deploy/railiance/apps/charts/state-hub/templates/serviceaccount.yaml b/deploy/railiance/apps/charts/state-hub/templates/serviceaccount.yaml
new file mode 100644
index 0000000..6efb4c9
--- /dev/null
+++ b/deploy/railiance/apps/charts/state-hub/templates/serviceaccount.yaml
@@ -0,0 +1,12 @@
+{{- if .Values.serviceAccount.create }}
+# STATE-WP-0084-T02. The OpenBao Kubernetes auth role built by MASON-WP-0003-T02
+# binds to this ServiceAccount by name and deliberately does not bind to
+# `default` — so the pod must stop running as `default` before the lane can
+# carry anything. Creating it here keeps that binding in the release rather than
+# in an operator's memory.
+apiVersion: v1
+kind: ServiceAccount
+metadata:
+  name: {{ .Values.serviceAccount.name | quote }}
+  labels: {{- include "statehub.labels" . | nindent 4 }}
+{{- end }}
diff --git a/deploy/railiance/apps/charts/state-hub/values.yaml b/deploy/railiance/apps/charts/state-hub/values.yaml
index 9c2fb59..97bb087 100644
--- a/deploy/railiance/apps/charts/state-hub/values.yaml
+++ b/deploy/railiance/apps/charts/state-hub/values.yaml
@@ -22,10 +22,57 @@ config:
   enabled: true
   name: state-hub-config
   corsOrigins: "http://localhost:3000,http://127.0.0.1:3000,http://localhost:3001,http://127.0.0.1:3001"
+  sbomNexusUrl: ""
+  sbomNexusReadMode: legacy
+  sbomNexusWriteMode: legacy
+  # CUST-WP-0067-T03. "unknown" is the honest default for a chart that could be
+  # installed anywhere; the production values set this to primary.
+  instanceRole: unknown
+  instanceLabel: ""
+
+# STATE-WP-0084-T02. The OpenBao Kubernetes auth role binds to this name and
+# not to `default`, so this is load-bearing, not cosmetic.
+serviceAccount:
+  create: true
+  name: state-hub
 
 secret:
   name: state-hub-env
 
+# Forge read credential for deriving private repositories (STATE-WP-0084,
+# MASON-WP-0003). Disabled by default: a hub without it still derives every
+# public repository, so this is added capability, not a prerequisite.
+#
+# There is no agent injector and no secrets-store CSI driver on this cluster, so
+# the pod authenticates to OpenBao itself with its projected ServiceAccount
+# token and reads the KV path. Nothing here is the credential; these are only
+# coordinates. Rotating the token in OpenBao needs no chart change and no
+# redeploy.
+forgeRead:
+  enabled: false
+  openbao:
+    # Matches every existing ClusterSecretStore on this cluster.
+    addr: http://openbao.openbao.svc:8200
+    authMount: kubernetes
+    role: state-hub-forge-derivation
+    # KV v2: the read path carries the `data/` infix, mount `platform`.
+    secretPath: platform/data/workloads/state-hub/forge-derivation
+    secretKey: FORGE_READ_TOKEN
+    # Audience for the projected ServiceAccount token.
+    #
+    # Empty renders no audience, giving the token the API server's audience —
+    # what the four existing external-secrets roles use, and what an OpenBao
+    # Kubernetes auth role with no bound audience will accept. A token with an
+    # audience the role does not bind is rejected at TokenReview, so this must
+    # not be set to "openbao" until the role binds that audience.
+    #
+    # Worth revisiting: with no audience, a copy of this token is a credential
+    # for the cluster API. Binding `openbao` on the role and setting it here
+    # narrows it to OpenBao alone. Either way the token is short-lived and
+    # kubelet-rotated, which the legacy auto-mounted token is not.
+    audience: ""
+    expirationSeconds: 3600
+
 resources:
   requests:
     cpu: 250m
@@ -44,6 +91,62 @@ ingress:
     traefik.ingress.kubernetes.io/router.tls: "true"
     cert-manager.io/cluster-issuer: letsencrypt-prod
 
+# Database migrations (STATE-WP-0083-T07). Runs as a Helm pre-install/pre-upgrade
+# hook rather than an init container: an init container runs per pod, so more
+# than one replica means concurrent `alembic upgrade` with no locking. A hook
+# runs once per release and fails the upgrade if the migration fails.
+migrations:
+  enabled: true
+  backoffLimit: 1
+  resources:
+    requests:
+      cpu: 50m
+      memory: 256Mi
+    limits:
+      cpu: 500m
+      memory: 1Gi
+
+# Classification allowed-values (CUST-WP-0067-T09). The API validates repo
+# classification against the-custodian canon; a container has no such checkout,
+# so the file travels with the release as a ConfigMap. Without it every
+# classification write fails with a 500.
+classificationAllowed:
+  enabled: true
+  name: state-hub-classification-allowed
+  mountPath: /etc/state-hub/classification
+
+# MCP layer (CUST-WP-0067-T08). Runs from the same image with a different
+# command, as a stateless HTTP client over the API service. ClusterIP only —
+# it proxies an unauthenticated API, so it must never gain an Ingress.
+mcp:
+  enabled: false
+  replicaCount: 1
+  transport: sse
+  # Defaults to the in-cluster API Service; override only to point elsewhere.
+  apiBase: ""
+  service:
+    port: 8001
+    targetPort: 8001
+  probes:
+    enabled: true
+    liveness:
+      initialDelaySeconds: 30
+      periodSeconds: 30
+      timeoutSeconds: 5
+      failureThreshold: 3
+    readiness:
+      initialDelaySeconds: 10
+      periodSeconds: 10
+      timeoutSeconds: 5
+      failureThreshold: 3
+  resources:
+    requests:
+      cpu: 50m
+      memory: 128Mi
+    limits:
+      cpu: 500m
+      memory: 512Mi
+
 probes:
   enabled: true
   path: /state/health
@@ -59,16 +162,36 @@ probes:
     timeoutSeconds: 5
     failureThreshold: 3
 
-podSecurityContext: {}
-securityContext: {}
+# STATE-WP-0081-T04. The image and all writable runtime state are independent
+# of root. Keep these defaults restrictive so API, MCP, and migration pods have
+# the same security posture in every installation.
+podSecurityContext:
+  runAsNonRoot: true
+  runAsUser: 10001
+  runAsGroup: 10001
+  fsGroup: 10001
+  seccompProfile:
+    type: RuntimeDefault
+securityContext:
+  allowPrivilegeEscalation: false
+  capabilities:
+    drop:
+      - ALL
+  readOnlyRootFilesystem: true
 
 nodeSelector: {}
 tolerations: []
 affinity: {}
 
-# Consistency sweep: mount railiance01 clone tree and match host_paths hostname.
+# Legacy consistency sweep settings. Kept only for rollback compatibility;
+# production uses Forge-derived reconciliation and must leave this disabled.
 sweep:
   enabled: false
   hostname: ""
   hostPath: /home/tegwick
-  sshHostPath: /home/tegwick/.ssh
\ No newline at end of file
+  sshHostPath: /home/tegwick/.ssh
+
+# RPF-WP-0035-T04: API-only, separately owned ESO Secret; no secret values here.
+renamePreflight:
+  enabled: false
+  secretName: state-hub-rename-preflight
diff --git a/deploy/railiance/apps/helm/state-hub-values.yaml b/deploy/railiance/apps/helm/state-hub-values.yaml
index f8a0dc3..3a464a5 100644
--- a/deploy/railiance/apps/helm/state-hub-values.yaml
+++ b/deploy/railiance/apps/helm/state-hub-values.yaml
@@ -6,13 +6,62 @@ namespace:
 
 image:
   repository: forgejo.coulomb.social/coulomb/state-hub
-  tag: "main-1cf949b"
+  tag: "main-0747b4d"
 
 ingress:
   enabled: false
 
-sweep:
+# MCP layer on central (CUST-WP-0067-T08). Enabled together with the image tag
+# above: MCP_HOST landed in main-6c1262e, and enabling this on an older image
+# would deploy a pod that binds loopback and never becomes reachable.
+# ClusterIP only — no ingress, same reason the API's is disabled.
+mcp:
   enabled: true
+  resources:
+    requests:
+      # 2026-09-10: 1,078 observed 5-minute samples, p99 2.35m, peak 30.45m.
+      # Preserve the 500m limit for bursts; free 40m for the API rollout surge.
+      cpu: 10m
+
+config:
+  # This deployment is the authoritative hub. Callers verify this rather than
+  # trusting that whatever answered on a port is central (CUST-WP-0067-T03).
+  instanceRole: primary
+  instanceLabel: railiance01
+  sbomNexusUrl: "http://sbom-nexus.sbom-nexus.svc.cluster.local:8010"
+  # Reversible T04 read cutover; set back to `legacy` to roll back.
+  sbomNexusReadMode: nexus
+  # Reversible T04 write cutover; set back to `legacy` to roll back future writes.
+  sbomNexusWriteMode: nexus
+
+resources:
+  # The single 4-core node currently has less than 250m unallocated. Keep enough
+  # headroom for maxSurge=1 so State Hub can roll without an outage.
+  requests:
+    cpu: 100m
+    memory: 512Mi
+  limits:
+    cpu: 1000m
+    memory: 2Gi
+
+sweep:
+  # RMGR-WP-0005-T11: disabled while railiance01 checkouts still target the
+  # stale gitea-remote lineage. Re-enable only after the governed remote
+  # reconciliation and registrar preflight are complete.
+  enabled: false
+  # Present in the live release but previously missing here, so deploying from
+  # this file alone silently dropped it. Inert while enabled is false.
   hostname: 239.62.205.92.host.secureserver.net
   hostPath: /home/tegwick
   sshHostPath: /home/tegwick/.ssh
+
+# Forge read credential (STATE-WP-0084-T02). Coordinates only — the token lives
+# in OpenBao at platform/workloads/state-hub/forge-derivation and reaches the
+# pod through Kubernetes auth, never through this file or a Secret.
+forgeRead:
+  enabled: true
+
+# RPF-WP-0035-T04: dedicated ESO signing key, API-only explicit reference.
+renamePreflight:
+  enabled: true
+  secretName: state-hub-rename-preflight
diff --git a/docs/adr/ADR-001-repository-rename-identity-contract.md b/docs/adr/ADR-001-repository-rename-identity-contract.md
new file mode 100644
index 0000000..6d02ea2
--- /dev/null
+++ b/docs/adr/ADR-001-repository-rename-identity-contract.md
@@ -0,0 +1,268 @@
+---
+id: STATE-ADR-001
+type: architecture-decision-record
+title: "Preserve repository identity across canonical-name changes"
+status: accepted
+owner: state-hub
+date: "2026-08-28"
+deciders:
+  - operator
+  - state-hub
+related:
+  - STATE-WP-0085
+  - CUST-ADR-007
+  - CUST-ADR-012
+---
+
+# Preserve repository identity across canonical-name changes
+
+## Status and scope
+
+Accepted for the implementation governed by `STATE-WP-0085`. This decision
+defines the State Hub compatibility contract. It does not authorize a live
+Forgejo rename.
+
+The contract covers a repository name change within one Forgejo instance and
+owner. A Forgejo owner transfer is a different identity and authorization
+problem and is out of scope. A product or runtime rename is also out of scope:
+module paths, binaries, packages, image names, namespaces, releases, DNS names,
+environment variables, policy vocabulary, and user-facing names change only
+when the target repository's migration workplan says so.
+
+## Context
+
+State Hub already anchors most durable relationships to `managed_repos.id`, but
+it also exposes the current repository slug through URLs, commands, generated
+files, routing keys, cached projections, and historical evidence. Treating the
+slug as identity would split history when a repository is renamed. Rewriting
+every occurrence would instead erase provenance and make interrupted migration
+recovery unsafe.
+
+Forgejo is authoritative for the Git repository. State Hub is authoritative
+for its repository UUID, canonical slug, protected aliases, and rename-operation
+evidence. Repository files remain authoritative for work records; State Hub
+continues to be their read model in accordance with `CUST-ADR-012`.
+
+## Decision
+
+A repository is identified by an immutable State Hub UUID and a verified
+immutable Forge identity. Its slug, name, URL, and checkout paths are mutable
+coordinates. A rename changes coordinates on the existing repository row,
+retains the former slug as a protected alias, and records an idempotent phased
+operation. It never registers a replacement repository.
+
+### Identity model
+
+| Element | Authority | Mutability | Rename rule |
+| --- | --- | --- | --- |
+| State Hub repository UUID | State Hub | Immutable | The operation is addressed by UUID; it must be identical before and after every phase. |
+| Forge provider/instance | Estate configuration | Immutable in this contract | A move between instances is not a rename. |
+| Forge owner | Forgejo | Immutable in this contract | Owner transfer requires a separate contract. |
+| Forge repository numeric ID | Forgejo | Immutable | Preflight must verify it; any mismatch fails closed. |
+| Canonical repository slug/name | Forgejo, mirrored by State Hub | Mutable | Exactly one canonical slug names the repository at a time. |
+| Prior slugs | State Hub | Append-only | Retained as protected aliases; they resolve to the same UUID and cannot be claimed by another live repository. |
+| Clone/web URL | Forgejo | Mutable projection | Recomputed from verified forge coordinates; never used as durable identity. |
+| Local and host checkout paths | Operator/registration | Mutable projection | Re-registered after a new clone; old paths remain evidence until explicit cleanup. |
+| Default branch | Forgejo/Git | Mutable outside the rename | Captured by preflight and compared before mutation; rename does not change it. |
+| Expected source commit | Git | Immutable preflight assertion | Apply fails if the selected branch head has moved; a fresh preflight is required. |
+| Workplan/task identifiers and Hub UUIDs | Repository files/registrar | Immutable | Preserved without re-keying. Existing prefix values remain valid. |
+| Historical event/message/provenance values | Producing system | Immutable evidence | Retain the value observed at event time; resolve aliases only when a live action is requested. |
+
+An implementation may normalize Forge identity into dedicated tables, but the
+uniqueness boundary is `(provider instance, owner, forge repository ID)`. It
+must not infer or backfill the numeric repository ID from a slug, URL, checkout,
+or initial Git commit.
+
+### Invariants
+
+| ID | Invariant | Required proof |
+| --- | --- | --- |
+| I1 | A rename uses one `managed_repos` row. | Repository-row count and UUID are unchanged. |
+| I2 | Forge repository identity is unchanged. | Provider, owner, and numeric ID match the accepted preflight. |
+| I3 | The selected source is unchanged at cutover. | Default branch and expected head commit match the accepted preflight. |
+| I4 | Work history and telemetry retain identity. | Workplan, task, progress, decision, token, SBOM, service, DoI, and TPSC relationships still reference the same repository UUID and their baseline counts/checksums match. |
+| I5 | Existing work-record identifiers are not renamed. | No identifier or filename rewrite is caused solely by the slug change. |
+| I6 | The former slug remains usable as an alias. | Old and new slug resolve to the same UUID; canonical responses identify the new slug. |
+| I7 | Historical evidence is not rewritten. | Stored event, message, review, contribution, raw metadata, and source-provenance values remain byte-for-byte intact. |
+| I8 | Each phase is idempotent. | Repeating a completed phase with the same operation ID is a no-op returning the achieved state. |
+| I9 | Every incomplete state has one safe next action. | The operation exposes its achieved phase and recovery instruction. |
+| I10 | Cleanup follows verification. | No alias, checkout, route, or rollback input is removed by this operation. |
+
+### Slug treatment vocabulary
+
+Every slug-bearing surface has exactly one primary treatment:
+
+| Treatment | Meaning |
+| --- | --- |
+| `foreign-key anchored` | Durable relationship already uses the repository UUID. Preserve the row; render the current canonical slug when needed. |
+| `alias-resolved` | The value requests a live lookup, route, or mutation. Accept canonical or protected alias, resolve to one UUID, then emit the canonical slug. |
+| `reprojected` | Derived data is rebuilt from repository files or current coordinates after cutover. Do not hand-edit cached rows. |
+| `historically retained` | The string records what a producer observed. Never rewrite it; a separate repository UUID may be added for future records. |
+| `target-repo handoff` | State Hub does not own the source. Generate an explicit task for its owner and verify the result. |
+
+## Slug-bearing surface inventory
+
+This inventory is the baseline for `STATE-WP-0085`. New slug-bearing fields
+must declare one of the treatments above before they are added.
+
+### Persistence and domain models
+
+| Surface | Treatment | Owner and required behavior |
+| --- | --- | --- |
+| `managed_repos.slug`, `name`, `remote_url`, `local_path`, `host_paths`, `git_fingerprint` | alias-resolved | State Hub updates canonical coordinates on the existing UUID. Previous slug becomes a protected alias; previous paths/URL remain operation evidence. |
+| `workplans.repo_id`, `repo_goals.repo_id`, `workplan_launch_requests.repo_id` | foreign-key anchored | State Hub preserves relationships and renders the canonical slug. Repository-file bindings are reprojected. |
+| `token_events.repo_id`, `sbom_snapshots.repo_id`, `sbom_entries.repo_id`, `tpsc_snapshots.repo_id`, `service_first_party.repo_id`, `doi_cache.repo_id`, `capability_catalog.repo_id` | foreign-key anchored | State Hub preserves rows and history. Cached/materialized responses use the canonical slug after invalidation. |
+| `intakes.repo_id` | foreign-key anchored | State Hub preserves the relationship. `source_repo_path` remains historical provenance. |
+| `contributions.repo_id` | foreign-key anchored | State Hub preserves a known local target relationship. |
+| `contributions.target_repo` | historically retained | Contribution producer owns the observed string; do not rewrite past records. New live inputs resolve aliases when a matching managed repository exists. |
+| `agent_messages.from_agent`, `agent_messages.to_agent` | historically retained | State Hub retains delivered envelope values. Message creation and inbox lookup are alias-resolved, so the old repository agent name continues to reach the canonical inbox. Message bodies are never rewritten. |
+| `interface_changes.repo_id` | foreign-key anchored | State Hub preserves the origin repository relationship. |
+| `interface_changes.affected_repo_slugs` | historically retained | State Hub retains the audience recorded at publication. New publication, pending-recipient queries, and acknowledgements resolve aliases to UUID-equivalent recipients. |
+| `work_record_identifier_aliases.repo_slug` | historically retained | Registrar owns identifier provenance. A repository-name alias must not rewrite or repurpose a work-record identifier alias. |
+| `review_contracts.source_repo`, `review_receipts.source_repo`, and their `source_path` values | historically retained | Review producer owns source provenance. Future records may additionally bind a repository UUID. |
+| `fabric_graph_imports.source_repo_slug`, `fabric_graph_nodes.source_repo_slug`, `fabric_graph_nodes.repo_slug`, `fabric_graph_edges.source_repo_slug` | target-repo handoff | Fabric source owns these projections. Re-import from the updated source and verify lineage; State Hub does not silently rewrite them. |
+| Any `source_path`, `raw_metadata`, progress payload, decision text, or event payload containing the old slug | historically retained | The producing component owns the evidence. Search results may enrich it with current canonical identity, but storage is unchanged. |
+
+### REST API and serialization
+
+| Surface | Treatment | Owner and required behavior |
+| --- | --- | --- |
+| `/repos/{slug}` and `/repos/{slug}/paths`; repo lookup, dispatch, DoI, sync, remote-URL and fingerprint lookup responses | alias-resolved | Repositories router resolves aliases to UUID. A response includes canonical slug and whether the request used an alias; canonical links use the new slug. Mutations bind to UUID. |
+| `/repo-goals?repo_slug`, `/sbom/{repo_slug}`, SBOM ingest/list filters, `/tpsc/snapshots?repo_slug` | alias-resolved | Owning routers resolve once through the repository resolver and query by UUID. |
+| Capability-catalog, service-first-party, contribution, and workplan-file-binding request `repo_slug` fields | alias-resolved | Request handlers resolve old/new slug to the same UUID. Generated and response values use the canonical slug unless explicitly historical. |
+| Message `from_agent`/`to_agent` creation and inbox query parameters | alias-resolved | Message router canonicalizes repository-agent routing for matching while retaining the original envelope. Non-repository agent names are unaffected. |
+| Interface-change `repo_slug`, `affected_repo_slugs`, pending `origin_repo_slug`, and affected-repo filters | alias-resolved | Interface-change router resolves local repository recipients by UUID-equivalence and retains original publication evidence. |
+| Fabric graph `source_repo_slug` and `repo` filters and payloads | target-repo handoff | Fabric importer accepts old evidence but refreshed canonical data comes from its source projection. |
+| Review contract/receipt `source_repo` and contribution `target_repo` representations | historically retained | APIs return the recorded value and may add canonical-resolution metadata; they do not mutate history on read. |
+| Repo token summaries, DoI, SBOM, TPSC, service, capability, consistency, and dispatch response slugs derived from `repo_id` | foreign-key anchored | Serializers render the canonical slug from the repository relationship. |
+
+### CLI, MCP, consistency, and generated files
+
+| Surface | Treatment | Owner and required behavior |
+| --- | --- | --- |
+| `statehub register`, repo update/paths/dispatch/DoI/sync commands, and repo-slug options | alias-resolved | State Hub CLI resolves existing aliases, refuses duplicate registration, and prints UUID plus canonical slug. A new checkout updates the same UUID. |
+| MCP tools accepting `repo_slug` for repository updates, ADR validation, consistency, SBOM, TPSC, repo goals, dispatch, interface changes, and ad-hoc tasks | alias-resolved | MCP adapters use the same REST resolver and return canonical identity. They do not implement a second rename path. |
+| `scripts/statehub_register.py` slug/path/remote/fingerprint discovery and scaffold output | alias-resolved | Registration script recognizes the Forge identity/alias before POST or PATCH and generates only canonical new material. |
+| `scripts/consistency_check.py` repository lookup, host paths, file bindings, inbox queries, prefixes, and briefs | reprojected | Consistency tooling resolves aliases, reads the canonical repository files, and regenerates bindings/briefs without changing stable work-record IDs. |
+| `.custodian-brief.md`, `WORK-RECORDS.md`, workplan-file bindings, repository indexes, and other generated repository-name views | reprojected | State Hub consistency projection regenerates current coordinates from canonical source and records its source revision. |
+| Repository-native workplans, `AGENTS.md`, catalog/manifest files, and other source files containing the repository slug | target-repo handoff | The target repository migration workplan updates intentional live references and retains historical ones. State Hub verifies the committed source revision. |
+
+### Dashboard, events, edge, and external systems
+
+| Surface | Treatment | Owner and required behavior |
+| --- | --- | --- |
+| Dashboard repository list and `/repos/[slug]` route | alias-resolved | Dashboard accepts an old route, identifies alias use, and links/redirects to the canonical route without losing the UUID. |
+| Dashboard domain, inbox, interface-change, TPSC, SBOM, service, and capability queries | alias-resolved | Dashboard passes either slug to the API and renders returned canonical identity. |
+| Existing `org.statehub.repo.registered` events | historically retained | Event Router retains payloads. Registration is not emitted for rename. |
+| New `org.statehub.repo.renamed` and rename-phase events | historically retained | State Hub emits operation ID, repository UUID, Forge identity, old/new slug, phase, actor, expected commit, and evidence reference. Events contain no credential. |
+| Edge outbox `repo_slug` metadata and literal request path/body | historically retained | Edge relay preserves queued envelopes. Central alias-aware handlers replay old-slug requests against the same UUID. Rename phase mutations are never edge-queueable and require central availability. |
+| Edge read-cache keys containing old/new slug | reprojected | Edge relay treats them as separate keys, invalidates repository-scoped keys on phase events, and returns canonical identity. Stale old-slug cache content must not authorize a mutation. |
+| Forgejo repository name, web/clone URL, redirects, Actions variables, hooks, branch protection, packages, releases, and deploy keys | target-repo handoff | Forgejo/HelixForge operator performs and verifies the rename. Redirects are compatibility evidence, not canonical configuration. Owner transfer remains out of scope. |
+| Downstream Git remotes, submodules, module/dependency references, CI consumers, image/package references, deployments, policies, credentials, fabric declarations, and documentation | target-repo handoff | Each owning repository or platform component receives a target-workplan task. Product/runtime-name changes require explicit decisions rather than following the repository slug automatically. |
+| Local working copies and automation checkout paths | target-repo handoff | Operator clones the canonical URL, registers the new path against the existing UUID, verifies it, and only then removes an old checkout under a separately confirmed cleanup step. |
+
+## Operation and phase contract
+
+Every rename has an immutable operation UUID and captures:
+
+- State Hub repository UUID;
+- Forge provider, instance, owner, and numeric repository ID;
+- old and proposed canonical slug, name, URLs, and registered paths;
+- default branch and expected head commit;
+- preflight expiry and evidence checksum;
+- actor, confirmation evidence, achieved phase, timestamps, and errors.
+
+Each phase is a compare-and-set transition. A caller requests one phase, not an
+opaque multi-system transaction. Before changing anything, the phase handler
+observes actual State Hub and Forgejo state. If the requested result is already
+true for this operation, it returns success without repeating the side effect.
+If reality corresponds to a later or conflicting state, it stops and reports
+the observed facts.
+
+Live rename phase transitions are Red-lane operations. They require central
+State Hub availability, an unexpired accepted preflight, explicit operator
+confirmation, and the operation UUID. They are excluded from edge queued-write
+allowlists.
+
+### Phase and interruption recovery
+
+| Phase | Durable truth | Allowed next phase | Safe action after interruption |
+| --- | --- | --- | --- |
+| `draft` | Intent exists; no identity assertion has been accepted. | `preflighted` or cancel draft | Run non-mutating preflight. It is always safe to abandon a draft. |
+| `preflighted` | Forge identity, old/new availability, branch/head, baselines, effects, and expiry are recorded; no rename has occurred. | `forge-renamed` | Re-read Forgejo and State Hub. If any compare value changed, expire the preflight and run it again. Otherwise request only the Forge phase. |
+| `forge-renamed` | Forgejo numeric ID now has the new name; State Hub may still expose the old canonical slug. | `statehub-rebound` or `rollback-preflight` | Verify Forge ID and commit. Prefer completing the State Hub rebind. If continuation is unsafe, first prove the old Forge slug is free, then enter rollback preflight. Do not register a new Hub repository. |
+| `statehub-rebound` | Existing Hub UUID has the new canonical slug and protected old alias; Forge identity matches. | `source-synced` or `rollback-preflight` | Verify both slugs resolve to one UUID. Regenerate State Hub-owned projections and sync repository source. Alias compatibility makes pausing here safe. |
+| `source-synced` | Target repository source and State Hub projections are committed at the recorded revision. | `consumers-verified` or `rollback-preflight` | Resume external handoffs from the recorded checklist. Do not assume source changes rolled out to consumers. |
+| `consumers-verified` | Required consumers, routes, artifacts, deployment references, and telemetry continuity checks have evidence. | `completed` or `rollback-preflight` | Re-run final invariant checks. Complete only if no required handoff remains open. |
+| `completed` | Invariants and required handoffs passed; old alias remains protected. | none in this operation | No automatic action. Optional checkout or compatibility cleanup is a separately approved target-repository task. |
+| `rollback-preflight` | Desired rollback point, old-slug availability, current IDs/commits, and irreversible handoffs are recorded. | `rolled-back` or resume forward | If the old slug is unavailable or an external change is unsafe to reverse, stop and resume forward. Otherwise reverse one phase at a time, Forgejo first when its name must change. |
+| `rolled-back` | Forgejo and State Hub canonical coordinates are restored and both observed slugs remain protected aliases; history is intact. | new operation only | Verify the original canonical route and consumers. Keep evidence and aliases; investigate before starting a new operation. |
+
+### Failure states
+
+| Failure code | Detection | Mutation rule | Recovery |
+| --- | --- | --- | --- |
+| `forge-unreachable` | Forge identity or repository cannot be read. | None. | Restore connectivity and repeat the same phase. Never infer success from a redirect or local clone. |
+| `forge-identity-mismatch` | Provider, owner, or numeric ID differs from preflight. | None. | Stop for operator investigation; a new preflight cannot waive an identity mismatch without a separately reviewed migration. |
+| `source-moved` | Default branch or expected head commit differs. | None. | Expire preflight and generate a new one against the intended commit. |
+| `target-slug-conflict` | New slug is owned by another Forgejo or State Hub identity/alias. | None. | Choose another slug or resolve the conflicting ownership outside this operation. |
+| `old-slug-unavailable` | Rollback target is no longer free. | No rollback mutation. | Continue forward or resolve ownership explicitly; do not steal or delete an alias. |
+| `statehub-conflict` | Old/new slug, alias, or Forge identity resolves to multiple/different UUIDs. | None. | Repair identity data under a separate reviewed incident; preserve all evidence. |
+| `forge-renamed-hub-pending` | Forge ID has new name but State Hub remains canonical on old slug. | Only `statehub-rebound` or rollback after preflight. | Verify ID/commit, then resume rebind with the same operation ID. |
+| `hub-rebound-source-pending` | Hub canonical slug changed but repository projections/source are stale. | No duplicate rebind. | Resolve through either alias, then run source/projection sync for the recorded revision. |
+| `consumer-verification-failed` | One or more external handoffs lack evidence or health checks fail. | Do not complete or clean up. | Keep aliases and both checkout facts; repair the named consumer or enter rollback preflight. |
+| `edge-writes-pending` | Relevant outbox envelopes or unknown queued writes exist. | Preflight fails closed. | Replay/quarantine the outbox, verify idempotency against aliases, then preflight again. |
+| `operation-conflict` | Another active operation targets the same UUID, Forge ID, old slug, or new slug. | None. | Finish/cancel the owning operation; only one active rename may hold the identity lock. |
+| `evidence-drift` | Counts, checksums, paths, or source revision no longer match accepted evidence. | None for the requested phase. | Explain the drift and renew preflight; never silently update the accepted baseline. |
+
+### Retry and rollback limits
+
+- An idempotency key is the operation UUID plus requested phase. Reuse of the
+  key with different expectations is a conflict.
+- A completed phase cannot be overwritten by a retry. Reconciliation may
+  append observed evidence and an error, but not erase prior evidence.
+- Rollback is a new sequence on the same operation record and must itself pass
+  compare-and-set checks. It never deletes aliases, operation history, events,
+  or historical values.
+- Before `forge-renamed`, rollback means abandoning an unexpired intent and has
+  no external side effect.
+- After `forge-renamed`, automatic rollback is possible only while the old
+  Forge slug is provably available and external effects can be reversed.
+- After source or consumer changes, rollback generates explicit handoffs for
+  irreversible or independently owned effects. It must not claim that a Forge
+  and Hub coordinate reversal also reversed packages, deployments, policies,
+  caches, or product/runtime names.
+
+## Consequences
+
+- T02 must add verified Forge identity, protected repository aliases, and an
+  operation journal without changing existing repository UUIDs.
+- T03 must expose UUID-addressed preflight and one-phase mutation APIs with the
+  failure codes above. Slug convenience routes are read/resolution helpers only.
+- T04 and T05 must centralize alias resolution and prove that history,
+  telemetry, work records, and queued-write behavior remain continuous.
+- T06 must generate target-repository workplans that separate repository,
+  product, runtime, consumer, and cleanup decisions.
+- T07 and T08 may orchestrate and rehearse the contract, but the live
+  `flex-auth` to `access-engine` operation remains gated by its adopted target
+  workplan.
+- Protected aliases may accumulate. A future alias-retirement policy needs its
+  own evidence and decision; this rename workflow does not delete them.
+
+## Rejected alternatives
+
+| Alternative | Reason rejected |
+| --- | --- |
+| Delete and re-register under the new slug | Creates a second repository identity and strands foreign-key history. |
+| Update only `managed_repos.slug` | Leaves routing, files, external projections, retries, and recovery undefined. |
+| Mass-rewrite every old-slug string | Destroys historical provenance and cannot safely update independently owned systems. |
+| Use Forgejo redirects indefinitely | Redirects do not update canonical remotes, routing, packages, policies, or deployment consumers. |
+| Make repository and product/runtime rename one operation | Couples independently risky decisions and makes rollback boundaries unknowable. |
+| Queue live rename phases through the edge relay | A disconnected multi-system identity mutation cannot prove current Forge identity, conflicts, or ordering. |
+
+## References
+
+- `STATE-WP-0085` — lineage-preserving repository rename workflow
+- `CUST-ADR-007` — stable workplan identity and registrar authority
+- `CUST-ADR-012` — Forge projection, source revision, and rebuildability
+- `docs/architecture/state-hub_v0.1.md` — State Hub system context
diff --git a/docs/adr/ADR-002-forge-repository-boundary.md b/docs/adr/ADR-002-forge-repository-boundary.md
new file mode 100644
index 0000000..491ec93
--- /dev/null
+++ b/docs/adr/ADR-002-forge-repository-boundary.md
@@ -0,0 +1,59 @@
+---
+id: STATE-ADR-002
+type: architecture-decision-record
+title: "Use Forge commits, never another machine's checkout, as the cluster repository boundary"
+status: accepted
+owner: state-hub
+date: "2026-09-04"
+deciders:
+  - operator
+  - state-hub
+related:
+  - STATE-WP-0081
+  - STATE-WP-0083
+  - STATE-WP-0084
+  - STATE-WP-0086
+---
+
+# Use Forge commits as the cluster repository boundary
+
+## Context
+
+The former consistency sweep mounted an operator home directory into the
+production State Hub pod. The cluster therefore saw stale checkouts, wrote
+root-owned files into human workspaces, inherited a personal SSH identity, and
+could not distinguish an absent work record from an out-of-date disk.
+
+Repository files remain authoritative, but a local checkout is only one
+machine's observation of those files. It is not a cross-machine transport.
+
+## Decision
+
+Workstation agents commit and push repository authority to Forgejo. Cluster
+infrastructure reads a named, verified Forge commit into ephemeral storage.
+Neither side reads or writes the other side's checkout.
+
+`local_path` and `host_paths` remain compatibility/observation fields for tools
+running on the named host. They must not select central reconciliation input.
+Central reconciliation records both the expected and derived commit and refuses
+the projection if they differ.
+
+Cluster Forge access uses a workload service identity whose credential is
+obtained through Kubernetes authentication to OpenBao. Personal SSH directories
+and home-directory hostPaths are prohibited.
+
+## Consequences
+
+- A workstation change is invisible centrally until it is committed and pushed.
+- A cluster result is attributable to an exact Forge commit.
+- Temporary clones and credentials may be discarded after reconciliation.
+- Offline writes use the explicit edge outbox; shared disks are not a fallback.
+- Scripts needing repository contents locally resolve the current host's
+  `host_paths` entry and must fail clearly when no checkout is present.
+
+## Verification
+
+- The live State Hub pod has no operator-home or SSH hostPath.
+- `rmgr sync --push` verifies `primary/railliance01` and exact commit equality.
+- `docs/evidence/repository-registry-audit-20260904.json` records no active
+  repository without a remote and no stale Gitea remote.
diff --git a/docs/architecture/state-hub_v0.1.md b/docs/architecture/state-hub_v0.1.md
new file mode 100644
index 0000000..dc4370b
--- /dev/null
+++ b/docs/architecture/state-hub_v0.1.md
@@ -0,0 +1,161 @@
+---
+id: state-hub-architecture
+title: "State Hub architecture"
+status: proposed
+owner: state-hub
+revision: "draft-3"
+version: "0.1"
+last_reviewed: "2026-08-31"
+review_interval: 6m
+---
+
+# State Hub — Software Architecture Documentation (arc42)
+
+## About this document
+
+First-wave arc42 for State Hub, the estate's live coordination
+read-model. This service is in active retirement planning; new
+permanent ownership should not land here. Chapter 9 points at the
+estate ADRs that still bind it.
+
+---
+
+## 1. Introduction and Goals
+
+State Hub is a queryable, auditable memory of work: domains, repos,
+workplans, tasks, decisions, progress. Files remain the origin. The
+hub is derived state (custodian ADR-001, ADR-003).
+
+It remains operational until retirement gates in
+`prj-state-hub-retirement` are met. Replacement ownership is moving
+toward `repo-manager` and `hub-core`.
+
+### 1.1 Requirements Overview
+
+- Rebuild coordination state from registered repository files.
+- Deterministic UUIDv5 work-record identifiers (ADR-007). Any instance may
+  reconcile the same repository; the canonical record id produces the same
+  database key and writeback bytes on every instance.
+- Preserve compatibility; do not take new permanent architectural
+  ownership.
+
+### 1.2 Quality Goals
+
+1. Rebuildability from git.
+2. Hub never becomes the origin of work.
+3. Extraction paths stay open.
+
+### 1.3 Stakeholders
+
+| Role | Concern |
+| --- | --- |
+| state-hub | Live read-model during retirement. |
+| the-custodian | Estate rules the hub must not invert. |
+| repo-manager | Incoming consistency / repo representation. |
+| product repos | Workplan files the hub indexes. |
+
+---
+
+## 2. Architecture Constraints
+
+N/A for this stub — retirement program is the binding constraint.
+
+---
+
+## 3. System Scope and Context
+
+**In:** indexing workplans/tasks/decisions, consistency rebuild,
+query API and dashboard used today.
+**Out:** being the source of work items; new cross-domain capabilities;
+publication of policy (policy-nexus).
+
+### 3.1 Business Context
+
+Files are excellent for canon and provenance. The estate still needs a
+live query surface while retirement proceeds.
+
+### 3.2 Technical Context
+
+Inputs: workplan markdown via `fix-consistency`. Outputs: HTTP/MCP
+APIs. Neighbours: every registered repo, activity-core (ops runs),
+policy-nexus (does not index the hub).
+
+---
+
+## 4. Solution Strategy
+
+N/A for this stub. The strategy is already in the estate ADRs: files
+first, materialized derived state, single registrar, local cache vs
+authority (ADR-010, proposed).
+
+---
+
+## 5. Building Block View
+
+### 5.1 Level 1 – System/Top-Level
+
+N/A for this stub.
+
+---
+
+## 6. Runtime View
+
+N/A for this stub.
+
+---
+
+## 7. Deployment View
+
+N/A for this stub.
+
+---
+
+## 8. Cross-Cutting Concepts
+
+N/A for this stub.
+
+---
+
+## 9. Architecture Decisions
+
+Estate-wide binding decisions live in the-custodian and are listed on the
+estate map. Service-local implementation decisions live in `docs/adr/` and do
+not supersede the estate decisions:
+
+| Estate ADR | Status | Why it binds this system |
+| --- | --- | --- |
+| `CUST-ADR-001` | accepted | File-backed work originates in repositories; the Hub projects it. Published `/adr/custodian-workplans-as-repo-artefacts/v1/`. |
+| `CUST-ADR-003` | accepted | How derived state invalidates; ADR-012 supplies commit provenance. |
+| `CUST-ADR-007` | accepted | Namespace-aware identity and deterministic work-record UUIDs. |
+| `CUST-ADR-010` | proposed | Two kinds of hub data. |
+| `CUST-ADR-011` | proposed | Namespace and reconciliation limits. |
+| `CUST-ADR-012` | accepted | Forge projection baseline and preliminary overlays. |
+
+| Local ADR | Status | Scope |
+| --- | --- | --- |
+| `STATE-ADR-001` | accepted | Repository identity and recovery contract for canonical-name changes. |
+
+Do not treat a State Hub `/decisions` row as the published ADR.
+
+---
+
+## 10. Quality Requirements
+
+N/A for this stub.
+
+---
+
+## 11. Risks and Technical Debt
+
+N/A for this stub. Residual: this workstation cannot mint registrar
+UUIDs.
+
+---
+
+## 12. Glossary
+
+| Term | Meaning |
+| --- | --- |
+| Read model | Derived index; never the origin. |
+| Registrar | The single instance allowed to mint workplan UUIDs. |
+| Retirement | Coordinated move of capabilities out of this repo. |
diff --git a/docs/cluster-operating-model.md b/docs/cluster-operating-model.md
index 01f4c5f..fafcb27 100644
--- a/docs/cluster-operating-model.md
+++ b/docs/cluster-operating-model.md
@@ -1,24 +1,43 @@
 # State Hub Cluster Operating Model
 
-This document describes how State Hub runs after the pragmatic cluster migration
-(`CUST-WP-0011`). It is the operator runbook for day-to-day use, rollback, and
-known pragmatic limitations.
+This document describes the primary State Hub runtime on railiance01 and the
+repository boundary established by `STATE-ADR-002`. It is the operator runbook
+for day-to-day use, rollback, and known pragmatic limitations.
 
 ## Runtime Summary
 
 | Component | Location | Notes |
 |-----------|----------|-------|
-| API workload | `coulombcore-k3s`, namespace `state-hub` | Single-replica Deployment |
-| Database | CNPG cluster `state-hub-db`, namespace `databases` | One instance, healthy |
+| API workload | railiance01 k3s, namespace `state-hub` | Single-replica Deployment |
+| MCP workload | railiance01 k3s, namespace `state-hub` | ClusterIP only; opt-in for clients |
+| Database | railiance01 CNPG cluster `state-hub-db`, namespace `databases` | One primary instance |
 | Image registry | `forgejo.coulomb.social/coulomb/state-hub` | Tag pinned in Helm values |
-| Primary access | `http://127.0.0.1:8000` | ops-bridge `state-hub-primary` forward tunnel |
+| In-cluster access | `http://10.43.68.154:8000` | `state-hub` ClusterIP |
+| Workstation access | `http://127.0.0.1:8000` | Host listener/tunnel to the primary |
 | WSL2 fallback | `make api` + local Docker Postgres | Retained; not the normal writer |
 
 State Hub is **not** publicly exposed. Access stays on the private tunnel /
 ops-bridge path.
 
-Deployment handoff assets live under `deploy/railiance/` and were promoted to
-the coulombcore cluster during cutover (2026-07-03).
+Deployment handoff assets live under `deploy/railiance/`; the running release is
+on railiance01.
+
+## Repository Boundary
+
+The invariant is: **workstation coding agents push to Forgejo; cluster
+infrastructure reads exact Forge commits; neither reads the other's disk.**
+
+- File-backed work records remain authoritative in their repository.
+- `rmgr sync --push` pushes the local commit, verifies Forgejo, and requests
+  central reconciliation of that exact commit.
+- Central reconciliation clones into ephemeral storage. It never uses a
+  workstation `local_path` or mounts an operator home directory.
+- `host_paths` describes where a checkout is visible to a particular host; it
+  is not shared storage.
+- Cluster Forge reads use the `state-hub` service account and an OpenBao-backed
+  workload credential. Personal SSH keys are not mounted.
+
+See [`ADR-002`](adr/ADR-002-forge-repository-boundary.md).
 
 ## How Agents Reach State Hub
 
@@ -39,13 +58,14 @@ make register-mcp
 make mcp-http    # SSE on :8001
 ```
 
-### Remote machines (Railiance01, CoulombCore, Haskelseed, …)
+### Remote and in-cluster callers
 
-Bring up the managed tunnel mesh, then register MCP against the remote API port:
+On railiance01, use the service address directly. Elsewhere, use the managed
+edge relay or tunnel selected by the operator:
 
 ```bash
-make bridges
-make register-mcp MCP_URL=http://127.0.0.1:18001/sse API_BASE=http://127.0.0.1:18000
+curl -fsS http://10.43.68.154:8000/state/health
+statehub --api-base http://127.0.0.1:18080 outbox status
 ```
 
 Restart the agent runtime after MCP registration.
@@ -66,7 +86,7 @@ equivalent State Hub MCP helpers.
 
 ### Cluster database (CNPG)
 
-The `state-hub-db` cluster is managed by CloudNativePG on coulombcore-k3s.
+The `state-hub-db` cluster is managed by CloudNativePG on railiance01 k3s.
 Scheduled CNPG backups are **not yet configured** — treat manual dumps as the
 current backup path until `CUST-WP-0038` or a disaster-control workplan adds
 automated retention.
@@ -138,14 +158,12 @@ Cutover sequence reference: `CUST-WP-0011-T07` (2026-07-03).
 File-backed workplans remain authoritative (ADR-001). After commits:
 
 ```bash
-make fix-consistency REPO=<slug>
-# or from repo root:
-make fix-consistency-here
+uv run --project ~/repo-manager rmgr sync --path /path/to/repo --push
 ```
 
-The 15-minute all-repo sweep is owned by activity-core on Railiance01. It
-reaches the API through the `actcore-state-hub-bridge` proxy chain. Manual
-invocation from the workstation still works:
+The command verifies `primary/railliance01`, then central derives and applies
+the exact pushed Forgejo commit. `statehub fix-consistency` remains the broad
+deep-audit tool; it is not the interactive registration/update path.
 
 ```bash
 curl -s -X POST http://127.0.0.1:8000/consistency/sweep/remote-all \
@@ -159,11 +177,24 @@ Runbook: [`docs/consistency-sweep-runbook.md`](consistency-sweep-runbook.md).
 cutover while the bridge target chain was rewired. Manual sweeps succeed.
 Re-enablement is tracked outside this workplan (service-inventory gap).
 
+## Activity-core ops run visibility
+
+Ops-run claims, leases, completion, and failure remain on activity-core in
+Railiance. State Hub only exposes the cached read projection described in
+[`ops-run-read-projection.md`](ops-run-read-projection.md). Configure the
+railiance01 State Hub deployment with a private `ACTIVITY_CORE_URL` and an
+OpenBao/ESO-injected `ACTIVITY_CORE_WORKER_TOKEN`.
+
+If the Railiance edge or tunnel is unavailable, State Hub serves the last
+successful projection with `stale: true`; before any successful pull it returns
+`available: false`. Alert on those flags. Do not add claim or completion writes
+to State Hub as a failover mechanism.
+
 ## Pragmatic Limitations (Single-Node)
 
 This deployment is intentionally **not** highly available:
 
-- One API replica on one k3s node.
+- One API replica on the single railiance01 k3s node.
 - One CNPG instance (no synchronous replica).
 - No public ingress; tunnel dependency for all remote access.
 - Cluster and tunnel outages require the WSL2 fallback or the offline write
@@ -197,4 +228,4 @@ After image or chart changes, see `deploy/railiance/README.md` and
 - `workplans/CUST-WP-0011-state-hub-threephoenix-migration.md` — migration plan
 - `workplans/CUST-WP-0038-state-hub-threephoenix-ha.md` — future HA target
 - `deploy/railiance/README.md` — Helm/CNPG handoff
-- `the-custodian/ops/service-inventory.yml` — live endpoint inventory
\ No newline at end of file
+- `the-custodian/ops/service-inventory.yml` — live endpoint inventory
diff --git a/docs/evidence/2026-09-10-projection-convergence.json b/docs/evidence/2026-09-10-projection-convergence.json
new file mode 100644
index 0000000..30dead6
--- /dev/null
+++ b/docs/evidence/2026-09-10-projection-convergence.json
@@ -0,0 +1,300 @@
+{
+  "observed_at": "2026-09-10T14:32:10.814248+00:00",
+  "status": "live-converged",
+  "implementation_commits": {
+    "state-hub": "0747b4d95b3d30a12c41de673912659e8fdd1654",
+    "repo-manager": "00ce69fadaa4d6a5486b4b12cb0aa39e8d7ce4ee"
+  },
+  "tests": {
+    "repo-manager": 188,
+    "state-hub_projection_consistency_api": 242
+  },
+  "before": {
+    "selected_tasks": 24,
+    "drifted_tasks": 6
+  },
+  "after": {
+    "observed_at": "2026-09-10T14:29:31.367440+00:00",
+    "checked": 24,
+    "drifted_tasks": 0,
+    "manual_task_patches": 0,
+    "tasks": [
+      {
+        "task": "SECRETS-WP-0008-T01",
+        "status": "done",
+        "drift": []
+      },
+      {
+        "task": "SECRETS-WP-0008-T02",
+        "status": "wait",
+        "drift": []
+      },
+      {
+        "task": "SECRETS-WP-0008-T03",
+        "status": "done",
+        "drift": []
+      },
+      {
+        "task": "SECRETS-WP-0008-T04",
+        "status": "done",
+        "drift": []
+      },
+      {
+        "task": "SECRETS-WP-0008-T05",
+        "status": "done",
+        "drift": []
+      },
+      {
+        "task": "SECRETS-WP-0008-T06",
+        "status": "wait",
+        "drift": []
+      },
+      {
+        "task": "SECRETS-WP-0009-T01",
+        "status": "done",
+        "drift": []
+      },
+      {
+        "task": "SECRETS-WP-0009-T02",
+        "status": "done",
+        "drift": []
+      },
+      {
+        "task": "SECRETS-WP-0009-T03",
+        "status": "wait",
+        "drift": []
+      },
+      {
+        "task": "RPF-WP-0035-T01",
+        "status": "done",
+        "drift": []
+      },
+      {
+        "task": "RPF-WP-0035-T02",
+        "status": "wait",
+        "drift": []
+      },
+      {
+        "task": "RPF-WP-0035-T03",
+        "status": "wait",
+        "drift": []
+      },
+      {
+        "task": "RPF-WP-0035-T04",
+        "status": "done",
+        "drift": []
+      },
+      {
+        "task": "RPF-WP-0035-T05",
+        "status": "done",
+        "drift": []
+      },
+      {
+        "task": "RPF-WP-0035-T07",
+        "status": "todo",
+        "drift": []
+      },
+      {
+        "task": "RPF-WP-0035-T06",
+        "status": "wait",
+        "drift": []
+      },
+      {
+        "task": "HFACT-WP-0001-T01",
+        "status": "progress",
+        "drift": []
+      },
+      {
+        "task": "HFACT-WP-0001-T02",
+        "status": "progress",
+        "drift": []
+      },
+      {
+        "task": "HFACT-WP-0001-T03",
+        "status": "wait",
+        "drift": []
+      },
+      {
+        "task": "HFACT-WP-0001-T04",
+        "status": "wait",
+        "drift": []
+      },
+      {
+        "task": "HFACT-WP-0001-T05",
+        "status": "wait",
+        "drift": []
+      },
+      {
+        "task": "HFACT-WP-0001-T06",
+        "status": "wait",
+        "drift": []
+      },
+      {
+        "task": "HFACT-WP-0001-T07",
+        "status": "wait",
+        "drift": []
+      },
+      {
+        "task": "HFACT-WP-0001-T08",
+        "status": "wait",
+        "drift": []
+      }
+    ]
+  },
+  "live_release": {
+    "helm_revision": 63,
+    "status": "deployed",
+    "pods": [
+      {
+        "pod": "state-hub-bf8df7596-xm9lx",
+        "ready": true,
+        "image": "forgejo.coulomb.social/coulomb/state-hub:main-0747b4d",
+        "image_id": "forgejo.coulomb.social/coulomb/state-hub@sha256:78828c9e85848538878a27d2e3e6bebfd0cc7192c0961c92c749b27acca7b6f5",
+        "restarts": 0
+      },
+      {
+        "pod": "state-hub-mcp-5f579c6589-fh99w",
+        "ready": true,
+        "image": "forgejo.coulomb.social/coulomb/state-hub:main-0747b4d",
+        "image_id": "forgejo.coulomb.social/coulomb/state-hub@sha256:78828c9e85848538878a27d2e3e6bebfd0cc7192c0961c92c749b27acca7b6f5",
+        "restarts": 0
+      }
+    ],
+    "health": {
+      "status": "ok",
+      "db": "connected",
+      "instance_role": "primary",
+      "instance_label": "railiance01",
+      "schema": {
+        "status": "ok",
+        "applied": "b5e6f7a8c9d0",
+        "expected": "b5e6f7a8c9d0"
+      }
+    }
+  },
+  "independent_rederivation": {
+    "observed_at": "2026-09-10T14:30:00.843952+00:00",
+    "independent_request_keys": true,
+    "receipts": [
+      {
+        "schema": "state-hub.repository-projection-reconcile.v1",
+        "instance_role": "primary",
+        "instance_label": "railiance01",
+        "expected_commit": "d1c13b5dd667bcad453c94564f65bdf5f172ba3b",
+        "derived_commit": "d1c13b5dd667bcad453c94564f65bdf5f172ba3b",
+        "outcome": {
+          "schema": "state-hub.projection-reset.v1",
+          "repo_slug": "secrets-engine",
+          "commit": "d1c13b5dd667bcad453c94564f65bdf5f172ba3b",
+          "status": "noop",
+          "counts": {
+            "created": 0,
+            "updated": 0,
+            "retired": 0,
+            "refused": 0,
+            "released": 0,
+            "created_tasks": 0,
+            "updated_tasks": 0,
+            "cancelled_tasks": 0
+          },
+          "created": [],
+          "updated": [],
+          "retired": [],
+          "released": [],
+          "created_tasks": [],
+          "updated_tasks": [],
+          "cancelled_tasks": [],
+          "refused": [],
+          "notes": []
+        }
+      },
+      {
+        "schema": "state-hub.repository-projection-reconcile.v1",
+        "instance_role": "primary",
+        "instance_label": "railiance01",
+        "expected_commit": "d3a502b45cebc0a658d0ee7499f1cfcf2a5902a4",
+        "derived_commit": "d3a502b45cebc0a658d0ee7499f1cfcf2a5902a4",
+        "outcome": {
+          "schema": "state-hub.projection-reset.v1",
+          "repo_slug": "railiance-platform",
+          "commit": "d3a502b45cebc0a658d0ee7499f1cfcf2a5902a4",
+          "status": "noop",
+          "counts": {
+            "created": 0,
+            "updated": 0,
+            "retired": 0,
+            "refused": 0,
+            "released": 0,
+            "created_tasks": 0,
+            "updated_tasks": 0,
+            "cancelled_tasks": 0
+          },
+          "created": [],
+          "updated": [],
+          "retired": [],
+          "released": [],
+          "created_tasks": [],
+          "updated_tasks": [],
+          "cancelled_tasks": [],
+          "refused": [],
+          "notes": []
+        }
+      },
+      {
+        "schema": "state-hub.repository-projection-reconcile.v1",
+        "instance_role": "primary",
+        "instance_label": "railiance01",
+        "expected_commit": "c22cb9a87eebed341bad5214f6d4844e60485ddf",
+        "derived_commit": "c22cb9a87eebed341bad5214f6d4844e60485ddf",
+        "outcome": {
+          "schema": "state-hub.projection-reset.v1",
+          "repo_slug": "prj-helixforge-factory",
+          "commit": "c22cb9a87eebed341bad5214f6d4844e60485ddf",
+          "status": "noop",
+          "counts": {
+            "created": 0,
+            "updated": 0,
+            "retired": 0,
+            "refused": 0,
+            "released": 0,
+            "created_tasks": 0,
+            "updated_tasks": 0,
+            "cancelled_tasks": 0
+          },
+          "created": [],
+          "updated": [],
+          "retired": [],
+          "released": [],
+          "created_tasks": [],
+          "updated_tasks": [],
+          "cancelled_tasks": [],
+          "refused": [],
+          "notes": []
+        }
+      }
+    ]
+  },
+  "capacity": {
+    "node_allocatable_mcpu": 4000,
+    "requested_before_mcpu": 3935,
+    "requested_after_mcpu": 3895,
+    "remaining_after_mcpu": 105,
+    "api_surge_mcpu": 100,
+    "mcp_request_before_mcpu": 50,
+    "mcp_request_after_mcpu": 10,
+    "mcp_limit_mcpu": 500,
+    "sample_count": 1078,
+    "coverage": "partial history within seven-day query window",
+    "mcp_p99_mcpu": 2.350371109351198,
+    "mcp_five_minute_peak_mcpu": 30.450431294722627,
+    "failed_revision": 61,
+    "healthy_atomic_rollback_revision": 62,
+    "successful_revision": 63,
+    "risk": "Reduced guaranteed share under contention; retain limits and review latency/errors/contention. Remaining release margin is narrow.",
+    "residual": "STATE-WP-0091"
+  },
+  "factory_attempts": 0,
+  "paid_provider_calls": 0,
+  "manual_task_patches": 0,
+  "dispatch_enabled": false
+}
diff --git a/docs/evidence/2026-09-14-release-headroom.md b/docs/evidence/2026-09-14-release-headroom.md
new file mode 100644
index 0000000..321469d
--- /dev/null
+++ b/docs/evidence/2026-09-14-release-headroom.md
@@ -0,0 +1,47 @@
+# STATE-WP-0091 — release headroom and demand handoff
+
+Date: 2026-09-14
+
+## T01 — preflight
+
+`scripts/release_headroom_preflight.py` is on the promotion path
+(`make railiance-state-hub-headroom`, `PROMOTE.md` step 0). It is read-only.
+
+Proved against fixtures of the 2026-09-10 incident:
+
+| Case | Remaining | Result |
+| --- | --- | --- |
+| Revision 61 | 65m | refuse API 100m surge |
+| Revision 63 | 105m | narrowly sufficient; not factory admission |
+| 105m plus 50m unrelated pending | 55m effective | refuse |
+
+Atomic rollback stays `--atomic`. Requests are not lowered by this tool.
+
+Live kubectl on 2026-09-14 refused: remaining 15m, pending unrelated 25m,
+migrate hook 50m unmet. The preflight is doing its job on the current node.
+
+## T02 — MCP demand and margin
+
+STATE-WP-0090 recorded 1,078 five-minute samples in a seven-day window
+(partial coverage): MCP p99 2.35m, peak 30.45m. The MCP request was cut
+50m → 10m; limit 500m, memory and replicas unchanged.
+
+That sample set is still not a week of complete coverage. It is enough to
+say:
+
+- 10m request is above p99 and below peak; bursts still use the 500m limit.
+- 105m node remainder is only 5m above the API surge. Concurrent MCP surge
+  (10m) or any unrelated pending pod ≥ 6m makes it insufficient.
+- **Durable release margin for State Hub:** remaining CPU after current
+  allocations must cover API surge 100m + migrate hook 50m sequenced
+  separately, and must refuse when unrelated pending demand would consume
+  the 5m sliver. Do not treat 105m as shared-capacity admission.
+
+Shared allocation and provisioning stay with other owners. Receiving records:
+
+- `RAIL-BS-WP-0014` (railiance-cluster) — node remaining vs surge, pending pods
+- `RESOURCE-WP-0007` (resource-control) — reef-railiance-k3s portfolio, not admission
+- `RPF-WP-0041` (railiance-platform) — no platform provisioning change from 105m
+- `CUST-WP-0071` already owns weekly fleet allocation review
+
+HFACT T01/T04 factory demand is not admitted by this 105m figure.
diff --git a/docs/evidence/STATE-WP-0079-caller-and-receiver-review-20260905.md b/docs/evidence/STATE-WP-0079-caller-and-receiver-review-20260905.md
new file mode 100644
index 0000000..eaf6bb9
--- /dev/null
+++ b/docs/evidence/STATE-WP-0079-caller-and-receiver-review-20260905.md
@@ -0,0 +1,92 @@
+# STATE-WP-0079 caller and receiver review — 2026-09-05
+
+## Actions and scope
+
+User authorized the proposed SBOM meter retirements, caller tracing/migration,
+and refreshed cutover checklist. No application image, production writer,
+network policy, runtime deployment, or compatibility handler was changed.
+
+A fresh seven-day primary review re-confirmed both candidates before mutation.
+Direct Nexus licence-report and snapshot reads returned HTTP 200 from the State
+Hub pod. Both meter records were patched with STATE-WP-0079-T05 provenance.
+The saved before/after receipt is
+`STATE-WP-0079-sbom-retirement-20260905.json`: eight retired, seven legacy,
+zero remaining candidates. Handler deletion is not claimed by meter retirement.
+
+## Caller trace
+
+Searched non-hidden source trees under `/home/worsch` for `workstream_id`,
+`/workstreams`, and the two SBOM endpoints, covering Python, shell, JS/TS and
+YAML while excluding tests, dependency trees, docs, archives and fixtures.
+517 matching lines were triaged by receiver and operation. A second Markdown
+instruction scan excluded workplans, generated indexes, docs, archives and
+session evidence. Matching strings alone were not treated as runtime callers.
+
+- Repo Manager's licence-report client uses explicit `SBOM_NEXUS_URL`; it is a
+  direct Nexus client, not evidence of a State Hub caller.
+- SBOM Nexus importer intentionally reads source and target snapshots/licences
+  for migration comparison. Its matching paths do not establish ongoing use.
+- The bundled State Hub skill advertised removed `create_workstream` and
+  `POST /workstreams/`; README and dashboard goals documentation also described
+  retired routes as supported. Corrected these to current workplan contracts,
+  file-first sync and component attribution.
+- No current hard-coded State Hub workstream route caller was found in the
+  scanned runtime sources. This does not cover hidden installations, remote
+  checkouts, dynamically built paths or past one-off commands.
+
+Targeted local agent-session review extracted only tool-call timestamp, working
+repository and legacy path. Full session contents were not copied into evidence.
+
+| Time (UTC) | Caller context | Observed operation | Confidence / correction |
+| --- | --- | --- | --- |
+| 2026-09-04 17:21:25.339 | Claude agent, fluid-telegram | Task query with legacy `workstream_id`, targeting `f2373858-c932-5a4d-81b6-db9a3595135a` | Actual command in session history; within four seconds of meter last_seen 17:21:29.173850. Strong correlation, not request-ID proof. AGENTS.md now prescribes canonical query and `X-StateHub-Component: fluid-telegram` |
+| 2026-08-29 12:57:27.083 | Claude agent, ops-warden | Task query with legacy `workstream_id`, targeting `ae3ff76f-883d-5e2f-b6aa-144d61e8fdef` | Actual command in session history. AGENTS.md now prescribes canonical query and `X-StateHub-Component: ops-warden` |
+
+Caller guidance commits: fluid-telegram `f7af151`, ops-warden `96dbb22`.
+Both changes are restricted to the repository-owned AGENTS.md extension.
+
+Replayed only the **canonical** task queries with those component headers:
+HTTP 200, 8 and 5 tasks respectively. No legacy query was replayed, so the
+retirement clocks were not reset by verification. Agent instructions reduce
+future misuse; they do not prove that future sessions will follow them.
+
+Remaining attribution: the meter's 11 task-filter calls are not all individually
+explained, seven workstream-detail calls remain unidentified, and the one SBOM
+index call remains unidentified. These are STATE-WP-0079-T07 live work, not
+claimed completed migrations.
+
+## Log retention limit
+
+Requested seven days of `deployment/state-hub` pod logs. Available logs start
+2026-09-04T20:10:36Z, after the relevant last-seen timestamps. No matching legacy
+requests appear in that retained interval. Kubernetes has no previous container
+log for this pod. Hence these logs cannot retrospectively identify the calls;
+absence in this interval is not evidence of seven quiet days.
+
+## Receiving runtime probe
+
+The live State Hub deployment image was `main-cdff3b7`; its configmap directs
+both SBOM read and write compatibility paths to the cluster Nexus service.
+
+`core-hub-api` and `core-hub-api-candidate` deployments both reported 1/1 ready.
+From the State Hub pod, requests to both Core Hub service addresses on port 8010
+were connection-refused. Cause was not established and no connectivity change
+was made. From candidate pod loopback, `/openapi.json` returned a **Hub Core
+Runtime** schema with 31 paths. It exposes `/api/v2/interaction-events`, but no
+`/messages`, `/progress`, `/token-events` or `/interface-changes` family.
+
+Shared Python routers exist for messages/progress, but importing them into
+State Hub does not deploy them on the owner runtime or migrate their rows.
+HUB-WP-0005's successful Core Hub `/api/v2` absorption must not be used as proof
+of the State Hub family cutover. STATE-WP-0079-T08 owns the bounded follow-up:
+identify/expose one deployed message-read contract, historical data projection,
+transport and parity/rollback evidence before changing any reader/writer.
+
+## Validation
+
+- Live primary identity and fresh seven-day eligibility verified before PATCH.
+- Direct receiving SBOM reads: 200; canonical caller task reads: 200.
+- State Hub skill passes the skill-creator frontmatter validator; this also
+  corrected an existing unquoted colon that made its description invalid YAML.
+- Documentation and caller-instruction edits pass `git diff --check`.
+- No executable application code changed; no database test suite was needed.
diff --git a/docs/evidence/STATE-WP-0079-d2-dual-read-20260831.md b/docs/evidence/STATE-WP-0079-d2-dual-read-20260831.md
new file mode 100644
index 0000000..44a727c
--- /dev/null
+++ b/docs/evidence/STATE-WP-0079-d2-dual-read-20260831.md
@@ -0,0 +1,88 @@
+# STATE-WP-0079 D2 dual-read cutover evidence — 2026-08-31
+
+## Outcome
+
+The Railiance Fabric authority snapshot is active on the `railiance01` State
+Hub read model and the executable fin-hub parity gate is green. Import
+idempotency and production rollback/roll-forward were exercised against
+retained immutable imports.
+
+This completes the D2 dual-read evidence. It does not authorize retirement of
+State Hub or claim a hosted Railiance Fabric owner service; that operational
+residual is `RAIL-FAB-WP-0028`.
+
+## Authority snapshot
+
+- Producer: `railiance-fabric`
+- Contract: `railiance.fabric/v1alpha2`, `financial-fabric-v1`
+- Revision: `snapshot-set:sha256:991bca294474e76a65e28011d813aace15d040aa7c173fcf8874a5d548aa7b35`
+- Source path: `registry://accepted-snapshots`
+- Exported at: `2026-08-31T20:44:15Z`
+- Content hash: `caae66795ce8e969b086609f7905c129206e4a027eb60c65086fc183e88613a2`
+- Counts: 131 nodes, 117 edges, 2 actors, 1 fabric, 0 unresolved references
+- State Hub import: `47e5358e-d04b-4969-99a2-ca88423ad054`
+
+## Compatibility defect and deployment
+
+The first production import correctly failed closed, but exposed two receiver
+defects: the Pydantic receiver omitted the contract's `deployment_overlay`, and
+`fabric_graph_imports.source_commit` was `varchar(80)` while deterministic
+snapshot-set revisions are 84 characters. The invalid-import diagnostic then
+also hit that width constraint and returned HTTP 500 instead of 422.
+
+State Hub commit `cf40c7b` aligned the receiver, bounded invalid provenance
+metadata, added migration `b5e6f7a8c9d0`, and added regression coverage. It was
+deployed atomically as image `main-cf40c7b`, Helm revision 56. Commit `cdff3b7`
+then added immutable-import activation for operational rollback and was deployed
+as image `main-cdff3b7`, Helm revision 57. Final health reported
+`primary/railiance01`, database connected, and schema `b5e6f7a8c9d0` applied.
+
+Verification:
+
+- Full State Hub suite before the first deployment: 828 passed; dashboard build
+  completed (one pre-existing SQLAlchemy resource warning and one broken-link
+  warning).
+- Focused activation/financial/import tests after the rollback addition: 5
+  passed.
+- The exact saved authority payload validated as 131 nodes / 117 edges before
+  deployment.
+
+## Parity and idempotency
+
+`finhub fabric-cutover-check` compared the saved authority export with
+`/fabric/graph/summary`. All checks passed: API/schema/kind, content hash,
+node/edge/actor/fabric/unresolved counts, source revision/path, and export time.
+The result was `ready: true` with no failures.
+
+Posting the identical saved payload a second time returned `created: false`,
+`idempotent: true`, and the same import id. No duplicate graph was created.
+
+## Exercised rollback and roll-forward
+
+The previous valid import remained intact as
+`f844733d-bfc2-4809-a3c6-8cc8fbb5a84d` (49 nodes, 58 edges, content hash
+`9d08056060753445727cff8cff7a7be1525b113dabcf45c4039bce98a1f5e912`).
+
+1. Activating that import changed the live summary to 49 nodes / 58 edges and
+   reported the 131/117 import as the previous import.
+2. Activating `47e5358e-d04b-4969-99a2-ca88423ad054` restored 131 nodes / 117
+   edges and reported the old import as previous.
+3. The full fin-hub cutover gate was rerun after roll-forward and again returned
+   `ready: true` with zero failures.
+
+Activation changes only the per-source latest marker; both graph imports remain
+immutable and readable.
+
+## Caller and owner-surface review
+
+A fresh code scan of repo-manager, fin-hub, hub-core, activity-core, ops-hub,
+railiance-fabric, and the retirement project found no runtime callers of the
+State Hub `/fabric/graph*` routes. Matches were contracts, operator docs, and
+retirement inventory only.
+
+Railiance Fabric currently documents a workstation-local registry service at
+`127.0.0.1:8765`; no Kubernetes/Helm production deployment was found in
+railiance-apps, railiance-cluster, rail-kubernetes, or railiance-fabric. Its
+accepted snapshot set is deterministic, but many component snapshots predate
+this cutover. `RAIL-FAB-WP-0028` owns the hosted runtime, persistence,
+authentication, freshness, recovery, and eventual direct-consumer switch.
diff --git a/docs/evidence/STATE-WP-0079-sbom-retirement-20260905.json b/docs/evidence/STATE-WP-0079-sbom-retirement-20260905.json
new file mode 100644
index 0000000..3dd3e0a
--- /dev/null
+++ b/docs/evidence/STATE-WP-0079-sbom-retirement-20260905.json
@@ -0,0 +1,1572 @@
+{
+  "captured_at": "2026-09-05T08:04:47.855699+00:00",
+  "workplan": "STATE-WP-0079",
+  "api_base": "http://127.0.0.1:8000",
+  "health": {
+    "status": "ok",
+    "db": "connected",
+    "instance_role": "primary",
+    "instance_label": "railiance01",
+    "schema": {
+      "status": "ok",
+      "applied": "b5e6f7a8c9d0",
+      "expected": "b5e6f7a8c9d0"
+    }
+  },
+  "before": {
+    "generated_at": "2026-09-05T08:04:48.276126Z",
+    "window_start": "2026-08-29T08:04:48.185252Z",
+    "window_end": "2026-09-05T08:04:48.185252Z",
+    "cadence": "weekly",
+    "activity_core_handoff": {
+      "activity_id": "statehub-legacy-interface-review",
+      "cadence": "weekly",
+      "source_endpoint": "/legacy-meter/weekly-review",
+      "state_owner": "state-hub",
+      "scheduler_owner": "activity-core"
+    },
+    "interfaces": [
+      {
+        "interface": {
+          "id": "8051fb40-66c9-4dc4-a413-13e8573e04a3",
+          "interface_key": "event_subject:org.statehub.workstream.completed",
+          "interface_kind": "event_subject",
+          "legacy_since": "2026-06-04T06:09:42.198193Z",
+          "replacement_ref": "org.statehub.workplan.completed",
+          "owner_component": "state-hub.events",
+          "status": "retired",
+          "replacement_verified": true,
+          "manual_hold": false,
+          "hold_reason": null,
+          "notes": "Retired by STATE-WP-0069 closeout",
+          "retired_at": "2026-08-31T08:55:06.871333Z",
+          "created_at": "2026-06-04T06:09:42.198193Z",
+          "updated_at": "2026-08-31T08:55:06.756087Z"
+        },
+        "all_time": {
+          "calls": 247,
+          "tenant_count": 1,
+          "user_count": 1,
+          "component_count": 1,
+          "tenants": {
+            "unknown": 247
+          },
+          "users": {
+            "unknown": 247
+          },
+          "components": {
+            "state-hub.events": 247
+          }
+        },
+        "window": {
+          "calls": 0,
+          "tenant_count": 0,
+          "user_count": 0,
+          "component_count": 0,
+          "tenants": {},
+          "users": {},
+          "components": {}
+        },
+        "last_seen_at": "2026-07-13T13:22:00.748140Z",
+        "retirement_candidate": false,
+        "retirement_reason": "already retired"
+      },
+      {
+        "interface": {
+          "id": "cd9342fd-27e7-4a46-a1be-d41499e106a3",
+          "interface_key": "rest_api:DELETE /workstreams/{workstream_id}",
+          "interface_kind": "rest_api",
+          "legacy_since": "2026-06-06T17:28:13.052813Z",
+          "replacement_ref": "/workplans/{workplan_id}",
+          "owner_component": "state-hub.api",
+          "status": "retired",
+          "replacement_verified": true,
+          "manual_hold": false,
+          "hold_reason": null,
+          "notes": "Retired by STATE-WP-0069 closeout",
+          "retired_at": "2026-08-31T08:55:08.200322Z",
+          "created_at": "2026-06-06T17:28:13.052813Z",
+          "updated_at": "2026-08-31T08:55:08.089714Z"
+        },
+        "all_time": {
+          "calls": 1,
+          "tenant_count": 1,
+          "user_count": 1,
+          "component_count": 1,
+          "tenants": {
+            "unknown": 1
+          },
+          "users": {
+            "unknown": 1
+          },
+          "components": {
+            "unknown": 1
+          }
+        },
+        "window": {
+          "calls": 0,
+          "tenant_count": 0,
+          "user_count": 0,
+          "component_count": 0,
+          "tenants": {},
+          "users": {},
+          "components": {}
+        },
+        "last_seen_at": "2026-06-06T17:28:13.047529Z",
+        "retirement_candidate": false,
+        "retirement_reason": "already retired"
+      },
+      {
+        "interface": {
+          "id": "d0294dce-7913-4268-94c3-1b2502aefb0f",
+          "interface_key": "rest_api:GET /sbom/",
+          "interface_kind": "rest_api",
+          "legacy_since": "2026-08-22T17:06:38.703608Z",
+          "replacement_ref": "sbom-nexus:/sbom/",
+          "owner_component": "state-hub.sbom-compat",
+          "status": "legacy",
+          "replacement_verified": true,
+          "manual_hold": false,
+          "hold_reason": null,
+          "notes": null,
+          "retired_at": null,
+          "created_at": "2026-08-22T17:06:38.703608Z",
+          "updated_at": "2026-08-22T17:23:43.730661Z"
+        },
+        "all_time": {
+          "calls": 6,
+          "tenant_count": 1,
+          "user_count": 1,
+          "component_count": 1,
+          "tenants": {
+            "unknown": 6
+          },
+          "users": {
+            "unknown": 6
+          },
+          "components": {
+            "unknown": 6
+          }
+        },
+        "window": {
+          "calls": 1,
+          "tenant_count": 1,
+          "user_count": 1,
+          "component_count": 1,
+          "tenants": {
+            "unknown": 1
+          },
+          "users": {
+            "unknown": 1
+          },
+          "components": {
+            "unknown": 1
+          }
+        },
+        "last_seen_at": "2026-08-31T08:18:41.571768Z",
+        "retirement_candidate": false,
+        "retirement_reason": "1 call(s) in review window"
+      },
+      {
+        "interface": {
+          "id": "2f77ac12-8c97-4974-a2f9-2996927982d1",
+          "interface_key": "rest_api:GET /sbom/report/licences/",
+          "interface_kind": "rest_api",
+          "legacy_since": "2026-08-22T17:06:41.978426Z",
+          "replacement_ref": "sbom-nexus:/sbom/",
+          "owner_component": "state-hub.sbom-compat",
+          "status": "legacy",
+          "replacement_verified": true,
+          "manual_hold": false,
+          "hold_reason": null,
+          "notes": null,
+          "retired_at": null,
+          "created_at": "2026-08-22T17:06:41.978426Z",
+          "updated_at": "2026-08-22T17:23:44.794796Z"
+        },
+        "all_time": {
+          "calls": 5,
+          "tenant_count": 1,
+          "user_count": 1,
+          "component_count": 1,
+          "tenants": {
+            "unknown": 5
+          },
+          "users": {
+            "unknown": 5
+          },
+          "components": {
+            "unknown": 5
+          }
+        },
+        "window": {
+          "calls": 0,
+          "tenant_count": 0,
+          "user_count": 0,
+          "component_count": 0,
+          "tenants": {},
+          "users": {},
+          "components": {}
+        },
+        "last_seen_at": "2026-08-28T18:46:10.642164Z",
+        "retirement_candidate": true,
+        "retirement_reason": "no usage in review window; quiet 7d (>= 7d required for 5 all-time call(s))"
+      },
+      {
+        "interface": {
+          "id": "b627edf5-3302-4366-ba2e-547d32f634b5",
+          "interface_key": "rest_api:GET /sbom/snapshots/",
+          "interface_kind": "rest_api",
+          "legacy_since": "2026-08-22T17:06:37.057774Z",
+          "replacement_ref": "sbom-nexus:/sbom/",
+          "owner_component": "state-hub.sbom-compat",
+          "status": "legacy",
+          "replacement_verified": true,
+          "manual_hold": false,
+          "hold_reason": null,
+          "notes": null,
+          "retired_at": null,
+          "created_at": "2026-08-22T17:06:37.057774Z",
+          "updated_at": "2026-08-22T17:22:15.080213Z"
+        },
+        "all_time": {
+          "calls": 7,
+          "tenant_count": 1,
+          "user_count": 1,
+          "component_count": 1,
+          "tenants": {
+            "unknown": 7
+          },
+          "users": {
+            "unknown": 7
+          },
+          "components": {
+            "unknown": 7
+          }
+        },
+        "window": {
+          "calls": 0,
+          "tenant_count": 0,
+          "user_count": 0,
+          "component_count": 0,
+          "tenants": {},
+          "users": {},
+          "components": {}
+        },
+        "last_seen_at": "2026-08-28T18:46:10.694185Z",
+        "retirement_candidate": true,
+        "retirement_reason": "no usage in review window; quiet 7d (>= 7d required for 7 all-time call(s))"
+      },
+      {
+        "interface": {
+          "id": "d03ee274-cd6f-4cd5-8f22-e4d298416299",
+          "interface_key": "rest_api:GET /sbom/snapshots/{snapshot_id}",
+          "interface_kind": "rest_api",
+          "legacy_since": "2026-08-22T17:23:45.969876Z",
+          "replacement_ref": "sbom-nexus:/sbom/",
+          "owner_component": "state-hub.sbom-compat",
+          "status": "retired",
+          "replacement_verified": true,
+          "manual_hold": false,
+          "hold_reason": null,
+          "notes": "Retired by STATE-WP-0069 closeout",
+          "retired_at": "2026-08-31T08:55:08.470106Z",
+          "created_at": "2026-08-22T17:23:45.969876Z",
+          "updated_at": "2026-08-31T08:55:08.456139Z"
+        },
+        "all_time": {
+          "calls": 1,
+          "tenant_count": 1,
+          "user_count": 1,
+          "component_count": 1,
+          "tenants": {
+            "unknown": 1
+          },
+          "users": {
+            "unknown": 1
+          },
+          "components": {
+            "unknown": 1
+          }
+        },
+        "window": {
+          "calls": 0,
+          "tenant_count": 0,
+          "user_count": 0,
+          "component_count": 0,
+          "tenants": {},
+          "users": {},
+          "components": {}
+        },
+        "last_seen_at": "2026-08-22T17:23:45.967492Z",
+        "retirement_candidate": false,
+        "retirement_reason": "already retired"
+      },
+      {
+        "interface": {
+          "id": "a6cb291e-8312-42f8-8a66-fde369482881",
+          "interface_key": "rest_api:GET /sbom/{repo_slug}",
+          "interface_kind": "rest_api",
+          "legacy_since": "2026-08-22T17:23:45.089542Z",
+          "replacement_ref": "sbom-nexus:/sbom/",
+          "owner_component": "state-hub.sbom-compat",
+          "status": "retired",
+          "replacement_verified": true,
+          "manual_hold": false,
+          "hold_reason": null,
+          "notes": "Retired by STATE-WP-0069 closeout",
+          "retired_at": "2026-08-31T08:55:08.754914Z",
+          "created_at": "2026-08-22T17:23:45.089542Z",
+          "updated_at": "2026-08-31T08:55:08.750826Z"
+        },
+        "all_time": {
+          "calls": 1,
+          "tenant_count": 1,
+          "user_count": 1,
+          "component_count": 1,
+          "tenants": {
+            "unknown": 1
+          },
+          "users": {
+            "unknown": 1
+          },
+          "components": {
+            "unknown": 1
+          }
+        },
+        "window": {
+          "calls": 0,
+          "tenant_count": 0,
+          "user_count": 0,
+          "component_count": 0,
+          "tenants": {},
+          "users": {},
+          "components": {}
+        },
+        "last_seen_at": "2026-08-22T17:23:45.670511Z",
+        "retirement_candidate": false,
+        "retirement_reason": "already retired"
+      },
+      {
+        "interface": {
+          "id": "cad13f19-ddb1-49b9-86d0-8789b7599f3a",
+          "interface_key": "rest_api:GET /tasks/?workstream_id",
+          "interface_kind": "rest_api",
+          "legacy_since": "2026-08-29T10:01:31.546213Z",
+          "replacement_ref": "/tasks/?workplan_id=<workplan_id>",
+          "owner_component": "state-hub.api",
+          "status": "legacy",
+          "replacement_verified": true,
+          "manual_hold": false,
+          "hold_reason": null,
+          "notes": null,
+          "retired_at": null,
+          "created_at": "2026-08-29T10:01:31.546213Z",
+          "updated_at": "2026-08-29T10:01:31.546213Z"
+        },
+        "all_time": {
+          "calls": 11,
+          "tenant_count": 1,
+          "user_count": 1,
+          "component_count": 1,
+          "tenants": {
+            "unknown": 11
+          },
+          "users": {
+            "unknown": 11
+          },
+          "components": {
+            "unknown": 11
+          }
+        },
+        "window": {
+          "calls": 11,
+          "tenant_count": 1,
+          "user_count": 1,
+          "component_count": 1,
+          "tenants": {
+            "unknown": 11
+          },
+          "users": {
+            "unknown": 11
+          },
+          "components": {
+            "unknown": 11
+          }
+        },
+        "last_seen_at": "2026-09-04T17:21:29.173850Z",
+        "retirement_candidate": false,
+        "retirement_reason": "11 call(s) in review window"
+      },
+      {
+        "interface": {
+          "id": "3e4a3d0b-08fa-45c3-91e2-4f514a914b97",
+          "interface_key": "rest_api:GET /workstreams/",
+          "interface_kind": "rest_api",
+          "legacy_since": "2026-06-04T00:26:14.533764Z",
+          "replacement_ref": "/workplans/",
+          "owner_component": "state-hub.api",
+          "status": "legacy",
+          "replacement_verified": true,
+          "manual_hold": false,
+          "hold_reason": null,
+          "notes": null,
+          "retired_at": null,
+          "created_at": "2026-06-04T00:26:14.533764Z",
+          "updated_at": "2026-06-04T00:26:14.533764Z"
+        },
+        "all_time": {
+          "calls": 830269,
+          "tenant_count": 1,
+          "user_count": 1,
+          "component_count": 1,
+          "tenants": {
+            "unknown": 830269
+          },
+          "users": {
+            "unknown": 830269
+          },
+          "components": {
+            "unknown": 830269
+          }
+        },
+        "window": {
+          "calls": 0,
+          "tenant_count": 0,
+          "user_count": 0,
+          "component_count": 0,
+          "tenants": {},
+          "users": {},
+          "components": {}
+        },
+        "last_seen_at": "2026-08-21T13:50:37.994459Z",
+        "retirement_candidate": false,
+        "retirement_reason": "quiet 14d of 60d required for 830269 all-time call(s)"
+      },
+      {
+        "interface": {
+          "id": "e4c140ec-7479-46f9-b185-4b533f19d639",
+          "interface_key": "rest_api:GET /workstreams/workplan-index",
+          "interface_kind": "rest_api",
+          "legacy_since": "2026-06-04T05:20:58.321869Z",
+          "replacement_ref": "/workplans/index",
+          "owner_component": "state-hub.api",
+          "status": "retired",
+          "replacement_verified": true,
+          "manual_hold": false,
+          "hold_reason": null,
+          "notes": "Retired by STATE-WP-0069 closeout",
+          "retired_at": "2026-08-31T08:55:08.939572Z",
+          "created_at": "2026-06-04T05:20:58.321869Z",
+          "updated_at": "2026-08-31T08:55:08.933482Z"
+        },
+        "all_time": {
+          "calls": 40,
+          "tenant_count": 1,
+          "user_count": 1,
+          "component_count": 1,
+          "tenants": {
+            "unknown": 40
+          },
+          "users": {
+            "unknown": 40
+          },
+          "components": {
+            "unknown": 40
+          }
+        },
+        "window": {
+          "calls": 1,
+          "tenant_count": 1,
+          "user_count": 1,
+          "component_count": 1,
+          "tenants": {
+            "unknown": 1
+          },
+          "users": {
+            "unknown": 1
+          },
+          "components": {
+            "unknown": 1
+          }
+        },
+        "last_seen_at": "2026-09-01T18:42:55.879795Z",
+        "retirement_candidate": false,
+        "retirement_reason": "already retired"
+      },
+      {
+        "interface": {
+          "id": "3a00b19e-e7db-4403-98aa-a77c9ab61ecc",
+          "interface_key": "rest_api:GET /workstreams/{workstream_id}",
+          "interface_kind": "rest_api",
+          "legacy_since": "2026-06-04T00:25:59.014966Z",
+          "replacement_ref": "/workplans/{workplan_id}",
+          "owner_component": "state-hub.api",
+          "status": "legacy",
+          "replacement_verified": true,
+          "manual_hold": false,
+          "hold_reason": null,
+          "notes": null,
+          "retired_at": null,
+          "created_at": "2026-06-04T00:25:59.014966Z",
+          "updated_at": "2026-06-04T00:25:59.014966Z"
+        },
+        "all_time": {
+          "calls": 3411477,
+          "tenant_count": 1,
+          "user_count": 1,
+          "component_count": 1,
+          "tenants": {
+            "unknown": 3411477
+          },
+          "users": {
+            "unknown": 3411477
+          },
+          "components": {
+            "unknown": 3411477
+          }
+        },
+        "window": {
+          "calls": 7,
+          "tenant_count": 1,
+          "user_count": 1,
+          "component_count": 1,
+          "tenants": {
+            "unknown": 7
+          },
+          "users": {
+            "unknown": 7
+          },
+          "components": {
+            "unknown": 7
+          }
+        },
+        "last_seen_at": "2026-09-03T22:02:35.348363Z",
+        "retirement_candidate": false,
+        "retirement_reason": "7 call(s) in review window"
+      },
+      {
+        "interface": {
+          "id": "69e1a255-a8b9-4101-8a68-b1bed23abfda",
+          "interface_key": "rest_api:GET /workstreams/{workstream_id}/dependencies/",
+          "interface_kind": "rest_api",
+          "legacy_since": "2026-06-04T00:25:59.291135Z",
+          "replacement_ref": "/workplans/{workplan_id}/dependencies/",
+          "owner_component": "state-hub.api",
+          "status": "legacy",
+          "replacement_verified": true,
+          "manual_hold": false,
+          "hold_reason": null,
+          "notes": null,
+          "retired_at": null,
+          "created_at": "2026-06-04T00:25:59.291135Z",
+          "updated_at": "2026-06-04T00:25:59.291135Z"
+        },
+        "all_time": {
+          "calls": 1643952,
+          "tenant_count": 1,
+          "user_count": 1,
+          "component_count": 1,
+          "tenants": {
+            "unknown": 1643952
+          },
+          "users": {
+            "unknown": 1643952
+          },
+          "components": {
+            "unknown": 1643952
+          }
+        },
+        "window": {
+          "calls": 0,
+          "tenant_count": 0,
+          "user_count": 0,
+          "component_count": 0,
+          "tenants": {},
+          "users": {},
+          "components": {}
+        },
+        "last_seen_at": "2026-08-21T13:50:30.082480Z",
+        "retirement_candidate": false,
+        "retirement_reason": "quiet 14d of 60d required for 1643952 all-time call(s)"
+      },
+      {
+        "interface": {
+          "id": "b1aae931-b51f-4a85-a723-865dd65f6132",
+          "interface_key": "rest_api:PATCH /workstreams/{workstream_id}",
+          "interface_kind": "rest_api",
+          "legacy_since": "2026-06-04T06:09:41.901035Z",
+          "replacement_ref": "/workplans/{workplan_id}",
+          "owner_component": "state-hub.api",
+          "status": "legacy",
+          "replacement_verified": true,
+          "manual_hold": false,
+          "hold_reason": null,
+          "notes": null,
+          "retired_at": null,
+          "created_at": "2026-06-04T06:09:41.901035Z",
+          "updated_at": "2026-06-04T06:09:41.901035Z"
+        },
+        "all_time": {
+          "calls": 584,
+          "tenant_count": 1,
+          "user_count": 1,
+          "component_count": 1,
+          "tenants": {
+            "unknown": 584
+          },
+          "users": {
+            "unknown": 584
+          },
+          "components": {
+            "unknown": 584
+          }
+        },
+        "window": {
+          "calls": 0,
+          "tenant_count": 0,
+          "user_count": 0,
+          "component_count": 0,
+          "tenants": {},
+          "users": {},
+          "components": {}
+        },
+        "last_seen_at": "2026-08-16T16:33:34.045078Z",
+        "retirement_candidate": false,
+        "retirement_reason": "quiet 19d of 30d required for 584 all-time call(s)"
+      },
+      {
+        "interface": {
+          "id": "ed6451c9-d2cc-4486-9afe-d3852782cabc",
+          "interface_key": "rest_api:POST /workstreams/",
+          "interface_kind": "rest_api",
+          "legacy_since": "2026-06-04T07:40:24.168535Z",
+          "replacement_ref": "/workplans/",
+          "owner_component": "state-hub.api",
+          "status": "legacy",
+          "replacement_verified": true,
+          "manual_hold": false,
+          "hold_reason": null,
+          "notes": null,
+          "retired_at": null,
+          "created_at": "2026-06-04T07:40:24.168535Z",
+          "updated_at": "2026-06-04T07:40:24.168535Z"
+        },
+        "all_time": {
+          "calls": 811,
+          "tenant_count": 1,
+          "user_count": 1,
+          "component_count": 1,
+          "tenants": {
+            "unknown": 811
+          },
+          "users": {
+            "unknown": 811
+          },
+          "components": {
+            "unknown": 811
+          }
+        },
+        "window": {
+          "calls": 0,
+          "tenant_count": 0,
+          "user_count": 0,
+          "component_count": 0,
+          "tenants": {},
+          "users": {},
+          "components": {}
+        },
+        "last_seen_at": "2026-08-16T01:03:41.093965Z",
+        "retirement_candidate": false,
+        "retirement_reason": "quiet 20d of 30d required for 811 all-time call(s)"
+      },
+      {
+        "interface": {
+          "id": "281fd706-b192-4194-8055-2d8733c115f9",
+          "interface_key": "rest_api:POST /workstreams/{workstream_id}/dependencies/",
+          "interface_kind": "rest_api",
+          "legacy_since": "2026-06-04T22:57:37.149207Z",
+          "replacement_ref": "/workplans/{workplan_id}/dependencies/",
+          "owner_component": "state-hub.api",
+          "status": "retired",
+          "replacement_verified": true,
+          "manual_hold": false,
+          "hold_reason": null,
+          "notes": "Retired by STATE-WP-0069 closeout",
+          "retired_at": "2026-08-31T08:55:09.130713Z",
+          "created_at": "2026-06-04T22:57:37.149207Z",
+          "updated_at": "2026-08-31T08:55:09.123888Z"
+        },
+        "all_time": {
+          "calls": 4975,
+          "tenant_count": 1,
+          "user_count": 1,
+          "component_count": 1,
+          "tenants": {
+            "unknown": 4975
+          },
+          "users": {
+            "unknown": 4975
+          },
+          "components": {
+            "unknown": 4975
+          }
+        },
+        "window": {
+          "calls": 0,
+          "tenant_count": 0,
+          "user_count": 0,
+          "component_count": 0,
+          "tenants": {},
+          "users": {},
+          "components": {}
+        },
+        "last_seen_at": "2026-07-07T20:31:35.389791Z",
+        "retirement_candidate": false,
+        "retirement_reason": "already retired"
+      }
+    ],
+    "retirement_candidates": [
+      {
+        "interface": {
+          "id": "2f77ac12-8c97-4974-a2f9-2996927982d1",
+          "interface_key": "rest_api:GET /sbom/report/licences/",
+          "interface_kind": "rest_api",
+          "legacy_since": "2026-08-22T17:06:41.978426Z",
+          "replacement_ref": "sbom-nexus:/sbom/",
+          "owner_component": "state-hub.sbom-compat",
+          "status": "legacy",
+          "replacement_verified": true,
+          "manual_hold": false,
+          "hold_reason": null,
+          "notes": null,
+          "retired_at": null,
+          "created_at": "2026-08-22T17:06:41.978426Z",
+          "updated_at": "2026-08-22T17:23:44.794796Z"
+        },
+        "all_time": {
+          "calls": 5,
+          "tenant_count": 1,
+          "user_count": 1,
+          "component_count": 1,
+          "tenants": {
+            "unknown": 5
+          },
+          "users": {
+            "unknown": 5
+          },
+          "components": {
+            "unknown": 5
+          }
+        },
+        "window": {
+          "calls": 0,
+          "tenant_count": 0,
+          "user_count": 0,
+          "component_count": 0,
+          "tenants": {},
+          "users": {},
+          "components": {}
+        },
+        "last_seen_at": "2026-08-28T18:46:10.642164Z",
+        "retirement_candidate": true,
+        "retirement_reason": "no usage in review window; quiet 7d (>= 7d required for 5 all-time call(s))"
+      },
+      {
+        "interface": {
+          "id": "b627edf5-3302-4366-ba2e-547d32f634b5",
+          "interface_key": "rest_api:GET /sbom/snapshots/",
+          "interface_kind": "rest_api",
+          "legacy_since": "2026-08-22T17:06:37.057774Z",
+          "replacement_ref": "sbom-nexus:/sbom/",
+          "owner_component": "state-hub.sbom-compat",
+          "status": "legacy",
+          "replacement_verified": true,
+          "manual_hold": false,
+          "hold_reason": null,
+          "notes": null,
+          "retired_at": null,
+          "created_at": "2026-08-22T17:06:37.057774Z",
+          "updated_at": "2026-08-22T17:22:15.080213Z"
+        },
+        "all_time": {
+          "calls": 7,
+          "tenant_count": 1,
+          "user_count": 1,
+          "component_count": 1,
+          "tenants": {
+            "unknown": 7
+          },
+          "users": {
+            "unknown": 7
+          },
+          "components": {
+            "unknown": 7
+          }
+        },
+        "window": {
+          "calls": 0,
+          "tenant_count": 0,
+          "user_count": 0,
+          "component_count": 0,
+          "tenants": {},
+          "users": {},
+          "components": {}
+        },
+        "last_seen_at": "2026-08-28T18:46:10.694185Z",
+        "retirement_candidate": true,
+        "retirement_reason": "no usage in review window; quiet 7d (>= 7d required for 7 all-time call(s))"
+      }
+    ]
+  },
+  "retired_interfaces": [
+    {
+      "id": "2f77ac12-8c97-4974-a2f9-2996927982d1",
+      "interface_key": "rest_api:GET /sbom/report/licences/",
+      "interface_kind": "rest_api",
+      "legacy_since": "2026-08-22T17:06:41.978426Z",
+      "replacement_ref": "sbom-nexus:/sbom/",
+      "owner_component": "state-hub.sbom-compat",
+      "status": "retired",
+      "replacement_verified": true,
+      "manual_hold": false,
+      "hold_reason": null,
+      "notes": "STATE-WP-0079-T05: user-authorized retirement 2026-09-05; fresh seven-day gate passed, replacement_verified=true; direct SBOM Nexus endpoints returned HTTP 200 from the State Hub pod. Compatibility storage/routes retained for the final cutover.",
+      "retired_at": "2026-09-05T08:04:48.423727Z",
+      "created_at": "2026-08-22T17:06:41.978426Z",
+      "updated_at": "2026-09-05T08:04:48.418993Z"
+    },
+    {
+      "id": "b627edf5-3302-4366-ba2e-547d32f634b5",
+      "interface_key": "rest_api:GET /sbom/snapshots/",
+      "interface_kind": "rest_api",
+      "legacy_since": "2026-08-22T17:06:37.057774Z",
+      "replacement_ref": "sbom-nexus:/sbom/",
+      "owner_component": "state-hub.sbom-compat",
+      "status": "retired",
+      "replacement_verified": true,
+      "manual_hold": false,
+      "hold_reason": null,
+      "notes": "STATE-WP-0079-T05: user-authorized retirement 2026-09-05; fresh seven-day gate passed, replacement_verified=true; direct SBOM Nexus endpoints returned HTTP 200 from the State Hub pod. Compatibility storage/routes retained for the final cutover.",
+      "retired_at": "2026-09-05T08:04:48.506447Z",
+      "created_at": "2026-08-22T17:06:37.057774Z",
+      "updated_at": "2026-09-05T08:04:48.501706Z"
+    }
+  ],
+  "days": 7,
+  "after": {
+    "generated_at": "2026-09-05T08:04:48.937717Z",
+    "window_start": "2026-08-29T08:04:48.702204Z",
+    "window_end": "2026-09-05T08:04:48.702204Z",
+    "cadence": "weekly",
+    "activity_core_handoff": {
+      "activity_id": "statehub-legacy-interface-review",
+      "cadence": "weekly",
+      "source_endpoint": "/legacy-meter/weekly-review",
+      "state_owner": "state-hub",
+      "scheduler_owner": "activity-core"
+    },
+    "interfaces": [
+      {
+        "interface": {
+          "id": "8051fb40-66c9-4dc4-a413-13e8573e04a3",
+          "interface_key": "event_subject:org.statehub.workstream.completed",
+          "interface_kind": "event_subject",
+          "legacy_since": "2026-06-04T06:09:42.198193Z",
+          "replacement_ref": "org.statehub.workplan.completed",
+          "owner_component": "state-hub.events",
+          "status": "retired",
+          "replacement_verified": true,
+          "manual_hold": false,
+          "hold_reason": null,
+          "notes": "Retired by STATE-WP-0069 closeout",
+          "retired_at": "2026-08-31T08:55:06.871333Z",
+          "created_at": "2026-06-04T06:09:42.198193Z",
+          "updated_at": "2026-08-31T08:55:06.756087Z"
+        },
+        "all_time": {
+          "calls": 247,
+          "tenant_count": 1,
+          "user_count": 1,
+          "component_count": 1,
+          "tenants": {
+            "unknown": 247
+          },
+          "users": {
+            "unknown": 247
+          },
+          "components": {
+            "state-hub.events": 247
+          }
+        },
+        "window": {
+          "calls": 0,
+          "tenant_count": 0,
+          "user_count": 0,
+          "component_count": 0,
+          "tenants": {},
+          "users": {},
+          "components": {}
+        },
+        "last_seen_at": "2026-07-13T13:22:00.748140Z",
+        "retirement_candidate": false,
+        "retirement_reason": "already retired"
+      },
+      {
+        "interface": {
+          "id": "cd9342fd-27e7-4a46-a1be-d41499e106a3",
+          "interface_key": "rest_api:DELETE /workstreams/{workstream_id}",
+          "interface_kind": "rest_api",
+          "legacy_since": "2026-06-06T17:28:13.052813Z",
+          "replacement_ref": "/workplans/{workplan_id}",
+          "owner_component": "state-hub.api",
+          "status": "retired",
+          "replacement_verified": true,
+          "manual_hold": false,
+          "hold_reason": null,
+          "notes": "Retired by STATE-WP-0069 closeout",
+          "retired_at": "2026-08-31T08:55:08.200322Z",
+          "created_at": "2026-06-06T17:28:13.052813Z",
+          "updated_at": "2026-08-31T08:55:08.089714Z"
+        },
+        "all_time": {
+          "calls": 1,
+          "tenant_count": 1,
+          "user_count": 1,
+          "component_count": 1,
+          "tenants": {
+            "unknown": 1
+          },
+          "users": {
+            "unknown": 1
+          },
+          "components": {
+            "unknown": 1
+          }
+        },
+        "window": {
+          "calls": 0,
+          "tenant_count": 0,
+          "user_count": 0,
+          "component_count": 0,
+          "tenants": {},
+          "users": {},
+          "components": {}
+        },
+        "last_seen_at": "2026-06-06T17:28:13.047529Z",
+        "retirement_candidate": false,
+        "retirement_reason": "already retired"
+      },
+      {
+        "interface": {
+          "id": "d0294dce-7913-4268-94c3-1b2502aefb0f",
+          "interface_key": "rest_api:GET /sbom/",
+          "interface_kind": "rest_api",
+          "legacy_since": "2026-08-22T17:06:38.703608Z",
+          "replacement_ref": "sbom-nexus:/sbom/",
+          "owner_component": "state-hub.sbom-compat",
+          "status": "legacy",
+          "replacement_verified": true,
+          "manual_hold": false,
+          "hold_reason": null,
+          "notes": null,
+          "retired_at": null,
+          "created_at": "2026-08-22T17:06:38.703608Z",
+          "updated_at": "2026-08-22T17:23:43.730661Z"
+        },
+        "all_time": {
+          "calls": 6,
+          "tenant_count": 1,
+          "user_count": 1,
+          "component_count": 1,
+          "tenants": {
+            "unknown": 6
+          },
+          "users": {
+            "unknown": 6
+          },
+          "components": {
+            "unknown": 6
+          }
+        },
+        "window": {
+          "calls": 1,
+          "tenant_count": 1,
+          "user_count": 1,
+          "component_count": 1,
+          "tenants": {
+            "unknown": 1
+          },
+          "users": {
+            "unknown": 1
+          },
+          "components": {
+            "unknown": 1
+          }
+        },
+        "last_seen_at": "2026-08-31T08:18:41.571768Z",
+        "retirement_candidate": false,
+        "retirement_reason": "1 call(s) in review window"
+      },
+      {
+        "interface": {
+          "id": "2f77ac12-8c97-4974-a2f9-2996927982d1",
+          "interface_key": "rest_api:GET /sbom/report/licences/",
+          "interface_kind": "rest_api",
+          "legacy_since": "2026-08-22T17:06:41.978426Z",
+          "replacement_ref": "sbom-nexus:/sbom/",
+          "owner_component": "state-hub.sbom-compat",
+          "status": "retired",
+          "replacement_verified": true,
+          "manual_hold": false,
+          "hold_reason": null,
+          "notes": "STATE-WP-0079-T05: user-authorized retirement 2026-09-05; fresh seven-day gate passed, replacement_verified=true; direct SBOM Nexus endpoints returned HTTP 200 from the State Hub pod. Compatibility storage/routes retained for the final cutover.",
+          "retired_at": "2026-09-05T08:04:48.423727Z",
+          "created_at": "2026-08-22T17:06:41.978426Z",
+          "updated_at": "2026-09-05T08:04:48.418993Z"
+        },
+        "all_time": {
+          "calls": 5,
+          "tenant_count": 1,
+          "user_count": 1,
+          "component_count": 1,
+          "tenants": {
+            "unknown": 5
+          },
+          "users": {
+            "unknown": 5
+          },
+          "components": {
+            "unknown": 5
+          }
+        },
+        "window": {
+          "calls": 0,
+          "tenant_count": 0,
+          "user_count": 0,
+          "component_count": 0,
+          "tenants": {},
+          "users": {},
+          "components": {}
+        },
+        "last_seen_at": "2026-08-28T18:46:10.642164Z",
+        "retirement_candidate": false,
+        "retirement_reason": "already retired"
+      },
+      {
+        "interface": {
+          "id": "b627edf5-3302-4366-ba2e-547d32f634b5",
+          "interface_key": "rest_api:GET /sbom/snapshots/",
+          "interface_kind": "rest_api",
+          "legacy_since": "2026-08-22T17:06:37.057774Z",
+          "replacement_ref": "sbom-nexus:/sbom/",
+          "owner_component": "state-hub.sbom-compat",
+          "status": "retired",
+          "replacement_verified": true,
+          "manual_hold": false,
+          "hold_reason": null,
+          "notes": "STATE-WP-0079-T05: user-authorized retirement 2026-09-05; fresh seven-day gate passed, replacement_verified=true; direct SBOM Nexus endpoints returned HTTP 200 from the State Hub pod. Compatibility storage/routes retained for the final cutover.",
+          "retired_at": "2026-09-05T08:04:48.506447Z",
+          "created_at": "2026-08-22T17:06:37.057774Z",
+          "updated_at": "2026-09-05T08:04:48.501706Z"
+        },
+        "all_time": {
+          "calls": 7,
+          "tenant_count": 1,
+          "user_count": 1,
+          "component_count": 1,
+          "tenants": {
+            "unknown": 7
+          },
+          "users": {
+            "unknown": 7
+          },
+          "components": {
+            "unknown": 7
+          }
+        },
+        "window": {
+          "calls": 0,
+          "tenant_count": 0,
+          "user_count": 0,
+          "component_count": 0,
+          "tenants": {},
+          "users": {},
+          "components": {}
+        },
+        "last_seen_at": "2026-08-28T18:46:10.694185Z",
+        "retirement_candidate": false,
+        "retirement_reason": "already retired"
+      },
+      {
+        "interface": {
+          "id": "d03ee274-cd6f-4cd5-8f22-e4d298416299",
+          "interface_key": "rest_api:GET /sbom/snapshots/{snapshot_id}",
+          "interface_kind": "rest_api",
+          "legacy_since": "2026-08-22T17:23:45.969876Z",
+          "replacement_ref": "sbom-nexus:/sbom/",
+          "owner_component": "state-hub.sbom-compat",
+          "status": "retired",
+          "replacement_verified": true,
+          "manual_hold": false,
+          "hold_reason": null,
+          "notes": "Retired by STATE-WP-0069 closeout",
+          "retired_at": "2026-08-31T08:55:08.470106Z",
+          "created_at": "2026-08-22T17:23:45.969876Z",
+          "updated_at": "2026-08-31T08:55:08.456139Z"
+        },
+        "all_time": {
+          "calls": 1,
+          "tenant_count": 1,
+          "user_count": 1,
+          "component_count": 1,
+          "tenants": {
+            "unknown": 1
+          },
+          "users": {
+            "unknown": 1
+          },
+          "components": {
+            "unknown": 1
+          }
+        },
+        "window": {
+          "calls": 0,
+          "tenant_count": 0,
+          "user_count": 0,
+          "component_count": 0,
+          "tenants": {},
+          "users": {},
+          "components": {}
+        },
+        "last_seen_at": "2026-08-22T17:23:45.967492Z",
+        "retirement_candidate": false,
+        "retirement_reason": "already retired"
+      },
+      {
+        "interface": {
+          "id": "a6cb291e-8312-42f8-8a66-fde369482881",
+          "interface_key": "rest_api:GET /sbom/{repo_slug}",
+          "interface_kind": "rest_api",
+          "legacy_since": "2026-08-22T17:23:45.089542Z",
+          "replacement_ref": "sbom-nexus:/sbom/",
+          "owner_component": "state-hub.sbom-compat",
+          "status": "retired",
+          "replacement_verified": true,
+          "manual_hold": false,
+          "hold_reason": null,
+          "notes": "Retired by STATE-WP-0069 closeout",
+          "retired_at": "2026-08-31T08:55:08.754914Z",
+          "created_at": "2026-08-22T17:23:45.089542Z",
+          "updated_at": "2026-08-31T08:55:08.750826Z"
+        },
+        "all_time": {
+          "calls": 1,
+          "tenant_count": 1,
+          "user_count": 1,
+          "component_count": 1,
+          "tenants": {
+            "unknown": 1
+          },
+          "users": {
+            "unknown": 1
+          },
+          "components": {
+            "unknown": 1
+          }
+        },
+        "window": {
+          "calls": 0,
+          "tenant_count": 0,
+          "user_count": 0,
+          "component_count": 0,
+          "tenants": {},
+          "users": {},
+          "components": {}
+        },
+        "last_seen_at": "2026-08-22T17:23:45.670511Z",
+        "retirement_candidate": false,
+        "retirement_reason": "already retired"
+      },
+      {
+        "interface": {
+          "id": "cad13f19-ddb1-49b9-86d0-8789b7599f3a",
+          "interface_key": "rest_api:GET /tasks/?workstream_id",
+          "interface_kind": "rest_api",
+          "legacy_since": "2026-08-29T10:01:31.546213Z",
+          "replacement_ref": "/tasks/?workplan_id=<workplan_id>",
+          "owner_component": "state-hub.api",
+          "status": "legacy",
+          "replacement_verified": true,
+          "manual_hold": false,
+          "hold_reason": null,
+          "notes": null,
+          "retired_at": null,
+          "created_at": "2026-08-29T10:01:31.546213Z",
+          "updated_at": "2026-08-29T10:01:31.546213Z"
+        },
+        "all_time": {
+          "calls": 11,
+          "tenant_count": 1,
+          "user_count": 1,
+          "component_count": 1,
+          "tenants": {
+            "unknown": 11
+          },
+          "users": {
+            "unknown": 11
+          },
+          "components": {
+            "unknown": 11
+          }
+        },
+        "window": {
+          "calls": 11,
+          "tenant_count": 1,
+          "user_count": 1,
+          "component_count": 1,
+          "tenants": {
+            "unknown": 11
+          },
+          "users": {
+            "unknown": 11
+          },
+          "components": {
+            "unknown": 11
+          }
+        },
+        "last_seen_at": "2026-09-04T17:21:29.173850Z",
+        "retirement_candidate": false,
+        "retirement_reason": "11 call(s) in review window"
+      },
+      {
+        "interface": {
+          "id": "3e4a3d0b-08fa-45c3-91e2-4f514a914b97",
+          "interface_key": "rest_api:GET /workstreams/",
+          "interface_kind": "rest_api",
+          "legacy_since": "2026-06-04T00:26:14.533764Z",
+          "replacement_ref": "/workplans/",
+          "owner_component": "state-hub.api",
+          "status": "legacy",
+          "replacement_verified": true,
+          "manual_hold": false,
+          "hold_reason": null,
+          "notes": null,
+          "retired_at": null,
+          "created_at": "2026-06-04T00:26:14.533764Z",
+          "updated_at": "2026-06-04T00:26:14.533764Z"
+        },
+        "all_time": {
+          "calls": 830269,
+          "tenant_count": 1,
+          "user_count": 1,
+          "component_count": 1,
+          "tenants": {
+            "unknown": 830269
+          },
+          "users": {
+            "unknown": 830269
+          },
+          "components": {
+            "unknown": 830269
+          }
+        },
+        "window": {
+          "calls": 0,
+          "tenant_count": 0,
+          "user_count": 0,
+          "component_count": 0,
+          "tenants": {},
+          "users": {},
+          "components": {}
+        },
+        "last_seen_at": "2026-08-21T13:50:37.994459Z",
+        "retirement_candidate": false,
+        "retirement_reason": "quiet 14d of 60d required for 830269 all-time call(s)"
+      },
+      {
+        "interface": {
+          "id": "e4c140ec-7479-46f9-b185-4b533f19d639",
+          "interface_key": "rest_api:GET /workstreams/workplan-index",
+          "interface_kind": "rest_api",
+          "legacy_since": "2026-06-04T05:20:58.321869Z",
+          "replacement_ref": "/workplans/index",
+          "owner_component": "state-hub.api",
+          "status": "retired",
+          "replacement_verified": true,
+          "manual_hold": false,
+          "hold_reason": null,
+          "notes": "Retired by STATE-WP-0069 closeout",
+          "retired_at": "2026-08-31T08:55:08.939572Z",
+          "created_at": "2026-06-04T05:20:58.321869Z",
+          "updated_at": "2026-08-31T08:55:08.933482Z"
+        },
+        "all_time": {
+          "calls": 40,
+          "tenant_count": 1,
+          "user_count": 1,
+          "component_count": 1,
+          "tenants": {
+            "unknown": 40
+          },
+          "users": {
+            "unknown": 40
+          },
+          "components": {
+            "unknown": 40
+          }
+        },
+        "window": {
+          "calls": 1,
+          "tenant_count": 1,
+          "user_count": 1,
+          "component_count": 1,
+          "tenants": {
+            "unknown": 1
+          },
+          "users": {
+            "unknown": 1
+          },
+          "components": {
+            "unknown": 1
+          }
+        },
+        "last_seen_at": "2026-09-01T18:42:55.879795Z",
+        "retirement_candidate": false,
+        "retirement_reason": "already retired"
+      },
+      {
+        "interface": {
+          "id": "3a00b19e-e7db-4403-98aa-a77c9ab61ecc",
+          "interface_key": "rest_api:GET /workstreams/{workstream_id}",
+          "interface_kind": "rest_api",
+          "legacy_since": "2026-06-04T00:25:59.014966Z",
+          "replacement_ref": "/workplans/{workplan_id}",
+          "owner_component": "state-hub.api",
+          "status": "legacy",
+          "replacement_verified": true,
+          "manual_hold": false,
+          "hold_reason": null,
+          "notes": null,
+          "retired_at": null,
+          "created_at": "2026-06-04T00:25:59.014966Z",
+          "updated_at": "2026-06-04T00:25:59.014966Z"
+        },
+        "all_time": {
+          "calls": 3411477,
+          "tenant_count": 1,
+          "user_count": 1,
+          "component_count": 1,
+          "tenants": {
+            "unknown": 3411477
+          },
+          "users": {
+            "unknown": 3411477
+          },
+          "components": {
+            "unknown": 3411477
+          }
+        },
+        "window": {
+          "calls": 7,
+          "tenant_count": 1,
+          "user_count": 1,
+          "component_count": 1,
+          "tenants": {
+            "unknown": 7
+          },
+          "users": {
+            "unknown": 7
+          },
+          "components": {
+            "unknown": 7
+          }
+        },
+        "last_seen_at": "2026-09-03T22:02:35.348363Z",
+        "retirement_candidate": false,
+        "retirement_reason": "7 call(s) in review window"
+      },
+      {
+        "interface": {
+          "id": "69e1a255-a8b9-4101-8a68-b1bed23abfda",
+          "interface_key": "rest_api:GET /workstreams/{workstream_id}/dependencies/",
+          "interface_kind": "rest_api",
+          "legacy_since": "2026-06-04T00:25:59.291135Z",
+          "replacement_ref": "/workplans/{workplan_id}/dependencies/",
+          "owner_component": "state-hub.api",
+          "status": "legacy",
+          "replacement_verified": true,
+          "manual_hold": false,
+          "hold_reason": null,
+          "notes": null,
+          "retired_at": null,
+          "created_at": "2026-06-04T00:25:59.291135Z",
+          "updated_at": "2026-06-04T00:25:59.291135Z"
+        },
+        "all_time": {
+          "calls": 1643952,
+          "tenant_count": 1,
+          "user_count": 1,
+          "component_count": 1,
+          "tenants": {
+            "unknown": 1643952
+          },
+          "users": {
+            "unknown": 1643952
+          },
+          "components": {
+            "unknown": 1643952
+          }
+        },
+        "window": {
+          "calls": 0,
+          "tenant_count": 0,
+          "user_count": 0,
+          "component_count": 0,
+          "tenants": {},
+          "users": {},
+          "components": {}
+        },
+        "last_seen_at": "2026-08-21T13:50:30.082480Z",
+        "retirement_candidate": false,
+        "retirement_reason": "quiet 14d of 60d required for 1643952 all-time call(s)"
+      },
+      {
+        "interface": {
+          "id": "b1aae931-b51f-4a85-a723-865dd65f6132",
+          "interface_key": "rest_api:PATCH /workstreams/{workstream_id}",
+          "interface_kind": "rest_api",
+          "legacy_since": "2026-06-04T06:09:41.901035Z",
+          "replacement_ref": "/workplans/{workplan_id}",
+          "owner_component": "state-hub.api",
+          "status": "legacy",
+          "replacement_verified": true,
+          "manual_hold": false,
+          "hold_reason": null,
+          "notes": null,
+          "retired_at": null,
+          "created_at": "2026-06-04T06:09:41.901035Z",
+          "updated_at": "2026-06-04T06:09:41.901035Z"
+        },
+        "all_time": {
+          "calls": 584,
+          "tenant_count": 1,
+          "user_count": 1,
+          "component_count": 1,
+          "tenants": {
+            "unknown": 584
+          },
+          "users": {
+            "unknown": 584
+          },
+          "components": {
+            "unknown": 584
+          }
+        },
+        "window": {
+          "calls": 0,
+          "tenant_count": 0,
+          "user_count": 0,
+          "component_count": 0,
+          "tenants": {},
+          "users": {},
+          "components": {}
+        },
+        "last_seen_at": "2026-08-16T16:33:34.045078Z",
+        "retirement_candidate": false,
+        "retirement_reason": "quiet 19d of 30d required for 584 all-time call(s)"
+      },
+      {
+        "interface": {
+          "id": "ed6451c9-d2cc-4486-9afe-d3852782cabc",
+          "interface_key": "rest_api:POST /workstreams/",
+          "interface_kind": "rest_api",
+          "legacy_since": "2026-06-04T07:40:24.168535Z",
+          "replacement_ref": "/workplans/",
+          "owner_component": "state-hub.api",
+          "status": "legacy",
+          "replacement_verified": true,
+          "manual_hold": false,
+          "hold_reason": null,
+          "notes": null,
+          "retired_at": null,
+          "created_at": "2026-06-04T07:40:24.168535Z",
+          "updated_at": "2026-06-04T07:40:24.168535Z"
+        },
+        "all_time": {
+          "calls": 811,
+          "tenant_count": 1,
+          "user_count": 1,
+          "component_count": 1,
+          "tenants": {
+            "unknown": 811
+          },
+          "users": {
+            "unknown": 811
+          },
+          "components": {
+            "unknown": 811
+          }
+        },
+        "window": {
+          "calls": 0,
+          "tenant_count": 0,
+          "user_count": 0,
+          "component_count": 0,
+          "tenants": {},
+          "users": {},
+          "components": {}
+        },
+        "last_seen_at": "2026-08-16T01:03:41.093965Z",
+        "retirement_candidate": false,
+        "retirement_reason": "quiet 20d of 30d required for 811 all-time call(s)"
+      },
+      {
+        "interface": {
+          "id": "281fd706-b192-4194-8055-2d8733c115f9",
+          "interface_key": "rest_api:POST /workstreams/{workstream_id}/dependencies/",
+          "interface_kind": "rest_api",
+          "legacy_since": "2026-06-04T22:57:37.149207Z",
+          "replacement_ref": "/workplans/{workplan_id}/dependencies/",
+          "owner_component": "state-hub.api",
+          "status": "retired",
+          "replacement_verified": true,
+          "manual_hold": false,
+          "hold_reason": null,
+          "notes": "Retired by STATE-WP-0069 closeout",
+          "retired_at": "2026-08-31T08:55:09.130713Z",
+          "created_at": "2026-06-04T22:57:37.149207Z",
+          "updated_at": "2026-08-31T08:55:09.123888Z"
+        },
+        "all_time": {
+          "calls": 4975,
+          "tenant_count": 1,
+          "user_count": 1,
+          "component_count": 1,
+          "tenants": {
+            "unknown": 4975
+          },
+          "users": {
+            "unknown": 4975
+          },
+          "components": {
+            "unknown": 4975
+          }
+        },
+        "window": {
+          "calls": 0,
+          "tenant_count": 0,
+          "user_count": 0,
+          "component_count": 0,
+          "tenants": {},
+          "users": {},
+          "components": {}
+        },
+        "last_seen_at": "2026-07-07T20:31:35.389791Z",
+        "retirement_candidate": false,
+        "retirement_reason": "already retired"
+      }
+    ],
+    "retirement_candidates": []
+  }
+}
diff --git a/docs/evidence/STATE-WP-0083-task-identity-audit-2026-08-31.json b/docs/evidence/STATE-WP-0083-task-identity-audit-2026-08-31.json
new file mode 100644
index 0000000..b07d879
--- /dev/null
+++ b/docs/evidence/STATE-WP-0083-task-identity-audit-2026-08-31.json
@@ -0,0 +1,56 @@
+{
+  "schema": "state-hub.task-identity-audit.v1",
+  "observed_at": "2026-08-31",
+  "source": "primary State Hub task and workplan APIs",
+  "counts": {
+    "tasks": 6613,
+    "identified_tasks": 5831,
+    "duplicate_record_id_groups": 131,
+    "rows_in_duplicate_groups": 274,
+    "cross_workplan_groups": 131,
+    "same_workplan_groups": 0,
+    "cross_repository_groups": 31
+  },
+  "slug_tombstone_shape": {
+    "exactly_one_untombstoned_workplan_slug": 104,
+    "tombstoned_workplan_slugs_only": 15,
+    "multiple_untombstoned_workplan_slugs": 12,
+    "note": "Slug tombstones are an operational clue, not task-level projection membership. Tasks have no projection-retirement field."
+  },
+  "multiple_untombstoned_workplan_slugs": [
+    {
+      "record_id_prefix": "CUST-WP-0010b-T",
+      "task_identity_groups": 2,
+      "workplan_slugs": [
+        "cust-wp-0010b",
+        "cust-wp-0010"
+      ],
+      "workplan_status": "finished",
+      "cause": "stale completed task rows left by an earlier wrong workplan/backing-file projection"
+    },
+    {
+      "record_id_prefix": "SECRETS-WP-0002-T",
+      "task_identity_groups": 10,
+      "workplan_slugs": [
+        "secrets-wp-0001",
+        "secrets-wp-0002"
+      ],
+      "workplan_status": "finished",
+      "cause": "stale completed task rows left by an earlier wrong workplan/backing-file projection"
+    }
+  ],
+  "decision": {
+    "historical_rows": "preserve; a repeated label outside the owning workplan's desired task set is not current projection ambiguity",
+    "duplicate_inside_matched_workplan_desired_set": "refuse reset and report every claimant UUID",
+    "duplicate_inside_forge_projection": "refuse reset; require file-level disposition",
+    "new_derived_task_uuid_held_by_other_current_workplan": "refuse before insert",
+    "duplicate_record_id_across_other_workplans": "preserve as historical evidence; do not block unless the forge repeats the identity or the derived UUID collides"
+  },
+  "live_reconcile": {
+    "state-hub": "applied metadata at a32112e5abc18dfbecbbf1320cf5b04dce814920, then noop with every count zero",
+    "the-custodian": "applied 74 workplan and 169 task field updates; zero creates, retirements, cancellations, or refusals",
+    "secrets-engine": "applied 10 workplan and 26 task field updates; zero creates, retirements, cancellations, or refusals",
+    "second_pass": "state-hub, the-custodian, and secrets-engine returned noop with every count zero",
+    "deployment": "main-a32112e, Helm revision 53, railiance01 primary healthy"
+  }
+}
diff --git a/docs/evidence/STATE-WP-0084-private-forge-cutover-2026-08-31.md b/docs/evidence/STATE-WP-0084-private-forge-cutover-2026-08-31.md
new file mode 100644
index 0000000..957d53d
--- /dev/null
+++ b/docs/evidence/STATE-WP-0084-private-forge-cutover-2026-08-31.md
@@ -0,0 +1,34 @@
+# STATE-WP-0084 private Forge derivation cutover evidence
+
+Date: 2026-08-31
+
+The `railliance01` State Hub deployment is healthy on image
+`main-a32112e`. Helm has `forgeRead.enabled: true`; the pod uses ServiceAccount
+`state-hub`, a projected OpenBao Kubernetes token, and coordinate-only runtime
+configuration. A non-secret in-pod check returned `available` from
+`forge_read_token()`.
+
+A transaction-rolled-back review derived all nine `rapp-*` repositories from
+Forgejo before any projection write. It returned seven ordinary update sets and
+two no-ops, with zero creations, retirements, refusals, or errors. The reviewed
+commits were:
+
+| Repository | Forge commit | Review result |
+| --- | --- | --- |
+| `rapp-core-hub` | `b322bf1531650a09a9ef0669d3c63091532ab078` | update |
+| `rapp-issue-core` | `a78f38cfd8afb29ed23d150a4ea3e3dcd1f35381` | update |
+| `rapp-openbao` | `89bc86b8aff549953ec744395ca47578aaac7591` | update |
+| `rapp-policy-nexus` | `41c42e8d1a653af666da2e5e7e008a27464d9b87` | update |
+| `rapp-postgres` | `2b7fe861f984f8539ca63ede662fe5719ace895a` | update |
+| `rapp-qonto` | `240c462b9412a3932cc27dbbc13933378f4af07e` | update |
+| `rapp-sbom-nexus` | `1566bcf69fc0757db5efc67f78b14af10d944c1b` | no-op |
+| `rapp-tenant-engine` | `70a6dc3113b4da070690bf6e7a21c2bac67e2004` | no-op |
+| `rapp-user-engine` | `608690d80d63cc373af17d387af29adec8a53c7b` | update |
+
+Each commit was then reconciled through the guarded primary-only
+`POST /repos/{slug}/work-record-projection/reconcile` API with
+`acknowledge_retirements: false`. A second rolled-back review returned
+`noop: 9`, with zero errors and every change count at zero.
+
+No token value, credential-bearing URL, or private preflight artifact was
+printed or stored in this evidence.
diff --git a/docs/evidence/STATE-WP-0085-T07-repository-rename-recovery-matrix.md b/docs/evidence/STATE-WP-0085-T07-repository-rename-recovery-matrix.md
new file mode 100644
index 0000000..3721cb8
--- /dev/null
+++ b/docs/evidence/STATE-WP-0085-T07-repository-rename-recovery-matrix.md
@@ -0,0 +1,70 @@
+# Repository rename recovery and continuity matrix
+
+Work item: `STATE-WP-0085-T07`
+Scope: State Hub lifecycle only; no live `flex-auth`/`access-engine` mutation.
+
+## Automated recovery matrix
+
+| Hazard | Automated proof | Required result |
+| --- | --- | --- |
+| Interruption/failure after every forward phase | `test_every_forward_phase_failure_is_retry_safe`; `test_interrupt_resume_every_phase_and_preserve_uuid` | Journal remains at the last achieved phase; retry resumes the same operation UUID. |
+| Stale preflight/head | `test_stale_head_wrong_id_target_conflict_and_queued_writes_fail_closed` | Operation creation fails before mutation. |
+| Double submission | `test_client_operation_id_is_idempotent_and_globally_discoverable` | Same intent and operation UUID returns `no_op`; changed intent fails closed. |
+| Conflicting target rename | `test_stale_head_wrong_id_target_conflict_and_queued_writes_fail_closed` | Claimed Forge/State Hub target blocks preflight. |
+| Forge redirect | `test_redirected_forge_and_wrong_fresh_clone_identity_fail_closed_then_resume` | A redirected lookup cannot masquerade as the requested coordinate. |
+| Old slug unavailable during rollback | `test_rollback_recovers_when_old_statehub_slug_temporarily_unavailable` | Failure is journaled; restoring the protected route permits a safe retry after the external Forge rollback already committed. |
+| State Hub outage | `test_state_hub_outage_fails_without_losing_operation_identity_or_leaking_secrets` | CLI reports `state_hub_unavailable`; the client-owned operation ID remains the recovery key. |
+| Edge outbox replay | `test_message_history_is_immutable_and_old_slug_write_replays_once`; edge outbox/relay suites | Old-slug write canonicalizes and persists exactly once under its idempotency key. |
+| Unreadable private repository | `test_expired_token_bad_confirmation_and_unreadable_forge_fail_closed` | Preflight is unsafe and no token is issued. |
+| Fresh clone has wrong immutable Forge ID | `test_redirected_forge_and_wrong_fresh_clone_identity_fail_closed_then_resume` | `source-synced` fails, journals the failure, and succeeds only with matching repository ID and head. |
+
+## Continuity proof
+
+`collect_continuity_baseline` records both identity lists and immutable
+relationship tuples. Each record family has a `relationship_checksum`; token
+events additionally record input, output, cached-input, reasoning-output, and
+raw totals. Verification recomputes the relationships for every baseline ID,
+permits append-only records, and fails when an original ID is missing or any
+repository/workplan/task/snapshot binding changes.
+
+The matrix covers repository identity, workplans, tasks, progress, decisions,
+token events and totals, SBOM snapshots and entries, active dispatch, protected
+slug routes, historical messages, and workplan file bindings. Alias verification
+is phase-aware because the intended mutation changes the old route from
+`canonical` to `alias`; all work-record and telemetry relationships remain
+unchanged.
+
+`test_equal_counts_do_not_hide_detached_work_and_telemetry` deliberately moves
+an original workplan and token event to another repository, inserts replacements
+with identical counts and token totals, and proves verification still fails.
+
+## Operational evidence
+
+The durable operation journal exposes:
+
+- phase attempt counts and durations in milliseconds;
+- total retries and failures plus failures by phase;
+- rollback attempts and outcome;
+- verification outcome;
+- the last failure code, without operator evidence or credentials.
+
+Credential-free NATS events publish phase, failure, verification, rollback, and
+completion outcomes. Event payloads contain immutable IDs, coordinate names,
+the expected source commit, metrics, and an operation evidence reference. They
+never include preflight tokens, supplied operator evidence, authorization data,
+remote URLs, or error details.
+
+## Reproduction
+
+```bash
+.venv/bin/pytest -q \
+  tests/test_repository_rename_api.py \
+  tests/test_repository_rename_cli.py \
+  tests/test_repository_alias_routing.py \
+  tests/test_edge_outbox.py \
+  tests/test_edge_relay.py
+```
+
+Run the full repository suite before accepting this work item. Record the final
+test count and revision in the workplan result rather than editing this matrix
+with transient local values.
diff --git a/docs/evidence/STATE-WP-0088-independent-signing-verification-20260905.json b/docs/evidence/STATE-WP-0088-independent-signing-verification-20260905.json
new file mode 100644
index 0000000..1454736
--- /dev/null
+++ b/docs/evidence/STATE-WP-0088-independent-signing-verification-20260905.json
@@ -0,0 +1,21 @@
+{
+  "schema": "state-hub.signing-runtime-acceptance.v1",
+  "health": "passed",
+  "signed_preflight": true,
+  "replicas": 1,
+  "secret_resource_version": "57239554",
+  "pods": [
+    {
+      "pod_uid": "cff7074b-5d15-40b9-8c14-68c1c3ab05c3",
+      "accepted_key_version": true,
+      "predecessor_rejected": true
+    }
+  ],
+  "repository_mutations": 0,
+  "date": "2026-09-05",
+  "task": "STATE-WP-0088-T02",
+  "platform_task": "RPF-WP-0035-T04",
+  "verified_kv_version": 2,
+  "predecessor_rejection": "signature; expiry alone is rejected by the verifier",
+  "platform_evidence": "railiance-platform/docs/evidence/RPF-WP-0035-T04-signing-activation-2026-09-05.json"
+}
diff --git a/docs/evidence/legacy-meter-weekly-review-20260712.json b/docs/evidence/legacy-meter-weekly-review-20260712.json
index 49b8eb7..8a49779 100644
--- a/docs/evidence/legacy-meter-weekly-review-20260712.json
+++ b/docs/evidence/legacy-meter-weekly-review-20260712.json
@@ -1,29 +1,12 @@
 {
-  "captured_at": "2026-07-11T23:07:21.434523+00:00",
+  "captured_at": "2026-07-12T14:00:09.343613+00:00",
   "api_base": "http://127.0.0.1:8000",
   "workplan": "STATE-WP-0070",
-  "retired_interfaces": [
-    {
-      "id": "8051fb40-66c9-4dc4-a413-13e8573e04a3",
-      "interface_key": "event_subject:org.statehub.workstream.completed",
-      "interface_kind": "event_subject",
-      "legacy_since": "2026-06-04T06:09:42.198193Z",
-      "replacement_ref": "org.statehub.workplan.completed",
-      "owner_component": "state-hub.events",
-      "status": "retired",
-      "replacement_verified": true,
-      "manual_hold": false,
-      "hold_reason": null,
-      "notes": "Retired by STATE-WP-0069 closeout",
-      "retired_at": "2026-07-08T21:38:52.773601Z",
-      "created_at": "2026-06-04T06:09:42.198193Z",
-      "updated_at": "2026-07-08T21:38:52.761243Z"
-    }
-  ],
+  "retired_interfaces": [],
   "weekly_review": {
-    "generated_at": "2026-07-11T23:07:21.408590Z",
-    "window_start": "2026-07-11T15:07:21.328695Z",
-    "window_end": "2026-07-11T23:07:21.328695Z",
+    "generated_at": "2026-07-12T14:00:09.336673Z",
+    "window_start": "2026-07-12T06:00:08.911717Z",
+    "window_end": "2026-07-12T14:00:08.911717Z",
     "cadence": "weekly",
     "activity_core_handoff": {
       "activity_id": "statehub-legacy-interface-review",
diff --git a/docs/evidence/legacy-meter-weekly-review-20260713.json b/docs/evidence/legacy-meter-weekly-review-20260713.json
new file mode 100644
index 0000000..126308a
--- /dev/null
+++ b/docs/evidence/legacy-meter-weekly-review-20260713.json
@@ -0,0 +1,1665 @@
+{
+  "captured_at": "2026-07-12T22:00:01.424861+00:00",
+  "api_base": "http://127.0.0.1:8000",
+  "workplan": "STATE-WP-0070",
+  "retired_interfaces": [],
+  "weekly_review": {
+    "generated_at": "2026-07-12T22:00:01.418415Z",
+    "window_start": "2026-07-12T14:00:01.350670Z",
+    "window_end": "2026-07-12T22:00:01.350670Z",
+    "cadence": "weekly",
+    "activity_core_handoff": {
+      "activity_id": "statehub-legacy-interface-review",
+      "cadence": "weekly",
+      "source_endpoint": "/legacy-meter/weekly-review",
+      "state_owner": "state-hub",
+      "scheduler_owner": "activity-core"
+    },
+    "interfaces": [
+      {
+        "interface": {
+          "id": "8051fb40-66c9-4dc4-a413-13e8573e04a3",
+          "interface_key": "event_subject:org.statehub.workstream.completed",
+          "interface_kind": "event_subject",
+          "legacy_since": "2026-06-04T06:09:42.198193Z",
+          "replacement_ref": "org.statehub.workplan.completed",
+          "owner_component": "state-hub.events",
+          "status": "retired",
+          "replacement_verified": true,
+          "manual_hold": false,
+          "hold_reason": null,
+          "notes": "Retired by STATE-WP-0069 closeout",
+          "retired_at": "2026-07-08T21:38:52.773601Z",
+          "created_at": "2026-06-04T06:09:42.198193Z",
+          "updated_at": "2026-07-08T21:38:52.761243Z"
+        },
+        "all_time": {
+          "calls": 255,
+          "tenant_count": 1,
+          "user_count": 1,
+          "component_count": 1,
+          "tenants": {
+            "unknown": 255
+          },
+          "users": {
+            "unknown": 255
+          },
+          "components": {
+            "state-hub.events": 255
+          }
+        },
+        "window": {
+          "calls": 0,
+          "tenant_count": 0,
+          "user_count": 0,
+          "component_count": 0,
+          "tenants": {},
+          "users": {},
+          "components": {}
+        },
+        "last_seen_at": "2026-07-08T20:49:12.839383Z",
+        "retirement_candidate": false,
+        "retirement_reason": "already retired"
+      },
+      {
+        "interface": {
+          "id": "63ed90e3-42b4-431a-94db-e1254a52f9e2",
+          "interface_key": "mcp:create_workstream",
+          "interface_kind": "mcp_tool",
+          "legacy_since": "2026-07-10T13:19:44.205900Z",
+          "replacement_ref": "create_workplan",
+          "owner_component": "state-hub.mcp",
+          "status": "legacy",
+          "replacement_verified": true,
+          "manual_hold": false,
+          "hold_reason": null,
+          "notes": "Registered by STATE-WP-0070 T03 \u2014 zero-window streak starts at registration",
+          "retired_at": null,
+          "created_at": "2026-07-10T13:19:44.205900Z",
+          "updated_at": "2026-07-10T13:19:44.205900Z"
+        },
+        "all_time": {
+          "calls": 2,
+          "tenant_count": 1,
+          "user_count": 1,
+          "component_count": 1,
+          "tenants": {
+            "unknown": 2
+          },
+          "users": {
+            "unknown": 2
+          },
+          "components": {
+            "state-hub.mcp": 2
+          }
+        },
+        "window": {
+          "calls": 0,
+          "tenant_count": 0,
+          "user_count": 0,
+          "component_count": 0,
+          "tenants": {},
+          "users": {},
+          "components": {}
+        },
+        "last_seen_at": "2026-07-10T13:20:43.378546Z",
+        "retirement_candidate": true,
+        "retirement_reason": "no measured usage in review window"
+      },
+      {
+        "interface": {
+          "id": "b6a5fe44-fb85-4ef7-a273-78d09da777af",
+          "interface_key": "mcp:list_workstreams",
+          "interface_kind": "mcp_tool",
+          "legacy_since": "2026-07-10T13:19:26.075491Z",
+          "replacement_ref": "list_workplans",
+          "owner_component": "state-hub.mcp",
+          "status": "legacy",
+          "replacement_verified": true,
+          "manual_hold": false,
+          "hold_reason": null,
+          "notes": null,
+          "retired_at": null,
+          "created_at": "2026-07-10T13:19:26.075491Z",
+          "updated_at": "2026-07-10T13:19:26.075491Z"
+        },
+        "all_time": {
+          "calls": 2,
+          "tenant_count": 1,
+          "user_count": 1,
+          "component_count": 1,
+          "tenants": {
+            "unknown": 2
+          },
+          "users": {
+            "unknown": 2
+          },
+          "components": {
+            "state-hub.mcp": 2
+          }
+        },
+        "window": {
+          "calls": 0,
+          "tenant_count": 0,
+          "user_count": 0,
+          "component_count": 0,
+          "tenants": {},
+          "users": {},
+          "components": {}
+        },
+        "last_seen_at": "2026-07-10T13:20:42.374940Z",
+        "retirement_candidate": true,
+        "retirement_reason": "no measured usage in review window"
+      },
+      {
+        "interface": {
+          "id": "53c3372b-307d-4d6a-8ea4-bc36cacdcaf2",
+          "interface_key": "mcp:update_workstream",
+          "interface_kind": "mcp_tool",
+          "legacy_since": "2026-07-10T13:19:44.255216Z",
+          "replacement_ref": "update_workplan",
+          "owner_component": "state-hub.mcp",
+          "status": "legacy",
+          "replacement_verified": true,
+          "manual_hold": false,
+          "hold_reason": null,
+          "notes": "Registered by STATE-WP-0070 T03 \u2014 zero-window streak starts at registration",
+          "retired_at": null,
+          "created_at": "2026-07-10T13:19:44.255216Z",
+          "updated_at": "2026-07-10T13:19:44.255216Z"
+        },
+        "all_time": {
+          "calls": 0,
+          "tenant_count": 0,
+          "user_count": 0,
+          "component_count": 0,
+          "tenants": {},
+          "users": {},
+          "components": {}
+        },
+        "window": {
+          "calls": 0,
+          "tenant_count": 0,
+          "user_count": 0,
+          "component_count": 0,
+          "tenants": {},
+          "users": {},
+          "components": {}
+        },
+        "last_seen_at": null,
+        "retirement_candidate": true,
+        "retirement_reason": "no measured usage in review window"
+      },
+      {
+        "interface": {
+          "id": "bed4d08a-3471-48f5-9f0e-f9d550383a26",
+          "interface_key": "mcp:update_workstream_status",
+          "interface_kind": "mcp_tool",
+          "legacy_since": "2026-07-10T13:19:44.303612Z",
+          "replacement_ref": "update_workplan_status",
+          "owner_component": "state-hub.mcp",
+          "status": "legacy",
+          "replacement_verified": true,
+          "manual_hold": false,
+          "hold_reason": null,
+          "notes": "Registered by STATE-WP-0070 T03 \u2014 zero-window streak starts at registration",
+          "retired_at": null,
+          "created_at": "2026-07-10T13:19:44.303612Z",
+          "updated_at": "2026-07-10T13:19:44.303612Z"
+        },
+        "all_time": {
+          "calls": 0,
+          "tenant_count": 0,
+          "user_count": 0,
+          "component_count": 0,
+          "tenants": {},
+          "users": {},
+          "components": {}
+        },
+        "window": {
+          "calls": 0,
+          "tenant_count": 0,
+          "user_count": 0,
+          "component_count": 0,
+          "tenants": {},
+          "users": {},
+          "components": {}
+        },
+        "last_seen_at": null,
+        "retirement_candidate": true,
+        "retirement_reason": "no measured usage in review window"
+      },
+      {
+        "interface": {
+          "id": "46900dc2-0893-405b-ba59-80f31fb6ebb1",
+          "interface_key": "state://workstreams/{topic_slug}",
+          "interface_kind": "mcp_tool",
+          "legacy_since": "2026-07-10T13:19:44.344493Z",
+          "replacement_ref": "state://workplans/{topic_slug}",
+          "owner_component": "state-hub.mcp",
+          "status": "legacy",
+          "replacement_verified": true,
+          "manual_hold": false,
+          "hold_reason": null,
+          "notes": "Registered by STATE-WP-0070 T03 \u2014 zero-window streak starts at registration",
+          "retired_at": null,
+          "created_at": "2026-07-10T13:19:44.344493Z",
+          "updated_at": "2026-07-10T13:19:44.344493Z"
+        },
+        "all_time": {
+          "calls": 1,
+          "tenant_count": 1,
+          "user_count": 1,
+          "component_count": 1,
+          "tenants": {
+            "unknown": 1
+          },
+          "users": {
+            "unknown": 1
+          },
+          "components": {
+            "state-hub.mcp": 1
+          }
+        },
+        "window": {
+          "calls": 0,
+          "tenant_count": 0,
+          "user_count": 0,
+          "component_count": 0,
+          "tenants": {},
+          "users": {},
+          "components": {}
+        },
+        "last_seen_at": "2026-07-10T13:20:34.491811Z",
+        "retirement_candidate": true,
+        "retirement_reason": "no measured usage in review window"
+      },
+      {
+        "interface": {
+          "id": "cd9342fd-27e7-4a46-a1be-d41499e106a3",
+          "interface_key": "rest_api:DELETE /workstreams/{workstream_id}",
+          "interface_kind": "rest_api",
+          "legacy_since": "2026-06-06T17:28:13.052813Z",
+          "replacement_ref": "/workplans/{workplan_id}",
+          "owner_component": "state-hub.api",
+          "status": "legacy",
+          "replacement_verified": true,
+          "manual_hold": false,
+          "hold_reason": null,
+          "notes": null,
+          "retired_at": null,
+          "created_at": "2026-06-06T17:28:13.052813Z",
+          "updated_at": "2026-06-06T17:28:13.052813Z"
+        },
+        "all_time": {
+          "calls": 1,
+          "tenant_count": 1,
+          "user_count": 1,
+          "component_count": 1,
+          "tenants": {
+            "unknown": 1
+          },
+          "users": {
+            "unknown": 1
+          },
+          "components": {
+            "unknown": 1
+          }
+        },
+        "window": {
+          "calls": 0,
+          "tenant_count": 0,
+          "user_count": 0,
+          "component_count": 0,
+          "tenants": {},
+          "users": {},
+          "components": {}
+        },
+        "last_seen_at": "2026-06-06T17:28:13.047529Z",
+        "retirement_candidate": true,
+        "retirement_reason": "no measured usage in review window"
+      },
+      {
+        "interface": {
+          "id": "a4e0948c-cd4a-461e-8ae2-7fd7b51d04a7",
+          "interface_key": "rest_api:GET /decisions/?workstream_id",
+          "interface_kind": "rest_api",
+          "legacy_since": "2026-07-09T23:07:53.093223Z",
+          "replacement_ref": "/decisions/?workplan_id=<workplan_id>",
+          "owner_component": "state-hub.api",
+          "status": "legacy",
+          "replacement_verified": true,
+          "manual_hold": false,
+          "hold_reason": null,
+          "notes": null,
+          "retired_at": null,
+          "created_at": "2026-07-09T23:07:53.093223Z",
+          "updated_at": "2026-07-09T23:07:53.093223Z"
+        },
+        "all_time": {
+          "calls": 1,
+          "tenant_count": 1,
+          "user_count": 1,
+          "component_count": 1,
+          "tenants": {
+            "unknown": 1
+          },
+          "users": {
+            "unknown": 1
+          },
+          "components": {
+            "unknown": 1
+          }
+        },
+        "window": {
+          "calls": 0,
+          "tenant_count": 0,
+          "user_count": 0,
+          "component_count": 0,
+          "tenants": {},
+          "users": {},
+          "components": {}
+        },
+        "last_seen_at": "2026-07-09T23:07:53.083299Z",
+        "retirement_candidate": true,
+        "retirement_reason": "no measured usage in review window"
+      },
+      {
+        "interface": {
+          "id": "be3cdcf8-250b-4bf0-801f-02ffd5f57e00",
+          "interface_key": "rest_api:GET /tasks/?workstream_id",
+          "interface_kind": "rest_api",
+          "legacy_since": "2026-07-08T19:32:21.628513Z",
+          "replacement_ref": "/tasks/?workplan_id=<workplan_id>",
+          "owner_component": "state-hub.api",
+          "status": "legacy",
+          "replacement_verified": true,
+          "manual_hold": false,
+          "hold_reason": null,
+          "notes": null,
+          "retired_at": null,
+          "created_at": "2026-07-08T19:32:21.628513Z",
+          "updated_at": "2026-07-08T19:32:21.628513Z"
+        },
+        "all_time": {
+          "calls": 577,
+          "tenant_count": 1,
+          "user_count": 1,
+          "component_count": 1,
+          "tenants": {
+            "unknown": 577
+          },
+          "users": {
+            "unknown": 577
+          },
+          "components": {
+            "unknown": 577
+          }
+        },
+        "window": {
+          "calls": 0,
+          "tenant_count": 0,
+          "user_count": 0,
+          "component_count": 0,
+          "tenants": {},
+          "users": {},
+          "components": {}
+        },
+        "last_seen_at": "2026-07-08T21:38:17.035426Z",
+        "retirement_candidate": true,
+        "retirement_reason": "no measured usage in review window"
+      },
+      {
+        "interface": {
+          "id": "3e4a3d0b-08fa-45c3-91e2-4f514a914b97",
+          "interface_key": "rest_api:GET /workstreams/",
+          "interface_kind": "rest_api",
+          "legacy_since": "2026-06-04T00:26:14.533764Z",
+          "replacement_ref": "/workplans/",
+          "owner_component": "state-hub.api",
+          "status": "legacy",
+          "replacement_verified": true,
+          "manual_hold": false,
+          "hold_reason": null,
+          "notes": null,
+          "retired_at": null,
+          "created_at": "2026-06-04T00:26:14.533764Z",
+          "updated_at": "2026-06-04T00:26:14.533764Z"
+        },
+        "all_time": {
+          "calls": 144084,
+          "tenant_count": 1,
+          "user_count": 1,
+          "component_count": 1,
+          "tenants": {
+            "unknown": 144084
+          },
+          "users": {
+            "unknown": 144084
+          },
+          "components": {
+            "unknown": 144084
+          }
+        },
+        "window": {
+          "calls": 0,
+          "tenant_count": 0,
+          "user_count": 0,
+          "component_count": 0,
+          "tenants": {},
+          "users": {},
+          "components": {}
+        },
+        "last_seen_at": "2026-07-08T21:14:39.652776Z",
+        "retirement_candidate": true,
+        "retirement_reason": "no measured usage in review window"
+      },
+      {
+        "interface": {
+          "id": "e4c140ec-7479-46f9-b185-4b533f19d639",
+          "interface_key": "rest_api:GET /workstreams/workplan-index",
+          "interface_kind": "rest_api",
+          "legacy_since": "2026-06-04T05:20:58.321869Z",
+          "replacement_ref": "/workplans/index",
+          "owner_component": "state-hub.api",
+          "status": "legacy",
+          "replacement_verified": true,
+          "manual_hold": false,
+          "hold_reason": null,
+          "notes": null,
+          "retired_at": null,
+          "created_at": "2026-06-04T05:20:58.321869Z",
+          "updated_at": "2026-06-04T05:20:58.321869Z"
+        },
+        "all_time": {
+          "calls": 30,
+          "tenant_count": 1,
+          "user_count": 1,
+          "component_count": 1,
+          "tenants": {
+            "unknown": 30
+          },
+          "users": {
+            "unknown": 30
+          },
+          "components": {
+            "unknown": 30
+          }
+        },
+        "window": {
+          "calls": 0,
+          "tenant_count": 0,
+          "user_count": 0,
+          "component_count": 0,
+          "tenants": {},
+          "users": {},
+          "components": {}
+        },
+        "last_seen_at": "2026-07-03T05:20:34.534439Z",
+        "retirement_candidate": true,
+        "retirement_reason": "no measured usage in review window"
+      },
+      {
+        "interface": {
+          "id": "3a00b19e-e7db-4403-98aa-a77c9ab61ecc",
+          "interface_key": "rest_api:GET /workstreams/{workstream_id}",
+          "interface_kind": "rest_api",
+          "legacy_since": "2026-06-04T00:25:59.014966Z",
+          "replacement_ref": "/workplans/{workplan_id}",
+          "owner_component": "state-hub.api",
+          "status": "legacy",
+          "replacement_verified": true,
+          "manual_hold": false,
+          "hold_reason": null,
+          "notes": null,
+          "retired_at": null,
+          "created_at": "2026-06-04T00:25:59.014966Z",
+          "updated_at": "2026-06-04T00:25:59.014966Z"
+        },
+        "all_time": {
+          "calls": 511405,
+          "tenant_count": 1,
+          "user_count": 1,
+          "component_count": 1,
+          "tenants": {
+            "unknown": 511405
+          },
+          "users": {
+            "unknown": 511405
+          },
+          "components": {
+            "unknown": 511405
+          }
+        },
+        "window": {
+          "calls": 0,
+          "tenant_count": 0,
+          "user_count": 0,
+          "component_count": 0,
+          "tenants": {},
+          "users": {},
+          "components": {}
+        },
+        "last_seen_at": "2026-07-08T21:14:20.781103Z",
+        "retirement_candidate": true,
+        "retirement_reason": "no measured usage in review window"
+      },
+      {
+        "interface": {
+          "id": "69e1a255-a8b9-4101-8a68-b1bed23abfda",
+          "interface_key": "rest_api:GET /workstreams/{workstream_id}/dependencies/",
+          "interface_kind": "rest_api",
+          "legacy_since": "2026-06-04T00:25:59.291135Z",
+          "replacement_ref": "/workplans/{workplan_id}/dependencies/",
+          "owner_component": "state-hub.api",
+          "status": "legacy",
+          "replacement_verified": true,
+          "manual_hold": false,
+          "hold_reason": null,
+          "notes": null,
+          "retired_at": null,
+          "created_at": "2026-06-04T00:25:59.291135Z",
+          "updated_at": "2026-06-04T00:25:59.291135Z"
+        },
+        "all_time": {
+          "calls": 255865,
+          "tenant_count": 1,
+          "user_count": 1,
+          "component_count": 1,
+          "tenants": {
+            "unknown": 255865
+          },
+          "users": {
+            "unknown": 255865
+          },
+          "components": {
+            "unknown": 255865
+          }
+        },
+        "window": {
+          "calls": 0,
+          "tenant_count": 0,
+          "user_count": 0,
+          "component_count": 0,
+          "tenants": {},
+          "users": {},
+          "components": {}
+        },
+        "last_seen_at": "2026-07-08T21:14:12.747005Z",
+        "retirement_candidate": true,
+        "retirement_reason": "no measured usage in review window"
+      },
+      {
+        "interface": {
+          "id": "b1aae931-b51f-4a85-a723-865dd65f6132",
+          "interface_key": "rest_api:PATCH /workstreams/{workstream_id}",
+          "interface_kind": "rest_api",
+          "legacy_since": "2026-06-04T06:09:41.901035Z",
+          "replacement_ref": "/workplans/{workplan_id}",
+          "owner_component": "state-hub.api",
+          "status": "legacy",
+          "replacement_verified": true,
+          "manual_hold": false,
+          "hold_reason": null,
+          "notes": null,
+          "retired_at": null,
+          "created_at": "2026-06-04T06:09:41.901035Z",
+          "updated_at": "2026-06-04T06:09:41.901035Z"
+        },
+        "all_time": {
+          "calls": 571,
+          "tenant_count": 1,
+          "user_count": 1,
+          "component_count": 1,
+          "tenants": {
+            "unknown": 571
+          },
+          "users": {
+            "unknown": 571
+          },
+          "components": {
+            "unknown": 571
+          }
+        },
+        "window": {
+          "calls": 0,
+          "tenant_count": 0,
+          "user_count": 0,
+          "component_count": 0,
+          "tenants": {},
+          "users": {},
+          "components": {}
+        },
+        "last_seen_at": "2026-07-08T20:49:12.335710Z",
+        "retirement_candidate": true,
+        "retirement_reason": "no measured usage in review window"
+      },
+      {
+        "interface": {
+          "id": "4aea9591-970b-4918-ac4a-4da95a0a1a8c",
+          "interface_key": "rest_api:POST /decisions/ workstream_id",
+          "interface_kind": "rest_api",
+          "legacy_since": "2026-07-09T22:56:35.473130Z",
+          "replacement_ref": "POST /decisions/ with workplan_id",
+          "owner_component": "state-hub.api",
+          "status": "legacy",
+          "replacement_verified": true,
+          "manual_hold": false,
+          "hold_reason": null,
+          "notes": null,
+          "retired_at": null,
+          "created_at": "2026-07-09T22:56:35.473130Z",
+          "updated_at": "2026-07-09T22:56:35.473130Z"
+        },
+        "all_time": {
+          "calls": 3,
+          "tenant_count": 1,
+          "user_count": 1,
+          "component_count": 1,
+          "tenants": {
+            "unknown": 3
+          },
+          "users": {
+            "unknown": 3
+          },
+          "components": {
+            "unknown": 3
+          }
+        },
+        "window": {
+          "calls": 0,
+          "tenant_count": 0,
+          "user_count": 0,
+          "component_count": 0,
+          "tenants": {},
+          "users": {},
+          "components": {}
+        },
+        "last_seen_at": "2026-07-09T22:57:05.912456Z",
+        "retirement_candidate": true,
+        "retirement_reason": "no measured usage in review window"
+      },
+      {
+        "interface": {
+          "id": "4a70583c-1e41-4ec1-99a9-728856a7d79c",
+          "interface_key": "rest_api:POST /progress/ workstream_id",
+          "interface_kind": "rest_api",
+          "legacy_since": "2026-07-08T23:35:09.148333Z",
+          "replacement_ref": "POST /progress/ with workplan_id",
+          "owner_component": "state-hub.api",
+          "status": "legacy",
+          "replacement_verified": true,
+          "manual_hold": false,
+          "hold_reason": null,
+          "notes": null,
+          "retired_at": null,
+          "created_at": "2026-07-08T23:35:09.148333Z",
+          "updated_at": "2026-07-08T23:35:09.148333Z"
+        },
+        "all_time": {
+          "calls": 14,
+          "tenant_count": 1,
+          "user_count": 1,
+          "component_count": 1,
+          "tenants": {
+            "unknown": 14
+          },
+          "users": {
+            "unknown": 14
+          },
+          "components": {
+            "unknown": 14
+          }
+        },
+        "window": {
+          "calls": 0,
+          "tenant_count": 0,
+          "user_count": 0,
+          "component_count": 0,
+          "tenants": {},
+          "users": {},
+          "components": {}
+        },
+        "last_seen_at": "2026-07-10T08:34:42.959724Z",
+        "retirement_candidate": true,
+        "retirement_reason": "no measured usage in review window"
+      },
+      {
+        "interface": {
+          "id": "6df4e443-7bf1-461a-923b-a6eb52fe7b07",
+          "interface_key": "rest_api:POST /tasks/ workstream_id",
+          "interface_kind": "rest_api",
+          "legacy_since": "2026-07-08T22:38:29.405720Z",
+          "replacement_ref": "POST /tasks/ with workplan_id",
+          "owner_component": "state-hub.api",
+          "status": "legacy",
+          "replacement_verified": true,
+          "manual_hold": false,
+          "hold_reason": null,
+          "notes": null,
+          "retired_at": null,
+          "created_at": "2026-07-08T22:38:29.405720Z",
+          "updated_at": "2026-07-08T22:38:29.405720Z"
+        },
+        "all_time": {
+          "calls": 5,
+          "tenant_count": 1,
+          "user_count": 1,
+          "component_count": 1,
+          "tenants": {
+            "unknown": 5
+          },
+          "users": {
+            "unknown": 5
+          },
+          "components": {
+            "state-hub.fix-consistency": 5
+          }
+        },
+        "window": {
+          "calls": 0,
+          "tenant_count": 0,
+          "user_count": 0,
+          "component_count": 0,
+          "tenants": {},
+          "users": {},
+          "components": {}
+        },
+        "last_seen_at": "2026-07-08T22:38:29.976918Z",
+        "retirement_candidate": true,
+        "retirement_reason": "no measured usage in review window"
+      },
+      {
+        "interface": {
+          "id": "ed6451c9-d2cc-4486-9afe-d3852782cabc",
+          "interface_key": "rest_api:POST /workstreams/",
+          "interface_kind": "rest_api",
+          "legacy_since": "2026-06-04T07:40:24.168535Z",
+          "replacement_ref": "/workplans/",
+          "owner_component": "state-hub.api",
+          "status": "legacy",
+          "replacement_verified": true,
+          "manual_hold": false,
+          "hold_reason": null,
+          "notes": null,
+          "retired_at": null,
+          "created_at": "2026-06-04T07:40:24.168535Z",
+          "updated_at": "2026-06-04T07:40:24.168535Z"
+        },
+        "all_time": {
+          "calls": 824,
+          "tenant_count": 1,
+          "user_count": 1,
+          "component_count": 1,
+          "tenants": {
+            "unknown": 824
+          },
+          "users": {
+            "unknown": 824
+          },
+          "components": {
+            "unknown": 824
+          }
+        },
+        "window": {
+          "calls": 0,
+          "tenant_count": 0,
+          "user_count": 0,
+          "component_count": 0,
+          "tenants": {},
+          "users": {},
+          "components": {}
+        },
+        "last_seen_at": "2026-07-08T20:38:05.903144Z",
+        "retirement_candidate": true,
+        "retirement_reason": "no measured usage in review window"
+      },
+      {
+        "interface": {
+          "id": "281fd706-b192-4194-8055-2d8733c115f9",
+          "interface_key": "rest_api:POST /workstreams/{workstream_id}/dependencies/",
+          "interface_kind": "rest_api",
+          "legacy_since": "2026-06-04T22:57:37.149207Z",
+          "replacement_ref": "/workplans/{workplan_id}/dependencies/",
+          "owner_component": "state-hub.api",
+          "status": "legacy",
+          "replacement_verified": true,
+          "manual_hold": false,
+          "hold_reason": null,
+          "notes": null,
+          "retired_at": null,
+          "created_at": "2026-06-04T22:57:37.149207Z",
+          "updated_at": "2026-06-04T22:57:37.149207Z"
+        },
+        "all_time": {
+          "calls": 4971,
+          "tenant_count": 1,
+          "user_count": 1,
+          "component_count": 1,
+          "tenants": {
+            "unknown": 4971
+          },
+          "users": {
+            "unknown": 4971
+          },
+          "components": {
+            "unknown": 4971
+          }
+        },
+        "window": {
+          "calls": 0,
+          "tenant_count": 0,
+          "user_count": 0,
+          "component_count": 0,
+          "tenants": {},
+          "users": {},
+          "components": {}
+        },
+        "last_seen_at": "2026-07-01T22:09:24.229011Z",
+        "retirement_candidate": true,
+        "retirement_reason": "no measured usage in review window"
+      }
+    ],
+    "retirement_candidates": [
+      {
+        "interface": {
+          "id": "63ed90e3-42b4-431a-94db-e1254a52f9e2",
+          "interface_key": "mcp:create_workstream",
+          "interface_kind": "mcp_tool",
+          "legacy_since": "2026-07-10T13:19:44.205900Z",
+          "replacement_ref": "create_workplan",
+          "owner_component": "state-hub.mcp",
+          "status": "legacy",
+          "replacement_verified": true,
+          "manual_hold": false,
+          "hold_reason": null,
+          "notes": "Registered by STATE-WP-0070 T03 \u2014 zero-window streak starts at registration",
+          "retired_at": null,
+          "created_at": "2026-07-10T13:19:44.205900Z",
+          "updated_at": "2026-07-10T13:19:44.205900Z"
+        },
+        "all_time": {
+          "calls": 2,
+          "tenant_count": 1,
+          "user_count": 1,
+          "component_count": 1,
+          "tenants": {
+            "unknown": 2
+          },
+          "users": {
+            "unknown": 2
+          },
+          "components": {
+            "state-hub.mcp": 2
+          }
+        },
+        "window": {
+          "calls": 0,
+          "tenant_count": 0,
+          "user_count": 0,
+          "component_count": 0,
+          "tenants": {},
+          "users": {},
+          "components": {}
+        },
+        "last_seen_at": "2026-07-10T13:20:43.378546Z",
+        "retirement_candidate": true,
+        "retirement_reason": "no measured usage in review window"
+      },
+      {
+        "interface": {
+          "id": "b6a5fe44-fb85-4ef7-a273-78d09da777af",
+          "interface_key": "mcp:list_workstreams",
+          "interface_kind": "mcp_tool",
+          "legacy_since": "2026-07-10T13:19:26.075491Z",
+          "replacement_ref": "list_workplans",
+          "owner_component": "state-hub.mcp",
+          "status": "legacy",
+          "replacement_verified": true,
+          "manual_hold": false,
+          "hold_reason": null,
+          "notes": null,
+          "retired_at": null,
+          "created_at": "2026-07-10T13:19:26.075491Z",
+          "updated_at": "2026-07-10T13:19:26.075491Z"
+        },
+        "all_time": {
+          "calls": 2,
+          "tenant_count": 1,
+          "user_count": 1,
+          "component_count": 1,
+          "tenants": {
+            "unknown": 2
+          },
+          "users": {
+            "unknown": 2
+          },
+          "components": {
+            "state-hub.mcp": 2
+          }
+        },
+        "window": {
+          "calls": 0,
+          "tenant_count": 0,
+          "user_count": 0,
+          "component_count": 0,
+          "tenants": {},
+          "users": {},
+          "components": {}
+        },
+        "last_seen_at": "2026-07-10T13:20:42.374940Z",
+        "retirement_candidate": true,
+        "retirement_reason": "no measured usage in review window"
+      },
+      {
+        "interface": {
+          "id": "53c3372b-307d-4d6a-8ea4-bc36cacdcaf2",
+          "interface_key": "mcp:update_workstream",
+          "interface_kind": "mcp_tool",
+          "legacy_since": "2026-07-10T13:19:44.255216Z",
+          "replacement_ref": "update_workplan",
+          "owner_component": "state-hub.mcp",
+          "status": "legacy",
+          "replacement_verified": true,
+          "manual_hold": false,
+          "hold_reason": null,
+          "notes": "Registered by STATE-WP-0070 T03 \u2014 zero-window streak starts at registration",
+          "retired_at": null,
+          "created_at": "2026-07-10T13:19:44.255216Z",
+          "updated_at": "2026-07-10T13:19:44.255216Z"
+        },
+        "all_time": {
+          "calls": 0,
+          "tenant_count": 0,
+          "user_count": 0,
+          "component_count": 0,
+          "tenants": {},
+          "users": {},
+          "components": {}
+        },
+        "window": {
+          "calls": 0,
+          "tenant_count": 0,
+          "user_count": 0,
+          "component_count": 0,
+          "tenants": {},
+          "users": {},
+          "components": {}
+        },
+        "last_seen_at": null,
+        "retirement_candidate": true,
+        "retirement_reason": "no measured usage in review window"
+      },
+      {
+        "interface": {
+          "id": "bed4d08a-3471-48f5-9f0e-f9d550383a26",
+          "interface_key": "mcp:update_workstream_status",
+          "interface_kind": "mcp_tool",
+          "legacy_since": "2026-07-10T13:19:44.303612Z",
+          "replacement_ref": "update_workplan_status",
+          "owner_component": "state-hub.mcp",
+          "status": "legacy",
+          "replacement_verified": true,
+          "manual_hold": false,
+          "hold_reason": null,
+          "notes": "Registered by STATE-WP-0070 T03 \u2014 zero-window streak starts at registration",
+          "retired_at": null,
+          "created_at": "2026-07-10T13:19:44.303612Z",
+          "updated_at": "2026-07-10T13:19:44.303612Z"
+        },
+        "all_time": {
+          "calls": 0,
+          "tenant_count": 0,
+          "user_count": 0,
+          "component_count": 0,
+          "tenants": {},
+          "users": {},
+          "components": {}
+        },
+        "window": {
+          "calls": 0,
+          "tenant_count": 0,
+          "user_count": 0,
+          "component_count": 0,
+          "tenants": {},
+          "users": {},
+          "components": {}
+        },
+        "last_seen_at": null,
+        "retirement_candidate": true,
+        "retirement_reason": "no measured usage in review window"
+      },
+      {
+        "interface": {
+          "id": "46900dc2-0893-405b-ba59-80f31fb6ebb1",
+          "interface_key": "state://workstreams/{topic_slug}",
+          "interface_kind": "mcp_tool",
+          "legacy_since": "2026-07-10T13:19:44.344493Z",
+          "replacement_ref": "state://workplans/{topic_slug}",
+          "owner_component": "state-hub.mcp",
+          "status": "legacy",
+          "replacement_verified": true,
+          "manual_hold": false,
+          "hold_reason": null,
+          "notes": "Registered by STATE-WP-0070 T03 \u2014 zero-window streak starts at registration",
+          "retired_at": null,
+          "created_at": "2026-07-10T13:19:44.344493Z",
+          "updated_at": "2026-07-10T13:19:44.344493Z"
+        },
+        "all_time": {
+          "calls": 1,
+          "tenant_count": 1,
+          "user_count": 1,
+          "component_count": 1,
+          "tenants": {
+            "unknown": 1
+          },
+          "users": {
+            "unknown": 1
+          },
+          "components": {
+            "state-hub.mcp": 1
+          }
+        },
+        "window": {
+          "calls": 0,
+          "tenant_count": 0,
+          "user_count": 0,
+          "component_count": 0,
+          "tenants": {},
+          "users": {},
+          "components": {}
+        },
+        "last_seen_at": "2026-07-10T13:20:34.491811Z",
+        "retirement_candidate": true,
+        "retirement_reason": "no measured usage in review window"
+      },
+      {
+        "interface": {
+          "id": "cd9342fd-27e7-4a46-a1be-d41499e106a3",
+          "interface_key": "rest_api:DELETE /workstreams/{workstream_id}",
+          "interface_kind": "rest_api",
+          "legacy_since": "2026-06-06T17:28:13.052813Z",
+          "replacement_ref": "/workplans/{workplan_id}",
+          "owner_component": "state-hub.api",
+          "status": "legacy",
+          "replacement_verified": true,
+          "manual_hold": false,
+          "hold_reason": null,
+          "notes": null,
+          "retired_at": null,
+          "created_at": "2026-06-06T17:28:13.052813Z",
+          "updated_at": "2026-06-06T17:28:13.052813Z"
+        },
+        "all_time": {
+          "calls": 1,
+          "tenant_count": 1,
+          "user_count": 1,
+          "component_count": 1,
+          "tenants": {
+            "unknown": 1
+          },
+          "users": {
+            "unknown": 1
+          },
+          "components": {
+            "unknown": 1
+          }
+        },
+        "window": {
+          "calls": 0,
+          "tenant_count": 0,
+          "user_count": 0,
+          "component_count": 0,
+          "tenants": {},
+          "users": {},
+          "components": {}
+        },
+        "last_seen_at": "2026-06-06T17:28:13.047529Z",
+        "retirement_candidate": true,
+        "retirement_reason": "no measured usage in review window"
+      },
+      {
+        "interface": {
+          "id": "a4e0948c-cd4a-461e-8ae2-7fd7b51d04a7",
+          "interface_key": "rest_api:GET /decisions/?workstream_id",
+          "interface_kind": "rest_api",
+          "legacy_since": "2026-07-09T23:07:53.093223Z",
+          "replacement_ref": "/decisions/?workplan_id=<workplan_id>",
+          "owner_component": "state-hub.api",
+          "status": "legacy",
+          "replacement_verified": true,
+          "manual_hold": false,
+          "hold_reason": null,
+          "notes": null,
+          "retired_at": null,
+          "created_at": "2026-07-09T23:07:53.093223Z",
+          "updated_at": "2026-07-09T23:07:53.093223Z"
+        },
+        "all_time": {
+          "calls": 1,
+          "tenant_count": 1,
+          "user_count": 1,
+          "component_count": 1,
+          "tenants": {
+            "unknown": 1
+          },
+          "users": {
+            "unknown": 1
+          },
+          "components": {
+            "unknown": 1
+          }
+        },
+        "window": {
+          "calls": 0,
+          "tenant_count": 0,
+          "user_count": 0,
+          "component_count": 0,
+          "tenants": {},
+          "users": {},
+          "components": {}
+        },
+        "last_seen_at": "2026-07-09T23:07:53.083299Z",
+        "retirement_candidate": true,
+        "retirement_reason": "no measured usage in review window"
+      },
+      {
+        "interface": {
+          "id": "be3cdcf8-250b-4bf0-801f-02ffd5f57e00",
+          "interface_key": "rest_api:GET /tasks/?workstream_id",
+          "interface_kind": "rest_api",
+          "legacy_since": "2026-07-08T19:32:21.628513Z",
+          "replacement_ref": "/tasks/?workplan_id=<workplan_id>",
+          "owner_component": "state-hub.api",
+          "status": "legacy",
+          "replacement_verified": true,
+          "manual_hold": false,
+          "hold_reason": null,
+          "notes": null,
+          "retired_at": null,
+          "created_at": "2026-07-08T19:32:21.628513Z",
+          "updated_at": "2026-07-08T19:32:21.628513Z"
+        },
+        "all_time": {
+          "calls": 577,
+          "tenant_count": 1,
+          "user_count": 1,
+          "component_count": 1,
+          "tenants": {
+            "unknown": 577
+          },
+          "users": {
+            "unknown": 577
+          },
+          "components": {
+            "unknown": 577
+          }
+        },
+        "window": {
+          "calls": 0,
+          "tenant_count": 0,
+          "user_count": 0,
+          "component_count": 0,
+          "tenants": {},
+          "users": {},
+          "components": {}
+        },
+        "last_seen_at": "2026-07-08T21:38:17.035426Z",
+        "retirement_candidate": true,
+        "retirement_reason": "no measured usage in review window"
+      },
+      {
+        "interface": {
+          "id": "3e4a3d0b-08fa-45c3-91e2-4f514a914b97",
+          "interface_key": "rest_api:GET /workstreams/",
+          "interface_kind": "rest_api",
+          "legacy_since": "2026-06-04T00:26:14.533764Z",
+          "replacement_ref": "/workplans/",
+          "owner_component": "state-hub.api",
+          "status": "legacy",
+          "replacement_verified": true,
+          "manual_hold": false,
+          "hold_reason": null,
+          "notes": null,
+          "retired_at": null,
+          "created_at": "2026-06-04T00:26:14.533764Z",
+          "updated_at": "2026-06-04T00:26:14.533764Z"
+        },
+        "all_time": {
+          "calls": 144084,
+          "tenant_count": 1,
+          "user_count": 1,
+          "component_count": 1,
+          "tenants": {
+            "unknown": 144084
+          },
+          "users": {
+            "unknown": 144084
+          },
+          "components": {
+            "unknown": 144084
+          }
+        },
+        "window": {
+          "calls": 0,
+          "tenant_count": 0,
+          "user_count": 0,
+          "component_count": 0,
+          "tenants": {},
+          "users": {},
+          "components": {}
+        },
+        "last_seen_at": "2026-07-08T21:14:39.652776Z",
+        "retirement_candidate": true,
+        "retirement_reason": "no measured usage in review window"
+      },
+      {
+        "interface": {
+          "id": "e4c140ec-7479-46f9-b185-4b533f19d639",
+          "interface_key": "rest_api:GET /workstreams/workplan-index",
+          "interface_kind": "rest_api",
+          "legacy_since": "2026-06-04T05:20:58.321869Z",
+          "replacement_ref": "/workplans/index",
+          "owner_component": "state-hub.api",
+          "status": "legacy",
+          "replacement_verified": true,
+          "manual_hold": false,
+          "hold_reason": null,
+          "notes": null,
+          "retired_at": null,
+          "created_at": "2026-06-04T05:20:58.321869Z",
+          "updated_at": "2026-06-04T05:20:58.321869Z"
+        },
+        "all_time": {
+          "calls": 30,
+          "tenant_count": 1,
+          "user_count": 1,
+          "component_count": 1,
+          "tenants": {
+            "unknown": 30
+          },
+          "users": {
+            "unknown": 30
+          },
+          "components": {
+            "unknown": 30
+          }
+        },
+        "window": {
+          "calls": 0,
+          "tenant_count": 0,
+          "user_count": 0,
+          "component_count": 0,
+          "tenants": {},
+          "users": {},
+          "components": {}
+        },
+        "last_seen_at": "2026-07-03T05:20:34.534439Z",
+        "retirement_candidate": true,
+        "retirement_reason": "no measured usage in review window"
+      },
+      {
+        "interface": {
+          "id": "3a00b19e-e7db-4403-98aa-a77c9ab61ecc",
+          "interface_key": "rest_api:GET /workstreams/{workstream_id}",
+          "interface_kind": "rest_api",
+          "legacy_since": "2026-06-04T00:25:59.014966Z",
+          "replacement_ref": "/workplans/{workplan_id}",
+          "owner_component": "state-hub.api",
+          "status": "legacy",
+          "replacement_verified": true,
+          "manual_hold": false,
+          "hold_reason": null,
+          "notes": null,
+          "retired_at": null,
+          "created_at": "2026-06-04T00:25:59.014966Z",
+          "updated_at": "2026-06-04T00:25:59.014966Z"
+        },
+        "all_time": {
+          "calls": 511405,
+          "tenant_count": 1,
+          "user_count": 1,
+          "component_count": 1,
+          "tenants": {
+            "unknown": 511405
+          },
+          "users": {
+            "unknown": 511405
+          },
+          "components": {
+            "unknown": 511405
+          }
+        },
+        "window": {
+          "calls": 0,
+          "tenant_count": 0,
+          "user_count": 0,
+          "component_count": 0,
+          "tenants": {},
+          "users": {},
+          "components": {}
+        },
+        "last_seen_at": "2026-07-08T21:14:20.781103Z",
+        "retirement_candidate": true,
+        "retirement_reason": "no measured usage in review window"
+      },
+      {
+        "interface": {
+          "id": "69e1a255-a8b9-4101-8a68-b1bed23abfda",
+          "interface_key": "rest_api:GET /workstreams/{workstream_id}/dependencies/",
+          "interface_kind": "rest_api",
+          "legacy_since": "2026-06-04T00:25:59.291135Z",
+          "replacement_ref": "/workplans/{workplan_id}/dependencies/",
+          "owner_component": "state-hub.api",
+          "status": "legacy",
+          "replacement_verified": true,
+          "manual_hold": false,
+          "hold_reason": null,
+          "notes": null,
+          "retired_at": null,
+          "created_at": "2026-06-04T00:25:59.291135Z",
+          "updated_at": "2026-06-04T00:25:59.291135Z"
+        },
+        "all_time": {
+          "calls": 255865,
+          "tenant_count": 1,
+          "user_count": 1,
+          "component_count": 1,
+          "tenants": {
+            "unknown": 255865
+          },
+          "users": {
+            "unknown": 255865
+          },
+          "components": {
+            "unknown": 255865
+          }
+        },
+        "window": {
+          "calls": 0,
+          "tenant_count": 0,
+          "user_count": 0,
+          "component_count": 0,
+          "tenants": {},
+          "users": {},
+          "components": {}
+        },
+        "last_seen_at": "2026-07-08T21:14:12.747005Z",
+        "retirement_candidate": true,
+        "retirement_reason": "no measured usage in review window"
+      },
+      {
+        "interface": {
+          "id": "b1aae931-b51f-4a85-a723-865dd65f6132",
+          "interface_key": "rest_api:PATCH /workstreams/{workstream_id}",
+          "interface_kind": "rest_api",
+          "legacy_since": "2026-06-04T06:09:41.901035Z",
+          "replacement_ref": "/workplans/{workplan_id}",
+          "owner_component": "state-hub.api",
+          "status": "legacy",
+          "replacement_verified": true,
+          "manual_hold": false,
+          "hold_reason": null,
+          "notes": null,
+          "retired_at": null,
+          "created_at": "2026-06-04T06:09:41.901035Z",
+          "updated_at": "2026-06-04T06:09:41.901035Z"
+        },
+        "all_time": {
+          "calls": 571,
+          "tenant_count": 1,
+          "user_count": 1,
+          "component_count": 1,
+          "tenants": {
+            "unknown": 571
+          },
+          "users": {
+            "unknown": 571
+          },
+          "components": {
+            "unknown": 571
+          }
+        },
+        "window": {
+          "calls": 0,
+          "tenant_count": 0,
+          "user_count": 0,
+          "component_count": 0,
+          "tenants": {},
+          "users": {},
+          "components": {}
+        },
+        "last_seen_at": "2026-07-08T20:49:12.335710Z",
+        "retirement_candidate": true,
+        "retirement_reason": "no measured usage in review window"
+      },
+      {
+        "interface": {
+          "id": "4aea9591-970b-4918-ac4a-4da95a0a1a8c",
+          "interface_key": "rest_api:POST /decisions/ workstream_id",
+          "interface_kind": "rest_api",
+          "legacy_since": "2026-07-09T22:56:35.473130Z",
+          "replacement_ref": "POST /decisions/ with workplan_id",
+          "owner_component": "state-hub.api",
+          "status": "legacy",
+          "replacement_verified": true,
+          "manual_hold": false,
+          "hold_reason": null,
+          "notes": null,
+          "retired_at": null,
+          "created_at": "2026-07-09T22:56:35.473130Z",
+          "updated_at": "2026-07-09T22:56:35.473130Z"
+        },
+        "all_time": {
+          "calls": 3,
+          "tenant_count": 1,
+          "user_count": 1,
+          "component_count": 1,
+          "tenants": {
+            "unknown": 3
+          },
+          "users": {
+            "unknown": 3
+          },
+          "components": {
+            "unknown": 3
+          }
+        },
+        "window": {
+          "calls": 0,
+          "tenant_count": 0,
+          "user_count": 0,
+          "component_count": 0,
+          "tenants": {},
+          "users": {},
+          "components": {}
+        },
+        "last_seen_at": "2026-07-09T22:57:05.912456Z",
+        "retirement_candidate": true,
+        "retirement_reason": "no measured usage in review window"
+      },
+      {
+        "interface": {
+          "id": "4a70583c-1e41-4ec1-99a9-728856a7d79c",
+          "interface_key": "rest_api:POST /progress/ workstream_id",
+          "interface_kind": "rest_api",
+          "legacy_since": "2026-07-08T23:35:09.148333Z",
+          "replacement_ref": "POST /progress/ with workplan_id",
+          "owner_component": "state-hub.api",
+          "status": "legacy",
+          "replacement_verified": true,
+          "manual_hold": false,
+          "hold_reason": null,
+          "notes": null,
+          "retired_at": null,
+          "created_at": "2026-07-08T23:35:09.148333Z",
+          "updated_at": "2026-07-08T23:35:09.148333Z"
+        },
+        "all_time": {
+          "calls": 14,
+          "tenant_count": 1,
+          "user_count": 1,
+          "component_count": 1,
+          "tenants": {
+            "unknown": 14
+          },
+          "users": {
+            "unknown": 14
+          },
+          "components": {
+            "unknown": 14
+          }
+        },
+        "window": {
+          "calls": 0,
+          "tenant_count": 0,
+          "user_count": 0,
+          "component_count": 0,
+          "tenants": {},
+          "users": {},
+          "components": {}
+        },
+        "last_seen_at": "2026-07-10T08:34:42.959724Z",
+        "retirement_candidate": true,
+        "retirement_reason": "no measured usage in review window"
+      },
+      {
+        "interface": {
+          "id": "6df4e443-7bf1-461a-923b-a6eb52fe7b07",
+          "interface_key": "rest_api:POST /tasks/ workstream_id",
+          "interface_kind": "rest_api",
+          "legacy_since": "2026-07-08T22:38:29.405720Z",
+          "replacement_ref": "POST /tasks/ with workplan_id",
+          "owner_component": "state-hub.api",
+          "status": "legacy",
+          "replacement_verified": true,
+          "manual_hold": false,
+          "hold_reason": null,
+          "notes": null,
+          "retired_at": null,
+          "created_at": "2026-07-08T22:38:29.405720Z",
+          "updated_at": "2026-07-08T22:38:29.405720Z"
+        },
+        "all_time": {
+          "calls": 5,
+          "tenant_count": 1,
+          "user_count": 1,
+          "component_count": 1,
+          "tenants": {
+            "unknown": 5
+          },
+          "users": {
+            "unknown": 5
+          },
+          "components": {
+            "state-hub.fix-consistency": 5
+          }
+        },
+        "window": {
+          "calls": 0,
+          "tenant_count": 0,
+          "user_count": 0,
+          "component_count": 0,
+          "tenants": {},
+          "users": {},
+          "components": {}
+        },
+        "last_seen_at": "2026-07-08T22:38:29.976918Z",
+        "retirement_candidate": true,
+        "retirement_reason": "no measured usage in review window"
+      },
+      {
+        "interface": {
+          "id": "ed6451c9-d2cc-4486-9afe-d3852782cabc",
+          "interface_key": "rest_api:POST /workstreams/",
+          "interface_kind": "rest_api",
+          "legacy_since": "2026-06-04T07:40:24.168535Z",
+          "replacement_ref": "/workplans/",
+          "owner_component": "state-hub.api",
+          "status": "legacy",
+          "replacement_verified": true,
+          "manual_hold": false,
+          "hold_reason": null,
+          "notes": null,
+          "retired_at": null,
+          "created_at": "2026-06-04T07:40:24.168535Z",
+          "updated_at": "2026-06-04T07:40:24.168535Z"
+        },
+        "all_time": {
+          "calls": 824,
+          "tenant_count": 1,
+          "user_count": 1,
+          "component_count": 1,
+          "tenants": {
+            "unknown": 824
+          },
+          "users": {
+            "unknown": 824
+          },
+          "components": {
+            "unknown": 824
+          }
+        },
+        "window": {
+          "calls": 0,
+          "tenant_count": 0,
+          "user_count": 0,
+          "component_count": 0,
+          "tenants": {},
+          "users": {},
+          "components": {}
+        },
+        "last_seen_at": "2026-07-08T20:38:05.903144Z",
+        "retirement_candidate": true,
+        "retirement_reason": "no measured usage in review window"
+      },
+      {
+        "interface": {
+          "id": "281fd706-b192-4194-8055-2d8733c115f9",
+          "interface_key": "rest_api:POST /workstreams/{workstream_id}/dependencies/",
+          "interface_kind": "rest_api",
+          "legacy_since": "2026-06-04T22:57:37.149207Z",
+          "replacement_ref": "/workplans/{workplan_id}/dependencies/",
+          "owner_component": "state-hub.api",
+          "status": "legacy",
+          "replacement_verified": true,
+          "manual_hold": false,
+          "hold_reason": null,
+          "notes": null,
+          "retired_at": null,
+          "created_at": "2026-06-04T22:57:37.149207Z",
+          "updated_at": "2026-06-04T22:57:37.149207Z"
+        },
+        "all_time": {
+          "calls": 4971,
+          "tenant_count": 1,
+          "user_count": 1,
+          "component_count": 1,
+          "tenants": {
+            "unknown": 4971
+          },
+          "users": {
+            "unknown": 4971
+          },
+          "components": {
+            "unknown": 4971
+          }
+        },
+        "window": {
+          "calls": 0,
+          "tenant_count": 0,
+          "user_count": 0,
+          "component_count": 0,
+          "tenants": {},
+          "users": {},
+          "components": {}
+        },
+        "last_seen_at": "2026-07-01T22:09:24.229011Z",
+        "retirement_candidate": true,
+        "retirement_reason": "no measured usage in review window"
+      }
+    ]
+  },
+  "hours": 8
+}
diff --git a/docs/evidence/legacy-meter-weekly-review-20260714.json b/docs/evidence/legacy-meter-weekly-review-20260714.json
new file mode 100644
index 0000000..97b1a48
--- /dev/null
+++ b/docs/evidence/legacy-meter-weekly-review-20260714.json
@@ -0,0 +1,1665 @@
+{
+  "captured_at": "2026-07-13T22:00:05.734375+00:00",
+  "api_base": "http://127.0.0.1:8000",
+  "workplan": "STATE-WP-0070",
+  "retired_interfaces": [],
+  "weekly_review": {
+    "generated_at": "2026-07-13T22:00:05.724722Z",
+    "window_start": "2026-07-13T14:00:05.618726Z",
+    "window_end": "2026-07-13T22:00:05.618726Z",
+    "cadence": "weekly",
+    "activity_core_handoff": {
+      "activity_id": "statehub-legacy-interface-review",
+      "cadence": "weekly",
+      "source_endpoint": "/legacy-meter/weekly-review",
+      "state_owner": "state-hub",
+      "scheduler_owner": "activity-core"
+    },
+    "interfaces": [
+      {
+        "interface": {
+          "id": "8051fb40-66c9-4dc4-a413-13e8573e04a3",
+          "interface_key": "event_subject:org.statehub.workstream.completed",
+          "interface_kind": "event_subject",
+          "legacy_since": "2026-06-04T06:09:42.198193Z",
+          "replacement_ref": "org.statehub.workplan.completed",
+          "owner_component": "state-hub.events",
+          "status": "retired",
+          "replacement_verified": true,
+          "manual_hold": false,
+          "hold_reason": null,
+          "notes": "Retired by STATE-WP-0069 closeout",
+          "retired_at": "2026-07-08T21:38:52.773601Z",
+          "created_at": "2026-06-04T06:09:42.198193Z",
+          "updated_at": "2026-07-08T21:38:52.761243Z"
+        },
+        "all_time": {
+          "calls": 255,
+          "tenant_count": 1,
+          "user_count": 1,
+          "component_count": 1,
+          "tenants": {
+            "unknown": 255
+          },
+          "users": {
+            "unknown": 255
+          },
+          "components": {
+            "state-hub.events": 255
+          }
+        },
+        "window": {
+          "calls": 0,
+          "tenant_count": 0,
+          "user_count": 0,
+          "component_count": 0,
+          "tenants": {},
+          "users": {},
+          "components": {}
+        },
+        "last_seen_at": "2026-07-08T20:49:12.839383Z",
+        "retirement_candidate": false,
+        "retirement_reason": "already retired"
+      },
+      {
+        "interface": {
+          "id": "63ed90e3-42b4-431a-94db-e1254a52f9e2",
+          "interface_key": "mcp:create_workstream",
+          "interface_kind": "mcp_tool",
+          "legacy_since": "2026-07-10T13:19:44.205900Z",
+          "replacement_ref": "create_workplan",
+          "owner_component": "state-hub.mcp",
+          "status": "legacy",
+          "replacement_verified": true,
+          "manual_hold": false,
+          "hold_reason": null,
+          "notes": "Registered by STATE-WP-0070 T03 \u2014 zero-window streak starts at registration",
+          "retired_at": null,
+          "created_at": "2026-07-10T13:19:44.205900Z",
+          "updated_at": "2026-07-10T13:19:44.205900Z"
+        },
+        "all_time": {
+          "calls": 2,
+          "tenant_count": 1,
+          "user_count": 1,
+          "component_count": 1,
+          "tenants": {
+            "unknown": 2
+          },
+          "users": {
+            "unknown": 2
+          },
+          "components": {
+            "state-hub.mcp": 2
+          }
+        },
+        "window": {
+          "calls": 0,
+          "tenant_count": 0,
+          "user_count": 0,
+          "component_count": 0,
+          "tenants": {},
+          "users": {},
+          "components": {}
+        },
+        "last_seen_at": "2026-07-10T13:20:43.378546Z",
+        "retirement_candidate": true,
+        "retirement_reason": "no measured usage in review window"
+      },
+      {
+        "interface": {
+          "id": "b6a5fe44-fb85-4ef7-a273-78d09da777af",
+          "interface_key": "mcp:list_workstreams",
+          "interface_kind": "mcp_tool",
+          "legacy_since": "2026-07-10T13:19:26.075491Z",
+          "replacement_ref": "list_workplans",
+          "owner_component": "state-hub.mcp",
+          "status": "legacy",
+          "replacement_verified": true,
+          "manual_hold": false,
+          "hold_reason": null,
+          "notes": null,
+          "retired_at": null,
+          "created_at": "2026-07-10T13:19:26.075491Z",
+          "updated_at": "2026-07-10T13:19:26.075491Z"
+        },
+        "all_time": {
+          "calls": 2,
+          "tenant_count": 1,
+          "user_count": 1,
+          "component_count": 1,
+          "tenants": {
+            "unknown": 2
+          },
+          "users": {
+            "unknown": 2
+          },
+          "components": {
+            "state-hub.mcp": 2
+          }
+        },
+        "window": {
+          "calls": 0,
+          "tenant_count": 0,
+          "user_count": 0,
+          "component_count": 0,
+          "tenants": {},
+          "users": {},
+          "components": {}
+        },
+        "last_seen_at": "2026-07-10T13:20:42.374940Z",
+        "retirement_candidate": true,
+        "retirement_reason": "no measured usage in review window"
+      },
+      {
+        "interface": {
+          "id": "53c3372b-307d-4d6a-8ea4-bc36cacdcaf2",
+          "interface_key": "mcp:update_workstream",
+          "interface_kind": "mcp_tool",
+          "legacy_since": "2026-07-10T13:19:44.255216Z",
+          "replacement_ref": "update_workplan",
+          "owner_component": "state-hub.mcp",
+          "status": "legacy",
+          "replacement_verified": true,
+          "manual_hold": false,
+          "hold_reason": null,
+          "notes": "Registered by STATE-WP-0070 T03 \u2014 zero-window streak starts at registration",
+          "retired_at": null,
+          "created_at": "2026-07-10T13:19:44.255216Z",
+          "updated_at": "2026-07-10T13:19:44.255216Z"
+        },
+        "all_time": {
+          "calls": 0,
+          "tenant_count": 0,
+          "user_count": 0,
+          "component_count": 0,
+          "tenants": {},
+          "users": {},
+          "components": {}
+        },
+        "window": {
+          "calls": 0,
+          "tenant_count": 0,
+          "user_count": 0,
+          "component_count": 0,
+          "tenants": {},
+          "users": {},
+          "components": {}
+        },
+        "last_seen_at": null,
+        "retirement_candidate": true,
+        "retirement_reason": "no measured usage in review window"
+      },
+      {
+        "interface": {
+          "id": "bed4d08a-3471-48f5-9f0e-f9d550383a26",
+          "interface_key": "mcp:update_workstream_status",
+          "interface_kind": "mcp_tool",
+          "legacy_since": "2026-07-10T13:19:44.303612Z",
+          "replacement_ref": "update_workplan_status",
+          "owner_component": "state-hub.mcp",
+          "status": "legacy",
+          "replacement_verified": true,
+          "manual_hold": false,
+          "hold_reason": null,
+          "notes": "Registered by STATE-WP-0070 T03 \u2014 zero-window streak starts at registration",
+          "retired_at": null,
+          "created_at": "2026-07-10T13:19:44.303612Z",
+          "updated_at": "2026-07-10T13:19:44.303612Z"
+        },
+        "all_time": {
+          "calls": 0,
+          "tenant_count": 0,
+          "user_count": 0,
+          "component_count": 0,
+          "tenants": {},
+          "users": {},
+          "components": {}
+        },
+        "window": {
+          "calls": 0,
+          "tenant_count": 0,
+          "user_count": 0,
+          "component_count": 0,
+          "tenants": {},
+          "users": {},
+          "components": {}
+        },
+        "last_seen_at": null,
+        "retirement_candidate": true,
+        "retirement_reason": "no measured usage in review window"
+      },
+      {
+        "interface": {
+          "id": "46900dc2-0893-405b-ba59-80f31fb6ebb1",
+          "interface_key": "state://workstreams/{topic_slug}",
+          "interface_kind": "mcp_tool",
+          "legacy_since": "2026-07-10T13:19:44.344493Z",
+          "replacement_ref": "state://workplans/{topic_slug}",
+          "owner_component": "state-hub.mcp",
+          "status": "legacy",
+          "replacement_verified": true,
+          "manual_hold": false,
+          "hold_reason": null,
+          "notes": "Registered by STATE-WP-0070 T03 \u2014 zero-window streak starts at registration",
+          "retired_at": null,
+          "created_at": "2026-07-10T13:19:44.344493Z",
+          "updated_at": "2026-07-10T13:19:44.344493Z"
+        },
+        "all_time": {
+          "calls": 1,
+          "tenant_count": 1,
+          "user_count": 1,
+          "component_count": 1,
+          "tenants": {
+            "unknown": 1
+          },
+          "users": {
+            "unknown": 1
+          },
+          "components": {
+            "state-hub.mcp": 1
+          }
+        },
+        "window": {
+          "calls": 0,
+          "tenant_count": 0,
+          "user_count": 0,
+          "component_count": 0,
+          "tenants": {},
+          "users": {},
+          "components": {}
+        },
+        "last_seen_at": "2026-07-10T13:20:34.491811Z",
+        "retirement_candidate": true,
+        "retirement_reason": "no measured usage in review window"
+      },
+      {
+        "interface": {
+          "id": "cd9342fd-27e7-4a46-a1be-d41499e106a3",
+          "interface_key": "rest_api:DELETE /workstreams/{workstream_id}",
+          "interface_kind": "rest_api",
+          "legacy_since": "2026-06-06T17:28:13.052813Z",
+          "replacement_ref": "/workplans/{workplan_id}",
+          "owner_component": "state-hub.api",
+          "status": "legacy",
+          "replacement_verified": true,
+          "manual_hold": false,
+          "hold_reason": null,
+          "notes": null,
+          "retired_at": null,
+          "created_at": "2026-06-06T17:28:13.052813Z",
+          "updated_at": "2026-06-06T17:28:13.052813Z"
+        },
+        "all_time": {
+          "calls": 1,
+          "tenant_count": 1,
+          "user_count": 1,
+          "component_count": 1,
+          "tenants": {
+            "unknown": 1
+          },
+          "users": {
+            "unknown": 1
+          },
+          "components": {
+            "unknown": 1
+          }
+        },
+        "window": {
+          "calls": 0,
+          "tenant_count": 0,
+          "user_count": 0,
+          "component_count": 0,
+          "tenants": {},
+          "users": {},
+          "components": {}
+        },
+        "last_seen_at": "2026-06-06T17:28:13.047529Z",
+        "retirement_candidate": true,
+        "retirement_reason": "no measured usage in review window"
+      },
+      {
+        "interface": {
+          "id": "a4e0948c-cd4a-461e-8ae2-7fd7b51d04a7",
+          "interface_key": "rest_api:GET /decisions/?workstream_id",
+          "interface_kind": "rest_api",
+          "legacy_since": "2026-07-09T23:07:53.093223Z",
+          "replacement_ref": "/decisions/?workplan_id=<workplan_id>",
+          "owner_component": "state-hub.api",
+          "status": "legacy",
+          "replacement_verified": true,
+          "manual_hold": false,
+          "hold_reason": null,
+          "notes": null,
+          "retired_at": null,
+          "created_at": "2026-07-09T23:07:53.093223Z",
+          "updated_at": "2026-07-09T23:07:53.093223Z"
+        },
+        "all_time": {
+          "calls": 1,
+          "tenant_count": 1,
+          "user_count": 1,
+          "component_count": 1,
+          "tenants": {
+            "unknown": 1
+          },
+          "users": {
+            "unknown": 1
+          },
+          "components": {
+            "unknown": 1
+          }
+        },
+        "window": {
+          "calls": 0,
+          "tenant_count": 0,
+          "user_count": 0,
+          "component_count": 0,
+          "tenants": {},
+          "users": {},
+          "components": {}
+        },
+        "last_seen_at": "2026-07-09T23:07:53.083299Z",
+        "retirement_candidate": true,
+        "retirement_reason": "no measured usage in review window"
+      },
+      {
+        "interface": {
+          "id": "be3cdcf8-250b-4bf0-801f-02ffd5f57e00",
+          "interface_key": "rest_api:GET /tasks/?workstream_id",
+          "interface_kind": "rest_api",
+          "legacy_since": "2026-07-08T19:32:21.628513Z",
+          "replacement_ref": "/tasks/?workplan_id=<workplan_id>",
+          "owner_component": "state-hub.api",
+          "status": "legacy",
+          "replacement_verified": true,
+          "manual_hold": false,
+          "hold_reason": null,
+          "notes": null,
+          "retired_at": null,
+          "created_at": "2026-07-08T19:32:21.628513Z",
+          "updated_at": "2026-07-08T19:32:21.628513Z"
+        },
+        "all_time": {
+          "calls": 577,
+          "tenant_count": 1,
+          "user_count": 1,
+          "component_count": 1,
+          "tenants": {
+            "unknown": 577
+          },
+          "users": {
+            "unknown": 577
+          },
+          "components": {
+            "unknown": 577
+          }
+        },
+        "window": {
+          "calls": 0,
+          "tenant_count": 0,
+          "user_count": 0,
+          "component_count": 0,
+          "tenants": {},
+          "users": {},
+          "components": {}
+        },
+        "last_seen_at": "2026-07-08T21:38:17.035426Z",
+        "retirement_candidate": true,
+        "retirement_reason": "no measured usage in review window"
+      },
+      {
+        "interface": {
+          "id": "3e4a3d0b-08fa-45c3-91e2-4f514a914b97",
+          "interface_key": "rest_api:GET /workstreams/",
+          "interface_kind": "rest_api",
+          "legacy_since": "2026-06-04T00:26:14.533764Z",
+          "replacement_ref": "/workplans/",
+          "owner_component": "state-hub.api",
+          "status": "legacy",
+          "replacement_verified": true,
+          "manual_hold": false,
+          "hold_reason": null,
+          "notes": null,
+          "retired_at": null,
+          "created_at": "2026-06-04T00:26:14.533764Z",
+          "updated_at": "2026-06-04T00:26:14.533764Z"
+        },
+        "all_time": {
+          "calls": 144084,
+          "tenant_count": 1,
+          "user_count": 1,
+          "component_count": 1,
+          "tenants": {
+            "unknown": 144084
+          },
+          "users": {
+            "unknown": 144084
+          },
+          "components": {
+            "unknown": 144084
+          }
+        },
+        "window": {
+          "calls": 0,
+          "tenant_count": 0,
+          "user_count": 0,
+          "component_count": 0,
+          "tenants": {},
+          "users": {},
+          "components": {}
+        },
+        "last_seen_at": "2026-07-08T21:14:39.652776Z",
+        "retirement_candidate": true,
+        "retirement_reason": "no measured usage in review window"
+      },
+      {
+        "interface": {
+          "id": "e4c140ec-7479-46f9-b185-4b533f19d639",
+          "interface_key": "rest_api:GET /workstreams/workplan-index",
+          "interface_kind": "rest_api",
+          "legacy_since": "2026-06-04T05:20:58.321869Z",
+          "replacement_ref": "/workplans/index",
+          "owner_component": "state-hub.api",
+          "status": "legacy",
+          "replacement_verified": true,
+          "manual_hold": false,
+          "hold_reason": null,
+          "notes": null,
+          "retired_at": null,
+          "created_at": "2026-06-04T05:20:58.321869Z",
+          "updated_at": "2026-06-04T05:20:58.321869Z"
+        },
+        "all_time": {
+          "calls": 30,
+          "tenant_count": 1,
+          "user_count": 1,
+          "component_count": 1,
+          "tenants": {
+            "unknown": 30
+          },
+          "users": {
+            "unknown": 30
+          },
+          "components": {
+            "unknown": 30
+          }
+        },
+        "window": {
+          "calls": 0,
+          "tenant_count": 0,
+          "user_count": 0,
+          "component_count": 0,
+          "tenants": {},
+          "users": {},
+          "components": {}
+        },
+        "last_seen_at": "2026-07-03T05:20:34.534439Z",
+        "retirement_candidate": true,
+        "retirement_reason": "no measured usage in review window"
+      },
+      {
+        "interface": {
+          "id": "3a00b19e-e7db-4403-98aa-a77c9ab61ecc",
+          "interface_key": "rest_api:GET /workstreams/{workstream_id}",
+          "interface_kind": "rest_api",
+          "legacy_since": "2026-06-04T00:25:59.014966Z",
+          "replacement_ref": "/workplans/{workplan_id}",
+          "owner_component": "state-hub.api",
+          "status": "legacy",
+          "replacement_verified": true,
+          "manual_hold": false,
+          "hold_reason": null,
+          "notes": null,
+          "retired_at": null,
+          "created_at": "2026-06-04T00:25:59.014966Z",
+          "updated_at": "2026-06-04T00:25:59.014966Z"
+        },
+        "all_time": {
+          "calls": 511405,
+          "tenant_count": 1,
+          "user_count": 1,
+          "component_count": 1,
+          "tenants": {
+            "unknown": 511405
+          },
+          "users": {
+            "unknown": 511405
+          },
+          "components": {
+            "unknown": 511405
+          }
+        },
+        "window": {
+          "calls": 0,
+          "tenant_count": 0,
+          "user_count": 0,
+          "component_count": 0,
+          "tenants": {},
+          "users": {},
+          "components": {}
+        },
+        "last_seen_at": "2026-07-08T21:14:20.781103Z",
+        "retirement_candidate": true,
+        "retirement_reason": "no measured usage in review window"
+      },
+      {
+        "interface": {
+          "id": "69e1a255-a8b9-4101-8a68-b1bed23abfda",
+          "interface_key": "rest_api:GET /workstreams/{workstream_id}/dependencies/",
+          "interface_kind": "rest_api",
+          "legacy_since": "2026-06-04T00:25:59.291135Z",
+          "replacement_ref": "/workplans/{workplan_id}/dependencies/",
+          "owner_component": "state-hub.api",
+          "status": "legacy",
+          "replacement_verified": true,
+          "manual_hold": false,
+          "hold_reason": null,
+          "notes": null,
+          "retired_at": null,
+          "created_at": "2026-06-04T00:25:59.291135Z",
+          "updated_at": "2026-06-04T00:25:59.291135Z"
+        },
+        "all_time": {
+          "calls": 255865,
+          "tenant_count": 1,
+          "user_count": 1,
+          "component_count": 1,
+          "tenants": {
+            "unknown": 255865
+          },
+          "users": {
+            "unknown": 255865
+          },
+          "components": {
+            "unknown": 255865
+          }
+        },
+        "window": {
+          "calls": 0,
+          "tenant_count": 0,
+          "user_count": 0,
+          "component_count": 0,
+          "tenants": {},
+          "users": {},
+          "components": {}
+        },
+        "last_seen_at": "2026-07-08T21:14:12.747005Z",
+        "retirement_candidate": true,
+        "retirement_reason": "no measured usage in review window"
+      },
+      {
+        "interface": {
+          "id": "b1aae931-b51f-4a85-a723-865dd65f6132",
+          "interface_key": "rest_api:PATCH /workstreams/{workstream_id}",
+          "interface_kind": "rest_api",
+          "legacy_since": "2026-06-04T06:09:41.901035Z",
+          "replacement_ref": "/workplans/{workplan_id}",
+          "owner_component": "state-hub.api",
+          "status": "legacy",
+          "replacement_verified": true,
+          "manual_hold": false,
+          "hold_reason": null,
+          "notes": null,
+          "retired_at": null,
+          "created_at": "2026-06-04T06:09:41.901035Z",
+          "updated_at": "2026-06-04T06:09:41.901035Z"
+        },
+        "all_time": {
+          "calls": 571,
+          "tenant_count": 1,
+          "user_count": 1,
+          "component_count": 1,
+          "tenants": {
+            "unknown": 571
+          },
+          "users": {
+            "unknown": 571
+          },
+          "components": {
+            "unknown": 571
+          }
+        },
+        "window": {
+          "calls": 0,
+          "tenant_count": 0,
+          "user_count": 0,
+          "component_count": 0,
+          "tenants": {},
+          "users": {},
+          "components": {}
+        },
+        "last_seen_at": "2026-07-08T20:49:12.335710Z",
+        "retirement_candidate": true,
+        "retirement_reason": "no measured usage in review window"
+      },
+      {
+        "interface": {
+          "id": "4aea9591-970b-4918-ac4a-4da95a0a1a8c",
+          "interface_key": "rest_api:POST /decisions/ workstream_id",
+          "interface_kind": "rest_api",
+          "legacy_since": "2026-07-09T22:56:35.473130Z",
+          "replacement_ref": "POST /decisions/ with workplan_id",
+          "owner_component": "state-hub.api",
+          "status": "legacy",
+          "replacement_verified": true,
+          "manual_hold": false,
+          "hold_reason": null,
+          "notes": null,
+          "retired_at": null,
+          "created_at": "2026-07-09T22:56:35.473130Z",
+          "updated_at": "2026-07-09T22:56:35.473130Z"
+        },
+        "all_time": {
+          "calls": 3,
+          "tenant_count": 1,
+          "user_count": 1,
+          "component_count": 1,
+          "tenants": {
+            "unknown": 3
+          },
+          "users": {
+            "unknown": 3
+          },
+          "components": {
+            "unknown": 3
+          }
+        },
+        "window": {
+          "calls": 0,
+          "tenant_count": 0,
+          "user_count": 0,
+          "component_count": 0,
+          "tenants": {},
+          "users": {},
+          "components": {}
+        },
+        "last_seen_at": "2026-07-09T22:57:05.912456Z",
+        "retirement_candidate": true,
+        "retirement_reason": "no measured usage in review window"
+      },
+      {
+        "interface": {
+          "id": "4a70583c-1e41-4ec1-99a9-728856a7d79c",
+          "interface_key": "rest_api:POST /progress/ workstream_id",
+          "interface_kind": "rest_api",
+          "legacy_since": "2026-07-08T23:35:09.148333Z",
+          "replacement_ref": "POST /progress/ with workplan_id",
+          "owner_component": "state-hub.api",
+          "status": "legacy",
+          "replacement_verified": true,
+          "manual_hold": false,
+          "hold_reason": null,
+          "notes": null,
+          "retired_at": null,
+          "created_at": "2026-07-08T23:35:09.148333Z",
+          "updated_at": "2026-07-08T23:35:09.148333Z"
+        },
+        "all_time": {
+          "calls": 14,
+          "tenant_count": 1,
+          "user_count": 1,
+          "component_count": 1,
+          "tenants": {
+            "unknown": 14
+          },
+          "users": {
+            "unknown": 14
+          },
+          "components": {
+            "unknown": 14
+          }
+        },
+        "window": {
+          "calls": 0,
+          "tenant_count": 0,
+          "user_count": 0,
+          "component_count": 0,
+          "tenants": {},
+          "users": {},
+          "components": {}
+        },
+        "last_seen_at": "2026-07-10T08:34:42.959724Z",
+        "retirement_candidate": true,
+        "retirement_reason": "no measured usage in review window"
+      },
+      {
+        "interface": {
+          "id": "6df4e443-7bf1-461a-923b-a6eb52fe7b07",
+          "interface_key": "rest_api:POST /tasks/ workstream_id",
+          "interface_kind": "rest_api",
+          "legacy_since": "2026-07-08T22:38:29.405720Z",
+          "replacement_ref": "POST /tasks/ with workplan_id",
+          "owner_component": "state-hub.api",
+          "status": "legacy",
+          "replacement_verified": true,
+          "manual_hold": false,
+          "hold_reason": null,
+          "notes": null,
+          "retired_at": null,
+          "created_at": "2026-07-08T22:38:29.405720Z",
+          "updated_at": "2026-07-08T22:38:29.405720Z"
+        },
+        "all_time": {
+          "calls": 5,
+          "tenant_count": 1,
+          "user_count": 1,
+          "component_count": 1,
+          "tenants": {
+            "unknown": 5
+          },
+          "users": {
+            "unknown": 5
+          },
+          "components": {
+            "state-hub.fix-consistency": 5
+          }
+        },
+        "window": {
+          "calls": 0,
+          "tenant_count": 0,
+          "user_count": 0,
+          "component_count": 0,
+          "tenants": {},
+          "users": {},
+          "components": {}
+        },
+        "last_seen_at": "2026-07-08T22:38:29.976918Z",
+        "retirement_candidate": true,
+        "retirement_reason": "no measured usage in review window"
+      },
+      {
+        "interface": {
+          "id": "ed6451c9-d2cc-4486-9afe-d3852782cabc",
+          "interface_key": "rest_api:POST /workstreams/",
+          "interface_kind": "rest_api",
+          "legacy_since": "2026-06-04T07:40:24.168535Z",
+          "replacement_ref": "/workplans/",
+          "owner_component": "state-hub.api",
+          "status": "legacy",
+          "replacement_verified": true,
+          "manual_hold": false,
+          "hold_reason": null,
+          "notes": null,
+          "retired_at": null,
+          "created_at": "2026-06-04T07:40:24.168535Z",
+          "updated_at": "2026-06-04T07:40:24.168535Z"
+        },
+        "all_time": {
+          "calls": 824,
+          "tenant_count": 1,
+          "user_count": 1,
+          "component_count": 1,
+          "tenants": {
+            "unknown": 824
+          },
+          "users": {
+            "unknown": 824
+          },
+          "components": {
+            "unknown": 824
+          }
+        },
+        "window": {
+          "calls": 0,
+          "tenant_count": 0,
+          "user_count": 0,
+          "component_count": 0,
+          "tenants": {},
+          "users": {},
+          "components": {}
+        },
+        "last_seen_at": "2026-07-08T20:38:05.903144Z",
+        "retirement_candidate": true,
+        "retirement_reason": "no measured usage in review window"
+      },
+      {
+        "interface": {
+          "id": "281fd706-b192-4194-8055-2d8733c115f9",
+          "interface_key": "rest_api:POST /workstreams/{workstream_id}/dependencies/",
+          "interface_kind": "rest_api",
+          "legacy_since": "2026-06-04T22:57:37.149207Z",
+          "replacement_ref": "/workplans/{workplan_id}/dependencies/",
+          "owner_component": "state-hub.api",
+          "status": "legacy",
+          "replacement_verified": true,
+          "manual_hold": false,
+          "hold_reason": null,
+          "notes": null,
+          "retired_at": null,
+          "created_at": "2026-06-04T22:57:37.149207Z",
+          "updated_at": "2026-06-04T22:57:37.149207Z"
+        },
+        "all_time": {
+          "calls": 4971,
+          "tenant_count": 1,
+          "user_count": 1,
+          "component_count": 1,
+          "tenants": {
+            "unknown": 4971
+          },
+          "users": {
+            "unknown": 4971
+          },
+          "components": {
+            "unknown": 4971
+          }
+        },
+        "window": {
+          "calls": 0,
+          "tenant_count": 0,
+          "user_count": 0,
+          "component_count": 0,
+          "tenants": {},
+          "users": {},
+          "components": {}
+        },
+        "last_seen_at": "2026-07-01T22:09:24.229011Z",
+        "retirement_candidate": true,
+        "retirement_reason": "no measured usage in review window"
+      }
+    ],
+    "retirement_candidates": [
+      {
+        "interface": {
+          "id": "63ed90e3-42b4-431a-94db-e1254a52f9e2",
+          "interface_key": "mcp:create_workstream",
+          "interface_kind": "mcp_tool",
+          "legacy_since": "2026-07-10T13:19:44.205900Z",
+          "replacement_ref": "create_workplan",
+          "owner_component": "state-hub.mcp",
+          "status": "legacy",
+          "replacement_verified": true,
+          "manual_hold": false,
+          "hold_reason": null,
+          "notes": "Registered by STATE-WP-0070 T03 \u2014 zero-window streak starts at registration",
+          "retired_at": null,
+          "created_at": "2026-07-10T13:19:44.205900Z",
+          "updated_at": "2026-07-10T13:19:44.205900Z"
+        },
+        "all_time": {
+          "calls": 2,
+          "tenant_count": 1,
+          "user_count": 1,
+          "component_count": 1,
+          "tenants": {
+            "unknown": 2
+          },
+          "users": {
+            "unknown": 2
+          },
+          "components": {
+            "state-hub.mcp": 2
+          }
+        },
+        "window": {
+          "calls": 0,
+          "tenant_count": 0,
+          "user_count": 0,
+          "component_count": 0,
+          "tenants": {},
+          "users": {},
+          "components": {}
+        },
+        "last_seen_at": "2026-07-10T13:20:43.378546Z",
+        "retirement_candidate": true,
+        "retirement_reason": "no measured usage in review window"
+      },
+      {
+        "interface": {
+          "id": "b6a5fe44-fb85-4ef7-a273-78d09da777af",
+          "interface_key": "mcp:list_workstreams",
+          "interface_kind": "mcp_tool",
+          "legacy_since": "2026-07-10T13:19:26.075491Z",
+          "replacement_ref": "list_workplans",
+          "owner_component": "state-hub.mcp",
+          "status": "legacy",
+          "replacement_verified": true,
+          "manual_hold": false,
+          "hold_reason": null,
+          "notes": null,
+          "retired_at": null,
+          "created_at": "2026-07-10T13:19:26.075491Z",
+          "updated_at": "2026-07-10T13:19:26.075491Z"
+        },
+        "all_time": {
+          "calls": 2,
+          "tenant_count": 1,
+          "user_count": 1,
+          "component_count": 1,
+          "tenants": {
+            "unknown": 2
+          },
+          "users": {
+            "unknown": 2
+          },
+          "components": {
+            "state-hub.mcp": 2
+          }
+        },
+        "window": {
+          "calls": 0,
+          "tenant_count": 0,
+          "user_count": 0,
+          "component_count": 0,
+          "tenants": {},
+          "users": {},
+          "components": {}
+        },
+        "last_seen_at": "2026-07-10T13:20:42.374940Z",
+        "retirement_candidate": true,
+        "retirement_reason": "no measured usage in review window"
+      },
+      {
+        "interface": {
+          "id": "53c3372b-307d-4d6a-8ea4-bc36cacdcaf2",
+          "interface_key": "mcp:update_workstream",
+          "interface_kind": "mcp_tool",
+          "legacy_since": "2026-07-10T13:19:44.255216Z",
+          "replacement_ref": "update_workplan",
+          "owner_component": "state-hub.mcp",
+          "status": "legacy",
+          "replacement_verified": true,
+          "manual_hold": false,
+          "hold_reason": null,
+          "notes": "Registered by STATE-WP-0070 T03 \u2014 zero-window streak starts at registration",
+          "retired_at": null,
+          "created_at": "2026-07-10T13:19:44.255216Z",
+          "updated_at": "2026-07-10T13:19:44.255216Z"
+        },
+        "all_time": {
+          "calls": 0,
+          "tenant_count": 0,
+          "user_count": 0,
+          "component_count": 0,
+          "tenants": {},
+          "users": {},
+          "components": {}
+        },
+        "window": {
+          "calls": 0,
+          "tenant_count": 0,
+          "user_count": 0,
+          "component_count": 0,
+          "tenants": {},
+          "users": {},
+          "components": {}
+        },
+        "last_seen_at": null,
+        "retirement_candidate": true,
+        "retirement_reason": "no measured usage in review window"
+      },
+      {
+        "interface": {
+          "id": "bed4d08a-3471-48f5-9f0e-f9d550383a26",
+          "interface_key": "mcp:update_workstream_status",
+          "interface_kind": "mcp_tool",
+          "legacy_since": "2026-07-10T13:19:44.303612Z",
+          "replacement_ref": "update_workplan_status",
+          "owner_component": "state-hub.mcp",
+          "status": "legacy",
+          "replacement_verified": true,
+          "manual_hold": false,
+          "hold_reason": null,
+          "notes": "Registered by STATE-WP-0070 T03 \u2014 zero-window streak starts at registration",
+          "retired_at": null,
+          "created_at": "2026-07-10T13:19:44.303612Z",
+          "updated_at": "2026-07-10T13:19:44.303612Z"
+        },
+        "all_time": {
+          "calls": 0,
+          "tenant_count": 0,
+          "user_count": 0,
+          "component_count": 0,
+          "tenants": {},
+          "users": {},
+          "components": {}
+        },
+        "window": {
+          "calls": 0,
+          "tenant_count": 0,
+          "user_count": 0,
+          "component_count": 0,
+          "tenants": {},
+          "users": {},
+          "components": {}
+        },
+        "last_seen_at": null,
+        "retirement_candidate": true,
+        "retirement_reason": "no measured usage in review window"
+      },
+      {
+        "interface": {
+          "id": "46900dc2-0893-405b-ba59-80f31fb6ebb1",
+          "interface_key": "state://workstreams/{topic_slug}",
+          "interface_kind": "mcp_tool",
+          "legacy_since": "2026-07-10T13:19:44.344493Z",
+          "replacement_ref": "state://workplans/{topic_slug}",
+          "owner_component": "state-hub.mcp",
+          "status": "legacy",
+          "replacement_verified": true,
+          "manual_hold": false,
+          "hold_reason": null,
+          "notes": "Registered by STATE-WP-0070 T03 \u2014 zero-window streak starts at registration",
+          "retired_at": null,
+          "created_at": "2026-07-10T13:19:44.344493Z",
+          "updated_at": "2026-07-10T13:19:44.344493Z"
+        },
+        "all_time": {
+          "calls": 1,
+          "tenant_count": 1,
+          "user_count": 1,
+          "component_count": 1,
+          "tenants": {
+            "unknown": 1
+          },
+          "users": {
+            "unknown": 1
+          },
+          "components": {
+            "state-hub.mcp": 1
+          }
+        },
+        "window": {
+          "calls": 0,
+          "tenant_count": 0,
+          "user_count": 0,
+          "component_count": 0,
+          "tenants": {},
+          "users": {},
+          "components": {}
+        },
+        "last_seen_at": "2026-07-10T13:20:34.491811Z",
+        "retirement_candidate": true,
+        "retirement_reason": "no measured usage in review window"
+      },
+      {
+        "interface": {
+          "id": "cd9342fd-27e7-4a46-a1be-d41499e106a3",
+          "interface_key": "rest_api:DELETE /workstreams/{workstream_id}",
+          "interface_kind": "rest_api",
+          "legacy_since": "2026-06-06T17:28:13.052813Z",
+          "replacement_ref": "/workplans/{workplan_id}",
+          "owner_component": "state-hub.api",
+          "status": "legacy",
+          "replacement_verified": true,
+          "manual_hold": false,
+          "hold_reason": null,
+          "notes": null,
+          "retired_at": null,
+          "created_at": "2026-06-06T17:28:13.052813Z",
+          "updated_at": "2026-06-06T17:28:13.052813Z"
+        },
+        "all_time": {
+          "calls": 1,
+          "tenant_count": 1,
+          "user_count": 1,
+          "component_count": 1,
+          "tenants": {
+            "unknown": 1
+          },
+          "users": {
+            "unknown": 1
+          },
+          "components": {
+            "unknown": 1
+          }
+        },
+        "window": {
+          "calls": 0,
+          "tenant_count": 0,
+          "user_count": 0,
+          "component_count": 0,
+          "tenants": {},
+          "users": {},
+          "components": {}
+        },
+        "last_seen_at": "2026-06-06T17:28:13.047529Z",
+        "retirement_candidate": true,
+        "retirement_reason": "no measured usage in review window"
+      },
+      {
+        "interface": {
+          "id": "a4e0948c-cd4a-461e-8ae2-7fd7b51d04a7",
+          "interface_key": "rest_api:GET /decisions/?workstream_id",
+          "interface_kind": "rest_api",
+          "legacy_since": "2026-07-09T23:07:53.093223Z",
+          "replacement_ref": "/decisions/?workplan_id=<workplan_id>",
+          "owner_component": "state-hub.api",
+          "status": "legacy",
+          "replacement_verified": true,
+          "manual_hold": false,
+          "hold_reason": null,
+          "notes": null,
+          "retired_at": null,
+          "created_at": "2026-07-09T23:07:53.093223Z",
+          "updated_at": "2026-07-09T23:07:53.093223Z"
+        },
+        "all_time": {
+          "calls": 1,
+          "tenant_count": 1,
+          "user_count": 1,
+          "component_count": 1,
+          "tenants": {
+            "unknown": 1
+          },
+          "users": {
+            "unknown": 1
+          },
+          "components": {
+            "unknown": 1
+          }
+        },
+        "window": {
+          "calls": 0,
+          "tenant_count": 0,
+          "user_count": 0,
+          "component_count": 0,
+          "tenants": {},
+          "users": {},
+          "components": {}
+        },
+        "last_seen_at": "2026-07-09T23:07:53.083299Z",
+        "retirement_candidate": true,
+        "retirement_reason": "no measured usage in review window"
+      },
+      {
+        "interface": {
+          "id": "be3cdcf8-250b-4bf0-801f-02ffd5f57e00",
+          "interface_key": "rest_api:GET /tasks/?workstream_id",
+          "interface_kind": "rest_api",
+          "legacy_since": "2026-07-08T19:32:21.628513Z",
+          "replacement_ref": "/tasks/?workplan_id=<workplan_id>",
+          "owner_component": "state-hub.api",
+          "status": "legacy",
+          "replacement_verified": true,
+          "manual_hold": false,
+          "hold_reason": null,
+          "notes": null,
+          "retired_at": null,
+          "created_at": "2026-07-08T19:32:21.628513Z",
+          "updated_at": "2026-07-08T19:32:21.628513Z"
+        },
+        "all_time": {
+          "calls": 577,
+          "tenant_count": 1,
+          "user_count": 1,
+          "component_count": 1,
+          "tenants": {
+            "unknown": 577
+          },
+          "users": {
+            "unknown": 577
+          },
+          "components": {
+            "unknown": 577
+          }
+        },
+        "window": {
+          "calls": 0,
+          "tenant_count": 0,
+          "user_count": 0,
+          "component_count": 0,
+          "tenants": {},
+          "users": {},
+          "components": {}
+        },
+        "last_seen_at": "2026-07-08T21:38:17.035426Z",
+        "retirement_candidate": true,
+        "retirement_reason": "no measured usage in review window"
+      },
+      {
+        "interface": {
+          "id": "3e4a3d0b-08fa-45c3-91e2-4f514a914b97",
+          "interface_key": "rest_api:GET /workstreams/",
+          "interface_kind": "rest_api",
+          "legacy_since": "2026-06-04T00:26:14.533764Z",
+          "replacement_ref": "/workplans/",
+          "owner_component": "state-hub.api",
+          "status": "legacy",
+          "replacement_verified": true,
+          "manual_hold": false,
+          "hold_reason": null,
+          "notes": null,
+          "retired_at": null,
+          "created_at": "2026-06-04T00:26:14.533764Z",
+          "updated_at": "2026-06-04T00:26:14.533764Z"
+        },
+        "all_time": {
+          "calls": 144084,
+          "tenant_count": 1,
+          "user_count": 1,
+          "component_count": 1,
+          "tenants": {
+            "unknown": 144084
+          },
+          "users": {
+            "unknown": 144084
+          },
+          "components": {
+            "unknown": 144084
+          }
+        },
+        "window": {
+          "calls": 0,
+          "tenant_count": 0,
+          "user_count": 0,
+          "component_count": 0,
+          "tenants": {},
+          "users": {},
+          "components": {}
+        },
+        "last_seen_at": "2026-07-08T21:14:39.652776Z",
+        "retirement_candidate": true,
+        "retirement_reason": "no measured usage in review window"
+      },
+      {
+        "interface": {
+          "id": "e4c140ec-7479-46f9-b185-4b533f19d639",
+          "interface_key": "rest_api:GET /workstreams/workplan-index",
+          "interface_kind": "rest_api",
+          "legacy_since": "2026-06-04T05:20:58.321869Z",
+          "replacement_ref": "/workplans/index",
+          "owner_component": "state-hub.api",
+          "status": "legacy",
+          "replacement_verified": true,
+          "manual_hold": false,
+          "hold_reason": null,
+          "notes": null,
+          "retired_at": null,
+          "created_at": "2026-06-04T05:20:58.321869Z",
+          "updated_at": "2026-06-04T05:20:58.321869Z"
+        },
+        "all_time": {
+          "calls": 30,
+          "tenant_count": 1,
+          "user_count": 1,
+          "component_count": 1,
+          "tenants": {
+            "unknown": 30
+          },
+          "users": {
+            "unknown": 30
+          },
+          "components": {
+            "unknown": 30
+          }
+        },
+        "window": {
+          "calls": 0,
+          "tenant_count": 0,
+          "user_count": 0,
+          "component_count": 0,
+          "tenants": {},
+          "users": {},
+          "components": {}
+        },
+        "last_seen_at": "2026-07-03T05:20:34.534439Z",
+        "retirement_candidate": true,
+        "retirement_reason": "no measured usage in review window"
+      },
+      {
+        "interface": {
+          "id": "3a00b19e-e7db-4403-98aa-a77c9ab61ecc",
+          "interface_key": "rest_api:GET /workstreams/{workstream_id}",
+          "interface_kind": "rest_api",
+          "legacy_since": "2026-06-04T00:25:59.014966Z",
+          "replacement_ref": "/workplans/{workplan_id}",
+          "owner_component": "state-hub.api",
+          "status": "legacy",
+          "replacement_verified": true,
+          "manual_hold": false,
+          "hold_reason": null,
+          "notes": null,
+          "retired_at": null,
+          "created_at": "2026-06-04T00:25:59.014966Z",
+          "updated_at": "2026-06-04T00:25:59.014966Z"
+        },
+        "all_time": {
+          "calls": 511405,
+          "tenant_count": 1,
+          "user_count": 1,
+          "component_count": 1,
+          "tenants": {
+            "unknown": 511405
+          },
+          "users": {
+            "unknown": 511405
+          },
+          "components": {
+            "unknown": 511405
+          }
+        },
+        "window": {
+          "calls": 0,
+          "tenant_count": 0,
+          "user_count": 0,
+          "component_count": 0,
+          "tenants": {},
+          "users": {},
+          "components": {}
+        },
+        "last_seen_at": "2026-07-08T21:14:20.781103Z",
+        "retirement_candidate": true,
+        "retirement_reason": "no measured usage in review window"
+      },
+      {
+        "interface": {
+          "id": "69e1a255-a8b9-4101-8a68-b1bed23abfda",
+          "interface_key": "rest_api:GET /workstreams/{workstream_id}/dependencies/",
+          "interface_kind": "rest_api",
+          "legacy_since": "2026-06-04T00:25:59.291135Z",
+          "replacement_ref": "/workplans/{workplan_id}/dependencies/",
+          "owner_component": "state-hub.api",
+          "status": "legacy",
+          "replacement_verified": true,
+          "manual_hold": false,
+          "hold_reason": null,
+          "notes": null,
+          "retired_at": null,
+          "created_at": "2026-06-04T00:25:59.291135Z",
+          "updated_at": "2026-06-04T00:25:59.291135Z"
+        },
+        "all_time": {
+          "calls": 255865,
+          "tenant_count": 1,
+          "user_count": 1,
+          "component_count": 1,
+          "tenants": {
+            "unknown": 255865
+          },
+          "users": {
+            "unknown": 255865
+          },
+          "components": {
+            "unknown": 255865
+          }
+        },
+        "window": {
+          "calls": 0,
+          "tenant_count": 0,
+          "user_count": 0,
+          "component_count": 0,
+          "tenants": {},
+          "users": {},
+          "components": {}
+        },
+        "last_seen_at": "2026-07-08T21:14:12.747005Z",
+        "retirement_candidate": true,
+        "retirement_reason": "no measured usage in review window"
+      },
+      {
+        "interface": {
+          "id": "b1aae931-b51f-4a85-a723-865dd65f6132",
+          "interface_key": "rest_api:PATCH /workstreams/{workstream_id}",
+          "interface_kind": "rest_api",
+          "legacy_since": "2026-06-04T06:09:41.901035Z",
+          "replacement_ref": "/workplans/{workplan_id}",
+          "owner_component": "state-hub.api",
+          "status": "legacy",
+          "replacement_verified": true,
+          "manual_hold": false,
+          "hold_reason": null,
+          "notes": null,
+          "retired_at": null,
+          "created_at": "2026-06-04T06:09:41.901035Z",
+          "updated_at": "2026-06-04T06:09:41.901035Z"
+        },
+        "all_time": {
+          "calls": 571,
+          "tenant_count": 1,
+          "user_count": 1,
+          "component_count": 1,
+          "tenants": {
+            "unknown": 571
+          },
+          "users": {
+            "unknown": 571
+          },
+          "components": {
+            "unknown": 571
+          }
+        },
+        "window": {
+          "calls": 0,
+          "tenant_count": 0,
+          "user_count": 0,
+          "component_count": 0,
+          "tenants": {},
+          "users": {},
+          "components": {}
+        },
+        "last_seen_at": "2026-07-08T20:49:12.335710Z",
+        "retirement_candidate": true,
+        "retirement_reason": "no measured usage in review window"
+      },
+      {
+        "interface": {
+          "id": "4aea9591-970b-4918-ac4a-4da95a0a1a8c",
+          "interface_key": "rest_api:POST /decisions/ workstream_id",
+          "interface_kind": "rest_api",
+          "legacy_since": "2026-07-09T22:56:35.473130Z",
+          "replacement_ref": "POST /decisions/ with workplan_id",
+          "owner_component": "state-hub.api",
+          "status": "legacy",
+          "replacement_verified": true,
+          "manual_hold": false,
+          "hold_reason": null,
+          "notes": null,
+          "retired_at": null,
+          "created_at": "2026-07-09T22:56:35.473130Z",
+          "updated_at": "2026-07-09T22:56:35.473130Z"
+        },
+        "all_time": {
+          "calls": 3,
+          "tenant_count": 1,
+          "user_count": 1,
+          "component_count": 1,
+          "tenants": {
+            "unknown": 3
+          },
+          "users": {
+            "unknown": 3
+          },
+          "components": {
+            "unknown": 3
+          }
+        },
+        "window": {
+          "calls": 0,
+          "tenant_count": 0,
+          "user_count": 0,
+          "component_count": 0,
+          "tenants": {},
+          "users": {},
+          "components": {}
+        },
+        "last_seen_at": "2026-07-09T22:57:05.912456Z",
+        "retirement_candidate": true,
+        "retirement_reason": "no measured usage in review window"
+      },
+      {
+        "interface": {
+          "id": "4a70583c-1e41-4ec1-99a9-728856a7d79c",
+          "interface_key": "rest_api:POST /progress/ workstream_id",
+          "interface_kind": "rest_api",
+          "legacy_since": "2026-07-08T23:35:09.148333Z",
+          "replacement_ref": "POST /progress/ with workplan_id",
+          "owner_component": "state-hub.api",
+          "status": "legacy",
+          "replacement_verified": true,
+          "manual_hold": false,
+          "hold_reason": null,
+          "notes": null,
+          "retired_at": null,
+          "created_at": "2026-07-08T23:35:09.148333Z",
+          "updated_at": "2026-07-08T23:35:09.148333Z"
+        },
+        "all_time": {
+          "calls": 14,
+          "tenant_count": 1,
+          "user_count": 1,
+          "component_count": 1,
+          "tenants": {
+            "unknown": 14
+          },
+          "users": {
+            "unknown": 14
+          },
+          "components": {
+            "unknown": 14
+          }
+        },
+        "window": {
+          "calls": 0,
+          "tenant_count": 0,
+          "user_count": 0,
+          "component_count": 0,
+          "tenants": {},
+          "users": {},
+          "components": {}
+        },
+        "last_seen_at": "2026-07-10T08:34:42.959724Z",
+        "retirement_candidate": true,
+        "retirement_reason": "no measured usage in review window"
+      },
+      {
+        "interface": {
+          "id": "6df4e443-7bf1-461a-923b-a6eb52fe7b07",
+          "interface_key": "rest_api:POST /tasks/ workstream_id",
+          "interface_kind": "rest_api",
+          "legacy_since": "2026-07-08T22:38:29.405720Z",
+          "replacement_ref": "POST /tasks/ with workplan_id",
+          "owner_component": "state-hub.api",
+          "status": "legacy",
+          "replacement_verified": true,
+          "manual_hold": false,
+          "hold_reason": null,
+          "notes": null,
+          "retired_at": null,
+          "created_at": "2026-07-08T22:38:29.405720Z",
+          "updated_at": "2026-07-08T22:38:29.405720Z"
+        },
+        "all_time": {
+          "calls": 5,
+          "tenant_count": 1,
+          "user_count": 1,
+          "component_count": 1,
+          "tenants": {
+            "unknown": 5
+          },
+          "users": {
+            "unknown": 5
+          },
+          "components": {
+            "state-hub.fix-consistency": 5
+          }
+        },
+        "window": {
+          "calls": 0,
+          "tenant_count": 0,
+          "user_count": 0,
+          "component_count": 0,
+          "tenants": {},
+          "users": {},
+          "components": {}
+        },
+        "last_seen_at": "2026-07-08T22:38:29.976918Z",
+        "retirement_candidate": true,
+        "retirement_reason": "no measured usage in review window"
+      },
+      {
+        "interface": {
+          "id": "ed6451c9-d2cc-4486-9afe-d3852782cabc",
+          "interface_key": "rest_api:POST /workstreams/",
+          "interface_kind": "rest_api",
+          "legacy_since": "2026-06-04T07:40:24.168535Z",
+          "replacement_ref": "/workplans/",
+          "owner_component": "state-hub.api",
+          "status": "legacy",
+          "replacement_verified": true,
+          "manual_hold": false,
+          "hold_reason": null,
+          "notes": null,
+          "retired_at": null,
+          "created_at": "2026-06-04T07:40:24.168535Z",
+          "updated_at": "2026-06-04T07:40:24.168535Z"
+        },
+        "all_time": {
+          "calls": 824,
+          "tenant_count": 1,
+          "user_count": 1,
+          "component_count": 1,
+          "tenants": {
+            "unknown": 824
+          },
+          "users": {
+            "unknown": 824
+          },
+          "components": {
+            "unknown": 824
+          }
+        },
+        "window": {
+          "calls": 0,
+          "tenant_count": 0,
+          "user_count": 0,
+          "component_count": 0,
+          "tenants": {},
+          "users": {},
+          "components": {}
+        },
+        "last_seen_at": "2026-07-08T20:38:05.903144Z",
+        "retirement_candidate": true,
+        "retirement_reason": "no measured usage in review window"
+      },
+      {
+        "interface": {
+          "id": "281fd706-b192-4194-8055-2d8733c115f9",
+          "interface_key": "rest_api:POST /workstreams/{workstream_id}/dependencies/",
+          "interface_kind": "rest_api",
+          "legacy_since": "2026-06-04T22:57:37.149207Z",
+          "replacement_ref": "/workplans/{workplan_id}/dependencies/",
+          "owner_component": "state-hub.api",
+          "status": "legacy",
+          "replacement_verified": true,
+          "manual_hold": false,
+          "hold_reason": null,
+          "notes": null,
+          "retired_at": null,
+          "created_at": "2026-06-04T22:57:37.149207Z",
+          "updated_at": "2026-06-04T22:57:37.149207Z"
+        },
+        "all_time": {
+          "calls": 4971,
+          "tenant_count": 1,
+          "user_count": 1,
+          "component_count": 1,
+          "tenants": {
+            "unknown": 4971
+          },
+          "users": {
+            "unknown": 4971
+          },
+          "components": {
+            "unknown": 4971
+          }
+        },
+        "window": {
+          "calls": 0,
+          "tenant_count": 0,
+          "user_count": 0,
+          "component_count": 0,
+          "tenants": {},
+          "users": {},
+          "components": {}
+        },
+        "last_seen_at": "2026-07-01T22:09:24.229011Z",
+        "retirement_candidate": true,
+        "retirement_reason": "no measured usage in review window"
+      }
+    ]
+  },
+  "hours": 8
+}
diff --git a/docs/evidence/legacy-meter-weekly-review-20260716.json b/docs/evidence/legacy-meter-weekly-review-20260716.json
new file mode 100644
index 0000000..99c3b95
--- /dev/null
+++ b/docs/evidence/legacy-meter-weekly-review-20260716.json
@@ -0,0 +1,1716 @@
+{
+  "captured_at": "2026-07-16T14:00:05.458231+00:00",
+  "api_base": "http://127.0.0.1:8000",
+  "workplan": "STATE-WP-0070",
+  "retired_interfaces": [],
+  "weekly_review": {
+    "generated_at": "2026-07-16T14:00:05.452247Z",
+    "window_start": "2026-07-16T06:00:05.399179Z",
+    "window_end": "2026-07-16T14:00:05.399179Z",
+    "cadence": "weekly",
+    "activity_core_handoff": {
+      "activity_id": "statehub-legacy-interface-review",
+      "cadence": "weekly",
+      "source_endpoint": "/legacy-meter/weekly-review",
+      "state_owner": "state-hub",
+      "scheduler_owner": "activity-core"
+    },
+    "interfaces": [
+      {
+        "interface": {
+          "id": "8051fb40-66c9-4dc4-a413-13e8573e04a3",
+          "interface_key": "event_subject:org.statehub.workstream.completed",
+          "interface_kind": "event_subject",
+          "legacy_since": "2026-06-04T06:09:42.198193Z",
+          "replacement_ref": "org.statehub.workplan.completed",
+          "owner_component": "state-hub.events",
+          "status": "retired",
+          "replacement_verified": true,
+          "manual_hold": false,
+          "hold_reason": null,
+          "notes": "Retired by STATE-WP-0069 closeout",
+          "retired_at": "2026-07-08T21:38:52.773601Z",
+          "created_at": "2026-06-04T06:09:42.198193Z",
+          "updated_at": "2026-07-08T21:38:52.761243Z"
+        },
+        "all_time": {
+          "calls": 255,
+          "tenant_count": 1,
+          "user_count": 1,
+          "component_count": 1,
+          "tenants": {
+            "unknown": 255
+          },
+          "users": {
+            "unknown": 255
+          },
+          "components": {
+            "state-hub.events": 255
+          }
+        },
+        "window": {
+          "calls": 0,
+          "tenant_count": 0,
+          "user_count": 0,
+          "component_count": 0,
+          "tenants": {},
+          "users": {},
+          "components": {}
+        },
+        "last_seen_at": "2026-07-08T20:49:12.839383Z",
+        "retirement_candidate": false,
+        "retirement_reason": "already retired"
+      },
+      {
+        "interface": {
+          "id": "63ed90e3-42b4-431a-94db-e1254a52f9e2",
+          "interface_key": "mcp:create_workstream",
+          "interface_kind": "mcp_tool",
+          "legacy_since": "2026-07-10T13:19:44.205900Z",
+          "replacement_ref": "create_workplan",
+          "owner_component": "state-hub.mcp",
+          "status": "legacy",
+          "replacement_verified": true,
+          "manual_hold": false,
+          "hold_reason": null,
+          "notes": "Registered by STATE-WP-0070 T03 \u2014 zero-window streak starts at registration",
+          "retired_at": null,
+          "created_at": "2026-07-10T13:19:44.205900Z",
+          "updated_at": "2026-07-10T13:19:44.205900Z"
+        },
+        "all_time": {
+          "calls": 2,
+          "tenant_count": 1,
+          "user_count": 1,
+          "component_count": 1,
+          "tenants": {
+            "unknown": 2
+          },
+          "users": {
+            "unknown": 2
+          },
+          "components": {
+            "state-hub.mcp": 2
+          }
+        },
+        "window": {
+          "calls": 0,
+          "tenant_count": 0,
+          "user_count": 0,
+          "component_count": 0,
+          "tenants": {},
+          "users": {},
+          "components": {}
+        },
+        "last_seen_at": "2026-07-10T13:20:43.378546Z",
+        "retirement_candidate": true,
+        "retirement_reason": "no measured usage in review window"
+      },
+      {
+        "interface": {
+          "id": "b6a5fe44-fb85-4ef7-a273-78d09da777af",
+          "interface_key": "mcp:list_workstreams",
+          "interface_kind": "mcp_tool",
+          "legacy_since": "2026-07-10T13:19:26.075491Z",
+          "replacement_ref": "list_workplans",
+          "owner_component": "state-hub.mcp",
+          "status": "legacy",
+          "replacement_verified": true,
+          "manual_hold": false,
+          "hold_reason": null,
+          "notes": null,
+          "retired_at": null,
+          "created_at": "2026-07-10T13:19:26.075491Z",
+          "updated_at": "2026-07-10T13:19:26.075491Z"
+        },
+        "all_time": {
+          "calls": 2,
+          "tenant_count": 1,
+          "user_count": 1,
+          "component_count": 1,
+          "tenants": {
+            "unknown": 2
+          },
+          "users": {
+            "unknown": 2
+          },
+          "components": {
+            "state-hub.mcp": 2
+          }
+        },
+        "window": {
+          "calls": 0,
+          "tenant_count": 0,
+          "user_count": 0,
+          "component_count": 0,
+          "tenants": {},
+          "users": {},
+          "components": {}
+        },
+        "last_seen_at": "2026-07-10T13:20:42.374940Z",
+        "retirement_candidate": true,
+        "retirement_reason": "no measured usage in review window"
+      },
+      {
+        "interface": {
+          "id": "53c3372b-307d-4d6a-8ea4-bc36cacdcaf2",
+          "interface_key": "mcp:update_workstream",
+          "interface_kind": "mcp_tool",
+          "legacy_since": "2026-07-10T13:19:44.255216Z",
+          "replacement_ref": "update_workplan",
+          "owner_component": "state-hub.mcp",
+          "status": "legacy",
+          "replacement_verified": true,
+          "manual_hold": false,
+          "hold_reason": null,
+          "notes": "Registered by STATE-WP-0070 T03 \u2014 zero-window streak starts at registration",
+          "retired_at": null,
+          "created_at": "2026-07-10T13:19:44.255216Z",
+          "updated_at": "2026-07-10T13:19:44.255216Z"
+        },
+        "all_time": {
+          "calls": 0,
+          "tenant_count": 0,
+          "user_count": 0,
+          "component_count": 0,
+          "tenants": {},
+          "users": {},
+          "components": {}
+        },
+        "window": {
+          "calls": 0,
+          "tenant_count": 0,
+          "user_count": 0,
+          "component_count": 0,
+          "tenants": {},
+          "users": {},
+          "components": {}
+        },
+        "last_seen_at": null,
+        "retirement_candidate": true,
+        "retirement_reason": "no measured usage in review window"
+      },
+      {
+        "interface": {
+          "id": "bed4d08a-3471-48f5-9f0e-f9d550383a26",
+          "interface_key": "mcp:update_workstream_status",
+          "interface_kind": "mcp_tool",
+          "legacy_since": "2026-07-10T13:19:44.303612Z",
+          "replacement_ref": "update_workplan_status",
+          "owner_component": "state-hub.mcp",
+          "status": "legacy",
+          "replacement_verified": true,
+          "manual_hold": false,
+          "hold_reason": null,
+          "notes": "Registered by STATE-WP-0070 T03 \u2014 zero-window streak starts at registration",
+          "retired_at": null,
+          "created_at": "2026-07-10T13:19:44.303612Z",
+          "updated_at": "2026-07-10T13:19:44.303612Z"
+        },
+        "all_time": {
+          "calls": 0,
+          "tenant_count": 0,
+          "user_count": 0,
+          "component_count": 0,
+          "tenants": {},
+          "users": {},
+          "components": {}
+        },
+        "window": {
+          "calls": 0,
+          "tenant_count": 0,
+          "user_count": 0,
+          "component_count": 0,
+          "tenants": {},
+          "users": {},
+          "components": {}
+        },
+        "last_seen_at": null,
+        "retirement_candidate": true,
+        "retirement_reason": "no measured usage in review window"
+      },
+      {
+        "interface": {
+          "id": "46900dc2-0893-405b-ba59-80f31fb6ebb1",
+          "interface_key": "state://workstreams/{topic_slug}",
+          "interface_kind": "mcp_tool",
+          "legacy_since": "2026-07-10T13:19:44.344493Z",
+          "replacement_ref": "state://workplans/{topic_slug}",
+          "owner_component": "state-hub.mcp",
+          "status": "legacy",
+          "replacement_verified": true,
+          "manual_hold": false,
+          "hold_reason": null,
+          "notes": "Registered by STATE-WP-0070 T03 \u2014 zero-window streak starts at registration",
+          "retired_at": null,
+          "created_at": "2026-07-10T13:19:44.344493Z",
+          "updated_at": "2026-07-10T13:19:44.344493Z"
+        },
+        "all_time": {
+          "calls": 1,
+          "tenant_count": 1,
+          "user_count": 1,
+          "component_count": 1,
+          "tenants": {
+            "unknown": 1
+          },
+          "users": {
+            "unknown": 1
+          },
+          "components": {
+            "state-hub.mcp": 1
+          }
+        },
+        "window": {
+          "calls": 0,
+          "tenant_count": 0,
+          "user_count": 0,
+          "component_count": 0,
+          "tenants": {},
+          "users": {},
+          "components": {}
+        },
+        "last_seen_at": "2026-07-10T13:20:34.491811Z",
+        "retirement_candidate": true,
+        "retirement_reason": "no measured usage in review window"
+      },
+      {
+        "interface": {
+          "id": "cd9342fd-27e7-4a46-a1be-d41499e106a3",
+          "interface_key": "rest_api:DELETE /workstreams/{workstream_id}",
+          "interface_kind": "rest_api",
+          "legacy_since": "2026-06-06T17:28:13.052813Z",
+          "replacement_ref": "/workplans/{workplan_id}",
+          "owner_component": "state-hub.api",
+          "status": "legacy",
+          "replacement_verified": true,
+          "manual_hold": false,
+          "hold_reason": null,
+          "notes": null,
+          "retired_at": null,
+          "created_at": "2026-06-06T17:28:13.052813Z",
+          "updated_at": "2026-06-06T17:28:13.052813Z"
+        },
+        "all_time": {
+          "calls": 1,
+          "tenant_count": 1,
+          "user_count": 1,
+          "component_count": 1,
+          "tenants": {
+            "unknown": 1
+          },
+          "users": {
+            "unknown": 1
+          },
+          "components": {
+            "unknown": 1
+          }
+        },
+        "window": {
+          "calls": 0,
+          "tenant_count": 0,
+          "user_count": 0,
+          "component_count": 0,
+          "tenants": {},
+          "users": {},
+          "components": {}
+        },
+        "last_seen_at": "2026-06-06T17:28:13.047529Z",
+        "retirement_candidate": true,
+        "retirement_reason": "no measured usage in review window"
+      },
+      {
+        "interface": {
+          "id": "a4e0948c-cd4a-461e-8ae2-7fd7b51d04a7",
+          "interface_key": "rest_api:GET /decisions/?workstream_id",
+          "interface_kind": "rest_api",
+          "legacy_since": "2026-07-09T23:07:53.093223Z",
+          "replacement_ref": "/decisions/?workplan_id=<workplan_id>",
+          "owner_component": "state-hub.api",
+          "status": "legacy",
+          "replacement_verified": true,
+          "manual_hold": false,
+          "hold_reason": null,
+          "notes": null,
+          "retired_at": null,
+          "created_at": "2026-07-09T23:07:53.093223Z",
+          "updated_at": "2026-07-09T23:07:53.093223Z"
+        },
+        "all_time": {
+          "calls": 1,
+          "tenant_count": 1,
+          "user_count": 1,
+          "component_count": 1,
+          "tenants": {
+            "unknown": 1
+          },
+          "users": {
+            "unknown": 1
+          },
+          "components": {
+            "unknown": 1
+          }
+        },
+        "window": {
+          "calls": 0,
+          "tenant_count": 0,
+          "user_count": 0,
+          "component_count": 0,
+          "tenants": {},
+          "users": {},
+          "components": {}
+        },
+        "last_seen_at": "2026-07-09T23:07:53.083299Z",
+        "retirement_candidate": true,
+        "retirement_reason": "no measured usage in review window"
+      },
+      {
+        "interface": {
+          "id": "70a9346e-e0ee-42ac-874f-f160580b54dd",
+          "interface_key": "rest_api:GET /progress/?workstream_id",
+          "interface_kind": "rest_api",
+          "legacy_since": "2026-07-13T22:04:03.911449Z",
+          "replacement_ref": "/progress/?workplan_id=<workplan_id>",
+          "owner_component": "state-hub.api",
+          "status": "legacy",
+          "replacement_verified": true,
+          "manual_hold": false,
+          "hold_reason": null,
+          "notes": null,
+          "retired_at": null,
+          "created_at": "2026-07-13T22:04:03.911449Z",
+          "updated_at": "2026-07-13T22:04:03.911449Z"
+        },
+        "all_time": {
+          "calls": 1,
+          "tenant_count": 1,
+          "user_count": 1,
+          "component_count": 1,
+          "tenants": {
+            "unknown": 1
+          },
+          "users": {
+            "unknown": 1
+          },
+          "components": {
+            "unknown": 1
+          }
+        },
+        "window": {
+          "calls": 0,
+          "tenant_count": 0,
+          "user_count": 0,
+          "component_count": 0,
+          "tenants": {},
+          "users": {},
+          "components": {}
+        },
+        "last_seen_at": "2026-07-13T22:04:03.904998Z",
+        "retirement_candidate": true,
+        "retirement_reason": "no measured usage in review window"
+      },
+      {
+        "interface": {
+          "id": "be3cdcf8-250b-4bf0-801f-02ffd5f57e00",
+          "interface_key": "rest_api:GET /tasks/?workstream_id",
+          "interface_kind": "rest_api",
+          "legacy_since": "2026-07-08T19:32:21.628513Z",
+          "replacement_ref": "/tasks/?workplan_id=<workplan_id>",
+          "owner_component": "state-hub.api",
+          "status": "legacy",
+          "replacement_verified": true,
+          "manual_hold": false,
+          "hold_reason": null,
+          "notes": null,
+          "retired_at": null,
+          "created_at": "2026-07-08T19:32:21.628513Z",
+          "updated_at": "2026-07-08T19:32:21.628513Z"
+        },
+        "all_time": {
+          "calls": 583,
+          "tenant_count": 1,
+          "user_count": 1,
+          "component_count": 1,
+          "tenants": {
+            "unknown": 583
+          },
+          "users": {
+            "unknown": 583
+          },
+          "components": {
+            "unknown": 583
+          }
+        },
+        "window": {
+          "calls": 5,
+          "tenant_count": 1,
+          "user_count": 1,
+          "component_count": 1,
+          "tenants": {
+            "unknown": 5
+          },
+          "users": {
+            "unknown": 5
+          },
+          "components": {
+            "unknown": 5
+          }
+        },
+        "last_seen_at": "2026-07-16T12:36:43.901956Z",
+        "retirement_candidate": false,
+        "retirement_reason": "5 call(s) in review window"
+      },
+      {
+        "interface": {
+          "id": "3e4a3d0b-08fa-45c3-91e2-4f514a914b97",
+          "interface_key": "rest_api:GET /workstreams/",
+          "interface_kind": "rest_api",
+          "legacy_since": "2026-06-04T00:26:14.533764Z",
+          "replacement_ref": "/workplans/",
+          "owner_component": "state-hub.api",
+          "status": "legacy",
+          "replacement_verified": true,
+          "manual_hold": false,
+          "hold_reason": null,
+          "notes": null,
+          "retired_at": null,
+          "created_at": "2026-06-04T00:26:14.533764Z",
+          "updated_at": "2026-06-04T00:26:14.533764Z"
+        },
+        "all_time": {
+          "calls": 144084,
+          "tenant_count": 1,
+          "user_count": 1,
+          "component_count": 1,
+          "tenants": {
+            "unknown": 144084
+          },
+          "users": {
+            "unknown": 144084
+          },
+          "components": {
+            "unknown": 144084
+          }
+        },
+        "window": {
+          "calls": 0,
+          "tenant_count": 0,
+          "user_count": 0,
+          "component_count": 0,
+          "tenants": {},
+          "users": {},
+          "components": {}
+        },
+        "last_seen_at": "2026-07-08T21:14:39.652776Z",
+        "retirement_candidate": true,
+        "retirement_reason": "no measured usage in review window"
+      },
+      {
+        "interface": {
+          "id": "e4c140ec-7479-46f9-b185-4b533f19d639",
+          "interface_key": "rest_api:GET /workstreams/workplan-index",
+          "interface_kind": "rest_api",
+          "legacy_since": "2026-06-04T05:20:58.321869Z",
+          "replacement_ref": "/workplans/index",
+          "owner_component": "state-hub.api",
+          "status": "legacy",
+          "replacement_verified": true,
+          "manual_hold": false,
+          "hold_reason": null,
+          "notes": null,
+          "retired_at": null,
+          "created_at": "2026-06-04T05:20:58.321869Z",
+          "updated_at": "2026-06-04T05:20:58.321869Z"
+        },
+        "all_time": {
+          "calls": 30,
+          "tenant_count": 1,
+          "user_count": 1,
+          "component_count": 1,
+          "tenants": {
+            "unknown": 30
+          },
+          "users": {
+            "unknown": 30
+          },
+          "components": {
+            "unknown": 30
+          }
+        },
+        "window": {
+          "calls": 0,
+          "tenant_count": 0,
+          "user_count": 0,
+          "component_count": 0,
+          "tenants": {},
+          "users": {},
+          "components": {}
+        },
+        "last_seen_at": "2026-07-03T05:20:34.534439Z",
+        "retirement_candidate": true,
+        "retirement_reason": "no measured usage in review window"
+      },
+      {
+        "interface": {
+          "id": "3a00b19e-e7db-4403-98aa-a77c9ab61ecc",
+          "interface_key": "rest_api:GET /workstreams/{workstream_id}",
+          "interface_kind": "rest_api",
+          "legacy_since": "2026-06-04T00:25:59.014966Z",
+          "replacement_ref": "/workplans/{workplan_id}",
+          "owner_component": "state-hub.api",
+          "status": "legacy",
+          "replacement_verified": true,
+          "manual_hold": false,
+          "hold_reason": null,
+          "notes": null,
+          "retired_at": null,
+          "created_at": "2026-06-04T00:25:59.014966Z",
+          "updated_at": "2026-06-04T00:25:59.014966Z"
+        },
+        "all_time": {
+          "calls": 511405,
+          "tenant_count": 1,
+          "user_count": 1,
+          "component_count": 1,
+          "tenants": {
+            "unknown": 511405
+          },
+          "users": {
+            "unknown": 511405
+          },
+          "components": {
+            "unknown": 511405
+          }
+        },
+        "window": {
+          "calls": 0,
+          "tenant_count": 0,
+          "user_count": 0,
+          "component_count": 0,
+          "tenants": {},
+          "users": {},
+          "components": {}
+        },
+        "last_seen_at": "2026-07-08T21:14:20.781103Z",
+        "retirement_candidate": true,
+        "retirement_reason": "no measured usage in review window"
+      },
+      {
+        "interface": {
+          "id": "69e1a255-a8b9-4101-8a68-b1bed23abfda",
+          "interface_key": "rest_api:GET /workstreams/{workstream_id}/dependencies/",
+          "interface_kind": "rest_api",
+          "legacy_since": "2026-06-04T00:25:59.291135Z",
+          "replacement_ref": "/workplans/{workplan_id}/dependencies/",
+          "owner_component": "state-hub.api",
+          "status": "legacy",
+          "replacement_verified": true,
+          "manual_hold": false,
+          "hold_reason": null,
+          "notes": null,
+          "retired_at": null,
+          "created_at": "2026-06-04T00:25:59.291135Z",
+          "updated_at": "2026-06-04T00:25:59.291135Z"
+        },
+        "all_time": {
+          "calls": 255865,
+          "tenant_count": 1,
+          "user_count": 1,
+          "component_count": 1,
+          "tenants": {
+            "unknown": 255865
+          },
+          "users": {
+            "unknown": 255865
+          },
+          "components": {
+            "unknown": 255865
+          }
+        },
+        "window": {
+          "calls": 0,
+          "tenant_count": 0,
+          "user_count": 0,
+          "component_count": 0,
+          "tenants": {},
+          "users": {},
+          "components": {}
+        },
+        "last_seen_at": "2026-07-08T21:14:12.747005Z",
+        "retirement_candidate": true,
+        "retirement_reason": "no measured usage in review window"
+      },
+      {
+        "interface": {
+          "id": "b1aae931-b51f-4a85-a723-865dd65f6132",
+          "interface_key": "rest_api:PATCH /workstreams/{workstream_id}",
+          "interface_kind": "rest_api",
+          "legacy_since": "2026-06-04T06:09:41.901035Z",
+          "replacement_ref": "/workplans/{workplan_id}",
+          "owner_component": "state-hub.api",
+          "status": "legacy",
+          "replacement_verified": true,
+          "manual_hold": false,
+          "hold_reason": null,
+          "notes": null,
+          "retired_at": null,
+          "created_at": "2026-06-04T06:09:41.901035Z",
+          "updated_at": "2026-06-04T06:09:41.901035Z"
+        },
+        "all_time": {
+          "calls": 571,
+          "tenant_count": 1,
+          "user_count": 1,
+          "component_count": 1,
+          "tenants": {
+            "unknown": 571
+          },
+          "users": {
+            "unknown": 571
+          },
+          "components": {
+            "unknown": 571
+          }
+        },
+        "window": {
+          "calls": 0,
+          "tenant_count": 0,
+          "user_count": 0,
+          "component_count": 0,
+          "tenants": {},
+          "users": {},
+          "components": {}
+        },
+        "last_seen_at": "2026-07-08T20:49:12.335710Z",
+        "retirement_candidate": true,
+        "retirement_reason": "no measured usage in review window"
+      },
+      {
+        "interface": {
+          "id": "4aea9591-970b-4918-ac4a-4da95a0a1a8c",
+          "interface_key": "rest_api:POST /decisions/ workstream_id",
+          "interface_kind": "rest_api",
+          "legacy_since": "2026-07-09T22:56:35.473130Z",
+          "replacement_ref": "POST /decisions/ with workplan_id",
+          "owner_component": "state-hub.api",
+          "status": "legacy",
+          "replacement_verified": true,
+          "manual_hold": false,
+          "hold_reason": null,
+          "notes": null,
+          "retired_at": null,
+          "created_at": "2026-07-09T22:56:35.473130Z",
+          "updated_at": "2026-07-09T22:56:35.473130Z"
+        },
+        "all_time": {
+          "calls": 3,
+          "tenant_count": 1,
+          "user_count": 1,
+          "component_count": 1,
+          "tenants": {
+            "unknown": 3
+          },
+          "users": {
+            "unknown": 3
+          },
+          "components": {
+            "unknown": 3
+          }
+        },
+        "window": {
+          "calls": 0,
+          "tenant_count": 0,
+          "user_count": 0,
+          "component_count": 0,
+          "tenants": {},
+          "users": {},
+          "components": {}
+        },
+        "last_seen_at": "2026-07-09T22:57:05.912456Z",
+        "retirement_candidate": true,
+        "retirement_reason": "no measured usage in review window"
+      },
+      {
+        "interface": {
+          "id": "4a70583c-1e41-4ec1-99a9-728856a7d79c",
+          "interface_key": "rest_api:POST /progress/ workstream_id",
+          "interface_kind": "rest_api",
+          "legacy_since": "2026-07-08T23:35:09.148333Z",
+          "replacement_ref": "POST /progress/ with workplan_id",
+          "owner_component": "state-hub.api",
+          "status": "legacy",
+          "replacement_verified": true,
+          "manual_hold": false,
+          "hold_reason": null,
+          "notes": null,
+          "retired_at": null,
+          "created_at": "2026-07-08T23:35:09.148333Z",
+          "updated_at": "2026-07-08T23:35:09.148333Z"
+        },
+        "all_time": {
+          "calls": 14,
+          "tenant_count": 1,
+          "user_count": 1,
+          "component_count": 1,
+          "tenants": {
+            "unknown": 14
+          },
+          "users": {
+            "unknown": 14
+          },
+          "components": {
+            "unknown": 14
+          }
+        },
+        "window": {
+          "calls": 0,
+          "tenant_count": 0,
+          "user_count": 0,
+          "component_count": 0,
+          "tenants": {},
+          "users": {},
+          "components": {}
+        },
+        "last_seen_at": "2026-07-10T08:34:42.959724Z",
+        "retirement_candidate": true,
+        "retirement_reason": "no measured usage in review window"
+      },
+      {
+        "interface": {
+          "id": "6df4e443-7bf1-461a-923b-a6eb52fe7b07",
+          "interface_key": "rest_api:POST /tasks/ workstream_id",
+          "interface_kind": "rest_api",
+          "legacy_since": "2026-07-08T22:38:29.405720Z",
+          "replacement_ref": "POST /tasks/ with workplan_id",
+          "owner_component": "state-hub.api",
+          "status": "legacy",
+          "replacement_verified": true,
+          "manual_hold": false,
+          "hold_reason": null,
+          "notes": null,
+          "retired_at": null,
+          "created_at": "2026-07-08T22:38:29.405720Z",
+          "updated_at": "2026-07-08T22:38:29.405720Z"
+        },
+        "all_time": {
+          "calls": 5,
+          "tenant_count": 1,
+          "user_count": 1,
+          "component_count": 1,
+          "tenants": {
+            "unknown": 5
+          },
+          "users": {
+            "unknown": 5
+          },
+          "components": {
+            "state-hub.fix-consistency": 5
+          }
+        },
+        "window": {
+          "calls": 0,
+          "tenant_count": 0,
+          "user_count": 0,
+          "component_count": 0,
+          "tenants": {},
+          "users": {},
+          "components": {}
+        },
+        "last_seen_at": "2026-07-08T22:38:29.976918Z",
+        "retirement_candidate": true,
+        "retirement_reason": "no measured usage in review window"
+      },
+      {
+        "interface": {
+          "id": "ed6451c9-d2cc-4486-9afe-d3852782cabc",
+          "interface_key": "rest_api:POST /workstreams/",
+          "interface_kind": "rest_api",
+          "legacy_since": "2026-06-04T07:40:24.168535Z",
+          "replacement_ref": "/workplans/",
+          "owner_component": "state-hub.api",
+          "status": "legacy",
+          "replacement_verified": true,
+          "manual_hold": false,
+          "hold_reason": null,
+          "notes": null,
+          "retired_at": null,
+          "created_at": "2026-06-04T07:40:24.168535Z",
+          "updated_at": "2026-06-04T07:40:24.168535Z"
+        },
+        "all_time": {
+          "calls": 824,
+          "tenant_count": 1,
+          "user_count": 1,
+          "component_count": 1,
+          "tenants": {
+            "unknown": 824
+          },
+          "users": {
+            "unknown": 824
+          },
+          "components": {
+            "unknown": 824
+          }
+        },
+        "window": {
+          "calls": 0,
+          "tenant_count": 0,
+          "user_count": 0,
+          "component_count": 0,
+          "tenants": {},
+          "users": {},
+          "components": {}
+        },
+        "last_seen_at": "2026-07-08T20:38:05.903144Z",
+        "retirement_candidate": true,
+        "retirement_reason": "no measured usage in review window"
+      },
+      {
+        "interface": {
+          "id": "281fd706-b192-4194-8055-2d8733c115f9",
+          "interface_key": "rest_api:POST /workstreams/{workstream_id}/dependencies/",
+          "interface_kind": "rest_api",
+          "legacy_since": "2026-06-04T22:57:37.149207Z",
+          "replacement_ref": "/workplans/{workplan_id}/dependencies/",
+          "owner_component": "state-hub.api",
+          "status": "legacy",
+          "replacement_verified": true,
+          "manual_hold": false,
+          "hold_reason": null,
+          "notes": null,
+          "retired_at": null,
+          "created_at": "2026-06-04T22:57:37.149207Z",
+          "updated_at": "2026-06-04T22:57:37.149207Z"
+        },
+        "all_time": {
+          "calls": 4971,
+          "tenant_count": 1,
+          "user_count": 1,
+          "component_count": 1,
+          "tenants": {
+            "unknown": 4971
+          },
+          "users": {
+            "unknown": 4971
+          },
+          "components": {
+            "unknown": 4971
+          }
+        },
+        "window": {
+          "calls": 0,
+          "tenant_count": 0,
+          "user_count": 0,
+          "component_count": 0,
+          "tenants": {},
+          "users": {},
+          "components": {}
+        },
+        "last_seen_at": "2026-07-01T22:09:24.229011Z",
+        "retirement_candidate": true,
+        "retirement_reason": "no measured usage in review window"
+      }
+    ],
+    "retirement_candidates": [
+      {
+        "interface": {
+          "id": "63ed90e3-42b4-431a-94db-e1254a52f9e2",
+          "interface_key": "mcp:create_workstream",
+          "interface_kind": "mcp_tool",
+          "legacy_since": "2026-07-10T13:19:44.205900Z",
+          "replacement_ref": "create_workplan",
+          "owner_component": "state-hub.mcp",
+          "status": "legacy",
+          "replacement_verified": true,
+          "manual_hold": false,
+          "hold_reason": null,
+          "notes": "Registered by STATE-WP-0070 T03 \u2014 zero-window streak starts at registration",
+          "retired_at": null,
+          "created_at": "2026-07-10T13:19:44.205900Z",
+          "updated_at": "2026-07-10T13:19:44.205900Z"
+        },
+        "all_time": {
+          "calls": 2,
+          "tenant_count": 1,
+          "user_count": 1,
+          "component_count": 1,
+          "tenants": {
+            "unknown": 2
+          },
+          "users": {
+            "unknown": 2
+          },
+          "components": {
+            "state-hub.mcp": 2
+          }
+        },
+        "window": {
+          "calls": 0,
+          "tenant_count": 0,
+          "user_count": 0,
+          "component_count": 0,
+          "tenants": {},
+          "users": {},
+          "components": {}
+        },
+        "last_seen_at": "2026-07-10T13:20:43.378546Z",
+        "retirement_candidate": true,
+        "retirement_reason": "no measured usage in review window"
+      },
+      {
+        "interface": {
+          "id": "b6a5fe44-fb85-4ef7-a273-78d09da777af",
+          "interface_key": "mcp:list_workstreams",
+          "interface_kind": "mcp_tool",
+          "legacy_since": "2026-07-10T13:19:26.075491Z",
+          "replacement_ref": "list_workplans",
+          "owner_component": "state-hub.mcp",
+          "status": "legacy",
+          "replacement_verified": true,
+          "manual_hold": false,
+          "hold_reason": null,
+          "notes": null,
+          "retired_at": null,
+          "created_at": "2026-07-10T13:19:26.075491Z",
+          "updated_at": "2026-07-10T13:19:26.075491Z"
+        },
+        "all_time": {
+          "calls": 2,
+          "tenant_count": 1,
+          "user_count": 1,
+          "component_count": 1,
+          "tenants": {
+            "unknown": 2
+          },
+          "users": {
+            "unknown": 2
+          },
+          "components": {
+            "state-hub.mcp": 2
+          }
+        },
+        "window": {
+          "calls": 0,
+          "tenant_count": 0,
+          "user_count": 0,
+          "component_count": 0,
+          "tenants": {},
+          "users": {},
+          "components": {}
+        },
+        "last_seen_at": "2026-07-10T13:20:42.374940Z",
+        "retirement_candidate": true,
+        "retirement_reason": "no measured usage in review window"
+      },
+      {
+        "interface": {
+          "id": "53c3372b-307d-4d6a-8ea4-bc36cacdcaf2",
+          "interface_key": "mcp:update_workstream",
+          "interface_kind": "mcp_tool",
+          "legacy_since": "2026-07-10T13:19:44.255216Z",
+          "replacement_ref": "update_workplan",
+          "owner_component": "state-hub.mcp",
+          "status": "legacy",
+          "replacement_verified": true,
+          "manual_hold": false,
+          "hold_reason": null,
+          "notes": "Registered by STATE-WP-0070 T03 \u2014 zero-window streak starts at registration",
+          "retired_at": null,
+          "created_at": "2026-07-10T13:19:44.255216Z",
+          "updated_at": "2026-07-10T13:19:44.255216Z"
+        },
+        "all_time": {
+          "calls": 0,
+          "tenant_count": 0,
+          "user_count": 0,
+          "component_count": 0,
+          "tenants": {},
+          "users": {},
+          "components": {}
+        },
+        "window": {
+          "calls": 0,
+          "tenant_count": 0,
+          "user_count": 0,
+          "component_count": 0,
+          "tenants": {},
+          "users": {},
+          "components": {}
+        },
+        "last_seen_at": null,
+        "retirement_candidate": true,
+        "retirement_reason": "no measured usage in review window"
+      },
+      {
+        "interface": {
+          "id": "bed4d08a-3471-48f5-9f0e-f9d550383a26",
+          "interface_key": "mcp:update_workstream_status",
+          "interface_kind": "mcp_tool",
+          "legacy_since": "2026-07-10T13:19:44.303612Z",
+          "replacement_ref": "update_workplan_status",
+          "owner_component": "state-hub.mcp",
+          "status": "legacy",
+          "replacement_verified": true,
+          "manual_hold": false,
+          "hold_reason": null,
+          "notes": "Registered by STATE-WP-0070 T03 \u2014 zero-window streak starts at registration",
+          "retired_at": null,
+          "created_at": "2026-07-10T13:19:44.303612Z",
+          "updated_at": "2026-07-10T13:19:44.303612Z"
+        },
+        "all_time": {
+          "calls": 0,
+          "tenant_count": 0,
+          "user_count": 0,
+          "component_count": 0,
+          "tenants": {},
+          "users": {},
+          "components": {}
+        },
+        "window": {
+          "calls": 0,
+          "tenant_count": 0,
+          "user_count": 0,
+          "component_count": 0,
+          "tenants": {},
+          "users": {},
+          "components": {}
+        },
+        "last_seen_at": null,
+        "retirement_candidate": true,
+        "retirement_reason": "no measured usage in review window"
+      },
+      {
+        "interface": {
+          "id": "46900dc2-0893-405b-ba59-80f31fb6ebb1",
+          "interface_key": "state://workstreams/{topic_slug}",
+          "interface_kind": "mcp_tool",
+          "legacy_since": "2026-07-10T13:19:44.344493Z",
+          "replacement_ref": "state://workplans/{topic_slug}",
+          "owner_component": "state-hub.mcp",
+          "status": "legacy",
+          "replacement_verified": true,
+          "manual_hold": false,
+          "hold_reason": null,
+          "notes": "Registered by STATE-WP-0070 T03 \u2014 zero-window streak starts at registration",
+          "retired_at": null,
+          "created_at": "2026-07-10T13:19:44.344493Z",
+          "updated_at": "2026-07-10T13:19:44.344493Z"
+        },
+        "all_time": {
+          "calls": 1,
+          "tenant_count": 1,
+          "user_count": 1,
+          "component_count": 1,
+          "tenants": {
+            "unknown": 1
+          },
+          "users": {
+            "unknown": 1
+          },
+          "components": {
+            "state-hub.mcp": 1
+          }
+        },
+        "window": {
+          "calls": 0,
+          "tenant_count": 0,
+          "user_count": 0,
+          "component_count": 0,
+          "tenants": {},
+          "users": {},
+          "components": {}
+        },
+        "last_seen_at": "2026-07-10T13:20:34.491811Z",
+        "retirement_candidate": true,
+        "retirement_reason": "no measured usage in review window"
+      },
+      {
+        "interface": {
+          "id": "cd9342fd-27e7-4a46-a1be-d41499e106a3",
+          "interface_key": "rest_api:DELETE /workstreams/{workstream_id}",
+          "interface_kind": "rest_api",
+          "legacy_since": "2026-06-06T17:28:13.052813Z",
+          "replacement_ref": "/workplans/{workplan_id}",
+          "owner_component": "state-hub.api",
+          "status": "legacy",
+          "replacement_verified": true,
+          "manual_hold": false,
+          "hold_reason": null,
+          "notes": null,
+          "retired_at": null,
+          "created_at": "2026-06-06T17:28:13.052813Z",
+          "updated_at": "2026-06-06T17:28:13.052813Z"
+        },
+        "all_time": {
+          "calls": 1,
+          "tenant_count": 1,
+          "user_count": 1,
+          "component_count": 1,
+          "tenants": {
+            "unknown": 1
+          },
+          "users": {
+            "unknown": 1
+          },
+          "components": {
+            "unknown": 1
+          }
+        },
+        "window": {
+          "calls": 0,
+          "tenant_count": 0,
+          "user_count": 0,
+          "component_count": 0,
+          "tenants": {},
+          "users": {},
+          "components": {}
+        },
+        "last_seen_at": "2026-06-06T17:28:13.047529Z",
+        "retirement_candidate": true,
+        "retirement_reason": "no measured usage in review window"
+      },
+      {
+        "interface": {
+          "id": "a4e0948c-cd4a-461e-8ae2-7fd7b51d04a7",
+          "interface_key": "rest_api:GET /decisions/?workstream_id",
+          "interface_kind": "rest_api",
+          "legacy_since": "2026-07-09T23:07:53.093223Z",
+          "replacement_ref": "/decisions/?workplan_id=<workplan_id>",
+          "owner_component": "state-hub.api",
+          "status": "legacy",
+          "replacement_verified": true,
+          "manual_hold": false,
+          "hold_reason": null,
+          "notes": null,
+          "retired_at": null,
+          "created_at": "2026-07-09T23:07:53.093223Z",
+          "updated_at": "2026-07-09T23:07:53.093223Z"
+        },
+        "all_time": {
+          "calls": 1,
+          "tenant_count": 1,
+          "user_count": 1,
+          "component_count": 1,
+          "tenants": {
+            "unknown": 1
+          },
+          "users": {
+            "unknown": 1
+          },
+          "components": {
+            "unknown": 1
+          }
+        },
+        "window": {
+          "calls": 0,
+          "tenant_count": 0,
+          "user_count": 0,
+          "component_count": 0,
+          "tenants": {},
+          "users": {},
+          "components": {}
+        },
+        "last_seen_at": "2026-07-09T23:07:53.083299Z",
+        "retirement_candidate": true,
+        "retirement_reason": "no measured usage in review window"
+      },
+      {
+        "interface": {
+          "id": "70a9346e-e0ee-42ac-874f-f160580b54dd",
+          "interface_key": "rest_api:GET /progress/?workstream_id",
+          "interface_kind": "rest_api",
+          "legacy_since": "2026-07-13T22:04:03.911449Z",
+          "replacement_ref": "/progress/?workplan_id=<workplan_id>",
+          "owner_component": "state-hub.api",
+          "status": "legacy",
+          "replacement_verified": true,
+          "manual_hold": false,
+          "hold_reason": null,
+          "notes": null,
+          "retired_at": null,
+          "created_at": "2026-07-13T22:04:03.911449Z",
+          "updated_at": "2026-07-13T22:04:03.911449Z"
+        },
+        "all_time": {
+          "calls": 1,
+          "tenant_count": 1,
+          "user_count": 1,
+          "component_count": 1,
+          "tenants": {
+            "unknown": 1
+          },
+          "users": {
+            "unknown": 1
+          },
+          "components": {
+            "unknown": 1
+          }
+        },
+        "window": {
+          "calls": 0,
+          "tenant_count": 0,
+          "user_count": 0,
+          "component_count": 0,
+          "tenants": {},
+          "users": {},
+          "components": {}
+        },
+        "last_seen_at": "2026-07-13T22:04:03.904998Z",
+        "retirement_candidate": true,
+        "retirement_reason": "no measured usage in review window"
+      },
+      {
+        "interface": {
+          "id": "3e4a3d0b-08fa-45c3-91e2-4f514a914b97",
+          "interface_key": "rest_api:GET /workstreams/",
+          "interface_kind": "rest_api",
+          "legacy_since": "2026-06-04T00:26:14.533764Z",
+          "replacement_ref": "/workplans/",
+          "owner_component": "state-hub.api",
+          "status": "legacy",
+          "replacement_verified": true,
+          "manual_hold": false,
+          "hold_reason": null,
+          "notes": null,
+          "retired_at": null,
+          "created_at": "2026-06-04T00:26:14.533764Z",
+          "updated_at": "2026-06-04T00:26:14.533764Z"
+        },
+        "all_time": {
+          "calls": 144084,
+          "tenant_count": 1,
+          "user_count": 1,
+          "component_count": 1,
+          "tenants": {
+            "unknown": 144084
+          },
+          "users": {
+            "unknown": 144084
+          },
+          "components": {
+            "unknown": 144084
+          }
+        },
+        "window": {
+          "calls": 0,
+          "tenant_count": 0,
+          "user_count": 0,
+          "component_count": 0,
+          "tenants": {},
+          "users": {},
+          "components": {}
+        },
+        "last_seen_at": "2026-07-08T21:14:39.652776Z",
+        "retirement_candidate": true,
+        "retirement_reason": "no measured usage in review window"
+      },
+      {
+        "interface": {
+          "id": "e4c140ec-7479-46f9-b185-4b533f19d639",
+          "interface_key": "rest_api:GET /workstreams/workplan-index",
+          "interface_kind": "rest_api",
+          "legacy_since": "2026-06-04T05:20:58.321869Z",
+          "replacement_ref": "/workplans/index",
+          "owner_component": "state-hub.api",
+          "status": "legacy",
+          "replacement_verified": true,
+          "manual_hold": false,
+          "hold_reason": null,
+          "notes": null,
+          "retired_at": null,
+          "created_at": "2026-06-04T05:20:58.321869Z",
+          "updated_at": "2026-06-04T05:20:58.321869Z"
+        },
+        "all_time": {
+          "calls": 30,
+          "tenant_count": 1,
+          "user_count": 1,
+          "component_count": 1,
+          "tenants": {
+            "unknown": 30
+          },
+          "users": {
+            "unknown": 30
+          },
+          "components": {
+            "unknown": 30
+          }
+        },
+        "window": {
+          "calls": 0,
+          "tenant_count": 0,
+          "user_count": 0,
+          "component_count": 0,
+          "tenants": {},
+          "users": {},
+          "components": {}
+        },
+        "last_seen_at": "2026-07-03T05:20:34.534439Z",
+        "retirement_candidate": true,
+        "retirement_reason": "no measured usage in review window"
+      },
+      {
+        "interface": {
+          "id": "3a00b19e-e7db-4403-98aa-a77c9ab61ecc",
+          "interface_key": "rest_api:GET /workstreams/{workstream_id}",
+          "interface_kind": "rest_api",
+          "legacy_since": "2026-06-04T00:25:59.014966Z",
+          "replacement_ref": "/workplans/{workplan_id}",
+          "owner_component": "state-hub.api",
+          "status": "legacy",
+          "replacement_verified": true,
+          "manual_hold": false,
+          "hold_reason": null,
+          "notes": null,
+          "retired_at": null,
+          "created_at": "2026-06-04T00:25:59.014966Z",
+          "updated_at": "2026-06-04T00:25:59.014966Z"
+        },
+        "all_time": {
+          "calls": 511405,
+          "tenant_count": 1,
+          "user_count": 1,
+          "component_count": 1,
+          "tenants": {
+            "unknown": 511405
+          },
+          "users": {
+            "unknown": 511405
+          },
+          "components": {
+            "unknown": 511405
+          }
+        },
+        "window": {
+          "calls": 0,
+          "tenant_count": 0,
+          "user_count": 0,
+          "component_count": 0,
+          "tenants": {},
+          "users": {},
+          "components": {}
+        },
+        "last_seen_at": "2026-07-08T21:14:20.781103Z",
+        "retirement_candidate": true,
+        "retirement_reason": "no measured usage in review window"
+      },
+      {
+        "interface": {
+          "id": "69e1a255-a8b9-4101-8a68-b1bed23abfda",
+          "interface_key": "rest_api:GET /workstreams/{workstream_id}/dependencies/",
+          "interface_kind": "rest_api",
+          "legacy_since": "2026-06-04T00:25:59.291135Z",
+          "replacement_ref": "/workplans/{workplan_id}/dependencies/",
+          "owner_component": "state-hub.api",
+          "status": "legacy",
+          "replacement_verified": true,
+          "manual_hold": false,
+          "hold_reason": null,
+          "notes": null,
+          "retired_at": null,
+          "created_at": "2026-06-04T00:25:59.291135Z",
+          "updated_at": "2026-06-04T00:25:59.291135Z"
+        },
+        "all_time": {
+          "calls": 255865,
+          "tenant_count": 1,
+          "user_count": 1,
+          "component_count": 1,
+          "tenants": {
+            "unknown": 255865
+          },
+          "users": {
+            "unknown": 255865
+          },
+          "components": {
+            "unknown": 255865
+          }
+        },
+        "window": {
+          "calls": 0,
+          "tenant_count": 0,
+          "user_count": 0,
+          "component_count": 0,
+          "tenants": {},
+          "users": {},
+          "components": {}
+        },
+        "last_seen_at": "2026-07-08T21:14:12.747005Z",
+        "retirement_candidate": true,
+        "retirement_reason": "no measured usage in review window"
+      },
+      {
+        "interface": {
+          "id": "b1aae931-b51f-4a85-a723-865dd65f6132",
+          "interface_key": "rest_api:PATCH /workstreams/{workstream_id}",
+          "interface_kind": "rest_api",
+          "legacy_since": "2026-06-04T06:09:41.901035Z",
+          "replacement_ref": "/workplans/{workplan_id}",
+          "owner_component": "state-hub.api",
+          "status": "legacy",
+          "replacement_verified": true,
+          "manual_hold": false,
+          "hold_reason": null,
+          "notes": null,
+          "retired_at": null,
+          "created_at": "2026-06-04T06:09:41.901035Z",
+          "updated_at": "2026-06-04T06:09:41.901035Z"
+        },
+        "all_time": {
+          "calls": 571,
+          "tenant_count": 1,
+          "user_count": 1,
+          "component_count": 1,
+          "tenants": {
+            "unknown": 571
+          },
+          "users": {
+            "unknown": 571
+          },
+          "components": {
+            "unknown": 571
+          }
+        },
+        "window": {
+          "calls": 0,
+          "tenant_count": 0,
+          "user_count": 0,
+          "component_count": 0,
+          "tenants": {},
+          "users": {},
+          "components": {}
+        },
+        "last_seen_at": "2026-07-08T20:49:12.335710Z",
+        "retirement_candidate": true,
+        "retirement_reason": "no measured usage in review window"
+      },
+      {
+        "interface": {
+          "id": "4aea9591-970b-4918-ac4a-4da95a0a1a8c",
+          "interface_key": "rest_api:POST /decisions/ workstream_id",
+          "interface_kind": "rest_api",
+          "legacy_since": "2026-07-09T22:56:35.473130Z",
+          "replacement_ref": "POST /decisions/ with workplan_id",
+          "owner_component": "state-hub.api",
+          "status": "legacy",
+          "replacement_verified": true,
+          "manual_hold": false,
+          "hold_reason": null,
+          "notes": null,
+          "retired_at": null,
+          "created_at": "2026-07-09T22:56:35.473130Z",
+          "updated_at": "2026-07-09T22:56:35.473130Z"
+        },
+        "all_time": {
+          "calls": 3,
+          "tenant_count": 1,
+          "user_count": 1,
+          "component_count": 1,
+          "tenants": {
+            "unknown": 3
+          },
+          "users": {
+            "unknown": 3
+          },
+          "components": {
+            "unknown": 3
+          }
+        },
+        "window": {
+          "calls": 0,
+          "tenant_count": 0,
+          "user_count": 0,
+          "component_count": 0,
+          "tenants": {},
+          "users": {},
+          "components": {}
+        },
+        "last_seen_at": "2026-07-09T22:57:05.912456Z",
+        "retirement_candidate": true,
+        "retirement_reason": "no measured usage in review window"
+      },
+      {
+        "interface": {
+          "id": "4a70583c-1e41-4ec1-99a9-728856a7d79c",
+          "interface_key": "rest_api:POST /progress/ workstream_id",
+          "interface_kind": "rest_api",
+          "legacy_since": "2026-07-08T23:35:09.148333Z",
+          "replacement_ref": "POST /progress/ with workplan_id",
+          "owner_component": "state-hub.api",
+          "status": "legacy",
+          "replacement_verified": true,
+          "manual_hold": false,
+          "hold_reason": null,
+          "notes": null,
+          "retired_at": null,
+          "created_at": "2026-07-08T23:35:09.148333Z",
+          "updated_at": "2026-07-08T23:35:09.148333Z"
+        },
+        "all_time": {
+          "calls": 14,
+          "tenant_count": 1,
+          "user_count": 1,
+          "component_count": 1,
+          "tenants": {
+            "unknown": 14
+          },
+          "users": {
+            "unknown": 14
+          },
+          "components": {
+            "unknown": 14
+          }
+        },
+        "window": {
+          "calls": 0,
+          "tenant_count": 0,
+          "user_count": 0,
+          "component_count": 0,
+          "tenants": {},
+          "users": {},
+          "components": {}
+        },
+        "last_seen_at": "2026-07-10T08:34:42.959724Z",
+        "retirement_candidate": true,
+        "retirement_reason": "no measured usage in review window"
+      },
+      {
+        "interface": {
+          "id": "6df4e443-7bf1-461a-923b-a6eb52fe7b07",
+          "interface_key": "rest_api:POST /tasks/ workstream_id",
+          "interface_kind": "rest_api",
+          "legacy_since": "2026-07-08T22:38:29.405720Z",
+          "replacement_ref": "POST /tasks/ with workplan_id",
+          "owner_component": "state-hub.api",
+          "status": "legacy",
+          "replacement_verified": true,
+          "manual_hold": false,
+          "hold_reason": null,
+          "notes": null,
+          "retired_at": null,
+          "created_at": "2026-07-08T22:38:29.405720Z",
+          "updated_at": "2026-07-08T22:38:29.405720Z"
+        },
+        "all_time": {
+          "calls": 5,
+          "tenant_count": 1,
+          "user_count": 1,
+          "component_count": 1,
+          "tenants": {
+            "unknown": 5
+          },
+          "users": {
+            "unknown": 5
+          },
+          "components": {
+            "state-hub.fix-consistency": 5
+          }
+        },
+        "window": {
+          "calls": 0,
+          "tenant_count": 0,
+          "user_count": 0,
+          "component_count": 0,
+          "tenants": {},
+          "users": {},
+          "components": {}
+        },
+        "last_seen_at": "2026-07-08T22:38:29.976918Z",
+        "retirement_candidate": true,
+        "retirement_reason": "no measured usage in review window"
+      },
+      {
+        "interface": {
+          "id": "ed6451c9-d2cc-4486-9afe-d3852782cabc",
+          "interface_key": "rest_api:POST /workstreams/",
+          "interface_kind": "rest_api",
+          "legacy_since": "2026-06-04T07:40:24.168535Z",
+          "replacement_ref": "/workplans/",
+          "owner_component": "state-hub.api",
+          "status": "legacy",
+          "replacement_verified": true,
+          "manual_hold": false,
+          "hold_reason": null,
+          "notes": null,
+          "retired_at": null,
+          "created_at": "2026-06-04T07:40:24.168535Z",
+          "updated_at": "2026-06-04T07:40:24.168535Z"
+        },
+        "all_time": {
+          "calls": 824,
+          "tenant_count": 1,
+          "user_count": 1,
+          "component_count": 1,
+          "tenants": {
+            "unknown": 824
+          },
+          "users": {
+            "unknown": 824
+          },
+          "components": {
+            "unknown": 824
+          }
+        },
+        "window": {
+          "calls": 0,
+          "tenant_count": 0,
+          "user_count": 0,
+          "component_count": 0,
+          "tenants": {},
+          "users": {},
+          "components": {}
+        },
+        "last_seen_at": "2026-07-08T20:38:05.903144Z",
+        "retirement_candidate": true,
+        "retirement_reason": "no measured usage in review window"
+      },
+      {
+        "interface": {
+          "id": "281fd706-b192-4194-8055-2d8733c115f9",
+          "interface_key": "rest_api:POST /workstreams/{workstream_id}/dependencies/",
+          "interface_kind": "rest_api",
+          "legacy_since": "2026-06-04T22:57:37.149207Z",
+          "replacement_ref": "/workplans/{workplan_id}/dependencies/",
+          "owner_component": "state-hub.api",
+          "status": "legacy",
+          "replacement_verified": true,
+          "manual_hold": false,
+          "hold_reason": null,
+          "notes": null,
+          "retired_at": null,
+          "created_at": "2026-06-04T22:57:37.149207Z",
+          "updated_at": "2026-06-04T22:57:37.149207Z"
+        },
+        "all_time": {
+          "calls": 4971,
+          "tenant_count": 1,
+          "user_count": 1,
+          "component_count": 1,
+          "tenants": {
+            "unknown": 4971
+          },
+          "users": {
+            "unknown": 4971
+          },
+          "components": {
+            "unknown": 4971
+          }
+        },
+        "window": {
+          "calls": 0,
+          "tenant_count": 0,
+          "user_count": 0,
+          "component_count": 0,
+          "tenants": {},
+          "users": {},
+          "components": {}
+        },
+        "last_seen_at": "2026-07-01T22:09:24.229011Z",
+        "retirement_candidate": true,
+        "retirement_reason": "no measured usage in review window"
+      }
+    ]
+  },
+  "hours": 8
+}
diff --git a/docs/evidence/legacy-meter-weekly-review-20260717.json b/docs/evidence/legacy-meter-weekly-review-20260717.json
new file mode 100644
index 0000000..5f02fc3
--- /dev/null
+++ b/docs/evidence/legacy-meter-weekly-review-20260717.json
@@ -0,0 +1,1755 @@
+{
+  "captured_at": "2026-07-17T14:00:08.022696+00:00",
+  "api_base": "http://127.0.0.1:8000",
+  "workplan": "STATE-WP-0070",
+  "retired_interfaces": [],
+  "weekly_review": {
+    "generated_at": "2026-07-17T14:00:07.987975Z",
+    "window_start": "2026-07-17T06:00:07.495685Z",
+    "window_end": "2026-07-17T14:00:07.495685Z",
+    "cadence": "weekly",
+    "activity_core_handoff": {
+      "activity_id": "statehub-legacy-interface-review",
+      "cadence": "weekly",
+      "source_endpoint": "/legacy-meter/weekly-review",
+      "state_owner": "state-hub",
+      "scheduler_owner": "activity-core"
+    },
+    "interfaces": [
+      {
+        "interface": {
+          "id": "8051fb40-66c9-4dc4-a413-13e8573e04a3",
+          "interface_key": "event_subject:org.statehub.workstream.completed",
+          "interface_kind": "event_subject",
+          "legacy_since": "2026-06-04T06:09:42.198193Z",
+          "replacement_ref": "org.statehub.workplan.completed",
+          "owner_component": "state-hub.events",
+          "status": "retired",
+          "replacement_verified": true,
+          "manual_hold": false,
+          "hold_reason": null,
+          "notes": "Retired by STATE-WP-0069 closeout",
+          "retired_at": "2026-07-08T21:38:52.773601Z",
+          "created_at": "2026-06-04T06:09:42.198193Z",
+          "updated_at": "2026-07-08T21:38:52.761243Z"
+        },
+        "all_time": {
+          "calls": 255,
+          "tenant_count": 1,
+          "user_count": 1,
+          "component_count": 1,
+          "tenants": {
+            "unknown": 255
+          },
+          "users": {
+            "unknown": 255
+          },
+          "components": {
+            "state-hub.events": 255
+          }
+        },
+        "window": {
+          "calls": 0,
+          "tenant_count": 0,
+          "user_count": 0,
+          "component_count": 0,
+          "tenants": {},
+          "users": {},
+          "components": {}
+        },
+        "last_seen_at": "2026-07-08T20:49:12.839383Z",
+        "retirement_candidate": false,
+        "retirement_reason": "already retired"
+      },
+      {
+        "interface": {
+          "id": "63ed90e3-42b4-431a-94db-e1254a52f9e2",
+          "interface_key": "mcp:create_workstream",
+          "interface_kind": "mcp_tool",
+          "legacy_since": "2026-07-10T13:19:44.205900Z",
+          "replacement_ref": "create_workplan",
+          "owner_component": "state-hub.mcp",
+          "status": "legacy",
+          "replacement_verified": true,
+          "manual_hold": false,
+          "hold_reason": null,
+          "notes": "Registered by STATE-WP-0070 T03 \u2014 zero-window streak starts at registration",
+          "retired_at": null,
+          "created_at": "2026-07-10T13:19:44.205900Z",
+          "updated_at": "2026-07-10T13:19:44.205900Z"
+        },
+        "all_time": {
+          "calls": 2,
+          "tenant_count": 1,
+          "user_count": 1,
+          "component_count": 1,
+          "tenants": {
+            "unknown": 2
+          },
+          "users": {
+            "unknown": 2
+          },
+          "components": {
+            "state-hub.mcp": 2
+          }
+        },
+        "window": {
+          "calls": 0,
+          "tenant_count": 0,
+          "user_count": 0,
+          "component_count": 0,
+          "tenants": {},
+          "users": {},
+          "components": {}
+        },
+        "last_seen_at": "2026-07-10T13:20:43.378546Z",
+        "retirement_candidate": true,
+        "retirement_reason": "no measured usage in review window"
+      },
+      {
+        "interface": {
+          "id": "b6a5fe44-fb85-4ef7-a273-78d09da777af",
+          "interface_key": "mcp:list_workstreams",
+          "interface_kind": "mcp_tool",
+          "legacy_since": "2026-07-10T13:19:26.075491Z",
+          "replacement_ref": "list_workplans",
+          "owner_component": "state-hub.mcp",
+          "status": "legacy",
+          "replacement_verified": true,
+          "manual_hold": false,
+          "hold_reason": null,
+          "notes": null,
+          "retired_at": null,
+          "created_at": "2026-07-10T13:19:26.075491Z",
+          "updated_at": "2026-07-10T13:19:26.075491Z"
+        },
+        "all_time": {
+          "calls": 2,
+          "tenant_count": 1,
+          "user_count": 1,
+          "component_count": 1,
+          "tenants": {
+            "unknown": 2
+          },
+          "users": {
+            "unknown": 2
+          },
+          "components": {
+            "state-hub.mcp": 2
+          }
+        },
+        "window": {
+          "calls": 0,
+          "tenant_count": 0,
+          "user_count": 0,
+          "component_count": 0,
+          "tenants": {},
+          "users": {},
+          "components": {}
+        },
+        "last_seen_at": "2026-07-10T13:20:42.374940Z",
+        "retirement_candidate": true,
+        "retirement_reason": "no measured usage in review window"
+      },
+      {
+        "interface": {
+          "id": "53c3372b-307d-4d6a-8ea4-bc36cacdcaf2",
+          "interface_key": "mcp:update_workstream",
+          "interface_kind": "mcp_tool",
+          "legacy_since": "2026-07-10T13:19:44.255216Z",
+          "replacement_ref": "update_workplan",
+          "owner_component": "state-hub.mcp",
+          "status": "legacy",
+          "replacement_verified": true,
+          "manual_hold": false,
+          "hold_reason": null,
+          "notes": "Registered by STATE-WP-0070 T03 \u2014 zero-window streak starts at registration",
+          "retired_at": null,
+          "created_at": "2026-07-10T13:19:44.255216Z",
+          "updated_at": "2026-07-10T13:19:44.255216Z"
+        },
+        "all_time": {
+          "calls": 0,
+          "tenant_count": 0,
+          "user_count": 0,
+          "component_count": 0,
+          "tenants": {},
+          "users": {},
+          "components": {}
+        },
+        "window": {
+          "calls": 0,
+          "tenant_count": 0,
+          "user_count": 0,
+          "component_count": 0,
+          "tenants": {},
+          "users": {},
+          "components": {}
+        },
+        "last_seen_at": null,
+        "retirement_candidate": true,
+        "retirement_reason": "no measured usage in review window"
+      },
+      {
+        "interface": {
+          "id": "bed4d08a-3471-48f5-9f0e-f9d550383a26",
+          "interface_key": "mcp:update_workstream_status",
+          "interface_kind": "mcp_tool",
+          "legacy_since": "2026-07-10T13:19:44.303612Z",
+          "replacement_ref": "update_workplan_status",
+          "owner_component": "state-hub.mcp",
+          "status": "legacy",
+          "replacement_verified": true,
+          "manual_hold": false,
+          "hold_reason": null,
+          "notes": "Registered by STATE-WP-0070 T03 \u2014 zero-window streak starts at registration",
+          "retired_at": null,
+          "created_at": "2026-07-10T13:19:44.303612Z",
+          "updated_at": "2026-07-10T13:19:44.303612Z"
+        },
+        "all_time": {
+          "calls": 0,
+          "tenant_count": 0,
+          "user_count": 0,
+          "component_count": 0,
+          "tenants": {},
+          "users": {},
+          "components": {}
+        },
+        "window": {
+          "calls": 0,
+          "tenant_count": 0,
+          "user_count": 0,
+          "component_count": 0,
+          "tenants": {},
+          "users": {},
+          "components": {}
+        },
+        "last_seen_at": null,
+        "retirement_candidate": true,
+        "retirement_reason": "no measured usage in review window"
+      },
+      {
+        "interface": {
+          "id": "46900dc2-0893-405b-ba59-80f31fb6ebb1",
+          "interface_key": "state://workstreams/{topic_slug}",
+          "interface_kind": "mcp_tool",
+          "legacy_since": "2026-07-10T13:19:44.344493Z",
+          "replacement_ref": "state://workplans/{topic_slug}",
+          "owner_component": "state-hub.mcp",
+          "status": "legacy",
+          "replacement_verified": true,
+          "manual_hold": false,
+          "hold_reason": null,
+          "notes": "Registered by STATE-WP-0070 T03 \u2014 zero-window streak starts at registration",
+          "retired_at": null,
+          "created_at": "2026-07-10T13:19:44.344493Z",
+          "updated_at": "2026-07-10T13:19:44.344493Z"
+        },
+        "all_time": {
+          "calls": 1,
+          "tenant_count": 1,
+          "user_count": 1,
+          "component_count": 1,
+          "tenants": {
+            "unknown": 1
+          },
+          "users": {
+            "unknown": 1
+          },
+          "components": {
+            "state-hub.mcp": 1
+          }
+        },
+        "window": {
+          "calls": 0,
+          "tenant_count": 0,
+          "user_count": 0,
+          "component_count": 0,
+          "tenants": {},
+          "users": {},
+          "components": {}
+        },
+        "last_seen_at": "2026-07-10T13:20:34.491811Z",
+        "retirement_candidate": true,
+        "retirement_reason": "no measured usage in review window"
+      },
+      {
+        "interface": {
+          "id": "cd9342fd-27e7-4a46-a1be-d41499e106a3",
+          "interface_key": "rest_api:DELETE /workstreams/{workstream_id}",
+          "interface_kind": "rest_api",
+          "legacy_since": "2026-06-06T17:28:13.052813Z",
+          "replacement_ref": "/workplans/{workplan_id}",
+          "owner_component": "state-hub.api",
+          "status": "legacy",
+          "replacement_verified": true,
+          "manual_hold": false,
+          "hold_reason": null,
+          "notes": null,
+          "retired_at": null,
+          "created_at": "2026-06-06T17:28:13.052813Z",
+          "updated_at": "2026-06-06T17:28:13.052813Z"
+        },
+        "all_time": {
+          "calls": 1,
+          "tenant_count": 1,
+          "user_count": 1,
+          "component_count": 1,
+          "tenants": {
+            "unknown": 1
+          },
+          "users": {
+            "unknown": 1
+          },
+          "components": {
+            "unknown": 1
+          }
+        },
+        "window": {
+          "calls": 0,
+          "tenant_count": 0,
+          "user_count": 0,
+          "component_count": 0,
+          "tenants": {},
+          "users": {},
+          "components": {}
+        },
+        "last_seen_at": "2026-06-06T17:28:13.047529Z",
+        "retirement_candidate": true,
+        "retirement_reason": "no measured usage in review window"
+      },
+      {
+        "interface": {
+          "id": "a4e0948c-cd4a-461e-8ae2-7fd7b51d04a7",
+          "interface_key": "rest_api:GET /decisions/?workstream_id",
+          "interface_kind": "rest_api",
+          "legacy_since": "2026-07-09T23:07:53.093223Z",
+          "replacement_ref": "/decisions/?workplan_id=<workplan_id>",
+          "owner_component": "state-hub.api",
+          "status": "legacy",
+          "replacement_verified": true,
+          "manual_hold": false,
+          "hold_reason": null,
+          "notes": null,
+          "retired_at": null,
+          "created_at": "2026-07-09T23:07:53.093223Z",
+          "updated_at": "2026-07-09T23:07:53.093223Z"
+        },
+        "all_time": {
+          "calls": 1,
+          "tenant_count": 1,
+          "user_count": 1,
+          "component_count": 1,
+          "tenants": {
+            "unknown": 1
+          },
+          "users": {
+            "unknown": 1
+          },
+          "components": {
+            "unknown": 1
+          }
+        },
+        "window": {
+          "calls": 0,
+          "tenant_count": 0,
+          "user_count": 0,
+          "component_count": 0,
+          "tenants": {},
+          "users": {},
+          "components": {}
+        },
+        "last_seen_at": "2026-07-09T23:07:53.083299Z",
+        "retirement_candidate": true,
+        "retirement_reason": "no measured usage in review window"
+      },
+      {
+        "interface": {
+          "id": "70a9346e-e0ee-42ac-874f-f160580b54dd",
+          "interface_key": "rest_api:GET /progress/?workstream_id",
+          "interface_kind": "rest_api",
+          "legacy_since": "2026-07-13T22:04:03.911449Z",
+          "replacement_ref": "/progress/?workplan_id=<workplan_id>",
+          "owner_component": "state-hub.api",
+          "status": "legacy",
+          "replacement_verified": true,
+          "manual_hold": false,
+          "hold_reason": null,
+          "notes": null,
+          "retired_at": null,
+          "created_at": "2026-07-13T22:04:03.911449Z",
+          "updated_at": "2026-07-13T22:04:03.911449Z"
+        },
+        "all_time": {
+          "calls": 1,
+          "tenant_count": 1,
+          "user_count": 1,
+          "component_count": 1,
+          "tenants": {
+            "unknown": 1
+          },
+          "users": {
+            "unknown": 1
+          },
+          "components": {
+            "unknown": 1
+          }
+        },
+        "window": {
+          "calls": 0,
+          "tenant_count": 0,
+          "user_count": 0,
+          "component_count": 0,
+          "tenants": {},
+          "users": {},
+          "components": {}
+        },
+        "last_seen_at": "2026-07-13T22:04:03.904998Z",
+        "retirement_candidate": true,
+        "retirement_reason": "no measured usage in review window"
+      },
+      {
+        "interface": {
+          "id": "be3cdcf8-250b-4bf0-801f-02ffd5f57e00",
+          "interface_key": "rest_api:GET /tasks/?workstream_id",
+          "interface_kind": "rest_api",
+          "legacy_since": "2026-07-08T19:32:21.628513Z",
+          "replacement_ref": "/tasks/?workplan_id=<workplan_id>",
+          "owner_component": "state-hub.api",
+          "status": "legacy",
+          "replacement_verified": true,
+          "manual_hold": false,
+          "hold_reason": null,
+          "notes": null,
+          "retired_at": null,
+          "created_at": "2026-07-08T19:32:21.628513Z",
+          "updated_at": "2026-07-08T19:32:21.628513Z"
+        },
+        "all_time": {
+          "calls": 583,
+          "tenant_count": 1,
+          "user_count": 1,
+          "component_count": 1,
+          "tenants": {
+            "unknown": 583
+          },
+          "users": {
+            "unknown": 583
+          },
+          "components": {
+            "unknown": 583
+          }
+        },
+        "window": {
+          "calls": 0,
+          "tenant_count": 0,
+          "user_count": 0,
+          "component_count": 0,
+          "tenants": {},
+          "users": {},
+          "components": {}
+        },
+        "last_seen_at": "2026-07-16T12:36:43.901956Z",
+        "retirement_candidate": true,
+        "retirement_reason": "no measured usage in review window"
+      },
+      {
+        "interface": {
+          "id": "3e4a3d0b-08fa-45c3-91e2-4f514a914b97",
+          "interface_key": "rest_api:GET /workstreams/",
+          "interface_kind": "rest_api",
+          "legacy_since": "2026-06-04T00:26:14.533764Z",
+          "replacement_ref": "/workplans/",
+          "owner_component": "state-hub.api",
+          "status": "legacy",
+          "replacement_verified": true,
+          "manual_hold": false,
+          "hold_reason": null,
+          "notes": null,
+          "retired_at": null,
+          "created_at": "2026-06-04T00:26:14.533764Z",
+          "updated_at": "2026-06-04T00:26:14.533764Z"
+        },
+        "all_time": {
+          "calls": 144084,
+          "tenant_count": 1,
+          "user_count": 1,
+          "component_count": 1,
+          "tenants": {
+            "unknown": 144084
+          },
+          "users": {
+            "unknown": 144084
+          },
+          "components": {
+            "unknown": 144084
+          }
+        },
+        "window": {
+          "calls": 0,
+          "tenant_count": 0,
+          "user_count": 0,
+          "component_count": 0,
+          "tenants": {},
+          "users": {},
+          "components": {}
+        },
+        "last_seen_at": "2026-07-08T21:14:39.652776Z",
+        "retirement_candidate": true,
+        "retirement_reason": "no measured usage in review window"
+      },
+      {
+        "interface": {
+          "id": "e4c140ec-7479-46f9-b185-4b533f19d639",
+          "interface_key": "rest_api:GET /workstreams/workplan-index",
+          "interface_kind": "rest_api",
+          "legacy_since": "2026-06-04T05:20:58.321869Z",
+          "replacement_ref": "/workplans/index",
+          "owner_component": "state-hub.api",
+          "status": "legacy",
+          "replacement_verified": true,
+          "manual_hold": false,
+          "hold_reason": null,
+          "notes": null,
+          "retired_at": null,
+          "created_at": "2026-06-04T05:20:58.321869Z",
+          "updated_at": "2026-06-04T05:20:58.321869Z"
+        },
+        "all_time": {
+          "calls": 30,
+          "tenant_count": 1,
+          "user_count": 1,
+          "component_count": 1,
+          "tenants": {
+            "unknown": 30
+          },
+          "users": {
+            "unknown": 30
+          },
+          "components": {
+            "unknown": 30
+          }
+        },
+        "window": {
+          "calls": 0,
+          "tenant_count": 0,
+          "user_count": 0,
+          "component_count": 0,
+          "tenants": {},
+          "users": {},
+          "components": {}
+        },
+        "last_seen_at": "2026-07-03T05:20:34.534439Z",
+        "retirement_candidate": true,
+        "retirement_reason": "no measured usage in review window"
+      },
+      {
+        "interface": {
+          "id": "3a00b19e-e7db-4403-98aa-a77c9ab61ecc",
+          "interface_key": "rest_api:GET /workstreams/{workstream_id}",
+          "interface_kind": "rest_api",
+          "legacy_since": "2026-06-04T00:25:59.014966Z",
+          "replacement_ref": "/workplans/{workplan_id}",
+          "owner_component": "state-hub.api",
+          "status": "legacy",
+          "replacement_verified": true,
+          "manual_hold": false,
+          "hold_reason": null,
+          "notes": null,
+          "retired_at": null,
+          "created_at": "2026-06-04T00:25:59.014966Z",
+          "updated_at": "2026-06-04T00:25:59.014966Z"
+        },
+        "all_time": {
+          "calls": 511405,
+          "tenant_count": 1,
+          "user_count": 1,
+          "component_count": 1,
+          "tenants": {
+            "unknown": 511405
+          },
+          "users": {
+            "unknown": 511405
+          },
+          "components": {
+            "unknown": 511405
+          }
+        },
+        "window": {
+          "calls": 0,
+          "tenant_count": 0,
+          "user_count": 0,
+          "component_count": 0,
+          "tenants": {},
+          "users": {},
+          "components": {}
+        },
+        "last_seen_at": "2026-07-08T21:14:20.781103Z",
+        "retirement_candidate": true,
+        "retirement_reason": "no measured usage in review window"
+      },
+      {
+        "interface": {
+          "id": "69e1a255-a8b9-4101-8a68-b1bed23abfda",
+          "interface_key": "rest_api:GET /workstreams/{workstream_id}/dependencies/",
+          "interface_kind": "rest_api",
+          "legacy_since": "2026-06-04T00:25:59.291135Z",
+          "replacement_ref": "/workplans/{workplan_id}/dependencies/",
+          "owner_component": "state-hub.api",
+          "status": "legacy",
+          "replacement_verified": true,
+          "manual_hold": false,
+          "hold_reason": null,
+          "notes": null,
+          "retired_at": null,
+          "created_at": "2026-06-04T00:25:59.291135Z",
+          "updated_at": "2026-06-04T00:25:59.291135Z"
+        },
+        "all_time": {
+          "calls": 255865,
+          "tenant_count": 1,
+          "user_count": 1,
+          "component_count": 1,
+          "tenants": {
+            "unknown": 255865
+          },
+          "users": {
+            "unknown": 255865
+          },
+          "components": {
+            "unknown": 255865
+          }
+        },
+        "window": {
+          "calls": 0,
+          "tenant_count": 0,
+          "user_count": 0,
+          "component_count": 0,
+          "tenants": {},
+          "users": {},
+          "components": {}
+        },
+        "last_seen_at": "2026-07-08T21:14:12.747005Z",
+        "retirement_candidate": true,
+        "retirement_reason": "no measured usage in review window"
+      },
+      {
+        "interface": {
+          "id": "b1aae931-b51f-4a85-a723-865dd65f6132",
+          "interface_key": "rest_api:PATCH /workstreams/{workstream_id}",
+          "interface_kind": "rest_api",
+          "legacy_since": "2026-06-04T06:09:41.901035Z",
+          "replacement_ref": "/workplans/{workplan_id}",
+          "owner_component": "state-hub.api",
+          "status": "legacy",
+          "replacement_verified": true,
+          "manual_hold": false,
+          "hold_reason": null,
+          "notes": null,
+          "retired_at": null,
+          "created_at": "2026-06-04T06:09:41.901035Z",
+          "updated_at": "2026-06-04T06:09:41.901035Z"
+        },
+        "all_time": {
+          "calls": 571,
+          "tenant_count": 1,
+          "user_count": 1,
+          "component_count": 1,
+          "tenants": {
+            "unknown": 571
+          },
+          "users": {
+            "unknown": 571
+          },
+          "components": {
+            "unknown": 571
+          }
+        },
+        "window": {
+          "calls": 0,
+          "tenant_count": 0,
+          "user_count": 0,
+          "component_count": 0,
+          "tenants": {},
+          "users": {},
+          "components": {}
+        },
+        "last_seen_at": "2026-07-08T20:49:12.335710Z",
+        "retirement_candidate": true,
+        "retirement_reason": "no measured usage in review window"
+      },
+      {
+        "interface": {
+          "id": "4aea9591-970b-4918-ac4a-4da95a0a1a8c",
+          "interface_key": "rest_api:POST /decisions/ workstream_id",
+          "interface_kind": "rest_api",
+          "legacy_since": "2026-07-09T22:56:35.473130Z",
+          "replacement_ref": "POST /decisions/ with workplan_id",
+          "owner_component": "state-hub.api",
+          "status": "legacy",
+          "replacement_verified": true,
+          "manual_hold": false,
+          "hold_reason": null,
+          "notes": null,
+          "retired_at": null,
+          "created_at": "2026-07-09T22:56:35.473130Z",
+          "updated_at": "2026-07-09T22:56:35.473130Z"
+        },
+        "all_time": {
+          "calls": 3,
+          "tenant_count": 1,
+          "user_count": 1,
+          "component_count": 1,
+          "tenants": {
+            "unknown": 3
+          },
+          "users": {
+            "unknown": 3
+          },
+          "components": {
+            "unknown": 3
+          }
+        },
+        "window": {
+          "calls": 0,
+          "tenant_count": 0,
+          "user_count": 0,
+          "component_count": 0,
+          "tenants": {},
+          "users": {},
+          "components": {}
+        },
+        "last_seen_at": "2026-07-09T22:57:05.912456Z",
+        "retirement_candidate": true,
+        "retirement_reason": "no measured usage in review window"
+      },
+      {
+        "interface": {
+          "id": "4a70583c-1e41-4ec1-99a9-728856a7d79c",
+          "interface_key": "rest_api:POST /progress/ workstream_id",
+          "interface_kind": "rest_api",
+          "legacy_since": "2026-07-08T23:35:09.148333Z",
+          "replacement_ref": "POST /progress/ with workplan_id",
+          "owner_component": "state-hub.api",
+          "status": "legacy",
+          "replacement_verified": true,
+          "manual_hold": false,
+          "hold_reason": null,
+          "notes": null,
+          "retired_at": null,
+          "created_at": "2026-07-08T23:35:09.148333Z",
+          "updated_at": "2026-07-08T23:35:09.148333Z"
+        },
+        "all_time": {
+          "calls": 14,
+          "tenant_count": 1,
+          "user_count": 1,
+          "component_count": 1,
+          "tenants": {
+            "unknown": 14
+          },
+          "users": {
+            "unknown": 14
+          },
+          "components": {
+            "unknown": 14
+          }
+        },
+        "window": {
+          "calls": 0,
+          "tenant_count": 0,
+          "user_count": 0,
+          "component_count": 0,
+          "tenants": {},
+          "users": {},
+          "components": {}
+        },
+        "last_seen_at": "2026-07-10T08:34:42.959724Z",
+        "retirement_candidate": true,
+        "retirement_reason": "no measured usage in review window"
+      },
+      {
+        "interface": {
+          "id": "6df4e443-7bf1-461a-923b-a6eb52fe7b07",
+          "interface_key": "rest_api:POST /tasks/ workstream_id",
+          "interface_kind": "rest_api",
+          "legacy_since": "2026-07-08T22:38:29.405720Z",
+          "replacement_ref": "POST /tasks/ with workplan_id",
+          "owner_component": "state-hub.api",
+          "status": "legacy",
+          "replacement_verified": true,
+          "manual_hold": false,
+          "hold_reason": null,
+          "notes": null,
+          "retired_at": null,
+          "created_at": "2026-07-08T22:38:29.405720Z",
+          "updated_at": "2026-07-08T22:38:29.405720Z"
+        },
+        "all_time": {
+          "calls": 5,
+          "tenant_count": 1,
+          "user_count": 1,
+          "component_count": 1,
+          "tenants": {
+            "unknown": 5
+          },
+          "users": {
+            "unknown": 5
+          },
+          "components": {
+            "state-hub.fix-consistency": 5
+          }
+        },
+        "window": {
+          "calls": 0,
+          "tenant_count": 0,
+          "user_count": 0,
+          "component_count": 0,
+          "tenants": {},
+          "users": {},
+          "components": {}
+        },
+        "last_seen_at": "2026-07-08T22:38:29.976918Z",
+        "retirement_candidate": true,
+        "retirement_reason": "no measured usage in review window"
+      },
+      {
+        "interface": {
+          "id": "ed6451c9-d2cc-4486-9afe-d3852782cabc",
+          "interface_key": "rest_api:POST /workstreams/",
+          "interface_kind": "rest_api",
+          "legacy_since": "2026-06-04T07:40:24.168535Z",
+          "replacement_ref": "/workplans/",
+          "owner_component": "state-hub.api",
+          "status": "legacy",
+          "replacement_verified": true,
+          "manual_hold": false,
+          "hold_reason": null,
+          "notes": null,
+          "retired_at": null,
+          "created_at": "2026-06-04T07:40:24.168535Z",
+          "updated_at": "2026-06-04T07:40:24.168535Z"
+        },
+        "all_time": {
+          "calls": 824,
+          "tenant_count": 1,
+          "user_count": 1,
+          "component_count": 1,
+          "tenants": {
+            "unknown": 824
+          },
+          "users": {
+            "unknown": 824
+          },
+          "components": {
+            "unknown": 824
+          }
+        },
+        "window": {
+          "calls": 0,
+          "tenant_count": 0,
+          "user_count": 0,
+          "component_count": 0,
+          "tenants": {},
+          "users": {},
+          "components": {}
+        },
+        "last_seen_at": "2026-07-08T20:38:05.903144Z",
+        "retirement_candidate": true,
+        "retirement_reason": "no measured usage in review window"
+      },
+      {
+        "interface": {
+          "id": "281fd706-b192-4194-8055-2d8733c115f9",
+          "interface_key": "rest_api:POST /workstreams/{workstream_id}/dependencies/",
+          "interface_kind": "rest_api",
+          "legacy_since": "2026-06-04T22:57:37.149207Z",
+          "replacement_ref": "/workplans/{workplan_id}/dependencies/",
+          "owner_component": "state-hub.api",
+          "status": "legacy",
+          "replacement_verified": true,
+          "manual_hold": false,
+          "hold_reason": null,
+          "notes": null,
+          "retired_at": null,
+          "created_at": "2026-06-04T22:57:37.149207Z",
+          "updated_at": "2026-06-04T22:57:37.149207Z"
+        },
+        "all_time": {
+          "calls": 4971,
+          "tenant_count": 1,
+          "user_count": 1,
+          "component_count": 1,
+          "tenants": {
+            "unknown": 4971
+          },
+          "users": {
+            "unknown": 4971
+          },
+          "components": {
+            "unknown": 4971
+          }
+        },
+        "window": {
+          "calls": 0,
+          "tenant_count": 0,
+          "user_count": 0,
+          "component_count": 0,
+          "tenants": {},
+          "users": {},
+          "components": {}
+        },
+        "last_seen_at": "2026-07-01T22:09:24.229011Z",
+        "retirement_candidate": true,
+        "retirement_reason": "no measured usage in review window"
+      }
+    ],
+    "retirement_candidates": [
+      {
+        "interface": {
+          "id": "63ed90e3-42b4-431a-94db-e1254a52f9e2",
+          "interface_key": "mcp:create_workstream",
+          "interface_kind": "mcp_tool",
+          "legacy_since": "2026-07-10T13:19:44.205900Z",
+          "replacement_ref": "create_workplan",
+          "owner_component": "state-hub.mcp",
+          "status": "legacy",
+          "replacement_verified": true,
+          "manual_hold": false,
+          "hold_reason": null,
+          "notes": "Registered by STATE-WP-0070 T03 \u2014 zero-window streak starts at registration",
+          "retired_at": null,
+          "created_at": "2026-07-10T13:19:44.205900Z",
+          "updated_at": "2026-07-10T13:19:44.205900Z"
+        },
+        "all_time": {
+          "calls": 2,
+          "tenant_count": 1,
+          "user_count": 1,
+          "component_count": 1,
+          "tenants": {
+            "unknown": 2
+          },
+          "users": {
+            "unknown": 2
+          },
+          "components": {
+            "state-hub.mcp": 2
+          }
+        },
+        "window": {
+          "calls": 0,
+          "tenant_count": 0,
+          "user_count": 0,
+          "component_count": 0,
+          "tenants": {},
+          "users": {},
+          "components": {}
+        },
+        "last_seen_at": "2026-07-10T13:20:43.378546Z",
+        "retirement_candidate": true,
+        "retirement_reason": "no measured usage in review window"
+      },
+      {
+        "interface": {
+          "id": "b6a5fe44-fb85-4ef7-a273-78d09da777af",
+          "interface_key": "mcp:list_workstreams",
+          "interface_kind": "mcp_tool",
+          "legacy_since": "2026-07-10T13:19:26.075491Z",
+          "replacement_ref": "list_workplans",
+          "owner_component": "state-hub.mcp",
+          "status": "legacy",
+          "replacement_verified": true,
+          "manual_hold": false,
+          "hold_reason": null,
+          "notes": null,
+          "retired_at": null,
+          "created_at": "2026-07-10T13:19:26.075491Z",
+          "updated_at": "2026-07-10T13:19:26.075491Z"
+        },
+        "all_time": {
+          "calls": 2,
+          "tenant_count": 1,
+          "user_count": 1,
+          "component_count": 1,
+          "tenants": {
+            "unknown": 2
+          },
+          "users": {
+            "unknown": 2
+          },
+          "components": {
+            "state-hub.mcp": 2
+          }
+        },
+        "window": {
+          "calls": 0,
+          "tenant_count": 0,
+          "user_count": 0,
+          "component_count": 0,
+          "tenants": {},
+          "users": {},
+          "components": {}
+        },
+        "last_seen_at": "2026-07-10T13:20:42.374940Z",
+        "retirement_candidate": true,
+        "retirement_reason": "no measured usage in review window"
+      },
+      {
+        "interface": {
+          "id": "53c3372b-307d-4d6a-8ea4-bc36cacdcaf2",
+          "interface_key": "mcp:update_workstream",
+          "interface_kind": "mcp_tool",
+          "legacy_since": "2026-07-10T13:19:44.255216Z",
+          "replacement_ref": "update_workplan",
+          "owner_component": "state-hub.mcp",
+          "status": "legacy",
+          "replacement_verified": true,
+          "manual_hold": false,
+          "hold_reason": null,
+          "notes": "Registered by STATE-WP-0070 T03 \u2014 zero-window streak starts at registration",
+          "retired_at": null,
+          "created_at": "2026-07-10T13:19:44.255216Z",
+          "updated_at": "2026-07-10T13:19:44.255216Z"
+        },
+        "all_time": {
+          "calls": 0,
+          "tenant_count": 0,
+          "user_count": 0,
+          "component_count": 0,
+          "tenants": {},
+          "users": {},
+          "components": {}
+        },
+        "window": {
+          "calls": 0,
+          "tenant_count": 0,
+          "user_count": 0,
+          "component_count": 0,
+          "tenants": {},
+          "users": {},
+          "components": {}
+        },
+        "last_seen_at": null,
+        "retirement_candidate": true,
+        "retirement_reason": "no measured usage in review window"
+      },
+      {
+        "interface": {
+          "id": "bed4d08a-3471-48f5-9f0e-f9d550383a26",
+          "interface_key": "mcp:update_workstream_status",
+          "interface_kind": "mcp_tool",
+          "legacy_since": "2026-07-10T13:19:44.303612Z",
+          "replacement_ref": "update_workplan_status",
+          "owner_component": "state-hub.mcp",
+          "status": "legacy",
+          "replacement_verified": true,
+          "manual_hold": false,
+          "hold_reason": null,
+          "notes": "Registered by STATE-WP-0070 T03 \u2014 zero-window streak starts at registration",
+          "retired_at": null,
+          "created_at": "2026-07-10T13:19:44.303612Z",
+          "updated_at": "2026-07-10T13:19:44.303612Z"
+        },
+        "all_time": {
+          "calls": 0,
+          "tenant_count": 0,
+          "user_count": 0,
+          "component_count": 0,
+          "tenants": {},
+          "users": {},
+          "components": {}
+        },
+        "window": {
+          "calls": 0,
+          "tenant_count": 0,
+          "user_count": 0,
+          "component_count": 0,
+          "tenants": {},
+          "users": {},
+          "components": {}
+        },
+        "last_seen_at": null,
+        "retirement_candidate": true,
+        "retirement_reason": "no measured usage in review window"
+      },
+      {
+        "interface": {
+          "id": "46900dc2-0893-405b-ba59-80f31fb6ebb1",
+          "interface_key": "state://workstreams/{topic_slug}",
+          "interface_kind": "mcp_tool",
+          "legacy_since": "2026-07-10T13:19:44.344493Z",
+          "replacement_ref": "state://workplans/{topic_slug}",
+          "owner_component": "state-hub.mcp",
+          "status": "legacy",
+          "replacement_verified": true,
+          "manual_hold": false,
+          "hold_reason": null,
+          "notes": "Registered by STATE-WP-0070 T03 \u2014 zero-window streak starts at registration",
+          "retired_at": null,
+          "created_at": "2026-07-10T13:19:44.344493Z",
+          "updated_at": "2026-07-10T13:19:44.344493Z"
+        },
+        "all_time": {
+          "calls": 1,
+          "tenant_count": 1,
+          "user_count": 1,
+          "component_count": 1,
+          "tenants": {
+            "unknown": 1
+          },
+          "users": {
+            "unknown": 1
+          },
+          "components": {
+            "state-hub.mcp": 1
+          }
+        },
+        "window": {
+          "calls": 0,
+          "tenant_count": 0,
+          "user_count": 0,
+          "component_count": 0,
+          "tenants": {},
+          "users": {},
+          "components": {}
+        },
+        "last_seen_at": "2026-07-10T13:20:34.491811Z",
+        "retirement_candidate": true,
+        "retirement_reason": "no measured usage in review window"
+      },
+      {
+        "interface": {
+          "id": "cd9342fd-27e7-4a46-a1be-d41499e106a3",
+          "interface_key": "rest_api:DELETE /workstreams/{workstream_id}",
+          "interface_kind": "rest_api",
+          "legacy_since": "2026-06-06T17:28:13.052813Z",
+          "replacement_ref": "/workplans/{workplan_id}",
+          "owner_component": "state-hub.api",
+          "status": "legacy",
+          "replacement_verified": true,
+          "manual_hold": false,
+          "hold_reason": null,
+          "notes": null,
+          "retired_at": null,
+          "created_at": "2026-06-06T17:28:13.052813Z",
+          "updated_at": "2026-06-06T17:28:13.052813Z"
+        },
+        "all_time": {
+          "calls": 1,
+          "tenant_count": 1,
+          "user_count": 1,
+          "component_count": 1,
+          "tenants": {
+            "unknown": 1
+          },
+          "users": {
+            "unknown": 1
+          },
+          "components": {
+            "unknown": 1
+          }
+        },
+        "window": {
+          "calls": 0,
+          "tenant_count": 0,
+          "user_count": 0,
+          "component_count": 0,
+          "tenants": {},
+          "users": {},
+          "components": {}
+        },
+        "last_seen_at": "2026-06-06T17:28:13.047529Z",
+        "retirement_candidate": true,
+        "retirement_reason": "no measured usage in review window"
+      },
+      {
+        "interface": {
+          "id": "a4e0948c-cd4a-461e-8ae2-7fd7b51d04a7",
+          "interface_key": "rest_api:GET /decisions/?workstream_id",
+          "interface_kind": "rest_api",
+          "legacy_since": "2026-07-09T23:07:53.093223Z",
+          "replacement_ref": "/decisions/?workplan_id=<workplan_id>",
+          "owner_component": "state-hub.api",
+          "status": "legacy",
+          "replacement_verified": true,
+          "manual_hold": false,
+          "hold_reason": null,
+          "notes": null,
+          "retired_at": null,
+          "created_at": "2026-07-09T23:07:53.093223Z",
+          "updated_at": "2026-07-09T23:07:53.093223Z"
+        },
+        "all_time": {
+          "calls": 1,
+          "tenant_count": 1,
+          "user_count": 1,
+          "component_count": 1,
+          "tenants": {
+            "unknown": 1
+          },
+          "users": {
+            "unknown": 1
+          },
+          "components": {
+            "unknown": 1
+          }
+        },
+        "window": {
+          "calls": 0,
+          "tenant_count": 0,
+          "user_count": 0,
+          "component_count": 0,
+          "tenants": {},
+          "users": {},
+          "components": {}
+        },
+        "last_seen_at": "2026-07-09T23:07:53.083299Z",
+        "retirement_candidate": true,
+        "retirement_reason": "no measured usage in review window"
+      },
+      {
+        "interface": {
+          "id": "70a9346e-e0ee-42ac-874f-f160580b54dd",
+          "interface_key": "rest_api:GET /progress/?workstream_id",
+          "interface_kind": "rest_api",
+          "legacy_since": "2026-07-13T22:04:03.911449Z",
+          "replacement_ref": "/progress/?workplan_id=<workplan_id>",
+          "owner_component": "state-hub.api",
+          "status": "legacy",
+          "replacement_verified": true,
+          "manual_hold": false,
+          "hold_reason": null,
+          "notes": null,
+          "retired_at": null,
+          "created_at": "2026-07-13T22:04:03.911449Z",
+          "updated_at": "2026-07-13T22:04:03.911449Z"
+        },
+        "all_time": {
+          "calls": 1,
+          "tenant_count": 1,
+          "user_count": 1,
+          "component_count": 1,
+          "tenants": {
+            "unknown": 1
+          },
+          "users": {
+            "unknown": 1
+          },
+          "components": {
+            "unknown": 1
+          }
+        },
+        "window": {
+          "calls": 0,
+          "tenant_count": 0,
+          "user_count": 0,
+          "component_count": 0,
+          "tenants": {},
+          "users": {},
+          "components": {}
+        },
+        "last_seen_at": "2026-07-13T22:04:03.904998Z",
+        "retirement_candidate": true,
+        "retirement_reason": "no measured usage in review window"
+      },
+      {
+        "interface": {
+          "id": "be3cdcf8-250b-4bf0-801f-02ffd5f57e00",
+          "interface_key": "rest_api:GET /tasks/?workstream_id",
+          "interface_kind": "rest_api",
+          "legacy_since": "2026-07-08T19:32:21.628513Z",
+          "replacement_ref": "/tasks/?workplan_id=<workplan_id>",
+          "owner_component": "state-hub.api",
+          "status": "legacy",
+          "replacement_verified": true,
+          "manual_hold": false,
+          "hold_reason": null,
+          "notes": null,
+          "retired_at": null,
+          "created_at": "2026-07-08T19:32:21.628513Z",
+          "updated_at": "2026-07-08T19:32:21.628513Z"
+        },
+        "all_time": {
+          "calls": 583,
+          "tenant_count": 1,
+          "user_count": 1,
+          "component_count": 1,
+          "tenants": {
+            "unknown": 583
+          },
+          "users": {
+            "unknown": 583
+          },
+          "components": {
+            "unknown": 583
+          }
+        },
+        "window": {
+          "calls": 0,
+          "tenant_count": 0,
+          "user_count": 0,
+          "component_count": 0,
+          "tenants": {},
+          "users": {},
+          "components": {}
+        },
+        "last_seen_at": "2026-07-16T12:36:43.901956Z",
+        "retirement_candidate": true,
+        "retirement_reason": "no measured usage in review window"
+      },
+      {
+        "interface": {
+          "id": "3e4a3d0b-08fa-45c3-91e2-4f514a914b97",
+          "interface_key": "rest_api:GET /workstreams/",
+          "interface_kind": "rest_api",
+          "legacy_since": "2026-06-04T00:26:14.533764Z",
+          "replacement_ref": "/workplans/",
+          "owner_component": "state-hub.api",
+          "status": "legacy",
+          "replacement_verified": true,
+          "manual_hold": false,
+          "hold_reason": null,
+          "notes": null,
+          "retired_at": null,
+          "created_at": "2026-06-04T00:26:14.533764Z",
+          "updated_at": "2026-06-04T00:26:14.533764Z"
+        },
+        "all_time": {
+          "calls": 144084,
+          "tenant_count": 1,
+          "user_count": 1,
+          "component_count": 1,
+          "tenants": {
+            "unknown": 144084
+          },
+          "users": {
+            "unknown": 144084
+          },
+          "components": {
+            "unknown": 144084
+          }
+        },
+        "window": {
+          "calls": 0,
+          "tenant_count": 0,
+          "user_count": 0,
+          "component_count": 0,
+          "tenants": {},
+          "users": {},
+          "components": {}
+        },
+        "last_seen_at": "2026-07-08T21:14:39.652776Z",
+        "retirement_candidate": true,
+        "retirement_reason": "no measured usage in review window"
+      },
+      {
+        "interface": {
+          "id": "e4c140ec-7479-46f9-b185-4b533f19d639",
+          "interface_key": "rest_api:GET /workstreams/workplan-index",
+          "interface_kind": "rest_api",
+          "legacy_since": "2026-06-04T05:20:58.321869Z",
+          "replacement_ref": "/workplans/index",
+          "owner_component": "state-hub.api",
+          "status": "legacy",
+          "replacement_verified": true,
+          "manual_hold": false,
+          "hold_reason": null,
+          "notes": null,
+          "retired_at": null,
+          "created_at": "2026-06-04T05:20:58.321869Z",
+          "updated_at": "2026-06-04T05:20:58.321869Z"
+        },
+        "all_time": {
+          "calls": 30,
+          "tenant_count": 1,
+          "user_count": 1,
+          "component_count": 1,
+          "tenants": {
+            "unknown": 30
+          },
+          "users": {
+            "unknown": 30
+          },
+          "components": {
+            "unknown": 30
+          }
+        },
+        "window": {
+          "calls": 0,
+          "tenant_count": 0,
+          "user_count": 0,
+          "component_count": 0,
+          "tenants": {},
+          "users": {},
+          "components": {}
+        },
+        "last_seen_at": "2026-07-03T05:20:34.534439Z",
+        "retirement_candidate": true,
+        "retirement_reason": "no measured usage in review window"
+      },
+      {
+        "interface": {
+          "id": "3a00b19e-e7db-4403-98aa-a77c9ab61ecc",
+          "interface_key": "rest_api:GET /workstreams/{workstream_id}",
+          "interface_kind": "rest_api",
+          "legacy_since": "2026-06-04T00:25:59.014966Z",
+          "replacement_ref": "/workplans/{workplan_id}",
+          "owner_component": "state-hub.api",
+          "status": "legacy",
+          "replacement_verified": true,
+          "manual_hold": false,
+          "hold_reason": null,
+          "notes": null,
+          "retired_at": null,
+          "created_at": "2026-06-04T00:25:59.014966Z",
+          "updated_at": "2026-06-04T00:25:59.014966Z"
+        },
+        "all_time": {
+          "calls": 511405,
+          "tenant_count": 1,
+          "user_count": 1,
+          "component_count": 1,
+          "tenants": {
+            "unknown": 511405
+          },
+          "users": {
+            "unknown": 511405
+          },
+          "components": {
+            "unknown": 511405
+          }
+        },
+        "window": {
+          "calls": 0,
+          "tenant_count": 0,
+          "user_count": 0,
+          "component_count": 0,
+          "tenants": {},
+          "users": {},
+          "components": {}
+        },
+        "last_seen_at": "2026-07-08T21:14:20.781103Z",
+        "retirement_candidate": true,
+        "retirement_reason": "no measured usage in review window"
+      },
+      {
+        "interface": {
+          "id": "69e1a255-a8b9-4101-8a68-b1bed23abfda",
+          "interface_key": "rest_api:GET /workstreams/{workstream_id}/dependencies/",
+          "interface_kind": "rest_api",
+          "legacy_since": "2026-06-04T00:25:59.291135Z",
+          "replacement_ref": "/workplans/{workplan_id}/dependencies/",
+          "owner_component": "state-hub.api",
+          "status": "legacy",
+          "replacement_verified": true,
+          "manual_hold": false,
+          "hold_reason": null,
+          "notes": null,
+          "retired_at": null,
+          "created_at": "2026-06-04T00:25:59.291135Z",
+          "updated_at": "2026-06-04T00:25:59.291135Z"
+        },
+        "all_time": {
+          "calls": 255865,
+          "tenant_count": 1,
+          "user_count": 1,
+          "component_count": 1,
+          "tenants": {
+            "unknown": 255865
+          },
+          "users": {
+            "unknown": 255865
+          },
+          "components": {
+            "unknown": 255865
+          }
+        },
+        "window": {
+          "calls": 0,
+          "tenant_count": 0,
+          "user_count": 0,
+          "component_count": 0,
+          "tenants": {},
+          "users": {},
+          "components": {}
+        },
+        "last_seen_at": "2026-07-08T21:14:12.747005Z",
+        "retirement_candidate": true,
+        "retirement_reason": "no measured usage in review window"
+      },
+      {
+        "interface": {
+          "id": "b1aae931-b51f-4a85-a723-865dd65f6132",
+          "interface_key": "rest_api:PATCH /workstreams/{workstream_id}",
+          "interface_kind": "rest_api",
+          "legacy_since": "2026-06-04T06:09:41.901035Z",
+          "replacement_ref": "/workplans/{workplan_id}",
+          "owner_component": "state-hub.api",
+          "status": "legacy",
+          "replacement_verified": true,
+          "manual_hold": false,
+          "hold_reason": null,
+          "notes": null,
+          "retired_at": null,
+          "created_at": "2026-06-04T06:09:41.901035Z",
+          "updated_at": "2026-06-04T06:09:41.901035Z"
+        },
+        "all_time": {
+          "calls": 571,
+          "tenant_count": 1,
+          "user_count": 1,
+          "component_count": 1,
+          "tenants": {
+            "unknown": 571
+          },
+          "users": {
+            "unknown": 571
+          },
+          "components": {
+            "unknown": 571
+          }
+        },
+        "window": {
+          "calls": 0,
+          "tenant_count": 0,
+          "user_count": 0,
+          "component_count": 0,
+          "tenants": {},
+          "users": {},
+          "components": {}
+        },
+        "last_seen_at": "2026-07-08T20:49:12.335710Z",
+        "retirement_candidate": true,
+        "retirement_reason": "no measured usage in review window"
+      },
+      {
+        "interface": {
+          "id": "4aea9591-970b-4918-ac4a-4da95a0a1a8c",
+          "interface_key": "rest_api:POST /decisions/ workstream_id",
+          "interface_kind": "rest_api",
+          "legacy_since": "2026-07-09T22:56:35.473130Z",
+          "replacement_ref": "POST /decisions/ with workplan_id",
+          "owner_component": "state-hub.api",
+          "status": "legacy",
+          "replacement_verified": true,
+          "manual_hold": false,
+          "hold_reason": null,
+          "notes": null,
+          "retired_at": null,
+          "created_at": "2026-07-09T22:56:35.473130Z",
+          "updated_at": "2026-07-09T22:56:35.473130Z"
+        },
+        "all_time": {
+          "calls": 3,
+          "tenant_count": 1,
+          "user_count": 1,
+          "component_count": 1,
+          "tenants": {
+            "unknown": 3
+          },
+          "users": {
+            "unknown": 3
+          },
+          "components": {
+            "unknown": 3
+          }
+        },
+        "window": {
+          "calls": 0,
+          "tenant_count": 0,
+          "user_count": 0,
+          "component_count": 0,
+          "tenants": {},
+          "users": {},
+          "components": {}
+        },
+        "last_seen_at": "2026-07-09T22:57:05.912456Z",
+        "retirement_candidate": true,
+        "retirement_reason": "no measured usage in review window"
+      },
+      {
+        "interface": {
+          "id": "4a70583c-1e41-4ec1-99a9-728856a7d79c",
+          "interface_key": "rest_api:POST /progress/ workstream_id",
+          "interface_kind": "rest_api",
+          "legacy_since": "2026-07-08T23:35:09.148333Z",
+          "replacement_ref": "POST /progress/ with workplan_id",
+          "owner_component": "state-hub.api",
+          "status": "legacy",
+          "replacement_verified": true,
+          "manual_hold": false,
+          "hold_reason": null,
+          "notes": null,
+          "retired_at": null,
+          "created_at": "2026-07-08T23:35:09.148333Z",
+          "updated_at": "2026-07-08T23:35:09.148333Z"
+        },
+        "all_time": {
+          "calls": 14,
+          "tenant_count": 1,
+          "user_count": 1,
+          "component_count": 1,
+          "tenants": {
+            "unknown": 14
+          },
+          "users": {
+            "unknown": 14
+          },
+          "components": {
+            "unknown": 14
+          }
+        },
+        "window": {
+          "calls": 0,
+          "tenant_count": 0,
+          "user_count": 0,
+          "component_count": 0,
+          "tenants": {},
+          "users": {},
+          "components": {}
+        },
+        "last_seen_at": "2026-07-10T08:34:42.959724Z",
+        "retirement_candidate": true,
+        "retirement_reason": "no measured usage in review window"
+      },
+      {
+        "interface": {
+          "id": "6df4e443-7bf1-461a-923b-a6eb52fe7b07",
+          "interface_key": "rest_api:POST /tasks/ workstream_id",
+          "interface_kind": "rest_api",
+          "legacy_since": "2026-07-08T22:38:29.405720Z",
+          "replacement_ref": "POST /tasks/ with workplan_id",
+          "owner_component": "state-hub.api",
+          "status": "legacy",
+          "replacement_verified": true,
+          "manual_hold": false,
+          "hold_reason": null,
+          "notes": null,
+          "retired_at": null,
+          "created_at": "2026-07-08T22:38:29.405720Z",
+          "updated_at": "2026-07-08T22:38:29.405720Z"
+        },
+        "all_time": {
+          "calls": 5,
+          "tenant_count": 1,
+          "user_count": 1,
+          "component_count": 1,
+          "tenants": {
+            "unknown": 5
+          },
+          "users": {
+            "unknown": 5
+          },
+          "components": {
+            "state-hub.fix-consistency": 5
+          }
+        },
+        "window": {
+          "calls": 0,
+          "tenant_count": 0,
+          "user_count": 0,
+          "component_count": 0,
+          "tenants": {},
+          "users": {},
+          "components": {}
+        },
+        "last_seen_at": "2026-07-08T22:38:29.976918Z",
+        "retirement_candidate": true,
+        "retirement_reason": "no measured usage in review window"
+      },
+      {
+        "interface": {
+          "id": "ed6451c9-d2cc-4486-9afe-d3852782cabc",
+          "interface_key": "rest_api:POST /workstreams/",
+          "interface_kind": "rest_api",
+          "legacy_since": "2026-06-04T07:40:24.168535Z",
+          "replacement_ref": "/workplans/",
+          "owner_component": "state-hub.api",
+          "status": "legacy",
+          "replacement_verified": true,
+          "manual_hold": false,
+          "hold_reason": null,
+          "notes": null,
+          "retired_at": null,
+          "created_at": "2026-06-04T07:40:24.168535Z",
+          "updated_at": "2026-06-04T07:40:24.168535Z"
+        },
+        "all_time": {
+          "calls": 824,
+          "tenant_count": 1,
+          "user_count": 1,
+          "component_count": 1,
+          "tenants": {
+            "unknown": 824
+          },
+          "users": {
+            "unknown": 824
+          },
+          "components": {
+            "unknown": 824
+          }
+        },
+        "window": {
+          "calls": 0,
+          "tenant_count": 0,
+          "user_count": 0,
+          "component_count": 0,
+          "tenants": {},
+          "users": {},
+          "components": {}
+        },
+        "last_seen_at": "2026-07-08T20:38:05.903144Z",
+        "retirement_candidate": true,
+        "retirement_reason": "no measured usage in review window"
+      },
+      {
+        "interface": {
+          "id": "281fd706-b192-4194-8055-2d8733c115f9",
+          "interface_key": "rest_api:POST /workstreams/{workstream_id}/dependencies/",
+          "interface_kind": "rest_api",
+          "legacy_since": "2026-06-04T22:57:37.149207Z",
+          "replacement_ref": "/workplans/{workplan_id}/dependencies/",
+          "owner_component": "state-hub.api",
+          "status": "legacy",
+          "replacement_verified": true,
+          "manual_hold": false,
+          "hold_reason": null,
+          "notes": null,
+          "retired_at": null,
+          "created_at": "2026-06-04T22:57:37.149207Z",
+          "updated_at": "2026-06-04T22:57:37.149207Z"
+        },
+        "all_time": {
+          "calls": 4971,
+          "tenant_count": 1,
+          "user_count": 1,
+          "component_count": 1,
+          "tenants": {
+            "unknown": 4971
+          },
+          "users": {
+            "unknown": 4971
+          },
+          "components": {
+            "unknown": 4971
+          }
+        },
+        "window": {
+          "calls": 0,
+          "tenant_count": 0,
+          "user_count": 0,
+          "component_count": 0,
+          "tenants": {},
+          "users": {},
+          "components": {}
+        },
+        "last_seen_at": "2026-07-01T22:09:24.229011Z",
+        "retirement_candidate": true,
+        "retirement_reason": "no measured usage in review window"
+      }
+    ]
+  },
+  "hours": 8
+}
diff --git a/docs/evidence/legacy-meter-weekly-review-20260718.json b/docs/evidence/legacy-meter-weekly-review-20260718.json
new file mode 100644
index 0000000..1e7679c
--- /dev/null
+++ b/docs/evidence/legacy-meter-weekly-review-20260718.json
@@ -0,0 +1,1755 @@
+{
+  "captured_at": "2026-07-18T14:00:04.817890+00:00",
+  "api_base": "http://127.0.0.1:8000",
+  "workplan": "STATE-WP-0070",
+  "retired_interfaces": [],
+  "weekly_review": {
+    "generated_at": "2026-07-18T14:00:04.812359Z",
+    "window_start": "2026-07-18T06:00:04.743344Z",
+    "window_end": "2026-07-18T14:00:04.743344Z",
+    "cadence": "weekly",
+    "activity_core_handoff": {
+      "activity_id": "statehub-legacy-interface-review",
+      "cadence": "weekly",
+      "source_endpoint": "/legacy-meter/weekly-review",
+      "state_owner": "state-hub",
+      "scheduler_owner": "activity-core"
+    },
+    "interfaces": [
+      {
+        "interface": {
+          "id": "8051fb40-66c9-4dc4-a413-13e8573e04a3",
+          "interface_key": "event_subject:org.statehub.workstream.completed",
+          "interface_kind": "event_subject",
+          "legacy_since": "2026-06-04T06:09:42.198193Z",
+          "replacement_ref": "org.statehub.workplan.completed",
+          "owner_component": "state-hub.events",
+          "status": "retired",
+          "replacement_verified": true,
+          "manual_hold": false,
+          "hold_reason": null,
+          "notes": "Retired by STATE-WP-0069 closeout",
+          "retired_at": "2026-07-08T21:38:52.773601Z",
+          "created_at": "2026-06-04T06:09:42.198193Z",
+          "updated_at": "2026-07-08T21:38:52.761243Z"
+        },
+        "all_time": {
+          "calls": 255,
+          "tenant_count": 1,
+          "user_count": 1,
+          "component_count": 1,
+          "tenants": {
+            "unknown": 255
+          },
+          "users": {
+            "unknown": 255
+          },
+          "components": {
+            "state-hub.events": 255
+          }
+        },
+        "window": {
+          "calls": 0,
+          "tenant_count": 0,
+          "user_count": 0,
+          "component_count": 0,
+          "tenants": {},
+          "users": {},
+          "components": {}
+        },
+        "last_seen_at": "2026-07-08T20:49:12.839383Z",
+        "retirement_candidate": false,
+        "retirement_reason": "already retired"
+      },
+      {
+        "interface": {
+          "id": "63ed90e3-42b4-431a-94db-e1254a52f9e2",
+          "interface_key": "mcp:create_workstream",
+          "interface_kind": "mcp_tool",
+          "legacy_since": "2026-07-10T13:19:44.205900Z",
+          "replacement_ref": "create_workplan",
+          "owner_component": "state-hub.mcp",
+          "status": "legacy",
+          "replacement_verified": true,
+          "manual_hold": false,
+          "hold_reason": null,
+          "notes": "Registered by STATE-WP-0070 T03 \u2014 zero-window streak starts at registration",
+          "retired_at": null,
+          "created_at": "2026-07-10T13:19:44.205900Z",
+          "updated_at": "2026-07-10T13:19:44.205900Z"
+        },
+        "all_time": {
+          "calls": 2,
+          "tenant_count": 1,
+          "user_count": 1,
+          "component_count": 1,
+          "tenants": {
+            "unknown": 2
+          },
+          "users": {
+            "unknown": 2
+          },
+          "components": {
+            "state-hub.mcp": 2
+          }
+        },
+        "window": {
+          "calls": 0,
+          "tenant_count": 0,
+          "user_count": 0,
+          "component_count": 0,
+          "tenants": {},
+          "users": {},
+          "components": {}
+        },
+        "last_seen_at": "2026-07-10T13:20:43.378546Z",
+        "retirement_candidate": true,
+        "retirement_reason": "no measured usage in review window"
+      },
+      {
+        "interface": {
+          "id": "b6a5fe44-fb85-4ef7-a273-78d09da777af",
+          "interface_key": "mcp:list_workstreams",
+          "interface_kind": "mcp_tool",
+          "legacy_since": "2026-07-10T13:19:26.075491Z",
+          "replacement_ref": "list_workplans",
+          "owner_component": "state-hub.mcp",
+          "status": "legacy",
+          "replacement_verified": true,
+          "manual_hold": false,
+          "hold_reason": null,
+          "notes": null,
+          "retired_at": null,
+          "created_at": "2026-07-10T13:19:26.075491Z",
+          "updated_at": "2026-07-10T13:19:26.075491Z"
+        },
+        "all_time": {
+          "calls": 2,
+          "tenant_count": 1,
+          "user_count": 1,
+          "component_count": 1,
+          "tenants": {
+            "unknown": 2
+          },
+          "users": {
+            "unknown": 2
+          },
+          "components": {
+            "state-hub.mcp": 2
+          }
+        },
+        "window": {
+          "calls": 0,
+          "tenant_count": 0,
+          "user_count": 0,
+          "component_count": 0,
+          "tenants": {},
+          "users": {},
+          "components": {}
+        },
+        "last_seen_at": "2026-07-10T13:20:42.374940Z",
+        "retirement_candidate": true,
+        "retirement_reason": "no measured usage in review window"
+      },
+      {
+        "interface": {
+          "id": "53c3372b-307d-4d6a-8ea4-bc36cacdcaf2",
+          "interface_key": "mcp:update_workstream",
+          "interface_kind": "mcp_tool",
+          "legacy_since": "2026-07-10T13:19:44.255216Z",
+          "replacement_ref": "update_workplan",
+          "owner_component": "state-hub.mcp",
+          "status": "legacy",
+          "replacement_verified": true,
+          "manual_hold": false,
+          "hold_reason": null,
+          "notes": "Registered by STATE-WP-0070 T03 \u2014 zero-window streak starts at registration",
+          "retired_at": null,
+          "created_at": "2026-07-10T13:19:44.255216Z",
+          "updated_at": "2026-07-10T13:19:44.255216Z"
+        },
+        "all_time": {
+          "calls": 0,
+          "tenant_count": 0,
+          "user_count": 0,
+          "component_count": 0,
+          "tenants": {},
+          "users": {},
+          "components": {}
+        },
+        "window": {
+          "calls": 0,
+          "tenant_count": 0,
+          "user_count": 0,
+          "component_count": 0,
+          "tenants": {},
+          "users": {},
+          "components": {}
+        },
+        "last_seen_at": null,
+        "retirement_candidate": true,
+        "retirement_reason": "no measured usage in review window"
+      },
+      {
+        "interface": {
+          "id": "bed4d08a-3471-48f5-9f0e-f9d550383a26",
+          "interface_key": "mcp:update_workstream_status",
+          "interface_kind": "mcp_tool",
+          "legacy_since": "2026-07-10T13:19:44.303612Z",
+          "replacement_ref": "update_workplan_status",
+          "owner_component": "state-hub.mcp",
+          "status": "legacy",
+          "replacement_verified": true,
+          "manual_hold": false,
+          "hold_reason": null,
+          "notes": "Registered by STATE-WP-0070 T03 \u2014 zero-window streak starts at registration",
+          "retired_at": null,
+          "created_at": "2026-07-10T13:19:44.303612Z",
+          "updated_at": "2026-07-10T13:19:44.303612Z"
+        },
+        "all_time": {
+          "calls": 0,
+          "tenant_count": 0,
+          "user_count": 0,
+          "component_count": 0,
+          "tenants": {},
+          "users": {},
+          "components": {}
+        },
+        "window": {
+          "calls": 0,
+          "tenant_count": 0,
+          "user_count": 0,
+          "component_count": 0,
+          "tenants": {},
+          "users": {},
+          "components": {}
+        },
+        "last_seen_at": null,
+        "retirement_candidate": true,
+        "retirement_reason": "no measured usage in review window"
+      },
+      {
+        "interface": {
+          "id": "46900dc2-0893-405b-ba59-80f31fb6ebb1",
+          "interface_key": "state://workstreams/{topic_slug}",
+          "interface_kind": "mcp_tool",
+          "legacy_since": "2026-07-10T13:19:44.344493Z",
+          "replacement_ref": "state://workplans/{topic_slug}",
+          "owner_component": "state-hub.mcp",
+          "status": "legacy",
+          "replacement_verified": true,
+          "manual_hold": false,
+          "hold_reason": null,
+          "notes": "Registered by STATE-WP-0070 T03 \u2014 zero-window streak starts at registration",
+          "retired_at": null,
+          "created_at": "2026-07-10T13:19:44.344493Z",
+          "updated_at": "2026-07-10T13:19:44.344493Z"
+        },
+        "all_time": {
+          "calls": 1,
+          "tenant_count": 1,
+          "user_count": 1,
+          "component_count": 1,
+          "tenants": {
+            "unknown": 1
+          },
+          "users": {
+            "unknown": 1
+          },
+          "components": {
+            "state-hub.mcp": 1
+          }
+        },
+        "window": {
+          "calls": 0,
+          "tenant_count": 0,
+          "user_count": 0,
+          "component_count": 0,
+          "tenants": {},
+          "users": {},
+          "components": {}
+        },
+        "last_seen_at": "2026-07-10T13:20:34.491811Z",
+        "retirement_candidate": true,
+        "retirement_reason": "no measured usage in review window"
+      },
+      {
+        "interface": {
+          "id": "cd9342fd-27e7-4a46-a1be-d41499e106a3",
+          "interface_key": "rest_api:DELETE /workstreams/{workstream_id}",
+          "interface_kind": "rest_api",
+          "legacy_since": "2026-06-06T17:28:13.052813Z",
+          "replacement_ref": "/workplans/{workplan_id}",
+          "owner_component": "state-hub.api",
+          "status": "legacy",
+          "replacement_verified": true,
+          "manual_hold": false,
+          "hold_reason": null,
+          "notes": null,
+          "retired_at": null,
+          "created_at": "2026-06-06T17:28:13.052813Z",
+          "updated_at": "2026-06-06T17:28:13.052813Z"
+        },
+        "all_time": {
+          "calls": 1,
+          "tenant_count": 1,
+          "user_count": 1,
+          "component_count": 1,
+          "tenants": {
+            "unknown": 1
+          },
+          "users": {
+            "unknown": 1
+          },
+          "components": {
+            "unknown": 1
+          }
+        },
+        "window": {
+          "calls": 0,
+          "tenant_count": 0,
+          "user_count": 0,
+          "component_count": 0,
+          "tenants": {},
+          "users": {},
+          "components": {}
+        },
+        "last_seen_at": "2026-06-06T17:28:13.047529Z",
+        "retirement_candidate": true,
+        "retirement_reason": "no measured usage in review window"
+      },
+      {
+        "interface": {
+          "id": "a4e0948c-cd4a-461e-8ae2-7fd7b51d04a7",
+          "interface_key": "rest_api:GET /decisions/?workstream_id",
+          "interface_kind": "rest_api",
+          "legacy_since": "2026-07-09T23:07:53.093223Z",
+          "replacement_ref": "/decisions/?workplan_id=<workplan_id>",
+          "owner_component": "state-hub.api",
+          "status": "legacy",
+          "replacement_verified": true,
+          "manual_hold": false,
+          "hold_reason": null,
+          "notes": null,
+          "retired_at": null,
+          "created_at": "2026-07-09T23:07:53.093223Z",
+          "updated_at": "2026-07-09T23:07:53.093223Z"
+        },
+        "all_time": {
+          "calls": 1,
+          "tenant_count": 1,
+          "user_count": 1,
+          "component_count": 1,
+          "tenants": {
+            "unknown": 1
+          },
+          "users": {
+            "unknown": 1
+          },
+          "components": {
+            "unknown": 1
+          }
+        },
+        "window": {
+          "calls": 0,
+          "tenant_count": 0,
+          "user_count": 0,
+          "component_count": 0,
+          "tenants": {},
+          "users": {},
+          "components": {}
+        },
+        "last_seen_at": "2026-07-09T23:07:53.083299Z",
+        "retirement_candidate": true,
+        "retirement_reason": "no measured usage in review window"
+      },
+      {
+        "interface": {
+          "id": "70a9346e-e0ee-42ac-874f-f160580b54dd",
+          "interface_key": "rest_api:GET /progress/?workstream_id",
+          "interface_kind": "rest_api",
+          "legacy_since": "2026-07-13T22:04:03.911449Z",
+          "replacement_ref": "/progress/?workplan_id=<workplan_id>",
+          "owner_component": "state-hub.api",
+          "status": "legacy",
+          "replacement_verified": true,
+          "manual_hold": false,
+          "hold_reason": null,
+          "notes": null,
+          "retired_at": null,
+          "created_at": "2026-07-13T22:04:03.911449Z",
+          "updated_at": "2026-07-13T22:04:03.911449Z"
+        },
+        "all_time": {
+          "calls": 1,
+          "tenant_count": 1,
+          "user_count": 1,
+          "component_count": 1,
+          "tenants": {
+            "unknown": 1
+          },
+          "users": {
+            "unknown": 1
+          },
+          "components": {
+            "unknown": 1
+          }
+        },
+        "window": {
+          "calls": 0,
+          "tenant_count": 0,
+          "user_count": 0,
+          "component_count": 0,
+          "tenants": {},
+          "users": {},
+          "components": {}
+        },
+        "last_seen_at": "2026-07-13T22:04:03.904998Z",
+        "retirement_candidate": true,
+        "retirement_reason": "no measured usage in review window"
+      },
+      {
+        "interface": {
+          "id": "be3cdcf8-250b-4bf0-801f-02ffd5f57e00",
+          "interface_key": "rest_api:GET /tasks/?workstream_id",
+          "interface_kind": "rest_api",
+          "legacy_since": "2026-07-08T19:32:21.628513Z",
+          "replacement_ref": "/tasks/?workplan_id=<workplan_id>",
+          "owner_component": "state-hub.api",
+          "status": "legacy",
+          "replacement_verified": true,
+          "manual_hold": false,
+          "hold_reason": null,
+          "notes": null,
+          "retired_at": null,
+          "created_at": "2026-07-08T19:32:21.628513Z",
+          "updated_at": "2026-07-08T19:32:21.628513Z"
+        },
+        "all_time": {
+          "calls": 583,
+          "tenant_count": 1,
+          "user_count": 1,
+          "component_count": 1,
+          "tenants": {
+            "unknown": 583
+          },
+          "users": {
+            "unknown": 583
+          },
+          "components": {
+            "unknown": 583
+          }
+        },
+        "window": {
+          "calls": 0,
+          "tenant_count": 0,
+          "user_count": 0,
+          "component_count": 0,
+          "tenants": {},
+          "users": {},
+          "components": {}
+        },
+        "last_seen_at": "2026-07-16T12:36:43.901956Z",
+        "retirement_candidate": true,
+        "retirement_reason": "no measured usage in review window"
+      },
+      {
+        "interface": {
+          "id": "3e4a3d0b-08fa-45c3-91e2-4f514a914b97",
+          "interface_key": "rest_api:GET /workstreams/",
+          "interface_kind": "rest_api",
+          "legacy_since": "2026-06-04T00:26:14.533764Z",
+          "replacement_ref": "/workplans/",
+          "owner_component": "state-hub.api",
+          "status": "legacy",
+          "replacement_verified": true,
+          "manual_hold": false,
+          "hold_reason": null,
+          "notes": null,
+          "retired_at": null,
+          "created_at": "2026-06-04T00:26:14.533764Z",
+          "updated_at": "2026-06-04T00:26:14.533764Z"
+        },
+        "all_time": {
+          "calls": 144084,
+          "tenant_count": 1,
+          "user_count": 1,
+          "component_count": 1,
+          "tenants": {
+            "unknown": 144084
+          },
+          "users": {
+            "unknown": 144084
+          },
+          "components": {
+            "unknown": 144084
+          }
+        },
+        "window": {
+          "calls": 0,
+          "tenant_count": 0,
+          "user_count": 0,
+          "component_count": 0,
+          "tenants": {},
+          "users": {},
+          "components": {}
+        },
+        "last_seen_at": "2026-07-08T21:14:39.652776Z",
+        "retirement_candidate": true,
+        "retirement_reason": "no measured usage in review window"
+      },
+      {
+        "interface": {
+          "id": "e4c140ec-7479-46f9-b185-4b533f19d639",
+          "interface_key": "rest_api:GET /workstreams/workplan-index",
+          "interface_kind": "rest_api",
+          "legacy_since": "2026-06-04T05:20:58.321869Z",
+          "replacement_ref": "/workplans/index",
+          "owner_component": "state-hub.api",
+          "status": "legacy",
+          "replacement_verified": true,
+          "manual_hold": false,
+          "hold_reason": null,
+          "notes": null,
+          "retired_at": null,
+          "created_at": "2026-06-04T05:20:58.321869Z",
+          "updated_at": "2026-06-04T05:20:58.321869Z"
+        },
+        "all_time": {
+          "calls": 30,
+          "tenant_count": 1,
+          "user_count": 1,
+          "component_count": 1,
+          "tenants": {
+            "unknown": 30
+          },
+          "users": {
+            "unknown": 30
+          },
+          "components": {
+            "unknown": 30
+          }
+        },
+        "window": {
+          "calls": 0,
+          "tenant_count": 0,
+          "user_count": 0,
+          "component_count": 0,
+          "tenants": {},
+          "users": {},
+          "components": {}
+        },
+        "last_seen_at": "2026-07-03T05:20:34.534439Z",
+        "retirement_candidate": true,
+        "retirement_reason": "no measured usage in review window"
+      },
+      {
+        "interface": {
+          "id": "3a00b19e-e7db-4403-98aa-a77c9ab61ecc",
+          "interface_key": "rest_api:GET /workstreams/{workstream_id}",
+          "interface_kind": "rest_api",
+          "legacy_since": "2026-06-04T00:25:59.014966Z",
+          "replacement_ref": "/workplans/{workplan_id}",
+          "owner_component": "state-hub.api",
+          "status": "legacy",
+          "replacement_verified": true,
+          "manual_hold": false,
+          "hold_reason": null,
+          "notes": null,
+          "retired_at": null,
+          "created_at": "2026-06-04T00:25:59.014966Z",
+          "updated_at": "2026-06-04T00:25:59.014966Z"
+        },
+        "all_time": {
+          "calls": 511405,
+          "tenant_count": 1,
+          "user_count": 1,
+          "component_count": 1,
+          "tenants": {
+            "unknown": 511405
+          },
+          "users": {
+            "unknown": 511405
+          },
+          "components": {
+            "unknown": 511405
+          }
+        },
+        "window": {
+          "calls": 0,
+          "tenant_count": 0,
+          "user_count": 0,
+          "component_count": 0,
+          "tenants": {},
+          "users": {},
+          "components": {}
+        },
+        "last_seen_at": "2026-07-08T21:14:20.781103Z",
+        "retirement_candidate": true,
+        "retirement_reason": "no measured usage in review window"
+      },
+      {
+        "interface": {
+          "id": "69e1a255-a8b9-4101-8a68-b1bed23abfda",
+          "interface_key": "rest_api:GET /workstreams/{workstream_id}/dependencies/",
+          "interface_kind": "rest_api",
+          "legacy_since": "2026-06-04T00:25:59.291135Z",
+          "replacement_ref": "/workplans/{workplan_id}/dependencies/",
+          "owner_component": "state-hub.api",
+          "status": "legacy",
+          "replacement_verified": true,
+          "manual_hold": false,
+          "hold_reason": null,
+          "notes": null,
+          "retired_at": null,
+          "created_at": "2026-06-04T00:25:59.291135Z",
+          "updated_at": "2026-06-04T00:25:59.291135Z"
+        },
+        "all_time": {
+          "calls": 255865,
+          "tenant_count": 1,
+          "user_count": 1,
+          "component_count": 1,
+          "tenants": {
+            "unknown": 255865
+          },
+          "users": {
+            "unknown": 255865
+          },
+          "components": {
+            "unknown": 255865
+          }
+        },
+        "window": {
+          "calls": 0,
+          "tenant_count": 0,
+          "user_count": 0,
+          "component_count": 0,
+          "tenants": {},
+          "users": {},
+          "components": {}
+        },
+        "last_seen_at": "2026-07-08T21:14:12.747005Z",
+        "retirement_candidate": true,
+        "retirement_reason": "no measured usage in review window"
+      },
+      {
+        "interface": {
+          "id": "b1aae931-b51f-4a85-a723-865dd65f6132",
+          "interface_key": "rest_api:PATCH /workstreams/{workstream_id}",
+          "interface_kind": "rest_api",
+          "legacy_since": "2026-06-04T06:09:41.901035Z",
+          "replacement_ref": "/workplans/{workplan_id}",
+          "owner_component": "state-hub.api",
+          "status": "legacy",
+          "replacement_verified": true,
+          "manual_hold": false,
+          "hold_reason": null,
+          "notes": null,
+          "retired_at": null,
+          "created_at": "2026-06-04T06:09:41.901035Z",
+          "updated_at": "2026-06-04T06:09:41.901035Z"
+        },
+        "all_time": {
+          "calls": 571,
+          "tenant_count": 1,
+          "user_count": 1,
+          "component_count": 1,
+          "tenants": {
+            "unknown": 571
+          },
+          "users": {
+            "unknown": 571
+          },
+          "components": {
+            "unknown": 571
+          }
+        },
+        "window": {
+          "calls": 0,
+          "tenant_count": 0,
+          "user_count": 0,
+          "component_count": 0,
+          "tenants": {},
+          "users": {},
+          "components": {}
+        },
+        "last_seen_at": "2026-07-08T20:49:12.335710Z",
+        "retirement_candidate": true,
+        "retirement_reason": "no measured usage in review window"
+      },
+      {
+        "interface": {
+          "id": "4aea9591-970b-4918-ac4a-4da95a0a1a8c",
+          "interface_key": "rest_api:POST /decisions/ workstream_id",
+          "interface_kind": "rest_api",
+          "legacy_since": "2026-07-09T22:56:35.473130Z",
+          "replacement_ref": "POST /decisions/ with workplan_id",
+          "owner_component": "state-hub.api",
+          "status": "legacy",
+          "replacement_verified": true,
+          "manual_hold": false,
+          "hold_reason": null,
+          "notes": null,
+          "retired_at": null,
+          "created_at": "2026-07-09T22:56:35.473130Z",
+          "updated_at": "2026-07-09T22:56:35.473130Z"
+        },
+        "all_time": {
+          "calls": 3,
+          "tenant_count": 1,
+          "user_count": 1,
+          "component_count": 1,
+          "tenants": {
+            "unknown": 3
+          },
+          "users": {
+            "unknown": 3
+          },
+          "components": {
+            "unknown": 3
+          }
+        },
+        "window": {
+          "calls": 0,
+          "tenant_count": 0,
+          "user_count": 0,
+          "component_count": 0,
+          "tenants": {},
+          "users": {},
+          "components": {}
+        },
+        "last_seen_at": "2026-07-09T22:57:05.912456Z",
+        "retirement_candidate": true,
+        "retirement_reason": "no measured usage in review window"
+      },
+      {
+        "interface": {
+          "id": "4a70583c-1e41-4ec1-99a9-728856a7d79c",
+          "interface_key": "rest_api:POST /progress/ workstream_id",
+          "interface_kind": "rest_api",
+          "legacy_since": "2026-07-08T23:35:09.148333Z",
+          "replacement_ref": "POST /progress/ with workplan_id",
+          "owner_component": "state-hub.api",
+          "status": "legacy",
+          "replacement_verified": true,
+          "manual_hold": false,
+          "hold_reason": null,
+          "notes": null,
+          "retired_at": null,
+          "created_at": "2026-07-08T23:35:09.148333Z",
+          "updated_at": "2026-07-08T23:35:09.148333Z"
+        },
+        "all_time": {
+          "calls": 14,
+          "tenant_count": 1,
+          "user_count": 1,
+          "component_count": 1,
+          "tenants": {
+            "unknown": 14
+          },
+          "users": {
+            "unknown": 14
+          },
+          "components": {
+            "unknown": 14
+          }
+        },
+        "window": {
+          "calls": 0,
+          "tenant_count": 0,
+          "user_count": 0,
+          "component_count": 0,
+          "tenants": {},
+          "users": {},
+          "components": {}
+        },
+        "last_seen_at": "2026-07-10T08:34:42.959724Z",
+        "retirement_candidate": true,
+        "retirement_reason": "no measured usage in review window"
+      },
+      {
+        "interface": {
+          "id": "6df4e443-7bf1-461a-923b-a6eb52fe7b07",
+          "interface_key": "rest_api:POST /tasks/ workstream_id",
+          "interface_kind": "rest_api",
+          "legacy_since": "2026-07-08T22:38:29.405720Z",
+          "replacement_ref": "POST /tasks/ with workplan_id",
+          "owner_component": "state-hub.api",
+          "status": "legacy",
+          "replacement_verified": true,
+          "manual_hold": false,
+          "hold_reason": null,
+          "notes": null,
+          "retired_at": null,
+          "created_at": "2026-07-08T22:38:29.405720Z",
+          "updated_at": "2026-07-08T22:38:29.405720Z"
+        },
+        "all_time": {
+          "calls": 5,
+          "tenant_count": 1,
+          "user_count": 1,
+          "component_count": 1,
+          "tenants": {
+            "unknown": 5
+          },
+          "users": {
+            "unknown": 5
+          },
+          "components": {
+            "state-hub.fix-consistency": 5
+          }
+        },
+        "window": {
+          "calls": 0,
+          "tenant_count": 0,
+          "user_count": 0,
+          "component_count": 0,
+          "tenants": {},
+          "users": {},
+          "components": {}
+        },
+        "last_seen_at": "2026-07-08T22:38:29.976918Z",
+        "retirement_candidate": true,
+        "retirement_reason": "no measured usage in review window"
+      },
+      {
+        "interface": {
+          "id": "ed6451c9-d2cc-4486-9afe-d3852782cabc",
+          "interface_key": "rest_api:POST /workstreams/",
+          "interface_kind": "rest_api",
+          "legacy_since": "2026-06-04T07:40:24.168535Z",
+          "replacement_ref": "/workplans/",
+          "owner_component": "state-hub.api",
+          "status": "legacy",
+          "replacement_verified": true,
+          "manual_hold": false,
+          "hold_reason": null,
+          "notes": null,
+          "retired_at": null,
+          "created_at": "2026-06-04T07:40:24.168535Z",
+          "updated_at": "2026-06-04T07:40:24.168535Z"
+        },
+        "all_time": {
+          "calls": 824,
+          "tenant_count": 1,
+          "user_count": 1,
+          "component_count": 1,
+          "tenants": {
+            "unknown": 824
+          },
+          "users": {
+            "unknown": 824
+          },
+          "components": {
+            "unknown": 824
+          }
+        },
+        "window": {
+          "calls": 0,
+          "tenant_count": 0,
+          "user_count": 0,
+          "component_count": 0,
+          "tenants": {},
+          "users": {},
+          "components": {}
+        },
+        "last_seen_at": "2026-07-08T20:38:05.903144Z",
+        "retirement_candidate": true,
+        "retirement_reason": "no measured usage in review window"
+      },
+      {
+        "interface": {
+          "id": "281fd706-b192-4194-8055-2d8733c115f9",
+          "interface_key": "rest_api:POST /workstreams/{workstream_id}/dependencies/",
+          "interface_kind": "rest_api",
+          "legacy_since": "2026-06-04T22:57:37.149207Z",
+          "replacement_ref": "/workplans/{workplan_id}/dependencies/",
+          "owner_component": "state-hub.api",
+          "status": "legacy",
+          "replacement_verified": true,
+          "manual_hold": false,
+          "hold_reason": null,
+          "notes": null,
+          "retired_at": null,
+          "created_at": "2026-06-04T22:57:37.149207Z",
+          "updated_at": "2026-06-04T22:57:37.149207Z"
+        },
+        "all_time": {
+          "calls": 4971,
+          "tenant_count": 1,
+          "user_count": 1,
+          "component_count": 1,
+          "tenants": {
+            "unknown": 4971
+          },
+          "users": {
+            "unknown": 4971
+          },
+          "components": {
+            "unknown": 4971
+          }
+        },
+        "window": {
+          "calls": 0,
+          "tenant_count": 0,
+          "user_count": 0,
+          "component_count": 0,
+          "tenants": {},
+          "users": {},
+          "components": {}
+        },
+        "last_seen_at": "2026-07-01T22:09:24.229011Z",
+        "retirement_candidate": true,
+        "retirement_reason": "no measured usage in review window"
+      }
+    ],
+    "retirement_candidates": [
+      {
+        "interface": {
+          "id": "63ed90e3-42b4-431a-94db-e1254a52f9e2",
+          "interface_key": "mcp:create_workstream",
+          "interface_kind": "mcp_tool",
+          "legacy_since": "2026-07-10T13:19:44.205900Z",
+          "replacement_ref": "create_workplan",
+          "owner_component": "state-hub.mcp",
+          "status": "legacy",
+          "replacement_verified": true,
+          "manual_hold": false,
+          "hold_reason": null,
+          "notes": "Registered by STATE-WP-0070 T03 \u2014 zero-window streak starts at registration",
+          "retired_at": null,
+          "created_at": "2026-07-10T13:19:44.205900Z",
+          "updated_at": "2026-07-10T13:19:44.205900Z"
+        },
+        "all_time": {
+          "calls": 2,
+          "tenant_count": 1,
+          "user_count": 1,
+          "component_count": 1,
+          "tenants": {
+            "unknown": 2
+          },
+          "users": {
+            "unknown": 2
+          },
+          "components": {
+            "state-hub.mcp": 2
+          }
+        },
+        "window": {
+          "calls": 0,
+          "tenant_count": 0,
+          "user_count": 0,
+          "component_count": 0,
+          "tenants": {},
+          "users": {},
+          "components": {}
+        },
+        "last_seen_at": "2026-07-10T13:20:43.378546Z",
+        "retirement_candidate": true,
+        "retirement_reason": "no measured usage in review window"
+      },
+      {
+        "interface": {
+          "id": "b6a5fe44-fb85-4ef7-a273-78d09da777af",
+          "interface_key": "mcp:list_workstreams",
+          "interface_kind": "mcp_tool",
+          "legacy_since": "2026-07-10T13:19:26.075491Z",
+          "replacement_ref": "list_workplans",
+          "owner_component": "state-hub.mcp",
+          "status": "legacy",
+          "replacement_verified": true,
+          "manual_hold": false,
+          "hold_reason": null,
+          "notes": null,
+          "retired_at": null,
+          "created_at": "2026-07-10T13:19:26.075491Z",
+          "updated_at": "2026-07-10T13:19:26.075491Z"
+        },
+        "all_time": {
+          "calls": 2,
+          "tenant_count": 1,
+          "user_count": 1,
+          "component_count": 1,
+          "tenants": {
+            "unknown": 2
+          },
+          "users": {
+            "unknown": 2
+          },
+          "components": {
+            "state-hub.mcp": 2
+          }
+        },
+        "window": {
+          "calls": 0,
+          "tenant_count": 0,
+          "user_count": 0,
+          "component_count": 0,
+          "tenants": {},
+          "users": {},
+          "components": {}
+        },
+        "last_seen_at": "2026-07-10T13:20:42.374940Z",
+        "retirement_candidate": true,
+        "retirement_reason": "no measured usage in review window"
+      },
+      {
+        "interface": {
+          "id": "53c3372b-307d-4d6a-8ea4-bc36cacdcaf2",
+          "interface_key": "mcp:update_workstream",
+          "interface_kind": "mcp_tool",
+          "legacy_since": "2026-07-10T13:19:44.255216Z",
+          "replacement_ref": "update_workplan",
+          "owner_component": "state-hub.mcp",
+          "status": "legacy",
+          "replacement_verified": true,
+          "manual_hold": false,
+          "hold_reason": null,
+          "notes": "Registered by STATE-WP-0070 T03 \u2014 zero-window streak starts at registration",
+          "retired_at": null,
+          "created_at": "2026-07-10T13:19:44.255216Z",
+          "updated_at": "2026-07-10T13:19:44.255216Z"
+        },
+        "all_time": {
+          "calls": 0,
+          "tenant_count": 0,
+          "user_count": 0,
+          "component_count": 0,
+          "tenants": {},
+          "users": {},
+          "components": {}
+        },
+        "window": {
+          "calls": 0,
+          "tenant_count": 0,
+          "user_count": 0,
+          "component_count": 0,
+          "tenants": {},
+          "users": {},
+          "components": {}
+        },
+        "last_seen_at": null,
+        "retirement_candidate": true,
+        "retirement_reason": "no measured usage in review window"
+      },
+      {
+        "interface": {
+          "id": "bed4d08a-3471-48f5-9f0e-f9d550383a26",
+          "interface_key": "mcp:update_workstream_status",
+          "interface_kind": "mcp_tool",
+          "legacy_since": "2026-07-10T13:19:44.303612Z",
+          "replacement_ref": "update_workplan_status",
+          "owner_component": "state-hub.mcp",
+          "status": "legacy",
+          "replacement_verified": true,
+          "manual_hold": false,
+          "hold_reason": null,
+          "notes": "Registered by STATE-WP-0070 T03 \u2014 zero-window streak starts at registration",
+          "retired_at": null,
+          "created_at": "2026-07-10T13:19:44.303612Z",
+          "updated_at": "2026-07-10T13:19:44.303612Z"
+        },
+        "all_time": {
+          "calls": 0,
+          "tenant_count": 0,
+          "user_count": 0,
+          "component_count": 0,
+          "tenants": {},
+          "users": {},
+          "components": {}
+        },
+        "window": {
+          "calls": 0,
+          "tenant_count": 0,
+          "user_count": 0,
+          "component_count": 0,
+          "tenants": {},
+          "users": {},
+          "components": {}
+        },
+        "last_seen_at": null,
+        "retirement_candidate": true,
+        "retirement_reason": "no measured usage in review window"
+      },
+      {
+        "interface": {
+          "id": "46900dc2-0893-405b-ba59-80f31fb6ebb1",
+          "interface_key": "state://workstreams/{topic_slug}",
+          "interface_kind": "mcp_tool",
+          "legacy_since": "2026-07-10T13:19:44.344493Z",
+          "replacement_ref": "state://workplans/{topic_slug}",
+          "owner_component": "state-hub.mcp",
+          "status": "legacy",
+          "replacement_verified": true,
+          "manual_hold": false,
+          "hold_reason": null,
+          "notes": "Registered by STATE-WP-0070 T03 \u2014 zero-window streak starts at registration",
+          "retired_at": null,
+          "created_at": "2026-07-10T13:19:44.344493Z",
+          "updated_at": "2026-07-10T13:19:44.344493Z"
+        },
+        "all_time": {
+          "calls": 1,
+          "tenant_count": 1,
+          "user_count": 1,
+          "component_count": 1,
+          "tenants": {
+            "unknown": 1
+          },
+          "users": {
+            "unknown": 1
+          },
+          "components": {
+            "state-hub.mcp": 1
+          }
+        },
+        "window": {
+          "calls": 0,
+          "tenant_count": 0,
+          "user_count": 0,
+          "component_count": 0,
+          "tenants": {},
+          "users": {},
+          "components": {}
+        },
+        "last_seen_at": "2026-07-10T13:20:34.491811Z",
+        "retirement_candidate": true,
+        "retirement_reason": "no measured usage in review window"
+      },
+      {
+        "interface": {
+          "id": "cd9342fd-27e7-4a46-a1be-d41499e106a3",
+          "interface_key": "rest_api:DELETE /workstreams/{workstream_id}",
+          "interface_kind": "rest_api",
+          "legacy_since": "2026-06-06T17:28:13.052813Z",
+          "replacement_ref": "/workplans/{workplan_id}",
+          "owner_component": "state-hub.api",
+          "status": "legacy",
+          "replacement_verified": true,
+          "manual_hold": false,
+          "hold_reason": null,
+          "notes": null,
+          "retired_at": null,
+          "created_at": "2026-06-06T17:28:13.052813Z",
+          "updated_at": "2026-06-06T17:28:13.052813Z"
+        },
+        "all_time": {
+          "calls": 1,
+          "tenant_count": 1,
+          "user_count": 1,
+          "component_count": 1,
+          "tenants": {
+            "unknown": 1
+          },
+          "users": {
+            "unknown": 1
+          },
+          "components": {
+            "unknown": 1
+          }
+        },
+        "window": {
+          "calls": 0,
+          "tenant_count": 0,
+          "user_count": 0,
+          "component_count": 0,
+          "tenants": {},
+          "users": {},
+          "components": {}
+        },
+        "last_seen_at": "2026-06-06T17:28:13.047529Z",
+        "retirement_candidate": true,
+        "retirement_reason": "no measured usage in review window"
+      },
+      {
+        "interface": {
+          "id": "a4e0948c-cd4a-461e-8ae2-7fd7b51d04a7",
+          "interface_key": "rest_api:GET /decisions/?workstream_id",
+          "interface_kind": "rest_api",
+          "legacy_since": "2026-07-09T23:07:53.093223Z",
+          "replacement_ref": "/decisions/?workplan_id=<workplan_id>",
+          "owner_component": "state-hub.api",
+          "status": "legacy",
+          "replacement_verified": true,
+          "manual_hold": false,
+          "hold_reason": null,
+          "notes": null,
+          "retired_at": null,
+          "created_at": "2026-07-09T23:07:53.093223Z",
+          "updated_at": "2026-07-09T23:07:53.093223Z"
+        },
+        "all_time": {
+          "calls": 1,
+          "tenant_count": 1,
+          "user_count": 1,
+          "component_count": 1,
+          "tenants": {
+            "unknown": 1
+          },
+          "users": {
+            "unknown": 1
+          },
+          "components": {
+            "unknown": 1
+          }
+        },
+        "window": {
+          "calls": 0,
+          "tenant_count": 0,
+          "user_count": 0,
+          "component_count": 0,
+          "tenants": {},
+          "users": {},
+          "components": {}
+        },
+        "last_seen_at": "2026-07-09T23:07:53.083299Z",
+        "retirement_candidate": true,
+        "retirement_reason": "no measured usage in review window"
+      },
+      {
+        "interface": {
+          "id": "70a9346e-e0ee-42ac-874f-f160580b54dd",
+          "interface_key": "rest_api:GET /progress/?workstream_id",
+          "interface_kind": "rest_api",
+          "legacy_since": "2026-07-13T22:04:03.911449Z",
+          "replacement_ref": "/progress/?workplan_id=<workplan_id>",
+          "owner_component": "state-hub.api",
+          "status": "legacy",
+          "replacement_verified": true,
+          "manual_hold": false,
+          "hold_reason": null,
+          "notes": null,
+          "retired_at": null,
+          "created_at": "2026-07-13T22:04:03.911449Z",
+          "updated_at": "2026-07-13T22:04:03.911449Z"
+        },
+        "all_time": {
+          "calls": 1,
+          "tenant_count": 1,
+          "user_count": 1,
+          "component_count": 1,
+          "tenants": {
+            "unknown": 1
+          },
+          "users": {
+            "unknown": 1
+          },
+          "components": {
+            "unknown": 1
+          }
+        },
+        "window": {
+          "calls": 0,
+          "tenant_count": 0,
+          "user_count": 0,
+          "component_count": 0,
+          "tenants": {},
+          "users": {},
+          "components": {}
+        },
+        "last_seen_at": "2026-07-13T22:04:03.904998Z",
+        "retirement_candidate": true,
+        "retirement_reason": "no measured usage in review window"
+      },
+      {
+        "interface": {
+          "id": "be3cdcf8-250b-4bf0-801f-02ffd5f57e00",
+          "interface_key": "rest_api:GET /tasks/?workstream_id",
+          "interface_kind": "rest_api",
+          "legacy_since": "2026-07-08T19:32:21.628513Z",
+          "replacement_ref": "/tasks/?workplan_id=<workplan_id>",
+          "owner_component": "state-hub.api",
+          "status": "legacy",
+          "replacement_verified": true,
+          "manual_hold": false,
+          "hold_reason": null,
+          "notes": null,
+          "retired_at": null,
+          "created_at": "2026-07-08T19:32:21.628513Z",
+          "updated_at": "2026-07-08T19:32:21.628513Z"
+        },
+        "all_time": {
+          "calls": 583,
+          "tenant_count": 1,
+          "user_count": 1,
+          "component_count": 1,
+          "tenants": {
+            "unknown": 583
+          },
+          "users": {
+            "unknown": 583
+          },
+          "components": {
+            "unknown": 583
+          }
+        },
+        "window": {
+          "calls": 0,
+          "tenant_count": 0,
+          "user_count": 0,
+          "component_count": 0,
+          "tenants": {},
+          "users": {},
+          "components": {}
+        },
+        "last_seen_at": "2026-07-16T12:36:43.901956Z",
+        "retirement_candidate": true,
+        "retirement_reason": "no measured usage in review window"
+      },
+      {
+        "interface": {
+          "id": "3e4a3d0b-08fa-45c3-91e2-4f514a914b97",
+          "interface_key": "rest_api:GET /workstreams/",
+          "interface_kind": "rest_api",
+          "legacy_since": "2026-06-04T00:26:14.533764Z",
+          "replacement_ref": "/workplans/",
+          "owner_component": "state-hub.api",
+          "status": "legacy",
+          "replacement_verified": true,
+          "manual_hold": false,
+          "hold_reason": null,
+          "notes": null,
+          "retired_at": null,
+          "created_at": "2026-06-04T00:26:14.533764Z",
+          "updated_at": "2026-06-04T00:26:14.533764Z"
+        },
+        "all_time": {
+          "calls": 144084,
+          "tenant_count": 1,
+          "user_count": 1,
+          "component_count": 1,
+          "tenants": {
+            "unknown": 144084
+          },
+          "users": {
+            "unknown": 144084
+          },
+          "components": {
+            "unknown": 144084
+          }
+        },
+        "window": {
+          "calls": 0,
+          "tenant_count": 0,
+          "user_count": 0,
+          "component_count": 0,
+          "tenants": {},
+          "users": {},
+          "components": {}
+        },
+        "last_seen_at": "2026-07-08T21:14:39.652776Z",
+        "retirement_candidate": true,
+        "retirement_reason": "no measured usage in review window"
+      },
+      {
+        "interface": {
+          "id": "e4c140ec-7479-46f9-b185-4b533f19d639",
+          "interface_key": "rest_api:GET /workstreams/workplan-index",
+          "interface_kind": "rest_api",
+          "legacy_since": "2026-06-04T05:20:58.321869Z",
+          "replacement_ref": "/workplans/index",
+          "owner_component": "state-hub.api",
+          "status": "legacy",
+          "replacement_verified": true,
+          "manual_hold": false,
+          "hold_reason": null,
+          "notes": null,
+          "retired_at": null,
+          "created_at": "2026-06-04T05:20:58.321869Z",
+          "updated_at": "2026-06-04T05:20:58.321869Z"
+        },
+        "all_time": {
+          "calls": 30,
+          "tenant_count": 1,
+          "user_count": 1,
+          "component_count": 1,
+          "tenants": {
+            "unknown": 30
+          },
+          "users": {
+            "unknown": 30
+          },
+          "components": {
+            "unknown": 30
+          }
+        },
+        "window": {
+          "calls": 0,
+          "tenant_count": 0,
+          "user_count": 0,
+          "component_count": 0,
+          "tenants": {},
+          "users": {},
+          "components": {}
+        },
+        "last_seen_at": "2026-07-03T05:20:34.534439Z",
+        "retirement_candidate": true,
+        "retirement_reason": "no measured usage in review window"
+      },
+      {
+        "interface": {
+          "id": "3a00b19e-e7db-4403-98aa-a77c9ab61ecc",
+          "interface_key": "rest_api:GET /workstreams/{workstream_id}",
+          "interface_kind": "rest_api",
+          "legacy_since": "2026-06-04T00:25:59.014966Z",
+          "replacement_ref": "/workplans/{workplan_id}",
+          "owner_component": "state-hub.api",
+          "status": "legacy",
+          "replacement_verified": true,
+          "manual_hold": false,
+          "hold_reason": null,
+          "notes": null,
+          "retired_at": null,
+          "created_at": "2026-06-04T00:25:59.014966Z",
+          "updated_at": "2026-06-04T00:25:59.014966Z"
+        },
+        "all_time": {
+          "calls": 511405,
+          "tenant_count": 1,
+          "user_count": 1,
+          "component_count": 1,
+          "tenants": {
+            "unknown": 511405
+          },
+          "users": {
+            "unknown": 511405
+          },
+          "components": {
+            "unknown": 511405
+          }
+        },
+        "window": {
+          "calls": 0,
+          "tenant_count": 0,
+          "user_count": 0,
+          "component_count": 0,
+          "tenants": {},
+          "users": {},
+          "components": {}
+        },
+        "last_seen_at": "2026-07-08T21:14:20.781103Z",
+        "retirement_candidate": true,
+        "retirement_reason": "no measured usage in review window"
+      },
+      {
+        "interface": {
+          "id": "69e1a255-a8b9-4101-8a68-b1bed23abfda",
+          "interface_key": "rest_api:GET /workstreams/{workstream_id}/dependencies/",
+          "interface_kind": "rest_api",
+          "legacy_since": "2026-06-04T00:25:59.291135Z",
+          "replacement_ref": "/workplans/{workplan_id}/dependencies/",
+          "owner_component": "state-hub.api",
+          "status": "legacy",
+          "replacement_verified": true,
+          "manual_hold": false,
+          "hold_reason": null,
+          "notes": null,
+          "retired_at": null,
+          "created_at": "2026-06-04T00:25:59.291135Z",
+          "updated_at": "2026-06-04T00:25:59.291135Z"
+        },
+        "all_time": {
+          "calls": 255865,
+          "tenant_count": 1,
+          "user_count": 1,
+          "component_count": 1,
+          "tenants": {
+            "unknown": 255865
+          },
+          "users": {
+            "unknown": 255865
+          },
+          "components": {
+            "unknown": 255865
+          }
+        },
+        "window": {
+          "calls": 0,
+          "tenant_count": 0,
+          "user_count": 0,
+          "component_count": 0,
+          "tenants": {},
+          "users": {},
+          "components": {}
+        },
+        "last_seen_at": "2026-07-08T21:14:12.747005Z",
+        "retirement_candidate": true,
+        "retirement_reason": "no measured usage in review window"
+      },
+      {
+        "interface": {
+          "id": "b1aae931-b51f-4a85-a723-865dd65f6132",
+          "interface_key": "rest_api:PATCH /workstreams/{workstream_id}",
+          "interface_kind": "rest_api",
+          "legacy_since": "2026-06-04T06:09:41.901035Z",
+          "replacement_ref": "/workplans/{workplan_id}",
+          "owner_component": "state-hub.api",
+          "status": "legacy",
+          "replacement_verified": true,
+          "manual_hold": false,
+          "hold_reason": null,
+          "notes": null,
+          "retired_at": null,
+          "created_at": "2026-06-04T06:09:41.901035Z",
+          "updated_at": "2026-06-04T06:09:41.901035Z"
+        },
+        "all_time": {
+          "calls": 571,
+          "tenant_count": 1,
+          "user_count": 1,
+          "component_count": 1,
+          "tenants": {
+            "unknown": 571
+          },
+          "users": {
+            "unknown": 571
+          },
+          "components": {
+            "unknown": 571
+          }
+        },
+        "window": {
+          "calls": 0,
+          "tenant_count": 0,
+          "user_count": 0,
+          "component_count": 0,
+          "tenants": {},
+          "users": {},
+          "components": {}
+        },
+        "last_seen_at": "2026-07-08T20:49:12.335710Z",
+        "retirement_candidate": true,
+        "retirement_reason": "no measured usage in review window"
+      },
+      {
+        "interface": {
+          "id": "4aea9591-970b-4918-ac4a-4da95a0a1a8c",
+          "interface_key": "rest_api:POST /decisions/ workstream_id",
+          "interface_kind": "rest_api",
+          "legacy_since": "2026-07-09T22:56:35.473130Z",
+          "replacement_ref": "POST /decisions/ with workplan_id",
+          "owner_component": "state-hub.api",
+          "status": "legacy",
+          "replacement_verified": true,
+          "manual_hold": false,
+          "hold_reason": null,
+          "notes": null,
+          "retired_at": null,
+          "created_at": "2026-07-09T22:56:35.473130Z",
+          "updated_at": "2026-07-09T22:56:35.473130Z"
+        },
+        "all_time": {
+          "calls": 3,
+          "tenant_count": 1,
+          "user_count": 1,
+          "component_count": 1,
+          "tenants": {
+            "unknown": 3
+          },
+          "users": {
+            "unknown": 3
+          },
+          "components": {
+            "unknown": 3
+          }
+        },
+        "window": {
+          "calls": 0,
+          "tenant_count": 0,
+          "user_count": 0,
+          "component_count": 0,
+          "tenants": {},
+          "users": {},
+          "components": {}
+        },
+        "last_seen_at": "2026-07-09T22:57:05.912456Z",
+        "retirement_candidate": true,
+        "retirement_reason": "no measured usage in review window"
+      },
+      {
+        "interface": {
+          "id": "4a70583c-1e41-4ec1-99a9-728856a7d79c",
+          "interface_key": "rest_api:POST /progress/ workstream_id",
+          "interface_kind": "rest_api",
+          "legacy_since": "2026-07-08T23:35:09.148333Z",
+          "replacement_ref": "POST /progress/ with workplan_id",
+          "owner_component": "state-hub.api",
+          "status": "legacy",
+          "replacement_verified": true,
+          "manual_hold": false,
+          "hold_reason": null,
+          "notes": null,
+          "retired_at": null,
+          "created_at": "2026-07-08T23:35:09.148333Z",
+          "updated_at": "2026-07-08T23:35:09.148333Z"
+        },
+        "all_time": {
+          "calls": 14,
+          "tenant_count": 1,
+          "user_count": 1,
+          "component_count": 1,
+          "tenants": {
+            "unknown": 14
+          },
+          "users": {
+            "unknown": 14
+          },
+          "components": {
+            "unknown": 14
+          }
+        },
+        "window": {
+          "calls": 0,
+          "tenant_count": 0,
+          "user_count": 0,
+          "component_count": 0,
+          "tenants": {},
+          "users": {},
+          "components": {}
+        },
+        "last_seen_at": "2026-07-10T08:34:42.959724Z",
+        "retirement_candidate": true,
+        "retirement_reason": "no measured usage in review window"
+      },
+      {
+        "interface": {
+          "id": "6df4e443-7bf1-461a-923b-a6eb52fe7b07",
+          "interface_key": "rest_api:POST /tasks/ workstream_id",
+          "interface_kind": "rest_api",
+          "legacy_since": "2026-07-08T22:38:29.405720Z",
+          "replacement_ref": "POST /tasks/ with workplan_id",
+          "owner_component": "state-hub.api",
+          "status": "legacy",
+          "replacement_verified": true,
+          "manual_hold": false,
+          "hold_reason": null,
+          "notes": null,
+          "retired_at": null,
+          "created_at": "2026-07-08T22:38:29.405720Z",
+          "updated_at": "2026-07-08T22:38:29.405720Z"
+        },
+        "all_time": {
+          "calls": 5,
+          "tenant_count": 1,
+          "user_count": 1,
+          "component_count": 1,
+          "tenants": {
+            "unknown": 5
+          },
+          "users": {
+            "unknown": 5
+          },
+          "components": {
+            "state-hub.fix-consistency": 5
+          }
+        },
+        "window": {
+          "calls": 0,
+          "tenant_count": 0,
+          "user_count": 0,
+          "component_count": 0,
+          "tenants": {},
+          "users": {},
+          "components": {}
+        },
+        "last_seen_at": "2026-07-08T22:38:29.976918Z",
+        "retirement_candidate": true,
+        "retirement_reason": "no measured usage in review window"
+      },
+      {
+        "interface": {
+          "id": "ed6451c9-d2cc-4486-9afe-d3852782cabc",
+          "interface_key": "rest_api:POST /workstreams/",
+          "interface_kind": "rest_api",
+          "legacy_since": "2026-06-04T07:40:24.168535Z",
+          "replacement_ref": "/workplans/",
+          "owner_component": "state-hub.api",
+          "status": "legacy",
+          "replacement_verified": true,
+          "manual_hold": false,
+          "hold_reason": null,
+          "notes": null,
+          "retired_at": null,
+          "created_at": "2026-06-04T07:40:24.168535Z",
+          "updated_at": "2026-06-04T07:40:24.168535Z"
+        },
+        "all_time": {
+          "calls": 824,
+          "tenant_count": 1,
+          "user_count": 1,
+          "component_count": 1,
+          "tenants": {
+            "unknown": 824
+          },
+          "users": {
+            "unknown": 824
+          },
+          "components": {
+            "unknown": 824
+          }
+        },
+        "window": {
+          "calls": 0,
+          "tenant_count": 0,
+          "user_count": 0,
+          "component_count": 0,
+          "tenants": {},
+          "users": {},
+          "components": {}
+        },
+        "last_seen_at": "2026-07-08T20:38:05.903144Z",
+        "retirement_candidate": true,
+        "retirement_reason": "no measured usage in review window"
+      },
+      {
+        "interface": {
+          "id": "281fd706-b192-4194-8055-2d8733c115f9",
+          "interface_key": "rest_api:POST /workstreams/{workstream_id}/dependencies/",
+          "interface_kind": "rest_api",
+          "legacy_since": "2026-06-04T22:57:37.149207Z",
+          "replacement_ref": "/workplans/{workplan_id}/dependencies/",
+          "owner_component": "state-hub.api",
+          "status": "legacy",
+          "replacement_verified": true,
+          "manual_hold": false,
+          "hold_reason": null,
+          "notes": null,
+          "retired_at": null,
+          "created_at": "2026-06-04T22:57:37.149207Z",
+          "updated_at": "2026-06-04T22:57:37.149207Z"
+        },
+        "all_time": {
+          "calls": 4971,
+          "tenant_count": 1,
+          "user_count": 1,
+          "component_count": 1,
+          "tenants": {
+            "unknown": 4971
+          },
+          "users": {
+            "unknown": 4971
+          },
+          "components": {
+            "unknown": 4971
+          }
+        },
+        "window": {
+          "calls": 0,
+          "tenant_count": 0,
+          "user_count": 0,
+          "component_count": 0,
+          "tenants": {},
+          "users": {},
+          "components": {}
+        },
+        "last_seen_at": "2026-07-01T22:09:24.229011Z",
+        "retirement_candidate": true,
+        "retirement_reason": "no measured usage in review window"
+      }
+    ]
+  },
+  "hours": 8
+}
diff --git a/docs/evidence/legacy-meter-weekly-review-20260719.json b/docs/evidence/legacy-meter-weekly-review-20260719.json
new file mode 100644
index 0000000..1909ed9
--- /dev/null
+++ b/docs/evidence/legacy-meter-weekly-review-20260719.json
@@ -0,0 +1,1755 @@
+{
+  "captured_at": "2026-07-19T14:00:06.091484+00:00",
+  "api_base": "http://127.0.0.1:8000",
+  "workplan": "STATE-WP-0070",
+  "retired_interfaces": [],
+  "weekly_review": {
+    "generated_at": "2026-07-19T14:00:06.084800Z",
+    "window_start": "2026-07-19T06:00:05.487277Z",
+    "window_end": "2026-07-19T14:00:05.487277Z",
+    "cadence": "weekly",
+    "activity_core_handoff": {
+      "activity_id": "statehub-legacy-interface-review",
+      "cadence": "weekly",
+      "source_endpoint": "/legacy-meter/weekly-review",
+      "state_owner": "state-hub",
+      "scheduler_owner": "activity-core"
+    },
+    "interfaces": [
+      {
+        "interface": {
+          "id": "8051fb40-66c9-4dc4-a413-13e8573e04a3",
+          "interface_key": "event_subject:org.statehub.workstream.completed",
+          "interface_kind": "event_subject",
+          "legacy_since": "2026-06-04T06:09:42.198193Z",
+          "replacement_ref": "org.statehub.workplan.completed",
+          "owner_component": "state-hub.events",
+          "status": "retired",
+          "replacement_verified": true,
+          "manual_hold": false,
+          "hold_reason": null,
+          "notes": "Retired by STATE-WP-0069 closeout",
+          "retired_at": "2026-07-08T21:38:52.773601Z",
+          "created_at": "2026-06-04T06:09:42.198193Z",
+          "updated_at": "2026-07-08T21:38:52.761243Z"
+        },
+        "all_time": {
+          "calls": 255,
+          "tenant_count": 1,
+          "user_count": 1,
+          "component_count": 1,
+          "tenants": {
+            "unknown": 255
+          },
+          "users": {
+            "unknown": 255
+          },
+          "components": {
+            "state-hub.events": 255
+          }
+        },
+        "window": {
+          "calls": 0,
+          "tenant_count": 0,
+          "user_count": 0,
+          "component_count": 0,
+          "tenants": {},
+          "users": {},
+          "components": {}
+        },
+        "last_seen_at": "2026-07-08T20:49:12.839383Z",
+        "retirement_candidate": false,
+        "retirement_reason": "already retired"
+      },
+      {
+        "interface": {
+          "id": "63ed90e3-42b4-431a-94db-e1254a52f9e2",
+          "interface_key": "mcp:create_workstream",
+          "interface_kind": "mcp_tool",
+          "legacy_since": "2026-07-10T13:19:44.205900Z",
+          "replacement_ref": "create_workplan",
+          "owner_component": "state-hub.mcp",
+          "status": "legacy",
+          "replacement_verified": true,
+          "manual_hold": false,
+          "hold_reason": null,
+          "notes": "Registered by STATE-WP-0070 T03 \u2014 zero-window streak starts at registration",
+          "retired_at": null,
+          "created_at": "2026-07-10T13:19:44.205900Z",
+          "updated_at": "2026-07-10T13:19:44.205900Z"
+        },
+        "all_time": {
+          "calls": 2,
+          "tenant_count": 1,
+          "user_count": 1,
+          "component_count": 1,
+          "tenants": {
+            "unknown": 2
+          },
+          "users": {
+            "unknown": 2
+          },
+          "components": {
+            "state-hub.mcp": 2
+          }
+        },
+        "window": {
+          "calls": 0,
+          "tenant_count": 0,
+          "user_count": 0,
+          "component_count": 0,
+          "tenants": {},
+          "users": {},
+          "components": {}
+        },
+        "last_seen_at": "2026-07-10T13:20:43.378546Z",
+        "retirement_candidate": true,
+        "retirement_reason": "no measured usage in review window"
+      },
+      {
+        "interface": {
+          "id": "b6a5fe44-fb85-4ef7-a273-78d09da777af",
+          "interface_key": "mcp:list_workstreams",
+          "interface_kind": "mcp_tool",
+          "legacy_since": "2026-07-10T13:19:26.075491Z",
+          "replacement_ref": "list_workplans",
+          "owner_component": "state-hub.mcp",
+          "status": "legacy",
+          "replacement_verified": true,
+          "manual_hold": false,
+          "hold_reason": null,
+          "notes": null,
+          "retired_at": null,
+          "created_at": "2026-07-10T13:19:26.075491Z",
+          "updated_at": "2026-07-10T13:19:26.075491Z"
+        },
+        "all_time": {
+          "calls": 2,
+          "tenant_count": 1,
+          "user_count": 1,
+          "component_count": 1,
+          "tenants": {
+            "unknown": 2
+          },
+          "users": {
+            "unknown": 2
+          },
+          "components": {
+            "state-hub.mcp": 2
+          }
+        },
+        "window": {
+          "calls": 0,
+          "tenant_count": 0,
+          "user_count": 0,
+          "component_count": 0,
+          "tenants": {},
+          "users": {},
+          "components": {}
+        },
+        "last_seen_at": "2026-07-10T13:20:42.374940Z",
+        "retirement_candidate": true,
+        "retirement_reason": "no measured usage in review window"
+      },
+      {
+        "interface": {
+          "id": "53c3372b-307d-4d6a-8ea4-bc36cacdcaf2",
+          "interface_key": "mcp:update_workstream",
+          "interface_kind": "mcp_tool",
+          "legacy_since": "2026-07-10T13:19:44.255216Z",
+          "replacement_ref": "update_workplan",
+          "owner_component": "state-hub.mcp",
+          "status": "legacy",
+          "replacement_verified": true,
+          "manual_hold": false,
+          "hold_reason": null,
+          "notes": "Registered by STATE-WP-0070 T03 \u2014 zero-window streak starts at registration",
+          "retired_at": null,
+          "created_at": "2026-07-10T13:19:44.255216Z",
+          "updated_at": "2026-07-10T13:19:44.255216Z"
+        },
+        "all_time": {
+          "calls": 0,
+          "tenant_count": 0,
+          "user_count": 0,
+          "component_count": 0,
+          "tenants": {},
+          "users": {},
+          "components": {}
+        },
+        "window": {
+          "calls": 0,
+          "tenant_count": 0,
+          "user_count": 0,
+          "component_count": 0,
+          "tenants": {},
+          "users": {},
+          "components": {}
+        },
+        "last_seen_at": null,
+        "retirement_candidate": true,
+        "retirement_reason": "no measured usage in review window"
+      },
+      {
+        "interface": {
+          "id": "bed4d08a-3471-48f5-9f0e-f9d550383a26",
+          "interface_key": "mcp:update_workstream_status",
+          "interface_kind": "mcp_tool",
+          "legacy_since": "2026-07-10T13:19:44.303612Z",
+          "replacement_ref": "update_workplan_status",
+          "owner_component": "state-hub.mcp",
+          "status": "legacy",
+          "replacement_verified": true,
+          "manual_hold": false,
+          "hold_reason": null,
+          "notes": "Registered by STATE-WP-0070 T03 \u2014 zero-window streak starts at registration",
+          "retired_at": null,
+          "created_at": "2026-07-10T13:19:44.303612Z",
+          "updated_at": "2026-07-10T13:19:44.303612Z"
+        },
+        "all_time": {
+          "calls": 0,
+          "tenant_count": 0,
+          "user_count": 0,
+          "component_count": 0,
+          "tenants": {},
+          "users": {},
+          "components": {}
+        },
+        "window": {
+          "calls": 0,
+          "tenant_count": 0,
+          "user_count": 0,
+          "component_count": 0,
+          "tenants": {},
+          "users": {},
+          "components": {}
+        },
+        "last_seen_at": null,
+        "retirement_candidate": true,
+        "retirement_reason": "no measured usage in review window"
+      },
+      {
+        "interface": {
+          "id": "46900dc2-0893-405b-ba59-80f31fb6ebb1",
+          "interface_key": "state://workstreams/{topic_slug}",
+          "interface_kind": "mcp_tool",
+          "legacy_since": "2026-07-10T13:19:44.344493Z",
+          "replacement_ref": "state://workplans/{topic_slug}",
+          "owner_component": "state-hub.mcp",
+          "status": "legacy",
+          "replacement_verified": true,
+          "manual_hold": false,
+          "hold_reason": null,
+          "notes": "Registered by STATE-WP-0070 T03 \u2014 zero-window streak starts at registration",
+          "retired_at": null,
+          "created_at": "2026-07-10T13:19:44.344493Z",
+          "updated_at": "2026-07-10T13:19:44.344493Z"
+        },
+        "all_time": {
+          "calls": 1,
+          "tenant_count": 1,
+          "user_count": 1,
+          "component_count": 1,
+          "tenants": {
+            "unknown": 1
+          },
+          "users": {
+            "unknown": 1
+          },
+          "components": {
+            "state-hub.mcp": 1
+          }
+        },
+        "window": {
+          "calls": 0,
+          "tenant_count": 0,
+          "user_count": 0,
+          "component_count": 0,
+          "tenants": {},
+          "users": {},
+          "components": {}
+        },
+        "last_seen_at": "2026-07-10T13:20:34.491811Z",
+        "retirement_candidate": true,
+        "retirement_reason": "no measured usage in review window"
+      },
+      {
+        "interface": {
+          "id": "cd9342fd-27e7-4a46-a1be-d41499e106a3",
+          "interface_key": "rest_api:DELETE /workstreams/{workstream_id}",
+          "interface_kind": "rest_api",
+          "legacy_since": "2026-06-06T17:28:13.052813Z",
+          "replacement_ref": "/workplans/{workplan_id}",
+          "owner_component": "state-hub.api",
+          "status": "legacy",
+          "replacement_verified": true,
+          "manual_hold": false,
+          "hold_reason": null,
+          "notes": null,
+          "retired_at": null,
+          "created_at": "2026-06-06T17:28:13.052813Z",
+          "updated_at": "2026-06-06T17:28:13.052813Z"
+        },
+        "all_time": {
+          "calls": 1,
+          "tenant_count": 1,
+          "user_count": 1,
+          "component_count": 1,
+          "tenants": {
+            "unknown": 1
+          },
+          "users": {
+            "unknown": 1
+          },
+          "components": {
+            "unknown": 1
+          }
+        },
+        "window": {
+          "calls": 0,
+          "tenant_count": 0,
+          "user_count": 0,
+          "component_count": 0,
+          "tenants": {},
+          "users": {},
+          "components": {}
+        },
+        "last_seen_at": "2026-06-06T17:28:13.047529Z",
+        "retirement_candidate": true,
+        "retirement_reason": "no measured usage in review window"
+      },
+      {
+        "interface": {
+          "id": "a4e0948c-cd4a-461e-8ae2-7fd7b51d04a7",
+          "interface_key": "rest_api:GET /decisions/?workstream_id",
+          "interface_kind": "rest_api",
+          "legacy_since": "2026-07-09T23:07:53.093223Z",
+          "replacement_ref": "/decisions/?workplan_id=<workplan_id>",
+          "owner_component": "state-hub.api",
+          "status": "legacy",
+          "replacement_verified": true,
+          "manual_hold": false,
+          "hold_reason": null,
+          "notes": null,
+          "retired_at": null,
+          "created_at": "2026-07-09T23:07:53.093223Z",
+          "updated_at": "2026-07-09T23:07:53.093223Z"
+        },
+        "all_time": {
+          "calls": 1,
+          "tenant_count": 1,
+          "user_count": 1,
+          "component_count": 1,
+          "tenants": {
+            "unknown": 1
+          },
+          "users": {
+            "unknown": 1
+          },
+          "components": {
+            "unknown": 1
+          }
+        },
+        "window": {
+          "calls": 0,
+          "tenant_count": 0,
+          "user_count": 0,
+          "component_count": 0,
+          "tenants": {},
+          "users": {},
+          "components": {}
+        },
+        "last_seen_at": "2026-07-09T23:07:53.083299Z",
+        "retirement_candidate": true,
+        "retirement_reason": "no measured usage in review window"
+      },
+      {
+        "interface": {
+          "id": "70a9346e-e0ee-42ac-874f-f160580b54dd",
+          "interface_key": "rest_api:GET /progress/?workstream_id",
+          "interface_kind": "rest_api",
+          "legacy_since": "2026-07-13T22:04:03.911449Z",
+          "replacement_ref": "/progress/?workplan_id=<workplan_id>",
+          "owner_component": "state-hub.api",
+          "status": "legacy",
+          "replacement_verified": true,
+          "manual_hold": false,
+          "hold_reason": null,
+          "notes": null,
+          "retired_at": null,
+          "created_at": "2026-07-13T22:04:03.911449Z",
+          "updated_at": "2026-07-13T22:04:03.911449Z"
+        },
+        "all_time": {
+          "calls": 1,
+          "tenant_count": 1,
+          "user_count": 1,
+          "component_count": 1,
+          "tenants": {
+            "unknown": 1
+          },
+          "users": {
+            "unknown": 1
+          },
+          "components": {
+            "unknown": 1
+          }
+        },
+        "window": {
+          "calls": 0,
+          "tenant_count": 0,
+          "user_count": 0,
+          "component_count": 0,
+          "tenants": {},
+          "users": {},
+          "components": {}
+        },
+        "last_seen_at": "2026-07-13T22:04:03.904998Z",
+        "retirement_candidate": true,
+        "retirement_reason": "no measured usage in review window"
+      },
+      {
+        "interface": {
+          "id": "be3cdcf8-250b-4bf0-801f-02ffd5f57e00",
+          "interface_key": "rest_api:GET /tasks/?workstream_id",
+          "interface_kind": "rest_api",
+          "legacy_since": "2026-07-08T19:32:21.628513Z",
+          "replacement_ref": "/tasks/?workplan_id=<workplan_id>",
+          "owner_component": "state-hub.api",
+          "status": "legacy",
+          "replacement_verified": true,
+          "manual_hold": false,
+          "hold_reason": null,
+          "notes": null,
+          "retired_at": null,
+          "created_at": "2026-07-08T19:32:21.628513Z",
+          "updated_at": "2026-07-08T19:32:21.628513Z"
+        },
+        "all_time": {
+          "calls": 584,
+          "tenant_count": 1,
+          "user_count": 1,
+          "component_count": 1,
+          "tenants": {
+            "unknown": 584
+          },
+          "users": {
+            "unknown": 584
+          },
+          "components": {
+            "unknown": 584
+          }
+        },
+        "window": {
+          "calls": 0,
+          "tenant_count": 0,
+          "user_count": 0,
+          "component_count": 0,
+          "tenants": {},
+          "users": {},
+          "components": {}
+        },
+        "last_seen_at": "2026-07-18T16:00:45.856882Z",
+        "retirement_candidate": true,
+        "retirement_reason": "no measured usage in review window"
+      },
+      {
+        "interface": {
+          "id": "3e4a3d0b-08fa-45c3-91e2-4f514a914b97",
+          "interface_key": "rest_api:GET /workstreams/",
+          "interface_kind": "rest_api",
+          "legacy_since": "2026-06-04T00:26:14.533764Z",
+          "replacement_ref": "/workplans/",
+          "owner_component": "state-hub.api",
+          "status": "legacy",
+          "replacement_verified": true,
+          "manual_hold": false,
+          "hold_reason": null,
+          "notes": null,
+          "retired_at": null,
+          "created_at": "2026-06-04T00:26:14.533764Z",
+          "updated_at": "2026-06-04T00:26:14.533764Z"
+        },
+        "all_time": {
+          "calls": 144084,
+          "tenant_count": 1,
+          "user_count": 1,
+          "component_count": 1,
+          "tenants": {
+            "unknown": 144084
+          },
+          "users": {
+            "unknown": 144084
+          },
+          "components": {
+            "unknown": 144084
+          }
+        },
+        "window": {
+          "calls": 0,
+          "tenant_count": 0,
+          "user_count": 0,
+          "component_count": 0,
+          "tenants": {},
+          "users": {},
+          "components": {}
+        },
+        "last_seen_at": "2026-07-08T21:14:39.652776Z",
+        "retirement_candidate": true,
+        "retirement_reason": "no measured usage in review window"
+      },
+      {
+        "interface": {
+          "id": "e4c140ec-7479-46f9-b185-4b533f19d639",
+          "interface_key": "rest_api:GET /workstreams/workplan-index",
+          "interface_kind": "rest_api",
+          "legacy_since": "2026-06-04T05:20:58.321869Z",
+          "replacement_ref": "/workplans/index",
+          "owner_component": "state-hub.api",
+          "status": "legacy",
+          "replacement_verified": true,
+          "manual_hold": false,
+          "hold_reason": null,
+          "notes": null,
+          "retired_at": null,
+          "created_at": "2026-06-04T05:20:58.321869Z",
+          "updated_at": "2026-06-04T05:20:58.321869Z"
+        },
+        "all_time": {
+          "calls": 30,
+          "tenant_count": 1,
+          "user_count": 1,
+          "component_count": 1,
+          "tenants": {
+            "unknown": 30
+          },
+          "users": {
+            "unknown": 30
+          },
+          "components": {
+            "unknown": 30
+          }
+        },
+        "window": {
+          "calls": 0,
+          "tenant_count": 0,
+          "user_count": 0,
+          "component_count": 0,
+          "tenants": {},
+          "users": {},
+          "components": {}
+        },
+        "last_seen_at": "2026-07-03T05:20:34.534439Z",
+        "retirement_candidate": true,
+        "retirement_reason": "no measured usage in review window"
+      },
+      {
+        "interface": {
+          "id": "3a00b19e-e7db-4403-98aa-a77c9ab61ecc",
+          "interface_key": "rest_api:GET /workstreams/{workstream_id}",
+          "interface_kind": "rest_api",
+          "legacy_since": "2026-06-04T00:25:59.014966Z",
+          "replacement_ref": "/workplans/{workplan_id}",
+          "owner_component": "state-hub.api",
+          "status": "legacy",
+          "replacement_verified": true,
+          "manual_hold": false,
+          "hold_reason": null,
+          "notes": null,
+          "retired_at": null,
+          "created_at": "2026-06-04T00:25:59.014966Z",
+          "updated_at": "2026-06-04T00:25:59.014966Z"
+        },
+        "all_time": {
+          "calls": 511405,
+          "tenant_count": 1,
+          "user_count": 1,
+          "component_count": 1,
+          "tenants": {
+            "unknown": 511405
+          },
+          "users": {
+            "unknown": 511405
+          },
+          "components": {
+            "unknown": 511405
+          }
+        },
+        "window": {
+          "calls": 0,
+          "tenant_count": 0,
+          "user_count": 0,
+          "component_count": 0,
+          "tenants": {},
+          "users": {},
+          "components": {}
+        },
+        "last_seen_at": "2026-07-08T21:14:20.781103Z",
+        "retirement_candidate": true,
+        "retirement_reason": "no measured usage in review window"
+      },
+      {
+        "interface": {
+          "id": "69e1a255-a8b9-4101-8a68-b1bed23abfda",
+          "interface_key": "rest_api:GET /workstreams/{workstream_id}/dependencies/",
+          "interface_kind": "rest_api",
+          "legacy_since": "2026-06-04T00:25:59.291135Z",
+          "replacement_ref": "/workplans/{workplan_id}/dependencies/",
+          "owner_component": "state-hub.api",
+          "status": "legacy",
+          "replacement_verified": true,
+          "manual_hold": false,
+          "hold_reason": null,
+          "notes": null,
+          "retired_at": null,
+          "created_at": "2026-06-04T00:25:59.291135Z",
+          "updated_at": "2026-06-04T00:25:59.291135Z"
+        },
+        "all_time": {
+          "calls": 255865,
+          "tenant_count": 1,
+          "user_count": 1,
+          "component_count": 1,
+          "tenants": {
+            "unknown": 255865
+          },
+          "users": {
+            "unknown": 255865
+          },
+          "components": {
+            "unknown": 255865
+          }
+        },
+        "window": {
+          "calls": 0,
+          "tenant_count": 0,
+          "user_count": 0,
+          "component_count": 0,
+          "tenants": {},
+          "users": {},
+          "components": {}
+        },
+        "last_seen_at": "2026-07-08T21:14:12.747005Z",
+        "retirement_candidate": true,
+        "retirement_reason": "no measured usage in review window"
+      },
+      {
+        "interface": {
+          "id": "b1aae931-b51f-4a85-a723-865dd65f6132",
+          "interface_key": "rest_api:PATCH /workstreams/{workstream_id}",
+          "interface_kind": "rest_api",
+          "legacy_since": "2026-06-04T06:09:41.901035Z",
+          "replacement_ref": "/workplans/{workplan_id}",
+          "owner_component": "state-hub.api",
+          "status": "legacy",
+          "replacement_verified": true,
+          "manual_hold": false,
+          "hold_reason": null,
+          "notes": null,
+          "retired_at": null,
+          "created_at": "2026-06-04T06:09:41.901035Z",
+          "updated_at": "2026-06-04T06:09:41.901035Z"
+        },
+        "all_time": {
+          "calls": 571,
+          "tenant_count": 1,
+          "user_count": 1,
+          "component_count": 1,
+          "tenants": {
+            "unknown": 571
+          },
+          "users": {
+            "unknown": 571
+          },
+          "components": {
+            "unknown": 571
+          }
+        },
+        "window": {
+          "calls": 0,
+          "tenant_count": 0,
+          "user_count": 0,
+          "component_count": 0,
+          "tenants": {},
+          "users": {},
+          "components": {}
+        },
+        "last_seen_at": "2026-07-08T20:49:12.335710Z",
+        "retirement_candidate": true,
+        "retirement_reason": "no measured usage in review window"
+      },
+      {
+        "interface": {
+          "id": "4aea9591-970b-4918-ac4a-4da95a0a1a8c",
+          "interface_key": "rest_api:POST /decisions/ workstream_id",
+          "interface_kind": "rest_api",
+          "legacy_since": "2026-07-09T22:56:35.473130Z",
+          "replacement_ref": "POST /decisions/ with workplan_id",
+          "owner_component": "state-hub.api",
+          "status": "legacy",
+          "replacement_verified": true,
+          "manual_hold": false,
+          "hold_reason": null,
+          "notes": null,
+          "retired_at": null,
+          "created_at": "2026-07-09T22:56:35.473130Z",
+          "updated_at": "2026-07-09T22:56:35.473130Z"
+        },
+        "all_time": {
+          "calls": 3,
+          "tenant_count": 1,
+          "user_count": 1,
+          "component_count": 1,
+          "tenants": {
+            "unknown": 3
+          },
+          "users": {
+            "unknown": 3
+          },
+          "components": {
+            "unknown": 3
+          }
+        },
+        "window": {
+          "calls": 0,
+          "tenant_count": 0,
+          "user_count": 0,
+          "component_count": 0,
+          "tenants": {},
+          "users": {},
+          "components": {}
+        },
+        "last_seen_at": "2026-07-09T22:57:05.912456Z",
+        "retirement_candidate": true,
+        "retirement_reason": "no measured usage in review window"
+      },
+      {
+        "interface": {
+          "id": "4a70583c-1e41-4ec1-99a9-728856a7d79c",
+          "interface_key": "rest_api:POST /progress/ workstream_id",
+          "interface_kind": "rest_api",
+          "legacy_since": "2026-07-08T23:35:09.148333Z",
+          "replacement_ref": "POST /progress/ with workplan_id",
+          "owner_component": "state-hub.api",
+          "status": "legacy",
+          "replacement_verified": true,
+          "manual_hold": false,
+          "hold_reason": null,
+          "notes": null,
+          "retired_at": null,
+          "created_at": "2026-07-08T23:35:09.148333Z",
+          "updated_at": "2026-07-08T23:35:09.148333Z"
+        },
+        "all_time": {
+          "calls": 14,
+          "tenant_count": 1,
+          "user_count": 1,
+          "component_count": 1,
+          "tenants": {
+            "unknown": 14
+          },
+          "users": {
+            "unknown": 14
+          },
+          "components": {
+            "unknown": 14
+          }
+        },
+        "window": {
+          "calls": 0,
+          "tenant_count": 0,
+          "user_count": 0,
+          "component_count": 0,
+          "tenants": {},
+          "users": {},
+          "components": {}
+        },
+        "last_seen_at": "2026-07-10T08:34:42.959724Z",
+        "retirement_candidate": true,
+        "retirement_reason": "no measured usage in review window"
+      },
+      {
+        "interface": {
+          "id": "6df4e443-7bf1-461a-923b-a6eb52fe7b07",
+          "interface_key": "rest_api:POST /tasks/ workstream_id",
+          "interface_kind": "rest_api",
+          "legacy_since": "2026-07-08T22:38:29.405720Z",
+          "replacement_ref": "POST /tasks/ with workplan_id",
+          "owner_component": "state-hub.api",
+          "status": "legacy",
+          "replacement_verified": true,
+          "manual_hold": false,
+          "hold_reason": null,
+          "notes": null,
+          "retired_at": null,
+          "created_at": "2026-07-08T22:38:29.405720Z",
+          "updated_at": "2026-07-08T22:38:29.405720Z"
+        },
+        "all_time": {
+          "calls": 5,
+          "tenant_count": 1,
+          "user_count": 1,
+          "component_count": 1,
+          "tenants": {
+            "unknown": 5
+          },
+          "users": {
+            "unknown": 5
+          },
+          "components": {
+            "state-hub.fix-consistency": 5
+          }
+        },
+        "window": {
+          "calls": 0,
+          "tenant_count": 0,
+          "user_count": 0,
+          "component_count": 0,
+          "tenants": {},
+          "users": {},
+          "components": {}
+        },
+        "last_seen_at": "2026-07-08T22:38:29.976918Z",
+        "retirement_candidate": true,
+        "retirement_reason": "no measured usage in review window"
+      },
+      {
+        "interface": {
+          "id": "ed6451c9-d2cc-4486-9afe-d3852782cabc",
+          "interface_key": "rest_api:POST /workstreams/",
+          "interface_kind": "rest_api",
+          "legacy_since": "2026-06-04T07:40:24.168535Z",
+          "replacement_ref": "/workplans/",
+          "owner_component": "state-hub.api",
+          "status": "legacy",
+          "replacement_verified": true,
+          "manual_hold": false,
+          "hold_reason": null,
+          "notes": null,
+          "retired_at": null,
+          "created_at": "2026-06-04T07:40:24.168535Z",
+          "updated_at": "2026-06-04T07:40:24.168535Z"
+        },
+        "all_time": {
+          "calls": 824,
+          "tenant_count": 1,
+          "user_count": 1,
+          "component_count": 1,
+          "tenants": {
+            "unknown": 824
+          },
+          "users": {
+            "unknown": 824
+          },
+          "components": {
+            "unknown": 824
+          }
+        },
+        "window": {
+          "calls": 0,
+          "tenant_count": 0,
+          "user_count": 0,
+          "component_count": 0,
+          "tenants": {},
+          "users": {},
+          "components": {}
+        },
+        "last_seen_at": "2026-07-08T20:38:05.903144Z",
+        "retirement_candidate": true,
+        "retirement_reason": "no measured usage in review window"
+      },
+      {
+        "interface": {
+          "id": "281fd706-b192-4194-8055-2d8733c115f9",
+          "interface_key": "rest_api:POST /workstreams/{workstream_id}/dependencies/",
+          "interface_kind": "rest_api",
+          "legacy_since": "2026-06-04T22:57:37.149207Z",
+          "replacement_ref": "/workplans/{workplan_id}/dependencies/",
+          "owner_component": "state-hub.api",
+          "status": "legacy",
+          "replacement_verified": true,
+          "manual_hold": false,
+          "hold_reason": null,
+          "notes": null,
+          "retired_at": null,
+          "created_at": "2026-06-04T22:57:37.149207Z",
+          "updated_at": "2026-06-04T22:57:37.149207Z"
+        },
+        "all_time": {
+          "calls": 4971,
+          "tenant_count": 1,
+          "user_count": 1,
+          "component_count": 1,
+          "tenants": {
+            "unknown": 4971
+          },
+          "users": {
+            "unknown": 4971
+          },
+          "components": {
+            "unknown": 4971
+          }
+        },
+        "window": {
+          "calls": 0,
+          "tenant_count": 0,
+          "user_count": 0,
+          "component_count": 0,
+          "tenants": {},
+          "users": {},
+          "components": {}
+        },
+        "last_seen_at": "2026-07-01T22:09:24.229011Z",
+        "retirement_candidate": true,
+        "retirement_reason": "no measured usage in review window"
+      }
+    ],
+    "retirement_candidates": [
+      {
+        "interface": {
+          "id": "63ed90e3-42b4-431a-94db-e1254a52f9e2",
+          "interface_key": "mcp:create_workstream",
+          "interface_kind": "mcp_tool",
+          "legacy_since": "2026-07-10T13:19:44.205900Z",
+          "replacement_ref": "create_workplan",
+          "owner_component": "state-hub.mcp",
+          "status": "legacy",
+          "replacement_verified": true,
+          "manual_hold": false,
+          "hold_reason": null,
+          "notes": "Registered by STATE-WP-0070 T03 \u2014 zero-window streak starts at registration",
+          "retired_at": null,
+          "created_at": "2026-07-10T13:19:44.205900Z",
+          "updated_at": "2026-07-10T13:19:44.205900Z"
+        },
+        "all_time": {
+          "calls": 2,
+          "tenant_count": 1,
+          "user_count": 1,
+          "component_count": 1,
+          "tenants": {
+            "unknown": 2
+          },
+          "users": {
+            "unknown": 2
+          },
+          "components": {
+            "state-hub.mcp": 2
+          }
+        },
+        "window": {
+          "calls": 0,
+          "tenant_count": 0,
+          "user_count": 0,
+          "component_count": 0,
+          "tenants": {},
+          "users": {},
+          "components": {}
+        },
+        "last_seen_at": "2026-07-10T13:20:43.378546Z",
+        "retirement_candidate": true,
+        "retirement_reason": "no measured usage in review window"
+      },
+      {
+        "interface": {
+          "id": "b6a5fe44-fb85-4ef7-a273-78d09da777af",
+          "interface_key": "mcp:list_workstreams",
+          "interface_kind": "mcp_tool",
+          "legacy_since": "2026-07-10T13:19:26.075491Z",
+          "replacement_ref": "list_workplans",
+          "owner_component": "state-hub.mcp",
+          "status": "legacy",
+          "replacement_verified": true,
+          "manual_hold": false,
+          "hold_reason": null,
+          "notes": null,
+          "retired_at": null,
+          "created_at": "2026-07-10T13:19:26.075491Z",
+          "updated_at": "2026-07-10T13:19:26.075491Z"
+        },
+        "all_time": {
+          "calls": 2,
+          "tenant_count": 1,
+          "user_count": 1,
+          "component_count": 1,
+          "tenants": {
+            "unknown": 2
+          },
+          "users": {
+            "unknown": 2
+          },
+          "components": {
+            "state-hub.mcp": 2
+          }
+        },
+        "window": {
+          "calls": 0,
+          "tenant_count": 0,
+          "user_count": 0,
+          "component_count": 0,
+          "tenants": {},
+          "users": {},
+          "components": {}
+        },
+        "last_seen_at": "2026-07-10T13:20:42.374940Z",
+        "retirement_candidate": true,
+        "retirement_reason": "no measured usage in review window"
+      },
+      {
+        "interface": {
+          "id": "53c3372b-307d-4d6a-8ea4-bc36cacdcaf2",
+          "interface_key": "mcp:update_workstream",
+          "interface_kind": "mcp_tool",
+          "legacy_since": "2026-07-10T13:19:44.255216Z",
+          "replacement_ref": "update_workplan",
+          "owner_component": "state-hub.mcp",
+          "status": "legacy",
+          "replacement_verified": true,
+          "manual_hold": false,
+          "hold_reason": null,
+          "notes": "Registered by STATE-WP-0070 T03 \u2014 zero-window streak starts at registration",
+          "retired_at": null,
+          "created_at": "2026-07-10T13:19:44.255216Z",
+          "updated_at": "2026-07-10T13:19:44.255216Z"
+        },
+        "all_time": {
+          "calls": 0,
+          "tenant_count": 0,
+          "user_count": 0,
+          "component_count": 0,
+          "tenants": {},
+          "users": {},
+          "components": {}
+        },
+        "window": {
+          "calls": 0,
+          "tenant_count": 0,
+          "user_count": 0,
+          "component_count": 0,
+          "tenants": {},
+          "users": {},
+          "components": {}
+        },
+        "last_seen_at": null,
+        "retirement_candidate": true,
+        "retirement_reason": "no measured usage in review window"
+      },
+      {
+        "interface": {
+          "id": "bed4d08a-3471-48f5-9f0e-f9d550383a26",
+          "interface_key": "mcp:update_workstream_status",
+          "interface_kind": "mcp_tool",
+          "legacy_since": "2026-07-10T13:19:44.303612Z",
+          "replacement_ref": "update_workplan_status",
+          "owner_component": "state-hub.mcp",
+          "status": "legacy",
+          "replacement_verified": true,
+          "manual_hold": false,
+          "hold_reason": null,
+          "notes": "Registered by STATE-WP-0070 T03 \u2014 zero-window streak starts at registration",
+          "retired_at": null,
+          "created_at": "2026-07-10T13:19:44.303612Z",
+          "updated_at": "2026-07-10T13:19:44.303612Z"
+        },
+        "all_time": {
+          "calls": 0,
+          "tenant_count": 0,
+          "user_count": 0,
+          "component_count": 0,
+          "tenants": {},
+          "users": {},
+          "components": {}
+        },
+        "window": {
+          "calls": 0,
+          "tenant_count": 0,
+          "user_count": 0,
+          "component_count": 0,
+          "tenants": {},
+          "users": {},
+          "components": {}
+        },
+        "last_seen_at": null,
+        "retirement_candidate": true,
+        "retirement_reason": "no measured usage in review window"
+      },
+      {
+        "interface": {
+          "id": "46900dc2-0893-405b-ba59-80f31fb6ebb1",
+          "interface_key": "state://workstreams/{topic_slug}",
+          "interface_kind": "mcp_tool",
+          "legacy_since": "2026-07-10T13:19:44.344493Z",
+          "replacement_ref": "state://workplans/{topic_slug}",
+          "owner_component": "state-hub.mcp",
+          "status": "legacy",
+          "replacement_verified": true,
+          "manual_hold": false,
+          "hold_reason": null,
+          "notes": "Registered by STATE-WP-0070 T03 \u2014 zero-window streak starts at registration",
+          "retired_at": null,
+          "created_at": "2026-07-10T13:19:44.344493Z",
+          "updated_at": "2026-07-10T13:19:44.344493Z"
+        },
+        "all_time": {
+          "calls": 1,
+          "tenant_count": 1,
+          "user_count": 1,
+          "component_count": 1,
+          "tenants": {
+            "unknown": 1
+          },
+          "users": {
+            "unknown": 1
+          },
+          "components": {
+            "state-hub.mcp": 1
+          }
+        },
+        "window": {
+          "calls": 0,
+          "tenant_count": 0,
+          "user_count": 0,
+          "component_count": 0,
+          "tenants": {},
+          "users": {},
+          "components": {}
+        },
+        "last_seen_at": "2026-07-10T13:20:34.491811Z",
+        "retirement_candidate": true,
+        "retirement_reason": "no measured usage in review window"
+      },
+      {
+        "interface": {
+          "id": "cd9342fd-27e7-4a46-a1be-d41499e106a3",
+          "interface_key": "rest_api:DELETE /workstreams/{workstream_id}",
+          "interface_kind": "rest_api",
+          "legacy_since": "2026-06-06T17:28:13.052813Z",
+          "replacement_ref": "/workplans/{workplan_id}",
+          "owner_component": "state-hub.api",
+          "status": "legacy",
+          "replacement_verified": true,
+          "manual_hold": false,
+          "hold_reason": null,
+          "notes": null,
+          "retired_at": null,
+          "created_at": "2026-06-06T17:28:13.052813Z",
+          "updated_at": "2026-06-06T17:28:13.052813Z"
+        },
+        "all_time": {
+          "calls": 1,
+          "tenant_count": 1,
+          "user_count": 1,
+          "component_count": 1,
+          "tenants": {
+            "unknown": 1
+          },
+          "users": {
+            "unknown": 1
+          },
+          "components": {
+            "unknown": 1
+          }
+        },
+        "window": {
+          "calls": 0,
+          "tenant_count": 0,
+          "user_count": 0,
+          "component_count": 0,
+          "tenants": {},
+          "users": {},
+          "components": {}
+        },
+        "last_seen_at": "2026-06-06T17:28:13.047529Z",
+        "retirement_candidate": true,
+        "retirement_reason": "no measured usage in review window"
+      },
+      {
+        "interface": {
+          "id": "a4e0948c-cd4a-461e-8ae2-7fd7b51d04a7",
+          "interface_key": "rest_api:GET /decisions/?workstream_id",
+          "interface_kind": "rest_api",
+          "legacy_since": "2026-07-09T23:07:53.093223Z",
+          "replacement_ref": "/decisions/?workplan_id=<workplan_id>",
+          "owner_component": "state-hub.api",
+          "status": "legacy",
+          "replacement_verified": true,
+          "manual_hold": false,
+          "hold_reason": null,
+          "notes": null,
+          "retired_at": null,
+          "created_at": "2026-07-09T23:07:53.093223Z",
+          "updated_at": "2026-07-09T23:07:53.093223Z"
+        },
+        "all_time": {
+          "calls": 1,
+          "tenant_count": 1,
+          "user_count": 1,
+          "component_count": 1,
+          "tenants": {
+            "unknown": 1
+          },
+          "users": {
+            "unknown": 1
+          },
+          "components": {
+            "unknown": 1
+          }
+        },
+        "window": {
+          "calls": 0,
+          "tenant_count": 0,
+          "user_count": 0,
+          "component_count": 0,
+          "tenants": {},
+          "users": {},
+          "components": {}
+        },
+        "last_seen_at": "2026-07-09T23:07:53.083299Z",
+        "retirement_candidate": true,
+        "retirement_reason": "no measured usage in review window"
+      },
+      {
+        "interface": {
+          "id": "70a9346e-e0ee-42ac-874f-f160580b54dd",
+          "interface_key": "rest_api:GET /progress/?workstream_id",
+          "interface_kind": "rest_api",
+          "legacy_since": "2026-07-13T22:04:03.911449Z",
+          "replacement_ref": "/progress/?workplan_id=<workplan_id>",
+          "owner_component": "state-hub.api",
+          "status": "legacy",
+          "replacement_verified": true,
+          "manual_hold": false,
+          "hold_reason": null,
+          "notes": null,
+          "retired_at": null,
+          "created_at": "2026-07-13T22:04:03.911449Z",
+          "updated_at": "2026-07-13T22:04:03.911449Z"
+        },
+        "all_time": {
+          "calls": 1,
+          "tenant_count": 1,
+          "user_count": 1,
+          "component_count": 1,
+          "tenants": {
+            "unknown": 1
+          },
+          "users": {
+            "unknown": 1
+          },
+          "components": {
+            "unknown": 1
+          }
+        },
+        "window": {
+          "calls": 0,
+          "tenant_count": 0,
+          "user_count": 0,
+          "component_count": 0,
+          "tenants": {},
+          "users": {},
+          "components": {}
+        },
+        "last_seen_at": "2026-07-13T22:04:03.904998Z",
+        "retirement_candidate": true,
+        "retirement_reason": "no measured usage in review window"
+      },
+      {
+        "interface": {
+          "id": "be3cdcf8-250b-4bf0-801f-02ffd5f57e00",
+          "interface_key": "rest_api:GET /tasks/?workstream_id",
+          "interface_kind": "rest_api",
+          "legacy_since": "2026-07-08T19:32:21.628513Z",
+          "replacement_ref": "/tasks/?workplan_id=<workplan_id>",
+          "owner_component": "state-hub.api",
+          "status": "legacy",
+          "replacement_verified": true,
+          "manual_hold": false,
+          "hold_reason": null,
+          "notes": null,
+          "retired_at": null,
+          "created_at": "2026-07-08T19:32:21.628513Z",
+          "updated_at": "2026-07-08T19:32:21.628513Z"
+        },
+        "all_time": {
+          "calls": 584,
+          "tenant_count": 1,
+          "user_count": 1,
+          "component_count": 1,
+          "tenants": {
+            "unknown": 584
+          },
+          "users": {
+            "unknown": 584
+          },
+          "components": {
+            "unknown": 584
+          }
+        },
+        "window": {
+          "calls": 0,
+          "tenant_count": 0,
+          "user_count": 0,
+          "component_count": 0,
+          "tenants": {},
+          "users": {},
+          "components": {}
+        },
+        "last_seen_at": "2026-07-18T16:00:45.856882Z",
+        "retirement_candidate": true,
+        "retirement_reason": "no measured usage in review window"
+      },
+      {
+        "interface": {
+          "id": "3e4a3d0b-08fa-45c3-91e2-4f514a914b97",
+          "interface_key": "rest_api:GET /workstreams/",
+          "interface_kind": "rest_api",
+          "legacy_since": "2026-06-04T00:26:14.533764Z",
+          "replacement_ref": "/workplans/",
+          "owner_component": "state-hub.api",
+          "status": "legacy",
+          "replacement_verified": true,
+          "manual_hold": false,
+          "hold_reason": null,
+          "notes": null,
+          "retired_at": null,
+          "created_at": "2026-06-04T00:26:14.533764Z",
+          "updated_at": "2026-06-04T00:26:14.533764Z"
+        },
+        "all_time": {
+          "calls": 144084,
+          "tenant_count": 1,
+          "user_count": 1,
+          "component_count": 1,
+          "tenants": {
+            "unknown": 144084
+          },
+          "users": {
+            "unknown": 144084
+          },
+          "components": {
+            "unknown": 144084
+          }
+        },
+        "window": {
+          "calls": 0,
+          "tenant_count": 0,
+          "user_count": 0,
+          "component_count": 0,
+          "tenants": {},
+          "users": {},
+          "components": {}
+        },
+        "last_seen_at": "2026-07-08T21:14:39.652776Z",
+        "retirement_candidate": true,
+        "retirement_reason": "no measured usage in review window"
+      },
+      {
+        "interface": {
+          "id": "e4c140ec-7479-46f9-b185-4b533f19d639",
+          "interface_key": "rest_api:GET /workstreams/workplan-index",
+          "interface_kind": "rest_api",
+          "legacy_since": "2026-06-04T05:20:58.321869Z",
+          "replacement_ref": "/workplans/index",
+          "owner_component": "state-hub.api",
+          "status": "legacy",
+          "replacement_verified": true,
+          "manual_hold": false,
+          "hold_reason": null,
+          "notes": null,
+          "retired_at": null,
+          "created_at": "2026-06-04T05:20:58.321869Z",
+          "updated_at": "2026-06-04T05:20:58.321869Z"
+        },
+        "all_time": {
+          "calls": 30,
+          "tenant_count": 1,
+          "user_count": 1,
+          "component_count": 1,
+          "tenants": {
+            "unknown": 30
+          },
+          "users": {
+            "unknown": 30
+          },
+          "components": {
+            "unknown": 30
+          }
+        },
+        "window": {
+          "calls": 0,
+          "tenant_count": 0,
+          "user_count": 0,
+          "component_count": 0,
+          "tenants": {},
+          "users": {},
+          "components": {}
+        },
+        "last_seen_at": "2026-07-03T05:20:34.534439Z",
+        "retirement_candidate": true,
+        "retirement_reason": "no measured usage in review window"
+      },
+      {
+        "interface": {
+          "id": "3a00b19e-e7db-4403-98aa-a77c9ab61ecc",
+          "interface_key": "rest_api:GET /workstreams/{workstream_id}",
+          "interface_kind": "rest_api",
+          "legacy_since": "2026-06-04T00:25:59.014966Z",
+          "replacement_ref": "/workplans/{workplan_id}",
+          "owner_component": "state-hub.api",
+          "status": "legacy",
+          "replacement_verified": true,
+          "manual_hold": false,
+          "hold_reason": null,
+          "notes": null,
+          "retired_at": null,
+          "created_at": "2026-06-04T00:25:59.014966Z",
+          "updated_at": "2026-06-04T00:25:59.014966Z"
+        },
+        "all_time": {
+          "calls": 511405,
+          "tenant_count": 1,
+          "user_count": 1,
+          "component_count": 1,
+          "tenants": {
+            "unknown": 511405
+          },
+          "users": {
+            "unknown": 511405
+          },
+          "components": {
+            "unknown": 511405
+          }
+        },
+        "window": {
+          "calls": 0,
+          "tenant_count": 0,
+          "user_count": 0,
+          "component_count": 0,
+          "tenants": {},
+          "users": {},
+          "components": {}
+        },
+        "last_seen_at": "2026-07-08T21:14:20.781103Z",
+        "retirement_candidate": true,
+        "retirement_reason": "no measured usage in review window"
+      },
+      {
+        "interface": {
+          "id": "69e1a255-a8b9-4101-8a68-b1bed23abfda",
+          "interface_key": "rest_api:GET /workstreams/{workstream_id}/dependencies/",
+          "interface_kind": "rest_api",
+          "legacy_since": "2026-06-04T00:25:59.291135Z",
+          "replacement_ref": "/workplans/{workplan_id}/dependencies/",
+          "owner_component": "state-hub.api",
+          "status": "legacy",
+          "replacement_verified": true,
+          "manual_hold": false,
+          "hold_reason": null,
+          "notes": null,
+          "retired_at": null,
+          "created_at": "2026-06-04T00:25:59.291135Z",
+          "updated_at": "2026-06-04T00:25:59.291135Z"
+        },
+        "all_time": {
+          "calls": 255865,
+          "tenant_count": 1,
+          "user_count": 1,
+          "component_count": 1,
+          "tenants": {
+            "unknown": 255865
+          },
+          "users": {
+            "unknown": 255865
+          },
+          "components": {
+            "unknown": 255865
+          }
+        },
+        "window": {
+          "calls": 0,
+          "tenant_count": 0,
+          "user_count": 0,
+          "component_count": 0,
+          "tenants": {},
+          "users": {},
+          "components": {}
+        },
+        "last_seen_at": "2026-07-08T21:14:12.747005Z",
+        "retirement_candidate": true,
+        "retirement_reason": "no measured usage in review window"
+      },
+      {
+        "interface": {
+          "id": "b1aae931-b51f-4a85-a723-865dd65f6132",
+          "interface_key": "rest_api:PATCH /workstreams/{workstream_id}",
+          "interface_kind": "rest_api",
+          "legacy_since": "2026-06-04T06:09:41.901035Z",
+          "replacement_ref": "/workplans/{workplan_id}",
+          "owner_component": "state-hub.api",
+          "status": "legacy",
+          "replacement_verified": true,
+          "manual_hold": false,
+          "hold_reason": null,
+          "notes": null,
+          "retired_at": null,
+          "created_at": "2026-06-04T06:09:41.901035Z",
+          "updated_at": "2026-06-04T06:09:41.901035Z"
+        },
+        "all_time": {
+          "calls": 571,
+          "tenant_count": 1,
+          "user_count": 1,
+          "component_count": 1,
+          "tenants": {
+            "unknown": 571
+          },
+          "users": {
+            "unknown": 571
+          },
+          "components": {
+            "unknown": 571
+          }
+        },
+        "window": {
+          "calls": 0,
+          "tenant_count": 0,
+          "user_count": 0,
+          "component_count": 0,
+          "tenants": {},
+          "users": {},
+          "components": {}
+        },
+        "last_seen_at": "2026-07-08T20:49:12.335710Z",
+        "retirement_candidate": true,
+        "retirement_reason": "no measured usage in review window"
+      },
+      {
+        "interface": {
+          "id": "4aea9591-970b-4918-ac4a-4da95a0a1a8c",
+          "interface_key": "rest_api:POST /decisions/ workstream_id",
+          "interface_kind": "rest_api",
+          "legacy_since": "2026-07-09T22:56:35.473130Z",
+          "replacement_ref": "POST /decisions/ with workplan_id",
+          "owner_component": "state-hub.api",
+          "status": "legacy",
+          "replacement_verified": true,
+          "manual_hold": false,
+          "hold_reason": null,
+          "notes": null,
+          "retired_at": null,
+          "created_at": "2026-07-09T22:56:35.473130Z",
+          "updated_at": "2026-07-09T22:56:35.473130Z"
+        },
+        "all_time": {
+          "calls": 3,
+          "tenant_count": 1,
+          "user_count": 1,
+          "component_count": 1,
+          "tenants": {
+            "unknown": 3
+          },
+          "users": {
+            "unknown": 3
+          },
+          "components": {
+            "unknown": 3
+          }
+        },
+        "window": {
+          "calls": 0,
+          "tenant_count": 0,
+          "user_count": 0,
+          "component_count": 0,
+          "tenants": {},
+          "users": {},
+          "components": {}
+        },
+        "last_seen_at": "2026-07-09T22:57:05.912456Z",
+        "retirement_candidate": true,
+        "retirement_reason": "no measured usage in review window"
+      },
+      {
+        "interface": {
+          "id": "4a70583c-1e41-4ec1-99a9-728856a7d79c",
+          "interface_key": "rest_api:POST /progress/ workstream_id",
+          "interface_kind": "rest_api",
+          "legacy_since": "2026-07-08T23:35:09.148333Z",
+          "replacement_ref": "POST /progress/ with workplan_id",
+          "owner_component": "state-hub.api",
+          "status": "legacy",
+          "replacement_verified": true,
+          "manual_hold": false,
+          "hold_reason": null,
+          "notes": null,
+          "retired_at": null,
+          "created_at": "2026-07-08T23:35:09.148333Z",
+          "updated_at": "2026-07-08T23:35:09.148333Z"
+        },
+        "all_time": {
+          "calls": 14,
+          "tenant_count": 1,
+          "user_count": 1,
+          "component_count": 1,
+          "tenants": {
+            "unknown": 14
+          },
+          "users": {
+            "unknown": 14
+          },
+          "components": {
+            "unknown": 14
+          }
+        },
+        "window": {
+          "calls": 0,
+          "tenant_count": 0,
+          "user_count": 0,
+          "component_count": 0,
+          "tenants": {},
+          "users": {},
+          "components": {}
+        },
+        "last_seen_at": "2026-07-10T08:34:42.959724Z",
+        "retirement_candidate": true,
+        "retirement_reason": "no measured usage in review window"
+      },
+      {
+        "interface": {
+          "id": "6df4e443-7bf1-461a-923b-a6eb52fe7b07",
+          "interface_key": "rest_api:POST /tasks/ workstream_id",
+          "interface_kind": "rest_api",
+          "legacy_since": "2026-07-08T22:38:29.405720Z",
+          "replacement_ref": "POST /tasks/ with workplan_id",
+          "owner_component": "state-hub.api",
+          "status": "legacy",
+          "replacement_verified": true,
+          "manual_hold": false,
+          "hold_reason": null,
+          "notes": null,
+          "retired_at": null,
+          "created_at": "2026-07-08T22:38:29.405720Z",
+          "updated_at": "2026-07-08T22:38:29.405720Z"
+        },
+        "all_time": {
+          "calls": 5,
+          "tenant_count": 1,
+          "user_count": 1,
+          "component_count": 1,
+          "tenants": {
+            "unknown": 5
+          },
+          "users": {
+            "unknown": 5
+          },
+          "components": {
+            "state-hub.fix-consistency": 5
+          }
+        },
+        "window": {
+          "calls": 0,
+          "tenant_count": 0,
+          "user_count": 0,
+          "component_count": 0,
+          "tenants": {},
+          "users": {},
+          "components": {}
+        },
+        "last_seen_at": "2026-07-08T22:38:29.976918Z",
+        "retirement_candidate": true,
+        "retirement_reason": "no measured usage in review window"
+      },
+      {
+        "interface": {
+          "id": "ed6451c9-d2cc-4486-9afe-d3852782cabc",
+          "interface_key": "rest_api:POST /workstreams/",
+          "interface_kind": "rest_api",
+          "legacy_since": "2026-06-04T07:40:24.168535Z",
+          "replacement_ref": "/workplans/",
+          "owner_component": "state-hub.api",
+          "status": "legacy",
+          "replacement_verified": true,
+          "manual_hold": false,
+          "hold_reason": null,
+          "notes": null,
+          "retired_at": null,
+          "created_at": "2026-06-04T07:40:24.168535Z",
+          "updated_at": "2026-06-04T07:40:24.168535Z"
+        },
+        "all_time": {
+          "calls": 824,
+          "tenant_count": 1,
+          "user_count": 1,
+          "component_count": 1,
+          "tenants": {
+            "unknown": 824
+          },
+          "users": {
+            "unknown": 824
+          },
+          "components": {
+            "unknown": 824
+          }
+        },
+        "window": {
+          "calls": 0,
+          "tenant_count": 0,
+          "user_count": 0,
+          "component_count": 0,
+          "tenants": {},
+          "users": {},
+          "components": {}
+        },
+        "last_seen_at": "2026-07-08T20:38:05.903144Z",
+        "retirement_candidate": true,
+        "retirement_reason": "no measured usage in review window"
+      },
+      {
+        "interface": {
+          "id": "281fd706-b192-4194-8055-2d8733c115f9",
+          "interface_key": "rest_api:POST /workstreams/{workstream_id}/dependencies/",
+          "interface_kind": "rest_api",
+          "legacy_since": "2026-06-04T22:57:37.149207Z",
+          "replacement_ref": "/workplans/{workplan_id}/dependencies/",
+          "owner_component": "state-hub.api",
+          "status": "legacy",
+          "replacement_verified": true,
+          "manual_hold": false,
+          "hold_reason": null,
+          "notes": null,
+          "retired_at": null,
+          "created_at": "2026-06-04T22:57:37.149207Z",
+          "updated_at": "2026-06-04T22:57:37.149207Z"
+        },
+        "all_time": {
+          "calls": 4971,
+          "tenant_count": 1,
+          "user_count": 1,
+          "component_count": 1,
+          "tenants": {
+            "unknown": 4971
+          },
+          "users": {
+            "unknown": 4971
+          },
+          "components": {
+            "unknown": 4971
+          }
+        },
+        "window": {
+          "calls": 0,
+          "tenant_count": 0,
+          "user_count": 0,
+          "component_count": 0,
+          "tenants": {},
+          "users": {},
+          "components": {}
+        },
+        "last_seen_at": "2026-07-01T22:09:24.229011Z",
+        "retirement_candidate": true,
+        "retirement_reason": "no measured usage in review window"
+      }
+    ]
+  },
+  "hours": 8
+}
diff --git a/docs/evidence/legacy-meter-weekly-review-20260721.json b/docs/evidence/legacy-meter-weekly-review-20260721.json
new file mode 100644
index 0000000..0ccc74c
--- /dev/null
+++ b/docs/evidence/legacy-meter-weekly-review-20260721.json
@@ -0,0 +1,1755 @@
+{
+  "captured_at": "2026-07-20T22:00:04.665800+00:00",
+  "api_base": "http://127.0.0.1:8000",
+  "workplan": "STATE-WP-0070",
+  "retired_interfaces": [],
+  "weekly_review": {
+    "generated_at": "2026-07-20T22:00:04.659438Z",
+    "window_start": "2026-07-20T14:00:04.586631Z",
+    "window_end": "2026-07-20T22:00:04.586631Z",
+    "cadence": "weekly",
+    "activity_core_handoff": {
+      "activity_id": "statehub-legacy-interface-review",
+      "cadence": "weekly",
+      "source_endpoint": "/legacy-meter/weekly-review",
+      "state_owner": "state-hub",
+      "scheduler_owner": "activity-core"
+    },
+    "interfaces": [
+      {
+        "interface": {
+          "id": "8051fb40-66c9-4dc4-a413-13e8573e04a3",
+          "interface_key": "event_subject:org.statehub.workstream.completed",
+          "interface_kind": "event_subject",
+          "legacy_since": "2026-06-04T06:09:42.198193Z",
+          "replacement_ref": "org.statehub.workplan.completed",
+          "owner_component": "state-hub.events",
+          "status": "retired",
+          "replacement_verified": true,
+          "manual_hold": false,
+          "hold_reason": null,
+          "notes": "Retired by STATE-WP-0069 closeout",
+          "retired_at": "2026-07-08T21:38:52.773601Z",
+          "created_at": "2026-06-04T06:09:42.198193Z",
+          "updated_at": "2026-07-08T21:38:52.761243Z"
+        },
+        "all_time": {
+          "calls": 255,
+          "tenant_count": 1,
+          "user_count": 1,
+          "component_count": 1,
+          "tenants": {
+            "unknown": 255
+          },
+          "users": {
+            "unknown": 255
+          },
+          "components": {
+            "state-hub.events": 255
+          }
+        },
+        "window": {
+          "calls": 0,
+          "tenant_count": 0,
+          "user_count": 0,
+          "component_count": 0,
+          "tenants": {},
+          "users": {},
+          "components": {}
+        },
+        "last_seen_at": "2026-07-08T20:49:12.839383Z",
+        "retirement_candidate": false,
+        "retirement_reason": "already retired"
+      },
+      {
+        "interface": {
+          "id": "63ed90e3-42b4-431a-94db-e1254a52f9e2",
+          "interface_key": "mcp:create_workstream",
+          "interface_kind": "mcp_tool",
+          "legacy_since": "2026-07-10T13:19:44.205900Z",
+          "replacement_ref": "create_workplan",
+          "owner_component": "state-hub.mcp",
+          "status": "legacy",
+          "replacement_verified": true,
+          "manual_hold": false,
+          "hold_reason": null,
+          "notes": "Registered by STATE-WP-0070 T03 \u2014 zero-window streak starts at registration",
+          "retired_at": null,
+          "created_at": "2026-07-10T13:19:44.205900Z",
+          "updated_at": "2026-07-10T13:19:44.205900Z"
+        },
+        "all_time": {
+          "calls": 2,
+          "tenant_count": 1,
+          "user_count": 1,
+          "component_count": 1,
+          "tenants": {
+            "unknown": 2
+          },
+          "users": {
+            "unknown": 2
+          },
+          "components": {
+            "state-hub.mcp": 2
+          }
+        },
+        "window": {
+          "calls": 0,
+          "tenant_count": 0,
+          "user_count": 0,
+          "component_count": 0,
+          "tenants": {},
+          "users": {},
+          "components": {}
+        },
+        "last_seen_at": "2026-07-10T13:20:43.378546Z",
+        "retirement_candidate": true,
+        "retirement_reason": "no measured usage in review window"
+      },
+      {
+        "interface": {
+          "id": "b6a5fe44-fb85-4ef7-a273-78d09da777af",
+          "interface_key": "mcp:list_workstreams",
+          "interface_kind": "mcp_tool",
+          "legacy_since": "2026-07-10T13:19:26.075491Z",
+          "replacement_ref": "list_workplans",
+          "owner_component": "state-hub.mcp",
+          "status": "legacy",
+          "replacement_verified": true,
+          "manual_hold": false,
+          "hold_reason": null,
+          "notes": null,
+          "retired_at": null,
+          "created_at": "2026-07-10T13:19:26.075491Z",
+          "updated_at": "2026-07-10T13:19:26.075491Z"
+        },
+        "all_time": {
+          "calls": 2,
+          "tenant_count": 1,
+          "user_count": 1,
+          "component_count": 1,
+          "tenants": {
+            "unknown": 2
+          },
+          "users": {
+            "unknown": 2
+          },
+          "components": {
+            "state-hub.mcp": 2
+          }
+        },
+        "window": {
+          "calls": 0,
+          "tenant_count": 0,
+          "user_count": 0,
+          "component_count": 0,
+          "tenants": {},
+          "users": {},
+          "components": {}
+        },
+        "last_seen_at": "2026-07-10T13:20:42.374940Z",
+        "retirement_candidate": true,
+        "retirement_reason": "no measured usage in review window"
+      },
+      {
+        "interface": {
+          "id": "53c3372b-307d-4d6a-8ea4-bc36cacdcaf2",
+          "interface_key": "mcp:update_workstream",
+          "interface_kind": "mcp_tool",
+          "legacy_since": "2026-07-10T13:19:44.255216Z",
+          "replacement_ref": "update_workplan",
+          "owner_component": "state-hub.mcp",
+          "status": "legacy",
+          "replacement_verified": true,
+          "manual_hold": false,
+          "hold_reason": null,
+          "notes": "Registered by STATE-WP-0070 T03 \u2014 zero-window streak starts at registration",
+          "retired_at": null,
+          "created_at": "2026-07-10T13:19:44.255216Z",
+          "updated_at": "2026-07-10T13:19:44.255216Z"
+        },
+        "all_time": {
+          "calls": 0,
+          "tenant_count": 0,
+          "user_count": 0,
+          "component_count": 0,
+          "tenants": {},
+          "users": {},
+          "components": {}
+        },
+        "window": {
+          "calls": 0,
+          "tenant_count": 0,
+          "user_count": 0,
+          "component_count": 0,
+          "tenants": {},
+          "users": {},
+          "components": {}
+        },
+        "last_seen_at": null,
+        "retirement_candidate": true,
+        "retirement_reason": "no measured usage in review window"
+      },
+      {
+        "interface": {
+          "id": "bed4d08a-3471-48f5-9f0e-f9d550383a26",
+          "interface_key": "mcp:update_workstream_status",
+          "interface_kind": "mcp_tool",
+          "legacy_since": "2026-07-10T13:19:44.303612Z",
+          "replacement_ref": "update_workplan_status",
+          "owner_component": "state-hub.mcp",
+          "status": "legacy",
+          "replacement_verified": true,
+          "manual_hold": false,
+          "hold_reason": null,
+          "notes": "Registered by STATE-WP-0070 T03 \u2014 zero-window streak starts at registration",
+          "retired_at": null,
+          "created_at": "2026-07-10T13:19:44.303612Z",
+          "updated_at": "2026-07-10T13:19:44.303612Z"
+        },
+        "all_time": {
+          "calls": 0,
+          "tenant_count": 0,
+          "user_count": 0,
+          "component_count": 0,
+          "tenants": {},
+          "users": {},
+          "components": {}
+        },
+        "window": {
+          "calls": 0,
+          "tenant_count": 0,
+          "user_count": 0,
+          "component_count": 0,
+          "tenants": {},
+          "users": {},
+          "components": {}
+        },
+        "last_seen_at": null,
+        "retirement_candidate": true,
+        "retirement_reason": "no measured usage in review window"
+      },
+      {
+        "interface": {
+          "id": "46900dc2-0893-405b-ba59-80f31fb6ebb1",
+          "interface_key": "state://workstreams/{topic_slug}",
+          "interface_kind": "mcp_tool",
+          "legacy_since": "2026-07-10T13:19:44.344493Z",
+          "replacement_ref": "state://workplans/{topic_slug}",
+          "owner_component": "state-hub.mcp",
+          "status": "legacy",
+          "replacement_verified": true,
+          "manual_hold": false,
+          "hold_reason": null,
+          "notes": "Registered by STATE-WP-0070 T03 \u2014 zero-window streak starts at registration",
+          "retired_at": null,
+          "created_at": "2026-07-10T13:19:44.344493Z",
+          "updated_at": "2026-07-10T13:19:44.344493Z"
+        },
+        "all_time": {
+          "calls": 1,
+          "tenant_count": 1,
+          "user_count": 1,
+          "component_count": 1,
+          "tenants": {
+            "unknown": 1
+          },
+          "users": {
+            "unknown": 1
+          },
+          "components": {
+            "state-hub.mcp": 1
+          }
+        },
+        "window": {
+          "calls": 0,
+          "tenant_count": 0,
+          "user_count": 0,
+          "component_count": 0,
+          "tenants": {},
+          "users": {},
+          "components": {}
+        },
+        "last_seen_at": "2026-07-10T13:20:34.491811Z",
+        "retirement_candidate": true,
+        "retirement_reason": "no measured usage in review window"
+      },
+      {
+        "interface": {
+          "id": "cd9342fd-27e7-4a46-a1be-d41499e106a3",
+          "interface_key": "rest_api:DELETE /workstreams/{workstream_id}",
+          "interface_kind": "rest_api",
+          "legacy_since": "2026-06-06T17:28:13.052813Z",
+          "replacement_ref": "/workplans/{workplan_id}",
+          "owner_component": "state-hub.api",
+          "status": "legacy",
+          "replacement_verified": true,
+          "manual_hold": false,
+          "hold_reason": null,
+          "notes": null,
+          "retired_at": null,
+          "created_at": "2026-06-06T17:28:13.052813Z",
+          "updated_at": "2026-06-06T17:28:13.052813Z"
+        },
+        "all_time": {
+          "calls": 1,
+          "tenant_count": 1,
+          "user_count": 1,
+          "component_count": 1,
+          "tenants": {
+            "unknown": 1
+          },
+          "users": {
+            "unknown": 1
+          },
+          "components": {
+            "unknown": 1
+          }
+        },
+        "window": {
+          "calls": 0,
+          "tenant_count": 0,
+          "user_count": 0,
+          "component_count": 0,
+          "tenants": {},
+          "users": {},
+          "components": {}
+        },
+        "last_seen_at": "2026-06-06T17:28:13.047529Z",
+        "retirement_candidate": true,
+        "retirement_reason": "no measured usage in review window"
+      },
+      {
+        "interface": {
+          "id": "a4e0948c-cd4a-461e-8ae2-7fd7b51d04a7",
+          "interface_key": "rest_api:GET /decisions/?workstream_id",
+          "interface_kind": "rest_api",
+          "legacy_since": "2026-07-09T23:07:53.093223Z",
+          "replacement_ref": "/decisions/?workplan_id=<workplan_id>",
+          "owner_component": "state-hub.api",
+          "status": "legacy",
+          "replacement_verified": true,
+          "manual_hold": false,
+          "hold_reason": null,
+          "notes": null,
+          "retired_at": null,
+          "created_at": "2026-07-09T23:07:53.093223Z",
+          "updated_at": "2026-07-09T23:07:53.093223Z"
+        },
+        "all_time": {
+          "calls": 1,
+          "tenant_count": 1,
+          "user_count": 1,
+          "component_count": 1,
+          "tenants": {
+            "unknown": 1
+          },
+          "users": {
+            "unknown": 1
+          },
+          "components": {
+            "unknown": 1
+          }
+        },
+        "window": {
+          "calls": 0,
+          "tenant_count": 0,
+          "user_count": 0,
+          "component_count": 0,
+          "tenants": {},
+          "users": {},
+          "components": {}
+        },
+        "last_seen_at": "2026-07-09T23:07:53.083299Z",
+        "retirement_candidate": true,
+        "retirement_reason": "no measured usage in review window"
+      },
+      {
+        "interface": {
+          "id": "70a9346e-e0ee-42ac-874f-f160580b54dd",
+          "interface_key": "rest_api:GET /progress/?workstream_id",
+          "interface_kind": "rest_api",
+          "legacy_since": "2026-07-13T22:04:03.911449Z",
+          "replacement_ref": "/progress/?workplan_id=<workplan_id>",
+          "owner_component": "state-hub.api",
+          "status": "legacy",
+          "replacement_verified": true,
+          "manual_hold": false,
+          "hold_reason": null,
+          "notes": null,
+          "retired_at": null,
+          "created_at": "2026-07-13T22:04:03.911449Z",
+          "updated_at": "2026-07-13T22:04:03.911449Z"
+        },
+        "all_time": {
+          "calls": 1,
+          "tenant_count": 1,
+          "user_count": 1,
+          "component_count": 1,
+          "tenants": {
+            "unknown": 1
+          },
+          "users": {
+            "unknown": 1
+          },
+          "components": {
+            "unknown": 1
+          }
+        },
+        "window": {
+          "calls": 0,
+          "tenant_count": 0,
+          "user_count": 0,
+          "component_count": 0,
+          "tenants": {},
+          "users": {},
+          "components": {}
+        },
+        "last_seen_at": "2026-07-13T22:04:03.904998Z",
+        "retirement_candidate": true,
+        "retirement_reason": "no measured usage in review window"
+      },
+      {
+        "interface": {
+          "id": "be3cdcf8-250b-4bf0-801f-02ffd5f57e00",
+          "interface_key": "rest_api:GET /tasks/?workstream_id",
+          "interface_kind": "rest_api",
+          "legacy_since": "2026-07-08T19:32:21.628513Z",
+          "replacement_ref": "/tasks/?workplan_id=<workplan_id>",
+          "owner_component": "state-hub.api",
+          "status": "legacy",
+          "replacement_verified": true,
+          "manual_hold": false,
+          "hold_reason": null,
+          "notes": null,
+          "retired_at": null,
+          "created_at": "2026-07-08T19:32:21.628513Z",
+          "updated_at": "2026-07-08T19:32:21.628513Z"
+        },
+        "all_time": {
+          "calls": 584,
+          "tenant_count": 1,
+          "user_count": 1,
+          "component_count": 1,
+          "tenants": {
+            "unknown": 584
+          },
+          "users": {
+            "unknown": 584
+          },
+          "components": {
+            "unknown": 584
+          }
+        },
+        "window": {
+          "calls": 0,
+          "tenant_count": 0,
+          "user_count": 0,
+          "component_count": 0,
+          "tenants": {},
+          "users": {},
+          "components": {}
+        },
+        "last_seen_at": "2026-07-18T16:00:45.856882Z",
+        "retirement_candidate": true,
+        "retirement_reason": "no measured usage in review window"
+      },
+      {
+        "interface": {
+          "id": "3e4a3d0b-08fa-45c3-91e2-4f514a914b97",
+          "interface_key": "rest_api:GET /workstreams/",
+          "interface_kind": "rest_api",
+          "legacy_since": "2026-06-04T00:26:14.533764Z",
+          "replacement_ref": "/workplans/",
+          "owner_component": "state-hub.api",
+          "status": "legacy",
+          "replacement_verified": true,
+          "manual_hold": false,
+          "hold_reason": null,
+          "notes": null,
+          "retired_at": null,
+          "created_at": "2026-06-04T00:26:14.533764Z",
+          "updated_at": "2026-06-04T00:26:14.533764Z"
+        },
+        "all_time": {
+          "calls": 144084,
+          "tenant_count": 1,
+          "user_count": 1,
+          "component_count": 1,
+          "tenants": {
+            "unknown": 144084
+          },
+          "users": {
+            "unknown": 144084
+          },
+          "components": {
+            "unknown": 144084
+          }
+        },
+        "window": {
+          "calls": 0,
+          "tenant_count": 0,
+          "user_count": 0,
+          "component_count": 0,
+          "tenants": {},
+          "users": {},
+          "components": {}
+        },
+        "last_seen_at": "2026-07-08T21:14:39.652776Z",
+        "retirement_candidate": true,
+        "retirement_reason": "no measured usage in review window"
+      },
+      {
+        "interface": {
+          "id": "e4c140ec-7479-46f9-b185-4b533f19d639",
+          "interface_key": "rest_api:GET /workstreams/workplan-index",
+          "interface_kind": "rest_api",
+          "legacy_since": "2026-06-04T05:20:58.321869Z",
+          "replacement_ref": "/workplans/index",
+          "owner_component": "state-hub.api",
+          "status": "legacy",
+          "replacement_verified": true,
+          "manual_hold": false,
+          "hold_reason": null,
+          "notes": null,
+          "retired_at": null,
+          "created_at": "2026-06-04T05:20:58.321869Z",
+          "updated_at": "2026-06-04T05:20:58.321869Z"
+        },
+        "all_time": {
+          "calls": 30,
+          "tenant_count": 1,
+          "user_count": 1,
+          "component_count": 1,
+          "tenants": {
+            "unknown": 30
+          },
+          "users": {
+            "unknown": 30
+          },
+          "components": {
+            "unknown": 30
+          }
+        },
+        "window": {
+          "calls": 0,
+          "tenant_count": 0,
+          "user_count": 0,
+          "component_count": 0,
+          "tenants": {},
+          "users": {},
+          "components": {}
+        },
+        "last_seen_at": "2026-07-03T05:20:34.534439Z",
+        "retirement_candidate": true,
+        "retirement_reason": "no measured usage in review window"
+      },
+      {
+        "interface": {
+          "id": "3a00b19e-e7db-4403-98aa-a77c9ab61ecc",
+          "interface_key": "rest_api:GET /workstreams/{workstream_id}",
+          "interface_kind": "rest_api",
+          "legacy_since": "2026-06-04T00:25:59.014966Z",
+          "replacement_ref": "/workplans/{workplan_id}",
+          "owner_component": "state-hub.api",
+          "status": "legacy",
+          "replacement_verified": true,
+          "manual_hold": false,
+          "hold_reason": null,
+          "notes": null,
+          "retired_at": null,
+          "created_at": "2026-06-04T00:25:59.014966Z",
+          "updated_at": "2026-06-04T00:25:59.014966Z"
+        },
+        "all_time": {
+          "calls": 511405,
+          "tenant_count": 1,
+          "user_count": 1,
+          "component_count": 1,
+          "tenants": {
+            "unknown": 511405
+          },
+          "users": {
+            "unknown": 511405
+          },
+          "components": {
+            "unknown": 511405
+          }
+        },
+        "window": {
+          "calls": 0,
+          "tenant_count": 0,
+          "user_count": 0,
+          "component_count": 0,
+          "tenants": {},
+          "users": {},
+          "components": {}
+        },
+        "last_seen_at": "2026-07-08T21:14:20.781103Z",
+        "retirement_candidate": true,
+        "retirement_reason": "no measured usage in review window"
+      },
+      {
+        "interface": {
+          "id": "69e1a255-a8b9-4101-8a68-b1bed23abfda",
+          "interface_key": "rest_api:GET /workstreams/{workstream_id}/dependencies/",
+          "interface_kind": "rest_api",
+          "legacy_since": "2026-06-04T00:25:59.291135Z",
+          "replacement_ref": "/workplans/{workplan_id}/dependencies/",
+          "owner_component": "state-hub.api",
+          "status": "legacy",
+          "replacement_verified": true,
+          "manual_hold": false,
+          "hold_reason": null,
+          "notes": null,
+          "retired_at": null,
+          "created_at": "2026-06-04T00:25:59.291135Z",
+          "updated_at": "2026-06-04T00:25:59.291135Z"
+        },
+        "all_time": {
+          "calls": 255865,
+          "tenant_count": 1,
+          "user_count": 1,
+          "component_count": 1,
+          "tenants": {
+            "unknown": 255865
+          },
+          "users": {
+            "unknown": 255865
+          },
+          "components": {
+            "unknown": 255865
+          }
+        },
+        "window": {
+          "calls": 0,
+          "tenant_count": 0,
+          "user_count": 0,
+          "component_count": 0,
+          "tenants": {},
+          "users": {},
+          "components": {}
+        },
+        "last_seen_at": "2026-07-08T21:14:12.747005Z",
+        "retirement_candidate": true,
+        "retirement_reason": "no measured usage in review window"
+      },
+      {
+        "interface": {
+          "id": "b1aae931-b51f-4a85-a723-865dd65f6132",
+          "interface_key": "rest_api:PATCH /workstreams/{workstream_id}",
+          "interface_kind": "rest_api",
+          "legacy_since": "2026-06-04T06:09:41.901035Z",
+          "replacement_ref": "/workplans/{workplan_id}",
+          "owner_component": "state-hub.api",
+          "status": "legacy",
+          "replacement_verified": true,
+          "manual_hold": false,
+          "hold_reason": null,
+          "notes": null,
+          "retired_at": null,
+          "created_at": "2026-06-04T06:09:41.901035Z",
+          "updated_at": "2026-06-04T06:09:41.901035Z"
+        },
+        "all_time": {
+          "calls": 571,
+          "tenant_count": 1,
+          "user_count": 1,
+          "component_count": 1,
+          "tenants": {
+            "unknown": 571
+          },
+          "users": {
+            "unknown": 571
+          },
+          "components": {
+            "unknown": 571
+          }
+        },
+        "window": {
+          "calls": 0,
+          "tenant_count": 0,
+          "user_count": 0,
+          "component_count": 0,
+          "tenants": {},
+          "users": {},
+          "components": {}
+        },
+        "last_seen_at": "2026-07-08T20:49:12.335710Z",
+        "retirement_candidate": true,
+        "retirement_reason": "no measured usage in review window"
+      },
+      {
+        "interface": {
+          "id": "4aea9591-970b-4918-ac4a-4da95a0a1a8c",
+          "interface_key": "rest_api:POST /decisions/ workstream_id",
+          "interface_kind": "rest_api",
+          "legacy_since": "2026-07-09T22:56:35.473130Z",
+          "replacement_ref": "POST /decisions/ with workplan_id",
+          "owner_component": "state-hub.api",
+          "status": "legacy",
+          "replacement_verified": true,
+          "manual_hold": false,
+          "hold_reason": null,
+          "notes": null,
+          "retired_at": null,
+          "created_at": "2026-07-09T22:56:35.473130Z",
+          "updated_at": "2026-07-09T22:56:35.473130Z"
+        },
+        "all_time": {
+          "calls": 3,
+          "tenant_count": 1,
+          "user_count": 1,
+          "component_count": 1,
+          "tenants": {
+            "unknown": 3
+          },
+          "users": {
+            "unknown": 3
+          },
+          "components": {
+            "unknown": 3
+          }
+        },
+        "window": {
+          "calls": 0,
+          "tenant_count": 0,
+          "user_count": 0,
+          "component_count": 0,
+          "tenants": {},
+          "users": {},
+          "components": {}
+        },
+        "last_seen_at": "2026-07-09T22:57:05.912456Z",
+        "retirement_candidate": true,
+        "retirement_reason": "no measured usage in review window"
+      },
+      {
+        "interface": {
+          "id": "4a70583c-1e41-4ec1-99a9-728856a7d79c",
+          "interface_key": "rest_api:POST /progress/ workstream_id",
+          "interface_kind": "rest_api",
+          "legacy_since": "2026-07-08T23:35:09.148333Z",
+          "replacement_ref": "POST /progress/ with workplan_id",
+          "owner_component": "state-hub.api",
+          "status": "legacy",
+          "replacement_verified": true,
+          "manual_hold": false,
+          "hold_reason": null,
+          "notes": null,
+          "retired_at": null,
+          "created_at": "2026-07-08T23:35:09.148333Z",
+          "updated_at": "2026-07-08T23:35:09.148333Z"
+        },
+        "all_time": {
+          "calls": 14,
+          "tenant_count": 1,
+          "user_count": 1,
+          "component_count": 1,
+          "tenants": {
+            "unknown": 14
+          },
+          "users": {
+            "unknown": 14
+          },
+          "components": {
+            "unknown": 14
+          }
+        },
+        "window": {
+          "calls": 0,
+          "tenant_count": 0,
+          "user_count": 0,
+          "component_count": 0,
+          "tenants": {},
+          "users": {},
+          "components": {}
+        },
+        "last_seen_at": "2026-07-10T08:34:42.959724Z",
+        "retirement_candidate": true,
+        "retirement_reason": "no measured usage in review window"
+      },
+      {
+        "interface": {
+          "id": "6df4e443-7bf1-461a-923b-a6eb52fe7b07",
+          "interface_key": "rest_api:POST /tasks/ workstream_id",
+          "interface_kind": "rest_api",
+          "legacy_since": "2026-07-08T22:38:29.405720Z",
+          "replacement_ref": "POST /tasks/ with workplan_id",
+          "owner_component": "state-hub.api",
+          "status": "legacy",
+          "replacement_verified": true,
+          "manual_hold": false,
+          "hold_reason": null,
+          "notes": null,
+          "retired_at": null,
+          "created_at": "2026-07-08T22:38:29.405720Z",
+          "updated_at": "2026-07-08T22:38:29.405720Z"
+        },
+        "all_time": {
+          "calls": 5,
+          "tenant_count": 1,
+          "user_count": 1,
+          "component_count": 1,
+          "tenants": {
+            "unknown": 5
+          },
+          "users": {
+            "unknown": 5
+          },
+          "components": {
+            "state-hub.fix-consistency": 5
+          }
+        },
+        "window": {
+          "calls": 0,
+          "tenant_count": 0,
+          "user_count": 0,
+          "component_count": 0,
+          "tenants": {},
+          "users": {},
+          "components": {}
+        },
+        "last_seen_at": "2026-07-08T22:38:29.976918Z",
+        "retirement_candidate": true,
+        "retirement_reason": "no measured usage in review window"
+      },
+      {
+        "interface": {
+          "id": "ed6451c9-d2cc-4486-9afe-d3852782cabc",
+          "interface_key": "rest_api:POST /workstreams/",
+          "interface_kind": "rest_api",
+          "legacy_since": "2026-06-04T07:40:24.168535Z",
+          "replacement_ref": "/workplans/",
+          "owner_component": "state-hub.api",
+          "status": "legacy",
+          "replacement_verified": true,
+          "manual_hold": false,
+          "hold_reason": null,
+          "notes": null,
+          "retired_at": null,
+          "created_at": "2026-06-04T07:40:24.168535Z",
+          "updated_at": "2026-06-04T07:40:24.168535Z"
+        },
+        "all_time": {
+          "calls": 824,
+          "tenant_count": 1,
+          "user_count": 1,
+          "component_count": 1,
+          "tenants": {
+            "unknown": 824
+          },
+          "users": {
+            "unknown": 824
+          },
+          "components": {
+            "unknown": 824
+          }
+        },
+        "window": {
+          "calls": 0,
+          "tenant_count": 0,
+          "user_count": 0,
+          "component_count": 0,
+          "tenants": {},
+          "users": {},
+          "components": {}
+        },
+        "last_seen_at": "2026-07-08T20:38:05.903144Z",
+        "retirement_candidate": true,
+        "retirement_reason": "no measured usage in review window"
+      },
+      {
+        "interface": {
+          "id": "281fd706-b192-4194-8055-2d8733c115f9",
+          "interface_key": "rest_api:POST /workstreams/{workstream_id}/dependencies/",
+          "interface_kind": "rest_api",
+          "legacy_since": "2026-06-04T22:57:37.149207Z",
+          "replacement_ref": "/workplans/{workplan_id}/dependencies/",
+          "owner_component": "state-hub.api",
+          "status": "legacy",
+          "replacement_verified": true,
+          "manual_hold": false,
+          "hold_reason": null,
+          "notes": null,
+          "retired_at": null,
+          "created_at": "2026-06-04T22:57:37.149207Z",
+          "updated_at": "2026-06-04T22:57:37.149207Z"
+        },
+        "all_time": {
+          "calls": 4971,
+          "tenant_count": 1,
+          "user_count": 1,
+          "component_count": 1,
+          "tenants": {
+            "unknown": 4971
+          },
+          "users": {
+            "unknown": 4971
+          },
+          "components": {
+            "unknown": 4971
+          }
+        },
+        "window": {
+          "calls": 0,
+          "tenant_count": 0,
+          "user_count": 0,
+          "component_count": 0,
+          "tenants": {},
+          "users": {},
+          "components": {}
+        },
+        "last_seen_at": "2026-07-01T22:09:24.229011Z",
+        "retirement_candidate": true,
+        "retirement_reason": "no measured usage in review window"
+      }
+    ],
+    "retirement_candidates": [
+      {
+        "interface": {
+          "id": "63ed90e3-42b4-431a-94db-e1254a52f9e2",
+          "interface_key": "mcp:create_workstream",
+          "interface_kind": "mcp_tool",
+          "legacy_since": "2026-07-10T13:19:44.205900Z",
+          "replacement_ref": "create_workplan",
+          "owner_component": "state-hub.mcp",
+          "status": "legacy",
+          "replacement_verified": true,
+          "manual_hold": false,
+          "hold_reason": null,
+          "notes": "Registered by STATE-WP-0070 T03 \u2014 zero-window streak starts at registration",
+          "retired_at": null,
+          "created_at": "2026-07-10T13:19:44.205900Z",
+          "updated_at": "2026-07-10T13:19:44.205900Z"
+        },
+        "all_time": {
+          "calls": 2,
+          "tenant_count": 1,
+          "user_count": 1,
+          "component_count": 1,
+          "tenants": {
+            "unknown": 2
+          },
+          "users": {
+            "unknown": 2
+          },
+          "components": {
+            "state-hub.mcp": 2
+          }
+        },
+        "window": {
+          "calls": 0,
+          "tenant_count": 0,
+          "user_count": 0,
+          "component_count": 0,
+          "tenants": {},
+          "users": {},
+          "components": {}
+        },
+        "last_seen_at": "2026-07-10T13:20:43.378546Z",
+        "retirement_candidate": true,
+        "retirement_reason": "no measured usage in review window"
+      },
+      {
+        "interface": {
+          "id": "b6a5fe44-fb85-4ef7-a273-78d09da777af",
+          "interface_key": "mcp:list_workstreams",
+          "interface_kind": "mcp_tool",
+          "legacy_since": "2026-07-10T13:19:26.075491Z",
+          "replacement_ref": "list_workplans",
+          "owner_component": "state-hub.mcp",
+          "status": "legacy",
+          "replacement_verified": true,
+          "manual_hold": false,
+          "hold_reason": null,
+          "notes": null,
+          "retired_at": null,
+          "created_at": "2026-07-10T13:19:26.075491Z",
+          "updated_at": "2026-07-10T13:19:26.075491Z"
+        },
+        "all_time": {
+          "calls": 2,
+          "tenant_count": 1,
+          "user_count": 1,
+          "component_count": 1,
+          "tenants": {
+            "unknown": 2
+          },
+          "users": {
+            "unknown": 2
+          },
+          "components": {
+            "state-hub.mcp": 2
+          }
+        },
+        "window": {
+          "calls": 0,
+          "tenant_count": 0,
+          "user_count": 0,
+          "component_count": 0,
+          "tenants": {},
+          "users": {},
+          "components": {}
+        },
+        "last_seen_at": "2026-07-10T13:20:42.374940Z",
+        "retirement_candidate": true,
+        "retirement_reason": "no measured usage in review window"
+      },
+      {
+        "interface": {
+          "id": "53c3372b-307d-4d6a-8ea4-bc36cacdcaf2",
+          "interface_key": "mcp:update_workstream",
+          "interface_kind": "mcp_tool",
+          "legacy_since": "2026-07-10T13:19:44.255216Z",
+          "replacement_ref": "update_workplan",
+          "owner_component": "state-hub.mcp",
+          "status": "legacy",
+          "replacement_verified": true,
+          "manual_hold": false,
+          "hold_reason": null,
+          "notes": "Registered by STATE-WP-0070 T03 \u2014 zero-window streak starts at registration",
+          "retired_at": null,
+          "created_at": "2026-07-10T13:19:44.255216Z",
+          "updated_at": "2026-07-10T13:19:44.255216Z"
+        },
+        "all_time": {
+          "calls": 0,
+          "tenant_count": 0,
+          "user_count": 0,
+          "component_count": 0,
+          "tenants": {},
+          "users": {},
+          "components": {}
+        },
+        "window": {
+          "calls": 0,
+          "tenant_count": 0,
+          "user_count": 0,
+          "component_count": 0,
+          "tenants": {},
+          "users": {},
+          "components": {}
+        },
+        "last_seen_at": null,
+        "retirement_candidate": true,
+        "retirement_reason": "no measured usage in review window"
+      },
+      {
+        "interface": {
+          "id": "bed4d08a-3471-48f5-9f0e-f9d550383a26",
+          "interface_key": "mcp:update_workstream_status",
+          "interface_kind": "mcp_tool",
+          "legacy_since": "2026-07-10T13:19:44.303612Z",
+          "replacement_ref": "update_workplan_status",
+          "owner_component": "state-hub.mcp",
+          "status": "legacy",
+          "replacement_verified": true,
+          "manual_hold": false,
+          "hold_reason": null,
+          "notes": "Registered by STATE-WP-0070 T03 \u2014 zero-window streak starts at registration",
+          "retired_at": null,
+          "created_at": "2026-07-10T13:19:44.303612Z",
+          "updated_at": "2026-07-10T13:19:44.303612Z"
+        },
+        "all_time": {
+          "calls": 0,
+          "tenant_count": 0,
+          "user_count": 0,
+          "component_count": 0,
+          "tenants": {},
+          "users": {},
+          "components": {}
+        },
+        "window": {
+          "calls": 0,
+          "tenant_count": 0,
+          "user_count": 0,
+          "component_count": 0,
+          "tenants": {},
+          "users": {},
+          "components": {}
+        },
+        "last_seen_at": null,
+        "retirement_candidate": true,
+        "retirement_reason": "no measured usage in review window"
+      },
+      {
+        "interface": {
+          "id": "46900dc2-0893-405b-ba59-80f31fb6ebb1",
+          "interface_key": "state://workstreams/{topic_slug}",
+          "interface_kind": "mcp_tool",
+          "legacy_since": "2026-07-10T13:19:44.344493Z",
+          "replacement_ref": "state://workplans/{topic_slug}",
+          "owner_component": "state-hub.mcp",
+          "status": "legacy",
+          "replacement_verified": true,
+          "manual_hold": false,
+          "hold_reason": null,
+          "notes": "Registered by STATE-WP-0070 T03 \u2014 zero-window streak starts at registration",
+          "retired_at": null,
+          "created_at": "2026-07-10T13:19:44.344493Z",
+          "updated_at": "2026-07-10T13:19:44.344493Z"
+        },
+        "all_time": {
+          "calls": 1,
+          "tenant_count": 1,
+          "user_count": 1,
+          "component_count": 1,
+          "tenants": {
+            "unknown": 1
+          },
+          "users": {
+            "unknown": 1
+          },
+          "components": {
+            "state-hub.mcp": 1
+          }
+        },
+        "window": {
+          "calls": 0,
+          "tenant_count": 0,
+          "user_count": 0,
+          "component_count": 0,
+          "tenants": {},
+          "users": {},
+          "components": {}
+        },
+        "last_seen_at": "2026-07-10T13:20:34.491811Z",
+        "retirement_candidate": true,
+        "retirement_reason": "no measured usage in review window"
+      },
+      {
+        "interface": {
+          "id": "cd9342fd-27e7-4a46-a1be-d41499e106a3",
+          "interface_key": "rest_api:DELETE /workstreams/{workstream_id}",
+          "interface_kind": "rest_api",
+          "legacy_since": "2026-06-06T17:28:13.052813Z",
+          "replacement_ref": "/workplans/{workplan_id}",
+          "owner_component": "state-hub.api",
+          "status": "legacy",
+          "replacement_verified": true,
+          "manual_hold": false,
+          "hold_reason": null,
+          "notes": null,
+          "retired_at": null,
+          "created_at": "2026-06-06T17:28:13.052813Z",
+          "updated_at": "2026-06-06T17:28:13.052813Z"
+        },
+        "all_time": {
+          "calls": 1,
+          "tenant_count": 1,
+          "user_count": 1,
+          "component_count": 1,
+          "tenants": {
+            "unknown": 1
+          },
+          "users": {
+            "unknown": 1
+          },
+          "components": {
+            "unknown": 1
+          }
+        },
+        "window": {
+          "calls": 0,
+          "tenant_count": 0,
+          "user_count": 0,
+          "component_count": 0,
+          "tenants": {},
+          "users": {},
+          "components": {}
+        },
+        "last_seen_at": "2026-06-06T17:28:13.047529Z",
+        "retirement_candidate": true,
+        "retirement_reason": "no measured usage in review window"
+      },
+      {
+        "interface": {
+          "id": "a4e0948c-cd4a-461e-8ae2-7fd7b51d04a7",
+          "interface_key": "rest_api:GET /decisions/?workstream_id",
+          "interface_kind": "rest_api",
+          "legacy_since": "2026-07-09T23:07:53.093223Z",
+          "replacement_ref": "/decisions/?workplan_id=<workplan_id>",
+          "owner_component": "state-hub.api",
+          "status": "legacy",
+          "replacement_verified": true,
+          "manual_hold": false,
+          "hold_reason": null,
+          "notes": null,
+          "retired_at": null,
+          "created_at": "2026-07-09T23:07:53.093223Z",
+          "updated_at": "2026-07-09T23:07:53.093223Z"
+        },
+        "all_time": {
+          "calls": 1,
+          "tenant_count": 1,
+          "user_count": 1,
+          "component_count": 1,
+          "tenants": {
+            "unknown": 1
+          },
+          "users": {
+            "unknown": 1
+          },
+          "components": {
+            "unknown": 1
+          }
+        },
+        "window": {
+          "calls": 0,
+          "tenant_count": 0,
+          "user_count": 0,
+          "component_count": 0,
+          "tenants": {},
+          "users": {},
+          "components": {}
+        },
+        "last_seen_at": "2026-07-09T23:07:53.083299Z",
+        "retirement_candidate": true,
+        "retirement_reason": "no measured usage in review window"
+      },
+      {
+        "interface": {
+          "id": "70a9346e-e0ee-42ac-874f-f160580b54dd",
+          "interface_key": "rest_api:GET /progress/?workstream_id",
+          "interface_kind": "rest_api",
+          "legacy_since": "2026-07-13T22:04:03.911449Z",
+          "replacement_ref": "/progress/?workplan_id=<workplan_id>",
+          "owner_component": "state-hub.api",
+          "status": "legacy",
+          "replacement_verified": true,
+          "manual_hold": false,
+          "hold_reason": null,
+          "notes": null,
+          "retired_at": null,
+          "created_at": "2026-07-13T22:04:03.911449Z",
+          "updated_at": "2026-07-13T22:04:03.911449Z"
+        },
+        "all_time": {
+          "calls": 1,
+          "tenant_count": 1,
+          "user_count": 1,
+          "component_count": 1,
+          "tenants": {
+            "unknown": 1
+          },
+          "users": {
+            "unknown": 1
+          },
+          "components": {
+            "unknown": 1
+          }
+        },
+        "window": {
+          "calls": 0,
+          "tenant_count": 0,
+          "user_count": 0,
+          "component_count": 0,
+          "tenants": {},
+          "users": {},
+          "components": {}
+        },
+        "last_seen_at": "2026-07-13T22:04:03.904998Z",
+        "retirement_candidate": true,
+        "retirement_reason": "no measured usage in review window"
+      },
+      {
+        "interface": {
+          "id": "be3cdcf8-250b-4bf0-801f-02ffd5f57e00",
+          "interface_key": "rest_api:GET /tasks/?workstream_id",
+          "interface_kind": "rest_api",
+          "legacy_since": "2026-07-08T19:32:21.628513Z",
+          "replacement_ref": "/tasks/?workplan_id=<workplan_id>",
+          "owner_component": "state-hub.api",
+          "status": "legacy",
+          "replacement_verified": true,
+          "manual_hold": false,
+          "hold_reason": null,
+          "notes": null,
+          "retired_at": null,
+          "created_at": "2026-07-08T19:32:21.628513Z",
+          "updated_at": "2026-07-08T19:32:21.628513Z"
+        },
+        "all_time": {
+          "calls": 584,
+          "tenant_count": 1,
+          "user_count": 1,
+          "component_count": 1,
+          "tenants": {
+            "unknown": 584
+          },
+          "users": {
+            "unknown": 584
+          },
+          "components": {
+            "unknown": 584
+          }
+        },
+        "window": {
+          "calls": 0,
+          "tenant_count": 0,
+          "user_count": 0,
+          "component_count": 0,
+          "tenants": {},
+          "users": {},
+          "components": {}
+        },
+        "last_seen_at": "2026-07-18T16:00:45.856882Z",
+        "retirement_candidate": true,
+        "retirement_reason": "no measured usage in review window"
+      },
+      {
+        "interface": {
+          "id": "3e4a3d0b-08fa-45c3-91e2-4f514a914b97",
+          "interface_key": "rest_api:GET /workstreams/",
+          "interface_kind": "rest_api",
+          "legacy_since": "2026-06-04T00:26:14.533764Z",
+          "replacement_ref": "/workplans/",
+          "owner_component": "state-hub.api",
+          "status": "legacy",
+          "replacement_verified": true,
+          "manual_hold": false,
+          "hold_reason": null,
+          "notes": null,
+          "retired_at": null,
+          "created_at": "2026-06-04T00:26:14.533764Z",
+          "updated_at": "2026-06-04T00:26:14.533764Z"
+        },
+        "all_time": {
+          "calls": 144084,
+          "tenant_count": 1,
+          "user_count": 1,
+          "component_count": 1,
+          "tenants": {
+            "unknown": 144084
+          },
+          "users": {
+            "unknown": 144084
+          },
+          "components": {
+            "unknown": 144084
+          }
+        },
+        "window": {
+          "calls": 0,
+          "tenant_count": 0,
+          "user_count": 0,
+          "component_count": 0,
+          "tenants": {},
+          "users": {},
+          "components": {}
+        },
+        "last_seen_at": "2026-07-08T21:14:39.652776Z",
+        "retirement_candidate": true,
+        "retirement_reason": "no measured usage in review window"
+      },
+      {
+        "interface": {
+          "id": "e4c140ec-7479-46f9-b185-4b533f19d639",
+          "interface_key": "rest_api:GET /workstreams/workplan-index",
+          "interface_kind": "rest_api",
+          "legacy_since": "2026-06-04T05:20:58.321869Z",
+          "replacement_ref": "/workplans/index",
+          "owner_component": "state-hub.api",
+          "status": "legacy",
+          "replacement_verified": true,
+          "manual_hold": false,
+          "hold_reason": null,
+          "notes": null,
+          "retired_at": null,
+          "created_at": "2026-06-04T05:20:58.321869Z",
+          "updated_at": "2026-06-04T05:20:58.321869Z"
+        },
+        "all_time": {
+          "calls": 30,
+          "tenant_count": 1,
+          "user_count": 1,
+          "component_count": 1,
+          "tenants": {
+            "unknown": 30
+          },
+          "users": {
+            "unknown": 30
+          },
+          "components": {
+            "unknown": 30
+          }
+        },
+        "window": {
+          "calls": 0,
+          "tenant_count": 0,
+          "user_count": 0,
+          "component_count": 0,
+          "tenants": {},
+          "users": {},
+          "components": {}
+        },
+        "last_seen_at": "2026-07-03T05:20:34.534439Z",
+        "retirement_candidate": true,
+        "retirement_reason": "no measured usage in review window"
+      },
+      {
+        "interface": {
+          "id": "3a00b19e-e7db-4403-98aa-a77c9ab61ecc",
+          "interface_key": "rest_api:GET /workstreams/{workstream_id}",
+          "interface_kind": "rest_api",
+          "legacy_since": "2026-06-04T00:25:59.014966Z",
+          "replacement_ref": "/workplans/{workplan_id}",
+          "owner_component": "state-hub.api",
+          "status": "legacy",
+          "replacement_verified": true,
+          "manual_hold": false,
+          "hold_reason": null,
+          "notes": null,
+          "retired_at": null,
+          "created_at": "2026-06-04T00:25:59.014966Z",
+          "updated_at": "2026-06-04T00:25:59.014966Z"
+        },
+        "all_time": {
+          "calls": 511405,
+          "tenant_count": 1,
+          "user_count": 1,
+          "component_count": 1,
+          "tenants": {
+            "unknown": 511405
+          },
+          "users": {
+            "unknown": 511405
+          },
+          "components": {
+            "unknown": 511405
+          }
+        },
+        "window": {
+          "calls": 0,
+          "tenant_count": 0,
+          "user_count": 0,
+          "component_count": 0,
+          "tenants": {},
+          "users": {},
+          "components": {}
+        },
+        "last_seen_at": "2026-07-08T21:14:20.781103Z",
+        "retirement_candidate": true,
+        "retirement_reason": "no measured usage in review window"
+      },
+      {
+        "interface": {
+          "id": "69e1a255-a8b9-4101-8a68-b1bed23abfda",
+          "interface_key": "rest_api:GET /workstreams/{workstream_id}/dependencies/",
+          "interface_kind": "rest_api",
+          "legacy_since": "2026-06-04T00:25:59.291135Z",
+          "replacement_ref": "/workplans/{workplan_id}/dependencies/",
+          "owner_component": "state-hub.api",
+          "status": "legacy",
+          "replacement_verified": true,
+          "manual_hold": false,
+          "hold_reason": null,
+          "notes": null,
+          "retired_at": null,
+          "created_at": "2026-06-04T00:25:59.291135Z",
+          "updated_at": "2026-06-04T00:25:59.291135Z"
+        },
+        "all_time": {
+          "calls": 255865,
+          "tenant_count": 1,
+          "user_count": 1,
+          "component_count": 1,
+          "tenants": {
+            "unknown": 255865
+          },
+          "users": {
+            "unknown": 255865
+          },
+          "components": {
+            "unknown": 255865
+          }
+        },
+        "window": {
+          "calls": 0,
+          "tenant_count": 0,
+          "user_count": 0,
+          "component_count": 0,
+          "tenants": {},
+          "users": {},
+          "components": {}
+        },
+        "last_seen_at": "2026-07-08T21:14:12.747005Z",
+        "retirement_candidate": true,
+        "retirement_reason": "no measured usage in review window"
+      },
+      {
+        "interface": {
+          "id": "b1aae931-b51f-4a85-a723-865dd65f6132",
+          "interface_key": "rest_api:PATCH /workstreams/{workstream_id}",
+          "interface_kind": "rest_api",
+          "legacy_since": "2026-06-04T06:09:41.901035Z",
+          "replacement_ref": "/workplans/{workplan_id}",
+          "owner_component": "state-hub.api",
+          "status": "legacy",
+          "replacement_verified": true,
+          "manual_hold": false,
+          "hold_reason": null,
+          "notes": null,
+          "retired_at": null,
+          "created_at": "2026-06-04T06:09:41.901035Z",
+          "updated_at": "2026-06-04T06:09:41.901035Z"
+        },
+        "all_time": {
+          "calls": 571,
+          "tenant_count": 1,
+          "user_count": 1,
+          "component_count": 1,
+          "tenants": {
+            "unknown": 571
+          },
+          "users": {
+            "unknown": 571
+          },
+          "components": {
+            "unknown": 571
+          }
+        },
+        "window": {
+          "calls": 0,
+          "tenant_count": 0,
+          "user_count": 0,
+          "component_count": 0,
+          "tenants": {},
+          "users": {},
+          "components": {}
+        },
+        "last_seen_at": "2026-07-08T20:49:12.335710Z",
+        "retirement_candidate": true,
+        "retirement_reason": "no measured usage in review window"
+      },
+      {
+        "interface": {
+          "id": "4aea9591-970b-4918-ac4a-4da95a0a1a8c",
+          "interface_key": "rest_api:POST /decisions/ workstream_id",
+          "interface_kind": "rest_api",
+          "legacy_since": "2026-07-09T22:56:35.473130Z",
+          "replacement_ref": "POST /decisions/ with workplan_id",
+          "owner_component": "state-hub.api",
+          "status": "legacy",
+          "replacement_verified": true,
+          "manual_hold": false,
+          "hold_reason": null,
+          "notes": null,
+          "retired_at": null,
+          "created_at": "2026-07-09T22:56:35.473130Z",
+          "updated_at": "2026-07-09T22:56:35.473130Z"
+        },
+        "all_time": {
+          "calls": 3,
+          "tenant_count": 1,
+          "user_count": 1,
+          "component_count": 1,
+          "tenants": {
+            "unknown": 3
+          },
+          "users": {
+            "unknown": 3
+          },
+          "components": {
+            "unknown": 3
+          }
+        },
+        "window": {
+          "calls": 0,
+          "tenant_count": 0,
+          "user_count": 0,
+          "component_count": 0,
+          "tenants": {},
+          "users": {},
+          "components": {}
+        },
+        "last_seen_at": "2026-07-09T22:57:05.912456Z",
+        "retirement_candidate": true,
+        "retirement_reason": "no measured usage in review window"
+      },
+      {
+        "interface": {
+          "id": "4a70583c-1e41-4ec1-99a9-728856a7d79c",
+          "interface_key": "rest_api:POST /progress/ workstream_id",
+          "interface_kind": "rest_api",
+          "legacy_since": "2026-07-08T23:35:09.148333Z",
+          "replacement_ref": "POST /progress/ with workplan_id",
+          "owner_component": "state-hub.api",
+          "status": "legacy",
+          "replacement_verified": true,
+          "manual_hold": false,
+          "hold_reason": null,
+          "notes": null,
+          "retired_at": null,
+          "created_at": "2026-07-08T23:35:09.148333Z",
+          "updated_at": "2026-07-08T23:35:09.148333Z"
+        },
+        "all_time": {
+          "calls": 14,
+          "tenant_count": 1,
+          "user_count": 1,
+          "component_count": 1,
+          "tenants": {
+            "unknown": 14
+          },
+          "users": {
+            "unknown": 14
+          },
+          "components": {
+            "unknown": 14
+          }
+        },
+        "window": {
+          "calls": 0,
+          "tenant_count": 0,
+          "user_count": 0,
+          "component_count": 0,
+          "tenants": {},
+          "users": {},
+          "components": {}
+        },
+        "last_seen_at": "2026-07-10T08:34:42.959724Z",
+        "retirement_candidate": true,
+        "retirement_reason": "no measured usage in review window"
+      },
+      {
+        "interface": {
+          "id": "6df4e443-7bf1-461a-923b-a6eb52fe7b07",
+          "interface_key": "rest_api:POST /tasks/ workstream_id",
+          "interface_kind": "rest_api",
+          "legacy_since": "2026-07-08T22:38:29.405720Z",
+          "replacement_ref": "POST /tasks/ with workplan_id",
+          "owner_component": "state-hub.api",
+          "status": "legacy",
+          "replacement_verified": true,
+          "manual_hold": false,
+          "hold_reason": null,
+          "notes": null,
+          "retired_at": null,
+          "created_at": "2026-07-08T22:38:29.405720Z",
+          "updated_at": "2026-07-08T22:38:29.405720Z"
+        },
+        "all_time": {
+          "calls": 5,
+          "tenant_count": 1,
+          "user_count": 1,
+          "component_count": 1,
+          "tenants": {
+            "unknown": 5
+          },
+          "users": {
+            "unknown": 5
+          },
+          "components": {
+            "state-hub.fix-consistency": 5
+          }
+        },
+        "window": {
+          "calls": 0,
+          "tenant_count": 0,
+          "user_count": 0,
+          "component_count": 0,
+          "tenants": {},
+          "users": {},
+          "components": {}
+        },
+        "last_seen_at": "2026-07-08T22:38:29.976918Z",
+        "retirement_candidate": true,
+        "retirement_reason": "no measured usage in review window"
+      },
+      {
+        "interface": {
+          "id": "ed6451c9-d2cc-4486-9afe-d3852782cabc",
+          "interface_key": "rest_api:POST /workstreams/",
+          "interface_kind": "rest_api",
+          "legacy_since": "2026-06-04T07:40:24.168535Z",
+          "replacement_ref": "/workplans/",
+          "owner_component": "state-hub.api",
+          "status": "legacy",
+          "replacement_verified": true,
+          "manual_hold": false,
+          "hold_reason": null,
+          "notes": null,
+          "retired_at": null,
+          "created_at": "2026-06-04T07:40:24.168535Z",
+          "updated_at": "2026-06-04T07:40:24.168535Z"
+        },
+        "all_time": {
+          "calls": 824,
+          "tenant_count": 1,
+          "user_count": 1,
+          "component_count": 1,
+          "tenants": {
+            "unknown": 824
+          },
+          "users": {
+            "unknown": 824
+          },
+          "components": {
+            "unknown": 824
+          }
+        },
+        "window": {
+          "calls": 0,
+          "tenant_count": 0,
+          "user_count": 0,
+          "component_count": 0,
+          "tenants": {},
+          "users": {},
+          "components": {}
+        },
+        "last_seen_at": "2026-07-08T20:38:05.903144Z",
+        "retirement_candidate": true,
+        "retirement_reason": "no measured usage in review window"
+      },
+      {
+        "interface": {
+          "id": "281fd706-b192-4194-8055-2d8733c115f9",
+          "interface_key": "rest_api:POST /workstreams/{workstream_id}/dependencies/",
+          "interface_kind": "rest_api",
+          "legacy_since": "2026-06-04T22:57:37.149207Z",
+          "replacement_ref": "/workplans/{workplan_id}/dependencies/",
+          "owner_component": "state-hub.api",
+          "status": "legacy",
+          "replacement_verified": true,
+          "manual_hold": false,
+          "hold_reason": null,
+          "notes": null,
+          "retired_at": null,
+          "created_at": "2026-06-04T22:57:37.149207Z",
+          "updated_at": "2026-06-04T22:57:37.149207Z"
+        },
+        "all_time": {
+          "calls": 4971,
+          "tenant_count": 1,
+          "user_count": 1,
+          "component_count": 1,
+          "tenants": {
+            "unknown": 4971
+          },
+          "users": {
+            "unknown": 4971
+          },
+          "components": {
+            "unknown": 4971
+          }
+        },
+        "window": {
+          "calls": 0,
+          "tenant_count": 0,
+          "user_count": 0,
+          "component_count": 0,
+          "tenants": {},
+          "users": {},
+          "components": {}
+        },
+        "last_seen_at": "2026-07-01T22:09:24.229011Z",
+        "retirement_candidate": true,
+        "retirement_reason": "no measured usage in review window"
+      }
+    ]
+  },
+  "hours": 8
+}
diff --git a/docs/evidence/legacy-meter-weekly-review-20260722.json b/docs/evidence/legacy-meter-weekly-review-20260722.json
new file mode 100644
index 0000000..fdf1951
--- /dev/null
+++ b/docs/evidence/legacy-meter-weekly-review-20260722.json
@@ -0,0 +1,1716 @@
+{
+  "captured_at": "2026-07-22T14:00:03.546399+00:00",
+  "api_base": "http://127.0.0.1:8000",
+  "workplan": "STATE-WP-0070",
+  "retired_interfaces": [],
+  "weekly_review": {
+    "generated_at": "2026-07-22T14:00:03.540281Z",
+    "window_start": "2026-07-22T06:00:03.489476Z",
+    "window_end": "2026-07-22T14:00:03.489476Z",
+    "cadence": "weekly",
+    "activity_core_handoff": {
+      "activity_id": "statehub-legacy-interface-review",
+      "cadence": "weekly",
+      "source_endpoint": "/legacy-meter/weekly-review",
+      "state_owner": "state-hub",
+      "scheduler_owner": "activity-core"
+    },
+    "interfaces": [
+      {
+        "interface": {
+          "id": "8051fb40-66c9-4dc4-a413-13e8573e04a3",
+          "interface_key": "event_subject:org.statehub.workstream.completed",
+          "interface_kind": "event_subject",
+          "legacy_since": "2026-06-04T06:09:42.198193Z",
+          "replacement_ref": "org.statehub.workplan.completed",
+          "owner_component": "state-hub.events",
+          "status": "retired",
+          "replacement_verified": true,
+          "manual_hold": false,
+          "hold_reason": null,
+          "notes": "Retired by STATE-WP-0069 closeout",
+          "retired_at": "2026-07-08T21:38:52.773601Z",
+          "created_at": "2026-06-04T06:09:42.198193Z",
+          "updated_at": "2026-07-08T21:38:52.761243Z"
+        },
+        "all_time": {
+          "calls": 255,
+          "tenant_count": 1,
+          "user_count": 1,
+          "component_count": 1,
+          "tenants": {
+            "unknown": 255
+          },
+          "users": {
+            "unknown": 255
+          },
+          "components": {
+            "state-hub.events": 255
+          }
+        },
+        "window": {
+          "calls": 0,
+          "tenant_count": 0,
+          "user_count": 0,
+          "component_count": 0,
+          "tenants": {},
+          "users": {},
+          "components": {}
+        },
+        "last_seen_at": "2026-07-08T20:49:12.839383Z",
+        "retirement_candidate": false,
+        "retirement_reason": "already retired"
+      },
+      {
+        "interface": {
+          "id": "63ed90e3-42b4-431a-94db-e1254a52f9e2",
+          "interface_key": "mcp:create_workstream",
+          "interface_kind": "mcp_tool",
+          "legacy_since": "2026-07-10T13:19:44.205900Z",
+          "replacement_ref": "create_workplan",
+          "owner_component": "state-hub.mcp",
+          "status": "legacy",
+          "replacement_verified": true,
+          "manual_hold": false,
+          "hold_reason": null,
+          "notes": "Registered by STATE-WP-0070 T03 \u2014 zero-window streak starts at registration",
+          "retired_at": null,
+          "created_at": "2026-07-10T13:19:44.205900Z",
+          "updated_at": "2026-07-10T13:19:44.205900Z"
+        },
+        "all_time": {
+          "calls": 2,
+          "tenant_count": 1,
+          "user_count": 1,
+          "component_count": 1,
+          "tenants": {
+            "unknown": 2
+          },
+          "users": {
+            "unknown": 2
+          },
+          "components": {
+            "state-hub.mcp": 2
+          }
+        },
+        "window": {
+          "calls": 0,
+          "tenant_count": 0,
+          "user_count": 0,
+          "component_count": 0,
+          "tenants": {},
+          "users": {},
+          "components": {}
+        },
+        "last_seen_at": "2026-07-10T13:20:43.378546Z",
+        "retirement_candidate": true,
+        "retirement_reason": "no measured usage in review window"
+      },
+      {
+        "interface": {
+          "id": "b6a5fe44-fb85-4ef7-a273-78d09da777af",
+          "interface_key": "mcp:list_workstreams",
+          "interface_kind": "mcp_tool",
+          "legacy_since": "2026-07-10T13:19:26.075491Z",
+          "replacement_ref": "list_workplans",
+          "owner_component": "state-hub.mcp",
+          "status": "legacy",
+          "replacement_verified": true,
+          "manual_hold": false,
+          "hold_reason": null,
+          "notes": null,
+          "retired_at": null,
+          "created_at": "2026-07-10T13:19:26.075491Z",
+          "updated_at": "2026-07-10T13:19:26.075491Z"
+        },
+        "all_time": {
+          "calls": 2,
+          "tenant_count": 1,
+          "user_count": 1,
+          "component_count": 1,
+          "tenants": {
+            "unknown": 2
+          },
+          "users": {
+            "unknown": 2
+          },
+          "components": {
+            "state-hub.mcp": 2
+          }
+        },
+        "window": {
+          "calls": 0,
+          "tenant_count": 0,
+          "user_count": 0,
+          "component_count": 0,
+          "tenants": {},
+          "users": {},
+          "components": {}
+        },
+        "last_seen_at": "2026-07-10T13:20:42.374940Z",
+        "retirement_candidate": true,
+        "retirement_reason": "no measured usage in review window"
+      },
+      {
+        "interface": {
+          "id": "53c3372b-307d-4d6a-8ea4-bc36cacdcaf2",
+          "interface_key": "mcp:update_workstream",
+          "interface_kind": "mcp_tool",
+          "legacy_since": "2026-07-10T13:19:44.255216Z",
+          "replacement_ref": "update_workplan",
+          "owner_component": "state-hub.mcp",
+          "status": "legacy",
+          "replacement_verified": true,
+          "manual_hold": false,
+          "hold_reason": null,
+          "notes": "Registered by STATE-WP-0070 T03 \u2014 zero-window streak starts at registration",
+          "retired_at": null,
+          "created_at": "2026-07-10T13:19:44.255216Z",
+          "updated_at": "2026-07-10T13:19:44.255216Z"
+        },
+        "all_time": {
+          "calls": 0,
+          "tenant_count": 0,
+          "user_count": 0,
+          "component_count": 0,
+          "tenants": {},
+          "users": {},
+          "components": {}
+        },
+        "window": {
+          "calls": 0,
+          "tenant_count": 0,
+          "user_count": 0,
+          "component_count": 0,
+          "tenants": {},
+          "users": {},
+          "components": {}
+        },
+        "last_seen_at": null,
+        "retirement_candidate": true,
+        "retirement_reason": "no measured usage in review window"
+      },
+      {
+        "interface": {
+          "id": "bed4d08a-3471-48f5-9f0e-f9d550383a26",
+          "interface_key": "mcp:update_workstream_status",
+          "interface_kind": "mcp_tool",
+          "legacy_since": "2026-07-10T13:19:44.303612Z",
+          "replacement_ref": "update_workplan_status",
+          "owner_component": "state-hub.mcp",
+          "status": "legacy",
+          "replacement_verified": true,
+          "manual_hold": false,
+          "hold_reason": null,
+          "notes": "Registered by STATE-WP-0070 T03 \u2014 zero-window streak starts at registration",
+          "retired_at": null,
+          "created_at": "2026-07-10T13:19:44.303612Z",
+          "updated_at": "2026-07-10T13:19:44.303612Z"
+        },
+        "all_time": {
+          "calls": 0,
+          "tenant_count": 0,
+          "user_count": 0,
+          "component_count": 0,
+          "tenants": {},
+          "users": {},
+          "components": {}
+        },
+        "window": {
+          "calls": 0,
+          "tenant_count": 0,
+          "user_count": 0,
+          "component_count": 0,
+          "tenants": {},
+          "users": {},
+          "components": {}
+        },
+        "last_seen_at": null,
+        "retirement_candidate": true,
+        "retirement_reason": "no measured usage in review window"
+      },
+      {
+        "interface": {
+          "id": "46900dc2-0893-405b-ba59-80f31fb6ebb1",
+          "interface_key": "state://workstreams/{topic_slug}",
+          "interface_kind": "mcp_tool",
+          "legacy_since": "2026-07-10T13:19:44.344493Z",
+          "replacement_ref": "state://workplans/{topic_slug}",
+          "owner_component": "state-hub.mcp",
+          "status": "legacy",
+          "replacement_verified": true,
+          "manual_hold": false,
+          "hold_reason": null,
+          "notes": "Registered by STATE-WP-0070 T03 \u2014 zero-window streak starts at registration",
+          "retired_at": null,
+          "created_at": "2026-07-10T13:19:44.344493Z",
+          "updated_at": "2026-07-10T13:19:44.344493Z"
+        },
+        "all_time": {
+          "calls": 1,
+          "tenant_count": 1,
+          "user_count": 1,
+          "component_count": 1,
+          "tenants": {
+            "unknown": 1
+          },
+          "users": {
+            "unknown": 1
+          },
+          "components": {
+            "state-hub.mcp": 1
+          }
+        },
+        "window": {
+          "calls": 0,
+          "tenant_count": 0,
+          "user_count": 0,
+          "component_count": 0,
+          "tenants": {},
+          "users": {},
+          "components": {}
+        },
+        "last_seen_at": "2026-07-10T13:20:34.491811Z",
+        "retirement_candidate": true,
+        "retirement_reason": "no measured usage in review window"
+      },
+      {
+        "interface": {
+          "id": "cd9342fd-27e7-4a46-a1be-d41499e106a3",
+          "interface_key": "rest_api:DELETE /workstreams/{workstream_id}",
+          "interface_kind": "rest_api",
+          "legacy_since": "2026-06-06T17:28:13.052813Z",
+          "replacement_ref": "/workplans/{workplan_id}",
+          "owner_component": "state-hub.api",
+          "status": "legacy",
+          "replacement_verified": true,
+          "manual_hold": false,
+          "hold_reason": null,
+          "notes": null,
+          "retired_at": null,
+          "created_at": "2026-06-06T17:28:13.052813Z",
+          "updated_at": "2026-06-06T17:28:13.052813Z"
+        },
+        "all_time": {
+          "calls": 1,
+          "tenant_count": 1,
+          "user_count": 1,
+          "component_count": 1,
+          "tenants": {
+            "unknown": 1
+          },
+          "users": {
+            "unknown": 1
+          },
+          "components": {
+            "unknown": 1
+          }
+        },
+        "window": {
+          "calls": 0,
+          "tenant_count": 0,
+          "user_count": 0,
+          "component_count": 0,
+          "tenants": {},
+          "users": {},
+          "components": {}
+        },
+        "last_seen_at": "2026-06-06T17:28:13.047529Z",
+        "retirement_candidate": true,
+        "retirement_reason": "no measured usage in review window"
+      },
+      {
+        "interface": {
+          "id": "a4e0948c-cd4a-461e-8ae2-7fd7b51d04a7",
+          "interface_key": "rest_api:GET /decisions/?workstream_id",
+          "interface_kind": "rest_api",
+          "legacy_since": "2026-07-09T23:07:53.093223Z",
+          "replacement_ref": "/decisions/?workplan_id=<workplan_id>",
+          "owner_component": "state-hub.api",
+          "status": "legacy",
+          "replacement_verified": true,
+          "manual_hold": false,
+          "hold_reason": null,
+          "notes": null,
+          "retired_at": null,
+          "created_at": "2026-07-09T23:07:53.093223Z",
+          "updated_at": "2026-07-09T23:07:53.093223Z"
+        },
+        "all_time": {
+          "calls": 1,
+          "tenant_count": 1,
+          "user_count": 1,
+          "component_count": 1,
+          "tenants": {
+            "unknown": 1
+          },
+          "users": {
+            "unknown": 1
+          },
+          "components": {
+            "unknown": 1
+          }
+        },
+        "window": {
+          "calls": 0,
+          "tenant_count": 0,
+          "user_count": 0,
+          "component_count": 0,
+          "tenants": {},
+          "users": {},
+          "components": {}
+        },
+        "last_seen_at": "2026-07-09T23:07:53.083299Z",
+        "retirement_candidate": true,
+        "retirement_reason": "no measured usage in review window"
+      },
+      {
+        "interface": {
+          "id": "70a9346e-e0ee-42ac-874f-f160580b54dd",
+          "interface_key": "rest_api:GET /progress/?workstream_id",
+          "interface_kind": "rest_api",
+          "legacy_since": "2026-07-13T22:04:03.911449Z",
+          "replacement_ref": "/progress/?workplan_id=<workplan_id>",
+          "owner_component": "state-hub.api",
+          "status": "legacy",
+          "replacement_verified": true,
+          "manual_hold": false,
+          "hold_reason": null,
+          "notes": null,
+          "retired_at": null,
+          "created_at": "2026-07-13T22:04:03.911449Z",
+          "updated_at": "2026-07-13T22:04:03.911449Z"
+        },
+        "all_time": {
+          "calls": 1,
+          "tenant_count": 1,
+          "user_count": 1,
+          "component_count": 1,
+          "tenants": {
+            "unknown": 1
+          },
+          "users": {
+            "unknown": 1
+          },
+          "components": {
+            "unknown": 1
+          }
+        },
+        "window": {
+          "calls": 0,
+          "tenant_count": 0,
+          "user_count": 0,
+          "component_count": 0,
+          "tenants": {},
+          "users": {},
+          "components": {}
+        },
+        "last_seen_at": "2026-07-13T22:04:03.904998Z",
+        "retirement_candidate": true,
+        "retirement_reason": "no measured usage in review window"
+      },
+      {
+        "interface": {
+          "id": "be3cdcf8-250b-4bf0-801f-02ffd5f57e00",
+          "interface_key": "rest_api:GET /tasks/?workstream_id",
+          "interface_kind": "rest_api",
+          "legacy_since": "2026-07-08T19:32:21.628513Z",
+          "replacement_ref": "/tasks/?workplan_id=<workplan_id>",
+          "owner_component": "state-hub.api",
+          "status": "legacy",
+          "replacement_verified": true,
+          "manual_hold": false,
+          "hold_reason": null,
+          "notes": null,
+          "retired_at": null,
+          "created_at": "2026-07-08T19:32:21.628513Z",
+          "updated_at": "2026-07-08T19:32:21.628513Z"
+        },
+        "all_time": {
+          "calls": 587,
+          "tenant_count": 1,
+          "user_count": 1,
+          "component_count": 1,
+          "tenants": {
+            "unknown": 587
+          },
+          "users": {
+            "unknown": 587
+          },
+          "components": {
+            "unknown": 587
+          }
+        },
+        "window": {
+          "calls": 3,
+          "tenant_count": 1,
+          "user_count": 1,
+          "component_count": 1,
+          "tenants": {
+            "unknown": 3
+          },
+          "users": {
+            "unknown": 3
+          },
+          "components": {
+            "unknown": 3
+          }
+        },
+        "last_seen_at": "2026-07-22T13:21:12.171828Z",
+        "retirement_candidate": false,
+        "retirement_reason": "3 call(s) in review window"
+      },
+      {
+        "interface": {
+          "id": "3e4a3d0b-08fa-45c3-91e2-4f514a914b97",
+          "interface_key": "rest_api:GET /workstreams/",
+          "interface_kind": "rest_api",
+          "legacy_since": "2026-06-04T00:26:14.533764Z",
+          "replacement_ref": "/workplans/",
+          "owner_component": "state-hub.api",
+          "status": "legacy",
+          "replacement_verified": true,
+          "manual_hold": false,
+          "hold_reason": null,
+          "notes": null,
+          "retired_at": null,
+          "created_at": "2026-06-04T00:26:14.533764Z",
+          "updated_at": "2026-06-04T00:26:14.533764Z"
+        },
+        "all_time": {
+          "calls": 144084,
+          "tenant_count": 1,
+          "user_count": 1,
+          "component_count": 1,
+          "tenants": {
+            "unknown": 144084
+          },
+          "users": {
+            "unknown": 144084
+          },
+          "components": {
+            "unknown": 144084
+          }
+        },
+        "window": {
+          "calls": 0,
+          "tenant_count": 0,
+          "user_count": 0,
+          "component_count": 0,
+          "tenants": {},
+          "users": {},
+          "components": {}
+        },
+        "last_seen_at": "2026-07-08T21:14:39.652776Z",
+        "retirement_candidate": true,
+        "retirement_reason": "no measured usage in review window"
+      },
+      {
+        "interface": {
+          "id": "e4c140ec-7479-46f9-b185-4b533f19d639",
+          "interface_key": "rest_api:GET /workstreams/workplan-index",
+          "interface_kind": "rest_api",
+          "legacy_since": "2026-06-04T05:20:58.321869Z",
+          "replacement_ref": "/workplans/index",
+          "owner_component": "state-hub.api",
+          "status": "legacy",
+          "replacement_verified": true,
+          "manual_hold": false,
+          "hold_reason": null,
+          "notes": null,
+          "retired_at": null,
+          "created_at": "2026-06-04T05:20:58.321869Z",
+          "updated_at": "2026-06-04T05:20:58.321869Z"
+        },
+        "all_time": {
+          "calls": 30,
+          "tenant_count": 1,
+          "user_count": 1,
+          "component_count": 1,
+          "tenants": {
+            "unknown": 30
+          },
+          "users": {
+            "unknown": 30
+          },
+          "components": {
+            "unknown": 30
+          }
+        },
+        "window": {
+          "calls": 0,
+          "tenant_count": 0,
+          "user_count": 0,
+          "component_count": 0,
+          "tenants": {},
+          "users": {},
+          "components": {}
+        },
+        "last_seen_at": "2026-07-03T05:20:34.534439Z",
+        "retirement_candidate": true,
+        "retirement_reason": "no measured usage in review window"
+      },
+      {
+        "interface": {
+          "id": "3a00b19e-e7db-4403-98aa-a77c9ab61ecc",
+          "interface_key": "rest_api:GET /workstreams/{workstream_id}",
+          "interface_kind": "rest_api",
+          "legacy_since": "2026-06-04T00:25:59.014966Z",
+          "replacement_ref": "/workplans/{workplan_id}",
+          "owner_component": "state-hub.api",
+          "status": "legacy",
+          "replacement_verified": true,
+          "manual_hold": false,
+          "hold_reason": null,
+          "notes": null,
+          "retired_at": null,
+          "created_at": "2026-06-04T00:25:59.014966Z",
+          "updated_at": "2026-06-04T00:25:59.014966Z"
+        },
+        "all_time": {
+          "calls": 511405,
+          "tenant_count": 1,
+          "user_count": 1,
+          "component_count": 1,
+          "tenants": {
+            "unknown": 511405
+          },
+          "users": {
+            "unknown": 511405
+          },
+          "components": {
+            "unknown": 511405
+          }
+        },
+        "window": {
+          "calls": 0,
+          "tenant_count": 0,
+          "user_count": 0,
+          "component_count": 0,
+          "tenants": {},
+          "users": {},
+          "components": {}
+        },
+        "last_seen_at": "2026-07-08T21:14:20.781103Z",
+        "retirement_candidate": true,
+        "retirement_reason": "no measured usage in review window"
+      },
+      {
+        "interface": {
+          "id": "69e1a255-a8b9-4101-8a68-b1bed23abfda",
+          "interface_key": "rest_api:GET /workstreams/{workstream_id}/dependencies/",
+          "interface_kind": "rest_api",
+          "legacy_since": "2026-06-04T00:25:59.291135Z",
+          "replacement_ref": "/workplans/{workplan_id}/dependencies/",
+          "owner_component": "state-hub.api",
+          "status": "legacy",
+          "replacement_verified": true,
+          "manual_hold": false,
+          "hold_reason": null,
+          "notes": null,
+          "retired_at": null,
+          "created_at": "2026-06-04T00:25:59.291135Z",
+          "updated_at": "2026-06-04T00:25:59.291135Z"
+        },
+        "all_time": {
+          "calls": 255865,
+          "tenant_count": 1,
+          "user_count": 1,
+          "component_count": 1,
+          "tenants": {
+            "unknown": 255865
+          },
+          "users": {
+            "unknown": 255865
+          },
+          "components": {
+            "unknown": 255865
+          }
+        },
+        "window": {
+          "calls": 0,
+          "tenant_count": 0,
+          "user_count": 0,
+          "component_count": 0,
+          "tenants": {},
+          "users": {},
+          "components": {}
+        },
+        "last_seen_at": "2026-07-08T21:14:12.747005Z",
+        "retirement_candidate": true,
+        "retirement_reason": "no measured usage in review window"
+      },
+      {
+        "interface": {
+          "id": "b1aae931-b51f-4a85-a723-865dd65f6132",
+          "interface_key": "rest_api:PATCH /workstreams/{workstream_id}",
+          "interface_kind": "rest_api",
+          "legacy_since": "2026-06-04T06:09:41.901035Z",
+          "replacement_ref": "/workplans/{workplan_id}",
+          "owner_component": "state-hub.api",
+          "status": "legacy",
+          "replacement_verified": true,
+          "manual_hold": false,
+          "hold_reason": null,
+          "notes": null,
+          "retired_at": null,
+          "created_at": "2026-06-04T06:09:41.901035Z",
+          "updated_at": "2026-06-04T06:09:41.901035Z"
+        },
+        "all_time": {
+          "calls": 571,
+          "tenant_count": 1,
+          "user_count": 1,
+          "component_count": 1,
+          "tenants": {
+            "unknown": 571
+          },
+          "users": {
+            "unknown": 571
+          },
+          "components": {
+            "unknown": 571
+          }
+        },
+        "window": {
+          "calls": 0,
+          "tenant_count": 0,
+          "user_count": 0,
+          "component_count": 0,
+          "tenants": {},
+          "users": {},
+          "components": {}
+        },
+        "last_seen_at": "2026-07-08T20:49:12.335710Z",
+        "retirement_candidate": true,
+        "retirement_reason": "no measured usage in review window"
+      },
+      {
+        "interface": {
+          "id": "4aea9591-970b-4918-ac4a-4da95a0a1a8c",
+          "interface_key": "rest_api:POST /decisions/ workstream_id",
+          "interface_kind": "rest_api",
+          "legacy_since": "2026-07-09T22:56:35.473130Z",
+          "replacement_ref": "POST /decisions/ with workplan_id",
+          "owner_component": "state-hub.api",
+          "status": "legacy",
+          "replacement_verified": true,
+          "manual_hold": false,
+          "hold_reason": null,
+          "notes": null,
+          "retired_at": null,
+          "created_at": "2026-07-09T22:56:35.473130Z",
+          "updated_at": "2026-07-09T22:56:35.473130Z"
+        },
+        "all_time": {
+          "calls": 3,
+          "tenant_count": 1,
+          "user_count": 1,
+          "component_count": 1,
+          "tenants": {
+            "unknown": 3
+          },
+          "users": {
+            "unknown": 3
+          },
+          "components": {
+            "unknown": 3
+          }
+        },
+        "window": {
+          "calls": 0,
+          "tenant_count": 0,
+          "user_count": 0,
+          "component_count": 0,
+          "tenants": {},
+          "users": {},
+          "components": {}
+        },
+        "last_seen_at": "2026-07-09T22:57:05.912456Z",
+        "retirement_candidate": true,
+        "retirement_reason": "no measured usage in review window"
+      },
+      {
+        "interface": {
+          "id": "4a70583c-1e41-4ec1-99a9-728856a7d79c",
+          "interface_key": "rest_api:POST /progress/ workstream_id",
+          "interface_kind": "rest_api",
+          "legacy_since": "2026-07-08T23:35:09.148333Z",
+          "replacement_ref": "POST /progress/ with workplan_id",
+          "owner_component": "state-hub.api",
+          "status": "legacy",
+          "replacement_verified": true,
+          "manual_hold": false,
+          "hold_reason": null,
+          "notes": null,
+          "retired_at": null,
+          "created_at": "2026-07-08T23:35:09.148333Z",
+          "updated_at": "2026-07-08T23:35:09.148333Z"
+        },
+        "all_time": {
+          "calls": 14,
+          "tenant_count": 1,
+          "user_count": 1,
+          "component_count": 1,
+          "tenants": {
+            "unknown": 14
+          },
+          "users": {
+            "unknown": 14
+          },
+          "components": {
+            "unknown": 14
+          }
+        },
+        "window": {
+          "calls": 0,
+          "tenant_count": 0,
+          "user_count": 0,
+          "component_count": 0,
+          "tenants": {},
+          "users": {},
+          "components": {}
+        },
+        "last_seen_at": "2026-07-10T08:34:42.959724Z",
+        "retirement_candidate": true,
+        "retirement_reason": "no measured usage in review window"
+      },
+      {
+        "interface": {
+          "id": "6df4e443-7bf1-461a-923b-a6eb52fe7b07",
+          "interface_key": "rest_api:POST /tasks/ workstream_id",
+          "interface_kind": "rest_api",
+          "legacy_since": "2026-07-08T22:38:29.405720Z",
+          "replacement_ref": "POST /tasks/ with workplan_id",
+          "owner_component": "state-hub.api",
+          "status": "legacy",
+          "replacement_verified": true,
+          "manual_hold": false,
+          "hold_reason": null,
+          "notes": null,
+          "retired_at": null,
+          "created_at": "2026-07-08T22:38:29.405720Z",
+          "updated_at": "2026-07-08T22:38:29.405720Z"
+        },
+        "all_time": {
+          "calls": 5,
+          "tenant_count": 1,
+          "user_count": 1,
+          "component_count": 1,
+          "tenants": {
+            "unknown": 5
+          },
+          "users": {
+            "unknown": 5
+          },
+          "components": {
+            "state-hub.fix-consistency": 5
+          }
+        },
+        "window": {
+          "calls": 0,
+          "tenant_count": 0,
+          "user_count": 0,
+          "component_count": 0,
+          "tenants": {},
+          "users": {},
+          "components": {}
+        },
+        "last_seen_at": "2026-07-08T22:38:29.976918Z",
+        "retirement_candidate": true,
+        "retirement_reason": "no measured usage in review window"
+      },
+      {
+        "interface": {
+          "id": "ed6451c9-d2cc-4486-9afe-d3852782cabc",
+          "interface_key": "rest_api:POST /workstreams/",
+          "interface_kind": "rest_api",
+          "legacy_since": "2026-06-04T07:40:24.168535Z",
+          "replacement_ref": "/workplans/",
+          "owner_component": "state-hub.api",
+          "status": "legacy",
+          "replacement_verified": true,
+          "manual_hold": false,
+          "hold_reason": null,
+          "notes": null,
+          "retired_at": null,
+          "created_at": "2026-06-04T07:40:24.168535Z",
+          "updated_at": "2026-06-04T07:40:24.168535Z"
+        },
+        "all_time": {
+          "calls": 824,
+          "tenant_count": 1,
+          "user_count": 1,
+          "component_count": 1,
+          "tenants": {
+            "unknown": 824
+          },
+          "users": {
+            "unknown": 824
+          },
+          "components": {
+            "unknown": 824
+          }
+        },
+        "window": {
+          "calls": 0,
+          "tenant_count": 0,
+          "user_count": 0,
+          "component_count": 0,
+          "tenants": {},
+          "users": {},
+          "components": {}
+        },
+        "last_seen_at": "2026-07-08T20:38:05.903144Z",
+        "retirement_candidate": true,
+        "retirement_reason": "no measured usage in review window"
+      },
+      {
+        "interface": {
+          "id": "281fd706-b192-4194-8055-2d8733c115f9",
+          "interface_key": "rest_api:POST /workstreams/{workstream_id}/dependencies/",
+          "interface_kind": "rest_api",
+          "legacy_since": "2026-06-04T22:57:37.149207Z",
+          "replacement_ref": "/workplans/{workplan_id}/dependencies/",
+          "owner_component": "state-hub.api",
+          "status": "legacy",
+          "replacement_verified": true,
+          "manual_hold": false,
+          "hold_reason": null,
+          "notes": null,
+          "retired_at": null,
+          "created_at": "2026-06-04T22:57:37.149207Z",
+          "updated_at": "2026-06-04T22:57:37.149207Z"
+        },
+        "all_time": {
+          "calls": 4971,
+          "tenant_count": 1,
+          "user_count": 1,
+          "component_count": 1,
+          "tenants": {
+            "unknown": 4971
+          },
+          "users": {
+            "unknown": 4971
+          },
+          "components": {
+            "unknown": 4971
+          }
+        },
+        "window": {
+          "calls": 0,
+          "tenant_count": 0,
+          "user_count": 0,
+          "component_count": 0,
+          "tenants": {},
+          "users": {},
+          "components": {}
+        },
+        "last_seen_at": "2026-07-01T22:09:24.229011Z",
+        "retirement_candidate": true,
+        "retirement_reason": "no measured usage in review window"
+      }
+    ],
+    "retirement_candidates": [
+      {
+        "interface": {
+          "id": "63ed90e3-42b4-431a-94db-e1254a52f9e2",
+          "interface_key": "mcp:create_workstream",
+          "interface_kind": "mcp_tool",
+          "legacy_since": "2026-07-10T13:19:44.205900Z",
+          "replacement_ref": "create_workplan",
+          "owner_component": "state-hub.mcp",
+          "status": "legacy",
+          "replacement_verified": true,
+          "manual_hold": false,
+          "hold_reason": null,
+          "notes": "Registered by STATE-WP-0070 T03 \u2014 zero-window streak starts at registration",
+          "retired_at": null,
+          "created_at": "2026-07-10T13:19:44.205900Z",
+          "updated_at": "2026-07-10T13:19:44.205900Z"
+        },
+        "all_time": {
+          "calls": 2,
+          "tenant_count": 1,
+          "user_count": 1,
+          "component_count": 1,
+          "tenants": {
+            "unknown": 2
+          },
+          "users": {
+            "unknown": 2
+          },
+          "components": {
+            "state-hub.mcp": 2
+          }
+        },
+        "window": {
+          "calls": 0,
+          "tenant_count": 0,
+          "user_count": 0,
+          "component_count": 0,
+          "tenants": {},
+          "users": {},
+          "components": {}
+        },
+        "last_seen_at": "2026-07-10T13:20:43.378546Z",
+        "retirement_candidate": true,
+        "retirement_reason": "no measured usage in review window"
+      },
+      {
+        "interface": {
+          "id": "b6a5fe44-fb85-4ef7-a273-78d09da777af",
+          "interface_key": "mcp:list_workstreams",
+          "interface_kind": "mcp_tool",
+          "legacy_since": "2026-07-10T13:19:26.075491Z",
+          "replacement_ref": "list_workplans",
+          "owner_component": "state-hub.mcp",
+          "status": "legacy",
+          "replacement_verified": true,
+          "manual_hold": false,
+          "hold_reason": null,
+          "notes": null,
+          "retired_at": null,
+          "created_at": "2026-07-10T13:19:26.075491Z",
+          "updated_at": "2026-07-10T13:19:26.075491Z"
+        },
+        "all_time": {
+          "calls": 2,
+          "tenant_count": 1,
+          "user_count": 1,
+          "component_count": 1,
+          "tenants": {
+            "unknown": 2
+          },
+          "users": {
+            "unknown": 2
+          },
+          "components": {
+            "state-hub.mcp": 2
+          }
+        },
+        "window": {
+          "calls": 0,
+          "tenant_count": 0,
+          "user_count": 0,
+          "component_count": 0,
+          "tenants": {},
+          "users": {},
+          "components": {}
+        },
+        "last_seen_at": "2026-07-10T13:20:42.374940Z",
+        "retirement_candidate": true,
+        "retirement_reason": "no measured usage in review window"
+      },
+      {
+        "interface": {
+          "id": "53c3372b-307d-4d6a-8ea4-bc36cacdcaf2",
+          "interface_key": "mcp:update_workstream",
+          "interface_kind": "mcp_tool",
+          "legacy_since": "2026-07-10T13:19:44.255216Z",
+          "replacement_ref": "update_workplan",
+          "owner_component": "state-hub.mcp",
+          "status": "legacy",
+          "replacement_verified": true,
+          "manual_hold": false,
+          "hold_reason": null,
+          "notes": "Registered by STATE-WP-0070 T03 \u2014 zero-window streak starts at registration",
+          "retired_at": null,
+          "created_at": "2026-07-10T13:19:44.255216Z",
+          "updated_at": "2026-07-10T13:19:44.255216Z"
+        },
+        "all_time": {
+          "calls": 0,
+          "tenant_count": 0,
+          "user_count": 0,
+          "component_count": 0,
+          "tenants": {},
+          "users": {},
+          "components": {}
+        },
+        "window": {
+          "calls": 0,
+          "tenant_count": 0,
+          "user_count": 0,
+          "component_count": 0,
+          "tenants": {},
+          "users": {},
+          "components": {}
+        },
+        "last_seen_at": null,
+        "retirement_candidate": true,
+        "retirement_reason": "no measured usage in review window"
+      },
+      {
+        "interface": {
+          "id": "bed4d08a-3471-48f5-9f0e-f9d550383a26",
+          "interface_key": "mcp:update_workstream_status",
+          "interface_kind": "mcp_tool",
+          "legacy_since": "2026-07-10T13:19:44.303612Z",
+          "replacement_ref": "update_workplan_status",
+          "owner_component": "state-hub.mcp",
+          "status": "legacy",
+          "replacement_verified": true,
+          "manual_hold": false,
+          "hold_reason": null,
+          "notes": "Registered by STATE-WP-0070 T03 \u2014 zero-window streak starts at registration",
+          "retired_at": null,
+          "created_at": "2026-07-10T13:19:44.303612Z",
+          "updated_at": "2026-07-10T13:19:44.303612Z"
+        },
+        "all_time": {
+          "calls": 0,
+          "tenant_count": 0,
+          "user_count": 0,
+          "component_count": 0,
+          "tenants": {},
+          "users": {},
+          "components": {}
+        },
+        "window": {
+          "calls": 0,
+          "tenant_count": 0,
+          "user_count": 0,
+          "component_count": 0,
+          "tenants": {},
+          "users": {},
+          "components": {}
+        },
+        "last_seen_at": null,
+        "retirement_candidate": true,
+        "retirement_reason": "no measured usage in review window"
+      },
+      {
+        "interface": {
+          "id": "46900dc2-0893-405b-ba59-80f31fb6ebb1",
+          "interface_key": "state://workstreams/{topic_slug}",
+          "interface_kind": "mcp_tool",
+          "legacy_since": "2026-07-10T13:19:44.344493Z",
+          "replacement_ref": "state://workplans/{topic_slug}",
+          "owner_component": "state-hub.mcp",
+          "status": "legacy",
+          "replacement_verified": true,
+          "manual_hold": false,
+          "hold_reason": null,
+          "notes": "Registered by STATE-WP-0070 T03 \u2014 zero-window streak starts at registration",
+          "retired_at": null,
+          "created_at": "2026-07-10T13:19:44.344493Z",
+          "updated_at": "2026-07-10T13:19:44.344493Z"
+        },
+        "all_time": {
+          "calls": 1,
+          "tenant_count": 1,
+          "user_count": 1,
+          "component_count": 1,
+          "tenants": {
+            "unknown": 1
+          },
+          "users": {
+            "unknown": 1
+          },
+          "components": {
+            "state-hub.mcp": 1
+          }
+        },
+        "window": {
+          "calls": 0,
+          "tenant_count": 0,
+          "user_count": 0,
+          "component_count": 0,
+          "tenants": {},
+          "users": {},
+          "components": {}
+        },
+        "last_seen_at": "2026-07-10T13:20:34.491811Z",
+        "retirement_candidate": true,
+        "retirement_reason": "no measured usage in review window"
+      },
+      {
+        "interface": {
+          "id": "cd9342fd-27e7-4a46-a1be-d41499e106a3",
+          "interface_key": "rest_api:DELETE /workstreams/{workstream_id}",
+          "interface_kind": "rest_api",
+          "legacy_since": "2026-06-06T17:28:13.052813Z",
+          "replacement_ref": "/workplans/{workplan_id}",
+          "owner_component": "state-hub.api",
+          "status": "legacy",
+          "replacement_verified": true,
+          "manual_hold": false,
+          "hold_reason": null,
+          "notes": null,
+          "retired_at": null,
+          "created_at": "2026-06-06T17:28:13.052813Z",
+          "updated_at": "2026-06-06T17:28:13.052813Z"
+        },
+        "all_time": {
+          "calls": 1,
+          "tenant_count": 1,
+          "user_count": 1,
+          "component_count": 1,
+          "tenants": {
+            "unknown": 1
+          },
+          "users": {
+            "unknown": 1
+          },
+          "components": {
+            "unknown": 1
+          }
+        },
+        "window": {
+          "calls": 0,
+          "tenant_count": 0,
+          "user_count": 0,
+          "component_count": 0,
+          "tenants": {},
+          "users": {},
+          "components": {}
+        },
+        "last_seen_at": "2026-06-06T17:28:13.047529Z",
+        "retirement_candidate": true,
+        "retirement_reason": "no measured usage in review window"
+      },
+      {
+        "interface": {
+          "id": "a4e0948c-cd4a-461e-8ae2-7fd7b51d04a7",
+          "interface_key": "rest_api:GET /decisions/?workstream_id",
+          "interface_kind": "rest_api",
+          "legacy_since": "2026-07-09T23:07:53.093223Z",
+          "replacement_ref": "/decisions/?workplan_id=<workplan_id>",
+          "owner_component": "state-hub.api",
+          "status": "legacy",
+          "replacement_verified": true,
+          "manual_hold": false,
+          "hold_reason": null,
+          "notes": null,
+          "retired_at": null,
+          "created_at": "2026-07-09T23:07:53.093223Z",
+          "updated_at": "2026-07-09T23:07:53.093223Z"
+        },
+        "all_time": {
+          "calls": 1,
+          "tenant_count": 1,
+          "user_count": 1,
+          "component_count": 1,
+          "tenants": {
+            "unknown": 1
+          },
+          "users": {
+            "unknown": 1
+          },
+          "components": {
+            "unknown": 1
+          }
+        },
+        "window": {
+          "calls": 0,
+          "tenant_count": 0,
+          "user_count": 0,
+          "component_count": 0,
+          "tenants": {},
+          "users": {},
+          "components": {}
+        },
+        "last_seen_at": "2026-07-09T23:07:53.083299Z",
+        "retirement_candidate": true,
+        "retirement_reason": "no measured usage in review window"
+      },
+      {
+        "interface": {
+          "id": "70a9346e-e0ee-42ac-874f-f160580b54dd",
+          "interface_key": "rest_api:GET /progress/?workstream_id",
+          "interface_kind": "rest_api",
+          "legacy_since": "2026-07-13T22:04:03.911449Z",
+          "replacement_ref": "/progress/?workplan_id=<workplan_id>",
+          "owner_component": "state-hub.api",
+          "status": "legacy",
+          "replacement_verified": true,
+          "manual_hold": false,
+          "hold_reason": null,
+          "notes": null,
+          "retired_at": null,
+          "created_at": "2026-07-13T22:04:03.911449Z",
+          "updated_at": "2026-07-13T22:04:03.911449Z"
+        },
+        "all_time": {
+          "calls": 1,
+          "tenant_count": 1,
+          "user_count": 1,
+          "component_count": 1,
+          "tenants": {
+            "unknown": 1
+          },
+          "users": {
+            "unknown": 1
+          },
+          "components": {
+            "unknown": 1
+          }
+        },
+        "window": {
+          "calls": 0,
+          "tenant_count": 0,
+          "user_count": 0,
+          "component_count": 0,
+          "tenants": {},
+          "users": {},
+          "components": {}
+        },
+        "last_seen_at": "2026-07-13T22:04:03.904998Z",
+        "retirement_candidate": true,
+        "retirement_reason": "no measured usage in review window"
+      },
+      {
+        "interface": {
+          "id": "3e4a3d0b-08fa-45c3-91e2-4f514a914b97",
+          "interface_key": "rest_api:GET /workstreams/",
+          "interface_kind": "rest_api",
+          "legacy_since": "2026-06-04T00:26:14.533764Z",
+          "replacement_ref": "/workplans/",
+          "owner_component": "state-hub.api",
+          "status": "legacy",
+          "replacement_verified": true,
+          "manual_hold": false,
+          "hold_reason": null,
+          "notes": null,
+          "retired_at": null,
+          "created_at": "2026-06-04T00:26:14.533764Z",
+          "updated_at": "2026-06-04T00:26:14.533764Z"
+        },
+        "all_time": {
+          "calls": 144084,
+          "tenant_count": 1,
+          "user_count": 1,
+          "component_count": 1,
+          "tenants": {
+            "unknown": 144084
+          },
+          "users": {
+            "unknown": 144084
+          },
+          "components": {
+            "unknown": 144084
+          }
+        },
+        "window": {
+          "calls": 0,
+          "tenant_count": 0,
+          "user_count": 0,
+          "component_count": 0,
+          "tenants": {},
+          "users": {},
+          "components": {}
+        },
+        "last_seen_at": "2026-07-08T21:14:39.652776Z",
+        "retirement_candidate": true,
+        "retirement_reason": "no measured usage in review window"
+      },
+      {
+        "interface": {
+          "id": "e4c140ec-7479-46f9-b185-4b533f19d639",
+          "interface_key": "rest_api:GET /workstreams/workplan-index",
+          "interface_kind": "rest_api",
+          "legacy_since": "2026-06-04T05:20:58.321869Z",
+          "replacement_ref": "/workplans/index",
+          "owner_component": "state-hub.api",
+          "status": "legacy",
+          "replacement_verified": true,
+          "manual_hold": false,
+          "hold_reason": null,
+          "notes": null,
+          "retired_at": null,
+          "created_at": "2026-06-04T05:20:58.321869Z",
+          "updated_at": "2026-06-04T05:20:58.321869Z"
+        },
+        "all_time": {
+          "calls": 30,
+          "tenant_count": 1,
+          "user_count": 1,
+          "component_count": 1,
+          "tenants": {
+            "unknown": 30
+          },
+          "users": {
+            "unknown": 30
+          },
+          "components": {
+            "unknown": 30
+          }
+        },
+        "window": {
+          "calls": 0,
+          "tenant_count": 0,
+          "user_count": 0,
+          "component_count": 0,
+          "tenants": {},
+          "users": {},
+          "components": {}
+        },
+        "last_seen_at": "2026-07-03T05:20:34.534439Z",
+        "retirement_candidate": true,
+        "retirement_reason": "no measured usage in review window"
+      },
+      {
+        "interface": {
+          "id": "3a00b19e-e7db-4403-98aa-a77c9ab61ecc",
+          "interface_key": "rest_api:GET /workstreams/{workstream_id}",
+          "interface_kind": "rest_api",
+          "legacy_since": "2026-06-04T00:25:59.014966Z",
+          "replacement_ref": "/workplans/{workplan_id}",
+          "owner_component": "state-hub.api",
+          "status": "legacy",
+          "replacement_verified": true,
+          "manual_hold": false,
+          "hold_reason": null,
+          "notes": null,
+          "retired_at": null,
+          "created_at": "2026-06-04T00:25:59.014966Z",
+          "updated_at": "2026-06-04T00:25:59.014966Z"
+        },
+        "all_time": {
+          "calls": 511405,
+          "tenant_count": 1,
+          "user_count": 1,
+          "component_count": 1,
+          "tenants": {
+            "unknown": 511405
+          },
+          "users": {
+            "unknown": 511405
+          },
+          "components": {
+            "unknown": 511405
+          }
+        },
+        "window": {
+          "calls": 0,
+          "tenant_count": 0,
+          "user_count": 0,
+          "component_count": 0,
+          "tenants": {},
+          "users": {},
+          "components": {}
+        },
+        "last_seen_at": "2026-07-08T21:14:20.781103Z",
+        "retirement_candidate": true,
+        "retirement_reason": "no measured usage in review window"
+      },
+      {
+        "interface": {
+          "id": "69e1a255-a8b9-4101-8a68-b1bed23abfda",
+          "interface_key": "rest_api:GET /workstreams/{workstream_id}/dependencies/",
+          "interface_kind": "rest_api",
+          "legacy_since": "2026-06-04T00:25:59.291135Z",
+          "replacement_ref": "/workplans/{workplan_id}/dependencies/",
+          "owner_component": "state-hub.api",
+          "status": "legacy",
+          "replacement_verified": true,
+          "manual_hold": false,
+          "hold_reason": null,
+          "notes": null,
+          "retired_at": null,
+          "created_at": "2026-06-04T00:25:59.291135Z",
+          "updated_at": "2026-06-04T00:25:59.291135Z"
+        },
+        "all_time": {
+          "calls": 255865,
+          "tenant_count": 1,
+          "user_count": 1,
+          "component_count": 1,
+          "tenants": {
+            "unknown": 255865
+          },
+          "users": {
+            "unknown": 255865
+          },
+          "components": {
+            "unknown": 255865
+          }
+        },
+        "window": {
+          "calls": 0,
+          "tenant_count": 0,
+          "user_count": 0,
+          "component_count": 0,
+          "tenants": {},
+          "users": {},
+          "components": {}
+        },
+        "last_seen_at": "2026-07-08T21:14:12.747005Z",
+        "retirement_candidate": true,
+        "retirement_reason": "no measured usage in review window"
+      },
+      {
+        "interface": {
+          "id": "b1aae931-b51f-4a85-a723-865dd65f6132",
+          "interface_key": "rest_api:PATCH /workstreams/{workstream_id}",
+          "interface_kind": "rest_api",
+          "legacy_since": "2026-06-04T06:09:41.901035Z",
+          "replacement_ref": "/workplans/{workplan_id}",
+          "owner_component": "state-hub.api",
+          "status": "legacy",
+          "replacement_verified": true,
+          "manual_hold": false,
+          "hold_reason": null,
+          "notes": null,
+          "retired_at": null,
+          "created_at": "2026-06-04T06:09:41.901035Z",
+          "updated_at": "2026-06-04T06:09:41.901035Z"
+        },
+        "all_time": {
+          "calls": 571,
+          "tenant_count": 1,
+          "user_count": 1,
+          "component_count": 1,
+          "tenants": {
+            "unknown": 571
+          },
+          "users": {
+            "unknown": 571
+          },
+          "components": {
+            "unknown": 571
+          }
+        },
+        "window": {
+          "calls": 0,
+          "tenant_count": 0,
+          "user_count": 0,
+          "component_count": 0,
+          "tenants": {},
+          "users": {},
+          "components": {}
+        },
+        "last_seen_at": "2026-07-08T20:49:12.335710Z",
+        "retirement_candidate": true,
+        "retirement_reason": "no measured usage in review window"
+      },
+      {
+        "interface": {
+          "id": "4aea9591-970b-4918-ac4a-4da95a0a1a8c",
+          "interface_key": "rest_api:POST /decisions/ workstream_id",
+          "interface_kind": "rest_api",
+          "legacy_since": "2026-07-09T22:56:35.473130Z",
+          "replacement_ref": "POST /decisions/ with workplan_id",
+          "owner_component": "state-hub.api",
+          "status": "legacy",
+          "replacement_verified": true,
+          "manual_hold": false,
+          "hold_reason": null,
+          "notes": null,
+          "retired_at": null,
+          "created_at": "2026-07-09T22:56:35.473130Z",
+          "updated_at": "2026-07-09T22:56:35.473130Z"
+        },
+        "all_time": {
+          "calls": 3,
+          "tenant_count": 1,
+          "user_count": 1,
+          "component_count": 1,
+          "tenants": {
+            "unknown": 3
+          },
+          "users": {
+            "unknown": 3
+          },
+          "components": {
+            "unknown": 3
+          }
+        },
+        "window": {
+          "calls": 0,
+          "tenant_count": 0,
+          "user_count": 0,
+          "component_count": 0,
+          "tenants": {},
+          "users": {},
+          "components": {}
+        },
+        "last_seen_at": "2026-07-09T22:57:05.912456Z",
+        "retirement_candidate": true,
+        "retirement_reason": "no measured usage in review window"
+      },
+      {
+        "interface": {
+          "id": "4a70583c-1e41-4ec1-99a9-728856a7d79c",
+          "interface_key": "rest_api:POST /progress/ workstream_id",
+          "interface_kind": "rest_api",
+          "legacy_since": "2026-07-08T23:35:09.148333Z",
+          "replacement_ref": "POST /progress/ with workplan_id",
+          "owner_component": "state-hub.api",
+          "status": "legacy",
+          "replacement_verified": true,
+          "manual_hold": false,
+          "hold_reason": null,
+          "notes": null,
+          "retired_at": null,
+          "created_at": "2026-07-08T23:35:09.148333Z",
+          "updated_at": "2026-07-08T23:35:09.148333Z"
+        },
+        "all_time": {
+          "calls": 14,
+          "tenant_count": 1,
+          "user_count": 1,
+          "component_count": 1,
+          "tenants": {
+            "unknown": 14
+          },
+          "users": {
+            "unknown": 14
+          },
+          "components": {
+            "unknown": 14
+          }
+        },
+        "window": {
+          "calls": 0,
+          "tenant_count": 0,
+          "user_count": 0,
+          "component_count": 0,
+          "tenants": {},
+          "users": {},
+          "components": {}
+        },
+        "last_seen_at": "2026-07-10T08:34:42.959724Z",
+        "retirement_candidate": true,
+        "retirement_reason": "no measured usage in review window"
+      },
+      {
+        "interface": {
+          "id": "6df4e443-7bf1-461a-923b-a6eb52fe7b07",
+          "interface_key": "rest_api:POST /tasks/ workstream_id",
+          "interface_kind": "rest_api",
+          "legacy_since": "2026-07-08T22:38:29.405720Z",
+          "replacement_ref": "POST /tasks/ with workplan_id",
+          "owner_component": "state-hub.api",
+          "status": "legacy",
+          "replacement_verified": true,
+          "manual_hold": false,
+          "hold_reason": null,
+          "notes": null,
+          "retired_at": null,
+          "created_at": "2026-07-08T22:38:29.405720Z",
+          "updated_at": "2026-07-08T22:38:29.405720Z"
+        },
+        "all_time": {
+          "calls": 5,
+          "tenant_count": 1,
+          "user_count": 1,
+          "component_count": 1,
+          "tenants": {
+            "unknown": 5
+          },
+          "users": {
+            "unknown": 5
+          },
+          "components": {
+            "state-hub.fix-consistency": 5
+          }
+        },
+        "window": {
+          "calls": 0,
+          "tenant_count": 0,
+          "user_count": 0,
+          "component_count": 0,
+          "tenants": {},
+          "users": {},
+          "components": {}
+        },
+        "last_seen_at": "2026-07-08T22:38:29.976918Z",
+        "retirement_candidate": true,
+        "retirement_reason": "no measured usage in review window"
+      },
+      {
+        "interface": {
+          "id": "ed6451c9-d2cc-4486-9afe-d3852782cabc",
+          "interface_key": "rest_api:POST /workstreams/",
+          "interface_kind": "rest_api",
+          "legacy_since": "2026-06-04T07:40:24.168535Z",
+          "replacement_ref": "/workplans/",
+          "owner_component": "state-hub.api",
+          "status": "legacy",
+          "replacement_verified": true,
+          "manual_hold": false,
+          "hold_reason": null,
+          "notes": null,
+          "retired_at": null,
+          "created_at": "2026-06-04T07:40:24.168535Z",
+          "updated_at": "2026-06-04T07:40:24.168535Z"
+        },
+        "all_time": {
+          "calls": 824,
+          "tenant_count": 1,
+          "user_count": 1,
+          "component_count": 1,
+          "tenants": {
+            "unknown": 824
+          },
+          "users": {
+            "unknown": 824
+          },
+          "components": {
+            "unknown": 824
+          }
+        },
+        "window": {
+          "calls": 0,
+          "tenant_count": 0,
+          "user_count": 0,
+          "component_count": 0,
+          "tenants": {},
+          "users": {},
+          "components": {}
+        },
+        "last_seen_at": "2026-07-08T20:38:05.903144Z",
+        "retirement_candidate": true,
+        "retirement_reason": "no measured usage in review window"
+      },
+      {
+        "interface": {
+          "id": "281fd706-b192-4194-8055-2d8733c115f9",
+          "interface_key": "rest_api:POST /workstreams/{workstream_id}/dependencies/",
+          "interface_kind": "rest_api",
+          "legacy_since": "2026-06-04T22:57:37.149207Z",
+          "replacement_ref": "/workplans/{workplan_id}/dependencies/",
+          "owner_component": "state-hub.api",
+          "status": "legacy",
+          "replacement_verified": true,
+          "manual_hold": false,
+          "hold_reason": null,
+          "notes": null,
+          "retired_at": null,
+          "created_at": "2026-06-04T22:57:37.149207Z",
+          "updated_at": "2026-06-04T22:57:37.149207Z"
+        },
+        "all_time": {
+          "calls": 4971,
+          "tenant_count": 1,
+          "user_count": 1,
+          "component_count": 1,
+          "tenants": {
+            "unknown": 4971
+          },
+          "users": {
+            "unknown": 4971
+          },
+          "components": {
+            "unknown": 4971
+          }
+        },
+        "window": {
+          "calls": 0,
+          "tenant_count": 0,
+          "user_count": 0,
+          "component_count": 0,
+          "tenants": {},
+          "users": {},
+          "components": {}
+        },
+        "last_seen_at": "2026-07-01T22:09:24.229011Z",
+        "retirement_candidate": true,
+        "retirement_reason": "no measured usage in review window"
+      }
+    ]
+  },
+  "hours": 8
+}
diff --git a/docs/evidence/legacy-meter-weekly-review-20260723.json b/docs/evidence/legacy-meter-weekly-review-20260723.json
new file mode 100644
index 0000000..fd87ef2
--- /dev/null
+++ b/docs/evidence/legacy-meter-weekly-review-20260723.json
@@ -0,0 +1,1755 @@
+{
+  "captured_at": "2026-07-23T14:00:06.763729+00:00",
+  "api_base": "http://127.0.0.1:8000",
+  "workplan": "STATE-WP-0070",
+  "retired_interfaces": [],
+  "weekly_review": {
+    "generated_at": "2026-07-23T14:00:06.757894Z",
+    "window_start": "2026-07-23T06:00:06.691596Z",
+    "window_end": "2026-07-23T14:00:06.691596Z",
+    "cadence": "weekly",
+    "activity_core_handoff": {
+      "activity_id": "statehub-legacy-interface-review",
+      "cadence": "weekly",
+      "source_endpoint": "/legacy-meter/weekly-review",
+      "state_owner": "state-hub",
+      "scheduler_owner": "activity-core"
+    },
+    "interfaces": [
+      {
+        "interface": {
+          "id": "8051fb40-66c9-4dc4-a413-13e8573e04a3",
+          "interface_key": "event_subject:org.statehub.workstream.completed",
+          "interface_kind": "event_subject",
+          "legacy_since": "2026-06-04T06:09:42.198193Z",
+          "replacement_ref": "org.statehub.workplan.completed",
+          "owner_component": "state-hub.events",
+          "status": "retired",
+          "replacement_verified": true,
+          "manual_hold": false,
+          "hold_reason": null,
+          "notes": "Retired by STATE-WP-0069 closeout",
+          "retired_at": "2026-07-08T21:38:52.773601Z",
+          "created_at": "2026-06-04T06:09:42.198193Z",
+          "updated_at": "2026-07-08T21:38:52.761243Z"
+        },
+        "all_time": {
+          "calls": 255,
+          "tenant_count": 1,
+          "user_count": 1,
+          "component_count": 1,
+          "tenants": {
+            "unknown": 255
+          },
+          "users": {
+            "unknown": 255
+          },
+          "components": {
+            "state-hub.events": 255
+          }
+        },
+        "window": {
+          "calls": 0,
+          "tenant_count": 0,
+          "user_count": 0,
+          "component_count": 0,
+          "tenants": {},
+          "users": {},
+          "components": {}
+        },
+        "last_seen_at": "2026-07-08T20:49:12.839383Z",
+        "retirement_candidate": false,
+        "retirement_reason": "already retired"
+      },
+      {
+        "interface": {
+          "id": "63ed90e3-42b4-431a-94db-e1254a52f9e2",
+          "interface_key": "mcp:create_workstream",
+          "interface_kind": "mcp_tool",
+          "legacy_since": "2026-07-10T13:19:44.205900Z",
+          "replacement_ref": "create_workplan",
+          "owner_component": "state-hub.mcp",
+          "status": "legacy",
+          "replacement_verified": true,
+          "manual_hold": false,
+          "hold_reason": null,
+          "notes": "Registered by STATE-WP-0070 T03 \u2014 zero-window streak starts at registration",
+          "retired_at": null,
+          "created_at": "2026-07-10T13:19:44.205900Z",
+          "updated_at": "2026-07-10T13:19:44.205900Z"
+        },
+        "all_time": {
+          "calls": 2,
+          "tenant_count": 1,
+          "user_count": 1,
+          "component_count": 1,
+          "tenants": {
+            "unknown": 2
+          },
+          "users": {
+            "unknown": 2
+          },
+          "components": {
+            "state-hub.mcp": 2
+          }
+        },
+        "window": {
+          "calls": 0,
+          "tenant_count": 0,
+          "user_count": 0,
+          "component_count": 0,
+          "tenants": {},
+          "users": {},
+          "components": {}
+        },
+        "last_seen_at": "2026-07-10T13:20:43.378546Z",
+        "retirement_candidate": true,
+        "retirement_reason": "no measured usage in review window"
+      },
+      {
+        "interface": {
+          "id": "b6a5fe44-fb85-4ef7-a273-78d09da777af",
+          "interface_key": "mcp:list_workstreams",
+          "interface_kind": "mcp_tool",
+          "legacy_since": "2026-07-10T13:19:26.075491Z",
+          "replacement_ref": "list_workplans",
+          "owner_component": "state-hub.mcp",
+          "status": "legacy",
+          "replacement_verified": true,
+          "manual_hold": false,
+          "hold_reason": null,
+          "notes": null,
+          "retired_at": null,
+          "created_at": "2026-07-10T13:19:26.075491Z",
+          "updated_at": "2026-07-10T13:19:26.075491Z"
+        },
+        "all_time": {
+          "calls": 2,
+          "tenant_count": 1,
+          "user_count": 1,
+          "component_count": 1,
+          "tenants": {
+            "unknown": 2
+          },
+          "users": {
+            "unknown": 2
+          },
+          "components": {
+            "state-hub.mcp": 2
+          }
+        },
+        "window": {
+          "calls": 0,
+          "tenant_count": 0,
+          "user_count": 0,
+          "component_count": 0,
+          "tenants": {},
+          "users": {},
+          "components": {}
+        },
+        "last_seen_at": "2026-07-10T13:20:42.374940Z",
+        "retirement_candidate": true,
+        "retirement_reason": "no measured usage in review window"
+      },
+      {
+        "interface": {
+          "id": "53c3372b-307d-4d6a-8ea4-bc36cacdcaf2",
+          "interface_key": "mcp:update_workstream",
+          "interface_kind": "mcp_tool",
+          "legacy_since": "2026-07-10T13:19:44.255216Z",
+          "replacement_ref": "update_workplan",
+          "owner_component": "state-hub.mcp",
+          "status": "legacy",
+          "replacement_verified": true,
+          "manual_hold": false,
+          "hold_reason": null,
+          "notes": "Registered by STATE-WP-0070 T03 \u2014 zero-window streak starts at registration",
+          "retired_at": null,
+          "created_at": "2026-07-10T13:19:44.255216Z",
+          "updated_at": "2026-07-10T13:19:44.255216Z"
+        },
+        "all_time": {
+          "calls": 0,
+          "tenant_count": 0,
+          "user_count": 0,
+          "component_count": 0,
+          "tenants": {},
+          "users": {},
+          "components": {}
+        },
+        "window": {
+          "calls": 0,
+          "tenant_count": 0,
+          "user_count": 0,
+          "component_count": 0,
+          "tenants": {},
+          "users": {},
+          "components": {}
+        },
+        "last_seen_at": null,
+        "retirement_candidate": true,
+        "retirement_reason": "no measured usage in review window"
+      },
+      {
+        "interface": {
+          "id": "bed4d08a-3471-48f5-9f0e-f9d550383a26",
+          "interface_key": "mcp:update_workstream_status",
+          "interface_kind": "mcp_tool",
+          "legacy_since": "2026-07-10T13:19:44.303612Z",
+          "replacement_ref": "update_workplan_status",
+          "owner_component": "state-hub.mcp",
+          "status": "legacy",
+          "replacement_verified": true,
+          "manual_hold": false,
+          "hold_reason": null,
+          "notes": "Registered by STATE-WP-0070 T03 \u2014 zero-window streak starts at registration",
+          "retired_at": null,
+          "created_at": "2026-07-10T13:19:44.303612Z",
+          "updated_at": "2026-07-10T13:19:44.303612Z"
+        },
+        "all_time": {
+          "calls": 0,
+          "tenant_count": 0,
+          "user_count": 0,
+          "component_count": 0,
+          "tenants": {},
+          "users": {},
+          "components": {}
+        },
+        "window": {
+          "calls": 0,
+          "tenant_count": 0,
+          "user_count": 0,
+          "component_count": 0,
+          "tenants": {},
+          "users": {},
+          "components": {}
+        },
+        "last_seen_at": null,
+        "retirement_candidate": true,
+        "retirement_reason": "no measured usage in review window"
+      },
+      {
+        "interface": {
+          "id": "46900dc2-0893-405b-ba59-80f31fb6ebb1",
+          "interface_key": "state://workstreams/{topic_slug}",
+          "interface_kind": "mcp_tool",
+          "legacy_since": "2026-07-10T13:19:44.344493Z",
+          "replacement_ref": "state://workplans/{topic_slug}",
+          "owner_component": "state-hub.mcp",
+          "status": "legacy",
+          "replacement_verified": true,
+          "manual_hold": false,
+          "hold_reason": null,
+          "notes": "Registered by STATE-WP-0070 T03 \u2014 zero-window streak starts at registration",
+          "retired_at": null,
+          "created_at": "2026-07-10T13:19:44.344493Z",
+          "updated_at": "2026-07-10T13:19:44.344493Z"
+        },
+        "all_time": {
+          "calls": 1,
+          "tenant_count": 1,
+          "user_count": 1,
+          "component_count": 1,
+          "tenants": {
+            "unknown": 1
+          },
+          "users": {
+            "unknown": 1
+          },
+          "components": {
+            "state-hub.mcp": 1
+          }
+        },
+        "window": {
+          "calls": 0,
+          "tenant_count": 0,
+          "user_count": 0,
+          "component_count": 0,
+          "tenants": {},
+          "users": {},
+          "components": {}
+        },
+        "last_seen_at": "2026-07-10T13:20:34.491811Z",
+        "retirement_candidate": true,
+        "retirement_reason": "no measured usage in review window"
+      },
+      {
+        "interface": {
+          "id": "cd9342fd-27e7-4a46-a1be-d41499e106a3",
+          "interface_key": "rest_api:DELETE /workstreams/{workstream_id}",
+          "interface_kind": "rest_api",
+          "legacy_since": "2026-06-06T17:28:13.052813Z",
+          "replacement_ref": "/workplans/{workplan_id}",
+          "owner_component": "state-hub.api",
+          "status": "legacy",
+          "replacement_verified": true,
+          "manual_hold": false,
+          "hold_reason": null,
+          "notes": null,
+          "retired_at": null,
+          "created_at": "2026-06-06T17:28:13.052813Z",
+          "updated_at": "2026-06-06T17:28:13.052813Z"
+        },
+        "all_time": {
+          "calls": 1,
+          "tenant_count": 1,
+          "user_count": 1,
+          "component_count": 1,
+          "tenants": {
+            "unknown": 1
+          },
+          "users": {
+            "unknown": 1
+          },
+          "components": {
+            "unknown": 1
+          }
+        },
+        "window": {
+          "calls": 0,
+          "tenant_count": 0,
+          "user_count": 0,
+          "component_count": 0,
+          "tenants": {},
+          "users": {},
+          "components": {}
+        },
+        "last_seen_at": "2026-06-06T17:28:13.047529Z",
+        "retirement_candidate": true,
+        "retirement_reason": "no measured usage in review window"
+      },
+      {
+        "interface": {
+          "id": "a4e0948c-cd4a-461e-8ae2-7fd7b51d04a7",
+          "interface_key": "rest_api:GET /decisions/?workstream_id",
+          "interface_kind": "rest_api",
+          "legacy_since": "2026-07-09T23:07:53.093223Z",
+          "replacement_ref": "/decisions/?workplan_id=<workplan_id>",
+          "owner_component": "state-hub.api",
+          "status": "legacy",
+          "replacement_verified": true,
+          "manual_hold": false,
+          "hold_reason": null,
+          "notes": null,
+          "retired_at": null,
+          "created_at": "2026-07-09T23:07:53.093223Z",
+          "updated_at": "2026-07-09T23:07:53.093223Z"
+        },
+        "all_time": {
+          "calls": 1,
+          "tenant_count": 1,
+          "user_count": 1,
+          "component_count": 1,
+          "tenants": {
+            "unknown": 1
+          },
+          "users": {
+            "unknown": 1
+          },
+          "components": {
+            "unknown": 1
+          }
+        },
+        "window": {
+          "calls": 0,
+          "tenant_count": 0,
+          "user_count": 0,
+          "component_count": 0,
+          "tenants": {},
+          "users": {},
+          "components": {}
+        },
+        "last_seen_at": "2026-07-09T23:07:53.083299Z",
+        "retirement_candidate": true,
+        "retirement_reason": "no measured usage in review window"
+      },
+      {
+        "interface": {
+          "id": "70a9346e-e0ee-42ac-874f-f160580b54dd",
+          "interface_key": "rest_api:GET /progress/?workstream_id",
+          "interface_kind": "rest_api",
+          "legacy_since": "2026-07-13T22:04:03.911449Z",
+          "replacement_ref": "/progress/?workplan_id=<workplan_id>",
+          "owner_component": "state-hub.api",
+          "status": "legacy",
+          "replacement_verified": true,
+          "manual_hold": false,
+          "hold_reason": null,
+          "notes": null,
+          "retired_at": null,
+          "created_at": "2026-07-13T22:04:03.911449Z",
+          "updated_at": "2026-07-13T22:04:03.911449Z"
+        },
+        "all_time": {
+          "calls": 1,
+          "tenant_count": 1,
+          "user_count": 1,
+          "component_count": 1,
+          "tenants": {
+            "unknown": 1
+          },
+          "users": {
+            "unknown": 1
+          },
+          "components": {
+            "unknown": 1
+          }
+        },
+        "window": {
+          "calls": 0,
+          "tenant_count": 0,
+          "user_count": 0,
+          "component_count": 0,
+          "tenants": {},
+          "users": {},
+          "components": {}
+        },
+        "last_seen_at": "2026-07-13T22:04:03.904998Z",
+        "retirement_candidate": true,
+        "retirement_reason": "no measured usage in review window"
+      },
+      {
+        "interface": {
+          "id": "be3cdcf8-250b-4bf0-801f-02ffd5f57e00",
+          "interface_key": "rest_api:GET /tasks/?workstream_id",
+          "interface_kind": "rest_api",
+          "legacy_since": "2026-07-08T19:32:21.628513Z",
+          "replacement_ref": "/tasks/?workplan_id=<workplan_id>",
+          "owner_component": "state-hub.api",
+          "status": "legacy",
+          "replacement_verified": true,
+          "manual_hold": false,
+          "hold_reason": null,
+          "notes": null,
+          "retired_at": null,
+          "created_at": "2026-07-08T19:32:21.628513Z",
+          "updated_at": "2026-07-08T19:32:21.628513Z"
+        },
+        "all_time": {
+          "calls": 587,
+          "tenant_count": 1,
+          "user_count": 1,
+          "component_count": 1,
+          "tenants": {
+            "unknown": 587
+          },
+          "users": {
+            "unknown": 587
+          },
+          "components": {
+            "unknown": 587
+          }
+        },
+        "window": {
+          "calls": 0,
+          "tenant_count": 0,
+          "user_count": 0,
+          "component_count": 0,
+          "tenants": {},
+          "users": {},
+          "components": {}
+        },
+        "last_seen_at": "2026-07-22T13:21:12.171828Z",
+        "retirement_candidate": true,
+        "retirement_reason": "no measured usage in review window"
+      },
+      {
+        "interface": {
+          "id": "3e4a3d0b-08fa-45c3-91e2-4f514a914b97",
+          "interface_key": "rest_api:GET /workstreams/",
+          "interface_kind": "rest_api",
+          "legacy_since": "2026-06-04T00:26:14.533764Z",
+          "replacement_ref": "/workplans/",
+          "owner_component": "state-hub.api",
+          "status": "legacy",
+          "replacement_verified": true,
+          "manual_hold": false,
+          "hold_reason": null,
+          "notes": null,
+          "retired_at": null,
+          "created_at": "2026-06-04T00:26:14.533764Z",
+          "updated_at": "2026-06-04T00:26:14.533764Z"
+        },
+        "all_time": {
+          "calls": 144084,
+          "tenant_count": 1,
+          "user_count": 1,
+          "component_count": 1,
+          "tenants": {
+            "unknown": 144084
+          },
+          "users": {
+            "unknown": 144084
+          },
+          "components": {
+            "unknown": 144084
+          }
+        },
+        "window": {
+          "calls": 0,
+          "tenant_count": 0,
+          "user_count": 0,
+          "component_count": 0,
+          "tenants": {},
+          "users": {},
+          "components": {}
+        },
+        "last_seen_at": "2026-07-08T21:14:39.652776Z",
+        "retirement_candidate": true,
+        "retirement_reason": "no measured usage in review window"
+      },
+      {
+        "interface": {
+          "id": "e4c140ec-7479-46f9-b185-4b533f19d639",
+          "interface_key": "rest_api:GET /workstreams/workplan-index",
+          "interface_kind": "rest_api",
+          "legacy_since": "2026-06-04T05:20:58.321869Z",
+          "replacement_ref": "/workplans/index",
+          "owner_component": "state-hub.api",
+          "status": "legacy",
+          "replacement_verified": true,
+          "manual_hold": false,
+          "hold_reason": null,
+          "notes": null,
+          "retired_at": null,
+          "created_at": "2026-06-04T05:20:58.321869Z",
+          "updated_at": "2026-06-04T05:20:58.321869Z"
+        },
+        "all_time": {
+          "calls": 30,
+          "tenant_count": 1,
+          "user_count": 1,
+          "component_count": 1,
+          "tenants": {
+            "unknown": 30
+          },
+          "users": {
+            "unknown": 30
+          },
+          "components": {
+            "unknown": 30
+          }
+        },
+        "window": {
+          "calls": 0,
+          "tenant_count": 0,
+          "user_count": 0,
+          "component_count": 0,
+          "tenants": {},
+          "users": {},
+          "components": {}
+        },
+        "last_seen_at": "2026-07-03T05:20:34.534439Z",
+        "retirement_candidate": true,
+        "retirement_reason": "no measured usage in review window"
+      },
+      {
+        "interface": {
+          "id": "3a00b19e-e7db-4403-98aa-a77c9ab61ecc",
+          "interface_key": "rest_api:GET /workstreams/{workstream_id}",
+          "interface_kind": "rest_api",
+          "legacy_since": "2026-06-04T00:25:59.014966Z",
+          "replacement_ref": "/workplans/{workplan_id}",
+          "owner_component": "state-hub.api",
+          "status": "legacy",
+          "replacement_verified": true,
+          "manual_hold": false,
+          "hold_reason": null,
+          "notes": null,
+          "retired_at": null,
+          "created_at": "2026-06-04T00:25:59.014966Z",
+          "updated_at": "2026-06-04T00:25:59.014966Z"
+        },
+        "all_time": {
+          "calls": 511405,
+          "tenant_count": 1,
+          "user_count": 1,
+          "component_count": 1,
+          "tenants": {
+            "unknown": 511405
+          },
+          "users": {
+            "unknown": 511405
+          },
+          "components": {
+            "unknown": 511405
+          }
+        },
+        "window": {
+          "calls": 0,
+          "tenant_count": 0,
+          "user_count": 0,
+          "component_count": 0,
+          "tenants": {},
+          "users": {},
+          "components": {}
+        },
+        "last_seen_at": "2026-07-08T21:14:20.781103Z",
+        "retirement_candidate": true,
+        "retirement_reason": "no measured usage in review window"
+      },
+      {
+        "interface": {
+          "id": "69e1a255-a8b9-4101-8a68-b1bed23abfda",
+          "interface_key": "rest_api:GET /workstreams/{workstream_id}/dependencies/",
+          "interface_kind": "rest_api",
+          "legacy_since": "2026-06-04T00:25:59.291135Z",
+          "replacement_ref": "/workplans/{workplan_id}/dependencies/",
+          "owner_component": "state-hub.api",
+          "status": "legacy",
+          "replacement_verified": true,
+          "manual_hold": false,
+          "hold_reason": null,
+          "notes": null,
+          "retired_at": null,
+          "created_at": "2026-06-04T00:25:59.291135Z",
+          "updated_at": "2026-06-04T00:25:59.291135Z"
+        },
+        "all_time": {
+          "calls": 255865,
+          "tenant_count": 1,
+          "user_count": 1,
+          "component_count": 1,
+          "tenants": {
+            "unknown": 255865
+          },
+          "users": {
+            "unknown": 255865
+          },
+          "components": {
+            "unknown": 255865
+          }
+        },
+        "window": {
+          "calls": 0,
+          "tenant_count": 0,
+          "user_count": 0,
+          "component_count": 0,
+          "tenants": {},
+          "users": {},
+          "components": {}
+        },
+        "last_seen_at": "2026-07-08T21:14:12.747005Z",
+        "retirement_candidate": true,
+        "retirement_reason": "no measured usage in review window"
+      },
+      {
+        "interface": {
+          "id": "b1aae931-b51f-4a85-a723-865dd65f6132",
+          "interface_key": "rest_api:PATCH /workstreams/{workstream_id}",
+          "interface_kind": "rest_api",
+          "legacy_since": "2026-06-04T06:09:41.901035Z",
+          "replacement_ref": "/workplans/{workplan_id}",
+          "owner_component": "state-hub.api",
+          "status": "legacy",
+          "replacement_verified": true,
+          "manual_hold": false,
+          "hold_reason": null,
+          "notes": null,
+          "retired_at": null,
+          "created_at": "2026-06-04T06:09:41.901035Z",
+          "updated_at": "2026-06-04T06:09:41.901035Z"
+        },
+        "all_time": {
+          "calls": 571,
+          "tenant_count": 1,
+          "user_count": 1,
+          "component_count": 1,
+          "tenants": {
+            "unknown": 571
+          },
+          "users": {
+            "unknown": 571
+          },
+          "components": {
+            "unknown": 571
+          }
+        },
+        "window": {
+          "calls": 0,
+          "tenant_count": 0,
+          "user_count": 0,
+          "component_count": 0,
+          "tenants": {},
+          "users": {},
+          "components": {}
+        },
+        "last_seen_at": "2026-07-08T20:49:12.335710Z",
+        "retirement_candidate": true,
+        "retirement_reason": "no measured usage in review window"
+      },
+      {
+        "interface": {
+          "id": "4aea9591-970b-4918-ac4a-4da95a0a1a8c",
+          "interface_key": "rest_api:POST /decisions/ workstream_id",
+          "interface_kind": "rest_api",
+          "legacy_since": "2026-07-09T22:56:35.473130Z",
+          "replacement_ref": "POST /decisions/ with workplan_id",
+          "owner_component": "state-hub.api",
+          "status": "legacy",
+          "replacement_verified": true,
+          "manual_hold": false,
+          "hold_reason": null,
+          "notes": null,
+          "retired_at": null,
+          "created_at": "2026-07-09T22:56:35.473130Z",
+          "updated_at": "2026-07-09T22:56:35.473130Z"
+        },
+        "all_time": {
+          "calls": 3,
+          "tenant_count": 1,
+          "user_count": 1,
+          "component_count": 1,
+          "tenants": {
+            "unknown": 3
+          },
+          "users": {
+            "unknown": 3
+          },
+          "components": {
+            "unknown": 3
+          }
+        },
+        "window": {
+          "calls": 0,
+          "tenant_count": 0,
+          "user_count": 0,
+          "component_count": 0,
+          "tenants": {},
+          "users": {},
+          "components": {}
+        },
+        "last_seen_at": "2026-07-09T22:57:05.912456Z",
+        "retirement_candidate": true,
+        "retirement_reason": "no measured usage in review window"
+      },
+      {
+        "interface": {
+          "id": "4a70583c-1e41-4ec1-99a9-728856a7d79c",
+          "interface_key": "rest_api:POST /progress/ workstream_id",
+          "interface_kind": "rest_api",
+          "legacy_since": "2026-07-08T23:35:09.148333Z",
+          "replacement_ref": "POST /progress/ with workplan_id",
+          "owner_component": "state-hub.api",
+          "status": "legacy",
+          "replacement_verified": true,
+          "manual_hold": false,
+          "hold_reason": null,
+          "notes": null,
+          "retired_at": null,
+          "created_at": "2026-07-08T23:35:09.148333Z",
+          "updated_at": "2026-07-08T23:35:09.148333Z"
+        },
+        "all_time": {
+          "calls": 14,
+          "tenant_count": 1,
+          "user_count": 1,
+          "component_count": 1,
+          "tenants": {
+            "unknown": 14
+          },
+          "users": {
+            "unknown": 14
+          },
+          "components": {
+            "unknown": 14
+          }
+        },
+        "window": {
+          "calls": 0,
+          "tenant_count": 0,
+          "user_count": 0,
+          "component_count": 0,
+          "tenants": {},
+          "users": {},
+          "components": {}
+        },
+        "last_seen_at": "2026-07-10T08:34:42.959724Z",
+        "retirement_candidate": true,
+        "retirement_reason": "no measured usage in review window"
+      },
+      {
+        "interface": {
+          "id": "6df4e443-7bf1-461a-923b-a6eb52fe7b07",
+          "interface_key": "rest_api:POST /tasks/ workstream_id",
+          "interface_kind": "rest_api",
+          "legacy_since": "2026-07-08T22:38:29.405720Z",
+          "replacement_ref": "POST /tasks/ with workplan_id",
+          "owner_component": "state-hub.api",
+          "status": "legacy",
+          "replacement_verified": true,
+          "manual_hold": false,
+          "hold_reason": null,
+          "notes": null,
+          "retired_at": null,
+          "created_at": "2026-07-08T22:38:29.405720Z",
+          "updated_at": "2026-07-08T22:38:29.405720Z"
+        },
+        "all_time": {
+          "calls": 5,
+          "tenant_count": 1,
+          "user_count": 1,
+          "component_count": 1,
+          "tenants": {
+            "unknown": 5
+          },
+          "users": {
+            "unknown": 5
+          },
+          "components": {
+            "state-hub.fix-consistency": 5
+          }
+        },
+        "window": {
+          "calls": 0,
+          "tenant_count": 0,
+          "user_count": 0,
+          "component_count": 0,
+          "tenants": {},
+          "users": {},
+          "components": {}
+        },
+        "last_seen_at": "2026-07-08T22:38:29.976918Z",
+        "retirement_candidate": true,
+        "retirement_reason": "no measured usage in review window"
+      },
+      {
+        "interface": {
+          "id": "ed6451c9-d2cc-4486-9afe-d3852782cabc",
+          "interface_key": "rest_api:POST /workstreams/",
+          "interface_kind": "rest_api",
+          "legacy_since": "2026-06-04T07:40:24.168535Z",
+          "replacement_ref": "/workplans/",
+          "owner_component": "state-hub.api",
+          "status": "legacy",
+          "replacement_verified": true,
+          "manual_hold": false,
+          "hold_reason": null,
+          "notes": null,
+          "retired_at": null,
+          "created_at": "2026-06-04T07:40:24.168535Z",
+          "updated_at": "2026-06-04T07:40:24.168535Z"
+        },
+        "all_time": {
+          "calls": 824,
+          "tenant_count": 1,
+          "user_count": 1,
+          "component_count": 1,
+          "tenants": {
+            "unknown": 824
+          },
+          "users": {
+            "unknown": 824
+          },
+          "components": {
+            "unknown": 824
+          }
+        },
+        "window": {
+          "calls": 0,
+          "tenant_count": 0,
+          "user_count": 0,
+          "component_count": 0,
+          "tenants": {},
+          "users": {},
+          "components": {}
+        },
+        "last_seen_at": "2026-07-08T20:38:05.903144Z",
+        "retirement_candidate": true,
+        "retirement_reason": "no measured usage in review window"
+      },
+      {
+        "interface": {
+          "id": "281fd706-b192-4194-8055-2d8733c115f9",
+          "interface_key": "rest_api:POST /workstreams/{workstream_id}/dependencies/",
+          "interface_kind": "rest_api",
+          "legacy_since": "2026-06-04T22:57:37.149207Z",
+          "replacement_ref": "/workplans/{workplan_id}/dependencies/",
+          "owner_component": "state-hub.api",
+          "status": "legacy",
+          "replacement_verified": true,
+          "manual_hold": false,
+          "hold_reason": null,
+          "notes": null,
+          "retired_at": null,
+          "created_at": "2026-06-04T22:57:37.149207Z",
+          "updated_at": "2026-06-04T22:57:37.149207Z"
+        },
+        "all_time": {
+          "calls": 4971,
+          "tenant_count": 1,
+          "user_count": 1,
+          "component_count": 1,
+          "tenants": {
+            "unknown": 4971
+          },
+          "users": {
+            "unknown": 4971
+          },
+          "components": {
+            "unknown": 4971
+          }
+        },
+        "window": {
+          "calls": 0,
+          "tenant_count": 0,
+          "user_count": 0,
+          "component_count": 0,
+          "tenants": {},
+          "users": {},
+          "components": {}
+        },
+        "last_seen_at": "2026-07-01T22:09:24.229011Z",
+        "retirement_candidate": true,
+        "retirement_reason": "no measured usage in review window"
+      }
+    ],
+    "retirement_candidates": [
+      {
+        "interface": {
+          "id": "63ed90e3-42b4-431a-94db-e1254a52f9e2",
+          "interface_key": "mcp:create_workstream",
+          "interface_kind": "mcp_tool",
+          "legacy_since": "2026-07-10T13:19:44.205900Z",
+          "replacement_ref": "create_workplan",
+          "owner_component": "state-hub.mcp",
+          "status": "legacy",
+          "replacement_verified": true,
+          "manual_hold": false,
+          "hold_reason": null,
+          "notes": "Registered by STATE-WP-0070 T03 \u2014 zero-window streak starts at registration",
+          "retired_at": null,
+          "created_at": "2026-07-10T13:19:44.205900Z",
+          "updated_at": "2026-07-10T13:19:44.205900Z"
+        },
+        "all_time": {
+          "calls": 2,
+          "tenant_count": 1,
+          "user_count": 1,
+          "component_count": 1,
+          "tenants": {
+            "unknown": 2
+          },
+          "users": {
+            "unknown": 2
+          },
+          "components": {
+            "state-hub.mcp": 2
+          }
+        },
+        "window": {
+          "calls": 0,
+          "tenant_count": 0,
+          "user_count": 0,
+          "component_count": 0,
+          "tenants": {},
+          "users": {},
+          "components": {}
+        },
+        "last_seen_at": "2026-07-10T13:20:43.378546Z",
+        "retirement_candidate": true,
+        "retirement_reason": "no measured usage in review window"
+      },
+      {
+        "interface": {
+          "id": "b6a5fe44-fb85-4ef7-a273-78d09da777af",
+          "interface_key": "mcp:list_workstreams",
+          "interface_kind": "mcp_tool",
+          "legacy_since": "2026-07-10T13:19:26.075491Z",
+          "replacement_ref": "list_workplans",
+          "owner_component": "state-hub.mcp",
+          "status": "legacy",
+          "replacement_verified": true,
+          "manual_hold": false,
+          "hold_reason": null,
+          "notes": null,
+          "retired_at": null,
+          "created_at": "2026-07-10T13:19:26.075491Z",
+          "updated_at": "2026-07-10T13:19:26.075491Z"
+        },
+        "all_time": {
+          "calls": 2,
+          "tenant_count": 1,
+          "user_count": 1,
+          "component_count": 1,
+          "tenants": {
+            "unknown": 2
+          },
+          "users": {
+            "unknown": 2
+          },
+          "components": {
+            "state-hub.mcp": 2
+          }
+        },
+        "window": {
+          "calls": 0,
+          "tenant_count": 0,
+          "user_count": 0,
+          "component_count": 0,
+          "tenants": {},
+          "users": {},
+          "components": {}
+        },
+        "last_seen_at": "2026-07-10T13:20:42.374940Z",
+        "retirement_candidate": true,
+        "retirement_reason": "no measured usage in review window"
+      },
+      {
+        "interface": {
+          "id": "53c3372b-307d-4d6a-8ea4-bc36cacdcaf2",
+          "interface_key": "mcp:update_workstream",
+          "interface_kind": "mcp_tool",
+          "legacy_since": "2026-07-10T13:19:44.255216Z",
+          "replacement_ref": "update_workplan",
+          "owner_component": "state-hub.mcp",
+          "status": "legacy",
+          "replacement_verified": true,
+          "manual_hold": false,
+          "hold_reason": null,
+          "notes": "Registered by STATE-WP-0070 T03 \u2014 zero-window streak starts at registration",
+          "retired_at": null,
+          "created_at": "2026-07-10T13:19:44.255216Z",
+          "updated_at": "2026-07-10T13:19:44.255216Z"
+        },
+        "all_time": {
+          "calls": 0,
+          "tenant_count": 0,
+          "user_count": 0,
+          "component_count": 0,
+          "tenants": {},
+          "users": {},
+          "components": {}
+        },
+        "window": {
+          "calls": 0,
+          "tenant_count": 0,
+          "user_count": 0,
+          "component_count": 0,
+          "tenants": {},
+          "users": {},
+          "components": {}
+        },
+        "last_seen_at": null,
+        "retirement_candidate": true,
+        "retirement_reason": "no measured usage in review window"
+      },
+      {
+        "interface": {
+          "id": "bed4d08a-3471-48f5-9f0e-f9d550383a26",
+          "interface_key": "mcp:update_workstream_status",
+          "interface_kind": "mcp_tool",
+          "legacy_since": "2026-07-10T13:19:44.303612Z",
+          "replacement_ref": "update_workplan_status",
+          "owner_component": "state-hub.mcp",
+          "status": "legacy",
+          "replacement_verified": true,
+          "manual_hold": false,
+          "hold_reason": null,
+          "notes": "Registered by STATE-WP-0070 T03 \u2014 zero-window streak starts at registration",
+          "retired_at": null,
+          "created_at": "2026-07-10T13:19:44.303612Z",
+          "updated_at": "2026-07-10T13:19:44.303612Z"
+        },
+        "all_time": {
+          "calls": 0,
+          "tenant_count": 0,
+          "user_count": 0,
+          "component_count": 0,
+          "tenants": {},
+          "users": {},
+          "components": {}
+        },
+        "window": {
+          "calls": 0,
+          "tenant_count": 0,
+          "user_count": 0,
+          "component_count": 0,
+          "tenants": {},
+          "users": {},
+          "components": {}
+        },
+        "last_seen_at": null,
+        "retirement_candidate": true,
+        "retirement_reason": "no measured usage in review window"
+      },
+      {
+        "interface": {
+          "id": "46900dc2-0893-405b-ba59-80f31fb6ebb1",
+          "interface_key": "state://workstreams/{topic_slug}",
+          "interface_kind": "mcp_tool",
+          "legacy_since": "2026-07-10T13:19:44.344493Z",
+          "replacement_ref": "state://workplans/{topic_slug}",
+          "owner_component": "state-hub.mcp",
+          "status": "legacy",
+          "replacement_verified": true,
+          "manual_hold": false,
+          "hold_reason": null,
+          "notes": "Registered by STATE-WP-0070 T03 \u2014 zero-window streak starts at registration",
+          "retired_at": null,
+          "created_at": "2026-07-10T13:19:44.344493Z",
+          "updated_at": "2026-07-10T13:19:44.344493Z"
+        },
+        "all_time": {
+          "calls": 1,
+          "tenant_count": 1,
+          "user_count": 1,
+          "component_count": 1,
+          "tenants": {
+            "unknown": 1
+          },
+          "users": {
+            "unknown": 1
+          },
+          "components": {
+            "state-hub.mcp": 1
+          }
+        },
+        "window": {
+          "calls": 0,
+          "tenant_count": 0,
+          "user_count": 0,
+          "component_count": 0,
+          "tenants": {},
+          "users": {},
+          "components": {}
+        },
+        "last_seen_at": "2026-07-10T13:20:34.491811Z",
+        "retirement_candidate": true,
+        "retirement_reason": "no measured usage in review window"
+      },
+      {
+        "interface": {
+          "id": "cd9342fd-27e7-4a46-a1be-d41499e106a3",
+          "interface_key": "rest_api:DELETE /workstreams/{workstream_id}",
+          "interface_kind": "rest_api",
+          "legacy_since": "2026-06-06T17:28:13.052813Z",
+          "replacement_ref": "/workplans/{workplan_id}",
+          "owner_component": "state-hub.api",
+          "status": "legacy",
+          "replacement_verified": true,
+          "manual_hold": false,
+          "hold_reason": null,
+          "notes": null,
+          "retired_at": null,
+          "created_at": "2026-06-06T17:28:13.052813Z",
+          "updated_at": "2026-06-06T17:28:13.052813Z"
+        },
+        "all_time": {
+          "calls": 1,
+          "tenant_count": 1,
+          "user_count": 1,
+          "component_count": 1,
+          "tenants": {
+            "unknown": 1
+          },
+          "users": {
+            "unknown": 1
+          },
+          "components": {
+            "unknown": 1
+          }
+        },
+        "window": {
+          "calls": 0,
+          "tenant_count": 0,
+          "user_count": 0,
+          "component_count": 0,
+          "tenants": {},
+          "users": {},
+          "components": {}
+        },
+        "last_seen_at": "2026-06-06T17:28:13.047529Z",
+        "retirement_candidate": true,
+        "retirement_reason": "no measured usage in review window"
+      },
+      {
+        "interface": {
+          "id": "a4e0948c-cd4a-461e-8ae2-7fd7b51d04a7",
+          "interface_key": "rest_api:GET /decisions/?workstream_id",
+          "interface_kind": "rest_api",
+          "legacy_since": "2026-07-09T23:07:53.093223Z",
+          "replacement_ref": "/decisions/?workplan_id=<workplan_id>",
+          "owner_component": "state-hub.api",
+          "status": "legacy",
+          "replacement_verified": true,
+          "manual_hold": false,
+          "hold_reason": null,
+          "notes": null,
+          "retired_at": null,
+          "created_at": "2026-07-09T23:07:53.093223Z",
+          "updated_at": "2026-07-09T23:07:53.093223Z"
+        },
+        "all_time": {
+          "calls": 1,
+          "tenant_count": 1,
+          "user_count": 1,
+          "component_count": 1,
+          "tenants": {
+            "unknown": 1
+          },
+          "users": {
+            "unknown": 1
+          },
+          "components": {
+            "unknown": 1
+          }
+        },
+        "window": {
+          "calls": 0,
+          "tenant_count": 0,
+          "user_count": 0,
+          "component_count": 0,
+          "tenants": {},
+          "users": {},
+          "components": {}
+        },
+        "last_seen_at": "2026-07-09T23:07:53.083299Z",
+        "retirement_candidate": true,
+        "retirement_reason": "no measured usage in review window"
+      },
+      {
+        "interface": {
+          "id": "70a9346e-e0ee-42ac-874f-f160580b54dd",
+          "interface_key": "rest_api:GET /progress/?workstream_id",
+          "interface_kind": "rest_api",
+          "legacy_since": "2026-07-13T22:04:03.911449Z",
+          "replacement_ref": "/progress/?workplan_id=<workplan_id>",
+          "owner_component": "state-hub.api",
+          "status": "legacy",
+          "replacement_verified": true,
+          "manual_hold": false,
+          "hold_reason": null,
+          "notes": null,
+          "retired_at": null,
+          "created_at": "2026-07-13T22:04:03.911449Z",
+          "updated_at": "2026-07-13T22:04:03.911449Z"
+        },
+        "all_time": {
+          "calls": 1,
+          "tenant_count": 1,
+          "user_count": 1,
+          "component_count": 1,
+          "tenants": {
+            "unknown": 1
+          },
+          "users": {
+            "unknown": 1
+          },
+          "components": {
+            "unknown": 1
+          }
+        },
+        "window": {
+          "calls": 0,
+          "tenant_count": 0,
+          "user_count": 0,
+          "component_count": 0,
+          "tenants": {},
+          "users": {},
+          "components": {}
+        },
+        "last_seen_at": "2026-07-13T22:04:03.904998Z",
+        "retirement_candidate": true,
+        "retirement_reason": "no measured usage in review window"
+      },
+      {
+        "interface": {
+          "id": "be3cdcf8-250b-4bf0-801f-02ffd5f57e00",
+          "interface_key": "rest_api:GET /tasks/?workstream_id",
+          "interface_kind": "rest_api",
+          "legacy_since": "2026-07-08T19:32:21.628513Z",
+          "replacement_ref": "/tasks/?workplan_id=<workplan_id>",
+          "owner_component": "state-hub.api",
+          "status": "legacy",
+          "replacement_verified": true,
+          "manual_hold": false,
+          "hold_reason": null,
+          "notes": null,
+          "retired_at": null,
+          "created_at": "2026-07-08T19:32:21.628513Z",
+          "updated_at": "2026-07-08T19:32:21.628513Z"
+        },
+        "all_time": {
+          "calls": 587,
+          "tenant_count": 1,
+          "user_count": 1,
+          "component_count": 1,
+          "tenants": {
+            "unknown": 587
+          },
+          "users": {
+            "unknown": 587
+          },
+          "components": {
+            "unknown": 587
+          }
+        },
+        "window": {
+          "calls": 0,
+          "tenant_count": 0,
+          "user_count": 0,
+          "component_count": 0,
+          "tenants": {},
+          "users": {},
+          "components": {}
+        },
+        "last_seen_at": "2026-07-22T13:21:12.171828Z",
+        "retirement_candidate": true,
+        "retirement_reason": "no measured usage in review window"
+      },
+      {
+        "interface": {
+          "id": "3e4a3d0b-08fa-45c3-91e2-4f514a914b97",
+          "interface_key": "rest_api:GET /workstreams/",
+          "interface_kind": "rest_api",
+          "legacy_since": "2026-06-04T00:26:14.533764Z",
+          "replacement_ref": "/workplans/",
+          "owner_component": "state-hub.api",
+          "status": "legacy",
+          "replacement_verified": true,
+          "manual_hold": false,
+          "hold_reason": null,
+          "notes": null,
+          "retired_at": null,
+          "created_at": "2026-06-04T00:26:14.533764Z",
+          "updated_at": "2026-06-04T00:26:14.533764Z"
+        },
+        "all_time": {
+          "calls": 144084,
+          "tenant_count": 1,
+          "user_count": 1,
+          "component_count": 1,
+          "tenants": {
+            "unknown": 144084
+          },
+          "users": {
+            "unknown": 144084
+          },
+          "components": {
+            "unknown": 144084
+          }
+        },
+        "window": {
+          "calls": 0,
+          "tenant_count": 0,
+          "user_count": 0,
+          "component_count": 0,
+          "tenants": {},
+          "users": {},
+          "components": {}
+        },
+        "last_seen_at": "2026-07-08T21:14:39.652776Z",
+        "retirement_candidate": true,
+        "retirement_reason": "no measured usage in review window"
+      },
+      {
+        "interface": {
+          "id": "e4c140ec-7479-46f9-b185-4b533f19d639",
+          "interface_key": "rest_api:GET /workstreams/workplan-index",
+          "interface_kind": "rest_api",
+          "legacy_since": "2026-06-04T05:20:58.321869Z",
+          "replacement_ref": "/workplans/index",
+          "owner_component": "state-hub.api",
+          "status": "legacy",
+          "replacement_verified": true,
+          "manual_hold": false,
+          "hold_reason": null,
+          "notes": null,
+          "retired_at": null,
+          "created_at": "2026-06-04T05:20:58.321869Z",
+          "updated_at": "2026-06-04T05:20:58.321869Z"
+        },
+        "all_time": {
+          "calls": 30,
+          "tenant_count": 1,
+          "user_count": 1,
+          "component_count": 1,
+          "tenants": {
+            "unknown": 30
+          },
+          "users": {
+            "unknown": 30
+          },
+          "components": {
+            "unknown": 30
+          }
+        },
+        "window": {
+          "calls": 0,
+          "tenant_count": 0,
+          "user_count": 0,
+          "component_count": 0,
+          "tenants": {},
+          "users": {},
+          "components": {}
+        },
+        "last_seen_at": "2026-07-03T05:20:34.534439Z",
+        "retirement_candidate": true,
+        "retirement_reason": "no measured usage in review window"
+      },
+      {
+        "interface": {
+          "id": "3a00b19e-e7db-4403-98aa-a77c9ab61ecc",
+          "interface_key": "rest_api:GET /workstreams/{workstream_id}",
+          "interface_kind": "rest_api",
+          "legacy_since": "2026-06-04T00:25:59.014966Z",
+          "replacement_ref": "/workplans/{workplan_id}",
+          "owner_component": "state-hub.api",
+          "status": "legacy",
+          "replacement_verified": true,
+          "manual_hold": false,
+          "hold_reason": null,
+          "notes": null,
+          "retired_at": null,
+          "created_at": "2026-06-04T00:25:59.014966Z",
+          "updated_at": "2026-06-04T00:25:59.014966Z"
+        },
+        "all_time": {
+          "calls": 511405,
+          "tenant_count": 1,
+          "user_count": 1,
+          "component_count": 1,
+          "tenants": {
+            "unknown": 511405
+          },
+          "users": {
+            "unknown": 511405
+          },
+          "components": {
+            "unknown": 511405
+          }
+        },
+        "window": {
+          "calls": 0,
+          "tenant_count": 0,
+          "user_count": 0,
+          "component_count": 0,
+          "tenants": {},
+          "users": {},
+          "components": {}
+        },
+        "last_seen_at": "2026-07-08T21:14:20.781103Z",
+        "retirement_candidate": true,
+        "retirement_reason": "no measured usage in review window"
+      },
+      {
+        "interface": {
+          "id": "69e1a255-a8b9-4101-8a68-b1bed23abfda",
+          "interface_key": "rest_api:GET /workstreams/{workstream_id}/dependencies/",
+          "interface_kind": "rest_api",
+          "legacy_since": "2026-06-04T00:25:59.291135Z",
+          "replacement_ref": "/workplans/{workplan_id}/dependencies/",
+          "owner_component": "state-hub.api",
+          "status": "legacy",
+          "replacement_verified": true,
+          "manual_hold": false,
+          "hold_reason": null,
+          "notes": null,
+          "retired_at": null,
+          "created_at": "2026-06-04T00:25:59.291135Z",
+          "updated_at": "2026-06-04T00:25:59.291135Z"
+        },
+        "all_time": {
+          "calls": 255865,
+          "tenant_count": 1,
+          "user_count": 1,
+          "component_count": 1,
+          "tenants": {
+            "unknown": 255865
+          },
+          "users": {
+            "unknown": 255865
+          },
+          "components": {
+            "unknown": 255865
+          }
+        },
+        "window": {
+          "calls": 0,
+          "tenant_count": 0,
+          "user_count": 0,
+          "component_count": 0,
+          "tenants": {},
+          "users": {},
+          "components": {}
+        },
+        "last_seen_at": "2026-07-08T21:14:12.747005Z",
+        "retirement_candidate": true,
+        "retirement_reason": "no measured usage in review window"
+      },
+      {
+        "interface": {
+          "id": "b1aae931-b51f-4a85-a723-865dd65f6132",
+          "interface_key": "rest_api:PATCH /workstreams/{workstream_id}",
+          "interface_kind": "rest_api",
+          "legacy_since": "2026-06-04T06:09:41.901035Z",
+          "replacement_ref": "/workplans/{workplan_id}",
+          "owner_component": "state-hub.api",
+          "status": "legacy",
+          "replacement_verified": true,
+          "manual_hold": false,
+          "hold_reason": null,
+          "notes": null,
+          "retired_at": null,
+          "created_at": "2026-06-04T06:09:41.901035Z",
+          "updated_at": "2026-06-04T06:09:41.901035Z"
+        },
+        "all_time": {
+          "calls": 571,
+          "tenant_count": 1,
+          "user_count": 1,
+          "component_count": 1,
+          "tenants": {
+            "unknown": 571
+          },
+          "users": {
+            "unknown": 571
+          },
+          "components": {
+            "unknown": 571
+          }
+        },
+        "window": {
+          "calls": 0,
+          "tenant_count": 0,
+          "user_count": 0,
+          "component_count": 0,
+          "tenants": {},
+          "users": {},
+          "components": {}
+        },
+        "last_seen_at": "2026-07-08T20:49:12.335710Z",
+        "retirement_candidate": true,
+        "retirement_reason": "no measured usage in review window"
+      },
+      {
+        "interface": {
+          "id": "4aea9591-970b-4918-ac4a-4da95a0a1a8c",
+          "interface_key": "rest_api:POST /decisions/ workstream_id",
+          "interface_kind": "rest_api",
+          "legacy_since": "2026-07-09T22:56:35.473130Z",
+          "replacement_ref": "POST /decisions/ with workplan_id",
+          "owner_component": "state-hub.api",
+          "status": "legacy",
+          "replacement_verified": true,
+          "manual_hold": false,
+          "hold_reason": null,
+          "notes": null,
+          "retired_at": null,
+          "created_at": "2026-07-09T22:56:35.473130Z",
+          "updated_at": "2026-07-09T22:56:35.473130Z"
+        },
+        "all_time": {
+          "calls": 3,
+          "tenant_count": 1,
+          "user_count": 1,
+          "component_count": 1,
+          "tenants": {
+            "unknown": 3
+          },
+          "users": {
+            "unknown": 3
+          },
+          "components": {
+            "unknown": 3
+          }
+        },
+        "window": {
+          "calls": 0,
+          "tenant_count": 0,
+          "user_count": 0,
+          "component_count": 0,
+          "tenants": {},
+          "users": {},
+          "components": {}
+        },
+        "last_seen_at": "2026-07-09T22:57:05.912456Z",
+        "retirement_candidate": true,
+        "retirement_reason": "no measured usage in review window"
+      },
+      {
+        "interface": {
+          "id": "4a70583c-1e41-4ec1-99a9-728856a7d79c",
+          "interface_key": "rest_api:POST /progress/ workstream_id",
+          "interface_kind": "rest_api",
+          "legacy_since": "2026-07-08T23:35:09.148333Z",
+          "replacement_ref": "POST /progress/ with workplan_id",
+          "owner_component": "state-hub.api",
+          "status": "legacy",
+          "replacement_verified": true,
+          "manual_hold": false,
+          "hold_reason": null,
+          "notes": null,
+          "retired_at": null,
+          "created_at": "2026-07-08T23:35:09.148333Z",
+          "updated_at": "2026-07-08T23:35:09.148333Z"
+        },
+        "all_time": {
+          "calls": 14,
+          "tenant_count": 1,
+          "user_count": 1,
+          "component_count": 1,
+          "tenants": {
+            "unknown": 14
+          },
+          "users": {
+            "unknown": 14
+          },
+          "components": {
+            "unknown": 14
+          }
+        },
+        "window": {
+          "calls": 0,
+          "tenant_count": 0,
+          "user_count": 0,
+          "component_count": 0,
+          "tenants": {},
+          "users": {},
+          "components": {}
+        },
+        "last_seen_at": "2026-07-10T08:34:42.959724Z",
+        "retirement_candidate": true,
+        "retirement_reason": "no measured usage in review window"
+      },
+      {
+        "interface": {
+          "id": "6df4e443-7bf1-461a-923b-a6eb52fe7b07",
+          "interface_key": "rest_api:POST /tasks/ workstream_id",
+          "interface_kind": "rest_api",
+          "legacy_since": "2026-07-08T22:38:29.405720Z",
+          "replacement_ref": "POST /tasks/ with workplan_id",
+          "owner_component": "state-hub.api",
+          "status": "legacy",
+          "replacement_verified": true,
+          "manual_hold": false,
+          "hold_reason": null,
+          "notes": null,
+          "retired_at": null,
+          "created_at": "2026-07-08T22:38:29.405720Z",
+          "updated_at": "2026-07-08T22:38:29.405720Z"
+        },
+        "all_time": {
+          "calls": 5,
+          "tenant_count": 1,
+          "user_count": 1,
+          "component_count": 1,
+          "tenants": {
+            "unknown": 5
+          },
+          "users": {
+            "unknown": 5
+          },
+          "components": {
+            "state-hub.fix-consistency": 5
+          }
+        },
+        "window": {
+          "calls": 0,
+          "tenant_count": 0,
+          "user_count": 0,
+          "component_count": 0,
+          "tenants": {},
+          "users": {},
+          "components": {}
+        },
+        "last_seen_at": "2026-07-08T22:38:29.976918Z",
+        "retirement_candidate": true,
+        "retirement_reason": "no measured usage in review window"
+      },
+      {
+        "interface": {
+          "id": "ed6451c9-d2cc-4486-9afe-d3852782cabc",
+          "interface_key": "rest_api:POST /workstreams/",
+          "interface_kind": "rest_api",
+          "legacy_since": "2026-06-04T07:40:24.168535Z",
+          "replacement_ref": "/workplans/",
+          "owner_component": "state-hub.api",
+          "status": "legacy",
+          "replacement_verified": true,
+          "manual_hold": false,
+          "hold_reason": null,
+          "notes": null,
+          "retired_at": null,
+          "created_at": "2026-06-04T07:40:24.168535Z",
+          "updated_at": "2026-06-04T07:40:24.168535Z"
+        },
+        "all_time": {
+          "calls": 824,
+          "tenant_count": 1,
+          "user_count": 1,
+          "component_count": 1,
+          "tenants": {
+            "unknown": 824
+          },
+          "users": {
+            "unknown": 824
+          },
+          "components": {
+            "unknown": 824
+          }
+        },
+        "window": {
+          "calls": 0,
+          "tenant_count": 0,
+          "user_count": 0,
+          "component_count": 0,
+          "tenants": {},
+          "users": {},
+          "components": {}
+        },
+        "last_seen_at": "2026-07-08T20:38:05.903144Z",
+        "retirement_candidate": true,
+        "retirement_reason": "no measured usage in review window"
+      },
+      {
+        "interface": {
+          "id": "281fd706-b192-4194-8055-2d8733c115f9",
+          "interface_key": "rest_api:POST /workstreams/{workstream_id}/dependencies/",
+          "interface_kind": "rest_api",
+          "legacy_since": "2026-06-04T22:57:37.149207Z",
+          "replacement_ref": "/workplans/{workplan_id}/dependencies/",
+          "owner_component": "state-hub.api",
+          "status": "legacy",
+          "replacement_verified": true,
+          "manual_hold": false,
+          "hold_reason": null,
+          "notes": null,
+          "retired_at": null,
+          "created_at": "2026-06-04T22:57:37.149207Z",
+          "updated_at": "2026-06-04T22:57:37.149207Z"
+        },
+        "all_time": {
+          "calls": 4971,
+          "tenant_count": 1,
+          "user_count": 1,
+          "component_count": 1,
+          "tenants": {
+            "unknown": 4971
+          },
+          "users": {
+            "unknown": 4971
+          },
+          "components": {
+            "unknown": 4971
+          }
+        },
+        "window": {
+          "calls": 0,
+          "tenant_count": 0,
+          "user_count": 0,
+          "component_count": 0,
+          "tenants": {},
+          "users": {},
+          "components": {}
+        },
+        "last_seen_at": "2026-07-01T22:09:24.229011Z",
+        "retirement_candidate": true,
+        "retirement_reason": "no measured usage in review window"
+      }
+    ]
+  },
+  "hours": 8
+}
diff --git a/docs/evidence/legacy-meter-weekly-review-20260724.json b/docs/evidence/legacy-meter-weekly-review-20260724.json
new file mode 100644
index 0000000..759b9b1
--- /dev/null
+++ b/docs/evidence/legacy-meter-weekly-review-20260724.json
@@ -0,0 +1,1755 @@
+{
+  "captured_at": "2026-07-24T14:00:07.665429+00:00",
+  "api_base": "http://127.0.0.1:8000",
+  "workplan": "STATE-WP-0070",
+  "retired_interfaces": [],
+  "weekly_review": {
+    "generated_at": "2026-07-24T14:00:07.655422Z",
+    "window_start": "2026-07-24T06:00:07.388874Z",
+    "window_end": "2026-07-24T14:00:07.388874Z",
+    "cadence": "weekly",
+    "activity_core_handoff": {
+      "activity_id": "statehub-legacy-interface-review",
+      "cadence": "weekly",
+      "source_endpoint": "/legacy-meter/weekly-review",
+      "state_owner": "state-hub",
+      "scheduler_owner": "activity-core"
+    },
+    "interfaces": [
+      {
+        "interface": {
+          "id": "8051fb40-66c9-4dc4-a413-13e8573e04a3",
+          "interface_key": "event_subject:org.statehub.workstream.completed",
+          "interface_kind": "event_subject",
+          "legacy_since": "2026-06-04T06:09:42.198193Z",
+          "replacement_ref": "org.statehub.workplan.completed",
+          "owner_component": "state-hub.events",
+          "status": "retired",
+          "replacement_verified": true,
+          "manual_hold": false,
+          "hold_reason": null,
+          "notes": "Retired by STATE-WP-0069 closeout",
+          "retired_at": "2026-07-08T21:38:52.773601Z",
+          "created_at": "2026-06-04T06:09:42.198193Z",
+          "updated_at": "2026-07-08T21:38:52.761243Z"
+        },
+        "all_time": {
+          "calls": 255,
+          "tenant_count": 1,
+          "user_count": 1,
+          "component_count": 1,
+          "tenants": {
+            "unknown": 255
+          },
+          "users": {
+            "unknown": 255
+          },
+          "components": {
+            "state-hub.events": 255
+          }
+        },
+        "window": {
+          "calls": 0,
+          "tenant_count": 0,
+          "user_count": 0,
+          "component_count": 0,
+          "tenants": {},
+          "users": {},
+          "components": {}
+        },
+        "last_seen_at": "2026-07-08T20:49:12.839383Z",
+        "retirement_candidate": false,
+        "retirement_reason": "already retired"
+      },
+      {
+        "interface": {
+          "id": "63ed90e3-42b4-431a-94db-e1254a52f9e2",
+          "interface_key": "mcp:create_workstream",
+          "interface_kind": "mcp_tool",
+          "legacy_since": "2026-07-10T13:19:44.205900Z",
+          "replacement_ref": "create_workplan",
+          "owner_component": "state-hub.mcp",
+          "status": "legacy",
+          "replacement_verified": true,
+          "manual_hold": false,
+          "hold_reason": null,
+          "notes": "Registered by STATE-WP-0070 T03 \u2014 zero-window streak starts at registration",
+          "retired_at": null,
+          "created_at": "2026-07-10T13:19:44.205900Z",
+          "updated_at": "2026-07-10T13:19:44.205900Z"
+        },
+        "all_time": {
+          "calls": 2,
+          "tenant_count": 1,
+          "user_count": 1,
+          "component_count": 1,
+          "tenants": {
+            "unknown": 2
+          },
+          "users": {
+            "unknown": 2
+          },
+          "components": {
+            "state-hub.mcp": 2
+          }
+        },
+        "window": {
+          "calls": 0,
+          "tenant_count": 0,
+          "user_count": 0,
+          "component_count": 0,
+          "tenants": {},
+          "users": {},
+          "components": {}
+        },
+        "last_seen_at": "2026-07-10T13:20:43.378546Z",
+        "retirement_candidate": true,
+        "retirement_reason": "no measured usage in review window"
+      },
+      {
+        "interface": {
+          "id": "b6a5fe44-fb85-4ef7-a273-78d09da777af",
+          "interface_key": "mcp:list_workstreams",
+          "interface_kind": "mcp_tool",
+          "legacy_since": "2026-07-10T13:19:26.075491Z",
+          "replacement_ref": "list_workplans",
+          "owner_component": "state-hub.mcp",
+          "status": "legacy",
+          "replacement_verified": true,
+          "manual_hold": false,
+          "hold_reason": null,
+          "notes": null,
+          "retired_at": null,
+          "created_at": "2026-07-10T13:19:26.075491Z",
+          "updated_at": "2026-07-10T13:19:26.075491Z"
+        },
+        "all_time": {
+          "calls": 2,
+          "tenant_count": 1,
+          "user_count": 1,
+          "component_count": 1,
+          "tenants": {
+            "unknown": 2
+          },
+          "users": {
+            "unknown": 2
+          },
+          "components": {
+            "state-hub.mcp": 2
+          }
+        },
+        "window": {
+          "calls": 0,
+          "tenant_count": 0,
+          "user_count": 0,
+          "component_count": 0,
+          "tenants": {},
+          "users": {},
+          "components": {}
+        },
+        "last_seen_at": "2026-07-10T13:20:42.374940Z",
+        "retirement_candidate": true,
+        "retirement_reason": "no measured usage in review window"
+      },
+      {
+        "interface": {
+          "id": "53c3372b-307d-4d6a-8ea4-bc36cacdcaf2",
+          "interface_key": "mcp:update_workstream",
+          "interface_kind": "mcp_tool",
+          "legacy_since": "2026-07-10T13:19:44.255216Z",
+          "replacement_ref": "update_workplan",
+          "owner_component": "state-hub.mcp",
+          "status": "legacy",
+          "replacement_verified": true,
+          "manual_hold": false,
+          "hold_reason": null,
+          "notes": "Registered by STATE-WP-0070 T03 \u2014 zero-window streak starts at registration",
+          "retired_at": null,
+          "created_at": "2026-07-10T13:19:44.255216Z",
+          "updated_at": "2026-07-10T13:19:44.255216Z"
+        },
+        "all_time": {
+          "calls": 0,
+          "tenant_count": 0,
+          "user_count": 0,
+          "component_count": 0,
+          "tenants": {},
+          "users": {},
+          "components": {}
+        },
+        "window": {
+          "calls": 0,
+          "tenant_count": 0,
+          "user_count": 0,
+          "component_count": 0,
+          "tenants": {},
+          "users": {},
+          "components": {}
+        },
+        "last_seen_at": null,
+        "retirement_candidate": true,
+        "retirement_reason": "no measured usage in review window"
+      },
+      {
+        "interface": {
+          "id": "bed4d08a-3471-48f5-9f0e-f9d550383a26",
+          "interface_key": "mcp:update_workstream_status",
+          "interface_kind": "mcp_tool",
+          "legacy_since": "2026-07-10T13:19:44.303612Z",
+          "replacement_ref": "update_workplan_status",
+          "owner_component": "state-hub.mcp",
+          "status": "legacy",
+          "replacement_verified": true,
+          "manual_hold": false,
+          "hold_reason": null,
+          "notes": "Registered by STATE-WP-0070 T03 \u2014 zero-window streak starts at registration",
+          "retired_at": null,
+          "created_at": "2026-07-10T13:19:44.303612Z",
+          "updated_at": "2026-07-10T13:19:44.303612Z"
+        },
+        "all_time": {
+          "calls": 0,
+          "tenant_count": 0,
+          "user_count": 0,
+          "component_count": 0,
+          "tenants": {},
+          "users": {},
+          "components": {}
+        },
+        "window": {
+          "calls": 0,
+          "tenant_count": 0,
+          "user_count": 0,
+          "component_count": 0,
+          "tenants": {},
+          "users": {},
+          "components": {}
+        },
+        "last_seen_at": null,
+        "retirement_candidate": true,
+        "retirement_reason": "no measured usage in review window"
+      },
+      {
+        "interface": {
+          "id": "46900dc2-0893-405b-ba59-80f31fb6ebb1",
+          "interface_key": "state://workstreams/{topic_slug}",
+          "interface_kind": "mcp_tool",
+          "legacy_since": "2026-07-10T13:19:44.344493Z",
+          "replacement_ref": "state://workplans/{topic_slug}",
+          "owner_component": "state-hub.mcp",
+          "status": "legacy",
+          "replacement_verified": true,
+          "manual_hold": false,
+          "hold_reason": null,
+          "notes": "Registered by STATE-WP-0070 T03 \u2014 zero-window streak starts at registration",
+          "retired_at": null,
+          "created_at": "2026-07-10T13:19:44.344493Z",
+          "updated_at": "2026-07-10T13:19:44.344493Z"
+        },
+        "all_time": {
+          "calls": 1,
+          "tenant_count": 1,
+          "user_count": 1,
+          "component_count": 1,
+          "tenants": {
+            "unknown": 1
+          },
+          "users": {
+            "unknown": 1
+          },
+          "components": {
+            "state-hub.mcp": 1
+          }
+        },
+        "window": {
+          "calls": 0,
+          "tenant_count": 0,
+          "user_count": 0,
+          "component_count": 0,
+          "tenants": {},
+          "users": {},
+          "components": {}
+        },
+        "last_seen_at": "2026-07-10T13:20:34.491811Z",
+        "retirement_candidate": true,
+        "retirement_reason": "no measured usage in review window"
+      },
+      {
+        "interface": {
+          "id": "cd9342fd-27e7-4a46-a1be-d41499e106a3",
+          "interface_key": "rest_api:DELETE /workstreams/{workstream_id}",
+          "interface_kind": "rest_api",
+          "legacy_since": "2026-06-06T17:28:13.052813Z",
+          "replacement_ref": "/workplans/{workplan_id}",
+          "owner_component": "state-hub.api",
+          "status": "legacy",
+          "replacement_verified": true,
+          "manual_hold": false,
+          "hold_reason": null,
+          "notes": null,
+          "retired_at": null,
+          "created_at": "2026-06-06T17:28:13.052813Z",
+          "updated_at": "2026-06-06T17:28:13.052813Z"
+        },
+        "all_time": {
+          "calls": 1,
+          "tenant_count": 1,
+          "user_count": 1,
+          "component_count": 1,
+          "tenants": {
+            "unknown": 1
+          },
+          "users": {
+            "unknown": 1
+          },
+          "components": {
+            "unknown": 1
+          }
+        },
+        "window": {
+          "calls": 0,
+          "tenant_count": 0,
+          "user_count": 0,
+          "component_count": 0,
+          "tenants": {},
+          "users": {},
+          "components": {}
+        },
+        "last_seen_at": "2026-06-06T17:28:13.047529Z",
+        "retirement_candidate": true,
+        "retirement_reason": "no measured usage in review window"
+      },
+      {
+        "interface": {
+          "id": "a4e0948c-cd4a-461e-8ae2-7fd7b51d04a7",
+          "interface_key": "rest_api:GET /decisions/?workstream_id",
+          "interface_kind": "rest_api",
+          "legacy_since": "2026-07-09T23:07:53.093223Z",
+          "replacement_ref": "/decisions/?workplan_id=<workplan_id>",
+          "owner_component": "state-hub.api",
+          "status": "legacy",
+          "replacement_verified": true,
+          "manual_hold": false,
+          "hold_reason": null,
+          "notes": null,
+          "retired_at": null,
+          "created_at": "2026-07-09T23:07:53.093223Z",
+          "updated_at": "2026-07-09T23:07:53.093223Z"
+        },
+        "all_time": {
+          "calls": 1,
+          "tenant_count": 1,
+          "user_count": 1,
+          "component_count": 1,
+          "tenants": {
+            "unknown": 1
+          },
+          "users": {
+            "unknown": 1
+          },
+          "components": {
+            "unknown": 1
+          }
+        },
+        "window": {
+          "calls": 0,
+          "tenant_count": 0,
+          "user_count": 0,
+          "component_count": 0,
+          "tenants": {},
+          "users": {},
+          "components": {}
+        },
+        "last_seen_at": "2026-07-09T23:07:53.083299Z",
+        "retirement_candidate": true,
+        "retirement_reason": "no measured usage in review window"
+      },
+      {
+        "interface": {
+          "id": "70a9346e-e0ee-42ac-874f-f160580b54dd",
+          "interface_key": "rest_api:GET /progress/?workstream_id",
+          "interface_kind": "rest_api",
+          "legacy_since": "2026-07-13T22:04:03.911449Z",
+          "replacement_ref": "/progress/?workplan_id=<workplan_id>",
+          "owner_component": "state-hub.api",
+          "status": "legacy",
+          "replacement_verified": true,
+          "manual_hold": false,
+          "hold_reason": null,
+          "notes": null,
+          "retired_at": null,
+          "created_at": "2026-07-13T22:04:03.911449Z",
+          "updated_at": "2026-07-13T22:04:03.911449Z"
+        },
+        "all_time": {
+          "calls": 1,
+          "tenant_count": 1,
+          "user_count": 1,
+          "component_count": 1,
+          "tenants": {
+            "unknown": 1
+          },
+          "users": {
+            "unknown": 1
+          },
+          "components": {
+            "unknown": 1
+          }
+        },
+        "window": {
+          "calls": 0,
+          "tenant_count": 0,
+          "user_count": 0,
+          "component_count": 0,
+          "tenants": {},
+          "users": {},
+          "components": {}
+        },
+        "last_seen_at": "2026-07-13T22:04:03.904998Z",
+        "retirement_candidate": true,
+        "retirement_reason": "no measured usage in review window"
+      },
+      {
+        "interface": {
+          "id": "be3cdcf8-250b-4bf0-801f-02ffd5f57e00",
+          "interface_key": "rest_api:GET /tasks/?workstream_id",
+          "interface_kind": "rest_api",
+          "legacy_since": "2026-07-08T19:32:21.628513Z",
+          "replacement_ref": "/tasks/?workplan_id=<workplan_id>",
+          "owner_component": "state-hub.api",
+          "status": "legacy",
+          "replacement_verified": true,
+          "manual_hold": false,
+          "hold_reason": null,
+          "notes": null,
+          "retired_at": null,
+          "created_at": "2026-07-08T19:32:21.628513Z",
+          "updated_at": "2026-07-08T19:32:21.628513Z"
+        },
+        "all_time": {
+          "calls": 587,
+          "tenant_count": 1,
+          "user_count": 1,
+          "component_count": 1,
+          "tenants": {
+            "unknown": 587
+          },
+          "users": {
+            "unknown": 587
+          },
+          "components": {
+            "unknown": 587
+          }
+        },
+        "window": {
+          "calls": 0,
+          "tenant_count": 0,
+          "user_count": 0,
+          "component_count": 0,
+          "tenants": {},
+          "users": {},
+          "components": {}
+        },
+        "last_seen_at": "2026-07-22T13:21:12.171828Z",
+        "retirement_candidate": true,
+        "retirement_reason": "no measured usage in review window"
+      },
+      {
+        "interface": {
+          "id": "3e4a3d0b-08fa-45c3-91e2-4f514a914b97",
+          "interface_key": "rest_api:GET /workstreams/",
+          "interface_kind": "rest_api",
+          "legacy_since": "2026-06-04T00:26:14.533764Z",
+          "replacement_ref": "/workplans/",
+          "owner_component": "state-hub.api",
+          "status": "legacy",
+          "replacement_verified": true,
+          "manual_hold": false,
+          "hold_reason": null,
+          "notes": null,
+          "retired_at": null,
+          "created_at": "2026-06-04T00:26:14.533764Z",
+          "updated_at": "2026-06-04T00:26:14.533764Z"
+        },
+        "all_time": {
+          "calls": 144084,
+          "tenant_count": 1,
+          "user_count": 1,
+          "component_count": 1,
+          "tenants": {
+            "unknown": 144084
+          },
+          "users": {
+            "unknown": 144084
+          },
+          "components": {
+            "unknown": 144084
+          }
+        },
+        "window": {
+          "calls": 0,
+          "tenant_count": 0,
+          "user_count": 0,
+          "component_count": 0,
+          "tenants": {},
+          "users": {},
+          "components": {}
+        },
+        "last_seen_at": "2026-07-08T21:14:39.652776Z",
+        "retirement_candidate": true,
+        "retirement_reason": "no measured usage in review window"
+      },
+      {
+        "interface": {
+          "id": "e4c140ec-7479-46f9-b185-4b533f19d639",
+          "interface_key": "rest_api:GET /workstreams/workplan-index",
+          "interface_kind": "rest_api",
+          "legacy_since": "2026-06-04T05:20:58.321869Z",
+          "replacement_ref": "/workplans/index",
+          "owner_component": "state-hub.api",
+          "status": "legacy",
+          "replacement_verified": true,
+          "manual_hold": false,
+          "hold_reason": null,
+          "notes": null,
+          "retired_at": null,
+          "created_at": "2026-06-04T05:20:58.321869Z",
+          "updated_at": "2026-06-04T05:20:58.321869Z"
+        },
+        "all_time": {
+          "calls": 30,
+          "tenant_count": 1,
+          "user_count": 1,
+          "component_count": 1,
+          "tenants": {
+            "unknown": 30
+          },
+          "users": {
+            "unknown": 30
+          },
+          "components": {
+            "unknown": 30
+          }
+        },
+        "window": {
+          "calls": 0,
+          "tenant_count": 0,
+          "user_count": 0,
+          "component_count": 0,
+          "tenants": {},
+          "users": {},
+          "components": {}
+        },
+        "last_seen_at": "2026-07-03T05:20:34.534439Z",
+        "retirement_candidate": true,
+        "retirement_reason": "no measured usage in review window"
+      },
+      {
+        "interface": {
+          "id": "3a00b19e-e7db-4403-98aa-a77c9ab61ecc",
+          "interface_key": "rest_api:GET /workstreams/{workstream_id}",
+          "interface_kind": "rest_api",
+          "legacy_since": "2026-06-04T00:25:59.014966Z",
+          "replacement_ref": "/workplans/{workplan_id}",
+          "owner_component": "state-hub.api",
+          "status": "legacy",
+          "replacement_verified": true,
+          "manual_hold": false,
+          "hold_reason": null,
+          "notes": null,
+          "retired_at": null,
+          "created_at": "2026-06-04T00:25:59.014966Z",
+          "updated_at": "2026-06-04T00:25:59.014966Z"
+        },
+        "all_time": {
+          "calls": 511405,
+          "tenant_count": 1,
+          "user_count": 1,
+          "component_count": 1,
+          "tenants": {
+            "unknown": 511405
+          },
+          "users": {
+            "unknown": 511405
+          },
+          "components": {
+            "unknown": 511405
+          }
+        },
+        "window": {
+          "calls": 0,
+          "tenant_count": 0,
+          "user_count": 0,
+          "component_count": 0,
+          "tenants": {},
+          "users": {},
+          "components": {}
+        },
+        "last_seen_at": "2026-07-08T21:14:20.781103Z",
+        "retirement_candidate": true,
+        "retirement_reason": "no measured usage in review window"
+      },
+      {
+        "interface": {
+          "id": "69e1a255-a8b9-4101-8a68-b1bed23abfda",
+          "interface_key": "rest_api:GET /workstreams/{workstream_id}/dependencies/",
+          "interface_kind": "rest_api",
+          "legacy_since": "2026-06-04T00:25:59.291135Z",
+          "replacement_ref": "/workplans/{workplan_id}/dependencies/",
+          "owner_component": "state-hub.api",
+          "status": "legacy",
+          "replacement_verified": true,
+          "manual_hold": false,
+          "hold_reason": null,
+          "notes": null,
+          "retired_at": null,
+          "created_at": "2026-06-04T00:25:59.291135Z",
+          "updated_at": "2026-06-04T00:25:59.291135Z"
+        },
+        "all_time": {
+          "calls": 255865,
+          "tenant_count": 1,
+          "user_count": 1,
+          "component_count": 1,
+          "tenants": {
+            "unknown": 255865
+          },
+          "users": {
+            "unknown": 255865
+          },
+          "components": {
+            "unknown": 255865
+          }
+        },
+        "window": {
+          "calls": 0,
+          "tenant_count": 0,
+          "user_count": 0,
+          "component_count": 0,
+          "tenants": {},
+          "users": {},
+          "components": {}
+        },
+        "last_seen_at": "2026-07-08T21:14:12.747005Z",
+        "retirement_candidate": true,
+        "retirement_reason": "no measured usage in review window"
+      },
+      {
+        "interface": {
+          "id": "b1aae931-b51f-4a85-a723-865dd65f6132",
+          "interface_key": "rest_api:PATCH /workstreams/{workstream_id}",
+          "interface_kind": "rest_api",
+          "legacy_since": "2026-06-04T06:09:41.901035Z",
+          "replacement_ref": "/workplans/{workplan_id}",
+          "owner_component": "state-hub.api",
+          "status": "legacy",
+          "replacement_verified": true,
+          "manual_hold": false,
+          "hold_reason": null,
+          "notes": null,
+          "retired_at": null,
+          "created_at": "2026-06-04T06:09:41.901035Z",
+          "updated_at": "2026-06-04T06:09:41.901035Z"
+        },
+        "all_time": {
+          "calls": 571,
+          "tenant_count": 1,
+          "user_count": 1,
+          "component_count": 1,
+          "tenants": {
+            "unknown": 571
+          },
+          "users": {
+            "unknown": 571
+          },
+          "components": {
+            "unknown": 571
+          }
+        },
+        "window": {
+          "calls": 0,
+          "tenant_count": 0,
+          "user_count": 0,
+          "component_count": 0,
+          "tenants": {},
+          "users": {},
+          "components": {}
+        },
+        "last_seen_at": "2026-07-08T20:49:12.335710Z",
+        "retirement_candidate": true,
+        "retirement_reason": "no measured usage in review window"
+      },
+      {
+        "interface": {
+          "id": "4aea9591-970b-4918-ac4a-4da95a0a1a8c",
+          "interface_key": "rest_api:POST /decisions/ workstream_id",
+          "interface_kind": "rest_api",
+          "legacy_since": "2026-07-09T22:56:35.473130Z",
+          "replacement_ref": "POST /decisions/ with workplan_id",
+          "owner_component": "state-hub.api",
+          "status": "legacy",
+          "replacement_verified": true,
+          "manual_hold": false,
+          "hold_reason": null,
+          "notes": null,
+          "retired_at": null,
+          "created_at": "2026-07-09T22:56:35.473130Z",
+          "updated_at": "2026-07-09T22:56:35.473130Z"
+        },
+        "all_time": {
+          "calls": 3,
+          "tenant_count": 1,
+          "user_count": 1,
+          "component_count": 1,
+          "tenants": {
+            "unknown": 3
+          },
+          "users": {
+            "unknown": 3
+          },
+          "components": {
+            "unknown": 3
+          }
+        },
+        "window": {
+          "calls": 0,
+          "tenant_count": 0,
+          "user_count": 0,
+          "component_count": 0,
+          "tenants": {},
+          "users": {},
+          "components": {}
+        },
+        "last_seen_at": "2026-07-09T22:57:05.912456Z",
+        "retirement_candidate": true,
+        "retirement_reason": "no measured usage in review window"
+      },
+      {
+        "interface": {
+          "id": "4a70583c-1e41-4ec1-99a9-728856a7d79c",
+          "interface_key": "rest_api:POST /progress/ workstream_id",
+          "interface_kind": "rest_api",
+          "legacy_since": "2026-07-08T23:35:09.148333Z",
+          "replacement_ref": "POST /progress/ with workplan_id",
+          "owner_component": "state-hub.api",
+          "status": "legacy",
+          "replacement_verified": true,
+          "manual_hold": false,
+          "hold_reason": null,
+          "notes": null,
+          "retired_at": null,
+          "created_at": "2026-07-08T23:35:09.148333Z",
+          "updated_at": "2026-07-08T23:35:09.148333Z"
+        },
+        "all_time": {
+          "calls": 14,
+          "tenant_count": 1,
+          "user_count": 1,
+          "component_count": 1,
+          "tenants": {
+            "unknown": 14
+          },
+          "users": {
+            "unknown": 14
+          },
+          "components": {
+            "unknown": 14
+          }
+        },
+        "window": {
+          "calls": 0,
+          "tenant_count": 0,
+          "user_count": 0,
+          "component_count": 0,
+          "tenants": {},
+          "users": {},
+          "components": {}
+        },
+        "last_seen_at": "2026-07-10T08:34:42.959724Z",
+        "retirement_candidate": true,
+        "retirement_reason": "no measured usage in review window"
+      },
+      {
+        "interface": {
+          "id": "6df4e443-7bf1-461a-923b-a6eb52fe7b07",
+          "interface_key": "rest_api:POST /tasks/ workstream_id",
+          "interface_kind": "rest_api",
+          "legacy_since": "2026-07-08T22:38:29.405720Z",
+          "replacement_ref": "POST /tasks/ with workplan_id",
+          "owner_component": "state-hub.api",
+          "status": "legacy",
+          "replacement_verified": true,
+          "manual_hold": false,
+          "hold_reason": null,
+          "notes": null,
+          "retired_at": null,
+          "created_at": "2026-07-08T22:38:29.405720Z",
+          "updated_at": "2026-07-08T22:38:29.405720Z"
+        },
+        "all_time": {
+          "calls": 5,
+          "tenant_count": 1,
+          "user_count": 1,
+          "component_count": 1,
+          "tenants": {
+            "unknown": 5
+          },
+          "users": {
+            "unknown": 5
+          },
+          "components": {
+            "state-hub.fix-consistency": 5
+          }
+        },
+        "window": {
+          "calls": 0,
+          "tenant_count": 0,
+          "user_count": 0,
+          "component_count": 0,
+          "tenants": {},
+          "users": {},
+          "components": {}
+        },
+        "last_seen_at": "2026-07-08T22:38:29.976918Z",
+        "retirement_candidate": true,
+        "retirement_reason": "no measured usage in review window"
+      },
+      {
+        "interface": {
+          "id": "ed6451c9-d2cc-4486-9afe-d3852782cabc",
+          "interface_key": "rest_api:POST /workstreams/",
+          "interface_kind": "rest_api",
+          "legacy_since": "2026-06-04T07:40:24.168535Z",
+          "replacement_ref": "/workplans/",
+          "owner_component": "state-hub.api",
+          "status": "legacy",
+          "replacement_verified": true,
+          "manual_hold": false,
+          "hold_reason": null,
+          "notes": null,
+          "retired_at": null,
+          "created_at": "2026-06-04T07:40:24.168535Z",
+          "updated_at": "2026-06-04T07:40:24.168535Z"
+        },
+        "all_time": {
+          "calls": 824,
+          "tenant_count": 1,
+          "user_count": 1,
+          "component_count": 1,
+          "tenants": {
+            "unknown": 824
+          },
+          "users": {
+            "unknown": 824
+          },
+          "components": {
+            "unknown": 824
+          }
+        },
+        "window": {
+          "calls": 0,
+          "tenant_count": 0,
+          "user_count": 0,
+          "component_count": 0,
+          "tenants": {},
+          "users": {},
+          "components": {}
+        },
+        "last_seen_at": "2026-07-08T20:38:05.903144Z",
+        "retirement_candidate": true,
+        "retirement_reason": "no measured usage in review window"
+      },
+      {
+        "interface": {
+          "id": "281fd706-b192-4194-8055-2d8733c115f9",
+          "interface_key": "rest_api:POST /workstreams/{workstream_id}/dependencies/",
+          "interface_kind": "rest_api",
+          "legacy_since": "2026-06-04T22:57:37.149207Z",
+          "replacement_ref": "/workplans/{workplan_id}/dependencies/",
+          "owner_component": "state-hub.api",
+          "status": "legacy",
+          "replacement_verified": true,
+          "manual_hold": false,
+          "hold_reason": null,
+          "notes": null,
+          "retired_at": null,
+          "created_at": "2026-06-04T22:57:37.149207Z",
+          "updated_at": "2026-06-04T22:57:37.149207Z"
+        },
+        "all_time": {
+          "calls": 4971,
+          "tenant_count": 1,
+          "user_count": 1,
+          "component_count": 1,
+          "tenants": {
+            "unknown": 4971
+          },
+          "users": {
+            "unknown": 4971
+          },
+          "components": {
+            "unknown": 4971
+          }
+        },
+        "window": {
+          "calls": 0,
+          "tenant_count": 0,
+          "user_count": 0,
+          "component_count": 0,
+          "tenants": {},
+          "users": {},
+          "components": {}
+        },
+        "last_seen_at": "2026-07-01T22:09:24.229011Z",
+        "retirement_candidate": true,
+        "retirement_reason": "no measured usage in review window"
+      }
+    ],
+    "retirement_candidates": [
+      {
+        "interface": {
+          "id": "63ed90e3-42b4-431a-94db-e1254a52f9e2",
+          "interface_key": "mcp:create_workstream",
+          "interface_kind": "mcp_tool",
+          "legacy_since": "2026-07-10T13:19:44.205900Z",
+          "replacement_ref": "create_workplan",
+          "owner_component": "state-hub.mcp",
+          "status": "legacy",
+          "replacement_verified": true,
+          "manual_hold": false,
+          "hold_reason": null,
+          "notes": "Registered by STATE-WP-0070 T03 \u2014 zero-window streak starts at registration",
+          "retired_at": null,
+          "created_at": "2026-07-10T13:19:44.205900Z",
+          "updated_at": "2026-07-10T13:19:44.205900Z"
+        },
+        "all_time": {
+          "calls": 2,
+          "tenant_count": 1,
+          "user_count": 1,
+          "component_count": 1,
+          "tenants": {
+            "unknown": 2
+          },
+          "users": {
+            "unknown": 2
+          },
+          "components": {
+            "state-hub.mcp": 2
+          }
+        },
+        "window": {
+          "calls": 0,
+          "tenant_count": 0,
+          "user_count": 0,
+          "component_count": 0,
+          "tenants": {},
+          "users": {},
+          "components": {}
+        },
+        "last_seen_at": "2026-07-10T13:20:43.378546Z",
+        "retirement_candidate": true,
+        "retirement_reason": "no measured usage in review window"
+      },
+      {
+        "interface": {
+          "id": "b6a5fe44-fb85-4ef7-a273-78d09da777af",
+          "interface_key": "mcp:list_workstreams",
+          "interface_kind": "mcp_tool",
+          "legacy_since": "2026-07-10T13:19:26.075491Z",
+          "replacement_ref": "list_workplans",
+          "owner_component": "state-hub.mcp",
+          "status": "legacy",
+          "replacement_verified": true,
+          "manual_hold": false,
+          "hold_reason": null,
+          "notes": null,
+          "retired_at": null,
+          "created_at": "2026-07-10T13:19:26.075491Z",
+          "updated_at": "2026-07-10T13:19:26.075491Z"
+        },
+        "all_time": {
+          "calls": 2,
+          "tenant_count": 1,
+          "user_count": 1,
+          "component_count": 1,
+          "tenants": {
+            "unknown": 2
+          },
+          "users": {
+            "unknown": 2
+          },
+          "components": {
+            "state-hub.mcp": 2
+          }
+        },
+        "window": {
+          "calls": 0,
+          "tenant_count": 0,
+          "user_count": 0,
+          "component_count": 0,
+          "tenants": {},
+          "users": {},
+          "components": {}
+        },
+        "last_seen_at": "2026-07-10T13:20:42.374940Z",
+        "retirement_candidate": true,
+        "retirement_reason": "no measured usage in review window"
+      },
+      {
+        "interface": {
+          "id": "53c3372b-307d-4d6a-8ea4-bc36cacdcaf2",
+          "interface_key": "mcp:update_workstream",
+          "interface_kind": "mcp_tool",
+          "legacy_since": "2026-07-10T13:19:44.255216Z",
+          "replacement_ref": "update_workplan",
+          "owner_component": "state-hub.mcp",
+          "status": "legacy",
+          "replacement_verified": true,
+          "manual_hold": false,
+          "hold_reason": null,
+          "notes": "Registered by STATE-WP-0070 T03 \u2014 zero-window streak starts at registration",
+          "retired_at": null,
+          "created_at": "2026-07-10T13:19:44.255216Z",
+          "updated_at": "2026-07-10T13:19:44.255216Z"
+        },
+        "all_time": {
+          "calls": 0,
+          "tenant_count": 0,
+          "user_count": 0,
+          "component_count": 0,
+          "tenants": {},
+          "users": {},
+          "components": {}
+        },
+        "window": {
+          "calls": 0,
+          "tenant_count": 0,
+          "user_count": 0,
+          "component_count": 0,
+          "tenants": {},
+          "users": {},
+          "components": {}
+        },
+        "last_seen_at": null,
+        "retirement_candidate": true,
+        "retirement_reason": "no measured usage in review window"
+      },
+      {
+        "interface": {
+          "id": "bed4d08a-3471-48f5-9f0e-f9d550383a26",
+          "interface_key": "mcp:update_workstream_status",
+          "interface_kind": "mcp_tool",
+          "legacy_since": "2026-07-10T13:19:44.303612Z",
+          "replacement_ref": "update_workplan_status",
+          "owner_component": "state-hub.mcp",
+          "status": "legacy",
+          "replacement_verified": true,
+          "manual_hold": false,
+          "hold_reason": null,
+          "notes": "Registered by STATE-WP-0070 T03 \u2014 zero-window streak starts at registration",
+          "retired_at": null,
+          "created_at": "2026-07-10T13:19:44.303612Z",
+          "updated_at": "2026-07-10T13:19:44.303612Z"
+        },
+        "all_time": {
+          "calls": 0,
+          "tenant_count": 0,
+          "user_count": 0,
+          "component_count": 0,
+          "tenants": {},
+          "users": {},
+          "components": {}
+        },
+        "window": {
+          "calls": 0,
+          "tenant_count": 0,
+          "user_count": 0,
+          "component_count": 0,
+          "tenants": {},
+          "users": {},
+          "components": {}
+        },
+        "last_seen_at": null,
+        "retirement_candidate": true,
+        "retirement_reason": "no measured usage in review window"
+      },
+      {
+        "interface": {
+          "id": "46900dc2-0893-405b-ba59-80f31fb6ebb1",
+          "interface_key": "state://workstreams/{topic_slug}",
+          "interface_kind": "mcp_tool",
+          "legacy_since": "2026-07-10T13:19:44.344493Z",
+          "replacement_ref": "state://workplans/{topic_slug}",
+          "owner_component": "state-hub.mcp",
+          "status": "legacy",
+          "replacement_verified": true,
+          "manual_hold": false,
+          "hold_reason": null,
+          "notes": "Registered by STATE-WP-0070 T03 \u2014 zero-window streak starts at registration",
+          "retired_at": null,
+          "created_at": "2026-07-10T13:19:44.344493Z",
+          "updated_at": "2026-07-10T13:19:44.344493Z"
+        },
+        "all_time": {
+          "calls": 1,
+          "tenant_count": 1,
+          "user_count": 1,
+          "component_count": 1,
+          "tenants": {
+            "unknown": 1
+          },
+          "users": {
+            "unknown": 1
+          },
+          "components": {
+            "state-hub.mcp": 1
+          }
+        },
+        "window": {
+          "calls": 0,
+          "tenant_count": 0,
+          "user_count": 0,
+          "component_count": 0,
+          "tenants": {},
+          "users": {},
+          "components": {}
+        },
+        "last_seen_at": "2026-07-10T13:20:34.491811Z",
+        "retirement_candidate": true,
+        "retirement_reason": "no measured usage in review window"
+      },
+      {
+        "interface": {
+          "id": "cd9342fd-27e7-4a46-a1be-d41499e106a3",
+          "interface_key": "rest_api:DELETE /workstreams/{workstream_id}",
+          "interface_kind": "rest_api",
+          "legacy_since": "2026-06-06T17:28:13.052813Z",
+          "replacement_ref": "/workplans/{workplan_id}",
+          "owner_component": "state-hub.api",
+          "status": "legacy",
+          "replacement_verified": true,
+          "manual_hold": false,
+          "hold_reason": null,
+          "notes": null,
+          "retired_at": null,
+          "created_at": "2026-06-06T17:28:13.052813Z",
+          "updated_at": "2026-06-06T17:28:13.052813Z"
+        },
+        "all_time": {
+          "calls": 1,
+          "tenant_count": 1,
+          "user_count": 1,
+          "component_count": 1,
+          "tenants": {
+            "unknown": 1
+          },
+          "users": {
+            "unknown": 1
+          },
+          "components": {
+            "unknown": 1
+          }
+        },
+        "window": {
+          "calls": 0,
+          "tenant_count": 0,
+          "user_count": 0,
+          "component_count": 0,
+          "tenants": {},
+          "users": {},
+          "components": {}
+        },
+        "last_seen_at": "2026-06-06T17:28:13.047529Z",
+        "retirement_candidate": true,
+        "retirement_reason": "no measured usage in review window"
+      },
+      {
+        "interface": {
+          "id": "a4e0948c-cd4a-461e-8ae2-7fd7b51d04a7",
+          "interface_key": "rest_api:GET /decisions/?workstream_id",
+          "interface_kind": "rest_api",
+          "legacy_since": "2026-07-09T23:07:53.093223Z",
+          "replacement_ref": "/decisions/?workplan_id=<workplan_id>",
+          "owner_component": "state-hub.api",
+          "status": "legacy",
+          "replacement_verified": true,
+          "manual_hold": false,
+          "hold_reason": null,
+          "notes": null,
+          "retired_at": null,
+          "created_at": "2026-07-09T23:07:53.093223Z",
+          "updated_at": "2026-07-09T23:07:53.093223Z"
+        },
+        "all_time": {
+          "calls": 1,
+          "tenant_count": 1,
+          "user_count": 1,
+          "component_count": 1,
+          "tenants": {
+            "unknown": 1
+          },
+          "users": {
+            "unknown": 1
+          },
+          "components": {
+            "unknown": 1
+          }
+        },
+        "window": {
+          "calls": 0,
+          "tenant_count": 0,
+          "user_count": 0,
+          "component_count": 0,
+          "tenants": {},
+          "users": {},
+          "components": {}
+        },
+        "last_seen_at": "2026-07-09T23:07:53.083299Z",
+        "retirement_candidate": true,
+        "retirement_reason": "no measured usage in review window"
+      },
+      {
+        "interface": {
+          "id": "70a9346e-e0ee-42ac-874f-f160580b54dd",
+          "interface_key": "rest_api:GET /progress/?workstream_id",
+          "interface_kind": "rest_api",
+          "legacy_since": "2026-07-13T22:04:03.911449Z",
+          "replacement_ref": "/progress/?workplan_id=<workplan_id>",
+          "owner_component": "state-hub.api",
+          "status": "legacy",
+          "replacement_verified": true,
+          "manual_hold": false,
+          "hold_reason": null,
+          "notes": null,
+          "retired_at": null,
+          "created_at": "2026-07-13T22:04:03.911449Z",
+          "updated_at": "2026-07-13T22:04:03.911449Z"
+        },
+        "all_time": {
+          "calls": 1,
+          "tenant_count": 1,
+          "user_count": 1,
+          "component_count": 1,
+          "tenants": {
+            "unknown": 1
+          },
+          "users": {
+            "unknown": 1
+          },
+          "components": {
+            "unknown": 1
+          }
+        },
+        "window": {
+          "calls": 0,
+          "tenant_count": 0,
+          "user_count": 0,
+          "component_count": 0,
+          "tenants": {},
+          "users": {},
+          "components": {}
+        },
+        "last_seen_at": "2026-07-13T22:04:03.904998Z",
+        "retirement_candidate": true,
+        "retirement_reason": "no measured usage in review window"
+      },
+      {
+        "interface": {
+          "id": "be3cdcf8-250b-4bf0-801f-02ffd5f57e00",
+          "interface_key": "rest_api:GET /tasks/?workstream_id",
+          "interface_kind": "rest_api",
+          "legacy_since": "2026-07-08T19:32:21.628513Z",
+          "replacement_ref": "/tasks/?workplan_id=<workplan_id>",
+          "owner_component": "state-hub.api",
+          "status": "legacy",
+          "replacement_verified": true,
+          "manual_hold": false,
+          "hold_reason": null,
+          "notes": null,
+          "retired_at": null,
+          "created_at": "2026-07-08T19:32:21.628513Z",
+          "updated_at": "2026-07-08T19:32:21.628513Z"
+        },
+        "all_time": {
+          "calls": 587,
+          "tenant_count": 1,
+          "user_count": 1,
+          "component_count": 1,
+          "tenants": {
+            "unknown": 587
+          },
+          "users": {
+            "unknown": 587
+          },
+          "components": {
+            "unknown": 587
+          }
+        },
+        "window": {
+          "calls": 0,
+          "tenant_count": 0,
+          "user_count": 0,
+          "component_count": 0,
+          "tenants": {},
+          "users": {},
+          "components": {}
+        },
+        "last_seen_at": "2026-07-22T13:21:12.171828Z",
+        "retirement_candidate": true,
+        "retirement_reason": "no measured usage in review window"
+      },
+      {
+        "interface": {
+          "id": "3e4a3d0b-08fa-45c3-91e2-4f514a914b97",
+          "interface_key": "rest_api:GET /workstreams/",
+          "interface_kind": "rest_api",
+          "legacy_since": "2026-06-04T00:26:14.533764Z",
+          "replacement_ref": "/workplans/",
+          "owner_component": "state-hub.api",
+          "status": "legacy",
+          "replacement_verified": true,
+          "manual_hold": false,
+          "hold_reason": null,
+          "notes": null,
+          "retired_at": null,
+          "created_at": "2026-06-04T00:26:14.533764Z",
+          "updated_at": "2026-06-04T00:26:14.533764Z"
+        },
+        "all_time": {
+          "calls": 144084,
+          "tenant_count": 1,
+          "user_count": 1,
+          "component_count": 1,
+          "tenants": {
+            "unknown": 144084
+          },
+          "users": {
+            "unknown": 144084
+          },
+          "components": {
+            "unknown": 144084
+          }
+        },
+        "window": {
+          "calls": 0,
+          "tenant_count": 0,
+          "user_count": 0,
+          "component_count": 0,
+          "tenants": {},
+          "users": {},
+          "components": {}
+        },
+        "last_seen_at": "2026-07-08T21:14:39.652776Z",
+        "retirement_candidate": true,
+        "retirement_reason": "no measured usage in review window"
+      },
+      {
+        "interface": {
+          "id": "e4c140ec-7479-46f9-b185-4b533f19d639",
+          "interface_key": "rest_api:GET /workstreams/workplan-index",
+          "interface_kind": "rest_api",
+          "legacy_since": "2026-06-04T05:20:58.321869Z",
+          "replacement_ref": "/workplans/index",
+          "owner_component": "state-hub.api",
+          "status": "legacy",
+          "replacement_verified": true,
+          "manual_hold": false,
+          "hold_reason": null,
+          "notes": null,
+          "retired_at": null,
+          "created_at": "2026-06-04T05:20:58.321869Z",
+          "updated_at": "2026-06-04T05:20:58.321869Z"
+        },
+        "all_time": {
+          "calls": 30,
+          "tenant_count": 1,
+          "user_count": 1,
+          "component_count": 1,
+          "tenants": {
+            "unknown": 30
+          },
+          "users": {
+            "unknown": 30
+          },
+          "components": {
+            "unknown": 30
+          }
+        },
+        "window": {
+          "calls": 0,
+          "tenant_count": 0,
+          "user_count": 0,
+          "component_count": 0,
+          "tenants": {},
+          "users": {},
+          "components": {}
+        },
+        "last_seen_at": "2026-07-03T05:20:34.534439Z",
+        "retirement_candidate": true,
+        "retirement_reason": "no measured usage in review window"
+      },
+      {
+        "interface": {
+          "id": "3a00b19e-e7db-4403-98aa-a77c9ab61ecc",
+          "interface_key": "rest_api:GET /workstreams/{workstream_id}",
+          "interface_kind": "rest_api",
+          "legacy_since": "2026-06-04T00:25:59.014966Z",
+          "replacement_ref": "/workplans/{workplan_id}",
+          "owner_component": "state-hub.api",
+          "status": "legacy",
+          "replacement_verified": true,
+          "manual_hold": false,
+          "hold_reason": null,
+          "notes": null,
+          "retired_at": null,
+          "created_at": "2026-06-04T00:25:59.014966Z",
+          "updated_at": "2026-06-04T00:25:59.014966Z"
+        },
+        "all_time": {
+          "calls": 511405,
+          "tenant_count": 1,
+          "user_count": 1,
+          "component_count": 1,
+          "tenants": {
+            "unknown": 511405
+          },
+          "users": {
+            "unknown": 511405
+          },
+          "components": {
+            "unknown": 511405
+          }
+        },
+        "window": {
+          "calls": 0,
+          "tenant_count": 0,
+          "user_count": 0,
+          "component_count": 0,
+          "tenants": {},
+          "users": {},
+          "components": {}
+        },
+        "last_seen_at": "2026-07-08T21:14:20.781103Z",
+        "retirement_candidate": true,
+        "retirement_reason": "no measured usage in review window"
+      },
+      {
+        "interface": {
+          "id": "69e1a255-a8b9-4101-8a68-b1bed23abfda",
+          "interface_key": "rest_api:GET /workstreams/{workstream_id}/dependencies/",
+          "interface_kind": "rest_api",
+          "legacy_since": "2026-06-04T00:25:59.291135Z",
+          "replacement_ref": "/workplans/{workplan_id}/dependencies/",
+          "owner_component": "state-hub.api",
+          "status": "legacy",
+          "replacement_verified": true,
+          "manual_hold": false,
+          "hold_reason": null,
+          "notes": null,
+          "retired_at": null,
+          "created_at": "2026-06-04T00:25:59.291135Z",
+          "updated_at": "2026-06-04T00:25:59.291135Z"
+        },
+        "all_time": {
+          "calls": 255865,
+          "tenant_count": 1,
+          "user_count": 1,
+          "component_count": 1,
+          "tenants": {
+            "unknown": 255865
+          },
+          "users": {
+            "unknown": 255865
+          },
+          "components": {
+            "unknown": 255865
+          }
+        },
+        "window": {
+          "calls": 0,
+          "tenant_count": 0,
+          "user_count": 0,
+          "component_count": 0,
+          "tenants": {},
+          "users": {},
+          "components": {}
+        },
+        "last_seen_at": "2026-07-08T21:14:12.747005Z",
+        "retirement_candidate": true,
+        "retirement_reason": "no measured usage in review window"
+      },
+      {
+        "interface": {
+          "id": "b1aae931-b51f-4a85-a723-865dd65f6132",
+          "interface_key": "rest_api:PATCH /workstreams/{workstream_id}",
+          "interface_kind": "rest_api",
+          "legacy_since": "2026-06-04T06:09:41.901035Z",
+          "replacement_ref": "/workplans/{workplan_id}",
+          "owner_component": "state-hub.api",
+          "status": "legacy",
+          "replacement_verified": true,
+          "manual_hold": false,
+          "hold_reason": null,
+          "notes": null,
+          "retired_at": null,
+          "created_at": "2026-06-04T06:09:41.901035Z",
+          "updated_at": "2026-06-04T06:09:41.901035Z"
+        },
+        "all_time": {
+          "calls": 571,
+          "tenant_count": 1,
+          "user_count": 1,
+          "component_count": 1,
+          "tenants": {
+            "unknown": 571
+          },
+          "users": {
+            "unknown": 571
+          },
+          "components": {
+            "unknown": 571
+          }
+        },
+        "window": {
+          "calls": 0,
+          "tenant_count": 0,
+          "user_count": 0,
+          "component_count": 0,
+          "tenants": {},
+          "users": {},
+          "components": {}
+        },
+        "last_seen_at": "2026-07-08T20:49:12.335710Z",
+        "retirement_candidate": true,
+        "retirement_reason": "no measured usage in review window"
+      },
+      {
+        "interface": {
+          "id": "4aea9591-970b-4918-ac4a-4da95a0a1a8c",
+          "interface_key": "rest_api:POST /decisions/ workstream_id",
+          "interface_kind": "rest_api",
+          "legacy_since": "2026-07-09T22:56:35.473130Z",
+          "replacement_ref": "POST /decisions/ with workplan_id",
+          "owner_component": "state-hub.api",
+          "status": "legacy",
+          "replacement_verified": true,
+          "manual_hold": false,
+          "hold_reason": null,
+          "notes": null,
+          "retired_at": null,
+          "created_at": "2026-07-09T22:56:35.473130Z",
+          "updated_at": "2026-07-09T22:56:35.473130Z"
+        },
+        "all_time": {
+          "calls": 3,
+          "tenant_count": 1,
+          "user_count": 1,
+          "component_count": 1,
+          "tenants": {
+            "unknown": 3
+          },
+          "users": {
+            "unknown": 3
+          },
+          "components": {
+            "unknown": 3
+          }
+        },
+        "window": {
+          "calls": 0,
+          "tenant_count": 0,
+          "user_count": 0,
+          "component_count": 0,
+          "tenants": {},
+          "users": {},
+          "components": {}
+        },
+        "last_seen_at": "2026-07-09T22:57:05.912456Z",
+        "retirement_candidate": true,
+        "retirement_reason": "no measured usage in review window"
+      },
+      {
+        "interface": {
+          "id": "4a70583c-1e41-4ec1-99a9-728856a7d79c",
+          "interface_key": "rest_api:POST /progress/ workstream_id",
+          "interface_kind": "rest_api",
+          "legacy_since": "2026-07-08T23:35:09.148333Z",
+          "replacement_ref": "POST /progress/ with workplan_id",
+          "owner_component": "state-hub.api",
+          "status": "legacy",
+          "replacement_verified": true,
+          "manual_hold": false,
+          "hold_reason": null,
+          "notes": null,
+          "retired_at": null,
+          "created_at": "2026-07-08T23:35:09.148333Z",
+          "updated_at": "2026-07-08T23:35:09.148333Z"
+        },
+        "all_time": {
+          "calls": 14,
+          "tenant_count": 1,
+          "user_count": 1,
+          "component_count": 1,
+          "tenants": {
+            "unknown": 14
+          },
+          "users": {
+            "unknown": 14
+          },
+          "components": {
+            "unknown": 14
+          }
+        },
+        "window": {
+          "calls": 0,
+          "tenant_count": 0,
+          "user_count": 0,
+          "component_count": 0,
+          "tenants": {},
+          "users": {},
+          "components": {}
+        },
+        "last_seen_at": "2026-07-10T08:34:42.959724Z",
+        "retirement_candidate": true,
+        "retirement_reason": "no measured usage in review window"
+      },
+      {
+        "interface": {
+          "id": "6df4e443-7bf1-461a-923b-a6eb52fe7b07",
+          "interface_key": "rest_api:POST /tasks/ workstream_id",
+          "interface_kind": "rest_api",
+          "legacy_since": "2026-07-08T22:38:29.405720Z",
+          "replacement_ref": "POST /tasks/ with workplan_id",
+          "owner_component": "state-hub.api",
+          "status": "legacy",
+          "replacement_verified": true,
+          "manual_hold": false,
+          "hold_reason": null,
+          "notes": null,
+          "retired_at": null,
+          "created_at": "2026-07-08T22:38:29.405720Z",
+          "updated_at": "2026-07-08T22:38:29.405720Z"
+        },
+        "all_time": {
+          "calls": 5,
+          "tenant_count": 1,
+          "user_count": 1,
+          "component_count": 1,
+          "tenants": {
+            "unknown": 5
+          },
+          "users": {
+            "unknown": 5
+          },
+          "components": {
+            "state-hub.fix-consistency": 5
+          }
+        },
+        "window": {
+          "calls": 0,
+          "tenant_count": 0,
+          "user_count": 0,
+          "component_count": 0,
+          "tenants": {},
+          "users": {},
+          "components": {}
+        },
+        "last_seen_at": "2026-07-08T22:38:29.976918Z",
+        "retirement_candidate": true,
+        "retirement_reason": "no measured usage in review window"
+      },
+      {
+        "interface": {
+          "id": "ed6451c9-d2cc-4486-9afe-d3852782cabc",
+          "interface_key": "rest_api:POST /workstreams/",
+          "interface_kind": "rest_api",
+          "legacy_since": "2026-06-04T07:40:24.168535Z",
+          "replacement_ref": "/workplans/",
+          "owner_component": "state-hub.api",
+          "status": "legacy",
+          "replacement_verified": true,
+          "manual_hold": false,
+          "hold_reason": null,
+          "notes": null,
+          "retired_at": null,
+          "created_at": "2026-06-04T07:40:24.168535Z",
+          "updated_at": "2026-06-04T07:40:24.168535Z"
+        },
+        "all_time": {
+          "calls": 824,
+          "tenant_count": 1,
+          "user_count": 1,
+          "component_count": 1,
+          "tenants": {
+            "unknown": 824
+          },
+          "users": {
+            "unknown": 824
+          },
+          "components": {
+            "unknown": 824
+          }
+        },
+        "window": {
+          "calls": 0,
+          "tenant_count": 0,
+          "user_count": 0,
+          "component_count": 0,
+          "tenants": {},
+          "users": {},
+          "components": {}
+        },
+        "last_seen_at": "2026-07-08T20:38:05.903144Z",
+        "retirement_candidate": true,
+        "retirement_reason": "no measured usage in review window"
+      },
+      {
+        "interface": {
+          "id": "281fd706-b192-4194-8055-2d8733c115f9",
+          "interface_key": "rest_api:POST /workstreams/{workstream_id}/dependencies/",
+          "interface_kind": "rest_api",
+          "legacy_since": "2026-06-04T22:57:37.149207Z",
+          "replacement_ref": "/workplans/{workplan_id}/dependencies/",
+          "owner_component": "state-hub.api",
+          "status": "legacy",
+          "replacement_verified": true,
+          "manual_hold": false,
+          "hold_reason": null,
+          "notes": null,
+          "retired_at": null,
+          "created_at": "2026-06-04T22:57:37.149207Z",
+          "updated_at": "2026-06-04T22:57:37.149207Z"
+        },
+        "all_time": {
+          "calls": 4971,
+          "tenant_count": 1,
+          "user_count": 1,
+          "component_count": 1,
+          "tenants": {
+            "unknown": 4971
+          },
+          "users": {
+            "unknown": 4971
+          },
+          "components": {
+            "unknown": 4971
+          }
+        },
+        "window": {
+          "calls": 0,
+          "tenant_count": 0,
+          "user_count": 0,
+          "component_count": 0,
+          "tenants": {},
+          "users": {},
+          "components": {}
+        },
+        "last_seen_at": "2026-07-01T22:09:24.229011Z",
+        "retirement_candidate": true,
+        "retirement_reason": "no measured usage in review window"
+      }
+    ]
+  },
+  "hours": 8
+}
diff --git a/docs/evidence/legacy-meter-weekly-review-20260725.json b/docs/evidence/legacy-meter-weekly-review-20260725.json
new file mode 100644
index 0000000..2084713
--- /dev/null
+++ b/docs/evidence/legacy-meter-weekly-review-20260725.json
@@ -0,0 +1,1755 @@
+{
+  "captured_at": "2026-07-25T14:00:04.489065+00:00",
+  "api_base": "http://127.0.0.1:8000",
+  "workplan": "STATE-WP-0070",
+  "retired_interfaces": [],
+  "weekly_review": {
+    "generated_at": "2026-07-25T14:00:04.482770Z",
+    "window_start": "2026-07-25T06:00:04.413072Z",
+    "window_end": "2026-07-25T14:00:04.413072Z",
+    "cadence": "weekly",
+    "activity_core_handoff": {
+      "activity_id": "statehub-legacy-interface-review",
+      "cadence": "weekly",
+      "source_endpoint": "/legacy-meter/weekly-review",
+      "state_owner": "state-hub",
+      "scheduler_owner": "activity-core"
+    },
+    "interfaces": [
+      {
+        "interface": {
+          "id": "8051fb40-66c9-4dc4-a413-13e8573e04a3",
+          "interface_key": "event_subject:org.statehub.workstream.completed",
+          "interface_kind": "event_subject",
+          "legacy_since": "2026-06-04T06:09:42.198193Z",
+          "replacement_ref": "org.statehub.workplan.completed",
+          "owner_component": "state-hub.events",
+          "status": "retired",
+          "replacement_verified": true,
+          "manual_hold": false,
+          "hold_reason": null,
+          "notes": "Retired by STATE-WP-0069 closeout",
+          "retired_at": "2026-07-08T21:38:52.773601Z",
+          "created_at": "2026-06-04T06:09:42.198193Z",
+          "updated_at": "2026-07-08T21:38:52.761243Z"
+        },
+        "all_time": {
+          "calls": 255,
+          "tenant_count": 1,
+          "user_count": 1,
+          "component_count": 1,
+          "tenants": {
+            "unknown": 255
+          },
+          "users": {
+            "unknown": 255
+          },
+          "components": {
+            "state-hub.events": 255
+          }
+        },
+        "window": {
+          "calls": 0,
+          "tenant_count": 0,
+          "user_count": 0,
+          "component_count": 0,
+          "tenants": {},
+          "users": {},
+          "components": {}
+        },
+        "last_seen_at": "2026-07-08T20:49:12.839383Z",
+        "retirement_candidate": false,
+        "retirement_reason": "already retired"
+      },
+      {
+        "interface": {
+          "id": "63ed90e3-42b4-431a-94db-e1254a52f9e2",
+          "interface_key": "mcp:create_workstream",
+          "interface_kind": "mcp_tool",
+          "legacy_since": "2026-07-10T13:19:44.205900Z",
+          "replacement_ref": "create_workplan",
+          "owner_component": "state-hub.mcp",
+          "status": "legacy",
+          "replacement_verified": true,
+          "manual_hold": false,
+          "hold_reason": null,
+          "notes": "Registered by STATE-WP-0070 T03 \u2014 zero-window streak starts at registration",
+          "retired_at": null,
+          "created_at": "2026-07-10T13:19:44.205900Z",
+          "updated_at": "2026-07-10T13:19:44.205900Z"
+        },
+        "all_time": {
+          "calls": 2,
+          "tenant_count": 1,
+          "user_count": 1,
+          "component_count": 1,
+          "tenants": {
+            "unknown": 2
+          },
+          "users": {
+            "unknown": 2
+          },
+          "components": {
+            "state-hub.mcp": 2
+          }
+        },
+        "window": {
+          "calls": 0,
+          "tenant_count": 0,
+          "user_count": 0,
+          "component_count": 0,
+          "tenants": {},
+          "users": {},
+          "components": {}
+        },
+        "last_seen_at": "2026-07-10T13:20:43.378546Z",
+        "retirement_candidate": true,
+        "retirement_reason": "no measured usage in review window"
+      },
+      {
+        "interface": {
+          "id": "b6a5fe44-fb85-4ef7-a273-78d09da777af",
+          "interface_key": "mcp:list_workstreams",
+          "interface_kind": "mcp_tool",
+          "legacy_since": "2026-07-10T13:19:26.075491Z",
+          "replacement_ref": "list_workplans",
+          "owner_component": "state-hub.mcp",
+          "status": "legacy",
+          "replacement_verified": true,
+          "manual_hold": false,
+          "hold_reason": null,
+          "notes": null,
+          "retired_at": null,
+          "created_at": "2026-07-10T13:19:26.075491Z",
+          "updated_at": "2026-07-10T13:19:26.075491Z"
+        },
+        "all_time": {
+          "calls": 2,
+          "tenant_count": 1,
+          "user_count": 1,
+          "component_count": 1,
+          "tenants": {
+            "unknown": 2
+          },
+          "users": {
+            "unknown": 2
+          },
+          "components": {
+            "state-hub.mcp": 2
+          }
+        },
+        "window": {
+          "calls": 0,
+          "tenant_count": 0,
+          "user_count": 0,
+          "component_count": 0,
+          "tenants": {},
+          "users": {},
+          "components": {}
+        },
+        "last_seen_at": "2026-07-10T13:20:42.374940Z",
+        "retirement_candidate": true,
+        "retirement_reason": "no measured usage in review window"
+      },
+      {
+        "interface": {
+          "id": "53c3372b-307d-4d6a-8ea4-bc36cacdcaf2",
+          "interface_key": "mcp:update_workstream",
+          "interface_kind": "mcp_tool",
+          "legacy_since": "2026-07-10T13:19:44.255216Z",
+          "replacement_ref": "update_workplan",
+          "owner_component": "state-hub.mcp",
+          "status": "legacy",
+          "replacement_verified": true,
+          "manual_hold": false,
+          "hold_reason": null,
+          "notes": "Registered by STATE-WP-0070 T03 \u2014 zero-window streak starts at registration",
+          "retired_at": null,
+          "created_at": "2026-07-10T13:19:44.255216Z",
+          "updated_at": "2026-07-10T13:19:44.255216Z"
+        },
+        "all_time": {
+          "calls": 0,
+          "tenant_count": 0,
+          "user_count": 0,
+          "component_count": 0,
+          "tenants": {},
+          "users": {},
+          "components": {}
+        },
+        "window": {
+          "calls": 0,
+          "tenant_count": 0,
+          "user_count": 0,
+          "component_count": 0,
+          "tenants": {},
+          "users": {},
+          "components": {}
+        },
+        "last_seen_at": null,
+        "retirement_candidate": true,
+        "retirement_reason": "no measured usage in review window"
+      },
+      {
+        "interface": {
+          "id": "bed4d08a-3471-48f5-9f0e-f9d550383a26",
+          "interface_key": "mcp:update_workstream_status",
+          "interface_kind": "mcp_tool",
+          "legacy_since": "2026-07-10T13:19:44.303612Z",
+          "replacement_ref": "update_workplan_status",
+          "owner_component": "state-hub.mcp",
+          "status": "legacy",
+          "replacement_verified": true,
+          "manual_hold": false,
+          "hold_reason": null,
+          "notes": "Registered by STATE-WP-0070 T03 \u2014 zero-window streak starts at registration",
+          "retired_at": null,
+          "created_at": "2026-07-10T13:19:44.303612Z",
+          "updated_at": "2026-07-10T13:19:44.303612Z"
+        },
+        "all_time": {
+          "calls": 0,
+          "tenant_count": 0,
+          "user_count": 0,
+          "component_count": 0,
+          "tenants": {},
+          "users": {},
+          "components": {}
+        },
+        "window": {
+          "calls": 0,
+          "tenant_count": 0,
+          "user_count": 0,
+          "component_count": 0,
+          "tenants": {},
+          "users": {},
+          "components": {}
+        },
+        "last_seen_at": null,
+        "retirement_candidate": true,
+        "retirement_reason": "no measured usage in review window"
+      },
+      {
+        "interface": {
+          "id": "46900dc2-0893-405b-ba59-80f31fb6ebb1",
+          "interface_key": "state://workstreams/{topic_slug}",
+          "interface_kind": "mcp_tool",
+          "legacy_since": "2026-07-10T13:19:44.344493Z",
+          "replacement_ref": "state://workplans/{topic_slug}",
+          "owner_component": "state-hub.mcp",
+          "status": "legacy",
+          "replacement_verified": true,
+          "manual_hold": false,
+          "hold_reason": null,
+          "notes": "Registered by STATE-WP-0070 T03 \u2014 zero-window streak starts at registration",
+          "retired_at": null,
+          "created_at": "2026-07-10T13:19:44.344493Z",
+          "updated_at": "2026-07-10T13:19:44.344493Z"
+        },
+        "all_time": {
+          "calls": 1,
+          "tenant_count": 1,
+          "user_count": 1,
+          "component_count": 1,
+          "tenants": {
+            "unknown": 1
+          },
+          "users": {
+            "unknown": 1
+          },
+          "components": {
+            "state-hub.mcp": 1
+          }
+        },
+        "window": {
+          "calls": 0,
+          "tenant_count": 0,
+          "user_count": 0,
+          "component_count": 0,
+          "tenants": {},
+          "users": {},
+          "components": {}
+        },
+        "last_seen_at": "2026-07-10T13:20:34.491811Z",
+        "retirement_candidate": true,
+        "retirement_reason": "no measured usage in review window"
+      },
+      {
+        "interface": {
+          "id": "cd9342fd-27e7-4a46-a1be-d41499e106a3",
+          "interface_key": "rest_api:DELETE /workstreams/{workstream_id}",
+          "interface_kind": "rest_api",
+          "legacy_since": "2026-06-06T17:28:13.052813Z",
+          "replacement_ref": "/workplans/{workplan_id}",
+          "owner_component": "state-hub.api",
+          "status": "legacy",
+          "replacement_verified": true,
+          "manual_hold": false,
+          "hold_reason": null,
+          "notes": null,
+          "retired_at": null,
+          "created_at": "2026-06-06T17:28:13.052813Z",
+          "updated_at": "2026-06-06T17:28:13.052813Z"
+        },
+        "all_time": {
+          "calls": 1,
+          "tenant_count": 1,
+          "user_count": 1,
+          "component_count": 1,
+          "tenants": {
+            "unknown": 1
+          },
+          "users": {
+            "unknown": 1
+          },
+          "components": {
+            "unknown": 1
+          }
+        },
+        "window": {
+          "calls": 0,
+          "tenant_count": 0,
+          "user_count": 0,
+          "component_count": 0,
+          "tenants": {},
+          "users": {},
+          "components": {}
+        },
+        "last_seen_at": "2026-06-06T17:28:13.047529Z",
+        "retirement_candidate": true,
+        "retirement_reason": "no measured usage in review window"
+      },
+      {
+        "interface": {
+          "id": "a4e0948c-cd4a-461e-8ae2-7fd7b51d04a7",
+          "interface_key": "rest_api:GET /decisions/?workstream_id",
+          "interface_kind": "rest_api",
+          "legacy_since": "2026-07-09T23:07:53.093223Z",
+          "replacement_ref": "/decisions/?workplan_id=<workplan_id>",
+          "owner_component": "state-hub.api",
+          "status": "legacy",
+          "replacement_verified": true,
+          "manual_hold": false,
+          "hold_reason": null,
+          "notes": null,
+          "retired_at": null,
+          "created_at": "2026-07-09T23:07:53.093223Z",
+          "updated_at": "2026-07-09T23:07:53.093223Z"
+        },
+        "all_time": {
+          "calls": 1,
+          "tenant_count": 1,
+          "user_count": 1,
+          "component_count": 1,
+          "tenants": {
+            "unknown": 1
+          },
+          "users": {
+            "unknown": 1
+          },
+          "components": {
+            "unknown": 1
+          }
+        },
+        "window": {
+          "calls": 0,
+          "tenant_count": 0,
+          "user_count": 0,
+          "component_count": 0,
+          "tenants": {},
+          "users": {},
+          "components": {}
+        },
+        "last_seen_at": "2026-07-09T23:07:53.083299Z",
+        "retirement_candidate": true,
+        "retirement_reason": "no measured usage in review window"
+      },
+      {
+        "interface": {
+          "id": "70a9346e-e0ee-42ac-874f-f160580b54dd",
+          "interface_key": "rest_api:GET /progress/?workstream_id",
+          "interface_kind": "rest_api",
+          "legacy_since": "2026-07-13T22:04:03.911449Z",
+          "replacement_ref": "/progress/?workplan_id=<workplan_id>",
+          "owner_component": "state-hub.api",
+          "status": "legacy",
+          "replacement_verified": true,
+          "manual_hold": false,
+          "hold_reason": null,
+          "notes": null,
+          "retired_at": null,
+          "created_at": "2026-07-13T22:04:03.911449Z",
+          "updated_at": "2026-07-13T22:04:03.911449Z"
+        },
+        "all_time": {
+          "calls": 1,
+          "tenant_count": 1,
+          "user_count": 1,
+          "component_count": 1,
+          "tenants": {
+            "unknown": 1
+          },
+          "users": {
+            "unknown": 1
+          },
+          "components": {
+            "unknown": 1
+          }
+        },
+        "window": {
+          "calls": 0,
+          "tenant_count": 0,
+          "user_count": 0,
+          "component_count": 0,
+          "tenants": {},
+          "users": {},
+          "components": {}
+        },
+        "last_seen_at": "2026-07-13T22:04:03.904998Z",
+        "retirement_candidate": true,
+        "retirement_reason": "no measured usage in review window"
+      },
+      {
+        "interface": {
+          "id": "be3cdcf8-250b-4bf0-801f-02ffd5f57e00",
+          "interface_key": "rest_api:GET /tasks/?workstream_id",
+          "interface_kind": "rest_api",
+          "legacy_since": "2026-07-08T19:32:21.628513Z",
+          "replacement_ref": "/tasks/?workplan_id=<workplan_id>",
+          "owner_component": "state-hub.api",
+          "status": "legacy",
+          "replacement_verified": true,
+          "manual_hold": false,
+          "hold_reason": null,
+          "notes": null,
+          "retired_at": null,
+          "created_at": "2026-07-08T19:32:21.628513Z",
+          "updated_at": "2026-07-08T19:32:21.628513Z"
+        },
+        "all_time": {
+          "calls": 587,
+          "tenant_count": 1,
+          "user_count": 1,
+          "component_count": 1,
+          "tenants": {
+            "unknown": 587
+          },
+          "users": {
+            "unknown": 587
+          },
+          "components": {
+            "unknown": 587
+          }
+        },
+        "window": {
+          "calls": 0,
+          "tenant_count": 0,
+          "user_count": 0,
+          "component_count": 0,
+          "tenants": {},
+          "users": {},
+          "components": {}
+        },
+        "last_seen_at": "2026-07-22T13:21:12.171828Z",
+        "retirement_candidate": true,
+        "retirement_reason": "no measured usage in review window"
+      },
+      {
+        "interface": {
+          "id": "3e4a3d0b-08fa-45c3-91e2-4f514a914b97",
+          "interface_key": "rest_api:GET /workstreams/",
+          "interface_kind": "rest_api",
+          "legacy_since": "2026-06-04T00:26:14.533764Z",
+          "replacement_ref": "/workplans/",
+          "owner_component": "state-hub.api",
+          "status": "legacy",
+          "replacement_verified": true,
+          "manual_hold": false,
+          "hold_reason": null,
+          "notes": null,
+          "retired_at": null,
+          "created_at": "2026-06-04T00:26:14.533764Z",
+          "updated_at": "2026-06-04T00:26:14.533764Z"
+        },
+        "all_time": {
+          "calls": 144084,
+          "tenant_count": 1,
+          "user_count": 1,
+          "component_count": 1,
+          "tenants": {
+            "unknown": 144084
+          },
+          "users": {
+            "unknown": 144084
+          },
+          "components": {
+            "unknown": 144084
+          }
+        },
+        "window": {
+          "calls": 0,
+          "tenant_count": 0,
+          "user_count": 0,
+          "component_count": 0,
+          "tenants": {},
+          "users": {},
+          "components": {}
+        },
+        "last_seen_at": "2026-07-08T21:14:39.652776Z",
+        "retirement_candidate": true,
+        "retirement_reason": "no measured usage in review window"
+      },
+      {
+        "interface": {
+          "id": "e4c140ec-7479-46f9-b185-4b533f19d639",
+          "interface_key": "rest_api:GET /workstreams/workplan-index",
+          "interface_kind": "rest_api",
+          "legacy_since": "2026-06-04T05:20:58.321869Z",
+          "replacement_ref": "/workplans/index",
+          "owner_component": "state-hub.api",
+          "status": "legacy",
+          "replacement_verified": true,
+          "manual_hold": false,
+          "hold_reason": null,
+          "notes": null,
+          "retired_at": null,
+          "created_at": "2026-06-04T05:20:58.321869Z",
+          "updated_at": "2026-06-04T05:20:58.321869Z"
+        },
+        "all_time": {
+          "calls": 30,
+          "tenant_count": 1,
+          "user_count": 1,
+          "component_count": 1,
+          "tenants": {
+            "unknown": 30
+          },
+          "users": {
+            "unknown": 30
+          },
+          "components": {
+            "unknown": 30
+          }
+        },
+        "window": {
+          "calls": 0,
+          "tenant_count": 0,
+          "user_count": 0,
+          "component_count": 0,
+          "tenants": {},
+          "users": {},
+          "components": {}
+        },
+        "last_seen_at": "2026-07-03T05:20:34.534439Z",
+        "retirement_candidate": true,
+        "retirement_reason": "no measured usage in review window"
+      },
+      {
+        "interface": {
+          "id": "3a00b19e-e7db-4403-98aa-a77c9ab61ecc",
+          "interface_key": "rest_api:GET /workstreams/{workstream_id}",
+          "interface_kind": "rest_api",
+          "legacy_since": "2026-06-04T00:25:59.014966Z",
+          "replacement_ref": "/workplans/{workplan_id}",
+          "owner_component": "state-hub.api",
+          "status": "legacy",
+          "replacement_verified": true,
+          "manual_hold": false,
+          "hold_reason": null,
+          "notes": null,
+          "retired_at": null,
+          "created_at": "2026-06-04T00:25:59.014966Z",
+          "updated_at": "2026-06-04T00:25:59.014966Z"
+        },
+        "all_time": {
+          "calls": 511405,
+          "tenant_count": 1,
+          "user_count": 1,
+          "component_count": 1,
+          "tenants": {
+            "unknown": 511405
+          },
+          "users": {
+            "unknown": 511405
+          },
+          "components": {
+            "unknown": 511405
+          }
+        },
+        "window": {
+          "calls": 0,
+          "tenant_count": 0,
+          "user_count": 0,
+          "component_count": 0,
+          "tenants": {},
+          "users": {},
+          "components": {}
+        },
+        "last_seen_at": "2026-07-08T21:14:20.781103Z",
+        "retirement_candidate": true,
+        "retirement_reason": "no measured usage in review window"
+      },
+      {
+        "interface": {
+          "id": "69e1a255-a8b9-4101-8a68-b1bed23abfda",
+          "interface_key": "rest_api:GET /workstreams/{workstream_id}/dependencies/",
+          "interface_kind": "rest_api",
+          "legacy_since": "2026-06-04T00:25:59.291135Z",
+          "replacement_ref": "/workplans/{workplan_id}/dependencies/",
+          "owner_component": "state-hub.api",
+          "status": "legacy",
+          "replacement_verified": true,
+          "manual_hold": false,
+          "hold_reason": null,
+          "notes": null,
+          "retired_at": null,
+          "created_at": "2026-06-04T00:25:59.291135Z",
+          "updated_at": "2026-06-04T00:25:59.291135Z"
+        },
+        "all_time": {
+          "calls": 255865,
+          "tenant_count": 1,
+          "user_count": 1,
+          "component_count": 1,
+          "tenants": {
+            "unknown": 255865
+          },
+          "users": {
+            "unknown": 255865
+          },
+          "components": {
+            "unknown": 255865
+          }
+        },
+        "window": {
+          "calls": 0,
+          "tenant_count": 0,
+          "user_count": 0,
+          "component_count": 0,
+          "tenants": {},
+          "users": {},
+          "components": {}
+        },
+        "last_seen_at": "2026-07-08T21:14:12.747005Z",
+        "retirement_candidate": true,
+        "retirement_reason": "no measured usage in review window"
+      },
+      {
+        "interface": {
+          "id": "b1aae931-b51f-4a85-a723-865dd65f6132",
+          "interface_key": "rest_api:PATCH /workstreams/{workstream_id}",
+          "interface_kind": "rest_api",
+          "legacy_since": "2026-06-04T06:09:41.901035Z",
+          "replacement_ref": "/workplans/{workplan_id}",
+          "owner_component": "state-hub.api",
+          "status": "legacy",
+          "replacement_verified": true,
+          "manual_hold": false,
+          "hold_reason": null,
+          "notes": null,
+          "retired_at": null,
+          "created_at": "2026-06-04T06:09:41.901035Z",
+          "updated_at": "2026-06-04T06:09:41.901035Z"
+        },
+        "all_time": {
+          "calls": 571,
+          "tenant_count": 1,
+          "user_count": 1,
+          "component_count": 1,
+          "tenants": {
+            "unknown": 571
+          },
+          "users": {
+            "unknown": 571
+          },
+          "components": {
+            "unknown": 571
+          }
+        },
+        "window": {
+          "calls": 0,
+          "tenant_count": 0,
+          "user_count": 0,
+          "component_count": 0,
+          "tenants": {},
+          "users": {},
+          "components": {}
+        },
+        "last_seen_at": "2026-07-08T20:49:12.335710Z",
+        "retirement_candidate": true,
+        "retirement_reason": "no measured usage in review window"
+      },
+      {
+        "interface": {
+          "id": "4aea9591-970b-4918-ac4a-4da95a0a1a8c",
+          "interface_key": "rest_api:POST /decisions/ workstream_id",
+          "interface_kind": "rest_api",
+          "legacy_since": "2026-07-09T22:56:35.473130Z",
+          "replacement_ref": "POST /decisions/ with workplan_id",
+          "owner_component": "state-hub.api",
+          "status": "legacy",
+          "replacement_verified": true,
+          "manual_hold": false,
+          "hold_reason": null,
+          "notes": null,
+          "retired_at": null,
+          "created_at": "2026-07-09T22:56:35.473130Z",
+          "updated_at": "2026-07-09T22:56:35.473130Z"
+        },
+        "all_time": {
+          "calls": 3,
+          "tenant_count": 1,
+          "user_count": 1,
+          "component_count": 1,
+          "tenants": {
+            "unknown": 3
+          },
+          "users": {
+            "unknown": 3
+          },
+          "components": {
+            "unknown": 3
+          }
+        },
+        "window": {
+          "calls": 0,
+          "tenant_count": 0,
+          "user_count": 0,
+          "component_count": 0,
+          "tenants": {},
+          "users": {},
+          "components": {}
+        },
+        "last_seen_at": "2026-07-09T22:57:05.912456Z",
+        "retirement_candidate": true,
+        "retirement_reason": "no measured usage in review window"
+      },
+      {
+        "interface": {
+          "id": "4a70583c-1e41-4ec1-99a9-728856a7d79c",
+          "interface_key": "rest_api:POST /progress/ workstream_id",
+          "interface_kind": "rest_api",
+          "legacy_since": "2026-07-08T23:35:09.148333Z",
+          "replacement_ref": "POST /progress/ with workplan_id",
+          "owner_component": "state-hub.api",
+          "status": "legacy",
+          "replacement_verified": true,
+          "manual_hold": false,
+          "hold_reason": null,
+          "notes": null,
+          "retired_at": null,
+          "created_at": "2026-07-08T23:35:09.148333Z",
+          "updated_at": "2026-07-08T23:35:09.148333Z"
+        },
+        "all_time": {
+          "calls": 14,
+          "tenant_count": 1,
+          "user_count": 1,
+          "component_count": 1,
+          "tenants": {
+            "unknown": 14
+          },
+          "users": {
+            "unknown": 14
+          },
+          "components": {
+            "unknown": 14
+          }
+        },
+        "window": {
+          "calls": 0,
+          "tenant_count": 0,
+          "user_count": 0,
+          "component_count": 0,
+          "tenants": {},
+          "users": {},
+          "components": {}
+        },
+        "last_seen_at": "2026-07-10T08:34:42.959724Z",
+        "retirement_candidate": true,
+        "retirement_reason": "no measured usage in review window"
+      },
+      {
+        "interface": {
+          "id": "6df4e443-7bf1-461a-923b-a6eb52fe7b07",
+          "interface_key": "rest_api:POST /tasks/ workstream_id",
+          "interface_kind": "rest_api",
+          "legacy_since": "2026-07-08T22:38:29.405720Z",
+          "replacement_ref": "POST /tasks/ with workplan_id",
+          "owner_component": "state-hub.api",
+          "status": "legacy",
+          "replacement_verified": true,
+          "manual_hold": false,
+          "hold_reason": null,
+          "notes": null,
+          "retired_at": null,
+          "created_at": "2026-07-08T22:38:29.405720Z",
+          "updated_at": "2026-07-08T22:38:29.405720Z"
+        },
+        "all_time": {
+          "calls": 5,
+          "tenant_count": 1,
+          "user_count": 1,
+          "component_count": 1,
+          "tenants": {
+            "unknown": 5
+          },
+          "users": {
+            "unknown": 5
+          },
+          "components": {
+            "state-hub.fix-consistency": 5
+          }
+        },
+        "window": {
+          "calls": 0,
+          "tenant_count": 0,
+          "user_count": 0,
+          "component_count": 0,
+          "tenants": {},
+          "users": {},
+          "components": {}
+        },
+        "last_seen_at": "2026-07-08T22:38:29.976918Z",
+        "retirement_candidate": true,
+        "retirement_reason": "no measured usage in review window"
+      },
+      {
+        "interface": {
+          "id": "ed6451c9-d2cc-4486-9afe-d3852782cabc",
+          "interface_key": "rest_api:POST /workstreams/",
+          "interface_kind": "rest_api",
+          "legacy_since": "2026-06-04T07:40:24.168535Z",
+          "replacement_ref": "/workplans/",
+          "owner_component": "state-hub.api",
+          "status": "legacy",
+          "replacement_verified": true,
+          "manual_hold": false,
+          "hold_reason": null,
+          "notes": null,
+          "retired_at": null,
+          "created_at": "2026-06-04T07:40:24.168535Z",
+          "updated_at": "2026-06-04T07:40:24.168535Z"
+        },
+        "all_time": {
+          "calls": 824,
+          "tenant_count": 1,
+          "user_count": 1,
+          "component_count": 1,
+          "tenants": {
+            "unknown": 824
+          },
+          "users": {
+            "unknown": 824
+          },
+          "components": {
+            "unknown": 824
+          }
+        },
+        "window": {
+          "calls": 0,
+          "tenant_count": 0,
+          "user_count": 0,
+          "component_count": 0,
+          "tenants": {},
+          "users": {},
+          "components": {}
+        },
+        "last_seen_at": "2026-07-08T20:38:05.903144Z",
+        "retirement_candidate": true,
+        "retirement_reason": "no measured usage in review window"
+      },
+      {
+        "interface": {
+          "id": "281fd706-b192-4194-8055-2d8733c115f9",
+          "interface_key": "rest_api:POST /workstreams/{workstream_id}/dependencies/",
+          "interface_kind": "rest_api",
+          "legacy_since": "2026-06-04T22:57:37.149207Z",
+          "replacement_ref": "/workplans/{workplan_id}/dependencies/",
+          "owner_component": "state-hub.api",
+          "status": "legacy",
+          "replacement_verified": true,
+          "manual_hold": false,
+          "hold_reason": null,
+          "notes": null,
+          "retired_at": null,
+          "created_at": "2026-06-04T22:57:37.149207Z",
+          "updated_at": "2026-06-04T22:57:37.149207Z"
+        },
+        "all_time": {
+          "calls": 4971,
+          "tenant_count": 1,
+          "user_count": 1,
+          "component_count": 1,
+          "tenants": {
+            "unknown": 4971
+          },
+          "users": {
+            "unknown": 4971
+          },
+          "components": {
+            "unknown": 4971
+          }
+        },
+        "window": {
+          "calls": 0,
+          "tenant_count": 0,
+          "user_count": 0,
+          "component_count": 0,
+          "tenants": {},
+          "users": {},
+          "components": {}
+        },
+        "last_seen_at": "2026-07-01T22:09:24.229011Z",
+        "retirement_candidate": true,
+        "retirement_reason": "no measured usage in review window"
+      }
+    ],
+    "retirement_candidates": [
+      {
+        "interface": {
+          "id": "63ed90e3-42b4-431a-94db-e1254a52f9e2",
+          "interface_key": "mcp:create_workstream",
+          "interface_kind": "mcp_tool",
+          "legacy_since": "2026-07-10T13:19:44.205900Z",
+          "replacement_ref": "create_workplan",
+          "owner_component": "state-hub.mcp",
+          "status": "legacy",
+          "replacement_verified": true,
+          "manual_hold": false,
+          "hold_reason": null,
+          "notes": "Registered by STATE-WP-0070 T03 \u2014 zero-window streak starts at registration",
+          "retired_at": null,
+          "created_at": "2026-07-10T13:19:44.205900Z",
+          "updated_at": "2026-07-10T13:19:44.205900Z"
+        },
+        "all_time": {
+          "calls": 2,
+          "tenant_count": 1,
+          "user_count": 1,
+          "component_count": 1,
+          "tenants": {
+            "unknown": 2
+          },
+          "users": {
+            "unknown": 2
+          },
+          "components": {
+            "state-hub.mcp": 2
+          }
+        },
+        "window": {
+          "calls": 0,
+          "tenant_count": 0,
+          "user_count": 0,
+          "component_count": 0,
+          "tenants": {},
+          "users": {},
+          "components": {}
+        },
+        "last_seen_at": "2026-07-10T13:20:43.378546Z",
+        "retirement_candidate": true,
+        "retirement_reason": "no measured usage in review window"
+      },
+      {
+        "interface": {
+          "id": "b6a5fe44-fb85-4ef7-a273-78d09da777af",
+          "interface_key": "mcp:list_workstreams",
+          "interface_kind": "mcp_tool",
+          "legacy_since": "2026-07-10T13:19:26.075491Z",
+          "replacement_ref": "list_workplans",
+          "owner_component": "state-hub.mcp",
+          "status": "legacy",
+          "replacement_verified": true,
+          "manual_hold": false,
+          "hold_reason": null,
+          "notes": null,
+          "retired_at": null,
+          "created_at": "2026-07-10T13:19:26.075491Z",
+          "updated_at": "2026-07-10T13:19:26.075491Z"
+        },
+        "all_time": {
+          "calls": 2,
+          "tenant_count": 1,
+          "user_count": 1,
+          "component_count": 1,
+          "tenants": {
+            "unknown": 2
+          },
+          "users": {
+            "unknown": 2
+          },
+          "components": {
+            "state-hub.mcp": 2
+          }
+        },
+        "window": {
+          "calls": 0,
+          "tenant_count": 0,
+          "user_count": 0,
+          "component_count": 0,
+          "tenants": {},
+          "users": {},
+          "components": {}
+        },
+        "last_seen_at": "2026-07-10T13:20:42.374940Z",
+        "retirement_candidate": true,
+        "retirement_reason": "no measured usage in review window"
+      },
+      {
+        "interface": {
+          "id": "53c3372b-307d-4d6a-8ea4-bc36cacdcaf2",
+          "interface_key": "mcp:update_workstream",
+          "interface_kind": "mcp_tool",
+          "legacy_since": "2026-07-10T13:19:44.255216Z",
+          "replacement_ref": "update_workplan",
+          "owner_component": "state-hub.mcp",
+          "status": "legacy",
+          "replacement_verified": true,
+          "manual_hold": false,
+          "hold_reason": null,
+          "notes": "Registered by STATE-WP-0070 T03 \u2014 zero-window streak starts at registration",
+          "retired_at": null,
+          "created_at": "2026-07-10T13:19:44.255216Z",
+          "updated_at": "2026-07-10T13:19:44.255216Z"
+        },
+        "all_time": {
+          "calls": 0,
+          "tenant_count": 0,
+          "user_count": 0,
+          "component_count": 0,
+          "tenants": {},
+          "users": {},
+          "components": {}
+        },
+        "window": {
+          "calls": 0,
+          "tenant_count": 0,
+          "user_count": 0,
+          "component_count": 0,
+          "tenants": {},
+          "users": {},
+          "components": {}
+        },
+        "last_seen_at": null,
+        "retirement_candidate": true,
+        "retirement_reason": "no measured usage in review window"
+      },
+      {
+        "interface": {
+          "id": "bed4d08a-3471-48f5-9f0e-f9d550383a26",
+          "interface_key": "mcp:update_workstream_status",
+          "interface_kind": "mcp_tool",
+          "legacy_since": "2026-07-10T13:19:44.303612Z",
+          "replacement_ref": "update_workplan_status",
+          "owner_component": "state-hub.mcp",
+          "status": "legacy",
+          "replacement_verified": true,
+          "manual_hold": false,
+          "hold_reason": null,
+          "notes": "Registered by STATE-WP-0070 T03 \u2014 zero-window streak starts at registration",
+          "retired_at": null,
+          "created_at": "2026-07-10T13:19:44.303612Z",
+          "updated_at": "2026-07-10T13:19:44.303612Z"
+        },
+        "all_time": {
+          "calls": 0,
+          "tenant_count": 0,
+          "user_count": 0,
+          "component_count": 0,
+          "tenants": {},
+          "users": {},
+          "components": {}
+        },
+        "window": {
+          "calls": 0,
+          "tenant_count": 0,
+          "user_count": 0,
+          "component_count": 0,
+          "tenants": {},
+          "users": {},
+          "components": {}
+        },
+        "last_seen_at": null,
+        "retirement_candidate": true,
+        "retirement_reason": "no measured usage in review window"
+      },
+      {
+        "interface": {
+          "id": "46900dc2-0893-405b-ba59-80f31fb6ebb1",
+          "interface_key": "state://workstreams/{topic_slug}",
+          "interface_kind": "mcp_tool",
+          "legacy_since": "2026-07-10T13:19:44.344493Z",
+          "replacement_ref": "state://workplans/{topic_slug}",
+          "owner_component": "state-hub.mcp",
+          "status": "legacy",
+          "replacement_verified": true,
+          "manual_hold": false,
+          "hold_reason": null,
+          "notes": "Registered by STATE-WP-0070 T03 \u2014 zero-window streak starts at registration",
+          "retired_at": null,
+          "created_at": "2026-07-10T13:19:44.344493Z",
+          "updated_at": "2026-07-10T13:19:44.344493Z"
+        },
+        "all_time": {
+          "calls": 1,
+          "tenant_count": 1,
+          "user_count": 1,
+          "component_count": 1,
+          "tenants": {
+            "unknown": 1
+          },
+          "users": {
+            "unknown": 1
+          },
+          "components": {
+            "state-hub.mcp": 1
+          }
+        },
+        "window": {
+          "calls": 0,
+          "tenant_count": 0,
+          "user_count": 0,
+          "component_count": 0,
+          "tenants": {},
+          "users": {},
+          "components": {}
+        },
+        "last_seen_at": "2026-07-10T13:20:34.491811Z",
+        "retirement_candidate": true,
+        "retirement_reason": "no measured usage in review window"
+      },
+      {
+        "interface": {
+          "id": "cd9342fd-27e7-4a46-a1be-d41499e106a3",
+          "interface_key": "rest_api:DELETE /workstreams/{workstream_id}",
+          "interface_kind": "rest_api",
+          "legacy_since": "2026-06-06T17:28:13.052813Z",
+          "replacement_ref": "/workplans/{workplan_id}",
+          "owner_component": "state-hub.api",
+          "status": "legacy",
+          "replacement_verified": true,
+          "manual_hold": false,
+          "hold_reason": null,
+          "notes": null,
+          "retired_at": null,
+          "created_at": "2026-06-06T17:28:13.052813Z",
+          "updated_at": "2026-06-06T17:28:13.052813Z"
+        },
+        "all_time": {
+          "calls": 1,
+          "tenant_count": 1,
+          "user_count": 1,
+          "component_count": 1,
+          "tenants": {
+            "unknown": 1
+          },
+          "users": {
+            "unknown": 1
+          },
+          "components": {
+            "unknown": 1
+          }
+        },
+        "window": {
+          "calls": 0,
+          "tenant_count": 0,
+          "user_count": 0,
+          "component_count": 0,
+          "tenants": {},
+          "users": {},
+          "components": {}
+        },
+        "last_seen_at": "2026-06-06T17:28:13.047529Z",
+        "retirement_candidate": true,
+        "retirement_reason": "no measured usage in review window"
+      },
+      {
+        "interface": {
+          "id": "a4e0948c-cd4a-461e-8ae2-7fd7b51d04a7",
+          "interface_key": "rest_api:GET /decisions/?workstream_id",
+          "interface_kind": "rest_api",
+          "legacy_since": "2026-07-09T23:07:53.093223Z",
+          "replacement_ref": "/decisions/?workplan_id=<workplan_id>",
+          "owner_component": "state-hub.api",
+          "status": "legacy",
+          "replacement_verified": true,
+          "manual_hold": false,
+          "hold_reason": null,
+          "notes": null,
+          "retired_at": null,
+          "created_at": "2026-07-09T23:07:53.093223Z",
+          "updated_at": "2026-07-09T23:07:53.093223Z"
+        },
+        "all_time": {
+          "calls": 1,
+          "tenant_count": 1,
+          "user_count": 1,
+          "component_count": 1,
+          "tenants": {
+            "unknown": 1
+          },
+          "users": {
+            "unknown": 1
+          },
+          "components": {
+            "unknown": 1
+          }
+        },
+        "window": {
+          "calls": 0,
+          "tenant_count": 0,
+          "user_count": 0,
+          "component_count": 0,
+          "tenants": {},
+          "users": {},
+          "components": {}
+        },
+        "last_seen_at": "2026-07-09T23:07:53.083299Z",
+        "retirement_candidate": true,
+        "retirement_reason": "no measured usage in review window"
+      },
+      {
+        "interface": {
+          "id": "70a9346e-e0ee-42ac-874f-f160580b54dd",
+          "interface_key": "rest_api:GET /progress/?workstream_id",
+          "interface_kind": "rest_api",
+          "legacy_since": "2026-07-13T22:04:03.911449Z",
+          "replacement_ref": "/progress/?workplan_id=<workplan_id>",
+          "owner_component": "state-hub.api",
+          "status": "legacy",
+          "replacement_verified": true,
+          "manual_hold": false,
+          "hold_reason": null,
+          "notes": null,
+          "retired_at": null,
+          "created_at": "2026-07-13T22:04:03.911449Z",
+          "updated_at": "2026-07-13T22:04:03.911449Z"
+        },
+        "all_time": {
+          "calls": 1,
+          "tenant_count": 1,
+          "user_count": 1,
+          "component_count": 1,
+          "tenants": {
+            "unknown": 1
+          },
+          "users": {
+            "unknown": 1
+          },
+          "components": {
+            "unknown": 1
+          }
+        },
+        "window": {
+          "calls": 0,
+          "tenant_count": 0,
+          "user_count": 0,
+          "component_count": 0,
+          "tenants": {},
+          "users": {},
+          "components": {}
+        },
+        "last_seen_at": "2026-07-13T22:04:03.904998Z",
+        "retirement_candidate": true,
+        "retirement_reason": "no measured usage in review window"
+      },
+      {
+        "interface": {
+          "id": "be3cdcf8-250b-4bf0-801f-02ffd5f57e00",
+          "interface_key": "rest_api:GET /tasks/?workstream_id",
+          "interface_kind": "rest_api",
+          "legacy_since": "2026-07-08T19:32:21.628513Z",
+          "replacement_ref": "/tasks/?workplan_id=<workplan_id>",
+          "owner_component": "state-hub.api",
+          "status": "legacy",
+          "replacement_verified": true,
+          "manual_hold": false,
+          "hold_reason": null,
+          "notes": null,
+          "retired_at": null,
+          "created_at": "2026-07-08T19:32:21.628513Z",
+          "updated_at": "2026-07-08T19:32:21.628513Z"
+        },
+        "all_time": {
+          "calls": 587,
+          "tenant_count": 1,
+          "user_count": 1,
+          "component_count": 1,
+          "tenants": {
+            "unknown": 587
+          },
+          "users": {
+            "unknown": 587
+          },
+          "components": {
+            "unknown": 587
+          }
+        },
+        "window": {
+          "calls": 0,
+          "tenant_count": 0,
+          "user_count": 0,
+          "component_count": 0,
+          "tenants": {},
+          "users": {},
+          "components": {}
+        },
+        "last_seen_at": "2026-07-22T13:21:12.171828Z",
+        "retirement_candidate": true,
+        "retirement_reason": "no measured usage in review window"
+      },
+      {
+        "interface": {
+          "id": "3e4a3d0b-08fa-45c3-91e2-4f514a914b97",
+          "interface_key": "rest_api:GET /workstreams/",
+          "interface_kind": "rest_api",
+          "legacy_since": "2026-06-04T00:26:14.533764Z",
+          "replacement_ref": "/workplans/",
+          "owner_component": "state-hub.api",
+          "status": "legacy",
+          "replacement_verified": true,
+          "manual_hold": false,
+          "hold_reason": null,
+          "notes": null,
+          "retired_at": null,
+          "created_at": "2026-06-04T00:26:14.533764Z",
+          "updated_at": "2026-06-04T00:26:14.533764Z"
+        },
+        "all_time": {
+          "calls": 144084,
+          "tenant_count": 1,
+          "user_count": 1,
+          "component_count": 1,
+          "tenants": {
+            "unknown": 144084
+          },
+          "users": {
+            "unknown": 144084
+          },
+          "components": {
+            "unknown": 144084
+          }
+        },
+        "window": {
+          "calls": 0,
+          "tenant_count": 0,
+          "user_count": 0,
+          "component_count": 0,
+          "tenants": {},
+          "users": {},
+          "components": {}
+        },
+        "last_seen_at": "2026-07-08T21:14:39.652776Z",
+        "retirement_candidate": true,
+        "retirement_reason": "no measured usage in review window"
+      },
+      {
+        "interface": {
+          "id": "e4c140ec-7479-46f9-b185-4b533f19d639",
+          "interface_key": "rest_api:GET /workstreams/workplan-index",
+          "interface_kind": "rest_api",
+          "legacy_since": "2026-06-04T05:20:58.321869Z",
+          "replacement_ref": "/workplans/index",
+          "owner_component": "state-hub.api",
+          "status": "legacy",
+          "replacement_verified": true,
+          "manual_hold": false,
+          "hold_reason": null,
+          "notes": null,
+          "retired_at": null,
+          "created_at": "2026-06-04T05:20:58.321869Z",
+          "updated_at": "2026-06-04T05:20:58.321869Z"
+        },
+        "all_time": {
+          "calls": 30,
+          "tenant_count": 1,
+          "user_count": 1,
+          "component_count": 1,
+          "tenants": {
+            "unknown": 30
+          },
+          "users": {
+            "unknown": 30
+          },
+          "components": {
+            "unknown": 30
+          }
+        },
+        "window": {
+          "calls": 0,
+          "tenant_count": 0,
+          "user_count": 0,
+          "component_count": 0,
+          "tenants": {},
+          "users": {},
+          "components": {}
+        },
+        "last_seen_at": "2026-07-03T05:20:34.534439Z",
+        "retirement_candidate": true,
+        "retirement_reason": "no measured usage in review window"
+      },
+      {
+        "interface": {
+          "id": "3a00b19e-e7db-4403-98aa-a77c9ab61ecc",
+          "interface_key": "rest_api:GET /workstreams/{workstream_id}",
+          "interface_kind": "rest_api",
+          "legacy_since": "2026-06-04T00:25:59.014966Z",
+          "replacement_ref": "/workplans/{workplan_id}",
+          "owner_component": "state-hub.api",
+          "status": "legacy",
+          "replacement_verified": true,
+          "manual_hold": false,
+          "hold_reason": null,
+          "notes": null,
+          "retired_at": null,
+          "created_at": "2026-06-04T00:25:59.014966Z",
+          "updated_at": "2026-06-04T00:25:59.014966Z"
+        },
+        "all_time": {
+          "calls": 511405,
+          "tenant_count": 1,
+          "user_count": 1,
+          "component_count": 1,
+          "tenants": {
+            "unknown": 511405
+          },
+          "users": {
+            "unknown": 511405
+          },
+          "components": {
+            "unknown": 511405
+          }
+        },
+        "window": {
+          "calls": 0,
+          "tenant_count": 0,
+          "user_count": 0,
+          "component_count": 0,
+          "tenants": {},
+          "users": {},
+          "components": {}
+        },
+        "last_seen_at": "2026-07-08T21:14:20.781103Z",
+        "retirement_candidate": true,
+        "retirement_reason": "no measured usage in review window"
+      },
+      {
+        "interface": {
+          "id": "69e1a255-a8b9-4101-8a68-b1bed23abfda",
+          "interface_key": "rest_api:GET /workstreams/{workstream_id}/dependencies/",
+          "interface_kind": "rest_api",
+          "legacy_since": "2026-06-04T00:25:59.291135Z",
+          "replacement_ref": "/workplans/{workplan_id}/dependencies/",
+          "owner_component": "state-hub.api",
+          "status": "legacy",
+          "replacement_verified": true,
+          "manual_hold": false,
+          "hold_reason": null,
+          "notes": null,
+          "retired_at": null,
+          "created_at": "2026-06-04T00:25:59.291135Z",
+          "updated_at": "2026-06-04T00:25:59.291135Z"
+        },
+        "all_time": {
+          "calls": 255865,
+          "tenant_count": 1,
+          "user_count": 1,
+          "component_count": 1,
+          "tenants": {
+            "unknown": 255865
+          },
+          "users": {
+            "unknown": 255865
+          },
+          "components": {
+            "unknown": 255865
+          }
+        },
+        "window": {
+          "calls": 0,
+          "tenant_count": 0,
+          "user_count": 0,
+          "component_count": 0,
+          "tenants": {},
+          "users": {},
+          "components": {}
+        },
+        "last_seen_at": "2026-07-08T21:14:12.747005Z",
+        "retirement_candidate": true,
+        "retirement_reason": "no measured usage in review window"
+      },
+      {
+        "interface": {
+          "id": "b1aae931-b51f-4a85-a723-865dd65f6132",
+          "interface_key": "rest_api:PATCH /workstreams/{workstream_id}",
+          "interface_kind": "rest_api",
+          "legacy_since": "2026-06-04T06:09:41.901035Z",
+          "replacement_ref": "/workplans/{workplan_id}",
+          "owner_component": "state-hub.api",
+          "status": "legacy",
+          "replacement_verified": true,
+          "manual_hold": false,
+          "hold_reason": null,
+          "notes": null,
+          "retired_at": null,
+          "created_at": "2026-06-04T06:09:41.901035Z",
+          "updated_at": "2026-06-04T06:09:41.901035Z"
+        },
+        "all_time": {
+          "calls": 571,
+          "tenant_count": 1,
+          "user_count": 1,
+          "component_count": 1,
+          "tenants": {
+            "unknown": 571
+          },
+          "users": {
+            "unknown": 571
+          },
+          "components": {
+            "unknown": 571
+          }
+        },
+        "window": {
+          "calls": 0,
+          "tenant_count": 0,
+          "user_count": 0,
+          "component_count": 0,
+          "tenants": {},
+          "users": {},
+          "components": {}
+        },
+        "last_seen_at": "2026-07-08T20:49:12.335710Z",
+        "retirement_candidate": true,
+        "retirement_reason": "no measured usage in review window"
+      },
+      {
+        "interface": {
+          "id": "4aea9591-970b-4918-ac4a-4da95a0a1a8c",
+          "interface_key": "rest_api:POST /decisions/ workstream_id",
+          "interface_kind": "rest_api",
+          "legacy_since": "2026-07-09T22:56:35.473130Z",
+          "replacement_ref": "POST /decisions/ with workplan_id",
+          "owner_component": "state-hub.api",
+          "status": "legacy",
+          "replacement_verified": true,
+          "manual_hold": false,
+          "hold_reason": null,
+          "notes": null,
+          "retired_at": null,
+          "created_at": "2026-07-09T22:56:35.473130Z",
+          "updated_at": "2026-07-09T22:56:35.473130Z"
+        },
+        "all_time": {
+          "calls": 3,
+          "tenant_count": 1,
+          "user_count": 1,
+          "component_count": 1,
+          "tenants": {
+            "unknown": 3
+          },
+          "users": {
+            "unknown": 3
+          },
+          "components": {
+            "unknown": 3
+          }
+        },
+        "window": {
+          "calls": 0,
+          "tenant_count": 0,
+          "user_count": 0,
+          "component_count": 0,
+          "tenants": {},
+          "users": {},
+          "components": {}
+        },
+        "last_seen_at": "2026-07-09T22:57:05.912456Z",
+        "retirement_candidate": true,
+        "retirement_reason": "no measured usage in review window"
+      },
+      {
+        "interface": {
+          "id": "4a70583c-1e41-4ec1-99a9-728856a7d79c",
+          "interface_key": "rest_api:POST /progress/ workstream_id",
+          "interface_kind": "rest_api",
+          "legacy_since": "2026-07-08T23:35:09.148333Z",
+          "replacement_ref": "POST /progress/ with workplan_id",
+          "owner_component": "state-hub.api",
+          "status": "legacy",
+          "replacement_verified": true,
+          "manual_hold": false,
+          "hold_reason": null,
+          "notes": null,
+          "retired_at": null,
+          "created_at": "2026-07-08T23:35:09.148333Z",
+          "updated_at": "2026-07-08T23:35:09.148333Z"
+        },
+        "all_time": {
+          "calls": 14,
+          "tenant_count": 1,
+          "user_count": 1,
+          "component_count": 1,
+          "tenants": {
+            "unknown": 14
+          },
+          "users": {
+            "unknown": 14
+          },
+          "components": {
+            "unknown": 14
+          }
+        },
+        "window": {
+          "calls": 0,
+          "tenant_count": 0,
+          "user_count": 0,
+          "component_count": 0,
+          "tenants": {},
+          "users": {},
+          "components": {}
+        },
+        "last_seen_at": "2026-07-10T08:34:42.959724Z",
+        "retirement_candidate": true,
+        "retirement_reason": "no measured usage in review window"
+      },
+      {
+        "interface": {
+          "id": "6df4e443-7bf1-461a-923b-a6eb52fe7b07",
+          "interface_key": "rest_api:POST /tasks/ workstream_id",
+          "interface_kind": "rest_api",
+          "legacy_since": "2026-07-08T22:38:29.405720Z",
+          "replacement_ref": "POST /tasks/ with workplan_id",
+          "owner_component": "state-hub.api",
+          "status": "legacy",
+          "replacement_verified": true,
+          "manual_hold": false,
+          "hold_reason": null,
+          "notes": null,
+          "retired_at": null,
+          "created_at": "2026-07-08T22:38:29.405720Z",
+          "updated_at": "2026-07-08T22:38:29.405720Z"
+        },
+        "all_time": {
+          "calls": 5,
+          "tenant_count": 1,
+          "user_count": 1,
+          "component_count": 1,
+          "tenants": {
+            "unknown": 5
+          },
+          "users": {
+            "unknown": 5
+          },
+          "components": {
+            "state-hub.fix-consistency": 5
+          }
+        },
+        "window": {
+          "calls": 0,
+          "tenant_count": 0,
+          "user_count": 0,
+          "component_count": 0,
+          "tenants": {},
+          "users": {},
+          "components": {}
+        },
+        "last_seen_at": "2026-07-08T22:38:29.976918Z",
+        "retirement_candidate": true,
+        "retirement_reason": "no measured usage in review window"
+      },
+      {
+        "interface": {
+          "id": "ed6451c9-d2cc-4486-9afe-d3852782cabc",
+          "interface_key": "rest_api:POST /workstreams/",
+          "interface_kind": "rest_api",
+          "legacy_since": "2026-06-04T07:40:24.168535Z",
+          "replacement_ref": "/workplans/",
+          "owner_component": "state-hub.api",
+          "status": "legacy",
+          "replacement_verified": true,
+          "manual_hold": false,
+          "hold_reason": null,
+          "notes": null,
+          "retired_at": null,
+          "created_at": "2026-06-04T07:40:24.168535Z",
+          "updated_at": "2026-06-04T07:40:24.168535Z"
+        },
+        "all_time": {
+          "calls": 824,
+          "tenant_count": 1,
+          "user_count": 1,
+          "component_count": 1,
+          "tenants": {
+            "unknown": 824
+          },
+          "users": {
+            "unknown": 824
+          },
+          "components": {
+            "unknown": 824
+          }
+        },
+        "window": {
+          "calls": 0,
+          "tenant_count": 0,
+          "user_count": 0,
+          "component_count": 0,
+          "tenants": {},
+          "users": {},
+          "components": {}
+        },
+        "last_seen_at": "2026-07-08T20:38:05.903144Z",
+        "retirement_candidate": true,
+        "retirement_reason": "no measured usage in review window"
+      },
+      {
+        "interface": {
+          "id": "281fd706-b192-4194-8055-2d8733c115f9",
+          "interface_key": "rest_api:POST /workstreams/{workstream_id}/dependencies/",
+          "interface_kind": "rest_api",
+          "legacy_since": "2026-06-04T22:57:37.149207Z",
+          "replacement_ref": "/workplans/{workplan_id}/dependencies/",
+          "owner_component": "state-hub.api",
+          "status": "legacy",
+          "replacement_verified": true,
+          "manual_hold": false,
+          "hold_reason": null,
+          "notes": null,
+          "retired_at": null,
+          "created_at": "2026-06-04T22:57:37.149207Z",
+          "updated_at": "2026-06-04T22:57:37.149207Z"
+        },
+        "all_time": {
+          "calls": 4971,
+          "tenant_count": 1,
+          "user_count": 1,
+          "component_count": 1,
+          "tenants": {
+            "unknown": 4971
+          },
+          "users": {
+            "unknown": 4971
+          },
+          "components": {
+            "unknown": 4971
+          }
+        },
+        "window": {
+          "calls": 0,
+          "tenant_count": 0,
+          "user_count": 0,
+          "component_count": 0,
+          "tenants": {},
+          "users": {},
+          "components": {}
+        },
+        "last_seen_at": "2026-07-01T22:09:24.229011Z",
+        "retirement_candidate": true,
+        "retirement_reason": "no measured usage in review window"
+      }
+    ]
+  },
+  "hours": 8
+}
diff --git a/docs/evidence/legacy-meter-weekly-review-20260726.json b/docs/evidence/legacy-meter-weekly-review-20260726.json
new file mode 100644
index 0000000..699fe0f
--- /dev/null
+++ b/docs/evidence/legacy-meter-weekly-review-20260726.json
@@ -0,0 +1,1755 @@
+{
+  "captured_at": "2026-07-26T14:00:06.969030+00:00",
+  "api_base": "http://127.0.0.1:8000",
+  "workplan": "STATE-WP-0070",
+  "retired_interfaces": [],
+  "weekly_review": {
+    "generated_at": "2026-07-26T14:00:06.963119Z",
+    "window_start": "2026-07-26T06:00:06.891319Z",
+    "window_end": "2026-07-26T14:00:06.891319Z",
+    "cadence": "weekly",
+    "activity_core_handoff": {
+      "activity_id": "statehub-legacy-interface-review",
+      "cadence": "weekly",
+      "source_endpoint": "/legacy-meter/weekly-review",
+      "state_owner": "state-hub",
+      "scheduler_owner": "activity-core"
+    },
+    "interfaces": [
+      {
+        "interface": {
+          "id": "8051fb40-66c9-4dc4-a413-13e8573e04a3",
+          "interface_key": "event_subject:org.statehub.workstream.completed",
+          "interface_kind": "event_subject",
+          "legacy_since": "2026-06-04T06:09:42.198193Z",
+          "replacement_ref": "org.statehub.workplan.completed",
+          "owner_component": "state-hub.events",
+          "status": "retired",
+          "replacement_verified": true,
+          "manual_hold": false,
+          "hold_reason": null,
+          "notes": "Retired by STATE-WP-0069 closeout",
+          "retired_at": "2026-07-08T21:38:52.773601Z",
+          "created_at": "2026-06-04T06:09:42.198193Z",
+          "updated_at": "2026-07-08T21:38:52.761243Z"
+        },
+        "all_time": {
+          "calls": 255,
+          "tenant_count": 1,
+          "user_count": 1,
+          "component_count": 1,
+          "tenants": {
+            "unknown": 255
+          },
+          "users": {
+            "unknown": 255
+          },
+          "components": {
+            "state-hub.events": 255
+          }
+        },
+        "window": {
+          "calls": 0,
+          "tenant_count": 0,
+          "user_count": 0,
+          "component_count": 0,
+          "tenants": {},
+          "users": {},
+          "components": {}
+        },
+        "last_seen_at": "2026-07-08T20:49:12.839383Z",
+        "retirement_candidate": false,
+        "retirement_reason": "already retired"
+      },
+      {
+        "interface": {
+          "id": "63ed90e3-42b4-431a-94db-e1254a52f9e2",
+          "interface_key": "mcp:create_workstream",
+          "interface_kind": "mcp_tool",
+          "legacy_since": "2026-07-10T13:19:44.205900Z",
+          "replacement_ref": "create_workplan",
+          "owner_component": "state-hub.mcp",
+          "status": "legacy",
+          "replacement_verified": true,
+          "manual_hold": false,
+          "hold_reason": null,
+          "notes": "Registered by STATE-WP-0070 T03 \u2014 zero-window streak starts at registration",
+          "retired_at": null,
+          "created_at": "2026-07-10T13:19:44.205900Z",
+          "updated_at": "2026-07-10T13:19:44.205900Z"
+        },
+        "all_time": {
+          "calls": 2,
+          "tenant_count": 1,
+          "user_count": 1,
+          "component_count": 1,
+          "tenants": {
+            "unknown": 2
+          },
+          "users": {
+            "unknown": 2
+          },
+          "components": {
+            "state-hub.mcp": 2
+          }
+        },
+        "window": {
+          "calls": 0,
+          "tenant_count": 0,
+          "user_count": 0,
+          "component_count": 0,
+          "tenants": {},
+          "users": {},
+          "components": {}
+        },
+        "last_seen_at": "2026-07-10T13:20:43.378546Z",
+        "retirement_candidate": true,
+        "retirement_reason": "no measured usage in review window"
+      },
+      {
+        "interface": {
+          "id": "b6a5fe44-fb85-4ef7-a273-78d09da777af",
+          "interface_key": "mcp:list_workstreams",
+          "interface_kind": "mcp_tool",
+          "legacy_since": "2026-07-10T13:19:26.075491Z",
+          "replacement_ref": "list_workplans",
+          "owner_component": "state-hub.mcp",
+          "status": "legacy",
+          "replacement_verified": true,
+          "manual_hold": false,
+          "hold_reason": null,
+          "notes": null,
+          "retired_at": null,
+          "created_at": "2026-07-10T13:19:26.075491Z",
+          "updated_at": "2026-07-10T13:19:26.075491Z"
+        },
+        "all_time": {
+          "calls": 2,
+          "tenant_count": 1,
+          "user_count": 1,
+          "component_count": 1,
+          "tenants": {
+            "unknown": 2
+          },
+          "users": {
+            "unknown": 2
+          },
+          "components": {
+            "state-hub.mcp": 2
+          }
+        },
+        "window": {
+          "calls": 0,
+          "tenant_count": 0,
+          "user_count": 0,
+          "component_count": 0,
+          "tenants": {},
+          "users": {},
+          "components": {}
+        },
+        "last_seen_at": "2026-07-10T13:20:42.374940Z",
+        "retirement_candidate": true,
+        "retirement_reason": "no measured usage in review window"
+      },
+      {
+        "interface": {
+          "id": "53c3372b-307d-4d6a-8ea4-bc36cacdcaf2",
+          "interface_key": "mcp:update_workstream",
+          "interface_kind": "mcp_tool",
+          "legacy_since": "2026-07-10T13:19:44.255216Z",
+          "replacement_ref": "update_workplan",
+          "owner_component": "state-hub.mcp",
+          "status": "legacy",
+          "replacement_verified": true,
+          "manual_hold": false,
+          "hold_reason": null,
+          "notes": "Registered by STATE-WP-0070 T03 \u2014 zero-window streak starts at registration",
+          "retired_at": null,
+          "created_at": "2026-07-10T13:19:44.255216Z",
+          "updated_at": "2026-07-10T13:19:44.255216Z"
+        },
+        "all_time": {
+          "calls": 0,
+          "tenant_count": 0,
+          "user_count": 0,
+          "component_count": 0,
+          "tenants": {},
+          "users": {},
+          "components": {}
+        },
+        "window": {
+          "calls": 0,
+          "tenant_count": 0,
+          "user_count": 0,
+          "component_count": 0,
+          "tenants": {},
+          "users": {},
+          "components": {}
+        },
+        "last_seen_at": null,
+        "retirement_candidate": true,
+        "retirement_reason": "no measured usage in review window"
+      },
+      {
+        "interface": {
+          "id": "bed4d08a-3471-48f5-9f0e-f9d550383a26",
+          "interface_key": "mcp:update_workstream_status",
+          "interface_kind": "mcp_tool",
+          "legacy_since": "2026-07-10T13:19:44.303612Z",
+          "replacement_ref": "update_workplan_status",
+          "owner_component": "state-hub.mcp",
+          "status": "legacy",
+          "replacement_verified": true,
+          "manual_hold": false,
+          "hold_reason": null,
+          "notes": "Registered by STATE-WP-0070 T03 \u2014 zero-window streak starts at registration",
+          "retired_at": null,
+          "created_at": "2026-07-10T13:19:44.303612Z",
+          "updated_at": "2026-07-10T13:19:44.303612Z"
+        },
+        "all_time": {
+          "calls": 0,
+          "tenant_count": 0,
+          "user_count": 0,
+          "component_count": 0,
+          "tenants": {},
+          "users": {},
+          "components": {}
+        },
+        "window": {
+          "calls": 0,
+          "tenant_count": 0,
+          "user_count": 0,
+          "component_count": 0,
+          "tenants": {},
+          "users": {},
+          "components": {}
+        },
+        "last_seen_at": null,
+        "retirement_candidate": true,
+        "retirement_reason": "no measured usage in review window"
+      },
+      {
+        "interface": {
+          "id": "46900dc2-0893-405b-ba59-80f31fb6ebb1",
+          "interface_key": "state://workstreams/{topic_slug}",
+          "interface_kind": "mcp_tool",
+          "legacy_since": "2026-07-10T13:19:44.344493Z",
+          "replacement_ref": "state://workplans/{topic_slug}",
+          "owner_component": "state-hub.mcp",
+          "status": "legacy",
+          "replacement_verified": true,
+          "manual_hold": false,
+          "hold_reason": null,
+          "notes": "Registered by STATE-WP-0070 T03 \u2014 zero-window streak starts at registration",
+          "retired_at": null,
+          "created_at": "2026-07-10T13:19:44.344493Z",
+          "updated_at": "2026-07-10T13:19:44.344493Z"
+        },
+        "all_time": {
+          "calls": 1,
+          "tenant_count": 1,
+          "user_count": 1,
+          "component_count": 1,
+          "tenants": {
+            "unknown": 1
+          },
+          "users": {
+            "unknown": 1
+          },
+          "components": {
+            "state-hub.mcp": 1
+          }
+        },
+        "window": {
+          "calls": 0,
+          "tenant_count": 0,
+          "user_count": 0,
+          "component_count": 0,
+          "tenants": {},
+          "users": {},
+          "components": {}
+        },
+        "last_seen_at": "2026-07-10T13:20:34.491811Z",
+        "retirement_candidate": true,
+        "retirement_reason": "no measured usage in review window"
+      },
+      {
+        "interface": {
+          "id": "cd9342fd-27e7-4a46-a1be-d41499e106a3",
+          "interface_key": "rest_api:DELETE /workstreams/{workstream_id}",
+          "interface_kind": "rest_api",
+          "legacy_since": "2026-06-06T17:28:13.052813Z",
+          "replacement_ref": "/workplans/{workplan_id}",
+          "owner_component": "state-hub.api",
+          "status": "legacy",
+          "replacement_verified": true,
+          "manual_hold": false,
+          "hold_reason": null,
+          "notes": null,
+          "retired_at": null,
+          "created_at": "2026-06-06T17:28:13.052813Z",
+          "updated_at": "2026-06-06T17:28:13.052813Z"
+        },
+        "all_time": {
+          "calls": 1,
+          "tenant_count": 1,
+          "user_count": 1,
+          "component_count": 1,
+          "tenants": {
+            "unknown": 1
+          },
+          "users": {
+            "unknown": 1
+          },
+          "components": {
+            "unknown": 1
+          }
+        },
+        "window": {
+          "calls": 0,
+          "tenant_count": 0,
+          "user_count": 0,
+          "component_count": 0,
+          "tenants": {},
+          "users": {},
+          "components": {}
+        },
+        "last_seen_at": "2026-06-06T17:28:13.047529Z",
+        "retirement_candidate": true,
+        "retirement_reason": "no measured usage in review window"
+      },
+      {
+        "interface": {
+          "id": "a4e0948c-cd4a-461e-8ae2-7fd7b51d04a7",
+          "interface_key": "rest_api:GET /decisions/?workstream_id",
+          "interface_kind": "rest_api",
+          "legacy_since": "2026-07-09T23:07:53.093223Z",
+          "replacement_ref": "/decisions/?workplan_id=<workplan_id>",
+          "owner_component": "state-hub.api",
+          "status": "legacy",
+          "replacement_verified": true,
+          "manual_hold": false,
+          "hold_reason": null,
+          "notes": null,
+          "retired_at": null,
+          "created_at": "2026-07-09T23:07:53.093223Z",
+          "updated_at": "2026-07-09T23:07:53.093223Z"
+        },
+        "all_time": {
+          "calls": 1,
+          "tenant_count": 1,
+          "user_count": 1,
+          "component_count": 1,
+          "tenants": {
+            "unknown": 1
+          },
+          "users": {
+            "unknown": 1
+          },
+          "components": {
+            "unknown": 1
+          }
+        },
+        "window": {
+          "calls": 0,
+          "tenant_count": 0,
+          "user_count": 0,
+          "component_count": 0,
+          "tenants": {},
+          "users": {},
+          "components": {}
+        },
+        "last_seen_at": "2026-07-09T23:07:53.083299Z",
+        "retirement_candidate": true,
+        "retirement_reason": "no measured usage in review window"
+      },
+      {
+        "interface": {
+          "id": "70a9346e-e0ee-42ac-874f-f160580b54dd",
+          "interface_key": "rest_api:GET /progress/?workstream_id",
+          "interface_kind": "rest_api",
+          "legacy_since": "2026-07-13T22:04:03.911449Z",
+          "replacement_ref": "/progress/?workplan_id=<workplan_id>",
+          "owner_component": "state-hub.api",
+          "status": "legacy",
+          "replacement_verified": true,
+          "manual_hold": false,
+          "hold_reason": null,
+          "notes": null,
+          "retired_at": null,
+          "created_at": "2026-07-13T22:04:03.911449Z",
+          "updated_at": "2026-07-13T22:04:03.911449Z"
+        },
+        "all_time": {
+          "calls": 1,
+          "tenant_count": 1,
+          "user_count": 1,
+          "component_count": 1,
+          "tenants": {
+            "unknown": 1
+          },
+          "users": {
+            "unknown": 1
+          },
+          "components": {
+            "unknown": 1
+          }
+        },
+        "window": {
+          "calls": 0,
+          "tenant_count": 0,
+          "user_count": 0,
+          "component_count": 0,
+          "tenants": {},
+          "users": {},
+          "components": {}
+        },
+        "last_seen_at": "2026-07-13T22:04:03.904998Z",
+        "retirement_candidate": true,
+        "retirement_reason": "no measured usage in review window"
+      },
+      {
+        "interface": {
+          "id": "be3cdcf8-250b-4bf0-801f-02ffd5f57e00",
+          "interface_key": "rest_api:GET /tasks/?workstream_id",
+          "interface_kind": "rest_api",
+          "legacy_since": "2026-07-08T19:32:21.628513Z",
+          "replacement_ref": "/tasks/?workplan_id=<workplan_id>",
+          "owner_component": "state-hub.api",
+          "status": "legacy",
+          "replacement_verified": true,
+          "manual_hold": false,
+          "hold_reason": null,
+          "notes": null,
+          "retired_at": null,
+          "created_at": "2026-07-08T19:32:21.628513Z",
+          "updated_at": "2026-07-08T19:32:21.628513Z"
+        },
+        "all_time": {
+          "calls": 587,
+          "tenant_count": 1,
+          "user_count": 1,
+          "component_count": 1,
+          "tenants": {
+            "unknown": 587
+          },
+          "users": {
+            "unknown": 587
+          },
+          "components": {
+            "unknown": 587
+          }
+        },
+        "window": {
+          "calls": 0,
+          "tenant_count": 0,
+          "user_count": 0,
+          "component_count": 0,
+          "tenants": {},
+          "users": {},
+          "components": {}
+        },
+        "last_seen_at": "2026-07-22T13:21:12.171828Z",
+        "retirement_candidate": true,
+        "retirement_reason": "no measured usage in review window"
+      },
+      {
+        "interface": {
+          "id": "3e4a3d0b-08fa-45c3-91e2-4f514a914b97",
+          "interface_key": "rest_api:GET /workstreams/",
+          "interface_kind": "rest_api",
+          "legacy_since": "2026-06-04T00:26:14.533764Z",
+          "replacement_ref": "/workplans/",
+          "owner_component": "state-hub.api",
+          "status": "legacy",
+          "replacement_verified": true,
+          "manual_hold": false,
+          "hold_reason": null,
+          "notes": null,
+          "retired_at": null,
+          "created_at": "2026-06-04T00:26:14.533764Z",
+          "updated_at": "2026-06-04T00:26:14.533764Z"
+        },
+        "all_time": {
+          "calls": 144084,
+          "tenant_count": 1,
+          "user_count": 1,
+          "component_count": 1,
+          "tenants": {
+            "unknown": 144084
+          },
+          "users": {
+            "unknown": 144084
+          },
+          "components": {
+            "unknown": 144084
+          }
+        },
+        "window": {
+          "calls": 0,
+          "tenant_count": 0,
+          "user_count": 0,
+          "component_count": 0,
+          "tenants": {},
+          "users": {},
+          "components": {}
+        },
+        "last_seen_at": "2026-07-08T21:14:39.652776Z",
+        "retirement_candidate": true,
+        "retirement_reason": "no measured usage in review window"
+      },
+      {
+        "interface": {
+          "id": "e4c140ec-7479-46f9-b185-4b533f19d639",
+          "interface_key": "rest_api:GET /workstreams/workplan-index",
+          "interface_kind": "rest_api",
+          "legacy_since": "2026-06-04T05:20:58.321869Z",
+          "replacement_ref": "/workplans/index",
+          "owner_component": "state-hub.api",
+          "status": "legacy",
+          "replacement_verified": true,
+          "manual_hold": false,
+          "hold_reason": null,
+          "notes": null,
+          "retired_at": null,
+          "created_at": "2026-06-04T05:20:58.321869Z",
+          "updated_at": "2026-06-04T05:20:58.321869Z"
+        },
+        "all_time": {
+          "calls": 30,
+          "tenant_count": 1,
+          "user_count": 1,
+          "component_count": 1,
+          "tenants": {
+            "unknown": 30
+          },
+          "users": {
+            "unknown": 30
+          },
+          "components": {
+            "unknown": 30
+          }
+        },
+        "window": {
+          "calls": 0,
+          "tenant_count": 0,
+          "user_count": 0,
+          "component_count": 0,
+          "tenants": {},
+          "users": {},
+          "components": {}
+        },
+        "last_seen_at": "2026-07-03T05:20:34.534439Z",
+        "retirement_candidate": true,
+        "retirement_reason": "no measured usage in review window"
+      },
+      {
+        "interface": {
+          "id": "3a00b19e-e7db-4403-98aa-a77c9ab61ecc",
+          "interface_key": "rest_api:GET /workstreams/{workstream_id}",
+          "interface_kind": "rest_api",
+          "legacy_since": "2026-06-04T00:25:59.014966Z",
+          "replacement_ref": "/workplans/{workplan_id}",
+          "owner_component": "state-hub.api",
+          "status": "legacy",
+          "replacement_verified": true,
+          "manual_hold": false,
+          "hold_reason": null,
+          "notes": null,
+          "retired_at": null,
+          "created_at": "2026-06-04T00:25:59.014966Z",
+          "updated_at": "2026-06-04T00:25:59.014966Z"
+        },
+        "all_time": {
+          "calls": 511405,
+          "tenant_count": 1,
+          "user_count": 1,
+          "component_count": 1,
+          "tenants": {
+            "unknown": 511405
+          },
+          "users": {
+            "unknown": 511405
+          },
+          "components": {
+            "unknown": 511405
+          }
+        },
+        "window": {
+          "calls": 0,
+          "tenant_count": 0,
+          "user_count": 0,
+          "component_count": 0,
+          "tenants": {},
+          "users": {},
+          "components": {}
+        },
+        "last_seen_at": "2026-07-08T21:14:20.781103Z",
+        "retirement_candidate": true,
+        "retirement_reason": "no measured usage in review window"
+      },
+      {
+        "interface": {
+          "id": "69e1a255-a8b9-4101-8a68-b1bed23abfda",
+          "interface_key": "rest_api:GET /workstreams/{workstream_id}/dependencies/",
+          "interface_kind": "rest_api",
+          "legacy_since": "2026-06-04T00:25:59.291135Z",
+          "replacement_ref": "/workplans/{workplan_id}/dependencies/",
+          "owner_component": "state-hub.api",
+          "status": "legacy",
+          "replacement_verified": true,
+          "manual_hold": false,
+          "hold_reason": null,
+          "notes": null,
+          "retired_at": null,
+          "created_at": "2026-06-04T00:25:59.291135Z",
+          "updated_at": "2026-06-04T00:25:59.291135Z"
+        },
+        "all_time": {
+          "calls": 255865,
+          "tenant_count": 1,
+          "user_count": 1,
+          "component_count": 1,
+          "tenants": {
+            "unknown": 255865
+          },
+          "users": {
+            "unknown": 255865
+          },
+          "components": {
+            "unknown": 255865
+          }
+        },
+        "window": {
+          "calls": 0,
+          "tenant_count": 0,
+          "user_count": 0,
+          "component_count": 0,
+          "tenants": {},
+          "users": {},
+          "components": {}
+        },
+        "last_seen_at": "2026-07-08T21:14:12.747005Z",
+        "retirement_candidate": true,
+        "retirement_reason": "no measured usage in review window"
+      },
+      {
+        "interface": {
+          "id": "b1aae931-b51f-4a85-a723-865dd65f6132",
+          "interface_key": "rest_api:PATCH /workstreams/{workstream_id}",
+          "interface_kind": "rest_api",
+          "legacy_since": "2026-06-04T06:09:41.901035Z",
+          "replacement_ref": "/workplans/{workplan_id}",
+          "owner_component": "state-hub.api",
+          "status": "legacy",
+          "replacement_verified": true,
+          "manual_hold": false,
+          "hold_reason": null,
+          "notes": null,
+          "retired_at": null,
+          "created_at": "2026-06-04T06:09:41.901035Z",
+          "updated_at": "2026-06-04T06:09:41.901035Z"
+        },
+        "all_time": {
+          "calls": 571,
+          "tenant_count": 1,
+          "user_count": 1,
+          "component_count": 1,
+          "tenants": {
+            "unknown": 571
+          },
+          "users": {
+            "unknown": 571
+          },
+          "components": {
+            "unknown": 571
+          }
+        },
+        "window": {
+          "calls": 0,
+          "tenant_count": 0,
+          "user_count": 0,
+          "component_count": 0,
+          "tenants": {},
+          "users": {},
+          "components": {}
+        },
+        "last_seen_at": "2026-07-08T20:49:12.335710Z",
+        "retirement_candidate": true,
+        "retirement_reason": "no measured usage in review window"
+      },
+      {
+        "interface": {
+          "id": "4aea9591-970b-4918-ac4a-4da95a0a1a8c",
+          "interface_key": "rest_api:POST /decisions/ workstream_id",
+          "interface_kind": "rest_api",
+          "legacy_since": "2026-07-09T22:56:35.473130Z",
+          "replacement_ref": "POST /decisions/ with workplan_id",
+          "owner_component": "state-hub.api",
+          "status": "legacy",
+          "replacement_verified": true,
+          "manual_hold": false,
+          "hold_reason": null,
+          "notes": null,
+          "retired_at": null,
+          "created_at": "2026-07-09T22:56:35.473130Z",
+          "updated_at": "2026-07-09T22:56:35.473130Z"
+        },
+        "all_time": {
+          "calls": 3,
+          "tenant_count": 1,
+          "user_count": 1,
+          "component_count": 1,
+          "tenants": {
+            "unknown": 3
+          },
+          "users": {
+            "unknown": 3
+          },
+          "components": {
+            "unknown": 3
+          }
+        },
+        "window": {
+          "calls": 0,
+          "tenant_count": 0,
+          "user_count": 0,
+          "component_count": 0,
+          "tenants": {},
+          "users": {},
+          "components": {}
+        },
+        "last_seen_at": "2026-07-09T22:57:05.912456Z",
+        "retirement_candidate": true,
+        "retirement_reason": "no measured usage in review window"
+      },
+      {
+        "interface": {
+          "id": "4a70583c-1e41-4ec1-99a9-728856a7d79c",
+          "interface_key": "rest_api:POST /progress/ workstream_id",
+          "interface_kind": "rest_api",
+          "legacy_since": "2026-07-08T23:35:09.148333Z",
+          "replacement_ref": "POST /progress/ with workplan_id",
+          "owner_component": "state-hub.api",
+          "status": "legacy",
+          "replacement_verified": true,
+          "manual_hold": false,
+          "hold_reason": null,
+          "notes": null,
+          "retired_at": null,
+          "created_at": "2026-07-08T23:35:09.148333Z",
+          "updated_at": "2026-07-08T23:35:09.148333Z"
+        },
+        "all_time": {
+          "calls": 14,
+          "tenant_count": 1,
+          "user_count": 1,
+          "component_count": 1,
+          "tenants": {
+            "unknown": 14
+          },
+          "users": {
+            "unknown": 14
+          },
+          "components": {
+            "unknown": 14
+          }
+        },
+        "window": {
+          "calls": 0,
+          "tenant_count": 0,
+          "user_count": 0,
+          "component_count": 0,
+          "tenants": {},
+          "users": {},
+          "components": {}
+        },
+        "last_seen_at": "2026-07-10T08:34:42.959724Z",
+        "retirement_candidate": true,
+        "retirement_reason": "no measured usage in review window"
+      },
+      {
+        "interface": {
+          "id": "6df4e443-7bf1-461a-923b-a6eb52fe7b07",
+          "interface_key": "rest_api:POST /tasks/ workstream_id",
+          "interface_kind": "rest_api",
+          "legacy_since": "2026-07-08T22:38:29.405720Z",
+          "replacement_ref": "POST /tasks/ with workplan_id",
+          "owner_component": "state-hub.api",
+          "status": "legacy",
+          "replacement_verified": true,
+          "manual_hold": false,
+          "hold_reason": null,
+          "notes": null,
+          "retired_at": null,
+          "created_at": "2026-07-08T22:38:29.405720Z",
+          "updated_at": "2026-07-08T22:38:29.405720Z"
+        },
+        "all_time": {
+          "calls": 5,
+          "tenant_count": 1,
+          "user_count": 1,
+          "component_count": 1,
+          "tenants": {
+            "unknown": 5
+          },
+          "users": {
+            "unknown": 5
+          },
+          "components": {
+            "state-hub.fix-consistency": 5
+          }
+        },
+        "window": {
+          "calls": 0,
+          "tenant_count": 0,
+          "user_count": 0,
+          "component_count": 0,
+          "tenants": {},
+          "users": {},
+          "components": {}
+        },
+        "last_seen_at": "2026-07-08T22:38:29.976918Z",
+        "retirement_candidate": true,
+        "retirement_reason": "no measured usage in review window"
+      },
+      {
+        "interface": {
+          "id": "ed6451c9-d2cc-4486-9afe-d3852782cabc",
+          "interface_key": "rest_api:POST /workstreams/",
+          "interface_kind": "rest_api",
+          "legacy_since": "2026-06-04T07:40:24.168535Z",
+          "replacement_ref": "/workplans/",
+          "owner_component": "state-hub.api",
+          "status": "legacy",
+          "replacement_verified": true,
+          "manual_hold": false,
+          "hold_reason": null,
+          "notes": null,
+          "retired_at": null,
+          "created_at": "2026-06-04T07:40:24.168535Z",
+          "updated_at": "2026-06-04T07:40:24.168535Z"
+        },
+        "all_time": {
+          "calls": 824,
+          "tenant_count": 1,
+          "user_count": 1,
+          "component_count": 1,
+          "tenants": {
+            "unknown": 824
+          },
+          "users": {
+            "unknown": 824
+          },
+          "components": {
+            "unknown": 824
+          }
+        },
+        "window": {
+          "calls": 0,
+          "tenant_count": 0,
+          "user_count": 0,
+          "component_count": 0,
+          "tenants": {},
+          "users": {},
+          "components": {}
+        },
+        "last_seen_at": "2026-07-08T20:38:05.903144Z",
+        "retirement_candidate": true,
+        "retirement_reason": "no measured usage in review window"
+      },
+      {
+        "interface": {
+          "id": "281fd706-b192-4194-8055-2d8733c115f9",
+          "interface_key": "rest_api:POST /workstreams/{workstream_id}/dependencies/",
+          "interface_kind": "rest_api",
+          "legacy_since": "2026-06-04T22:57:37.149207Z",
+          "replacement_ref": "/workplans/{workplan_id}/dependencies/",
+          "owner_component": "state-hub.api",
+          "status": "legacy",
+          "replacement_verified": true,
+          "manual_hold": false,
+          "hold_reason": null,
+          "notes": null,
+          "retired_at": null,
+          "created_at": "2026-06-04T22:57:37.149207Z",
+          "updated_at": "2026-06-04T22:57:37.149207Z"
+        },
+        "all_time": {
+          "calls": 4971,
+          "tenant_count": 1,
+          "user_count": 1,
+          "component_count": 1,
+          "tenants": {
+            "unknown": 4971
+          },
+          "users": {
+            "unknown": 4971
+          },
+          "components": {
+            "unknown": 4971
+          }
+        },
+        "window": {
+          "calls": 0,
+          "tenant_count": 0,
+          "user_count": 0,
+          "component_count": 0,
+          "tenants": {},
+          "users": {},
+          "components": {}
+        },
+        "last_seen_at": "2026-07-01T22:09:24.229011Z",
+        "retirement_candidate": true,
+        "retirement_reason": "no measured usage in review window"
+      }
+    ],
+    "retirement_candidates": [
+      {
+        "interface": {
+          "id": "63ed90e3-42b4-431a-94db-e1254a52f9e2",
+          "interface_key": "mcp:create_workstream",
+          "interface_kind": "mcp_tool",
+          "legacy_since": "2026-07-10T13:19:44.205900Z",
+          "replacement_ref": "create_workplan",
+          "owner_component": "state-hub.mcp",
+          "status": "legacy",
+          "replacement_verified": true,
+          "manual_hold": false,
+          "hold_reason": null,
+          "notes": "Registered by STATE-WP-0070 T03 \u2014 zero-window streak starts at registration",
+          "retired_at": null,
+          "created_at": "2026-07-10T13:19:44.205900Z",
+          "updated_at": "2026-07-10T13:19:44.205900Z"
+        },
+        "all_time": {
+          "calls": 2,
+          "tenant_count": 1,
+          "user_count": 1,
+          "component_count": 1,
+          "tenants": {
+            "unknown": 2
+          },
+          "users": {
+            "unknown": 2
+          },
+          "components": {
+            "state-hub.mcp": 2
+          }
+        },
+        "window": {
+          "calls": 0,
+          "tenant_count": 0,
+          "user_count": 0,
+          "component_count": 0,
+          "tenants": {},
+          "users": {},
+          "components": {}
+        },
+        "last_seen_at": "2026-07-10T13:20:43.378546Z",
+        "retirement_candidate": true,
+        "retirement_reason": "no measured usage in review window"
+      },
+      {
+        "interface": {
+          "id": "b6a5fe44-fb85-4ef7-a273-78d09da777af",
+          "interface_key": "mcp:list_workstreams",
+          "interface_kind": "mcp_tool",
+          "legacy_since": "2026-07-10T13:19:26.075491Z",
+          "replacement_ref": "list_workplans",
+          "owner_component": "state-hub.mcp",
+          "status": "legacy",
+          "replacement_verified": true,
+          "manual_hold": false,
+          "hold_reason": null,
+          "notes": null,
+          "retired_at": null,
+          "created_at": "2026-07-10T13:19:26.075491Z",
+          "updated_at": "2026-07-10T13:19:26.075491Z"
+        },
+        "all_time": {
+          "calls": 2,
+          "tenant_count": 1,
+          "user_count": 1,
+          "component_count": 1,
+          "tenants": {
+            "unknown": 2
+          },
+          "users": {
+            "unknown": 2
+          },
+          "components": {
+            "state-hub.mcp": 2
+          }
+        },
+        "window": {
+          "calls": 0,
+          "tenant_count": 0,
+          "user_count": 0,
+          "component_count": 0,
+          "tenants": {},
+          "users": {},
+          "components": {}
+        },
+        "last_seen_at": "2026-07-10T13:20:42.374940Z",
+        "retirement_candidate": true,
+        "retirement_reason": "no measured usage in review window"
+      },
+      {
+        "interface": {
+          "id": "53c3372b-307d-4d6a-8ea4-bc36cacdcaf2",
+          "interface_key": "mcp:update_workstream",
+          "interface_kind": "mcp_tool",
+          "legacy_since": "2026-07-10T13:19:44.255216Z",
+          "replacement_ref": "update_workplan",
+          "owner_component": "state-hub.mcp",
+          "status": "legacy",
+          "replacement_verified": true,
+          "manual_hold": false,
+          "hold_reason": null,
+          "notes": "Registered by STATE-WP-0070 T03 \u2014 zero-window streak starts at registration",
+          "retired_at": null,
+          "created_at": "2026-07-10T13:19:44.255216Z",
+          "updated_at": "2026-07-10T13:19:44.255216Z"
+        },
+        "all_time": {
+          "calls": 0,
+          "tenant_count": 0,
+          "user_count": 0,
+          "component_count": 0,
+          "tenants": {},
+          "users": {},
+          "components": {}
+        },
+        "window": {
+          "calls": 0,
+          "tenant_count": 0,
+          "user_count": 0,
+          "component_count": 0,
+          "tenants": {},
+          "users": {},
+          "components": {}
+        },
+        "last_seen_at": null,
+        "retirement_candidate": true,
+        "retirement_reason": "no measured usage in review window"
+      },
+      {
+        "interface": {
+          "id": "bed4d08a-3471-48f5-9f0e-f9d550383a26",
+          "interface_key": "mcp:update_workstream_status",
+          "interface_kind": "mcp_tool",
+          "legacy_since": "2026-07-10T13:19:44.303612Z",
+          "replacement_ref": "update_workplan_status",
+          "owner_component": "state-hub.mcp",
+          "status": "legacy",
+          "replacement_verified": true,
+          "manual_hold": false,
+          "hold_reason": null,
+          "notes": "Registered by STATE-WP-0070 T03 \u2014 zero-window streak starts at registration",
+          "retired_at": null,
+          "created_at": "2026-07-10T13:19:44.303612Z",
+          "updated_at": "2026-07-10T13:19:44.303612Z"
+        },
+        "all_time": {
+          "calls": 0,
+          "tenant_count": 0,
+          "user_count": 0,
+          "component_count": 0,
+          "tenants": {},
+          "users": {},
+          "components": {}
+        },
+        "window": {
+          "calls": 0,
+          "tenant_count": 0,
+          "user_count": 0,
+          "component_count": 0,
+          "tenants": {},
+          "users": {},
+          "components": {}
+        },
+        "last_seen_at": null,
+        "retirement_candidate": true,
+        "retirement_reason": "no measured usage in review window"
+      },
+      {
+        "interface": {
+          "id": "46900dc2-0893-405b-ba59-80f31fb6ebb1",
+          "interface_key": "state://workstreams/{topic_slug}",
+          "interface_kind": "mcp_tool",
+          "legacy_since": "2026-07-10T13:19:44.344493Z",
+          "replacement_ref": "state://workplans/{topic_slug}",
+          "owner_component": "state-hub.mcp",
+          "status": "legacy",
+          "replacement_verified": true,
+          "manual_hold": false,
+          "hold_reason": null,
+          "notes": "Registered by STATE-WP-0070 T03 \u2014 zero-window streak starts at registration",
+          "retired_at": null,
+          "created_at": "2026-07-10T13:19:44.344493Z",
+          "updated_at": "2026-07-10T13:19:44.344493Z"
+        },
+        "all_time": {
+          "calls": 1,
+          "tenant_count": 1,
+          "user_count": 1,
+          "component_count": 1,
+          "tenants": {
+            "unknown": 1
+          },
+          "users": {
+            "unknown": 1
+          },
+          "components": {
+            "state-hub.mcp": 1
+          }
+        },
+        "window": {
+          "calls": 0,
+          "tenant_count": 0,
+          "user_count": 0,
+          "component_count": 0,
+          "tenants": {},
+          "users": {},
+          "components": {}
+        },
+        "last_seen_at": "2026-07-10T13:20:34.491811Z",
+        "retirement_candidate": true,
+        "retirement_reason": "no measured usage in review window"
+      },
+      {
+        "interface": {
+          "id": "cd9342fd-27e7-4a46-a1be-d41499e106a3",
+          "interface_key": "rest_api:DELETE /workstreams/{workstream_id}",
+          "interface_kind": "rest_api",
+          "legacy_since": "2026-06-06T17:28:13.052813Z",
+          "replacement_ref": "/workplans/{workplan_id}",
+          "owner_component": "state-hub.api",
+          "status": "legacy",
+          "replacement_verified": true,
+          "manual_hold": false,
+          "hold_reason": null,
+          "notes": null,
+          "retired_at": null,
+          "created_at": "2026-06-06T17:28:13.052813Z",
+          "updated_at": "2026-06-06T17:28:13.052813Z"
+        },
+        "all_time": {
+          "calls": 1,
+          "tenant_count": 1,
+          "user_count": 1,
+          "component_count": 1,
+          "tenants": {
+            "unknown": 1
+          },
+          "users": {
+            "unknown": 1
+          },
+          "components": {
+            "unknown": 1
+          }
+        },
+        "window": {
+          "calls": 0,
+          "tenant_count": 0,
+          "user_count": 0,
+          "component_count": 0,
+          "tenants": {},
+          "users": {},
+          "components": {}
+        },
+        "last_seen_at": "2026-06-06T17:28:13.047529Z",
+        "retirement_candidate": true,
+        "retirement_reason": "no measured usage in review window"
+      },
+      {
+        "interface": {
+          "id": "a4e0948c-cd4a-461e-8ae2-7fd7b51d04a7",
+          "interface_key": "rest_api:GET /decisions/?workstream_id",
+          "interface_kind": "rest_api",
+          "legacy_since": "2026-07-09T23:07:53.093223Z",
+          "replacement_ref": "/decisions/?workplan_id=<workplan_id>",
+          "owner_component": "state-hub.api",
+          "status": "legacy",
+          "replacement_verified": true,
+          "manual_hold": false,
+          "hold_reason": null,
+          "notes": null,
+          "retired_at": null,
+          "created_at": "2026-07-09T23:07:53.093223Z",
+          "updated_at": "2026-07-09T23:07:53.093223Z"
+        },
+        "all_time": {
+          "calls": 1,
+          "tenant_count": 1,
+          "user_count": 1,
+          "component_count": 1,
+          "tenants": {
+            "unknown": 1
+          },
+          "users": {
+            "unknown": 1
+          },
+          "components": {
+            "unknown": 1
+          }
+        },
+        "window": {
+          "calls": 0,
+          "tenant_count": 0,
+          "user_count": 0,
+          "component_count": 0,
+          "tenants": {},
+          "users": {},
+          "components": {}
+        },
+        "last_seen_at": "2026-07-09T23:07:53.083299Z",
+        "retirement_candidate": true,
+        "retirement_reason": "no measured usage in review window"
+      },
+      {
+        "interface": {
+          "id": "70a9346e-e0ee-42ac-874f-f160580b54dd",
+          "interface_key": "rest_api:GET /progress/?workstream_id",
+          "interface_kind": "rest_api",
+          "legacy_since": "2026-07-13T22:04:03.911449Z",
+          "replacement_ref": "/progress/?workplan_id=<workplan_id>",
+          "owner_component": "state-hub.api",
+          "status": "legacy",
+          "replacement_verified": true,
+          "manual_hold": false,
+          "hold_reason": null,
+          "notes": null,
+          "retired_at": null,
+          "created_at": "2026-07-13T22:04:03.911449Z",
+          "updated_at": "2026-07-13T22:04:03.911449Z"
+        },
+        "all_time": {
+          "calls": 1,
+          "tenant_count": 1,
+          "user_count": 1,
+          "component_count": 1,
+          "tenants": {
+            "unknown": 1
+          },
+          "users": {
+            "unknown": 1
+          },
+          "components": {
+            "unknown": 1
+          }
+        },
+        "window": {
+          "calls": 0,
+          "tenant_count": 0,
+          "user_count": 0,
+          "component_count": 0,
+          "tenants": {},
+          "users": {},
+          "components": {}
+        },
+        "last_seen_at": "2026-07-13T22:04:03.904998Z",
+        "retirement_candidate": true,
+        "retirement_reason": "no measured usage in review window"
+      },
+      {
+        "interface": {
+          "id": "be3cdcf8-250b-4bf0-801f-02ffd5f57e00",
+          "interface_key": "rest_api:GET /tasks/?workstream_id",
+          "interface_kind": "rest_api",
+          "legacy_since": "2026-07-08T19:32:21.628513Z",
+          "replacement_ref": "/tasks/?workplan_id=<workplan_id>",
+          "owner_component": "state-hub.api",
+          "status": "legacy",
+          "replacement_verified": true,
+          "manual_hold": false,
+          "hold_reason": null,
+          "notes": null,
+          "retired_at": null,
+          "created_at": "2026-07-08T19:32:21.628513Z",
+          "updated_at": "2026-07-08T19:32:21.628513Z"
+        },
+        "all_time": {
+          "calls": 587,
+          "tenant_count": 1,
+          "user_count": 1,
+          "component_count": 1,
+          "tenants": {
+            "unknown": 587
+          },
+          "users": {
+            "unknown": 587
+          },
+          "components": {
+            "unknown": 587
+          }
+        },
+        "window": {
+          "calls": 0,
+          "tenant_count": 0,
+          "user_count": 0,
+          "component_count": 0,
+          "tenants": {},
+          "users": {},
+          "components": {}
+        },
+        "last_seen_at": "2026-07-22T13:21:12.171828Z",
+        "retirement_candidate": true,
+        "retirement_reason": "no measured usage in review window"
+      },
+      {
+        "interface": {
+          "id": "3e4a3d0b-08fa-45c3-91e2-4f514a914b97",
+          "interface_key": "rest_api:GET /workstreams/",
+          "interface_kind": "rest_api",
+          "legacy_since": "2026-06-04T00:26:14.533764Z",
+          "replacement_ref": "/workplans/",
+          "owner_component": "state-hub.api",
+          "status": "legacy",
+          "replacement_verified": true,
+          "manual_hold": false,
+          "hold_reason": null,
+          "notes": null,
+          "retired_at": null,
+          "created_at": "2026-06-04T00:26:14.533764Z",
+          "updated_at": "2026-06-04T00:26:14.533764Z"
+        },
+        "all_time": {
+          "calls": 144084,
+          "tenant_count": 1,
+          "user_count": 1,
+          "component_count": 1,
+          "tenants": {
+            "unknown": 144084
+          },
+          "users": {
+            "unknown": 144084
+          },
+          "components": {
+            "unknown": 144084
+          }
+        },
+        "window": {
+          "calls": 0,
+          "tenant_count": 0,
+          "user_count": 0,
+          "component_count": 0,
+          "tenants": {},
+          "users": {},
+          "components": {}
+        },
+        "last_seen_at": "2026-07-08T21:14:39.652776Z",
+        "retirement_candidate": true,
+        "retirement_reason": "no measured usage in review window"
+      },
+      {
+        "interface": {
+          "id": "e4c140ec-7479-46f9-b185-4b533f19d639",
+          "interface_key": "rest_api:GET /workstreams/workplan-index",
+          "interface_kind": "rest_api",
+          "legacy_since": "2026-06-04T05:20:58.321869Z",
+          "replacement_ref": "/workplans/index",
+          "owner_component": "state-hub.api",
+          "status": "legacy",
+          "replacement_verified": true,
+          "manual_hold": false,
+          "hold_reason": null,
+          "notes": null,
+          "retired_at": null,
+          "created_at": "2026-06-04T05:20:58.321869Z",
+          "updated_at": "2026-06-04T05:20:58.321869Z"
+        },
+        "all_time": {
+          "calls": 30,
+          "tenant_count": 1,
+          "user_count": 1,
+          "component_count": 1,
+          "tenants": {
+            "unknown": 30
+          },
+          "users": {
+            "unknown": 30
+          },
+          "components": {
+            "unknown": 30
+          }
+        },
+        "window": {
+          "calls": 0,
+          "tenant_count": 0,
+          "user_count": 0,
+          "component_count": 0,
+          "tenants": {},
+          "users": {},
+          "components": {}
+        },
+        "last_seen_at": "2026-07-03T05:20:34.534439Z",
+        "retirement_candidate": true,
+        "retirement_reason": "no measured usage in review window"
+      },
+      {
+        "interface": {
+          "id": "3a00b19e-e7db-4403-98aa-a77c9ab61ecc",
+          "interface_key": "rest_api:GET /workstreams/{workstream_id}",
+          "interface_kind": "rest_api",
+          "legacy_since": "2026-06-04T00:25:59.014966Z",
+          "replacement_ref": "/workplans/{workplan_id}",
+          "owner_component": "state-hub.api",
+          "status": "legacy",
+          "replacement_verified": true,
+          "manual_hold": false,
+          "hold_reason": null,
+          "notes": null,
+          "retired_at": null,
+          "created_at": "2026-06-04T00:25:59.014966Z",
+          "updated_at": "2026-06-04T00:25:59.014966Z"
+        },
+        "all_time": {
+          "calls": 511405,
+          "tenant_count": 1,
+          "user_count": 1,
+          "component_count": 1,
+          "tenants": {
+            "unknown": 511405
+          },
+          "users": {
+            "unknown": 511405
+          },
+          "components": {
+            "unknown": 511405
+          }
+        },
+        "window": {
+          "calls": 0,
+          "tenant_count": 0,
+          "user_count": 0,
+          "component_count": 0,
+          "tenants": {},
+          "users": {},
+          "components": {}
+        },
+        "last_seen_at": "2026-07-08T21:14:20.781103Z",
+        "retirement_candidate": true,
+        "retirement_reason": "no measured usage in review window"
+      },
+      {
+        "interface": {
+          "id": "69e1a255-a8b9-4101-8a68-b1bed23abfda",
+          "interface_key": "rest_api:GET /workstreams/{workstream_id}/dependencies/",
+          "interface_kind": "rest_api",
+          "legacy_since": "2026-06-04T00:25:59.291135Z",
+          "replacement_ref": "/workplans/{workplan_id}/dependencies/",
+          "owner_component": "state-hub.api",
+          "status": "legacy",
+          "replacement_verified": true,
+          "manual_hold": false,
+          "hold_reason": null,
+          "notes": null,
+          "retired_at": null,
+          "created_at": "2026-06-04T00:25:59.291135Z",
+          "updated_at": "2026-06-04T00:25:59.291135Z"
+        },
+        "all_time": {
+          "calls": 255865,
+          "tenant_count": 1,
+          "user_count": 1,
+          "component_count": 1,
+          "tenants": {
+            "unknown": 255865
+          },
+          "users": {
+            "unknown": 255865
+          },
+          "components": {
+            "unknown": 255865
+          }
+        },
+        "window": {
+          "calls": 0,
+          "tenant_count": 0,
+          "user_count": 0,
+          "component_count": 0,
+          "tenants": {},
+          "users": {},
+          "components": {}
+        },
+        "last_seen_at": "2026-07-08T21:14:12.747005Z",
+        "retirement_candidate": true,
+        "retirement_reason": "no measured usage in review window"
+      },
+      {
+        "interface": {
+          "id": "b1aae931-b51f-4a85-a723-865dd65f6132",
+          "interface_key": "rest_api:PATCH /workstreams/{workstream_id}",
+          "interface_kind": "rest_api",
+          "legacy_since": "2026-06-04T06:09:41.901035Z",
+          "replacement_ref": "/workplans/{workplan_id}",
+          "owner_component": "state-hub.api",
+          "status": "legacy",
+          "replacement_verified": true,
+          "manual_hold": false,
+          "hold_reason": null,
+          "notes": null,
+          "retired_at": null,
+          "created_at": "2026-06-04T06:09:41.901035Z",
+          "updated_at": "2026-06-04T06:09:41.901035Z"
+        },
+        "all_time": {
+          "calls": 571,
+          "tenant_count": 1,
+          "user_count": 1,
+          "component_count": 1,
+          "tenants": {
+            "unknown": 571
+          },
+          "users": {
+            "unknown": 571
+          },
+          "components": {
+            "unknown": 571
+          }
+        },
+        "window": {
+          "calls": 0,
+          "tenant_count": 0,
+          "user_count": 0,
+          "component_count": 0,
+          "tenants": {},
+          "users": {},
+          "components": {}
+        },
+        "last_seen_at": "2026-07-08T20:49:12.335710Z",
+        "retirement_candidate": true,
+        "retirement_reason": "no measured usage in review window"
+      },
+      {
+        "interface": {
+          "id": "4aea9591-970b-4918-ac4a-4da95a0a1a8c",
+          "interface_key": "rest_api:POST /decisions/ workstream_id",
+          "interface_kind": "rest_api",
+          "legacy_since": "2026-07-09T22:56:35.473130Z",
+          "replacement_ref": "POST /decisions/ with workplan_id",
+          "owner_component": "state-hub.api",
+          "status": "legacy",
+          "replacement_verified": true,
+          "manual_hold": false,
+          "hold_reason": null,
+          "notes": null,
+          "retired_at": null,
+          "created_at": "2026-07-09T22:56:35.473130Z",
+          "updated_at": "2026-07-09T22:56:35.473130Z"
+        },
+        "all_time": {
+          "calls": 3,
+          "tenant_count": 1,
+          "user_count": 1,
+          "component_count": 1,
+          "tenants": {
+            "unknown": 3
+          },
+          "users": {
+            "unknown": 3
+          },
+          "components": {
+            "unknown": 3
+          }
+        },
+        "window": {
+          "calls": 0,
+          "tenant_count": 0,
+          "user_count": 0,
+          "component_count": 0,
+          "tenants": {},
+          "users": {},
+          "components": {}
+        },
+        "last_seen_at": "2026-07-09T22:57:05.912456Z",
+        "retirement_candidate": true,
+        "retirement_reason": "no measured usage in review window"
+      },
+      {
+        "interface": {
+          "id": "4a70583c-1e41-4ec1-99a9-728856a7d79c",
+          "interface_key": "rest_api:POST /progress/ workstream_id",
+          "interface_kind": "rest_api",
+          "legacy_since": "2026-07-08T23:35:09.148333Z",
+          "replacement_ref": "POST /progress/ with workplan_id",
+          "owner_component": "state-hub.api",
+          "status": "legacy",
+          "replacement_verified": true,
+          "manual_hold": false,
+          "hold_reason": null,
+          "notes": null,
+          "retired_at": null,
+          "created_at": "2026-07-08T23:35:09.148333Z",
+          "updated_at": "2026-07-08T23:35:09.148333Z"
+        },
+        "all_time": {
+          "calls": 14,
+          "tenant_count": 1,
+          "user_count": 1,
+          "component_count": 1,
+          "tenants": {
+            "unknown": 14
+          },
+          "users": {
+            "unknown": 14
+          },
+          "components": {
+            "unknown": 14
+          }
+        },
+        "window": {
+          "calls": 0,
+          "tenant_count": 0,
+          "user_count": 0,
+          "component_count": 0,
+          "tenants": {},
+          "users": {},
+          "components": {}
+        },
+        "last_seen_at": "2026-07-10T08:34:42.959724Z",
+        "retirement_candidate": true,
+        "retirement_reason": "no measured usage in review window"
+      },
+      {
+        "interface": {
+          "id": "6df4e443-7bf1-461a-923b-a6eb52fe7b07",
+          "interface_key": "rest_api:POST /tasks/ workstream_id",
+          "interface_kind": "rest_api",
+          "legacy_since": "2026-07-08T22:38:29.405720Z",
+          "replacement_ref": "POST /tasks/ with workplan_id",
+          "owner_component": "state-hub.api",
+          "status": "legacy",
+          "replacement_verified": true,
+          "manual_hold": false,
+          "hold_reason": null,
+          "notes": null,
+          "retired_at": null,
+          "created_at": "2026-07-08T22:38:29.405720Z",
+          "updated_at": "2026-07-08T22:38:29.405720Z"
+        },
+        "all_time": {
+          "calls": 5,
+          "tenant_count": 1,
+          "user_count": 1,
+          "component_count": 1,
+          "tenants": {
+            "unknown": 5
+          },
+          "users": {
+            "unknown": 5
+          },
+          "components": {
+            "state-hub.fix-consistency": 5
+          }
+        },
+        "window": {
+          "calls": 0,
+          "tenant_count": 0,
+          "user_count": 0,
+          "component_count": 0,
+          "tenants": {},
+          "users": {},
+          "components": {}
+        },
+        "last_seen_at": "2026-07-08T22:38:29.976918Z",
+        "retirement_candidate": true,
+        "retirement_reason": "no measured usage in review window"
+      },
+      {
+        "interface": {
+          "id": "ed6451c9-d2cc-4486-9afe-d3852782cabc",
+          "interface_key": "rest_api:POST /workstreams/",
+          "interface_kind": "rest_api",
+          "legacy_since": "2026-06-04T07:40:24.168535Z",
+          "replacement_ref": "/workplans/",
+          "owner_component": "state-hub.api",
+          "status": "legacy",
+          "replacement_verified": true,
+          "manual_hold": false,
+          "hold_reason": null,
+          "notes": null,
+          "retired_at": null,
+          "created_at": "2026-06-04T07:40:24.168535Z",
+          "updated_at": "2026-06-04T07:40:24.168535Z"
+        },
+        "all_time": {
+          "calls": 824,
+          "tenant_count": 1,
+          "user_count": 1,
+          "component_count": 1,
+          "tenants": {
+            "unknown": 824
+          },
+          "users": {
+            "unknown": 824
+          },
+          "components": {
+            "unknown": 824
+          }
+        },
+        "window": {
+          "calls": 0,
+          "tenant_count": 0,
+          "user_count": 0,
+          "component_count": 0,
+          "tenants": {},
+          "users": {},
+          "components": {}
+        },
+        "last_seen_at": "2026-07-08T20:38:05.903144Z",
+        "retirement_candidate": true,
+        "retirement_reason": "no measured usage in review window"
+      },
+      {
+        "interface": {
+          "id": "281fd706-b192-4194-8055-2d8733c115f9",
+          "interface_key": "rest_api:POST /workstreams/{workstream_id}/dependencies/",
+          "interface_kind": "rest_api",
+          "legacy_since": "2026-06-04T22:57:37.149207Z",
+          "replacement_ref": "/workplans/{workplan_id}/dependencies/",
+          "owner_component": "state-hub.api",
+          "status": "legacy",
+          "replacement_verified": true,
+          "manual_hold": false,
+          "hold_reason": null,
+          "notes": null,
+          "retired_at": null,
+          "created_at": "2026-06-04T22:57:37.149207Z",
+          "updated_at": "2026-06-04T22:57:37.149207Z"
+        },
+        "all_time": {
+          "calls": 4971,
+          "tenant_count": 1,
+          "user_count": 1,
+          "component_count": 1,
+          "tenants": {
+            "unknown": 4971
+          },
+          "users": {
+            "unknown": 4971
+          },
+          "components": {
+            "unknown": 4971
+          }
+        },
+        "window": {
+          "calls": 0,
+          "tenant_count": 0,
+          "user_count": 0,
+          "component_count": 0,
+          "tenants": {},
+          "users": {},
+          "components": {}
+        },
+        "last_seen_at": "2026-07-01T22:09:24.229011Z",
+        "retirement_candidate": true,
+        "retirement_reason": "no measured usage in review window"
+      }
+    ]
+  },
+  "hours": 8
+}
diff --git a/docs/evidence/legacy-meter-weekly-review-20260727.json b/docs/evidence/legacy-meter-weekly-review-20260727.json
new file mode 100644
index 0000000..dee4c4a
--- /dev/null
+++ b/docs/evidence/legacy-meter-weekly-review-20260727.json
@@ -0,0 +1,1755 @@
+{
+  "captured_at": "2026-07-26T22:00:07.321362+00:00",
+  "api_base": "http://127.0.0.1:8000",
+  "workplan": "STATE-WP-0070",
+  "retired_interfaces": [],
+  "weekly_review": {
+    "generated_at": "2026-07-26T22:00:07.315070Z",
+    "window_start": "2026-07-26T14:00:07.226326Z",
+    "window_end": "2026-07-26T22:00:07.226326Z",
+    "cadence": "weekly",
+    "activity_core_handoff": {
+      "activity_id": "statehub-legacy-interface-review",
+      "cadence": "weekly",
+      "source_endpoint": "/legacy-meter/weekly-review",
+      "state_owner": "state-hub",
+      "scheduler_owner": "activity-core"
+    },
+    "interfaces": [
+      {
+        "interface": {
+          "id": "8051fb40-66c9-4dc4-a413-13e8573e04a3",
+          "interface_key": "event_subject:org.statehub.workstream.completed",
+          "interface_kind": "event_subject",
+          "legacy_since": "2026-06-04T06:09:42.198193Z",
+          "replacement_ref": "org.statehub.workplan.completed",
+          "owner_component": "state-hub.events",
+          "status": "retired",
+          "replacement_verified": true,
+          "manual_hold": false,
+          "hold_reason": null,
+          "notes": "Retired by STATE-WP-0069 closeout",
+          "retired_at": "2026-07-08T21:38:52.773601Z",
+          "created_at": "2026-06-04T06:09:42.198193Z",
+          "updated_at": "2026-07-08T21:38:52.761243Z"
+        },
+        "all_time": {
+          "calls": 255,
+          "tenant_count": 1,
+          "user_count": 1,
+          "component_count": 1,
+          "tenants": {
+            "unknown": 255
+          },
+          "users": {
+            "unknown": 255
+          },
+          "components": {
+            "state-hub.events": 255
+          }
+        },
+        "window": {
+          "calls": 0,
+          "tenant_count": 0,
+          "user_count": 0,
+          "component_count": 0,
+          "tenants": {},
+          "users": {},
+          "components": {}
+        },
+        "last_seen_at": "2026-07-08T20:49:12.839383Z",
+        "retirement_candidate": false,
+        "retirement_reason": "already retired"
+      },
+      {
+        "interface": {
+          "id": "63ed90e3-42b4-431a-94db-e1254a52f9e2",
+          "interface_key": "mcp:create_workstream",
+          "interface_kind": "mcp_tool",
+          "legacy_since": "2026-07-10T13:19:44.205900Z",
+          "replacement_ref": "create_workplan",
+          "owner_component": "state-hub.mcp",
+          "status": "legacy",
+          "replacement_verified": true,
+          "manual_hold": false,
+          "hold_reason": null,
+          "notes": "Registered by STATE-WP-0070 T03 \u2014 zero-window streak starts at registration",
+          "retired_at": null,
+          "created_at": "2026-07-10T13:19:44.205900Z",
+          "updated_at": "2026-07-10T13:19:44.205900Z"
+        },
+        "all_time": {
+          "calls": 2,
+          "tenant_count": 1,
+          "user_count": 1,
+          "component_count": 1,
+          "tenants": {
+            "unknown": 2
+          },
+          "users": {
+            "unknown": 2
+          },
+          "components": {
+            "state-hub.mcp": 2
+          }
+        },
+        "window": {
+          "calls": 0,
+          "tenant_count": 0,
+          "user_count": 0,
+          "component_count": 0,
+          "tenants": {},
+          "users": {},
+          "components": {}
+        },
+        "last_seen_at": "2026-07-10T13:20:43.378546Z",
+        "retirement_candidate": true,
+        "retirement_reason": "no measured usage in review window"
+      },
+      {
+        "interface": {
+          "id": "b6a5fe44-fb85-4ef7-a273-78d09da777af",
+          "interface_key": "mcp:list_workstreams",
+          "interface_kind": "mcp_tool",
+          "legacy_since": "2026-07-10T13:19:26.075491Z",
+          "replacement_ref": "list_workplans",
+          "owner_component": "state-hub.mcp",
+          "status": "legacy",
+          "replacement_verified": true,
+          "manual_hold": false,
+          "hold_reason": null,
+          "notes": null,
+          "retired_at": null,
+          "created_at": "2026-07-10T13:19:26.075491Z",
+          "updated_at": "2026-07-10T13:19:26.075491Z"
+        },
+        "all_time": {
+          "calls": 2,
+          "tenant_count": 1,
+          "user_count": 1,
+          "component_count": 1,
+          "tenants": {
+            "unknown": 2
+          },
+          "users": {
+            "unknown": 2
+          },
+          "components": {
+            "state-hub.mcp": 2
+          }
+        },
+        "window": {
+          "calls": 0,
+          "tenant_count": 0,
+          "user_count": 0,
+          "component_count": 0,
+          "tenants": {},
+          "users": {},
+          "components": {}
+        },
+        "last_seen_at": "2026-07-10T13:20:42.374940Z",
+        "retirement_candidate": true,
+        "retirement_reason": "no measured usage in review window"
+      },
+      {
+        "interface": {
+          "id": "53c3372b-307d-4d6a-8ea4-bc36cacdcaf2",
+          "interface_key": "mcp:update_workstream",
+          "interface_kind": "mcp_tool",
+          "legacy_since": "2026-07-10T13:19:44.255216Z",
+          "replacement_ref": "update_workplan",
+          "owner_component": "state-hub.mcp",
+          "status": "legacy",
+          "replacement_verified": true,
+          "manual_hold": false,
+          "hold_reason": null,
+          "notes": "Registered by STATE-WP-0070 T03 \u2014 zero-window streak starts at registration",
+          "retired_at": null,
+          "created_at": "2026-07-10T13:19:44.255216Z",
+          "updated_at": "2026-07-10T13:19:44.255216Z"
+        },
+        "all_time": {
+          "calls": 0,
+          "tenant_count": 0,
+          "user_count": 0,
+          "component_count": 0,
+          "tenants": {},
+          "users": {},
+          "components": {}
+        },
+        "window": {
+          "calls": 0,
+          "tenant_count": 0,
+          "user_count": 0,
+          "component_count": 0,
+          "tenants": {},
+          "users": {},
+          "components": {}
+        },
+        "last_seen_at": null,
+        "retirement_candidate": true,
+        "retirement_reason": "no measured usage in review window"
+      },
+      {
+        "interface": {
+          "id": "bed4d08a-3471-48f5-9f0e-f9d550383a26",
+          "interface_key": "mcp:update_workstream_status",
+          "interface_kind": "mcp_tool",
+          "legacy_since": "2026-07-10T13:19:44.303612Z",
+          "replacement_ref": "update_workplan_status",
+          "owner_component": "state-hub.mcp",
+          "status": "legacy",
+          "replacement_verified": true,
+          "manual_hold": false,
+          "hold_reason": null,
+          "notes": "Registered by STATE-WP-0070 T03 \u2014 zero-window streak starts at registration",
+          "retired_at": null,
+          "created_at": "2026-07-10T13:19:44.303612Z",
+          "updated_at": "2026-07-10T13:19:44.303612Z"
+        },
+        "all_time": {
+          "calls": 0,
+          "tenant_count": 0,
+          "user_count": 0,
+          "component_count": 0,
+          "tenants": {},
+          "users": {},
+          "components": {}
+        },
+        "window": {
+          "calls": 0,
+          "tenant_count": 0,
+          "user_count": 0,
+          "component_count": 0,
+          "tenants": {},
+          "users": {},
+          "components": {}
+        },
+        "last_seen_at": null,
+        "retirement_candidate": true,
+        "retirement_reason": "no measured usage in review window"
+      },
+      {
+        "interface": {
+          "id": "46900dc2-0893-405b-ba59-80f31fb6ebb1",
+          "interface_key": "state://workstreams/{topic_slug}",
+          "interface_kind": "mcp_tool",
+          "legacy_since": "2026-07-10T13:19:44.344493Z",
+          "replacement_ref": "state://workplans/{topic_slug}",
+          "owner_component": "state-hub.mcp",
+          "status": "legacy",
+          "replacement_verified": true,
+          "manual_hold": false,
+          "hold_reason": null,
+          "notes": "Registered by STATE-WP-0070 T03 \u2014 zero-window streak starts at registration",
+          "retired_at": null,
+          "created_at": "2026-07-10T13:19:44.344493Z",
+          "updated_at": "2026-07-10T13:19:44.344493Z"
+        },
+        "all_time": {
+          "calls": 1,
+          "tenant_count": 1,
+          "user_count": 1,
+          "component_count": 1,
+          "tenants": {
+            "unknown": 1
+          },
+          "users": {
+            "unknown": 1
+          },
+          "components": {
+            "state-hub.mcp": 1
+          }
+        },
+        "window": {
+          "calls": 0,
+          "tenant_count": 0,
+          "user_count": 0,
+          "component_count": 0,
+          "tenants": {},
+          "users": {},
+          "components": {}
+        },
+        "last_seen_at": "2026-07-10T13:20:34.491811Z",
+        "retirement_candidate": true,
+        "retirement_reason": "no measured usage in review window"
+      },
+      {
+        "interface": {
+          "id": "cd9342fd-27e7-4a46-a1be-d41499e106a3",
+          "interface_key": "rest_api:DELETE /workstreams/{workstream_id}",
+          "interface_kind": "rest_api",
+          "legacy_since": "2026-06-06T17:28:13.052813Z",
+          "replacement_ref": "/workplans/{workplan_id}",
+          "owner_component": "state-hub.api",
+          "status": "legacy",
+          "replacement_verified": true,
+          "manual_hold": false,
+          "hold_reason": null,
+          "notes": null,
+          "retired_at": null,
+          "created_at": "2026-06-06T17:28:13.052813Z",
+          "updated_at": "2026-06-06T17:28:13.052813Z"
+        },
+        "all_time": {
+          "calls": 1,
+          "tenant_count": 1,
+          "user_count": 1,
+          "component_count": 1,
+          "tenants": {
+            "unknown": 1
+          },
+          "users": {
+            "unknown": 1
+          },
+          "components": {
+            "unknown": 1
+          }
+        },
+        "window": {
+          "calls": 0,
+          "tenant_count": 0,
+          "user_count": 0,
+          "component_count": 0,
+          "tenants": {},
+          "users": {},
+          "components": {}
+        },
+        "last_seen_at": "2026-06-06T17:28:13.047529Z",
+        "retirement_candidate": true,
+        "retirement_reason": "no measured usage in review window"
+      },
+      {
+        "interface": {
+          "id": "a4e0948c-cd4a-461e-8ae2-7fd7b51d04a7",
+          "interface_key": "rest_api:GET /decisions/?workstream_id",
+          "interface_kind": "rest_api",
+          "legacy_since": "2026-07-09T23:07:53.093223Z",
+          "replacement_ref": "/decisions/?workplan_id=<workplan_id>",
+          "owner_component": "state-hub.api",
+          "status": "legacy",
+          "replacement_verified": true,
+          "manual_hold": false,
+          "hold_reason": null,
+          "notes": null,
+          "retired_at": null,
+          "created_at": "2026-07-09T23:07:53.093223Z",
+          "updated_at": "2026-07-09T23:07:53.093223Z"
+        },
+        "all_time": {
+          "calls": 1,
+          "tenant_count": 1,
+          "user_count": 1,
+          "component_count": 1,
+          "tenants": {
+            "unknown": 1
+          },
+          "users": {
+            "unknown": 1
+          },
+          "components": {
+            "unknown": 1
+          }
+        },
+        "window": {
+          "calls": 0,
+          "tenant_count": 0,
+          "user_count": 0,
+          "component_count": 0,
+          "tenants": {},
+          "users": {},
+          "components": {}
+        },
+        "last_seen_at": "2026-07-09T23:07:53.083299Z",
+        "retirement_candidate": true,
+        "retirement_reason": "no measured usage in review window"
+      },
+      {
+        "interface": {
+          "id": "70a9346e-e0ee-42ac-874f-f160580b54dd",
+          "interface_key": "rest_api:GET /progress/?workstream_id",
+          "interface_kind": "rest_api",
+          "legacy_since": "2026-07-13T22:04:03.911449Z",
+          "replacement_ref": "/progress/?workplan_id=<workplan_id>",
+          "owner_component": "state-hub.api",
+          "status": "legacy",
+          "replacement_verified": true,
+          "manual_hold": false,
+          "hold_reason": null,
+          "notes": null,
+          "retired_at": null,
+          "created_at": "2026-07-13T22:04:03.911449Z",
+          "updated_at": "2026-07-13T22:04:03.911449Z"
+        },
+        "all_time": {
+          "calls": 1,
+          "tenant_count": 1,
+          "user_count": 1,
+          "component_count": 1,
+          "tenants": {
+            "unknown": 1
+          },
+          "users": {
+            "unknown": 1
+          },
+          "components": {
+            "unknown": 1
+          }
+        },
+        "window": {
+          "calls": 0,
+          "tenant_count": 0,
+          "user_count": 0,
+          "component_count": 0,
+          "tenants": {},
+          "users": {},
+          "components": {}
+        },
+        "last_seen_at": "2026-07-13T22:04:03.904998Z",
+        "retirement_candidate": true,
+        "retirement_reason": "no measured usage in review window"
+      },
+      {
+        "interface": {
+          "id": "be3cdcf8-250b-4bf0-801f-02ffd5f57e00",
+          "interface_key": "rest_api:GET /tasks/?workstream_id",
+          "interface_kind": "rest_api",
+          "legacy_since": "2026-07-08T19:32:21.628513Z",
+          "replacement_ref": "/tasks/?workplan_id=<workplan_id>",
+          "owner_component": "state-hub.api",
+          "status": "legacy",
+          "replacement_verified": true,
+          "manual_hold": false,
+          "hold_reason": null,
+          "notes": null,
+          "retired_at": null,
+          "created_at": "2026-07-08T19:32:21.628513Z",
+          "updated_at": "2026-07-08T19:32:21.628513Z"
+        },
+        "all_time": {
+          "calls": 587,
+          "tenant_count": 1,
+          "user_count": 1,
+          "component_count": 1,
+          "tenants": {
+            "unknown": 587
+          },
+          "users": {
+            "unknown": 587
+          },
+          "components": {
+            "unknown": 587
+          }
+        },
+        "window": {
+          "calls": 0,
+          "tenant_count": 0,
+          "user_count": 0,
+          "component_count": 0,
+          "tenants": {},
+          "users": {},
+          "components": {}
+        },
+        "last_seen_at": "2026-07-22T13:21:12.171828Z",
+        "retirement_candidate": true,
+        "retirement_reason": "no measured usage in review window"
+      },
+      {
+        "interface": {
+          "id": "3e4a3d0b-08fa-45c3-91e2-4f514a914b97",
+          "interface_key": "rest_api:GET /workstreams/",
+          "interface_kind": "rest_api",
+          "legacy_since": "2026-06-04T00:26:14.533764Z",
+          "replacement_ref": "/workplans/",
+          "owner_component": "state-hub.api",
+          "status": "legacy",
+          "replacement_verified": true,
+          "manual_hold": false,
+          "hold_reason": null,
+          "notes": null,
+          "retired_at": null,
+          "created_at": "2026-06-04T00:26:14.533764Z",
+          "updated_at": "2026-06-04T00:26:14.533764Z"
+        },
+        "all_time": {
+          "calls": 144084,
+          "tenant_count": 1,
+          "user_count": 1,
+          "component_count": 1,
+          "tenants": {
+            "unknown": 144084
+          },
+          "users": {
+            "unknown": 144084
+          },
+          "components": {
+            "unknown": 144084
+          }
+        },
+        "window": {
+          "calls": 0,
+          "tenant_count": 0,
+          "user_count": 0,
+          "component_count": 0,
+          "tenants": {},
+          "users": {},
+          "components": {}
+        },
+        "last_seen_at": "2026-07-08T21:14:39.652776Z",
+        "retirement_candidate": true,
+        "retirement_reason": "no measured usage in review window"
+      },
+      {
+        "interface": {
+          "id": "e4c140ec-7479-46f9-b185-4b533f19d639",
+          "interface_key": "rest_api:GET /workstreams/workplan-index",
+          "interface_kind": "rest_api",
+          "legacy_since": "2026-06-04T05:20:58.321869Z",
+          "replacement_ref": "/workplans/index",
+          "owner_component": "state-hub.api",
+          "status": "legacy",
+          "replacement_verified": true,
+          "manual_hold": false,
+          "hold_reason": null,
+          "notes": null,
+          "retired_at": null,
+          "created_at": "2026-06-04T05:20:58.321869Z",
+          "updated_at": "2026-06-04T05:20:58.321869Z"
+        },
+        "all_time": {
+          "calls": 30,
+          "tenant_count": 1,
+          "user_count": 1,
+          "component_count": 1,
+          "tenants": {
+            "unknown": 30
+          },
+          "users": {
+            "unknown": 30
+          },
+          "components": {
+            "unknown": 30
+          }
+        },
+        "window": {
+          "calls": 0,
+          "tenant_count": 0,
+          "user_count": 0,
+          "component_count": 0,
+          "tenants": {},
+          "users": {},
+          "components": {}
+        },
+        "last_seen_at": "2026-07-03T05:20:34.534439Z",
+        "retirement_candidate": true,
+        "retirement_reason": "no measured usage in review window"
+      },
+      {
+        "interface": {
+          "id": "3a00b19e-e7db-4403-98aa-a77c9ab61ecc",
+          "interface_key": "rest_api:GET /workstreams/{workstream_id}",
+          "interface_kind": "rest_api",
+          "legacy_since": "2026-06-04T00:25:59.014966Z",
+          "replacement_ref": "/workplans/{workplan_id}",
+          "owner_component": "state-hub.api",
+          "status": "legacy",
+          "replacement_verified": true,
+          "manual_hold": false,
+          "hold_reason": null,
+          "notes": null,
+          "retired_at": null,
+          "created_at": "2026-06-04T00:25:59.014966Z",
+          "updated_at": "2026-06-04T00:25:59.014966Z"
+        },
+        "all_time": {
+          "calls": 511405,
+          "tenant_count": 1,
+          "user_count": 1,
+          "component_count": 1,
+          "tenants": {
+            "unknown": 511405
+          },
+          "users": {
+            "unknown": 511405
+          },
+          "components": {
+            "unknown": 511405
+          }
+        },
+        "window": {
+          "calls": 0,
+          "tenant_count": 0,
+          "user_count": 0,
+          "component_count": 0,
+          "tenants": {},
+          "users": {},
+          "components": {}
+        },
+        "last_seen_at": "2026-07-08T21:14:20.781103Z",
+        "retirement_candidate": true,
+        "retirement_reason": "no measured usage in review window"
+      },
+      {
+        "interface": {
+          "id": "69e1a255-a8b9-4101-8a68-b1bed23abfda",
+          "interface_key": "rest_api:GET /workstreams/{workstream_id}/dependencies/",
+          "interface_kind": "rest_api",
+          "legacy_since": "2026-06-04T00:25:59.291135Z",
+          "replacement_ref": "/workplans/{workplan_id}/dependencies/",
+          "owner_component": "state-hub.api",
+          "status": "legacy",
+          "replacement_verified": true,
+          "manual_hold": false,
+          "hold_reason": null,
+          "notes": null,
+          "retired_at": null,
+          "created_at": "2026-06-04T00:25:59.291135Z",
+          "updated_at": "2026-06-04T00:25:59.291135Z"
+        },
+        "all_time": {
+          "calls": 255865,
+          "tenant_count": 1,
+          "user_count": 1,
+          "component_count": 1,
+          "tenants": {
+            "unknown": 255865
+          },
+          "users": {
+            "unknown": 255865
+          },
+          "components": {
+            "unknown": 255865
+          }
+        },
+        "window": {
+          "calls": 0,
+          "tenant_count": 0,
+          "user_count": 0,
+          "component_count": 0,
+          "tenants": {},
+          "users": {},
+          "components": {}
+        },
+        "last_seen_at": "2026-07-08T21:14:12.747005Z",
+        "retirement_candidate": true,
+        "retirement_reason": "no measured usage in review window"
+      },
+      {
+        "interface": {
+          "id": "b1aae931-b51f-4a85-a723-865dd65f6132",
+          "interface_key": "rest_api:PATCH /workstreams/{workstream_id}",
+          "interface_kind": "rest_api",
+          "legacy_since": "2026-06-04T06:09:41.901035Z",
+          "replacement_ref": "/workplans/{workplan_id}",
+          "owner_component": "state-hub.api",
+          "status": "legacy",
+          "replacement_verified": true,
+          "manual_hold": false,
+          "hold_reason": null,
+          "notes": null,
+          "retired_at": null,
+          "created_at": "2026-06-04T06:09:41.901035Z",
+          "updated_at": "2026-06-04T06:09:41.901035Z"
+        },
+        "all_time": {
+          "calls": 571,
+          "tenant_count": 1,
+          "user_count": 1,
+          "component_count": 1,
+          "tenants": {
+            "unknown": 571
+          },
+          "users": {
+            "unknown": 571
+          },
+          "components": {
+            "unknown": 571
+          }
+        },
+        "window": {
+          "calls": 0,
+          "tenant_count": 0,
+          "user_count": 0,
+          "component_count": 0,
+          "tenants": {},
+          "users": {},
+          "components": {}
+        },
+        "last_seen_at": "2026-07-08T20:49:12.335710Z",
+        "retirement_candidate": true,
+        "retirement_reason": "no measured usage in review window"
+      },
+      {
+        "interface": {
+          "id": "4aea9591-970b-4918-ac4a-4da95a0a1a8c",
+          "interface_key": "rest_api:POST /decisions/ workstream_id",
+          "interface_kind": "rest_api",
+          "legacy_since": "2026-07-09T22:56:35.473130Z",
+          "replacement_ref": "POST /decisions/ with workplan_id",
+          "owner_component": "state-hub.api",
+          "status": "legacy",
+          "replacement_verified": true,
+          "manual_hold": false,
+          "hold_reason": null,
+          "notes": null,
+          "retired_at": null,
+          "created_at": "2026-07-09T22:56:35.473130Z",
+          "updated_at": "2026-07-09T22:56:35.473130Z"
+        },
+        "all_time": {
+          "calls": 3,
+          "tenant_count": 1,
+          "user_count": 1,
+          "component_count": 1,
+          "tenants": {
+            "unknown": 3
+          },
+          "users": {
+            "unknown": 3
+          },
+          "components": {
+            "unknown": 3
+          }
+        },
+        "window": {
+          "calls": 0,
+          "tenant_count": 0,
+          "user_count": 0,
+          "component_count": 0,
+          "tenants": {},
+          "users": {},
+          "components": {}
+        },
+        "last_seen_at": "2026-07-09T22:57:05.912456Z",
+        "retirement_candidate": true,
+        "retirement_reason": "no measured usage in review window"
+      },
+      {
+        "interface": {
+          "id": "4a70583c-1e41-4ec1-99a9-728856a7d79c",
+          "interface_key": "rest_api:POST /progress/ workstream_id",
+          "interface_kind": "rest_api",
+          "legacy_since": "2026-07-08T23:35:09.148333Z",
+          "replacement_ref": "POST /progress/ with workplan_id",
+          "owner_component": "state-hub.api",
+          "status": "legacy",
+          "replacement_verified": true,
+          "manual_hold": false,
+          "hold_reason": null,
+          "notes": null,
+          "retired_at": null,
+          "created_at": "2026-07-08T23:35:09.148333Z",
+          "updated_at": "2026-07-08T23:35:09.148333Z"
+        },
+        "all_time": {
+          "calls": 14,
+          "tenant_count": 1,
+          "user_count": 1,
+          "component_count": 1,
+          "tenants": {
+            "unknown": 14
+          },
+          "users": {
+            "unknown": 14
+          },
+          "components": {
+            "unknown": 14
+          }
+        },
+        "window": {
+          "calls": 0,
+          "tenant_count": 0,
+          "user_count": 0,
+          "component_count": 0,
+          "tenants": {},
+          "users": {},
+          "components": {}
+        },
+        "last_seen_at": "2026-07-10T08:34:42.959724Z",
+        "retirement_candidate": true,
+        "retirement_reason": "no measured usage in review window"
+      },
+      {
+        "interface": {
+          "id": "6df4e443-7bf1-461a-923b-a6eb52fe7b07",
+          "interface_key": "rest_api:POST /tasks/ workstream_id",
+          "interface_kind": "rest_api",
+          "legacy_since": "2026-07-08T22:38:29.405720Z",
+          "replacement_ref": "POST /tasks/ with workplan_id",
+          "owner_component": "state-hub.api",
+          "status": "legacy",
+          "replacement_verified": true,
+          "manual_hold": false,
+          "hold_reason": null,
+          "notes": null,
+          "retired_at": null,
+          "created_at": "2026-07-08T22:38:29.405720Z",
+          "updated_at": "2026-07-08T22:38:29.405720Z"
+        },
+        "all_time": {
+          "calls": 5,
+          "tenant_count": 1,
+          "user_count": 1,
+          "component_count": 1,
+          "tenants": {
+            "unknown": 5
+          },
+          "users": {
+            "unknown": 5
+          },
+          "components": {
+            "state-hub.fix-consistency": 5
+          }
+        },
+        "window": {
+          "calls": 0,
+          "tenant_count": 0,
+          "user_count": 0,
+          "component_count": 0,
+          "tenants": {},
+          "users": {},
+          "components": {}
+        },
+        "last_seen_at": "2026-07-08T22:38:29.976918Z",
+        "retirement_candidate": true,
+        "retirement_reason": "no measured usage in review window"
+      },
+      {
+        "interface": {
+          "id": "ed6451c9-d2cc-4486-9afe-d3852782cabc",
+          "interface_key": "rest_api:POST /workstreams/",
+          "interface_kind": "rest_api",
+          "legacy_since": "2026-06-04T07:40:24.168535Z",
+          "replacement_ref": "/workplans/",
+          "owner_component": "state-hub.api",
+          "status": "legacy",
+          "replacement_verified": true,
+          "manual_hold": false,
+          "hold_reason": null,
+          "notes": null,
+          "retired_at": null,
+          "created_at": "2026-06-04T07:40:24.168535Z",
+          "updated_at": "2026-06-04T07:40:24.168535Z"
+        },
+        "all_time": {
+          "calls": 824,
+          "tenant_count": 1,
+          "user_count": 1,
+          "component_count": 1,
+          "tenants": {
+            "unknown": 824
+          },
+          "users": {
+            "unknown": 824
+          },
+          "components": {
+            "unknown": 824
+          }
+        },
+        "window": {
+          "calls": 0,
+          "tenant_count": 0,
+          "user_count": 0,
+          "component_count": 0,
+          "tenants": {},
+          "users": {},
+          "components": {}
+        },
+        "last_seen_at": "2026-07-08T20:38:05.903144Z",
+        "retirement_candidate": true,
+        "retirement_reason": "no measured usage in review window"
+      },
+      {
+        "interface": {
+          "id": "281fd706-b192-4194-8055-2d8733c115f9",
+          "interface_key": "rest_api:POST /workstreams/{workstream_id}/dependencies/",
+          "interface_kind": "rest_api",
+          "legacy_since": "2026-06-04T22:57:37.149207Z",
+          "replacement_ref": "/workplans/{workplan_id}/dependencies/",
+          "owner_component": "state-hub.api",
+          "status": "legacy",
+          "replacement_verified": true,
+          "manual_hold": false,
+          "hold_reason": null,
+          "notes": null,
+          "retired_at": null,
+          "created_at": "2026-06-04T22:57:37.149207Z",
+          "updated_at": "2026-06-04T22:57:37.149207Z"
+        },
+        "all_time": {
+          "calls": 4971,
+          "tenant_count": 1,
+          "user_count": 1,
+          "component_count": 1,
+          "tenants": {
+            "unknown": 4971
+          },
+          "users": {
+            "unknown": 4971
+          },
+          "components": {
+            "unknown": 4971
+          }
+        },
+        "window": {
+          "calls": 0,
+          "tenant_count": 0,
+          "user_count": 0,
+          "component_count": 0,
+          "tenants": {},
+          "users": {},
+          "components": {}
+        },
+        "last_seen_at": "2026-07-01T22:09:24.229011Z",
+        "retirement_candidate": true,
+        "retirement_reason": "no measured usage in review window"
+      }
+    ],
+    "retirement_candidates": [
+      {
+        "interface": {
+          "id": "63ed90e3-42b4-431a-94db-e1254a52f9e2",
+          "interface_key": "mcp:create_workstream",
+          "interface_kind": "mcp_tool",
+          "legacy_since": "2026-07-10T13:19:44.205900Z",
+          "replacement_ref": "create_workplan",
+          "owner_component": "state-hub.mcp",
+          "status": "legacy",
+          "replacement_verified": true,
+          "manual_hold": false,
+          "hold_reason": null,
+          "notes": "Registered by STATE-WP-0070 T03 \u2014 zero-window streak starts at registration",
+          "retired_at": null,
+          "created_at": "2026-07-10T13:19:44.205900Z",
+          "updated_at": "2026-07-10T13:19:44.205900Z"
+        },
+        "all_time": {
+          "calls": 2,
+          "tenant_count": 1,
+          "user_count": 1,
+          "component_count": 1,
+          "tenants": {
+            "unknown": 2
+          },
+          "users": {
+            "unknown": 2
+          },
+          "components": {
+            "state-hub.mcp": 2
+          }
+        },
+        "window": {
+          "calls": 0,
+          "tenant_count": 0,
+          "user_count": 0,
+          "component_count": 0,
+          "tenants": {},
+          "users": {},
+          "components": {}
+        },
+        "last_seen_at": "2026-07-10T13:20:43.378546Z",
+        "retirement_candidate": true,
+        "retirement_reason": "no measured usage in review window"
+      },
+      {
+        "interface": {
+          "id": "b6a5fe44-fb85-4ef7-a273-78d09da777af",
+          "interface_key": "mcp:list_workstreams",
+          "interface_kind": "mcp_tool",
+          "legacy_since": "2026-07-10T13:19:26.075491Z",
+          "replacement_ref": "list_workplans",
+          "owner_component": "state-hub.mcp",
+          "status": "legacy",
+          "replacement_verified": true,
+          "manual_hold": false,
+          "hold_reason": null,
+          "notes": null,
+          "retired_at": null,
+          "created_at": "2026-07-10T13:19:26.075491Z",
+          "updated_at": "2026-07-10T13:19:26.075491Z"
+        },
+        "all_time": {
+          "calls": 2,
+          "tenant_count": 1,
+          "user_count": 1,
+          "component_count": 1,
+          "tenants": {
+            "unknown": 2
+          },
+          "users": {
+            "unknown": 2
+          },
+          "components": {
+            "state-hub.mcp": 2
+          }
+        },
+        "window": {
+          "calls": 0,
+          "tenant_count": 0,
+          "user_count": 0,
+          "component_count": 0,
+          "tenants": {},
+          "users": {},
+          "components": {}
+        },
+        "last_seen_at": "2026-07-10T13:20:42.374940Z",
+        "retirement_candidate": true,
+        "retirement_reason": "no measured usage in review window"
+      },
+      {
+        "interface": {
+          "id": "53c3372b-307d-4d6a-8ea4-bc36cacdcaf2",
+          "interface_key": "mcp:update_workstream",
+          "interface_kind": "mcp_tool",
+          "legacy_since": "2026-07-10T13:19:44.255216Z",
+          "replacement_ref": "update_workplan",
+          "owner_component": "state-hub.mcp",
+          "status": "legacy",
+          "replacement_verified": true,
+          "manual_hold": false,
+          "hold_reason": null,
+          "notes": "Registered by STATE-WP-0070 T03 \u2014 zero-window streak starts at registration",
+          "retired_at": null,
+          "created_at": "2026-07-10T13:19:44.255216Z",
+          "updated_at": "2026-07-10T13:19:44.255216Z"
+        },
+        "all_time": {
+          "calls": 0,
+          "tenant_count": 0,
+          "user_count": 0,
+          "component_count": 0,
+          "tenants": {},
+          "users": {},
+          "components": {}
+        },
+        "window": {
+          "calls": 0,
+          "tenant_count": 0,
+          "user_count": 0,
+          "component_count": 0,
+          "tenants": {},
+          "users": {},
+          "components": {}
+        },
+        "last_seen_at": null,
+        "retirement_candidate": true,
+        "retirement_reason": "no measured usage in review window"
+      },
+      {
+        "interface": {
+          "id": "bed4d08a-3471-48f5-9f0e-f9d550383a26",
+          "interface_key": "mcp:update_workstream_status",
+          "interface_kind": "mcp_tool",
+          "legacy_since": "2026-07-10T13:19:44.303612Z",
+          "replacement_ref": "update_workplan_status",
+          "owner_component": "state-hub.mcp",
+          "status": "legacy",
+          "replacement_verified": true,
+          "manual_hold": false,
+          "hold_reason": null,
+          "notes": "Registered by STATE-WP-0070 T03 \u2014 zero-window streak starts at registration",
+          "retired_at": null,
+          "created_at": "2026-07-10T13:19:44.303612Z",
+          "updated_at": "2026-07-10T13:19:44.303612Z"
+        },
+        "all_time": {
+          "calls": 0,
+          "tenant_count": 0,
+          "user_count": 0,
+          "component_count": 0,
+          "tenants": {},
+          "users": {},
+          "components": {}
+        },
+        "window": {
+          "calls": 0,
+          "tenant_count": 0,
+          "user_count": 0,
+          "component_count": 0,
+          "tenants": {},
+          "users": {},
+          "components": {}
+        },
+        "last_seen_at": null,
+        "retirement_candidate": true,
+        "retirement_reason": "no measured usage in review window"
+      },
+      {
+        "interface": {
+          "id": "46900dc2-0893-405b-ba59-80f31fb6ebb1",
+          "interface_key": "state://workstreams/{topic_slug}",
+          "interface_kind": "mcp_tool",
+          "legacy_since": "2026-07-10T13:19:44.344493Z",
+          "replacement_ref": "state://workplans/{topic_slug}",
+          "owner_component": "state-hub.mcp",
+          "status": "legacy",
+          "replacement_verified": true,
+          "manual_hold": false,
+          "hold_reason": null,
+          "notes": "Registered by STATE-WP-0070 T03 \u2014 zero-window streak starts at registration",
+          "retired_at": null,
+          "created_at": "2026-07-10T13:19:44.344493Z",
+          "updated_at": "2026-07-10T13:19:44.344493Z"
+        },
+        "all_time": {
+          "calls": 1,
+          "tenant_count": 1,
+          "user_count": 1,
+          "component_count": 1,
+          "tenants": {
+            "unknown": 1
+          },
+          "users": {
+            "unknown": 1
+          },
+          "components": {
+            "state-hub.mcp": 1
+          }
+        },
+        "window": {
+          "calls": 0,
+          "tenant_count": 0,
+          "user_count": 0,
+          "component_count": 0,
+          "tenants": {},
+          "users": {},
+          "components": {}
+        },
+        "last_seen_at": "2026-07-10T13:20:34.491811Z",
+        "retirement_candidate": true,
+        "retirement_reason": "no measured usage in review window"
+      },
+      {
+        "interface": {
+          "id": "cd9342fd-27e7-4a46-a1be-d41499e106a3",
+          "interface_key": "rest_api:DELETE /workstreams/{workstream_id}",
+          "interface_kind": "rest_api",
+          "legacy_since": "2026-06-06T17:28:13.052813Z",
+          "replacement_ref": "/workplans/{workplan_id}",
+          "owner_component": "state-hub.api",
+          "status": "legacy",
+          "replacement_verified": true,
+          "manual_hold": false,
+          "hold_reason": null,
+          "notes": null,
+          "retired_at": null,
+          "created_at": "2026-06-06T17:28:13.052813Z",
+          "updated_at": "2026-06-06T17:28:13.052813Z"
+        },
+        "all_time": {
+          "calls": 1,
+          "tenant_count": 1,
+          "user_count": 1,
+          "component_count": 1,
+          "tenants": {
+            "unknown": 1
+          },
+          "users": {
+            "unknown": 1
+          },
+          "components": {
+            "unknown": 1
+          }
+        },
+        "window": {
+          "calls": 0,
+          "tenant_count": 0,
+          "user_count": 0,
+          "component_count": 0,
+          "tenants": {},
+          "users": {},
+          "components": {}
+        },
+        "last_seen_at": "2026-06-06T17:28:13.047529Z",
+        "retirement_candidate": true,
+        "retirement_reason": "no measured usage in review window"
+      },
+      {
+        "interface": {
+          "id": "a4e0948c-cd4a-461e-8ae2-7fd7b51d04a7",
+          "interface_key": "rest_api:GET /decisions/?workstream_id",
+          "interface_kind": "rest_api",
+          "legacy_since": "2026-07-09T23:07:53.093223Z",
+          "replacement_ref": "/decisions/?workplan_id=<workplan_id>",
+          "owner_component": "state-hub.api",
+          "status": "legacy",
+          "replacement_verified": true,
+          "manual_hold": false,
+          "hold_reason": null,
+          "notes": null,
+          "retired_at": null,
+          "created_at": "2026-07-09T23:07:53.093223Z",
+          "updated_at": "2026-07-09T23:07:53.093223Z"
+        },
+        "all_time": {
+          "calls": 1,
+          "tenant_count": 1,
+          "user_count": 1,
+          "component_count": 1,
+          "tenants": {
+            "unknown": 1
+          },
+          "users": {
+            "unknown": 1
+          },
+          "components": {
+            "unknown": 1
+          }
+        },
+        "window": {
+          "calls": 0,
+          "tenant_count": 0,
+          "user_count": 0,
+          "component_count": 0,
+          "tenants": {},
+          "users": {},
+          "components": {}
+        },
+        "last_seen_at": "2026-07-09T23:07:53.083299Z",
+        "retirement_candidate": true,
+        "retirement_reason": "no measured usage in review window"
+      },
+      {
+        "interface": {
+          "id": "70a9346e-e0ee-42ac-874f-f160580b54dd",
+          "interface_key": "rest_api:GET /progress/?workstream_id",
+          "interface_kind": "rest_api",
+          "legacy_since": "2026-07-13T22:04:03.911449Z",
+          "replacement_ref": "/progress/?workplan_id=<workplan_id>",
+          "owner_component": "state-hub.api",
+          "status": "legacy",
+          "replacement_verified": true,
+          "manual_hold": false,
+          "hold_reason": null,
+          "notes": null,
+          "retired_at": null,
+          "created_at": "2026-07-13T22:04:03.911449Z",
+          "updated_at": "2026-07-13T22:04:03.911449Z"
+        },
+        "all_time": {
+          "calls": 1,
+          "tenant_count": 1,
+          "user_count": 1,
+          "component_count": 1,
+          "tenants": {
+            "unknown": 1
+          },
+          "users": {
+            "unknown": 1
+          },
+          "components": {
+            "unknown": 1
+          }
+        },
+        "window": {
+          "calls": 0,
+          "tenant_count": 0,
+          "user_count": 0,
+          "component_count": 0,
+          "tenants": {},
+          "users": {},
+          "components": {}
+        },
+        "last_seen_at": "2026-07-13T22:04:03.904998Z",
+        "retirement_candidate": true,
+        "retirement_reason": "no measured usage in review window"
+      },
+      {
+        "interface": {
+          "id": "be3cdcf8-250b-4bf0-801f-02ffd5f57e00",
+          "interface_key": "rest_api:GET /tasks/?workstream_id",
+          "interface_kind": "rest_api",
+          "legacy_since": "2026-07-08T19:32:21.628513Z",
+          "replacement_ref": "/tasks/?workplan_id=<workplan_id>",
+          "owner_component": "state-hub.api",
+          "status": "legacy",
+          "replacement_verified": true,
+          "manual_hold": false,
+          "hold_reason": null,
+          "notes": null,
+          "retired_at": null,
+          "created_at": "2026-07-08T19:32:21.628513Z",
+          "updated_at": "2026-07-08T19:32:21.628513Z"
+        },
+        "all_time": {
+          "calls": 587,
+          "tenant_count": 1,
+          "user_count": 1,
+          "component_count": 1,
+          "tenants": {
+            "unknown": 587
+          },
+          "users": {
+            "unknown": 587
+          },
+          "components": {
+            "unknown": 587
+          }
+        },
+        "window": {
+          "calls": 0,
+          "tenant_count": 0,
+          "user_count": 0,
+          "component_count": 0,
+          "tenants": {},
+          "users": {},
+          "components": {}
+        },
+        "last_seen_at": "2026-07-22T13:21:12.171828Z",
+        "retirement_candidate": true,
+        "retirement_reason": "no measured usage in review window"
+      },
+      {
+        "interface": {
+          "id": "3e4a3d0b-08fa-45c3-91e2-4f514a914b97",
+          "interface_key": "rest_api:GET /workstreams/",
+          "interface_kind": "rest_api",
+          "legacy_since": "2026-06-04T00:26:14.533764Z",
+          "replacement_ref": "/workplans/",
+          "owner_component": "state-hub.api",
+          "status": "legacy",
+          "replacement_verified": true,
+          "manual_hold": false,
+          "hold_reason": null,
+          "notes": null,
+          "retired_at": null,
+          "created_at": "2026-06-04T00:26:14.533764Z",
+          "updated_at": "2026-06-04T00:26:14.533764Z"
+        },
+        "all_time": {
+          "calls": 144084,
+          "tenant_count": 1,
+          "user_count": 1,
+          "component_count": 1,
+          "tenants": {
+            "unknown": 144084
+          },
+          "users": {
+            "unknown": 144084
+          },
+          "components": {
+            "unknown": 144084
+          }
+        },
+        "window": {
+          "calls": 0,
+          "tenant_count": 0,
+          "user_count": 0,
+          "component_count": 0,
+          "tenants": {},
+          "users": {},
+          "components": {}
+        },
+        "last_seen_at": "2026-07-08T21:14:39.652776Z",
+        "retirement_candidate": true,
+        "retirement_reason": "no measured usage in review window"
+      },
+      {
+        "interface": {
+          "id": "e4c140ec-7479-46f9-b185-4b533f19d639",
+          "interface_key": "rest_api:GET /workstreams/workplan-index",
+          "interface_kind": "rest_api",
+          "legacy_since": "2026-06-04T05:20:58.321869Z",
+          "replacement_ref": "/workplans/index",
+          "owner_component": "state-hub.api",
+          "status": "legacy",
+          "replacement_verified": true,
+          "manual_hold": false,
+          "hold_reason": null,
+          "notes": null,
+          "retired_at": null,
+          "created_at": "2026-06-04T05:20:58.321869Z",
+          "updated_at": "2026-06-04T05:20:58.321869Z"
+        },
+        "all_time": {
+          "calls": 30,
+          "tenant_count": 1,
+          "user_count": 1,
+          "component_count": 1,
+          "tenants": {
+            "unknown": 30
+          },
+          "users": {
+            "unknown": 30
+          },
+          "components": {
+            "unknown": 30
+          }
+        },
+        "window": {
+          "calls": 0,
+          "tenant_count": 0,
+          "user_count": 0,
+          "component_count": 0,
+          "tenants": {},
+          "users": {},
+          "components": {}
+        },
+        "last_seen_at": "2026-07-03T05:20:34.534439Z",
+        "retirement_candidate": true,
+        "retirement_reason": "no measured usage in review window"
+      },
+      {
+        "interface": {
+          "id": "3a00b19e-e7db-4403-98aa-a77c9ab61ecc",
+          "interface_key": "rest_api:GET /workstreams/{workstream_id}",
+          "interface_kind": "rest_api",
+          "legacy_since": "2026-06-04T00:25:59.014966Z",
+          "replacement_ref": "/workplans/{workplan_id}",
+          "owner_component": "state-hub.api",
+          "status": "legacy",
+          "replacement_verified": true,
+          "manual_hold": false,
+          "hold_reason": null,
+          "notes": null,
+          "retired_at": null,
+          "created_at": "2026-06-04T00:25:59.014966Z",
+          "updated_at": "2026-06-04T00:25:59.014966Z"
+        },
+        "all_time": {
+          "calls": 511405,
+          "tenant_count": 1,
+          "user_count": 1,
+          "component_count": 1,
+          "tenants": {
+            "unknown": 511405
+          },
+          "users": {
+            "unknown": 511405
+          },
+          "components": {
+            "unknown": 511405
+          }
+        },
+        "window": {
+          "calls": 0,
+          "tenant_count": 0,
+          "user_count": 0,
+          "component_count": 0,
+          "tenants": {},
+          "users": {},
+          "components": {}
+        },
+        "last_seen_at": "2026-07-08T21:14:20.781103Z",
+        "retirement_candidate": true,
+        "retirement_reason": "no measured usage in review window"
+      },
+      {
+        "interface": {
+          "id": "69e1a255-a8b9-4101-8a68-b1bed23abfda",
+          "interface_key": "rest_api:GET /workstreams/{workstream_id}/dependencies/",
+          "interface_kind": "rest_api",
+          "legacy_since": "2026-06-04T00:25:59.291135Z",
+          "replacement_ref": "/workplans/{workplan_id}/dependencies/",
+          "owner_component": "state-hub.api",
+          "status": "legacy",
+          "replacement_verified": true,
+          "manual_hold": false,
+          "hold_reason": null,
+          "notes": null,
+          "retired_at": null,
+          "created_at": "2026-06-04T00:25:59.291135Z",
+          "updated_at": "2026-06-04T00:25:59.291135Z"
+        },
+        "all_time": {
+          "calls": 255865,
+          "tenant_count": 1,
+          "user_count": 1,
+          "component_count": 1,
+          "tenants": {
+            "unknown": 255865
+          },
+          "users": {
+            "unknown": 255865
+          },
+          "components": {
+            "unknown": 255865
+          }
+        },
+        "window": {
+          "calls": 0,
+          "tenant_count": 0,
+          "user_count": 0,
+          "component_count": 0,
+          "tenants": {},
+          "users": {},
+          "components": {}
+        },
+        "last_seen_at": "2026-07-08T21:14:12.747005Z",
+        "retirement_candidate": true,
+        "retirement_reason": "no measured usage in review window"
+      },
+      {
+        "interface": {
+          "id": "b1aae931-b51f-4a85-a723-865dd65f6132",
+          "interface_key": "rest_api:PATCH /workstreams/{workstream_id}",
+          "interface_kind": "rest_api",
+          "legacy_since": "2026-06-04T06:09:41.901035Z",
+          "replacement_ref": "/workplans/{workplan_id}",
+          "owner_component": "state-hub.api",
+          "status": "legacy",
+          "replacement_verified": true,
+          "manual_hold": false,
+          "hold_reason": null,
+          "notes": null,
+          "retired_at": null,
+          "created_at": "2026-06-04T06:09:41.901035Z",
+          "updated_at": "2026-06-04T06:09:41.901035Z"
+        },
+        "all_time": {
+          "calls": 571,
+          "tenant_count": 1,
+          "user_count": 1,
+          "component_count": 1,
+          "tenants": {
+            "unknown": 571
+          },
+          "users": {
+            "unknown": 571
+          },
+          "components": {
+            "unknown": 571
+          }
+        },
+        "window": {
+          "calls": 0,
+          "tenant_count": 0,
+          "user_count": 0,
+          "component_count": 0,
+          "tenants": {},
+          "users": {},
+          "components": {}
+        },
+        "last_seen_at": "2026-07-08T20:49:12.335710Z",
+        "retirement_candidate": true,
+        "retirement_reason": "no measured usage in review window"
+      },
+      {
+        "interface": {
+          "id": "4aea9591-970b-4918-ac4a-4da95a0a1a8c",
+          "interface_key": "rest_api:POST /decisions/ workstream_id",
+          "interface_kind": "rest_api",
+          "legacy_since": "2026-07-09T22:56:35.473130Z",
+          "replacement_ref": "POST /decisions/ with workplan_id",
+          "owner_component": "state-hub.api",
+          "status": "legacy",
+          "replacement_verified": true,
+          "manual_hold": false,
+          "hold_reason": null,
+          "notes": null,
+          "retired_at": null,
+          "created_at": "2026-07-09T22:56:35.473130Z",
+          "updated_at": "2026-07-09T22:56:35.473130Z"
+        },
+        "all_time": {
+          "calls": 3,
+          "tenant_count": 1,
+          "user_count": 1,
+          "component_count": 1,
+          "tenants": {
+            "unknown": 3
+          },
+          "users": {
+            "unknown": 3
+          },
+          "components": {
+            "unknown": 3
+          }
+        },
+        "window": {
+          "calls": 0,
+          "tenant_count": 0,
+          "user_count": 0,
+          "component_count": 0,
+          "tenants": {},
+          "users": {},
+          "components": {}
+        },
+        "last_seen_at": "2026-07-09T22:57:05.912456Z",
+        "retirement_candidate": true,
+        "retirement_reason": "no measured usage in review window"
+      },
+      {
+        "interface": {
+          "id": "4a70583c-1e41-4ec1-99a9-728856a7d79c",
+          "interface_key": "rest_api:POST /progress/ workstream_id",
+          "interface_kind": "rest_api",
+          "legacy_since": "2026-07-08T23:35:09.148333Z",
+          "replacement_ref": "POST /progress/ with workplan_id",
+          "owner_component": "state-hub.api",
+          "status": "legacy",
+          "replacement_verified": true,
+          "manual_hold": false,
+          "hold_reason": null,
+          "notes": null,
+          "retired_at": null,
+          "created_at": "2026-07-08T23:35:09.148333Z",
+          "updated_at": "2026-07-08T23:35:09.148333Z"
+        },
+        "all_time": {
+          "calls": 14,
+          "tenant_count": 1,
+          "user_count": 1,
+          "component_count": 1,
+          "tenants": {
+            "unknown": 14
+          },
+          "users": {
+            "unknown": 14
+          },
+          "components": {
+            "unknown": 14
+          }
+        },
+        "window": {
+          "calls": 0,
+          "tenant_count": 0,
+          "user_count": 0,
+          "component_count": 0,
+          "tenants": {},
+          "users": {},
+          "components": {}
+        },
+        "last_seen_at": "2026-07-10T08:34:42.959724Z",
+        "retirement_candidate": true,
+        "retirement_reason": "no measured usage in review window"
+      },
+      {
+        "interface": {
+          "id": "6df4e443-7bf1-461a-923b-a6eb52fe7b07",
+          "interface_key": "rest_api:POST /tasks/ workstream_id",
+          "interface_kind": "rest_api",
+          "legacy_since": "2026-07-08T22:38:29.405720Z",
+          "replacement_ref": "POST /tasks/ with workplan_id",
+          "owner_component": "state-hub.api",
+          "status": "legacy",
+          "replacement_verified": true,
+          "manual_hold": false,
+          "hold_reason": null,
+          "notes": null,
+          "retired_at": null,
+          "created_at": "2026-07-08T22:38:29.405720Z",
+          "updated_at": "2026-07-08T22:38:29.405720Z"
+        },
+        "all_time": {
+          "calls": 5,
+          "tenant_count": 1,
+          "user_count": 1,
+          "component_count": 1,
+          "tenants": {
+            "unknown": 5
+          },
+          "users": {
+            "unknown": 5
+          },
+          "components": {
+            "state-hub.fix-consistency": 5
+          }
+        },
+        "window": {
+          "calls": 0,
+          "tenant_count": 0,
+          "user_count": 0,
+          "component_count": 0,
+          "tenants": {},
+          "users": {},
+          "components": {}
+        },
+        "last_seen_at": "2026-07-08T22:38:29.976918Z",
+        "retirement_candidate": true,
+        "retirement_reason": "no measured usage in review window"
+      },
+      {
+        "interface": {
+          "id": "ed6451c9-d2cc-4486-9afe-d3852782cabc",
+          "interface_key": "rest_api:POST /workstreams/",
+          "interface_kind": "rest_api",
+          "legacy_since": "2026-06-04T07:40:24.168535Z",
+          "replacement_ref": "/workplans/",
+          "owner_component": "state-hub.api",
+          "status": "legacy",
+          "replacement_verified": true,
+          "manual_hold": false,
+          "hold_reason": null,
+          "notes": null,
+          "retired_at": null,
+          "created_at": "2026-06-04T07:40:24.168535Z",
+          "updated_at": "2026-06-04T07:40:24.168535Z"
+        },
+        "all_time": {
+          "calls": 824,
+          "tenant_count": 1,
+          "user_count": 1,
+          "component_count": 1,
+          "tenants": {
+            "unknown": 824
+          },
+          "users": {
+            "unknown": 824
+          },
+          "components": {
+            "unknown": 824
+          }
+        },
+        "window": {
+          "calls": 0,
+          "tenant_count": 0,
+          "user_count": 0,
+          "component_count": 0,
+          "tenants": {},
+          "users": {},
+          "components": {}
+        },
+        "last_seen_at": "2026-07-08T20:38:05.903144Z",
+        "retirement_candidate": true,
+        "retirement_reason": "no measured usage in review window"
+      },
+      {
+        "interface": {
+          "id": "281fd706-b192-4194-8055-2d8733c115f9",
+          "interface_key": "rest_api:POST /workstreams/{workstream_id}/dependencies/",
+          "interface_kind": "rest_api",
+          "legacy_since": "2026-06-04T22:57:37.149207Z",
+          "replacement_ref": "/workplans/{workplan_id}/dependencies/",
+          "owner_component": "state-hub.api",
+          "status": "legacy",
+          "replacement_verified": true,
+          "manual_hold": false,
+          "hold_reason": null,
+          "notes": null,
+          "retired_at": null,
+          "created_at": "2026-06-04T22:57:37.149207Z",
+          "updated_at": "2026-06-04T22:57:37.149207Z"
+        },
+        "all_time": {
+          "calls": 4971,
+          "tenant_count": 1,
+          "user_count": 1,
+          "component_count": 1,
+          "tenants": {
+            "unknown": 4971
+          },
+          "users": {
+            "unknown": 4971
+          },
+          "components": {
+            "unknown": 4971
+          }
+        },
+        "window": {
+          "calls": 0,
+          "tenant_count": 0,
+          "user_count": 0,
+          "component_count": 0,
+          "tenants": {},
+          "users": {},
+          "components": {}
+        },
+        "last_seen_at": "2026-07-01T22:09:24.229011Z",
+        "retirement_candidate": true,
+        "retirement_reason": "no measured usage in review window"
+      }
+    ]
+  },
+  "hours": 8
+}
diff --git a/docs/evidence/legacy-meter-weekly-review-20260728.json b/docs/evidence/legacy-meter-weekly-review-20260728.json
new file mode 100644
index 0000000..2d6de7b
--- /dev/null
+++ b/docs/evidence/legacy-meter-weekly-review-20260728.json
@@ -0,0 +1,1755 @@
+{
+  "captured_at": "2026-07-28T14:00:05.380241+00:00",
+  "api_base": "http://127.0.0.1:8000",
+  "workplan": "STATE-WP-0070",
+  "retired_interfaces": [],
+  "weekly_review": {
+    "generated_at": "2026-07-28T14:00:05.369857Z",
+    "window_start": "2026-07-28T06:00:04.915668Z",
+    "window_end": "2026-07-28T14:00:04.915668Z",
+    "cadence": "weekly",
+    "activity_core_handoff": {
+      "activity_id": "statehub-legacy-interface-review",
+      "cadence": "weekly",
+      "source_endpoint": "/legacy-meter/weekly-review",
+      "state_owner": "state-hub",
+      "scheduler_owner": "activity-core"
+    },
+    "interfaces": [
+      {
+        "interface": {
+          "id": "8051fb40-66c9-4dc4-a413-13e8573e04a3",
+          "interface_key": "event_subject:org.statehub.workstream.completed",
+          "interface_kind": "event_subject",
+          "legacy_since": "2026-06-04T06:09:42.198193Z",
+          "replacement_ref": "org.statehub.workplan.completed",
+          "owner_component": "state-hub.events",
+          "status": "retired",
+          "replacement_verified": true,
+          "manual_hold": false,
+          "hold_reason": null,
+          "notes": "Retired by STATE-WP-0069 closeout",
+          "retired_at": "2026-07-08T21:38:52.773601Z",
+          "created_at": "2026-06-04T06:09:42.198193Z",
+          "updated_at": "2026-07-08T21:38:52.761243Z"
+        },
+        "all_time": {
+          "calls": 255,
+          "tenant_count": 1,
+          "user_count": 1,
+          "component_count": 1,
+          "tenants": {
+            "unknown": 255
+          },
+          "users": {
+            "unknown": 255
+          },
+          "components": {
+            "state-hub.events": 255
+          }
+        },
+        "window": {
+          "calls": 0,
+          "tenant_count": 0,
+          "user_count": 0,
+          "component_count": 0,
+          "tenants": {},
+          "users": {},
+          "components": {}
+        },
+        "last_seen_at": "2026-07-08T20:49:12.839383Z",
+        "retirement_candidate": false,
+        "retirement_reason": "already retired"
+      },
+      {
+        "interface": {
+          "id": "63ed90e3-42b4-431a-94db-e1254a52f9e2",
+          "interface_key": "mcp:create_workstream",
+          "interface_kind": "mcp_tool",
+          "legacy_since": "2026-07-10T13:19:44.205900Z",
+          "replacement_ref": "create_workplan",
+          "owner_component": "state-hub.mcp",
+          "status": "legacy",
+          "replacement_verified": true,
+          "manual_hold": false,
+          "hold_reason": null,
+          "notes": "Registered by STATE-WP-0070 T03 \u2014 zero-window streak starts at registration",
+          "retired_at": null,
+          "created_at": "2026-07-10T13:19:44.205900Z",
+          "updated_at": "2026-07-10T13:19:44.205900Z"
+        },
+        "all_time": {
+          "calls": 2,
+          "tenant_count": 1,
+          "user_count": 1,
+          "component_count": 1,
+          "tenants": {
+            "unknown": 2
+          },
+          "users": {
+            "unknown": 2
+          },
+          "components": {
+            "state-hub.mcp": 2
+          }
+        },
+        "window": {
+          "calls": 0,
+          "tenant_count": 0,
+          "user_count": 0,
+          "component_count": 0,
+          "tenants": {},
+          "users": {},
+          "components": {}
+        },
+        "last_seen_at": "2026-07-10T13:20:43.378546Z",
+        "retirement_candidate": true,
+        "retirement_reason": "no measured usage in review window"
+      },
+      {
+        "interface": {
+          "id": "b6a5fe44-fb85-4ef7-a273-78d09da777af",
+          "interface_key": "mcp:list_workstreams",
+          "interface_kind": "mcp_tool",
+          "legacy_since": "2026-07-10T13:19:26.075491Z",
+          "replacement_ref": "list_workplans",
+          "owner_component": "state-hub.mcp",
+          "status": "legacy",
+          "replacement_verified": true,
+          "manual_hold": false,
+          "hold_reason": null,
+          "notes": null,
+          "retired_at": null,
+          "created_at": "2026-07-10T13:19:26.075491Z",
+          "updated_at": "2026-07-10T13:19:26.075491Z"
+        },
+        "all_time": {
+          "calls": 2,
+          "tenant_count": 1,
+          "user_count": 1,
+          "component_count": 1,
+          "tenants": {
+            "unknown": 2
+          },
+          "users": {
+            "unknown": 2
+          },
+          "components": {
+            "state-hub.mcp": 2
+          }
+        },
+        "window": {
+          "calls": 0,
+          "tenant_count": 0,
+          "user_count": 0,
+          "component_count": 0,
+          "tenants": {},
+          "users": {},
+          "components": {}
+        },
+        "last_seen_at": "2026-07-10T13:20:42.374940Z",
+        "retirement_candidate": true,
+        "retirement_reason": "no measured usage in review window"
+      },
+      {
+        "interface": {
+          "id": "53c3372b-307d-4d6a-8ea4-bc36cacdcaf2",
+          "interface_key": "mcp:update_workstream",
+          "interface_kind": "mcp_tool",
+          "legacy_since": "2026-07-10T13:19:44.255216Z",
+          "replacement_ref": "update_workplan",
+          "owner_component": "state-hub.mcp",
+          "status": "legacy",
+          "replacement_verified": true,
+          "manual_hold": false,
+          "hold_reason": null,
+          "notes": "Registered by STATE-WP-0070 T03 \u2014 zero-window streak starts at registration",
+          "retired_at": null,
+          "created_at": "2026-07-10T13:19:44.255216Z",
+          "updated_at": "2026-07-10T13:19:44.255216Z"
+        },
+        "all_time": {
+          "calls": 0,
+          "tenant_count": 0,
+          "user_count": 0,
+          "component_count": 0,
+          "tenants": {},
+          "users": {},
+          "components": {}
+        },
+        "window": {
+          "calls": 0,
+          "tenant_count": 0,
+          "user_count": 0,
+          "component_count": 0,
+          "tenants": {},
+          "users": {},
+          "components": {}
+        },
+        "last_seen_at": null,
+        "retirement_candidate": true,
+        "retirement_reason": "no measured usage in review window"
+      },
+      {
+        "interface": {
+          "id": "bed4d08a-3471-48f5-9f0e-f9d550383a26",
+          "interface_key": "mcp:update_workstream_status",
+          "interface_kind": "mcp_tool",
+          "legacy_since": "2026-07-10T13:19:44.303612Z",
+          "replacement_ref": "update_workplan_status",
+          "owner_component": "state-hub.mcp",
+          "status": "legacy",
+          "replacement_verified": true,
+          "manual_hold": false,
+          "hold_reason": null,
+          "notes": "Registered by STATE-WP-0070 T03 \u2014 zero-window streak starts at registration",
+          "retired_at": null,
+          "created_at": "2026-07-10T13:19:44.303612Z",
+          "updated_at": "2026-07-10T13:19:44.303612Z"
+        },
+        "all_time": {
+          "calls": 0,
+          "tenant_count": 0,
+          "user_count": 0,
+          "component_count": 0,
+          "tenants": {},
+          "users": {},
+          "components": {}
+        },
+        "window": {
+          "calls": 0,
+          "tenant_count": 0,
+          "user_count": 0,
+          "component_count": 0,
+          "tenants": {},
+          "users": {},
+          "components": {}
+        },
+        "last_seen_at": null,
+        "retirement_candidate": true,
+        "retirement_reason": "no measured usage in review window"
+      },
+      {
+        "interface": {
+          "id": "46900dc2-0893-405b-ba59-80f31fb6ebb1",
+          "interface_key": "state://workstreams/{topic_slug}",
+          "interface_kind": "mcp_tool",
+          "legacy_since": "2026-07-10T13:19:44.344493Z",
+          "replacement_ref": "state://workplans/{topic_slug}",
+          "owner_component": "state-hub.mcp",
+          "status": "legacy",
+          "replacement_verified": true,
+          "manual_hold": false,
+          "hold_reason": null,
+          "notes": "Registered by STATE-WP-0070 T03 \u2014 zero-window streak starts at registration",
+          "retired_at": null,
+          "created_at": "2026-07-10T13:19:44.344493Z",
+          "updated_at": "2026-07-10T13:19:44.344493Z"
+        },
+        "all_time": {
+          "calls": 1,
+          "tenant_count": 1,
+          "user_count": 1,
+          "component_count": 1,
+          "tenants": {
+            "unknown": 1
+          },
+          "users": {
+            "unknown": 1
+          },
+          "components": {
+            "state-hub.mcp": 1
+          }
+        },
+        "window": {
+          "calls": 0,
+          "tenant_count": 0,
+          "user_count": 0,
+          "component_count": 0,
+          "tenants": {},
+          "users": {},
+          "components": {}
+        },
+        "last_seen_at": "2026-07-10T13:20:34.491811Z",
+        "retirement_candidate": true,
+        "retirement_reason": "no measured usage in review window"
+      },
+      {
+        "interface": {
+          "id": "cd9342fd-27e7-4a46-a1be-d41499e106a3",
+          "interface_key": "rest_api:DELETE /workstreams/{workstream_id}",
+          "interface_kind": "rest_api",
+          "legacy_since": "2026-06-06T17:28:13.052813Z",
+          "replacement_ref": "/workplans/{workplan_id}",
+          "owner_component": "state-hub.api",
+          "status": "legacy",
+          "replacement_verified": true,
+          "manual_hold": false,
+          "hold_reason": null,
+          "notes": null,
+          "retired_at": null,
+          "created_at": "2026-06-06T17:28:13.052813Z",
+          "updated_at": "2026-06-06T17:28:13.052813Z"
+        },
+        "all_time": {
+          "calls": 1,
+          "tenant_count": 1,
+          "user_count": 1,
+          "component_count": 1,
+          "tenants": {
+            "unknown": 1
+          },
+          "users": {
+            "unknown": 1
+          },
+          "components": {
+            "unknown": 1
+          }
+        },
+        "window": {
+          "calls": 0,
+          "tenant_count": 0,
+          "user_count": 0,
+          "component_count": 0,
+          "tenants": {},
+          "users": {},
+          "components": {}
+        },
+        "last_seen_at": "2026-06-06T17:28:13.047529Z",
+        "retirement_candidate": true,
+        "retirement_reason": "no measured usage in review window"
+      },
+      {
+        "interface": {
+          "id": "a4e0948c-cd4a-461e-8ae2-7fd7b51d04a7",
+          "interface_key": "rest_api:GET /decisions/?workstream_id",
+          "interface_kind": "rest_api",
+          "legacy_since": "2026-07-09T23:07:53.093223Z",
+          "replacement_ref": "/decisions/?workplan_id=<workplan_id>",
+          "owner_component": "state-hub.api",
+          "status": "legacy",
+          "replacement_verified": true,
+          "manual_hold": false,
+          "hold_reason": null,
+          "notes": null,
+          "retired_at": null,
+          "created_at": "2026-07-09T23:07:53.093223Z",
+          "updated_at": "2026-07-09T23:07:53.093223Z"
+        },
+        "all_time": {
+          "calls": 1,
+          "tenant_count": 1,
+          "user_count": 1,
+          "component_count": 1,
+          "tenants": {
+            "unknown": 1
+          },
+          "users": {
+            "unknown": 1
+          },
+          "components": {
+            "unknown": 1
+          }
+        },
+        "window": {
+          "calls": 0,
+          "tenant_count": 0,
+          "user_count": 0,
+          "component_count": 0,
+          "tenants": {},
+          "users": {},
+          "components": {}
+        },
+        "last_seen_at": "2026-07-09T23:07:53.083299Z",
+        "retirement_candidate": true,
+        "retirement_reason": "no measured usage in review window"
+      },
+      {
+        "interface": {
+          "id": "70a9346e-e0ee-42ac-874f-f160580b54dd",
+          "interface_key": "rest_api:GET /progress/?workstream_id",
+          "interface_kind": "rest_api",
+          "legacy_since": "2026-07-13T22:04:03.911449Z",
+          "replacement_ref": "/progress/?workplan_id=<workplan_id>",
+          "owner_component": "state-hub.api",
+          "status": "legacy",
+          "replacement_verified": true,
+          "manual_hold": false,
+          "hold_reason": null,
+          "notes": null,
+          "retired_at": null,
+          "created_at": "2026-07-13T22:04:03.911449Z",
+          "updated_at": "2026-07-13T22:04:03.911449Z"
+        },
+        "all_time": {
+          "calls": 1,
+          "tenant_count": 1,
+          "user_count": 1,
+          "component_count": 1,
+          "tenants": {
+            "unknown": 1
+          },
+          "users": {
+            "unknown": 1
+          },
+          "components": {
+            "unknown": 1
+          }
+        },
+        "window": {
+          "calls": 0,
+          "tenant_count": 0,
+          "user_count": 0,
+          "component_count": 0,
+          "tenants": {},
+          "users": {},
+          "components": {}
+        },
+        "last_seen_at": "2026-07-13T22:04:03.904998Z",
+        "retirement_candidate": true,
+        "retirement_reason": "no measured usage in review window"
+      },
+      {
+        "interface": {
+          "id": "be3cdcf8-250b-4bf0-801f-02ffd5f57e00",
+          "interface_key": "rest_api:GET /tasks/?workstream_id",
+          "interface_kind": "rest_api",
+          "legacy_since": "2026-07-08T19:32:21.628513Z",
+          "replacement_ref": "/tasks/?workplan_id=<workplan_id>",
+          "owner_component": "state-hub.api",
+          "status": "legacy",
+          "replacement_verified": true,
+          "manual_hold": false,
+          "hold_reason": null,
+          "notes": null,
+          "retired_at": null,
+          "created_at": "2026-07-08T19:32:21.628513Z",
+          "updated_at": "2026-07-08T19:32:21.628513Z"
+        },
+        "all_time": {
+          "calls": 587,
+          "tenant_count": 1,
+          "user_count": 1,
+          "component_count": 1,
+          "tenants": {
+            "unknown": 587
+          },
+          "users": {
+            "unknown": 587
+          },
+          "components": {
+            "unknown": 587
+          }
+        },
+        "window": {
+          "calls": 0,
+          "tenant_count": 0,
+          "user_count": 0,
+          "component_count": 0,
+          "tenants": {},
+          "users": {},
+          "components": {}
+        },
+        "last_seen_at": "2026-07-22T13:21:12.171828Z",
+        "retirement_candidate": true,
+        "retirement_reason": "no measured usage in review window"
+      },
+      {
+        "interface": {
+          "id": "3e4a3d0b-08fa-45c3-91e2-4f514a914b97",
+          "interface_key": "rest_api:GET /workstreams/",
+          "interface_kind": "rest_api",
+          "legacy_since": "2026-06-04T00:26:14.533764Z",
+          "replacement_ref": "/workplans/",
+          "owner_component": "state-hub.api",
+          "status": "legacy",
+          "replacement_verified": true,
+          "manual_hold": false,
+          "hold_reason": null,
+          "notes": null,
+          "retired_at": null,
+          "created_at": "2026-06-04T00:26:14.533764Z",
+          "updated_at": "2026-06-04T00:26:14.533764Z"
+        },
+        "all_time": {
+          "calls": 144084,
+          "tenant_count": 1,
+          "user_count": 1,
+          "component_count": 1,
+          "tenants": {
+            "unknown": 144084
+          },
+          "users": {
+            "unknown": 144084
+          },
+          "components": {
+            "unknown": 144084
+          }
+        },
+        "window": {
+          "calls": 0,
+          "tenant_count": 0,
+          "user_count": 0,
+          "component_count": 0,
+          "tenants": {},
+          "users": {},
+          "components": {}
+        },
+        "last_seen_at": "2026-07-08T21:14:39.652776Z",
+        "retirement_candidate": true,
+        "retirement_reason": "no measured usage in review window"
+      },
+      {
+        "interface": {
+          "id": "e4c140ec-7479-46f9-b185-4b533f19d639",
+          "interface_key": "rest_api:GET /workstreams/workplan-index",
+          "interface_kind": "rest_api",
+          "legacy_since": "2026-06-04T05:20:58.321869Z",
+          "replacement_ref": "/workplans/index",
+          "owner_component": "state-hub.api",
+          "status": "legacy",
+          "replacement_verified": true,
+          "manual_hold": false,
+          "hold_reason": null,
+          "notes": null,
+          "retired_at": null,
+          "created_at": "2026-06-04T05:20:58.321869Z",
+          "updated_at": "2026-06-04T05:20:58.321869Z"
+        },
+        "all_time": {
+          "calls": 30,
+          "tenant_count": 1,
+          "user_count": 1,
+          "component_count": 1,
+          "tenants": {
+            "unknown": 30
+          },
+          "users": {
+            "unknown": 30
+          },
+          "components": {
+            "unknown": 30
+          }
+        },
+        "window": {
+          "calls": 0,
+          "tenant_count": 0,
+          "user_count": 0,
+          "component_count": 0,
+          "tenants": {},
+          "users": {},
+          "components": {}
+        },
+        "last_seen_at": "2026-07-03T05:20:34.534439Z",
+        "retirement_candidate": true,
+        "retirement_reason": "no measured usage in review window"
+      },
+      {
+        "interface": {
+          "id": "3a00b19e-e7db-4403-98aa-a77c9ab61ecc",
+          "interface_key": "rest_api:GET /workstreams/{workstream_id}",
+          "interface_kind": "rest_api",
+          "legacy_since": "2026-06-04T00:25:59.014966Z",
+          "replacement_ref": "/workplans/{workplan_id}",
+          "owner_component": "state-hub.api",
+          "status": "legacy",
+          "replacement_verified": true,
+          "manual_hold": false,
+          "hold_reason": null,
+          "notes": null,
+          "retired_at": null,
+          "created_at": "2026-06-04T00:25:59.014966Z",
+          "updated_at": "2026-06-04T00:25:59.014966Z"
+        },
+        "all_time": {
+          "calls": 511405,
+          "tenant_count": 1,
+          "user_count": 1,
+          "component_count": 1,
+          "tenants": {
+            "unknown": 511405
+          },
+          "users": {
+            "unknown": 511405
+          },
+          "components": {
+            "unknown": 511405
+          }
+        },
+        "window": {
+          "calls": 0,
+          "tenant_count": 0,
+          "user_count": 0,
+          "component_count": 0,
+          "tenants": {},
+          "users": {},
+          "components": {}
+        },
+        "last_seen_at": "2026-07-08T21:14:20.781103Z",
+        "retirement_candidate": true,
+        "retirement_reason": "no measured usage in review window"
+      },
+      {
+        "interface": {
+          "id": "69e1a255-a8b9-4101-8a68-b1bed23abfda",
+          "interface_key": "rest_api:GET /workstreams/{workstream_id}/dependencies/",
+          "interface_kind": "rest_api",
+          "legacy_since": "2026-06-04T00:25:59.291135Z",
+          "replacement_ref": "/workplans/{workplan_id}/dependencies/",
+          "owner_component": "state-hub.api",
+          "status": "legacy",
+          "replacement_verified": true,
+          "manual_hold": false,
+          "hold_reason": null,
+          "notes": null,
+          "retired_at": null,
+          "created_at": "2026-06-04T00:25:59.291135Z",
+          "updated_at": "2026-06-04T00:25:59.291135Z"
+        },
+        "all_time": {
+          "calls": 255865,
+          "tenant_count": 1,
+          "user_count": 1,
+          "component_count": 1,
+          "tenants": {
+            "unknown": 255865
+          },
+          "users": {
+            "unknown": 255865
+          },
+          "components": {
+            "unknown": 255865
+          }
+        },
+        "window": {
+          "calls": 0,
+          "tenant_count": 0,
+          "user_count": 0,
+          "component_count": 0,
+          "tenants": {},
+          "users": {},
+          "components": {}
+        },
+        "last_seen_at": "2026-07-08T21:14:12.747005Z",
+        "retirement_candidate": true,
+        "retirement_reason": "no measured usage in review window"
+      },
+      {
+        "interface": {
+          "id": "b1aae931-b51f-4a85-a723-865dd65f6132",
+          "interface_key": "rest_api:PATCH /workstreams/{workstream_id}",
+          "interface_kind": "rest_api",
+          "legacy_since": "2026-06-04T06:09:41.901035Z",
+          "replacement_ref": "/workplans/{workplan_id}",
+          "owner_component": "state-hub.api",
+          "status": "legacy",
+          "replacement_verified": true,
+          "manual_hold": false,
+          "hold_reason": null,
+          "notes": null,
+          "retired_at": null,
+          "created_at": "2026-06-04T06:09:41.901035Z",
+          "updated_at": "2026-06-04T06:09:41.901035Z"
+        },
+        "all_time": {
+          "calls": 571,
+          "tenant_count": 1,
+          "user_count": 1,
+          "component_count": 1,
+          "tenants": {
+            "unknown": 571
+          },
+          "users": {
+            "unknown": 571
+          },
+          "components": {
+            "unknown": 571
+          }
+        },
+        "window": {
+          "calls": 0,
+          "tenant_count": 0,
+          "user_count": 0,
+          "component_count": 0,
+          "tenants": {},
+          "users": {},
+          "components": {}
+        },
+        "last_seen_at": "2026-07-08T20:49:12.335710Z",
+        "retirement_candidate": true,
+        "retirement_reason": "no measured usage in review window"
+      },
+      {
+        "interface": {
+          "id": "4aea9591-970b-4918-ac4a-4da95a0a1a8c",
+          "interface_key": "rest_api:POST /decisions/ workstream_id",
+          "interface_kind": "rest_api",
+          "legacy_since": "2026-07-09T22:56:35.473130Z",
+          "replacement_ref": "POST /decisions/ with workplan_id",
+          "owner_component": "state-hub.api",
+          "status": "legacy",
+          "replacement_verified": true,
+          "manual_hold": false,
+          "hold_reason": null,
+          "notes": null,
+          "retired_at": null,
+          "created_at": "2026-07-09T22:56:35.473130Z",
+          "updated_at": "2026-07-09T22:56:35.473130Z"
+        },
+        "all_time": {
+          "calls": 3,
+          "tenant_count": 1,
+          "user_count": 1,
+          "component_count": 1,
+          "tenants": {
+            "unknown": 3
+          },
+          "users": {
+            "unknown": 3
+          },
+          "components": {
+            "unknown": 3
+          }
+        },
+        "window": {
+          "calls": 0,
+          "tenant_count": 0,
+          "user_count": 0,
+          "component_count": 0,
+          "tenants": {},
+          "users": {},
+          "components": {}
+        },
+        "last_seen_at": "2026-07-09T22:57:05.912456Z",
+        "retirement_candidate": true,
+        "retirement_reason": "no measured usage in review window"
+      },
+      {
+        "interface": {
+          "id": "4a70583c-1e41-4ec1-99a9-728856a7d79c",
+          "interface_key": "rest_api:POST /progress/ workstream_id",
+          "interface_kind": "rest_api",
+          "legacy_since": "2026-07-08T23:35:09.148333Z",
+          "replacement_ref": "POST /progress/ with workplan_id",
+          "owner_component": "state-hub.api",
+          "status": "legacy",
+          "replacement_verified": true,
+          "manual_hold": false,
+          "hold_reason": null,
+          "notes": null,
+          "retired_at": null,
+          "created_at": "2026-07-08T23:35:09.148333Z",
+          "updated_at": "2026-07-08T23:35:09.148333Z"
+        },
+        "all_time": {
+          "calls": 14,
+          "tenant_count": 1,
+          "user_count": 1,
+          "component_count": 1,
+          "tenants": {
+            "unknown": 14
+          },
+          "users": {
+            "unknown": 14
+          },
+          "components": {
+            "unknown": 14
+          }
+        },
+        "window": {
+          "calls": 0,
+          "tenant_count": 0,
+          "user_count": 0,
+          "component_count": 0,
+          "tenants": {},
+          "users": {},
+          "components": {}
+        },
+        "last_seen_at": "2026-07-10T08:34:42.959724Z",
+        "retirement_candidate": true,
+        "retirement_reason": "no measured usage in review window"
+      },
+      {
+        "interface": {
+          "id": "6df4e443-7bf1-461a-923b-a6eb52fe7b07",
+          "interface_key": "rest_api:POST /tasks/ workstream_id",
+          "interface_kind": "rest_api",
+          "legacy_since": "2026-07-08T22:38:29.405720Z",
+          "replacement_ref": "POST /tasks/ with workplan_id",
+          "owner_component": "state-hub.api",
+          "status": "legacy",
+          "replacement_verified": true,
+          "manual_hold": false,
+          "hold_reason": null,
+          "notes": null,
+          "retired_at": null,
+          "created_at": "2026-07-08T22:38:29.405720Z",
+          "updated_at": "2026-07-08T22:38:29.405720Z"
+        },
+        "all_time": {
+          "calls": 5,
+          "tenant_count": 1,
+          "user_count": 1,
+          "component_count": 1,
+          "tenants": {
+            "unknown": 5
+          },
+          "users": {
+            "unknown": 5
+          },
+          "components": {
+            "state-hub.fix-consistency": 5
+          }
+        },
+        "window": {
+          "calls": 0,
+          "tenant_count": 0,
+          "user_count": 0,
+          "component_count": 0,
+          "tenants": {},
+          "users": {},
+          "components": {}
+        },
+        "last_seen_at": "2026-07-08T22:38:29.976918Z",
+        "retirement_candidate": true,
+        "retirement_reason": "no measured usage in review window"
+      },
+      {
+        "interface": {
+          "id": "ed6451c9-d2cc-4486-9afe-d3852782cabc",
+          "interface_key": "rest_api:POST /workstreams/",
+          "interface_kind": "rest_api",
+          "legacy_since": "2026-06-04T07:40:24.168535Z",
+          "replacement_ref": "/workplans/",
+          "owner_component": "state-hub.api",
+          "status": "legacy",
+          "replacement_verified": true,
+          "manual_hold": false,
+          "hold_reason": null,
+          "notes": null,
+          "retired_at": null,
+          "created_at": "2026-06-04T07:40:24.168535Z",
+          "updated_at": "2026-06-04T07:40:24.168535Z"
+        },
+        "all_time": {
+          "calls": 824,
+          "tenant_count": 1,
+          "user_count": 1,
+          "component_count": 1,
+          "tenants": {
+            "unknown": 824
+          },
+          "users": {
+            "unknown": 824
+          },
+          "components": {
+            "unknown": 824
+          }
+        },
+        "window": {
+          "calls": 0,
+          "tenant_count": 0,
+          "user_count": 0,
+          "component_count": 0,
+          "tenants": {},
+          "users": {},
+          "components": {}
+        },
+        "last_seen_at": "2026-07-08T20:38:05.903144Z",
+        "retirement_candidate": true,
+        "retirement_reason": "no measured usage in review window"
+      },
+      {
+        "interface": {
+          "id": "281fd706-b192-4194-8055-2d8733c115f9",
+          "interface_key": "rest_api:POST /workstreams/{workstream_id}/dependencies/",
+          "interface_kind": "rest_api",
+          "legacy_since": "2026-06-04T22:57:37.149207Z",
+          "replacement_ref": "/workplans/{workplan_id}/dependencies/",
+          "owner_component": "state-hub.api",
+          "status": "legacy",
+          "replacement_verified": true,
+          "manual_hold": false,
+          "hold_reason": null,
+          "notes": null,
+          "retired_at": null,
+          "created_at": "2026-06-04T22:57:37.149207Z",
+          "updated_at": "2026-06-04T22:57:37.149207Z"
+        },
+        "all_time": {
+          "calls": 4971,
+          "tenant_count": 1,
+          "user_count": 1,
+          "component_count": 1,
+          "tenants": {
+            "unknown": 4971
+          },
+          "users": {
+            "unknown": 4971
+          },
+          "components": {
+            "unknown": 4971
+          }
+        },
+        "window": {
+          "calls": 0,
+          "tenant_count": 0,
+          "user_count": 0,
+          "component_count": 0,
+          "tenants": {},
+          "users": {},
+          "components": {}
+        },
+        "last_seen_at": "2026-07-01T22:09:24.229011Z",
+        "retirement_candidate": true,
+        "retirement_reason": "no measured usage in review window"
+      }
+    ],
+    "retirement_candidates": [
+      {
+        "interface": {
+          "id": "63ed90e3-42b4-431a-94db-e1254a52f9e2",
+          "interface_key": "mcp:create_workstream",
+          "interface_kind": "mcp_tool",
+          "legacy_since": "2026-07-10T13:19:44.205900Z",
+          "replacement_ref": "create_workplan",
+          "owner_component": "state-hub.mcp",
+          "status": "legacy",
+          "replacement_verified": true,
+          "manual_hold": false,
+          "hold_reason": null,
+          "notes": "Registered by STATE-WP-0070 T03 \u2014 zero-window streak starts at registration",
+          "retired_at": null,
+          "created_at": "2026-07-10T13:19:44.205900Z",
+          "updated_at": "2026-07-10T13:19:44.205900Z"
+        },
+        "all_time": {
+          "calls": 2,
+          "tenant_count": 1,
+          "user_count": 1,
+          "component_count": 1,
+          "tenants": {
+            "unknown": 2
+          },
+          "users": {
+            "unknown": 2
+          },
+          "components": {
+            "state-hub.mcp": 2
+          }
+        },
+        "window": {
+          "calls": 0,
+          "tenant_count": 0,
+          "user_count": 0,
+          "component_count": 0,
+          "tenants": {},
+          "users": {},
+          "components": {}
+        },
+        "last_seen_at": "2026-07-10T13:20:43.378546Z",
+        "retirement_candidate": true,
+        "retirement_reason": "no measured usage in review window"
+      },
+      {
+        "interface": {
+          "id": "b6a5fe44-fb85-4ef7-a273-78d09da777af",
+          "interface_key": "mcp:list_workstreams",
+          "interface_kind": "mcp_tool",
+          "legacy_since": "2026-07-10T13:19:26.075491Z",
+          "replacement_ref": "list_workplans",
+          "owner_component": "state-hub.mcp",
+          "status": "legacy",
+          "replacement_verified": true,
+          "manual_hold": false,
+          "hold_reason": null,
+          "notes": null,
+          "retired_at": null,
+          "created_at": "2026-07-10T13:19:26.075491Z",
+          "updated_at": "2026-07-10T13:19:26.075491Z"
+        },
+        "all_time": {
+          "calls": 2,
+          "tenant_count": 1,
+          "user_count": 1,
+          "component_count": 1,
+          "tenants": {
+            "unknown": 2
+          },
+          "users": {
+            "unknown": 2
+          },
+          "components": {
+            "state-hub.mcp": 2
+          }
+        },
+        "window": {
+          "calls": 0,
+          "tenant_count": 0,
+          "user_count": 0,
+          "component_count": 0,
+          "tenants": {},
+          "users": {},
+          "components": {}
+        },
+        "last_seen_at": "2026-07-10T13:20:42.374940Z",
+        "retirement_candidate": true,
+        "retirement_reason": "no measured usage in review window"
+      },
+      {
+        "interface": {
+          "id": "53c3372b-307d-4d6a-8ea4-bc36cacdcaf2",
+          "interface_key": "mcp:update_workstream",
+          "interface_kind": "mcp_tool",
+          "legacy_since": "2026-07-10T13:19:44.255216Z",
+          "replacement_ref": "update_workplan",
+          "owner_component": "state-hub.mcp",
+          "status": "legacy",
+          "replacement_verified": true,
+          "manual_hold": false,
+          "hold_reason": null,
+          "notes": "Registered by STATE-WP-0070 T03 \u2014 zero-window streak starts at registration",
+          "retired_at": null,
+          "created_at": "2026-07-10T13:19:44.255216Z",
+          "updated_at": "2026-07-10T13:19:44.255216Z"
+        },
+        "all_time": {
+          "calls": 0,
+          "tenant_count": 0,
+          "user_count": 0,
+          "component_count": 0,
+          "tenants": {},
+          "users": {},
+          "components": {}
+        },
+        "window": {
+          "calls": 0,
+          "tenant_count": 0,
+          "user_count": 0,
+          "component_count": 0,
+          "tenants": {},
+          "users": {},
+          "components": {}
+        },
+        "last_seen_at": null,
+        "retirement_candidate": true,
+        "retirement_reason": "no measured usage in review window"
+      },
+      {
+        "interface": {
+          "id": "bed4d08a-3471-48f5-9f0e-f9d550383a26",
+          "interface_key": "mcp:update_workstream_status",
+          "interface_kind": "mcp_tool",
+          "legacy_since": "2026-07-10T13:19:44.303612Z",
+          "replacement_ref": "update_workplan_status",
+          "owner_component": "state-hub.mcp",
+          "status": "legacy",
+          "replacement_verified": true,
+          "manual_hold": false,
+          "hold_reason": null,
+          "notes": "Registered by STATE-WP-0070 T03 \u2014 zero-window streak starts at registration",
+          "retired_at": null,
+          "created_at": "2026-07-10T13:19:44.303612Z",
+          "updated_at": "2026-07-10T13:19:44.303612Z"
+        },
+        "all_time": {
+          "calls": 0,
+          "tenant_count": 0,
+          "user_count": 0,
+          "component_count": 0,
+          "tenants": {},
+          "users": {},
+          "components": {}
+        },
+        "window": {
+          "calls": 0,
+          "tenant_count": 0,
+          "user_count": 0,
+          "component_count": 0,
+          "tenants": {},
+          "users": {},
+          "components": {}
+        },
+        "last_seen_at": null,
+        "retirement_candidate": true,
+        "retirement_reason": "no measured usage in review window"
+      },
+      {
+        "interface": {
+          "id": "46900dc2-0893-405b-ba59-80f31fb6ebb1",
+          "interface_key": "state://workstreams/{topic_slug}",
+          "interface_kind": "mcp_tool",
+          "legacy_since": "2026-07-10T13:19:44.344493Z",
+          "replacement_ref": "state://workplans/{topic_slug}",
+          "owner_component": "state-hub.mcp",
+          "status": "legacy",
+          "replacement_verified": true,
+          "manual_hold": false,
+          "hold_reason": null,
+          "notes": "Registered by STATE-WP-0070 T03 \u2014 zero-window streak starts at registration",
+          "retired_at": null,
+          "created_at": "2026-07-10T13:19:44.344493Z",
+          "updated_at": "2026-07-10T13:19:44.344493Z"
+        },
+        "all_time": {
+          "calls": 1,
+          "tenant_count": 1,
+          "user_count": 1,
+          "component_count": 1,
+          "tenants": {
+            "unknown": 1
+          },
+          "users": {
+            "unknown": 1
+          },
+          "components": {
+            "state-hub.mcp": 1
+          }
+        },
+        "window": {
+          "calls": 0,
+          "tenant_count": 0,
+          "user_count": 0,
+          "component_count": 0,
+          "tenants": {},
+          "users": {},
+          "components": {}
+        },
+        "last_seen_at": "2026-07-10T13:20:34.491811Z",
+        "retirement_candidate": true,
+        "retirement_reason": "no measured usage in review window"
+      },
+      {
+        "interface": {
+          "id": "cd9342fd-27e7-4a46-a1be-d41499e106a3",
+          "interface_key": "rest_api:DELETE /workstreams/{workstream_id}",
+          "interface_kind": "rest_api",
+          "legacy_since": "2026-06-06T17:28:13.052813Z",
+          "replacement_ref": "/workplans/{workplan_id}",
+          "owner_component": "state-hub.api",
+          "status": "legacy",
+          "replacement_verified": true,
+          "manual_hold": false,
+          "hold_reason": null,
+          "notes": null,
+          "retired_at": null,
+          "created_at": "2026-06-06T17:28:13.052813Z",
+          "updated_at": "2026-06-06T17:28:13.052813Z"
+        },
+        "all_time": {
+          "calls": 1,
+          "tenant_count": 1,
+          "user_count": 1,
+          "component_count": 1,
+          "tenants": {
+            "unknown": 1
+          },
+          "users": {
+            "unknown": 1
+          },
+          "components": {
+            "unknown": 1
+          }
+        },
+        "window": {
+          "calls": 0,
+          "tenant_count": 0,
+          "user_count": 0,
+          "component_count": 0,
+          "tenants": {},
+          "users": {},
+          "components": {}
+        },
+        "last_seen_at": "2026-06-06T17:28:13.047529Z",
+        "retirement_candidate": true,
+        "retirement_reason": "no measured usage in review window"
+      },
+      {
+        "interface": {
+          "id": "a4e0948c-cd4a-461e-8ae2-7fd7b51d04a7",
+          "interface_key": "rest_api:GET /decisions/?workstream_id",
+          "interface_kind": "rest_api",
+          "legacy_since": "2026-07-09T23:07:53.093223Z",
+          "replacement_ref": "/decisions/?workplan_id=<workplan_id>",
+          "owner_component": "state-hub.api",
+          "status": "legacy",
+          "replacement_verified": true,
+          "manual_hold": false,
+          "hold_reason": null,
+          "notes": null,
+          "retired_at": null,
+          "created_at": "2026-07-09T23:07:53.093223Z",
+          "updated_at": "2026-07-09T23:07:53.093223Z"
+        },
+        "all_time": {
+          "calls": 1,
+          "tenant_count": 1,
+          "user_count": 1,
+          "component_count": 1,
+          "tenants": {
+            "unknown": 1
+          },
+          "users": {
+            "unknown": 1
+          },
+          "components": {
+            "unknown": 1
+          }
+        },
+        "window": {
+          "calls": 0,
+          "tenant_count": 0,
+          "user_count": 0,
+          "component_count": 0,
+          "tenants": {},
+          "users": {},
+          "components": {}
+        },
+        "last_seen_at": "2026-07-09T23:07:53.083299Z",
+        "retirement_candidate": true,
+        "retirement_reason": "no measured usage in review window"
+      },
+      {
+        "interface": {
+          "id": "70a9346e-e0ee-42ac-874f-f160580b54dd",
+          "interface_key": "rest_api:GET /progress/?workstream_id",
+          "interface_kind": "rest_api",
+          "legacy_since": "2026-07-13T22:04:03.911449Z",
+          "replacement_ref": "/progress/?workplan_id=<workplan_id>",
+          "owner_component": "state-hub.api",
+          "status": "legacy",
+          "replacement_verified": true,
+          "manual_hold": false,
+          "hold_reason": null,
+          "notes": null,
+          "retired_at": null,
+          "created_at": "2026-07-13T22:04:03.911449Z",
+          "updated_at": "2026-07-13T22:04:03.911449Z"
+        },
+        "all_time": {
+          "calls": 1,
+          "tenant_count": 1,
+          "user_count": 1,
+          "component_count": 1,
+          "tenants": {
+            "unknown": 1
+          },
+          "users": {
+            "unknown": 1
+          },
+          "components": {
+            "unknown": 1
+          }
+        },
+        "window": {
+          "calls": 0,
+          "tenant_count": 0,
+          "user_count": 0,
+          "component_count": 0,
+          "tenants": {},
+          "users": {},
+          "components": {}
+        },
+        "last_seen_at": "2026-07-13T22:04:03.904998Z",
+        "retirement_candidate": true,
+        "retirement_reason": "no measured usage in review window"
+      },
+      {
+        "interface": {
+          "id": "be3cdcf8-250b-4bf0-801f-02ffd5f57e00",
+          "interface_key": "rest_api:GET /tasks/?workstream_id",
+          "interface_kind": "rest_api",
+          "legacy_since": "2026-07-08T19:32:21.628513Z",
+          "replacement_ref": "/tasks/?workplan_id=<workplan_id>",
+          "owner_component": "state-hub.api",
+          "status": "legacy",
+          "replacement_verified": true,
+          "manual_hold": false,
+          "hold_reason": null,
+          "notes": null,
+          "retired_at": null,
+          "created_at": "2026-07-08T19:32:21.628513Z",
+          "updated_at": "2026-07-08T19:32:21.628513Z"
+        },
+        "all_time": {
+          "calls": 587,
+          "tenant_count": 1,
+          "user_count": 1,
+          "component_count": 1,
+          "tenants": {
+            "unknown": 587
+          },
+          "users": {
+            "unknown": 587
+          },
+          "components": {
+            "unknown": 587
+          }
+        },
+        "window": {
+          "calls": 0,
+          "tenant_count": 0,
+          "user_count": 0,
+          "component_count": 0,
+          "tenants": {},
+          "users": {},
+          "components": {}
+        },
+        "last_seen_at": "2026-07-22T13:21:12.171828Z",
+        "retirement_candidate": true,
+        "retirement_reason": "no measured usage in review window"
+      },
+      {
+        "interface": {
+          "id": "3e4a3d0b-08fa-45c3-91e2-4f514a914b97",
+          "interface_key": "rest_api:GET /workstreams/",
+          "interface_kind": "rest_api",
+          "legacy_since": "2026-06-04T00:26:14.533764Z",
+          "replacement_ref": "/workplans/",
+          "owner_component": "state-hub.api",
+          "status": "legacy",
+          "replacement_verified": true,
+          "manual_hold": false,
+          "hold_reason": null,
+          "notes": null,
+          "retired_at": null,
+          "created_at": "2026-06-04T00:26:14.533764Z",
+          "updated_at": "2026-06-04T00:26:14.533764Z"
+        },
+        "all_time": {
+          "calls": 144084,
+          "tenant_count": 1,
+          "user_count": 1,
+          "component_count": 1,
+          "tenants": {
+            "unknown": 144084
+          },
+          "users": {
+            "unknown": 144084
+          },
+          "components": {
+            "unknown": 144084
+          }
+        },
+        "window": {
+          "calls": 0,
+          "tenant_count": 0,
+          "user_count": 0,
+          "component_count": 0,
+          "tenants": {},
+          "users": {},
+          "components": {}
+        },
+        "last_seen_at": "2026-07-08T21:14:39.652776Z",
+        "retirement_candidate": true,
+        "retirement_reason": "no measured usage in review window"
+      },
+      {
+        "interface": {
+          "id": "e4c140ec-7479-46f9-b185-4b533f19d639",
+          "interface_key": "rest_api:GET /workstreams/workplan-index",
+          "interface_kind": "rest_api",
+          "legacy_since": "2026-06-04T05:20:58.321869Z",
+          "replacement_ref": "/workplans/index",
+          "owner_component": "state-hub.api",
+          "status": "legacy",
+          "replacement_verified": true,
+          "manual_hold": false,
+          "hold_reason": null,
+          "notes": null,
+          "retired_at": null,
+          "created_at": "2026-06-04T05:20:58.321869Z",
+          "updated_at": "2026-06-04T05:20:58.321869Z"
+        },
+        "all_time": {
+          "calls": 30,
+          "tenant_count": 1,
+          "user_count": 1,
+          "component_count": 1,
+          "tenants": {
+            "unknown": 30
+          },
+          "users": {
+            "unknown": 30
+          },
+          "components": {
+            "unknown": 30
+          }
+        },
+        "window": {
+          "calls": 0,
+          "tenant_count": 0,
+          "user_count": 0,
+          "component_count": 0,
+          "tenants": {},
+          "users": {},
+          "components": {}
+        },
+        "last_seen_at": "2026-07-03T05:20:34.534439Z",
+        "retirement_candidate": true,
+        "retirement_reason": "no measured usage in review window"
+      },
+      {
+        "interface": {
+          "id": "3a00b19e-e7db-4403-98aa-a77c9ab61ecc",
+          "interface_key": "rest_api:GET /workstreams/{workstream_id}",
+          "interface_kind": "rest_api",
+          "legacy_since": "2026-06-04T00:25:59.014966Z",
+          "replacement_ref": "/workplans/{workplan_id}",
+          "owner_component": "state-hub.api",
+          "status": "legacy",
+          "replacement_verified": true,
+          "manual_hold": false,
+          "hold_reason": null,
+          "notes": null,
+          "retired_at": null,
+          "created_at": "2026-06-04T00:25:59.014966Z",
+          "updated_at": "2026-06-04T00:25:59.014966Z"
+        },
+        "all_time": {
+          "calls": 511405,
+          "tenant_count": 1,
+          "user_count": 1,
+          "component_count": 1,
+          "tenants": {
+            "unknown": 511405
+          },
+          "users": {
+            "unknown": 511405
+          },
+          "components": {
+            "unknown": 511405
+          }
+        },
+        "window": {
+          "calls": 0,
+          "tenant_count": 0,
+          "user_count": 0,
+          "component_count": 0,
+          "tenants": {},
+          "users": {},
+          "components": {}
+        },
+        "last_seen_at": "2026-07-08T21:14:20.781103Z",
+        "retirement_candidate": true,
+        "retirement_reason": "no measured usage in review window"
+      },
+      {
+        "interface": {
+          "id": "69e1a255-a8b9-4101-8a68-b1bed23abfda",
+          "interface_key": "rest_api:GET /workstreams/{workstream_id}/dependencies/",
+          "interface_kind": "rest_api",
+          "legacy_since": "2026-06-04T00:25:59.291135Z",
+          "replacement_ref": "/workplans/{workplan_id}/dependencies/",
+          "owner_component": "state-hub.api",
+          "status": "legacy",
+          "replacement_verified": true,
+          "manual_hold": false,
+          "hold_reason": null,
+          "notes": null,
+          "retired_at": null,
+          "created_at": "2026-06-04T00:25:59.291135Z",
+          "updated_at": "2026-06-04T00:25:59.291135Z"
+        },
+        "all_time": {
+          "calls": 255865,
+          "tenant_count": 1,
+          "user_count": 1,
+          "component_count": 1,
+          "tenants": {
+            "unknown": 255865
+          },
+          "users": {
+            "unknown": 255865
+          },
+          "components": {
+            "unknown": 255865
+          }
+        },
+        "window": {
+          "calls": 0,
+          "tenant_count": 0,
+          "user_count": 0,
+          "component_count": 0,
+          "tenants": {},
+          "users": {},
+          "components": {}
+        },
+        "last_seen_at": "2026-07-08T21:14:12.747005Z",
+        "retirement_candidate": true,
+        "retirement_reason": "no measured usage in review window"
+      },
+      {
+        "interface": {
+          "id": "b1aae931-b51f-4a85-a723-865dd65f6132",
+          "interface_key": "rest_api:PATCH /workstreams/{workstream_id}",
+          "interface_kind": "rest_api",
+          "legacy_since": "2026-06-04T06:09:41.901035Z",
+          "replacement_ref": "/workplans/{workplan_id}",
+          "owner_component": "state-hub.api",
+          "status": "legacy",
+          "replacement_verified": true,
+          "manual_hold": false,
+          "hold_reason": null,
+          "notes": null,
+          "retired_at": null,
+          "created_at": "2026-06-04T06:09:41.901035Z",
+          "updated_at": "2026-06-04T06:09:41.901035Z"
+        },
+        "all_time": {
+          "calls": 571,
+          "tenant_count": 1,
+          "user_count": 1,
+          "component_count": 1,
+          "tenants": {
+            "unknown": 571
+          },
+          "users": {
+            "unknown": 571
+          },
+          "components": {
+            "unknown": 571
+          }
+        },
+        "window": {
+          "calls": 0,
+          "tenant_count": 0,
+          "user_count": 0,
+          "component_count": 0,
+          "tenants": {},
+          "users": {},
+          "components": {}
+        },
+        "last_seen_at": "2026-07-08T20:49:12.335710Z",
+        "retirement_candidate": true,
+        "retirement_reason": "no measured usage in review window"
+      },
+      {
+        "interface": {
+          "id": "4aea9591-970b-4918-ac4a-4da95a0a1a8c",
+          "interface_key": "rest_api:POST /decisions/ workstream_id",
+          "interface_kind": "rest_api",
+          "legacy_since": "2026-07-09T22:56:35.473130Z",
+          "replacement_ref": "POST /decisions/ with workplan_id",
+          "owner_component": "state-hub.api",
+          "status": "legacy",
+          "replacement_verified": true,
+          "manual_hold": false,
+          "hold_reason": null,
+          "notes": null,
+          "retired_at": null,
+          "created_at": "2026-07-09T22:56:35.473130Z",
+          "updated_at": "2026-07-09T22:56:35.473130Z"
+        },
+        "all_time": {
+          "calls": 3,
+          "tenant_count": 1,
+          "user_count": 1,
+          "component_count": 1,
+          "tenants": {
+            "unknown": 3
+          },
+          "users": {
+            "unknown": 3
+          },
+          "components": {
+            "unknown": 3
+          }
+        },
+        "window": {
+          "calls": 0,
+          "tenant_count": 0,
+          "user_count": 0,
+          "component_count": 0,
+          "tenants": {},
+          "users": {},
+          "components": {}
+        },
+        "last_seen_at": "2026-07-09T22:57:05.912456Z",
+        "retirement_candidate": true,
+        "retirement_reason": "no measured usage in review window"
+      },
+      {
+        "interface": {
+          "id": "4a70583c-1e41-4ec1-99a9-728856a7d79c",
+          "interface_key": "rest_api:POST /progress/ workstream_id",
+          "interface_kind": "rest_api",
+          "legacy_since": "2026-07-08T23:35:09.148333Z",
+          "replacement_ref": "POST /progress/ with workplan_id",
+          "owner_component": "state-hub.api",
+          "status": "legacy",
+          "replacement_verified": true,
+          "manual_hold": false,
+          "hold_reason": null,
+          "notes": null,
+          "retired_at": null,
+          "created_at": "2026-07-08T23:35:09.148333Z",
+          "updated_at": "2026-07-08T23:35:09.148333Z"
+        },
+        "all_time": {
+          "calls": 14,
+          "tenant_count": 1,
+          "user_count": 1,
+          "component_count": 1,
+          "tenants": {
+            "unknown": 14
+          },
+          "users": {
+            "unknown": 14
+          },
+          "components": {
+            "unknown": 14
+          }
+        },
+        "window": {
+          "calls": 0,
+          "tenant_count": 0,
+          "user_count": 0,
+          "component_count": 0,
+          "tenants": {},
+          "users": {},
+          "components": {}
+        },
+        "last_seen_at": "2026-07-10T08:34:42.959724Z",
+        "retirement_candidate": true,
+        "retirement_reason": "no measured usage in review window"
+      },
+      {
+        "interface": {
+          "id": "6df4e443-7bf1-461a-923b-a6eb52fe7b07",
+          "interface_key": "rest_api:POST /tasks/ workstream_id",
+          "interface_kind": "rest_api",
+          "legacy_since": "2026-07-08T22:38:29.405720Z",
+          "replacement_ref": "POST /tasks/ with workplan_id",
+          "owner_component": "state-hub.api",
+          "status": "legacy",
+          "replacement_verified": true,
+          "manual_hold": false,
+          "hold_reason": null,
+          "notes": null,
+          "retired_at": null,
+          "created_at": "2026-07-08T22:38:29.405720Z",
+          "updated_at": "2026-07-08T22:38:29.405720Z"
+        },
+        "all_time": {
+          "calls": 5,
+          "tenant_count": 1,
+          "user_count": 1,
+          "component_count": 1,
+          "tenants": {
+            "unknown": 5
+          },
+          "users": {
+            "unknown": 5
+          },
+          "components": {
+            "state-hub.fix-consistency": 5
+          }
+        },
+        "window": {
+          "calls": 0,
+          "tenant_count": 0,
+          "user_count": 0,
+          "component_count": 0,
+          "tenants": {},
+          "users": {},
+          "components": {}
+        },
+        "last_seen_at": "2026-07-08T22:38:29.976918Z",
+        "retirement_candidate": true,
+        "retirement_reason": "no measured usage in review window"
+      },
+      {
+        "interface": {
+          "id": "ed6451c9-d2cc-4486-9afe-d3852782cabc",
+          "interface_key": "rest_api:POST /workstreams/",
+          "interface_kind": "rest_api",
+          "legacy_since": "2026-06-04T07:40:24.168535Z",
+          "replacement_ref": "/workplans/",
+          "owner_component": "state-hub.api",
+          "status": "legacy",
+          "replacement_verified": true,
+          "manual_hold": false,
+          "hold_reason": null,
+          "notes": null,
+          "retired_at": null,
+          "created_at": "2026-06-04T07:40:24.168535Z",
+          "updated_at": "2026-06-04T07:40:24.168535Z"
+        },
+        "all_time": {
+          "calls": 824,
+          "tenant_count": 1,
+          "user_count": 1,
+          "component_count": 1,
+          "tenants": {
+            "unknown": 824
+          },
+          "users": {
+            "unknown": 824
+          },
+          "components": {
+            "unknown": 824
+          }
+        },
+        "window": {
+          "calls": 0,
+          "tenant_count": 0,
+          "user_count": 0,
+          "component_count": 0,
+          "tenants": {},
+          "users": {},
+          "components": {}
+        },
+        "last_seen_at": "2026-07-08T20:38:05.903144Z",
+        "retirement_candidate": true,
+        "retirement_reason": "no measured usage in review window"
+      },
+      {
+        "interface": {
+          "id": "281fd706-b192-4194-8055-2d8733c115f9",
+          "interface_key": "rest_api:POST /workstreams/{workstream_id}/dependencies/",
+          "interface_kind": "rest_api",
+          "legacy_since": "2026-06-04T22:57:37.149207Z",
+          "replacement_ref": "/workplans/{workplan_id}/dependencies/",
+          "owner_component": "state-hub.api",
+          "status": "legacy",
+          "replacement_verified": true,
+          "manual_hold": false,
+          "hold_reason": null,
+          "notes": null,
+          "retired_at": null,
+          "created_at": "2026-06-04T22:57:37.149207Z",
+          "updated_at": "2026-06-04T22:57:37.149207Z"
+        },
+        "all_time": {
+          "calls": 4971,
+          "tenant_count": 1,
+          "user_count": 1,
+          "component_count": 1,
+          "tenants": {
+            "unknown": 4971
+          },
+          "users": {
+            "unknown": 4971
+          },
+          "components": {
+            "unknown": 4971
+          }
+        },
+        "window": {
+          "calls": 0,
+          "tenant_count": 0,
+          "user_count": 0,
+          "component_count": 0,
+          "tenants": {},
+          "users": {},
+          "components": {}
+        },
+        "last_seen_at": "2026-07-01T22:09:24.229011Z",
+        "retirement_candidate": true,
+        "retirement_reason": "no measured usage in review window"
+      }
+    ]
+  },
+  "hours": 8
+}
diff --git a/docs/evidence/legacy-meter-weekly-review-20260729.json b/docs/evidence/legacy-meter-weekly-review-20260729.json
new file mode 100644
index 0000000..c84f44e
--- /dev/null
+++ b/docs/evidence/legacy-meter-weekly-review-20260729.json
@@ -0,0 +1,1755 @@
+{
+  "captured_at": "2026-07-29T14:00:07.590408+00:00",
+  "api_base": "http://127.0.0.1:8000",
+  "workplan": "STATE-WP-0070",
+  "retired_interfaces": [],
+  "weekly_review": {
+    "generated_at": "2026-07-29T14:00:07.584163Z",
+    "window_start": "2026-07-29T06:00:07.528759Z",
+    "window_end": "2026-07-29T14:00:07.528759Z",
+    "cadence": "weekly",
+    "activity_core_handoff": {
+      "activity_id": "statehub-legacy-interface-review",
+      "cadence": "weekly",
+      "source_endpoint": "/legacy-meter/weekly-review",
+      "state_owner": "state-hub",
+      "scheduler_owner": "activity-core"
+    },
+    "interfaces": [
+      {
+        "interface": {
+          "id": "8051fb40-66c9-4dc4-a413-13e8573e04a3",
+          "interface_key": "event_subject:org.statehub.workstream.completed",
+          "interface_kind": "event_subject",
+          "legacy_since": "2026-06-04T06:09:42.198193Z",
+          "replacement_ref": "org.statehub.workplan.completed",
+          "owner_component": "state-hub.events",
+          "status": "retired",
+          "replacement_verified": true,
+          "manual_hold": false,
+          "hold_reason": null,
+          "notes": "Retired by STATE-WP-0069 closeout",
+          "retired_at": "2026-07-08T21:38:52.773601Z",
+          "created_at": "2026-06-04T06:09:42.198193Z",
+          "updated_at": "2026-07-08T21:38:52.761243Z"
+        },
+        "all_time": {
+          "calls": 255,
+          "tenant_count": 1,
+          "user_count": 1,
+          "component_count": 1,
+          "tenants": {
+            "unknown": 255
+          },
+          "users": {
+            "unknown": 255
+          },
+          "components": {
+            "state-hub.events": 255
+          }
+        },
+        "window": {
+          "calls": 0,
+          "tenant_count": 0,
+          "user_count": 0,
+          "component_count": 0,
+          "tenants": {},
+          "users": {},
+          "components": {}
+        },
+        "last_seen_at": "2026-07-08T20:49:12.839383Z",
+        "retirement_candidate": false,
+        "retirement_reason": "already retired"
+      },
+      {
+        "interface": {
+          "id": "63ed90e3-42b4-431a-94db-e1254a52f9e2",
+          "interface_key": "mcp:create_workstream",
+          "interface_kind": "mcp_tool",
+          "legacy_since": "2026-07-10T13:19:44.205900Z",
+          "replacement_ref": "create_workplan",
+          "owner_component": "state-hub.mcp",
+          "status": "legacy",
+          "replacement_verified": true,
+          "manual_hold": false,
+          "hold_reason": null,
+          "notes": "Registered by STATE-WP-0070 T03 \u2014 zero-window streak starts at registration",
+          "retired_at": null,
+          "created_at": "2026-07-10T13:19:44.205900Z",
+          "updated_at": "2026-07-10T13:19:44.205900Z"
+        },
+        "all_time": {
+          "calls": 2,
+          "tenant_count": 1,
+          "user_count": 1,
+          "component_count": 1,
+          "tenants": {
+            "unknown": 2
+          },
+          "users": {
+            "unknown": 2
+          },
+          "components": {
+            "state-hub.mcp": 2
+          }
+        },
+        "window": {
+          "calls": 0,
+          "tenant_count": 0,
+          "user_count": 0,
+          "component_count": 0,
+          "tenants": {},
+          "users": {},
+          "components": {}
+        },
+        "last_seen_at": "2026-07-10T13:20:43.378546Z",
+        "retirement_candidate": true,
+        "retirement_reason": "no measured usage in review window"
+      },
+      {
+        "interface": {
+          "id": "b6a5fe44-fb85-4ef7-a273-78d09da777af",
+          "interface_key": "mcp:list_workstreams",
+          "interface_kind": "mcp_tool",
+          "legacy_since": "2026-07-10T13:19:26.075491Z",
+          "replacement_ref": "list_workplans",
+          "owner_component": "state-hub.mcp",
+          "status": "legacy",
+          "replacement_verified": true,
+          "manual_hold": false,
+          "hold_reason": null,
+          "notes": null,
+          "retired_at": null,
+          "created_at": "2026-07-10T13:19:26.075491Z",
+          "updated_at": "2026-07-10T13:19:26.075491Z"
+        },
+        "all_time": {
+          "calls": 2,
+          "tenant_count": 1,
+          "user_count": 1,
+          "component_count": 1,
+          "tenants": {
+            "unknown": 2
+          },
+          "users": {
+            "unknown": 2
+          },
+          "components": {
+            "state-hub.mcp": 2
+          }
+        },
+        "window": {
+          "calls": 0,
+          "tenant_count": 0,
+          "user_count": 0,
+          "component_count": 0,
+          "tenants": {},
+          "users": {},
+          "components": {}
+        },
+        "last_seen_at": "2026-07-10T13:20:42.374940Z",
+        "retirement_candidate": true,
+        "retirement_reason": "no measured usage in review window"
+      },
+      {
+        "interface": {
+          "id": "53c3372b-307d-4d6a-8ea4-bc36cacdcaf2",
+          "interface_key": "mcp:update_workstream",
+          "interface_kind": "mcp_tool",
+          "legacy_since": "2026-07-10T13:19:44.255216Z",
+          "replacement_ref": "update_workplan",
+          "owner_component": "state-hub.mcp",
+          "status": "legacy",
+          "replacement_verified": true,
+          "manual_hold": false,
+          "hold_reason": null,
+          "notes": "Registered by STATE-WP-0070 T03 \u2014 zero-window streak starts at registration",
+          "retired_at": null,
+          "created_at": "2026-07-10T13:19:44.255216Z",
+          "updated_at": "2026-07-10T13:19:44.255216Z"
+        },
+        "all_time": {
+          "calls": 0,
+          "tenant_count": 0,
+          "user_count": 0,
+          "component_count": 0,
+          "tenants": {},
+          "users": {},
+          "components": {}
+        },
+        "window": {
+          "calls": 0,
+          "tenant_count": 0,
+          "user_count": 0,
+          "component_count": 0,
+          "tenants": {},
+          "users": {},
+          "components": {}
+        },
+        "last_seen_at": null,
+        "retirement_candidate": true,
+        "retirement_reason": "no measured usage in review window"
+      },
+      {
+        "interface": {
+          "id": "bed4d08a-3471-48f5-9f0e-f9d550383a26",
+          "interface_key": "mcp:update_workstream_status",
+          "interface_kind": "mcp_tool",
+          "legacy_since": "2026-07-10T13:19:44.303612Z",
+          "replacement_ref": "update_workplan_status",
+          "owner_component": "state-hub.mcp",
+          "status": "legacy",
+          "replacement_verified": true,
+          "manual_hold": false,
+          "hold_reason": null,
+          "notes": "Registered by STATE-WP-0070 T03 \u2014 zero-window streak starts at registration",
+          "retired_at": null,
+          "created_at": "2026-07-10T13:19:44.303612Z",
+          "updated_at": "2026-07-10T13:19:44.303612Z"
+        },
+        "all_time": {
+          "calls": 0,
+          "tenant_count": 0,
+          "user_count": 0,
+          "component_count": 0,
+          "tenants": {},
+          "users": {},
+          "components": {}
+        },
+        "window": {
+          "calls": 0,
+          "tenant_count": 0,
+          "user_count": 0,
+          "component_count": 0,
+          "tenants": {},
+          "users": {},
+          "components": {}
+        },
+        "last_seen_at": null,
+        "retirement_candidate": true,
+        "retirement_reason": "no measured usage in review window"
+      },
+      {
+        "interface": {
+          "id": "46900dc2-0893-405b-ba59-80f31fb6ebb1",
+          "interface_key": "state://workstreams/{topic_slug}",
+          "interface_kind": "mcp_tool",
+          "legacy_since": "2026-07-10T13:19:44.344493Z",
+          "replacement_ref": "state://workplans/{topic_slug}",
+          "owner_component": "state-hub.mcp",
+          "status": "legacy",
+          "replacement_verified": true,
+          "manual_hold": false,
+          "hold_reason": null,
+          "notes": "Registered by STATE-WP-0070 T03 \u2014 zero-window streak starts at registration",
+          "retired_at": null,
+          "created_at": "2026-07-10T13:19:44.344493Z",
+          "updated_at": "2026-07-10T13:19:44.344493Z"
+        },
+        "all_time": {
+          "calls": 1,
+          "tenant_count": 1,
+          "user_count": 1,
+          "component_count": 1,
+          "tenants": {
+            "unknown": 1
+          },
+          "users": {
+            "unknown": 1
+          },
+          "components": {
+            "state-hub.mcp": 1
+          }
+        },
+        "window": {
+          "calls": 0,
+          "tenant_count": 0,
+          "user_count": 0,
+          "component_count": 0,
+          "tenants": {},
+          "users": {},
+          "components": {}
+        },
+        "last_seen_at": "2026-07-10T13:20:34.491811Z",
+        "retirement_candidate": true,
+        "retirement_reason": "no measured usage in review window"
+      },
+      {
+        "interface": {
+          "id": "cd9342fd-27e7-4a46-a1be-d41499e106a3",
+          "interface_key": "rest_api:DELETE /workstreams/{workstream_id}",
+          "interface_kind": "rest_api",
+          "legacy_since": "2026-06-06T17:28:13.052813Z",
+          "replacement_ref": "/workplans/{workplan_id}",
+          "owner_component": "state-hub.api",
+          "status": "legacy",
+          "replacement_verified": true,
+          "manual_hold": false,
+          "hold_reason": null,
+          "notes": null,
+          "retired_at": null,
+          "created_at": "2026-06-06T17:28:13.052813Z",
+          "updated_at": "2026-06-06T17:28:13.052813Z"
+        },
+        "all_time": {
+          "calls": 1,
+          "tenant_count": 1,
+          "user_count": 1,
+          "component_count": 1,
+          "tenants": {
+            "unknown": 1
+          },
+          "users": {
+            "unknown": 1
+          },
+          "components": {
+            "unknown": 1
+          }
+        },
+        "window": {
+          "calls": 0,
+          "tenant_count": 0,
+          "user_count": 0,
+          "component_count": 0,
+          "tenants": {},
+          "users": {},
+          "components": {}
+        },
+        "last_seen_at": "2026-06-06T17:28:13.047529Z",
+        "retirement_candidate": true,
+        "retirement_reason": "no measured usage in review window"
+      },
+      {
+        "interface": {
+          "id": "a4e0948c-cd4a-461e-8ae2-7fd7b51d04a7",
+          "interface_key": "rest_api:GET /decisions/?workstream_id",
+          "interface_kind": "rest_api",
+          "legacy_since": "2026-07-09T23:07:53.093223Z",
+          "replacement_ref": "/decisions/?workplan_id=<workplan_id>",
+          "owner_component": "state-hub.api",
+          "status": "legacy",
+          "replacement_verified": true,
+          "manual_hold": false,
+          "hold_reason": null,
+          "notes": null,
+          "retired_at": null,
+          "created_at": "2026-07-09T23:07:53.093223Z",
+          "updated_at": "2026-07-09T23:07:53.093223Z"
+        },
+        "all_time": {
+          "calls": 1,
+          "tenant_count": 1,
+          "user_count": 1,
+          "component_count": 1,
+          "tenants": {
+            "unknown": 1
+          },
+          "users": {
+            "unknown": 1
+          },
+          "components": {
+            "unknown": 1
+          }
+        },
+        "window": {
+          "calls": 0,
+          "tenant_count": 0,
+          "user_count": 0,
+          "component_count": 0,
+          "tenants": {},
+          "users": {},
+          "components": {}
+        },
+        "last_seen_at": "2026-07-09T23:07:53.083299Z",
+        "retirement_candidate": true,
+        "retirement_reason": "no measured usage in review window"
+      },
+      {
+        "interface": {
+          "id": "70a9346e-e0ee-42ac-874f-f160580b54dd",
+          "interface_key": "rest_api:GET /progress/?workstream_id",
+          "interface_kind": "rest_api",
+          "legacy_since": "2026-07-13T22:04:03.911449Z",
+          "replacement_ref": "/progress/?workplan_id=<workplan_id>",
+          "owner_component": "state-hub.api",
+          "status": "legacy",
+          "replacement_verified": true,
+          "manual_hold": false,
+          "hold_reason": null,
+          "notes": null,
+          "retired_at": null,
+          "created_at": "2026-07-13T22:04:03.911449Z",
+          "updated_at": "2026-07-13T22:04:03.911449Z"
+        },
+        "all_time": {
+          "calls": 1,
+          "tenant_count": 1,
+          "user_count": 1,
+          "component_count": 1,
+          "tenants": {
+            "unknown": 1
+          },
+          "users": {
+            "unknown": 1
+          },
+          "components": {
+            "unknown": 1
+          }
+        },
+        "window": {
+          "calls": 0,
+          "tenant_count": 0,
+          "user_count": 0,
+          "component_count": 0,
+          "tenants": {},
+          "users": {},
+          "components": {}
+        },
+        "last_seen_at": "2026-07-13T22:04:03.904998Z",
+        "retirement_candidate": true,
+        "retirement_reason": "no measured usage in review window"
+      },
+      {
+        "interface": {
+          "id": "be3cdcf8-250b-4bf0-801f-02ffd5f57e00",
+          "interface_key": "rest_api:GET /tasks/?workstream_id",
+          "interface_kind": "rest_api",
+          "legacy_since": "2026-07-08T19:32:21.628513Z",
+          "replacement_ref": "/tasks/?workplan_id=<workplan_id>",
+          "owner_component": "state-hub.api",
+          "status": "legacy",
+          "replacement_verified": true,
+          "manual_hold": false,
+          "hold_reason": null,
+          "notes": null,
+          "retired_at": null,
+          "created_at": "2026-07-08T19:32:21.628513Z",
+          "updated_at": "2026-07-08T19:32:21.628513Z"
+        },
+        "all_time": {
+          "calls": 587,
+          "tenant_count": 1,
+          "user_count": 1,
+          "component_count": 1,
+          "tenants": {
+            "unknown": 587
+          },
+          "users": {
+            "unknown": 587
+          },
+          "components": {
+            "unknown": 587
+          }
+        },
+        "window": {
+          "calls": 0,
+          "tenant_count": 0,
+          "user_count": 0,
+          "component_count": 0,
+          "tenants": {},
+          "users": {},
+          "components": {}
+        },
+        "last_seen_at": "2026-07-22T13:21:12.171828Z",
+        "retirement_candidate": true,
+        "retirement_reason": "no measured usage in review window"
+      },
+      {
+        "interface": {
+          "id": "3e4a3d0b-08fa-45c3-91e2-4f514a914b97",
+          "interface_key": "rest_api:GET /workstreams/",
+          "interface_kind": "rest_api",
+          "legacy_since": "2026-06-04T00:26:14.533764Z",
+          "replacement_ref": "/workplans/",
+          "owner_component": "state-hub.api",
+          "status": "legacy",
+          "replacement_verified": true,
+          "manual_hold": false,
+          "hold_reason": null,
+          "notes": null,
+          "retired_at": null,
+          "created_at": "2026-06-04T00:26:14.533764Z",
+          "updated_at": "2026-06-04T00:26:14.533764Z"
+        },
+        "all_time": {
+          "calls": 144084,
+          "tenant_count": 1,
+          "user_count": 1,
+          "component_count": 1,
+          "tenants": {
+            "unknown": 144084
+          },
+          "users": {
+            "unknown": 144084
+          },
+          "components": {
+            "unknown": 144084
+          }
+        },
+        "window": {
+          "calls": 0,
+          "tenant_count": 0,
+          "user_count": 0,
+          "component_count": 0,
+          "tenants": {},
+          "users": {},
+          "components": {}
+        },
+        "last_seen_at": "2026-07-08T21:14:39.652776Z",
+        "retirement_candidate": true,
+        "retirement_reason": "no measured usage in review window"
+      },
+      {
+        "interface": {
+          "id": "e4c140ec-7479-46f9-b185-4b533f19d639",
+          "interface_key": "rest_api:GET /workstreams/workplan-index",
+          "interface_kind": "rest_api",
+          "legacy_since": "2026-06-04T05:20:58.321869Z",
+          "replacement_ref": "/workplans/index",
+          "owner_component": "state-hub.api",
+          "status": "legacy",
+          "replacement_verified": true,
+          "manual_hold": false,
+          "hold_reason": null,
+          "notes": null,
+          "retired_at": null,
+          "created_at": "2026-06-04T05:20:58.321869Z",
+          "updated_at": "2026-06-04T05:20:58.321869Z"
+        },
+        "all_time": {
+          "calls": 30,
+          "tenant_count": 1,
+          "user_count": 1,
+          "component_count": 1,
+          "tenants": {
+            "unknown": 30
+          },
+          "users": {
+            "unknown": 30
+          },
+          "components": {
+            "unknown": 30
+          }
+        },
+        "window": {
+          "calls": 0,
+          "tenant_count": 0,
+          "user_count": 0,
+          "component_count": 0,
+          "tenants": {},
+          "users": {},
+          "components": {}
+        },
+        "last_seen_at": "2026-07-03T05:20:34.534439Z",
+        "retirement_candidate": true,
+        "retirement_reason": "no measured usage in review window"
+      },
+      {
+        "interface": {
+          "id": "3a00b19e-e7db-4403-98aa-a77c9ab61ecc",
+          "interface_key": "rest_api:GET /workstreams/{workstream_id}",
+          "interface_kind": "rest_api",
+          "legacy_since": "2026-06-04T00:25:59.014966Z",
+          "replacement_ref": "/workplans/{workplan_id}",
+          "owner_component": "state-hub.api",
+          "status": "legacy",
+          "replacement_verified": true,
+          "manual_hold": false,
+          "hold_reason": null,
+          "notes": null,
+          "retired_at": null,
+          "created_at": "2026-06-04T00:25:59.014966Z",
+          "updated_at": "2026-06-04T00:25:59.014966Z"
+        },
+        "all_time": {
+          "calls": 511405,
+          "tenant_count": 1,
+          "user_count": 1,
+          "component_count": 1,
+          "tenants": {
+            "unknown": 511405
+          },
+          "users": {
+            "unknown": 511405
+          },
+          "components": {
+            "unknown": 511405
+          }
+        },
+        "window": {
+          "calls": 0,
+          "tenant_count": 0,
+          "user_count": 0,
+          "component_count": 0,
+          "tenants": {},
+          "users": {},
+          "components": {}
+        },
+        "last_seen_at": "2026-07-08T21:14:20.781103Z",
+        "retirement_candidate": true,
+        "retirement_reason": "no measured usage in review window"
+      },
+      {
+        "interface": {
+          "id": "69e1a255-a8b9-4101-8a68-b1bed23abfda",
+          "interface_key": "rest_api:GET /workstreams/{workstream_id}/dependencies/",
+          "interface_kind": "rest_api",
+          "legacy_since": "2026-06-04T00:25:59.291135Z",
+          "replacement_ref": "/workplans/{workplan_id}/dependencies/",
+          "owner_component": "state-hub.api",
+          "status": "legacy",
+          "replacement_verified": true,
+          "manual_hold": false,
+          "hold_reason": null,
+          "notes": null,
+          "retired_at": null,
+          "created_at": "2026-06-04T00:25:59.291135Z",
+          "updated_at": "2026-06-04T00:25:59.291135Z"
+        },
+        "all_time": {
+          "calls": 255865,
+          "tenant_count": 1,
+          "user_count": 1,
+          "component_count": 1,
+          "tenants": {
+            "unknown": 255865
+          },
+          "users": {
+            "unknown": 255865
+          },
+          "components": {
+            "unknown": 255865
+          }
+        },
+        "window": {
+          "calls": 0,
+          "tenant_count": 0,
+          "user_count": 0,
+          "component_count": 0,
+          "tenants": {},
+          "users": {},
+          "components": {}
+        },
+        "last_seen_at": "2026-07-08T21:14:12.747005Z",
+        "retirement_candidate": true,
+        "retirement_reason": "no measured usage in review window"
+      },
+      {
+        "interface": {
+          "id": "b1aae931-b51f-4a85-a723-865dd65f6132",
+          "interface_key": "rest_api:PATCH /workstreams/{workstream_id}",
+          "interface_kind": "rest_api",
+          "legacy_since": "2026-06-04T06:09:41.901035Z",
+          "replacement_ref": "/workplans/{workplan_id}",
+          "owner_component": "state-hub.api",
+          "status": "legacy",
+          "replacement_verified": true,
+          "manual_hold": false,
+          "hold_reason": null,
+          "notes": null,
+          "retired_at": null,
+          "created_at": "2026-06-04T06:09:41.901035Z",
+          "updated_at": "2026-06-04T06:09:41.901035Z"
+        },
+        "all_time": {
+          "calls": 571,
+          "tenant_count": 1,
+          "user_count": 1,
+          "component_count": 1,
+          "tenants": {
+            "unknown": 571
+          },
+          "users": {
+            "unknown": 571
+          },
+          "components": {
+            "unknown": 571
+          }
+        },
+        "window": {
+          "calls": 0,
+          "tenant_count": 0,
+          "user_count": 0,
+          "component_count": 0,
+          "tenants": {},
+          "users": {},
+          "components": {}
+        },
+        "last_seen_at": "2026-07-08T20:49:12.335710Z",
+        "retirement_candidate": true,
+        "retirement_reason": "no measured usage in review window"
+      },
+      {
+        "interface": {
+          "id": "4aea9591-970b-4918-ac4a-4da95a0a1a8c",
+          "interface_key": "rest_api:POST /decisions/ workstream_id",
+          "interface_kind": "rest_api",
+          "legacy_since": "2026-07-09T22:56:35.473130Z",
+          "replacement_ref": "POST /decisions/ with workplan_id",
+          "owner_component": "state-hub.api",
+          "status": "legacy",
+          "replacement_verified": true,
+          "manual_hold": false,
+          "hold_reason": null,
+          "notes": null,
+          "retired_at": null,
+          "created_at": "2026-07-09T22:56:35.473130Z",
+          "updated_at": "2026-07-09T22:56:35.473130Z"
+        },
+        "all_time": {
+          "calls": 3,
+          "tenant_count": 1,
+          "user_count": 1,
+          "component_count": 1,
+          "tenants": {
+            "unknown": 3
+          },
+          "users": {
+            "unknown": 3
+          },
+          "components": {
+            "unknown": 3
+          }
+        },
+        "window": {
+          "calls": 0,
+          "tenant_count": 0,
+          "user_count": 0,
+          "component_count": 0,
+          "tenants": {},
+          "users": {},
+          "components": {}
+        },
+        "last_seen_at": "2026-07-09T22:57:05.912456Z",
+        "retirement_candidate": true,
+        "retirement_reason": "no measured usage in review window"
+      },
+      {
+        "interface": {
+          "id": "4a70583c-1e41-4ec1-99a9-728856a7d79c",
+          "interface_key": "rest_api:POST /progress/ workstream_id",
+          "interface_kind": "rest_api",
+          "legacy_since": "2026-07-08T23:35:09.148333Z",
+          "replacement_ref": "POST /progress/ with workplan_id",
+          "owner_component": "state-hub.api",
+          "status": "legacy",
+          "replacement_verified": true,
+          "manual_hold": false,
+          "hold_reason": null,
+          "notes": null,
+          "retired_at": null,
+          "created_at": "2026-07-08T23:35:09.148333Z",
+          "updated_at": "2026-07-08T23:35:09.148333Z"
+        },
+        "all_time": {
+          "calls": 14,
+          "tenant_count": 1,
+          "user_count": 1,
+          "component_count": 1,
+          "tenants": {
+            "unknown": 14
+          },
+          "users": {
+            "unknown": 14
+          },
+          "components": {
+            "unknown": 14
+          }
+        },
+        "window": {
+          "calls": 0,
+          "tenant_count": 0,
+          "user_count": 0,
+          "component_count": 0,
+          "tenants": {},
+          "users": {},
+          "components": {}
+        },
+        "last_seen_at": "2026-07-10T08:34:42.959724Z",
+        "retirement_candidate": true,
+        "retirement_reason": "no measured usage in review window"
+      },
+      {
+        "interface": {
+          "id": "6df4e443-7bf1-461a-923b-a6eb52fe7b07",
+          "interface_key": "rest_api:POST /tasks/ workstream_id",
+          "interface_kind": "rest_api",
+          "legacy_since": "2026-07-08T22:38:29.405720Z",
+          "replacement_ref": "POST /tasks/ with workplan_id",
+          "owner_component": "state-hub.api",
+          "status": "legacy",
+          "replacement_verified": true,
+          "manual_hold": false,
+          "hold_reason": null,
+          "notes": null,
+          "retired_at": null,
+          "created_at": "2026-07-08T22:38:29.405720Z",
+          "updated_at": "2026-07-08T22:38:29.405720Z"
+        },
+        "all_time": {
+          "calls": 5,
+          "tenant_count": 1,
+          "user_count": 1,
+          "component_count": 1,
+          "tenants": {
+            "unknown": 5
+          },
+          "users": {
+            "unknown": 5
+          },
+          "components": {
+            "state-hub.fix-consistency": 5
+          }
+        },
+        "window": {
+          "calls": 0,
+          "tenant_count": 0,
+          "user_count": 0,
+          "component_count": 0,
+          "tenants": {},
+          "users": {},
+          "components": {}
+        },
+        "last_seen_at": "2026-07-08T22:38:29.976918Z",
+        "retirement_candidate": true,
+        "retirement_reason": "no measured usage in review window"
+      },
+      {
+        "interface": {
+          "id": "ed6451c9-d2cc-4486-9afe-d3852782cabc",
+          "interface_key": "rest_api:POST /workstreams/",
+          "interface_kind": "rest_api",
+          "legacy_since": "2026-06-04T07:40:24.168535Z",
+          "replacement_ref": "/workplans/",
+          "owner_component": "state-hub.api",
+          "status": "legacy",
+          "replacement_verified": true,
+          "manual_hold": false,
+          "hold_reason": null,
+          "notes": null,
+          "retired_at": null,
+          "created_at": "2026-06-04T07:40:24.168535Z",
+          "updated_at": "2026-06-04T07:40:24.168535Z"
+        },
+        "all_time": {
+          "calls": 824,
+          "tenant_count": 1,
+          "user_count": 1,
+          "component_count": 1,
+          "tenants": {
+            "unknown": 824
+          },
+          "users": {
+            "unknown": 824
+          },
+          "components": {
+            "unknown": 824
+          }
+        },
+        "window": {
+          "calls": 0,
+          "tenant_count": 0,
+          "user_count": 0,
+          "component_count": 0,
+          "tenants": {},
+          "users": {},
+          "components": {}
+        },
+        "last_seen_at": "2026-07-08T20:38:05.903144Z",
+        "retirement_candidate": true,
+        "retirement_reason": "no measured usage in review window"
+      },
+      {
+        "interface": {
+          "id": "281fd706-b192-4194-8055-2d8733c115f9",
+          "interface_key": "rest_api:POST /workstreams/{workstream_id}/dependencies/",
+          "interface_kind": "rest_api",
+          "legacy_since": "2026-06-04T22:57:37.149207Z",
+          "replacement_ref": "/workplans/{workplan_id}/dependencies/",
+          "owner_component": "state-hub.api",
+          "status": "legacy",
+          "replacement_verified": true,
+          "manual_hold": false,
+          "hold_reason": null,
+          "notes": null,
+          "retired_at": null,
+          "created_at": "2026-06-04T22:57:37.149207Z",
+          "updated_at": "2026-06-04T22:57:37.149207Z"
+        },
+        "all_time": {
+          "calls": 4971,
+          "tenant_count": 1,
+          "user_count": 1,
+          "component_count": 1,
+          "tenants": {
+            "unknown": 4971
+          },
+          "users": {
+            "unknown": 4971
+          },
+          "components": {
+            "unknown": 4971
+          }
+        },
+        "window": {
+          "calls": 0,
+          "tenant_count": 0,
+          "user_count": 0,
+          "component_count": 0,
+          "tenants": {},
+          "users": {},
+          "components": {}
+        },
+        "last_seen_at": "2026-07-01T22:09:24.229011Z",
+        "retirement_candidate": true,
+        "retirement_reason": "no measured usage in review window"
+      }
+    ],
+    "retirement_candidates": [
+      {
+        "interface": {
+          "id": "63ed90e3-42b4-431a-94db-e1254a52f9e2",
+          "interface_key": "mcp:create_workstream",
+          "interface_kind": "mcp_tool",
+          "legacy_since": "2026-07-10T13:19:44.205900Z",
+          "replacement_ref": "create_workplan",
+          "owner_component": "state-hub.mcp",
+          "status": "legacy",
+          "replacement_verified": true,
+          "manual_hold": false,
+          "hold_reason": null,
+          "notes": "Registered by STATE-WP-0070 T03 \u2014 zero-window streak starts at registration",
+          "retired_at": null,
+          "created_at": "2026-07-10T13:19:44.205900Z",
+          "updated_at": "2026-07-10T13:19:44.205900Z"
+        },
+        "all_time": {
+          "calls": 2,
+          "tenant_count": 1,
+          "user_count": 1,
+          "component_count": 1,
+          "tenants": {
+            "unknown": 2
+          },
+          "users": {
+            "unknown": 2
+          },
+          "components": {
+            "state-hub.mcp": 2
+          }
+        },
+        "window": {
+          "calls": 0,
+          "tenant_count": 0,
+          "user_count": 0,
+          "component_count": 0,
+          "tenants": {},
+          "users": {},
+          "components": {}
+        },
+        "last_seen_at": "2026-07-10T13:20:43.378546Z",
+        "retirement_candidate": true,
+        "retirement_reason": "no measured usage in review window"
+      },
+      {
+        "interface": {
+          "id": "b6a5fe44-fb85-4ef7-a273-78d09da777af",
+          "interface_key": "mcp:list_workstreams",
+          "interface_kind": "mcp_tool",
+          "legacy_since": "2026-07-10T13:19:26.075491Z",
+          "replacement_ref": "list_workplans",
+          "owner_component": "state-hub.mcp",
+          "status": "legacy",
+          "replacement_verified": true,
+          "manual_hold": false,
+          "hold_reason": null,
+          "notes": null,
+          "retired_at": null,
+          "created_at": "2026-07-10T13:19:26.075491Z",
+          "updated_at": "2026-07-10T13:19:26.075491Z"
+        },
+        "all_time": {
+          "calls": 2,
+          "tenant_count": 1,
+          "user_count": 1,
+          "component_count": 1,
+          "tenants": {
+            "unknown": 2
+          },
+          "users": {
+            "unknown": 2
+          },
+          "components": {
+            "state-hub.mcp": 2
+          }
+        },
+        "window": {
+          "calls": 0,
+          "tenant_count": 0,
+          "user_count": 0,
+          "component_count": 0,
+          "tenants": {},
+          "users": {},
+          "components": {}
+        },
+        "last_seen_at": "2026-07-10T13:20:42.374940Z",
+        "retirement_candidate": true,
+        "retirement_reason": "no measured usage in review window"
+      },
+      {
+        "interface": {
+          "id": "53c3372b-307d-4d6a-8ea4-bc36cacdcaf2",
+          "interface_key": "mcp:update_workstream",
+          "interface_kind": "mcp_tool",
+          "legacy_since": "2026-07-10T13:19:44.255216Z",
+          "replacement_ref": "update_workplan",
+          "owner_component": "state-hub.mcp",
+          "status": "legacy",
+          "replacement_verified": true,
+          "manual_hold": false,
+          "hold_reason": null,
+          "notes": "Registered by STATE-WP-0070 T03 \u2014 zero-window streak starts at registration",
+          "retired_at": null,
+          "created_at": "2026-07-10T13:19:44.255216Z",
+          "updated_at": "2026-07-10T13:19:44.255216Z"
+        },
+        "all_time": {
+          "calls": 0,
+          "tenant_count": 0,
+          "user_count": 0,
+          "component_count": 0,
+          "tenants": {},
+          "users": {},
+          "components": {}
+        },
+        "window": {
+          "calls": 0,
+          "tenant_count": 0,
+          "user_count": 0,
+          "component_count": 0,
+          "tenants": {},
+          "users": {},
+          "components": {}
+        },
+        "last_seen_at": null,
+        "retirement_candidate": true,
+        "retirement_reason": "no measured usage in review window"
+      },
+      {
+        "interface": {
+          "id": "bed4d08a-3471-48f5-9f0e-f9d550383a26",
+          "interface_key": "mcp:update_workstream_status",
+          "interface_kind": "mcp_tool",
+          "legacy_since": "2026-07-10T13:19:44.303612Z",
+          "replacement_ref": "update_workplan_status",
+          "owner_component": "state-hub.mcp",
+          "status": "legacy",
+          "replacement_verified": true,
+          "manual_hold": false,
+          "hold_reason": null,
+          "notes": "Registered by STATE-WP-0070 T03 \u2014 zero-window streak starts at registration",
+          "retired_at": null,
+          "created_at": "2026-07-10T13:19:44.303612Z",
+          "updated_at": "2026-07-10T13:19:44.303612Z"
+        },
+        "all_time": {
+          "calls": 0,
+          "tenant_count": 0,
+          "user_count": 0,
+          "component_count": 0,
+          "tenants": {},
+          "users": {},
+          "components": {}
+        },
+        "window": {
+          "calls": 0,
+          "tenant_count": 0,
+          "user_count": 0,
+          "component_count": 0,
+          "tenants": {},
+          "users": {},
+          "components": {}
+        },
+        "last_seen_at": null,
+        "retirement_candidate": true,
+        "retirement_reason": "no measured usage in review window"
+      },
+      {
+        "interface": {
+          "id": "46900dc2-0893-405b-ba59-80f31fb6ebb1",
+          "interface_key": "state://workstreams/{topic_slug}",
+          "interface_kind": "mcp_tool",
+          "legacy_since": "2026-07-10T13:19:44.344493Z",
+          "replacement_ref": "state://workplans/{topic_slug}",
+          "owner_component": "state-hub.mcp",
+          "status": "legacy",
+          "replacement_verified": true,
+          "manual_hold": false,
+          "hold_reason": null,
+          "notes": "Registered by STATE-WP-0070 T03 \u2014 zero-window streak starts at registration",
+          "retired_at": null,
+          "created_at": "2026-07-10T13:19:44.344493Z",
+          "updated_at": "2026-07-10T13:19:44.344493Z"
+        },
+        "all_time": {
+          "calls": 1,
+          "tenant_count": 1,
+          "user_count": 1,
+          "component_count": 1,
+          "tenants": {
+            "unknown": 1
+          },
+          "users": {
+            "unknown": 1
+          },
+          "components": {
+            "state-hub.mcp": 1
+          }
+        },
+        "window": {
+          "calls": 0,
+          "tenant_count": 0,
+          "user_count": 0,
+          "component_count": 0,
+          "tenants": {},
+          "users": {},
+          "components": {}
+        },
+        "last_seen_at": "2026-07-10T13:20:34.491811Z",
+        "retirement_candidate": true,
+        "retirement_reason": "no measured usage in review window"
+      },
+      {
+        "interface": {
+          "id": "cd9342fd-27e7-4a46-a1be-d41499e106a3",
+          "interface_key": "rest_api:DELETE /workstreams/{workstream_id}",
+          "interface_kind": "rest_api",
+          "legacy_since": "2026-06-06T17:28:13.052813Z",
+          "replacement_ref": "/workplans/{workplan_id}",
+          "owner_component": "state-hub.api",
+          "status": "legacy",
+          "replacement_verified": true,
+          "manual_hold": false,
+          "hold_reason": null,
+          "notes": null,
+          "retired_at": null,
+          "created_at": "2026-06-06T17:28:13.052813Z",
+          "updated_at": "2026-06-06T17:28:13.052813Z"
+        },
+        "all_time": {
+          "calls": 1,
+          "tenant_count": 1,
+          "user_count": 1,
+          "component_count": 1,
+          "tenants": {
+            "unknown": 1
+          },
+          "users": {
+            "unknown": 1
+          },
+          "components": {
+            "unknown": 1
+          }
+        },
+        "window": {
+          "calls": 0,
+          "tenant_count": 0,
+          "user_count": 0,
+          "component_count": 0,
+          "tenants": {},
+          "users": {},
+          "components": {}
+        },
+        "last_seen_at": "2026-06-06T17:28:13.047529Z",
+        "retirement_candidate": true,
+        "retirement_reason": "no measured usage in review window"
+      },
+      {
+        "interface": {
+          "id": "a4e0948c-cd4a-461e-8ae2-7fd7b51d04a7",
+          "interface_key": "rest_api:GET /decisions/?workstream_id",
+          "interface_kind": "rest_api",
+          "legacy_since": "2026-07-09T23:07:53.093223Z",
+          "replacement_ref": "/decisions/?workplan_id=<workplan_id>",
+          "owner_component": "state-hub.api",
+          "status": "legacy",
+          "replacement_verified": true,
+          "manual_hold": false,
+          "hold_reason": null,
+          "notes": null,
+          "retired_at": null,
+          "created_at": "2026-07-09T23:07:53.093223Z",
+          "updated_at": "2026-07-09T23:07:53.093223Z"
+        },
+        "all_time": {
+          "calls": 1,
+          "tenant_count": 1,
+          "user_count": 1,
+          "component_count": 1,
+          "tenants": {
+            "unknown": 1
+          },
+          "users": {
+            "unknown": 1
+          },
+          "components": {
+            "unknown": 1
+          }
+        },
+        "window": {
+          "calls": 0,
+          "tenant_count": 0,
+          "user_count": 0,
+          "component_count": 0,
+          "tenants": {},
+          "users": {},
+          "components": {}
+        },
+        "last_seen_at": "2026-07-09T23:07:53.083299Z",
+        "retirement_candidate": true,
+        "retirement_reason": "no measured usage in review window"
+      },
+      {
+        "interface": {
+          "id": "70a9346e-e0ee-42ac-874f-f160580b54dd",
+          "interface_key": "rest_api:GET /progress/?workstream_id",
+          "interface_kind": "rest_api",
+          "legacy_since": "2026-07-13T22:04:03.911449Z",
+          "replacement_ref": "/progress/?workplan_id=<workplan_id>",
+          "owner_component": "state-hub.api",
+          "status": "legacy",
+          "replacement_verified": true,
+          "manual_hold": false,
+          "hold_reason": null,
+          "notes": null,
+          "retired_at": null,
+          "created_at": "2026-07-13T22:04:03.911449Z",
+          "updated_at": "2026-07-13T22:04:03.911449Z"
+        },
+        "all_time": {
+          "calls": 1,
+          "tenant_count": 1,
+          "user_count": 1,
+          "component_count": 1,
+          "tenants": {
+            "unknown": 1
+          },
+          "users": {
+            "unknown": 1
+          },
+          "components": {
+            "unknown": 1
+          }
+        },
+        "window": {
+          "calls": 0,
+          "tenant_count": 0,
+          "user_count": 0,
+          "component_count": 0,
+          "tenants": {},
+          "users": {},
+          "components": {}
+        },
+        "last_seen_at": "2026-07-13T22:04:03.904998Z",
+        "retirement_candidate": true,
+        "retirement_reason": "no measured usage in review window"
+      },
+      {
+        "interface": {
+          "id": "be3cdcf8-250b-4bf0-801f-02ffd5f57e00",
+          "interface_key": "rest_api:GET /tasks/?workstream_id",
+          "interface_kind": "rest_api",
+          "legacy_since": "2026-07-08T19:32:21.628513Z",
+          "replacement_ref": "/tasks/?workplan_id=<workplan_id>",
+          "owner_component": "state-hub.api",
+          "status": "legacy",
+          "replacement_verified": true,
+          "manual_hold": false,
+          "hold_reason": null,
+          "notes": null,
+          "retired_at": null,
+          "created_at": "2026-07-08T19:32:21.628513Z",
+          "updated_at": "2026-07-08T19:32:21.628513Z"
+        },
+        "all_time": {
+          "calls": 587,
+          "tenant_count": 1,
+          "user_count": 1,
+          "component_count": 1,
+          "tenants": {
+            "unknown": 587
+          },
+          "users": {
+            "unknown": 587
+          },
+          "components": {
+            "unknown": 587
+          }
+        },
+        "window": {
+          "calls": 0,
+          "tenant_count": 0,
+          "user_count": 0,
+          "component_count": 0,
+          "tenants": {},
+          "users": {},
+          "components": {}
+        },
+        "last_seen_at": "2026-07-22T13:21:12.171828Z",
+        "retirement_candidate": true,
+        "retirement_reason": "no measured usage in review window"
+      },
+      {
+        "interface": {
+          "id": "3e4a3d0b-08fa-45c3-91e2-4f514a914b97",
+          "interface_key": "rest_api:GET /workstreams/",
+          "interface_kind": "rest_api",
+          "legacy_since": "2026-06-04T00:26:14.533764Z",
+          "replacement_ref": "/workplans/",
+          "owner_component": "state-hub.api",
+          "status": "legacy",
+          "replacement_verified": true,
+          "manual_hold": false,
+          "hold_reason": null,
+          "notes": null,
+          "retired_at": null,
+          "created_at": "2026-06-04T00:26:14.533764Z",
+          "updated_at": "2026-06-04T00:26:14.533764Z"
+        },
+        "all_time": {
+          "calls": 144084,
+          "tenant_count": 1,
+          "user_count": 1,
+          "component_count": 1,
+          "tenants": {
+            "unknown": 144084
+          },
+          "users": {
+            "unknown": 144084
+          },
+          "components": {
+            "unknown": 144084
+          }
+        },
+        "window": {
+          "calls": 0,
+          "tenant_count": 0,
+          "user_count": 0,
+          "component_count": 0,
+          "tenants": {},
+          "users": {},
+          "components": {}
+        },
+        "last_seen_at": "2026-07-08T21:14:39.652776Z",
+        "retirement_candidate": true,
+        "retirement_reason": "no measured usage in review window"
+      },
+      {
+        "interface": {
+          "id": "e4c140ec-7479-46f9-b185-4b533f19d639",
+          "interface_key": "rest_api:GET /workstreams/workplan-index",
+          "interface_kind": "rest_api",
+          "legacy_since": "2026-06-04T05:20:58.321869Z",
+          "replacement_ref": "/workplans/index",
+          "owner_component": "state-hub.api",
+          "status": "legacy",
+          "replacement_verified": true,
+          "manual_hold": false,
+          "hold_reason": null,
+          "notes": null,
+          "retired_at": null,
+          "created_at": "2026-06-04T05:20:58.321869Z",
+          "updated_at": "2026-06-04T05:20:58.321869Z"
+        },
+        "all_time": {
+          "calls": 30,
+          "tenant_count": 1,
+          "user_count": 1,
+          "component_count": 1,
+          "tenants": {
+            "unknown": 30
+          },
+          "users": {
+            "unknown": 30
+          },
+          "components": {
+            "unknown": 30
+          }
+        },
+        "window": {
+          "calls": 0,
+          "tenant_count": 0,
+          "user_count": 0,
+          "component_count": 0,
+          "tenants": {},
+          "users": {},
+          "components": {}
+        },
+        "last_seen_at": "2026-07-03T05:20:34.534439Z",
+        "retirement_candidate": true,
+        "retirement_reason": "no measured usage in review window"
+      },
+      {
+        "interface": {
+          "id": "3a00b19e-e7db-4403-98aa-a77c9ab61ecc",
+          "interface_key": "rest_api:GET /workstreams/{workstream_id}",
+          "interface_kind": "rest_api",
+          "legacy_since": "2026-06-04T00:25:59.014966Z",
+          "replacement_ref": "/workplans/{workplan_id}",
+          "owner_component": "state-hub.api",
+          "status": "legacy",
+          "replacement_verified": true,
+          "manual_hold": false,
+          "hold_reason": null,
+          "notes": null,
+          "retired_at": null,
+          "created_at": "2026-06-04T00:25:59.014966Z",
+          "updated_at": "2026-06-04T00:25:59.014966Z"
+        },
+        "all_time": {
+          "calls": 511405,
+          "tenant_count": 1,
+          "user_count": 1,
+          "component_count": 1,
+          "tenants": {
+            "unknown": 511405
+          },
+          "users": {
+            "unknown": 511405
+          },
+          "components": {
+            "unknown": 511405
+          }
+        },
+        "window": {
+          "calls": 0,
+          "tenant_count": 0,
+          "user_count": 0,
+          "component_count": 0,
+          "tenants": {},
+          "users": {},
+          "components": {}
+        },
+        "last_seen_at": "2026-07-08T21:14:20.781103Z",
+        "retirement_candidate": true,
+        "retirement_reason": "no measured usage in review window"
+      },
+      {
+        "interface": {
+          "id": "69e1a255-a8b9-4101-8a68-b1bed23abfda",
+          "interface_key": "rest_api:GET /workstreams/{workstream_id}/dependencies/",
+          "interface_kind": "rest_api",
+          "legacy_since": "2026-06-04T00:25:59.291135Z",
+          "replacement_ref": "/workplans/{workplan_id}/dependencies/",
+          "owner_component": "state-hub.api",
+          "status": "legacy",
+          "replacement_verified": true,
+          "manual_hold": false,
+          "hold_reason": null,
+          "notes": null,
+          "retired_at": null,
+          "created_at": "2026-06-04T00:25:59.291135Z",
+          "updated_at": "2026-06-04T00:25:59.291135Z"
+        },
+        "all_time": {
+          "calls": 255865,
+          "tenant_count": 1,
+          "user_count": 1,
+          "component_count": 1,
+          "tenants": {
+            "unknown": 255865
+          },
+          "users": {
+            "unknown": 255865
+          },
+          "components": {
+            "unknown": 255865
+          }
+        },
+        "window": {
+          "calls": 0,
+          "tenant_count": 0,
+          "user_count": 0,
+          "component_count": 0,
+          "tenants": {},
+          "users": {},
+          "components": {}
+        },
+        "last_seen_at": "2026-07-08T21:14:12.747005Z",
+        "retirement_candidate": true,
+        "retirement_reason": "no measured usage in review window"
+      },
+      {
+        "interface": {
+          "id": "b1aae931-b51f-4a85-a723-865dd65f6132",
+          "interface_key": "rest_api:PATCH /workstreams/{workstream_id}",
+          "interface_kind": "rest_api",
+          "legacy_since": "2026-06-04T06:09:41.901035Z",
+          "replacement_ref": "/workplans/{workplan_id}",
+          "owner_component": "state-hub.api",
+          "status": "legacy",
+          "replacement_verified": true,
+          "manual_hold": false,
+          "hold_reason": null,
+          "notes": null,
+          "retired_at": null,
+          "created_at": "2026-06-04T06:09:41.901035Z",
+          "updated_at": "2026-06-04T06:09:41.901035Z"
+        },
+        "all_time": {
+          "calls": 571,
+          "tenant_count": 1,
+          "user_count": 1,
+          "component_count": 1,
+          "tenants": {
+            "unknown": 571
+          },
+          "users": {
+            "unknown": 571
+          },
+          "components": {
+            "unknown": 571
+          }
+        },
+        "window": {
+          "calls": 0,
+          "tenant_count": 0,
+          "user_count": 0,
+          "component_count": 0,
+          "tenants": {},
+          "users": {},
+          "components": {}
+        },
+        "last_seen_at": "2026-07-08T20:49:12.335710Z",
+        "retirement_candidate": true,
+        "retirement_reason": "no measured usage in review window"
+      },
+      {
+        "interface": {
+          "id": "4aea9591-970b-4918-ac4a-4da95a0a1a8c",
+          "interface_key": "rest_api:POST /decisions/ workstream_id",
+          "interface_kind": "rest_api",
+          "legacy_since": "2026-07-09T22:56:35.473130Z",
+          "replacement_ref": "POST /decisions/ with workplan_id",
+          "owner_component": "state-hub.api",
+          "status": "legacy",
+          "replacement_verified": true,
+          "manual_hold": false,
+          "hold_reason": null,
+          "notes": null,
+          "retired_at": null,
+          "created_at": "2026-07-09T22:56:35.473130Z",
+          "updated_at": "2026-07-09T22:56:35.473130Z"
+        },
+        "all_time": {
+          "calls": 3,
+          "tenant_count": 1,
+          "user_count": 1,
+          "component_count": 1,
+          "tenants": {
+            "unknown": 3
+          },
+          "users": {
+            "unknown": 3
+          },
+          "components": {
+            "unknown": 3
+          }
+        },
+        "window": {
+          "calls": 0,
+          "tenant_count": 0,
+          "user_count": 0,
+          "component_count": 0,
+          "tenants": {},
+          "users": {},
+          "components": {}
+        },
+        "last_seen_at": "2026-07-09T22:57:05.912456Z",
+        "retirement_candidate": true,
+        "retirement_reason": "no measured usage in review window"
+      },
+      {
+        "interface": {
+          "id": "4a70583c-1e41-4ec1-99a9-728856a7d79c",
+          "interface_key": "rest_api:POST /progress/ workstream_id",
+          "interface_kind": "rest_api",
+          "legacy_since": "2026-07-08T23:35:09.148333Z",
+          "replacement_ref": "POST /progress/ with workplan_id",
+          "owner_component": "state-hub.api",
+          "status": "legacy",
+          "replacement_verified": true,
+          "manual_hold": false,
+          "hold_reason": null,
+          "notes": null,
+          "retired_at": null,
+          "created_at": "2026-07-08T23:35:09.148333Z",
+          "updated_at": "2026-07-08T23:35:09.148333Z"
+        },
+        "all_time": {
+          "calls": 14,
+          "tenant_count": 1,
+          "user_count": 1,
+          "component_count": 1,
+          "tenants": {
+            "unknown": 14
+          },
+          "users": {
+            "unknown": 14
+          },
+          "components": {
+            "unknown": 14
+          }
+        },
+        "window": {
+          "calls": 0,
+          "tenant_count": 0,
+          "user_count": 0,
+          "component_count": 0,
+          "tenants": {},
+          "users": {},
+          "components": {}
+        },
+        "last_seen_at": "2026-07-10T08:34:42.959724Z",
+        "retirement_candidate": true,
+        "retirement_reason": "no measured usage in review window"
+      },
+      {
+        "interface": {
+          "id": "6df4e443-7bf1-461a-923b-a6eb52fe7b07",
+          "interface_key": "rest_api:POST /tasks/ workstream_id",
+          "interface_kind": "rest_api",
+          "legacy_since": "2026-07-08T22:38:29.405720Z",
+          "replacement_ref": "POST /tasks/ with workplan_id",
+          "owner_component": "state-hub.api",
+          "status": "legacy",
+          "replacement_verified": true,
+          "manual_hold": false,
+          "hold_reason": null,
+          "notes": null,
+          "retired_at": null,
+          "created_at": "2026-07-08T22:38:29.405720Z",
+          "updated_at": "2026-07-08T22:38:29.405720Z"
+        },
+        "all_time": {
+          "calls": 5,
+          "tenant_count": 1,
+          "user_count": 1,
+          "component_count": 1,
+          "tenants": {
+            "unknown": 5
+          },
+          "users": {
+            "unknown": 5
+          },
+          "components": {
+            "state-hub.fix-consistency": 5
+          }
+        },
+        "window": {
+          "calls": 0,
+          "tenant_count": 0,
+          "user_count": 0,
+          "component_count": 0,
+          "tenants": {},
+          "users": {},
+          "components": {}
+        },
+        "last_seen_at": "2026-07-08T22:38:29.976918Z",
+        "retirement_candidate": true,
+        "retirement_reason": "no measured usage in review window"
+      },
+      {
+        "interface": {
+          "id": "ed6451c9-d2cc-4486-9afe-d3852782cabc",
+          "interface_key": "rest_api:POST /workstreams/",
+          "interface_kind": "rest_api",
+          "legacy_since": "2026-06-04T07:40:24.168535Z",
+          "replacement_ref": "/workplans/",
+          "owner_component": "state-hub.api",
+          "status": "legacy",
+          "replacement_verified": true,
+          "manual_hold": false,
+          "hold_reason": null,
+          "notes": null,
+          "retired_at": null,
+          "created_at": "2026-06-04T07:40:24.168535Z",
+          "updated_at": "2026-06-04T07:40:24.168535Z"
+        },
+        "all_time": {
+          "calls": 824,
+          "tenant_count": 1,
+          "user_count": 1,
+          "component_count": 1,
+          "tenants": {
+            "unknown": 824
+          },
+          "users": {
+            "unknown": 824
+          },
+          "components": {
+            "unknown": 824
+          }
+        },
+        "window": {
+          "calls": 0,
+          "tenant_count": 0,
+          "user_count": 0,
+          "component_count": 0,
+          "tenants": {},
+          "users": {},
+          "components": {}
+        },
+        "last_seen_at": "2026-07-08T20:38:05.903144Z",
+        "retirement_candidate": true,
+        "retirement_reason": "no measured usage in review window"
+      },
+      {
+        "interface": {
+          "id": "281fd706-b192-4194-8055-2d8733c115f9",
+          "interface_key": "rest_api:POST /workstreams/{workstream_id}/dependencies/",
+          "interface_kind": "rest_api",
+          "legacy_since": "2026-06-04T22:57:37.149207Z",
+          "replacement_ref": "/workplans/{workplan_id}/dependencies/",
+          "owner_component": "state-hub.api",
+          "status": "legacy",
+          "replacement_verified": true,
+          "manual_hold": false,
+          "hold_reason": null,
+          "notes": null,
+          "retired_at": null,
+          "created_at": "2026-06-04T22:57:37.149207Z",
+          "updated_at": "2026-06-04T22:57:37.149207Z"
+        },
+        "all_time": {
+          "calls": 4971,
+          "tenant_count": 1,
+          "user_count": 1,
+          "component_count": 1,
+          "tenants": {
+            "unknown": 4971
+          },
+          "users": {
+            "unknown": 4971
+          },
+          "components": {
+            "unknown": 4971
+          }
+        },
+        "window": {
+          "calls": 0,
+          "tenant_count": 0,
+          "user_count": 0,
+          "component_count": 0,
+          "tenants": {},
+          "users": {},
+          "components": {}
+        },
+        "last_seen_at": "2026-07-01T22:09:24.229011Z",
+        "retirement_candidate": true,
+        "retirement_reason": "no measured usage in review window"
+      }
+    ]
+  },
+  "hours": 8
+}
diff --git a/docs/evidence/legacy-meter-weekly-review-20260730.json b/docs/evidence/legacy-meter-weekly-review-20260730.json
new file mode 100644
index 0000000..fd20566
--- /dev/null
+++ b/docs/evidence/legacy-meter-weekly-review-20260730.json
@@ -0,0 +1,1755 @@
+{
+  "captured_at": "2026-07-30T14:00:07.865979+00:00",
+  "api_base": "http://127.0.0.1:8000",
+  "workplan": "STATE-WP-0070",
+  "retired_interfaces": [],
+  "weekly_review": {
+    "generated_at": "2026-07-30T14:00:07.855719Z",
+    "window_start": "2026-07-30T06:00:07.746581Z",
+    "window_end": "2026-07-30T14:00:07.746581Z",
+    "cadence": "weekly",
+    "activity_core_handoff": {
+      "activity_id": "statehub-legacy-interface-review",
+      "cadence": "weekly",
+      "source_endpoint": "/legacy-meter/weekly-review",
+      "state_owner": "state-hub",
+      "scheduler_owner": "activity-core"
+    },
+    "interfaces": [
+      {
+        "interface": {
+          "id": "8051fb40-66c9-4dc4-a413-13e8573e04a3",
+          "interface_key": "event_subject:org.statehub.workstream.completed",
+          "interface_kind": "event_subject",
+          "legacy_since": "2026-06-04T06:09:42.198193Z",
+          "replacement_ref": "org.statehub.workplan.completed",
+          "owner_component": "state-hub.events",
+          "status": "retired",
+          "replacement_verified": true,
+          "manual_hold": false,
+          "hold_reason": null,
+          "notes": "Retired by STATE-WP-0069 closeout",
+          "retired_at": "2026-07-08T21:38:52.773601Z",
+          "created_at": "2026-06-04T06:09:42.198193Z",
+          "updated_at": "2026-07-08T21:38:52.761243Z"
+        },
+        "all_time": {
+          "calls": 255,
+          "tenant_count": 1,
+          "user_count": 1,
+          "component_count": 1,
+          "tenants": {
+            "unknown": 255
+          },
+          "users": {
+            "unknown": 255
+          },
+          "components": {
+            "state-hub.events": 255
+          }
+        },
+        "window": {
+          "calls": 0,
+          "tenant_count": 0,
+          "user_count": 0,
+          "component_count": 0,
+          "tenants": {},
+          "users": {},
+          "components": {}
+        },
+        "last_seen_at": "2026-07-08T20:49:12.839383Z",
+        "retirement_candidate": false,
+        "retirement_reason": "already retired"
+      },
+      {
+        "interface": {
+          "id": "63ed90e3-42b4-431a-94db-e1254a52f9e2",
+          "interface_key": "mcp:create_workstream",
+          "interface_kind": "mcp_tool",
+          "legacy_since": "2026-07-10T13:19:44.205900Z",
+          "replacement_ref": "create_workplan",
+          "owner_component": "state-hub.mcp",
+          "status": "legacy",
+          "replacement_verified": true,
+          "manual_hold": false,
+          "hold_reason": null,
+          "notes": "Registered by STATE-WP-0070 T03 \u2014 zero-window streak starts at registration",
+          "retired_at": null,
+          "created_at": "2026-07-10T13:19:44.205900Z",
+          "updated_at": "2026-07-10T13:19:44.205900Z"
+        },
+        "all_time": {
+          "calls": 2,
+          "tenant_count": 1,
+          "user_count": 1,
+          "component_count": 1,
+          "tenants": {
+            "unknown": 2
+          },
+          "users": {
+            "unknown": 2
+          },
+          "components": {
+            "state-hub.mcp": 2
+          }
+        },
+        "window": {
+          "calls": 0,
+          "tenant_count": 0,
+          "user_count": 0,
+          "component_count": 0,
+          "tenants": {},
+          "users": {},
+          "components": {}
+        },
+        "last_seen_at": "2026-07-10T13:20:43.378546Z",
+        "retirement_candidate": true,
+        "retirement_reason": "no measured usage in review window"
+      },
+      {
+        "interface": {
+          "id": "b6a5fe44-fb85-4ef7-a273-78d09da777af",
+          "interface_key": "mcp:list_workstreams",
+          "interface_kind": "mcp_tool",
+          "legacy_since": "2026-07-10T13:19:26.075491Z",
+          "replacement_ref": "list_workplans",
+          "owner_component": "state-hub.mcp",
+          "status": "legacy",
+          "replacement_verified": true,
+          "manual_hold": false,
+          "hold_reason": null,
+          "notes": null,
+          "retired_at": null,
+          "created_at": "2026-07-10T13:19:26.075491Z",
+          "updated_at": "2026-07-10T13:19:26.075491Z"
+        },
+        "all_time": {
+          "calls": 2,
+          "tenant_count": 1,
+          "user_count": 1,
+          "component_count": 1,
+          "tenants": {
+            "unknown": 2
+          },
+          "users": {
+            "unknown": 2
+          },
+          "components": {
+            "state-hub.mcp": 2
+          }
+        },
+        "window": {
+          "calls": 0,
+          "tenant_count": 0,
+          "user_count": 0,
+          "component_count": 0,
+          "tenants": {},
+          "users": {},
+          "components": {}
+        },
+        "last_seen_at": "2026-07-10T13:20:42.374940Z",
+        "retirement_candidate": true,
+        "retirement_reason": "no measured usage in review window"
+      },
+      {
+        "interface": {
+          "id": "53c3372b-307d-4d6a-8ea4-bc36cacdcaf2",
+          "interface_key": "mcp:update_workstream",
+          "interface_kind": "mcp_tool",
+          "legacy_since": "2026-07-10T13:19:44.255216Z",
+          "replacement_ref": "update_workplan",
+          "owner_component": "state-hub.mcp",
+          "status": "legacy",
+          "replacement_verified": true,
+          "manual_hold": false,
+          "hold_reason": null,
+          "notes": "Registered by STATE-WP-0070 T03 \u2014 zero-window streak starts at registration",
+          "retired_at": null,
+          "created_at": "2026-07-10T13:19:44.255216Z",
+          "updated_at": "2026-07-10T13:19:44.255216Z"
+        },
+        "all_time": {
+          "calls": 0,
+          "tenant_count": 0,
+          "user_count": 0,
+          "component_count": 0,
+          "tenants": {},
+          "users": {},
+          "components": {}
+        },
+        "window": {
+          "calls": 0,
+          "tenant_count": 0,
+          "user_count": 0,
+          "component_count": 0,
+          "tenants": {},
+          "users": {},
+          "components": {}
+        },
+        "last_seen_at": null,
+        "retirement_candidate": true,
+        "retirement_reason": "no measured usage in review window"
+      },
+      {
+        "interface": {
+          "id": "bed4d08a-3471-48f5-9f0e-f9d550383a26",
+          "interface_key": "mcp:update_workstream_status",
+          "interface_kind": "mcp_tool",
+          "legacy_since": "2026-07-10T13:19:44.303612Z",
+          "replacement_ref": "update_workplan_status",
+          "owner_component": "state-hub.mcp",
+          "status": "legacy",
+          "replacement_verified": true,
+          "manual_hold": false,
+          "hold_reason": null,
+          "notes": "Registered by STATE-WP-0070 T03 \u2014 zero-window streak starts at registration",
+          "retired_at": null,
+          "created_at": "2026-07-10T13:19:44.303612Z",
+          "updated_at": "2026-07-10T13:19:44.303612Z"
+        },
+        "all_time": {
+          "calls": 0,
+          "tenant_count": 0,
+          "user_count": 0,
+          "component_count": 0,
+          "tenants": {},
+          "users": {},
+          "components": {}
+        },
+        "window": {
+          "calls": 0,
+          "tenant_count": 0,
+          "user_count": 0,
+          "component_count": 0,
+          "tenants": {},
+          "users": {},
+          "components": {}
+        },
+        "last_seen_at": null,
+        "retirement_candidate": true,
+        "retirement_reason": "no measured usage in review window"
+      },
+      {
+        "interface": {
+          "id": "46900dc2-0893-405b-ba59-80f31fb6ebb1",
+          "interface_key": "state://workstreams/{topic_slug}",
+          "interface_kind": "mcp_tool",
+          "legacy_since": "2026-07-10T13:19:44.344493Z",
+          "replacement_ref": "state://workplans/{topic_slug}",
+          "owner_component": "state-hub.mcp",
+          "status": "legacy",
+          "replacement_verified": true,
+          "manual_hold": false,
+          "hold_reason": null,
+          "notes": "Registered by STATE-WP-0070 T03 \u2014 zero-window streak starts at registration",
+          "retired_at": null,
+          "created_at": "2026-07-10T13:19:44.344493Z",
+          "updated_at": "2026-07-10T13:19:44.344493Z"
+        },
+        "all_time": {
+          "calls": 1,
+          "tenant_count": 1,
+          "user_count": 1,
+          "component_count": 1,
+          "tenants": {
+            "unknown": 1
+          },
+          "users": {
+            "unknown": 1
+          },
+          "components": {
+            "state-hub.mcp": 1
+          }
+        },
+        "window": {
+          "calls": 0,
+          "tenant_count": 0,
+          "user_count": 0,
+          "component_count": 0,
+          "tenants": {},
+          "users": {},
+          "components": {}
+        },
+        "last_seen_at": "2026-07-10T13:20:34.491811Z",
+        "retirement_candidate": true,
+        "retirement_reason": "no measured usage in review window"
+      },
+      {
+        "interface": {
+          "id": "cd9342fd-27e7-4a46-a1be-d41499e106a3",
+          "interface_key": "rest_api:DELETE /workstreams/{workstream_id}",
+          "interface_kind": "rest_api",
+          "legacy_since": "2026-06-06T17:28:13.052813Z",
+          "replacement_ref": "/workplans/{workplan_id}",
+          "owner_component": "state-hub.api",
+          "status": "legacy",
+          "replacement_verified": true,
+          "manual_hold": false,
+          "hold_reason": null,
+          "notes": null,
+          "retired_at": null,
+          "created_at": "2026-06-06T17:28:13.052813Z",
+          "updated_at": "2026-06-06T17:28:13.052813Z"
+        },
+        "all_time": {
+          "calls": 1,
+          "tenant_count": 1,
+          "user_count": 1,
+          "component_count": 1,
+          "tenants": {
+            "unknown": 1
+          },
+          "users": {
+            "unknown": 1
+          },
+          "components": {
+            "unknown": 1
+          }
+        },
+        "window": {
+          "calls": 0,
+          "tenant_count": 0,
+          "user_count": 0,
+          "component_count": 0,
+          "tenants": {},
+          "users": {},
+          "components": {}
+        },
+        "last_seen_at": "2026-06-06T17:28:13.047529Z",
+        "retirement_candidate": true,
+        "retirement_reason": "no measured usage in review window"
+      },
+      {
+        "interface": {
+          "id": "a4e0948c-cd4a-461e-8ae2-7fd7b51d04a7",
+          "interface_key": "rest_api:GET /decisions/?workstream_id",
+          "interface_kind": "rest_api",
+          "legacy_since": "2026-07-09T23:07:53.093223Z",
+          "replacement_ref": "/decisions/?workplan_id=<workplan_id>",
+          "owner_component": "state-hub.api",
+          "status": "legacy",
+          "replacement_verified": true,
+          "manual_hold": false,
+          "hold_reason": null,
+          "notes": null,
+          "retired_at": null,
+          "created_at": "2026-07-09T23:07:53.093223Z",
+          "updated_at": "2026-07-09T23:07:53.093223Z"
+        },
+        "all_time": {
+          "calls": 1,
+          "tenant_count": 1,
+          "user_count": 1,
+          "component_count": 1,
+          "tenants": {
+            "unknown": 1
+          },
+          "users": {
+            "unknown": 1
+          },
+          "components": {
+            "unknown": 1
+          }
+        },
+        "window": {
+          "calls": 0,
+          "tenant_count": 0,
+          "user_count": 0,
+          "component_count": 0,
+          "tenants": {},
+          "users": {},
+          "components": {}
+        },
+        "last_seen_at": "2026-07-09T23:07:53.083299Z",
+        "retirement_candidate": true,
+        "retirement_reason": "no measured usage in review window"
+      },
+      {
+        "interface": {
+          "id": "70a9346e-e0ee-42ac-874f-f160580b54dd",
+          "interface_key": "rest_api:GET /progress/?workstream_id",
+          "interface_kind": "rest_api",
+          "legacy_since": "2026-07-13T22:04:03.911449Z",
+          "replacement_ref": "/progress/?workplan_id=<workplan_id>",
+          "owner_component": "state-hub.api",
+          "status": "legacy",
+          "replacement_verified": true,
+          "manual_hold": false,
+          "hold_reason": null,
+          "notes": null,
+          "retired_at": null,
+          "created_at": "2026-07-13T22:04:03.911449Z",
+          "updated_at": "2026-07-13T22:04:03.911449Z"
+        },
+        "all_time": {
+          "calls": 1,
+          "tenant_count": 1,
+          "user_count": 1,
+          "component_count": 1,
+          "tenants": {
+            "unknown": 1
+          },
+          "users": {
+            "unknown": 1
+          },
+          "components": {
+            "unknown": 1
+          }
+        },
+        "window": {
+          "calls": 0,
+          "tenant_count": 0,
+          "user_count": 0,
+          "component_count": 0,
+          "tenants": {},
+          "users": {},
+          "components": {}
+        },
+        "last_seen_at": "2026-07-13T22:04:03.904998Z",
+        "retirement_candidate": true,
+        "retirement_reason": "no measured usage in review window"
+      },
+      {
+        "interface": {
+          "id": "be3cdcf8-250b-4bf0-801f-02ffd5f57e00",
+          "interface_key": "rest_api:GET /tasks/?workstream_id",
+          "interface_kind": "rest_api",
+          "legacy_since": "2026-07-08T19:32:21.628513Z",
+          "replacement_ref": "/tasks/?workplan_id=<workplan_id>",
+          "owner_component": "state-hub.api",
+          "status": "legacy",
+          "replacement_verified": true,
+          "manual_hold": false,
+          "hold_reason": null,
+          "notes": null,
+          "retired_at": null,
+          "created_at": "2026-07-08T19:32:21.628513Z",
+          "updated_at": "2026-07-08T19:32:21.628513Z"
+        },
+        "all_time": {
+          "calls": 587,
+          "tenant_count": 1,
+          "user_count": 1,
+          "component_count": 1,
+          "tenants": {
+            "unknown": 587
+          },
+          "users": {
+            "unknown": 587
+          },
+          "components": {
+            "unknown": 587
+          }
+        },
+        "window": {
+          "calls": 0,
+          "tenant_count": 0,
+          "user_count": 0,
+          "component_count": 0,
+          "tenants": {},
+          "users": {},
+          "components": {}
+        },
+        "last_seen_at": "2026-07-22T13:21:12.171828Z",
+        "retirement_candidate": true,
+        "retirement_reason": "no measured usage in review window"
+      },
+      {
+        "interface": {
+          "id": "3e4a3d0b-08fa-45c3-91e2-4f514a914b97",
+          "interface_key": "rest_api:GET /workstreams/",
+          "interface_kind": "rest_api",
+          "legacy_since": "2026-06-04T00:26:14.533764Z",
+          "replacement_ref": "/workplans/",
+          "owner_component": "state-hub.api",
+          "status": "legacy",
+          "replacement_verified": true,
+          "manual_hold": false,
+          "hold_reason": null,
+          "notes": null,
+          "retired_at": null,
+          "created_at": "2026-06-04T00:26:14.533764Z",
+          "updated_at": "2026-06-04T00:26:14.533764Z"
+        },
+        "all_time": {
+          "calls": 144084,
+          "tenant_count": 1,
+          "user_count": 1,
+          "component_count": 1,
+          "tenants": {
+            "unknown": 144084
+          },
+          "users": {
+            "unknown": 144084
+          },
+          "components": {
+            "unknown": 144084
+          }
+        },
+        "window": {
+          "calls": 0,
+          "tenant_count": 0,
+          "user_count": 0,
+          "component_count": 0,
+          "tenants": {},
+          "users": {},
+          "components": {}
+        },
+        "last_seen_at": "2026-07-08T21:14:39.652776Z",
+        "retirement_candidate": true,
+        "retirement_reason": "no measured usage in review window"
+      },
+      {
+        "interface": {
+          "id": "e4c140ec-7479-46f9-b185-4b533f19d639",
+          "interface_key": "rest_api:GET /workstreams/workplan-index",
+          "interface_kind": "rest_api",
+          "legacy_since": "2026-06-04T05:20:58.321869Z",
+          "replacement_ref": "/workplans/index",
+          "owner_component": "state-hub.api",
+          "status": "legacy",
+          "replacement_verified": true,
+          "manual_hold": false,
+          "hold_reason": null,
+          "notes": null,
+          "retired_at": null,
+          "created_at": "2026-06-04T05:20:58.321869Z",
+          "updated_at": "2026-06-04T05:20:58.321869Z"
+        },
+        "all_time": {
+          "calls": 30,
+          "tenant_count": 1,
+          "user_count": 1,
+          "component_count": 1,
+          "tenants": {
+            "unknown": 30
+          },
+          "users": {
+            "unknown": 30
+          },
+          "components": {
+            "unknown": 30
+          }
+        },
+        "window": {
+          "calls": 0,
+          "tenant_count": 0,
+          "user_count": 0,
+          "component_count": 0,
+          "tenants": {},
+          "users": {},
+          "components": {}
+        },
+        "last_seen_at": "2026-07-03T05:20:34.534439Z",
+        "retirement_candidate": true,
+        "retirement_reason": "no measured usage in review window"
+      },
+      {
+        "interface": {
+          "id": "3a00b19e-e7db-4403-98aa-a77c9ab61ecc",
+          "interface_key": "rest_api:GET /workstreams/{workstream_id}",
+          "interface_kind": "rest_api",
+          "legacy_since": "2026-06-04T00:25:59.014966Z",
+          "replacement_ref": "/workplans/{workplan_id}",
+          "owner_component": "state-hub.api",
+          "status": "legacy",
+          "replacement_verified": true,
+          "manual_hold": false,
+          "hold_reason": null,
+          "notes": null,
+          "retired_at": null,
+          "created_at": "2026-06-04T00:25:59.014966Z",
+          "updated_at": "2026-06-04T00:25:59.014966Z"
+        },
+        "all_time": {
+          "calls": 511405,
+          "tenant_count": 1,
+          "user_count": 1,
+          "component_count": 1,
+          "tenants": {
+            "unknown": 511405
+          },
+          "users": {
+            "unknown": 511405
+          },
+          "components": {
+            "unknown": 511405
+          }
+        },
+        "window": {
+          "calls": 0,
+          "tenant_count": 0,
+          "user_count": 0,
+          "component_count": 0,
+          "tenants": {},
+          "users": {},
+          "components": {}
+        },
+        "last_seen_at": "2026-07-08T21:14:20.781103Z",
+        "retirement_candidate": true,
+        "retirement_reason": "no measured usage in review window"
+      },
+      {
+        "interface": {
+          "id": "69e1a255-a8b9-4101-8a68-b1bed23abfda",
+          "interface_key": "rest_api:GET /workstreams/{workstream_id}/dependencies/",
+          "interface_kind": "rest_api",
+          "legacy_since": "2026-06-04T00:25:59.291135Z",
+          "replacement_ref": "/workplans/{workplan_id}/dependencies/",
+          "owner_component": "state-hub.api",
+          "status": "legacy",
+          "replacement_verified": true,
+          "manual_hold": false,
+          "hold_reason": null,
+          "notes": null,
+          "retired_at": null,
+          "created_at": "2026-06-04T00:25:59.291135Z",
+          "updated_at": "2026-06-04T00:25:59.291135Z"
+        },
+        "all_time": {
+          "calls": 255865,
+          "tenant_count": 1,
+          "user_count": 1,
+          "component_count": 1,
+          "tenants": {
+            "unknown": 255865
+          },
+          "users": {
+            "unknown": 255865
+          },
+          "components": {
+            "unknown": 255865
+          }
+        },
+        "window": {
+          "calls": 0,
+          "tenant_count": 0,
+          "user_count": 0,
+          "component_count": 0,
+          "tenants": {},
+          "users": {},
+          "components": {}
+        },
+        "last_seen_at": "2026-07-08T21:14:12.747005Z",
+        "retirement_candidate": true,
+        "retirement_reason": "no measured usage in review window"
+      },
+      {
+        "interface": {
+          "id": "b1aae931-b51f-4a85-a723-865dd65f6132",
+          "interface_key": "rest_api:PATCH /workstreams/{workstream_id}",
+          "interface_kind": "rest_api",
+          "legacy_since": "2026-06-04T06:09:41.901035Z",
+          "replacement_ref": "/workplans/{workplan_id}",
+          "owner_component": "state-hub.api",
+          "status": "legacy",
+          "replacement_verified": true,
+          "manual_hold": false,
+          "hold_reason": null,
+          "notes": null,
+          "retired_at": null,
+          "created_at": "2026-06-04T06:09:41.901035Z",
+          "updated_at": "2026-06-04T06:09:41.901035Z"
+        },
+        "all_time": {
+          "calls": 571,
+          "tenant_count": 1,
+          "user_count": 1,
+          "component_count": 1,
+          "tenants": {
+            "unknown": 571
+          },
+          "users": {
+            "unknown": 571
+          },
+          "components": {
+            "unknown": 571
+          }
+        },
+        "window": {
+          "calls": 0,
+          "tenant_count": 0,
+          "user_count": 0,
+          "component_count": 0,
+          "tenants": {},
+          "users": {},
+          "components": {}
+        },
+        "last_seen_at": "2026-07-08T20:49:12.335710Z",
+        "retirement_candidate": true,
+        "retirement_reason": "no measured usage in review window"
+      },
+      {
+        "interface": {
+          "id": "4aea9591-970b-4918-ac4a-4da95a0a1a8c",
+          "interface_key": "rest_api:POST /decisions/ workstream_id",
+          "interface_kind": "rest_api",
+          "legacy_since": "2026-07-09T22:56:35.473130Z",
+          "replacement_ref": "POST /decisions/ with workplan_id",
+          "owner_component": "state-hub.api",
+          "status": "legacy",
+          "replacement_verified": true,
+          "manual_hold": false,
+          "hold_reason": null,
+          "notes": null,
+          "retired_at": null,
+          "created_at": "2026-07-09T22:56:35.473130Z",
+          "updated_at": "2026-07-09T22:56:35.473130Z"
+        },
+        "all_time": {
+          "calls": 3,
+          "tenant_count": 1,
+          "user_count": 1,
+          "component_count": 1,
+          "tenants": {
+            "unknown": 3
+          },
+          "users": {
+            "unknown": 3
+          },
+          "components": {
+            "unknown": 3
+          }
+        },
+        "window": {
+          "calls": 0,
+          "tenant_count": 0,
+          "user_count": 0,
+          "component_count": 0,
+          "tenants": {},
+          "users": {},
+          "components": {}
+        },
+        "last_seen_at": "2026-07-09T22:57:05.912456Z",
+        "retirement_candidate": true,
+        "retirement_reason": "no measured usage in review window"
+      },
+      {
+        "interface": {
+          "id": "4a70583c-1e41-4ec1-99a9-728856a7d79c",
+          "interface_key": "rest_api:POST /progress/ workstream_id",
+          "interface_kind": "rest_api",
+          "legacy_since": "2026-07-08T23:35:09.148333Z",
+          "replacement_ref": "POST /progress/ with workplan_id",
+          "owner_component": "state-hub.api",
+          "status": "legacy",
+          "replacement_verified": true,
+          "manual_hold": false,
+          "hold_reason": null,
+          "notes": null,
+          "retired_at": null,
+          "created_at": "2026-07-08T23:35:09.148333Z",
+          "updated_at": "2026-07-08T23:35:09.148333Z"
+        },
+        "all_time": {
+          "calls": 14,
+          "tenant_count": 1,
+          "user_count": 1,
+          "component_count": 1,
+          "tenants": {
+            "unknown": 14
+          },
+          "users": {
+            "unknown": 14
+          },
+          "components": {
+            "unknown": 14
+          }
+        },
+        "window": {
+          "calls": 0,
+          "tenant_count": 0,
+          "user_count": 0,
+          "component_count": 0,
+          "tenants": {},
+          "users": {},
+          "components": {}
+        },
+        "last_seen_at": "2026-07-10T08:34:42.959724Z",
+        "retirement_candidate": true,
+        "retirement_reason": "no measured usage in review window"
+      },
+      {
+        "interface": {
+          "id": "6df4e443-7bf1-461a-923b-a6eb52fe7b07",
+          "interface_key": "rest_api:POST /tasks/ workstream_id",
+          "interface_kind": "rest_api",
+          "legacy_since": "2026-07-08T22:38:29.405720Z",
+          "replacement_ref": "POST /tasks/ with workplan_id",
+          "owner_component": "state-hub.api",
+          "status": "legacy",
+          "replacement_verified": true,
+          "manual_hold": false,
+          "hold_reason": null,
+          "notes": null,
+          "retired_at": null,
+          "created_at": "2026-07-08T22:38:29.405720Z",
+          "updated_at": "2026-07-08T22:38:29.405720Z"
+        },
+        "all_time": {
+          "calls": 5,
+          "tenant_count": 1,
+          "user_count": 1,
+          "component_count": 1,
+          "tenants": {
+            "unknown": 5
+          },
+          "users": {
+            "unknown": 5
+          },
+          "components": {
+            "state-hub.fix-consistency": 5
+          }
+        },
+        "window": {
+          "calls": 0,
+          "tenant_count": 0,
+          "user_count": 0,
+          "component_count": 0,
+          "tenants": {},
+          "users": {},
+          "components": {}
+        },
+        "last_seen_at": "2026-07-08T22:38:29.976918Z",
+        "retirement_candidate": true,
+        "retirement_reason": "no measured usage in review window"
+      },
+      {
+        "interface": {
+          "id": "ed6451c9-d2cc-4486-9afe-d3852782cabc",
+          "interface_key": "rest_api:POST /workstreams/",
+          "interface_kind": "rest_api",
+          "legacy_since": "2026-06-04T07:40:24.168535Z",
+          "replacement_ref": "/workplans/",
+          "owner_component": "state-hub.api",
+          "status": "legacy",
+          "replacement_verified": true,
+          "manual_hold": false,
+          "hold_reason": null,
+          "notes": null,
+          "retired_at": null,
+          "created_at": "2026-06-04T07:40:24.168535Z",
+          "updated_at": "2026-06-04T07:40:24.168535Z"
+        },
+        "all_time": {
+          "calls": 824,
+          "tenant_count": 1,
+          "user_count": 1,
+          "component_count": 1,
+          "tenants": {
+            "unknown": 824
+          },
+          "users": {
+            "unknown": 824
+          },
+          "components": {
+            "unknown": 824
+          }
+        },
+        "window": {
+          "calls": 0,
+          "tenant_count": 0,
+          "user_count": 0,
+          "component_count": 0,
+          "tenants": {},
+          "users": {},
+          "components": {}
+        },
+        "last_seen_at": "2026-07-08T20:38:05.903144Z",
+        "retirement_candidate": true,
+        "retirement_reason": "no measured usage in review window"
+      },
+      {
+        "interface": {
+          "id": "281fd706-b192-4194-8055-2d8733c115f9",
+          "interface_key": "rest_api:POST /workstreams/{workstream_id}/dependencies/",
+          "interface_kind": "rest_api",
+          "legacy_since": "2026-06-04T22:57:37.149207Z",
+          "replacement_ref": "/workplans/{workplan_id}/dependencies/",
+          "owner_component": "state-hub.api",
+          "status": "legacy",
+          "replacement_verified": true,
+          "manual_hold": false,
+          "hold_reason": null,
+          "notes": null,
+          "retired_at": null,
+          "created_at": "2026-06-04T22:57:37.149207Z",
+          "updated_at": "2026-06-04T22:57:37.149207Z"
+        },
+        "all_time": {
+          "calls": 4971,
+          "tenant_count": 1,
+          "user_count": 1,
+          "component_count": 1,
+          "tenants": {
+            "unknown": 4971
+          },
+          "users": {
+            "unknown": 4971
+          },
+          "components": {
+            "unknown": 4971
+          }
+        },
+        "window": {
+          "calls": 0,
+          "tenant_count": 0,
+          "user_count": 0,
+          "component_count": 0,
+          "tenants": {},
+          "users": {},
+          "components": {}
+        },
+        "last_seen_at": "2026-07-01T22:09:24.229011Z",
+        "retirement_candidate": true,
+        "retirement_reason": "no measured usage in review window"
+      }
+    ],
+    "retirement_candidates": [
+      {
+        "interface": {
+          "id": "63ed90e3-42b4-431a-94db-e1254a52f9e2",
+          "interface_key": "mcp:create_workstream",
+          "interface_kind": "mcp_tool",
+          "legacy_since": "2026-07-10T13:19:44.205900Z",
+          "replacement_ref": "create_workplan",
+          "owner_component": "state-hub.mcp",
+          "status": "legacy",
+          "replacement_verified": true,
+          "manual_hold": false,
+          "hold_reason": null,
+          "notes": "Registered by STATE-WP-0070 T03 \u2014 zero-window streak starts at registration",
+          "retired_at": null,
+          "created_at": "2026-07-10T13:19:44.205900Z",
+          "updated_at": "2026-07-10T13:19:44.205900Z"
+        },
+        "all_time": {
+          "calls": 2,
+          "tenant_count": 1,
+          "user_count": 1,
+          "component_count": 1,
+          "tenants": {
+            "unknown": 2
+          },
+          "users": {
+            "unknown": 2
+          },
+          "components": {
+            "state-hub.mcp": 2
+          }
+        },
+        "window": {
+          "calls": 0,
+          "tenant_count": 0,
+          "user_count": 0,
+          "component_count": 0,
+          "tenants": {},
+          "users": {},
+          "components": {}
+        },
+        "last_seen_at": "2026-07-10T13:20:43.378546Z",
+        "retirement_candidate": true,
+        "retirement_reason": "no measured usage in review window"
+      },
+      {
+        "interface": {
+          "id": "b6a5fe44-fb85-4ef7-a273-78d09da777af",
+          "interface_key": "mcp:list_workstreams",
+          "interface_kind": "mcp_tool",
+          "legacy_since": "2026-07-10T13:19:26.075491Z",
+          "replacement_ref": "list_workplans",
+          "owner_component": "state-hub.mcp",
+          "status": "legacy",
+          "replacement_verified": true,
+          "manual_hold": false,
+          "hold_reason": null,
+          "notes": null,
+          "retired_at": null,
+          "created_at": "2026-07-10T13:19:26.075491Z",
+          "updated_at": "2026-07-10T13:19:26.075491Z"
+        },
+        "all_time": {
+          "calls": 2,
+          "tenant_count": 1,
+          "user_count": 1,
+          "component_count": 1,
+          "tenants": {
+            "unknown": 2
+          },
+          "users": {
+            "unknown": 2
+          },
+          "components": {
+            "state-hub.mcp": 2
+          }
+        },
+        "window": {
+          "calls": 0,
+          "tenant_count": 0,
+          "user_count": 0,
+          "component_count": 0,
+          "tenants": {},
+          "users": {},
+          "components": {}
+        },
+        "last_seen_at": "2026-07-10T13:20:42.374940Z",
+        "retirement_candidate": true,
+        "retirement_reason": "no measured usage in review window"
+      },
+      {
+        "interface": {
+          "id": "53c3372b-307d-4d6a-8ea4-bc36cacdcaf2",
+          "interface_key": "mcp:update_workstream",
+          "interface_kind": "mcp_tool",
+          "legacy_since": "2026-07-10T13:19:44.255216Z",
+          "replacement_ref": "update_workplan",
+          "owner_component": "state-hub.mcp",
+          "status": "legacy",
+          "replacement_verified": true,
+          "manual_hold": false,
+          "hold_reason": null,
+          "notes": "Registered by STATE-WP-0070 T03 \u2014 zero-window streak starts at registration",
+          "retired_at": null,
+          "created_at": "2026-07-10T13:19:44.255216Z",
+          "updated_at": "2026-07-10T13:19:44.255216Z"
+        },
+        "all_time": {
+          "calls": 0,
+          "tenant_count": 0,
+          "user_count": 0,
+          "component_count": 0,
+          "tenants": {},
+          "users": {},
+          "components": {}
+        },
+        "window": {
+          "calls": 0,
+          "tenant_count": 0,
+          "user_count": 0,
+          "component_count": 0,
+          "tenants": {},
+          "users": {},
+          "components": {}
+        },
+        "last_seen_at": null,
+        "retirement_candidate": true,
+        "retirement_reason": "no measured usage in review window"
+      },
+      {
+        "interface": {
+          "id": "bed4d08a-3471-48f5-9f0e-f9d550383a26",
+          "interface_key": "mcp:update_workstream_status",
+          "interface_kind": "mcp_tool",
+          "legacy_since": "2026-07-10T13:19:44.303612Z",
+          "replacement_ref": "update_workplan_status",
+          "owner_component": "state-hub.mcp",
+          "status": "legacy",
+          "replacement_verified": true,
+          "manual_hold": false,
+          "hold_reason": null,
+          "notes": "Registered by STATE-WP-0070 T03 \u2014 zero-window streak starts at registration",
+          "retired_at": null,
+          "created_at": "2026-07-10T13:19:44.303612Z",
+          "updated_at": "2026-07-10T13:19:44.303612Z"
+        },
+        "all_time": {
+          "calls": 0,
+          "tenant_count": 0,
+          "user_count": 0,
+          "component_count": 0,
+          "tenants": {},
+          "users": {},
+          "components": {}
+        },
+        "window": {
+          "calls": 0,
+          "tenant_count": 0,
+          "user_count": 0,
+          "component_count": 0,
+          "tenants": {},
+          "users": {},
+          "components": {}
+        },
+        "last_seen_at": null,
+        "retirement_candidate": true,
+        "retirement_reason": "no measured usage in review window"
+      },
+      {
+        "interface": {
+          "id": "46900dc2-0893-405b-ba59-80f31fb6ebb1",
+          "interface_key": "state://workstreams/{topic_slug}",
+          "interface_kind": "mcp_tool",
+          "legacy_since": "2026-07-10T13:19:44.344493Z",
+          "replacement_ref": "state://workplans/{topic_slug}",
+          "owner_component": "state-hub.mcp",
+          "status": "legacy",
+          "replacement_verified": true,
+          "manual_hold": false,
+          "hold_reason": null,
+          "notes": "Registered by STATE-WP-0070 T03 \u2014 zero-window streak starts at registration",
+          "retired_at": null,
+          "created_at": "2026-07-10T13:19:44.344493Z",
+          "updated_at": "2026-07-10T13:19:44.344493Z"
+        },
+        "all_time": {
+          "calls": 1,
+          "tenant_count": 1,
+          "user_count": 1,
+          "component_count": 1,
+          "tenants": {
+            "unknown": 1
+          },
+          "users": {
+            "unknown": 1
+          },
+          "components": {
+            "state-hub.mcp": 1
+          }
+        },
+        "window": {
+          "calls": 0,
+          "tenant_count": 0,
+          "user_count": 0,
+          "component_count": 0,
+          "tenants": {},
+          "users": {},
+          "components": {}
+        },
+        "last_seen_at": "2026-07-10T13:20:34.491811Z",
+        "retirement_candidate": true,
+        "retirement_reason": "no measured usage in review window"
+      },
+      {
+        "interface": {
+          "id": "cd9342fd-27e7-4a46-a1be-d41499e106a3",
+          "interface_key": "rest_api:DELETE /workstreams/{workstream_id}",
+          "interface_kind": "rest_api",
+          "legacy_since": "2026-06-06T17:28:13.052813Z",
+          "replacement_ref": "/workplans/{workplan_id}",
+          "owner_component": "state-hub.api",
+          "status": "legacy",
+          "replacement_verified": true,
+          "manual_hold": false,
+          "hold_reason": null,
+          "notes": null,
+          "retired_at": null,
+          "created_at": "2026-06-06T17:28:13.052813Z",
+          "updated_at": "2026-06-06T17:28:13.052813Z"
+        },
+        "all_time": {
+          "calls": 1,
+          "tenant_count": 1,
+          "user_count": 1,
+          "component_count": 1,
+          "tenants": {
+            "unknown": 1
+          },
+          "users": {
+            "unknown": 1
+          },
+          "components": {
+            "unknown": 1
+          }
+        },
+        "window": {
+          "calls": 0,
+          "tenant_count": 0,
+          "user_count": 0,
+          "component_count": 0,
+          "tenants": {},
+          "users": {},
+          "components": {}
+        },
+        "last_seen_at": "2026-06-06T17:28:13.047529Z",
+        "retirement_candidate": true,
+        "retirement_reason": "no measured usage in review window"
+      },
+      {
+        "interface": {
+          "id": "a4e0948c-cd4a-461e-8ae2-7fd7b51d04a7",
+          "interface_key": "rest_api:GET /decisions/?workstream_id",
+          "interface_kind": "rest_api",
+          "legacy_since": "2026-07-09T23:07:53.093223Z",
+          "replacement_ref": "/decisions/?workplan_id=<workplan_id>",
+          "owner_component": "state-hub.api",
+          "status": "legacy",
+          "replacement_verified": true,
+          "manual_hold": false,
+          "hold_reason": null,
+          "notes": null,
+          "retired_at": null,
+          "created_at": "2026-07-09T23:07:53.093223Z",
+          "updated_at": "2026-07-09T23:07:53.093223Z"
+        },
+        "all_time": {
+          "calls": 1,
+          "tenant_count": 1,
+          "user_count": 1,
+          "component_count": 1,
+          "tenants": {
+            "unknown": 1
+          },
+          "users": {
+            "unknown": 1
+          },
+          "components": {
+            "unknown": 1
+          }
+        },
+        "window": {
+          "calls": 0,
+          "tenant_count": 0,
+          "user_count": 0,
+          "component_count": 0,
+          "tenants": {},
+          "users": {},
+          "components": {}
+        },
+        "last_seen_at": "2026-07-09T23:07:53.083299Z",
+        "retirement_candidate": true,
+        "retirement_reason": "no measured usage in review window"
+      },
+      {
+        "interface": {
+          "id": "70a9346e-e0ee-42ac-874f-f160580b54dd",
+          "interface_key": "rest_api:GET /progress/?workstream_id",
+          "interface_kind": "rest_api",
+          "legacy_since": "2026-07-13T22:04:03.911449Z",
+          "replacement_ref": "/progress/?workplan_id=<workplan_id>",
+          "owner_component": "state-hub.api",
+          "status": "legacy",
+          "replacement_verified": true,
+          "manual_hold": false,
+          "hold_reason": null,
+          "notes": null,
+          "retired_at": null,
+          "created_at": "2026-07-13T22:04:03.911449Z",
+          "updated_at": "2026-07-13T22:04:03.911449Z"
+        },
+        "all_time": {
+          "calls": 1,
+          "tenant_count": 1,
+          "user_count": 1,
+          "component_count": 1,
+          "tenants": {
+            "unknown": 1
+          },
+          "users": {
+            "unknown": 1
+          },
+          "components": {
+            "unknown": 1
+          }
+        },
+        "window": {
+          "calls": 0,
+          "tenant_count": 0,
+          "user_count": 0,
+          "component_count": 0,
+          "tenants": {},
+          "users": {},
+          "components": {}
+        },
+        "last_seen_at": "2026-07-13T22:04:03.904998Z",
+        "retirement_candidate": true,
+        "retirement_reason": "no measured usage in review window"
+      },
+      {
+        "interface": {
+          "id": "be3cdcf8-250b-4bf0-801f-02ffd5f57e00",
+          "interface_key": "rest_api:GET /tasks/?workstream_id",
+          "interface_kind": "rest_api",
+          "legacy_since": "2026-07-08T19:32:21.628513Z",
+          "replacement_ref": "/tasks/?workplan_id=<workplan_id>",
+          "owner_component": "state-hub.api",
+          "status": "legacy",
+          "replacement_verified": true,
+          "manual_hold": false,
+          "hold_reason": null,
+          "notes": null,
+          "retired_at": null,
+          "created_at": "2026-07-08T19:32:21.628513Z",
+          "updated_at": "2026-07-08T19:32:21.628513Z"
+        },
+        "all_time": {
+          "calls": 587,
+          "tenant_count": 1,
+          "user_count": 1,
+          "component_count": 1,
+          "tenants": {
+            "unknown": 587
+          },
+          "users": {
+            "unknown": 587
+          },
+          "components": {
+            "unknown": 587
+          }
+        },
+        "window": {
+          "calls": 0,
+          "tenant_count": 0,
+          "user_count": 0,
+          "component_count": 0,
+          "tenants": {},
+          "users": {},
+          "components": {}
+        },
+        "last_seen_at": "2026-07-22T13:21:12.171828Z",
+        "retirement_candidate": true,
+        "retirement_reason": "no measured usage in review window"
+      },
+      {
+        "interface": {
+          "id": "3e4a3d0b-08fa-45c3-91e2-4f514a914b97",
+          "interface_key": "rest_api:GET /workstreams/",
+          "interface_kind": "rest_api",
+          "legacy_since": "2026-06-04T00:26:14.533764Z",
+          "replacement_ref": "/workplans/",
+          "owner_component": "state-hub.api",
+          "status": "legacy",
+          "replacement_verified": true,
+          "manual_hold": false,
+          "hold_reason": null,
+          "notes": null,
+          "retired_at": null,
+          "created_at": "2026-06-04T00:26:14.533764Z",
+          "updated_at": "2026-06-04T00:26:14.533764Z"
+        },
+        "all_time": {
+          "calls": 144084,
+          "tenant_count": 1,
+          "user_count": 1,
+          "component_count": 1,
+          "tenants": {
+            "unknown": 144084
+          },
+          "users": {
+            "unknown": 144084
+          },
+          "components": {
+            "unknown": 144084
+          }
+        },
+        "window": {
+          "calls": 0,
+          "tenant_count": 0,
+          "user_count": 0,
+          "component_count": 0,
+          "tenants": {},
+          "users": {},
+          "components": {}
+        },
+        "last_seen_at": "2026-07-08T21:14:39.652776Z",
+        "retirement_candidate": true,
+        "retirement_reason": "no measured usage in review window"
+      },
+      {
+        "interface": {
+          "id": "e4c140ec-7479-46f9-b185-4b533f19d639",
+          "interface_key": "rest_api:GET /workstreams/workplan-index",
+          "interface_kind": "rest_api",
+          "legacy_since": "2026-06-04T05:20:58.321869Z",
+          "replacement_ref": "/workplans/index",
+          "owner_component": "state-hub.api",
+          "status": "legacy",
+          "replacement_verified": true,
+          "manual_hold": false,
+          "hold_reason": null,
+          "notes": null,
+          "retired_at": null,
+          "created_at": "2026-06-04T05:20:58.321869Z",
+          "updated_at": "2026-06-04T05:20:58.321869Z"
+        },
+        "all_time": {
+          "calls": 30,
+          "tenant_count": 1,
+          "user_count": 1,
+          "component_count": 1,
+          "tenants": {
+            "unknown": 30
+          },
+          "users": {
+            "unknown": 30
+          },
+          "components": {
+            "unknown": 30
+          }
+        },
+        "window": {
+          "calls": 0,
+          "tenant_count": 0,
+          "user_count": 0,
+          "component_count": 0,
+          "tenants": {},
+          "users": {},
+          "components": {}
+        },
+        "last_seen_at": "2026-07-03T05:20:34.534439Z",
+        "retirement_candidate": true,
+        "retirement_reason": "no measured usage in review window"
+      },
+      {
+        "interface": {
+          "id": "3a00b19e-e7db-4403-98aa-a77c9ab61ecc",
+          "interface_key": "rest_api:GET /workstreams/{workstream_id}",
+          "interface_kind": "rest_api",
+          "legacy_since": "2026-06-04T00:25:59.014966Z",
+          "replacement_ref": "/workplans/{workplan_id}",
+          "owner_component": "state-hub.api",
+          "status": "legacy",
+          "replacement_verified": true,
+          "manual_hold": false,
+          "hold_reason": null,
+          "notes": null,
+          "retired_at": null,
+          "created_at": "2026-06-04T00:25:59.014966Z",
+          "updated_at": "2026-06-04T00:25:59.014966Z"
+        },
+        "all_time": {
+          "calls": 511405,
+          "tenant_count": 1,
+          "user_count": 1,
+          "component_count": 1,
+          "tenants": {
+            "unknown": 511405
+          },
+          "users": {
+            "unknown": 511405
+          },
+          "components": {
+            "unknown": 511405
+          }
+        },
+        "window": {
+          "calls": 0,
+          "tenant_count": 0,
+          "user_count": 0,
+          "component_count": 0,
+          "tenants": {},
+          "users": {},
+          "components": {}
+        },
+        "last_seen_at": "2026-07-08T21:14:20.781103Z",
+        "retirement_candidate": true,
+        "retirement_reason": "no measured usage in review window"
+      },
+      {
+        "interface": {
+          "id": "69e1a255-a8b9-4101-8a68-b1bed23abfda",
+          "interface_key": "rest_api:GET /workstreams/{workstream_id}/dependencies/",
+          "interface_kind": "rest_api",
+          "legacy_since": "2026-06-04T00:25:59.291135Z",
+          "replacement_ref": "/workplans/{workplan_id}/dependencies/",
+          "owner_component": "state-hub.api",
+          "status": "legacy",
+          "replacement_verified": true,
+          "manual_hold": false,
+          "hold_reason": null,
+          "notes": null,
+          "retired_at": null,
+          "created_at": "2026-06-04T00:25:59.291135Z",
+          "updated_at": "2026-06-04T00:25:59.291135Z"
+        },
+        "all_time": {
+          "calls": 255865,
+          "tenant_count": 1,
+          "user_count": 1,
+          "component_count": 1,
+          "tenants": {
+            "unknown": 255865
+          },
+          "users": {
+            "unknown": 255865
+          },
+          "components": {
+            "unknown": 255865
+          }
+        },
+        "window": {
+          "calls": 0,
+          "tenant_count": 0,
+          "user_count": 0,
+          "component_count": 0,
+          "tenants": {},
+          "users": {},
+          "components": {}
+        },
+        "last_seen_at": "2026-07-08T21:14:12.747005Z",
+        "retirement_candidate": true,
+        "retirement_reason": "no measured usage in review window"
+      },
+      {
+        "interface": {
+          "id": "b1aae931-b51f-4a85-a723-865dd65f6132",
+          "interface_key": "rest_api:PATCH /workstreams/{workstream_id}",
+          "interface_kind": "rest_api",
+          "legacy_since": "2026-06-04T06:09:41.901035Z",
+          "replacement_ref": "/workplans/{workplan_id}",
+          "owner_component": "state-hub.api",
+          "status": "legacy",
+          "replacement_verified": true,
+          "manual_hold": false,
+          "hold_reason": null,
+          "notes": null,
+          "retired_at": null,
+          "created_at": "2026-06-04T06:09:41.901035Z",
+          "updated_at": "2026-06-04T06:09:41.901035Z"
+        },
+        "all_time": {
+          "calls": 571,
+          "tenant_count": 1,
+          "user_count": 1,
+          "component_count": 1,
+          "tenants": {
+            "unknown": 571
+          },
+          "users": {
+            "unknown": 571
+          },
+          "components": {
+            "unknown": 571
+          }
+        },
+        "window": {
+          "calls": 0,
+          "tenant_count": 0,
+          "user_count": 0,
+          "component_count": 0,
+          "tenants": {},
+          "users": {},
+          "components": {}
+        },
+        "last_seen_at": "2026-07-08T20:49:12.335710Z",
+        "retirement_candidate": true,
+        "retirement_reason": "no measured usage in review window"
+      },
+      {
+        "interface": {
+          "id": "4aea9591-970b-4918-ac4a-4da95a0a1a8c",
+          "interface_key": "rest_api:POST /decisions/ workstream_id",
+          "interface_kind": "rest_api",
+          "legacy_since": "2026-07-09T22:56:35.473130Z",
+          "replacement_ref": "POST /decisions/ with workplan_id",
+          "owner_component": "state-hub.api",
+          "status": "legacy",
+          "replacement_verified": true,
+          "manual_hold": false,
+          "hold_reason": null,
+          "notes": null,
+          "retired_at": null,
+          "created_at": "2026-07-09T22:56:35.473130Z",
+          "updated_at": "2026-07-09T22:56:35.473130Z"
+        },
+        "all_time": {
+          "calls": 3,
+          "tenant_count": 1,
+          "user_count": 1,
+          "component_count": 1,
+          "tenants": {
+            "unknown": 3
+          },
+          "users": {
+            "unknown": 3
+          },
+          "components": {
+            "unknown": 3
+          }
+        },
+        "window": {
+          "calls": 0,
+          "tenant_count": 0,
+          "user_count": 0,
+          "component_count": 0,
+          "tenants": {},
+          "users": {},
+          "components": {}
+        },
+        "last_seen_at": "2026-07-09T22:57:05.912456Z",
+        "retirement_candidate": true,
+        "retirement_reason": "no measured usage in review window"
+      },
+      {
+        "interface": {
+          "id": "4a70583c-1e41-4ec1-99a9-728856a7d79c",
+          "interface_key": "rest_api:POST /progress/ workstream_id",
+          "interface_kind": "rest_api",
+          "legacy_since": "2026-07-08T23:35:09.148333Z",
+          "replacement_ref": "POST /progress/ with workplan_id",
+          "owner_component": "state-hub.api",
+          "status": "legacy",
+          "replacement_verified": true,
+          "manual_hold": false,
+          "hold_reason": null,
+          "notes": null,
+          "retired_at": null,
+          "created_at": "2026-07-08T23:35:09.148333Z",
+          "updated_at": "2026-07-08T23:35:09.148333Z"
+        },
+        "all_time": {
+          "calls": 14,
+          "tenant_count": 1,
+          "user_count": 1,
+          "component_count": 1,
+          "tenants": {
+            "unknown": 14
+          },
+          "users": {
+            "unknown": 14
+          },
+          "components": {
+            "unknown": 14
+          }
+        },
+        "window": {
+          "calls": 0,
+          "tenant_count": 0,
+          "user_count": 0,
+          "component_count": 0,
+          "tenants": {},
+          "users": {},
+          "components": {}
+        },
+        "last_seen_at": "2026-07-10T08:34:42.959724Z",
+        "retirement_candidate": true,
+        "retirement_reason": "no measured usage in review window"
+      },
+      {
+        "interface": {
+          "id": "6df4e443-7bf1-461a-923b-a6eb52fe7b07",
+          "interface_key": "rest_api:POST /tasks/ workstream_id",
+          "interface_kind": "rest_api",
+          "legacy_since": "2026-07-08T22:38:29.405720Z",
+          "replacement_ref": "POST /tasks/ with workplan_id",
+          "owner_component": "state-hub.api",
+          "status": "legacy",
+          "replacement_verified": true,
+          "manual_hold": false,
+          "hold_reason": null,
+          "notes": null,
+          "retired_at": null,
+          "created_at": "2026-07-08T22:38:29.405720Z",
+          "updated_at": "2026-07-08T22:38:29.405720Z"
+        },
+        "all_time": {
+          "calls": 5,
+          "tenant_count": 1,
+          "user_count": 1,
+          "component_count": 1,
+          "tenants": {
+            "unknown": 5
+          },
+          "users": {
+            "unknown": 5
+          },
+          "components": {
+            "state-hub.fix-consistency": 5
+          }
+        },
+        "window": {
+          "calls": 0,
+          "tenant_count": 0,
+          "user_count": 0,
+          "component_count": 0,
+          "tenants": {},
+          "users": {},
+          "components": {}
+        },
+        "last_seen_at": "2026-07-08T22:38:29.976918Z",
+        "retirement_candidate": true,
+        "retirement_reason": "no measured usage in review window"
+      },
+      {
+        "interface": {
+          "id": "ed6451c9-d2cc-4486-9afe-d3852782cabc",
+          "interface_key": "rest_api:POST /workstreams/",
+          "interface_kind": "rest_api",
+          "legacy_since": "2026-06-04T07:40:24.168535Z",
+          "replacement_ref": "/workplans/",
+          "owner_component": "state-hub.api",
+          "status": "legacy",
+          "replacement_verified": true,
+          "manual_hold": false,
+          "hold_reason": null,
+          "notes": null,
+          "retired_at": null,
+          "created_at": "2026-06-04T07:40:24.168535Z",
+          "updated_at": "2026-06-04T07:40:24.168535Z"
+        },
+        "all_time": {
+          "calls": 824,
+          "tenant_count": 1,
+          "user_count": 1,
+          "component_count": 1,
+          "tenants": {
+            "unknown": 824
+          },
+          "users": {
+            "unknown": 824
+          },
+          "components": {
+            "unknown": 824
+          }
+        },
+        "window": {
+          "calls": 0,
+          "tenant_count": 0,
+          "user_count": 0,
+          "component_count": 0,
+          "tenants": {},
+          "users": {},
+          "components": {}
+        },
+        "last_seen_at": "2026-07-08T20:38:05.903144Z",
+        "retirement_candidate": true,
+        "retirement_reason": "no measured usage in review window"
+      },
+      {
+        "interface": {
+          "id": "281fd706-b192-4194-8055-2d8733c115f9",
+          "interface_key": "rest_api:POST /workstreams/{workstream_id}/dependencies/",
+          "interface_kind": "rest_api",
+          "legacy_since": "2026-06-04T22:57:37.149207Z",
+          "replacement_ref": "/workplans/{workplan_id}/dependencies/",
+          "owner_component": "state-hub.api",
+          "status": "legacy",
+          "replacement_verified": true,
+          "manual_hold": false,
+          "hold_reason": null,
+          "notes": null,
+          "retired_at": null,
+          "created_at": "2026-06-04T22:57:37.149207Z",
+          "updated_at": "2026-06-04T22:57:37.149207Z"
+        },
+        "all_time": {
+          "calls": 4971,
+          "tenant_count": 1,
+          "user_count": 1,
+          "component_count": 1,
+          "tenants": {
+            "unknown": 4971
+          },
+          "users": {
+            "unknown": 4971
+          },
+          "components": {
+            "unknown": 4971
+          }
+        },
+        "window": {
+          "calls": 0,
+          "tenant_count": 0,
+          "user_count": 0,
+          "component_count": 0,
+          "tenants": {},
+          "users": {},
+          "components": {}
+        },
+        "last_seen_at": "2026-07-01T22:09:24.229011Z",
+        "retirement_candidate": true,
+        "retirement_reason": "no measured usage in review window"
+      }
+    ]
+  },
+  "hours": 8
+}
diff --git a/docs/evidence/legacy-meter-weekly-review-20260731.json b/docs/evidence/legacy-meter-weekly-review-20260731.json
new file mode 100644
index 0000000..4217e66
--- /dev/null
+++ b/docs/evidence/legacy-meter-weekly-review-20260731.json
@@ -0,0 +1,1755 @@
+{
+  "captured_at": "2026-07-31T14:00:07.166750+00:00",
+  "api_base": "http://127.0.0.1:8000",
+  "workplan": "STATE-WP-0070",
+  "retired_interfaces": [],
+  "weekly_review": {
+    "generated_at": "2026-07-31T14:00:07.159705Z",
+    "window_start": "2026-07-31T06:00:07.083469Z",
+    "window_end": "2026-07-31T14:00:07.083469Z",
+    "cadence": "weekly",
+    "activity_core_handoff": {
+      "activity_id": "statehub-legacy-interface-review",
+      "cadence": "weekly",
+      "source_endpoint": "/legacy-meter/weekly-review",
+      "state_owner": "state-hub",
+      "scheduler_owner": "activity-core"
+    },
+    "interfaces": [
+      {
+        "interface": {
+          "id": "8051fb40-66c9-4dc4-a413-13e8573e04a3",
+          "interface_key": "event_subject:org.statehub.workstream.completed",
+          "interface_kind": "event_subject",
+          "legacy_since": "2026-06-04T06:09:42.198193Z",
+          "replacement_ref": "org.statehub.workplan.completed",
+          "owner_component": "state-hub.events",
+          "status": "retired",
+          "replacement_verified": true,
+          "manual_hold": false,
+          "hold_reason": null,
+          "notes": "Retired by STATE-WP-0069 closeout",
+          "retired_at": "2026-07-08T21:38:52.773601Z",
+          "created_at": "2026-06-04T06:09:42.198193Z",
+          "updated_at": "2026-07-08T21:38:52.761243Z"
+        },
+        "all_time": {
+          "calls": 255,
+          "tenant_count": 1,
+          "user_count": 1,
+          "component_count": 1,
+          "tenants": {
+            "unknown": 255
+          },
+          "users": {
+            "unknown": 255
+          },
+          "components": {
+            "state-hub.events": 255
+          }
+        },
+        "window": {
+          "calls": 0,
+          "tenant_count": 0,
+          "user_count": 0,
+          "component_count": 0,
+          "tenants": {},
+          "users": {},
+          "components": {}
+        },
+        "last_seen_at": "2026-07-08T20:49:12.839383Z",
+        "retirement_candidate": false,
+        "retirement_reason": "already retired"
+      },
+      {
+        "interface": {
+          "id": "63ed90e3-42b4-431a-94db-e1254a52f9e2",
+          "interface_key": "mcp:create_workstream",
+          "interface_kind": "mcp_tool",
+          "legacy_since": "2026-07-10T13:19:44.205900Z",
+          "replacement_ref": "create_workplan",
+          "owner_component": "state-hub.mcp",
+          "status": "legacy",
+          "replacement_verified": true,
+          "manual_hold": false,
+          "hold_reason": null,
+          "notes": "Registered by STATE-WP-0070 T03 \u2014 zero-window streak starts at registration",
+          "retired_at": null,
+          "created_at": "2026-07-10T13:19:44.205900Z",
+          "updated_at": "2026-07-10T13:19:44.205900Z"
+        },
+        "all_time": {
+          "calls": 2,
+          "tenant_count": 1,
+          "user_count": 1,
+          "component_count": 1,
+          "tenants": {
+            "unknown": 2
+          },
+          "users": {
+            "unknown": 2
+          },
+          "components": {
+            "state-hub.mcp": 2
+          }
+        },
+        "window": {
+          "calls": 0,
+          "tenant_count": 0,
+          "user_count": 0,
+          "component_count": 0,
+          "tenants": {},
+          "users": {},
+          "components": {}
+        },
+        "last_seen_at": "2026-07-10T13:20:43.378546Z",
+        "retirement_candidate": true,
+        "retirement_reason": "no measured usage in review window"
+      },
+      {
+        "interface": {
+          "id": "b6a5fe44-fb85-4ef7-a273-78d09da777af",
+          "interface_key": "mcp:list_workstreams",
+          "interface_kind": "mcp_tool",
+          "legacy_since": "2026-07-10T13:19:26.075491Z",
+          "replacement_ref": "list_workplans",
+          "owner_component": "state-hub.mcp",
+          "status": "legacy",
+          "replacement_verified": true,
+          "manual_hold": false,
+          "hold_reason": null,
+          "notes": null,
+          "retired_at": null,
+          "created_at": "2026-07-10T13:19:26.075491Z",
+          "updated_at": "2026-07-10T13:19:26.075491Z"
+        },
+        "all_time": {
+          "calls": 2,
+          "tenant_count": 1,
+          "user_count": 1,
+          "component_count": 1,
+          "tenants": {
+            "unknown": 2
+          },
+          "users": {
+            "unknown": 2
+          },
+          "components": {
+            "state-hub.mcp": 2
+          }
+        },
+        "window": {
+          "calls": 0,
+          "tenant_count": 0,
+          "user_count": 0,
+          "component_count": 0,
+          "tenants": {},
+          "users": {},
+          "components": {}
+        },
+        "last_seen_at": "2026-07-10T13:20:42.374940Z",
+        "retirement_candidate": true,
+        "retirement_reason": "no measured usage in review window"
+      },
+      {
+        "interface": {
+          "id": "53c3372b-307d-4d6a-8ea4-bc36cacdcaf2",
+          "interface_key": "mcp:update_workstream",
+          "interface_kind": "mcp_tool",
+          "legacy_since": "2026-07-10T13:19:44.255216Z",
+          "replacement_ref": "update_workplan",
+          "owner_component": "state-hub.mcp",
+          "status": "legacy",
+          "replacement_verified": true,
+          "manual_hold": false,
+          "hold_reason": null,
+          "notes": "Registered by STATE-WP-0070 T03 \u2014 zero-window streak starts at registration",
+          "retired_at": null,
+          "created_at": "2026-07-10T13:19:44.255216Z",
+          "updated_at": "2026-07-10T13:19:44.255216Z"
+        },
+        "all_time": {
+          "calls": 0,
+          "tenant_count": 0,
+          "user_count": 0,
+          "component_count": 0,
+          "tenants": {},
+          "users": {},
+          "components": {}
+        },
+        "window": {
+          "calls": 0,
+          "tenant_count": 0,
+          "user_count": 0,
+          "component_count": 0,
+          "tenants": {},
+          "users": {},
+          "components": {}
+        },
+        "last_seen_at": null,
+        "retirement_candidate": true,
+        "retirement_reason": "no measured usage in review window"
+      },
+      {
+        "interface": {
+          "id": "bed4d08a-3471-48f5-9f0e-f9d550383a26",
+          "interface_key": "mcp:update_workstream_status",
+          "interface_kind": "mcp_tool",
+          "legacy_since": "2026-07-10T13:19:44.303612Z",
+          "replacement_ref": "update_workplan_status",
+          "owner_component": "state-hub.mcp",
+          "status": "legacy",
+          "replacement_verified": true,
+          "manual_hold": false,
+          "hold_reason": null,
+          "notes": "Registered by STATE-WP-0070 T03 \u2014 zero-window streak starts at registration",
+          "retired_at": null,
+          "created_at": "2026-07-10T13:19:44.303612Z",
+          "updated_at": "2026-07-10T13:19:44.303612Z"
+        },
+        "all_time": {
+          "calls": 0,
+          "tenant_count": 0,
+          "user_count": 0,
+          "component_count": 0,
+          "tenants": {},
+          "users": {},
+          "components": {}
+        },
+        "window": {
+          "calls": 0,
+          "tenant_count": 0,
+          "user_count": 0,
+          "component_count": 0,
+          "tenants": {},
+          "users": {},
+          "components": {}
+        },
+        "last_seen_at": null,
+        "retirement_candidate": true,
+        "retirement_reason": "no measured usage in review window"
+      },
+      {
+        "interface": {
+          "id": "46900dc2-0893-405b-ba59-80f31fb6ebb1",
+          "interface_key": "state://workstreams/{topic_slug}",
+          "interface_kind": "mcp_tool",
+          "legacy_since": "2026-07-10T13:19:44.344493Z",
+          "replacement_ref": "state://workplans/{topic_slug}",
+          "owner_component": "state-hub.mcp",
+          "status": "legacy",
+          "replacement_verified": true,
+          "manual_hold": false,
+          "hold_reason": null,
+          "notes": "Registered by STATE-WP-0070 T03 \u2014 zero-window streak starts at registration",
+          "retired_at": null,
+          "created_at": "2026-07-10T13:19:44.344493Z",
+          "updated_at": "2026-07-10T13:19:44.344493Z"
+        },
+        "all_time": {
+          "calls": 1,
+          "tenant_count": 1,
+          "user_count": 1,
+          "component_count": 1,
+          "tenants": {
+            "unknown": 1
+          },
+          "users": {
+            "unknown": 1
+          },
+          "components": {
+            "state-hub.mcp": 1
+          }
+        },
+        "window": {
+          "calls": 0,
+          "tenant_count": 0,
+          "user_count": 0,
+          "component_count": 0,
+          "tenants": {},
+          "users": {},
+          "components": {}
+        },
+        "last_seen_at": "2026-07-10T13:20:34.491811Z",
+        "retirement_candidate": true,
+        "retirement_reason": "no measured usage in review window"
+      },
+      {
+        "interface": {
+          "id": "cd9342fd-27e7-4a46-a1be-d41499e106a3",
+          "interface_key": "rest_api:DELETE /workstreams/{workstream_id}",
+          "interface_kind": "rest_api",
+          "legacy_since": "2026-06-06T17:28:13.052813Z",
+          "replacement_ref": "/workplans/{workplan_id}",
+          "owner_component": "state-hub.api",
+          "status": "legacy",
+          "replacement_verified": true,
+          "manual_hold": false,
+          "hold_reason": null,
+          "notes": null,
+          "retired_at": null,
+          "created_at": "2026-06-06T17:28:13.052813Z",
+          "updated_at": "2026-06-06T17:28:13.052813Z"
+        },
+        "all_time": {
+          "calls": 1,
+          "tenant_count": 1,
+          "user_count": 1,
+          "component_count": 1,
+          "tenants": {
+            "unknown": 1
+          },
+          "users": {
+            "unknown": 1
+          },
+          "components": {
+            "unknown": 1
+          }
+        },
+        "window": {
+          "calls": 0,
+          "tenant_count": 0,
+          "user_count": 0,
+          "component_count": 0,
+          "tenants": {},
+          "users": {},
+          "components": {}
+        },
+        "last_seen_at": "2026-06-06T17:28:13.047529Z",
+        "retirement_candidate": true,
+        "retirement_reason": "no measured usage in review window"
+      },
+      {
+        "interface": {
+          "id": "a4e0948c-cd4a-461e-8ae2-7fd7b51d04a7",
+          "interface_key": "rest_api:GET /decisions/?workstream_id",
+          "interface_kind": "rest_api",
+          "legacy_since": "2026-07-09T23:07:53.093223Z",
+          "replacement_ref": "/decisions/?workplan_id=<workplan_id>",
+          "owner_component": "state-hub.api",
+          "status": "legacy",
+          "replacement_verified": true,
+          "manual_hold": false,
+          "hold_reason": null,
+          "notes": null,
+          "retired_at": null,
+          "created_at": "2026-07-09T23:07:53.093223Z",
+          "updated_at": "2026-07-09T23:07:53.093223Z"
+        },
+        "all_time": {
+          "calls": 1,
+          "tenant_count": 1,
+          "user_count": 1,
+          "component_count": 1,
+          "tenants": {
+            "unknown": 1
+          },
+          "users": {
+            "unknown": 1
+          },
+          "components": {
+            "unknown": 1
+          }
+        },
+        "window": {
+          "calls": 0,
+          "tenant_count": 0,
+          "user_count": 0,
+          "component_count": 0,
+          "tenants": {},
+          "users": {},
+          "components": {}
+        },
+        "last_seen_at": "2026-07-09T23:07:53.083299Z",
+        "retirement_candidate": true,
+        "retirement_reason": "no measured usage in review window"
+      },
+      {
+        "interface": {
+          "id": "70a9346e-e0ee-42ac-874f-f160580b54dd",
+          "interface_key": "rest_api:GET /progress/?workstream_id",
+          "interface_kind": "rest_api",
+          "legacy_since": "2026-07-13T22:04:03.911449Z",
+          "replacement_ref": "/progress/?workplan_id=<workplan_id>",
+          "owner_component": "state-hub.api",
+          "status": "legacy",
+          "replacement_verified": true,
+          "manual_hold": false,
+          "hold_reason": null,
+          "notes": null,
+          "retired_at": null,
+          "created_at": "2026-07-13T22:04:03.911449Z",
+          "updated_at": "2026-07-13T22:04:03.911449Z"
+        },
+        "all_time": {
+          "calls": 1,
+          "tenant_count": 1,
+          "user_count": 1,
+          "component_count": 1,
+          "tenants": {
+            "unknown": 1
+          },
+          "users": {
+            "unknown": 1
+          },
+          "components": {
+            "unknown": 1
+          }
+        },
+        "window": {
+          "calls": 0,
+          "tenant_count": 0,
+          "user_count": 0,
+          "component_count": 0,
+          "tenants": {},
+          "users": {},
+          "components": {}
+        },
+        "last_seen_at": "2026-07-13T22:04:03.904998Z",
+        "retirement_candidate": true,
+        "retirement_reason": "no measured usage in review window"
+      },
+      {
+        "interface": {
+          "id": "be3cdcf8-250b-4bf0-801f-02ffd5f57e00",
+          "interface_key": "rest_api:GET /tasks/?workstream_id",
+          "interface_kind": "rest_api",
+          "legacy_since": "2026-07-08T19:32:21.628513Z",
+          "replacement_ref": "/tasks/?workplan_id=<workplan_id>",
+          "owner_component": "state-hub.api",
+          "status": "legacy",
+          "replacement_verified": true,
+          "manual_hold": false,
+          "hold_reason": null,
+          "notes": null,
+          "retired_at": null,
+          "created_at": "2026-07-08T19:32:21.628513Z",
+          "updated_at": "2026-07-08T19:32:21.628513Z"
+        },
+        "all_time": {
+          "calls": 587,
+          "tenant_count": 1,
+          "user_count": 1,
+          "component_count": 1,
+          "tenants": {
+            "unknown": 587
+          },
+          "users": {
+            "unknown": 587
+          },
+          "components": {
+            "unknown": 587
+          }
+        },
+        "window": {
+          "calls": 0,
+          "tenant_count": 0,
+          "user_count": 0,
+          "component_count": 0,
+          "tenants": {},
+          "users": {},
+          "components": {}
+        },
+        "last_seen_at": "2026-07-22T13:21:12.171828Z",
+        "retirement_candidate": true,
+        "retirement_reason": "no measured usage in review window"
+      },
+      {
+        "interface": {
+          "id": "3e4a3d0b-08fa-45c3-91e2-4f514a914b97",
+          "interface_key": "rest_api:GET /workstreams/",
+          "interface_kind": "rest_api",
+          "legacy_since": "2026-06-04T00:26:14.533764Z",
+          "replacement_ref": "/workplans/",
+          "owner_component": "state-hub.api",
+          "status": "legacy",
+          "replacement_verified": true,
+          "manual_hold": false,
+          "hold_reason": null,
+          "notes": null,
+          "retired_at": null,
+          "created_at": "2026-06-04T00:26:14.533764Z",
+          "updated_at": "2026-06-04T00:26:14.533764Z"
+        },
+        "all_time": {
+          "calls": 144084,
+          "tenant_count": 1,
+          "user_count": 1,
+          "component_count": 1,
+          "tenants": {
+            "unknown": 144084
+          },
+          "users": {
+            "unknown": 144084
+          },
+          "components": {
+            "unknown": 144084
+          }
+        },
+        "window": {
+          "calls": 0,
+          "tenant_count": 0,
+          "user_count": 0,
+          "component_count": 0,
+          "tenants": {},
+          "users": {},
+          "components": {}
+        },
+        "last_seen_at": "2026-07-08T21:14:39.652776Z",
+        "retirement_candidate": true,
+        "retirement_reason": "no measured usage in review window"
+      },
+      {
+        "interface": {
+          "id": "e4c140ec-7479-46f9-b185-4b533f19d639",
+          "interface_key": "rest_api:GET /workstreams/workplan-index",
+          "interface_kind": "rest_api",
+          "legacy_since": "2026-06-04T05:20:58.321869Z",
+          "replacement_ref": "/workplans/index",
+          "owner_component": "state-hub.api",
+          "status": "legacy",
+          "replacement_verified": true,
+          "manual_hold": false,
+          "hold_reason": null,
+          "notes": null,
+          "retired_at": null,
+          "created_at": "2026-06-04T05:20:58.321869Z",
+          "updated_at": "2026-06-04T05:20:58.321869Z"
+        },
+        "all_time": {
+          "calls": 30,
+          "tenant_count": 1,
+          "user_count": 1,
+          "component_count": 1,
+          "tenants": {
+            "unknown": 30
+          },
+          "users": {
+            "unknown": 30
+          },
+          "components": {
+            "unknown": 30
+          }
+        },
+        "window": {
+          "calls": 0,
+          "tenant_count": 0,
+          "user_count": 0,
+          "component_count": 0,
+          "tenants": {},
+          "users": {},
+          "components": {}
+        },
+        "last_seen_at": "2026-07-03T05:20:34.534439Z",
+        "retirement_candidate": true,
+        "retirement_reason": "no measured usage in review window"
+      },
+      {
+        "interface": {
+          "id": "3a00b19e-e7db-4403-98aa-a77c9ab61ecc",
+          "interface_key": "rest_api:GET /workstreams/{workstream_id}",
+          "interface_kind": "rest_api",
+          "legacy_since": "2026-06-04T00:25:59.014966Z",
+          "replacement_ref": "/workplans/{workplan_id}",
+          "owner_component": "state-hub.api",
+          "status": "legacy",
+          "replacement_verified": true,
+          "manual_hold": false,
+          "hold_reason": null,
+          "notes": null,
+          "retired_at": null,
+          "created_at": "2026-06-04T00:25:59.014966Z",
+          "updated_at": "2026-06-04T00:25:59.014966Z"
+        },
+        "all_time": {
+          "calls": 511405,
+          "tenant_count": 1,
+          "user_count": 1,
+          "component_count": 1,
+          "tenants": {
+            "unknown": 511405
+          },
+          "users": {
+            "unknown": 511405
+          },
+          "components": {
+            "unknown": 511405
+          }
+        },
+        "window": {
+          "calls": 0,
+          "tenant_count": 0,
+          "user_count": 0,
+          "component_count": 0,
+          "tenants": {},
+          "users": {},
+          "components": {}
+        },
+        "last_seen_at": "2026-07-08T21:14:20.781103Z",
+        "retirement_candidate": true,
+        "retirement_reason": "no measured usage in review window"
+      },
+      {
+        "interface": {
+          "id": "69e1a255-a8b9-4101-8a68-b1bed23abfda",
+          "interface_key": "rest_api:GET /workstreams/{workstream_id}/dependencies/",
+          "interface_kind": "rest_api",
+          "legacy_since": "2026-06-04T00:25:59.291135Z",
+          "replacement_ref": "/workplans/{workplan_id}/dependencies/",
+          "owner_component": "state-hub.api",
+          "status": "legacy",
+          "replacement_verified": true,
+          "manual_hold": false,
+          "hold_reason": null,
+          "notes": null,
+          "retired_at": null,
+          "created_at": "2026-06-04T00:25:59.291135Z",
+          "updated_at": "2026-06-04T00:25:59.291135Z"
+        },
+        "all_time": {
+          "calls": 255865,
+          "tenant_count": 1,
+          "user_count": 1,
+          "component_count": 1,
+          "tenants": {
+            "unknown": 255865
+          },
+          "users": {
+            "unknown": 255865
+          },
+          "components": {
+            "unknown": 255865
+          }
+        },
+        "window": {
+          "calls": 0,
+          "tenant_count": 0,
+          "user_count": 0,
+          "component_count": 0,
+          "tenants": {},
+          "users": {},
+          "components": {}
+        },
+        "last_seen_at": "2026-07-08T21:14:12.747005Z",
+        "retirement_candidate": true,
+        "retirement_reason": "no measured usage in review window"
+      },
+      {
+        "interface": {
+          "id": "b1aae931-b51f-4a85-a723-865dd65f6132",
+          "interface_key": "rest_api:PATCH /workstreams/{workstream_id}",
+          "interface_kind": "rest_api",
+          "legacy_since": "2026-06-04T06:09:41.901035Z",
+          "replacement_ref": "/workplans/{workplan_id}",
+          "owner_component": "state-hub.api",
+          "status": "legacy",
+          "replacement_verified": true,
+          "manual_hold": false,
+          "hold_reason": null,
+          "notes": null,
+          "retired_at": null,
+          "created_at": "2026-06-04T06:09:41.901035Z",
+          "updated_at": "2026-06-04T06:09:41.901035Z"
+        },
+        "all_time": {
+          "calls": 571,
+          "tenant_count": 1,
+          "user_count": 1,
+          "component_count": 1,
+          "tenants": {
+            "unknown": 571
+          },
+          "users": {
+            "unknown": 571
+          },
+          "components": {
+            "unknown": 571
+          }
+        },
+        "window": {
+          "calls": 0,
+          "tenant_count": 0,
+          "user_count": 0,
+          "component_count": 0,
+          "tenants": {},
+          "users": {},
+          "components": {}
+        },
+        "last_seen_at": "2026-07-08T20:49:12.335710Z",
+        "retirement_candidate": true,
+        "retirement_reason": "no measured usage in review window"
+      },
+      {
+        "interface": {
+          "id": "4aea9591-970b-4918-ac4a-4da95a0a1a8c",
+          "interface_key": "rest_api:POST /decisions/ workstream_id",
+          "interface_kind": "rest_api",
+          "legacy_since": "2026-07-09T22:56:35.473130Z",
+          "replacement_ref": "POST /decisions/ with workplan_id",
+          "owner_component": "state-hub.api",
+          "status": "legacy",
+          "replacement_verified": true,
+          "manual_hold": false,
+          "hold_reason": null,
+          "notes": null,
+          "retired_at": null,
+          "created_at": "2026-07-09T22:56:35.473130Z",
+          "updated_at": "2026-07-09T22:56:35.473130Z"
+        },
+        "all_time": {
+          "calls": 3,
+          "tenant_count": 1,
+          "user_count": 1,
+          "component_count": 1,
+          "tenants": {
+            "unknown": 3
+          },
+          "users": {
+            "unknown": 3
+          },
+          "components": {
+            "unknown": 3
+          }
+        },
+        "window": {
+          "calls": 0,
+          "tenant_count": 0,
+          "user_count": 0,
+          "component_count": 0,
+          "tenants": {},
+          "users": {},
+          "components": {}
+        },
+        "last_seen_at": "2026-07-09T22:57:05.912456Z",
+        "retirement_candidate": true,
+        "retirement_reason": "no measured usage in review window"
+      },
+      {
+        "interface": {
+          "id": "4a70583c-1e41-4ec1-99a9-728856a7d79c",
+          "interface_key": "rest_api:POST /progress/ workstream_id",
+          "interface_kind": "rest_api",
+          "legacy_since": "2026-07-08T23:35:09.148333Z",
+          "replacement_ref": "POST /progress/ with workplan_id",
+          "owner_component": "state-hub.api",
+          "status": "legacy",
+          "replacement_verified": true,
+          "manual_hold": false,
+          "hold_reason": null,
+          "notes": null,
+          "retired_at": null,
+          "created_at": "2026-07-08T23:35:09.148333Z",
+          "updated_at": "2026-07-08T23:35:09.148333Z"
+        },
+        "all_time": {
+          "calls": 14,
+          "tenant_count": 1,
+          "user_count": 1,
+          "component_count": 1,
+          "tenants": {
+            "unknown": 14
+          },
+          "users": {
+            "unknown": 14
+          },
+          "components": {
+            "unknown": 14
+          }
+        },
+        "window": {
+          "calls": 0,
+          "tenant_count": 0,
+          "user_count": 0,
+          "component_count": 0,
+          "tenants": {},
+          "users": {},
+          "components": {}
+        },
+        "last_seen_at": "2026-07-10T08:34:42.959724Z",
+        "retirement_candidate": true,
+        "retirement_reason": "no measured usage in review window"
+      },
+      {
+        "interface": {
+          "id": "6df4e443-7bf1-461a-923b-a6eb52fe7b07",
+          "interface_key": "rest_api:POST /tasks/ workstream_id",
+          "interface_kind": "rest_api",
+          "legacy_since": "2026-07-08T22:38:29.405720Z",
+          "replacement_ref": "POST /tasks/ with workplan_id",
+          "owner_component": "state-hub.api",
+          "status": "legacy",
+          "replacement_verified": true,
+          "manual_hold": false,
+          "hold_reason": null,
+          "notes": null,
+          "retired_at": null,
+          "created_at": "2026-07-08T22:38:29.405720Z",
+          "updated_at": "2026-07-08T22:38:29.405720Z"
+        },
+        "all_time": {
+          "calls": 5,
+          "tenant_count": 1,
+          "user_count": 1,
+          "component_count": 1,
+          "tenants": {
+            "unknown": 5
+          },
+          "users": {
+            "unknown": 5
+          },
+          "components": {
+            "state-hub.fix-consistency": 5
+          }
+        },
+        "window": {
+          "calls": 0,
+          "tenant_count": 0,
+          "user_count": 0,
+          "component_count": 0,
+          "tenants": {},
+          "users": {},
+          "components": {}
+        },
+        "last_seen_at": "2026-07-08T22:38:29.976918Z",
+        "retirement_candidate": true,
+        "retirement_reason": "no measured usage in review window"
+      },
+      {
+        "interface": {
+          "id": "ed6451c9-d2cc-4486-9afe-d3852782cabc",
+          "interface_key": "rest_api:POST /workstreams/",
+          "interface_kind": "rest_api",
+          "legacy_since": "2026-06-04T07:40:24.168535Z",
+          "replacement_ref": "/workplans/",
+          "owner_component": "state-hub.api",
+          "status": "legacy",
+          "replacement_verified": true,
+          "manual_hold": false,
+          "hold_reason": null,
+          "notes": null,
+          "retired_at": null,
+          "created_at": "2026-06-04T07:40:24.168535Z",
+          "updated_at": "2026-06-04T07:40:24.168535Z"
+        },
+        "all_time": {
+          "calls": 824,
+          "tenant_count": 1,
+          "user_count": 1,
+          "component_count": 1,
+          "tenants": {
+            "unknown": 824
+          },
+          "users": {
+            "unknown": 824
+          },
+          "components": {
+            "unknown": 824
+          }
+        },
+        "window": {
+          "calls": 0,
+          "tenant_count": 0,
+          "user_count": 0,
+          "component_count": 0,
+          "tenants": {},
+          "users": {},
+          "components": {}
+        },
+        "last_seen_at": "2026-07-08T20:38:05.903144Z",
+        "retirement_candidate": true,
+        "retirement_reason": "no measured usage in review window"
+      },
+      {
+        "interface": {
+          "id": "281fd706-b192-4194-8055-2d8733c115f9",
+          "interface_key": "rest_api:POST /workstreams/{workstream_id}/dependencies/",
+          "interface_kind": "rest_api",
+          "legacy_since": "2026-06-04T22:57:37.149207Z",
+          "replacement_ref": "/workplans/{workplan_id}/dependencies/",
+          "owner_component": "state-hub.api",
+          "status": "legacy",
+          "replacement_verified": true,
+          "manual_hold": false,
+          "hold_reason": null,
+          "notes": null,
+          "retired_at": null,
+          "created_at": "2026-06-04T22:57:37.149207Z",
+          "updated_at": "2026-06-04T22:57:37.149207Z"
+        },
+        "all_time": {
+          "calls": 4971,
+          "tenant_count": 1,
+          "user_count": 1,
+          "component_count": 1,
+          "tenants": {
+            "unknown": 4971
+          },
+          "users": {
+            "unknown": 4971
+          },
+          "components": {
+            "unknown": 4971
+          }
+        },
+        "window": {
+          "calls": 0,
+          "tenant_count": 0,
+          "user_count": 0,
+          "component_count": 0,
+          "tenants": {},
+          "users": {},
+          "components": {}
+        },
+        "last_seen_at": "2026-07-01T22:09:24.229011Z",
+        "retirement_candidate": true,
+        "retirement_reason": "no measured usage in review window"
+      }
+    ],
+    "retirement_candidates": [
+      {
+        "interface": {
+          "id": "63ed90e3-42b4-431a-94db-e1254a52f9e2",
+          "interface_key": "mcp:create_workstream",
+          "interface_kind": "mcp_tool",
+          "legacy_since": "2026-07-10T13:19:44.205900Z",
+          "replacement_ref": "create_workplan",
+          "owner_component": "state-hub.mcp",
+          "status": "legacy",
+          "replacement_verified": true,
+          "manual_hold": false,
+          "hold_reason": null,
+          "notes": "Registered by STATE-WP-0070 T03 \u2014 zero-window streak starts at registration",
+          "retired_at": null,
+          "created_at": "2026-07-10T13:19:44.205900Z",
+          "updated_at": "2026-07-10T13:19:44.205900Z"
+        },
+        "all_time": {
+          "calls": 2,
+          "tenant_count": 1,
+          "user_count": 1,
+          "component_count": 1,
+          "tenants": {
+            "unknown": 2
+          },
+          "users": {
+            "unknown": 2
+          },
+          "components": {
+            "state-hub.mcp": 2
+          }
+        },
+        "window": {
+          "calls": 0,
+          "tenant_count": 0,
+          "user_count": 0,
+          "component_count": 0,
+          "tenants": {},
+          "users": {},
+          "components": {}
+        },
+        "last_seen_at": "2026-07-10T13:20:43.378546Z",
+        "retirement_candidate": true,
+        "retirement_reason": "no measured usage in review window"
+      },
+      {
+        "interface": {
+          "id": "b6a5fe44-fb85-4ef7-a273-78d09da777af",
+          "interface_key": "mcp:list_workstreams",
+          "interface_kind": "mcp_tool",
+          "legacy_since": "2026-07-10T13:19:26.075491Z",
+          "replacement_ref": "list_workplans",
+          "owner_component": "state-hub.mcp",
+          "status": "legacy",
+          "replacement_verified": true,
+          "manual_hold": false,
+          "hold_reason": null,
+          "notes": null,
+          "retired_at": null,
+          "created_at": "2026-07-10T13:19:26.075491Z",
+          "updated_at": "2026-07-10T13:19:26.075491Z"
+        },
+        "all_time": {
+          "calls": 2,
+          "tenant_count": 1,
+          "user_count": 1,
+          "component_count": 1,
+          "tenants": {
+            "unknown": 2
+          },
+          "users": {
+            "unknown": 2
+          },
+          "components": {
+            "state-hub.mcp": 2
+          }
+        },
+        "window": {
+          "calls": 0,
+          "tenant_count": 0,
+          "user_count": 0,
+          "component_count": 0,
+          "tenants": {},
+          "users": {},
+          "components": {}
+        },
+        "last_seen_at": "2026-07-10T13:20:42.374940Z",
+        "retirement_candidate": true,
+        "retirement_reason": "no measured usage in review window"
+      },
+      {
+        "interface": {
+          "id": "53c3372b-307d-4d6a-8ea4-bc36cacdcaf2",
+          "interface_key": "mcp:update_workstream",
+          "interface_kind": "mcp_tool",
+          "legacy_since": "2026-07-10T13:19:44.255216Z",
+          "replacement_ref": "update_workplan",
+          "owner_component": "state-hub.mcp",
+          "status": "legacy",
+          "replacement_verified": true,
+          "manual_hold": false,
+          "hold_reason": null,
+          "notes": "Registered by STATE-WP-0070 T03 \u2014 zero-window streak starts at registration",
+          "retired_at": null,
+          "created_at": "2026-07-10T13:19:44.255216Z",
+          "updated_at": "2026-07-10T13:19:44.255216Z"
+        },
+        "all_time": {
+          "calls": 0,
+          "tenant_count": 0,
+          "user_count": 0,
+          "component_count": 0,
+          "tenants": {},
+          "users": {},
+          "components": {}
+        },
+        "window": {
+          "calls": 0,
+          "tenant_count": 0,
+          "user_count": 0,
+          "component_count": 0,
+          "tenants": {},
+          "users": {},
+          "components": {}
+        },
+        "last_seen_at": null,
+        "retirement_candidate": true,
+        "retirement_reason": "no measured usage in review window"
+      },
+      {
+        "interface": {
+          "id": "bed4d08a-3471-48f5-9f0e-f9d550383a26",
+          "interface_key": "mcp:update_workstream_status",
+          "interface_kind": "mcp_tool",
+          "legacy_since": "2026-07-10T13:19:44.303612Z",
+          "replacement_ref": "update_workplan_status",
+          "owner_component": "state-hub.mcp",
+          "status": "legacy",
+          "replacement_verified": true,
+          "manual_hold": false,
+          "hold_reason": null,
+          "notes": "Registered by STATE-WP-0070 T03 \u2014 zero-window streak starts at registration",
+          "retired_at": null,
+          "created_at": "2026-07-10T13:19:44.303612Z",
+          "updated_at": "2026-07-10T13:19:44.303612Z"
+        },
+        "all_time": {
+          "calls": 0,
+          "tenant_count": 0,
+          "user_count": 0,
+          "component_count": 0,
+          "tenants": {},
+          "users": {},
+          "components": {}
+        },
+        "window": {
+          "calls": 0,
+          "tenant_count": 0,
+          "user_count": 0,
+          "component_count": 0,
+          "tenants": {},
+          "users": {},
+          "components": {}
+        },
+        "last_seen_at": null,
+        "retirement_candidate": true,
+        "retirement_reason": "no measured usage in review window"
+      },
+      {
+        "interface": {
+          "id": "46900dc2-0893-405b-ba59-80f31fb6ebb1",
+          "interface_key": "state://workstreams/{topic_slug}",
+          "interface_kind": "mcp_tool",
+          "legacy_since": "2026-07-10T13:19:44.344493Z",
+          "replacement_ref": "state://workplans/{topic_slug}",
+          "owner_component": "state-hub.mcp",
+          "status": "legacy",
+          "replacement_verified": true,
+          "manual_hold": false,
+          "hold_reason": null,
+          "notes": "Registered by STATE-WP-0070 T03 \u2014 zero-window streak starts at registration",
+          "retired_at": null,
+          "created_at": "2026-07-10T13:19:44.344493Z",
+          "updated_at": "2026-07-10T13:19:44.344493Z"
+        },
+        "all_time": {
+          "calls": 1,
+          "tenant_count": 1,
+          "user_count": 1,
+          "component_count": 1,
+          "tenants": {
+            "unknown": 1
+          },
+          "users": {
+            "unknown": 1
+          },
+          "components": {
+            "state-hub.mcp": 1
+          }
+        },
+        "window": {
+          "calls": 0,
+          "tenant_count": 0,
+          "user_count": 0,
+          "component_count": 0,
+          "tenants": {},
+          "users": {},
+          "components": {}
+        },
+        "last_seen_at": "2026-07-10T13:20:34.491811Z",
+        "retirement_candidate": true,
+        "retirement_reason": "no measured usage in review window"
+      },
+      {
+        "interface": {
+          "id": "cd9342fd-27e7-4a46-a1be-d41499e106a3",
+          "interface_key": "rest_api:DELETE /workstreams/{workstream_id}",
+          "interface_kind": "rest_api",
+          "legacy_since": "2026-06-06T17:28:13.052813Z",
+          "replacement_ref": "/workplans/{workplan_id}",
+          "owner_component": "state-hub.api",
+          "status": "legacy",
+          "replacement_verified": true,
+          "manual_hold": false,
+          "hold_reason": null,
+          "notes": null,
+          "retired_at": null,
+          "created_at": "2026-06-06T17:28:13.052813Z",
+          "updated_at": "2026-06-06T17:28:13.052813Z"
+        },
+        "all_time": {
+          "calls": 1,
+          "tenant_count": 1,
+          "user_count": 1,
+          "component_count": 1,
+          "tenants": {
+            "unknown": 1
+          },
+          "users": {
+            "unknown": 1
+          },
+          "components": {
+            "unknown": 1
+          }
+        },
+        "window": {
+          "calls": 0,
+          "tenant_count": 0,
+          "user_count": 0,
+          "component_count": 0,
+          "tenants": {},
+          "users": {},
+          "components": {}
+        },
+        "last_seen_at": "2026-06-06T17:28:13.047529Z",
+        "retirement_candidate": true,
+        "retirement_reason": "no measured usage in review window"
+      },
+      {
+        "interface": {
+          "id": "a4e0948c-cd4a-461e-8ae2-7fd7b51d04a7",
+          "interface_key": "rest_api:GET /decisions/?workstream_id",
+          "interface_kind": "rest_api",
+          "legacy_since": "2026-07-09T23:07:53.093223Z",
+          "replacement_ref": "/decisions/?workplan_id=<workplan_id>",
+          "owner_component": "state-hub.api",
+          "status": "legacy",
+          "replacement_verified": true,
+          "manual_hold": false,
+          "hold_reason": null,
+          "notes": null,
+          "retired_at": null,
+          "created_at": "2026-07-09T23:07:53.093223Z",
+          "updated_at": "2026-07-09T23:07:53.093223Z"
+        },
+        "all_time": {
+          "calls": 1,
+          "tenant_count": 1,
+          "user_count": 1,
+          "component_count": 1,
+          "tenants": {
+            "unknown": 1
+          },
+          "users": {
+            "unknown": 1
+          },
+          "components": {
+            "unknown": 1
+          }
+        },
+        "window": {
+          "calls": 0,
+          "tenant_count": 0,
+          "user_count": 0,
+          "component_count": 0,
+          "tenants": {},
+          "users": {},
+          "components": {}
+        },
+        "last_seen_at": "2026-07-09T23:07:53.083299Z",
+        "retirement_candidate": true,
+        "retirement_reason": "no measured usage in review window"
+      },
+      {
+        "interface": {
+          "id": "70a9346e-e0ee-42ac-874f-f160580b54dd",
+          "interface_key": "rest_api:GET /progress/?workstream_id",
+          "interface_kind": "rest_api",
+          "legacy_since": "2026-07-13T22:04:03.911449Z",
+          "replacement_ref": "/progress/?workplan_id=<workplan_id>",
+          "owner_component": "state-hub.api",
+          "status": "legacy",
+          "replacement_verified": true,
+          "manual_hold": false,
+          "hold_reason": null,
+          "notes": null,
+          "retired_at": null,
+          "created_at": "2026-07-13T22:04:03.911449Z",
+          "updated_at": "2026-07-13T22:04:03.911449Z"
+        },
+        "all_time": {
+          "calls": 1,
+          "tenant_count": 1,
+          "user_count": 1,
+          "component_count": 1,
+          "tenants": {
+            "unknown": 1
+          },
+          "users": {
+            "unknown": 1
+          },
+          "components": {
+            "unknown": 1
+          }
+        },
+        "window": {
+          "calls": 0,
+          "tenant_count": 0,
+          "user_count": 0,
+          "component_count": 0,
+          "tenants": {},
+          "users": {},
+          "components": {}
+        },
+        "last_seen_at": "2026-07-13T22:04:03.904998Z",
+        "retirement_candidate": true,
+        "retirement_reason": "no measured usage in review window"
+      },
+      {
+        "interface": {
+          "id": "be3cdcf8-250b-4bf0-801f-02ffd5f57e00",
+          "interface_key": "rest_api:GET /tasks/?workstream_id",
+          "interface_kind": "rest_api",
+          "legacy_since": "2026-07-08T19:32:21.628513Z",
+          "replacement_ref": "/tasks/?workplan_id=<workplan_id>",
+          "owner_component": "state-hub.api",
+          "status": "legacy",
+          "replacement_verified": true,
+          "manual_hold": false,
+          "hold_reason": null,
+          "notes": null,
+          "retired_at": null,
+          "created_at": "2026-07-08T19:32:21.628513Z",
+          "updated_at": "2026-07-08T19:32:21.628513Z"
+        },
+        "all_time": {
+          "calls": 587,
+          "tenant_count": 1,
+          "user_count": 1,
+          "component_count": 1,
+          "tenants": {
+            "unknown": 587
+          },
+          "users": {
+            "unknown": 587
+          },
+          "components": {
+            "unknown": 587
+          }
+        },
+        "window": {
+          "calls": 0,
+          "tenant_count": 0,
+          "user_count": 0,
+          "component_count": 0,
+          "tenants": {},
+          "users": {},
+          "components": {}
+        },
+        "last_seen_at": "2026-07-22T13:21:12.171828Z",
+        "retirement_candidate": true,
+        "retirement_reason": "no measured usage in review window"
+      },
+      {
+        "interface": {
+          "id": "3e4a3d0b-08fa-45c3-91e2-4f514a914b97",
+          "interface_key": "rest_api:GET /workstreams/",
+          "interface_kind": "rest_api",
+          "legacy_since": "2026-06-04T00:26:14.533764Z",
+          "replacement_ref": "/workplans/",
+          "owner_component": "state-hub.api",
+          "status": "legacy",
+          "replacement_verified": true,
+          "manual_hold": false,
+          "hold_reason": null,
+          "notes": null,
+          "retired_at": null,
+          "created_at": "2026-06-04T00:26:14.533764Z",
+          "updated_at": "2026-06-04T00:26:14.533764Z"
+        },
+        "all_time": {
+          "calls": 144084,
+          "tenant_count": 1,
+          "user_count": 1,
+          "component_count": 1,
+          "tenants": {
+            "unknown": 144084
+          },
+          "users": {
+            "unknown": 144084
+          },
+          "components": {
+            "unknown": 144084
+          }
+        },
+        "window": {
+          "calls": 0,
+          "tenant_count": 0,
+          "user_count": 0,
+          "component_count": 0,
+          "tenants": {},
+          "users": {},
+          "components": {}
+        },
+        "last_seen_at": "2026-07-08T21:14:39.652776Z",
+        "retirement_candidate": true,
+        "retirement_reason": "no measured usage in review window"
+      },
+      {
+        "interface": {
+          "id": "e4c140ec-7479-46f9-b185-4b533f19d639",
+          "interface_key": "rest_api:GET /workstreams/workplan-index",
+          "interface_kind": "rest_api",
+          "legacy_since": "2026-06-04T05:20:58.321869Z",
+          "replacement_ref": "/workplans/index",
+          "owner_component": "state-hub.api",
+          "status": "legacy",
+          "replacement_verified": true,
+          "manual_hold": false,
+          "hold_reason": null,
+          "notes": null,
+          "retired_at": null,
+          "created_at": "2026-06-04T05:20:58.321869Z",
+          "updated_at": "2026-06-04T05:20:58.321869Z"
+        },
+        "all_time": {
+          "calls": 30,
+          "tenant_count": 1,
+          "user_count": 1,
+          "component_count": 1,
+          "tenants": {
+            "unknown": 30
+          },
+          "users": {
+            "unknown": 30
+          },
+          "components": {
+            "unknown": 30
+          }
+        },
+        "window": {
+          "calls": 0,
+          "tenant_count": 0,
+          "user_count": 0,
+          "component_count": 0,
+          "tenants": {},
+          "users": {},
+          "components": {}
+        },
+        "last_seen_at": "2026-07-03T05:20:34.534439Z",
+        "retirement_candidate": true,
+        "retirement_reason": "no measured usage in review window"
+      },
+      {
+        "interface": {
+          "id": "3a00b19e-e7db-4403-98aa-a77c9ab61ecc",
+          "interface_key": "rest_api:GET /workstreams/{workstream_id}",
+          "interface_kind": "rest_api",
+          "legacy_since": "2026-06-04T00:25:59.014966Z",
+          "replacement_ref": "/workplans/{workplan_id}",
+          "owner_component": "state-hub.api",
+          "status": "legacy",
+          "replacement_verified": true,
+          "manual_hold": false,
+          "hold_reason": null,
+          "notes": null,
+          "retired_at": null,
+          "created_at": "2026-06-04T00:25:59.014966Z",
+          "updated_at": "2026-06-04T00:25:59.014966Z"
+        },
+        "all_time": {
+          "calls": 511405,
+          "tenant_count": 1,
+          "user_count": 1,
+          "component_count": 1,
+          "tenants": {
+            "unknown": 511405
+          },
+          "users": {
+            "unknown": 511405
+          },
+          "components": {
+            "unknown": 511405
+          }
+        },
+        "window": {
+          "calls": 0,
+          "tenant_count": 0,
+          "user_count": 0,
+          "component_count": 0,
+          "tenants": {},
+          "users": {},
+          "components": {}
+        },
+        "last_seen_at": "2026-07-08T21:14:20.781103Z",
+        "retirement_candidate": true,
+        "retirement_reason": "no measured usage in review window"
+      },
+      {
+        "interface": {
+          "id": "69e1a255-a8b9-4101-8a68-b1bed23abfda",
+          "interface_key": "rest_api:GET /workstreams/{workstream_id}/dependencies/",
+          "interface_kind": "rest_api",
+          "legacy_since": "2026-06-04T00:25:59.291135Z",
+          "replacement_ref": "/workplans/{workplan_id}/dependencies/",
+          "owner_component": "state-hub.api",
+          "status": "legacy",
+          "replacement_verified": true,
+          "manual_hold": false,
+          "hold_reason": null,
+          "notes": null,
+          "retired_at": null,
+          "created_at": "2026-06-04T00:25:59.291135Z",
+          "updated_at": "2026-06-04T00:25:59.291135Z"
+        },
+        "all_time": {
+          "calls": 255865,
+          "tenant_count": 1,
+          "user_count": 1,
+          "component_count": 1,
+          "tenants": {
+            "unknown": 255865
+          },
+          "users": {
+            "unknown": 255865
+          },
+          "components": {
+            "unknown": 255865
+          }
+        },
+        "window": {
+          "calls": 0,
+          "tenant_count": 0,
+          "user_count": 0,
+          "component_count": 0,
+          "tenants": {},
+          "users": {},
+          "components": {}
+        },
+        "last_seen_at": "2026-07-08T21:14:12.747005Z",
+        "retirement_candidate": true,
+        "retirement_reason": "no measured usage in review window"
+      },
+      {
+        "interface": {
+          "id": "b1aae931-b51f-4a85-a723-865dd65f6132",
+          "interface_key": "rest_api:PATCH /workstreams/{workstream_id}",
+          "interface_kind": "rest_api",
+          "legacy_since": "2026-06-04T06:09:41.901035Z",
+          "replacement_ref": "/workplans/{workplan_id}",
+          "owner_component": "state-hub.api",
+          "status": "legacy",
+          "replacement_verified": true,
+          "manual_hold": false,
+          "hold_reason": null,
+          "notes": null,
+          "retired_at": null,
+          "created_at": "2026-06-04T06:09:41.901035Z",
+          "updated_at": "2026-06-04T06:09:41.901035Z"
+        },
+        "all_time": {
+          "calls": 571,
+          "tenant_count": 1,
+          "user_count": 1,
+          "component_count": 1,
+          "tenants": {
+            "unknown": 571
+          },
+          "users": {
+            "unknown": 571
+          },
+          "components": {
+            "unknown": 571
+          }
+        },
+        "window": {
+          "calls": 0,
+          "tenant_count": 0,
+          "user_count": 0,
+          "component_count": 0,
+          "tenants": {},
+          "users": {},
+          "components": {}
+        },
+        "last_seen_at": "2026-07-08T20:49:12.335710Z",
+        "retirement_candidate": true,
+        "retirement_reason": "no measured usage in review window"
+      },
+      {
+        "interface": {
+          "id": "4aea9591-970b-4918-ac4a-4da95a0a1a8c",
+          "interface_key": "rest_api:POST /decisions/ workstream_id",
+          "interface_kind": "rest_api",
+          "legacy_since": "2026-07-09T22:56:35.473130Z",
+          "replacement_ref": "POST /decisions/ with workplan_id",
+          "owner_component": "state-hub.api",
+          "status": "legacy",
+          "replacement_verified": true,
+          "manual_hold": false,
+          "hold_reason": null,
+          "notes": null,
+          "retired_at": null,
+          "created_at": "2026-07-09T22:56:35.473130Z",
+          "updated_at": "2026-07-09T22:56:35.473130Z"
+        },
+        "all_time": {
+          "calls": 3,
+          "tenant_count": 1,
+          "user_count": 1,
+          "component_count": 1,
+          "tenants": {
+            "unknown": 3
+          },
+          "users": {
+            "unknown": 3
+          },
+          "components": {
+            "unknown": 3
+          }
+        },
+        "window": {
+          "calls": 0,
+          "tenant_count": 0,
+          "user_count": 0,
+          "component_count": 0,
+          "tenants": {},
+          "users": {},
+          "components": {}
+        },
+        "last_seen_at": "2026-07-09T22:57:05.912456Z",
+        "retirement_candidate": true,
+        "retirement_reason": "no measured usage in review window"
+      },
+      {
+        "interface": {
+          "id": "4a70583c-1e41-4ec1-99a9-728856a7d79c",
+          "interface_key": "rest_api:POST /progress/ workstream_id",
+          "interface_kind": "rest_api",
+          "legacy_since": "2026-07-08T23:35:09.148333Z",
+          "replacement_ref": "POST /progress/ with workplan_id",
+          "owner_component": "state-hub.api",
+          "status": "legacy",
+          "replacement_verified": true,
+          "manual_hold": false,
+          "hold_reason": null,
+          "notes": null,
+          "retired_at": null,
+          "created_at": "2026-07-08T23:35:09.148333Z",
+          "updated_at": "2026-07-08T23:35:09.148333Z"
+        },
+        "all_time": {
+          "calls": 14,
+          "tenant_count": 1,
+          "user_count": 1,
+          "component_count": 1,
+          "tenants": {
+            "unknown": 14
+          },
+          "users": {
+            "unknown": 14
+          },
+          "components": {
+            "unknown": 14
+          }
+        },
+        "window": {
+          "calls": 0,
+          "tenant_count": 0,
+          "user_count": 0,
+          "component_count": 0,
+          "tenants": {},
+          "users": {},
+          "components": {}
+        },
+        "last_seen_at": "2026-07-10T08:34:42.959724Z",
+        "retirement_candidate": true,
+        "retirement_reason": "no measured usage in review window"
+      },
+      {
+        "interface": {
+          "id": "6df4e443-7bf1-461a-923b-a6eb52fe7b07",
+          "interface_key": "rest_api:POST /tasks/ workstream_id",
+          "interface_kind": "rest_api",
+          "legacy_since": "2026-07-08T22:38:29.405720Z",
+          "replacement_ref": "POST /tasks/ with workplan_id",
+          "owner_component": "state-hub.api",
+          "status": "legacy",
+          "replacement_verified": true,
+          "manual_hold": false,
+          "hold_reason": null,
+          "notes": null,
+          "retired_at": null,
+          "created_at": "2026-07-08T22:38:29.405720Z",
+          "updated_at": "2026-07-08T22:38:29.405720Z"
+        },
+        "all_time": {
+          "calls": 5,
+          "tenant_count": 1,
+          "user_count": 1,
+          "component_count": 1,
+          "tenants": {
+            "unknown": 5
+          },
+          "users": {
+            "unknown": 5
+          },
+          "components": {
+            "state-hub.fix-consistency": 5
+          }
+        },
+        "window": {
+          "calls": 0,
+          "tenant_count": 0,
+          "user_count": 0,
+          "component_count": 0,
+          "tenants": {},
+          "users": {},
+          "components": {}
+        },
+        "last_seen_at": "2026-07-08T22:38:29.976918Z",
+        "retirement_candidate": true,
+        "retirement_reason": "no measured usage in review window"
+      },
+      {
+        "interface": {
+          "id": "ed6451c9-d2cc-4486-9afe-d3852782cabc",
+          "interface_key": "rest_api:POST /workstreams/",
+          "interface_kind": "rest_api",
+          "legacy_since": "2026-06-04T07:40:24.168535Z",
+          "replacement_ref": "/workplans/",
+          "owner_component": "state-hub.api",
+          "status": "legacy",
+          "replacement_verified": true,
+          "manual_hold": false,
+          "hold_reason": null,
+          "notes": null,
+          "retired_at": null,
+          "created_at": "2026-06-04T07:40:24.168535Z",
+          "updated_at": "2026-06-04T07:40:24.168535Z"
+        },
+        "all_time": {
+          "calls": 824,
+          "tenant_count": 1,
+          "user_count": 1,
+          "component_count": 1,
+          "tenants": {
+            "unknown": 824
+          },
+          "users": {
+            "unknown": 824
+          },
+          "components": {
+            "unknown": 824
+          }
+        },
+        "window": {
+          "calls": 0,
+          "tenant_count": 0,
+          "user_count": 0,
+          "component_count": 0,
+          "tenants": {},
+          "users": {},
+          "components": {}
+        },
+        "last_seen_at": "2026-07-08T20:38:05.903144Z",
+        "retirement_candidate": true,
+        "retirement_reason": "no measured usage in review window"
+      },
+      {
+        "interface": {
+          "id": "281fd706-b192-4194-8055-2d8733c115f9",
+          "interface_key": "rest_api:POST /workstreams/{workstream_id}/dependencies/",
+          "interface_kind": "rest_api",
+          "legacy_since": "2026-06-04T22:57:37.149207Z",
+          "replacement_ref": "/workplans/{workplan_id}/dependencies/",
+          "owner_component": "state-hub.api",
+          "status": "legacy",
+          "replacement_verified": true,
+          "manual_hold": false,
+          "hold_reason": null,
+          "notes": null,
+          "retired_at": null,
+          "created_at": "2026-06-04T22:57:37.149207Z",
+          "updated_at": "2026-06-04T22:57:37.149207Z"
+        },
+        "all_time": {
+          "calls": 4971,
+          "tenant_count": 1,
+          "user_count": 1,
+          "component_count": 1,
+          "tenants": {
+            "unknown": 4971
+          },
+          "users": {
+            "unknown": 4971
+          },
+          "components": {
+            "unknown": 4971
+          }
+        },
+        "window": {
+          "calls": 0,
+          "tenant_count": 0,
+          "user_count": 0,
+          "component_count": 0,
+          "tenants": {},
+          "users": {},
+          "components": {}
+        },
+        "last_seen_at": "2026-07-01T22:09:24.229011Z",
+        "retirement_candidate": true,
+        "retirement_reason": "no measured usage in review window"
+      }
+    ]
+  },
+  "hours": 8
+}
diff --git a/docs/evidence/legacy-meter-weekly-review-20260801.json b/docs/evidence/legacy-meter-weekly-review-20260801.json
new file mode 100644
index 0000000..37ed082
--- /dev/null
+++ b/docs/evidence/legacy-meter-weekly-review-20260801.json
@@ -0,0 +1,1755 @@
+{
+  "captured_at": "2026-08-01T14:00:04.644824+00:00",
+  "api_base": "http://127.0.0.1:8000",
+  "workplan": "STATE-WP-0070",
+  "retired_interfaces": [],
+  "weekly_review": {
+    "generated_at": "2026-08-01T14:00:04.638599Z",
+    "window_start": "2026-08-01T06:00:04.210055Z",
+    "window_end": "2026-08-01T14:00:04.210055Z",
+    "cadence": "weekly",
+    "activity_core_handoff": {
+      "activity_id": "statehub-legacy-interface-review",
+      "cadence": "weekly",
+      "source_endpoint": "/legacy-meter/weekly-review",
+      "state_owner": "state-hub",
+      "scheduler_owner": "activity-core"
+    },
+    "interfaces": [
+      {
+        "interface": {
+          "id": "8051fb40-66c9-4dc4-a413-13e8573e04a3",
+          "interface_key": "event_subject:org.statehub.workstream.completed",
+          "interface_kind": "event_subject",
+          "legacy_since": "2026-06-04T06:09:42.198193Z",
+          "replacement_ref": "org.statehub.workplan.completed",
+          "owner_component": "state-hub.events",
+          "status": "retired",
+          "replacement_verified": true,
+          "manual_hold": false,
+          "hold_reason": null,
+          "notes": "Retired by STATE-WP-0069 closeout",
+          "retired_at": "2026-07-08T21:38:52.773601Z",
+          "created_at": "2026-06-04T06:09:42.198193Z",
+          "updated_at": "2026-07-08T21:38:52.761243Z"
+        },
+        "all_time": {
+          "calls": 255,
+          "tenant_count": 1,
+          "user_count": 1,
+          "component_count": 1,
+          "tenants": {
+            "unknown": 255
+          },
+          "users": {
+            "unknown": 255
+          },
+          "components": {
+            "state-hub.events": 255
+          }
+        },
+        "window": {
+          "calls": 0,
+          "tenant_count": 0,
+          "user_count": 0,
+          "component_count": 0,
+          "tenants": {},
+          "users": {},
+          "components": {}
+        },
+        "last_seen_at": "2026-07-08T20:49:12.839383Z",
+        "retirement_candidate": false,
+        "retirement_reason": "already retired"
+      },
+      {
+        "interface": {
+          "id": "63ed90e3-42b4-431a-94db-e1254a52f9e2",
+          "interface_key": "mcp:create_workstream",
+          "interface_kind": "mcp_tool",
+          "legacy_since": "2026-07-10T13:19:44.205900Z",
+          "replacement_ref": "create_workplan",
+          "owner_component": "state-hub.mcp",
+          "status": "legacy",
+          "replacement_verified": true,
+          "manual_hold": false,
+          "hold_reason": null,
+          "notes": "Registered by STATE-WP-0070 T03 \u2014 zero-window streak starts at registration",
+          "retired_at": null,
+          "created_at": "2026-07-10T13:19:44.205900Z",
+          "updated_at": "2026-07-10T13:19:44.205900Z"
+        },
+        "all_time": {
+          "calls": 2,
+          "tenant_count": 1,
+          "user_count": 1,
+          "component_count": 1,
+          "tenants": {
+            "unknown": 2
+          },
+          "users": {
+            "unknown": 2
+          },
+          "components": {
+            "state-hub.mcp": 2
+          }
+        },
+        "window": {
+          "calls": 0,
+          "tenant_count": 0,
+          "user_count": 0,
+          "component_count": 0,
+          "tenants": {},
+          "users": {},
+          "components": {}
+        },
+        "last_seen_at": "2026-07-10T13:20:43.378546Z",
+        "retirement_candidate": true,
+        "retirement_reason": "no measured usage in review window"
+      },
+      {
+        "interface": {
+          "id": "b6a5fe44-fb85-4ef7-a273-78d09da777af",
+          "interface_key": "mcp:list_workstreams",
+          "interface_kind": "mcp_tool",
+          "legacy_since": "2026-07-10T13:19:26.075491Z",
+          "replacement_ref": "list_workplans",
+          "owner_component": "state-hub.mcp",
+          "status": "legacy",
+          "replacement_verified": true,
+          "manual_hold": false,
+          "hold_reason": null,
+          "notes": null,
+          "retired_at": null,
+          "created_at": "2026-07-10T13:19:26.075491Z",
+          "updated_at": "2026-07-10T13:19:26.075491Z"
+        },
+        "all_time": {
+          "calls": 2,
+          "tenant_count": 1,
+          "user_count": 1,
+          "component_count": 1,
+          "tenants": {
+            "unknown": 2
+          },
+          "users": {
+            "unknown": 2
+          },
+          "components": {
+            "state-hub.mcp": 2
+          }
+        },
+        "window": {
+          "calls": 0,
+          "tenant_count": 0,
+          "user_count": 0,
+          "component_count": 0,
+          "tenants": {},
+          "users": {},
+          "components": {}
+        },
+        "last_seen_at": "2026-07-10T13:20:42.374940Z",
+        "retirement_candidate": true,
+        "retirement_reason": "no measured usage in review window"
+      },
+      {
+        "interface": {
+          "id": "53c3372b-307d-4d6a-8ea4-bc36cacdcaf2",
+          "interface_key": "mcp:update_workstream",
+          "interface_kind": "mcp_tool",
+          "legacy_since": "2026-07-10T13:19:44.255216Z",
+          "replacement_ref": "update_workplan",
+          "owner_component": "state-hub.mcp",
+          "status": "legacy",
+          "replacement_verified": true,
+          "manual_hold": false,
+          "hold_reason": null,
+          "notes": "Registered by STATE-WP-0070 T03 \u2014 zero-window streak starts at registration",
+          "retired_at": null,
+          "created_at": "2026-07-10T13:19:44.255216Z",
+          "updated_at": "2026-07-10T13:19:44.255216Z"
+        },
+        "all_time": {
+          "calls": 0,
+          "tenant_count": 0,
+          "user_count": 0,
+          "component_count": 0,
+          "tenants": {},
+          "users": {},
+          "components": {}
+        },
+        "window": {
+          "calls": 0,
+          "tenant_count": 0,
+          "user_count": 0,
+          "component_count": 0,
+          "tenants": {},
+          "users": {},
+          "components": {}
+        },
+        "last_seen_at": null,
+        "retirement_candidate": true,
+        "retirement_reason": "no measured usage in review window"
+      },
+      {
+        "interface": {
+          "id": "bed4d08a-3471-48f5-9f0e-f9d550383a26",
+          "interface_key": "mcp:update_workstream_status",
+          "interface_kind": "mcp_tool",
+          "legacy_since": "2026-07-10T13:19:44.303612Z",
+          "replacement_ref": "update_workplan_status",
+          "owner_component": "state-hub.mcp",
+          "status": "legacy",
+          "replacement_verified": true,
+          "manual_hold": false,
+          "hold_reason": null,
+          "notes": "Registered by STATE-WP-0070 T03 \u2014 zero-window streak starts at registration",
+          "retired_at": null,
+          "created_at": "2026-07-10T13:19:44.303612Z",
+          "updated_at": "2026-07-10T13:19:44.303612Z"
+        },
+        "all_time": {
+          "calls": 0,
+          "tenant_count": 0,
+          "user_count": 0,
+          "component_count": 0,
+          "tenants": {},
+          "users": {},
+          "components": {}
+        },
+        "window": {
+          "calls": 0,
+          "tenant_count": 0,
+          "user_count": 0,
+          "component_count": 0,
+          "tenants": {},
+          "users": {},
+          "components": {}
+        },
+        "last_seen_at": null,
+        "retirement_candidate": true,
+        "retirement_reason": "no measured usage in review window"
+      },
+      {
+        "interface": {
+          "id": "46900dc2-0893-405b-ba59-80f31fb6ebb1",
+          "interface_key": "state://workstreams/{topic_slug}",
+          "interface_kind": "mcp_tool",
+          "legacy_since": "2026-07-10T13:19:44.344493Z",
+          "replacement_ref": "state://workplans/{topic_slug}",
+          "owner_component": "state-hub.mcp",
+          "status": "legacy",
+          "replacement_verified": true,
+          "manual_hold": false,
+          "hold_reason": null,
+          "notes": "Registered by STATE-WP-0070 T03 \u2014 zero-window streak starts at registration",
+          "retired_at": null,
+          "created_at": "2026-07-10T13:19:44.344493Z",
+          "updated_at": "2026-07-10T13:19:44.344493Z"
+        },
+        "all_time": {
+          "calls": 1,
+          "tenant_count": 1,
+          "user_count": 1,
+          "component_count": 1,
+          "tenants": {
+            "unknown": 1
+          },
+          "users": {
+            "unknown": 1
+          },
+          "components": {
+            "state-hub.mcp": 1
+          }
+        },
+        "window": {
+          "calls": 0,
+          "tenant_count": 0,
+          "user_count": 0,
+          "component_count": 0,
+          "tenants": {},
+          "users": {},
+          "components": {}
+        },
+        "last_seen_at": "2026-07-10T13:20:34.491811Z",
+        "retirement_candidate": true,
+        "retirement_reason": "no measured usage in review window"
+      },
+      {
+        "interface": {
+          "id": "cd9342fd-27e7-4a46-a1be-d41499e106a3",
+          "interface_key": "rest_api:DELETE /workstreams/{workstream_id}",
+          "interface_kind": "rest_api",
+          "legacy_since": "2026-06-06T17:28:13.052813Z",
+          "replacement_ref": "/workplans/{workplan_id}",
+          "owner_component": "state-hub.api",
+          "status": "legacy",
+          "replacement_verified": true,
+          "manual_hold": false,
+          "hold_reason": null,
+          "notes": null,
+          "retired_at": null,
+          "created_at": "2026-06-06T17:28:13.052813Z",
+          "updated_at": "2026-06-06T17:28:13.052813Z"
+        },
+        "all_time": {
+          "calls": 1,
+          "tenant_count": 1,
+          "user_count": 1,
+          "component_count": 1,
+          "tenants": {
+            "unknown": 1
+          },
+          "users": {
+            "unknown": 1
+          },
+          "components": {
+            "unknown": 1
+          }
+        },
+        "window": {
+          "calls": 0,
+          "tenant_count": 0,
+          "user_count": 0,
+          "component_count": 0,
+          "tenants": {},
+          "users": {},
+          "components": {}
+        },
+        "last_seen_at": "2026-06-06T17:28:13.047529Z",
+        "retirement_candidate": true,
+        "retirement_reason": "no measured usage in review window"
+      },
+      {
+        "interface": {
+          "id": "a4e0948c-cd4a-461e-8ae2-7fd7b51d04a7",
+          "interface_key": "rest_api:GET /decisions/?workstream_id",
+          "interface_kind": "rest_api",
+          "legacy_since": "2026-07-09T23:07:53.093223Z",
+          "replacement_ref": "/decisions/?workplan_id=<workplan_id>",
+          "owner_component": "state-hub.api",
+          "status": "legacy",
+          "replacement_verified": true,
+          "manual_hold": false,
+          "hold_reason": null,
+          "notes": null,
+          "retired_at": null,
+          "created_at": "2026-07-09T23:07:53.093223Z",
+          "updated_at": "2026-07-09T23:07:53.093223Z"
+        },
+        "all_time": {
+          "calls": 1,
+          "tenant_count": 1,
+          "user_count": 1,
+          "component_count": 1,
+          "tenants": {
+            "unknown": 1
+          },
+          "users": {
+            "unknown": 1
+          },
+          "components": {
+            "unknown": 1
+          }
+        },
+        "window": {
+          "calls": 0,
+          "tenant_count": 0,
+          "user_count": 0,
+          "component_count": 0,
+          "tenants": {},
+          "users": {},
+          "components": {}
+        },
+        "last_seen_at": "2026-07-09T23:07:53.083299Z",
+        "retirement_candidate": true,
+        "retirement_reason": "no measured usage in review window"
+      },
+      {
+        "interface": {
+          "id": "70a9346e-e0ee-42ac-874f-f160580b54dd",
+          "interface_key": "rest_api:GET /progress/?workstream_id",
+          "interface_kind": "rest_api",
+          "legacy_since": "2026-07-13T22:04:03.911449Z",
+          "replacement_ref": "/progress/?workplan_id=<workplan_id>",
+          "owner_component": "state-hub.api",
+          "status": "legacy",
+          "replacement_verified": true,
+          "manual_hold": false,
+          "hold_reason": null,
+          "notes": null,
+          "retired_at": null,
+          "created_at": "2026-07-13T22:04:03.911449Z",
+          "updated_at": "2026-07-13T22:04:03.911449Z"
+        },
+        "all_time": {
+          "calls": 1,
+          "tenant_count": 1,
+          "user_count": 1,
+          "component_count": 1,
+          "tenants": {
+            "unknown": 1
+          },
+          "users": {
+            "unknown": 1
+          },
+          "components": {
+            "unknown": 1
+          }
+        },
+        "window": {
+          "calls": 0,
+          "tenant_count": 0,
+          "user_count": 0,
+          "component_count": 0,
+          "tenants": {},
+          "users": {},
+          "components": {}
+        },
+        "last_seen_at": "2026-07-13T22:04:03.904998Z",
+        "retirement_candidate": true,
+        "retirement_reason": "no measured usage in review window"
+      },
+      {
+        "interface": {
+          "id": "be3cdcf8-250b-4bf0-801f-02ffd5f57e00",
+          "interface_key": "rest_api:GET /tasks/?workstream_id",
+          "interface_kind": "rest_api",
+          "legacy_since": "2026-07-08T19:32:21.628513Z",
+          "replacement_ref": "/tasks/?workplan_id=<workplan_id>",
+          "owner_component": "state-hub.api",
+          "status": "legacy",
+          "replacement_verified": true,
+          "manual_hold": false,
+          "hold_reason": null,
+          "notes": null,
+          "retired_at": null,
+          "created_at": "2026-07-08T19:32:21.628513Z",
+          "updated_at": "2026-07-08T19:32:21.628513Z"
+        },
+        "all_time": {
+          "calls": 589,
+          "tenant_count": 1,
+          "user_count": 1,
+          "component_count": 1,
+          "tenants": {
+            "unknown": 589
+          },
+          "users": {
+            "unknown": 589
+          },
+          "components": {
+            "unknown": 589
+          }
+        },
+        "window": {
+          "calls": 0,
+          "tenant_count": 0,
+          "user_count": 0,
+          "component_count": 0,
+          "tenants": {},
+          "users": {},
+          "components": {}
+        },
+        "last_seen_at": "2026-07-31T16:25:32.181901Z",
+        "retirement_candidate": true,
+        "retirement_reason": "no measured usage in review window"
+      },
+      {
+        "interface": {
+          "id": "3e4a3d0b-08fa-45c3-91e2-4f514a914b97",
+          "interface_key": "rest_api:GET /workstreams/",
+          "interface_kind": "rest_api",
+          "legacy_since": "2026-06-04T00:26:14.533764Z",
+          "replacement_ref": "/workplans/",
+          "owner_component": "state-hub.api",
+          "status": "legacy",
+          "replacement_verified": true,
+          "manual_hold": false,
+          "hold_reason": null,
+          "notes": null,
+          "retired_at": null,
+          "created_at": "2026-06-04T00:26:14.533764Z",
+          "updated_at": "2026-06-04T00:26:14.533764Z"
+        },
+        "all_time": {
+          "calls": 144084,
+          "tenant_count": 1,
+          "user_count": 1,
+          "component_count": 1,
+          "tenants": {
+            "unknown": 144084
+          },
+          "users": {
+            "unknown": 144084
+          },
+          "components": {
+            "unknown": 144084
+          }
+        },
+        "window": {
+          "calls": 0,
+          "tenant_count": 0,
+          "user_count": 0,
+          "component_count": 0,
+          "tenants": {},
+          "users": {},
+          "components": {}
+        },
+        "last_seen_at": "2026-07-08T21:14:39.652776Z",
+        "retirement_candidate": true,
+        "retirement_reason": "no measured usage in review window"
+      },
+      {
+        "interface": {
+          "id": "e4c140ec-7479-46f9-b185-4b533f19d639",
+          "interface_key": "rest_api:GET /workstreams/workplan-index",
+          "interface_kind": "rest_api",
+          "legacy_since": "2026-06-04T05:20:58.321869Z",
+          "replacement_ref": "/workplans/index",
+          "owner_component": "state-hub.api",
+          "status": "legacy",
+          "replacement_verified": true,
+          "manual_hold": false,
+          "hold_reason": null,
+          "notes": null,
+          "retired_at": null,
+          "created_at": "2026-06-04T05:20:58.321869Z",
+          "updated_at": "2026-06-04T05:20:58.321869Z"
+        },
+        "all_time": {
+          "calls": 30,
+          "tenant_count": 1,
+          "user_count": 1,
+          "component_count": 1,
+          "tenants": {
+            "unknown": 30
+          },
+          "users": {
+            "unknown": 30
+          },
+          "components": {
+            "unknown": 30
+          }
+        },
+        "window": {
+          "calls": 0,
+          "tenant_count": 0,
+          "user_count": 0,
+          "component_count": 0,
+          "tenants": {},
+          "users": {},
+          "components": {}
+        },
+        "last_seen_at": "2026-07-03T05:20:34.534439Z",
+        "retirement_candidate": true,
+        "retirement_reason": "no measured usage in review window"
+      },
+      {
+        "interface": {
+          "id": "3a00b19e-e7db-4403-98aa-a77c9ab61ecc",
+          "interface_key": "rest_api:GET /workstreams/{workstream_id}",
+          "interface_kind": "rest_api",
+          "legacy_since": "2026-06-04T00:25:59.014966Z",
+          "replacement_ref": "/workplans/{workplan_id}",
+          "owner_component": "state-hub.api",
+          "status": "legacy",
+          "replacement_verified": true,
+          "manual_hold": false,
+          "hold_reason": null,
+          "notes": null,
+          "retired_at": null,
+          "created_at": "2026-06-04T00:25:59.014966Z",
+          "updated_at": "2026-06-04T00:25:59.014966Z"
+        },
+        "all_time": {
+          "calls": 511406,
+          "tenant_count": 1,
+          "user_count": 1,
+          "component_count": 1,
+          "tenants": {
+            "unknown": 511406
+          },
+          "users": {
+            "unknown": 511406
+          },
+          "components": {
+            "unknown": 511406
+          }
+        },
+        "window": {
+          "calls": 0,
+          "tenant_count": 0,
+          "user_count": 0,
+          "component_count": 0,
+          "tenants": {},
+          "users": {},
+          "components": {}
+        },
+        "last_seen_at": "2026-07-31T16:25:32.004042Z",
+        "retirement_candidate": true,
+        "retirement_reason": "no measured usage in review window"
+      },
+      {
+        "interface": {
+          "id": "69e1a255-a8b9-4101-8a68-b1bed23abfda",
+          "interface_key": "rest_api:GET /workstreams/{workstream_id}/dependencies/",
+          "interface_kind": "rest_api",
+          "legacy_since": "2026-06-04T00:25:59.291135Z",
+          "replacement_ref": "/workplans/{workplan_id}/dependencies/",
+          "owner_component": "state-hub.api",
+          "status": "legacy",
+          "replacement_verified": true,
+          "manual_hold": false,
+          "hold_reason": null,
+          "notes": null,
+          "retired_at": null,
+          "created_at": "2026-06-04T00:25:59.291135Z",
+          "updated_at": "2026-06-04T00:25:59.291135Z"
+        },
+        "all_time": {
+          "calls": 255865,
+          "tenant_count": 1,
+          "user_count": 1,
+          "component_count": 1,
+          "tenants": {
+            "unknown": 255865
+          },
+          "users": {
+            "unknown": 255865
+          },
+          "components": {
+            "unknown": 255865
+          }
+        },
+        "window": {
+          "calls": 0,
+          "tenant_count": 0,
+          "user_count": 0,
+          "component_count": 0,
+          "tenants": {},
+          "users": {},
+          "components": {}
+        },
+        "last_seen_at": "2026-07-08T21:14:12.747005Z",
+        "retirement_candidate": true,
+        "retirement_reason": "no measured usage in review window"
+      },
+      {
+        "interface": {
+          "id": "b1aae931-b51f-4a85-a723-865dd65f6132",
+          "interface_key": "rest_api:PATCH /workstreams/{workstream_id}",
+          "interface_kind": "rest_api",
+          "legacy_since": "2026-06-04T06:09:41.901035Z",
+          "replacement_ref": "/workplans/{workplan_id}",
+          "owner_component": "state-hub.api",
+          "status": "legacy",
+          "replacement_verified": true,
+          "manual_hold": false,
+          "hold_reason": null,
+          "notes": null,
+          "retired_at": null,
+          "created_at": "2026-06-04T06:09:41.901035Z",
+          "updated_at": "2026-06-04T06:09:41.901035Z"
+        },
+        "all_time": {
+          "calls": 571,
+          "tenant_count": 1,
+          "user_count": 1,
+          "component_count": 1,
+          "tenants": {
+            "unknown": 571
+          },
+          "users": {
+            "unknown": 571
+          },
+          "components": {
+            "unknown": 571
+          }
+        },
+        "window": {
+          "calls": 0,
+          "tenant_count": 0,
+          "user_count": 0,
+          "component_count": 0,
+          "tenants": {},
+          "users": {},
+          "components": {}
+        },
+        "last_seen_at": "2026-07-08T20:49:12.335710Z",
+        "retirement_candidate": true,
+        "retirement_reason": "no measured usage in review window"
+      },
+      {
+        "interface": {
+          "id": "4aea9591-970b-4918-ac4a-4da95a0a1a8c",
+          "interface_key": "rest_api:POST /decisions/ workstream_id",
+          "interface_kind": "rest_api",
+          "legacy_since": "2026-07-09T22:56:35.473130Z",
+          "replacement_ref": "POST /decisions/ with workplan_id",
+          "owner_component": "state-hub.api",
+          "status": "legacy",
+          "replacement_verified": true,
+          "manual_hold": false,
+          "hold_reason": null,
+          "notes": null,
+          "retired_at": null,
+          "created_at": "2026-07-09T22:56:35.473130Z",
+          "updated_at": "2026-07-09T22:56:35.473130Z"
+        },
+        "all_time": {
+          "calls": 3,
+          "tenant_count": 1,
+          "user_count": 1,
+          "component_count": 1,
+          "tenants": {
+            "unknown": 3
+          },
+          "users": {
+            "unknown": 3
+          },
+          "components": {
+            "unknown": 3
+          }
+        },
+        "window": {
+          "calls": 0,
+          "tenant_count": 0,
+          "user_count": 0,
+          "component_count": 0,
+          "tenants": {},
+          "users": {},
+          "components": {}
+        },
+        "last_seen_at": "2026-07-09T22:57:05.912456Z",
+        "retirement_candidate": true,
+        "retirement_reason": "no measured usage in review window"
+      },
+      {
+        "interface": {
+          "id": "4a70583c-1e41-4ec1-99a9-728856a7d79c",
+          "interface_key": "rest_api:POST /progress/ workstream_id",
+          "interface_kind": "rest_api",
+          "legacy_since": "2026-07-08T23:35:09.148333Z",
+          "replacement_ref": "POST /progress/ with workplan_id",
+          "owner_component": "state-hub.api",
+          "status": "legacy",
+          "replacement_verified": true,
+          "manual_hold": false,
+          "hold_reason": null,
+          "notes": null,
+          "retired_at": null,
+          "created_at": "2026-07-08T23:35:09.148333Z",
+          "updated_at": "2026-07-08T23:35:09.148333Z"
+        },
+        "all_time": {
+          "calls": 14,
+          "tenant_count": 1,
+          "user_count": 1,
+          "component_count": 1,
+          "tenants": {
+            "unknown": 14
+          },
+          "users": {
+            "unknown": 14
+          },
+          "components": {
+            "unknown": 14
+          }
+        },
+        "window": {
+          "calls": 0,
+          "tenant_count": 0,
+          "user_count": 0,
+          "component_count": 0,
+          "tenants": {},
+          "users": {},
+          "components": {}
+        },
+        "last_seen_at": "2026-07-10T08:34:42.959724Z",
+        "retirement_candidate": true,
+        "retirement_reason": "no measured usage in review window"
+      },
+      {
+        "interface": {
+          "id": "6df4e443-7bf1-461a-923b-a6eb52fe7b07",
+          "interface_key": "rest_api:POST /tasks/ workstream_id",
+          "interface_kind": "rest_api",
+          "legacy_since": "2026-07-08T22:38:29.405720Z",
+          "replacement_ref": "POST /tasks/ with workplan_id",
+          "owner_component": "state-hub.api",
+          "status": "legacy",
+          "replacement_verified": true,
+          "manual_hold": false,
+          "hold_reason": null,
+          "notes": null,
+          "retired_at": null,
+          "created_at": "2026-07-08T22:38:29.405720Z",
+          "updated_at": "2026-07-08T22:38:29.405720Z"
+        },
+        "all_time": {
+          "calls": 5,
+          "tenant_count": 1,
+          "user_count": 1,
+          "component_count": 1,
+          "tenants": {
+            "unknown": 5
+          },
+          "users": {
+            "unknown": 5
+          },
+          "components": {
+            "state-hub.fix-consistency": 5
+          }
+        },
+        "window": {
+          "calls": 0,
+          "tenant_count": 0,
+          "user_count": 0,
+          "component_count": 0,
+          "tenants": {},
+          "users": {},
+          "components": {}
+        },
+        "last_seen_at": "2026-07-08T22:38:29.976918Z",
+        "retirement_candidate": true,
+        "retirement_reason": "no measured usage in review window"
+      },
+      {
+        "interface": {
+          "id": "ed6451c9-d2cc-4486-9afe-d3852782cabc",
+          "interface_key": "rest_api:POST /workstreams/",
+          "interface_kind": "rest_api",
+          "legacy_since": "2026-06-04T07:40:24.168535Z",
+          "replacement_ref": "/workplans/",
+          "owner_component": "state-hub.api",
+          "status": "legacy",
+          "replacement_verified": true,
+          "manual_hold": false,
+          "hold_reason": null,
+          "notes": null,
+          "retired_at": null,
+          "created_at": "2026-06-04T07:40:24.168535Z",
+          "updated_at": "2026-06-04T07:40:24.168535Z"
+        },
+        "all_time": {
+          "calls": 824,
+          "tenant_count": 1,
+          "user_count": 1,
+          "component_count": 1,
+          "tenants": {
+            "unknown": 824
+          },
+          "users": {
+            "unknown": 824
+          },
+          "components": {
+            "unknown": 824
+          }
+        },
+        "window": {
+          "calls": 0,
+          "tenant_count": 0,
+          "user_count": 0,
+          "component_count": 0,
+          "tenants": {},
+          "users": {},
+          "components": {}
+        },
+        "last_seen_at": "2026-07-08T20:38:05.903144Z",
+        "retirement_candidate": true,
+        "retirement_reason": "no measured usage in review window"
+      },
+      {
+        "interface": {
+          "id": "281fd706-b192-4194-8055-2d8733c115f9",
+          "interface_key": "rest_api:POST /workstreams/{workstream_id}/dependencies/",
+          "interface_kind": "rest_api",
+          "legacy_since": "2026-06-04T22:57:37.149207Z",
+          "replacement_ref": "/workplans/{workplan_id}/dependencies/",
+          "owner_component": "state-hub.api",
+          "status": "legacy",
+          "replacement_verified": true,
+          "manual_hold": false,
+          "hold_reason": null,
+          "notes": null,
+          "retired_at": null,
+          "created_at": "2026-06-04T22:57:37.149207Z",
+          "updated_at": "2026-06-04T22:57:37.149207Z"
+        },
+        "all_time": {
+          "calls": 4971,
+          "tenant_count": 1,
+          "user_count": 1,
+          "component_count": 1,
+          "tenants": {
+            "unknown": 4971
+          },
+          "users": {
+            "unknown": 4971
+          },
+          "components": {
+            "unknown": 4971
+          }
+        },
+        "window": {
+          "calls": 0,
+          "tenant_count": 0,
+          "user_count": 0,
+          "component_count": 0,
+          "tenants": {},
+          "users": {},
+          "components": {}
+        },
+        "last_seen_at": "2026-07-01T22:09:24.229011Z",
+        "retirement_candidate": true,
+        "retirement_reason": "no measured usage in review window"
+      }
+    ],
+    "retirement_candidates": [
+      {
+        "interface": {
+          "id": "63ed90e3-42b4-431a-94db-e1254a52f9e2",
+          "interface_key": "mcp:create_workstream",
+          "interface_kind": "mcp_tool",
+          "legacy_since": "2026-07-10T13:19:44.205900Z",
+          "replacement_ref": "create_workplan",
+          "owner_component": "state-hub.mcp",
+          "status": "legacy",
+          "replacement_verified": true,
+          "manual_hold": false,
+          "hold_reason": null,
+          "notes": "Registered by STATE-WP-0070 T03 \u2014 zero-window streak starts at registration",
+          "retired_at": null,
+          "created_at": "2026-07-10T13:19:44.205900Z",
+          "updated_at": "2026-07-10T13:19:44.205900Z"
+        },
+        "all_time": {
+          "calls": 2,
+          "tenant_count": 1,
+          "user_count": 1,
+          "component_count": 1,
+          "tenants": {
+            "unknown": 2
+          },
+          "users": {
+            "unknown": 2
+          },
+          "components": {
+            "state-hub.mcp": 2
+          }
+        },
+        "window": {
+          "calls": 0,
+          "tenant_count": 0,
+          "user_count": 0,
+          "component_count": 0,
+          "tenants": {},
+          "users": {},
+          "components": {}
+        },
+        "last_seen_at": "2026-07-10T13:20:43.378546Z",
+        "retirement_candidate": true,
+        "retirement_reason": "no measured usage in review window"
+      },
+      {
+        "interface": {
+          "id": "b6a5fe44-fb85-4ef7-a273-78d09da777af",
+          "interface_key": "mcp:list_workstreams",
+          "interface_kind": "mcp_tool",
+          "legacy_since": "2026-07-10T13:19:26.075491Z",
+          "replacement_ref": "list_workplans",
+          "owner_component": "state-hub.mcp",
+          "status": "legacy",
+          "replacement_verified": true,
+          "manual_hold": false,
+          "hold_reason": null,
+          "notes": null,
+          "retired_at": null,
+          "created_at": "2026-07-10T13:19:26.075491Z",
+          "updated_at": "2026-07-10T13:19:26.075491Z"
+        },
+        "all_time": {
+          "calls": 2,
+          "tenant_count": 1,
+          "user_count": 1,
+          "component_count": 1,
+          "tenants": {
+            "unknown": 2
+          },
+          "users": {
+            "unknown": 2
+          },
+          "components": {
+            "state-hub.mcp": 2
+          }
+        },
+        "window": {
+          "calls": 0,
+          "tenant_count": 0,
+          "user_count": 0,
+          "component_count": 0,
+          "tenants": {},
+          "users": {},
+          "components": {}
+        },
+        "last_seen_at": "2026-07-10T13:20:42.374940Z",
+        "retirement_candidate": true,
+        "retirement_reason": "no measured usage in review window"
+      },
+      {
+        "interface": {
+          "id": "53c3372b-307d-4d6a-8ea4-bc36cacdcaf2",
+          "interface_key": "mcp:update_workstream",
+          "interface_kind": "mcp_tool",
+          "legacy_since": "2026-07-10T13:19:44.255216Z",
+          "replacement_ref": "update_workplan",
+          "owner_component": "state-hub.mcp",
+          "status": "legacy",
+          "replacement_verified": true,
+          "manual_hold": false,
+          "hold_reason": null,
+          "notes": "Registered by STATE-WP-0070 T03 \u2014 zero-window streak starts at registration",
+          "retired_at": null,
+          "created_at": "2026-07-10T13:19:44.255216Z",
+          "updated_at": "2026-07-10T13:19:44.255216Z"
+        },
+        "all_time": {
+          "calls": 0,
+          "tenant_count": 0,
+          "user_count": 0,
+          "component_count": 0,
+          "tenants": {},
+          "users": {},
+          "components": {}
+        },
+        "window": {
+          "calls": 0,
+          "tenant_count": 0,
+          "user_count": 0,
+          "component_count": 0,
+          "tenants": {},
+          "users": {},
+          "components": {}
+        },
+        "last_seen_at": null,
+        "retirement_candidate": true,
+        "retirement_reason": "no measured usage in review window"
+      },
+      {
+        "interface": {
+          "id": "bed4d08a-3471-48f5-9f0e-f9d550383a26",
+          "interface_key": "mcp:update_workstream_status",
+          "interface_kind": "mcp_tool",
+          "legacy_since": "2026-07-10T13:19:44.303612Z",
+          "replacement_ref": "update_workplan_status",
+          "owner_component": "state-hub.mcp",
+          "status": "legacy",
+          "replacement_verified": true,
+          "manual_hold": false,
+          "hold_reason": null,
+          "notes": "Registered by STATE-WP-0070 T03 \u2014 zero-window streak starts at registration",
+          "retired_at": null,
+          "created_at": "2026-07-10T13:19:44.303612Z",
+          "updated_at": "2026-07-10T13:19:44.303612Z"
+        },
+        "all_time": {
+          "calls": 0,
+          "tenant_count": 0,
+          "user_count": 0,
+          "component_count": 0,
+          "tenants": {},
+          "users": {},
+          "components": {}
+        },
+        "window": {
+          "calls": 0,
+          "tenant_count": 0,
+          "user_count": 0,
+          "component_count": 0,
+          "tenants": {},
+          "users": {},
+          "components": {}
+        },
+        "last_seen_at": null,
+        "retirement_candidate": true,
+        "retirement_reason": "no measured usage in review window"
+      },
+      {
+        "interface": {
+          "id": "46900dc2-0893-405b-ba59-80f31fb6ebb1",
+          "interface_key": "state://workstreams/{topic_slug}",
+          "interface_kind": "mcp_tool",
+          "legacy_since": "2026-07-10T13:19:44.344493Z",
+          "replacement_ref": "state://workplans/{topic_slug}",
+          "owner_component": "state-hub.mcp",
+          "status": "legacy",
+          "replacement_verified": true,
+          "manual_hold": false,
+          "hold_reason": null,
+          "notes": "Registered by STATE-WP-0070 T03 \u2014 zero-window streak starts at registration",
+          "retired_at": null,
+          "created_at": "2026-07-10T13:19:44.344493Z",
+          "updated_at": "2026-07-10T13:19:44.344493Z"
+        },
+        "all_time": {
+          "calls": 1,
+          "tenant_count": 1,
+          "user_count": 1,
+          "component_count": 1,
+          "tenants": {
+            "unknown": 1
+          },
+          "users": {
+            "unknown": 1
+          },
+          "components": {
+            "state-hub.mcp": 1
+          }
+        },
+        "window": {
+          "calls": 0,
+          "tenant_count": 0,
+          "user_count": 0,
+          "component_count": 0,
+          "tenants": {},
+          "users": {},
+          "components": {}
+        },
+        "last_seen_at": "2026-07-10T13:20:34.491811Z",
+        "retirement_candidate": true,
+        "retirement_reason": "no measured usage in review window"
+      },
+      {
+        "interface": {
+          "id": "cd9342fd-27e7-4a46-a1be-d41499e106a3",
+          "interface_key": "rest_api:DELETE /workstreams/{workstream_id}",
+          "interface_kind": "rest_api",
+          "legacy_since": "2026-06-06T17:28:13.052813Z",
+          "replacement_ref": "/workplans/{workplan_id}",
+          "owner_component": "state-hub.api",
+          "status": "legacy",
+          "replacement_verified": true,
+          "manual_hold": false,
+          "hold_reason": null,
+          "notes": null,
+          "retired_at": null,
+          "created_at": "2026-06-06T17:28:13.052813Z",
+          "updated_at": "2026-06-06T17:28:13.052813Z"
+        },
+        "all_time": {
+          "calls": 1,
+          "tenant_count": 1,
+          "user_count": 1,
+          "component_count": 1,
+          "tenants": {
+            "unknown": 1
+          },
+          "users": {
+            "unknown": 1
+          },
+          "components": {
+            "unknown": 1
+          }
+        },
+        "window": {
+          "calls": 0,
+          "tenant_count": 0,
+          "user_count": 0,
+          "component_count": 0,
+          "tenants": {},
+          "users": {},
+          "components": {}
+        },
+        "last_seen_at": "2026-06-06T17:28:13.047529Z",
+        "retirement_candidate": true,
+        "retirement_reason": "no measured usage in review window"
+      },
+      {
+        "interface": {
+          "id": "a4e0948c-cd4a-461e-8ae2-7fd7b51d04a7",
+          "interface_key": "rest_api:GET /decisions/?workstream_id",
+          "interface_kind": "rest_api",
+          "legacy_since": "2026-07-09T23:07:53.093223Z",
+          "replacement_ref": "/decisions/?workplan_id=<workplan_id>",
+          "owner_component": "state-hub.api",
+          "status": "legacy",
+          "replacement_verified": true,
+          "manual_hold": false,
+          "hold_reason": null,
+          "notes": null,
+          "retired_at": null,
+          "created_at": "2026-07-09T23:07:53.093223Z",
+          "updated_at": "2026-07-09T23:07:53.093223Z"
+        },
+        "all_time": {
+          "calls": 1,
+          "tenant_count": 1,
+          "user_count": 1,
+          "component_count": 1,
+          "tenants": {
+            "unknown": 1
+          },
+          "users": {
+            "unknown": 1
+          },
+          "components": {
+            "unknown": 1
+          }
+        },
+        "window": {
+          "calls": 0,
+          "tenant_count": 0,
+          "user_count": 0,
+          "component_count": 0,
+          "tenants": {},
+          "users": {},
+          "components": {}
+        },
+        "last_seen_at": "2026-07-09T23:07:53.083299Z",
+        "retirement_candidate": true,
+        "retirement_reason": "no measured usage in review window"
+      },
+      {
+        "interface": {
+          "id": "70a9346e-e0ee-42ac-874f-f160580b54dd",
+          "interface_key": "rest_api:GET /progress/?workstream_id",
+          "interface_kind": "rest_api",
+          "legacy_since": "2026-07-13T22:04:03.911449Z",
+          "replacement_ref": "/progress/?workplan_id=<workplan_id>",
+          "owner_component": "state-hub.api",
+          "status": "legacy",
+          "replacement_verified": true,
+          "manual_hold": false,
+          "hold_reason": null,
+          "notes": null,
+          "retired_at": null,
+          "created_at": "2026-07-13T22:04:03.911449Z",
+          "updated_at": "2026-07-13T22:04:03.911449Z"
+        },
+        "all_time": {
+          "calls": 1,
+          "tenant_count": 1,
+          "user_count": 1,
+          "component_count": 1,
+          "tenants": {
+            "unknown": 1
+          },
+          "users": {
+            "unknown": 1
+          },
+          "components": {
+            "unknown": 1
+          }
+        },
+        "window": {
+          "calls": 0,
+          "tenant_count": 0,
+          "user_count": 0,
+          "component_count": 0,
+          "tenants": {},
+          "users": {},
+          "components": {}
+        },
+        "last_seen_at": "2026-07-13T22:04:03.904998Z",
+        "retirement_candidate": true,
+        "retirement_reason": "no measured usage in review window"
+      },
+      {
+        "interface": {
+          "id": "be3cdcf8-250b-4bf0-801f-02ffd5f57e00",
+          "interface_key": "rest_api:GET /tasks/?workstream_id",
+          "interface_kind": "rest_api",
+          "legacy_since": "2026-07-08T19:32:21.628513Z",
+          "replacement_ref": "/tasks/?workplan_id=<workplan_id>",
+          "owner_component": "state-hub.api",
+          "status": "legacy",
+          "replacement_verified": true,
+          "manual_hold": false,
+          "hold_reason": null,
+          "notes": null,
+          "retired_at": null,
+          "created_at": "2026-07-08T19:32:21.628513Z",
+          "updated_at": "2026-07-08T19:32:21.628513Z"
+        },
+        "all_time": {
+          "calls": 589,
+          "tenant_count": 1,
+          "user_count": 1,
+          "component_count": 1,
+          "tenants": {
+            "unknown": 589
+          },
+          "users": {
+            "unknown": 589
+          },
+          "components": {
+            "unknown": 589
+          }
+        },
+        "window": {
+          "calls": 0,
+          "tenant_count": 0,
+          "user_count": 0,
+          "component_count": 0,
+          "tenants": {},
+          "users": {},
+          "components": {}
+        },
+        "last_seen_at": "2026-07-31T16:25:32.181901Z",
+        "retirement_candidate": true,
+        "retirement_reason": "no measured usage in review window"
+      },
+      {
+        "interface": {
+          "id": "3e4a3d0b-08fa-45c3-91e2-4f514a914b97",
+          "interface_key": "rest_api:GET /workstreams/",
+          "interface_kind": "rest_api",
+          "legacy_since": "2026-06-04T00:26:14.533764Z",
+          "replacement_ref": "/workplans/",
+          "owner_component": "state-hub.api",
+          "status": "legacy",
+          "replacement_verified": true,
+          "manual_hold": false,
+          "hold_reason": null,
+          "notes": null,
+          "retired_at": null,
+          "created_at": "2026-06-04T00:26:14.533764Z",
+          "updated_at": "2026-06-04T00:26:14.533764Z"
+        },
+        "all_time": {
+          "calls": 144084,
+          "tenant_count": 1,
+          "user_count": 1,
+          "component_count": 1,
+          "tenants": {
+            "unknown": 144084
+          },
+          "users": {
+            "unknown": 144084
+          },
+          "components": {
+            "unknown": 144084
+          }
+        },
+        "window": {
+          "calls": 0,
+          "tenant_count": 0,
+          "user_count": 0,
+          "component_count": 0,
+          "tenants": {},
+          "users": {},
+          "components": {}
+        },
+        "last_seen_at": "2026-07-08T21:14:39.652776Z",
+        "retirement_candidate": true,
+        "retirement_reason": "no measured usage in review window"
+      },
+      {
+        "interface": {
+          "id": "e4c140ec-7479-46f9-b185-4b533f19d639",
+          "interface_key": "rest_api:GET /workstreams/workplan-index",
+          "interface_kind": "rest_api",
+          "legacy_since": "2026-06-04T05:20:58.321869Z",
+          "replacement_ref": "/workplans/index",
+          "owner_component": "state-hub.api",
+          "status": "legacy",
+          "replacement_verified": true,
+          "manual_hold": false,
+          "hold_reason": null,
+          "notes": null,
+          "retired_at": null,
+          "created_at": "2026-06-04T05:20:58.321869Z",
+          "updated_at": "2026-06-04T05:20:58.321869Z"
+        },
+        "all_time": {
+          "calls": 30,
+          "tenant_count": 1,
+          "user_count": 1,
+          "component_count": 1,
+          "tenants": {
+            "unknown": 30
+          },
+          "users": {
+            "unknown": 30
+          },
+          "components": {
+            "unknown": 30
+          }
+        },
+        "window": {
+          "calls": 0,
+          "tenant_count": 0,
+          "user_count": 0,
+          "component_count": 0,
+          "tenants": {},
+          "users": {},
+          "components": {}
+        },
+        "last_seen_at": "2026-07-03T05:20:34.534439Z",
+        "retirement_candidate": true,
+        "retirement_reason": "no measured usage in review window"
+      },
+      {
+        "interface": {
+          "id": "3a00b19e-e7db-4403-98aa-a77c9ab61ecc",
+          "interface_key": "rest_api:GET /workstreams/{workstream_id}",
+          "interface_kind": "rest_api",
+          "legacy_since": "2026-06-04T00:25:59.014966Z",
+          "replacement_ref": "/workplans/{workplan_id}",
+          "owner_component": "state-hub.api",
+          "status": "legacy",
+          "replacement_verified": true,
+          "manual_hold": false,
+          "hold_reason": null,
+          "notes": null,
+          "retired_at": null,
+          "created_at": "2026-06-04T00:25:59.014966Z",
+          "updated_at": "2026-06-04T00:25:59.014966Z"
+        },
+        "all_time": {
+          "calls": 511406,
+          "tenant_count": 1,
+          "user_count": 1,
+          "component_count": 1,
+          "tenants": {
+            "unknown": 511406
+          },
+          "users": {
+            "unknown": 511406
+          },
+          "components": {
+            "unknown": 511406
+          }
+        },
+        "window": {
+          "calls": 0,
+          "tenant_count": 0,
+          "user_count": 0,
+          "component_count": 0,
+          "tenants": {},
+          "users": {},
+          "components": {}
+        },
+        "last_seen_at": "2026-07-31T16:25:32.004042Z",
+        "retirement_candidate": true,
+        "retirement_reason": "no measured usage in review window"
+      },
+      {
+        "interface": {
+          "id": "69e1a255-a8b9-4101-8a68-b1bed23abfda",
+          "interface_key": "rest_api:GET /workstreams/{workstream_id}/dependencies/",
+          "interface_kind": "rest_api",
+          "legacy_since": "2026-06-04T00:25:59.291135Z",
+          "replacement_ref": "/workplans/{workplan_id}/dependencies/",
+          "owner_component": "state-hub.api",
+          "status": "legacy",
+          "replacement_verified": true,
+          "manual_hold": false,
+          "hold_reason": null,
+          "notes": null,
+          "retired_at": null,
+          "created_at": "2026-06-04T00:25:59.291135Z",
+          "updated_at": "2026-06-04T00:25:59.291135Z"
+        },
+        "all_time": {
+          "calls": 255865,
+          "tenant_count": 1,
+          "user_count": 1,
+          "component_count": 1,
+          "tenants": {
+            "unknown": 255865
+          },
+          "users": {
+            "unknown": 255865
+          },
+          "components": {
+            "unknown": 255865
+          }
+        },
+        "window": {
+          "calls": 0,
+          "tenant_count": 0,
+          "user_count": 0,
+          "component_count": 0,
+          "tenants": {},
+          "users": {},
+          "components": {}
+        },
+        "last_seen_at": "2026-07-08T21:14:12.747005Z",
+        "retirement_candidate": true,
+        "retirement_reason": "no measured usage in review window"
+      },
+      {
+        "interface": {
+          "id": "b1aae931-b51f-4a85-a723-865dd65f6132",
+          "interface_key": "rest_api:PATCH /workstreams/{workstream_id}",
+          "interface_kind": "rest_api",
+          "legacy_since": "2026-06-04T06:09:41.901035Z",
+          "replacement_ref": "/workplans/{workplan_id}",
+          "owner_component": "state-hub.api",
+          "status": "legacy",
+          "replacement_verified": true,
+          "manual_hold": false,
+          "hold_reason": null,
+          "notes": null,
+          "retired_at": null,
+          "created_at": "2026-06-04T06:09:41.901035Z",
+          "updated_at": "2026-06-04T06:09:41.901035Z"
+        },
+        "all_time": {
+          "calls": 571,
+          "tenant_count": 1,
+          "user_count": 1,
+          "component_count": 1,
+          "tenants": {
+            "unknown": 571
+          },
+          "users": {
+            "unknown": 571
+          },
+          "components": {
+            "unknown": 571
+          }
+        },
+        "window": {
+          "calls": 0,
+          "tenant_count": 0,
+          "user_count": 0,
+          "component_count": 0,
+          "tenants": {},
+          "users": {},
+          "components": {}
+        },
+        "last_seen_at": "2026-07-08T20:49:12.335710Z",
+        "retirement_candidate": true,
+        "retirement_reason": "no measured usage in review window"
+      },
+      {
+        "interface": {
+          "id": "4aea9591-970b-4918-ac4a-4da95a0a1a8c",
+          "interface_key": "rest_api:POST /decisions/ workstream_id",
+          "interface_kind": "rest_api",
+          "legacy_since": "2026-07-09T22:56:35.473130Z",
+          "replacement_ref": "POST /decisions/ with workplan_id",
+          "owner_component": "state-hub.api",
+          "status": "legacy",
+          "replacement_verified": true,
+          "manual_hold": false,
+          "hold_reason": null,
+          "notes": null,
+          "retired_at": null,
+          "created_at": "2026-07-09T22:56:35.473130Z",
+          "updated_at": "2026-07-09T22:56:35.473130Z"
+        },
+        "all_time": {
+          "calls": 3,
+          "tenant_count": 1,
+          "user_count": 1,
+          "component_count": 1,
+          "tenants": {
+            "unknown": 3
+          },
+          "users": {
+            "unknown": 3
+          },
+          "components": {
+            "unknown": 3
+          }
+        },
+        "window": {
+          "calls": 0,
+          "tenant_count": 0,
+          "user_count": 0,
+          "component_count": 0,
+          "tenants": {},
+          "users": {},
+          "components": {}
+        },
+        "last_seen_at": "2026-07-09T22:57:05.912456Z",
+        "retirement_candidate": true,
+        "retirement_reason": "no measured usage in review window"
+      },
+      {
+        "interface": {
+          "id": "4a70583c-1e41-4ec1-99a9-728856a7d79c",
+          "interface_key": "rest_api:POST /progress/ workstream_id",
+          "interface_kind": "rest_api",
+          "legacy_since": "2026-07-08T23:35:09.148333Z",
+          "replacement_ref": "POST /progress/ with workplan_id",
+          "owner_component": "state-hub.api",
+          "status": "legacy",
+          "replacement_verified": true,
+          "manual_hold": false,
+          "hold_reason": null,
+          "notes": null,
+          "retired_at": null,
+          "created_at": "2026-07-08T23:35:09.148333Z",
+          "updated_at": "2026-07-08T23:35:09.148333Z"
+        },
+        "all_time": {
+          "calls": 14,
+          "tenant_count": 1,
+          "user_count": 1,
+          "component_count": 1,
+          "tenants": {
+            "unknown": 14
+          },
+          "users": {
+            "unknown": 14
+          },
+          "components": {
+            "unknown": 14
+          }
+        },
+        "window": {
+          "calls": 0,
+          "tenant_count": 0,
+          "user_count": 0,
+          "component_count": 0,
+          "tenants": {},
+          "users": {},
+          "components": {}
+        },
+        "last_seen_at": "2026-07-10T08:34:42.959724Z",
+        "retirement_candidate": true,
+        "retirement_reason": "no measured usage in review window"
+      },
+      {
+        "interface": {
+          "id": "6df4e443-7bf1-461a-923b-a6eb52fe7b07",
+          "interface_key": "rest_api:POST /tasks/ workstream_id",
+          "interface_kind": "rest_api",
+          "legacy_since": "2026-07-08T22:38:29.405720Z",
+          "replacement_ref": "POST /tasks/ with workplan_id",
+          "owner_component": "state-hub.api",
+          "status": "legacy",
+          "replacement_verified": true,
+          "manual_hold": false,
+          "hold_reason": null,
+          "notes": null,
+          "retired_at": null,
+          "created_at": "2026-07-08T22:38:29.405720Z",
+          "updated_at": "2026-07-08T22:38:29.405720Z"
+        },
+        "all_time": {
+          "calls": 5,
+          "tenant_count": 1,
+          "user_count": 1,
+          "component_count": 1,
+          "tenants": {
+            "unknown": 5
+          },
+          "users": {
+            "unknown": 5
+          },
+          "components": {
+            "state-hub.fix-consistency": 5
+          }
+        },
+        "window": {
+          "calls": 0,
+          "tenant_count": 0,
+          "user_count": 0,
+          "component_count": 0,
+          "tenants": {},
+          "users": {},
+          "components": {}
+        },
+        "last_seen_at": "2026-07-08T22:38:29.976918Z",
+        "retirement_candidate": true,
+        "retirement_reason": "no measured usage in review window"
+      },
+      {
+        "interface": {
+          "id": "ed6451c9-d2cc-4486-9afe-d3852782cabc",
+          "interface_key": "rest_api:POST /workstreams/",
+          "interface_kind": "rest_api",
+          "legacy_since": "2026-06-04T07:40:24.168535Z",
+          "replacement_ref": "/workplans/",
+          "owner_component": "state-hub.api",
+          "status": "legacy",
+          "replacement_verified": true,
+          "manual_hold": false,
+          "hold_reason": null,
+          "notes": null,
+          "retired_at": null,
+          "created_at": "2026-06-04T07:40:24.168535Z",
+          "updated_at": "2026-06-04T07:40:24.168535Z"
+        },
+        "all_time": {
+          "calls": 824,
+          "tenant_count": 1,
+          "user_count": 1,
+          "component_count": 1,
+          "tenants": {
+            "unknown": 824
+          },
+          "users": {
+            "unknown": 824
+          },
+          "components": {
+            "unknown": 824
+          }
+        },
+        "window": {
+          "calls": 0,
+          "tenant_count": 0,
+          "user_count": 0,
+          "component_count": 0,
+          "tenants": {},
+          "users": {},
+          "components": {}
+        },
+        "last_seen_at": "2026-07-08T20:38:05.903144Z",
+        "retirement_candidate": true,
+        "retirement_reason": "no measured usage in review window"
+      },
+      {
+        "interface": {
+          "id": "281fd706-b192-4194-8055-2d8733c115f9",
+          "interface_key": "rest_api:POST /workstreams/{workstream_id}/dependencies/",
+          "interface_kind": "rest_api",
+          "legacy_since": "2026-06-04T22:57:37.149207Z",
+          "replacement_ref": "/workplans/{workplan_id}/dependencies/",
+          "owner_component": "state-hub.api",
+          "status": "legacy",
+          "replacement_verified": true,
+          "manual_hold": false,
+          "hold_reason": null,
+          "notes": null,
+          "retired_at": null,
+          "created_at": "2026-06-04T22:57:37.149207Z",
+          "updated_at": "2026-06-04T22:57:37.149207Z"
+        },
+        "all_time": {
+          "calls": 4971,
+          "tenant_count": 1,
+          "user_count": 1,
+          "component_count": 1,
+          "tenants": {
+            "unknown": 4971
+          },
+          "users": {
+            "unknown": 4971
+          },
+          "components": {
+            "unknown": 4971
+          }
+        },
+        "window": {
+          "calls": 0,
+          "tenant_count": 0,
+          "user_count": 0,
+          "component_count": 0,
+          "tenants": {},
+          "users": {},
+          "components": {}
+        },
+        "last_seen_at": "2026-07-01T22:09:24.229011Z",
+        "retirement_candidate": true,
+        "retirement_reason": "no measured usage in review window"
+      }
+    ]
+  },
+  "hours": 8
+}
diff --git a/docs/evidence/legacy-meter-weekly-review-20260802.json b/docs/evidence/legacy-meter-weekly-review-20260802.json
new file mode 100644
index 0000000..861487b
--- /dev/null
+++ b/docs/evidence/legacy-meter-weekly-review-20260802.json
@@ -0,0 +1,1755 @@
+{
+  "captured_at": "2026-08-02T14:00:05.219685+00:00",
+  "api_base": "http://127.0.0.1:8000",
+  "workplan": "STATE-WP-0070",
+  "retired_interfaces": [],
+  "weekly_review": {
+    "generated_at": "2026-08-02T14:00:05.203305Z",
+    "window_start": "2026-08-02T06:00:04.159083Z",
+    "window_end": "2026-08-02T14:00:04.159083Z",
+    "cadence": "weekly",
+    "activity_core_handoff": {
+      "activity_id": "statehub-legacy-interface-review",
+      "cadence": "weekly",
+      "source_endpoint": "/legacy-meter/weekly-review",
+      "state_owner": "state-hub",
+      "scheduler_owner": "activity-core"
+    },
+    "interfaces": [
+      {
+        "interface": {
+          "id": "8051fb40-66c9-4dc4-a413-13e8573e04a3",
+          "interface_key": "event_subject:org.statehub.workstream.completed",
+          "interface_kind": "event_subject",
+          "legacy_since": "2026-06-04T06:09:42.198193Z",
+          "replacement_ref": "org.statehub.workplan.completed",
+          "owner_component": "state-hub.events",
+          "status": "retired",
+          "replacement_verified": true,
+          "manual_hold": false,
+          "hold_reason": null,
+          "notes": "Retired by STATE-WP-0069 closeout",
+          "retired_at": "2026-07-08T21:38:52.773601Z",
+          "created_at": "2026-06-04T06:09:42.198193Z",
+          "updated_at": "2026-07-08T21:38:52.761243Z"
+        },
+        "all_time": {
+          "calls": 255,
+          "tenant_count": 1,
+          "user_count": 1,
+          "component_count": 1,
+          "tenants": {
+            "unknown": 255
+          },
+          "users": {
+            "unknown": 255
+          },
+          "components": {
+            "state-hub.events": 255
+          }
+        },
+        "window": {
+          "calls": 0,
+          "tenant_count": 0,
+          "user_count": 0,
+          "component_count": 0,
+          "tenants": {},
+          "users": {},
+          "components": {}
+        },
+        "last_seen_at": "2026-07-08T20:49:12.839383Z",
+        "retirement_candidate": false,
+        "retirement_reason": "already retired"
+      },
+      {
+        "interface": {
+          "id": "63ed90e3-42b4-431a-94db-e1254a52f9e2",
+          "interface_key": "mcp:create_workstream",
+          "interface_kind": "mcp_tool",
+          "legacy_since": "2026-07-10T13:19:44.205900Z",
+          "replacement_ref": "create_workplan",
+          "owner_component": "state-hub.mcp",
+          "status": "legacy",
+          "replacement_verified": true,
+          "manual_hold": false,
+          "hold_reason": null,
+          "notes": "Registered by STATE-WP-0070 T03 \u2014 zero-window streak starts at registration",
+          "retired_at": null,
+          "created_at": "2026-07-10T13:19:44.205900Z",
+          "updated_at": "2026-07-10T13:19:44.205900Z"
+        },
+        "all_time": {
+          "calls": 2,
+          "tenant_count": 1,
+          "user_count": 1,
+          "component_count": 1,
+          "tenants": {
+            "unknown": 2
+          },
+          "users": {
+            "unknown": 2
+          },
+          "components": {
+            "state-hub.mcp": 2
+          }
+        },
+        "window": {
+          "calls": 0,
+          "tenant_count": 0,
+          "user_count": 0,
+          "component_count": 0,
+          "tenants": {},
+          "users": {},
+          "components": {}
+        },
+        "last_seen_at": "2026-07-10T13:20:43.378546Z",
+        "retirement_candidate": true,
+        "retirement_reason": "no measured usage in review window"
+      },
+      {
+        "interface": {
+          "id": "b6a5fe44-fb85-4ef7-a273-78d09da777af",
+          "interface_key": "mcp:list_workstreams",
+          "interface_kind": "mcp_tool",
+          "legacy_since": "2026-07-10T13:19:26.075491Z",
+          "replacement_ref": "list_workplans",
+          "owner_component": "state-hub.mcp",
+          "status": "legacy",
+          "replacement_verified": true,
+          "manual_hold": false,
+          "hold_reason": null,
+          "notes": null,
+          "retired_at": null,
+          "created_at": "2026-07-10T13:19:26.075491Z",
+          "updated_at": "2026-07-10T13:19:26.075491Z"
+        },
+        "all_time": {
+          "calls": 2,
+          "tenant_count": 1,
+          "user_count": 1,
+          "component_count": 1,
+          "tenants": {
+            "unknown": 2
+          },
+          "users": {
+            "unknown": 2
+          },
+          "components": {
+            "state-hub.mcp": 2
+          }
+        },
+        "window": {
+          "calls": 0,
+          "tenant_count": 0,
+          "user_count": 0,
+          "component_count": 0,
+          "tenants": {},
+          "users": {},
+          "components": {}
+        },
+        "last_seen_at": "2026-07-10T13:20:42.374940Z",
+        "retirement_candidate": true,
+        "retirement_reason": "no measured usage in review window"
+      },
+      {
+        "interface": {
+          "id": "53c3372b-307d-4d6a-8ea4-bc36cacdcaf2",
+          "interface_key": "mcp:update_workstream",
+          "interface_kind": "mcp_tool",
+          "legacy_since": "2026-07-10T13:19:44.255216Z",
+          "replacement_ref": "update_workplan",
+          "owner_component": "state-hub.mcp",
+          "status": "legacy",
+          "replacement_verified": true,
+          "manual_hold": false,
+          "hold_reason": null,
+          "notes": "Registered by STATE-WP-0070 T03 \u2014 zero-window streak starts at registration",
+          "retired_at": null,
+          "created_at": "2026-07-10T13:19:44.255216Z",
+          "updated_at": "2026-07-10T13:19:44.255216Z"
+        },
+        "all_time": {
+          "calls": 0,
+          "tenant_count": 0,
+          "user_count": 0,
+          "component_count": 0,
+          "tenants": {},
+          "users": {},
+          "components": {}
+        },
+        "window": {
+          "calls": 0,
+          "tenant_count": 0,
+          "user_count": 0,
+          "component_count": 0,
+          "tenants": {},
+          "users": {},
+          "components": {}
+        },
+        "last_seen_at": null,
+        "retirement_candidate": true,
+        "retirement_reason": "no measured usage in review window"
+      },
+      {
+        "interface": {
+          "id": "bed4d08a-3471-48f5-9f0e-f9d550383a26",
+          "interface_key": "mcp:update_workstream_status",
+          "interface_kind": "mcp_tool",
+          "legacy_since": "2026-07-10T13:19:44.303612Z",
+          "replacement_ref": "update_workplan_status",
+          "owner_component": "state-hub.mcp",
+          "status": "legacy",
+          "replacement_verified": true,
+          "manual_hold": false,
+          "hold_reason": null,
+          "notes": "Registered by STATE-WP-0070 T03 \u2014 zero-window streak starts at registration",
+          "retired_at": null,
+          "created_at": "2026-07-10T13:19:44.303612Z",
+          "updated_at": "2026-07-10T13:19:44.303612Z"
+        },
+        "all_time": {
+          "calls": 0,
+          "tenant_count": 0,
+          "user_count": 0,
+          "component_count": 0,
+          "tenants": {},
+          "users": {},
+          "components": {}
+        },
+        "window": {
+          "calls": 0,
+          "tenant_count": 0,
+          "user_count": 0,
+          "component_count": 0,
+          "tenants": {},
+          "users": {},
+          "components": {}
+        },
+        "last_seen_at": null,
+        "retirement_candidate": true,
+        "retirement_reason": "no measured usage in review window"
+      },
+      {
+        "interface": {
+          "id": "46900dc2-0893-405b-ba59-80f31fb6ebb1",
+          "interface_key": "state://workstreams/{topic_slug}",
+          "interface_kind": "mcp_tool",
+          "legacy_since": "2026-07-10T13:19:44.344493Z",
+          "replacement_ref": "state://workplans/{topic_slug}",
+          "owner_component": "state-hub.mcp",
+          "status": "legacy",
+          "replacement_verified": true,
+          "manual_hold": false,
+          "hold_reason": null,
+          "notes": "Registered by STATE-WP-0070 T03 \u2014 zero-window streak starts at registration",
+          "retired_at": null,
+          "created_at": "2026-07-10T13:19:44.344493Z",
+          "updated_at": "2026-07-10T13:19:44.344493Z"
+        },
+        "all_time": {
+          "calls": 1,
+          "tenant_count": 1,
+          "user_count": 1,
+          "component_count": 1,
+          "tenants": {
+            "unknown": 1
+          },
+          "users": {
+            "unknown": 1
+          },
+          "components": {
+            "state-hub.mcp": 1
+          }
+        },
+        "window": {
+          "calls": 0,
+          "tenant_count": 0,
+          "user_count": 0,
+          "component_count": 0,
+          "tenants": {},
+          "users": {},
+          "components": {}
+        },
+        "last_seen_at": "2026-07-10T13:20:34.491811Z",
+        "retirement_candidate": true,
+        "retirement_reason": "no measured usage in review window"
+      },
+      {
+        "interface": {
+          "id": "cd9342fd-27e7-4a46-a1be-d41499e106a3",
+          "interface_key": "rest_api:DELETE /workstreams/{workstream_id}",
+          "interface_kind": "rest_api",
+          "legacy_since": "2026-06-06T17:28:13.052813Z",
+          "replacement_ref": "/workplans/{workplan_id}",
+          "owner_component": "state-hub.api",
+          "status": "legacy",
+          "replacement_verified": true,
+          "manual_hold": false,
+          "hold_reason": null,
+          "notes": null,
+          "retired_at": null,
+          "created_at": "2026-06-06T17:28:13.052813Z",
+          "updated_at": "2026-06-06T17:28:13.052813Z"
+        },
+        "all_time": {
+          "calls": 1,
+          "tenant_count": 1,
+          "user_count": 1,
+          "component_count": 1,
+          "tenants": {
+            "unknown": 1
+          },
+          "users": {
+            "unknown": 1
+          },
+          "components": {
+            "unknown": 1
+          }
+        },
+        "window": {
+          "calls": 0,
+          "tenant_count": 0,
+          "user_count": 0,
+          "component_count": 0,
+          "tenants": {},
+          "users": {},
+          "components": {}
+        },
+        "last_seen_at": "2026-06-06T17:28:13.047529Z",
+        "retirement_candidate": true,
+        "retirement_reason": "no measured usage in review window"
+      },
+      {
+        "interface": {
+          "id": "a4e0948c-cd4a-461e-8ae2-7fd7b51d04a7",
+          "interface_key": "rest_api:GET /decisions/?workstream_id",
+          "interface_kind": "rest_api",
+          "legacy_since": "2026-07-09T23:07:53.093223Z",
+          "replacement_ref": "/decisions/?workplan_id=<workplan_id>",
+          "owner_component": "state-hub.api",
+          "status": "legacy",
+          "replacement_verified": true,
+          "manual_hold": false,
+          "hold_reason": null,
+          "notes": null,
+          "retired_at": null,
+          "created_at": "2026-07-09T23:07:53.093223Z",
+          "updated_at": "2026-07-09T23:07:53.093223Z"
+        },
+        "all_time": {
+          "calls": 1,
+          "tenant_count": 1,
+          "user_count": 1,
+          "component_count": 1,
+          "tenants": {
+            "unknown": 1
+          },
+          "users": {
+            "unknown": 1
+          },
+          "components": {
+            "unknown": 1
+          }
+        },
+        "window": {
+          "calls": 0,
+          "tenant_count": 0,
+          "user_count": 0,
+          "component_count": 0,
+          "tenants": {},
+          "users": {},
+          "components": {}
+        },
+        "last_seen_at": "2026-07-09T23:07:53.083299Z",
+        "retirement_candidate": true,
+        "retirement_reason": "no measured usage in review window"
+      },
+      {
+        "interface": {
+          "id": "70a9346e-e0ee-42ac-874f-f160580b54dd",
+          "interface_key": "rest_api:GET /progress/?workstream_id",
+          "interface_kind": "rest_api",
+          "legacy_since": "2026-07-13T22:04:03.911449Z",
+          "replacement_ref": "/progress/?workplan_id=<workplan_id>",
+          "owner_component": "state-hub.api",
+          "status": "legacy",
+          "replacement_verified": true,
+          "manual_hold": false,
+          "hold_reason": null,
+          "notes": null,
+          "retired_at": null,
+          "created_at": "2026-07-13T22:04:03.911449Z",
+          "updated_at": "2026-07-13T22:04:03.911449Z"
+        },
+        "all_time": {
+          "calls": 1,
+          "tenant_count": 1,
+          "user_count": 1,
+          "component_count": 1,
+          "tenants": {
+            "unknown": 1
+          },
+          "users": {
+            "unknown": 1
+          },
+          "components": {
+            "unknown": 1
+          }
+        },
+        "window": {
+          "calls": 0,
+          "tenant_count": 0,
+          "user_count": 0,
+          "component_count": 0,
+          "tenants": {},
+          "users": {},
+          "components": {}
+        },
+        "last_seen_at": "2026-07-13T22:04:03.904998Z",
+        "retirement_candidate": true,
+        "retirement_reason": "no measured usage in review window"
+      },
+      {
+        "interface": {
+          "id": "be3cdcf8-250b-4bf0-801f-02ffd5f57e00",
+          "interface_key": "rest_api:GET /tasks/?workstream_id",
+          "interface_kind": "rest_api",
+          "legacy_since": "2026-07-08T19:32:21.628513Z",
+          "replacement_ref": "/tasks/?workplan_id=<workplan_id>",
+          "owner_component": "state-hub.api",
+          "status": "legacy",
+          "replacement_verified": true,
+          "manual_hold": false,
+          "hold_reason": null,
+          "notes": null,
+          "retired_at": null,
+          "created_at": "2026-07-08T19:32:21.628513Z",
+          "updated_at": "2026-07-08T19:32:21.628513Z"
+        },
+        "all_time": {
+          "calls": 589,
+          "tenant_count": 1,
+          "user_count": 1,
+          "component_count": 1,
+          "tenants": {
+            "unknown": 589
+          },
+          "users": {
+            "unknown": 589
+          },
+          "components": {
+            "unknown": 589
+          }
+        },
+        "window": {
+          "calls": 0,
+          "tenant_count": 0,
+          "user_count": 0,
+          "component_count": 0,
+          "tenants": {},
+          "users": {},
+          "components": {}
+        },
+        "last_seen_at": "2026-07-31T16:25:32.181901Z",
+        "retirement_candidate": true,
+        "retirement_reason": "no measured usage in review window"
+      },
+      {
+        "interface": {
+          "id": "3e4a3d0b-08fa-45c3-91e2-4f514a914b97",
+          "interface_key": "rest_api:GET /workstreams/",
+          "interface_kind": "rest_api",
+          "legacy_since": "2026-06-04T00:26:14.533764Z",
+          "replacement_ref": "/workplans/",
+          "owner_component": "state-hub.api",
+          "status": "legacy",
+          "replacement_verified": true,
+          "manual_hold": false,
+          "hold_reason": null,
+          "notes": null,
+          "retired_at": null,
+          "created_at": "2026-06-04T00:26:14.533764Z",
+          "updated_at": "2026-06-04T00:26:14.533764Z"
+        },
+        "all_time": {
+          "calls": 144084,
+          "tenant_count": 1,
+          "user_count": 1,
+          "component_count": 1,
+          "tenants": {
+            "unknown": 144084
+          },
+          "users": {
+            "unknown": 144084
+          },
+          "components": {
+            "unknown": 144084
+          }
+        },
+        "window": {
+          "calls": 0,
+          "tenant_count": 0,
+          "user_count": 0,
+          "component_count": 0,
+          "tenants": {},
+          "users": {},
+          "components": {}
+        },
+        "last_seen_at": "2026-07-08T21:14:39.652776Z",
+        "retirement_candidate": true,
+        "retirement_reason": "no measured usage in review window"
+      },
+      {
+        "interface": {
+          "id": "e4c140ec-7479-46f9-b185-4b533f19d639",
+          "interface_key": "rest_api:GET /workstreams/workplan-index",
+          "interface_kind": "rest_api",
+          "legacy_since": "2026-06-04T05:20:58.321869Z",
+          "replacement_ref": "/workplans/index",
+          "owner_component": "state-hub.api",
+          "status": "legacy",
+          "replacement_verified": true,
+          "manual_hold": false,
+          "hold_reason": null,
+          "notes": null,
+          "retired_at": null,
+          "created_at": "2026-06-04T05:20:58.321869Z",
+          "updated_at": "2026-06-04T05:20:58.321869Z"
+        },
+        "all_time": {
+          "calls": 30,
+          "tenant_count": 1,
+          "user_count": 1,
+          "component_count": 1,
+          "tenants": {
+            "unknown": 30
+          },
+          "users": {
+            "unknown": 30
+          },
+          "components": {
+            "unknown": 30
+          }
+        },
+        "window": {
+          "calls": 0,
+          "tenant_count": 0,
+          "user_count": 0,
+          "component_count": 0,
+          "tenants": {},
+          "users": {},
+          "components": {}
+        },
+        "last_seen_at": "2026-07-03T05:20:34.534439Z",
+        "retirement_candidate": true,
+        "retirement_reason": "no measured usage in review window"
+      },
+      {
+        "interface": {
+          "id": "3a00b19e-e7db-4403-98aa-a77c9ab61ecc",
+          "interface_key": "rest_api:GET /workstreams/{workstream_id}",
+          "interface_kind": "rest_api",
+          "legacy_since": "2026-06-04T00:25:59.014966Z",
+          "replacement_ref": "/workplans/{workplan_id}",
+          "owner_component": "state-hub.api",
+          "status": "legacy",
+          "replacement_verified": true,
+          "manual_hold": false,
+          "hold_reason": null,
+          "notes": null,
+          "retired_at": null,
+          "created_at": "2026-06-04T00:25:59.014966Z",
+          "updated_at": "2026-06-04T00:25:59.014966Z"
+        },
+        "all_time": {
+          "calls": 511406,
+          "tenant_count": 1,
+          "user_count": 1,
+          "component_count": 1,
+          "tenants": {
+            "unknown": 511406
+          },
+          "users": {
+            "unknown": 511406
+          },
+          "components": {
+            "unknown": 511406
+          }
+        },
+        "window": {
+          "calls": 0,
+          "tenant_count": 0,
+          "user_count": 0,
+          "component_count": 0,
+          "tenants": {},
+          "users": {},
+          "components": {}
+        },
+        "last_seen_at": "2026-07-31T16:25:32.004042Z",
+        "retirement_candidate": true,
+        "retirement_reason": "no measured usage in review window"
+      },
+      {
+        "interface": {
+          "id": "69e1a255-a8b9-4101-8a68-b1bed23abfda",
+          "interface_key": "rest_api:GET /workstreams/{workstream_id}/dependencies/",
+          "interface_kind": "rest_api",
+          "legacy_since": "2026-06-04T00:25:59.291135Z",
+          "replacement_ref": "/workplans/{workplan_id}/dependencies/",
+          "owner_component": "state-hub.api",
+          "status": "legacy",
+          "replacement_verified": true,
+          "manual_hold": false,
+          "hold_reason": null,
+          "notes": null,
+          "retired_at": null,
+          "created_at": "2026-06-04T00:25:59.291135Z",
+          "updated_at": "2026-06-04T00:25:59.291135Z"
+        },
+        "all_time": {
+          "calls": 255865,
+          "tenant_count": 1,
+          "user_count": 1,
+          "component_count": 1,
+          "tenants": {
+            "unknown": 255865
+          },
+          "users": {
+            "unknown": 255865
+          },
+          "components": {
+            "unknown": 255865
+          }
+        },
+        "window": {
+          "calls": 0,
+          "tenant_count": 0,
+          "user_count": 0,
+          "component_count": 0,
+          "tenants": {},
+          "users": {},
+          "components": {}
+        },
+        "last_seen_at": "2026-07-08T21:14:12.747005Z",
+        "retirement_candidate": true,
+        "retirement_reason": "no measured usage in review window"
+      },
+      {
+        "interface": {
+          "id": "b1aae931-b51f-4a85-a723-865dd65f6132",
+          "interface_key": "rest_api:PATCH /workstreams/{workstream_id}",
+          "interface_kind": "rest_api",
+          "legacy_since": "2026-06-04T06:09:41.901035Z",
+          "replacement_ref": "/workplans/{workplan_id}",
+          "owner_component": "state-hub.api",
+          "status": "legacy",
+          "replacement_verified": true,
+          "manual_hold": false,
+          "hold_reason": null,
+          "notes": null,
+          "retired_at": null,
+          "created_at": "2026-06-04T06:09:41.901035Z",
+          "updated_at": "2026-06-04T06:09:41.901035Z"
+        },
+        "all_time": {
+          "calls": 571,
+          "tenant_count": 1,
+          "user_count": 1,
+          "component_count": 1,
+          "tenants": {
+            "unknown": 571
+          },
+          "users": {
+            "unknown": 571
+          },
+          "components": {
+            "unknown": 571
+          }
+        },
+        "window": {
+          "calls": 0,
+          "tenant_count": 0,
+          "user_count": 0,
+          "component_count": 0,
+          "tenants": {},
+          "users": {},
+          "components": {}
+        },
+        "last_seen_at": "2026-07-08T20:49:12.335710Z",
+        "retirement_candidate": true,
+        "retirement_reason": "no measured usage in review window"
+      },
+      {
+        "interface": {
+          "id": "4aea9591-970b-4918-ac4a-4da95a0a1a8c",
+          "interface_key": "rest_api:POST /decisions/ workstream_id",
+          "interface_kind": "rest_api",
+          "legacy_since": "2026-07-09T22:56:35.473130Z",
+          "replacement_ref": "POST /decisions/ with workplan_id",
+          "owner_component": "state-hub.api",
+          "status": "legacy",
+          "replacement_verified": true,
+          "manual_hold": false,
+          "hold_reason": null,
+          "notes": null,
+          "retired_at": null,
+          "created_at": "2026-07-09T22:56:35.473130Z",
+          "updated_at": "2026-07-09T22:56:35.473130Z"
+        },
+        "all_time": {
+          "calls": 3,
+          "tenant_count": 1,
+          "user_count": 1,
+          "component_count": 1,
+          "tenants": {
+            "unknown": 3
+          },
+          "users": {
+            "unknown": 3
+          },
+          "components": {
+            "unknown": 3
+          }
+        },
+        "window": {
+          "calls": 0,
+          "tenant_count": 0,
+          "user_count": 0,
+          "component_count": 0,
+          "tenants": {},
+          "users": {},
+          "components": {}
+        },
+        "last_seen_at": "2026-07-09T22:57:05.912456Z",
+        "retirement_candidate": true,
+        "retirement_reason": "no measured usage in review window"
+      },
+      {
+        "interface": {
+          "id": "4a70583c-1e41-4ec1-99a9-728856a7d79c",
+          "interface_key": "rest_api:POST /progress/ workstream_id",
+          "interface_kind": "rest_api",
+          "legacy_since": "2026-07-08T23:35:09.148333Z",
+          "replacement_ref": "POST /progress/ with workplan_id",
+          "owner_component": "state-hub.api",
+          "status": "legacy",
+          "replacement_verified": true,
+          "manual_hold": false,
+          "hold_reason": null,
+          "notes": null,
+          "retired_at": null,
+          "created_at": "2026-07-08T23:35:09.148333Z",
+          "updated_at": "2026-07-08T23:35:09.148333Z"
+        },
+        "all_time": {
+          "calls": 14,
+          "tenant_count": 1,
+          "user_count": 1,
+          "component_count": 1,
+          "tenants": {
+            "unknown": 14
+          },
+          "users": {
+            "unknown": 14
+          },
+          "components": {
+            "unknown": 14
+          }
+        },
+        "window": {
+          "calls": 0,
+          "tenant_count": 0,
+          "user_count": 0,
+          "component_count": 0,
+          "tenants": {},
+          "users": {},
+          "components": {}
+        },
+        "last_seen_at": "2026-07-10T08:34:42.959724Z",
+        "retirement_candidate": true,
+        "retirement_reason": "no measured usage in review window"
+      },
+      {
+        "interface": {
+          "id": "6df4e443-7bf1-461a-923b-a6eb52fe7b07",
+          "interface_key": "rest_api:POST /tasks/ workstream_id",
+          "interface_kind": "rest_api",
+          "legacy_since": "2026-07-08T22:38:29.405720Z",
+          "replacement_ref": "POST /tasks/ with workplan_id",
+          "owner_component": "state-hub.api",
+          "status": "legacy",
+          "replacement_verified": true,
+          "manual_hold": false,
+          "hold_reason": null,
+          "notes": null,
+          "retired_at": null,
+          "created_at": "2026-07-08T22:38:29.405720Z",
+          "updated_at": "2026-07-08T22:38:29.405720Z"
+        },
+        "all_time": {
+          "calls": 5,
+          "tenant_count": 1,
+          "user_count": 1,
+          "component_count": 1,
+          "tenants": {
+            "unknown": 5
+          },
+          "users": {
+            "unknown": 5
+          },
+          "components": {
+            "state-hub.fix-consistency": 5
+          }
+        },
+        "window": {
+          "calls": 0,
+          "tenant_count": 0,
+          "user_count": 0,
+          "component_count": 0,
+          "tenants": {},
+          "users": {},
+          "components": {}
+        },
+        "last_seen_at": "2026-07-08T22:38:29.976918Z",
+        "retirement_candidate": true,
+        "retirement_reason": "no measured usage in review window"
+      },
+      {
+        "interface": {
+          "id": "ed6451c9-d2cc-4486-9afe-d3852782cabc",
+          "interface_key": "rest_api:POST /workstreams/",
+          "interface_kind": "rest_api",
+          "legacy_since": "2026-06-04T07:40:24.168535Z",
+          "replacement_ref": "/workplans/",
+          "owner_component": "state-hub.api",
+          "status": "legacy",
+          "replacement_verified": true,
+          "manual_hold": false,
+          "hold_reason": null,
+          "notes": null,
+          "retired_at": null,
+          "created_at": "2026-06-04T07:40:24.168535Z",
+          "updated_at": "2026-06-04T07:40:24.168535Z"
+        },
+        "all_time": {
+          "calls": 824,
+          "tenant_count": 1,
+          "user_count": 1,
+          "component_count": 1,
+          "tenants": {
+            "unknown": 824
+          },
+          "users": {
+            "unknown": 824
+          },
+          "components": {
+            "unknown": 824
+          }
+        },
+        "window": {
+          "calls": 0,
+          "tenant_count": 0,
+          "user_count": 0,
+          "component_count": 0,
+          "tenants": {},
+          "users": {},
+          "components": {}
+        },
+        "last_seen_at": "2026-07-08T20:38:05.903144Z",
+        "retirement_candidate": true,
+        "retirement_reason": "no measured usage in review window"
+      },
+      {
+        "interface": {
+          "id": "281fd706-b192-4194-8055-2d8733c115f9",
+          "interface_key": "rest_api:POST /workstreams/{workstream_id}/dependencies/",
+          "interface_kind": "rest_api",
+          "legacy_since": "2026-06-04T22:57:37.149207Z",
+          "replacement_ref": "/workplans/{workplan_id}/dependencies/",
+          "owner_component": "state-hub.api",
+          "status": "legacy",
+          "replacement_verified": true,
+          "manual_hold": false,
+          "hold_reason": null,
+          "notes": null,
+          "retired_at": null,
+          "created_at": "2026-06-04T22:57:37.149207Z",
+          "updated_at": "2026-06-04T22:57:37.149207Z"
+        },
+        "all_time": {
+          "calls": 4971,
+          "tenant_count": 1,
+          "user_count": 1,
+          "component_count": 1,
+          "tenants": {
+            "unknown": 4971
+          },
+          "users": {
+            "unknown": 4971
+          },
+          "components": {
+            "unknown": 4971
+          }
+        },
+        "window": {
+          "calls": 0,
+          "tenant_count": 0,
+          "user_count": 0,
+          "component_count": 0,
+          "tenants": {},
+          "users": {},
+          "components": {}
+        },
+        "last_seen_at": "2026-07-01T22:09:24.229011Z",
+        "retirement_candidate": true,
+        "retirement_reason": "no measured usage in review window"
+      }
+    ],
+    "retirement_candidates": [
+      {
+        "interface": {
+          "id": "63ed90e3-42b4-431a-94db-e1254a52f9e2",
+          "interface_key": "mcp:create_workstream",
+          "interface_kind": "mcp_tool",
+          "legacy_since": "2026-07-10T13:19:44.205900Z",
+          "replacement_ref": "create_workplan",
+          "owner_component": "state-hub.mcp",
+          "status": "legacy",
+          "replacement_verified": true,
+          "manual_hold": false,
+          "hold_reason": null,
+          "notes": "Registered by STATE-WP-0070 T03 \u2014 zero-window streak starts at registration",
+          "retired_at": null,
+          "created_at": "2026-07-10T13:19:44.205900Z",
+          "updated_at": "2026-07-10T13:19:44.205900Z"
+        },
+        "all_time": {
+          "calls": 2,
+          "tenant_count": 1,
+          "user_count": 1,
+          "component_count": 1,
+          "tenants": {
+            "unknown": 2
+          },
+          "users": {
+            "unknown": 2
+          },
+          "components": {
+            "state-hub.mcp": 2
+          }
+        },
+        "window": {
+          "calls": 0,
+          "tenant_count": 0,
+          "user_count": 0,
+          "component_count": 0,
+          "tenants": {},
+          "users": {},
+          "components": {}
+        },
+        "last_seen_at": "2026-07-10T13:20:43.378546Z",
+        "retirement_candidate": true,
+        "retirement_reason": "no measured usage in review window"
+      },
+      {
+        "interface": {
+          "id": "b6a5fe44-fb85-4ef7-a273-78d09da777af",
+          "interface_key": "mcp:list_workstreams",
+          "interface_kind": "mcp_tool",
+          "legacy_since": "2026-07-10T13:19:26.075491Z",
+          "replacement_ref": "list_workplans",
+          "owner_component": "state-hub.mcp",
+          "status": "legacy",
+          "replacement_verified": true,
+          "manual_hold": false,
+          "hold_reason": null,
+          "notes": null,
+          "retired_at": null,
+          "created_at": "2026-07-10T13:19:26.075491Z",
+          "updated_at": "2026-07-10T13:19:26.075491Z"
+        },
+        "all_time": {
+          "calls": 2,
+          "tenant_count": 1,
+          "user_count": 1,
+          "component_count": 1,
+          "tenants": {
+            "unknown": 2
+          },
+          "users": {
+            "unknown": 2
+          },
+          "components": {
+            "state-hub.mcp": 2
+          }
+        },
+        "window": {
+          "calls": 0,
+          "tenant_count": 0,
+          "user_count": 0,
+          "component_count": 0,
+          "tenants": {},
+          "users": {},
+          "components": {}
+        },
+        "last_seen_at": "2026-07-10T13:20:42.374940Z",
+        "retirement_candidate": true,
+        "retirement_reason": "no measured usage in review window"
+      },
+      {
+        "interface": {
+          "id": "53c3372b-307d-4d6a-8ea4-bc36cacdcaf2",
+          "interface_key": "mcp:update_workstream",
+          "interface_kind": "mcp_tool",
+          "legacy_since": "2026-07-10T13:19:44.255216Z",
+          "replacement_ref": "update_workplan",
+          "owner_component": "state-hub.mcp",
+          "status": "legacy",
+          "replacement_verified": true,
+          "manual_hold": false,
+          "hold_reason": null,
+          "notes": "Registered by STATE-WP-0070 T03 \u2014 zero-window streak starts at registration",
+          "retired_at": null,
+          "created_at": "2026-07-10T13:19:44.255216Z",
+          "updated_at": "2026-07-10T13:19:44.255216Z"
+        },
+        "all_time": {
+          "calls": 0,
+          "tenant_count": 0,
+          "user_count": 0,
+          "component_count": 0,
+          "tenants": {},
+          "users": {},
+          "components": {}
+        },
+        "window": {
+          "calls": 0,
+          "tenant_count": 0,
+          "user_count": 0,
+          "component_count": 0,
+          "tenants": {},
+          "users": {},
+          "components": {}
+        },
+        "last_seen_at": null,
+        "retirement_candidate": true,
+        "retirement_reason": "no measured usage in review window"
+      },
+      {
+        "interface": {
+          "id": "bed4d08a-3471-48f5-9f0e-f9d550383a26",
+          "interface_key": "mcp:update_workstream_status",
+          "interface_kind": "mcp_tool",
+          "legacy_since": "2026-07-10T13:19:44.303612Z",
+          "replacement_ref": "update_workplan_status",
+          "owner_component": "state-hub.mcp",
+          "status": "legacy",
+          "replacement_verified": true,
+          "manual_hold": false,
+          "hold_reason": null,
+          "notes": "Registered by STATE-WP-0070 T03 \u2014 zero-window streak starts at registration",
+          "retired_at": null,
+          "created_at": "2026-07-10T13:19:44.303612Z",
+          "updated_at": "2026-07-10T13:19:44.303612Z"
+        },
+        "all_time": {
+          "calls": 0,
+          "tenant_count": 0,
+          "user_count": 0,
+          "component_count": 0,
+          "tenants": {},
+          "users": {},
+          "components": {}
+        },
+        "window": {
+          "calls": 0,
+          "tenant_count": 0,
+          "user_count": 0,
+          "component_count": 0,
+          "tenants": {},
+          "users": {},
+          "components": {}
+        },
+        "last_seen_at": null,
+        "retirement_candidate": true,
+        "retirement_reason": "no measured usage in review window"
+      },
+      {
+        "interface": {
+          "id": "46900dc2-0893-405b-ba59-80f31fb6ebb1",
+          "interface_key": "state://workstreams/{topic_slug}",
+          "interface_kind": "mcp_tool",
+          "legacy_since": "2026-07-10T13:19:44.344493Z",
+          "replacement_ref": "state://workplans/{topic_slug}",
+          "owner_component": "state-hub.mcp",
+          "status": "legacy",
+          "replacement_verified": true,
+          "manual_hold": false,
+          "hold_reason": null,
+          "notes": "Registered by STATE-WP-0070 T03 \u2014 zero-window streak starts at registration",
+          "retired_at": null,
+          "created_at": "2026-07-10T13:19:44.344493Z",
+          "updated_at": "2026-07-10T13:19:44.344493Z"
+        },
+        "all_time": {
+          "calls": 1,
+          "tenant_count": 1,
+          "user_count": 1,
+          "component_count": 1,
+          "tenants": {
+            "unknown": 1
+          },
+          "users": {
+            "unknown": 1
+          },
+          "components": {
+            "state-hub.mcp": 1
+          }
+        },
+        "window": {
+          "calls": 0,
+          "tenant_count": 0,
+          "user_count": 0,
+          "component_count": 0,
+          "tenants": {},
+          "users": {},
+          "components": {}
+        },
+        "last_seen_at": "2026-07-10T13:20:34.491811Z",
+        "retirement_candidate": true,
+        "retirement_reason": "no measured usage in review window"
+      },
+      {
+        "interface": {
+          "id": "cd9342fd-27e7-4a46-a1be-d41499e106a3",
+          "interface_key": "rest_api:DELETE /workstreams/{workstream_id}",
+          "interface_kind": "rest_api",
+          "legacy_since": "2026-06-06T17:28:13.052813Z",
+          "replacement_ref": "/workplans/{workplan_id}",
+          "owner_component": "state-hub.api",
+          "status": "legacy",
+          "replacement_verified": true,
+          "manual_hold": false,
+          "hold_reason": null,
+          "notes": null,
+          "retired_at": null,
+          "created_at": "2026-06-06T17:28:13.052813Z",
+          "updated_at": "2026-06-06T17:28:13.052813Z"
+        },
+        "all_time": {
+          "calls": 1,
+          "tenant_count": 1,
+          "user_count": 1,
+          "component_count": 1,
+          "tenants": {
+            "unknown": 1
+          },
+          "users": {
+            "unknown": 1
+          },
+          "components": {
+            "unknown": 1
+          }
+        },
+        "window": {
+          "calls": 0,
+          "tenant_count": 0,
+          "user_count": 0,
+          "component_count": 0,
+          "tenants": {},
+          "users": {},
+          "components": {}
+        },
+        "last_seen_at": "2026-06-06T17:28:13.047529Z",
+        "retirement_candidate": true,
+        "retirement_reason": "no measured usage in review window"
+      },
+      {
+        "interface": {
+          "id": "a4e0948c-cd4a-461e-8ae2-7fd7b51d04a7",
+          "interface_key": "rest_api:GET /decisions/?workstream_id",
+          "interface_kind": "rest_api",
+          "legacy_since": "2026-07-09T23:07:53.093223Z",
+          "replacement_ref": "/decisions/?workplan_id=<workplan_id>",
+          "owner_component": "state-hub.api",
+          "status": "legacy",
+          "replacement_verified": true,
+          "manual_hold": false,
+          "hold_reason": null,
+          "notes": null,
+          "retired_at": null,
+          "created_at": "2026-07-09T23:07:53.093223Z",
+          "updated_at": "2026-07-09T23:07:53.093223Z"
+        },
+        "all_time": {
+          "calls": 1,
+          "tenant_count": 1,
+          "user_count": 1,
+          "component_count": 1,
+          "tenants": {
+            "unknown": 1
+          },
+          "users": {
+            "unknown": 1
+          },
+          "components": {
+            "unknown": 1
+          }
+        },
+        "window": {
+          "calls": 0,
+          "tenant_count": 0,
+          "user_count": 0,
+          "component_count": 0,
+          "tenants": {},
+          "users": {},
+          "components": {}
+        },
+        "last_seen_at": "2026-07-09T23:07:53.083299Z",
+        "retirement_candidate": true,
+        "retirement_reason": "no measured usage in review window"
+      },
+      {
+        "interface": {
+          "id": "70a9346e-e0ee-42ac-874f-f160580b54dd",
+          "interface_key": "rest_api:GET /progress/?workstream_id",
+          "interface_kind": "rest_api",
+          "legacy_since": "2026-07-13T22:04:03.911449Z",
+          "replacement_ref": "/progress/?workplan_id=<workplan_id>",
+          "owner_component": "state-hub.api",
+          "status": "legacy",
+          "replacement_verified": true,
+          "manual_hold": false,
+          "hold_reason": null,
+          "notes": null,
+          "retired_at": null,
+          "created_at": "2026-07-13T22:04:03.911449Z",
+          "updated_at": "2026-07-13T22:04:03.911449Z"
+        },
+        "all_time": {
+          "calls": 1,
+          "tenant_count": 1,
+          "user_count": 1,
+          "component_count": 1,
+          "tenants": {
+            "unknown": 1
+          },
+          "users": {
+            "unknown": 1
+          },
+          "components": {
+            "unknown": 1
+          }
+        },
+        "window": {
+          "calls": 0,
+          "tenant_count": 0,
+          "user_count": 0,
+          "component_count": 0,
+          "tenants": {},
+          "users": {},
+          "components": {}
+        },
+        "last_seen_at": "2026-07-13T22:04:03.904998Z",
+        "retirement_candidate": true,
+        "retirement_reason": "no measured usage in review window"
+      },
+      {
+        "interface": {
+          "id": "be3cdcf8-250b-4bf0-801f-02ffd5f57e00",
+          "interface_key": "rest_api:GET /tasks/?workstream_id",
+          "interface_kind": "rest_api",
+          "legacy_since": "2026-07-08T19:32:21.628513Z",
+          "replacement_ref": "/tasks/?workplan_id=<workplan_id>",
+          "owner_component": "state-hub.api",
+          "status": "legacy",
+          "replacement_verified": true,
+          "manual_hold": false,
+          "hold_reason": null,
+          "notes": null,
+          "retired_at": null,
+          "created_at": "2026-07-08T19:32:21.628513Z",
+          "updated_at": "2026-07-08T19:32:21.628513Z"
+        },
+        "all_time": {
+          "calls": 589,
+          "tenant_count": 1,
+          "user_count": 1,
+          "component_count": 1,
+          "tenants": {
+            "unknown": 589
+          },
+          "users": {
+            "unknown": 589
+          },
+          "components": {
+            "unknown": 589
+          }
+        },
+        "window": {
+          "calls": 0,
+          "tenant_count": 0,
+          "user_count": 0,
+          "component_count": 0,
+          "tenants": {},
+          "users": {},
+          "components": {}
+        },
+        "last_seen_at": "2026-07-31T16:25:32.181901Z",
+        "retirement_candidate": true,
+        "retirement_reason": "no measured usage in review window"
+      },
+      {
+        "interface": {
+          "id": "3e4a3d0b-08fa-45c3-91e2-4f514a914b97",
+          "interface_key": "rest_api:GET /workstreams/",
+          "interface_kind": "rest_api",
+          "legacy_since": "2026-06-04T00:26:14.533764Z",
+          "replacement_ref": "/workplans/",
+          "owner_component": "state-hub.api",
+          "status": "legacy",
+          "replacement_verified": true,
+          "manual_hold": false,
+          "hold_reason": null,
+          "notes": null,
+          "retired_at": null,
+          "created_at": "2026-06-04T00:26:14.533764Z",
+          "updated_at": "2026-06-04T00:26:14.533764Z"
+        },
+        "all_time": {
+          "calls": 144084,
+          "tenant_count": 1,
+          "user_count": 1,
+          "component_count": 1,
+          "tenants": {
+            "unknown": 144084
+          },
+          "users": {
+            "unknown": 144084
+          },
+          "components": {
+            "unknown": 144084
+          }
+        },
+        "window": {
+          "calls": 0,
+          "tenant_count": 0,
+          "user_count": 0,
+          "component_count": 0,
+          "tenants": {},
+          "users": {},
+          "components": {}
+        },
+        "last_seen_at": "2026-07-08T21:14:39.652776Z",
+        "retirement_candidate": true,
+        "retirement_reason": "no measured usage in review window"
+      },
+      {
+        "interface": {
+          "id": "e4c140ec-7479-46f9-b185-4b533f19d639",
+          "interface_key": "rest_api:GET /workstreams/workplan-index",
+          "interface_kind": "rest_api",
+          "legacy_since": "2026-06-04T05:20:58.321869Z",
+          "replacement_ref": "/workplans/index",
+          "owner_component": "state-hub.api",
+          "status": "legacy",
+          "replacement_verified": true,
+          "manual_hold": false,
+          "hold_reason": null,
+          "notes": null,
+          "retired_at": null,
+          "created_at": "2026-06-04T05:20:58.321869Z",
+          "updated_at": "2026-06-04T05:20:58.321869Z"
+        },
+        "all_time": {
+          "calls": 30,
+          "tenant_count": 1,
+          "user_count": 1,
+          "component_count": 1,
+          "tenants": {
+            "unknown": 30
+          },
+          "users": {
+            "unknown": 30
+          },
+          "components": {
+            "unknown": 30
+          }
+        },
+        "window": {
+          "calls": 0,
+          "tenant_count": 0,
+          "user_count": 0,
+          "component_count": 0,
+          "tenants": {},
+          "users": {},
+          "components": {}
+        },
+        "last_seen_at": "2026-07-03T05:20:34.534439Z",
+        "retirement_candidate": true,
+        "retirement_reason": "no measured usage in review window"
+      },
+      {
+        "interface": {
+          "id": "3a00b19e-e7db-4403-98aa-a77c9ab61ecc",
+          "interface_key": "rest_api:GET /workstreams/{workstream_id}",
+          "interface_kind": "rest_api",
+          "legacy_since": "2026-06-04T00:25:59.014966Z",
+          "replacement_ref": "/workplans/{workplan_id}",
+          "owner_component": "state-hub.api",
+          "status": "legacy",
+          "replacement_verified": true,
+          "manual_hold": false,
+          "hold_reason": null,
+          "notes": null,
+          "retired_at": null,
+          "created_at": "2026-06-04T00:25:59.014966Z",
+          "updated_at": "2026-06-04T00:25:59.014966Z"
+        },
+        "all_time": {
+          "calls": 511406,
+          "tenant_count": 1,
+          "user_count": 1,
+          "component_count": 1,
+          "tenants": {
+            "unknown": 511406
+          },
+          "users": {
+            "unknown": 511406
+          },
+          "components": {
+            "unknown": 511406
+          }
+        },
+        "window": {
+          "calls": 0,
+          "tenant_count": 0,
+          "user_count": 0,
+          "component_count": 0,
+          "tenants": {},
+          "users": {},
+          "components": {}
+        },
+        "last_seen_at": "2026-07-31T16:25:32.004042Z",
+        "retirement_candidate": true,
+        "retirement_reason": "no measured usage in review window"
+      },
+      {
+        "interface": {
+          "id": "69e1a255-a8b9-4101-8a68-b1bed23abfda",
+          "interface_key": "rest_api:GET /workstreams/{workstream_id}/dependencies/",
+          "interface_kind": "rest_api",
+          "legacy_since": "2026-06-04T00:25:59.291135Z",
+          "replacement_ref": "/workplans/{workplan_id}/dependencies/",
+          "owner_component": "state-hub.api",
+          "status": "legacy",
+          "replacement_verified": true,
+          "manual_hold": false,
+          "hold_reason": null,
+          "notes": null,
+          "retired_at": null,
+          "created_at": "2026-06-04T00:25:59.291135Z",
+          "updated_at": "2026-06-04T00:25:59.291135Z"
+        },
+        "all_time": {
+          "calls": 255865,
+          "tenant_count": 1,
+          "user_count": 1,
+          "component_count": 1,
+          "tenants": {
+            "unknown": 255865
+          },
+          "users": {
+            "unknown": 255865
+          },
+          "components": {
+            "unknown": 255865
+          }
+        },
+        "window": {
+          "calls": 0,
+          "tenant_count": 0,
+          "user_count": 0,
+          "component_count": 0,
+          "tenants": {},
+          "users": {},
+          "components": {}
+        },
+        "last_seen_at": "2026-07-08T21:14:12.747005Z",
+        "retirement_candidate": true,
+        "retirement_reason": "no measured usage in review window"
+      },
+      {
+        "interface": {
+          "id": "b1aae931-b51f-4a85-a723-865dd65f6132",
+          "interface_key": "rest_api:PATCH /workstreams/{workstream_id}",
+          "interface_kind": "rest_api",
+          "legacy_since": "2026-06-04T06:09:41.901035Z",
+          "replacement_ref": "/workplans/{workplan_id}",
+          "owner_component": "state-hub.api",
+          "status": "legacy",
+          "replacement_verified": true,
+          "manual_hold": false,
+          "hold_reason": null,
+          "notes": null,
+          "retired_at": null,
+          "created_at": "2026-06-04T06:09:41.901035Z",
+          "updated_at": "2026-06-04T06:09:41.901035Z"
+        },
+        "all_time": {
+          "calls": 571,
+          "tenant_count": 1,
+          "user_count": 1,
+          "component_count": 1,
+          "tenants": {
+            "unknown": 571
+          },
+          "users": {
+            "unknown": 571
+          },
+          "components": {
+            "unknown": 571
+          }
+        },
+        "window": {
+          "calls": 0,
+          "tenant_count": 0,
+          "user_count": 0,
+          "component_count": 0,
+          "tenants": {},
+          "users": {},
+          "components": {}
+        },
+        "last_seen_at": "2026-07-08T20:49:12.335710Z",
+        "retirement_candidate": true,
+        "retirement_reason": "no measured usage in review window"
+      },
+      {
+        "interface": {
+          "id": "4aea9591-970b-4918-ac4a-4da95a0a1a8c",
+          "interface_key": "rest_api:POST /decisions/ workstream_id",
+          "interface_kind": "rest_api",
+          "legacy_since": "2026-07-09T22:56:35.473130Z",
+          "replacement_ref": "POST /decisions/ with workplan_id",
+          "owner_component": "state-hub.api",
+          "status": "legacy",
+          "replacement_verified": true,
+          "manual_hold": false,
+          "hold_reason": null,
+          "notes": null,
+          "retired_at": null,
+          "created_at": "2026-07-09T22:56:35.473130Z",
+          "updated_at": "2026-07-09T22:56:35.473130Z"
+        },
+        "all_time": {
+          "calls": 3,
+          "tenant_count": 1,
+          "user_count": 1,
+          "component_count": 1,
+          "tenants": {
+            "unknown": 3
+          },
+          "users": {
+            "unknown": 3
+          },
+          "components": {
+            "unknown": 3
+          }
+        },
+        "window": {
+          "calls": 0,
+          "tenant_count": 0,
+          "user_count": 0,
+          "component_count": 0,
+          "tenants": {},
+          "users": {},
+          "components": {}
+        },
+        "last_seen_at": "2026-07-09T22:57:05.912456Z",
+        "retirement_candidate": true,
+        "retirement_reason": "no measured usage in review window"
+      },
+      {
+        "interface": {
+          "id": "4a70583c-1e41-4ec1-99a9-728856a7d79c",
+          "interface_key": "rest_api:POST /progress/ workstream_id",
+          "interface_kind": "rest_api",
+          "legacy_since": "2026-07-08T23:35:09.148333Z",
+          "replacement_ref": "POST /progress/ with workplan_id",
+          "owner_component": "state-hub.api",
+          "status": "legacy",
+          "replacement_verified": true,
+          "manual_hold": false,
+          "hold_reason": null,
+          "notes": null,
+          "retired_at": null,
+          "created_at": "2026-07-08T23:35:09.148333Z",
+          "updated_at": "2026-07-08T23:35:09.148333Z"
+        },
+        "all_time": {
+          "calls": 14,
+          "tenant_count": 1,
+          "user_count": 1,
+          "component_count": 1,
+          "tenants": {
+            "unknown": 14
+          },
+          "users": {
+            "unknown": 14
+          },
+          "components": {
+            "unknown": 14
+          }
+        },
+        "window": {
+          "calls": 0,
+          "tenant_count": 0,
+          "user_count": 0,
+          "component_count": 0,
+          "tenants": {},
+          "users": {},
+          "components": {}
+        },
+        "last_seen_at": "2026-07-10T08:34:42.959724Z",
+        "retirement_candidate": true,
+        "retirement_reason": "no measured usage in review window"
+      },
+      {
+        "interface": {
+          "id": "6df4e443-7bf1-461a-923b-a6eb52fe7b07",
+          "interface_key": "rest_api:POST /tasks/ workstream_id",
+          "interface_kind": "rest_api",
+          "legacy_since": "2026-07-08T22:38:29.405720Z",
+          "replacement_ref": "POST /tasks/ with workplan_id",
+          "owner_component": "state-hub.api",
+          "status": "legacy",
+          "replacement_verified": true,
+          "manual_hold": false,
+          "hold_reason": null,
+          "notes": null,
+          "retired_at": null,
+          "created_at": "2026-07-08T22:38:29.405720Z",
+          "updated_at": "2026-07-08T22:38:29.405720Z"
+        },
+        "all_time": {
+          "calls": 5,
+          "tenant_count": 1,
+          "user_count": 1,
+          "component_count": 1,
+          "tenants": {
+            "unknown": 5
+          },
+          "users": {
+            "unknown": 5
+          },
+          "components": {
+            "state-hub.fix-consistency": 5
+          }
+        },
+        "window": {
+          "calls": 0,
+          "tenant_count": 0,
+          "user_count": 0,
+          "component_count": 0,
+          "tenants": {},
+          "users": {},
+          "components": {}
+        },
+        "last_seen_at": "2026-07-08T22:38:29.976918Z",
+        "retirement_candidate": true,
+        "retirement_reason": "no measured usage in review window"
+      },
+      {
+        "interface": {
+          "id": "ed6451c9-d2cc-4486-9afe-d3852782cabc",
+          "interface_key": "rest_api:POST /workstreams/",
+          "interface_kind": "rest_api",
+          "legacy_since": "2026-06-04T07:40:24.168535Z",
+          "replacement_ref": "/workplans/",
+          "owner_component": "state-hub.api",
+          "status": "legacy",
+          "replacement_verified": true,
+          "manual_hold": false,
+          "hold_reason": null,
+          "notes": null,
+          "retired_at": null,
+          "created_at": "2026-06-04T07:40:24.168535Z",
+          "updated_at": "2026-06-04T07:40:24.168535Z"
+        },
+        "all_time": {
+          "calls": 824,
+          "tenant_count": 1,
+          "user_count": 1,
+          "component_count": 1,
+          "tenants": {
+            "unknown": 824
+          },
+          "users": {
+            "unknown": 824
+          },
+          "components": {
+            "unknown": 824
+          }
+        },
+        "window": {
+          "calls": 0,
+          "tenant_count": 0,
+          "user_count": 0,
+          "component_count": 0,
+          "tenants": {},
+          "users": {},
+          "components": {}
+        },
+        "last_seen_at": "2026-07-08T20:38:05.903144Z",
+        "retirement_candidate": true,
+        "retirement_reason": "no measured usage in review window"
+      },
+      {
+        "interface": {
+          "id": "281fd706-b192-4194-8055-2d8733c115f9",
+          "interface_key": "rest_api:POST /workstreams/{workstream_id}/dependencies/",
+          "interface_kind": "rest_api",
+          "legacy_since": "2026-06-04T22:57:37.149207Z",
+          "replacement_ref": "/workplans/{workplan_id}/dependencies/",
+          "owner_component": "state-hub.api",
+          "status": "legacy",
+          "replacement_verified": true,
+          "manual_hold": false,
+          "hold_reason": null,
+          "notes": null,
+          "retired_at": null,
+          "created_at": "2026-06-04T22:57:37.149207Z",
+          "updated_at": "2026-06-04T22:57:37.149207Z"
+        },
+        "all_time": {
+          "calls": 4971,
+          "tenant_count": 1,
+          "user_count": 1,
+          "component_count": 1,
+          "tenants": {
+            "unknown": 4971
+          },
+          "users": {
+            "unknown": 4971
+          },
+          "components": {
+            "unknown": 4971
+          }
+        },
+        "window": {
+          "calls": 0,
+          "tenant_count": 0,
+          "user_count": 0,
+          "component_count": 0,
+          "tenants": {},
+          "users": {},
+          "components": {}
+        },
+        "last_seen_at": "2026-07-01T22:09:24.229011Z",
+        "retirement_candidate": true,
+        "retirement_reason": "no measured usage in review window"
+      }
+    ]
+  },
+  "hours": 8
+}
diff --git a/docs/evidence/legacy-meter-weekly-review-20260803.json b/docs/evidence/legacy-meter-weekly-review-20260803.json
new file mode 100644
index 0000000..1cd5f87
--- /dev/null
+++ b/docs/evidence/legacy-meter-weekly-review-20260803.json
@@ -0,0 +1,1755 @@
+{
+  "captured_at": "2026-08-02T22:00:05.098934+00:00",
+  "api_base": "http://127.0.0.1:8000",
+  "workplan": "STATE-WP-0070",
+  "retired_interfaces": [],
+  "weekly_review": {
+    "generated_at": "2026-08-02T22:00:05.092643Z",
+    "window_start": "2026-08-02T14:00:04.986312Z",
+    "window_end": "2026-08-02T22:00:04.986312Z",
+    "cadence": "weekly",
+    "activity_core_handoff": {
+      "activity_id": "statehub-legacy-interface-review",
+      "cadence": "weekly",
+      "source_endpoint": "/legacy-meter/weekly-review",
+      "state_owner": "state-hub",
+      "scheduler_owner": "activity-core"
+    },
+    "interfaces": [
+      {
+        "interface": {
+          "id": "8051fb40-66c9-4dc4-a413-13e8573e04a3",
+          "interface_key": "event_subject:org.statehub.workstream.completed",
+          "interface_kind": "event_subject",
+          "legacy_since": "2026-06-04T06:09:42.198193Z",
+          "replacement_ref": "org.statehub.workplan.completed",
+          "owner_component": "state-hub.events",
+          "status": "retired",
+          "replacement_verified": true,
+          "manual_hold": false,
+          "hold_reason": null,
+          "notes": "Retired by STATE-WP-0069 closeout",
+          "retired_at": "2026-07-08T21:38:52.773601Z",
+          "created_at": "2026-06-04T06:09:42.198193Z",
+          "updated_at": "2026-07-08T21:38:52.761243Z"
+        },
+        "all_time": {
+          "calls": 255,
+          "tenant_count": 1,
+          "user_count": 1,
+          "component_count": 1,
+          "tenants": {
+            "unknown": 255
+          },
+          "users": {
+            "unknown": 255
+          },
+          "components": {
+            "state-hub.events": 255
+          }
+        },
+        "window": {
+          "calls": 0,
+          "tenant_count": 0,
+          "user_count": 0,
+          "component_count": 0,
+          "tenants": {},
+          "users": {},
+          "components": {}
+        },
+        "last_seen_at": "2026-07-08T20:49:12.839383Z",
+        "retirement_candidate": false,
+        "retirement_reason": "already retired"
+      },
+      {
+        "interface": {
+          "id": "63ed90e3-42b4-431a-94db-e1254a52f9e2",
+          "interface_key": "mcp:create_workstream",
+          "interface_kind": "mcp_tool",
+          "legacy_since": "2026-07-10T13:19:44.205900Z",
+          "replacement_ref": "create_workplan",
+          "owner_component": "state-hub.mcp",
+          "status": "legacy",
+          "replacement_verified": true,
+          "manual_hold": false,
+          "hold_reason": null,
+          "notes": "Registered by STATE-WP-0070 T03 \u2014 zero-window streak starts at registration",
+          "retired_at": null,
+          "created_at": "2026-07-10T13:19:44.205900Z",
+          "updated_at": "2026-07-10T13:19:44.205900Z"
+        },
+        "all_time": {
+          "calls": 2,
+          "tenant_count": 1,
+          "user_count": 1,
+          "component_count": 1,
+          "tenants": {
+            "unknown": 2
+          },
+          "users": {
+            "unknown": 2
+          },
+          "components": {
+            "state-hub.mcp": 2
+          }
+        },
+        "window": {
+          "calls": 0,
+          "tenant_count": 0,
+          "user_count": 0,
+          "component_count": 0,
+          "tenants": {},
+          "users": {},
+          "components": {}
+        },
+        "last_seen_at": "2026-07-10T13:20:43.378546Z",
+        "retirement_candidate": true,
+        "retirement_reason": "no measured usage in review window"
+      },
+      {
+        "interface": {
+          "id": "b6a5fe44-fb85-4ef7-a273-78d09da777af",
+          "interface_key": "mcp:list_workstreams",
+          "interface_kind": "mcp_tool",
+          "legacy_since": "2026-07-10T13:19:26.075491Z",
+          "replacement_ref": "list_workplans",
+          "owner_component": "state-hub.mcp",
+          "status": "legacy",
+          "replacement_verified": true,
+          "manual_hold": false,
+          "hold_reason": null,
+          "notes": null,
+          "retired_at": null,
+          "created_at": "2026-07-10T13:19:26.075491Z",
+          "updated_at": "2026-07-10T13:19:26.075491Z"
+        },
+        "all_time": {
+          "calls": 2,
+          "tenant_count": 1,
+          "user_count": 1,
+          "component_count": 1,
+          "tenants": {
+            "unknown": 2
+          },
+          "users": {
+            "unknown": 2
+          },
+          "components": {
+            "state-hub.mcp": 2
+          }
+        },
+        "window": {
+          "calls": 0,
+          "tenant_count": 0,
+          "user_count": 0,
+          "component_count": 0,
+          "tenants": {},
+          "users": {},
+          "components": {}
+        },
+        "last_seen_at": "2026-07-10T13:20:42.374940Z",
+        "retirement_candidate": true,
+        "retirement_reason": "no measured usage in review window"
+      },
+      {
+        "interface": {
+          "id": "53c3372b-307d-4d6a-8ea4-bc36cacdcaf2",
+          "interface_key": "mcp:update_workstream",
+          "interface_kind": "mcp_tool",
+          "legacy_since": "2026-07-10T13:19:44.255216Z",
+          "replacement_ref": "update_workplan",
+          "owner_component": "state-hub.mcp",
+          "status": "legacy",
+          "replacement_verified": true,
+          "manual_hold": false,
+          "hold_reason": null,
+          "notes": "Registered by STATE-WP-0070 T03 \u2014 zero-window streak starts at registration",
+          "retired_at": null,
+          "created_at": "2026-07-10T13:19:44.255216Z",
+          "updated_at": "2026-07-10T13:19:44.255216Z"
+        },
+        "all_time": {
+          "calls": 0,
+          "tenant_count": 0,
+          "user_count": 0,
+          "component_count": 0,
+          "tenants": {},
+          "users": {},
+          "components": {}
+        },
+        "window": {
+          "calls": 0,
+          "tenant_count": 0,
+          "user_count": 0,
+          "component_count": 0,
+          "tenants": {},
+          "users": {},
+          "components": {}
+        },
+        "last_seen_at": null,
+        "retirement_candidate": true,
+        "retirement_reason": "no measured usage in review window"
+      },
+      {
+        "interface": {
+          "id": "bed4d08a-3471-48f5-9f0e-f9d550383a26",
+          "interface_key": "mcp:update_workstream_status",
+          "interface_kind": "mcp_tool",
+          "legacy_since": "2026-07-10T13:19:44.303612Z",
+          "replacement_ref": "update_workplan_status",
+          "owner_component": "state-hub.mcp",
+          "status": "legacy",
+          "replacement_verified": true,
+          "manual_hold": false,
+          "hold_reason": null,
+          "notes": "Registered by STATE-WP-0070 T03 \u2014 zero-window streak starts at registration",
+          "retired_at": null,
+          "created_at": "2026-07-10T13:19:44.303612Z",
+          "updated_at": "2026-07-10T13:19:44.303612Z"
+        },
+        "all_time": {
+          "calls": 0,
+          "tenant_count": 0,
+          "user_count": 0,
+          "component_count": 0,
+          "tenants": {},
+          "users": {},
+          "components": {}
+        },
+        "window": {
+          "calls": 0,
+          "tenant_count": 0,
+          "user_count": 0,
+          "component_count": 0,
+          "tenants": {},
+          "users": {},
+          "components": {}
+        },
+        "last_seen_at": null,
+        "retirement_candidate": true,
+        "retirement_reason": "no measured usage in review window"
+      },
+      {
+        "interface": {
+          "id": "46900dc2-0893-405b-ba59-80f31fb6ebb1",
+          "interface_key": "state://workstreams/{topic_slug}",
+          "interface_kind": "mcp_tool",
+          "legacy_since": "2026-07-10T13:19:44.344493Z",
+          "replacement_ref": "state://workplans/{topic_slug}",
+          "owner_component": "state-hub.mcp",
+          "status": "legacy",
+          "replacement_verified": true,
+          "manual_hold": false,
+          "hold_reason": null,
+          "notes": "Registered by STATE-WP-0070 T03 \u2014 zero-window streak starts at registration",
+          "retired_at": null,
+          "created_at": "2026-07-10T13:19:44.344493Z",
+          "updated_at": "2026-07-10T13:19:44.344493Z"
+        },
+        "all_time": {
+          "calls": 1,
+          "tenant_count": 1,
+          "user_count": 1,
+          "component_count": 1,
+          "tenants": {
+            "unknown": 1
+          },
+          "users": {
+            "unknown": 1
+          },
+          "components": {
+            "state-hub.mcp": 1
+          }
+        },
+        "window": {
+          "calls": 0,
+          "tenant_count": 0,
+          "user_count": 0,
+          "component_count": 0,
+          "tenants": {},
+          "users": {},
+          "components": {}
+        },
+        "last_seen_at": "2026-07-10T13:20:34.491811Z",
+        "retirement_candidate": true,
+        "retirement_reason": "no measured usage in review window"
+      },
+      {
+        "interface": {
+          "id": "cd9342fd-27e7-4a46-a1be-d41499e106a3",
+          "interface_key": "rest_api:DELETE /workstreams/{workstream_id}",
+          "interface_kind": "rest_api",
+          "legacy_since": "2026-06-06T17:28:13.052813Z",
+          "replacement_ref": "/workplans/{workplan_id}",
+          "owner_component": "state-hub.api",
+          "status": "legacy",
+          "replacement_verified": true,
+          "manual_hold": false,
+          "hold_reason": null,
+          "notes": null,
+          "retired_at": null,
+          "created_at": "2026-06-06T17:28:13.052813Z",
+          "updated_at": "2026-06-06T17:28:13.052813Z"
+        },
+        "all_time": {
+          "calls": 1,
+          "tenant_count": 1,
+          "user_count": 1,
+          "component_count": 1,
+          "tenants": {
+            "unknown": 1
+          },
+          "users": {
+            "unknown": 1
+          },
+          "components": {
+            "unknown": 1
+          }
+        },
+        "window": {
+          "calls": 0,
+          "tenant_count": 0,
+          "user_count": 0,
+          "component_count": 0,
+          "tenants": {},
+          "users": {},
+          "components": {}
+        },
+        "last_seen_at": "2026-06-06T17:28:13.047529Z",
+        "retirement_candidate": true,
+        "retirement_reason": "no measured usage in review window"
+      },
+      {
+        "interface": {
+          "id": "a4e0948c-cd4a-461e-8ae2-7fd7b51d04a7",
+          "interface_key": "rest_api:GET /decisions/?workstream_id",
+          "interface_kind": "rest_api",
+          "legacy_since": "2026-07-09T23:07:53.093223Z",
+          "replacement_ref": "/decisions/?workplan_id=<workplan_id>",
+          "owner_component": "state-hub.api",
+          "status": "legacy",
+          "replacement_verified": true,
+          "manual_hold": false,
+          "hold_reason": null,
+          "notes": null,
+          "retired_at": null,
+          "created_at": "2026-07-09T23:07:53.093223Z",
+          "updated_at": "2026-07-09T23:07:53.093223Z"
+        },
+        "all_time": {
+          "calls": 1,
+          "tenant_count": 1,
+          "user_count": 1,
+          "component_count": 1,
+          "tenants": {
+            "unknown": 1
+          },
+          "users": {
+            "unknown": 1
+          },
+          "components": {
+            "unknown": 1
+          }
+        },
+        "window": {
+          "calls": 0,
+          "tenant_count": 0,
+          "user_count": 0,
+          "component_count": 0,
+          "tenants": {},
+          "users": {},
+          "components": {}
+        },
+        "last_seen_at": "2026-07-09T23:07:53.083299Z",
+        "retirement_candidate": true,
+        "retirement_reason": "no measured usage in review window"
+      },
+      {
+        "interface": {
+          "id": "70a9346e-e0ee-42ac-874f-f160580b54dd",
+          "interface_key": "rest_api:GET /progress/?workstream_id",
+          "interface_kind": "rest_api",
+          "legacy_since": "2026-07-13T22:04:03.911449Z",
+          "replacement_ref": "/progress/?workplan_id=<workplan_id>",
+          "owner_component": "state-hub.api",
+          "status": "legacy",
+          "replacement_verified": true,
+          "manual_hold": false,
+          "hold_reason": null,
+          "notes": null,
+          "retired_at": null,
+          "created_at": "2026-07-13T22:04:03.911449Z",
+          "updated_at": "2026-07-13T22:04:03.911449Z"
+        },
+        "all_time": {
+          "calls": 1,
+          "tenant_count": 1,
+          "user_count": 1,
+          "component_count": 1,
+          "tenants": {
+            "unknown": 1
+          },
+          "users": {
+            "unknown": 1
+          },
+          "components": {
+            "unknown": 1
+          }
+        },
+        "window": {
+          "calls": 0,
+          "tenant_count": 0,
+          "user_count": 0,
+          "component_count": 0,
+          "tenants": {},
+          "users": {},
+          "components": {}
+        },
+        "last_seen_at": "2026-07-13T22:04:03.904998Z",
+        "retirement_candidate": true,
+        "retirement_reason": "no measured usage in review window"
+      },
+      {
+        "interface": {
+          "id": "be3cdcf8-250b-4bf0-801f-02ffd5f57e00",
+          "interface_key": "rest_api:GET /tasks/?workstream_id",
+          "interface_kind": "rest_api",
+          "legacy_since": "2026-07-08T19:32:21.628513Z",
+          "replacement_ref": "/tasks/?workplan_id=<workplan_id>",
+          "owner_component": "state-hub.api",
+          "status": "legacy",
+          "replacement_verified": true,
+          "manual_hold": false,
+          "hold_reason": null,
+          "notes": null,
+          "retired_at": null,
+          "created_at": "2026-07-08T19:32:21.628513Z",
+          "updated_at": "2026-07-08T19:32:21.628513Z"
+        },
+        "all_time": {
+          "calls": 589,
+          "tenant_count": 1,
+          "user_count": 1,
+          "component_count": 1,
+          "tenants": {
+            "unknown": 589
+          },
+          "users": {
+            "unknown": 589
+          },
+          "components": {
+            "unknown": 589
+          }
+        },
+        "window": {
+          "calls": 0,
+          "tenant_count": 0,
+          "user_count": 0,
+          "component_count": 0,
+          "tenants": {},
+          "users": {},
+          "components": {}
+        },
+        "last_seen_at": "2026-07-31T16:25:32.181901Z",
+        "retirement_candidate": true,
+        "retirement_reason": "no measured usage in review window"
+      },
+      {
+        "interface": {
+          "id": "3e4a3d0b-08fa-45c3-91e2-4f514a914b97",
+          "interface_key": "rest_api:GET /workstreams/",
+          "interface_kind": "rest_api",
+          "legacy_since": "2026-06-04T00:26:14.533764Z",
+          "replacement_ref": "/workplans/",
+          "owner_component": "state-hub.api",
+          "status": "legacy",
+          "replacement_verified": true,
+          "manual_hold": false,
+          "hold_reason": null,
+          "notes": null,
+          "retired_at": null,
+          "created_at": "2026-06-04T00:26:14.533764Z",
+          "updated_at": "2026-06-04T00:26:14.533764Z"
+        },
+        "all_time": {
+          "calls": 144084,
+          "tenant_count": 1,
+          "user_count": 1,
+          "component_count": 1,
+          "tenants": {
+            "unknown": 144084
+          },
+          "users": {
+            "unknown": 144084
+          },
+          "components": {
+            "unknown": 144084
+          }
+        },
+        "window": {
+          "calls": 0,
+          "tenant_count": 0,
+          "user_count": 0,
+          "component_count": 0,
+          "tenants": {},
+          "users": {},
+          "components": {}
+        },
+        "last_seen_at": "2026-07-08T21:14:39.652776Z",
+        "retirement_candidate": true,
+        "retirement_reason": "no measured usage in review window"
+      },
+      {
+        "interface": {
+          "id": "e4c140ec-7479-46f9-b185-4b533f19d639",
+          "interface_key": "rest_api:GET /workstreams/workplan-index",
+          "interface_kind": "rest_api",
+          "legacy_since": "2026-06-04T05:20:58.321869Z",
+          "replacement_ref": "/workplans/index",
+          "owner_component": "state-hub.api",
+          "status": "legacy",
+          "replacement_verified": true,
+          "manual_hold": false,
+          "hold_reason": null,
+          "notes": null,
+          "retired_at": null,
+          "created_at": "2026-06-04T05:20:58.321869Z",
+          "updated_at": "2026-06-04T05:20:58.321869Z"
+        },
+        "all_time": {
+          "calls": 30,
+          "tenant_count": 1,
+          "user_count": 1,
+          "component_count": 1,
+          "tenants": {
+            "unknown": 30
+          },
+          "users": {
+            "unknown": 30
+          },
+          "components": {
+            "unknown": 30
+          }
+        },
+        "window": {
+          "calls": 0,
+          "tenant_count": 0,
+          "user_count": 0,
+          "component_count": 0,
+          "tenants": {},
+          "users": {},
+          "components": {}
+        },
+        "last_seen_at": "2026-07-03T05:20:34.534439Z",
+        "retirement_candidate": true,
+        "retirement_reason": "no measured usage in review window"
+      },
+      {
+        "interface": {
+          "id": "3a00b19e-e7db-4403-98aa-a77c9ab61ecc",
+          "interface_key": "rest_api:GET /workstreams/{workstream_id}",
+          "interface_kind": "rest_api",
+          "legacy_since": "2026-06-04T00:25:59.014966Z",
+          "replacement_ref": "/workplans/{workplan_id}",
+          "owner_component": "state-hub.api",
+          "status": "legacy",
+          "replacement_verified": true,
+          "manual_hold": false,
+          "hold_reason": null,
+          "notes": null,
+          "retired_at": null,
+          "created_at": "2026-06-04T00:25:59.014966Z",
+          "updated_at": "2026-06-04T00:25:59.014966Z"
+        },
+        "all_time": {
+          "calls": 511406,
+          "tenant_count": 1,
+          "user_count": 1,
+          "component_count": 1,
+          "tenants": {
+            "unknown": 511406
+          },
+          "users": {
+            "unknown": 511406
+          },
+          "components": {
+            "unknown": 511406
+          }
+        },
+        "window": {
+          "calls": 0,
+          "tenant_count": 0,
+          "user_count": 0,
+          "component_count": 0,
+          "tenants": {},
+          "users": {},
+          "components": {}
+        },
+        "last_seen_at": "2026-07-31T16:25:32.004042Z",
+        "retirement_candidate": true,
+        "retirement_reason": "no measured usage in review window"
+      },
+      {
+        "interface": {
+          "id": "69e1a255-a8b9-4101-8a68-b1bed23abfda",
+          "interface_key": "rest_api:GET /workstreams/{workstream_id}/dependencies/",
+          "interface_kind": "rest_api",
+          "legacy_since": "2026-06-04T00:25:59.291135Z",
+          "replacement_ref": "/workplans/{workplan_id}/dependencies/",
+          "owner_component": "state-hub.api",
+          "status": "legacy",
+          "replacement_verified": true,
+          "manual_hold": false,
+          "hold_reason": null,
+          "notes": null,
+          "retired_at": null,
+          "created_at": "2026-06-04T00:25:59.291135Z",
+          "updated_at": "2026-06-04T00:25:59.291135Z"
+        },
+        "all_time": {
+          "calls": 255865,
+          "tenant_count": 1,
+          "user_count": 1,
+          "component_count": 1,
+          "tenants": {
+            "unknown": 255865
+          },
+          "users": {
+            "unknown": 255865
+          },
+          "components": {
+            "unknown": 255865
+          }
+        },
+        "window": {
+          "calls": 0,
+          "tenant_count": 0,
+          "user_count": 0,
+          "component_count": 0,
+          "tenants": {},
+          "users": {},
+          "components": {}
+        },
+        "last_seen_at": "2026-07-08T21:14:12.747005Z",
+        "retirement_candidate": true,
+        "retirement_reason": "no measured usage in review window"
+      },
+      {
+        "interface": {
+          "id": "b1aae931-b51f-4a85-a723-865dd65f6132",
+          "interface_key": "rest_api:PATCH /workstreams/{workstream_id}",
+          "interface_kind": "rest_api",
+          "legacy_since": "2026-06-04T06:09:41.901035Z",
+          "replacement_ref": "/workplans/{workplan_id}",
+          "owner_component": "state-hub.api",
+          "status": "legacy",
+          "replacement_verified": true,
+          "manual_hold": false,
+          "hold_reason": null,
+          "notes": null,
+          "retired_at": null,
+          "created_at": "2026-06-04T06:09:41.901035Z",
+          "updated_at": "2026-06-04T06:09:41.901035Z"
+        },
+        "all_time": {
+          "calls": 571,
+          "tenant_count": 1,
+          "user_count": 1,
+          "component_count": 1,
+          "tenants": {
+            "unknown": 571
+          },
+          "users": {
+            "unknown": 571
+          },
+          "components": {
+            "unknown": 571
+          }
+        },
+        "window": {
+          "calls": 0,
+          "tenant_count": 0,
+          "user_count": 0,
+          "component_count": 0,
+          "tenants": {},
+          "users": {},
+          "components": {}
+        },
+        "last_seen_at": "2026-07-08T20:49:12.335710Z",
+        "retirement_candidate": true,
+        "retirement_reason": "no measured usage in review window"
+      },
+      {
+        "interface": {
+          "id": "4aea9591-970b-4918-ac4a-4da95a0a1a8c",
+          "interface_key": "rest_api:POST /decisions/ workstream_id",
+          "interface_kind": "rest_api",
+          "legacy_since": "2026-07-09T22:56:35.473130Z",
+          "replacement_ref": "POST /decisions/ with workplan_id",
+          "owner_component": "state-hub.api",
+          "status": "legacy",
+          "replacement_verified": true,
+          "manual_hold": false,
+          "hold_reason": null,
+          "notes": null,
+          "retired_at": null,
+          "created_at": "2026-07-09T22:56:35.473130Z",
+          "updated_at": "2026-07-09T22:56:35.473130Z"
+        },
+        "all_time": {
+          "calls": 3,
+          "tenant_count": 1,
+          "user_count": 1,
+          "component_count": 1,
+          "tenants": {
+            "unknown": 3
+          },
+          "users": {
+            "unknown": 3
+          },
+          "components": {
+            "unknown": 3
+          }
+        },
+        "window": {
+          "calls": 0,
+          "tenant_count": 0,
+          "user_count": 0,
+          "component_count": 0,
+          "tenants": {},
+          "users": {},
+          "components": {}
+        },
+        "last_seen_at": "2026-07-09T22:57:05.912456Z",
+        "retirement_candidate": true,
+        "retirement_reason": "no measured usage in review window"
+      },
+      {
+        "interface": {
+          "id": "4a70583c-1e41-4ec1-99a9-728856a7d79c",
+          "interface_key": "rest_api:POST /progress/ workstream_id",
+          "interface_kind": "rest_api",
+          "legacy_since": "2026-07-08T23:35:09.148333Z",
+          "replacement_ref": "POST /progress/ with workplan_id",
+          "owner_component": "state-hub.api",
+          "status": "legacy",
+          "replacement_verified": true,
+          "manual_hold": false,
+          "hold_reason": null,
+          "notes": null,
+          "retired_at": null,
+          "created_at": "2026-07-08T23:35:09.148333Z",
+          "updated_at": "2026-07-08T23:35:09.148333Z"
+        },
+        "all_time": {
+          "calls": 14,
+          "tenant_count": 1,
+          "user_count": 1,
+          "component_count": 1,
+          "tenants": {
+            "unknown": 14
+          },
+          "users": {
+            "unknown": 14
+          },
+          "components": {
+            "unknown": 14
+          }
+        },
+        "window": {
+          "calls": 0,
+          "tenant_count": 0,
+          "user_count": 0,
+          "component_count": 0,
+          "tenants": {},
+          "users": {},
+          "components": {}
+        },
+        "last_seen_at": "2026-07-10T08:34:42.959724Z",
+        "retirement_candidate": true,
+        "retirement_reason": "no measured usage in review window"
+      },
+      {
+        "interface": {
+          "id": "6df4e443-7bf1-461a-923b-a6eb52fe7b07",
+          "interface_key": "rest_api:POST /tasks/ workstream_id",
+          "interface_kind": "rest_api",
+          "legacy_since": "2026-07-08T22:38:29.405720Z",
+          "replacement_ref": "POST /tasks/ with workplan_id",
+          "owner_component": "state-hub.api",
+          "status": "legacy",
+          "replacement_verified": true,
+          "manual_hold": false,
+          "hold_reason": null,
+          "notes": null,
+          "retired_at": null,
+          "created_at": "2026-07-08T22:38:29.405720Z",
+          "updated_at": "2026-07-08T22:38:29.405720Z"
+        },
+        "all_time": {
+          "calls": 5,
+          "tenant_count": 1,
+          "user_count": 1,
+          "component_count": 1,
+          "tenants": {
+            "unknown": 5
+          },
+          "users": {
+            "unknown": 5
+          },
+          "components": {
+            "state-hub.fix-consistency": 5
+          }
+        },
+        "window": {
+          "calls": 0,
+          "tenant_count": 0,
+          "user_count": 0,
+          "component_count": 0,
+          "tenants": {},
+          "users": {},
+          "components": {}
+        },
+        "last_seen_at": "2026-07-08T22:38:29.976918Z",
+        "retirement_candidate": true,
+        "retirement_reason": "no measured usage in review window"
+      },
+      {
+        "interface": {
+          "id": "ed6451c9-d2cc-4486-9afe-d3852782cabc",
+          "interface_key": "rest_api:POST /workstreams/",
+          "interface_kind": "rest_api",
+          "legacy_since": "2026-06-04T07:40:24.168535Z",
+          "replacement_ref": "/workplans/",
+          "owner_component": "state-hub.api",
+          "status": "legacy",
+          "replacement_verified": true,
+          "manual_hold": false,
+          "hold_reason": null,
+          "notes": null,
+          "retired_at": null,
+          "created_at": "2026-06-04T07:40:24.168535Z",
+          "updated_at": "2026-06-04T07:40:24.168535Z"
+        },
+        "all_time": {
+          "calls": 824,
+          "tenant_count": 1,
+          "user_count": 1,
+          "component_count": 1,
+          "tenants": {
+            "unknown": 824
+          },
+          "users": {
+            "unknown": 824
+          },
+          "components": {
+            "unknown": 824
+          }
+        },
+        "window": {
+          "calls": 0,
+          "tenant_count": 0,
+          "user_count": 0,
+          "component_count": 0,
+          "tenants": {},
+          "users": {},
+          "components": {}
+        },
+        "last_seen_at": "2026-07-08T20:38:05.903144Z",
+        "retirement_candidate": true,
+        "retirement_reason": "no measured usage in review window"
+      },
+      {
+        "interface": {
+          "id": "281fd706-b192-4194-8055-2d8733c115f9",
+          "interface_key": "rest_api:POST /workstreams/{workstream_id}/dependencies/",
+          "interface_kind": "rest_api",
+          "legacy_since": "2026-06-04T22:57:37.149207Z",
+          "replacement_ref": "/workplans/{workplan_id}/dependencies/",
+          "owner_component": "state-hub.api",
+          "status": "legacy",
+          "replacement_verified": true,
+          "manual_hold": false,
+          "hold_reason": null,
+          "notes": null,
+          "retired_at": null,
+          "created_at": "2026-06-04T22:57:37.149207Z",
+          "updated_at": "2026-06-04T22:57:37.149207Z"
+        },
+        "all_time": {
+          "calls": 4971,
+          "tenant_count": 1,
+          "user_count": 1,
+          "component_count": 1,
+          "tenants": {
+            "unknown": 4971
+          },
+          "users": {
+            "unknown": 4971
+          },
+          "components": {
+            "unknown": 4971
+          }
+        },
+        "window": {
+          "calls": 0,
+          "tenant_count": 0,
+          "user_count": 0,
+          "component_count": 0,
+          "tenants": {},
+          "users": {},
+          "components": {}
+        },
+        "last_seen_at": "2026-07-01T22:09:24.229011Z",
+        "retirement_candidate": true,
+        "retirement_reason": "no measured usage in review window"
+      }
+    ],
+    "retirement_candidates": [
+      {
+        "interface": {
+          "id": "63ed90e3-42b4-431a-94db-e1254a52f9e2",
+          "interface_key": "mcp:create_workstream",
+          "interface_kind": "mcp_tool",
+          "legacy_since": "2026-07-10T13:19:44.205900Z",
+          "replacement_ref": "create_workplan",
+          "owner_component": "state-hub.mcp",
+          "status": "legacy",
+          "replacement_verified": true,
+          "manual_hold": false,
+          "hold_reason": null,
+          "notes": "Registered by STATE-WP-0070 T03 \u2014 zero-window streak starts at registration",
+          "retired_at": null,
+          "created_at": "2026-07-10T13:19:44.205900Z",
+          "updated_at": "2026-07-10T13:19:44.205900Z"
+        },
+        "all_time": {
+          "calls": 2,
+          "tenant_count": 1,
+          "user_count": 1,
+          "component_count": 1,
+          "tenants": {
+            "unknown": 2
+          },
+          "users": {
+            "unknown": 2
+          },
+          "components": {
+            "state-hub.mcp": 2
+          }
+        },
+        "window": {
+          "calls": 0,
+          "tenant_count": 0,
+          "user_count": 0,
+          "component_count": 0,
+          "tenants": {},
+          "users": {},
+          "components": {}
+        },
+        "last_seen_at": "2026-07-10T13:20:43.378546Z",
+        "retirement_candidate": true,
+        "retirement_reason": "no measured usage in review window"
+      },
+      {
+        "interface": {
+          "id": "b6a5fe44-fb85-4ef7-a273-78d09da777af",
+          "interface_key": "mcp:list_workstreams",
+          "interface_kind": "mcp_tool",
+          "legacy_since": "2026-07-10T13:19:26.075491Z",
+          "replacement_ref": "list_workplans",
+          "owner_component": "state-hub.mcp",
+          "status": "legacy",
+          "replacement_verified": true,
+          "manual_hold": false,
+          "hold_reason": null,
+          "notes": null,
+          "retired_at": null,
+          "created_at": "2026-07-10T13:19:26.075491Z",
+          "updated_at": "2026-07-10T13:19:26.075491Z"
+        },
+        "all_time": {
+          "calls": 2,
+          "tenant_count": 1,
+          "user_count": 1,
+          "component_count": 1,
+          "tenants": {
+            "unknown": 2
+          },
+          "users": {
+            "unknown": 2
+          },
+          "components": {
+            "state-hub.mcp": 2
+          }
+        },
+        "window": {
+          "calls": 0,
+          "tenant_count": 0,
+          "user_count": 0,
+          "component_count": 0,
+          "tenants": {},
+          "users": {},
+          "components": {}
+        },
+        "last_seen_at": "2026-07-10T13:20:42.374940Z",
+        "retirement_candidate": true,
+        "retirement_reason": "no measured usage in review window"
+      },
+      {
+        "interface": {
+          "id": "53c3372b-307d-4d6a-8ea4-bc36cacdcaf2",
+          "interface_key": "mcp:update_workstream",
+          "interface_kind": "mcp_tool",
+          "legacy_since": "2026-07-10T13:19:44.255216Z",
+          "replacement_ref": "update_workplan",
+          "owner_component": "state-hub.mcp",
+          "status": "legacy",
+          "replacement_verified": true,
+          "manual_hold": false,
+          "hold_reason": null,
+          "notes": "Registered by STATE-WP-0070 T03 \u2014 zero-window streak starts at registration",
+          "retired_at": null,
+          "created_at": "2026-07-10T13:19:44.255216Z",
+          "updated_at": "2026-07-10T13:19:44.255216Z"
+        },
+        "all_time": {
+          "calls": 0,
+          "tenant_count": 0,
+          "user_count": 0,
+          "component_count": 0,
+          "tenants": {},
+          "users": {},
+          "components": {}
+        },
+        "window": {
+          "calls": 0,
+          "tenant_count": 0,
+          "user_count": 0,
+          "component_count": 0,
+          "tenants": {},
+          "users": {},
+          "components": {}
+        },
+        "last_seen_at": null,
+        "retirement_candidate": true,
+        "retirement_reason": "no measured usage in review window"
+      },
+      {
+        "interface": {
+          "id": "bed4d08a-3471-48f5-9f0e-f9d550383a26",
+          "interface_key": "mcp:update_workstream_status",
+          "interface_kind": "mcp_tool",
+          "legacy_since": "2026-07-10T13:19:44.303612Z",
+          "replacement_ref": "update_workplan_status",
+          "owner_component": "state-hub.mcp",
+          "status": "legacy",
+          "replacement_verified": true,
+          "manual_hold": false,
+          "hold_reason": null,
+          "notes": "Registered by STATE-WP-0070 T03 \u2014 zero-window streak starts at registration",
+          "retired_at": null,
+          "created_at": "2026-07-10T13:19:44.303612Z",
+          "updated_at": "2026-07-10T13:19:44.303612Z"
+        },
+        "all_time": {
+          "calls": 0,
+          "tenant_count": 0,
+          "user_count": 0,
+          "component_count": 0,
+          "tenants": {},
+          "users": {},
+          "components": {}
+        },
+        "window": {
+          "calls": 0,
+          "tenant_count": 0,
+          "user_count": 0,
+          "component_count": 0,
+          "tenants": {},
+          "users": {},
+          "components": {}
+        },
+        "last_seen_at": null,
+        "retirement_candidate": true,
+        "retirement_reason": "no measured usage in review window"
+      },
+      {
+        "interface": {
+          "id": "46900dc2-0893-405b-ba59-80f31fb6ebb1",
+          "interface_key": "state://workstreams/{topic_slug}",
+          "interface_kind": "mcp_tool",
+          "legacy_since": "2026-07-10T13:19:44.344493Z",
+          "replacement_ref": "state://workplans/{topic_slug}",
+          "owner_component": "state-hub.mcp",
+          "status": "legacy",
+          "replacement_verified": true,
+          "manual_hold": false,
+          "hold_reason": null,
+          "notes": "Registered by STATE-WP-0070 T03 \u2014 zero-window streak starts at registration",
+          "retired_at": null,
+          "created_at": "2026-07-10T13:19:44.344493Z",
+          "updated_at": "2026-07-10T13:19:44.344493Z"
+        },
+        "all_time": {
+          "calls": 1,
+          "tenant_count": 1,
+          "user_count": 1,
+          "component_count": 1,
+          "tenants": {
+            "unknown": 1
+          },
+          "users": {
+            "unknown": 1
+          },
+          "components": {
+            "state-hub.mcp": 1
+          }
+        },
+        "window": {
+          "calls": 0,
+          "tenant_count": 0,
+          "user_count": 0,
+          "component_count": 0,
+          "tenants": {},
+          "users": {},
+          "components": {}
+        },
+        "last_seen_at": "2026-07-10T13:20:34.491811Z",
+        "retirement_candidate": true,
+        "retirement_reason": "no measured usage in review window"
+      },
+      {
+        "interface": {
+          "id": "cd9342fd-27e7-4a46-a1be-d41499e106a3",
+          "interface_key": "rest_api:DELETE /workstreams/{workstream_id}",
+          "interface_kind": "rest_api",
+          "legacy_since": "2026-06-06T17:28:13.052813Z",
+          "replacement_ref": "/workplans/{workplan_id}",
+          "owner_component": "state-hub.api",
+          "status": "legacy",
+          "replacement_verified": true,
+          "manual_hold": false,
+          "hold_reason": null,
+          "notes": null,
+          "retired_at": null,
+          "created_at": "2026-06-06T17:28:13.052813Z",
+          "updated_at": "2026-06-06T17:28:13.052813Z"
+        },
+        "all_time": {
+          "calls": 1,
+          "tenant_count": 1,
+          "user_count": 1,
+          "component_count": 1,
+          "tenants": {
+            "unknown": 1
+          },
+          "users": {
+            "unknown": 1
+          },
+          "components": {
+            "unknown": 1
+          }
+        },
+        "window": {
+          "calls": 0,
+          "tenant_count": 0,
+          "user_count": 0,
+          "component_count": 0,
+          "tenants": {},
+          "users": {},
+          "components": {}
+        },
+        "last_seen_at": "2026-06-06T17:28:13.047529Z",
+        "retirement_candidate": true,
+        "retirement_reason": "no measured usage in review window"
+      },
+      {
+        "interface": {
+          "id": "a4e0948c-cd4a-461e-8ae2-7fd7b51d04a7",
+          "interface_key": "rest_api:GET /decisions/?workstream_id",
+          "interface_kind": "rest_api",
+          "legacy_since": "2026-07-09T23:07:53.093223Z",
+          "replacement_ref": "/decisions/?workplan_id=<workplan_id>",
+          "owner_component": "state-hub.api",
+          "status": "legacy",
+          "replacement_verified": true,
+          "manual_hold": false,
+          "hold_reason": null,
+          "notes": null,
+          "retired_at": null,
+          "created_at": "2026-07-09T23:07:53.093223Z",
+          "updated_at": "2026-07-09T23:07:53.093223Z"
+        },
+        "all_time": {
+          "calls": 1,
+          "tenant_count": 1,
+          "user_count": 1,
+          "component_count": 1,
+          "tenants": {
+            "unknown": 1
+          },
+          "users": {
+            "unknown": 1
+          },
+          "components": {
+            "unknown": 1
+          }
+        },
+        "window": {
+          "calls": 0,
+          "tenant_count": 0,
+          "user_count": 0,
+          "component_count": 0,
+          "tenants": {},
+          "users": {},
+          "components": {}
+        },
+        "last_seen_at": "2026-07-09T23:07:53.083299Z",
+        "retirement_candidate": true,
+        "retirement_reason": "no measured usage in review window"
+      },
+      {
+        "interface": {
+          "id": "70a9346e-e0ee-42ac-874f-f160580b54dd",
+          "interface_key": "rest_api:GET /progress/?workstream_id",
+          "interface_kind": "rest_api",
+          "legacy_since": "2026-07-13T22:04:03.911449Z",
+          "replacement_ref": "/progress/?workplan_id=<workplan_id>",
+          "owner_component": "state-hub.api",
+          "status": "legacy",
+          "replacement_verified": true,
+          "manual_hold": false,
+          "hold_reason": null,
+          "notes": null,
+          "retired_at": null,
+          "created_at": "2026-07-13T22:04:03.911449Z",
+          "updated_at": "2026-07-13T22:04:03.911449Z"
+        },
+        "all_time": {
+          "calls": 1,
+          "tenant_count": 1,
+          "user_count": 1,
+          "component_count": 1,
+          "tenants": {
+            "unknown": 1
+          },
+          "users": {
+            "unknown": 1
+          },
+          "components": {
+            "unknown": 1
+          }
+        },
+        "window": {
+          "calls": 0,
+          "tenant_count": 0,
+          "user_count": 0,
+          "component_count": 0,
+          "tenants": {},
+          "users": {},
+          "components": {}
+        },
+        "last_seen_at": "2026-07-13T22:04:03.904998Z",
+        "retirement_candidate": true,
+        "retirement_reason": "no measured usage in review window"
+      },
+      {
+        "interface": {
+          "id": "be3cdcf8-250b-4bf0-801f-02ffd5f57e00",
+          "interface_key": "rest_api:GET /tasks/?workstream_id",
+          "interface_kind": "rest_api",
+          "legacy_since": "2026-07-08T19:32:21.628513Z",
+          "replacement_ref": "/tasks/?workplan_id=<workplan_id>",
+          "owner_component": "state-hub.api",
+          "status": "legacy",
+          "replacement_verified": true,
+          "manual_hold": false,
+          "hold_reason": null,
+          "notes": null,
+          "retired_at": null,
+          "created_at": "2026-07-08T19:32:21.628513Z",
+          "updated_at": "2026-07-08T19:32:21.628513Z"
+        },
+        "all_time": {
+          "calls": 589,
+          "tenant_count": 1,
+          "user_count": 1,
+          "component_count": 1,
+          "tenants": {
+            "unknown": 589
+          },
+          "users": {
+            "unknown": 589
+          },
+          "components": {
+            "unknown": 589
+          }
+        },
+        "window": {
+          "calls": 0,
+          "tenant_count": 0,
+          "user_count": 0,
+          "component_count": 0,
+          "tenants": {},
+          "users": {},
+          "components": {}
+        },
+        "last_seen_at": "2026-07-31T16:25:32.181901Z",
+        "retirement_candidate": true,
+        "retirement_reason": "no measured usage in review window"
+      },
+      {
+        "interface": {
+          "id": "3e4a3d0b-08fa-45c3-91e2-4f514a914b97",
+          "interface_key": "rest_api:GET /workstreams/",
+          "interface_kind": "rest_api",
+          "legacy_since": "2026-06-04T00:26:14.533764Z",
+          "replacement_ref": "/workplans/",
+          "owner_component": "state-hub.api",
+          "status": "legacy",
+          "replacement_verified": true,
+          "manual_hold": false,
+          "hold_reason": null,
+          "notes": null,
+          "retired_at": null,
+          "created_at": "2026-06-04T00:26:14.533764Z",
+          "updated_at": "2026-06-04T00:26:14.533764Z"
+        },
+        "all_time": {
+          "calls": 144084,
+          "tenant_count": 1,
+          "user_count": 1,
+          "component_count": 1,
+          "tenants": {
+            "unknown": 144084
+          },
+          "users": {
+            "unknown": 144084
+          },
+          "components": {
+            "unknown": 144084
+          }
+        },
+        "window": {
+          "calls": 0,
+          "tenant_count": 0,
+          "user_count": 0,
+          "component_count": 0,
+          "tenants": {},
+          "users": {},
+          "components": {}
+        },
+        "last_seen_at": "2026-07-08T21:14:39.652776Z",
+        "retirement_candidate": true,
+        "retirement_reason": "no measured usage in review window"
+      },
+      {
+        "interface": {
+          "id": "e4c140ec-7479-46f9-b185-4b533f19d639",
+          "interface_key": "rest_api:GET /workstreams/workplan-index",
+          "interface_kind": "rest_api",
+          "legacy_since": "2026-06-04T05:20:58.321869Z",
+          "replacement_ref": "/workplans/index",
+          "owner_component": "state-hub.api",
+          "status": "legacy",
+          "replacement_verified": true,
+          "manual_hold": false,
+          "hold_reason": null,
+          "notes": null,
+          "retired_at": null,
+          "created_at": "2026-06-04T05:20:58.321869Z",
+          "updated_at": "2026-06-04T05:20:58.321869Z"
+        },
+        "all_time": {
+          "calls": 30,
+          "tenant_count": 1,
+          "user_count": 1,
+          "component_count": 1,
+          "tenants": {
+            "unknown": 30
+          },
+          "users": {
+            "unknown": 30
+          },
+          "components": {
+            "unknown": 30
+          }
+        },
+        "window": {
+          "calls": 0,
+          "tenant_count": 0,
+          "user_count": 0,
+          "component_count": 0,
+          "tenants": {},
+          "users": {},
+          "components": {}
+        },
+        "last_seen_at": "2026-07-03T05:20:34.534439Z",
+        "retirement_candidate": true,
+        "retirement_reason": "no measured usage in review window"
+      },
+      {
+        "interface": {
+          "id": "3a00b19e-e7db-4403-98aa-a77c9ab61ecc",
+          "interface_key": "rest_api:GET /workstreams/{workstream_id}",
+          "interface_kind": "rest_api",
+          "legacy_since": "2026-06-04T00:25:59.014966Z",
+          "replacement_ref": "/workplans/{workplan_id}",
+          "owner_component": "state-hub.api",
+          "status": "legacy",
+          "replacement_verified": true,
+          "manual_hold": false,
+          "hold_reason": null,
+          "notes": null,
+          "retired_at": null,
+          "created_at": "2026-06-04T00:25:59.014966Z",
+          "updated_at": "2026-06-04T00:25:59.014966Z"
+        },
+        "all_time": {
+          "calls": 511406,
+          "tenant_count": 1,
+          "user_count": 1,
+          "component_count": 1,
+          "tenants": {
+            "unknown": 511406
+          },
+          "users": {
+            "unknown": 511406
+          },
+          "components": {
+            "unknown": 511406
+          }
+        },
+        "window": {
+          "calls": 0,
+          "tenant_count": 0,
+          "user_count": 0,
+          "component_count": 0,
+          "tenants": {},
+          "users": {},
+          "components": {}
+        },
+        "last_seen_at": "2026-07-31T16:25:32.004042Z",
+        "retirement_candidate": true,
+        "retirement_reason": "no measured usage in review window"
+      },
+      {
+        "interface": {
+          "id": "69e1a255-a8b9-4101-8a68-b1bed23abfda",
+          "interface_key": "rest_api:GET /workstreams/{workstream_id}/dependencies/",
+          "interface_kind": "rest_api",
+          "legacy_since": "2026-06-04T00:25:59.291135Z",
+          "replacement_ref": "/workplans/{workplan_id}/dependencies/",
+          "owner_component": "state-hub.api",
+          "status": "legacy",
+          "replacement_verified": true,
+          "manual_hold": false,
+          "hold_reason": null,
+          "notes": null,
+          "retired_at": null,
+          "created_at": "2026-06-04T00:25:59.291135Z",
+          "updated_at": "2026-06-04T00:25:59.291135Z"
+        },
+        "all_time": {
+          "calls": 255865,
+          "tenant_count": 1,
+          "user_count": 1,
+          "component_count": 1,
+          "tenants": {
+            "unknown": 255865
+          },
+          "users": {
+            "unknown": 255865
+          },
+          "components": {
+            "unknown": 255865
+          }
+        },
+        "window": {
+          "calls": 0,
+          "tenant_count": 0,
+          "user_count": 0,
+          "component_count": 0,
+          "tenants": {},
+          "users": {},
+          "components": {}
+        },
+        "last_seen_at": "2026-07-08T21:14:12.747005Z",
+        "retirement_candidate": true,
+        "retirement_reason": "no measured usage in review window"
+      },
+      {
+        "interface": {
+          "id": "b1aae931-b51f-4a85-a723-865dd65f6132",
+          "interface_key": "rest_api:PATCH /workstreams/{workstream_id}",
+          "interface_kind": "rest_api",
+          "legacy_since": "2026-06-04T06:09:41.901035Z",
+          "replacement_ref": "/workplans/{workplan_id}",
+          "owner_component": "state-hub.api",
+          "status": "legacy",
+          "replacement_verified": true,
+          "manual_hold": false,
+          "hold_reason": null,
+          "notes": null,
+          "retired_at": null,
+          "created_at": "2026-06-04T06:09:41.901035Z",
+          "updated_at": "2026-06-04T06:09:41.901035Z"
+        },
+        "all_time": {
+          "calls": 571,
+          "tenant_count": 1,
+          "user_count": 1,
+          "component_count": 1,
+          "tenants": {
+            "unknown": 571
+          },
+          "users": {
+            "unknown": 571
+          },
+          "components": {
+            "unknown": 571
+          }
+        },
+        "window": {
+          "calls": 0,
+          "tenant_count": 0,
+          "user_count": 0,
+          "component_count": 0,
+          "tenants": {},
+          "users": {},
+          "components": {}
+        },
+        "last_seen_at": "2026-07-08T20:49:12.335710Z",
+        "retirement_candidate": true,
+        "retirement_reason": "no measured usage in review window"
+      },
+      {
+        "interface": {
+          "id": "4aea9591-970b-4918-ac4a-4da95a0a1a8c",
+          "interface_key": "rest_api:POST /decisions/ workstream_id",
+          "interface_kind": "rest_api",
+          "legacy_since": "2026-07-09T22:56:35.473130Z",
+          "replacement_ref": "POST /decisions/ with workplan_id",
+          "owner_component": "state-hub.api",
+          "status": "legacy",
+          "replacement_verified": true,
+          "manual_hold": false,
+          "hold_reason": null,
+          "notes": null,
+          "retired_at": null,
+          "created_at": "2026-07-09T22:56:35.473130Z",
+          "updated_at": "2026-07-09T22:56:35.473130Z"
+        },
+        "all_time": {
+          "calls": 3,
+          "tenant_count": 1,
+          "user_count": 1,
+          "component_count": 1,
+          "tenants": {
+            "unknown": 3
+          },
+          "users": {
+            "unknown": 3
+          },
+          "components": {
+            "unknown": 3
+          }
+        },
+        "window": {
+          "calls": 0,
+          "tenant_count": 0,
+          "user_count": 0,
+          "component_count": 0,
+          "tenants": {},
+          "users": {},
+          "components": {}
+        },
+        "last_seen_at": "2026-07-09T22:57:05.912456Z",
+        "retirement_candidate": true,
+        "retirement_reason": "no measured usage in review window"
+      },
+      {
+        "interface": {
+          "id": "4a70583c-1e41-4ec1-99a9-728856a7d79c",
+          "interface_key": "rest_api:POST /progress/ workstream_id",
+          "interface_kind": "rest_api",
+          "legacy_since": "2026-07-08T23:35:09.148333Z",
+          "replacement_ref": "POST /progress/ with workplan_id",
+          "owner_component": "state-hub.api",
+          "status": "legacy",
+          "replacement_verified": true,
+          "manual_hold": false,
+          "hold_reason": null,
+          "notes": null,
+          "retired_at": null,
+          "created_at": "2026-07-08T23:35:09.148333Z",
+          "updated_at": "2026-07-08T23:35:09.148333Z"
+        },
+        "all_time": {
+          "calls": 14,
+          "tenant_count": 1,
+          "user_count": 1,
+          "component_count": 1,
+          "tenants": {
+            "unknown": 14
+          },
+          "users": {
+            "unknown": 14
+          },
+          "components": {
+            "unknown": 14
+          }
+        },
+        "window": {
+          "calls": 0,
+          "tenant_count": 0,
+          "user_count": 0,
+          "component_count": 0,
+          "tenants": {},
+          "users": {},
+          "components": {}
+        },
+        "last_seen_at": "2026-07-10T08:34:42.959724Z",
+        "retirement_candidate": true,
+        "retirement_reason": "no measured usage in review window"
+      },
+      {
+        "interface": {
+          "id": "6df4e443-7bf1-461a-923b-a6eb52fe7b07",
+          "interface_key": "rest_api:POST /tasks/ workstream_id",
+          "interface_kind": "rest_api",
+          "legacy_since": "2026-07-08T22:38:29.405720Z",
+          "replacement_ref": "POST /tasks/ with workplan_id",
+          "owner_component": "state-hub.api",
+          "status": "legacy",
+          "replacement_verified": true,
+          "manual_hold": false,
+          "hold_reason": null,
+          "notes": null,
+          "retired_at": null,
+          "created_at": "2026-07-08T22:38:29.405720Z",
+          "updated_at": "2026-07-08T22:38:29.405720Z"
+        },
+        "all_time": {
+          "calls": 5,
+          "tenant_count": 1,
+          "user_count": 1,
+          "component_count": 1,
+          "tenants": {
+            "unknown": 5
+          },
+          "users": {
+            "unknown": 5
+          },
+          "components": {
+            "state-hub.fix-consistency": 5
+          }
+        },
+        "window": {
+          "calls": 0,
+          "tenant_count": 0,
+          "user_count": 0,
+          "component_count": 0,
+          "tenants": {},
+          "users": {},
+          "components": {}
+        },
+        "last_seen_at": "2026-07-08T22:38:29.976918Z",
+        "retirement_candidate": true,
+        "retirement_reason": "no measured usage in review window"
+      },
+      {
+        "interface": {
+          "id": "ed6451c9-d2cc-4486-9afe-d3852782cabc",
+          "interface_key": "rest_api:POST /workstreams/",
+          "interface_kind": "rest_api",
+          "legacy_since": "2026-06-04T07:40:24.168535Z",
+          "replacement_ref": "/workplans/",
+          "owner_component": "state-hub.api",
+          "status": "legacy",
+          "replacement_verified": true,
+          "manual_hold": false,
+          "hold_reason": null,
+          "notes": null,
+          "retired_at": null,
+          "created_at": "2026-06-04T07:40:24.168535Z",
+          "updated_at": "2026-06-04T07:40:24.168535Z"
+        },
+        "all_time": {
+          "calls": 824,
+          "tenant_count": 1,
+          "user_count": 1,
+          "component_count": 1,
+          "tenants": {
+            "unknown": 824
+          },
+          "users": {
+            "unknown": 824
+          },
+          "components": {
+            "unknown": 824
+          }
+        },
+        "window": {
+          "calls": 0,
+          "tenant_count": 0,
+          "user_count": 0,
+          "component_count": 0,
+          "tenants": {},
+          "users": {},
+          "components": {}
+        },
+        "last_seen_at": "2026-07-08T20:38:05.903144Z",
+        "retirement_candidate": true,
+        "retirement_reason": "no measured usage in review window"
+      },
+      {
+        "interface": {
+          "id": "281fd706-b192-4194-8055-2d8733c115f9",
+          "interface_key": "rest_api:POST /workstreams/{workstream_id}/dependencies/",
+          "interface_kind": "rest_api",
+          "legacy_since": "2026-06-04T22:57:37.149207Z",
+          "replacement_ref": "/workplans/{workplan_id}/dependencies/",
+          "owner_component": "state-hub.api",
+          "status": "legacy",
+          "replacement_verified": true,
+          "manual_hold": false,
+          "hold_reason": null,
+          "notes": null,
+          "retired_at": null,
+          "created_at": "2026-06-04T22:57:37.149207Z",
+          "updated_at": "2026-06-04T22:57:37.149207Z"
+        },
+        "all_time": {
+          "calls": 4971,
+          "tenant_count": 1,
+          "user_count": 1,
+          "component_count": 1,
+          "tenants": {
+            "unknown": 4971
+          },
+          "users": {
+            "unknown": 4971
+          },
+          "components": {
+            "unknown": 4971
+          }
+        },
+        "window": {
+          "calls": 0,
+          "tenant_count": 0,
+          "user_count": 0,
+          "component_count": 0,
+          "tenants": {},
+          "users": {},
+          "components": {}
+        },
+        "last_seen_at": "2026-07-01T22:09:24.229011Z",
+        "retirement_candidate": true,
+        "retirement_reason": "no measured usage in review window"
+      }
+    ]
+  },
+  "hours": 8
+}
diff --git a/docs/evidence/legacy-meter-weekly-review-20260804.json b/docs/evidence/legacy-meter-weekly-review-20260804.json
new file mode 100644
index 0000000..275f050
--- /dev/null
+++ b/docs/evidence/legacy-meter-weekly-review-20260804.json
@@ -0,0 +1,1755 @@
+{
+  "captured_at": "2026-08-04T06:00:02.451219+00:00",
+  "api_base": "http://127.0.0.1:8000",
+  "workplan": "STATE-WP-0070",
+  "retired_interfaces": [],
+  "weekly_review": {
+    "generated_at": "2026-08-04T06:00:02.430575Z",
+    "window_start": "2026-08-03T22:00:01.406868Z",
+    "window_end": "2026-08-04T06:00:01.406868Z",
+    "cadence": "weekly",
+    "activity_core_handoff": {
+      "activity_id": "statehub-legacy-interface-review",
+      "cadence": "weekly",
+      "source_endpoint": "/legacy-meter/weekly-review",
+      "state_owner": "state-hub",
+      "scheduler_owner": "activity-core"
+    },
+    "interfaces": [
+      {
+        "interface": {
+          "id": "8051fb40-66c9-4dc4-a413-13e8573e04a3",
+          "interface_key": "event_subject:org.statehub.workstream.completed",
+          "interface_kind": "event_subject",
+          "legacy_since": "2026-06-04T06:09:42.198193Z",
+          "replacement_ref": "org.statehub.workplan.completed",
+          "owner_component": "state-hub.events",
+          "status": "retired",
+          "replacement_verified": true,
+          "manual_hold": false,
+          "hold_reason": null,
+          "notes": "Retired by STATE-WP-0069 closeout",
+          "retired_at": "2026-07-08T21:38:52.773601Z",
+          "created_at": "2026-06-04T06:09:42.198193Z",
+          "updated_at": "2026-07-08T21:38:52.761243Z"
+        },
+        "all_time": {
+          "calls": 255,
+          "tenant_count": 1,
+          "user_count": 1,
+          "component_count": 1,
+          "tenants": {
+            "unknown": 255
+          },
+          "users": {
+            "unknown": 255
+          },
+          "components": {
+            "state-hub.events": 255
+          }
+        },
+        "window": {
+          "calls": 0,
+          "tenant_count": 0,
+          "user_count": 0,
+          "component_count": 0,
+          "tenants": {},
+          "users": {},
+          "components": {}
+        },
+        "last_seen_at": "2026-07-08T20:49:12.839383Z",
+        "retirement_candidate": false,
+        "retirement_reason": "already retired"
+      },
+      {
+        "interface": {
+          "id": "63ed90e3-42b4-431a-94db-e1254a52f9e2",
+          "interface_key": "mcp:create_workstream",
+          "interface_kind": "mcp_tool",
+          "legacy_since": "2026-07-10T13:19:44.205900Z",
+          "replacement_ref": "create_workplan",
+          "owner_component": "state-hub.mcp",
+          "status": "legacy",
+          "replacement_verified": true,
+          "manual_hold": false,
+          "hold_reason": null,
+          "notes": "Registered by STATE-WP-0070 T03 \u2014 zero-window streak starts at registration",
+          "retired_at": null,
+          "created_at": "2026-07-10T13:19:44.205900Z",
+          "updated_at": "2026-07-10T13:19:44.205900Z"
+        },
+        "all_time": {
+          "calls": 2,
+          "tenant_count": 1,
+          "user_count": 1,
+          "component_count": 1,
+          "tenants": {
+            "unknown": 2
+          },
+          "users": {
+            "unknown": 2
+          },
+          "components": {
+            "state-hub.mcp": 2
+          }
+        },
+        "window": {
+          "calls": 0,
+          "tenant_count": 0,
+          "user_count": 0,
+          "component_count": 0,
+          "tenants": {},
+          "users": {},
+          "components": {}
+        },
+        "last_seen_at": "2026-07-10T13:20:43.378546Z",
+        "retirement_candidate": true,
+        "retirement_reason": "no measured usage in review window"
+      },
+      {
+        "interface": {
+          "id": "b6a5fe44-fb85-4ef7-a273-78d09da777af",
+          "interface_key": "mcp:list_workstreams",
+          "interface_kind": "mcp_tool",
+          "legacy_since": "2026-07-10T13:19:26.075491Z",
+          "replacement_ref": "list_workplans",
+          "owner_component": "state-hub.mcp",
+          "status": "legacy",
+          "replacement_verified": true,
+          "manual_hold": false,
+          "hold_reason": null,
+          "notes": null,
+          "retired_at": null,
+          "created_at": "2026-07-10T13:19:26.075491Z",
+          "updated_at": "2026-07-10T13:19:26.075491Z"
+        },
+        "all_time": {
+          "calls": 2,
+          "tenant_count": 1,
+          "user_count": 1,
+          "component_count": 1,
+          "tenants": {
+            "unknown": 2
+          },
+          "users": {
+            "unknown": 2
+          },
+          "components": {
+            "state-hub.mcp": 2
+          }
+        },
+        "window": {
+          "calls": 0,
+          "tenant_count": 0,
+          "user_count": 0,
+          "component_count": 0,
+          "tenants": {},
+          "users": {},
+          "components": {}
+        },
+        "last_seen_at": "2026-07-10T13:20:42.374940Z",
+        "retirement_candidate": true,
+        "retirement_reason": "no measured usage in review window"
+      },
+      {
+        "interface": {
+          "id": "53c3372b-307d-4d6a-8ea4-bc36cacdcaf2",
+          "interface_key": "mcp:update_workstream",
+          "interface_kind": "mcp_tool",
+          "legacy_since": "2026-07-10T13:19:44.255216Z",
+          "replacement_ref": "update_workplan",
+          "owner_component": "state-hub.mcp",
+          "status": "legacy",
+          "replacement_verified": true,
+          "manual_hold": false,
+          "hold_reason": null,
+          "notes": "Registered by STATE-WP-0070 T03 \u2014 zero-window streak starts at registration",
+          "retired_at": null,
+          "created_at": "2026-07-10T13:19:44.255216Z",
+          "updated_at": "2026-07-10T13:19:44.255216Z"
+        },
+        "all_time": {
+          "calls": 0,
+          "tenant_count": 0,
+          "user_count": 0,
+          "component_count": 0,
+          "tenants": {},
+          "users": {},
+          "components": {}
+        },
+        "window": {
+          "calls": 0,
+          "tenant_count": 0,
+          "user_count": 0,
+          "component_count": 0,
+          "tenants": {},
+          "users": {},
+          "components": {}
+        },
+        "last_seen_at": null,
+        "retirement_candidate": true,
+        "retirement_reason": "no measured usage in review window"
+      },
+      {
+        "interface": {
+          "id": "bed4d08a-3471-48f5-9f0e-f9d550383a26",
+          "interface_key": "mcp:update_workstream_status",
+          "interface_kind": "mcp_tool",
+          "legacy_since": "2026-07-10T13:19:44.303612Z",
+          "replacement_ref": "update_workplan_status",
+          "owner_component": "state-hub.mcp",
+          "status": "legacy",
+          "replacement_verified": true,
+          "manual_hold": false,
+          "hold_reason": null,
+          "notes": "Registered by STATE-WP-0070 T03 \u2014 zero-window streak starts at registration",
+          "retired_at": null,
+          "created_at": "2026-07-10T13:19:44.303612Z",
+          "updated_at": "2026-07-10T13:19:44.303612Z"
+        },
+        "all_time": {
+          "calls": 0,
+          "tenant_count": 0,
+          "user_count": 0,
+          "component_count": 0,
+          "tenants": {},
+          "users": {},
+          "components": {}
+        },
+        "window": {
+          "calls": 0,
+          "tenant_count": 0,
+          "user_count": 0,
+          "component_count": 0,
+          "tenants": {},
+          "users": {},
+          "components": {}
+        },
+        "last_seen_at": null,
+        "retirement_candidate": true,
+        "retirement_reason": "no measured usage in review window"
+      },
+      {
+        "interface": {
+          "id": "46900dc2-0893-405b-ba59-80f31fb6ebb1",
+          "interface_key": "state://workstreams/{topic_slug}",
+          "interface_kind": "mcp_tool",
+          "legacy_since": "2026-07-10T13:19:44.344493Z",
+          "replacement_ref": "state://workplans/{topic_slug}",
+          "owner_component": "state-hub.mcp",
+          "status": "legacy",
+          "replacement_verified": true,
+          "manual_hold": false,
+          "hold_reason": null,
+          "notes": "Registered by STATE-WP-0070 T03 \u2014 zero-window streak starts at registration",
+          "retired_at": null,
+          "created_at": "2026-07-10T13:19:44.344493Z",
+          "updated_at": "2026-07-10T13:19:44.344493Z"
+        },
+        "all_time": {
+          "calls": 1,
+          "tenant_count": 1,
+          "user_count": 1,
+          "component_count": 1,
+          "tenants": {
+            "unknown": 1
+          },
+          "users": {
+            "unknown": 1
+          },
+          "components": {
+            "state-hub.mcp": 1
+          }
+        },
+        "window": {
+          "calls": 0,
+          "tenant_count": 0,
+          "user_count": 0,
+          "component_count": 0,
+          "tenants": {},
+          "users": {},
+          "components": {}
+        },
+        "last_seen_at": "2026-07-10T13:20:34.491811Z",
+        "retirement_candidate": true,
+        "retirement_reason": "no measured usage in review window"
+      },
+      {
+        "interface": {
+          "id": "cd9342fd-27e7-4a46-a1be-d41499e106a3",
+          "interface_key": "rest_api:DELETE /workstreams/{workstream_id}",
+          "interface_kind": "rest_api",
+          "legacy_since": "2026-06-06T17:28:13.052813Z",
+          "replacement_ref": "/workplans/{workplan_id}",
+          "owner_component": "state-hub.api",
+          "status": "legacy",
+          "replacement_verified": true,
+          "manual_hold": false,
+          "hold_reason": null,
+          "notes": null,
+          "retired_at": null,
+          "created_at": "2026-06-06T17:28:13.052813Z",
+          "updated_at": "2026-06-06T17:28:13.052813Z"
+        },
+        "all_time": {
+          "calls": 1,
+          "tenant_count": 1,
+          "user_count": 1,
+          "component_count": 1,
+          "tenants": {
+            "unknown": 1
+          },
+          "users": {
+            "unknown": 1
+          },
+          "components": {
+            "unknown": 1
+          }
+        },
+        "window": {
+          "calls": 0,
+          "tenant_count": 0,
+          "user_count": 0,
+          "component_count": 0,
+          "tenants": {},
+          "users": {},
+          "components": {}
+        },
+        "last_seen_at": "2026-06-06T17:28:13.047529Z",
+        "retirement_candidate": true,
+        "retirement_reason": "no measured usage in review window"
+      },
+      {
+        "interface": {
+          "id": "a4e0948c-cd4a-461e-8ae2-7fd7b51d04a7",
+          "interface_key": "rest_api:GET /decisions/?workstream_id",
+          "interface_kind": "rest_api",
+          "legacy_since": "2026-07-09T23:07:53.093223Z",
+          "replacement_ref": "/decisions/?workplan_id=<workplan_id>",
+          "owner_component": "state-hub.api",
+          "status": "legacy",
+          "replacement_verified": true,
+          "manual_hold": false,
+          "hold_reason": null,
+          "notes": null,
+          "retired_at": null,
+          "created_at": "2026-07-09T23:07:53.093223Z",
+          "updated_at": "2026-07-09T23:07:53.093223Z"
+        },
+        "all_time": {
+          "calls": 1,
+          "tenant_count": 1,
+          "user_count": 1,
+          "component_count": 1,
+          "tenants": {
+            "unknown": 1
+          },
+          "users": {
+            "unknown": 1
+          },
+          "components": {
+            "unknown": 1
+          }
+        },
+        "window": {
+          "calls": 0,
+          "tenant_count": 0,
+          "user_count": 0,
+          "component_count": 0,
+          "tenants": {},
+          "users": {},
+          "components": {}
+        },
+        "last_seen_at": "2026-07-09T23:07:53.083299Z",
+        "retirement_candidate": true,
+        "retirement_reason": "no measured usage in review window"
+      },
+      {
+        "interface": {
+          "id": "70a9346e-e0ee-42ac-874f-f160580b54dd",
+          "interface_key": "rest_api:GET /progress/?workstream_id",
+          "interface_kind": "rest_api",
+          "legacy_since": "2026-07-13T22:04:03.911449Z",
+          "replacement_ref": "/progress/?workplan_id=<workplan_id>",
+          "owner_component": "state-hub.api",
+          "status": "legacy",
+          "replacement_verified": true,
+          "manual_hold": false,
+          "hold_reason": null,
+          "notes": null,
+          "retired_at": null,
+          "created_at": "2026-07-13T22:04:03.911449Z",
+          "updated_at": "2026-07-13T22:04:03.911449Z"
+        },
+        "all_time": {
+          "calls": 1,
+          "tenant_count": 1,
+          "user_count": 1,
+          "component_count": 1,
+          "tenants": {
+            "unknown": 1
+          },
+          "users": {
+            "unknown": 1
+          },
+          "components": {
+            "unknown": 1
+          }
+        },
+        "window": {
+          "calls": 0,
+          "tenant_count": 0,
+          "user_count": 0,
+          "component_count": 0,
+          "tenants": {},
+          "users": {},
+          "components": {}
+        },
+        "last_seen_at": "2026-07-13T22:04:03.904998Z",
+        "retirement_candidate": true,
+        "retirement_reason": "no measured usage in review window"
+      },
+      {
+        "interface": {
+          "id": "be3cdcf8-250b-4bf0-801f-02ffd5f57e00",
+          "interface_key": "rest_api:GET /tasks/?workstream_id",
+          "interface_kind": "rest_api",
+          "legacy_since": "2026-07-08T19:32:21.628513Z",
+          "replacement_ref": "/tasks/?workplan_id=<workplan_id>",
+          "owner_component": "state-hub.api",
+          "status": "legacy",
+          "replacement_verified": true,
+          "manual_hold": false,
+          "hold_reason": null,
+          "notes": null,
+          "retired_at": null,
+          "created_at": "2026-07-08T19:32:21.628513Z",
+          "updated_at": "2026-07-08T19:32:21.628513Z"
+        },
+        "all_time": {
+          "calls": 589,
+          "tenant_count": 1,
+          "user_count": 1,
+          "component_count": 1,
+          "tenants": {
+            "unknown": 589
+          },
+          "users": {
+            "unknown": 589
+          },
+          "components": {
+            "unknown": 589
+          }
+        },
+        "window": {
+          "calls": 0,
+          "tenant_count": 0,
+          "user_count": 0,
+          "component_count": 0,
+          "tenants": {},
+          "users": {},
+          "components": {}
+        },
+        "last_seen_at": "2026-07-31T16:25:32.181901Z",
+        "retirement_candidate": true,
+        "retirement_reason": "no measured usage in review window"
+      },
+      {
+        "interface": {
+          "id": "3e4a3d0b-08fa-45c3-91e2-4f514a914b97",
+          "interface_key": "rest_api:GET /workstreams/",
+          "interface_kind": "rest_api",
+          "legacy_since": "2026-06-04T00:26:14.533764Z",
+          "replacement_ref": "/workplans/",
+          "owner_component": "state-hub.api",
+          "status": "legacy",
+          "replacement_verified": true,
+          "manual_hold": false,
+          "hold_reason": null,
+          "notes": null,
+          "retired_at": null,
+          "created_at": "2026-06-04T00:26:14.533764Z",
+          "updated_at": "2026-06-04T00:26:14.533764Z"
+        },
+        "all_time": {
+          "calls": 144084,
+          "tenant_count": 1,
+          "user_count": 1,
+          "component_count": 1,
+          "tenants": {
+            "unknown": 144084
+          },
+          "users": {
+            "unknown": 144084
+          },
+          "components": {
+            "unknown": 144084
+          }
+        },
+        "window": {
+          "calls": 0,
+          "tenant_count": 0,
+          "user_count": 0,
+          "component_count": 0,
+          "tenants": {},
+          "users": {},
+          "components": {}
+        },
+        "last_seen_at": "2026-07-08T21:14:39.652776Z",
+        "retirement_candidate": true,
+        "retirement_reason": "no measured usage in review window"
+      },
+      {
+        "interface": {
+          "id": "e4c140ec-7479-46f9-b185-4b533f19d639",
+          "interface_key": "rest_api:GET /workstreams/workplan-index",
+          "interface_kind": "rest_api",
+          "legacy_since": "2026-06-04T05:20:58.321869Z",
+          "replacement_ref": "/workplans/index",
+          "owner_component": "state-hub.api",
+          "status": "legacy",
+          "replacement_verified": true,
+          "manual_hold": false,
+          "hold_reason": null,
+          "notes": null,
+          "retired_at": null,
+          "created_at": "2026-06-04T05:20:58.321869Z",
+          "updated_at": "2026-06-04T05:20:58.321869Z"
+        },
+        "all_time": {
+          "calls": 30,
+          "tenant_count": 1,
+          "user_count": 1,
+          "component_count": 1,
+          "tenants": {
+            "unknown": 30
+          },
+          "users": {
+            "unknown": 30
+          },
+          "components": {
+            "unknown": 30
+          }
+        },
+        "window": {
+          "calls": 0,
+          "tenant_count": 0,
+          "user_count": 0,
+          "component_count": 0,
+          "tenants": {},
+          "users": {},
+          "components": {}
+        },
+        "last_seen_at": "2026-07-03T05:20:34.534439Z",
+        "retirement_candidate": true,
+        "retirement_reason": "no measured usage in review window"
+      },
+      {
+        "interface": {
+          "id": "3a00b19e-e7db-4403-98aa-a77c9ab61ecc",
+          "interface_key": "rest_api:GET /workstreams/{workstream_id}",
+          "interface_kind": "rest_api",
+          "legacy_since": "2026-06-04T00:25:59.014966Z",
+          "replacement_ref": "/workplans/{workplan_id}",
+          "owner_component": "state-hub.api",
+          "status": "legacy",
+          "replacement_verified": true,
+          "manual_hold": false,
+          "hold_reason": null,
+          "notes": null,
+          "retired_at": null,
+          "created_at": "2026-06-04T00:25:59.014966Z",
+          "updated_at": "2026-06-04T00:25:59.014966Z"
+        },
+        "all_time": {
+          "calls": 511406,
+          "tenant_count": 1,
+          "user_count": 1,
+          "component_count": 1,
+          "tenants": {
+            "unknown": 511406
+          },
+          "users": {
+            "unknown": 511406
+          },
+          "components": {
+            "unknown": 511406
+          }
+        },
+        "window": {
+          "calls": 0,
+          "tenant_count": 0,
+          "user_count": 0,
+          "component_count": 0,
+          "tenants": {},
+          "users": {},
+          "components": {}
+        },
+        "last_seen_at": "2026-07-31T16:25:32.004042Z",
+        "retirement_candidate": true,
+        "retirement_reason": "no measured usage in review window"
+      },
+      {
+        "interface": {
+          "id": "69e1a255-a8b9-4101-8a68-b1bed23abfda",
+          "interface_key": "rest_api:GET /workstreams/{workstream_id}/dependencies/",
+          "interface_kind": "rest_api",
+          "legacy_since": "2026-06-04T00:25:59.291135Z",
+          "replacement_ref": "/workplans/{workplan_id}/dependencies/",
+          "owner_component": "state-hub.api",
+          "status": "legacy",
+          "replacement_verified": true,
+          "manual_hold": false,
+          "hold_reason": null,
+          "notes": null,
+          "retired_at": null,
+          "created_at": "2026-06-04T00:25:59.291135Z",
+          "updated_at": "2026-06-04T00:25:59.291135Z"
+        },
+        "all_time": {
+          "calls": 255865,
+          "tenant_count": 1,
+          "user_count": 1,
+          "component_count": 1,
+          "tenants": {
+            "unknown": 255865
+          },
+          "users": {
+            "unknown": 255865
+          },
+          "components": {
+            "unknown": 255865
+          }
+        },
+        "window": {
+          "calls": 0,
+          "tenant_count": 0,
+          "user_count": 0,
+          "component_count": 0,
+          "tenants": {},
+          "users": {},
+          "components": {}
+        },
+        "last_seen_at": "2026-07-08T21:14:12.747005Z",
+        "retirement_candidate": true,
+        "retirement_reason": "no measured usage in review window"
+      },
+      {
+        "interface": {
+          "id": "b1aae931-b51f-4a85-a723-865dd65f6132",
+          "interface_key": "rest_api:PATCH /workstreams/{workstream_id}",
+          "interface_kind": "rest_api",
+          "legacy_since": "2026-06-04T06:09:41.901035Z",
+          "replacement_ref": "/workplans/{workplan_id}",
+          "owner_component": "state-hub.api",
+          "status": "legacy",
+          "replacement_verified": true,
+          "manual_hold": false,
+          "hold_reason": null,
+          "notes": null,
+          "retired_at": null,
+          "created_at": "2026-06-04T06:09:41.901035Z",
+          "updated_at": "2026-06-04T06:09:41.901035Z"
+        },
+        "all_time": {
+          "calls": 571,
+          "tenant_count": 1,
+          "user_count": 1,
+          "component_count": 1,
+          "tenants": {
+            "unknown": 571
+          },
+          "users": {
+            "unknown": 571
+          },
+          "components": {
+            "unknown": 571
+          }
+        },
+        "window": {
+          "calls": 0,
+          "tenant_count": 0,
+          "user_count": 0,
+          "component_count": 0,
+          "tenants": {},
+          "users": {},
+          "components": {}
+        },
+        "last_seen_at": "2026-07-08T20:49:12.335710Z",
+        "retirement_candidate": true,
+        "retirement_reason": "no measured usage in review window"
+      },
+      {
+        "interface": {
+          "id": "4aea9591-970b-4918-ac4a-4da95a0a1a8c",
+          "interface_key": "rest_api:POST /decisions/ workstream_id",
+          "interface_kind": "rest_api",
+          "legacy_since": "2026-07-09T22:56:35.473130Z",
+          "replacement_ref": "POST /decisions/ with workplan_id",
+          "owner_component": "state-hub.api",
+          "status": "legacy",
+          "replacement_verified": true,
+          "manual_hold": false,
+          "hold_reason": null,
+          "notes": null,
+          "retired_at": null,
+          "created_at": "2026-07-09T22:56:35.473130Z",
+          "updated_at": "2026-07-09T22:56:35.473130Z"
+        },
+        "all_time": {
+          "calls": 3,
+          "tenant_count": 1,
+          "user_count": 1,
+          "component_count": 1,
+          "tenants": {
+            "unknown": 3
+          },
+          "users": {
+            "unknown": 3
+          },
+          "components": {
+            "unknown": 3
+          }
+        },
+        "window": {
+          "calls": 0,
+          "tenant_count": 0,
+          "user_count": 0,
+          "component_count": 0,
+          "tenants": {},
+          "users": {},
+          "components": {}
+        },
+        "last_seen_at": "2026-07-09T22:57:05.912456Z",
+        "retirement_candidate": true,
+        "retirement_reason": "no measured usage in review window"
+      },
+      {
+        "interface": {
+          "id": "4a70583c-1e41-4ec1-99a9-728856a7d79c",
+          "interface_key": "rest_api:POST /progress/ workstream_id",
+          "interface_kind": "rest_api",
+          "legacy_since": "2026-07-08T23:35:09.148333Z",
+          "replacement_ref": "POST /progress/ with workplan_id",
+          "owner_component": "state-hub.api",
+          "status": "legacy",
+          "replacement_verified": true,
+          "manual_hold": false,
+          "hold_reason": null,
+          "notes": null,
+          "retired_at": null,
+          "created_at": "2026-07-08T23:35:09.148333Z",
+          "updated_at": "2026-07-08T23:35:09.148333Z"
+        },
+        "all_time": {
+          "calls": 14,
+          "tenant_count": 1,
+          "user_count": 1,
+          "component_count": 1,
+          "tenants": {
+            "unknown": 14
+          },
+          "users": {
+            "unknown": 14
+          },
+          "components": {
+            "unknown": 14
+          }
+        },
+        "window": {
+          "calls": 0,
+          "tenant_count": 0,
+          "user_count": 0,
+          "component_count": 0,
+          "tenants": {},
+          "users": {},
+          "components": {}
+        },
+        "last_seen_at": "2026-07-10T08:34:42.959724Z",
+        "retirement_candidate": true,
+        "retirement_reason": "no measured usage in review window"
+      },
+      {
+        "interface": {
+          "id": "6df4e443-7bf1-461a-923b-a6eb52fe7b07",
+          "interface_key": "rest_api:POST /tasks/ workstream_id",
+          "interface_kind": "rest_api",
+          "legacy_since": "2026-07-08T22:38:29.405720Z",
+          "replacement_ref": "POST /tasks/ with workplan_id",
+          "owner_component": "state-hub.api",
+          "status": "legacy",
+          "replacement_verified": true,
+          "manual_hold": false,
+          "hold_reason": null,
+          "notes": null,
+          "retired_at": null,
+          "created_at": "2026-07-08T22:38:29.405720Z",
+          "updated_at": "2026-07-08T22:38:29.405720Z"
+        },
+        "all_time": {
+          "calls": 5,
+          "tenant_count": 1,
+          "user_count": 1,
+          "component_count": 1,
+          "tenants": {
+            "unknown": 5
+          },
+          "users": {
+            "unknown": 5
+          },
+          "components": {
+            "state-hub.fix-consistency": 5
+          }
+        },
+        "window": {
+          "calls": 0,
+          "tenant_count": 0,
+          "user_count": 0,
+          "component_count": 0,
+          "tenants": {},
+          "users": {},
+          "components": {}
+        },
+        "last_seen_at": "2026-07-08T22:38:29.976918Z",
+        "retirement_candidate": true,
+        "retirement_reason": "no measured usage in review window"
+      },
+      {
+        "interface": {
+          "id": "ed6451c9-d2cc-4486-9afe-d3852782cabc",
+          "interface_key": "rest_api:POST /workstreams/",
+          "interface_kind": "rest_api",
+          "legacy_since": "2026-06-04T07:40:24.168535Z",
+          "replacement_ref": "/workplans/",
+          "owner_component": "state-hub.api",
+          "status": "legacy",
+          "replacement_verified": true,
+          "manual_hold": false,
+          "hold_reason": null,
+          "notes": null,
+          "retired_at": null,
+          "created_at": "2026-06-04T07:40:24.168535Z",
+          "updated_at": "2026-06-04T07:40:24.168535Z"
+        },
+        "all_time": {
+          "calls": 824,
+          "tenant_count": 1,
+          "user_count": 1,
+          "component_count": 1,
+          "tenants": {
+            "unknown": 824
+          },
+          "users": {
+            "unknown": 824
+          },
+          "components": {
+            "unknown": 824
+          }
+        },
+        "window": {
+          "calls": 0,
+          "tenant_count": 0,
+          "user_count": 0,
+          "component_count": 0,
+          "tenants": {},
+          "users": {},
+          "components": {}
+        },
+        "last_seen_at": "2026-07-08T20:38:05.903144Z",
+        "retirement_candidate": true,
+        "retirement_reason": "no measured usage in review window"
+      },
+      {
+        "interface": {
+          "id": "281fd706-b192-4194-8055-2d8733c115f9",
+          "interface_key": "rest_api:POST /workstreams/{workstream_id}/dependencies/",
+          "interface_kind": "rest_api",
+          "legacy_since": "2026-06-04T22:57:37.149207Z",
+          "replacement_ref": "/workplans/{workplan_id}/dependencies/",
+          "owner_component": "state-hub.api",
+          "status": "legacy",
+          "replacement_verified": true,
+          "manual_hold": false,
+          "hold_reason": null,
+          "notes": null,
+          "retired_at": null,
+          "created_at": "2026-06-04T22:57:37.149207Z",
+          "updated_at": "2026-06-04T22:57:37.149207Z"
+        },
+        "all_time": {
+          "calls": 4971,
+          "tenant_count": 1,
+          "user_count": 1,
+          "component_count": 1,
+          "tenants": {
+            "unknown": 4971
+          },
+          "users": {
+            "unknown": 4971
+          },
+          "components": {
+            "unknown": 4971
+          }
+        },
+        "window": {
+          "calls": 0,
+          "tenant_count": 0,
+          "user_count": 0,
+          "component_count": 0,
+          "tenants": {},
+          "users": {},
+          "components": {}
+        },
+        "last_seen_at": "2026-07-01T22:09:24.229011Z",
+        "retirement_candidate": true,
+        "retirement_reason": "no measured usage in review window"
+      }
+    ],
+    "retirement_candidates": [
+      {
+        "interface": {
+          "id": "63ed90e3-42b4-431a-94db-e1254a52f9e2",
+          "interface_key": "mcp:create_workstream",
+          "interface_kind": "mcp_tool",
+          "legacy_since": "2026-07-10T13:19:44.205900Z",
+          "replacement_ref": "create_workplan",
+          "owner_component": "state-hub.mcp",
+          "status": "legacy",
+          "replacement_verified": true,
+          "manual_hold": false,
+          "hold_reason": null,
+          "notes": "Registered by STATE-WP-0070 T03 \u2014 zero-window streak starts at registration",
+          "retired_at": null,
+          "created_at": "2026-07-10T13:19:44.205900Z",
+          "updated_at": "2026-07-10T13:19:44.205900Z"
+        },
+        "all_time": {
+          "calls": 2,
+          "tenant_count": 1,
+          "user_count": 1,
+          "component_count": 1,
+          "tenants": {
+            "unknown": 2
+          },
+          "users": {
+            "unknown": 2
+          },
+          "components": {
+            "state-hub.mcp": 2
+          }
+        },
+        "window": {
+          "calls": 0,
+          "tenant_count": 0,
+          "user_count": 0,
+          "component_count": 0,
+          "tenants": {},
+          "users": {},
+          "components": {}
+        },
+        "last_seen_at": "2026-07-10T13:20:43.378546Z",
+        "retirement_candidate": true,
+        "retirement_reason": "no measured usage in review window"
+      },
+      {
+        "interface": {
+          "id": "b6a5fe44-fb85-4ef7-a273-78d09da777af",
+          "interface_key": "mcp:list_workstreams",
+          "interface_kind": "mcp_tool",
+          "legacy_since": "2026-07-10T13:19:26.075491Z",
+          "replacement_ref": "list_workplans",
+          "owner_component": "state-hub.mcp",
+          "status": "legacy",
+          "replacement_verified": true,
+          "manual_hold": false,
+          "hold_reason": null,
+          "notes": null,
+          "retired_at": null,
+          "created_at": "2026-07-10T13:19:26.075491Z",
+          "updated_at": "2026-07-10T13:19:26.075491Z"
+        },
+        "all_time": {
+          "calls": 2,
+          "tenant_count": 1,
+          "user_count": 1,
+          "component_count": 1,
+          "tenants": {
+            "unknown": 2
+          },
+          "users": {
+            "unknown": 2
+          },
+          "components": {
+            "state-hub.mcp": 2
+          }
+        },
+        "window": {
+          "calls": 0,
+          "tenant_count": 0,
+          "user_count": 0,
+          "component_count": 0,
+          "tenants": {},
+          "users": {},
+          "components": {}
+        },
+        "last_seen_at": "2026-07-10T13:20:42.374940Z",
+        "retirement_candidate": true,
+        "retirement_reason": "no measured usage in review window"
+      },
+      {
+        "interface": {
+          "id": "53c3372b-307d-4d6a-8ea4-bc36cacdcaf2",
+          "interface_key": "mcp:update_workstream",
+          "interface_kind": "mcp_tool",
+          "legacy_since": "2026-07-10T13:19:44.255216Z",
+          "replacement_ref": "update_workplan",
+          "owner_component": "state-hub.mcp",
+          "status": "legacy",
+          "replacement_verified": true,
+          "manual_hold": false,
+          "hold_reason": null,
+          "notes": "Registered by STATE-WP-0070 T03 \u2014 zero-window streak starts at registration",
+          "retired_at": null,
+          "created_at": "2026-07-10T13:19:44.255216Z",
+          "updated_at": "2026-07-10T13:19:44.255216Z"
+        },
+        "all_time": {
+          "calls": 0,
+          "tenant_count": 0,
+          "user_count": 0,
+          "component_count": 0,
+          "tenants": {},
+          "users": {},
+          "components": {}
+        },
+        "window": {
+          "calls": 0,
+          "tenant_count": 0,
+          "user_count": 0,
+          "component_count": 0,
+          "tenants": {},
+          "users": {},
+          "components": {}
+        },
+        "last_seen_at": null,
+        "retirement_candidate": true,
+        "retirement_reason": "no measured usage in review window"
+      },
+      {
+        "interface": {
+          "id": "bed4d08a-3471-48f5-9f0e-f9d550383a26",
+          "interface_key": "mcp:update_workstream_status",
+          "interface_kind": "mcp_tool",
+          "legacy_since": "2026-07-10T13:19:44.303612Z",
+          "replacement_ref": "update_workplan_status",
+          "owner_component": "state-hub.mcp",
+          "status": "legacy",
+          "replacement_verified": true,
+          "manual_hold": false,
+          "hold_reason": null,
+          "notes": "Registered by STATE-WP-0070 T03 \u2014 zero-window streak starts at registration",
+          "retired_at": null,
+          "created_at": "2026-07-10T13:19:44.303612Z",
+          "updated_at": "2026-07-10T13:19:44.303612Z"
+        },
+        "all_time": {
+          "calls": 0,
+          "tenant_count": 0,
+          "user_count": 0,
+          "component_count": 0,
+          "tenants": {},
+          "users": {},
+          "components": {}
+        },
+        "window": {
+          "calls": 0,
+          "tenant_count": 0,
+          "user_count": 0,
+          "component_count": 0,
+          "tenants": {},
+          "users": {},
+          "components": {}
+        },
+        "last_seen_at": null,
+        "retirement_candidate": true,
+        "retirement_reason": "no measured usage in review window"
+      },
+      {
+        "interface": {
+          "id": "46900dc2-0893-405b-ba59-80f31fb6ebb1",
+          "interface_key": "state://workstreams/{topic_slug}",
+          "interface_kind": "mcp_tool",
+          "legacy_since": "2026-07-10T13:19:44.344493Z",
+          "replacement_ref": "state://workplans/{topic_slug}",
+          "owner_component": "state-hub.mcp",
+          "status": "legacy",
+          "replacement_verified": true,
+          "manual_hold": false,
+          "hold_reason": null,
+          "notes": "Registered by STATE-WP-0070 T03 \u2014 zero-window streak starts at registration",
+          "retired_at": null,
+          "created_at": "2026-07-10T13:19:44.344493Z",
+          "updated_at": "2026-07-10T13:19:44.344493Z"
+        },
+        "all_time": {
+          "calls": 1,
+          "tenant_count": 1,
+          "user_count": 1,
+          "component_count": 1,
+          "tenants": {
+            "unknown": 1
+          },
+          "users": {
+            "unknown": 1
+          },
+          "components": {
+            "state-hub.mcp": 1
+          }
+        },
+        "window": {
+          "calls": 0,
+          "tenant_count": 0,
+          "user_count": 0,
+          "component_count": 0,
+          "tenants": {},
+          "users": {},
+          "components": {}
+        },
+        "last_seen_at": "2026-07-10T13:20:34.491811Z",
+        "retirement_candidate": true,
+        "retirement_reason": "no measured usage in review window"
+      },
+      {
+        "interface": {
+          "id": "cd9342fd-27e7-4a46-a1be-d41499e106a3",
+          "interface_key": "rest_api:DELETE /workstreams/{workstream_id}",
+          "interface_kind": "rest_api",
+          "legacy_since": "2026-06-06T17:28:13.052813Z",
+          "replacement_ref": "/workplans/{workplan_id}",
+          "owner_component": "state-hub.api",
+          "status": "legacy",
+          "replacement_verified": true,
+          "manual_hold": false,
+          "hold_reason": null,
+          "notes": null,
+          "retired_at": null,
+          "created_at": "2026-06-06T17:28:13.052813Z",
+          "updated_at": "2026-06-06T17:28:13.052813Z"
+        },
+        "all_time": {
+          "calls": 1,
+          "tenant_count": 1,
+          "user_count": 1,
+          "component_count": 1,
+          "tenants": {
+            "unknown": 1
+          },
+          "users": {
+            "unknown": 1
+          },
+          "components": {
+            "unknown": 1
+          }
+        },
+        "window": {
+          "calls": 0,
+          "tenant_count": 0,
+          "user_count": 0,
+          "component_count": 0,
+          "tenants": {},
+          "users": {},
+          "components": {}
+        },
+        "last_seen_at": "2026-06-06T17:28:13.047529Z",
+        "retirement_candidate": true,
+        "retirement_reason": "no measured usage in review window"
+      },
+      {
+        "interface": {
+          "id": "a4e0948c-cd4a-461e-8ae2-7fd7b51d04a7",
+          "interface_key": "rest_api:GET /decisions/?workstream_id",
+          "interface_kind": "rest_api",
+          "legacy_since": "2026-07-09T23:07:53.093223Z",
+          "replacement_ref": "/decisions/?workplan_id=<workplan_id>",
+          "owner_component": "state-hub.api",
+          "status": "legacy",
+          "replacement_verified": true,
+          "manual_hold": false,
+          "hold_reason": null,
+          "notes": null,
+          "retired_at": null,
+          "created_at": "2026-07-09T23:07:53.093223Z",
+          "updated_at": "2026-07-09T23:07:53.093223Z"
+        },
+        "all_time": {
+          "calls": 1,
+          "tenant_count": 1,
+          "user_count": 1,
+          "component_count": 1,
+          "tenants": {
+            "unknown": 1
+          },
+          "users": {
+            "unknown": 1
+          },
+          "components": {
+            "unknown": 1
+          }
+        },
+        "window": {
+          "calls": 0,
+          "tenant_count": 0,
+          "user_count": 0,
+          "component_count": 0,
+          "tenants": {},
+          "users": {},
+          "components": {}
+        },
+        "last_seen_at": "2026-07-09T23:07:53.083299Z",
+        "retirement_candidate": true,
+        "retirement_reason": "no measured usage in review window"
+      },
+      {
+        "interface": {
+          "id": "70a9346e-e0ee-42ac-874f-f160580b54dd",
+          "interface_key": "rest_api:GET /progress/?workstream_id",
+          "interface_kind": "rest_api",
+          "legacy_since": "2026-07-13T22:04:03.911449Z",
+          "replacement_ref": "/progress/?workplan_id=<workplan_id>",
+          "owner_component": "state-hub.api",
+          "status": "legacy",
+          "replacement_verified": true,
+          "manual_hold": false,
+          "hold_reason": null,
+          "notes": null,
+          "retired_at": null,
+          "created_at": "2026-07-13T22:04:03.911449Z",
+          "updated_at": "2026-07-13T22:04:03.911449Z"
+        },
+        "all_time": {
+          "calls": 1,
+          "tenant_count": 1,
+          "user_count": 1,
+          "component_count": 1,
+          "tenants": {
+            "unknown": 1
+          },
+          "users": {
+            "unknown": 1
+          },
+          "components": {
+            "unknown": 1
+          }
+        },
+        "window": {
+          "calls": 0,
+          "tenant_count": 0,
+          "user_count": 0,
+          "component_count": 0,
+          "tenants": {},
+          "users": {},
+          "components": {}
+        },
+        "last_seen_at": "2026-07-13T22:04:03.904998Z",
+        "retirement_candidate": true,
+        "retirement_reason": "no measured usage in review window"
+      },
+      {
+        "interface": {
+          "id": "be3cdcf8-250b-4bf0-801f-02ffd5f57e00",
+          "interface_key": "rest_api:GET /tasks/?workstream_id",
+          "interface_kind": "rest_api",
+          "legacy_since": "2026-07-08T19:32:21.628513Z",
+          "replacement_ref": "/tasks/?workplan_id=<workplan_id>",
+          "owner_component": "state-hub.api",
+          "status": "legacy",
+          "replacement_verified": true,
+          "manual_hold": false,
+          "hold_reason": null,
+          "notes": null,
+          "retired_at": null,
+          "created_at": "2026-07-08T19:32:21.628513Z",
+          "updated_at": "2026-07-08T19:32:21.628513Z"
+        },
+        "all_time": {
+          "calls": 589,
+          "tenant_count": 1,
+          "user_count": 1,
+          "component_count": 1,
+          "tenants": {
+            "unknown": 589
+          },
+          "users": {
+            "unknown": 589
+          },
+          "components": {
+            "unknown": 589
+          }
+        },
+        "window": {
+          "calls": 0,
+          "tenant_count": 0,
+          "user_count": 0,
+          "component_count": 0,
+          "tenants": {},
+          "users": {},
+          "components": {}
+        },
+        "last_seen_at": "2026-07-31T16:25:32.181901Z",
+        "retirement_candidate": true,
+        "retirement_reason": "no measured usage in review window"
+      },
+      {
+        "interface": {
+          "id": "3e4a3d0b-08fa-45c3-91e2-4f514a914b97",
+          "interface_key": "rest_api:GET /workstreams/",
+          "interface_kind": "rest_api",
+          "legacy_since": "2026-06-04T00:26:14.533764Z",
+          "replacement_ref": "/workplans/",
+          "owner_component": "state-hub.api",
+          "status": "legacy",
+          "replacement_verified": true,
+          "manual_hold": false,
+          "hold_reason": null,
+          "notes": null,
+          "retired_at": null,
+          "created_at": "2026-06-04T00:26:14.533764Z",
+          "updated_at": "2026-06-04T00:26:14.533764Z"
+        },
+        "all_time": {
+          "calls": 144084,
+          "tenant_count": 1,
+          "user_count": 1,
+          "component_count": 1,
+          "tenants": {
+            "unknown": 144084
+          },
+          "users": {
+            "unknown": 144084
+          },
+          "components": {
+            "unknown": 144084
+          }
+        },
+        "window": {
+          "calls": 0,
+          "tenant_count": 0,
+          "user_count": 0,
+          "component_count": 0,
+          "tenants": {},
+          "users": {},
+          "components": {}
+        },
+        "last_seen_at": "2026-07-08T21:14:39.652776Z",
+        "retirement_candidate": true,
+        "retirement_reason": "no measured usage in review window"
+      },
+      {
+        "interface": {
+          "id": "e4c140ec-7479-46f9-b185-4b533f19d639",
+          "interface_key": "rest_api:GET /workstreams/workplan-index",
+          "interface_kind": "rest_api",
+          "legacy_since": "2026-06-04T05:20:58.321869Z",
+          "replacement_ref": "/workplans/index",
+          "owner_component": "state-hub.api",
+          "status": "legacy",
+          "replacement_verified": true,
+          "manual_hold": false,
+          "hold_reason": null,
+          "notes": null,
+          "retired_at": null,
+          "created_at": "2026-06-04T05:20:58.321869Z",
+          "updated_at": "2026-06-04T05:20:58.321869Z"
+        },
+        "all_time": {
+          "calls": 30,
+          "tenant_count": 1,
+          "user_count": 1,
+          "component_count": 1,
+          "tenants": {
+            "unknown": 30
+          },
+          "users": {
+            "unknown": 30
+          },
+          "components": {
+            "unknown": 30
+          }
+        },
+        "window": {
+          "calls": 0,
+          "tenant_count": 0,
+          "user_count": 0,
+          "component_count": 0,
+          "tenants": {},
+          "users": {},
+          "components": {}
+        },
+        "last_seen_at": "2026-07-03T05:20:34.534439Z",
+        "retirement_candidate": true,
+        "retirement_reason": "no measured usage in review window"
+      },
+      {
+        "interface": {
+          "id": "3a00b19e-e7db-4403-98aa-a77c9ab61ecc",
+          "interface_key": "rest_api:GET /workstreams/{workstream_id}",
+          "interface_kind": "rest_api",
+          "legacy_since": "2026-06-04T00:25:59.014966Z",
+          "replacement_ref": "/workplans/{workplan_id}",
+          "owner_component": "state-hub.api",
+          "status": "legacy",
+          "replacement_verified": true,
+          "manual_hold": false,
+          "hold_reason": null,
+          "notes": null,
+          "retired_at": null,
+          "created_at": "2026-06-04T00:25:59.014966Z",
+          "updated_at": "2026-06-04T00:25:59.014966Z"
+        },
+        "all_time": {
+          "calls": 511406,
+          "tenant_count": 1,
+          "user_count": 1,
+          "component_count": 1,
+          "tenants": {
+            "unknown": 511406
+          },
+          "users": {
+            "unknown": 511406
+          },
+          "components": {
+            "unknown": 511406
+          }
+        },
+        "window": {
+          "calls": 0,
+          "tenant_count": 0,
+          "user_count": 0,
+          "component_count": 0,
+          "tenants": {},
+          "users": {},
+          "components": {}
+        },
+        "last_seen_at": "2026-07-31T16:25:32.004042Z",
+        "retirement_candidate": true,
+        "retirement_reason": "no measured usage in review window"
+      },
+      {
+        "interface": {
+          "id": "69e1a255-a8b9-4101-8a68-b1bed23abfda",
+          "interface_key": "rest_api:GET /workstreams/{workstream_id}/dependencies/",
+          "interface_kind": "rest_api",
+          "legacy_since": "2026-06-04T00:25:59.291135Z",
+          "replacement_ref": "/workplans/{workplan_id}/dependencies/",
+          "owner_component": "state-hub.api",
+          "status": "legacy",
+          "replacement_verified": true,
+          "manual_hold": false,
+          "hold_reason": null,
+          "notes": null,
+          "retired_at": null,
+          "created_at": "2026-06-04T00:25:59.291135Z",
+          "updated_at": "2026-06-04T00:25:59.291135Z"
+        },
+        "all_time": {
+          "calls": 255865,
+          "tenant_count": 1,
+          "user_count": 1,
+          "component_count": 1,
+          "tenants": {
+            "unknown": 255865
+          },
+          "users": {
+            "unknown": 255865
+          },
+          "components": {
+            "unknown": 255865
+          }
+        },
+        "window": {
+          "calls": 0,
+          "tenant_count": 0,
+          "user_count": 0,
+          "component_count": 0,
+          "tenants": {},
+          "users": {},
+          "components": {}
+        },
+        "last_seen_at": "2026-07-08T21:14:12.747005Z",
+        "retirement_candidate": true,
+        "retirement_reason": "no measured usage in review window"
+      },
+      {
+        "interface": {
+          "id": "b1aae931-b51f-4a85-a723-865dd65f6132",
+          "interface_key": "rest_api:PATCH /workstreams/{workstream_id}",
+          "interface_kind": "rest_api",
+          "legacy_since": "2026-06-04T06:09:41.901035Z",
+          "replacement_ref": "/workplans/{workplan_id}",
+          "owner_component": "state-hub.api",
+          "status": "legacy",
+          "replacement_verified": true,
+          "manual_hold": false,
+          "hold_reason": null,
+          "notes": null,
+          "retired_at": null,
+          "created_at": "2026-06-04T06:09:41.901035Z",
+          "updated_at": "2026-06-04T06:09:41.901035Z"
+        },
+        "all_time": {
+          "calls": 571,
+          "tenant_count": 1,
+          "user_count": 1,
+          "component_count": 1,
+          "tenants": {
+            "unknown": 571
+          },
+          "users": {
+            "unknown": 571
+          },
+          "components": {
+            "unknown": 571
+          }
+        },
+        "window": {
+          "calls": 0,
+          "tenant_count": 0,
+          "user_count": 0,
+          "component_count": 0,
+          "tenants": {},
+          "users": {},
+          "components": {}
+        },
+        "last_seen_at": "2026-07-08T20:49:12.335710Z",
+        "retirement_candidate": true,
+        "retirement_reason": "no measured usage in review window"
+      },
+      {
+        "interface": {
+          "id": "4aea9591-970b-4918-ac4a-4da95a0a1a8c",
+          "interface_key": "rest_api:POST /decisions/ workstream_id",
+          "interface_kind": "rest_api",
+          "legacy_since": "2026-07-09T22:56:35.473130Z",
+          "replacement_ref": "POST /decisions/ with workplan_id",
+          "owner_component": "state-hub.api",
+          "status": "legacy",
+          "replacement_verified": true,
+          "manual_hold": false,
+          "hold_reason": null,
+          "notes": null,
+          "retired_at": null,
+          "created_at": "2026-07-09T22:56:35.473130Z",
+          "updated_at": "2026-07-09T22:56:35.473130Z"
+        },
+        "all_time": {
+          "calls": 3,
+          "tenant_count": 1,
+          "user_count": 1,
+          "component_count": 1,
+          "tenants": {
+            "unknown": 3
+          },
+          "users": {
+            "unknown": 3
+          },
+          "components": {
+            "unknown": 3
+          }
+        },
+        "window": {
+          "calls": 0,
+          "tenant_count": 0,
+          "user_count": 0,
+          "component_count": 0,
+          "tenants": {},
+          "users": {},
+          "components": {}
+        },
+        "last_seen_at": "2026-07-09T22:57:05.912456Z",
+        "retirement_candidate": true,
+        "retirement_reason": "no measured usage in review window"
+      },
+      {
+        "interface": {
+          "id": "4a70583c-1e41-4ec1-99a9-728856a7d79c",
+          "interface_key": "rest_api:POST /progress/ workstream_id",
+          "interface_kind": "rest_api",
+          "legacy_since": "2026-07-08T23:35:09.148333Z",
+          "replacement_ref": "POST /progress/ with workplan_id",
+          "owner_component": "state-hub.api",
+          "status": "legacy",
+          "replacement_verified": true,
+          "manual_hold": false,
+          "hold_reason": null,
+          "notes": null,
+          "retired_at": null,
+          "created_at": "2026-07-08T23:35:09.148333Z",
+          "updated_at": "2026-07-08T23:35:09.148333Z"
+        },
+        "all_time": {
+          "calls": 14,
+          "tenant_count": 1,
+          "user_count": 1,
+          "component_count": 1,
+          "tenants": {
+            "unknown": 14
+          },
+          "users": {
+            "unknown": 14
+          },
+          "components": {
+            "unknown": 14
+          }
+        },
+        "window": {
+          "calls": 0,
+          "tenant_count": 0,
+          "user_count": 0,
+          "component_count": 0,
+          "tenants": {},
+          "users": {},
+          "components": {}
+        },
+        "last_seen_at": "2026-07-10T08:34:42.959724Z",
+        "retirement_candidate": true,
+        "retirement_reason": "no measured usage in review window"
+      },
+      {
+        "interface": {
+          "id": "6df4e443-7bf1-461a-923b-a6eb52fe7b07",
+          "interface_key": "rest_api:POST /tasks/ workstream_id",
+          "interface_kind": "rest_api",
+          "legacy_since": "2026-07-08T22:38:29.405720Z",
+          "replacement_ref": "POST /tasks/ with workplan_id",
+          "owner_component": "state-hub.api",
+          "status": "legacy",
+          "replacement_verified": true,
+          "manual_hold": false,
+          "hold_reason": null,
+          "notes": null,
+          "retired_at": null,
+          "created_at": "2026-07-08T22:38:29.405720Z",
+          "updated_at": "2026-07-08T22:38:29.405720Z"
+        },
+        "all_time": {
+          "calls": 5,
+          "tenant_count": 1,
+          "user_count": 1,
+          "component_count": 1,
+          "tenants": {
+            "unknown": 5
+          },
+          "users": {
+            "unknown": 5
+          },
+          "components": {
+            "state-hub.fix-consistency": 5
+          }
+        },
+        "window": {
+          "calls": 0,
+          "tenant_count": 0,
+          "user_count": 0,
+          "component_count": 0,
+          "tenants": {},
+          "users": {},
+          "components": {}
+        },
+        "last_seen_at": "2026-07-08T22:38:29.976918Z",
+        "retirement_candidate": true,
+        "retirement_reason": "no measured usage in review window"
+      },
+      {
+        "interface": {
+          "id": "ed6451c9-d2cc-4486-9afe-d3852782cabc",
+          "interface_key": "rest_api:POST /workstreams/",
+          "interface_kind": "rest_api",
+          "legacy_since": "2026-06-04T07:40:24.168535Z",
+          "replacement_ref": "/workplans/",
+          "owner_component": "state-hub.api",
+          "status": "legacy",
+          "replacement_verified": true,
+          "manual_hold": false,
+          "hold_reason": null,
+          "notes": null,
+          "retired_at": null,
+          "created_at": "2026-06-04T07:40:24.168535Z",
+          "updated_at": "2026-06-04T07:40:24.168535Z"
+        },
+        "all_time": {
+          "calls": 824,
+          "tenant_count": 1,
+          "user_count": 1,
+          "component_count": 1,
+          "tenants": {
+            "unknown": 824
+          },
+          "users": {
+            "unknown": 824
+          },
+          "components": {
+            "unknown": 824
+          }
+        },
+        "window": {
+          "calls": 0,
+          "tenant_count": 0,
+          "user_count": 0,
+          "component_count": 0,
+          "tenants": {},
+          "users": {},
+          "components": {}
+        },
+        "last_seen_at": "2026-07-08T20:38:05.903144Z",
+        "retirement_candidate": true,
+        "retirement_reason": "no measured usage in review window"
+      },
+      {
+        "interface": {
+          "id": "281fd706-b192-4194-8055-2d8733c115f9",
+          "interface_key": "rest_api:POST /workstreams/{workstream_id}/dependencies/",
+          "interface_kind": "rest_api",
+          "legacy_since": "2026-06-04T22:57:37.149207Z",
+          "replacement_ref": "/workplans/{workplan_id}/dependencies/",
+          "owner_component": "state-hub.api",
+          "status": "legacy",
+          "replacement_verified": true,
+          "manual_hold": false,
+          "hold_reason": null,
+          "notes": null,
+          "retired_at": null,
+          "created_at": "2026-06-04T22:57:37.149207Z",
+          "updated_at": "2026-06-04T22:57:37.149207Z"
+        },
+        "all_time": {
+          "calls": 4971,
+          "tenant_count": 1,
+          "user_count": 1,
+          "component_count": 1,
+          "tenants": {
+            "unknown": 4971
+          },
+          "users": {
+            "unknown": 4971
+          },
+          "components": {
+            "unknown": 4971
+          }
+        },
+        "window": {
+          "calls": 0,
+          "tenant_count": 0,
+          "user_count": 0,
+          "component_count": 0,
+          "tenants": {},
+          "users": {},
+          "components": {}
+        },
+        "last_seen_at": "2026-07-01T22:09:24.229011Z",
+        "retirement_candidate": true,
+        "retirement_reason": "no measured usage in review window"
+      }
+    ]
+  },
+  "hours": 8
+}
diff --git a/docs/evidence/legacy-meter-weekly-review-20260805.json b/docs/evidence/legacy-meter-weekly-review-20260805.json
new file mode 100644
index 0000000..6b62724
--- /dev/null
+++ b/docs/evidence/legacy-meter-weekly-review-20260805.json
@@ -0,0 +1,1716 @@
+{
+  "captured_at": "2026-08-05T14:00:10.371576+00:00",
+  "api_base": "http://127.0.0.1:8000",
+  "workplan": "STATE-WP-0070",
+  "retired_interfaces": [],
+  "weekly_review": {
+    "generated_at": "2026-08-05T14:00:10.355278Z",
+    "window_start": "2026-08-05T06:00:09.692329Z",
+    "window_end": "2026-08-05T14:00:09.692329Z",
+    "cadence": "weekly",
+    "activity_core_handoff": {
+      "activity_id": "statehub-legacy-interface-review",
+      "cadence": "weekly",
+      "source_endpoint": "/legacy-meter/weekly-review",
+      "state_owner": "state-hub",
+      "scheduler_owner": "activity-core"
+    },
+    "interfaces": [
+      {
+        "interface": {
+          "id": "8051fb40-66c9-4dc4-a413-13e8573e04a3",
+          "interface_key": "event_subject:org.statehub.workstream.completed",
+          "interface_kind": "event_subject",
+          "legacy_since": "2026-06-04T06:09:42.198193Z",
+          "replacement_ref": "org.statehub.workplan.completed",
+          "owner_component": "state-hub.events",
+          "status": "retired",
+          "replacement_verified": true,
+          "manual_hold": false,
+          "hold_reason": null,
+          "notes": "Retired by STATE-WP-0069 closeout",
+          "retired_at": "2026-07-08T21:38:52.773601Z",
+          "created_at": "2026-06-04T06:09:42.198193Z",
+          "updated_at": "2026-07-08T21:38:52.761243Z"
+        },
+        "all_time": {
+          "calls": 255,
+          "tenant_count": 1,
+          "user_count": 1,
+          "component_count": 1,
+          "tenants": {
+            "unknown": 255
+          },
+          "users": {
+            "unknown": 255
+          },
+          "components": {
+            "state-hub.events": 255
+          }
+        },
+        "window": {
+          "calls": 0,
+          "tenant_count": 0,
+          "user_count": 0,
+          "component_count": 0,
+          "tenants": {},
+          "users": {},
+          "components": {}
+        },
+        "last_seen_at": "2026-07-08T20:49:12.839383Z",
+        "retirement_candidate": false,
+        "retirement_reason": "already retired"
+      },
+      {
+        "interface": {
+          "id": "63ed90e3-42b4-431a-94db-e1254a52f9e2",
+          "interface_key": "mcp:create_workstream",
+          "interface_kind": "mcp_tool",
+          "legacy_since": "2026-07-10T13:19:44.205900Z",
+          "replacement_ref": "create_workplan",
+          "owner_component": "state-hub.mcp",
+          "status": "legacy",
+          "replacement_verified": true,
+          "manual_hold": false,
+          "hold_reason": null,
+          "notes": "Registered by STATE-WP-0070 T03 \u2014 zero-window streak starts at registration",
+          "retired_at": null,
+          "created_at": "2026-07-10T13:19:44.205900Z",
+          "updated_at": "2026-07-10T13:19:44.205900Z"
+        },
+        "all_time": {
+          "calls": 2,
+          "tenant_count": 1,
+          "user_count": 1,
+          "component_count": 1,
+          "tenants": {
+            "unknown": 2
+          },
+          "users": {
+            "unknown": 2
+          },
+          "components": {
+            "state-hub.mcp": 2
+          }
+        },
+        "window": {
+          "calls": 0,
+          "tenant_count": 0,
+          "user_count": 0,
+          "component_count": 0,
+          "tenants": {},
+          "users": {},
+          "components": {}
+        },
+        "last_seen_at": "2026-07-10T13:20:43.378546Z",
+        "retirement_candidate": true,
+        "retirement_reason": "no measured usage in review window"
+      },
+      {
+        "interface": {
+          "id": "b6a5fe44-fb85-4ef7-a273-78d09da777af",
+          "interface_key": "mcp:list_workstreams",
+          "interface_kind": "mcp_tool",
+          "legacy_since": "2026-07-10T13:19:26.075491Z",
+          "replacement_ref": "list_workplans",
+          "owner_component": "state-hub.mcp",
+          "status": "legacy",
+          "replacement_verified": true,
+          "manual_hold": false,
+          "hold_reason": null,
+          "notes": null,
+          "retired_at": null,
+          "created_at": "2026-07-10T13:19:26.075491Z",
+          "updated_at": "2026-07-10T13:19:26.075491Z"
+        },
+        "all_time": {
+          "calls": 2,
+          "tenant_count": 1,
+          "user_count": 1,
+          "component_count": 1,
+          "tenants": {
+            "unknown": 2
+          },
+          "users": {
+            "unknown": 2
+          },
+          "components": {
+            "state-hub.mcp": 2
+          }
+        },
+        "window": {
+          "calls": 0,
+          "tenant_count": 0,
+          "user_count": 0,
+          "component_count": 0,
+          "tenants": {},
+          "users": {},
+          "components": {}
+        },
+        "last_seen_at": "2026-07-10T13:20:42.374940Z",
+        "retirement_candidate": true,
+        "retirement_reason": "no measured usage in review window"
+      },
+      {
+        "interface": {
+          "id": "53c3372b-307d-4d6a-8ea4-bc36cacdcaf2",
+          "interface_key": "mcp:update_workstream",
+          "interface_kind": "mcp_tool",
+          "legacy_since": "2026-07-10T13:19:44.255216Z",
+          "replacement_ref": "update_workplan",
+          "owner_component": "state-hub.mcp",
+          "status": "legacy",
+          "replacement_verified": true,
+          "manual_hold": false,
+          "hold_reason": null,
+          "notes": "Registered by STATE-WP-0070 T03 \u2014 zero-window streak starts at registration",
+          "retired_at": null,
+          "created_at": "2026-07-10T13:19:44.255216Z",
+          "updated_at": "2026-07-10T13:19:44.255216Z"
+        },
+        "all_time": {
+          "calls": 0,
+          "tenant_count": 0,
+          "user_count": 0,
+          "component_count": 0,
+          "tenants": {},
+          "users": {},
+          "components": {}
+        },
+        "window": {
+          "calls": 0,
+          "tenant_count": 0,
+          "user_count": 0,
+          "component_count": 0,
+          "tenants": {},
+          "users": {},
+          "components": {}
+        },
+        "last_seen_at": null,
+        "retirement_candidate": true,
+        "retirement_reason": "no measured usage in review window"
+      },
+      {
+        "interface": {
+          "id": "bed4d08a-3471-48f5-9f0e-f9d550383a26",
+          "interface_key": "mcp:update_workstream_status",
+          "interface_kind": "mcp_tool",
+          "legacy_since": "2026-07-10T13:19:44.303612Z",
+          "replacement_ref": "update_workplan_status",
+          "owner_component": "state-hub.mcp",
+          "status": "legacy",
+          "replacement_verified": true,
+          "manual_hold": false,
+          "hold_reason": null,
+          "notes": "Registered by STATE-WP-0070 T03 \u2014 zero-window streak starts at registration",
+          "retired_at": null,
+          "created_at": "2026-07-10T13:19:44.303612Z",
+          "updated_at": "2026-07-10T13:19:44.303612Z"
+        },
+        "all_time": {
+          "calls": 0,
+          "tenant_count": 0,
+          "user_count": 0,
+          "component_count": 0,
+          "tenants": {},
+          "users": {},
+          "components": {}
+        },
+        "window": {
+          "calls": 0,
+          "tenant_count": 0,
+          "user_count": 0,
+          "component_count": 0,
+          "tenants": {},
+          "users": {},
+          "components": {}
+        },
+        "last_seen_at": null,
+        "retirement_candidate": true,
+        "retirement_reason": "no measured usage in review window"
+      },
+      {
+        "interface": {
+          "id": "46900dc2-0893-405b-ba59-80f31fb6ebb1",
+          "interface_key": "state://workstreams/{topic_slug}",
+          "interface_kind": "mcp_tool",
+          "legacy_since": "2026-07-10T13:19:44.344493Z",
+          "replacement_ref": "state://workplans/{topic_slug}",
+          "owner_component": "state-hub.mcp",
+          "status": "legacy",
+          "replacement_verified": true,
+          "manual_hold": false,
+          "hold_reason": null,
+          "notes": "Registered by STATE-WP-0070 T03 \u2014 zero-window streak starts at registration",
+          "retired_at": null,
+          "created_at": "2026-07-10T13:19:44.344493Z",
+          "updated_at": "2026-07-10T13:19:44.344493Z"
+        },
+        "all_time": {
+          "calls": 1,
+          "tenant_count": 1,
+          "user_count": 1,
+          "component_count": 1,
+          "tenants": {
+            "unknown": 1
+          },
+          "users": {
+            "unknown": 1
+          },
+          "components": {
+            "state-hub.mcp": 1
+          }
+        },
+        "window": {
+          "calls": 0,
+          "tenant_count": 0,
+          "user_count": 0,
+          "component_count": 0,
+          "tenants": {},
+          "users": {},
+          "components": {}
+        },
+        "last_seen_at": "2026-07-10T13:20:34.491811Z",
+        "retirement_candidate": true,
+        "retirement_reason": "no measured usage in review window"
+      },
+      {
+        "interface": {
+          "id": "cd9342fd-27e7-4a46-a1be-d41499e106a3",
+          "interface_key": "rest_api:DELETE /workstreams/{workstream_id}",
+          "interface_kind": "rest_api",
+          "legacy_since": "2026-06-06T17:28:13.052813Z",
+          "replacement_ref": "/workplans/{workplan_id}",
+          "owner_component": "state-hub.api",
+          "status": "legacy",
+          "replacement_verified": true,
+          "manual_hold": false,
+          "hold_reason": null,
+          "notes": null,
+          "retired_at": null,
+          "created_at": "2026-06-06T17:28:13.052813Z",
+          "updated_at": "2026-06-06T17:28:13.052813Z"
+        },
+        "all_time": {
+          "calls": 1,
+          "tenant_count": 1,
+          "user_count": 1,
+          "component_count": 1,
+          "tenants": {
+            "unknown": 1
+          },
+          "users": {
+            "unknown": 1
+          },
+          "components": {
+            "unknown": 1
+          }
+        },
+        "window": {
+          "calls": 0,
+          "tenant_count": 0,
+          "user_count": 0,
+          "component_count": 0,
+          "tenants": {},
+          "users": {},
+          "components": {}
+        },
+        "last_seen_at": "2026-06-06T17:28:13.047529Z",
+        "retirement_candidate": true,
+        "retirement_reason": "no measured usage in review window"
+      },
+      {
+        "interface": {
+          "id": "a4e0948c-cd4a-461e-8ae2-7fd7b51d04a7",
+          "interface_key": "rest_api:GET /decisions/?workstream_id",
+          "interface_kind": "rest_api",
+          "legacy_since": "2026-07-09T23:07:53.093223Z",
+          "replacement_ref": "/decisions/?workplan_id=<workplan_id>",
+          "owner_component": "state-hub.api",
+          "status": "legacy",
+          "replacement_verified": true,
+          "manual_hold": false,
+          "hold_reason": null,
+          "notes": null,
+          "retired_at": null,
+          "created_at": "2026-07-09T23:07:53.093223Z",
+          "updated_at": "2026-07-09T23:07:53.093223Z"
+        },
+        "all_time": {
+          "calls": 1,
+          "tenant_count": 1,
+          "user_count": 1,
+          "component_count": 1,
+          "tenants": {
+            "unknown": 1
+          },
+          "users": {
+            "unknown": 1
+          },
+          "components": {
+            "unknown": 1
+          }
+        },
+        "window": {
+          "calls": 0,
+          "tenant_count": 0,
+          "user_count": 0,
+          "component_count": 0,
+          "tenants": {},
+          "users": {},
+          "components": {}
+        },
+        "last_seen_at": "2026-07-09T23:07:53.083299Z",
+        "retirement_candidate": true,
+        "retirement_reason": "no measured usage in review window"
+      },
+      {
+        "interface": {
+          "id": "70a9346e-e0ee-42ac-874f-f160580b54dd",
+          "interface_key": "rest_api:GET /progress/?workstream_id",
+          "interface_kind": "rest_api",
+          "legacy_since": "2026-07-13T22:04:03.911449Z",
+          "replacement_ref": "/progress/?workplan_id=<workplan_id>",
+          "owner_component": "state-hub.api",
+          "status": "legacy",
+          "replacement_verified": true,
+          "manual_hold": false,
+          "hold_reason": null,
+          "notes": null,
+          "retired_at": null,
+          "created_at": "2026-07-13T22:04:03.911449Z",
+          "updated_at": "2026-07-13T22:04:03.911449Z"
+        },
+        "all_time": {
+          "calls": 1,
+          "tenant_count": 1,
+          "user_count": 1,
+          "component_count": 1,
+          "tenants": {
+            "unknown": 1
+          },
+          "users": {
+            "unknown": 1
+          },
+          "components": {
+            "unknown": 1
+          }
+        },
+        "window": {
+          "calls": 0,
+          "tenant_count": 0,
+          "user_count": 0,
+          "component_count": 0,
+          "tenants": {},
+          "users": {},
+          "components": {}
+        },
+        "last_seen_at": "2026-07-13T22:04:03.904998Z",
+        "retirement_candidate": true,
+        "retirement_reason": "no measured usage in review window"
+      },
+      {
+        "interface": {
+          "id": "be3cdcf8-250b-4bf0-801f-02ffd5f57e00",
+          "interface_key": "rest_api:GET /tasks/?workstream_id",
+          "interface_kind": "rest_api",
+          "legacy_since": "2026-07-08T19:32:21.628513Z",
+          "replacement_ref": "/tasks/?workplan_id=<workplan_id>",
+          "owner_component": "state-hub.api",
+          "status": "legacy",
+          "replacement_verified": true,
+          "manual_hold": false,
+          "hold_reason": null,
+          "notes": null,
+          "retired_at": null,
+          "created_at": "2026-07-08T19:32:21.628513Z",
+          "updated_at": "2026-07-08T19:32:21.628513Z"
+        },
+        "all_time": {
+          "calls": 589,
+          "tenant_count": 1,
+          "user_count": 1,
+          "component_count": 1,
+          "tenants": {
+            "unknown": 589
+          },
+          "users": {
+            "unknown": 589
+          },
+          "components": {
+            "unknown": 589
+          }
+        },
+        "window": {
+          "calls": 0,
+          "tenant_count": 0,
+          "user_count": 0,
+          "component_count": 0,
+          "tenants": {},
+          "users": {},
+          "components": {}
+        },
+        "last_seen_at": "2026-07-31T16:25:32.181901Z",
+        "retirement_candidate": true,
+        "retirement_reason": "no measured usage in review window"
+      },
+      {
+        "interface": {
+          "id": "3e4a3d0b-08fa-45c3-91e2-4f514a914b97",
+          "interface_key": "rest_api:GET /workstreams/",
+          "interface_kind": "rest_api",
+          "legacy_since": "2026-06-04T00:26:14.533764Z",
+          "replacement_ref": "/workplans/",
+          "owner_component": "state-hub.api",
+          "status": "legacy",
+          "replacement_verified": true,
+          "manual_hold": false,
+          "hold_reason": null,
+          "notes": null,
+          "retired_at": null,
+          "created_at": "2026-06-04T00:26:14.533764Z",
+          "updated_at": "2026-06-04T00:26:14.533764Z"
+        },
+        "all_time": {
+          "calls": 144085,
+          "tenant_count": 1,
+          "user_count": 1,
+          "component_count": 1,
+          "tenants": {
+            "unknown": 144085
+          },
+          "users": {
+            "unknown": 144085
+          },
+          "components": {
+            "unknown": 144085
+          }
+        },
+        "window": {
+          "calls": 1,
+          "tenant_count": 1,
+          "user_count": 1,
+          "component_count": 1,
+          "tenants": {
+            "unknown": 1
+          },
+          "users": {
+            "unknown": 1
+          },
+          "components": {
+            "unknown": 1
+          }
+        },
+        "last_seen_at": "2026-08-05T13:01:38.000781Z",
+        "retirement_candidate": false,
+        "retirement_reason": "1 call(s) in review window"
+      },
+      {
+        "interface": {
+          "id": "e4c140ec-7479-46f9-b185-4b533f19d639",
+          "interface_key": "rest_api:GET /workstreams/workplan-index",
+          "interface_kind": "rest_api",
+          "legacy_since": "2026-06-04T05:20:58.321869Z",
+          "replacement_ref": "/workplans/index",
+          "owner_component": "state-hub.api",
+          "status": "legacy",
+          "replacement_verified": true,
+          "manual_hold": false,
+          "hold_reason": null,
+          "notes": null,
+          "retired_at": null,
+          "created_at": "2026-06-04T05:20:58.321869Z",
+          "updated_at": "2026-06-04T05:20:58.321869Z"
+        },
+        "all_time": {
+          "calls": 30,
+          "tenant_count": 1,
+          "user_count": 1,
+          "component_count": 1,
+          "tenants": {
+            "unknown": 30
+          },
+          "users": {
+            "unknown": 30
+          },
+          "components": {
+            "unknown": 30
+          }
+        },
+        "window": {
+          "calls": 0,
+          "tenant_count": 0,
+          "user_count": 0,
+          "component_count": 0,
+          "tenants": {},
+          "users": {},
+          "components": {}
+        },
+        "last_seen_at": "2026-07-03T05:20:34.534439Z",
+        "retirement_candidate": true,
+        "retirement_reason": "no measured usage in review window"
+      },
+      {
+        "interface": {
+          "id": "3a00b19e-e7db-4403-98aa-a77c9ab61ecc",
+          "interface_key": "rest_api:GET /workstreams/{workstream_id}",
+          "interface_kind": "rest_api",
+          "legacy_since": "2026-06-04T00:25:59.014966Z",
+          "replacement_ref": "/workplans/{workplan_id}",
+          "owner_component": "state-hub.api",
+          "status": "legacy",
+          "replacement_verified": true,
+          "manual_hold": false,
+          "hold_reason": null,
+          "notes": null,
+          "retired_at": null,
+          "created_at": "2026-06-04T00:25:59.014966Z",
+          "updated_at": "2026-06-04T00:25:59.014966Z"
+        },
+        "all_time": {
+          "calls": 511406,
+          "tenant_count": 1,
+          "user_count": 1,
+          "component_count": 1,
+          "tenants": {
+            "unknown": 511406
+          },
+          "users": {
+            "unknown": 511406
+          },
+          "components": {
+            "unknown": 511406
+          }
+        },
+        "window": {
+          "calls": 0,
+          "tenant_count": 0,
+          "user_count": 0,
+          "component_count": 0,
+          "tenants": {},
+          "users": {},
+          "components": {}
+        },
+        "last_seen_at": "2026-07-31T16:25:32.004042Z",
+        "retirement_candidate": true,
+        "retirement_reason": "no measured usage in review window"
+      },
+      {
+        "interface": {
+          "id": "69e1a255-a8b9-4101-8a68-b1bed23abfda",
+          "interface_key": "rest_api:GET /workstreams/{workstream_id}/dependencies/",
+          "interface_kind": "rest_api",
+          "legacy_since": "2026-06-04T00:25:59.291135Z",
+          "replacement_ref": "/workplans/{workplan_id}/dependencies/",
+          "owner_component": "state-hub.api",
+          "status": "legacy",
+          "replacement_verified": true,
+          "manual_hold": false,
+          "hold_reason": null,
+          "notes": null,
+          "retired_at": null,
+          "created_at": "2026-06-04T00:25:59.291135Z",
+          "updated_at": "2026-06-04T00:25:59.291135Z"
+        },
+        "all_time": {
+          "calls": 255865,
+          "tenant_count": 1,
+          "user_count": 1,
+          "component_count": 1,
+          "tenants": {
+            "unknown": 255865
+          },
+          "users": {
+            "unknown": 255865
+          },
+          "components": {
+            "unknown": 255865
+          }
+        },
+        "window": {
+          "calls": 0,
+          "tenant_count": 0,
+          "user_count": 0,
+          "component_count": 0,
+          "tenants": {},
+          "users": {},
+          "components": {}
+        },
+        "last_seen_at": "2026-07-08T21:14:12.747005Z",
+        "retirement_candidate": true,
+        "retirement_reason": "no measured usage in review window"
+      },
+      {
+        "interface": {
+          "id": "b1aae931-b51f-4a85-a723-865dd65f6132",
+          "interface_key": "rest_api:PATCH /workstreams/{workstream_id}",
+          "interface_kind": "rest_api",
+          "legacy_since": "2026-06-04T06:09:41.901035Z",
+          "replacement_ref": "/workplans/{workplan_id}",
+          "owner_component": "state-hub.api",
+          "status": "legacy",
+          "replacement_verified": true,
+          "manual_hold": false,
+          "hold_reason": null,
+          "notes": null,
+          "retired_at": null,
+          "created_at": "2026-06-04T06:09:41.901035Z",
+          "updated_at": "2026-06-04T06:09:41.901035Z"
+        },
+        "all_time": {
+          "calls": 571,
+          "tenant_count": 1,
+          "user_count": 1,
+          "component_count": 1,
+          "tenants": {
+            "unknown": 571
+          },
+          "users": {
+            "unknown": 571
+          },
+          "components": {
+            "unknown": 571
+          }
+        },
+        "window": {
+          "calls": 0,
+          "tenant_count": 0,
+          "user_count": 0,
+          "component_count": 0,
+          "tenants": {},
+          "users": {},
+          "components": {}
+        },
+        "last_seen_at": "2026-07-08T20:49:12.335710Z",
+        "retirement_candidate": true,
+        "retirement_reason": "no measured usage in review window"
+      },
+      {
+        "interface": {
+          "id": "4aea9591-970b-4918-ac4a-4da95a0a1a8c",
+          "interface_key": "rest_api:POST /decisions/ workstream_id",
+          "interface_kind": "rest_api",
+          "legacy_since": "2026-07-09T22:56:35.473130Z",
+          "replacement_ref": "POST /decisions/ with workplan_id",
+          "owner_component": "state-hub.api",
+          "status": "legacy",
+          "replacement_verified": true,
+          "manual_hold": false,
+          "hold_reason": null,
+          "notes": null,
+          "retired_at": null,
+          "created_at": "2026-07-09T22:56:35.473130Z",
+          "updated_at": "2026-07-09T22:56:35.473130Z"
+        },
+        "all_time": {
+          "calls": 3,
+          "tenant_count": 1,
+          "user_count": 1,
+          "component_count": 1,
+          "tenants": {
+            "unknown": 3
+          },
+          "users": {
+            "unknown": 3
+          },
+          "components": {
+            "unknown": 3
+          }
+        },
+        "window": {
+          "calls": 0,
+          "tenant_count": 0,
+          "user_count": 0,
+          "component_count": 0,
+          "tenants": {},
+          "users": {},
+          "components": {}
+        },
+        "last_seen_at": "2026-07-09T22:57:05.912456Z",
+        "retirement_candidate": true,
+        "retirement_reason": "no measured usage in review window"
+      },
+      {
+        "interface": {
+          "id": "4a70583c-1e41-4ec1-99a9-728856a7d79c",
+          "interface_key": "rest_api:POST /progress/ workstream_id",
+          "interface_kind": "rest_api",
+          "legacy_since": "2026-07-08T23:35:09.148333Z",
+          "replacement_ref": "POST /progress/ with workplan_id",
+          "owner_component": "state-hub.api",
+          "status": "legacy",
+          "replacement_verified": true,
+          "manual_hold": false,
+          "hold_reason": null,
+          "notes": null,
+          "retired_at": null,
+          "created_at": "2026-07-08T23:35:09.148333Z",
+          "updated_at": "2026-07-08T23:35:09.148333Z"
+        },
+        "all_time": {
+          "calls": 14,
+          "tenant_count": 1,
+          "user_count": 1,
+          "component_count": 1,
+          "tenants": {
+            "unknown": 14
+          },
+          "users": {
+            "unknown": 14
+          },
+          "components": {
+            "unknown": 14
+          }
+        },
+        "window": {
+          "calls": 0,
+          "tenant_count": 0,
+          "user_count": 0,
+          "component_count": 0,
+          "tenants": {},
+          "users": {},
+          "components": {}
+        },
+        "last_seen_at": "2026-07-10T08:34:42.959724Z",
+        "retirement_candidate": true,
+        "retirement_reason": "no measured usage in review window"
+      },
+      {
+        "interface": {
+          "id": "6df4e443-7bf1-461a-923b-a6eb52fe7b07",
+          "interface_key": "rest_api:POST /tasks/ workstream_id",
+          "interface_kind": "rest_api",
+          "legacy_since": "2026-07-08T22:38:29.405720Z",
+          "replacement_ref": "POST /tasks/ with workplan_id",
+          "owner_component": "state-hub.api",
+          "status": "legacy",
+          "replacement_verified": true,
+          "manual_hold": false,
+          "hold_reason": null,
+          "notes": null,
+          "retired_at": null,
+          "created_at": "2026-07-08T22:38:29.405720Z",
+          "updated_at": "2026-07-08T22:38:29.405720Z"
+        },
+        "all_time": {
+          "calls": 5,
+          "tenant_count": 1,
+          "user_count": 1,
+          "component_count": 1,
+          "tenants": {
+            "unknown": 5
+          },
+          "users": {
+            "unknown": 5
+          },
+          "components": {
+            "state-hub.fix-consistency": 5
+          }
+        },
+        "window": {
+          "calls": 0,
+          "tenant_count": 0,
+          "user_count": 0,
+          "component_count": 0,
+          "tenants": {},
+          "users": {},
+          "components": {}
+        },
+        "last_seen_at": "2026-07-08T22:38:29.976918Z",
+        "retirement_candidate": true,
+        "retirement_reason": "no measured usage in review window"
+      },
+      {
+        "interface": {
+          "id": "ed6451c9-d2cc-4486-9afe-d3852782cabc",
+          "interface_key": "rest_api:POST /workstreams/",
+          "interface_kind": "rest_api",
+          "legacy_since": "2026-06-04T07:40:24.168535Z",
+          "replacement_ref": "/workplans/",
+          "owner_component": "state-hub.api",
+          "status": "legacy",
+          "replacement_verified": true,
+          "manual_hold": false,
+          "hold_reason": null,
+          "notes": null,
+          "retired_at": null,
+          "created_at": "2026-06-04T07:40:24.168535Z",
+          "updated_at": "2026-06-04T07:40:24.168535Z"
+        },
+        "all_time": {
+          "calls": 824,
+          "tenant_count": 1,
+          "user_count": 1,
+          "component_count": 1,
+          "tenants": {
+            "unknown": 824
+          },
+          "users": {
+            "unknown": 824
+          },
+          "components": {
+            "unknown": 824
+          }
+        },
+        "window": {
+          "calls": 0,
+          "tenant_count": 0,
+          "user_count": 0,
+          "component_count": 0,
+          "tenants": {},
+          "users": {},
+          "components": {}
+        },
+        "last_seen_at": "2026-07-08T20:38:05.903144Z",
+        "retirement_candidate": true,
+        "retirement_reason": "no measured usage in review window"
+      },
+      {
+        "interface": {
+          "id": "281fd706-b192-4194-8055-2d8733c115f9",
+          "interface_key": "rest_api:POST /workstreams/{workstream_id}/dependencies/",
+          "interface_kind": "rest_api",
+          "legacy_since": "2026-06-04T22:57:37.149207Z",
+          "replacement_ref": "/workplans/{workplan_id}/dependencies/",
+          "owner_component": "state-hub.api",
+          "status": "legacy",
+          "replacement_verified": true,
+          "manual_hold": false,
+          "hold_reason": null,
+          "notes": null,
+          "retired_at": null,
+          "created_at": "2026-06-04T22:57:37.149207Z",
+          "updated_at": "2026-06-04T22:57:37.149207Z"
+        },
+        "all_time": {
+          "calls": 4971,
+          "tenant_count": 1,
+          "user_count": 1,
+          "component_count": 1,
+          "tenants": {
+            "unknown": 4971
+          },
+          "users": {
+            "unknown": 4971
+          },
+          "components": {
+            "unknown": 4971
+          }
+        },
+        "window": {
+          "calls": 0,
+          "tenant_count": 0,
+          "user_count": 0,
+          "component_count": 0,
+          "tenants": {},
+          "users": {},
+          "components": {}
+        },
+        "last_seen_at": "2026-07-01T22:09:24.229011Z",
+        "retirement_candidate": true,
+        "retirement_reason": "no measured usage in review window"
+      }
+    ],
+    "retirement_candidates": [
+      {
+        "interface": {
+          "id": "63ed90e3-42b4-431a-94db-e1254a52f9e2",
+          "interface_key": "mcp:create_workstream",
+          "interface_kind": "mcp_tool",
+          "legacy_since": "2026-07-10T13:19:44.205900Z",
+          "replacement_ref": "create_workplan",
+          "owner_component": "state-hub.mcp",
+          "status": "legacy",
+          "replacement_verified": true,
+          "manual_hold": false,
+          "hold_reason": null,
+          "notes": "Registered by STATE-WP-0070 T03 \u2014 zero-window streak starts at registration",
+          "retired_at": null,
+          "created_at": "2026-07-10T13:19:44.205900Z",
+          "updated_at": "2026-07-10T13:19:44.205900Z"
+        },
+        "all_time": {
+          "calls": 2,
+          "tenant_count": 1,
+          "user_count": 1,
+          "component_count": 1,
+          "tenants": {
+            "unknown": 2
+          },
+          "users": {
+            "unknown": 2
+          },
+          "components": {
+            "state-hub.mcp": 2
+          }
+        },
+        "window": {
+          "calls": 0,
+          "tenant_count": 0,
+          "user_count": 0,
+          "component_count": 0,
+          "tenants": {},
+          "users": {},
+          "components": {}
+        },
+        "last_seen_at": "2026-07-10T13:20:43.378546Z",
+        "retirement_candidate": true,
+        "retirement_reason": "no measured usage in review window"
+      },
+      {
+        "interface": {
+          "id": "b6a5fe44-fb85-4ef7-a273-78d09da777af",
+          "interface_key": "mcp:list_workstreams",
+          "interface_kind": "mcp_tool",
+          "legacy_since": "2026-07-10T13:19:26.075491Z",
+          "replacement_ref": "list_workplans",
+          "owner_component": "state-hub.mcp",
+          "status": "legacy",
+          "replacement_verified": true,
+          "manual_hold": false,
+          "hold_reason": null,
+          "notes": null,
+          "retired_at": null,
+          "created_at": "2026-07-10T13:19:26.075491Z",
+          "updated_at": "2026-07-10T13:19:26.075491Z"
+        },
+        "all_time": {
+          "calls": 2,
+          "tenant_count": 1,
+          "user_count": 1,
+          "component_count": 1,
+          "tenants": {
+            "unknown": 2
+          },
+          "users": {
+            "unknown": 2
+          },
+          "components": {
+            "state-hub.mcp": 2
+          }
+        },
+        "window": {
+          "calls": 0,
+          "tenant_count": 0,
+          "user_count": 0,
+          "component_count": 0,
+          "tenants": {},
+          "users": {},
+          "components": {}
+        },
+        "last_seen_at": "2026-07-10T13:20:42.374940Z",
+        "retirement_candidate": true,
+        "retirement_reason": "no measured usage in review window"
+      },
+      {
+        "interface": {
+          "id": "53c3372b-307d-4d6a-8ea4-bc36cacdcaf2",
+          "interface_key": "mcp:update_workstream",
+          "interface_kind": "mcp_tool",
+          "legacy_since": "2026-07-10T13:19:44.255216Z",
+          "replacement_ref": "update_workplan",
+          "owner_component": "state-hub.mcp",
+          "status": "legacy",
+          "replacement_verified": true,
+          "manual_hold": false,
+          "hold_reason": null,
+          "notes": "Registered by STATE-WP-0070 T03 \u2014 zero-window streak starts at registration",
+          "retired_at": null,
+          "created_at": "2026-07-10T13:19:44.255216Z",
+          "updated_at": "2026-07-10T13:19:44.255216Z"
+        },
+        "all_time": {
+          "calls": 0,
+          "tenant_count": 0,
+          "user_count": 0,
+          "component_count": 0,
+          "tenants": {},
+          "users": {},
+          "components": {}
+        },
+        "window": {
+          "calls": 0,
+          "tenant_count": 0,
+          "user_count": 0,
+          "component_count": 0,
+          "tenants": {},
+          "users": {},
+          "components": {}
+        },
+        "last_seen_at": null,
+        "retirement_candidate": true,
+        "retirement_reason": "no measured usage in review window"
+      },
+      {
+        "interface": {
+          "id": "bed4d08a-3471-48f5-9f0e-f9d550383a26",
+          "interface_key": "mcp:update_workstream_status",
+          "interface_kind": "mcp_tool",
+          "legacy_since": "2026-07-10T13:19:44.303612Z",
+          "replacement_ref": "update_workplan_status",
+          "owner_component": "state-hub.mcp",
+          "status": "legacy",
+          "replacement_verified": true,
+          "manual_hold": false,
+          "hold_reason": null,
+          "notes": "Registered by STATE-WP-0070 T03 \u2014 zero-window streak starts at registration",
+          "retired_at": null,
+          "created_at": "2026-07-10T13:19:44.303612Z",
+          "updated_at": "2026-07-10T13:19:44.303612Z"
+        },
+        "all_time": {
+          "calls": 0,
+          "tenant_count": 0,
+          "user_count": 0,
+          "component_count": 0,
+          "tenants": {},
+          "users": {},
+          "components": {}
+        },
+        "window": {
+          "calls": 0,
+          "tenant_count": 0,
+          "user_count": 0,
+          "component_count": 0,
+          "tenants": {},
+          "users": {},
+          "components": {}
+        },
+        "last_seen_at": null,
+        "retirement_candidate": true,
+        "retirement_reason": "no measured usage in review window"
+      },
+      {
+        "interface": {
+          "id": "46900dc2-0893-405b-ba59-80f31fb6ebb1",
+          "interface_key": "state://workstreams/{topic_slug}",
+          "interface_kind": "mcp_tool",
+          "legacy_since": "2026-07-10T13:19:44.344493Z",
+          "replacement_ref": "state://workplans/{topic_slug}",
+          "owner_component": "state-hub.mcp",
+          "status": "legacy",
+          "replacement_verified": true,
+          "manual_hold": false,
+          "hold_reason": null,
+          "notes": "Registered by STATE-WP-0070 T03 \u2014 zero-window streak starts at registration",
+          "retired_at": null,
+          "created_at": "2026-07-10T13:19:44.344493Z",
+          "updated_at": "2026-07-10T13:19:44.344493Z"
+        },
+        "all_time": {
+          "calls": 1,
+          "tenant_count": 1,
+          "user_count": 1,
+          "component_count": 1,
+          "tenants": {
+            "unknown": 1
+          },
+          "users": {
+            "unknown": 1
+          },
+          "components": {
+            "state-hub.mcp": 1
+          }
+        },
+        "window": {
+          "calls": 0,
+          "tenant_count": 0,
+          "user_count": 0,
+          "component_count": 0,
+          "tenants": {},
+          "users": {},
+          "components": {}
+        },
+        "last_seen_at": "2026-07-10T13:20:34.491811Z",
+        "retirement_candidate": true,
+        "retirement_reason": "no measured usage in review window"
+      },
+      {
+        "interface": {
+          "id": "cd9342fd-27e7-4a46-a1be-d41499e106a3",
+          "interface_key": "rest_api:DELETE /workstreams/{workstream_id}",
+          "interface_kind": "rest_api",
+          "legacy_since": "2026-06-06T17:28:13.052813Z",
+          "replacement_ref": "/workplans/{workplan_id}",
+          "owner_component": "state-hub.api",
+          "status": "legacy",
+          "replacement_verified": true,
+          "manual_hold": false,
+          "hold_reason": null,
+          "notes": null,
+          "retired_at": null,
+          "created_at": "2026-06-06T17:28:13.052813Z",
+          "updated_at": "2026-06-06T17:28:13.052813Z"
+        },
+        "all_time": {
+          "calls": 1,
+          "tenant_count": 1,
+          "user_count": 1,
+          "component_count": 1,
+          "tenants": {
+            "unknown": 1
+          },
+          "users": {
+            "unknown": 1
+          },
+          "components": {
+            "unknown": 1
+          }
+        },
+        "window": {
+          "calls": 0,
+          "tenant_count": 0,
+          "user_count": 0,
+          "component_count": 0,
+          "tenants": {},
+          "users": {},
+          "components": {}
+        },
+        "last_seen_at": "2026-06-06T17:28:13.047529Z",
+        "retirement_candidate": true,
+        "retirement_reason": "no measured usage in review window"
+      },
+      {
+        "interface": {
+          "id": "a4e0948c-cd4a-461e-8ae2-7fd7b51d04a7",
+          "interface_key": "rest_api:GET /decisions/?workstream_id",
+          "interface_kind": "rest_api",
+          "legacy_since": "2026-07-09T23:07:53.093223Z",
+          "replacement_ref": "/decisions/?workplan_id=<workplan_id>",
+          "owner_component": "state-hub.api",
+          "status": "legacy",
+          "replacement_verified": true,
+          "manual_hold": false,
+          "hold_reason": null,
+          "notes": null,
+          "retired_at": null,
+          "created_at": "2026-07-09T23:07:53.093223Z",
+          "updated_at": "2026-07-09T23:07:53.093223Z"
+        },
+        "all_time": {
+          "calls": 1,
+          "tenant_count": 1,
+          "user_count": 1,
+          "component_count": 1,
+          "tenants": {
+            "unknown": 1
+          },
+          "users": {
+            "unknown": 1
+          },
+          "components": {
+            "unknown": 1
+          }
+        },
+        "window": {
+          "calls": 0,
+          "tenant_count": 0,
+          "user_count": 0,
+          "component_count": 0,
+          "tenants": {},
+          "users": {},
+          "components": {}
+        },
+        "last_seen_at": "2026-07-09T23:07:53.083299Z",
+        "retirement_candidate": true,
+        "retirement_reason": "no measured usage in review window"
+      },
+      {
+        "interface": {
+          "id": "70a9346e-e0ee-42ac-874f-f160580b54dd",
+          "interface_key": "rest_api:GET /progress/?workstream_id",
+          "interface_kind": "rest_api",
+          "legacy_since": "2026-07-13T22:04:03.911449Z",
+          "replacement_ref": "/progress/?workplan_id=<workplan_id>",
+          "owner_component": "state-hub.api",
+          "status": "legacy",
+          "replacement_verified": true,
+          "manual_hold": false,
+          "hold_reason": null,
+          "notes": null,
+          "retired_at": null,
+          "created_at": "2026-07-13T22:04:03.911449Z",
+          "updated_at": "2026-07-13T22:04:03.911449Z"
+        },
+        "all_time": {
+          "calls": 1,
+          "tenant_count": 1,
+          "user_count": 1,
+          "component_count": 1,
+          "tenants": {
+            "unknown": 1
+          },
+          "users": {
+            "unknown": 1
+          },
+          "components": {
+            "unknown": 1
+          }
+        },
+        "window": {
+          "calls": 0,
+          "tenant_count": 0,
+          "user_count": 0,
+          "component_count": 0,
+          "tenants": {},
+          "users": {},
+          "components": {}
+        },
+        "last_seen_at": "2026-07-13T22:04:03.904998Z",
+        "retirement_candidate": true,
+        "retirement_reason": "no measured usage in review window"
+      },
+      {
+        "interface": {
+          "id": "be3cdcf8-250b-4bf0-801f-02ffd5f57e00",
+          "interface_key": "rest_api:GET /tasks/?workstream_id",
+          "interface_kind": "rest_api",
+          "legacy_since": "2026-07-08T19:32:21.628513Z",
+          "replacement_ref": "/tasks/?workplan_id=<workplan_id>",
+          "owner_component": "state-hub.api",
+          "status": "legacy",
+          "replacement_verified": true,
+          "manual_hold": false,
+          "hold_reason": null,
+          "notes": null,
+          "retired_at": null,
+          "created_at": "2026-07-08T19:32:21.628513Z",
+          "updated_at": "2026-07-08T19:32:21.628513Z"
+        },
+        "all_time": {
+          "calls": 589,
+          "tenant_count": 1,
+          "user_count": 1,
+          "component_count": 1,
+          "tenants": {
+            "unknown": 589
+          },
+          "users": {
+            "unknown": 589
+          },
+          "components": {
+            "unknown": 589
+          }
+        },
+        "window": {
+          "calls": 0,
+          "tenant_count": 0,
+          "user_count": 0,
+          "component_count": 0,
+          "tenants": {},
+          "users": {},
+          "components": {}
+        },
+        "last_seen_at": "2026-07-31T16:25:32.181901Z",
+        "retirement_candidate": true,
+        "retirement_reason": "no measured usage in review window"
+      },
+      {
+        "interface": {
+          "id": "e4c140ec-7479-46f9-b185-4b533f19d639",
+          "interface_key": "rest_api:GET /workstreams/workplan-index",
+          "interface_kind": "rest_api",
+          "legacy_since": "2026-06-04T05:20:58.321869Z",
+          "replacement_ref": "/workplans/index",
+          "owner_component": "state-hub.api",
+          "status": "legacy",
+          "replacement_verified": true,
+          "manual_hold": false,
+          "hold_reason": null,
+          "notes": null,
+          "retired_at": null,
+          "created_at": "2026-06-04T05:20:58.321869Z",
+          "updated_at": "2026-06-04T05:20:58.321869Z"
+        },
+        "all_time": {
+          "calls": 30,
+          "tenant_count": 1,
+          "user_count": 1,
+          "component_count": 1,
+          "tenants": {
+            "unknown": 30
+          },
+          "users": {
+            "unknown": 30
+          },
+          "components": {
+            "unknown": 30
+          }
+        },
+        "window": {
+          "calls": 0,
+          "tenant_count": 0,
+          "user_count": 0,
+          "component_count": 0,
+          "tenants": {},
+          "users": {},
+          "components": {}
+        },
+        "last_seen_at": "2026-07-03T05:20:34.534439Z",
+        "retirement_candidate": true,
+        "retirement_reason": "no measured usage in review window"
+      },
+      {
+        "interface": {
+          "id": "3a00b19e-e7db-4403-98aa-a77c9ab61ecc",
+          "interface_key": "rest_api:GET /workstreams/{workstream_id}",
+          "interface_kind": "rest_api",
+          "legacy_since": "2026-06-04T00:25:59.014966Z",
+          "replacement_ref": "/workplans/{workplan_id}",
+          "owner_component": "state-hub.api",
+          "status": "legacy",
+          "replacement_verified": true,
+          "manual_hold": false,
+          "hold_reason": null,
+          "notes": null,
+          "retired_at": null,
+          "created_at": "2026-06-04T00:25:59.014966Z",
+          "updated_at": "2026-06-04T00:25:59.014966Z"
+        },
+        "all_time": {
+          "calls": 511406,
+          "tenant_count": 1,
+          "user_count": 1,
+          "component_count": 1,
+          "tenants": {
+            "unknown": 511406
+          },
+          "users": {
+            "unknown": 511406
+          },
+          "components": {
+            "unknown": 511406
+          }
+        },
+        "window": {
+          "calls": 0,
+          "tenant_count": 0,
+          "user_count": 0,
+          "component_count": 0,
+          "tenants": {},
+          "users": {},
+          "components": {}
+        },
+        "last_seen_at": "2026-07-31T16:25:32.004042Z",
+        "retirement_candidate": true,
+        "retirement_reason": "no measured usage in review window"
+      },
+      {
+        "interface": {
+          "id": "69e1a255-a8b9-4101-8a68-b1bed23abfda",
+          "interface_key": "rest_api:GET /workstreams/{workstream_id}/dependencies/",
+          "interface_kind": "rest_api",
+          "legacy_since": "2026-06-04T00:25:59.291135Z",
+          "replacement_ref": "/workplans/{workplan_id}/dependencies/",
+          "owner_component": "state-hub.api",
+          "status": "legacy",
+          "replacement_verified": true,
+          "manual_hold": false,
+          "hold_reason": null,
+          "notes": null,
+          "retired_at": null,
+          "created_at": "2026-06-04T00:25:59.291135Z",
+          "updated_at": "2026-06-04T00:25:59.291135Z"
+        },
+        "all_time": {
+          "calls": 255865,
+          "tenant_count": 1,
+          "user_count": 1,
+          "component_count": 1,
+          "tenants": {
+            "unknown": 255865
+          },
+          "users": {
+            "unknown": 255865
+          },
+          "components": {
+            "unknown": 255865
+          }
+        },
+        "window": {
+          "calls": 0,
+          "tenant_count": 0,
+          "user_count": 0,
+          "component_count": 0,
+          "tenants": {},
+          "users": {},
+          "components": {}
+        },
+        "last_seen_at": "2026-07-08T21:14:12.747005Z",
+        "retirement_candidate": true,
+        "retirement_reason": "no measured usage in review window"
+      },
+      {
+        "interface": {
+          "id": "b1aae931-b51f-4a85-a723-865dd65f6132",
+          "interface_key": "rest_api:PATCH /workstreams/{workstream_id}",
+          "interface_kind": "rest_api",
+          "legacy_since": "2026-06-04T06:09:41.901035Z",
+          "replacement_ref": "/workplans/{workplan_id}",
+          "owner_component": "state-hub.api",
+          "status": "legacy",
+          "replacement_verified": true,
+          "manual_hold": false,
+          "hold_reason": null,
+          "notes": null,
+          "retired_at": null,
+          "created_at": "2026-06-04T06:09:41.901035Z",
+          "updated_at": "2026-06-04T06:09:41.901035Z"
+        },
+        "all_time": {
+          "calls": 571,
+          "tenant_count": 1,
+          "user_count": 1,
+          "component_count": 1,
+          "tenants": {
+            "unknown": 571
+          },
+          "users": {
+            "unknown": 571
+          },
+          "components": {
+            "unknown": 571
+          }
+        },
+        "window": {
+          "calls": 0,
+          "tenant_count": 0,
+          "user_count": 0,
+          "component_count": 0,
+          "tenants": {},
+          "users": {},
+          "components": {}
+        },
+        "last_seen_at": "2026-07-08T20:49:12.335710Z",
+        "retirement_candidate": true,
+        "retirement_reason": "no measured usage in review window"
+      },
+      {
+        "interface": {
+          "id": "4aea9591-970b-4918-ac4a-4da95a0a1a8c",
+          "interface_key": "rest_api:POST /decisions/ workstream_id",
+          "interface_kind": "rest_api",
+          "legacy_since": "2026-07-09T22:56:35.473130Z",
+          "replacement_ref": "POST /decisions/ with workplan_id",
+          "owner_component": "state-hub.api",
+          "status": "legacy",
+          "replacement_verified": true,
+          "manual_hold": false,
+          "hold_reason": null,
+          "notes": null,
+          "retired_at": null,
+          "created_at": "2026-07-09T22:56:35.473130Z",
+          "updated_at": "2026-07-09T22:56:35.473130Z"
+        },
+        "all_time": {
+          "calls": 3,
+          "tenant_count": 1,
+          "user_count": 1,
+          "component_count": 1,
+          "tenants": {
+            "unknown": 3
+          },
+          "users": {
+            "unknown": 3
+          },
+          "components": {
+            "unknown": 3
+          }
+        },
+        "window": {
+          "calls": 0,
+          "tenant_count": 0,
+          "user_count": 0,
+          "component_count": 0,
+          "tenants": {},
+          "users": {},
+          "components": {}
+        },
+        "last_seen_at": "2026-07-09T22:57:05.912456Z",
+        "retirement_candidate": true,
+        "retirement_reason": "no measured usage in review window"
+      },
+      {
+        "interface": {
+          "id": "4a70583c-1e41-4ec1-99a9-728856a7d79c",
+          "interface_key": "rest_api:POST /progress/ workstream_id",
+          "interface_kind": "rest_api",
+          "legacy_since": "2026-07-08T23:35:09.148333Z",
+          "replacement_ref": "POST /progress/ with workplan_id",
+          "owner_component": "state-hub.api",
+          "status": "legacy",
+          "replacement_verified": true,
+          "manual_hold": false,
+          "hold_reason": null,
+          "notes": null,
+          "retired_at": null,
+          "created_at": "2026-07-08T23:35:09.148333Z",
+          "updated_at": "2026-07-08T23:35:09.148333Z"
+        },
+        "all_time": {
+          "calls": 14,
+          "tenant_count": 1,
+          "user_count": 1,
+          "component_count": 1,
+          "tenants": {
+            "unknown": 14
+          },
+          "users": {
+            "unknown": 14
+          },
+          "components": {
+            "unknown": 14
+          }
+        },
+        "window": {
+          "calls": 0,
+          "tenant_count": 0,
+          "user_count": 0,
+          "component_count": 0,
+          "tenants": {},
+          "users": {},
+          "components": {}
+        },
+        "last_seen_at": "2026-07-10T08:34:42.959724Z",
+        "retirement_candidate": true,
+        "retirement_reason": "no measured usage in review window"
+      },
+      {
+        "interface": {
+          "id": "6df4e443-7bf1-461a-923b-a6eb52fe7b07",
+          "interface_key": "rest_api:POST /tasks/ workstream_id",
+          "interface_kind": "rest_api",
+          "legacy_since": "2026-07-08T22:38:29.405720Z",
+          "replacement_ref": "POST /tasks/ with workplan_id",
+          "owner_component": "state-hub.api",
+          "status": "legacy",
+          "replacement_verified": true,
+          "manual_hold": false,
+          "hold_reason": null,
+          "notes": null,
+          "retired_at": null,
+          "created_at": "2026-07-08T22:38:29.405720Z",
+          "updated_at": "2026-07-08T22:38:29.405720Z"
+        },
+        "all_time": {
+          "calls": 5,
+          "tenant_count": 1,
+          "user_count": 1,
+          "component_count": 1,
+          "tenants": {
+            "unknown": 5
+          },
+          "users": {
+            "unknown": 5
+          },
+          "components": {
+            "state-hub.fix-consistency": 5
+          }
+        },
+        "window": {
+          "calls": 0,
+          "tenant_count": 0,
+          "user_count": 0,
+          "component_count": 0,
+          "tenants": {},
+          "users": {},
+          "components": {}
+        },
+        "last_seen_at": "2026-07-08T22:38:29.976918Z",
+        "retirement_candidate": true,
+        "retirement_reason": "no measured usage in review window"
+      },
+      {
+        "interface": {
+          "id": "ed6451c9-d2cc-4486-9afe-d3852782cabc",
+          "interface_key": "rest_api:POST /workstreams/",
+          "interface_kind": "rest_api",
+          "legacy_since": "2026-06-04T07:40:24.168535Z",
+          "replacement_ref": "/workplans/",
+          "owner_component": "state-hub.api",
+          "status": "legacy",
+          "replacement_verified": true,
+          "manual_hold": false,
+          "hold_reason": null,
+          "notes": null,
+          "retired_at": null,
+          "created_at": "2026-06-04T07:40:24.168535Z",
+          "updated_at": "2026-06-04T07:40:24.168535Z"
+        },
+        "all_time": {
+          "calls": 824,
+          "tenant_count": 1,
+          "user_count": 1,
+          "component_count": 1,
+          "tenants": {
+            "unknown": 824
+          },
+          "users": {
+            "unknown": 824
+          },
+          "components": {
+            "unknown": 824
+          }
+        },
+        "window": {
+          "calls": 0,
+          "tenant_count": 0,
+          "user_count": 0,
+          "component_count": 0,
+          "tenants": {},
+          "users": {},
+          "components": {}
+        },
+        "last_seen_at": "2026-07-08T20:38:05.903144Z",
+        "retirement_candidate": true,
+        "retirement_reason": "no measured usage in review window"
+      },
+      {
+        "interface": {
+          "id": "281fd706-b192-4194-8055-2d8733c115f9",
+          "interface_key": "rest_api:POST /workstreams/{workstream_id}/dependencies/",
+          "interface_kind": "rest_api",
+          "legacy_since": "2026-06-04T22:57:37.149207Z",
+          "replacement_ref": "/workplans/{workplan_id}/dependencies/",
+          "owner_component": "state-hub.api",
+          "status": "legacy",
+          "replacement_verified": true,
+          "manual_hold": false,
+          "hold_reason": null,
+          "notes": null,
+          "retired_at": null,
+          "created_at": "2026-06-04T22:57:37.149207Z",
+          "updated_at": "2026-06-04T22:57:37.149207Z"
+        },
+        "all_time": {
+          "calls": 4971,
+          "tenant_count": 1,
+          "user_count": 1,
+          "component_count": 1,
+          "tenants": {
+            "unknown": 4971
+          },
+          "users": {
+            "unknown": 4971
+          },
+          "components": {
+            "unknown": 4971
+          }
+        },
+        "window": {
+          "calls": 0,
+          "tenant_count": 0,
+          "user_count": 0,
+          "component_count": 0,
+          "tenants": {},
+          "users": {},
+          "components": {}
+        },
+        "last_seen_at": "2026-07-01T22:09:24.229011Z",
+        "retirement_candidate": true,
+        "retirement_reason": "no measured usage in review window"
+      }
+    ]
+  },
+  "hours": 8
+}
diff --git a/docs/evidence/legacy-meter-weekly-review-20260806.json b/docs/evidence/legacy-meter-weekly-review-20260806.json
new file mode 100644
index 0000000..0adefdc
--- /dev/null
+++ b/docs/evidence/legacy-meter-weekly-review-20260806.json
@@ -0,0 +1,1755 @@
+{
+  "captured_at": "2026-08-06T14:00:07.558615+00:00",
+  "api_base": "http://127.0.0.1:8000",
+  "workplan": "STATE-WP-0070",
+  "retired_interfaces": [],
+  "weekly_review": {
+    "generated_at": "2026-08-06T14:00:07.552971Z",
+    "window_start": "2026-08-06T06:00:07.142393Z",
+    "window_end": "2026-08-06T14:00:07.142393Z",
+    "cadence": "weekly",
+    "activity_core_handoff": {
+      "activity_id": "statehub-legacy-interface-review",
+      "cadence": "weekly",
+      "source_endpoint": "/legacy-meter/weekly-review",
+      "state_owner": "state-hub",
+      "scheduler_owner": "activity-core"
+    },
+    "interfaces": [
+      {
+        "interface": {
+          "id": "8051fb40-66c9-4dc4-a413-13e8573e04a3",
+          "interface_key": "event_subject:org.statehub.workstream.completed",
+          "interface_kind": "event_subject",
+          "legacy_since": "2026-06-04T06:09:42.198193Z",
+          "replacement_ref": "org.statehub.workplan.completed",
+          "owner_component": "state-hub.events",
+          "status": "retired",
+          "replacement_verified": true,
+          "manual_hold": false,
+          "hold_reason": null,
+          "notes": "Retired by STATE-WP-0069 closeout",
+          "retired_at": "2026-07-08T21:38:52.773601Z",
+          "created_at": "2026-06-04T06:09:42.198193Z",
+          "updated_at": "2026-07-08T21:38:52.761243Z"
+        },
+        "all_time": {
+          "calls": 255,
+          "tenant_count": 1,
+          "user_count": 1,
+          "component_count": 1,
+          "tenants": {
+            "unknown": 255
+          },
+          "users": {
+            "unknown": 255
+          },
+          "components": {
+            "state-hub.events": 255
+          }
+        },
+        "window": {
+          "calls": 0,
+          "tenant_count": 0,
+          "user_count": 0,
+          "component_count": 0,
+          "tenants": {},
+          "users": {},
+          "components": {}
+        },
+        "last_seen_at": "2026-07-08T20:49:12.839383Z",
+        "retirement_candidate": false,
+        "retirement_reason": "already retired"
+      },
+      {
+        "interface": {
+          "id": "63ed90e3-42b4-431a-94db-e1254a52f9e2",
+          "interface_key": "mcp:create_workstream",
+          "interface_kind": "mcp_tool",
+          "legacy_since": "2026-07-10T13:19:44.205900Z",
+          "replacement_ref": "create_workplan",
+          "owner_component": "state-hub.mcp",
+          "status": "legacy",
+          "replacement_verified": true,
+          "manual_hold": false,
+          "hold_reason": null,
+          "notes": "Registered by STATE-WP-0070 T03 \u2014 zero-window streak starts at registration",
+          "retired_at": null,
+          "created_at": "2026-07-10T13:19:44.205900Z",
+          "updated_at": "2026-07-10T13:19:44.205900Z"
+        },
+        "all_time": {
+          "calls": 2,
+          "tenant_count": 1,
+          "user_count": 1,
+          "component_count": 1,
+          "tenants": {
+            "unknown": 2
+          },
+          "users": {
+            "unknown": 2
+          },
+          "components": {
+            "state-hub.mcp": 2
+          }
+        },
+        "window": {
+          "calls": 0,
+          "tenant_count": 0,
+          "user_count": 0,
+          "component_count": 0,
+          "tenants": {},
+          "users": {},
+          "components": {}
+        },
+        "last_seen_at": "2026-07-10T13:20:43.378546Z",
+        "retirement_candidate": true,
+        "retirement_reason": "no measured usage in review window"
+      },
+      {
+        "interface": {
+          "id": "b6a5fe44-fb85-4ef7-a273-78d09da777af",
+          "interface_key": "mcp:list_workstreams",
+          "interface_kind": "mcp_tool",
+          "legacy_since": "2026-07-10T13:19:26.075491Z",
+          "replacement_ref": "list_workplans",
+          "owner_component": "state-hub.mcp",
+          "status": "legacy",
+          "replacement_verified": true,
+          "manual_hold": false,
+          "hold_reason": null,
+          "notes": null,
+          "retired_at": null,
+          "created_at": "2026-07-10T13:19:26.075491Z",
+          "updated_at": "2026-07-10T13:19:26.075491Z"
+        },
+        "all_time": {
+          "calls": 2,
+          "tenant_count": 1,
+          "user_count": 1,
+          "component_count": 1,
+          "tenants": {
+            "unknown": 2
+          },
+          "users": {
+            "unknown": 2
+          },
+          "components": {
+            "state-hub.mcp": 2
+          }
+        },
+        "window": {
+          "calls": 0,
+          "tenant_count": 0,
+          "user_count": 0,
+          "component_count": 0,
+          "tenants": {},
+          "users": {},
+          "components": {}
+        },
+        "last_seen_at": "2026-07-10T13:20:42.374940Z",
+        "retirement_candidate": true,
+        "retirement_reason": "no measured usage in review window"
+      },
+      {
+        "interface": {
+          "id": "53c3372b-307d-4d6a-8ea4-bc36cacdcaf2",
+          "interface_key": "mcp:update_workstream",
+          "interface_kind": "mcp_tool",
+          "legacy_since": "2026-07-10T13:19:44.255216Z",
+          "replacement_ref": "update_workplan",
+          "owner_component": "state-hub.mcp",
+          "status": "legacy",
+          "replacement_verified": true,
+          "manual_hold": false,
+          "hold_reason": null,
+          "notes": "Registered by STATE-WP-0070 T03 \u2014 zero-window streak starts at registration",
+          "retired_at": null,
+          "created_at": "2026-07-10T13:19:44.255216Z",
+          "updated_at": "2026-07-10T13:19:44.255216Z"
+        },
+        "all_time": {
+          "calls": 0,
+          "tenant_count": 0,
+          "user_count": 0,
+          "component_count": 0,
+          "tenants": {},
+          "users": {},
+          "components": {}
+        },
+        "window": {
+          "calls": 0,
+          "tenant_count": 0,
+          "user_count": 0,
+          "component_count": 0,
+          "tenants": {},
+          "users": {},
+          "components": {}
+        },
+        "last_seen_at": null,
+        "retirement_candidate": true,
+        "retirement_reason": "no measured usage in review window"
+      },
+      {
+        "interface": {
+          "id": "bed4d08a-3471-48f5-9f0e-f9d550383a26",
+          "interface_key": "mcp:update_workstream_status",
+          "interface_kind": "mcp_tool",
+          "legacy_since": "2026-07-10T13:19:44.303612Z",
+          "replacement_ref": "update_workplan_status",
+          "owner_component": "state-hub.mcp",
+          "status": "legacy",
+          "replacement_verified": true,
+          "manual_hold": false,
+          "hold_reason": null,
+          "notes": "Registered by STATE-WP-0070 T03 \u2014 zero-window streak starts at registration",
+          "retired_at": null,
+          "created_at": "2026-07-10T13:19:44.303612Z",
+          "updated_at": "2026-07-10T13:19:44.303612Z"
+        },
+        "all_time": {
+          "calls": 0,
+          "tenant_count": 0,
+          "user_count": 0,
+          "component_count": 0,
+          "tenants": {},
+          "users": {},
+          "components": {}
+        },
+        "window": {
+          "calls": 0,
+          "tenant_count": 0,
+          "user_count": 0,
+          "component_count": 0,
+          "tenants": {},
+          "users": {},
+          "components": {}
+        },
+        "last_seen_at": null,
+        "retirement_candidate": true,
+        "retirement_reason": "no measured usage in review window"
+      },
+      {
+        "interface": {
+          "id": "46900dc2-0893-405b-ba59-80f31fb6ebb1",
+          "interface_key": "state://workstreams/{topic_slug}",
+          "interface_kind": "mcp_tool",
+          "legacy_since": "2026-07-10T13:19:44.344493Z",
+          "replacement_ref": "state://workplans/{topic_slug}",
+          "owner_component": "state-hub.mcp",
+          "status": "legacy",
+          "replacement_verified": true,
+          "manual_hold": false,
+          "hold_reason": null,
+          "notes": "Registered by STATE-WP-0070 T03 \u2014 zero-window streak starts at registration",
+          "retired_at": null,
+          "created_at": "2026-07-10T13:19:44.344493Z",
+          "updated_at": "2026-07-10T13:19:44.344493Z"
+        },
+        "all_time": {
+          "calls": 1,
+          "tenant_count": 1,
+          "user_count": 1,
+          "component_count": 1,
+          "tenants": {
+            "unknown": 1
+          },
+          "users": {
+            "unknown": 1
+          },
+          "components": {
+            "state-hub.mcp": 1
+          }
+        },
+        "window": {
+          "calls": 0,
+          "tenant_count": 0,
+          "user_count": 0,
+          "component_count": 0,
+          "tenants": {},
+          "users": {},
+          "components": {}
+        },
+        "last_seen_at": "2026-07-10T13:20:34.491811Z",
+        "retirement_candidate": true,
+        "retirement_reason": "no measured usage in review window"
+      },
+      {
+        "interface": {
+          "id": "cd9342fd-27e7-4a46-a1be-d41499e106a3",
+          "interface_key": "rest_api:DELETE /workstreams/{workstream_id}",
+          "interface_kind": "rest_api",
+          "legacy_since": "2026-06-06T17:28:13.052813Z",
+          "replacement_ref": "/workplans/{workplan_id}",
+          "owner_component": "state-hub.api",
+          "status": "legacy",
+          "replacement_verified": true,
+          "manual_hold": false,
+          "hold_reason": null,
+          "notes": null,
+          "retired_at": null,
+          "created_at": "2026-06-06T17:28:13.052813Z",
+          "updated_at": "2026-06-06T17:28:13.052813Z"
+        },
+        "all_time": {
+          "calls": 1,
+          "tenant_count": 1,
+          "user_count": 1,
+          "component_count": 1,
+          "tenants": {
+            "unknown": 1
+          },
+          "users": {
+            "unknown": 1
+          },
+          "components": {
+            "unknown": 1
+          }
+        },
+        "window": {
+          "calls": 0,
+          "tenant_count": 0,
+          "user_count": 0,
+          "component_count": 0,
+          "tenants": {},
+          "users": {},
+          "components": {}
+        },
+        "last_seen_at": "2026-06-06T17:28:13.047529Z",
+        "retirement_candidate": true,
+        "retirement_reason": "no measured usage in review window"
+      },
+      {
+        "interface": {
+          "id": "a4e0948c-cd4a-461e-8ae2-7fd7b51d04a7",
+          "interface_key": "rest_api:GET /decisions/?workstream_id",
+          "interface_kind": "rest_api",
+          "legacy_since": "2026-07-09T23:07:53.093223Z",
+          "replacement_ref": "/decisions/?workplan_id=<workplan_id>",
+          "owner_component": "state-hub.api",
+          "status": "legacy",
+          "replacement_verified": true,
+          "manual_hold": false,
+          "hold_reason": null,
+          "notes": null,
+          "retired_at": null,
+          "created_at": "2026-07-09T23:07:53.093223Z",
+          "updated_at": "2026-07-09T23:07:53.093223Z"
+        },
+        "all_time": {
+          "calls": 1,
+          "tenant_count": 1,
+          "user_count": 1,
+          "component_count": 1,
+          "tenants": {
+            "unknown": 1
+          },
+          "users": {
+            "unknown": 1
+          },
+          "components": {
+            "unknown": 1
+          }
+        },
+        "window": {
+          "calls": 0,
+          "tenant_count": 0,
+          "user_count": 0,
+          "component_count": 0,
+          "tenants": {},
+          "users": {},
+          "components": {}
+        },
+        "last_seen_at": "2026-07-09T23:07:53.083299Z",
+        "retirement_candidate": true,
+        "retirement_reason": "no measured usage in review window"
+      },
+      {
+        "interface": {
+          "id": "70a9346e-e0ee-42ac-874f-f160580b54dd",
+          "interface_key": "rest_api:GET /progress/?workstream_id",
+          "interface_kind": "rest_api",
+          "legacy_since": "2026-07-13T22:04:03.911449Z",
+          "replacement_ref": "/progress/?workplan_id=<workplan_id>",
+          "owner_component": "state-hub.api",
+          "status": "legacy",
+          "replacement_verified": true,
+          "manual_hold": false,
+          "hold_reason": null,
+          "notes": null,
+          "retired_at": null,
+          "created_at": "2026-07-13T22:04:03.911449Z",
+          "updated_at": "2026-07-13T22:04:03.911449Z"
+        },
+        "all_time": {
+          "calls": 1,
+          "tenant_count": 1,
+          "user_count": 1,
+          "component_count": 1,
+          "tenants": {
+            "unknown": 1
+          },
+          "users": {
+            "unknown": 1
+          },
+          "components": {
+            "unknown": 1
+          }
+        },
+        "window": {
+          "calls": 0,
+          "tenant_count": 0,
+          "user_count": 0,
+          "component_count": 0,
+          "tenants": {},
+          "users": {},
+          "components": {}
+        },
+        "last_seen_at": "2026-07-13T22:04:03.904998Z",
+        "retirement_candidate": true,
+        "retirement_reason": "no measured usage in review window"
+      },
+      {
+        "interface": {
+          "id": "be3cdcf8-250b-4bf0-801f-02ffd5f57e00",
+          "interface_key": "rest_api:GET /tasks/?workstream_id",
+          "interface_kind": "rest_api",
+          "legacy_since": "2026-07-08T19:32:21.628513Z",
+          "replacement_ref": "/tasks/?workplan_id=<workplan_id>",
+          "owner_component": "state-hub.api",
+          "status": "legacy",
+          "replacement_verified": true,
+          "manual_hold": false,
+          "hold_reason": null,
+          "notes": null,
+          "retired_at": null,
+          "created_at": "2026-07-08T19:32:21.628513Z",
+          "updated_at": "2026-07-08T19:32:21.628513Z"
+        },
+        "all_time": {
+          "calls": 589,
+          "tenant_count": 1,
+          "user_count": 1,
+          "component_count": 1,
+          "tenants": {
+            "unknown": 589
+          },
+          "users": {
+            "unknown": 589
+          },
+          "components": {
+            "unknown": 589
+          }
+        },
+        "window": {
+          "calls": 0,
+          "tenant_count": 0,
+          "user_count": 0,
+          "component_count": 0,
+          "tenants": {},
+          "users": {},
+          "components": {}
+        },
+        "last_seen_at": "2026-07-31T16:25:32.181901Z",
+        "retirement_candidate": true,
+        "retirement_reason": "no measured usage in review window"
+      },
+      {
+        "interface": {
+          "id": "3e4a3d0b-08fa-45c3-91e2-4f514a914b97",
+          "interface_key": "rest_api:GET /workstreams/",
+          "interface_kind": "rest_api",
+          "legacy_since": "2026-06-04T00:26:14.533764Z",
+          "replacement_ref": "/workplans/",
+          "owner_component": "state-hub.api",
+          "status": "legacy",
+          "replacement_verified": true,
+          "manual_hold": false,
+          "hold_reason": null,
+          "notes": null,
+          "retired_at": null,
+          "created_at": "2026-06-04T00:26:14.533764Z",
+          "updated_at": "2026-06-04T00:26:14.533764Z"
+        },
+        "all_time": {
+          "calls": 144085,
+          "tenant_count": 1,
+          "user_count": 1,
+          "component_count": 1,
+          "tenants": {
+            "unknown": 144085
+          },
+          "users": {
+            "unknown": 144085
+          },
+          "components": {
+            "unknown": 144085
+          }
+        },
+        "window": {
+          "calls": 0,
+          "tenant_count": 0,
+          "user_count": 0,
+          "component_count": 0,
+          "tenants": {},
+          "users": {},
+          "components": {}
+        },
+        "last_seen_at": "2026-08-05T13:01:38.000781Z",
+        "retirement_candidate": true,
+        "retirement_reason": "no measured usage in review window"
+      },
+      {
+        "interface": {
+          "id": "e4c140ec-7479-46f9-b185-4b533f19d639",
+          "interface_key": "rest_api:GET /workstreams/workplan-index",
+          "interface_kind": "rest_api",
+          "legacy_since": "2026-06-04T05:20:58.321869Z",
+          "replacement_ref": "/workplans/index",
+          "owner_component": "state-hub.api",
+          "status": "legacy",
+          "replacement_verified": true,
+          "manual_hold": false,
+          "hold_reason": null,
+          "notes": null,
+          "retired_at": null,
+          "created_at": "2026-06-04T05:20:58.321869Z",
+          "updated_at": "2026-06-04T05:20:58.321869Z"
+        },
+        "all_time": {
+          "calls": 30,
+          "tenant_count": 1,
+          "user_count": 1,
+          "component_count": 1,
+          "tenants": {
+            "unknown": 30
+          },
+          "users": {
+            "unknown": 30
+          },
+          "components": {
+            "unknown": 30
+          }
+        },
+        "window": {
+          "calls": 0,
+          "tenant_count": 0,
+          "user_count": 0,
+          "component_count": 0,
+          "tenants": {},
+          "users": {},
+          "components": {}
+        },
+        "last_seen_at": "2026-07-03T05:20:34.534439Z",
+        "retirement_candidate": true,
+        "retirement_reason": "no measured usage in review window"
+      },
+      {
+        "interface": {
+          "id": "3a00b19e-e7db-4403-98aa-a77c9ab61ecc",
+          "interface_key": "rest_api:GET /workstreams/{workstream_id}",
+          "interface_kind": "rest_api",
+          "legacy_since": "2026-06-04T00:25:59.014966Z",
+          "replacement_ref": "/workplans/{workplan_id}",
+          "owner_component": "state-hub.api",
+          "status": "legacy",
+          "replacement_verified": true,
+          "manual_hold": false,
+          "hold_reason": null,
+          "notes": null,
+          "retired_at": null,
+          "created_at": "2026-06-04T00:25:59.014966Z",
+          "updated_at": "2026-06-04T00:25:59.014966Z"
+        },
+        "all_time": {
+          "calls": 511406,
+          "tenant_count": 1,
+          "user_count": 1,
+          "component_count": 1,
+          "tenants": {
+            "unknown": 511406
+          },
+          "users": {
+            "unknown": 511406
+          },
+          "components": {
+            "unknown": 511406
+          }
+        },
+        "window": {
+          "calls": 0,
+          "tenant_count": 0,
+          "user_count": 0,
+          "component_count": 0,
+          "tenants": {},
+          "users": {},
+          "components": {}
+        },
+        "last_seen_at": "2026-07-31T16:25:32.004042Z",
+        "retirement_candidate": true,
+        "retirement_reason": "no measured usage in review window"
+      },
+      {
+        "interface": {
+          "id": "69e1a255-a8b9-4101-8a68-b1bed23abfda",
+          "interface_key": "rest_api:GET /workstreams/{workstream_id}/dependencies/",
+          "interface_kind": "rest_api",
+          "legacy_since": "2026-06-04T00:25:59.291135Z",
+          "replacement_ref": "/workplans/{workplan_id}/dependencies/",
+          "owner_component": "state-hub.api",
+          "status": "legacy",
+          "replacement_verified": true,
+          "manual_hold": false,
+          "hold_reason": null,
+          "notes": null,
+          "retired_at": null,
+          "created_at": "2026-06-04T00:25:59.291135Z",
+          "updated_at": "2026-06-04T00:25:59.291135Z"
+        },
+        "all_time": {
+          "calls": 255865,
+          "tenant_count": 1,
+          "user_count": 1,
+          "component_count": 1,
+          "tenants": {
+            "unknown": 255865
+          },
+          "users": {
+            "unknown": 255865
+          },
+          "components": {
+            "unknown": 255865
+          }
+        },
+        "window": {
+          "calls": 0,
+          "tenant_count": 0,
+          "user_count": 0,
+          "component_count": 0,
+          "tenants": {},
+          "users": {},
+          "components": {}
+        },
+        "last_seen_at": "2026-07-08T21:14:12.747005Z",
+        "retirement_candidate": true,
+        "retirement_reason": "no measured usage in review window"
+      },
+      {
+        "interface": {
+          "id": "b1aae931-b51f-4a85-a723-865dd65f6132",
+          "interface_key": "rest_api:PATCH /workstreams/{workstream_id}",
+          "interface_kind": "rest_api",
+          "legacy_since": "2026-06-04T06:09:41.901035Z",
+          "replacement_ref": "/workplans/{workplan_id}",
+          "owner_component": "state-hub.api",
+          "status": "legacy",
+          "replacement_verified": true,
+          "manual_hold": false,
+          "hold_reason": null,
+          "notes": null,
+          "retired_at": null,
+          "created_at": "2026-06-04T06:09:41.901035Z",
+          "updated_at": "2026-06-04T06:09:41.901035Z"
+        },
+        "all_time": {
+          "calls": 571,
+          "tenant_count": 1,
+          "user_count": 1,
+          "component_count": 1,
+          "tenants": {
+            "unknown": 571
+          },
+          "users": {
+            "unknown": 571
+          },
+          "components": {
+            "unknown": 571
+          }
+        },
+        "window": {
+          "calls": 0,
+          "tenant_count": 0,
+          "user_count": 0,
+          "component_count": 0,
+          "tenants": {},
+          "users": {},
+          "components": {}
+        },
+        "last_seen_at": "2026-07-08T20:49:12.335710Z",
+        "retirement_candidate": true,
+        "retirement_reason": "no measured usage in review window"
+      },
+      {
+        "interface": {
+          "id": "4aea9591-970b-4918-ac4a-4da95a0a1a8c",
+          "interface_key": "rest_api:POST /decisions/ workstream_id",
+          "interface_kind": "rest_api",
+          "legacy_since": "2026-07-09T22:56:35.473130Z",
+          "replacement_ref": "POST /decisions/ with workplan_id",
+          "owner_component": "state-hub.api",
+          "status": "legacy",
+          "replacement_verified": true,
+          "manual_hold": false,
+          "hold_reason": null,
+          "notes": null,
+          "retired_at": null,
+          "created_at": "2026-07-09T22:56:35.473130Z",
+          "updated_at": "2026-07-09T22:56:35.473130Z"
+        },
+        "all_time": {
+          "calls": 3,
+          "tenant_count": 1,
+          "user_count": 1,
+          "component_count": 1,
+          "tenants": {
+            "unknown": 3
+          },
+          "users": {
+            "unknown": 3
+          },
+          "components": {
+            "unknown": 3
+          }
+        },
+        "window": {
+          "calls": 0,
+          "tenant_count": 0,
+          "user_count": 0,
+          "component_count": 0,
+          "tenants": {},
+          "users": {},
+          "components": {}
+        },
+        "last_seen_at": "2026-07-09T22:57:05.912456Z",
+        "retirement_candidate": true,
+        "retirement_reason": "no measured usage in review window"
+      },
+      {
+        "interface": {
+          "id": "4a70583c-1e41-4ec1-99a9-728856a7d79c",
+          "interface_key": "rest_api:POST /progress/ workstream_id",
+          "interface_kind": "rest_api",
+          "legacy_since": "2026-07-08T23:35:09.148333Z",
+          "replacement_ref": "POST /progress/ with workplan_id",
+          "owner_component": "state-hub.api",
+          "status": "legacy",
+          "replacement_verified": true,
+          "manual_hold": false,
+          "hold_reason": null,
+          "notes": null,
+          "retired_at": null,
+          "created_at": "2026-07-08T23:35:09.148333Z",
+          "updated_at": "2026-07-08T23:35:09.148333Z"
+        },
+        "all_time": {
+          "calls": 14,
+          "tenant_count": 1,
+          "user_count": 1,
+          "component_count": 1,
+          "tenants": {
+            "unknown": 14
+          },
+          "users": {
+            "unknown": 14
+          },
+          "components": {
+            "unknown": 14
+          }
+        },
+        "window": {
+          "calls": 0,
+          "tenant_count": 0,
+          "user_count": 0,
+          "component_count": 0,
+          "tenants": {},
+          "users": {},
+          "components": {}
+        },
+        "last_seen_at": "2026-07-10T08:34:42.959724Z",
+        "retirement_candidate": true,
+        "retirement_reason": "no measured usage in review window"
+      },
+      {
+        "interface": {
+          "id": "6df4e443-7bf1-461a-923b-a6eb52fe7b07",
+          "interface_key": "rest_api:POST /tasks/ workstream_id",
+          "interface_kind": "rest_api",
+          "legacy_since": "2026-07-08T22:38:29.405720Z",
+          "replacement_ref": "POST /tasks/ with workplan_id",
+          "owner_component": "state-hub.api",
+          "status": "legacy",
+          "replacement_verified": true,
+          "manual_hold": false,
+          "hold_reason": null,
+          "notes": null,
+          "retired_at": null,
+          "created_at": "2026-07-08T22:38:29.405720Z",
+          "updated_at": "2026-07-08T22:38:29.405720Z"
+        },
+        "all_time": {
+          "calls": 5,
+          "tenant_count": 1,
+          "user_count": 1,
+          "component_count": 1,
+          "tenants": {
+            "unknown": 5
+          },
+          "users": {
+            "unknown": 5
+          },
+          "components": {
+            "state-hub.fix-consistency": 5
+          }
+        },
+        "window": {
+          "calls": 0,
+          "tenant_count": 0,
+          "user_count": 0,
+          "component_count": 0,
+          "tenants": {},
+          "users": {},
+          "components": {}
+        },
+        "last_seen_at": "2026-07-08T22:38:29.976918Z",
+        "retirement_candidate": true,
+        "retirement_reason": "no measured usage in review window"
+      },
+      {
+        "interface": {
+          "id": "ed6451c9-d2cc-4486-9afe-d3852782cabc",
+          "interface_key": "rest_api:POST /workstreams/",
+          "interface_kind": "rest_api",
+          "legacy_since": "2026-06-04T07:40:24.168535Z",
+          "replacement_ref": "/workplans/",
+          "owner_component": "state-hub.api",
+          "status": "legacy",
+          "replacement_verified": true,
+          "manual_hold": false,
+          "hold_reason": null,
+          "notes": null,
+          "retired_at": null,
+          "created_at": "2026-06-04T07:40:24.168535Z",
+          "updated_at": "2026-06-04T07:40:24.168535Z"
+        },
+        "all_time": {
+          "calls": 824,
+          "tenant_count": 1,
+          "user_count": 1,
+          "component_count": 1,
+          "tenants": {
+            "unknown": 824
+          },
+          "users": {
+            "unknown": 824
+          },
+          "components": {
+            "unknown": 824
+          }
+        },
+        "window": {
+          "calls": 0,
+          "tenant_count": 0,
+          "user_count": 0,
+          "component_count": 0,
+          "tenants": {},
+          "users": {},
+          "components": {}
+        },
+        "last_seen_at": "2026-07-08T20:38:05.903144Z",
+        "retirement_candidate": true,
+        "retirement_reason": "no measured usage in review window"
+      },
+      {
+        "interface": {
+          "id": "281fd706-b192-4194-8055-2d8733c115f9",
+          "interface_key": "rest_api:POST /workstreams/{workstream_id}/dependencies/",
+          "interface_kind": "rest_api",
+          "legacy_since": "2026-06-04T22:57:37.149207Z",
+          "replacement_ref": "/workplans/{workplan_id}/dependencies/",
+          "owner_component": "state-hub.api",
+          "status": "legacy",
+          "replacement_verified": true,
+          "manual_hold": false,
+          "hold_reason": null,
+          "notes": null,
+          "retired_at": null,
+          "created_at": "2026-06-04T22:57:37.149207Z",
+          "updated_at": "2026-06-04T22:57:37.149207Z"
+        },
+        "all_time": {
+          "calls": 4971,
+          "tenant_count": 1,
+          "user_count": 1,
+          "component_count": 1,
+          "tenants": {
+            "unknown": 4971
+          },
+          "users": {
+            "unknown": 4971
+          },
+          "components": {
+            "unknown": 4971
+          }
+        },
+        "window": {
+          "calls": 0,
+          "tenant_count": 0,
+          "user_count": 0,
+          "component_count": 0,
+          "tenants": {},
+          "users": {},
+          "components": {}
+        },
+        "last_seen_at": "2026-07-01T22:09:24.229011Z",
+        "retirement_candidate": true,
+        "retirement_reason": "no measured usage in review window"
+      }
+    ],
+    "retirement_candidates": [
+      {
+        "interface": {
+          "id": "63ed90e3-42b4-431a-94db-e1254a52f9e2",
+          "interface_key": "mcp:create_workstream",
+          "interface_kind": "mcp_tool",
+          "legacy_since": "2026-07-10T13:19:44.205900Z",
+          "replacement_ref": "create_workplan",
+          "owner_component": "state-hub.mcp",
+          "status": "legacy",
+          "replacement_verified": true,
+          "manual_hold": false,
+          "hold_reason": null,
+          "notes": "Registered by STATE-WP-0070 T03 \u2014 zero-window streak starts at registration",
+          "retired_at": null,
+          "created_at": "2026-07-10T13:19:44.205900Z",
+          "updated_at": "2026-07-10T13:19:44.205900Z"
+        },
+        "all_time": {
+          "calls": 2,
+          "tenant_count": 1,
+          "user_count": 1,
+          "component_count": 1,
+          "tenants": {
+            "unknown": 2
+          },
+          "users": {
+            "unknown": 2
+          },
+          "components": {
+            "state-hub.mcp": 2
+          }
+        },
+        "window": {
+          "calls": 0,
+          "tenant_count": 0,
+          "user_count": 0,
+          "component_count": 0,
+          "tenants": {},
+          "users": {},
+          "components": {}
+        },
+        "last_seen_at": "2026-07-10T13:20:43.378546Z",
+        "retirement_candidate": true,
+        "retirement_reason": "no measured usage in review window"
+      },
+      {
+        "interface": {
+          "id": "b6a5fe44-fb85-4ef7-a273-78d09da777af",
+          "interface_key": "mcp:list_workstreams",
+          "interface_kind": "mcp_tool",
+          "legacy_since": "2026-07-10T13:19:26.075491Z",
+          "replacement_ref": "list_workplans",
+          "owner_component": "state-hub.mcp",
+          "status": "legacy",
+          "replacement_verified": true,
+          "manual_hold": false,
+          "hold_reason": null,
+          "notes": null,
+          "retired_at": null,
+          "created_at": "2026-07-10T13:19:26.075491Z",
+          "updated_at": "2026-07-10T13:19:26.075491Z"
+        },
+        "all_time": {
+          "calls": 2,
+          "tenant_count": 1,
+          "user_count": 1,
+          "component_count": 1,
+          "tenants": {
+            "unknown": 2
+          },
+          "users": {
+            "unknown": 2
+          },
+          "components": {
+            "state-hub.mcp": 2
+          }
+        },
+        "window": {
+          "calls": 0,
+          "tenant_count": 0,
+          "user_count": 0,
+          "component_count": 0,
+          "tenants": {},
+          "users": {},
+          "components": {}
+        },
+        "last_seen_at": "2026-07-10T13:20:42.374940Z",
+        "retirement_candidate": true,
+        "retirement_reason": "no measured usage in review window"
+      },
+      {
+        "interface": {
+          "id": "53c3372b-307d-4d6a-8ea4-bc36cacdcaf2",
+          "interface_key": "mcp:update_workstream",
+          "interface_kind": "mcp_tool",
+          "legacy_since": "2026-07-10T13:19:44.255216Z",
+          "replacement_ref": "update_workplan",
+          "owner_component": "state-hub.mcp",
+          "status": "legacy",
+          "replacement_verified": true,
+          "manual_hold": false,
+          "hold_reason": null,
+          "notes": "Registered by STATE-WP-0070 T03 \u2014 zero-window streak starts at registration",
+          "retired_at": null,
+          "created_at": "2026-07-10T13:19:44.255216Z",
+          "updated_at": "2026-07-10T13:19:44.255216Z"
+        },
+        "all_time": {
+          "calls": 0,
+          "tenant_count": 0,
+          "user_count": 0,
+          "component_count": 0,
+          "tenants": {},
+          "users": {},
+          "components": {}
+        },
+        "window": {
+          "calls": 0,
+          "tenant_count": 0,
+          "user_count": 0,
+          "component_count": 0,
+          "tenants": {},
+          "users": {},
+          "components": {}
+        },
+        "last_seen_at": null,
+        "retirement_candidate": true,
+        "retirement_reason": "no measured usage in review window"
+      },
+      {
+        "interface": {
+          "id": "bed4d08a-3471-48f5-9f0e-f9d550383a26",
+          "interface_key": "mcp:update_workstream_status",
+          "interface_kind": "mcp_tool",
+          "legacy_since": "2026-07-10T13:19:44.303612Z",
+          "replacement_ref": "update_workplan_status",
+          "owner_component": "state-hub.mcp",
+          "status": "legacy",
+          "replacement_verified": true,
+          "manual_hold": false,
+          "hold_reason": null,
+          "notes": "Registered by STATE-WP-0070 T03 \u2014 zero-window streak starts at registration",
+          "retired_at": null,
+          "created_at": "2026-07-10T13:19:44.303612Z",
+          "updated_at": "2026-07-10T13:19:44.303612Z"
+        },
+        "all_time": {
+          "calls": 0,
+          "tenant_count": 0,
+          "user_count": 0,
+          "component_count": 0,
+          "tenants": {},
+          "users": {},
+          "components": {}
+        },
+        "window": {
+          "calls": 0,
+          "tenant_count": 0,
+          "user_count": 0,
+          "component_count": 0,
+          "tenants": {},
+          "users": {},
+          "components": {}
+        },
+        "last_seen_at": null,
+        "retirement_candidate": true,
+        "retirement_reason": "no measured usage in review window"
+      },
+      {
+        "interface": {
+          "id": "46900dc2-0893-405b-ba59-80f31fb6ebb1",
+          "interface_key": "state://workstreams/{topic_slug}",
+          "interface_kind": "mcp_tool",
+          "legacy_since": "2026-07-10T13:19:44.344493Z",
+          "replacement_ref": "state://workplans/{topic_slug}",
+          "owner_component": "state-hub.mcp",
+          "status": "legacy",
+          "replacement_verified": true,
+          "manual_hold": false,
+          "hold_reason": null,
+          "notes": "Registered by STATE-WP-0070 T03 \u2014 zero-window streak starts at registration",
+          "retired_at": null,
+          "created_at": "2026-07-10T13:19:44.344493Z",
+          "updated_at": "2026-07-10T13:19:44.344493Z"
+        },
+        "all_time": {
+          "calls": 1,
+          "tenant_count": 1,
+          "user_count": 1,
+          "component_count": 1,
+          "tenants": {
+            "unknown": 1
+          },
+          "users": {
+            "unknown": 1
+          },
+          "components": {
+            "state-hub.mcp": 1
+          }
+        },
+        "window": {
+          "calls": 0,
+          "tenant_count": 0,
+          "user_count": 0,
+          "component_count": 0,
+          "tenants": {},
+          "users": {},
+          "components": {}
+        },
+        "last_seen_at": "2026-07-10T13:20:34.491811Z",
+        "retirement_candidate": true,
+        "retirement_reason": "no measured usage in review window"
+      },
+      {
+        "interface": {
+          "id": "cd9342fd-27e7-4a46-a1be-d41499e106a3",
+          "interface_key": "rest_api:DELETE /workstreams/{workstream_id}",
+          "interface_kind": "rest_api",
+          "legacy_since": "2026-06-06T17:28:13.052813Z",
+          "replacement_ref": "/workplans/{workplan_id}",
+          "owner_component": "state-hub.api",
+          "status": "legacy",
+          "replacement_verified": true,
+          "manual_hold": false,
+          "hold_reason": null,
+          "notes": null,
+          "retired_at": null,
+          "created_at": "2026-06-06T17:28:13.052813Z",
+          "updated_at": "2026-06-06T17:28:13.052813Z"
+        },
+        "all_time": {
+          "calls": 1,
+          "tenant_count": 1,
+          "user_count": 1,
+          "component_count": 1,
+          "tenants": {
+            "unknown": 1
+          },
+          "users": {
+            "unknown": 1
+          },
+          "components": {
+            "unknown": 1
+          }
+        },
+        "window": {
+          "calls": 0,
+          "tenant_count": 0,
+          "user_count": 0,
+          "component_count": 0,
+          "tenants": {},
+          "users": {},
+          "components": {}
+        },
+        "last_seen_at": "2026-06-06T17:28:13.047529Z",
+        "retirement_candidate": true,
+        "retirement_reason": "no measured usage in review window"
+      },
+      {
+        "interface": {
+          "id": "a4e0948c-cd4a-461e-8ae2-7fd7b51d04a7",
+          "interface_key": "rest_api:GET /decisions/?workstream_id",
+          "interface_kind": "rest_api",
+          "legacy_since": "2026-07-09T23:07:53.093223Z",
+          "replacement_ref": "/decisions/?workplan_id=<workplan_id>",
+          "owner_component": "state-hub.api",
+          "status": "legacy",
+          "replacement_verified": true,
+          "manual_hold": false,
+          "hold_reason": null,
+          "notes": null,
+          "retired_at": null,
+          "created_at": "2026-07-09T23:07:53.093223Z",
+          "updated_at": "2026-07-09T23:07:53.093223Z"
+        },
+        "all_time": {
+          "calls": 1,
+          "tenant_count": 1,
+          "user_count": 1,
+          "component_count": 1,
+          "tenants": {
+            "unknown": 1
+          },
+          "users": {
+            "unknown": 1
+          },
+          "components": {
+            "unknown": 1
+          }
+        },
+        "window": {
+          "calls": 0,
+          "tenant_count": 0,
+          "user_count": 0,
+          "component_count": 0,
+          "tenants": {},
+          "users": {},
+          "components": {}
+        },
+        "last_seen_at": "2026-07-09T23:07:53.083299Z",
+        "retirement_candidate": true,
+        "retirement_reason": "no measured usage in review window"
+      },
+      {
+        "interface": {
+          "id": "70a9346e-e0ee-42ac-874f-f160580b54dd",
+          "interface_key": "rest_api:GET /progress/?workstream_id",
+          "interface_kind": "rest_api",
+          "legacy_since": "2026-07-13T22:04:03.911449Z",
+          "replacement_ref": "/progress/?workplan_id=<workplan_id>",
+          "owner_component": "state-hub.api",
+          "status": "legacy",
+          "replacement_verified": true,
+          "manual_hold": false,
+          "hold_reason": null,
+          "notes": null,
+          "retired_at": null,
+          "created_at": "2026-07-13T22:04:03.911449Z",
+          "updated_at": "2026-07-13T22:04:03.911449Z"
+        },
+        "all_time": {
+          "calls": 1,
+          "tenant_count": 1,
+          "user_count": 1,
+          "component_count": 1,
+          "tenants": {
+            "unknown": 1
+          },
+          "users": {
+            "unknown": 1
+          },
+          "components": {
+            "unknown": 1
+          }
+        },
+        "window": {
+          "calls": 0,
+          "tenant_count": 0,
+          "user_count": 0,
+          "component_count": 0,
+          "tenants": {},
+          "users": {},
+          "components": {}
+        },
+        "last_seen_at": "2026-07-13T22:04:03.904998Z",
+        "retirement_candidate": true,
+        "retirement_reason": "no measured usage in review window"
+      },
+      {
+        "interface": {
+          "id": "be3cdcf8-250b-4bf0-801f-02ffd5f57e00",
+          "interface_key": "rest_api:GET /tasks/?workstream_id",
+          "interface_kind": "rest_api",
+          "legacy_since": "2026-07-08T19:32:21.628513Z",
+          "replacement_ref": "/tasks/?workplan_id=<workplan_id>",
+          "owner_component": "state-hub.api",
+          "status": "legacy",
+          "replacement_verified": true,
+          "manual_hold": false,
+          "hold_reason": null,
+          "notes": null,
+          "retired_at": null,
+          "created_at": "2026-07-08T19:32:21.628513Z",
+          "updated_at": "2026-07-08T19:32:21.628513Z"
+        },
+        "all_time": {
+          "calls": 589,
+          "tenant_count": 1,
+          "user_count": 1,
+          "component_count": 1,
+          "tenants": {
+            "unknown": 589
+          },
+          "users": {
+            "unknown": 589
+          },
+          "components": {
+            "unknown": 589
+          }
+        },
+        "window": {
+          "calls": 0,
+          "tenant_count": 0,
+          "user_count": 0,
+          "component_count": 0,
+          "tenants": {},
+          "users": {},
+          "components": {}
+        },
+        "last_seen_at": "2026-07-31T16:25:32.181901Z",
+        "retirement_candidate": true,
+        "retirement_reason": "no measured usage in review window"
+      },
+      {
+        "interface": {
+          "id": "3e4a3d0b-08fa-45c3-91e2-4f514a914b97",
+          "interface_key": "rest_api:GET /workstreams/",
+          "interface_kind": "rest_api",
+          "legacy_since": "2026-06-04T00:26:14.533764Z",
+          "replacement_ref": "/workplans/",
+          "owner_component": "state-hub.api",
+          "status": "legacy",
+          "replacement_verified": true,
+          "manual_hold": false,
+          "hold_reason": null,
+          "notes": null,
+          "retired_at": null,
+          "created_at": "2026-06-04T00:26:14.533764Z",
+          "updated_at": "2026-06-04T00:26:14.533764Z"
+        },
+        "all_time": {
+          "calls": 144085,
+          "tenant_count": 1,
+          "user_count": 1,
+          "component_count": 1,
+          "tenants": {
+            "unknown": 144085
+          },
+          "users": {
+            "unknown": 144085
+          },
+          "components": {
+            "unknown": 144085
+          }
+        },
+        "window": {
+          "calls": 0,
+          "tenant_count": 0,
+          "user_count": 0,
+          "component_count": 0,
+          "tenants": {},
+          "users": {},
+          "components": {}
+        },
+        "last_seen_at": "2026-08-05T13:01:38.000781Z",
+        "retirement_candidate": true,
+        "retirement_reason": "no measured usage in review window"
+      },
+      {
+        "interface": {
+          "id": "e4c140ec-7479-46f9-b185-4b533f19d639",
+          "interface_key": "rest_api:GET /workstreams/workplan-index",
+          "interface_kind": "rest_api",
+          "legacy_since": "2026-06-04T05:20:58.321869Z",
+          "replacement_ref": "/workplans/index",
+          "owner_component": "state-hub.api",
+          "status": "legacy",
+          "replacement_verified": true,
+          "manual_hold": false,
+          "hold_reason": null,
+          "notes": null,
+          "retired_at": null,
+          "created_at": "2026-06-04T05:20:58.321869Z",
+          "updated_at": "2026-06-04T05:20:58.321869Z"
+        },
+        "all_time": {
+          "calls": 30,
+          "tenant_count": 1,
+          "user_count": 1,
+          "component_count": 1,
+          "tenants": {
+            "unknown": 30
+          },
+          "users": {
+            "unknown": 30
+          },
+          "components": {
+            "unknown": 30
+          }
+        },
+        "window": {
+          "calls": 0,
+          "tenant_count": 0,
+          "user_count": 0,
+          "component_count": 0,
+          "tenants": {},
+          "users": {},
+          "components": {}
+        },
+        "last_seen_at": "2026-07-03T05:20:34.534439Z",
+        "retirement_candidate": true,
+        "retirement_reason": "no measured usage in review window"
+      },
+      {
+        "interface": {
+          "id": "3a00b19e-e7db-4403-98aa-a77c9ab61ecc",
+          "interface_key": "rest_api:GET /workstreams/{workstream_id}",
+          "interface_kind": "rest_api",
+          "legacy_since": "2026-06-04T00:25:59.014966Z",
+          "replacement_ref": "/workplans/{workplan_id}",
+          "owner_component": "state-hub.api",
+          "status": "legacy",
+          "replacement_verified": true,
+          "manual_hold": false,
+          "hold_reason": null,
+          "notes": null,
+          "retired_at": null,
+          "created_at": "2026-06-04T00:25:59.014966Z",
+          "updated_at": "2026-06-04T00:25:59.014966Z"
+        },
+        "all_time": {
+          "calls": 511406,
+          "tenant_count": 1,
+          "user_count": 1,
+          "component_count": 1,
+          "tenants": {
+            "unknown": 511406
+          },
+          "users": {
+            "unknown": 511406
+          },
+          "components": {
+            "unknown": 511406
+          }
+        },
+        "window": {
+          "calls": 0,
+          "tenant_count": 0,
+          "user_count": 0,
+          "component_count": 0,
+          "tenants": {},
+          "users": {},
+          "components": {}
+        },
+        "last_seen_at": "2026-07-31T16:25:32.004042Z",
+        "retirement_candidate": true,
+        "retirement_reason": "no measured usage in review window"
+      },
+      {
+        "interface": {
+          "id": "69e1a255-a8b9-4101-8a68-b1bed23abfda",
+          "interface_key": "rest_api:GET /workstreams/{workstream_id}/dependencies/",
+          "interface_kind": "rest_api",
+          "legacy_since": "2026-06-04T00:25:59.291135Z",
+          "replacement_ref": "/workplans/{workplan_id}/dependencies/",
+          "owner_component": "state-hub.api",
+          "status": "legacy",
+          "replacement_verified": true,
+          "manual_hold": false,
+          "hold_reason": null,
+          "notes": null,
+          "retired_at": null,
+          "created_at": "2026-06-04T00:25:59.291135Z",
+          "updated_at": "2026-06-04T00:25:59.291135Z"
+        },
+        "all_time": {
+          "calls": 255865,
+          "tenant_count": 1,
+          "user_count": 1,
+          "component_count": 1,
+          "tenants": {
+            "unknown": 255865
+          },
+          "users": {
+            "unknown": 255865
+          },
+          "components": {
+            "unknown": 255865
+          }
+        },
+        "window": {
+          "calls": 0,
+          "tenant_count": 0,
+          "user_count": 0,
+          "component_count": 0,
+          "tenants": {},
+          "users": {},
+          "components": {}
+        },
+        "last_seen_at": "2026-07-08T21:14:12.747005Z",
+        "retirement_candidate": true,
+        "retirement_reason": "no measured usage in review window"
+      },
+      {
+        "interface": {
+          "id": "b1aae931-b51f-4a85-a723-865dd65f6132",
+          "interface_key": "rest_api:PATCH /workstreams/{workstream_id}",
+          "interface_kind": "rest_api",
+          "legacy_since": "2026-06-04T06:09:41.901035Z",
+          "replacement_ref": "/workplans/{workplan_id}",
+          "owner_component": "state-hub.api",
+          "status": "legacy",
+          "replacement_verified": true,
+          "manual_hold": false,
+          "hold_reason": null,
+          "notes": null,
+          "retired_at": null,
+          "created_at": "2026-06-04T06:09:41.901035Z",
+          "updated_at": "2026-06-04T06:09:41.901035Z"
+        },
+        "all_time": {
+          "calls": 571,
+          "tenant_count": 1,
+          "user_count": 1,
+          "component_count": 1,
+          "tenants": {
+            "unknown": 571
+          },
+          "users": {
+            "unknown": 571
+          },
+          "components": {
+            "unknown": 571
+          }
+        },
+        "window": {
+          "calls": 0,
+          "tenant_count": 0,
+          "user_count": 0,
+          "component_count": 0,
+          "tenants": {},
+          "users": {},
+          "components": {}
+        },
+        "last_seen_at": "2026-07-08T20:49:12.335710Z",
+        "retirement_candidate": true,
+        "retirement_reason": "no measured usage in review window"
+      },
+      {
+        "interface": {
+          "id": "4aea9591-970b-4918-ac4a-4da95a0a1a8c",
+          "interface_key": "rest_api:POST /decisions/ workstream_id",
+          "interface_kind": "rest_api",
+          "legacy_since": "2026-07-09T22:56:35.473130Z",
+          "replacement_ref": "POST /decisions/ with workplan_id",
+          "owner_component": "state-hub.api",
+          "status": "legacy",
+          "replacement_verified": true,
+          "manual_hold": false,
+          "hold_reason": null,
+          "notes": null,
+          "retired_at": null,
+          "created_at": "2026-07-09T22:56:35.473130Z",
+          "updated_at": "2026-07-09T22:56:35.473130Z"
+        },
+        "all_time": {
+          "calls": 3,
+          "tenant_count": 1,
+          "user_count": 1,
+          "component_count": 1,
+          "tenants": {
+            "unknown": 3
+          },
+          "users": {
+            "unknown": 3
+          },
+          "components": {
+            "unknown": 3
+          }
+        },
+        "window": {
+          "calls": 0,
+          "tenant_count": 0,
+          "user_count": 0,
+          "component_count": 0,
+          "tenants": {},
+          "users": {},
+          "components": {}
+        },
+        "last_seen_at": "2026-07-09T22:57:05.912456Z",
+        "retirement_candidate": true,
+        "retirement_reason": "no measured usage in review window"
+      },
+      {
+        "interface": {
+          "id": "4a70583c-1e41-4ec1-99a9-728856a7d79c",
+          "interface_key": "rest_api:POST /progress/ workstream_id",
+          "interface_kind": "rest_api",
+          "legacy_since": "2026-07-08T23:35:09.148333Z",
+          "replacement_ref": "POST /progress/ with workplan_id",
+          "owner_component": "state-hub.api",
+          "status": "legacy",
+          "replacement_verified": true,
+          "manual_hold": false,
+          "hold_reason": null,
+          "notes": null,
+          "retired_at": null,
+          "created_at": "2026-07-08T23:35:09.148333Z",
+          "updated_at": "2026-07-08T23:35:09.148333Z"
+        },
+        "all_time": {
+          "calls": 14,
+          "tenant_count": 1,
+          "user_count": 1,
+          "component_count": 1,
+          "tenants": {
+            "unknown": 14
+          },
+          "users": {
+            "unknown": 14
+          },
+          "components": {
+            "unknown": 14
+          }
+        },
+        "window": {
+          "calls": 0,
+          "tenant_count": 0,
+          "user_count": 0,
+          "component_count": 0,
+          "tenants": {},
+          "users": {},
+          "components": {}
+        },
+        "last_seen_at": "2026-07-10T08:34:42.959724Z",
+        "retirement_candidate": true,
+        "retirement_reason": "no measured usage in review window"
+      },
+      {
+        "interface": {
+          "id": "6df4e443-7bf1-461a-923b-a6eb52fe7b07",
+          "interface_key": "rest_api:POST /tasks/ workstream_id",
+          "interface_kind": "rest_api",
+          "legacy_since": "2026-07-08T22:38:29.405720Z",
+          "replacement_ref": "POST /tasks/ with workplan_id",
+          "owner_component": "state-hub.api",
+          "status": "legacy",
+          "replacement_verified": true,
+          "manual_hold": false,
+          "hold_reason": null,
+          "notes": null,
+          "retired_at": null,
+          "created_at": "2026-07-08T22:38:29.405720Z",
+          "updated_at": "2026-07-08T22:38:29.405720Z"
+        },
+        "all_time": {
+          "calls": 5,
+          "tenant_count": 1,
+          "user_count": 1,
+          "component_count": 1,
+          "tenants": {
+            "unknown": 5
+          },
+          "users": {
+            "unknown": 5
+          },
+          "components": {
+            "state-hub.fix-consistency": 5
+          }
+        },
+        "window": {
+          "calls": 0,
+          "tenant_count": 0,
+          "user_count": 0,
+          "component_count": 0,
+          "tenants": {},
+          "users": {},
+          "components": {}
+        },
+        "last_seen_at": "2026-07-08T22:38:29.976918Z",
+        "retirement_candidate": true,
+        "retirement_reason": "no measured usage in review window"
+      },
+      {
+        "interface": {
+          "id": "ed6451c9-d2cc-4486-9afe-d3852782cabc",
+          "interface_key": "rest_api:POST /workstreams/",
+          "interface_kind": "rest_api",
+          "legacy_since": "2026-06-04T07:40:24.168535Z",
+          "replacement_ref": "/workplans/",
+          "owner_component": "state-hub.api",
+          "status": "legacy",
+          "replacement_verified": true,
+          "manual_hold": false,
+          "hold_reason": null,
+          "notes": null,
+          "retired_at": null,
+          "created_at": "2026-06-04T07:40:24.168535Z",
+          "updated_at": "2026-06-04T07:40:24.168535Z"
+        },
+        "all_time": {
+          "calls": 824,
+          "tenant_count": 1,
+          "user_count": 1,
+          "component_count": 1,
+          "tenants": {
+            "unknown": 824
+          },
+          "users": {
+            "unknown": 824
+          },
+          "components": {
+            "unknown": 824
+          }
+        },
+        "window": {
+          "calls": 0,
+          "tenant_count": 0,
+          "user_count": 0,
+          "component_count": 0,
+          "tenants": {},
+          "users": {},
+          "components": {}
+        },
+        "last_seen_at": "2026-07-08T20:38:05.903144Z",
+        "retirement_candidate": true,
+        "retirement_reason": "no measured usage in review window"
+      },
+      {
+        "interface": {
+          "id": "281fd706-b192-4194-8055-2d8733c115f9",
+          "interface_key": "rest_api:POST /workstreams/{workstream_id}/dependencies/",
+          "interface_kind": "rest_api",
+          "legacy_since": "2026-06-04T22:57:37.149207Z",
+          "replacement_ref": "/workplans/{workplan_id}/dependencies/",
+          "owner_component": "state-hub.api",
+          "status": "legacy",
+          "replacement_verified": true,
+          "manual_hold": false,
+          "hold_reason": null,
+          "notes": null,
+          "retired_at": null,
+          "created_at": "2026-06-04T22:57:37.149207Z",
+          "updated_at": "2026-06-04T22:57:37.149207Z"
+        },
+        "all_time": {
+          "calls": 4971,
+          "tenant_count": 1,
+          "user_count": 1,
+          "component_count": 1,
+          "tenants": {
+            "unknown": 4971
+          },
+          "users": {
+            "unknown": 4971
+          },
+          "components": {
+            "unknown": 4971
+          }
+        },
+        "window": {
+          "calls": 0,
+          "tenant_count": 0,
+          "user_count": 0,
+          "component_count": 0,
+          "tenants": {},
+          "users": {},
+          "components": {}
+        },
+        "last_seen_at": "2026-07-01T22:09:24.229011Z",
+        "retirement_candidate": true,
+        "retirement_reason": "no measured usage in review window"
+      }
+    ]
+  },
+  "hours": 8
+}
diff --git a/docs/evidence/legacy-meter-weekly-review-20260807.json b/docs/evidence/legacy-meter-weekly-review-20260807.json
new file mode 100644
index 0000000..353afeb
--- /dev/null
+++ b/docs/evidence/legacy-meter-weekly-review-20260807.json
@@ -0,0 +1,1755 @@
+{
+  "captured_at": "2026-08-07T14:00:07.840863+00:00",
+  "api_base": "http://127.0.0.1:8000",
+  "workplan": "STATE-WP-0070",
+  "retired_interfaces": [],
+  "weekly_review": {
+    "generated_at": "2026-08-07T14:00:07.834960Z",
+    "window_start": "2026-08-07T06:00:07.779478Z",
+    "window_end": "2026-08-07T14:00:07.779478Z",
+    "cadence": "weekly",
+    "activity_core_handoff": {
+      "activity_id": "statehub-legacy-interface-review",
+      "cadence": "weekly",
+      "source_endpoint": "/legacy-meter/weekly-review",
+      "state_owner": "state-hub",
+      "scheduler_owner": "activity-core"
+    },
+    "interfaces": [
+      {
+        "interface": {
+          "id": "8051fb40-66c9-4dc4-a413-13e8573e04a3",
+          "interface_key": "event_subject:org.statehub.workstream.completed",
+          "interface_kind": "event_subject",
+          "legacy_since": "2026-06-04T06:09:42.198193Z",
+          "replacement_ref": "org.statehub.workplan.completed",
+          "owner_component": "state-hub.events",
+          "status": "retired",
+          "replacement_verified": true,
+          "manual_hold": false,
+          "hold_reason": null,
+          "notes": "Retired by STATE-WP-0069 closeout",
+          "retired_at": "2026-07-08T21:38:52.773601Z",
+          "created_at": "2026-06-04T06:09:42.198193Z",
+          "updated_at": "2026-07-08T21:38:52.761243Z"
+        },
+        "all_time": {
+          "calls": 255,
+          "tenant_count": 1,
+          "user_count": 1,
+          "component_count": 1,
+          "tenants": {
+            "unknown": 255
+          },
+          "users": {
+            "unknown": 255
+          },
+          "components": {
+            "state-hub.events": 255
+          }
+        },
+        "window": {
+          "calls": 0,
+          "tenant_count": 0,
+          "user_count": 0,
+          "component_count": 0,
+          "tenants": {},
+          "users": {},
+          "components": {}
+        },
+        "last_seen_at": "2026-07-08T20:49:12.839383Z",
+        "retirement_candidate": false,
+        "retirement_reason": "already retired"
+      },
+      {
+        "interface": {
+          "id": "63ed90e3-42b4-431a-94db-e1254a52f9e2",
+          "interface_key": "mcp:create_workstream",
+          "interface_kind": "mcp_tool",
+          "legacy_since": "2026-07-10T13:19:44.205900Z",
+          "replacement_ref": "create_workplan",
+          "owner_component": "state-hub.mcp",
+          "status": "legacy",
+          "replacement_verified": true,
+          "manual_hold": false,
+          "hold_reason": null,
+          "notes": "Registered by STATE-WP-0070 T03 \u2014 zero-window streak starts at registration",
+          "retired_at": null,
+          "created_at": "2026-07-10T13:19:44.205900Z",
+          "updated_at": "2026-07-10T13:19:44.205900Z"
+        },
+        "all_time": {
+          "calls": 2,
+          "tenant_count": 1,
+          "user_count": 1,
+          "component_count": 1,
+          "tenants": {
+            "unknown": 2
+          },
+          "users": {
+            "unknown": 2
+          },
+          "components": {
+            "state-hub.mcp": 2
+          }
+        },
+        "window": {
+          "calls": 0,
+          "tenant_count": 0,
+          "user_count": 0,
+          "component_count": 0,
+          "tenants": {},
+          "users": {},
+          "components": {}
+        },
+        "last_seen_at": "2026-07-10T13:20:43.378546Z",
+        "retirement_candidate": true,
+        "retirement_reason": "no measured usage in review window"
+      },
+      {
+        "interface": {
+          "id": "b6a5fe44-fb85-4ef7-a273-78d09da777af",
+          "interface_key": "mcp:list_workstreams",
+          "interface_kind": "mcp_tool",
+          "legacy_since": "2026-07-10T13:19:26.075491Z",
+          "replacement_ref": "list_workplans",
+          "owner_component": "state-hub.mcp",
+          "status": "legacy",
+          "replacement_verified": true,
+          "manual_hold": false,
+          "hold_reason": null,
+          "notes": null,
+          "retired_at": null,
+          "created_at": "2026-07-10T13:19:26.075491Z",
+          "updated_at": "2026-07-10T13:19:26.075491Z"
+        },
+        "all_time": {
+          "calls": 2,
+          "tenant_count": 1,
+          "user_count": 1,
+          "component_count": 1,
+          "tenants": {
+            "unknown": 2
+          },
+          "users": {
+            "unknown": 2
+          },
+          "components": {
+            "state-hub.mcp": 2
+          }
+        },
+        "window": {
+          "calls": 0,
+          "tenant_count": 0,
+          "user_count": 0,
+          "component_count": 0,
+          "tenants": {},
+          "users": {},
+          "components": {}
+        },
+        "last_seen_at": "2026-07-10T13:20:42.374940Z",
+        "retirement_candidate": true,
+        "retirement_reason": "no measured usage in review window"
+      },
+      {
+        "interface": {
+          "id": "53c3372b-307d-4d6a-8ea4-bc36cacdcaf2",
+          "interface_key": "mcp:update_workstream",
+          "interface_kind": "mcp_tool",
+          "legacy_since": "2026-07-10T13:19:44.255216Z",
+          "replacement_ref": "update_workplan",
+          "owner_component": "state-hub.mcp",
+          "status": "legacy",
+          "replacement_verified": true,
+          "manual_hold": false,
+          "hold_reason": null,
+          "notes": "Registered by STATE-WP-0070 T03 \u2014 zero-window streak starts at registration",
+          "retired_at": null,
+          "created_at": "2026-07-10T13:19:44.255216Z",
+          "updated_at": "2026-07-10T13:19:44.255216Z"
+        },
+        "all_time": {
+          "calls": 0,
+          "tenant_count": 0,
+          "user_count": 0,
+          "component_count": 0,
+          "tenants": {},
+          "users": {},
+          "components": {}
+        },
+        "window": {
+          "calls": 0,
+          "tenant_count": 0,
+          "user_count": 0,
+          "component_count": 0,
+          "tenants": {},
+          "users": {},
+          "components": {}
+        },
+        "last_seen_at": null,
+        "retirement_candidate": true,
+        "retirement_reason": "no measured usage in review window"
+      },
+      {
+        "interface": {
+          "id": "bed4d08a-3471-48f5-9f0e-f9d550383a26",
+          "interface_key": "mcp:update_workstream_status",
+          "interface_kind": "mcp_tool",
+          "legacy_since": "2026-07-10T13:19:44.303612Z",
+          "replacement_ref": "update_workplan_status",
+          "owner_component": "state-hub.mcp",
+          "status": "legacy",
+          "replacement_verified": true,
+          "manual_hold": false,
+          "hold_reason": null,
+          "notes": "Registered by STATE-WP-0070 T03 \u2014 zero-window streak starts at registration",
+          "retired_at": null,
+          "created_at": "2026-07-10T13:19:44.303612Z",
+          "updated_at": "2026-07-10T13:19:44.303612Z"
+        },
+        "all_time": {
+          "calls": 0,
+          "tenant_count": 0,
+          "user_count": 0,
+          "component_count": 0,
+          "tenants": {},
+          "users": {},
+          "components": {}
+        },
+        "window": {
+          "calls": 0,
+          "tenant_count": 0,
+          "user_count": 0,
+          "component_count": 0,
+          "tenants": {},
+          "users": {},
+          "components": {}
+        },
+        "last_seen_at": null,
+        "retirement_candidate": true,
+        "retirement_reason": "no measured usage in review window"
+      },
+      {
+        "interface": {
+          "id": "46900dc2-0893-405b-ba59-80f31fb6ebb1",
+          "interface_key": "state://workstreams/{topic_slug}",
+          "interface_kind": "mcp_tool",
+          "legacy_since": "2026-07-10T13:19:44.344493Z",
+          "replacement_ref": "state://workplans/{topic_slug}",
+          "owner_component": "state-hub.mcp",
+          "status": "legacy",
+          "replacement_verified": true,
+          "manual_hold": false,
+          "hold_reason": null,
+          "notes": "Registered by STATE-WP-0070 T03 \u2014 zero-window streak starts at registration",
+          "retired_at": null,
+          "created_at": "2026-07-10T13:19:44.344493Z",
+          "updated_at": "2026-07-10T13:19:44.344493Z"
+        },
+        "all_time": {
+          "calls": 1,
+          "tenant_count": 1,
+          "user_count": 1,
+          "component_count": 1,
+          "tenants": {
+            "unknown": 1
+          },
+          "users": {
+            "unknown": 1
+          },
+          "components": {
+            "state-hub.mcp": 1
+          }
+        },
+        "window": {
+          "calls": 0,
+          "tenant_count": 0,
+          "user_count": 0,
+          "component_count": 0,
+          "tenants": {},
+          "users": {},
+          "components": {}
+        },
+        "last_seen_at": "2026-07-10T13:20:34.491811Z",
+        "retirement_candidate": true,
+        "retirement_reason": "no measured usage in review window"
+      },
+      {
+        "interface": {
+          "id": "cd9342fd-27e7-4a46-a1be-d41499e106a3",
+          "interface_key": "rest_api:DELETE /workstreams/{workstream_id}",
+          "interface_kind": "rest_api",
+          "legacy_since": "2026-06-06T17:28:13.052813Z",
+          "replacement_ref": "/workplans/{workplan_id}",
+          "owner_component": "state-hub.api",
+          "status": "legacy",
+          "replacement_verified": true,
+          "manual_hold": false,
+          "hold_reason": null,
+          "notes": null,
+          "retired_at": null,
+          "created_at": "2026-06-06T17:28:13.052813Z",
+          "updated_at": "2026-06-06T17:28:13.052813Z"
+        },
+        "all_time": {
+          "calls": 1,
+          "tenant_count": 1,
+          "user_count": 1,
+          "component_count": 1,
+          "tenants": {
+            "unknown": 1
+          },
+          "users": {
+            "unknown": 1
+          },
+          "components": {
+            "unknown": 1
+          }
+        },
+        "window": {
+          "calls": 0,
+          "tenant_count": 0,
+          "user_count": 0,
+          "component_count": 0,
+          "tenants": {},
+          "users": {},
+          "components": {}
+        },
+        "last_seen_at": "2026-06-06T17:28:13.047529Z",
+        "retirement_candidate": true,
+        "retirement_reason": "no measured usage in review window"
+      },
+      {
+        "interface": {
+          "id": "a4e0948c-cd4a-461e-8ae2-7fd7b51d04a7",
+          "interface_key": "rest_api:GET /decisions/?workstream_id",
+          "interface_kind": "rest_api",
+          "legacy_since": "2026-07-09T23:07:53.093223Z",
+          "replacement_ref": "/decisions/?workplan_id=<workplan_id>",
+          "owner_component": "state-hub.api",
+          "status": "legacy",
+          "replacement_verified": true,
+          "manual_hold": false,
+          "hold_reason": null,
+          "notes": null,
+          "retired_at": null,
+          "created_at": "2026-07-09T23:07:53.093223Z",
+          "updated_at": "2026-07-09T23:07:53.093223Z"
+        },
+        "all_time": {
+          "calls": 1,
+          "tenant_count": 1,
+          "user_count": 1,
+          "component_count": 1,
+          "tenants": {
+            "unknown": 1
+          },
+          "users": {
+            "unknown": 1
+          },
+          "components": {
+            "unknown": 1
+          }
+        },
+        "window": {
+          "calls": 0,
+          "tenant_count": 0,
+          "user_count": 0,
+          "component_count": 0,
+          "tenants": {},
+          "users": {},
+          "components": {}
+        },
+        "last_seen_at": "2026-07-09T23:07:53.083299Z",
+        "retirement_candidate": true,
+        "retirement_reason": "no measured usage in review window"
+      },
+      {
+        "interface": {
+          "id": "70a9346e-e0ee-42ac-874f-f160580b54dd",
+          "interface_key": "rest_api:GET /progress/?workstream_id",
+          "interface_kind": "rest_api",
+          "legacy_since": "2026-07-13T22:04:03.911449Z",
+          "replacement_ref": "/progress/?workplan_id=<workplan_id>",
+          "owner_component": "state-hub.api",
+          "status": "legacy",
+          "replacement_verified": true,
+          "manual_hold": false,
+          "hold_reason": null,
+          "notes": null,
+          "retired_at": null,
+          "created_at": "2026-07-13T22:04:03.911449Z",
+          "updated_at": "2026-07-13T22:04:03.911449Z"
+        },
+        "all_time": {
+          "calls": 1,
+          "tenant_count": 1,
+          "user_count": 1,
+          "component_count": 1,
+          "tenants": {
+            "unknown": 1
+          },
+          "users": {
+            "unknown": 1
+          },
+          "components": {
+            "unknown": 1
+          }
+        },
+        "window": {
+          "calls": 0,
+          "tenant_count": 0,
+          "user_count": 0,
+          "component_count": 0,
+          "tenants": {},
+          "users": {},
+          "components": {}
+        },
+        "last_seen_at": "2026-07-13T22:04:03.904998Z",
+        "retirement_candidate": true,
+        "retirement_reason": "no measured usage in review window"
+      },
+      {
+        "interface": {
+          "id": "be3cdcf8-250b-4bf0-801f-02ffd5f57e00",
+          "interface_key": "rest_api:GET /tasks/?workstream_id",
+          "interface_kind": "rest_api",
+          "legacy_since": "2026-07-08T19:32:21.628513Z",
+          "replacement_ref": "/tasks/?workplan_id=<workplan_id>",
+          "owner_component": "state-hub.api",
+          "status": "legacy",
+          "replacement_verified": true,
+          "manual_hold": false,
+          "hold_reason": null,
+          "notes": null,
+          "retired_at": null,
+          "created_at": "2026-07-08T19:32:21.628513Z",
+          "updated_at": "2026-07-08T19:32:21.628513Z"
+        },
+        "all_time": {
+          "calls": 589,
+          "tenant_count": 1,
+          "user_count": 1,
+          "component_count": 1,
+          "tenants": {
+            "unknown": 589
+          },
+          "users": {
+            "unknown": 589
+          },
+          "components": {
+            "unknown": 589
+          }
+        },
+        "window": {
+          "calls": 0,
+          "tenant_count": 0,
+          "user_count": 0,
+          "component_count": 0,
+          "tenants": {},
+          "users": {},
+          "components": {}
+        },
+        "last_seen_at": "2026-07-31T16:25:32.181901Z",
+        "retirement_candidate": true,
+        "retirement_reason": "no measured usage in review window"
+      },
+      {
+        "interface": {
+          "id": "3e4a3d0b-08fa-45c3-91e2-4f514a914b97",
+          "interface_key": "rest_api:GET /workstreams/",
+          "interface_kind": "rest_api",
+          "legacy_since": "2026-06-04T00:26:14.533764Z",
+          "replacement_ref": "/workplans/",
+          "owner_component": "state-hub.api",
+          "status": "legacy",
+          "replacement_verified": true,
+          "manual_hold": false,
+          "hold_reason": null,
+          "notes": null,
+          "retired_at": null,
+          "created_at": "2026-06-04T00:26:14.533764Z",
+          "updated_at": "2026-06-04T00:26:14.533764Z"
+        },
+        "all_time": {
+          "calls": 144085,
+          "tenant_count": 1,
+          "user_count": 1,
+          "component_count": 1,
+          "tenants": {
+            "unknown": 144085
+          },
+          "users": {
+            "unknown": 144085
+          },
+          "components": {
+            "unknown": 144085
+          }
+        },
+        "window": {
+          "calls": 0,
+          "tenant_count": 0,
+          "user_count": 0,
+          "component_count": 0,
+          "tenants": {},
+          "users": {},
+          "components": {}
+        },
+        "last_seen_at": "2026-08-05T13:01:38.000781Z",
+        "retirement_candidate": true,
+        "retirement_reason": "no measured usage in review window"
+      },
+      {
+        "interface": {
+          "id": "e4c140ec-7479-46f9-b185-4b533f19d639",
+          "interface_key": "rest_api:GET /workstreams/workplan-index",
+          "interface_kind": "rest_api",
+          "legacy_since": "2026-06-04T05:20:58.321869Z",
+          "replacement_ref": "/workplans/index",
+          "owner_component": "state-hub.api",
+          "status": "legacy",
+          "replacement_verified": true,
+          "manual_hold": false,
+          "hold_reason": null,
+          "notes": null,
+          "retired_at": null,
+          "created_at": "2026-06-04T05:20:58.321869Z",
+          "updated_at": "2026-06-04T05:20:58.321869Z"
+        },
+        "all_time": {
+          "calls": 30,
+          "tenant_count": 1,
+          "user_count": 1,
+          "component_count": 1,
+          "tenants": {
+            "unknown": 30
+          },
+          "users": {
+            "unknown": 30
+          },
+          "components": {
+            "unknown": 30
+          }
+        },
+        "window": {
+          "calls": 0,
+          "tenant_count": 0,
+          "user_count": 0,
+          "component_count": 0,
+          "tenants": {},
+          "users": {},
+          "components": {}
+        },
+        "last_seen_at": "2026-07-03T05:20:34.534439Z",
+        "retirement_candidate": true,
+        "retirement_reason": "no measured usage in review window"
+      },
+      {
+        "interface": {
+          "id": "3a00b19e-e7db-4403-98aa-a77c9ab61ecc",
+          "interface_key": "rest_api:GET /workstreams/{workstream_id}",
+          "interface_kind": "rest_api",
+          "legacy_since": "2026-06-04T00:25:59.014966Z",
+          "replacement_ref": "/workplans/{workplan_id}",
+          "owner_component": "state-hub.api",
+          "status": "legacy",
+          "replacement_verified": true,
+          "manual_hold": false,
+          "hold_reason": null,
+          "notes": null,
+          "retired_at": null,
+          "created_at": "2026-06-04T00:25:59.014966Z",
+          "updated_at": "2026-06-04T00:25:59.014966Z"
+        },
+        "all_time": {
+          "calls": 511406,
+          "tenant_count": 1,
+          "user_count": 1,
+          "component_count": 1,
+          "tenants": {
+            "unknown": 511406
+          },
+          "users": {
+            "unknown": 511406
+          },
+          "components": {
+            "unknown": 511406
+          }
+        },
+        "window": {
+          "calls": 0,
+          "tenant_count": 0,
+          "user_count": 0,
+          "component_count": 0,
+          "tenants": {},
+          "users": {},
+          "components": {}
+        },
+        "last_seen_at": "2026-07-31T16:25:32.004042Z",
+        "retirement_candidate": true,
+        "retirement_reason": "no measured usage in review window"
+      },
+      {
+        "interface": {
+          "id": "69e1a255-a8b9-4101-8a68-b1bed23abfda",
+          "interface_key": "rest_api:GET /workstreams/{workstream_id}/dependencies/",
+          "interface_kind": "rest_api",
+          "legacy_since": "2026-06-04T00:25:59.291135Z",
+          "replacement_ref": "/workplans/{workplan_id}/dependencies/",
+          "owner_component": "state-hub.api",
+          "status": "legacy",
+          "replacement_verified": true,
+          "manual_hold": false,
+          "hold_reason": null,
+          "notes": null,
+          "retired_at": null,
+          "created_at": "2026-06-04T00:25:59.291135Z",
+          "updated_at": "2026-06-04T00:25:59.291135Z"
+        },
+        "all_time": {
+          "calls": 255865,
+          "tenant_count": 1,
+          "user_count": 1,
+          "component_count": 1,
+          "tenants": {
+            "unknown": 255865
+          },
+          "users": {
+            "unknown": 255865
+          },
+          "components": {
+            "unknown": 255865
+          }
+        },
+        "window": {
+          "calls": 0,
+          "tenant_count": 0,
+          "user_count": 0,
+          "component_count": 0,
+          "tenants": {},
+          "users": {},
+          "components": {}
+        },
+        "last_seen_at": "2026-07-08T21:14:12.747005Z",
+        "retirement_candidate": true,
+        "retirement_reason": "no measured usage in review window"
+      },
+      {
+        "interface": {
+          "id": "b1aae931-b51f-4a85-a723-865dd65f6132",
+          "interface_key": "rest_api:PATCH /workstreams/{workstream_id}",
+          "interface_kind": "rest_api",
+          "legacy_since": "2026-06-04T06:09:41.901035Z",
+          "replacement_ref": "/workplans/{workplan_id}",
+          "owner_component": "state-hub.api",
+          "status": "legacy",
+          "replacement_verified": true,
+          "manual_hold": false,
+          "hold_reason": null,
+          "notes": null,
+          "retired_at": null,
+          "created_at": "2026-06-04T06:09:41.901035Z",
+          "updated_at": "2026-06-04T06:09:41.901035Z"
+        },
+        "all_time": {
+          "calls": 571,
+          "tenant_count": 1,
+          "user_count": 1,
+          "component_count": 1,
+          "tenants": {
+            "unknown": 571
+          },
+          "users": {
+            "unknown": 571
+          },
+          "components": {
+            "unknown": 571
+          }
+        },
+        "window": {
+          "calls": 0,
+          "tenant_count": 0,
+          "user_count": 0,
+          "component_count": 0,
+          "tenants": {},
+          "users": {},
+          "components": {}
+        },
+        "last_seen_at": "2026-07-08T20:49:12.335710Z",
+        "retirement_candidate": true,
+        "retirement_reason": "no measured usage in review window"
+      },
+      {
+        "interface": {
+          "id": "4aea9591-970b-4918-ac4a-4da95a0a1a8c",
+          "interface_key": "rest_api:POST /decisions/ workstream_id",
+          "interface_kind": "rest_api",
+          "legacy_since": "2026-07-09T22:56:35.473130Z",
+          "replacement_ref": "POST /decisions/ with workplan_id",
+          "owner_component": "state-hub.api",
+          "status": "legacy",
+          "replacement_verified": true,
+          "manual_hold": false,
+          "hold_reason": null,
+          "notes": null,
+          "retired_at": null,
+          "created_at": "2026-07-09T22:56:35.473130Z",
+          "updated_at": "2026-07-09T22:56:35.473130Z"
+        },
+        "all_time": {
+          "calls": 3,
+          "tenant_count": 1,
+          "user_count": 1,
+          "component_count": 1,
+          "tenants": {
+            "unknown": 3
+          },
+          "users": {
+            "unknown": 3
+          },
+          "components": {
+            "unknown": 3
+          }
+        },
+        "window": {
+          "calls": 0,
+          "tenant_count": 0,
+          "user_count": 0,
+          "component_count": 0,
+          "tenants": {},
+          "users": {},
+          "components": {}
+        },
+        "last_seen_at": "2026-07-09T22:57:05.912456Z",
+        "retirement_candidate": true,
+        "retirement_reason": "no measured usage in review window"
+      },
+      {
+        "interface": {
+          "id": "4a70583c-1e41-4ec1-99a9-728856a7d79c",
+          "interface_key": "rest_api:POST /progress/ workstream_id",
+          "interface_kind": "rest_api",
+          "legacy_since": "2026-07-08T23:35:09.148333Z",
+          "replacement_ref": "POST /progress/ with workplan_id",
+          "owner_component": "state-hub.api",
+          "status": "legacy",
+          "replacement_verified": true,
+          "manual_hold": false,
+          "hold_reason": null,
+          "notes": null,
+          "retired_at": null,
+          "created_at": "2026-07-08T23:35:09.148333Z",
+          "updated_at": "2026-07-08T23:35:09.148333Z"
+        },
+        "all_time": {
+          "calls": 14,
+          "tenant_count": 1,
+          "user_count": 1,
+          "component_count": 1,
+          "tenants": {
+            "unknown": 14
+          },
+          "users": {
+            "unknown": 14
+          },
+          "components": {
+            "unknown": 14
+          }
+        },
+        "window": {
+          "calls": 0,
+          "tenant_count": 0,
+          "user_count": 0,
+          "component_count": 0,
+          "tenants": {},
+          "users": {},
+          "components": {}
+        },
+        "last_seen_at": "2026-07-10T08:34:42.959724Z",
+        "retirement_candidate": true,
+        "retirement_reason": "no measured usage in review window"
+      },
+      {
+        "interface": {
+          "id": "6df4e443-7bf1-461a-923b-a6eb52fe7b07",
+          "interface_key": "rest_api:POST /tasks/ workstream_id",
+          "interface_kind": "rest_api",
+          "legacy_since": "2026-07-08T22:38:29.405720Z",
+          "replacement_ref": "POST /tasks/ with workplan_id",
+          "owner_component": "state-hub.api",
+          "status": "legacy",
+          "replacement_verified": true,
+          "manual_hold": false,
+          "hold_reason": null,
+          "notes": null,
+          "retired_at": null,
+          "created_at": "2026-07-08T22:38:29.405720Z",
+          "updated_at": "2026-07-08T22:38:29.405720Z"
+        },
+        "all_time": {
+          "calls": 5,
+          "tenant_count": 1,
+          "user_count": 1,
+          "component_count": 1,
+          "tenants": {
+            "unknown": 5
+          },
+          "users": {
+            "unknown": 5
+          },
+          "components": {
+            "state-hub.fix-consistency": 5
+          }
+        },
+        "window": {
+          "calls": 0,
+          "tenant_count": 0,
+          "user_count": 0,
+          "component_count": 0,
+          "tenants": {},
+          "users": {},
+          "components": {}
+        },
+        "last_seen_at": "2026-07-08T22:38:29.976918Z",
+        "retirement_candidate": true,
+        "retirement_reason": "no measured usage in review window"
+      },
+      {
+        "interface": {
+          "id": "ed6451c9-d2cc-4486-9afe-d3852782cabc",
+          "interface_key": "rest_api:POST /workstreams/",
+          "interface_kind": "rest_api",
+          "legacy_since": "2026-06-04T07:40:24.168535Z",
+          "replacement_ref": "/workplans/",
+          "owner_component": "state-hub.api",
+          "status": "legacy",
+          "replacement_verified": true,
+          "manual_hold": false,
+          "hold_reason": null,
+          "notes": null,
+          "retired_at": null,
+          "created_at": "2026-06-04T07:40:24.168535Z",
+          "updated_at": "2026-06-04T07:40:24.168535Z"
+        },
+        "all_time": {
+          "calls": 824,
+          "tenant_count": 1,
+          "user_count": 1,
+          "component_count": 1,
+          "tenants": {
+            "unknown": 824
+          },
+          "users": {
+            "unknown": 824
+          },
+          "components": {
+            "unknown": 824
+          }
+        },
+        "window": {
+          "calls": 0,
+          "tenant_count": 0,
+          "user_count": 0,
+          "component_count": 0,
+          "tenants": {},
+          "users": {},
+          "components": {}
+        },
+        "last_seen_at": "2026-07-08T20:38:05.903144Z",
+        "retirement_candidate": true,
+        "retirement_reason": "no measured usage in review window"
+      },
+      {
+        "interface": {
+          "id": "281fd706-b192-4194-8055-2d8733c115f9",
+          "interface_key": "rest_api:POST /workstreams/{workstream_id}/dependencies/",
+          "interface_kind": "rest_api",
+          "legacy_since": "2026-06-04T22:57:37.149207Z",
+          "replacement_ref": "/workplans/{workplan_id}/dependencies/",
+          "owner_component": "state-hub.api",
+          "status": "legacy",
+          "replacement_verified": true,
+          "manual_hold": false,
+          "hold_reason": null,
+          "notes": null,
+          "retired_at": null,
+          "created_at": "2026-06-04T22:57:37.149207Z",
+          "updated_at": "2026-06-04T22:57:37.149207Z"
+        },
+        "all_time": {
+          "calls": 4971,
+          "tenant_count": 1,
+          "user_count": 1,
+          "component_count": 1,
+          "tenants": {
+            "unknown": 4971
+          },
+          "users": {
+            "unknown": 4971
+          },
+          "components": {
+            "unknown": 4971
+          }
+        },
+        "window": {
+          "calls": 0,
+          "tenant_count": 0,
+          "user_count": 0,
+          "component_count": 0,
+          "tenants": {},
+          "users": {},
+          "components": {}
+        },
+        "last_seen_at": "2026-07-01T22:09:24.229011Z",
+        "retirement_candidate": true,
+        "retirement_reason": "no measured usage in review window"
+      }
+    ],
+    "retirement_candidates": [
+      {
+        "interface": {
+          "id": "63ed90e3-42b4-431a-94db-e1254a52f9e2",
+          "interface_key": "mcp:create_workstream",
+          "interface_kind": "mcp_tool",
+          "legacy_since": "2026-07-10T13:19:44.205900Z",
+          "replacement_ref": "create_workplan",
+          "owner_component": "state-hub.mcp",
+          "status": "legacy",
+          "replacement_verified": true,
+          "manual_hold": false,
+          "hold_reason": null,
+          "notes": "Registered by STATE-WP-0070 T03 \u2014 zero-window streak starts at registration",
+          "retired_at": null,
+          "created_at": "2026-07-10T13:19:44.205900Z",
+          "updated_at": "2026-07-10T13:19:44.205900Z"
+        },
+        "all_time": {
+          "calls": 2,
+          "tenant_count": 1,
+          "user_count": 1,
+          "component_count": 1,
+          "tenants": {
+            "unknown": 2
+          },
+          "users": {
+            "unknown": 2
+          },
+          "components": {
+            "state-hub.mcp": 2
+          }
+        },
+        "window": {
+          "calls": 0,
+          "tenant_count": 0,
+          "user_count": 0,
+          "component_count": 0,
+          "tenants": {},
+          "users": {},
+          "components": {}
+        },
+        "last_seen_at": "2026-07-10T13:20:43.378546Z",
+        "retirement_candidate": true,
+        "retirement_reason": "no measured usage in review window"
+      },
+      {
+        "interface": {
+          "id": "b6a5fe44-fb85-4ef7-a273-78d09da777af",
+          "interface_key": "mcp:list_workstreams",
+          "interface_kind": "mcp_tool",
+          "legacy_since": "2026-07-10T13:19:26.075491Z",
+          "replacement_ref": "list_workplans",
+          "owner_component": "state-hub.mcp",
+          "status": "legacy",
+          "replacement_verified": true,
+          "manual_hold": false,
+          "hold_reason": null,
+          "notes": null,
+          "retired_at": null,
+          "created_at": "2026-07-10T13:19:26.075491Z",
+          "updated_at": "2026-07-10T13:19:26.075491Z"
+        },
+        "all_time": {
+          "calls": 2,
+          "tenant_count": 1,
+          "user_count": 1,
+          "component_count": 1,
+          "tenants": {
+            "unknown": 2
+          },
+          "users": {
+            "unknown": 2
+          },
+          "components": {
+            "state-hub.mcp": 2
+          }
+        },
+        "window": {
+          "calls": 0,
+          "tenant_count": 0,
+          "user_count": 0,
+          "component_count": 0,
+          "tenants": {},
+          "users": {},
+          "components": {}
+        },
+        "last_seen_at": "2026-07-10T13:20:42.374940Z",
+        "retirement_candidate": true,
+        "retirement_reason": "no measured usage in review window"
+      },
+      {
+        "interface": {
+          "id": "53c3372b-307d-4d6a-8ea4-bc36cacdcaf2",
+          "interface_key": "mcp:update_workstream",
+          "interface_kind": "mcp_tool",
+          "legacy_since": "2026-07-10T13:19:44.255216Z",
+          "replacement_ref": "update_workplan",
+          "owner_component": "state-hub.mcp",
+          "status": "legacy",
+          "replacement_verified": true,
+          "manual_hold": false,
+          "hold_reason": null,
+          "notes": "Registered by STATE-WP-0070 T03 \u2014 zero-window streak starts at registration",
+          "retired_at": null,
+          "created_at": "2026-07-10T13:19:44.255216Z",
+          "updated_at": "2026-07-10T13:19:44.255216Z"
+        },
+        "all_time": {
+          "calls": 0,
+          "tenant_count": 0,
+          "user_count": 0,
+          "component_count": 0,
+          "tenants": {},
+          "users": {},
+          "components": {}
+        },
+        "window": {
+          "calls": 0,
+          "tenant_count": 0,
+          "user_count": 0,
+          "component_count": 0,
+          "tenants": {},
+          "users": {},
+          "components": {}
+        },
+        "last_seen_at": null,
+        "retirement_candidate": true,
+        "retirement_reason": "no measured usage in review window"
+      },
+      {
+        "interface": {
+          "id": "bed4d08a-3471-48f5-9f0e-f9d550383a26",
+          "interface_key": "mcp:update_workstream_status",
+          "interface_kind": "mcp_tool",
+          "legacy_since": "2026-07-10T13:19:44.303612Z",
+          "replacement_ref": "update_workplan_status",
+          "owner_component": "state-hub.mcp",
+          "status": "legacy",
+          "replacement_verified": true,
+          "manual_hold": false,
+          "hold_reason": null,
+          "notes": "Registered by STATE-WP-0070 T03 \u2014 zero-window streak starts at registration",
+          "retired_at": null,
+          "created_at": "2026-07-10T13:19:44.303612Z",
+          "updated_at": "2026-07-10T13:19:44.303612Z"
+        },
+        "all_time": {
+          "calls": 0,
+          "tenant_count": 0,
+          "user_count": 0,
+          "component_count": 0,
+          "tenants": {},
+          "users": {},
+          "components": {}
+        },
+        "window": {
+          "calls": 0,
+          "tenant_count": 0,
+          "user_count": 0,
+          "component_count": 0,
+          "tenants": {},
+          "users": {},
+          "components": {}
+        },
+        "last_seen_at": null,
+        "retirement_candidate": true,
+        "retirement_reason": "no measured usage in review window"
+      },
+      {
+        "interface": {
+          "id": "46900dc2-0893-405b-ba59-80f31fb6ebb1",
+          "interface_key": "state://workstreams/{topic_slug}",
+          "interface_kind": "mcp_tool",
+          "legacy_since": "2026-07-10T13:19:44.344493Z",
+          "replacement_ref": "state://workplans/{topic_slug}",
+          "owner_component": "state-hub.mcp",
+          "status": "legacy",
+          "replacement_verified": true,
+          "manual_hold": false,
+          "hold_reason": null,
+          "notes": "Registered by STATE-WP-0070 T03 \u2014 zero-window streak starts at registration",
+          "retired_at": null,
+          "created_at": "2026-07-10T13:19:44.344493Z",
+          "updated_at": "2026-07-10T13:19:44.344493Z"
+        },
+        "all_time": {
+          "calls": 1,
+          "tenant_count": 1,
+          "user_count": 1,
+          "component_count": 1,
+          "tenants": {
+            "unknown": 1
+          },
+          "users": {
+            "unknown": 1
+          },
+          "components": {
+            "state-hub.mcp": 1
+          }
+        },
+        "window": {
+          "calls": 0,
+          "tenant_count": 0,
+          "user_count": 0,
+          "component_count": 0,
+          "tenants": {},
+          "users": {},
+          "components": {}
+        },
+        "last_seen_at": "2026-07-10T13:20:34.491811Z",
+        "retirement_candidate": true,
+        "retirement_reason": "no measured usage in review window"
+      },
+      {
+        "interface": {
+          "id": "cd9342fd-27e7-4a46-a1be-d41499e106a3",
+          "interface_key": "rest_api:DELETE /workstreams/{workstream_id}",
+          "interface_kind": "rest_api",
+          "legacy_since": "2026-06-06T17:28:13.052813Z",
+          "replacement_ref": "/workplans/{workplan_id}",
+          "owner_component": "state-hub.api",
+          "status": "legacy",
+          "replacement_verified": true,
+          "manual_hold": false,
+          "hold_reason": null,
+          "notes": null,
+          "retired_at": null,
+          "created_at": "2026-06-06T17:28:13.052813Z",
+          "updated_at": "2026-06-06T17:28:13.052813Z"
+        },
+        "all_time": {
+          "calls": 1,
+          "tenant_count": 1,
+          "user_count": 1,
+          "component_count": 1,
+          "tenants": {
+            "unknown": 1
+          },
+          "users": {
+            "unknown": 1
+          },
+          "components": {
+            "unknown": 1
+          }
+        },
+        "window": {
+          "calls": 0,
+          "tenant_count": 0,
+          "user_count": 0,
+          "component_count": 0,
+          "tenants": {},
+          "users": {},
+          "components": {}
+        },
+        "last_seen_at": "2026-06-06T17:28:13.047529Z",
+        "retirement_candidate": true,
+        "retirement_reason": "no measured usage in review window"
+      },
+      {
+        "interface": {
+          "id": "a4e0948c-cd4a-461e-8ae2-7fd7b51d04a7",
+          "interface_key": "rest_api:GET /decisions/?workstream_id",
+          "interface_kind": "rest_api",
+          "legacy_since": "2026-07-09T23:07:53.093223Z",
+          "replacement_ref": "/decisions/?workplan_id=<workplan_id>",
+          "owner_component": "state-hub.api",
+          "status": "legacy",
+          "replacement_verified": true,
+          "manual_hold": false,
+          "hold_reason": null,
+          "notes": null,
+          "retired_at": null,
+          "created_at": "2026-07-09T23:07:53.093223Z",
+          "updated_at": "2026-07-09T23:07:53.093223Z"
+        },
+        "all_time": {
+          "calls": 1,
+          "tenant_count": 1,
+          "user_count": 1,
+          "component_count": 1,
+          "tenants": {
+            "unknown": 1
+          },
+          "users": {
+            "unknown": 1
+          },
+          "components": {
+            "unknown": 1
+          }
+        },
+        "window": {
+          "calls": 0,
+          "tenant_count": 0,
+          "user_count": 0,
+          "component_count": 0,
+          "tenants": {},
+          "users": {},
+          "components": {}
+        },
+        "last_seen_at": "2026-07-09T23:07:53.083299Z",
+        "retirement_candidate": true,
+        "retirement_reason": "no measured usage in review window"
+      },
+      {
+        "interface": {
+          "id": "70a9346e-e0ee-42ac-874f-f160580b54dd",
+          "interface_key": "rest_api:GET /progress/?workstream_id",
+          "interface_kind": "rest_api",
+          "legacy_since": "2026-07-13T22:04:03.911449Z",
+          "replacement_ref": "/progress/?workplan_id=<workplan_id>",
+          "owner_component": "state-hub.api",
+          "status": "legacy",
+          "replacement_verified": true,
+          "manual_hold": false,
+          "hold_reason": null,
+          "notes": null,
+          "retired_at": null,
+          "created_at": "2026-07-13T22:04:03.911449Z",
+          "updated_at": "2026-07-13T22:04:03.911449Z"
+        },
+        "all_time": {
+          "calls": 1,
+          "tenant_count": 1,
+          "user_count": 1,
+          "component_count": 1,
+          "tenants": {
+            "unknown": 1
+          },
+          "users": {
+            "unknown": 1
+          },
+          "components": {
+            "unknown": 1
+          }
+        },
+        "window": {
+          "calls": 0,
+          "tenant_count": 0,
+          "user_count": 0,
+          "component_count": 0,
+          "tenants": {},
+          "users": {},
+          "components": {}
+        },
+        "last_seen_at": "2026-07-13T22:04:03.904998Z",
+        "retirement_candidate": true,
+        "retirement_reason": "no measured usage in review window"
+      },
+      {
+        "interface": {
+          "id": "be3cdcf8-250b-4bf0-801f-02ffd5f57e00",
+          "interface_key": "rest_api:GET /tasks/?workstream_id",
+          "interface_kind": "rest_api",
+          "legacy_since": "2026-07-08T19:32:21.628513Z",
+          "replacement_ref": "/tasks/?workplan_id=<workplan_id>",
+          "owner_component": "state-hub.api",
+          "status": "legacy",
+          "replacement_verified": true,
+          "manual_hold": false,
+          "hold_reason": null,
+          "notes": null,
+          "retired_at": null,
+          "created_at": "2026-07-08T19:32:21.628513Z",
+          "updated_at": "2026-07-08T19:32:21.628513Z"
+        },
+        "all_time": {
+          "calls": 589,
+          "tenant_count": 1,
+          "user_count": 1,
+          "component_count": 1,
+          "tenants": {
+            "unknown": 589
+          },
+          "users": {
+            "unknown": 589
+          },
+          "components": {
+            "unknown": 589
+          }
+        },
+        "window": {
+          "calls": 0,
+          "tenant_count": 0,
+          "user_count": 0,
+          "component_count": 0,
+          "tenants": {},
+          "users": {},
+          "components": {}
+        },
+        "last_seen_at": "2026-07-31T16:25:32.181901Z",
+        "retirement_candidate": true,
+        "retirement_reason": "no measured usage in review window"
+      },
+      {
+        "interface": {
+          "id": "3e4a3d0b-08fa-45c3-91e2-4f514a914b97",
+          "interface_key": "rest_api:GET /workstreams/",
+          "interface_kind": "rest_api",
+          "legacy_since": "2026-06-04T00:26:14.533764Z",
+          "replacement_ref": "/workplans/",
+          "owner_component": "state-hub.api",
+          "status": "legacy",
+          "replacement_verified": true,
+          "manual_hold": false,
+          "hold_reason": null,
+          "notes": null,
+          "retired_at": null,
+          "created_at": "2026-06-04T00:26:14.533764Z",
+          "updated_at": "2026-06-04T00:26:14.533764Z"
+        },
+        "all_time": {
+          "calls": 144085,
+          "tenant_count": 1,
+          "user_count": 1,
+          "component_count": 1,
+          "tenants": {
+            "unknown": 144085
+          },
+          "users": {
+            "unknown": 144085
+          },
+          "components": {
+            "unknown": 144085
+          }
+        },
+        "window": {
+          "calls": 0,
+          "tenant_count": 0,
+          "user_count": 0,
+          "component_count": 0,
+          "tenants": {},
+          "users": {},
+          "components": {}
+        },
+        "last_seen_at": "2026-08-05T13:01:38.000781Z",
+        "retirement_candidate": true,
+        "retirement_reason": "no measured usage in review window"
+      },
+      {
+        "interface": {
+          "id": "e4c140ec-7479-46f9-b185-4b533f19d639",
+          "interface_key": "rest_api:GET /workstreams/workplan-index",
+          "interface_kind": "rest_api",
+          "legacy_since": "2026-06-04T05:20:58.321869Z",
+          "replacement_ref": "/workplans/index",
+          "owner_component": "state-hub.api",
+          "status": "legacy",
+          "replacement_verified": true,
+          "manual_hold": false,
+          "hold_reason": null,
+          "notes": null,
+          "retired_at": null,
+          "created_at": "2026-06-04T05:20:58.321869Z",
+          "updated_at": "2026-06-04T05:20:58.321869Z"
+        },
+        "all_time": {
+          "calls": 30,
+          "tenant_count": 1,
+          "user_count": 1,
+          "component_count": 1,
+          "tenants": {
+            "unknown": 30
+          },
+          "users": {
+            "unknown": 30
+          },
+          "components": {
+            "unknown": 30
+          }
+        },
+        "window": {
+          "calls": 0,
+          "tenant_count": 0,
+          "user_count": 0,
+          "component_count": 0,
+          "tenants": {},
+          "users": {},
+          "components": {}
+        },
+        "last_seen_at": "2026-07-03T05:20:34.534439Z",
+        "retirement_candidate": true,
+        "retirement_reason": "no measured usage in review window"
+      },
+      {
+        "interface": {
+          "id": "3a00b19e-e7db-4403-98aa-a77c9ab61ecc",
+          "interface_key": "rest_api:GET /workstreams/{workstream_id}",
+          "interface_kind": "rest_api",
+          "legacy_since": "2026-06-04T00:25:59.014966Z",
+          "replacement_ref": "/workplans/{workplan_id}",
+          "owner_component": "state-hub.api",
+          "status": "legacy",
+          "replacement_verified": true,
+          "manual_hold": false,
+          "hold_reason": null,
+          "notes": null,
+          "retired_at": null,
+          "created_at": "2026-06-04T00:25:59.014966Z",
+          "updated_at": "2026-06-04T00:25:59.014966Z"
+        },
+        "all_time": {
+          "calls": 511406,
+          "tenant_count": 1,
+          "user_count": 1,
+          "component_count": 1,
+          "tenants": {
+            "unknown": 511406
+          },
+          "users": {
+            "unknown": 511406
+          },
+          "components": {
+            "unknown": 511406
+          }
+        },
+        "window": {
+          "calls": 0,
+          "tenant_count": 0,
+          "user_count": 0,
+          "component_count": 0,
+          "tenants": {},
+          "users": {},
+          "components": {}
+        },
+        "last_seen_at": "2026-07-31T16:25:32.004042Z",
+        "retirement_candidate": true,
+        "retirement_reason": "no measured usage in review window"
+      },
+      {
+        "interface": {
+          "id": "69e1a255-a8b9-4101-8a68-b1bed23abfda",
+          "interface_key": "rest_api:GET /workstreams/{workstream_id}/dependencies/",
+          "interface_kind": "rest_api",
+          "legacy_since": "2026-06-04T00:25:59.291135Z",
+          "replacement_ref": "/workplans/{workplan_id}/dependencies/",
+          "owner_component": "state-hub.api",
+          "status": "legacy",
+          "replacement_verified": true,
+          "manual_hold": false,
+          "hold_reason": null,
+          "notes": null,
+          "retired_at": null,
+          "created_at": "2026-06-04T00:25:59.291135Z",
+          "updated_at": "2026-06-04T00:25:59.291135Z"
+        },
+        "all_time": {
+          "calls": 255865,
+          "tenant_count": 1,
+          "user_count": 1,
+          "component_count": 1,
+          "tenants": {
+            "unknown": 255865
+          },
+          "users": {
+            "unknown": 255865
+          },
+          "components": {
+            "unknown": 255865
+          }
+        },
+        "window": {
+          "calls": 0,
+          "tenant_count": 0,
+          "user_count": 0,
+          "component_count": 0,
+          "tenants": {},
+          "users": {},
+          "components": {}
+        },
+        "last_seen_at": "2026-07-08T21:14:12.747005Z",
+        "retirement_candidate": true,
+        "retirement_reason": "no measured usage in review window"
+      },
+      {
+        "interface": {
+          "id": "b1aae931-b51f-4a85-a723-865dd65f6132",
+          "interface_key": "rest_api:PATCH /workstreams/{workstream_id}",
+          "interface_kind": "rest_api",
+          "legacy_since": "2026-06-04T06:09:41.901035Z",
+          "replacement_ref": "/workplans/{workplan_id}",
+          "owner_component": "state-hub.api",
+          "status": "legacy",
+          "replacement_verified": true,
+          "manual_hold": false,
+          "hold_reason": null,
+          "notes": null,
+          "retired_at": null,
+          "created_at": "2026-06-04T06:09:41.901035Z",
+          "updated_at": "2026-06-04T06:09:41.901035Z"
+        },
+        "all_time": {
+          "calls": 571,
+          "tenant_count": 1,
+          "user_count": 1,
+          "component_count": 1,
+          "tenants": {
+            "unknown": 571
+          },
+          "users": {
+            "unknown": 571
+          },
+          "components": {
+            "unknown": 571
+          }
+        },
+        "window": {
+          "calls": 0,
+          "tenant_count": 0,
+          "user_count": 0,
+          "component_count": 0,
+          "tenants": {},
+          "users": {},
+          "components": {}
+        },
+        "last_seen_at": "2026-07-08T20:49:12.335710Z",
+        "retirement_candidate": true,
+        "retirement_reason": "no measured usage in review window"
+      },
+      {
+        "interface": {
+          "id": "4aea9591-970b-4918-ac4a-4da95a0a1a8c",
+          "interface_key": "rest_api:POST /decisions/ workstream_id",
+          "interface_kind": "rest_api",
+          "legacy_since": "2026-07-09T22:56:35.473130Z",
+          "replacement_ref": "POST /decisions/ with workplan_id",
+          "owner_component": "state-hub.api",
+          "status": "legacy",
+          "replacement_verified": true,
+          "manual_hold": false,
+          "hold_reason": null,
+          "notes": null,
+          "retired_at": null,
+          "created_at": "2026-07-09T22:56:35.473130Z",
+          "updated_at": "2026-07-09T22:56:35.473130Z"
+        },
+        "all_time": {
+          "calls": 3,
+          "tenant_count": 1,
+          "user_count": 1,
+          "component_count": 1,
+          "tenants": {
+            "unknown": 3
+          },
+          "users": {
+            "unknown": 3
+          },
+          "components": {
+            "unknown": 3
+          }
+        },
+        "window": {
+          "calls": 0,
+          "tenant_count": 0,
+          "user_count": 0,
+          "component_count": 0,
+          "tenants": {},
+          "users": {},
+          "components": {}
+        },
+        "last_seen_at": "2026-07-09T22:57:05.912456Z",
+        "retirement_candidate": true,
+        "retirement_reason": "no measured usage in review window"
+      },
+      {
+        "interface": {
+          "id": "4a70583c-1e41-4ec1-99a9-728856a7d79c",
+          "interface_key": "rest_api:POST /progress/ workstream_id",
+          "interface_kind": "rest_api",
+          "legacy_since": "2026-07-08T23:35:09.148333Z",
+          "replacement_ref": "POST /progress/ with workplan_id",
+          "owner_component": "state-hub.api",
+          "status": "legacy",
+          "replacement_verified": true,
+          "manual_hold": false,
+          "hold_reason": null,
+          "notes": null,
+          "retired_at": null,
+          "created_at": "2026-07-08T23:35:09.148333Z",
+          "updated_at": "2026-07-08T23:35:09.148333Z"
+        },
+        "all_time": {
+          "calls": 14,
+          "tenant_count": 1,
+          "user_count": 1,
+          "component_count": 1,
+          "tenants": {
+            "unknown": 14
+          },
+          "users": {
+            "unknown": 14
+          },
+          "components": {
+            "unknown": 14
+          }
+        },
+        "window": {
+          "calls": 0,
+          "tenant_count": 0,
+          "user_count": 0,
+          "component_count": 0,
+          "tenants": {},
+          "users": {},
+          "components": {}
+        },
+        "last_seen_at": "2026-07-10T08:34:42.959724Z",
+        "retirement_candidate": true,
+        "retirement_reason": "no measured usage in review window"
+      },
+      {
+        "interface": {
+          "id": "6df4e443-7bf1-461a-923b-a6eb52fe7b07",
+          "interface_key": "rest_api:POST /tasks/ workstream_id",
+          "interface_kind": "rest_api",
+          "legacy_since": "2026-07-08T22:38:29.405720Z",
+          "replacement_ref": "POST /tasks/ with workplan_id",
+          "owner_component": "state-hub.api",
+          "status": "legacy",
+          "replacement_verified": true,
+          "manual_hold": false,
+          "hold_reason": null,
+          "notes": null,
+          "retired_at": null,
+          "created_at": "2026-07-08T22:38:29.405720Z",
+          "updated_at": "2026-07-08T22:38:29.405720Z"
+        },
+        "all_time": {
+          "calls": 5,
+          "tenant_count": 1,
+          "user_count": 1,
+          "component_count": 1,
+          "tenants": {
+            "unknown": 5
+          },
+          "users": {
+            "unknown": 5
+          },
+          "components": {
+            "state-hub.fix-consistency": 5
+          }
+        },
+        "window": {
+          "calls": 0,
+          "tenant_count": 0,
+          "user_count": 0,
+          "component_count": 0,
+          "tenants": {},
+          "users": {},
+          "components": {}
+        },
+        "last_seen_at": "2026-07-08T22:38:29.976918Z",
+        "retirement_candidate": true,
+        "retirement_reason": "no measured usage in review window"
+      },
+      {
+        "interface": {
+          "id": "ed6451c9-d2cc-4486-9afe-d3852782cabc",
+          "interface_key": "rest_api:POST /workstreams/",
+          "interface_kind": "rest_api",
+          "legacy_since": "2026-06-04T07:40:24.168535Z",
+          "replacement_ref": "/workplans/",
+          "owner_component": "state-hub.api",
+          "status": "legacy",
+          "replacement_verified": true,
+          "manual_hold": false,
+          "hold_reason": null,
+          "notes": null,
+          "retired_at": null,
+          "created_at": "2026-06-04T07:40:24.168535Z",
+          "updated_at": "2026-06-04T07:40:24.168535Z"
+        },
+        "all_time": {
+          "calls": 824,
+          "tenant_count": 1,
+          "user_count": 1,
+          "component_count": 1,
+          "tenants": {
+            "unknown": 824
+          },
+          "users": {
+            "unknown": 824
+          },
+          "components": {
+            "unknown": 824
+          }
+        },
+        "window": {
+          "calls": 0,
+          "tenant_count": 0,
+          "user_count": 0,
+          "component_count": 0,
+          "tenants": {},
+          "users": {},
+          "components": {}
+        },
+        "last_seen_at": "2026-07-08T20:38:05.903144Z",
+        "retirement_candidate": true,
+        "retirement_reason": "no measured usage in review window"
+      },
+      {
+        "interface": {
+          "id": "281fd706-b192-4194-8055-2d8733c115f9",
+          "interface_key": "rest_api:POST /workstreams/{workstream_id}/dependencies/",
+          "interface_kind": "rest_api",
+          "legacy_since": "2026-06-04T22:57:37.149207Z",
+          "replacement_ref": "/workplans/{workplan_id}/dependencies/",
+          "owner_component": "state-hub.api",
+          "status": "legacy",
+          "replacement_verified": true,
+          "manual_hold": false,
+          "hold_reason": null,
+          "notes": null,
+          "retired_at": null,
+          "created_at": "2026-06-04T22:57:37.149207Z",
+          "updated_at": "2026-06-04T22:57:37.149207Z"
+        },
+        "all_time": {
+          "calls": 4971,
+          "tenant_count": 1,
+          "user_count": 1,
+          "component_count": 1,
+          "tenants": {
+            "unknown": 4971
+          },
+          "users": {
+            "unknown": 4971
+          },
+          "components": {
+            "unknown": 4971
+          }
+        },
+        "window": {
+          "calls": 0,
+          "tenant_count": 0,
+          "user_count": 0,
+          "component_count": 0,
+          "tenants": {},
+          "users": {},
+          "components": {}
+        },
+        "last_seen_at": "2026-07-01T22:09:24.229011Z",
+        "retirement_candidate": true,
+        "retirement_reason": "no measured usage in review window"
+      }
+    ]
+  },
+  "hours": 8
+}
diff --git a/docs/evidence/legacy-meter-weekly-review-20260808.json b/docs/evidence/legacy-meter-weekly-review-20260808.json
new file mode 100644
index 0000000..3924adf
--- /dev/null
+++ b/docs/evidence/legacy-meter-weekly-review-20260808.json
@@ -0,0 +1,1755 @@
+{
+  "captured_at": "2026-08-08T14:00:08.623026+00:00",
+  "api_base": "http://127.0.0.1:8000",
+  "workplan": "STATE-WP-0070",
+  "retired_interfaces": [],
+  "weekly_review": {
+    "generated_at": "2026-08-08T14:00:08.615710Z",
+    "window_start": "2026-08-08T06:00:08.547294Z",
+    "window_end": "2026-08-08T14:00:08.547294Z",
+    "cadence": "weekly",
+    "activity_core_handoff": {
+      "activity_id": "statehub-legacy-interface-review",
+      "cadence": "weekly",
+      "source_endpoint": "/legacy-meter/weekly-review",
+      "state_owner": "state-hub",
+      "scheduler_owner": "activity-core"
+    },
+    "interfaces": [
+      {
+        "interface": {
+          "id": "8051fb40-66c9-4dc4-a413-13e8573e04a3",
+          "interface_key": "event_subject:org.statehub.workstream.completed",
+          "interface_kind": "event_subject",
+          "legacy_since": "2026-06-04T06:09:42.198193Z",
+          "replacement_ref": "org.statehub.workplan.completed",
+          "owner_component": "state-hub.events",
+          "status": "retired",
+          "replacement_verified": true,
+          "manual_hold": false,
+          "hold_reason": null,
+          "notes": "Retired by STATE-WP-0069 closeout",
+          "retired_at": "2026-07-08T21:38:52.773601Z",
+          "created_at": "2026-06-04T06:09:42.198193Z",
+          "updated_at": "2026-07-08T21:38:52.761243Z"
+        },
+        "all_time": {
+          "calls": 255,
+          "tenant_count": 1,
+          "user_count": 1,
+          "component_count": 1,
+          "tenants": {
+            "unknown": 255
+          },
+          "users": {
+            "unknown": 255
+          },
+          "components": {
+            "state-hub.events": 255
+          }
+        },
+        "window": {
+          "calls": 0,
+          "tenant_count": 0,
+          "user_count": 0,
+          "component_count": 0,
+          "tenants": {},
+          "users": {},
+          "components": {}
+        },
+        "last_seen_at": "2026-07-08T20:49:12.839383Z",
+        "retirement_candidate": false,
+        "retirement_reason": "already retired"
+      },
+      {
+        "interface": {
+          "id": "63ed90e3-42b4-431a-94db-e1254a52f9e2",
+          "interface_key": "mcp:create_workstream",
+          "interface_kind": "mcp_tool",
+          "legacy_since": "2026-07-10T13:19:44.205900Z",
+          "replacement_ref": "create_workplan",
+          "owner_component": "state-hub.mcp",
+          "status": "legacy",
+          "replacement_verified": true,
+          "manual_hold": false,
+          "hold_reason": null,
+          "notes": "Registered by STATE-WP-0070 T03 \u2014 zero-window streak starts at registration",
+          "retired_at": null,
+          "created_at": "2026-07-10T13:19:44.205900Z",
+          "updated_at": "2026-07-10T13:19:44.205900Z"
+        },
+        "all_time": {
+          "calls": 2,
+          "tenant_count": 1,
+          "user_count": 1,
+          "component_count": 1,
+          "tenants": {
+            "unknown": 2
+          },
+          "users": {
+            "unknown": 2
+          },
+          "components": {
+            "state-hub.mcp": 2
+          }
+        },
+        "window": {
+          "calls": 0,
+          "tenant_count": 0,
+          "user_count": 0,
+          "component_count": 0,
+          "tenants": {},
+          "users": {},
+          "components": {}
+        },
+        "last_seen_at": "2026-07-10T13:20:43.378546Z",
+        "retirement_candidate": true,
+        "retirement_reason": "no measured usage in review window"
+      },
+      {
+        "interface": {
+          "id": "b6a5fe44-fb85-4ef7-a273-78d09da777af",
+          "interface_key": "mcp:list_workstreams",
+          "interface_kind": "mcp_tool",
+          "legacy_since": "2026-07-10T13:19:26.075491Z",
+          "replacement_ref": "list_workplans",
+          "owner_component": "state-hub.mcp",
+          "status": "legacy",
+          "replacement_verified": true,
+          "manual_hold": false,
+          "hold_reason": null,
+          "notes": null,
+          "retired_at": null,
+          "created_at": "2026-07-10T13:19:26.075491Z",
+          "updated_at": "2026-07-10T13:19:26.075491Z"
+        },
+        "all_time": {
+          "calls": 2,
+          "tenant_count": 1,
+          "user_count": 1,
+          "component_count": 1,
+          "tenants": {
+            "unknown": 2
+          },
+          "users": {
+            "unknown": 2
+          },
+          "components": {
+            "state-hub.mcp": 2
+          }
+        },
+        "window": {
+          "calls": 0,
+          "tenant_count": 0,
+          "user_count": 0,
+          "component_count": 0,
+          "tenants": {},
+          "users": {},
+          "components": {}
+        },
+        "last_seen_at": "2026-07-10T13:20:42.374940Z",
+        "retirement_candidate": true,
+        "retirement_reason": "no measured usage in review window"
+      },
+      {
+        "interface": {
+          "id": "53c3372b-307d-4d6a-8ea4-bc36cacdcaf2",
+          "interface_key": "mcp:update_workstream",
+          "interface_kind": "mcp_tool",
+          "legacy_since": "2026-07-10T13:19:44.255216Z",
+          "replacement_ref": "update_workplan",
+          "owner_component": "state-hub.mcp",
+          "status": "legacy",
+          "replacement_verified": true,
+          "manual_hold": false,
+          "hold_reason": null,
+          "notes": "Registered by STATE-WP-0070 T03 \u2014 zero-window streak starts at registration",
+          "retired_at": null,
+          "created_at": "2026-07-10T13:19:44.255216Z",
+          "updated_at": "2026-07-10T13:19:44.255216Z"
+        },
+        "all_time": {
+          "calls": 0,
+          "tenant_count": 0,
+          "user_count": 0,
+          "component_count": 0,
+          "tenants": {},
+          "users": {},
+          "components": {}
+        },
+        "window": {
+          "calls": 0,
+          "tenant_count": 0,
+          "user_count": 0,
+          "component_count": 0,
+          "tenants": {},
+          "users": {},
+          "components": {}
+        },
+        "last_seen_at": null,
+        "retirement_candidate": true,
+        "retirement_reason": "no measured usage in review window"
+      },
+      {
+        "interface": {
+          "id": "bed4d08a-3471-48f5-9f0e-f9d550383a26",
+          "interface_key": "mcp:update_workstream_status",
+          "interface_kind": "mcp_tool",
+          "legacy_since": "2026-07-10T13:19:44.303612Z",
+          "replacement_ref": "update_workplan_status",
+          "owner_component": "state-hub.mcp",
+          "status": "legacy",
+          "replacement_verified": true,
+          "manual_hold": false,
+          "hold_reason": null,
+          "notes": "Registered by STATE-WP-0070 T03 \u2014 zero-window streak starts at registration",
+          "retired_at": null,
+          "created_at": "2026-07-10T13:19:44.303612Z",
+          "updated_at": "2026-07-10T13:19:44.303612Z"
+        },
+        "all_time": {
+          "calls": 0,
+          "tenant_count": 0,
+          "user_count": 0,
+          "component_count": 0,
+          "tenants": {},
+          "users": {},
+          "components": {}
+        },
+        "window": {
+          "calls": 0,
+          "tenant_count": 0,
+          "user_count": 0,
+          "component_count": 0,
+          "tenants": {},
+          "users": {},
+          "components": {}
+        },
+        "last_seen_at": null,
+        "retirement_candidate": true,
+        "retirement_reason": "no measured usage in review window"
+      },
+      {
+        "interface": {
+          "id": "46900dc2-0893-405b-ba59-80f31fb6ebb1",
+          "interface_key": "state://workstreams/{topic_slug}",
+          "interface_kind": "mcp_tool",
+          "legacy_since": "2026-07-10T13:19:44.344493Z",
+          "replacement_ref": "state://workplans/{topic_slug}",
+          "owner_component": "state-hub.mcp",
+          "status": "legacy",
+          "replacement_verified": true,
+          "manual_hold": false,
+          "hold_reason": null,
+          "notes": "Registered by STATE-WP-0070 T03 \u2014 zero-window streak starts at registration",
+          "retired_at": null,
+          "created_at": "2026-07-10T13:19:44.344493Z",
+          "updated_at": "2026-07-10T13:19:44.344493Z"
+        },
+        "all_time": {
+          "calls": 1,
+          "tenant_count": 1,
+          "user_count": 1,
+          "component_count": 1,
+          "tenants": {
+            "unknown": 1
+          },
+          "users": {
+            "unknown": 1
+          },
+          "components": {
+            "state-hub.mcp": 1
+          }
+        },
+        "window": {
+          "calls": 0,
+          "tenant_count": 0,
+          "user_count": 0,
+          "component_count": 0,
+          "tenants": {},
+          "users": {},
+          "components": {}
+        },
+        "last_seen_at": "2026-07-10T13:20:34.491811Z",
+        "retirement_candidate": true,
+        "retirement_reason": "no measured usage in review window"
+      },
+      {
+        "interface": {
+          "id": "cd9342fd-27e7-4a46-a1be-d41499e106a3",
+          "interface_key": "rest_api:DELETE /workstreams/{workstream_id}",
+          "interface_kind": "rest_api",
+          "legacy_since": "2026-06-06T17:28:13.052813Z",
+          "replacement_ref": "/workplans/{workplan_id}",
+          "owner_component": "state-hub.api",
+          "status": "legacy",
+          "replacement_verified": true,
+          "manual_hold": false,
+          "hold_reason": null,
+          "notes": null,
+          "retired_at": null,
+          "created_at": "2026-06-06T17:28:13.052813Z",
+          "updated_at": "2026-06-06T17:28:13.052813Z"
+        },
+        "all_time": {
+          "calls": 1,
+          "tenant_count": 1,
+          "user_count": 1,
+          "component_count": 1,
+          "tenants": {
+            "unknown": 1
+          },
+          "users": {
+            "unknown": 1
+          },
+          "components": {
+            "unknown": 1
+          }
+        },
+        "window": {
+          "calls": 0,
+          "tenant_count": 0,
+          "user_count": 0,
+          "component_count": 0,
+          "tenants": {},
+          "users": {},
+          "components": {}
+        },
+        "last_seen_at": "2026-06-06T17:28:13.047529Z",
+        "retirement_candidate": true,
+        "retirement_reason": "no measured usage in review window"
+      },
+      {
+        "interface": {
+          "id": "a4e0948c-cd4a-461e-8ae2-7fd7b51d04a7",
+          "interface_key": "rest_api:GET /decisions/?workstream_id",
+          "interface_kind": "rest_api",
+          "legacy_since": "2026-07-09T23:07:53.093223Z",
+          "replacement_ref": "/decisions/?workplan_id=<workplan_id>",
+          "owner_component": "state-hub.api",
+          "status": "legacy",
+          "replacement_verified": true,
+          "manual_hold": false,
+          "hold_reason": null,
+          "notes": null,
+          "retired_at": null,
+          "created_at": "2026-07-09T23:07:53.093223Z",
+          "updated_at": "2026-07-09T23:07:53.093223Z"
+        },
+        "all_time": {
+          "calls": 1,
+          "tenant_count": 1,
+          "user_count": 1,
+          "component_count": 1,
+          "tenants": {
+            "unknown": 1
+          },
+          "users": {
+            "unknown": 1
+          },
+          "components": {
+            "unknown": 1
+          }
+        },
+        "window": {
+          "calls": 0,
+          "tenant_count": 0,
+          "user_count": 0,
+          "component_count": 0,
+          "tenants": {},
+          "users": {},
+          "components": {}
+        },
+        "last_seen_at": "2026-07-09T23:07:53.083299Z",
+        "retirement_candidate": true,
+        "retirement_reason": "no measured usage in review window"
+      },
+      {
+        "interface": {
+          "id": "70a9346e-e0ee-42ac-874f-f160580b54dd",
+          "interface_key": "rest_api:GET /progress/?workstream_id",
+          "interface_kind": "rest_api",
+          "legacy_since": "2026-07-13T22:04:03.911449Z",
+          "replacement_ref": "/progress/?workplan_id=<workplan_id>",
+          "owner_component": "state-hub.api",
+          "status": "legacy",
+          "replacement_verified": true,
+          "manual_hold": false,
+          "hold_reason": null,
+          "notes": null,
+          "retired_at": null,
+          "created_at": "2026-07-13T22:04:03.911449Z",
+          "updated_at": "2026-07-13T22:04:03.911449Z"
+        },
+        "all_time": {
+          "calls": 1,
+          "tenant_count": 1,
+          "user_count": 1,
+          "component_count": 1,
+          "tenants": {
+            "unknown": 1
+          },
+          "users": {
+            "unknown": 1
+          },
+          "components": {
+            "unknown": 1
+          }
+        },
+        "window": {
+          "calls": 0,
+          "tenant_count": 0,
+          "user_count": 0,
+          "component_count": 0,
+          "tenants": {},
+          "users": {},
+          "components": {}
+        },
+        "last_seen_at": "2026-07-13T22:04:03.904998Z",
+        "retirement_candidate": true,
+        "retirement_reason": "no measured usage in review window"
+      },
+      {
+        "interface": {
+          "id": "be3cdcf8-250b-4bf0-801f-02ffd5f57e00",
+          "interface_key": "rest_api:GET /tasks/?workstream_id",
+          "interface_kind": "rest_api",
+          "legacy_since": "2026-07-08T19:32:21.628513Z",
+          "replacement_ref": "/tasks/?workplan_id=<workplan_id>",
+          "owner_component": "state-hub.api",
+          "status": "legacy",
+          "replacement_verified": true,
+          "manual_hold": false,
+          "hold_reason": null,
+          "notes": null,
+          "retired_at": null,
+          "created_at": "2026-07-08T19:32:21.628513Z",
+          "updated_at": "2026-07-08T19:32:21.628513Z"
+        },
+        "all_time": {
+          "calls": 589,
+          "tenant_count": 1,
+          "user_count": 1,
+          "component_count": 1,
+          "tenants": {
+            "unknown": 589
+          },
+          "users": {
+            "unknown": 589
+          },
+          "components": {
+            "unknown": 589
+          }
+        },
+        "window": {
+          "calls": 0,
+          "tenant_count": 0,
+          "user_count": 0,
+          "component_count": 0,
+          "tenants": {},
+          "users": {},
+          "components": {}
+        },
+        "last_seen_at": "2026-07-31T16:25:32.181901Z",
+        "retirement_candidate": true,
+        "retirement_reason": "no measured usage in review window"
+      },
+      {
+        "interface": {
+          "id": "3e4a3d0b-08fa-45c3-91e2-4f514a914b97",
+          "interface_key": "rest_api:GET /workstreams/",
+          "interface_kind": "rest_api",
+          "legacy_since": "2026-06-04T00:26:14.533764Z",
+          "replacement_ref": "/workplans/",
+          "owner_component": "state-hub.api",
+          "status": "legacy",
+          "replacement_verified": true,
+          "manual_hold": false,
+          "hold_reason": null,
+          "notes": null,
+          "retired_at": null,
+          "created_at": "2026-06-04T00:26:14.533764Z",
+          "updated_at": "2026-06-04T00:26:14.533764Z"
+        },
+        "all_time": {
+          "calls": 144085,
+          "tenant_count": 1,
+          "user_count": 1,
+          "component_count": 1,
+          "tenants": {
+            "unknown": 144085
+          },
+          "users": {
+            "unknown": 144085
+          },
+          "components": {
+            "unknown": 144085
+          }
+        },
+        "window": {
+          "calls": 0,
+          "tenant_count": 0,
+          "user_count": 0,
+          "component_count": 0,
+          "tenants": {},
+          "users": {},
+          "components": {}
+        },
+        "last_seen_at": "2026-08-05T13:01:38.000781Z",
+        "retirement_candidate": true,
+        "retirement_reason": "no measured usage in review window"
+      },
+      {
+        "interface": {
+          "id": "e4c140ec-7479-46f9-b185-4b533f19d639",
+          "interface_key": "rest_api:GET /workstreams/workplan-index",
+          "interface_kind": "rest_api",
+          "legacy_since": "2026-06-04T05:20:58.321869Z",
+          "replacement_ref": "/workplans/index",
+          "owner_component": "state-hub.api",
+          "status": "legacy",
+          "replacement_verified": true,
+          "manual_hold": false,
+          "hold_reason": null,
+          "notes": null,
+          "retired_at": null,
+          "created_at": "2026-06-04T05:20:58.321869Z",
+          "updated_at": "2026-06-04T05:20:58.321869Z"
+        },
+        "all_time": {
+          "calls": 30,
+          "tenant_count": 1,
+          "user_count": 1,
+          "component_count": 1,
+          "tenants": {
+            "unknown": 30
+          },
+          "users": {
+            "unknown": 30
+          },
+          "components": {
+            "unknown": 30
+          }
+        },
+        "window": {
+          "calls": 0,
+          "tenant_count": 0,
+          "user_count": 0,
+          "component_count": 0,
+          "tenants": {},
+          "users": {},
+          "components": {}
+        },
+        "last_seen_at": "2026-07-03T05:20:34.534439Z",
+        "retirement_candidate": true,
+        "retirement_reason": "no measured usage in review window"
+      },
+      {
+        "interface": {
+          "id": "3a00b19e-e7db-4403-98aa-a77c9ab61ecc",
+          "interface_key": "rest_api:GET /workstreams/{workstream_id}",
+          "interface_kind": "rest_api",
+          "legacy_since": "2026-06-04T00:25:59.014966Z",
+          "replacement_ref": "/workplans/{workplan_id}",
+          "owner_component": "state-hub.api",
+          "status": "legacy",
+          "replacement_verified": true,
+          "manual_hold": false,
+          "hold_reason": null,
+          "notes": null,
+          "retired_at": null,
+          "created_at": "2026-06-04T00:25:59.014966Z",
+          "updated_at": "2026-06-04T00:25:59.014966Z"
+        },
+        "all_time": {
+          "calls": 511406,
+          "tenant_count": 1,
+          "user_count": 1,
+          "component_count": 1,
+          "tenants": {
+            "unknown": 511406
+          },
+          "users": {
+            "unknown": 511406
+          },
+          "components": {
+            "unknown": 511406
+          }
+        },
+        "window": {
+          "calls": 0,
+          "tenant_count": 0,
+          "user_count": 0,
+          "component_count": 0,
+          "tenants": {},
+          "users": {},
+          "components": {}
+        },
+        "last_seen_at": "2026-07-31T16:25:32.004042Z",
+        "retirement_candidate": true,
+        "retirement_reason": "no measured usage in review window"
+      },
+      {
+        "interface": {
+          "id": "69e1a255-a8b9-4101-8a68-b1bed23abfda",
+          "interface_key": "rest_api:GET /workstreams/{workstream_id}/dependencies/",
+          "interface_kind": "rest_api",
+          "legacy_since": "2026-06-04T00:25:59.291135Z",
+          "replacement_ref": "/workplans/{workplan_id}/dependencies/",
+          "owner_component": "state-hub.api",
+          "status": "legacy",
+          "replacement_verified": true,
+          "manual_hold": false,
+          "hold_reason": null,
+          "notes": null,
+          "retired_at": null,
+          "created_at": "2026-06-04T00:25:59.291135Z",
+          "updated_at": "2026-06-04T00:25:59.291135Z"
+        },
+        "all_time": {
+          "calls": 255865,
+          "tenant_count": 1,
+          "user_count": 1,
+          "component_count": 1,
+          "tenants": {
+            "unknown": 255865
+          },
+          "users": {
+            "unknown": 255865
+          },
+          "components": {
+            "unknown": 255865
+          }
+        },
+        "window": {
+          "calls": 0,
+          "tenant_count": 0,
+          "user_count": 0,
+          "component_count": 0,
+          "tenants": {},
+          "users": {},
+          "components": {}
+        },
+        "last_seen_at": "2026-07-08T21:14:12.747005Z",
+        "retirement_candidate": true,
+        "retirement_reason": "no measured usage in review window"
+      },
+      {
+        "interface": {
+          "id": "b1aae931-b51f-4a85-a723-865dd65f6132",
+          "interface_key": "rest_api:PATCH /workstreams/{workstream_id}",
+          "interface_kind": "rest_api",
+          "legacy_since": "2026-06-04T06:09:41.901035Z",
+          "replacement_ref": "/workplans/{workplan_id}",
+          "owner_component": "state-hub.api",
+          "status": "legacy",
+          "replacement_verified": true,
+          "manual_hold": false,
+          "hold_reason": null,
+          "notes": null,
+          "retired_at": null,
+          "created_at": "2026-06-04T06:09:41.901035Z",
+          "updated_at": "2026-06-04T06:09:41.901035Z"
+        },
+        "all_time": {
+          "calls": 571,
+          "tenant_count": 1,
+          "user_count": 1,
+          "component_count": 1,
+          "tenants": {
+            "unknown": 571
+          },
+          "users": {
+            "unknown": 571
+          },
+          "components": {
+            "unknown": 571
+          }
+        },
+        "window": {
+          "calls": 0,
+          "tenant_count": 0,
+          "user_count": 0,
+          "component_count": 0,
+          "tenants": {},
+          "users": {},
+          "components": {}
+        },
+        "last_seen_at": "2026-07-08T20:49:12.335710Z",
+        "retirement_candidate": true,
+        "retirement_reason": "no measured usage in review window"
+      },
+      {
+        "interface": {
+          "id": "4aea9591-970b-4918-ac4a-4da95a0a1a8c",
+          "interface_key": "rest_api:POST /decisions/ workstream_id",
+          "interface_kind": "rest_api",
+          "legacy_since": "2026-07-09T22:56:35.473130Z",
+          "replacement_ref": "POST /decisions/ with workplan_id",
+          "owner_component": "state-hub.api",
+          "status": "legacy",
+          "replacement_verified": true,
+          "manual_hold": false,
+          "hold_reason": null,
+          "notes": null,
+          "retired_at": null,
+          "created_at": "2026-07-09T22:56:35.473130Z",
+          "updated_at": "2026-07-09T22:56:35.473130Z"
+        },
+        "all_time": {
+          "calls": 3,
+          "tenant_count": 1,
+          "user_count": 1,
+          "component_count": 1,
+          "tenants": {
+            "unknown": 3
+          },
+          "users": {
+            "unknown": 3
+          },
+          "components": {
+            "unknown": 3
+          }
+        },
+        "window": {
+          "calls": 0,
+          "tenant_count": 0,
+          "user_count": 0,
+          "component_count": 0,
+          "tenants": {},
+          "users": {},
+          "components": {}
+        },
+        "last_seen_at": "2026-07-09T22:57:05.912456Z",
+        "retirement_candidate": true,
+        "retirement_reason": "no measured usage in review window"
+      },
+      {
+        "interface": {
+          "id": "4a70583c-1e41-4ec1-99a9-728856a7d79c",
+          "interface_key": "rest_api:POST /progress/ workstream_id",
+          "interface_kind": "rest_api",
+          "legacy_since": "2026-07-08T23:35:09.148333Z",
+          "replacement_ref": "POST /progress/ with workplan_id",
+          "owner_component": "state-hub.api",
+          "status": "legacy",
+          "replacement_verified": true,
+          "manual_hold": false,
+          "hold_reason": null,
+          "notes": null,
+          "retired_at": null,
+          "created_at": "2026-07-08T23:35:09.148333Z",
+          "updated_at": "2026-07-08T23:35:09.148333Z"
+        },
+        "all_time": {
+          "calls": 14,
+          "tenant_count": 1,
+          "user_count": 1,
+          "component_count": 1,
+          "tenants": {
+            "unknown": 14
+          },
+          "users": {
+            "unknown": 14
+          },
+          "components": {
+            "unknown": 14
+          }
+        },
+        "window": {
+          "calls": 0,
+          "tenant_count": 0,
+          "user_count": 0,
+          "component_count": 0,
+          "tenants": {},
+          "users": {},
+          "components": {}
+        },
+        "last_seen_at": "2026-07-10T08:34:42.959724Z",
+        "retirement_candidate": true,
+        "retirement_reason": "no measured usage in review window"
+      },
+      {
+        "interface": {
+          "id": "6df4e443-7bf1-461a-923b-a6eb52fe7b07",
+          "interface_key": "rest_api:POST /tasks/ workstream_id",
+          "interface_kind": "rest_api",
+          "legacy_since": "2026-07-08T22:38:29.405720Z",
+          "replacement_ref": "POST /tasks/ with workplan_id",
+          "owner_component": "state-hub.api",
+          "status": "legacy",
+          "replacement_verified": true,
+          "manual_hold": false,
+          "hold_reason": null,
+          "notes": null,
+          "retired_at": null,
+          "created_at": "2026-07-08T22:38:29.405720Z",
+          "updated_at": "2026-07-08T22:38:29.405720Z"
+        },
+        "all_time": {
+          "calls": 5,
+          "tenant_count": 1,
+          "user_count": 1,
+          "component_count": 1,
+          "tenants": {
+            "unknown": 5
+          },
+          "users": {
+            "unknown": 5
+          },
+          "components": {
+            "state-hub.fix-consistency": 5
+          }
+        },
+        "window": {
+          "calls": 0,
+          "tenant_count": 0,
+          "user_count": 0,
+          "component_count": 0,
+          "tenants": {},
+          "users": {},
+          "components": {}
+        },
+        "last_seen_at": "2026-07-08T22:38:29.976918Z",
+        "retirement_candidate": true,
+        "retirement_reason": "no measured usage in review window"
+      },
+      {
+        "interface": {
+          "id": "ed6451c9-d2cc-4486-9afe-d3852782cabc",
+          "interface_key": "rest_api:POST /workstreams/",
+          "interface_kind": "rest_api",
+          "legacy_since": "2026-06-04T07:40:24.168535Z",
+          "replacement_ref": "/workplans/",
+          "owner_component": "state-hub.api",
+          "status": "legacy",
+          "replacement_verified": true,
+          "manual_hold": false,
+          "hold_reason": null,
+          "notes": null,
+          "retired_at": null,
+          "created_at": "2026-06-04T07:40:24.168535Z",
+          "updated_at": "2026-06-04T07:40:24.168535Z"
+        },
+        "all_time": {
+          "calls": 824,
+          "tenant_count": 1,
+          "user_count": 1,
+          "component_count": 1,
+          "tenants": {
+            "unknown": 824
+          },
+          "users": {
+            "unknown": 824
+          },
+          "components": {
+            "unknown": 824
+          }
+        },
+        "window": {
+          "calls": 0,
+          "tenant_count": 0,
+          "user_count": 0,
+          "component_count": 0,
+          "tenants": {},
+          "users": {},
+          "components": {}
+        },
+        "last_seen_at": "2026-07-08T20:38:05.903144Z",
+        "retirement_candidate": true,
+        "retirement_reason": "no measured usage in review window"
+      },
+      {
+        "interface": {
+          "id": "281fd706-b192-4194-8055-2d8733c115f9",
+          "interface_key": "rest_api:POST /workstreams/{workstream_id}/dependencies/",
+          "interface_kind": "rest_api",
+          "legacy_since": "2026-06-04T22:57:37.149207Z",
+          "replacement_ref": "/workplans/{workplan_id}/dependencies/",
+          "owner_component": "state-hub.api",
+          "status": "legacy",
+          "replacement_verified": true,
+          "manual_hold": false,
+          "hold_reason": null,
+          "notes": null,
+          "retired_at": null,
+          "created_at": "2026-06-04T22:57:37.149207Z",
+          "updated_at": "2026-06-04T22:57:37.149207Z"
+        },
+        "all_time": {
+          "calls": 4971,
+          "tenant_count": 1,
+          "user_count": 1,
+          "component_count": 1,
+          "tenants": {
+            "unknown": 4971
+          },
+          "users": {
+            "unknown": 4971
+          },
+          "components": {
+            "unknown": 4971
+          }
+        },
+        "window": {
+          "calls": 0,
+          "tenant_count": 0,
+          "user_count": 0,
+          "component_count": 0,
+          "tenants": {},
+          "users": {},
+          "components": {}
+        },
+        "last_seen_at": "2026-07-01T22:09:24.229011Z",
+        "retirement_candidate": true,
+        "retirement_reason": "no measured usage in review window"
+      }
+    ],
+    "retirement_candidates": [
+      {
+        "interface": {
+          "id": "63ed90e3-42b4-431a-94db-e1254a52f9e2",
+          "interface_key": "mcp:create_workstream",
+          "interface_kind": "mcp_tool",
+          "legacy_since": "2026-07-10T13:19:44.205900Z",
+          "replacement_ref": "create_workplan",
+          "owner_component": "state-hub.mcp",
+          "status": "legacy",
+          "replacement_verified": true,
+          "manual_hold": false,
+          "hold_reason": null,
+          "notes": "Registered by STATE-WP-0070 T03 \u2014 zero-window streak starts at registration",
+          "retired_at": null,
+          "created_at": "2026-07-10T13:19:44.205900Z",
+          "updated_at": "2026-07-10T13:19:44.205900Z"
+        },
+        "all_time": {
+          "calls": 2,
+          "tenant_count": 1,
+          "user_count": 1,
+          "component_count": 1,
+          "tenants": {
+            "unknown": 2
+          },
+          "users": {
+            "unknown": 2
+          },
+          "components": {
+            "state-hub.mcp": 2
+          }
+        },
+        "window": {
+          "calls": 0,
+          "tenant_count": 0,
+          "user_count": 0,
+          "component_count": 0,
+          "tenants": {},
+          "users": {},
+          "components": {}
+        },
+        "last_seen_at": "2026-07-10T13:20:43.378546Z",
+        "retirement_candidate": true,
+        "retirement_reason": "no measured usage in review window"
+      },
+      {
+        "interface": {
+          "id": "b6a5fe44-fb85-4ef7-a273-78d09da777af",
+          "interface_key": "mcp:list_workstreams",
+          "interface_kind": "mcp_tool",
+          "legacy_since": "2026-07-10T13:19:26.075491Z",
+          "replacement_ref": "list_workplans",
+          "owner_component": "state-hub.mcp",
+          "status": "legacy",
+          "replacement_verified": true,
+          "manual_hold": false,
+          "hold_reason": null,
+          "notes": null,
+          "retired_at": null,
+          "created_at": "2026-07-10T13:19:26.075491Z",
+          "updated_at": "2026-07-10T13:19:26.075491Z"
+        },
+        "all_time": {
+          "calls": 2,
+          "tenant_count": 1,
+          "user_count": 1,
+          "component_count": 1,
+          "tenants": {
+            "unknown": 2
+          },
+          "users": {
+            "unknown": 2
+          },
+          "components": {
+            "state-hub.mcp": 2
+          }
+        },
+        "window": {
+          "calls": 0,
+          "tenant_count": 0,
+          "user_count": 0,
+          "component_count": 0,
+          "tenants": {},
+          "users": {},
+          "components": {}
+        },
+        "last_seen_at": "2026-07-10T13:20:42.374940Z",
+        "retirement_candidate": true,
+        "retirement_reason": "no measured usage in review window"
+      },
+      {
+        "interface": {
+          "id": "53c3372b-307d-4d6a-8ea4-bc36cacdcaf2",
+          "interface_key": "mcp:update_workstream",
+          "interface_kind": "mcp_tool",
+          "legacy_since": "2026-07-10T13:19:44.255216Z",
+          "replacement_ref": "update_workplan",
+          "owner_component": "state-hub.mcp",
+          "status": "legacy",
+          "replacement_verified": true,
+          "manual_hold": false,
+          "hold_reason": null,
+          "notes": "Registered by STATE-WP-0070 T03 \u2014 zero-window streak starts at registration",
+          "retired_at": null,
+          "created_at": "2026-07-10T13:19:44.255216Z",
+          "updated_at": "2026-07-10T13:19:44.255216Z"
+        },
+        "all_time": {
+          "calls": 0,
+          "tenant_count": 0,
+          "user_count": 0,
+          "component_count": 0,
+          "tenants": {},
+          "users": {},
+          "components": {}
+        },
+        "window": {
+          "calls": 0,
+          "tenant_count": 0,
+          "user_count": 0,
+          "component_count": 0,
+          "tenants": {},
+          "users": {},
+          "components": {}
+        },
+        "last_seen_at": null,
+        "retirement_candidate": true,
+        "retirement_reason": "no measured usage in review window"
+      },
+      {
+        "interface": {
+          "id": "bed4d08a-3471-48f5-9f0e-f9d550383a26",
+          "interface_key": "mcp:update_workstream_status",
+          "interface_kind": "mcp_tool",
+          "legacy_since": "2026-07-10T13:19:44.303612Z",
+          "replacement_ref": "update_workplan_status",
+          "owner_component": "state-hub.mcp",
+          "status": "legacy",
+          "replacement_verified": true,
+          "manual_hold": false,
+          "hold_reason": null,
+          "notes": "Registered by STATE-WP-0070 T03 \u2014 zero-window streak starts at registration",
+          "retired_at": null,
+          "created_at": "2026-07-10T13:19:44.303612Z",
+          "updated_at": "2026-07-10T13:19:44.303612Z"
+        },
+        "all_time": {
+          "calls": 0,
+          "tenant_count": 0,
+          "user_count": 0,
+          "component_count": 0,
+          "tenants": {},
+          "users": {},
+          "components": {}
+        },
+        "window": {
+          "calls": 0,
+          "tenant_count": 0,
+          "user_count": 0,
+          "component_count": 0,
+          "tenants": {},
+          "users": {},
+          "components": {}
+        },
+        "last_seen_at": null,
+        "retirement_candidate": true,
+        "retirement_reason": "no measured usage in review window"
+      },
+      {
+        "interface": {
+          "id": "46900dc2-0893-405b-ba59-80f31fb6ebb1",
+          "interface_key": "state://workstreams/{topic_slug}",
+          "interface_kind": "mcp_tool",
+          "legacy_since": "2026-07-10T13:19:44.344493Z",
+          "replacement_ref": "state://workplans/{topic_slug}",
+          "owner_component": "state-hub.mcp",
+          "status": "legacy",
+          "replacement_verified": true,
+          "manual_hold": false,
+          "hold_reason": null,
+          "notes": "Registered by STATE-WP-0070 T03 \u2014 zero-window streak starts at registration",
+          "retired_at": null,
+          "created_at": "2026-07-10T13:19:44.344493Z",
+          "updated_at": "2026-07-10T13:19:44.344493Z"
+        },
+        "all_time": {
+          "calls": 1,
+          "tenant_count": 1,
+          "user_count": 1,
+          "component_count": 1,
+          "tenants": {
+            "unknown": 1
+          },
+          "users": {
+            "unknown": 1
+          },
+          "components": {
+            "state-hub.mcp": 1
+          }
+        },
+        "window": {
+          "calls": 0,
+          "tenant_count": 0,
+          "user_count": 0,
+          "component_count": 0,
+          "tenants": {},
+          "users": {},
+          "components": {}
+        },
+        "last_seen_at": "2026-07-10T13:20:34.491811Z",
+        "retirement_candidate": true,
+        "retirement_reason": "no measured usage in review window"
+      },
+      {
+        "interface": {
+          "id": "cd9342fd-27e7-4a46-a1be-d41499e106a3",
+          "interface_key": "rest_api:DELETE /workstreams/{workstream_id}",
+          "interface_kind": "rest_api",
+          "legacy_since": "2026-06-06T17:28:13.052813Z",
+          "replacement_ref": "/workplans/{workplan_id}",
+          "owner_component": "state-hub.api",
+          "status": "legacy",
+          "replacement_verified": true,
+          "manual_hold": false,
+          "hold_reason": null,
+          "notes": null,
+          "retired_at": null,
+          "created_at": "2026-06-06T17:28:13.052813Z",
+          "updated_at": "2026-06-06T17:28:13.052813Z"
+        },
+        "all_time": {
+          "calls": 1,
+          "tenant_count": 1,
+          "user_count": 1,
+          "component_count": 1,
+          "tenants": {
+            "unknown": 1
+          },
+          "users": {
+            "unknown": 1
+          },
+          "components": {
+            "unknown": 1
+          }
+        },
+        "window": {
+          "calls": 0,
+          "tenant_count": 0,
+          "user_count": 0,
+          "component_count": 0,
+          "tenants": {},
+          "users": {},
+          "components": {}
+        },
+        "last_seen_at": "2026-06-06T17:28:13.047529Z",
+        "retirement_candidate": true,
+        "retirement_reason": "no measured usage in review window"
+      },
+      {
+        "interface": {
+          "id": "a4e0948c-cd4a-461e-8ae2-7fd7b51d04a7",
+          "interface_key": "rest_api:GET /decisions/?workstream_id",
+          "interface_kind": "rest_api",
+          "legacy_since": "2026-07-09T23:07:53.093223Z",
+          "replacement_ref": "/decisions/?workplan_id=<workplan_id>",
+          "owner_component": "state-hub.api",
+          "status": "legacy",
+          "replacement_verified": true,
+          "manual_hold": false,
+          "hold_reason": null,
+          "notes": null,
+          "retired_at": null,
+          "created_at": "2026-07-09T23:07:53.093223Z",
+          "updated_at": "2026-07-09T23:07:53.093223Z"
+        },
+        "all_time": {
+          "calls": 1,
+          "tenant_count": 1,
+          "user_count": 1,
+          "component_count": 1,
+          "tenants": {
+            "unknown": 1
+          },
+          "users": {
+            "unknown": 1
+          },
+          "components": {
+            "unknown": 1
+          }
+        },
+        "window": {
+          "calls": 0,
+          "tenant_count": 0,
+          "user_count": 0,
+          "component_count": 0,
+          "tenants": {},
+          "users": {},
+          "components": {}
+        },
+        "last_seen_at": "2026-07-09T23:07:53.083299Z",
+        "retirement_candidate": true,
+        "retirement_reason": "no measured usage in review window"
+      },
+      {
+        "interface": {
+          "id": "70a9346e-e0ee-42ac-874f-f160580b54dd",
+          "interface_key": "rest_api:GET /progress/?workstream_id",
+          "interface_kind": "rest_api",
+          "legacy_since": "2026-07-13T22:04:03.911449Z",
+          "replacement_ref": "/progress/?workplan_id=<workplan_id>",
+          "owner_component": "state-hub.api",
+          "status": "legacy",
+          "replacement_verified": true,
+          "manual_hold": false,
+          "hold_reason": null,
+          "notes": null,
+          "retired_at": null,
+          "created_at": "2026-07-13T22:04:03.911449Z",
+          "updated_at": "2026-07-13T22:04:03.911449Z"
+        },
+        "all_time": {
+          "calls": 1,
+          "tenant_count": 1,
+          "user_count": 1,
+          "component_count": 1,
+          "tenants": {
+            "unknown": 1
+          },
+          "users": {
+            "unknown": 1
+          },
+          "components": {
+            "unknown": 1
+          }
+        },
+        "window": {
+          "calls": 0,
+          "tenant_count": 0,
+          "user_count": 0,
+          "component_count": 0,
+          "tenants": {},
+          "users": {},
+          "components": {}
+        },
+        "last_seen_at": "2026-07-13T22:04:03.904998Z",
+        "retirement_candidate": true,
+        "retirement_reason": "no measured usage in review window"
+      },
+      {
+        "interface": {
+          "id": "be3cdcf8-250b-4bf0-801f-02ffd5f57e00",
+          "interface_key": "rest_api:GET /tasks/?workstream_id",
+          "interface_kind": "rest_api",
+          "legacy_since": "2026-07-08T19:32:21.628513Z",
+          "replacement_ref": "/tasks/?workplan_id=<workplan_id>",
+          "owner_component": "state-hub.api",
+          "status": "legacy",
+          "replacement_verified": true,
+          "manual_hold": false,
+          "hold_reason": null,
+          "notes": null,
+          "retired_at": null,
+          "created_at": "2026-07-08T19:32:21.628513Z",
+          "updated_at": "2026-07-08T19:32:21.628513Z"
+        },
+        "all_time": {
+          "calls": 589,
+          "tenant_count": 1,
+          "user_count": 1,
+          "component_count": 1,
+          "tenants": {
+            "unknown": 589
+          },
+          "users": {
+            "unknown": 589
+          },
+          "components": {
+            "unknown": 589
+          }
+        },
+        "window": {
+          "calls": 0,
+          "tenant_count": 0,
+          "user_count": 0,
+          "component_count": 0,
+          "tenants": {},
+          "users": {},
+          "components": {}
+        },
+        "last_seen_at": "2026-07-31T16:25:32.181901Z",
+        "retirement_candidate": true,
+        "retirement_reason": "no measured usage in review window"
+      },
+      {
+        "interface": {
+          "id": "3e4a3d0b-08fa-45c3-91e2-4f514a914b97",
+          "interface_key": "rest_api:GET /workstreams/",
+          "interface_kind": "rest_api",
+          "legacy_since": "2026-06-04T00:26:14.533764Z",
+          "replacement_ref": "/workplans/",
+          "owner_component": "state-hub.api",
+          "status": "legacy",
+          "replacement_verified": true,
+          "manual_hold": false,
+          "hold_reason": null,
+          "notes": null,
+          "retired_at": null,
+          "created_at": "2026-06-04T00:26:14.533764Z",
+          "updated_at": "2026-06-04T00:26:14.533764Z"
+        },
+        "all_time": {
+          "calls": 144085,
+          "tenant_count": 1,
+          "user_count": 1,
+          "component_count": 1,
+          "tenants": {
+            "unknown": 144085
+          },
+          "users": {
+            "unknown": 144085
+          },
+          "components": {
+            "unknown": 144085
+          }
+        },
+        "window": {
+          "calls": 0,
+          "tenant_count": 0,
+          "user_count": 0,
+          "component_count": 0,
+          "tenants": {},
+          "users": {},
+          "components": {}
+        },
+        "last_seen_at": "2026-08-05T13:01:38.000781Z",
+        "retirement_candidate": true,
+        "retirement_reason": "no measured usage in review window"
+      },
+      {
+        "interface": {
+          "id": "e4c140ec-7479-46f9-b185-4b533f19d639",
+          "interface_key": "rest_api:GET /workstreams/workplan-index",
+          "interface_kind": "rest_api",
+          "legacy_since": "2026-06-04T05:20:58.321869Z",
+          "replacement_ref": "/workplans/index",
+          "owner_component": "state-hub.api",
+          "status": "legacy",
+          "replacement_verified": true,
+          "manual_hold": false,
+          "hold_reason": null,
+          "notes": null,
+          "retired_at": null,
+          "created_at": "2026-06-04T05:20:58.321869Z",
+          "updated_at": "2026-06-04T05:20:58.321869Z"
+        },
+        "all_time": {
+          "calls": 30,
+          "tenant_count": 1,
+          "user_count": 1,
+          "component_count": 1,
+          "tenants": {
+            "unknown": 30
+          },
+          "users": {
+            "unknown": 30
+          },
+          "components": {
+            "unknown": 30
+          }
+        },
+        "window": {
+          "calls": 0,
+          "tenant_count": 0,
+          "user_count": 0,
+          "component_count": 0,
+          "tenants": {},
+          "users": {},
+          "components": {}
+        },
+        "last_seen_at": "2026-07-03T05:20:34.534439Z",
+        "retirement_candidate": true,
+        "retirement_reason": "no measured usage in review window"
+      },
+      {
+        "interface": {
+          "id": "3a00b19e-e7db-4403-98aa-a77c9ab61ecc",
+          "interface_key": "rest_api:GET /workstreams/{workstream_id}",
+          "interface_kind": "rest_api",
+          "legacy_since": "2026-06-04T00:25:59.014966Z",
+          "replacement_ref": "/workplans/{workplan_id}",
+          "owner_component": "state-hub.api",
+          "status": "legacy",
+          "replacement_verified": true,
+          "manual_hold": false,
+          "hold_reason": null,
+          "notes": null,
+          "retired_at": null,
+          "created_at": "2026-06-04T00:25:59.014966Z",
+          "updated_at": "2026-06-04T00:25:59.014966Z"
+        },
+        "all_time": {
+          "calls": 511406,
+          "tenant_count": 1,
+          "user_count": 1,
+          "component_count": 1,
+          "tenants": {
+            "unknown": 511406
+          },
+          "users": {
+            "unknown": 511406
+          },
+          "components": {
+            "unknown": 511406
+          }
+        },
+        "window": {
+          "calls": 0,
+          "tenant_count": 0,
+          "user_count": 0,
+          "component_count": 0,
+          "tenants": {},
+          "users": {},
+          "components": {}
+        },
+        "last_seen_at": "2026-07-31T16:25:32.004042Z",
+        "retirement_candidate": true,
+        "retirement_reason": "no measured usage in review window"
+      },
+      {
+        "interface": {
+          "id": "69e1a255-a8b9-4101-8a68-b1bed23abfda",
+          "interface_key": "rest_api:GET /workstreams/{workstream_id}/dependencies/",
+          "interface_kind": "rest_api",
+          "legacy_since": "2026-06-04T00:25:59.291135Z",
+          "replacement_ref": "/workplans/{workplan_id}/dependencies/",
+          "owner_component": "state-hub.api",
+          "status": "legacy",
+          "replacement_verified": true,
+          "manual_hold": false,
+          "hold_reason": null,
+          "notes": null,
+          "retired_at": null,
+          "created_at": "2026-06-04T00:25:59.291135Z",
+          "updated_at": "2026-06-04T00:25:59.291135Z"
+        },
+        "all_time": {
+          "calls": 255865,
+          "tenant_count": 1,
+          "user_count": 1,
+          "component_count": 1,
+          "tenants": {
+            "unknown": 255865
+          },
+          "users": {
+            "unknown": 255865
+          },
+          "components": {
+            "unknown": 255865
+          }
+        },
+        "window": {
+          "calls": 0,
+          "tenant_count": 0,
+          "user_count": 0,
+          "component_count": 0,
+          "tenants": {},
+          "users": {},
+          "components": {}
+        },
+        "last_seen_at": "2026-07-08T21:14:12.747005Z",
+        "retirement_candidate": true,
+        "retirement_reason": "no measured usage in review window"
+      },
+      {
+        "interface": {
+          "id": "b1aae931-b51f-4a85-a723-865dd65f6132",
+          "interface_key": "rest_api:PATCH /workstreams/{workstream_id}",
+          "interface_kind": "rest_api",
+          "legacy_since": "2026-06-04T06:09:41.901035Z",
+          "replacement_ref": "/workplans/{workplan_id}",
+          "owner_component": "state-hub.api",
+          "status": "legacy",
+          "replacement_verified": true,
+          "manual_hold": false,
+          "hold_reason": null,
+          "notes": null,
+          "retired_at": null,
+          "created_at": "2026-06-04T06:09:41.901035Z",
+          "updated_at": "2026-06-04T06:09:41.901035Z"
+        },
+        "all_time": {
+          "calls": 571,
+          "tenant_count": 1,
+          "user_count": 1,
+          "component_count": 1,
+          "tenants": {
+            "unknown": 571
+          },
+          "users": {
+            "unknown": 571
+          },
+          "components": {
+            "unknown": 571
+          }
+        },
+        "window": {
+          "calls": 0,
+          "tenant_count": 0,
+          "user_count": 0,
+          "component_count": 0,
+          "tenants": {},
+          "users": {},
+          "components": {}
+        },
+        "last_seen_at": "2026-07-08T20:49:12.335710Z",
+        "retirement_candidate": true,
+        "retirement_reason": "no measured usage in review window"
+      },
+      {
+        "interface": {
+          "id": "4aea9591-970b-4918-ac4a-4da95a0a1a8c",
+          "interface_key": "rest_api:POST /decisions/ workstream_id",
+          "interface_kind": "rest_api",
+          "legacy_since": "2026-07-09T22:56:35.473130Z",
+          "replacement_ref": "POST /decisions/ with workplan_id",
+          "owner_component": "state-hub.api",
+          "status": "legacy",
+          "replacement_verified": true,
+          "manual_hold": false,
+          "hold_reason": null,
+          "notes": null,
+          "retired_at": null,
+          "created_at": "2026-07-09T22:56:35.473130Z",
+          "updated_at": "2026-07-09T22:56:35.473130Z"
+        },
+        "all_time": {
+          "calls": 3,
+          "tenant_count": 1,
+          "user_count": 1,
+          "component_count": 1,
+          "tenants": {
+            "unknown": 3
+          },
+          "users": {
+            "unknown": 3
+          },
+          "components": {
+            "unknown": 3
+          }
+        },
+        "window": {
+          "calls": 0,
+          "tenant_count": 0,
+          "user_count": 0,
+          "component_count": 0,
+          "tenants": {},
+          "users": {},
+          "components": {}
+        },
+        "last_seen_at": "2026-07-09T22:57:05.912456Z",
+        "retirement_candidate": true,
+        "retirement_reason": "no measured usage in review window"
+      },
+      {
+        "interface": {
+          "id": "4a70583c-1e41-4ec1-99a9-728856a7d79c",
+          "interface_key": "rest_api:POST /progress/ workstream_id",
+          "interface_kind": "rest_api",
+          "legacy_since": "2026-07-08T23:35:09.148333Z",
+          "replacement_ref": "POST /progress/ with workplan_id",
+          "owner_component": "state-hub.api",
+          "status": "legacy",
+          "replacement_verified": true,
+          "manual_hold": false,
+          "hold_reason": null,
+          "notes": null,
+          "retired_at": null,
+          "created_at": "2026-07-08T23:35:09.148333Z",
+          "updated_at": "2026-07-08T23:35:09.148333Z"
+        },
+        "all_time": {
+          "calls": 14,
+          "tenant_count": 1,
+          "user_count": 1,
+          "component_count": 1,
+          "tenants": {
+            "unknown": 14
+          },
+          "users": {
+            "unknown": 14
+          },
+          "components": {
+            "unknown": 14
+          }
+        },
+        "window": {
+          "calls": 0,
+          "tenant_count": 0,
+          "user_count": 0,
+          "component_count": 0,
+          "tenants": {},
+          "users": {},
+          "components": {}
+        },
+        "last_seen_at": "2026-07-10T08:34:42.959724Z",
+        "retirement_candidate": true,
+        "retirement_reason": "no measured usage in review window"
+      },
+      {
+        "interface": {
+          "id": "6df4e443-7bf1-461a-923b-a6eb52fe7b07",
+          "interface_key": "rest_api:POST /tasks/ workstream_id",
+          "interface_kind": "rest_api",
+          "legacy_since": "2026-07-08T22:38:29.405720Z",
+          "replacement_ref": "POST /tasks/ with workplan_id",
+          "owner_component": "state-hub.api",
+          "status": "legacy",
+          "replacement_verified": true,
+          "manual_hold": false,
+          "hold_reason": null,
+          "notes": null,
+          "retired_at": null,
+          "created_at": "2026-07-08T22:38:29.405720Z",
+          "updated_at": "2026-07-08T22:38:29.405720Z"
+        },
+        "all_time": {
+          "calls": 5,
+          "tenant_count": 1,
+          "user_count": 1,
+          "component_count": 1,
+          "tenants": {
+            "unknown": 5
+          },
+          "users": {
+            "unknown": 5
+          },
+          "components": {
+            "state-hub.fix-consistency": 5
+          }
+        },
+        "window": {
+          "calls": 0,
+          "tenant_count": 0,
+          "user_count": 0,
+          "component_count": 0,
+          "tenants": {},
+          "users": {},
+          "components": {}
+        },
+        "last_seen_at": "2026-07-08T22:38:29.976918Z",
+        "retirement_candidate": true,
+        "retirement_reason": "no measured usage in review window"
+      },
+      {
+        "interface": {
+          "id": "ed6451c9-d2cc-4486-9afe-d3852782cabc",
+          "interface_key": "rest_api:POST /workstreams/",
+          "interface_kind": "rest_api",
+          "legacy_since": "2026-06-04T07:40:24.168535Z",
+          "replacement_ref": "/workplans/",
+          "owner_component": "state-hub.api",
+          "status": "legacy",
+          "replacement_verified": true,
+          "manual_hold": false,
+          "hold_reason": null,
+          "notes": null,
+          "retired_at": null,
+          "created_at": "2026-06-04T07:40:24.168535Z",
+          "updated_at": "2026-06-04T07:40:24.168535Z"
+        },
+        "all_time": {
+          "calls": 824,
+          "tenant_count": 1,
+          "user_count": 1,
+          "component_count": 1,
+          "tenants": {
+            "unknown": 824
+          },
+          "users": {
+            "unknown": 824
+          },
+          "components": {
+            "unknown": 824
+          }
+        },
+        "window": {
+          "calls": 0,
+          "tenant_count": 0,
+          "user_count": 0,
+          "component_count": 0,
+          "tenants": {},
+          "users": {},
+          "components": {}
+        },
+        "last_seen_at": "2026-07-08T20:38:05.903144Z",
+        "retirement_candidate": true,
+        "retirement_reason": "no measured usage in review window"
+      },
+      {
+        "interface": {
+          "id": "281fd706-b192-4194-8055-2d8733c115f9",
+          "interface_key": "rest_api:POST /workstreams/{workstream_id}/dependencies/",
+          "interface_kind": "rest_api",
+          "legacy_since": "2026-06-04T22:57:37.149207Z",
+          "replacement_ref": "/workplans/{workplan_id}/dependencies/",
+          "owner_component": "state-hub.api",
+          "status": "legacy",
+          "replacement_verified": true,
+          "manual_hold": false,
+          "hold_reason": null,
+          "notes": null,
+          "retired_at": null,
+          "created_at": "2026-06-04T22:57:37.149207Z",
+          "updated_at": "2026-06-04T22:57:37.149207Z"
+        },
+        "all_time": {
+          "calls": 4971,
+          "tenant_count": 1,
+          "user_count": 1,
+          "component_count": 1,
+          "tenants": {
+            "unknown": 4971
+          },
+          "users": {
+            "unknown": 4971
+          },
+          "components": {
+            "unknown": 4971
+          }
+        },
+        "window": {
+          "calls": 0,
+          "tenant_count": 0,
+          "user_count": 0,
+          "component_count": 0,
+          "tenants": {},
+          "users": {},
+          "components": {}
+        },
+        "last_seen_at": "2026-07-01T22:09:24.229011Z",
+        "retirement_candidate": true,
+        "retirement_reason": "no measured usage in review window"
+      }
+    ]
+  },
+  "hours": 8
+}
diff --git a/docs/evidence/legacy-meter-weekly-review-20260809.json b/docs/evidence/legacy-meter-weekly-review-20260809.json
new file mode 100644
index 0000000..fa002e7
--- /dev/null
+++ b/docs/evidence/legacy-meter-weekly-review-20260809.json
@@ -0,0 +1,1755 @@
+{
+  "captured_at": "2026-08-09T14:00:07.639782+00:00",
+  "api_base": "http://127.0.0.1:8000",
+  "workplan": "STATE-WP-0070",
+  "retired_interfaces": [],
+  "weekly_review": {
+    "generated_at": "2026-08-09T14:00:07.633236Z",
+    "window_start": "2026-08-09T06:00:07.531028Z",
+    "window_end": "2026-08-09T14:00:07.531028Z",
+    "cadence": "weekly",
+    "activity_core_handoff": {
+      "activity_id": "statehub-legacy-interface-review",
+      "cadence": "weekly",
+      "source_endpoint": "/legacy-meter/weekly-review",
+      "state_owner": "state-hub",
+      "scheduler_owner": "activity-core"
+    },
+    "interfaces": [
+      {
+        "interface": {
+          "id": "8051fb40-66c9-4dc4-a413-13e8573e04a3",
+          "interface_key": "event_subject:org.statehub.workstream.completed",
+          "interface_kind": "event_subject",
+          "legacy_since": "2026-06-04T06:09:42.198193Z",
+          "replacement_ref": "org.statehub.workplan.completed",
+          "owner_component": "state-hub.events",
+          "status": "retired",
+          "replacement_verified": true,
+          "manual_hold": false,
+          "hold_reason": null,
+          "notes": "Retired by STATE-WP-0069 closeout",
+          "retired_at": "2026-07-08T21:38:52.773601Z",
+          "created_at": "2026-06-04T06:09:42.198193Z",
+          "updated_at": "2026-07-08T21:38:52.761243Z"
+        },
+        "all_time": {
+          "calls": 255,
+          "tenant_count": 1,
+          "user_count": 1,
+          "component_count": 1,
+          "tenants": {
+            "unknown": 255
+          },
+          "users": {
+            "unknown": 255
+          },
+          "components": {
+            "state-hub.events": 255
+          }
+        },
+        "window": {
+          "calls": 0,
+          "tenant_count": 0,
+          "user_count": 0,
+          "component_count": 0,
+          "tenants": {},
+          "users": {},
+          "components": {}
+        },
+        "last_seen_at": "2026-07-08T20:49:12.839383Z",
+        "retirement_candidate": false,
+        "retirement_reason": "already retired"
+      },
+      {
+        "interface": {
+          "id": "63ed90e3-42b4-431a-94db-e1254a52f9e2",
+          "interface_key": "mcp:create_workstream",
+          "interface_kind": "mcp_tool",
+          "legacy_since": "2026-07-10T13:19:44.205900Z",
+          "replacement_ref": "create_workplan",
+          "owner_component": "state-hub.mcp",
+          "status": "legacy",
+          "replacement_verified": true,
+          "manual_hold": false,
+          "hold_reason": null,
+          "notes": "Registered by STATE-WP-0070 T03 \u2014 zero-window streak starts at registration",
+          "retired_at": null,
+          "created_at": "2026-07-10T13:19:44.205900Z",
+          "updated_at": "2026-07-10T13:19:44.205900Z"
+        },
+        "all_time": {
+          "calls": 2,
+          "tenant_count": 1,
+          "user_count": 1,
+          "component_count": 1,
+          "tenants": {
+            "unknown": 2
+          },
+          "users": {
+            "unknown": 2
+          },
+          "components": {
+            "state-hub.mcp": 2
+          }
+        },
+        "window": {
+          "calls": 0,
+          "tenant_count": 0,
+          "user_count": 0,
+          "component_count": 0,
+          "tenants": {},
+          "users": {},
+          "components": {}
+        },
+        "last_seen_at": "2026-07-10T13:20:43.378546Z",
+        "retirement_candidate": true,
+        "retirement_reason": "no measured usage in review window"
+      },
+      {
+        "interface": {
+          "id": "b6a5fe44-fb85-4ef7-a273-78d09da777af",
+          "interface_key": "mcp:list_workstreams",
+          "interface_kind": "mcp_tool",
+          "legacy_since": "2026-07-10T13:19:26.075491Z",
+          "replacement_ref": "list_workplans",
+          "owner_component": "state-hub.mcp",
+          "status": "legacy",
+          "replacement_verified": true,
+          "manual_hold": false,
+          "hold_reason": null,
+          "notes": null,
+          "retired_at": null,
+          "created_at": "2026-07-10T13:19:26.075491Z",
+          "updated_at": "2026-07-10T13:19:26.075491Z"
+        },
+        "all_time": {
+          "calls": 2,
+          "tenant_count": 1,
+          "user_count": 1,
+          "component_count": 1,
+          "tenants": {
+            "unknown": 2
+          },
+          "users": {
+            "unknown": 2
+          },
+          "components": {
+            "state-hub.mcp": 2
+          }
+        },
+        "window": {
+          "calls": 0,
+          "tenant_count": 0,
+          "user_count": 0,
+          "component_count": 0,
+          "tenants": {},
+          "users": {},
+          "components": {}
+        },
+        "last_seen_at": "2026-07-10T13:20:42.374940Z",
+        "retirement_candidate": true,
+        "retirement_reason": "no measured usage in review window"
+      },
+      {
+        "interface": {
+          "id": "53c3372b-307d-4d6a-8ea4-bc36cacdcaf2",
+          "interface_key": "mcp:update_workstream",
+          "interface_kind": "mcp_tool",
+          "legacy_since": "2026-07-10T13:19:44.255216Z",
+          "replacement_ref": "update_workplan",
+          "owner_component": "state-hub.mcp",
+          "status": "legacy",
+          "replacement_verified": true,
+          "manual_hold": false,
+          "hold_reason": null,
+          "notes": "Registered by STATE-WP-0070 T03 \u2014 zero-window streak starts at registration",
+          "retired_at": null,
+          "created_at": "2026-07-10T13:19:44.255216Z",
+          "updated_at": "2026-07-10T13:19:44.255216Z"
+        },
+        "all_time": {
+          "calls": 0,
+          "tenant_count": 0,
+          "user_count": 0,
+          "component_count": 0,
+          "tenants": {},
+          "users": {},
+          "components": {}
+        },
+        "window": {
+          "calls": 0,
+          "tenant_count": 0,
+          "user_count": 0,
+          "component_count": 0,
+          "tenants": {},
+          "users": {},
+          "components": {}
+        },
+        "last_seen_at": null,
+        "retirement_candidate": true,
+        "retirement_reason": "no measured usage in review window"
+      },
+      {
+        "interface": {
+          "id": "bed4d08a-3471-48f5-9f0e-f9d550383a26",
+          "interface_key": "mcp:update_workstream_status",
+          "interface_kind": "mcp_tool",
+          "legacy_since": "2026-07-10T13:19:44.303612Z",
+          "replacement_ref": "update_workplan_status",
+          "owner_component": "state-hub.mcp",
+          "status": "legacy",
+          "replacement_verified": true,
+          "manual_hold": false,
+          "hold_reason": null,
+          "notes": "Registered by STATE-WP-0070 T03 \u2014 zero-window streak starts at registration",
+          "retired_at": null,
+          "created_at": "2026-07-10T13:19:44.303612Z",
+          "updated_at": "2026-07-10T13:19:44.303612Z"
+        },
+        "all_time": {
+          "calls": 0,
+          "tenant_count": 0,
+          "user_count": 0,
+          "component_count": 0,
+          "tenants": {},
+          "users": {},
+          "components": {}
+        },
+        "window": {
+          "calls": 0,
+          "tenant_count": 0,
+          "user_count": 0,
+          "component_count": 0,
+          "tenants": {},
+          "users": {},
+          "components": {}
+        },
+        "last_seen_at": null,
+        "retirement_candidate": true,
+        "retirement_reason": "no measured usage in review window"
+      },
+      {
+        "interface": {
+          "id": "46900dc2-0893-405b-ba59-80f31fb6ebb1",
+          "interface_key": "state://workstreams/{topic_slug}",
+          "interface_kind": "mcp_tool",
+          "legacy_since": "2026-07-10T13:19:44.344493Z",
+          "replacement_ref": "state://workplans/{topic_slug}",
+          "owner_component": "state-hub.mcp",
+          "status": "legacy",
+          "replacement_verified": true,
+          "manual_hold": false,
+          "hold_reason": null,
+          "notes": "Registered by STATE-WP-0070 T03 \u2014 zero-window streak starts at registration",
+          "retired_at": null,
+          "created_at": "2026-07-10T13:19:44.344493Z",
+          "updated_at": "2026-07-10T13:19:44.344493Z"
+        },
+        "all_time": {
+          "calls": 1,
+          "tenant_count": 1,
+          "user_count": 1,
+          "component_count": 1,
+          "tenants": {
+            "unknown": 1
+          },
+          "users": {
+            "unknown": 1
+          },
+          "components": {
+            "state-hub.mcp": 1
+          }
+        },
+        "window": {
+          "calls": 0,
+          "tenant_count": 0,
+          "user_count": 0,
+          "component_count": 0,
+          "tenants": {},
+          "users": {},
+          "components": {}
+        },
+        "last_seen_at": "2026-07-10T13:20:34.491811Z",
+        "retirement_candidate": true,
+        "retirement_reason": "no measured usage in review window"
+      },
+      {
+        "interface": {
+          "id": "cd9342fd-27e7-4a46-a1be-d41499e106a3",
+          "interface_key": "rest_api:DELETE /workstreams/{workstream_id}",
+          "interface_kind": "rest_api",
+          "legacy_since": "2026-06-06T17:28:13.052813Z",
+          "replacement_ref": "/workplans/{workplan_id}",
+          "owner_component": "state-hub.api",
+          "status": "legacy",
+          "replacement_verified": true,
+          "manual_hold": false,
+          "hold_reason": null,
+          "notes": null,
+          "retired_at": null,
+          "created_at": "2026-06-06T17:28:13.052813Z",
+          "updated_at": "2026-06-06T17:28:13.052813Z"
+        },
+        "all_time": {
+          "calls": 1,
+          "tenant_count": 1,
+          "user_count": 1,
+          "component_count": 1,
+          "tenants": {
+            "unknown": 1
+          },
+          "users": {
+            "unknown": 1
+          },
+          "components": {
+            "unknown": 1
+          }
+        },
+        "window": {
+          "calls": 0,
+          "tenant_count": 0,
+          "user_count": 0,
+          "component_count": 0,
+          "tenants": {},
+          "users": {},
+          "components": {}
+        },
+        "last_seen_at": "2026-06-06T17:28:13.047529Z",
+        "retirement_candidate": true,
+        "retirement_reason": "no measured usage in review window"
+      },
+      {
+        "interface": {
+          "id": "a4e0948c-cd4a-461e-8ae2-7fd7b51d04a7",
+          "interface_key": "rest_api:GET /decisions/?workstream_id",
+          "interface_kind": "rest_api",
+          "legacy_since": "2026-07-09T23:07:53.093223Z",
+          "replacement_ref": "/decisions/?workplan_id=<workplan_id>",
+          "owner_component": "state-hub.api",
+          "status": "legacy",
+          "replacement_verified": true,
+          "manual_hold": false,
+          "hold_reason": null,
+          "notes": null,
+          "retired_at": null,
+          "created_at": "2026-07-09T23:07:53.093223Z",
+          "updated_at": "2026-07-09T23:07:53.093223Z"
+        },
+        "all_time": {
+          "calls": 1,
+          "tenant_count": 1,
+          "user_count": 1,
+          "component_count": 1,
+          "tenants": {
+            "unknown": 1
+          },
+          "users": {
+            "unknown": 1
+          },
+          "components": {
+            "unknown": 1
+          }
+        },
+        "window": {
+          "calls": 0,
+          "tenant_count": 0,
+          "user_count": 0,
+          "component_count": 0,
+          "tenants": {},
+          "users": {},
+          "components": {}
+        },
+        "last_seen_at": "2026-07-09T23:07:53.083299Z",
+        "retirement_candidate": true,
+        "retirement_reason": "no measured usage in review window"
+      },
+      {
+        "interface": {
+          "id": "70a9346e-e0ee-42ac-874f-f160580b54dd",
+          "interface_key": "rest_api:GET /progress/?workstream_id",
+          "interface_kind": "rest_api",
+          "legacy_since": "2026-07-13T22:04:03.911449Z",
+          "replacement_ref": "/progress/?workplan_id=<workplan_id>",
+          "owner_component": "state-hub.api",
+          "status": "legacy",
+          "replacement_verified": true,
+          "manual_hold": false,
+          "hold_reason": null,
+          "notes": null,
+          "retired_at": null,
+          "created_at": "2026-07-13T22:04:03.911449Z",
+          "updated_at": "2026-07-13T22:04:03.911449Z"
+        },
+        "all_time": {
+          "calls": 1,
+          "tenant_count": 1,
+          "user_count": 1,
+          "component_count": 1,
+          "tenants": {
+            "unknown": 1
+          },
+          "users": {
+            "unknown": 1
+          },
+          "components": {
+            "unknown": 1
+          }
+        },
+        "window": {
+          "calls": 0,
+          "tenant_count": 0,
+          "user_count": 0,
+          "component_count": 0,
+          "tenants": {},
+          "users": {},
+          "components": {}
+        },
+        "last_seen_at": "2026-07-13T22:04:03.904998Z",
+        "retirement_candidate": true,
+        "retirement_reason": "no measured usage in review window"
+      },
+      {
+        "interface": {
+          "id": "be3cdcf8-250b-4bf0-801f-02ffd5f57e00",
+          "interface_key": "rest_api:GET /tasks/?workstream_id",
+          "interface_kind": "rest_api",
+          "legacy_since": "2026-07-08T19:32:21.628513Z",
+          "replacement_ref": "/tasks/?workplan_id=<workplan_id>",
+          "owner_component": "state-hub.api",
+          "status": "legacy",
+          "replacement_verified": true,
+          "manual_hold": false,
+          "hold_reason": null,
+          "notes": null,
+          "retired_at": null,
+          "created_at": "2026-07-08T19:32:21.628513Z",
+          "updated_at": "2026-07-08T19:32:21.628513Z"
+        },
+        "all_time": {
+          "calls": 589,
+          "tenant_count": 1,
+          "user_count": 1,
+          "component_count": 1,
+          "tenants": {
+            "unknown": 589
+          },
+          "users": {
+            "unknown": 589
+          },
+          "components": {
+            "unknown": 589
+          }
+        },
+        "window": {
+          "calls": 0,
+          "tenant_count": 0,
+          "user_count": 0,
+          "component_count": 0,
+          "tenants": {},
+          "users": {},
+          "components": {}
+        },
+        "last_seen_at": "2026-07-31T16:25:32.181901Z",
+        "retirement_candidate": true,
+        "retirement_reason": "no measured usage in review window"
+      },
+      {
+        "interface": {
+          "id": "3e4a3d0b-08fa-45c3-91e2-4f514a914b97",
+          "interface_key": "rest_api:GET /workstreams/",
+          "interface_kind": "rest_api",
+          "legacy_since": "2026-06-04T00:26:14.533764Z",
+          "replacement_ref": "/workplans/",
+          "owner_component": "state-hub.api",
+          "status": "legacy",
+          "replacement_verified": true,
+          "manual_hold": false,
+          "hold_reason": null,
+          "notes": null,
+          "retired_at": null,
+          "created_at": "2026-06-04T00:26:14.533764Z",
+          "updated_at": "2026-06-04T00:26:14.533764Z"
+        },
+        "all_time": {
+          "calls": 144085,
+          "tenant_count": 1,
+          "user_count": 1,
+          "component_count": 1,
+          "tenants": {
+            "unknown": 144085
+          },
+          "users": {
+            "unknown": 144085
+          },
+          "components": {
+            "unknown": 144085
+          }
+        },
+        "window": {
+          "calls": 0,
+          "tenant_count": 0,
+          "user_count": 0,
+          "component_count": 0,
+          "tenants": {},
+          "users": {},
+          "components": {}
+        },
+        "last_seen_at": "2026-08-05T13:01:38.000781Z",
+        "retirement_candidate": true,
+        "retirement_reason": "no measured usage in review window"
+      },
+      {
+        "interface": {
+          "id": "e4c140ec-7479-46f9-b185-4b533f19d639",
+          "interface_key": "rest_api:GET /workstreams/workplan-index",
+          "interface_kind": "rest_api",
+          "legacy_since": "2026-06-04T05:20:58.321869Z",
+          "replacement_ref": "/workplans/index",
+          "owner_component": "state-hub.api",
+          "status": "legacy",
+          "replacement_verified": true,
+          "manual_hold": false,
+          "hold_reason": null,
+          "notes": null,
+          "retired_at": null,
+          "created_at": "2026-06-04T05:20:58.321869Z",
+          "updated_at": "2026-06-04T05:20:58.321869Z"
+        },
+        "all_time": {
+          "calls": 30,
+          "tenant_count": 1,
+          "user_count": 1,
+          "component_count": 1,
+          "tenants": {
+            "unknown": 30
+          },
+          "users": {
+            "unknown": 30
+          },
+          "components": {
+            "unknown": 30
+          }
+        },
+        "window": {
+          "calls": 0,
+          "tenant_count": 0,
+          "user_count": 0,
+          "component_count": 0,
+          "tenants": {},
+          "users": {},
+          "components": {}
+        },
+        "last_seen_at": "2026-07-03T05:20:34.534439Z",
+        "retirement_candidate": true,
+        "retirement_reason": "no measured usage in review window"
+      },
+      {
+        "interface": {
+          "id": "3a00b19e-e7db-4403-98aa-a77c9ab61ecc",
+          "interface_key": "rest_api:GET /workstreams/{workstream_id}",
+          "interface_kind": "rest_api",
+          "legacy_since": "2026-06-04T00:25:59.014966Z",
+          "replacement_ref": "/workplans/{workplan_id}",
+          "owner_component": "state-hub.api",
+          "status": "legacy",
+          "replacement_verified": true,
+          "manual_hold": false,
+          "hold_reason": null,
+          "notes": null,
+          "retired_at": null,
+          "created_at": "2026-06-04T00:25:59.014966Z",
+          "updated_at": "2026-06-04T00:25:59.014966Z"
+        },
+        "all_time": {
+          "calls": 511406,
+          "tenant_count": 1,
+          "user_count": 1,
+          "component_count": 1,
+          "tenants": {
+            "unknown": 511406
+          },
+          "users": {
+            "unknown": 511406
+          },
+          "components": {
+            "unknown": 511406
+          }
+        },
+        "window": {
+          "calls": 0,
+          "tenant_count": 0,
+          "user_count": 0,
+          "component_count": 0,
+          "tenants": {},
+          "users": {},
+          "components": {}
+        },
+        "last_seen_at": "2026-07-31T16:25:32.004042Z",
+        "retirement_candidate": true,
+        "retirement_reason": "no measured usage in review window"
+      },
+      {
+        "interface": {
+          "id": "69e1a255-a8b9-4101-8a68-b1bed23abfda",
+          "interface_key": "rest_api:GET /workstreams/{workstream_id}/dependencies/",
+          "interface_kind": "rest_api",
+          "legacy_since": "2026-06-04T00:25:59.291135Z",
+          "replacement_ref": "/workplans/{workplan_id}/dependencies/",
+          "owner_component": "state-hub.api",
+          "status": "legacy",
+          "replacement_verified": true,
+          "manual_hold": false,
+          "hold_reason": null,
+          "notes": null,
+          "retired_at": null,
+          "created_at": "2026-06-04T00:25:59.291135Z",
+          "updated_at": "2026-06-04T00:25:59.291135Z"
+        },
+        "all_time": {
+          "calls": 255865,
+          "tenant_count": 1,
+          "user_count": 1,
+          "component_count": 1,
+          "tenants": {
+            "unknown": 255865
+          },
+          "users": {
+            "unknown": 255865
+          },
+          "components": {
+            "unknown": 255865
+          }
+        },
+        "window": {
+          "calls": 0,
+          "tenant_count": 0,
+          "user_count": 0,
+          "component_count": 0,
+          "tenants": {},
+          "users": {},
+          "components": {}
+        },
+        "last_seen_at": "2026-07-08T21:14:12.747005Z",
+        "retirement_candidate": true,
+        "retirement_reason": "no measured usage in review window"
+      },
+      {
+        "interface": {
+          "id": "b1aae931-b51f-4a85-a723-865dd65f6132",
+          "interface_key": "rest_api:PATCH /workstreams/{workstream_id}",
+          "interface_kind": "rest_api",
+          "legacy_since": "2026-06-04T06:09:41.901035Z",
+          "replacement_ref": "/workplans/{workplan_id}",
+          "owner_component": "state-hub.api",
+          "status": "legacy",
+          "replacement_verified": true,
+          "manual_hold": false,
+          "hold_reason": null,
+          "notes": null,
+          "retired_at": null,
+          "created_at": "2026-06-04T06:09:41.901035Z",
+          "updated_at": "2026-06-04T06:09:41.901035Z"
+        },
+        "all_time": {
+          "calls": 571,
+          "tenant_count": 1,
+          "user_count": 1,
+          "component_count": 1,
+          "tenants": {
+            "unknown": 571
+          },
+          "users": {
+            "unknown": 571
+          },
+          "components": {
+            "unknown": 571
+          }
+        },
+        "window": {
+          "calls": 0,
+          "tenant_count": 0,
+          "user_count": 0,
+          "component_count": 0,
+          "tenants": {},
+          "users": {},
+          "components": {}
+        },
+        "last_seen_at": "2026-07-08T20:49:12.335710Z",
+        "retirement_candidate": true,
+        "retirement_reason": "no measured usage in review window"
+      },
+      {
+        "interface": {
+          "id": "4aea9591-970b-4918-ac4a-4da95a0a1a8c",
+          "interface_key": "rest_api:POST /decisions/ workstream_id",
+          "interface_kind": "rest_api",
+          "legacy_since": "2026-07-09T22:56:35.473130Z",
+          "replacement_ref": "POST /decisions/ with workplan_id",
+          "owner_component": "state-hub.api",
+          "status": "legacy",
+          "replacement_verified": true,
+          "manual_hold": false,
+          "hold_reason": null,
+          "notes": null,
+          "retired_at": null,
+          "created_at": "2026-07-09T22:56:35.473130Z",
+          "updated_at": "2026-07-09T22:56:35.473130Z"
+        },
+        "all_time": {
+          "calls": 3,
+          "tenant_count": 1,
+          "user_count": 1,
+          "component_count": 1,
+          "tenants": {
+            "unknown": 3
+          },
+          "users": {
+            "unknown": 3
+          },
+          "components": {
+            "unknown": 3
+          }
+        },
+        "window": {
+          "calls": 0,
+          "tenant_count": 0,
+          "user_count": 0,
+          "component_count": 0,
+          "tenants": {},
+          "users": {},
+          "components": {}
+        },
+        "last_seen_at": "2026-07-09T22:57:05.912456Z",
+        "retirement_candidate": true,
+        "retirement_reason": "no measured usage in review window"
+      },
+      {
+        "interface": {
+          "id": "4a70583c-1e41-4ec1-99a9-728856a7d79c",
+          "interface_key": "rest_api:POST /progress/ workstream_id",
+          "interface_kind": "rest_api",
+          "legacy_since": "2026-07-08T23:35:09.148333Z",
+          "replacement_ref": "POST /progress/ with workplan_id",
+          "owner_component": "state-hub.api",
+          "status": "legacy",
+          "replacement_verified": true,
+          "manual_hold": false,
+          "hold_reason": null,
+          "notes": null,
+          "retired_at": null,
+          "created_at": "2026-07-08T23:35:09.148333Z",
+          "updated_at": "2026-07-08T23:35:09.148333Z"
+        },
+        "all_time": {
+          "calls": 14,
+          "tenant_count": 1,
+          "user_count": 1,
+          "component_count": 1,
+          "tenants": {
+            "unknown": 14
+          },
+          "users": {
+            "unknown": 14
+          },
+          "components": {
+            "unknown": 14
+          }
+        },
+        "window": {
+          "calls": 0,
+          "tenant_count": 0,
+          "user_count": 0,
+          "component_count": 0,
+          "tenants": {},
+          "users": {},
+          "components": {}
+        },
+        "last_seen_at": "2026-07-10T08:34:42.959724Z",
+        "retirement_candidate": true,
+        "retirement_reason": "no measured usage in review window"
+      },
+      {
+        "interface": {
+          "id": "6df4e443-7bf1-461a-923b-a6eb52fe7b07",
+          "interface_key": "rest_api:POST /tasks/ workstream_id",
+          "interface_kind": "rest_api",
+          "legacy_since": "2026-07-08T22:38:29.405720Z",
+          "replacement_ref": "POST /tasks/ with workplan_id",
+          "owner_component": "state-hub.api",
+          "status": "legacy",
+          "replacement_verified": true,
+          "manual_hold": false,
+          "hold_reason": null,
+          "notes": null,
+          "retired_at": null,
+          "created_at": "2026-07-08T22:38:29.405720Z",
+          "updated_at": "2026-07-08T22:38:29.405720Z"
+        },
+        "all_time": {
+          "calls": 5,
+          "tenant_count": 1,
+          "user_count": 1,
+          "component_count": 1,
+          "tenants": {
+            "unknown": 5
+          },
+          "users": {
+            "unknown": 5
+          },
+          "components": {
+            "state-hub.fix-consistency": 5
+          }
+        },
+        "window": {
+          "calls": 0,
+          "tenant_count": 0,
+          "user_count": 0,
+          "component_count": 0,
+          "tenants": {},
+          "users": {},
+          "components": {}
+        },
+        "last_seen_at": "2026-07-08T22:38:29.976918Z",
+        "retirement_candidate": true,
+        "retirement_reason": "no measured usage in review window"
+      },
+      {
+        "interface": {
+          "id": "ed6451c9-d2cc-4486-9afe-d3852782cabc",
+          "interface_key": "rest_api:POST /workstreams/",
+          "interface_kind": "rest_api",
+          "legacy_since": "2026-06-04T07:40:24.168535Z",
+          "replacement_ref": "/workplans/",
+          "owner_component": "state-hub.api",
+          "status": "legacy",
+          "replacement_verified": true,
+          "manual_hold": false,
+          "hold_reason": null,
+          "notes": null,
+          "retired_at": null,
+          "created_at": "2026-06-04T07:40:24.168535Z",
+          "updated_at": "2026-06-04T07:40:24.168535Z"
+        },
+        "all_time": {
+          "calls": 824,
+          "tenant_count": 1,
+          "user_count": 1,
+          "component_count": 1,
+          "tenants": {
+            "unknown": 824
+          },
+          "users": {
+            "unknown": 824
+          },
+          "components": {
+            "unknown": 824
+          }
+        },
+        "window": {
+          "calls": 0,
+          "tenant_count": 0,
+          "user_count": 0,
+          "component_count": 0,
+          "tenants": {},
+          "users": {},
+          "components": {}
+        },
+        "last_seen_at": "2026-07-08T20:38:05.903144Z",
+        "retirement_candidate": true,
+        "retirement_reason": "no measured usage in review window"
+      },
+      {
+        "interface": {
+          "id": "281fd706-b192-4194-8055-2d8733c115f9",
+          "interface_key": "rest_api:POST /workstreams/{workstream_id}/dependencies/",
+          "interface_kind": "rest_api",
+          "legacy_since": "2026-06-04T22:57:37.149207Z",
+          "replacement_ref": "/workplans/{workplan_id}/dependencies/",
+          "owner_component": "state-hub.api",
+          "status": "legacy",
+          "replacement_verified": true,
+          "manual_hold": false,
+          "hold_reason": null,
+          "notes": null,
+          "retired_at": null,
+          "created_at": "2026-06-04T22:57:37.149207Z",
+          "updated_at": "2026-06-04T22:57:37.149207Z"
+        },
+        "all_time": {
+          "calls": 4971,
+          "tenant_count": 1,
+          "user_count": 1,
+          "component_count": 1,
+          "tenants": {
+            "unknown": 4971
+          },
+          "users": {
+            "unknown": 4971
+          },
+          "components": {
+            "unknown": 4971
+          }
+        },
+        "window": {
+          "calls": 0,
+          "tenant_count": 0,
+          "user_count": 0,
+          "component_count": 0,
+          "tenants": {},
+          "users": {},
+          "components": {}
+        },
+        "last_seen_at": "2026-07-01T22:09:24.229011Z",
+        "retirement_candidate": true,
+        "retirement_reason": "no measured usage in review window"
+      }
+    ],
+    "retirement_candidates": [
+      {
+        "interface": {
+          "id": "63ed90e3-42b4-431a-94db-e1254a52f9e2",
+          "interface_key": "mcp:create_workstream",
+          "interface_kind": "mcp_tool",
+          "legacy_since": "2026-07-10T13:19:44.205900Z",
+          "replacement_ref": "create_workplan",
+          "owner_component": "state-hub.mcp",
+          "status": "legacy",
+          "replacement_verified": true,
+          "manual_hold": false,
+          "hold_reason": null,
+          "notes": "Registered by STATE-WP-0070 T03 \u2014 zero-window streak starts at registration",
+          "retired_at": null,
+          "created_at": "2026-07-10T13:19:44.205900Z",
+          "updated_at": "2026-07-10T13:19:44.205900Z"
+        },
+        "all_time": {
+          "calls": 2,
+          "tenant_count": 1,
+          "user_count": 1,
+          "component_count": 1,
+          "tenants": {
+            "unknown": 2
+          },
+          "users": {
+            "unknown": 2
+          },
+          "components": {
+            "state-hub.mcp": 2
+          }
+        },
+        "window": {
+          "calls": 0,
+          "tenant_count": 0,
+          "user_count": 0,
+          "component_count": 0,
+          "tenants": {},
+          "users": {},
+          "components": {}
+        },
+        "last_seen_at": "2026-07-10T13:20:43.378546Z",
+        "retirement_candidate": true,
+        "retirement_reason": "no measured usage in review window"
+      },
+      {
+        "interface": {
+          "id": "b6a5fe44-fb85-4ef7-a273-78d09da777af",
+          "interface_key": "mcp:list_workstreams",
+          "interface_kind": "mcp_tool",
+          "legacy_since": "2026-07-10T13:19:26.075491Z",
+          "replacement_ref": "list_workplans",
+          "owner_component": "state-hub.mcp",
+          "status": "legacy",
+          "replacement_verified": true,
+          "manual_hold": false,
+          "hold_reason": null,
+          "notes": null,
+          "retired_at": null,
+          "created_at": "2026-07-10T13:19:26.075491Z",
+          "updated_at": "2026-07-10T13:19:26.075491Z"
+        },
+        "all_time": {
+          "calls": 2,
+          "tenant_count": 1,
+          "user_count": 1,
+          "component_count": 1,
+          "tenants": {
+            "unknown": 2
+          },
+          "users": {
+            "unknown": 2
+          },
+          "components": {
+            "state-hub.mcp": 2
+          }
+        },
+        "window": {
+          "calls": 0,
+          "tenant_count": 0,
+          "user_count": 0,
+          "component_count": 0,
+          "tenants": {},
+          "users": {},
+          "components": {}
+        },
+        "last_seen_at": "2026-07-10T13:20:42.374940Z",
+        "retirement_candidate": true,
+        "retirement_reason": "no measured usage in review window"
+      },
+      {
+        "interface": {
+          "id": "53c3372b-307d-4d6a-8ea4-bc36cacdcaf2",
+          "interface_key": "mcp:update_workstream",
+          "interface_kind": "mcp_tool",
+          "legacy_since": "2026-07-10T13:19:44.255216Z",
+          "replacement_ref": "update_workplan",
+          "owner_component": "state-hub.mcp",
+          "status": "legacy",
+          "replacement_verified": true,
+          "manual_hold": false,
+          "hold_reason": null,
+          "notes": "Registered by STATE-WP-0070 T03 \u2014 zero-window streak starts at registration",
+          "retired_at": null,
+          "created_at": "2026-07-10T13:19:44.255216Z",
+          "updated_at": "2026-07-10T13:19:44.255216Z"
+        },
+        "all_time": {
+          "calls": 0,
+          "tenant_count": 0,
+          "user_count": 0,
+          "component_count": 0,
+          "tenants": {},
+          "users": {},
+          "components": {}
+        },
+        "window": {
+          "calls": 0,
+          "tenant_count": 0,
+          "user_count": 0,
+          "component_count": 0,
+          "tenants": {},
+          "users": {},
+          "components": {}
+        },
+        "last_seen_at": null,
+        "retirement_candidate": true,
+        "retirement_reason": "no measured usage in review window"
+      },
+      {
+        "interface": {
+          "id": "bed4d08a-3471-48f5-9f0e-f9d550383a26",
+          "interface_key": "mcp:update_workstream_status",
+          "interface_kind": "mcp_tool",
+          "legacy_since": "2026-07-10T13:19:44.303612Z",
+          "replacement_ref": "update_workplan_status",
+          "owner_component": "state-hub.mcp",
+          "status": "legacy",
+          "replacement_verified": true,
+          "manual_hold": false,
+          "hold_reason": null,
+          "notes": "Registered by STATE-WP-0070 T03 \u2014 zero-window streak starts at registration",
+          "retired_at": null,
+          "created_at": "2026-07-10T13:19:44.303612Z",
+          "updated_at": "2026-07-10T13:19:44.303612Z"
+        },
+        "all_time": {
+          "calls": 0,
+          "tenant_count": 0,
+          "user_count": 0,
+          "component_count": 0,
+          "tenants": {},
+          "users": {},
+          "components": {}
+        },
+        "window": {
+          "calls": 0,
+          "tenant_count": 0,
+          "user_count": 0,
+          "component_count": 0,
+          "tenants": {},
+          "users": {},
+          "components": {}
+        },
+        "last_seen_at": null,
+        "retirement_candidate": true,
+        "retirement_reason": "no measured usage in review window"
+      },
+      {
+        "interface": {
+          "id": "46900dc2-0893-405b-ba59-80f31fb6ebb1",
+          "interface_key": "state://workstreams/{topic_slug}",
+          "interface_kind": "mcp_tool",
+          "legacy_since": "2026-07-10T13:19:44.344493Z",
+          "replacement_ref": "state://workplans/{topic_slug}",
+          "owner_component": "state-hub.mcp",
+          "status": "legacy",
+          "replacement_verified": true,
+          "manual_hold": false,
+          "hold_reason": null,
+          "notes": "Registered by STATE-WP-0070 T03 \u2014 zero-window streak starts at registration",
+          "retired_at": null,
+          "created_at": "2026-07-10T13:19:44.344493Z",
+          "updated_at": "2026-07-10T13:19:44.344493Z"
+        },
+        "all_time": {
+          "calls": 1,
+          "tenant_count": 1,
+          "user_count": 1,
+          "component_count": 1,
+          "tenants": {
+            "unknown": 1
+          },
+          "users": {
+            "unknown": 1
+          },
+          "components": {
+            "state-hub.mcp": 1
+          }
+        },
+        "window": {
+          "calls": 0,
+          "tenant_count": 0,
+          "user_count": 0,
+          "component_count": 0,
+          "tenants": {},
+          "users": {},
+          "components": {}
+        },
+        "last_seen_at": "2026-07-10T13:20:34.491811Z",
+        "retirement_candidate": true,
+        "retirement_reason": "no measured usage in review window"
+      },
+      {
+        "interface": {
+          "id": "cd9342fd-27e7-4a46-a1be-d41499e106a3",
+          "interface_key": "rest_api:DELETE /workstreams/{workstream_id}",
+          "interface_kind": "rest_api",
+          "legacy_since": "2026-06-06T17:28:13.052813Z",
+          "replacement_ref": "/workplans/{workplan_id}",
+          "owner_component": "state-hub.api",
+          "status": "legacy",
+          "replacement_verified": true,
+          "manual_hold": false,
+          "hold_reason": null,
+          "notes": null,
+          "retired_at": null,
+          "created_at": "2026-06-06T17:28:13.052813Z",
+          "updated_at": "2026-06-06T17:28:13.052813Z"
+        },
+        "all_time": {
+          "calls": 1,
+          "tenant_count": 1,
+          "user_count": 1,
+          "component_count": 1,
+          "tenants": {
+            "unknown": 1
+          },
+          "users": {
+            "unknown": 1
+          },
+          "components": {
+            "unknown": 1
+          }
+        },
+        "window": {
+          "calls": 0,
+          "tenant_count": 0,
+          "user_count": 0,
+          "component_count": 0,
+          "tenants": {},
+          "users": {},
+          "components": {}
+        },
+        "last_seen_at": "2026-06-06T17:28:13.047529Z",
+        "retirement_candidate": true,
+        "retirement_reason": "no measured usage in review window"
+      },
+      {
+        "interface": {
+          "id": "a4e0948c-cd4a-461e-8ae2-7fd7b51d04a7",
+          "interface_key": "rest_api:GET /decisions/?workstream_id",
+          "interface_kind": "rest_api",
+          "legacy_since": "2026-07-09T23:07:53.093223Z",
+          "replacement_ref": "/decisions/?workplan_id=<workplan_id>",
+          "owner_component": "state-hub.api",
+          "status": "legacy",
+          "replacement_verified": true,
+          "manual_hold": false,
+          "hold_reason": null,
+          "notes": null,
+          "retired_at": null,
+          "created_at": "2026-07-09T23:07:53.093223Z",
+          "updated_at": "2026-07-09T23:07:53.093223Z"
+        },
+        "all_time": {
+          "calls": 1,
+          "tenant_count": 1,
+          "user_count": 1,
+          "component_count": 1,
+          "tenants": {
+            "unknown": 1
+          },
+          "users": {
+            "unknown": 1
+          },
+          "components": {
+            "unknown": 1
+          }
+        },
+        "window": {
+          "calls": 0,
+          "tenant_count": 0,
+          "user_count": 0,
+          "component_count": 0,
+          "tenants": {},
+          "users": {},
+          "components": {}
+        },
+        "last_seen_at": "2026-07-09T23:07:53.083299Z",
+        "retirement_candidate": true,
+        "retirement_reason": "no measured usage in review window"
+      },
+      {
+        "interface": {
+          "id": "70a9346e-e0ee-42ac-874f-f160580b54dd",
+          "interface_key": "rest_api:GET /progress/?workstream_id",
+          "interface_kind": "rest_api",
+          "legacy_since": "2026-07-13T22:04:03.911449Z",
+          "replacement_ref": "/progress/?workplan_id=<workplan_id>",
+          "owner_component": "state-hub.api",
+          "status": "legacy",
+          "replacement_verified": true,
+          "manual_hold": false,
+          "hold_reason": null,
+          "notes": null,
+          "retired_at": null,
+          "created_at": "2026-07-13T22:04:03.911449Z",
+          "updated_at": "2026-07-13T22:04:03.911449Z"
+        },
+        "all_time": {
+          "calls": 1,
+          "tenant_count": 1,
+          "user_count": 1,
+          "component_count": 1,
+          "tenants": {
+            "unknown": 1
+          },
+          "users": {
+            "unknown": 1
+          },
+          "components": {
+            "unknown": 1
+          }
+        },
+        "window": {
+          "calls": 0,
+          "tenant_count": 0,
+          "user_count": 0,
+          "component_count": 0,
+          "tenants": {},
+          "users": {},
+          "components": {}
+        },
+        "last_seen_at": "2026-07-13T22:04:03.904998Z",
+        "retirement_candidate": true,
+        "retirement_reason": "no measured usage in review window"
+      },
+      {
+        "interface": {
+          "id": "be3cdcf8-250b-4bf0-801f-02ffd5f57e00",
+          "interface_key": "rest_api:GET /tasks/?workstream_id",
+          "interface_kind": "rest_api",
+          "legacy_since": "2026-07-08T19:32:21.628513Z",
+          "replacement_ref": "/tasks/?workplan_id=<workplan_id>",
+          "owner_component": "state-hub.api",
+          "status": "legacy",
+          "replacement_verified": true,
+          "manual_hold": false,
+          "hold_reason": null,
+          "notes": null,
+          "retired_at": null,
+          "created_at": "2026-07-08T19:32:21.628513Z",
+          "updated_at": "2026-07-08T19:32:21.628513Z"
+        },
+        "all_time": {
+          "calls": 589,
+          "tenant_count": 1,
+          "user_count": 1,
+          "component_count": 1,
+          "tenants": {
+            "unknown": 589
+          },
+          "users": {
+            "unknown": 589
+          },
+          "components": {
+            "unknown": 589
+          }
+        },
+        "window": {
+          "calls": 0,
+          "tenant_count": 0,
+          "user_count": 0,
+          "component_count": 0,
+          "tenants": {},
+          "users": {},
+          "components": {}
+        },
+        "last_seen_at": "2026-07-31T16:25:32.181901Z",
+        "retirement_candidate": true,
+        "retirement_reason": "no measured usage in review window"
+      },
+      {
+        "interface": {
+          "id": "3e4a3d0b-08fa-45c3-91e2-4f514a914b97",
+          "interface_key": "rest_api:GET /workstreams/",
+          "interface_kind": "rest_api",
+          "legacy_since": "2026-06-04T00:26:14.533764Z",
+          "replacement_ref": "/workplans/",
+          "owner_component": "state-hub.api",
+          "status": "legacy",
+          "replacement_verified": true,
+          "manual_hold": false,
+          "hold_reason": null,
+          "notes": null,
+          "retired_at": null,
+          "created_at": "2026-06-04T00:26:14.533764Z",
+          "updated_at": "2026-06-04T00:26:14.533764Z"
+        },
+        "all_time": {
+          "calls": 144085,
+          "tenant_count": 1,
+          "user_count": 1,
+          "component_count": 1,
+          "tenants": {
+            "unknown": 144085
+          },
+          "users": {
+            "unknown": 144085
+          },
+          "components": {
+            "unknown": 144085
+          }
+        },
+        "window": {
+          "calls": 0,
+          "tenant_count": 0,
+          "user_count": 0,
+          "component_count": 0,
+          "tenants": {},
+          "users": {},
+          "components": {}
+        },
+        "last_seen_at": "2026-08-05T13:01:38.000781Z",
+        "retirement_candidate": true,
+        "retirement_reason": "no measured usage in review window"
+      },
+      {
+        "interface": {
+          "id": "e4c140ec-7479-46f9-b185-4b533f19d639",
+          "interface_key": "rest_api:GET /workstreams/workplan-index",
+          "interface_kind": "rest_api",
+          "legacy_since": "2026-06-04T05:20:58.321869Z",
+          "replacement_ref": "/workplans/index",
+          "owner_component": "state-hub.api",
+          "status": "legacy",
+          "replacement_verified": true,
+          "manual_hold": false,
+          "hold_reason": null,
+          "notes": null,
+          "retired_at": null,
+          "created_at": "2026-06-04T05:20:58.321869Z",
+          "updated_at": "2026-06-04T05:20:58.321869Z"
+        },
+        "all_time": {
+          "calls": 30,
+          "tenant_count": 1,
+          "user_count": 1,
+          "component_count": 1,
+          "tenants": {
+            "unknown": 30
+          },
+          "users": {
+            "unknown": 30
+          },
+          "components": {
+            "unknown": 30
+          }
+        },
+        "window": {
+          "calls": 0,
+          "tenant_count": 0,
+          "user_count": 0,
+          "component_count": 0,
+          "tenants": {},
+          "users": {},
+          "components": {}
+        },
+        "last_seen_at": "2026-07-03T05:20:34.534439Z",
+        "retirement_candidate": true,
+        "retirement_reason": "no measured usage in review window"
+      },
+      {
+        "interface": {
+          "id": "3a00b19e-e7db-4403-98aa-a77c9ab61ecc",
+          "interface_key": "rest_api:GET /workstreams/{workstream_id}",
+          "interface_kind": "rest_api",
+          "legacy_since": "2026-06-04T00:25:59.014966Z",
+          "replacement_ref": "/workplans/{workplan_id}",
+          "owner_component": "state-hub.api",
+          "status": "legacy",
+          "replacement_verified": true,
+          "manual_hold": false,
+          "hold_reason": null,
+          "notes": null,
+          "retired_at": null,
+          "created_at": "2026-06-04T00:25:59.014966Z",
+          "updated_at": "2026-06-04T00:25:59.014966Z"
+        },
+        "all_time": {
+          "calls": 511406,
+          "tenant_count": 1,
+          "user_count": 1,
+          "component_count": 1,
+          "tenants": {
+            "unknown": 511406
+          },
+          "users": {
+            "unknown": 511406
+          },
+          "components": {
+            "unknown": 511406
+          }
+        },
+        "window": {
+          "calls": 0,
+          "tenant_count": 0,
+          "user_count": 0,
+          "component_count": 0,
+          "tenants": {},
+          "users": {},
+          "components": {}
+        },
+        "last_seen_at": "2026-07-31T16:25:32.004042Z",
+        "retirement_candidate": true,
+        "retirement_reason": "no measured usage in review window"
+      },
+      {
+        "interface": {
+          "id": "69e1a255-a8b9-4101-8a68-b1bed23abfda",
+          "interface_key": "rest_api:GET /workstreams/{workstream_id}/dependencies/",
+          "interface_kind": "rest_api",
+          "legacy_since": "2026-06-04T00:25:59.291135Z",
+          "replacement_ref": "/workplans/{workplan_id}/dependencies/",
+          "owner_component": "state-hub.api",
+          "status": "legacy",
+          "replacement_verified": true,
+          "manual_hold": false,
+          "hold_reason": null,
+          "notes": null,
+          "retired_at": null,
+          "created_at": "2026-06-04T00:25:59.291135Z",
+          "updated_at": "2026-06-04T00:25:59.291135Z"
+        },
+        "all_time": {
+          "calls": 255865,
+          "tenant_count": 1,
+          "user_count": 1,
+          "component_count": 1,
+          "tenants": {
+            "unknown": 255865
+          },
+          "users": {
+            "unknown": 255865
+          },
+          "components": {
+            "unknown": 255865
+          }
+        },
+        "window": {
+          "calls": 0,
+          "tenant_count": 0,
+          "user_count": 0,
+          "component_count": 0,
+          "tenants": {},
+          "users": {},
+          "components": {}
+        },
+        "last_seen_at": "2026-07-08T21:14:12.747005Z",
+        "retirement_candidate": true,
+        "retirement_reason": "no measured usage in review window"
+      },
+      {
+        "interface": {
+          "id": "b1aae931-b51f-4a85-a723-865dd65f6132",
+          "interface_key": "rest_api:PATCH /workstreams/{workstream_id}",
+          "interface_kind": "rest_api",
+          "legacy_since": "2026-06-04T06:09:41.901035Z",
+          "replacement_ref": "/workplans/{workplan_id}",
+          "owner_component": "state-hub.api",
+          "status": "legacy",
+          "replacement_verified": true,
+          "manual_hold": false,
+          "hold_reason": null,
+          "notes": null,
+          "retired_at": null,
+          "created_at": "2026-06-04T06:09:41.901035Z",
+          "updated_at": "2026-06-04T06:09:41.901035Z"
+        },
+        "all_time": {
+          "calls": 571,
+          "tenant_count": 1,
+          "user_count": 1,
+          "component_count": 1,
+          "tenants": {
+            "unknown": 571
+          },
+          "users": {
+            "unknown": 571
+          },
+          "components": {
+            "unknown": 571
+          }
+        },
+        "window": {
+          "calls": 0,
+          "tenant_count": 0,
+          "user_count": 0,
+          "component_count": 0,
+          "tenants": {},
+          "users": {},
+          "components": {}
+        },
+        "last_seen_at": "2026-07-08T20:49:12.335710Z",
+        "retirement_candidate": true,
+        "retirement_reason": "no measured usage in review window"
+      },
+      {
+        "interface": {
+          "id": "4aea9591-970b-4918-ac4a-4da95a0a1a8c",
+          "interface_key": "rest_api:POST /decisions/ workstream_id",
+          "interface_kind": "rest_api",
+          "legacy_since": "2026-07-09T22:56:35.473130Z",
+          "replacement_ref": "POST /decisions/ with workplan_id",
+          "owner_component": "state-hub.api",
+          "status": "legacy",
+          "replacement_verified": true,
+          "manual_hold": false,
+          "hold_reason": null,
+          "notes": null,
+          "retired_at": null,
+          "created_at": "2026-07-09T22:56:35.473130Z",
+          "updated_at": "2026-07-09T22:56:35.473130Z"
+        },
+        "all_time": {
+          "calls": 3,
+          "tenant_count": 1,
+          "user_count": 1,
+          "component_count": 1,
+          "tenants": {
+            "unknown": 3
+          },
+          "users": {
+            "unknown": 3
+          },
+          "components": {
+            "unknown": 3
+          }
+        },
+        "window": {
+          "calls": 0,
+          "tenant_count": 0,
+          "user_count": 0,
+          "component_count": 0,
+          "tenants": {},
+          "users": {},
+          "components": {}
+        },
+        "last_seen_at": "2026-07-09T22:57:05.912456Z",
+        "retirement_candidate": true,
+        "retirement_reason": "no measured usage in review window"
+      },
+      {
+        "interface": {
+          "id": "4a70583c-1e41-4ec1-99a9-728856a7d79c",
+          "interface_key": "rest_api:POST /progress/ workstream_id",
+          "interface_kind": "rest_api",
+          "legacy_since": "2026-07-08T23:35:09.148333Z",
+          "replacement_ref": "POST /progress/ with workplan_id",
+          "owner_component": "state-hub.api",
+          "status": "legacy",
+          "replacement_verified": true,
+          "manual_hold": false,
+          "hold_reason": null,
+          "notes": null,
+          "retired_at": null,
+          "created_at": "2026-07-08T23:35:09.148333Z",
+          "updated_at": "2026-07-08T23:35:09.148333Z"
+        },
+        "all_time": {
+          "calls": 14,
+          "tenant_count": 1,
+          "user_count": 1,
+          "component_count": 1,
+          "tenants": {
+            "unknown": 14
+          },
+          "users": {
+            "unknown": 14
+          },
+          "components": {
+            "unknown": 14
+          }
+        },
+        "window": {
+          "calls": 0,
+          "tenant_count": 0,
+          "user_count": 0,
+          "component_count": 0,
+          "tenants": {},
+          "users": {},
+          "components": {}
+        },
+        "last_seen_at": "2026-07-10T08:34:42.959724Z",
+        "retirement_candidate": true,
+        "retirement_reason": "no measured usage in review window"
+      },
+      {
+        "interface": {
+          "id": "6df4e443-7bf1-461a-923b-a6eb52fe7b07",
+          "interface_key": "rest_api:POST /tasks/ workstream_id",
+          "interface_kind": "rest_api",
+          "legacy_since": "2026-07-08T22:38:29.405720Z",
+          "replacement_ref": "POST /tasks/ with workplan_id",
+          "owner_component": "state-hub.api",
+          "status": "legacy",
+          "replacement_verified": true,
+          "manual_hold": false,
+          "hold_reason": null,
+          "notes": null,
+          "retired_at": null,
+          "created_at": "2026-07-08T22:38:29.405720Z",
+          "updated_at": "2026-07-08T22:38:29.405720Z"
+        },
+        "all_time": {
+          "calls": 5,
+          "tenant_count": 1,
+          "user_count": 1,
+          "component_count": 1,
+          "tenants": {
+            "unknown": 5
+          },
+          "users": {
+            "unknown": 5
+          },
+          "components": {
+            "state-hub.fix-consistency": 5
+          }
+        },
+        "window": {
+          "calls": 0,
+          "tenant_count": 0,
+          "user_count": 0,
+          "component_count": 0,
+          "tenants": {},
+          "users": {},
+          "components": {}
+        },
+        "last_seen_at": "2026-07-08T22:38:29.976918Z",
+        "retirement_candidate": true,
+        "retirement_reason": "no measured usage in review window"
+      },
+      {
+        "interface": {
+          "id": "ed6451c9-d2cc-4486-9afe-d3852782cabc",
+          "interface_key": "rest_api:POST /workstreams/",
+          "interface_kind": "rest_api",
+          "legacy_since": "2026-06-04T07:40:24.168535Z",
+          "replacement_ref": "/workplans/",
+          "owner_component": "state-hub.api",
+          "status": "legacy",
+          "replacement_verified": true,
+          "manual_hold": false,
+          "hold_reason": null,
+          "notes": null,
+          "retired_at": null,
+          "created_at": "2026-06-04T07:40:24.168535Z",
+          "updated_at": "2026-06-04T07:40:24.168535Z"
+        },
+        "all_time": {
+          "calls": 824,
+          "tenant_count": 1,
+          "user_count": 1,
+          "component_count": 1,
+          "tenants": {
+            "unknown": 824
+          },
+          "users": {
+            "unknown": 824
+          },
+          "components": {
+            "unknown": 824
+          }
+        },
+        "window": {
+          "calls": 0,
+          "tenant_count": 0,
+          "user_count": 0,
+          "component_count": 0,
+          "tenants": {},
+          "users": {},
+          "components": {}
+        },
+        "last_seen_at": "2026-07-08T20:38:05.903144Z",
+        "retirement_candidate": true,
+        "retirement_reason": "no measured usage in review window"
+      },
+      {
+        "interface": {
+          "id": "281fd706-b192-4194-8055-2d8733c115f9",
+          "interface_key": "rest_api:POST /workstreams/{workstream_id}/dependencies/",
+          "interface_kind": "rest_api",
+          "legacy_since": "2026-06-04T22:57:37.149207Z",
+          "replacement_ref": "/workplans/{workplan_id}/dependencies/",
+          "owner_component": "state-hub.api",
+          "status": "legacy",
+          "replacement_verified": true,
+          "manual_hold": false,
+          "hold_reason": null,
+          "notes": null,
+          "retired_at": null,
+          "created_at": "2026-06-04T22:57:37.149207Z",
+          "updated_at": "2026-06-04T22:57:37.149207Z"
+        },
+        "all_time": {
+          "calls": 4971,
+          "tenant_count": 1,
+          "user_count": 1,
+          "component_count": 1,
+          "tenants": {
+            "unknown": 4971
+          },
+          "users": {
+            "unknown": 4971
+          },
+          "components": {
+            "unknown": 4971
+          }
+        },
+        "window": {
+          "calls": 0,
+          "tenant_count": 0,
+          "user_count": 0,
+          "component_count": 0,
+          "tenants": {},
+          "users": {},
+          "components": {}
+        },
+        "last_seen_at": "2026-07-01T22:09:24.229011Z",
+        "retirement_candidate": true,
+        "retirement_reason": "no measured usage in review window"
+      }
+    ]
+  },
+  "hours": 8
+}
diff --git a/docs/evidence/legacy-meter-weekly-review-20260810.json b/docs/evidence/legacy-meter-weekly-review-20260810.json
new file mode 100644
index 0000000..e6cae93
--- /dev/null
+++ b/docs/evidence/legacy-meter-weekly-review-20260810.json
@@ -0,0 +1,1755 @@
+{
+  "captured_at": "2026-08-10T14:00:05.121326+00:00",
+  "api_base": "http://127.0.0.1:8000",
+  "workplan": "STATE-WP-0070",
+  "retired_interfaces": [],
+  "weekly_review": {
+    "generated_at": "2026-08-10T14:00:05.109339Z",
+    "window_start": "2026-08-10T06:00:04.970698Z",
+    "window_end": "2026-08-10T14:00:04.970698Z",
+    "cadence": "weekly",
+    "activity_core_handoff": {
+      "activity_id": "statehub-legacy-interface-review",
+      "cadence": "weekly",
+      "source_endpoint": "/legacy-meter/weekly-review",
+      "state_owner": "state-hub",
+      "scheduler_owner": "activity-core"
+    },
+    "interfaces": [
+      {
+        "interface": {
+          "id": "8051fb40-66c9-4dc4-a413-13e8573e04a3",
+          "interface_key": "event_subject:org.statehub.workstream.completed",
+          "interface_kind": "event_subject",
+          "legacy_since": "2026-06-04T06:09:42.198193Z",
+          "replacement_ref": "org.statehub.workplan.completed",
+          "owner_component": "state-hub.events",
+          "status": "retired",
+          "replacement_verified": true,
+          "manual_hold": false,
+          "hold_reason": null,
+          "notes": "Retired by STATE-WP-0069 closeout",
+          "retired_at": "2026-07-08T21:38:52.773601Z",
+          "created_at": "2026-06-04T06:09:42.198193Z",
+          "updated_at": "2026-07-08T21:38:52.761243Z"
+        },
+        "all_time": {
+          "calls": 255,
+          "tenant_count": 1,
+          "user_count": 1,
+          "component_count": 1,
+          "tenants": {
+            "unknown": 255
+          },
+          "users": {
+            "unknown": 255
+          },
+          "components": {
+            "state-hub.events": 255
+          }
+        },
+        "window": {
+          "calls": 0,
+          "tenant_count": 0,
+          "user_count": 0,
+          "component_count": 0,
+          "tenants": {},
+          "users": {},
+          "components": {}
+        },
+        "last_seen_at": "2026-07-08T20:49:12.839383Z",
+        "retirement_candidate": false,
+        "retirement_reason": "already retired"
+      },
+      {
+        "interface": {
+          "id": "63ed90e3-42b4-431a-94db-e1254a52f9e2",
+          "interface_key": "mcp:create_workstream",
+          "interface_kind": "mcp_tool",
+          "legacy_since": "2026-07-10T13:19:44.205900Z",
+          "replacement_ref": "create_workplan",
+          "owner_component": "state-hub.mcp",
+          "status": "legacy",
+          "replacement_verified": true,
+          "manual_hold": false,
+          "hold_reason": null,
+          "notes": "Registered by STATE-WP-0070 T03 \u2014 zero-window streak starts at registration",
+          "retired_at": null,
+          "created_at": "2026-07-10T13:19:44.205900Z",
+          "updated_at": "2026-07-10T13:19:44.205900Z"
+        },
+        "all_time": {
+          "calls": 2,
+          "tenant_count": 1,
+          "user_count": 1,
+          "component_count": 1,
+          "tenants": {
+            "unknown": 2
+          },
+          "users": {
+            "unknown": 2
+          },
+          "components": {
+            "state-hub.mcp": 2
+          }
+        },
+        "window": {
+          "calls": 0,
+          "tenant_count": 0,
+          "user_count": 0,
+          "component_count": 0,
+          "tenants": {},
+          "users": {},
+          "components": {}
+        },
+        "last_seen_at": "2026-07-10T13:20:43.378546Z",
+        "retirement_candidate": true,
+        "retirement_reason": "no measured usage in review window"
+      },
+      {
+        "interface": {
+          "id": "b6a5fe44-fb85-4ef7-a273-78d09da777af",
+          "interface_key": "mcp:list_workstreams",
+          "interface_kind": "mcp_tool",
+          "legacy_since": "2026-07-10T13:19:26.075491Z",
+          "replacement_ref": "list_workplans",
+          "owner_component": "state-hub.mcp",
+          "status": "legacy",
+          "replacement_verified": true,
+          "manual_hold": false,
+          "hold_reason": null,
+          "notes": null,
+          "retired_at": null,
+          "created_at": "2026-07-10T13:19:26.075491Z",
+          "updated_at": "2026-07-10T13:19:26.075491Z"
+        },
+        "all_time": {
+          "calls": 2,
+          "tenant_count": 1,
+          "user_count": 1,
+          "component_count": 1,
+          "tenants": {
+            "unknown": 2
+          },
+          "users": {
+            "unknown": 2
+          },
+          "components": {
+            "state-hub.mcp": 2
+          }
+        },
+        "window": {
+          "calls": 0,
+          "tenant_count": 0,
+          "user_count": 0,
+          "component_count": 0,
+          "tenants": {},
+          "users": {},
+          "components": {}
+        },
+        "last_seen_at": "2026-07-10T13:20:42.374940Z",
+        "retirement_candidate": true,
+        "retirement_reason": "no measured usage in review window"
+      },
+      {
+        "interface": {
+          "id": "53c3372b-307d-4d6a-8ea4-bc36cacdcaf2",
+          "interface_key": "mcp:update_workstream",
+          "interface_kind": "mcp_tool",
+          "legacy_since": "2026-07-10T13:19:44.255216Z",
+          "replacement_ref": "update_workplan",
+          "owner_component": "state-hub.mcp",
+          "status": "legacy",
+          "replacement_verified": true,
+          "manual_hold": false,
+          "hold_reason": null,
+          "notes": "Registered by STATE-WP-0070 T03 \u2014 zero-window streak starts at registration",
+          "retired_at": null,
+          "created_at": "2026-07-10T13:19:44.255216Z",
+          "updated_at": "2026-07-10T13:19:44.255216Z"
+        },
+        "all_time": {
+          "calls": 0,
+          "tenant_count": 0,
+          "user_count": 0,
+          "component_count": 0,
+          "tenants": {},
+          "users": {},
+          "components": {}
+        },
+        "window": {
+          "calls": 0,
+          "tenant_count": 0,
+          "user_count": 0,
+          "component_count": 0,
+          "tenants": {},
+          "users": {},
+          "components": {}
+        },
+        "last_seen_at": null,
+        "retirement_candidate": true,
+        "retirement_reason": "no measured usage in review window"
+      },
+      {
+        "interface": {
+          "id": "bed4d08a-3471-48f5-9f0e-f9d550383a26",
+          "interface_key": "mcp:update_workstream_status",
+          "interface_kind": "mcp_tool",
+          "legacy_since": "2026-07-10T13:19:44.303612Z",
+          "replacement_ref": "update_workplan_status",
+          "owner_component": "state-hub.mcp",
+          "status": "legacy",
+          "replacement_verified": true,
+          "manual_hold": false,
+          "hold_reason": null,
+          "notes": "Registered by STATE-WP-0070 T03 \u2014 zero-window streak starts at registration",
+          "retired_at": null,
+          "created_at": "2026-07-10T13:19:44.303612Z",
+          "updated_at": "2026-07-10T13:19:44.303612Z"
+        },
+        "all_time": {
+          "calls": 0,
+          "tenant_count": 0,
+          "user_count": 0,
+          "component_count": 0,
+          "tenants": {},
+          "users": {},
+          "components": {}
+        },
+        "window": {
+          "calls": 0,
+          "tenant_count": 0,
+          "user_count": 0,
+          "component_count": 0,
+          "tenants": {},
+          "users": {},
+          "components": {}
+        },
+        "last_seen_at": null,
+        "retirement_candidate": true,
+        "retirement_reason": "no measured usage in review window"
+      },
+      {
+        "interface": {
+          "id": "46900dc2-0893-405b-ba59-80f31fb6ebb1",
+          "interface_key": "state://workstreams/{topic_slug}",
+          "interface_kind": "mcp_tool",
+          "legacy_since": "2026-07-10T13:19:44.344493Z",
+          "replacement_ref": "state://workplans/{topic_slug}",
+          "owner_component": "state-hub.mcp",
+          "status": "legacy",
+          "replacement_verified": true,
+          "manual_hold": false,
+          "hold_reason": null,
+          "notes": "Registered by STATE-WP-0070 T03 \u2014 zero-window streak starts at registration",
+          "retired_at": null,
+          "created_at": "2026-07-10T13:19:44.344493Z",
+          "updated_at": "2026-07-10T13:19:44.344493Z"
+        },
+        "all_time": {
+          "calls": 1,
+          "tenant_count": 1,
+          "user_count": 1,
+          "component_count": 1,
+          "tenants": {
+            "unknown": 1
+          },
+          "users": {
+            "unknown": 1
+          },
+          "components": {
+            "state-hub.mcp": 1
+          }
+        },
+        "window": {
+          "calls": 0,
+          "tenant_count": 0,
+          "user_count": 0,
+          "component_count": 0,
+          "tenants": {},
+          "users": {},
+          "components": {}
+        },
+        "last_seen_at": "2026-07-10T13:20:34.491811Z",
+        "retirement_candidate": true,
+        "retirement_reason": "no measured usage in review window"
+      },
+      {
+        "interface": {
+          "id": "cd9342fd-27e7-4a46-a1be-d41499e106a3",
+          "interface_key": "rest_api:DELETE /workstreams/{workstream_id}",
+          "interface_kind": "rest_api",
+          "legacy_since": "2026-06-06T17:28:13.052813Z",
+          "replacement_ref": "/workplans/{workplan_id}",
+          "owner_component": "state-hub.api",
+          "status": "legacy",
+          "replacement_verified": true,
+          "manual_hold": false,
+          "hold_reason": null,
+          "notes": null,
+          "retired_at": null,
+          "created_at": "2026-06-06T17:28:13.052813Z",
+          "updated_at": "2026-06-06T17:28:13.052813Z"
+        },
+        "all_time": {
+          "calls": 1,
+          "tenant_count": 1,
+          "user_count": 1,
+          "component_count": 1,
+          "tenants": {
+            "unknown": 1
+          },
+          "users": {
+            "unknown": 1
+          },
+          "components": {
+            "unknown": 1
+          }
+        },
+        "window": {
+          "calls": 0,
+          "tenant_count": 0,
+          "user_count": 0,
+          "component_count": 0,
+          "tenants": {},
+          "users": {},
+          "components": {}
+        },
+        "last_seen_at": "2026-06-06T17:28:13.047529Z",
+        "retirement_candidate": true,
+        "retirement_reason": "no measured usage in review window"
+      },
+      {
+        "interface": {
+          "id": "a4e0948c-cd4a-461e-8ae2-7fd7b51d04a7",
+          "interface_key": "rest_api:GET /decisions/?workstream_id",
+          "interface_kind": "rest_api",
+          "legacy_since": "2026-07-09T23:07:53.093223Z",
+          "replacement_ref": "/decisions/?workplan_id=<workplan_id>",
+          "owner_component": "state-hub.api",
+          "status": "legacy",
+          "replacement_verified": true,
+          "manual_hold": false,
+          "hold_reason": null,
+          "notes": null,
+          "retired_at": null,
+          "created_at": "2026-07-09T23:07:53.093223Z",
+          "updated_at": "2026-07-09T23:07:53.093223Z"
+        },
+        "all_time": {
+          "calls": 1,
+          "tenant_count": 1,
+          "user_count": 1,
+          "component_count": 1,
+          "tenants": {
+            "unknown": 1
+          },
+          "users": {
+            "unknown": 1
+          },
+          "components": {
+            "unknown": 1
+          }
+        },
+        "window": {
+          "calls": 0,
+          "tenant_count": 0,
+          "user_count": 0,
+          "component_count": 0,
+          "tenants": {},
+          "users": {},
+          "components": {}
+        },
+        "last_seen_at": "2026-07-09T23:07:53.083299Z",
+        "retirement_candidate": true,
+        "retirement_reason": "no measured usage in review window"
+      },
+      {
+        "interface": {
+          "id": "70a9346e-e0ee-42ac-874f-f160580b54dd",
+          "interface_key": "rest_api:GET /progress/?workstream_id",
+          "interface_kind": "rest_api",
+          "legacy_since": "2026-07-13T22:04:03.911449Z",
+          "replacement_ref": "/progress/?workplan_id=<workplan_id>",
+          "owner_component": "state-hub.api",
+          "status": "legacy",
+          "replacement_verified": true,
+          "manual_hold": false,
+          "hold_reason": null,
+          "notes": null,
+          "retired_at": null,
+          "created_at": "2026-07-13T22:04:03.911449Z",
+          "updated_at": "2026-07-13T22:04:03.911449Z"
+        },
+        "all_time": {
+          "calls": 1,
+          "tenant_count": 1,
+          "user_count": 1,
+          "component_count": 1,
+          "tenants": {
+            "unknown": 1
+          },
+          "users": {
+            "unknown": 1
+          },
+          "components": {
+            "unknown": 1
+          }
+        },
+        "window": {
+          "calls": 0,
+          "tenant_count": 0,
+          "user_count": 0,
+          "component_count": 0,
+          "tenants": {},
+          "users": {},
+          "components": {}
+        },
+        "last_seen_at": "2026-07-13T22:04:03.904998Z",
+        "retirement_candidate": true,
+        "retirement_reason": "no measured usage in review window"
+      },
+      {
+        "interface": {
+          "id": "be3cdcf8-250b-4bf0-801f-02ffd5f57e00",
+          "interface_key": "rest_api:GET /tasks/?workstream_id",
+          "interface_kind": "rest_api",
+          "legacy_since": "2026-07-08T19:32:21.628513Z",
+          "replacement_ref": "/tasks/?workplan_id=<workplan_id>",
+          "owner_component": "state-hub.api",
+          "status": "legacy",
+          "replacement_verified": true,
+          "manual_hold": false,
+          "hold_reason": null,
+          "notes": null,
+          "retired_at": null,
+          "created_at": "2026-07-08T19:32:21.628513Z",
+          "updated_at": "2026-07-08T19:32:21.628513Z"
+        },
+        "all_time": {
+          "calls": 589,
+          "tenant_count": 1,
+          "user_count": 1,
+          "component_count": 1,
+          "tenants": {
+            "unknown": 589
+          },
+          "users": {
+            "unknown": 589
+          },
+          "components": {
+            "unknown": 589
+          }
+        },
+        "window": {
+          "calls": 0,
+          "tenant_count": 0,
+          "user_count": 0,
+          "component_count": 0,
+          "tenants": {},
+          "users": {},
+          "components": {}
+        },
+        "last_seen_at": "2026-07-31T16:25:32.181901Z",
+        "retirement_candidate": true,
+        "retirement_reason": "no measured usage in review window"
+      },
+      {
+        "interface": {
+          "id": "3e4a3d0b-08fa-45c3-91e2-4f514a914b97",
+          "interface_key": "rest_api:GET /workstreams/",
+          "interface_kind": "rest_api",
+          "legacy_since": "2026-06-04T00:26:14.533764Z",
+          "replacement_ref": "/workplans/",
+          "owner_component": "state-hub.api",
+          "status": "legacy",
+          "replacement_verified": true,
+          "manual_hold": false,
+          "hold_reason": null,
+          "notes": null,
+          "retired_at": null,
+          "created_at": "2026-06-04T00:26:14.533764Z",
+          "updated_at": "2026-06-04T00:26:14.533764Z"
+        },
+        "all_time": {
+          "calls": 144085,
+          "tenant_count": 1,
+          "user_count": 1,
+          "component_count": 1,
+          "tenants": {
+            "unknown": 144085
+          },
+          "users": {
+            "unknown": 144085
+          },
+          "components": {
+            "unknown": 144085
+          }
+        },
+        "window": {
+          "calls": 0,
+          "tenant_count": 0,
+          "user_count": 0,
+          "component_count": 0,
+          "tenants": {},
+          "users": {},
+          "components": {}
+        },
+        "last_seen_at": "2026-08-05T13:01:38.000781Z",
+        "retirement_candidate": true,
+        "retirement_reason": "no measured usage in review window"
+      },
+      {
+        "interface": {
+          "id": "e4c140ec-7479-46f9-b185-4b533f19d639",
+          "interface_key": "rest_api:GET /workstreams/workplan-index",
+          "interface_kind": "rest_api",
+          "legacy_since": "2026-06-04T05:20:58.321869Z",
+          "replacement_ref": "/workplans/index",
+          "owner_component": "state-hub.api",
+          "status": "legacy",
+          "replacement_verified": true,
+          "manual_hold": false,
+          "hold_reason": null,
+          "notes": null,
+          "retired_at": null,
+          "created_at": "2026-06-04T05:20:58.321869Z",
+          "updated_at": "2026-06-04T05:20:58.321869Z"
+        },
+        "all_time": {
+          "calls": 30,
+          "tenant_count": 1,
+          "user_count": 1,
+          "component_count": 1,
+          "tenants": {
+            "unknown": 30
+          },
+          "users": {
+            "unknown": 30
+          },
+          "components": {
+            "unknown": 30
+          }
+        },
+        "window": {
+          "calls": 0,
+          "tenant_count": 0,
+          "user_count": 0,
+          "component_count": 0,
+          "tenants": {},
+          "users": {},
+          "components": {}
+        },
+        "last_seen_at": "2026-07-03T05:20:34.534439Z",
+        "retirement_candidate": true,
+        "retirement_reason": "no measured usage in review window"
+      },
+      {
+        "interface": {
+          "id": "3a00b19e-e7db-4403-98aa-a77c9ab61ecc",
+          "interface_key": "rest_api:GET /workstreams/{workstream_id}",
+          "interface_kind": "rest_api",
+          "legacy_since": "2026-06-04T00:25:59.014966Z",
+          "replacement_ref": "/workplans/{workplan_id}",
+          "owner_component": "state-hub.api",
+          "status": "legacy",
+          "replacement_verified": true,
+          "manual_hold": false,
+          "hold_reason": null,
+          "notes": null,
+          "retired_at": null,
+          "created_at": "2026-06-04T00:25:59.014966Z",
+          "updated_at": "2026-06-04T00:25:59.014966Z"
+        },
+        "all_time": {
+          "calls": 511406,
+          "tenant_count": 1,
+          "user_count": 1,
+          "component_count": 1,
+          "tenants": {
+            "unknown": 511406
+          },
+          "users": {
+            "unknown": 511406
+          },
+          "components": {
+            "unknown": 511406
+          }
+        },
+        "window": {
+          "calls": 0,
+          "tenant_count": 0,
+          "user_count": 0,
+          "component_count": 0,
+          "tenants": {},
+          "users": {},
+          "components": {}
+        },
+        "last_seen_at": "2026-07-31T16:25:32.004042Z",
+        "retirement_candidate": true,
+        "retirement_reason": "no measured usage in review window"
+      },
+      {
+        "interface": {
+          "id": "69e1a255-a8b9-4101-8a68-b1bed23abfda",
+          "interface_key": "rest_api:GET /workstreams/{workstream_id}/dependencies/",
+          "interface_kind": "rest_api",
+          "legacy_since": "2026-06-04T00:25:59.291135Z",
+          "replacement_ref": "/workplans/{workplan_id}/dependencies/",
+          "owner_component": "state-hub.api",
+          "status": "legacy",
+          "replacement_verified": true,
+          "manual_hold": false,
+          "hold_reason": null,
+          "notes": null,
+          "retired_at": null,
+          "created_at": "2026-06-04T00:25:59.291135Z",
+          "updated_at": "2026-06-04T00:25:59.291135Z"
+        },
+        "all_time": {
+          "calls": 255865,
+          "tenant_count": 1,
+          "user_count": 1,
+          "component_count": 1,
+          "tenants": {
+            "unknown": 255865
+          },
+          "users": {
+            "unknown": 255865
+          },
+          "components": {
+            "unknown": 255865
+          }
+        },
+        "window": {
+          "calls": 0,
+          "tenant_count": 0,
+          "user_count": 0,
+          "component_count": 0,
+          "tenants": {},
+          "users": {},
+          "components": {}
+        },
+        "last_seen_at": "2026-07-08T21:14:12.747005Z",
+        "retirement_candidate": true,
+        "retirement_reason": "no measured usage in review window"
+      },
+      {
+        "interface": {
+          "id": "b1aae931-b51f-4a85-a723-865dd65f6132",
+          "interface_key": "rest_api:PATCH /workstreams/{workstream_id}",
+          "interface_kind": "rest_api",
+          "legacy_since": "2026-06-04T06:09:41.901035Z",
+          "replacement_ref": "/workplans/{workplan_id}",
+          "owner_component": "state-hub.api",
+          "status": "legacy",
+          "replacement_verified": true,
+          "manual_hold": false,
+          "hold_reason": null,
+          "notes": null,
+          "retired_at": null,
+          "created_at": "2026-06-04T06:09:41.901035Z",
+          "updated_at": "2026-06-04T06:09:41.901035Z"
+        },
+        "all_time": {
+          "calls": 571,
+          "tenant_count": 1,
+          "user_count": 1,
+          "component_count": 1,
+          "tenants": {
+            "unknown": 571
+          },
+          "users": {
+            "unknown": 571
+          },
+          "components": {
+            "unknown": 571
+          }
+        },
+        "window": {
+          "calls": 0,
+          "tenant_count": 0,
+          "user_count": 0,
+          "component_count": 0,
+          "tenants": {},
+          "users": {},
+          "components": {}
+        },
+        "last_seen_at": "2026-07-08T20:49:12.335710Z",
+        "retirement_candidate": true,
+        "retirement_reason": "no measured usage in review window"
+      },
+      {
+        "interface": {
+          "id": "4aea9591-970b-4918-ac4a-4da95a0a1a8c",
+          "interface_key": "rest_api:POST /decisions/ workstream_id",
+          "interface_kind": "rest_api",
+          "legacy_since": "2026-07-09T22:56:35.473130Z",
+          "replacement_ref": "POST /decisions/ with workplan_id",
+          "owner_component": "state-hub.api",
+          "status": "legacy",
+          "replacement_verified": true,
+          "manual_hold": false,
+          "hold_reason": null,
+          "notes": null,
+          "retired_at": null,
+          "created_at": "2026-07-09T22:56:35.473130Z",
+          "updated_at": "2026-07-09T22:56:35.473130Z"
+        },
+        "all_time": {
+          "calls": 3,
+          "tenant_count": 1,
+          "user_count": 1,
+          "component_count": 1,
+          "tenants": {
+            "unknown": 3
+          },
+          "users": {
+            "unknown": 3
+          },
+          "components": {
+            "unknown": 3
+          }
+        },
+        "window": {
+          "calls": 0,
+          "tenant_count": 0,
+          "user_count": 0,
+          "component_count": 0,
+          "tenants": {},
+          "users": {},
+          "components": {}
+        },
+        "last_seen_at": "2026-07-09T22:57:05.912456Z",
+        "retirement_candidate": true,
+        "retirement_reason": "no measured usage in review window"
+      },
+      {
+        "interface": {
+          "id": "4a70583c-1e41-4ec1-99a9-728856a7d79c",
+          "interface_key": "rest_api:POST /progress/ workstream_id",
+          "interface_kind": "rest_api",
+          "legacy_since": "2026-07-08T23:35:09.148333Z",
+          "replacement_ref": "POST /progress/ with workplan_id",
+          "owner_component": "state-hub.api",
+          "status": "legacy",
+          "replacement_verified": true,
+          "manual_hold": false,
+          "hold_reason": null,
+          "notes": null,
+          "retired_at": null,
+          "created_at": "2026-07-08T23:35:09.148333Z",
+          "updated_at": "2026-07-08T23:35:09.148333Z"
+        },
+        "all_time": {
+          "calls": 14,
+          "tenant_count": 1,
+          "user_count": 1,
+          "component_count": 1,
+          "tenants": {
+            "unknown": 14
+          },
+          "users": {
+            "unknown": 14
+          },
+          "components": {
+            "unknown": 14
+          }
+        },
+        "window": {
+          "calls": 0,
+          "tenant_count": 0,
+          "user_count": 0,
+          "component_count": 0,
+          "tenants": {},
+          "users": {},
+          "components": {}
+        },
+        "last_seen_at": "2026-07-10T08:34:42.959724Z",
+        "retirement_candidate": true,
+        "retirement_reason": "no measured usage in review window"
+      },
+      {
+        "interface": {
+          "id": "6df4e443-7bf1-461a-923b-a6eb52fe7b07",
+          "interface_key": "rest_api:POST /tasks/ workstream_id",
+          "interface_kind": "rest_api",
+          "legacy_since": "2026-07-08T22:38:29.405720Z",
+          "replacement_ref": "POST /tasks/ with workplan_id",
+          "owner_component": "state-hub.api",
+          "status": "legacy",
+          "replacement_verified": true,
+          "manual_hold": false,
+          "hold_reason": null,
+          "notes": null,
+          "retired_at": null,
+          "created_at": "2026-07-08T22:38:29.405720Z",
+          "updated_at": "2026-07-08T22:38:29.405720Z"
+        },
+        "all_time": {
+          "calls": 5,
+          "tenant_count": 1,
+          "user_count": 1,
+          "component_count": 1,
+          "tenants": {
+            "unknown": 5
+          },
+          "users": {
+            "unknown": 5
+          },
+          "components": {
+            "state-hub.fix-consistency": 5
+          }
+        },
+        "window": {
+          "calls": 0,
+          "tenant_count": 0,
+          "user_count": 0,
+          "component_count": 0,
+          "tenants": {},
+          "users": {},
+          "components": {}
+        },
+        "last_seen_at": "2026-07-08T22:38:29.976918Z",
+        "retirement_candidate": true,
+        "retirement_reason": "no measured usage in review window"
+      },
+      {
+        "interface": {
+          "id": "ed6451c9-d2cc-4486-9afe-d3852782cabc",
+          "interface_key": "rest_api:POST /workstreams/",
+          "interface_kind": "rest_api",
+          "legacy_since": "2026-06-04T07:40:24.168535Z",
+          "replacement_ref": "/workplans/",
+          "owner_component": "state-hub.api",
+          "status": "legacy",
+          "replacement_verified": true,
+          "manual_hold": false,
+          "hold_reason": null,
+          "notes": null,
+          "retired_at": null,
+          "created_at": "2026-06-04T07:40:24.168535Z",
+          "updated_at": "2026-06-04T07:40:24.168535Z"
+        },
+        "all_time": {
+          "calls": 824,
+          "tenant_count": 1,
+          "user_count": 1,
+          "component_count": 1,
+          "tenants": {
+            "unknown": 824
+          },
+          "users": {
+            "unknown": 824
+          },
+          "components": {
+            "unknown": 824
+          }
+        },
+        "window": {
+          "calls": 0,
+          "tenant_count": 0,
+          "user_count": 0,
+          "component_count": 0,
+          "tenants": {},
+          "users": {},
+          "components": {}
+        },
+        "last_seen_at": "2026-07-08T20:38:05.903144Z",
+        "retirement_candidate": true,
+        "retirement_reason": "no measured usage in review window"
+      },
+      {
+        "interface": {
+          "id": "281fd706-b192-4194-8055-2d8733c115f9",
+          "interface_key": "rest_api:POST /workstreams/{workstream_id}/dependencies/",
+          "interface_kind": "rest_api",
+          "legacy_since": "2026-06-04T22:57:37.149207Z",
+          "replacement_ref": "/workplans/{workplan_id}/dependencies/",
+          "owner_component": "state-hub.api",
+          "status": "legacy",
+          "replacement_verified": true,
+          "manual_hold": false,
+          "hold_reason": null,
+          "notes": null,
+          "retired_at": null,
+          "created_at": "2026-06-04T22:57:37.149207Z",
+          "updated_at": "2026-06-04T22:57:37.149207Z"
+        },
+        "all_time": {
+          "calls": 4971,
+          "tenant_count": 1,
+          "user_count": 1,
+          "component_count": 1,
+          "tenants": {
+            "unknown": 4971
+          },
+          "users": {
+            "unknown": 4971
+          },
+          "components": {
+            "unknown": 4971
+          }
+        },
+        "window": {
+          "calls": 0,
+          "tenant_count": 0,
+          "user_count": 0,
+          "component_count": 0,
+          "tenants": {},
+          "users": {},
+          "components": {}
+        },
+        "last_seen_at": "2026-07-01T22:09:24.229011Z",
+        "retirement_candidate": true,
+        "retirement_reason": "no measured usage in review window"
+      }
+    ],
+    "retirement_candidates": [
+      {
+        "interface": {
+          "id": "63ed90e3-42b4-431a-94db-e1254a52f9e2",
+          "interface_key": "mcp:create_workstream",
+          "interface_kind": "mcp_tool",
+          "legacy_since": "2026-07-10T13:19:44.205900Z",
+          "replacement_ref": "create_workplan",
+          "owner_component": "state-hub.mcp",
+          "status": "legacy",
+          "replacement_verified": true,
+          "manual_hold": false,
+          "hold_reason": null,
+          "notes": "Registered by STATE-WP-0070 T03 \u2014 zero-window streak starts at registration",
+          "retired_at": null,
+          "created_at": "2026-07-10T13:19:44.205900Z",
+          "updated_at": "2026-07-10T13:19:44.205900Z"
+        },
+        "all_time": {
+          "calls": 2,
+          "tenant_count": 1,
+          "user_count": 1,
+          "component_count": 1,
+          "tenants": {
+            "unknown": 2
+          },
+          "users": {
+            "unknown": 2
+          },
+          "components": {
+            "state-hub.mcp": 2
+          }
+        },
+        "window": {
+          "calls": 0,
+          "tenant_count": 0,
+          "user_count": 0,
+          "component_count": 0,
+          "tenants": {},
+          "users": {},
+          "components": {}
+        },
+        "last_seen_at": "2026-07-10T13:20:43.378546Z",
+        "retirement_candidate": true,
+        "retirement_reason": "no measured usage in review window"
+      },
+      {
+        "interface": {
+          "id": "b6a5fe44-fb85-4ef7-a273-78d09da777af",
+          "interface_key": "mcp:list_workstreams",
+          "interface_kind": "mcp_tool",
+          "legacy_since": "2026-07-10T13:19:26.075491Z",
+          "replacement_ref": "list_workplans",
+          "owner_component": "state-hub.mcp",
+          "status": "legacy",
+          "replacement_verified": true,
+          "manual_hold": false,
+          "hold_reason": null,
+          "notes": null,
+          "retired_at": null,
+          "created_at": "2026-07-10T13:19:26.075491Z",
+          "updated_at": "2026-07-10T13:19:26.075491Z"
+        },
+        "all_time": {
+          "calls": 2,
+          "tenant_count": 1,
+          "user_count": 1,
+          "component_count": 1,
+          "tenants": {
+            "unknown": 2
+          },
+          "users": {
+            "unknown": 2
+          },
+          "components": {
+            "state-hub.mcp": 2
+          }
+        },
+        "window": {
+          "calls": 0,
+          "tenant_count": 0,
+          "user_count": 0,
+          "component_count": 0,
+          "tenants": {},
+          "users": {},
+          "components": {}
+        },
+        "last_seen_at": "2026-07-10T13:20:42.374940Z",
+        "retirement_candidate": true,
+        "retirement_reason": "no measured usage in review window"
+      },
+      {
+        "interface": {
+          "id": "53c3372b-307d-4d6a-8ea4-bc36cacdcaf2",
+          "interface_key": "mcp:update_workstream",
+          "interface_kind": "mcp_tool",
+          "legacy_since": "2026-07-10T13:19:44.255216Z",
+          "replacement_ref": "update_workplan",
+          "owner_component": "state-hub.mcp",
+          "status": "legacy",
+          "replacement_verified": true,
+          "manual_hold": false,
+          "hold_reason": null,
+          "notes": "Registered by STATE-WP-0070 T03 \u2014 zero-window streak starts at registration",
+          "retired_at": null,
+          "created_at": "2026-07-10T13:19:44.255216Z",
+          "updated_at": "2026-07-10T13:19:44.255216Z"
+        },
+        "all_time": {
+          "calls": 0,
+          "tenant_count": 0,
+          "user_count": 0,
+          "component_count": 0,
+          "tenants": {},
+          "users": {},
+          "components": {}
+        },
+        "window": {
+          "calls": 0,
+          "tenant_count": 0,
+          "user_count": 0,
+          "component_count": 0,
+          "tenants": {},
+          "users": {},
+          "components": {}
+        },
+        "last_seen_at": null,
+        "retirement_candidate": true,
+        "retirement_reason": "no measured usage in review window"
+      },
+      {
+        "interface": {
+          "id": "bed4d08a-3471-48f5-9f0e-f9d550383a26",
+          "interface_key": "mcp:update_workstream_status",
+          "interface_kind": "mcp_tool",
+          "legacy_since": "2026-07-10T13:19:44.303612Z",
+          "replacement_ref": "update_workplan_status",
+          "owner_component": "state-hub.mcp",
+          "status": "legacy",
+          "replacement_verified": true,
+          "manual_hold": false,
+          "hold_reason": null,
+          "notes": "Registered by STATE-WP-0070 T03 \u2014 zero-window streak starts at registration",
+          "retired_at": null,
+          "created_at": "2026-07-10T13:19:44.303612Z",
+          "updated_at": "2026-07-10T13:19:44.303612Z"
+        },
+        "all_time": {
+          "calls": 0,
+          "tenant_count": 0,
+          "user_count": 0,
+          "component_count": 0,
+          "tenants": {},
+          "users": {},
+          "components": {}
+        },
+        "window": {
+          "calls": 0,
+          "tenant_count": 0,
+          "user_count": 0,
+          "component_count": 0,
+          "tenants": {},
+          "users": {},
+          "components": {}
+        },
+        "last_seen_at": null,
+        "retirement_candidate": true,
+        "retirement_reason": "no measured usage in review window"
+      },
+      {
+        "interface": {
+          "id": "46900dc2-0893-405b-ba59-80f31fb6ebb1",
+          "interface_key": "state://workstreams/{topic_slug}",
+          "interface_kind": "mcp_tool",
+          "legacy_since": "2026-07-10T13:19:44.344493Z",
+          "replacement_ref": "state://workplans/{topic_slug}",
+          "owner_component": "state-hub.mcp",
+          "status": "legacy",
+          "replacement_verified": true,
+          "manual_hold": false,
+          "hold_reason": null,
+          "notes": "Registered by STATE-WP-0070 T03 \u2014 zero-window streak starts at registration",
+          "retired_at": null,
+          "created_at": "2026-07-10T13:19:44.344493Z",
+          "updated_at": "2026-07-10T13:19:44.344493Z"
+        },
+        "all_time": {
+          "calls": 1,
+          "tenant_count": 1,
+          "user_count": 1,
+          "component_count": 1,
+          "tenants": {
+            "unknown": 1
+          },
+          "users": {
+            "unknown": 1
+          },
+          "components": {
+            "state-hub.mcp": 1
+          }
+        },
+        "window": {
+          "calls": 0,
+          "tenant_count": 0,
+          "user_count": 0,
+          "component_count": 0,
+          "tenants": {},
+          "users": {},
+          "components": {}
+        },
+        "last_seen_at": "2026-07-10T13:20:34.491811Z",
+        "retirement_candidate": true,
+        "retirement_reason": "no measured usage in review window"
+      },
+      {
+        "interface": {
+          "id": "cd9342fd-27e7-4a46-a1be-d41499e106a3",
+          "interface_key": "rest_api:DELETE /workstreams/{workstream_id}",
+          "interface_kind": "rest_api",
+          "legacy_since": "2026-06-06T17:28:13.052813Z",
+          "replacement_ref": "/workplans/{workplan_id}",
+          "owner_component": "state-hub.api",
+          "status": "legacy",
+          "replacement_verified": true,
+          "manual_hold": false,
+          "hold_reason": null,
+          "notes": null,
+          "retired_at": null,
+          "created_at": "2026-06-06T17:28:13.052813Z",
+          "updated_at": "2026-06-06T17:28:13.052813Z"
+        },
+        "all_time": {
+          "calls": 1,
+          "tenant_count": 1,
+          "user_count": 1,
+          "component_count": 1,
+          "tenants": {
+            "unknown": 1
+          },
+          "users": {
+            "unknown": 1
+          },
+          "components": {
+            "unknown": 1
+          }
+        },
+        "window": {
+          "calls": 0,
+          "tenant_count": 0,
+          "user_count": 0,
+          "component_count": 0,
+          "tenants": {},
+          "users": {},
+          "components": {}
+        },
+        "last_seen_at": "2026-06-06T17:28:13.047529Z",
+        "retirement_candidate": true,
+        "retirement_reason": "no measured usage in review window"
+      },
+      {
+        "interface": {
+          "id": "a4e0948c-cd4a-461e-8ae2-7fd7b51d04a7",
+          "interface_key": "rest_api:GET /decisions/?workstream_id",
+          "interface_kind": "rest_api",
+          "legacy_since": "2026-07-09T23:07:53.093223Z",
+          "replacement_ref": "/decisions/?workplan_id=<workplan_id>",
+          "owner_component": "state-hub.api",
+          "status": "legacy",
+          "replacement_verified": true,
+          "manual_hold": false,
+          "hold_reason": null,
+          "notes": null,
+          "retired_at": null,
+          "created_at": "2026-07-09T23:07:53.093223Z",
+          "updated_at": "2026-07-09T23:07:53.093223Z"
+        },
+        "all_time": {
+          "calls": 1,
+          "tenant_count": 1,
+          "user_count": 1,
+          "component_count": 1,
+          "tenants": {
+            "unknown": 1
+          },
+          "users": {
+            "unknown": 1
+          },
+          "components": {
+            "unknown": 1
+          }
+        },
+        "window": {
+          "calls": 0,
+          "tenant_count": 0,
+          "user_count": 0,
+          "component_count": 0,
+          "tenants": {},
+          "users": {},
+          "components": {}
+        },
+        "last_seen_at": "2026-07-09T23:07:53.083299Z",
+        "retirement_candidate": true,
+        "retirement_reason": "no measured usage in review window"
+      },
+      {
+        "interface": {
+          "id": "70a9346e-e0ee-42ac-874f-f160580b54dd",
+          "interface_key": "rest_api:GET /progress/?workstream_id",
+          "interface_kind": "rest_api",
+          "legacy_since": "2026-07-13T22:04:03.911449Z",
+          "replacement_ref": "/progress/?workplan_id=<workplan_id>",
+          "owner_component": "state-hub.api",
+          "status": "legacy",
+          "replacement_verified": true,
+          "manual_hold": false,
+          "hold_reason": null,
+          "notes": null,
+          "retired_at": null,
+          "created_at": "2026-07-13T22:04:03.911449Z",
+          "updated_at": "2026-07-13T22:04:03.911449Z"
+        },
+        "all_time": {
+          "calls": 1,
+          "tenant_count": 1,
+          "user_count": 1,
+          "component_count": 1,
+          "tenants": {
+            "unknown": 1
+          },
+          "users": {
+            "unknown": 1
+          },
+          "components": {
+            "unknown": 1
+          }
+        },
+        "window": {
+          "calls": 0,
+          "tenant_count": 0,
+          "user_count": 0,
+          "component_count": 0,
+          "tenants": {},
+          "users": {},
+          "components": {}
+        },
+        "last_seen_at": "2026-07-13T22:04:03.904998Z",
+        "retirement_candidate": true,
+        "retirement_reason": "no measured usage in review window"
+      },
+      {
+        "interface": {
+          "id": "be3cdcf8-250b-4bf0-801f-02ffd5f57e00",
+          "interface_key": "rest_api:GET /tasks/?workstream_id",
+          "interface_kind": "rest_api",
+          "legacy_since": "2026-07-08T19:32:21.628513Z",
+          "replacement_ref": "/tasks/?workplan_id=<workplan_id>",
+          "owner_component": "state-hub.api",
+          "status": "legacy",
+          "replacement_verified": true,
+          "manual_hold": false,
+          "hold_reason": null,
+          "notes": null,
+          "retired_at": null,
+          "created_at": "2026-07-08T19:32:21.628513Z",
+          "updated_at": "2026-07-08T19:32:21.628513Z"
+        },
+        "all_time": {
+          "calls": 589,
+          "tenant_count": 1,
+          "user_count": 1,
+          "component_count": 1,
+          "tenants": {
+            "unknown": 589
+          },
+          "users": {
+            "unknown": 589
+          },
+          "components": {
+            "unknown": 589
+          }
+        },
+        "window": {
+          "calls": 0,
+          "tenant_count": 0,
+          "user_count": 0,
+          "component_count": 0,
+          "tenants": {},
+          "users": {},
+          "components": {}
+        },
+        "last_seen_at": "2026-07-31T16:25:32.181901Z",
+        "retirement_candidate": true,
+        "retirement_reason": "no measured usage in review window"
+      },
+      {
+        "interface": {
+          "id": "3e4a3d0b-08fa-45c3-91e2-4f514a914b97",
+          "interface_key": "rest_api:GET /workstreams/",
+          "interface_kind": "rest_api",
+          "legacy_since": "2026-06-04T00:26:14.533764Z",
+          "replacement_ref": "/workplans/",
+          "owner_component": "state-hub.api",
+          "status": "legacy",
+          "replacement_verified": true,
+          "manual_hold": false,
+          "hold_reason": null,
+          "notes": null,
+          "retired_at": null,
+          "created_at": "2026-06-04T00:26:14.533764Z",
+          "updated_at": "2026-06-04T00:26:14.533764Z"
+        },
+        "all_time": {
+          "calls": 144085,
+          "tenant_count": 1,
+          "user_count": 1,
+          "component_count": 1,
+          "tenants": {
+            "unknown": 144085
+          },
+          "users": {
+            "unknown": 144085
+          },
+          "components": {
+            "unknown": 144085
+          }
+        },
+        "window": {
+          "calls": 0,
+          "tenant_count": 0,
+          "user_count": 0,
+          "component_count": 0,
+          "tenants": {},
+          "users": {},
+          "components": {}
+        },
+        "last_seen_at": "2026-08-05T13:01:38.000781Z",
+        "retirement_candidate": true,
+        "retirement_reason": "no measured usage in review window"
+      },
+      {
+        "interface": {
+          "id": "e4c140ec-7479-46f9-b185-4b533f19d639",
+          "interface_key": "rest_api:GET /workstreams/workplan-index",
+          "interface_kind": "rest_api",
+          "legacy_since": "2026-06-04T05:20:58.321869Z",
+          "replacement_ref": "/workplans/index",
+          "owner_component": "state-hub.api",
+          "status": "legacy",
+          "replacement_verified": true,
+          "manual_hold": false,
+          "hold_reason": null,
+          "notes": null,
+          "retired_at": null,
+          "created_at": "2026-06-04T05:20:58.321869Z",
+          "updated_at": "2026-06-04T05:20:58.321869Z"
+        },
+        "all_time": {
+          "calls": 30,
+          "tenant_count": 1,
+          "user_count": 1,
+          "component_count": 1,
+          "tenants": {
+            "unknown": 30
+          },
+          "users": {
+            "unknown": 30
+          },
+          "components": {
+            "unknown": 30
+          }
+        },
+        "window": {
+          "calls": 0,
+          "tenant_count": 0,
+          "user_count": 0,
+          "component_count": 0,
+          "tenants": {},
+          "users": {},
+          "components": {}
+        },
+        "last_seen_at": "2026-07-03T05:20:34.534439Z",
+        "retirement_candidate": true,
+        "retirement_reason": "no measured usage in review window"
+      },
+      {
+        "interface": {
+          "id": "3a00b19e-e7db-4403-98aa-a77c9ab61ecc",
+          "interface_key": "rest_api:GET /workstreams/{workstream_id}",
+          "interface_kind": "rest_api",
+          "legacy_since": "2026-06-04T00:25:59.014966Z",
+          "replacement_ref": "/workplans/{workplan_id}",
+          "owner_component": "state-hub.api",
+          "status": "legacy",
+          "replacement_verified": true,
+          "manual_hold": false,
+          "hold_reason": null,
+          "notes": null,
+          "retired_at": null,
+          "created_at": "2026-06-04T00:25:59.014966Z",
+          "updated_at": "2026-06-04T00:25:59.014966Z"
+        },
+        "all_time": {
+          "calls": 511406,
+          "tenant_count": 1,
+          "user_count": 1,
+          "component_count": 1,
+          "tenants": {
+            "unknown": 511406
+          },
+          "users": {
+            "unknown": 511406
+          },
+          "components": {
+            "unknown": 511406
+          }
+        },
+        "window": {
+          "calls": 0,
+          "tenant_count": 0,
+          "user_count": 0,
+          "component_count": 0,
+          "tenants": {},
+          "users": {},
+          "components": {}
+        },
+        "last_seen_at": "2026-07-31T16:25:32.004042Z",
+        "retirement_candidate": true,
+        "retirement_reason": "no measured usage in review window"
+      },
+      {
+        "interface": {
+          "id": "69e1a255-a8b9-4101-8a68-b1bed23abfda",
+          "interface_key": "rest_api:GET /workstreams/{workstream_id}/dependencies/",
+          "interface_kind": "rest_api",
+          "legacy_since": "2026-06-04T00:25:59.291135Z",
+          "replacement_ref": "/workplans/{workplan_id}/dependencies/",
+          "owner_component": "state-hub.api",
+          "status": "legacy",
+          "replacement_verified": true,
+          "manual_hold": false,
+          "hold_reason": null,
+          "notes": null,
+          "retired_at": null,
+          "created_at": "2026-06-04T00:25:59.291135Z",
+          "updated_at": "2026-06-04T00:25:59.291135Z"
+        },
+        "all_time": {
+          "calls": 255865,
+          "tenant_count": 1,
+          "user_count": 1,
+          "component_count": 1,
+          "tenants": {
+            "unknown": 255865
+          },
+          "users": {
+            "unknown": 255865
+          },
+          "components": {
+            "unknown": 255865
+          }
+        },
+        "window": {
+          "calls": 0,
+          "tenant_count": 0,
+          "user_count": 0,
+          "component_count": 0,
+          "tenants": {},
+          "users": {},
+          "components": {}
+        },
+        "last_seen_at": "2026-07-08T21:14:12.747005Z",
+        "retirement_candidate": true,
+        "retirement_reason": "no measured usage in review window"
+      },
+      {
+        "interface": {
+          "id": "b1aae931-b51f-4a85-a723-865dd65f6132",
+          "interface_key": "rest_api:PATCH /workstreams/{workstream_id}",
+          "interface_kind": "rest_api",
+          "legacy_since": "2026-06-04T06:09:41.901035Z",
+          "replacement_ref": "/workplans/{workplan_id}",
+          "owner_component": "state-hub.api",
+          "status": "legacy",
+          "replacement_verified": true,
+          "manual_hold": false,
+          "hold_reason": null,
+          "notes": null,
+          "retired_at": null,
+          "created_at": "2026-06-04T06:09:41.901035Z",
+          "updated_at": "2026-06-04T06:09:41.901035Z"
+        },
+        "all_time": {
+          "calls": 571,
+          "tenant_count": 1,
+          "user_count": 1,
+          "component_count": 1,
+          "tenants": {
+            "unknown": 571
+          },
+          "users": {
+            "unknown": 571
+          },
+          "components": {
+            "unknown": 571
+          }
+        },
+        "window": {
+          "calls": 0,
+          "tenant_count": 0,
+          "user_count": 0,
+          "component_count": 0,
+          "tenants": {},
+          "users": {},
+          "components": {}
+        },
+        "last_seen_at": "2026-07-08T20:49:12.335710Z",
+        "retirement_candidate": true,
+        "retirement_reason": "no measured usage in review window"
+      },
+      {
+        "interface": {
+          "id": "4aea9591-970b-4918-ac4a-4da95a0a1a8c",
+          "interface_key": "rest_api:POST /decisions/ workstream_id",
+          "interface_kind": "rest_api",
+          "legacy_since": "2026-07-09T22:56:35.473130Z",
+          "replacement_ref": "POST /decisions/ with workplan_id",
+          "owner_component": "state-hub.api",
+          "status": "legacy",
+          "replacement_verified": true,
+          "manual_hold": false,
+          "hold_reason": null,
+          "notes": null,
+          "retired_at": null,
+          "created_at": "2026-07-09T22:56:35.473130Z",
+          "updated_at": "2026-07-09T22:56:35.473130Z"
+        },
+        "all_time": {
+          "calls": 3,
+          "tenant_count": 1,
+          "user_count": 1,
+          "component_count": 1,
+          "tenants": {
+            "unknown": 3
+          },
+          "users": {
+            "unknown": 3
+          },
+          "components": {
+            "unknown": 3
+          }
+        },
+        "window": {
+          "calls": 0,
+          "tenant_count": 0,
+          "user_count": 0,
+          "component_count": 0,
+          "tenants": {},
+          "users": {},
+          "components": {}
+        },
+        "last_seen_at": "2026-07-09T22:57:05.912456Z",
+        "retirement_candidate": true,
+        "retirement_reason": "no measured usage in review window"
+      },
+      {
+        "interface": {
+          "id": "4a70583c-1e41-4ec1-99a9-728856a7d79c",
+          "interface_key": "rest_api:POST /progress/ workstream_id",
+          "interface_kind": "rest_api",
+          "legacy_since": "2026-07-08T23:35:09.148333Z",
+          "replacement_ref": "POST /progress/ with workplan_id",
+          "owner_component": "state-hub.api",
+          "status": "legacy",
+          "replacement_verified": true,
+          "manual_hold": false,
+          "hold_reason": null,
+          "notes": null,
+          "retired_at": null,
+          "created_at": "2026-07-08T23:35:09.148333Z",
+          "updated_at": "2026-07-08T23:35:09.148333Z"
+        },
+        "all_time": {
+          "calls": 14,
+          "tenant_count": 1,
+          "user_count": 1,
+          "component_count": 1,
+          "tenants": {
+            "unknown": 14
+          },
+          "users": {
+            "unknown": 14
+          },
+          "components": {
+            "unknown": 14
+          }
+        },
+        "window": {
+          "calls": 0,
+          "tenant_count": 0,
+          "user_count": 0,
+          "component_count": 0,
+          "tenants": {},
+          "users": {},
+          "components": {}
+        },
+        "last_seen_at": "2026-07-10T08:34:42.959724Z",
+        "retirement_candidate": true,
+        "retirement_reason": "no measured usage in review window"
+      },
+      {
+        "interface": {
+          "id": "6df4e443-7bf1-461a-923b-a6eb52fe7b07",
+          "interface_key": "rest_api:POST /tasks/ workstream_id",
+          "interface_kind": "rest_api",
+          "legacy_since": "2026-07-08T22:38:29.405720Z",
+          "replacement_ref": "POST /tasks/ with workplan_id",
+          "owner_component": "state-hub.api",
+          "status": "legacy",
+          "replacement_verified": true,
+          "manual_hold": false,
+          "hold_reason": null,
+          "notes": null,
+          "retired_at": null,
+          "created_at": "2026-07-08T22:38:29.405720Z",
+          "updated_at": "2026-07-08T22:38:29.405720Z"
+        },
+        "all_time": {
+          "calls": 5,
+          "tenant_count": 1,
+          "user_count": 1,
+          "component_count": 1,
+          "tenants": {
+            "unknown": 5
+          },
+          "users": {
+            "unknown": 5
+          },
+          "components": {
+            "state-hub.fix-consistency": 5
+          }
+        },
+        "window": {
+          "calls": 0,
+          "tenant_count": 0,
+          "user_count": 0,
+          "component_count": 0,
+          "tenants": {},
+          "users": {},
+          "components": {}
+        },
+        "last_seen_at": "2026-07-08T22:38:29.976918Z",
+        "retirement_candidate": true,
+        "retirement_reason": "no measured usage in review window"
+      },
+      {
+        "interface": {
+          "id": "ed6451c9-d2cc-4486-9afe-d3852782cabc",
+          "interface_key": "rest_api:POST /workstreams/",
+          "interface_kind": "rest_api",
+          "legacy_since": "2026-06-04T07:40:24.168535Z",
+          "replacement_ref": "/workplans/",
+          "owner_component": "state-hub.api",
+          "status": "legacy",
+          "replacement_verified": true,
+          "manual_hold": false,
+          "hold_reason": null,
+          "notes": null,
+          "retired_at": null,
+          "created_at": "2026-06-04T07:40:24.168535Z",
+          "updated_at": "2026-06-04T07:40:24.168535Z"
+        },
+        "all_time": {
+          "calls": 824,
+          "tenant_count": 1,
+          "user_count": 1,
+          "component_count": 1,
+          "tenants": {
+            "unknown": 824
+          },
+          "users": {
+            "unknown": 824
+          },
+          "components": {
+            "unknown": 824
+          }
+        },
+        "window": {
+          "calls": 0,
+          "tenant_count": 0,
+          "user_count": 0,
+          "component_count": 0,
+          "tenants": {},
+          "users": {},
+          "components": {}
+        },
+        "last_seen_at": "2026-07-08T20:38:05.903144Z",
+        "retirement_candidate": true,
+        "retirement_reason": "no measured usage in review window"
+      },
+      {
+        "interface": {
+          "id": "281fd706-b192-4194-8055-2d8733c115f9",
+          "interface_key": "rest_api:POST /workstreams/{workstream_id}/dependencies/",
+          "interface_kind": "rest_api",
+          "legacy_since": "2026-06-04T22:57:37.149207Z",
+          "replacement_ref": "/workplans/{workplan_id}/dependencies/",
+          "owner_component": "state-hub.api",
+          "status": "legacy",
+          "replacement_verified": true,
+          "manual_hold": false,
+          "hold_reason": null,
+          "notes": null,
+          "retired_at": null,
+          "created_at": "2026-06-04T22:57:37.149207Z",
+          "updated_at": "2026-06-04T22:57:37.149207Z"
+        },
+        "all_time": {
+          "calls": 4971,
+          "tenant_count": 1,
+          "user_count": 1,
+          "component_count": 1,
+          "tenants": {
+            "unknown": 4971
+          },
+          "users": {
+            "unknown": 4971
+          },
+          "components": {
+            "unknown": 4971
+          }
+        },
+        "window": {
+          "calls": 0,
+          "tenant_count": 0,
+          "user_count": 0,
+          "component_count": 0,
+          "tenants": {},
+          "users": {},
+          "components": {}
+        },
+        "last_seen_at": "2026-07-01T22:09:24.229011Z",
+        "retirement_candidate": true,
+        "retirement_reason": "no measured usage in review window"
+      }
+    ]
+  },
+  "hours": 8
+}
diff --git a/docs/evidence/legacy-meter-weekly-review-20260811.json b/docs/evidence/legacy-meter-weekly-review-20260811.json
new file mode 100644
index 0000000..79e9d57
--- /dev/null
+++ b/docs/evidence/legacy-meter-weekly-review-20260811.json
@@ -0,0 +1,1755 @@
+{
+  "captured_at": "2026-08-11T14:00:04.325774+00:00",
+  "api_base": "http://127.0.0.1:8000",
+  "workplan": "STATE-WP-0070",
+  "retired_interfaces": [],
+  "weekly_review": {
+    "generated_at": "2026-08-11T14:00:04.319529Z",
+    "window_start": "2026-08-11T06:00:04.248178Z",
+    "window_end": "2026-08-11T14:00:04.248178Z",
+    "cadence": "weekly",
+    "activity_core_handoff": {
+      "activity_id": "statehub-legacy-interface-review",
+      "cadence": "weekly",
+      "source_endpoint": "/legacy-meter/weekly-review",
+      "state_owner": "state-hub",
+      "scheduler_owner": "activity-core"
+    },
+    "interfaces": [
+      {
+        "interface": {
+          "id": "8051fb40-66c9-4dc4-a413-13e8573e04a3",
+          "interface_key": "event_subject:org.statehub.workstream.completed",
+          "interface_kind": "event_subject",
+          "legacy_since": "2026-06-04T06:09:42.198193Z",
+          "replacement_ref": "org.statehub.workplan.completed",
+          "owner_component": "state-hub.events",
+          "status": "retired",
+          "replacement_verified": true,
+          "manual_hold": false,
+          "hold_reason": null,
+          "notes": "Retired by STATE-WP-0069 closeout",
+          "retired_at": "2026-07-08T21:38:52.773601Z",
+          "created_at": "2026-06-04T06:09:42.198193Z",
+          "updated_at": "2026-07-08T21:38:52.761243Z"
+        },
+        "all_time": {
+          "calls": 255,
+          "tenant_count": 1,
+          "user_count": 1,
+          "component_count": 1,
+          "tenants": {
+            "unknown": 255
+          },
+          "users": {
+            "unknown": 255
+          },
+          "components": {
+            "state-hub.events": 255
+          }
+        },
+        "window": {
+          "calls": 0,
+          "tenant_count": 0,
+          "user_count": 0,
+          "component_count": 0,
+          "tenants": {},
+          "users": {},
+          "components": {}
+        },
+        "last_seen_at": "2026-07-08T20:49:12.839383Z",
+        "retirement_candidate": false,
+        "retirement_reason": "already retired"
+      },
+      {
+        "interface": {
+          "id": "63ed90e3-42b4-431a-94db-e1254a52f9e2",
+          "interface_key": "mcp:create_workstream",
+          "interface_kind": "mcp_tool",
+          "legacy_since": "2026-07-10T13:19:44.205900Z",
+          "replacement_ref": "create_workplan",
+          "owner_component": "state-hub.mcp",
+          "status": "legacy",
+          "replacement_verified": true,
+          "manual_hold": false,
+          "hold_reason": null,
+          "notes": "Registered by STATE-WP-0070 T03 \u2014 zero-window streak starts at registration",
+          "retired_at": null,
+          "created_at": "2026-07-10T13:19:44.205900Z",
+          "updated_at": "2026-07-10T13:19:44.205900Z"
+        },
+        "all_time": {
+          "calls": 2,
+          "tenant_count": 1,
+          "user_count": 1,
+          "component_count": 1,
+          "tenants": {
+            "unknown": 2
+          },
+          "users": {
+            "unknown": 2
+          },
+          "components": {
+            "state-hub.mcp": 2
+          }
+        },
+        "window": {
+          "calls": 0,
+          "tenant_count": 0,
+          "user_count": 0,
+          "component_count": 0,
+          "tenants": {},
+          "users": {},
+          "components": {}
+        },
+        "last_seen_at": "2026-07-10T13:20:43.378546Z",
+        "retirement_candidate": true,
+        "retirement_reason": "no measured usage in review window"
+      },
+      {
+        "interface": {
+          "id": "b6a5fe44-fb85-4ef7-a273-78d09da777af",
+          "interface_key": "mcp:list_workstreams",
+          "interface_kind": "mcp_tool",
+          "legacy_since": "2026-07-10T13:19:26.075491Z",
+          "replacement_ref": "list_workplans",
+          "owner_component": "state-hub.mcp",
+          "status": "legacy",
+          "replacement_verified": true,
+          "manual_hold": false,
+          "hold_reason": null,
+          "notes": null,
+          "retired_at": null,
+          "created_at": "2026-07-10T13:19:26.075491Z",
+          "updated_at": "2026-07-10T13:19:26.075491Z"
+        },
+        "all_time": {
+          "calls": 2,
+          "tenant_count": 1,
+          "user_count": 1,
+          "component_count": 1,
+          "tenants": {
+            "unknown": 2
+          },
+          "users": {
+            "unknown": 2
+          },
+          "components": {
+            "state-hub.mcp": 2
+          }
+        },
+        "window": {
+          "calls": 0,
+          "tenant_count": 0,
+          "user_count": 0,
+          "component_count": 0,
+          "tenants": {},
+          "users": {},
+          "components": {}
+        },
+        "last_seen_at": "2026-07-10T13:20:42.374940Z",
+        "retirement_candidate": true,
+        "retirement_reason": "no measured usage in review window"
+      },
+      {
+        "interface": {
+          "id": "53c3372b-307d-4d6a-8ea4-bc36cacdcaf2",
+          "interface_key": "mcp:update_workstream",
+          "interface_kind": "mcp_tool",
+          "legacy_since": "2026-07-10T13:19:44.255216Z",
+          "replacement_ref": "update_workplan",
+          "owner_component": "state-hub.mcp",
+          "status": "legacy",
+          "replacement_verified": true,
+          "manual_hold": false,
+          "hold_reason": null,
+          "notes": "Registered by STATE-WP-0070 T03 \u2014 zero-window streak starts at registration",
+          "retired_at": null,
+          "created_at": "2026-07-10T13:19:44.255216Z",
+          "updated_at": "2026-07-10T13:19:44.255216Z"
+        },
+        "all_time": {
+          "calls": 0,
+          "tenant_count": 0,
+          "user_count": 0,
+          "component_count": 0,
+          "tenants": {},
+          "users": {},
+          "components": {}
+        },
+        "window": {
+          "calls": 0,
+          "tenant_count": 0,
+          "user_count": 0,
+          "component_count": 0,
+          "tenants": {},
+          "users": {},
+          "components": {}
+        },
+        "last_seen_at": null,
+        "retirement_candidate": true,
+        "retirement_reason": "no measured usage in review window"
+      },
+      {
+        "interface": {
+          "id": "bed4d08a-3471-48f5-9f0e-f9d550383a26",
+          "interface_key": "mcp:update_workstream_status",
+          "interface_kind": "mcp_tool",
+          "legacy_since": "2026-07-10T13:19:44.303612Z",
+          "replacement_ref": "update_workplan_status",
+          "owner_component": "state-hub.mcp",
+          "status": "legacy",
+          "replacement_verified": true,
+          "manual_hold": false,
+          "hold_reason": null,
+          "notes": "Registered by STATE-WP-0070 T03 \u2014 zero-window streak starts at registration",
+          "retired_at": null,
+          "created_at": "2026-07-10T13:19:44.303612Z",
+          "updated_at": "2026-07-10T13:19:44.303612Z"
+        },
+        "all_time": {
+          "calls": 0,
+          "tenant_count": 0,
+          "user_count": 0,
+          "component_count": 0,
+          "tenants": {},
+          "users": {},
+          "components": {}
+        },
+        "window": {
+          "calls": 0,
+          "tenant_count": 0,
+          "user_count": 0,
+          "component_count": 0,
+          "tenants": {},
+          "users": {},
+          "components": {}
+        },
+        "last_seen_at": null,
+        "retirement_candidate": true,
+        "retirement_reason": "no measured usage in review window"
+      },
+      {
+        "interface": {
+          "id": "46900dc2-0893-405b-ba59-80f31fb6ebb1",
+          "interface_key": "state://workstreams/{topic_slug}",
+          "interface_kind": "mcp_tool",
+          "legacy_since": "2026-07-10T13:19:44.344493Z",
+          "replacement_ref": "state://workplans/{topic_slug}",
+          "owner_component": "state-hub.mcp",
+          "status": "legacy",
+          "replacement_verified": true,
+          "manual_hold": false,
+          "hold_reason": null,
+          "notes": "Registered by STATE-WP-0070 T03 \u2014 zero-window streak starts at registration",
+          "retired_at": null,
+          "created_at": "2026-07-10T13:19:44.344493Z",
+          "updated_at": "2026-07-10T13:19:44.344493Z"
+        },
+        "all_time": {
+          "calls": 1,
+          "tenant_count": 1,
+          "user_count": 1,
+          "component_count": 1,
+          "tenants": {
+            "unknown": 1
+          },
+          "users": {
+            "unknown": 1
+          },
+          "components": {
+            "state-hub.mcp": 1
+          }
+        },
+        "window": {
+          "calls": 0,
+          "tenant_count": 0,
+          "user_count": 0,
+          "component_count": 0,
+          "tenants": {},
+          "users": {},
+          "components": {}
+        },
+        "last_seen_at": "2026-07-10T13:20:34.491811Z",
+        "retirement_candidate": true,
+        "retirement_reason": "no measured usage in review window"
+      },
+      {
+        "interface": {
+          "id": "cd9342fd-27e7-4a46-a1be-d41499e106a3",
+          "interface_key": "rest_api:DELETE /workstreams/{workstream_id}",
+          "interface_kind": "rest_api",
+          "legacy_since": "2026-06-06T17:28:13.052813Z",
+          "replacement_ref": "/workplans/{workplan_id}",
+          "owner_component": "state-hub.api",
+          "status": "legacy",
+          "replacement_verified": true,
+          "manual_hold": false,
+          "hold_reason": null,
+          "notes": null,
+          "retired_at": null,
+          "created_at": "2026-06-06T17:28:13.052813Z",
+          "updated_at": "2026-06-06T17:28:13.052813Z"
+        },
+        "all_time": {
+          "calls": 1,
+          "tenant_count": 1,
+          "user_count": 1,
+          "component_count": 1,
+          "tenants": {
+            "unknown": 1
+          },
+          "users": {
+            "unknown": 1
+          },
+          "components": {
+            "unknown": 1
+          }
+        },
+        "window": {
+          "calls": 0,
+          "tenant_count": 0,
+          "user_count": 0,
+          "component_count": 0,
+          "tenants": {},
+          "users": {},
+          "components": {}
+        },
+        "last_seen_at": "2026-06-06T17:28:13.047529Z",
+        "retirement_candidate": true,
+        "retirement_reason": "no measured usage in review window"
+      },
+      {
+        "interface": {
+          "id": "a4e0948c-cd4a-461e-8ae2-7fd7b51d04a7",
+          "interface_key": "rest_api:GET /decisions/?workstream_id",
+          "interface_kind": "rest_api",
+          "legacy_since": "2026-07-09T23:07:53.093223Z",
+          "replacement_ref": "/decisions/?workplan_id=<workplan_id>",
+          "owner_component": "state-hub.api",
+          "status": "legacy",
+          "replacement_verified": true,
+          "manual_hold": false,
+          "hold_reason": null,
+          "notes": null,
+          "retired_at": null,
+          "created_at": "2026-07-09T23:07:53.093223Z",
+          "updated_at": "2026-07-09T23:07:53.093223Z"
+        },
+        "all_time": {
+          "calls": 1,
+          "tenant_count": 1,
+          "user_count": 1,
+          "component_count": 1,
+          "tenants": {
+            "unknown": 1
+          },
+          "users": {
+            "unknown": 1
+          },
+          "components": {
+            "unknown": 1
+          }
+        },
+        "window": {
+          "calls": 0,
+          "tenant_count": 0,
+          "user_count": 0,
+          "component_count": 0,
+          "tenants": {},
+          "users": {},
+          "components": {}
+        },
+        "last_seen_at": "2026-07-09T23:07:53.083299Z",
+        "retirement_candidate": true,
+        "retirement_reason": "no measured usage in review window"
+      },
+      {
+        "interface": {
+          "id": "70a9346e-e0ee-42ac-874f-f160580b54dd",
+          "interface_key": "rest_api:GET /progress/?workstream_id",
+          "interface_kind": "rest_api",
+          "legacy_since": "2026-07-13T22:04:03.911449Z",
+          "replacement_ref": "/progress/?workplan_id=<workplan_id>",
+          "owner_component": "state-hub.api",
+          "status": "legacy",
+          "replacement_verified": true,
+          "manual_hold": false,
+          "hold_reason": null,
+          "notes": null,
+          "retired_at": null,
+          "created_at": "2026-07-13T22:04:03.911449Z",
+          "updated_at": "2026-07-13T22:04:03.911449Z"
+        },
+        "all_time": {
+          "calls": 1,
+          "tenant_count": 1,
+          "user_count": 1,
+          "component_count": 1,
+          "tenants": {
+            "unknown": 1
+          },
+          "users": {
+            "unknown": 1
+          },
+          "components": {
+            "unknown": 1
+          }
+        },
+        "window": {
+          "calls": 0,
+          "tenant_count": 0,
+          "user_count": 0,
+          "component_count": 0,
+          "tenants": {},
+          "users": {},
+          "components": {}
+        },
+        "last_seen_at": "2026-07-13T22:04:03.904998Z",
+        "retirement_candidate": true,
+        "retirement_reason": "no measured usage in review window"
+      },
+      {
+        "interface": {
+          "id": "be3cdcf8-250b-4bf0-801f-02ffd5f57e00",
+          "interface_key": "rest_api:GET /tasks/?workstream_id",
+          "interface_kind": "rest_api",
+          "legacy_since": "2026-07-08T19:32:21.628513Z",
+          "replacement_ref": "/tasks/?workplan_id=<workplan_id>",
+          "owner_component": "state-hub.api",
+          "status": "legacy",
+          "replacement_verified": true,
+          "manual_hold": false,
+          "hold_reason": null,
+          "notes": null,
+          "retired_at": null,
+          "created_at": "2026-07-08T19:32:21.628513Z",
+          "updated_at": "2026-07-08T19:32:21.628513Z"
+        },
+        "all_time": {
+          "calls": 589,
+          "tenant_count": 1,
+          "user_count": 1,
+          "component_count": 1,
+          "tenants": {
+            "unknown": 589
+          },
+          "users": {
+            "unknown": 589
+          },
+          "components": {
+            "unknown": 589
+          }
+        },
+        "window": {
+          "calls": 0,
+          "tenant_count": 0,
+          "user_count": 0,
+          "component_count": 0,
+          "tenants": {},
+          "users": {},
+          "components": {}
+        },
+        "last_seen_at": "2026-07-31T16:25:32.181901Z",
+        "retirement_candidate": true,
+        "retirement_reason": "no measured usage in review window"
+      },
+      {
+        "interface": {
+          "id": "3e4a3d0b-08fa-45c3-91e2-4f514a914b97",
+          "interface_key": "rest_api:GET /workstreams/",
+          "interface_kind": "rest_api",
+          "legacy_since": "2026-06-04T00:26:14.533764Z",
+          "replacement_ref": "/workplans/",
+          "owner_component": "state-hub.api",
+          "status": "legacy",
+          "replacement_verified": true,
+          "manual_hold": false,
+          "hold_reason": null,
+          "notes": null,
+          "retired_at": null,
+          "created_at": "2026-06-04T00:26:14.533764Z",
+          "updated_at": "2026-06-04T00:26:14.533764Z"
+        },
+        "all_time": {
+          "calls": 144086,
+          "tenant_count": 1,
+          "user_count": 1,
+          "component_count": 1,
+          "tenants": {
+            "unknown": 144086
+          },
+          "users": {
+            "unknown": 144086
+          },
+          "components": {
+            "unknown": 144086
+          }
+        },
+        "window": {
+          "calls": 0,
+          "tenant_count": 0,
+          "user_count": 0,
+          "component_count": 0,
+          "tenants": {},
+          "users": {},
+          "components": {}
+        },
+        "last_seen_at": "2026-08-10T18:06:05.032338Z",
+        "retirement_candidate": true,
+        "retirement_reason": "no measured usage in review window"
+      },
+      {
+        "interface": {
+          "id": "e4c140ec-7479-46f9-b185-4b533f19d639",
+          "interface_key": "rest_api:GET /workstreams/workplan-index",
+          "interface_kind": "rest_api",
+          "legacy_since": "2026-06-04T05:20:58.321869Z",
+          "replacement_ref": "/workplans/index",
+          "owner_component": "state-hub.api",
+          "status": "legacy",
+          "replacement_verified": true,
+          "manual_hold": false,
+          "hold_reason": null,
+          "notes": null,
+          "retired_at": null,
+          "created_at": "2026-06-04T05:20:58.321869Z",
+          "updated_at": "2026-06-04T05:20:58.321869Z"
+        },
+        "all_time": {
+          "calls": 30,
+          "tenant_count": 1,
+          "user_count": 1,
+          "component_count": 1,
+          "tenants": {
+            "unknown": 30
+          },
+          "users": {
+            "unknown": 30
+          },
+          "components": {
+            "unknown": 30
+          }
+        },
+        "window": {
+          "calls": 0,
+          "tenant_count": 0,
+          "user_count": 0,
+          "component_count": 0,
+          "tenants": {},
+          "users": {},
+          "components": {}
+        },
+        "last_seen_at": "2026-07-03T05:20:34.534439Z",
+        "retirement_candidate": true,
+        "retirement_reason": "no measured usage in review window"
+      },
+      {
+        "interface": {
+          "id": "3a00b19e-e7db-4403-98aa-a77c9ab61ecc",
+          "interface_key": "rest_api:GET /workstreams/{workstream_id}",
+          "interface_kind": "rest_api",
+          "legacy_since": "2026-06-04T00:25:59.014966Z",
+          "replacement_ref": "/workplans/{workplan_id}",
+          "owner_component": "state-hub.api",
+          "status": "legacy",
+          "replacement_verified": true,
+          "manual_hold": false,
+          "hold_reason": null,
+          "notes": null,
+          "retired_at": null,
+          "created_at": "2026-06-04T00:25:59.014966Z",
+          "updated_at": "2026-06-04T00:25:59.014966Z"
+        },
+        "all_time": {
+          "calls": 511406,
+          "tenant_count": 1,
+          "user_count": 1,
+          "component_count": 1,
+          "tenants": {
+            "unknown": 511406
+          },
+          "users": {
+            "unknown": 511406
+          },
+          "components": {
+            "unknown": 511406
+          }
+        },
+        "window": {
+          "calls": 0,
+          "tenant_count": 0,
+          "user_count": 0,
+          "component_count": 0,
+          "tenants": {},
+          "users": {},
+          "components": {}
+        },
+        "last_seen_at": "2026-07-31T16:25:32.004042Z",
+        "retirement_candidate": true,
+        "retirement_reason": "no measured usage in review window"
+      },
+      {
+        "interface": {
+          "id": "69e1a255-a8b9-4101-8a68-b1bed23abfda",
+          "interface_key": "rest_api:GET /workstreams/{workstream_id}/dependencies/",
+          "interface_kind": "rest_api",
+          "legacy_since": "2026-06-04T00:25:59.291135Z",
+          "replacement_ref": "/workplans/{workplan_id}/dependencies/",
+          "owner_component": "state-hub.api",
+          "status": "legacy",
+          "replacement_verified": true,
+          "manual_hold": false,
+          "hold_reason": null,
+          "notes": null,
+          "retired_at": null,
+          "created_at": "2026-06-04T00:25:59.291135Z",
+          "updated_at": "2026-06-04T00:25:59.291135Z"
+        },
+        "all_time": {
+          "calls": 255865,
+          "tenant_count": 1,
+          "user_count": 1,
+          "component_count": 1,
+          "tenants": {
+            "unknown": 255865
+          },
+          "users": {
+            "unknown": 255865
+          },
+          "components": {
+            "unknown": 255865
+          }
+        },
+        "window": {
+          "calls": 0,
+          "tenant_count": 0,
+          "user_count": 0,
+          "component_count": 0,
+          "tenants": {},
+          "users": {},
+          "components": {}
+        },
+        "last_seen_at": "2026-07-08T21:14:12.747005Z",
+        "retirement_candidate": true,
+        "retirement_reason": "no measured usage in review window"
+      },
+      {
+        "interface": {
+          "id": "b1aae931-b51f-4a85-a723-865dd65f6132",
+          "interface_key": "rest_api:PATCH /workstreams/{workstream_id}",
+          "interface_kind": "rest_api",
+          "legacy_since": "2026-06-04T06:09:41.901035Z",
+          "replacement_ref": "/workplans/{workplan_id}",
+          "owner_component": "state-hub.api",
+          "status": "legacy",
+          "replacement_verified": true,
+          "manual_hold": false,
+          "hold_reason": null,
+          "notes": null,
+          "retired_at": null,
+          "created_at": "2026-06-04T06:09:41.901035Z",
+          "updated_at": "2026-06-04T06:09:41.901035Z"
+        },
+        "all_time": {
+          "calls": 571,
+          "tenant_count": 1,
+          "user_count": 1,
+          "component_count": 1,
+          "tenants": {
+            "unknown": 571
+          },
+          "users": {
+            "unknown": 571
+          },
+          "components": {
+            "unknown": 571
+          }
+        },
+        "window": {
+          "calls": 0,
+          "tenant_count": 0,
+          "user_count": 0,
+          "component_count": 0,
+          "tenants": {},
+          "users": {},
+          "components": {}
+        },
+        "last_seen_at": "2026-07-08T20:49:12.335710Z",
+        "retirement_candidate": true,
+        "retirement_reason": "no measured usage in review window"
+      },
+      {
+        "interface": {
+          "id": "4aea9591-970b-4918-ac4a-4da95a0a1a8c",
+          "interface_key": "rest_api:POST /decisions/ workstream_id",
+          "interface_kind": "rest_api",
+          "legacy_since": "2026-07-09T22:56:35.473130Z",
+          "replacement_ref": "POST /decisions/ with workplan_id",
+          "owner_component": "state-hub.api",
+          "status": "legacy",
+          "replacement_verified": true,
+          "manual_hold": false,
+          "hold_reason": null,
+          "notes": null,
+          "retired_at": null,
+          "created_at": "2026-07-09T22:56:35.473130Z",
+          "updated_at": "2026-07-09T22:56:35.473130Z"
+        },
+        "all_time": {
+          "calls": 3,
+          "tenant_count": 1,
+          "user_count": 1,
+          "component_count": 1,
+          "tenants": {
+            "unknown": 3
+          },
+          "users": {
+            "unknown": 3
+          },
+          "components": {
+            "unknown": 3
+          }
+        },
+        "window": {
+          "calls": 0,
+          "tenant_count": 0,
+          "user_count": 0,
+          "component_count": 0,
+          "tenants": {},
+          "users": {},
+          "components": {}
+        },
+        "last_seen_at": "2026-07-09T22:57:05.912456Z",
+        "retirement_candidate": true,
+        "retirement_reason": "no measured usage in review window"
+      },
+      {
+        "interface": {
+          "id": "4a70583c-1e41-4ec1-99a9-728856a7d79c",
+          "interface_key": "rest_api:POST /progress/ workstream_id",
+          "interface_kind": "rest_api",
+          "legacy_since": "2026-07-08T23:35:09.148333Z",
+          "replacement_ref": "POST /progress/ with workplan_id",
+          "owner_component": "state-hub.api",
+          "status": "legacy",
+          "replacement_verified": true,
+          "manual_hold": false,
+          "hold_reason": null,
+          "notes": null,
+          "retired_at": null,
+          "created_at": "2026-07-08T23:35:09.148333Z",
+          "updated_at": "2026-07-08T23:35:09.148333Z"
+        },
+        "all_time": {
+          "calls": 14,
+          "tenant_count": 1,
+          "user_count": 1,
+          "component_count": 1,
+          "tenants": {
+            "unknown": 14
+          },
+          "users": {
+            "unknown": 14
+          },
+          "components": {
+            "unknown": 14
+          }
+        },
+        "window": {
+          "calls": 0,
+          "tenant_count": 0,
+          "user_count": 0,
+          "component_count": 0,
+          "tenants": {},
+          "users": {},
+          "components": {}
+        },
+        "last_seen_at": "2026-07-10T08:34:42.959724Z",
+        "retirement_candidate": true,
+        "retirement_reason": "no measured usage in review window"
+      },
+      {
+        "interface": {
+          "id": "6df4e443-7bf1-461a-923b-a6eb52fe7b07",
+          "interface_key": "rest_api:POST /tasks/ workstream_id",
+          "interface_kind": "rest_api",
+          "legacy_since": "2026-07-08T22:38:29.405720Z",
+          "replacement_ref": "POST /tasks/ with workplan_id",
+          "owner_component": "state-hub.api",
+          "status": "legacy",
+          "replacement_verified": true,
+          "manual_hold": false,
+          "hold_reason": null,
+          "notes": null,
+          "retired_at": null,
+          "created_at": "2026-07-08T22:38:29.405720Z",
+          "updated_at": "2026-07-08T22:38:29.405720Z"
+        },
+        "all_time": {
+          "calls": 5,
+          "tenant_count": 1,
+          "user_count": 1,
+          "component_count": 1,
+          "tenants": {
+            "unknown": 5
+          },
+          "users": {
+            "unknown": 5
+          },
+          "components": {
+            "state-hub.fix-consistency": 5
+          }
+        },
+        "window": {
+          "calls": 0,
+          "tenant_count": 0,
+          "user_count": 0,
+          "component_count": 0,
+          "tenants": {},
+          "users": {},
+          "components": {}
+        },
+        "last_seen_at": "2026-07-08T22:38:29.976918Z",
+        "retirement_candidate": true,
+        "retirement_reason": "no measured usage in review window"
+      },
+      {
+        "interface": {
+          "id": "ed6451c9-d2cc-4486-9afe-d3852782cabc",
+          "interface_key": "rest_api:POST /workstreams/",
+          "interface_kind": "rest_api",
+          "legacy_since": "2026-06-04T07:40:24.168535Z",
+          "replacement_ref": "/workplans/",
+          "owner_component": "state-hub.api",
+          "status": "legacy",
+          "replacement_verified": true,
+          "manual_hold": false,
+          "hold_reason": null,
+          "notes": null,
+          "retired_at": null,
+          "created_at": "2026-06-04T07:40:24.168535Z",
+          "updated_at": "2026-06-04T07:40:24.168535Z"
+        },
+        "all_time": {
+          "calls": 824,
+          "tenant_count": 1,
+          "user_count": 1,
+          "component_count": 1,
+          "tenants": {
+            "unknown": 824
+          },
+          "users": {
+            "unknown": 824
+          },
+          "components": {
+            "unknown": 824
+          }
+        },
+        "window": {
+          "calls": 0,
+          "tenant_count": 0,
+          "user_count": 0,
+          "component_count": 0,
+          "tenants": {},
+          "users": {},
+          "components": {}
+        },
+        "last_seen_at": "2026-07-08T20:38:05.903144Z",
+        "retirement_candidate": true,
+        "retirement_reason": "no measured usage in review window"
+      },
+      {
+        "interface": {
+          "id": "281fd706-b192-4194-8055-2d8733c115f9",
+          "interface_key": "rest_api:POST /workstreams/{workstream_id}/dependencies/",
+          "interface_kind": "rest_api",
+          "legacy_since": "2026-06-04T22:57:37.149207Z",
+          "replacement_ref": "/workplans/{workplan_id}/dependencies/",
+          "owner_component": "state-hub.api",
+          "status": "legacy",
+          "replacement_verified": true,
+          "manual_hold": false,
+          "hold_reason": null,
+          "notes": null,
+          "retired_at": null,
+          "created_at": "2026-06-04T22:57:37.149207Z",
+          "updated_at": "2026-06-04T22:57:37.149207Z"
+        },
+        "all_time": {
+          "calls": 4971,
+          "tenant_count": 1,
+          "user_count": 1,
+          "component_count": 1,
+          "tenants": {
+            "unknown": 4971
+          },
+          "users": {
+            "unknown": 4971
+          },
+          "components": {
+            "unknown": 4971
+          }
+        },
+        "window": {
+          "calls": 0,
+          "tenant_count": 0,
+          "user_count": 0,
+          "component_count": 0,
+          "tenants": {},
+          "users": {},
+          "components": {}
+        },
+        "last_seen_at": "2026-07-01T22:09:24.229011Z",
+        "retirement_candidate": true,
+        "retirement_reason": "no measured usage in review window"
+      }
+    ],
+    "retirement_candidates": [
+      {
+        "interface": {
+          "id": "63ed90e3-42b4-431a-94db-e1254a52f9e2",
+          "interface_key": "mcp:create_workstream",
+          "interface_kind": "mcp_tool",
+          "legacy_since": "2026-07-10T13:19:44.205900Z",
+          "replacement_ref": "create_workplan",
+          "owner_component": "state-hub.mcp",
+          "status": "legacy",
+          "replacement_verified": true,
+          "manual_hold": false,
+          "hold_reason": null,
+          "notes": "Registered by STATE-WP-0070 T03 \u2014 zero-window streak starts at registration",
+          "retired_at": null,
+          "created_at": "2026-07-10T13:19:44.205900Z",
+          "updated_at": "2026-07-10T13:19:44.205900Z"
+        },
+        "all_time": {
+          "calls": 2,
+          "tenant_count": 1,
+          "user_count": 1,
+          "component_count": 1,
+          "tenants": {
+            "unknown": 2
+          },
+          "users": {
+            "unknown": 2
+          },
+          "components": {
+            "state-hub.mcp": 2
+          }
+        },
+        "window": {
+          "calls": 0,
+          "tenant_count": 0,
+          "user_count": 0,
+          "component_count": 0,
+          "tenants": {},
+          "users": {},
+          "components": {}
+        },
+        "last_seen_at": "2026-07-10T13:20:43.378546Z",
+        "retirement_candidate": true,
+        "retirement_reason": "no measured usage in review window"
+      },
+      {
+        "interface": {
+          "id": "b6a5fe44-fb85-4ef7-a273-78d09da777af",
+          "interface_key": "mcp:list_workstreams",
+          "interface_kind": "mcp_tool",
+          "legacy_since": "2026-07-10T13:19:26.075491Z",
+          "replacement_ref": "list_workplans",
+          "owner_component": "state-hub.mcp",
+          "status": "legacy",
+          "replacement_verified": true,
+          "manual_hold": false,
+          "hold_reason": null,
+          "notes": null,
+          "retired_at": null,
+          "created_at": "2026-07-10T13:19:26.075491Z",
+          "updated_at": "2026-07-10T13:19:26.075491Z"
+        },
+        "all_time": {
+          "calls": 2,
+          "tenant_count": 1,
+          "user_count": 1,
+          "component_count": 1,
+          "tenants": {
+            "unknown": 2
+          },
+          "users": {
+            "unknown": 2
+          },
+          "components": {
+            "state-hub.mcp": 2
+          }
+        },
+        "window": {
+          "calls": 0,
+          "tenant_count": 0,
+          "user_count": 0,
+          "component_count": 0,
+          "tenants": {},
+          "users": {},
+          "components": {}
+        },
+        "last_seen_at": "2026-07-10T13:20:42.374940Z",
+        "retirement_candidate": true,
+        "retirement_reason": "no measured usage in review window"
+      },
+      {
+        "interface": {
+          "id": "53c3372b-307d-4d6a-8ea4-bc36cacdcaf2",
+          "interface_key": "mcp:update_workstream",
+          "interface_kind": "mcp_tool",
+          "legacy_since": "2026-07-10T13:19:44.255216Z",
+          "replacement_ref": "update_workplan",
+          "owner_component": "state-hub.mcp",
+          "status": "legacy",
+          "replacement_verified": true,
+          "manual_hold": false,
+          "hold_reason": null,
+          "notes": "Registered by STATE-WP-0070 T03 \u2014 zero-window streak starts at registration",
+          "retired_at": null,
+          "created_at": "2026-07-10T13:19:44.255216Z",
+          "updated_at": "2026-07-10T13:19:44.255216Z"
+        },
+        "all_time": {
+          "calls": 0,
+          "tenant_count": 0,
+          "user_count": 0,
+          "component_count": 0,
+          "tenants": {},
+          "users": {},
+          "components": {}
+        },
+        "window": {
+          "calls": 0,
+          "tenant_count": 0,
+          "user_count": 0,
+          "component_count": 0,
+          "tenants": {},
+          "users": {},
+          "components": {}
+        },
+        "last_seen_at": null,
+        "retirement_candidate": true,
+        "retirement_reason": "no measured usage in review window"
+      },
+      {
+        "interface": {
+          "id": "bed4d08a-3471-48f5-9f0e-f9d550383a26",
+          "interface_key": "mcp:update_workstream_status",
+          "interface_kind": "mcp_tool",
+          "legacy_since": "2026-07-10T13:19:44.303612Z",
+          "replacement_ref": "update_workplan_status",
+          "owner_component": "state-hub.mcp",
+          "status": "legacy",
+          "replacement_verified": true,
+          "manual_hold": false,
+          "hold_reason": null,
+          "notes": "Registered by STATE-WP-0070 T03 \u2014 zero-window streak starts at registration",
+          "retired_at": null,
+          "created_at": "2026-07-10T13:19:44.303612Z",
+          "updated_at": "2026-07-10T13:19:44.303612Z"
+        },
+        "all_time": {
+          "calls": 0,
+          "tenant_count": 0,
+          "user_count": 0,
+          "component_count": 0,
+          "tenants": {},
+          "users": {},
+          "components": {}
+        },
+        "window": {
+          "calls": 0,
+          "tenant_count": 0,
+          "user_count": 0,
+          "component_count": 0,
+          "tenants": {},
+          "users": {},
+          "components": {}
+        },
+        "last_seen_at": null,
+        "retirement_candidate": true,
+        "retirement_reason": "no measured usage in review window"
+      },
+      {
+        "interface": {
+          "id": "46900dc2-0893-405b-ba59-80f31fb6ebb1",
+          "interface_key": "state://workstreams/{topic_slug}",
+          "interface_kind": "mcp_tool",
+          "legacy_since": "2026-07-10T13:19:44.344493Z",
+          "replacement_ref": "state://workplans/{topic_slug}",
+          "owner_component": "state-hub.mcp",
+          "status": "legacy",
+          "replacement_verified": true,
+          "manual_hold": false,
+          "hold_reason": null,
+          "notes": "Registered by STATE-WP-0070 T03 \u2014 zero-window streak starts at registration",
+          "retired_at": null,
+          "created_at": "2026-07-10T13:19:44.344493Z",
+          "updated_at": "2026-07-10T13:19:44.344493Z"
+        },
+        "all_time": {
+          "calls": 1,
+          "tenant_count": 1,
+          "user_count": 1,
+          "component_count": 1,
+          "tenants": {
+            "unknown": 1
+          },
+          "users": {
+            "unknown": 1
+          },
+          "components": {
+            "state-hub.mcp": 1
+          }
+        },
+        "window": {
+          "calls": 0,
+          "tenant_count": 0,
+          "user_count": 0,
+          "component_count": 0,
+          "tenants": {},
+          "users": {},
+          "components": {}
+        },
+        "last_seen_at": "2026-07-10T13:20:34.491811Z",
+        "retirement_candidate": true,
+        "retirement_reason": "no measured usage in review window"
+      },
+      {
+        "interface": {
+          "id": "cd9342fd-27e7-4a46-a1be-d41499e106a3",
+          "interface_key": "rest_api:DELETE /workstreams/{workstream_id}",
+          "interface_kind": "rest_api",
+          "legacy_since": "2026-06-06T17:28:13.052813Z",
+          "replacement_ref": "/workplans/{workplan_id}",
+          "owner_component": "state-hub.api",
+          "status": "legacy",
+          "replacement_verified": true,
+          "manual_hold": false,
+          "hold_reason": null,
+          "notes": null,
+          "retired_at": null,
+          "created_at": "2026-06-06T17:28:13.052813Z",
+          "updated_at": "2026-06-06T17:28:13.052813Z"
+        },
+        "all_time": {
+          "calls": 1,
+          "tenant_count": 1,
+          "user_count": 1,
+          "component_count": 1,
+          "tenants": {
+            "unknown": 1
+          },
+          "users": {
+            "unknown": 1
+          },
+          "components": {
+            "unknown": 1
+          }
+        },
+        "window": {
+          "calls": 0,
+          "tenant_count": 0,
+          "user_count": 0,
+          "component_count": 0,
+          "tenants": {},
+          "users": {},
+          "components": {}
+        },
+        "last_seen_at": "2026-06-06T17:28:13.047529Z",
+        "retirement_candidate": true,
+        "retirement_reason": "no measured usage in review window"
+      },
+      {
+        "interface": {
+          "id": "a4e0948c-cd4a-461e-8ae2-7fd7b51d04a7",
+          "interface_key": "rest_api:GET /decisions/?workstream_id",
+          "interface_kind": "rest_api",
+          "legacy_since": "2026-07-09T23:07:53.093223Z",
+          "replacement_ref": "/decisions/?workplan_id=<workplan_id>",
+          "owner_component": "state-hub.api",
+          "status": "legacy",
+          "replacement_verified": true,
+          "manual_hold": false,
+          "hold_reason": null,
+          "notes": null,
+          "retired_at": null,
+          "created_at": "2026-07-09T23:07:53.093223Z",
+          "updated_at": "2026-07-09T23:07:53.093223Z"
+        },
+        "all_time": {
+          "calls": 1,
+          "tenant_count": 1,
+          "user_count": 1,
+          "component_count": 1,
+          "tenants": {
+            "unknown": 1
+          },
+          "users": {
+            "unknown": 1
+          },
+          "components": {
+            "unknown": 1
+          }
+        },
+        "window": {
+          "calls": 0,
+          "tenant_count": 0,
+          "user_count": 0,
+          "component_count": 0,
+          "tenants": {},
+          "users": {},
+          "components": {}
+        },
+        "last_seen_at": "2026-07-09T23:07:53.083299Z",
+        "retirement_candidate": true,
+        "retirement_reason": "no measured usage in review window"
+      },
+      {
+        "interface": {
+          "id": "70a9346e-e0ee-42ac-874f-f160580b54dd",
+          "interface_key": "rest_api:GET /progress/?workstream_id",
+          "interface_kind": "rest_api",
+          "legacy_since": "2026-07-13T22:04:03.911449Z",
+          "replacement_ref": "/progress/?workplan_id=<workplan_id>",
+          "owner_component": "state-hub.api",
+          "status": "legacy",
+          "replacement_verified": true,
+          "manual_hold": false,
+          "hold_reason": null,
+          "notes": null,
+          "retired_at": null,
+          "created_at": "2026-07-13T22:04:03.911449Z",
+          "updated_at": "2026-07-13T22:04:03.911449Z"
+        },
+        "all_time": {
+          "calls": 1,
+          "tenant_count": 1,
+          "user_count": 1,
+          "component_count": 1,
+          "tenants": {
+            "unknown": 1
+          },
+          "users": {
+            "unknown": 1
+          },
+          "components": {
+            "unknown": 1
+          }
+        },
+        "window": {
+          "calls": 0,
+          "tenant_count": 0,
+          "user_count": 0,
+          "component_count": 0,
+          "tenants": {},
+          "users": {},
+          "components": {}
+        },
+        "last_seen_at": "2026-07-13T22:04:03.904998Z",
+        "retirement_candidate": true,
+        "retirement_reason": "no measured usage in review window"
+      },
+      {
+        "interface": {
+          "id": "be3cdcf8-250b-4bf0-801f-02ffd5f57e00",
+          "interface_key": "rest_api:GET /tasks/?workstream_id",
+          "interface_kind": "rest_api",
+          "legacy_since": "2026-07-08T19:32:21.628513Z",
+          "replacement_ref": "/tasks/?workplan_id=<workplan_id>",
+          "owner_component": "state-hub.api",
+          "status": "legacy",
+          "replacement_verified": true,
+          "manual_hold": false,
+          "hold_reason": null,
+          "notes": null,
+          "retired_at": null,
+          "created_at": "2026-07-08T19:32:21.628513Z",
+          "updated_at": "2026-07-08T19:32:21.628513Z"
+        },
+        "all_time": {
+          "calls": 589,
+          "tenant_count": 1,
+          "user_count": 1,
+          "component_count": 1,
+          "tenants": {
+            "unknown": 589
+          },
+          "users": {
+            "unknown": 589
+          },
+          "components": {
+            "unknown": 589
+          }
+        },
+        "window": {
+          "calls": 0,
+          "tenant_count": 0,
+          "user_count": 0,
+          "component_count": 0,
+          "tenants": {},
+          "users": {},
+          "components": {}
+        },
+        "last_seen_at": "2026-07-31T16:25:32.181901Z",
+        "retirement_candidate": true,
+        "retirement_reason": "no measured usage in review window"
+      },
+      {
+        "interface": {
+          "id": "3e4a3d0b-08fa-45c3-91e2-4f514a914b97",
+          "interface_key": "rest_api:GET /workstreams/",
+          "interface_kind": "rest_api",
+          "legacy_since": "2026-06-04T00:26:14.533764Z",
+          "replacement_ref": "/workplans/",
+          "owner_component": "state-hub.api",
+          "status": "legacy",
+          "replacement_verified": true,
+          "manual_hold": false,
+          "hold_reason": null,
+          "notes": null,
+          "retired_at": null,
+          "created_at": "2026-06-04T00:26:14.533764Z",
+          "updated_at": "2026-06-04T00:26:14.533764Z"
+        },
+        "all_time": {
+          "calls": 144086,
+          "tenant_count": 1,
+          "user_count": 1,
+          "component_count": 1,
+          "tenants": {
+            "unknown": 144086
+          },
+          "users": {
+            "unknown": 144086
+          },
+          "components": {
+            "unknown": 144086
+          }
+        },
+        "window": {
+          "calls": 0,
+          "tenant_count": 0,
+          "user_count": 0,
+          "component_count": 0,
+          "tenants": {},
+          "users": {},
+          "components": {}
+        },
+        "last_seen_at": "2026-08-10T18:06:05.032338Z",
+        "retirement_candidate": true,
+        "retirement_reason": "no measured usage in review window"
+      },
+      {
+        "interface": {
+          "id": "e4c140ec-7479-46f9-b185-4b533f19d639",
+          "interface_key": "rest_api:GET /workstreams/workplan-index",
+          "interface_kind": "rest_api",
+          "legacy_since": "2026-06-04T05:20:58.321869Z",
+          "replacement_ref": "/workplans/index",
+          "owner_component": "state-hub.api",
+          "status": "legacy",
+          "replacement_verified": true,
+          "manual_hold": false,
+          "hold_reason": null,
+          "notes": null,
+          "retired_at": null,
+          "created_at": "2026-06-04T05:20:58.321869Z",
+          "updated_at": "2026-06-04T05:20:58.321869Z"
+        },
+        "all_time": {
+          "calls": 30,
+          "tenant_count": 1,
+          "user_count": 1,
+          "component_count": 1,
+          "tenants": {
+            "unknown": 30
+          },
+          "users": {
+            "unknown": 30
+          },
+          "components": {
+            "unknown": 30
+          }
+        },
+        "window": {
+          "calls": 0,
+          "tenant_count": 0,
+          "user_count": 0,
+          "component_count": 0,
+          "tenants": {},
+          "users": {},
+          "components": {}
+        },
+        "last_seen_at": "2026-07-03T05:20:34.534439Z",
+        "retirement_candidate": true,
+        "retirement_reason": "no measured usage in review window"
+      },
+      {
+        "interface": {
+          "id": "3a00b19e-e7db-4403-98aa-a77c9ab61ecc",
+          "interface_key": "rest_api:GET /workstreams/{workstream_id}",
+          "interface_kind": "rest_api",
+          "legacy_since": "2026-06-04T00:25:59.014966Z",
+          "replacement_ref": "/workplans/{workplan_id}",
+          "owner_component": "state-hub.api",
+          "status": "legacy",
+          "replacement_verified": true,
+          "manual_hold": false,
+          "hold_reason": null,
+          "notes": null,
+          "retired_at": null,
+          "created_at": "2026-06-04T00:25:59.014966Z",
+          "updated_at": "2026-06-04T00:25:59.014966Z"
+        },
+        "all_time": {
+          "calls": 511406,
+          "tenant_count": 1,
+          "user_count": 1,
+          "component_count": 1,
+          "tenants": {
+            "unknown": 511406
+          },
+          "users": {
+            "unknown": 511406
+          },
+          "components": {
+            "unknown": 511406
+          }
+        },
+        "window": {
+          "calls": 0,
+          "tenant_count": 0,
+          "user_count": 0,
+          "component_count": 0,
+          "tenants": {},
+          "users": {},
+          "components": {}
+        },
+        "last_seen_at": "2026-07-31T16:25:32.004042Z",
+        "retirement_candidate": true,
+        "retirement_reason": "no measured usage in review window"
+      },
+      {
+        "interface": {
+          "id": "69e1a255-a8b9-4101-8a68-b1bed23abfda",
+          "interface_key": "rest_api:GET /workstreams/{workstream_id}/dependencies/",
+          "interface_kind": "rest_api",
+          "legacy_since": "2026-06-04T00:25:59.291135Z",
+          "replacement_ref": "/workplans/{workplan_id}/dependencies/",
+          "owner_component": "state-hub.api",
+          "status": "legacy",
+          "replacement_verified": true,
+          "manual_hold": false,
+          "hold_reason": null,
+          "notes": null,
+          "retired_at": null,
+          "created_at": "2026-06-04T00:25:59.291135Z",
+          "updated_at": "2026-06-04T00:25:59.291135Z"
+        },
+        "all_time": {
+          "calls": 255865,
+          "tenant_count": 1,
+          "user_count": 1,
+          "component_count": 1,
+          "tenants": {
+            "unknown": 255865
+          },
+          "users": {
+            "unknown": 255865
+          },
+          "components": {
+            "unknown": 255865
+          }
+        },
+        "window": {
+          "calls": 0,
+          "tenant_count": 0,
+          "user_count": 0,
+          "component_count": 0,
+          "tenants": {},
+          "users": {},
+          "components": {}
+        },
+        "last_seen_at": "2026-07-08T21:14:12.747005Z",
+        "retirement_candidate": true,
+        "retirement_reason": "no measured usage in review window"
+      },
+      {
+        "interface": {
+          "id": "b1aae931-b51f-4a85-a723-865dd65f6132",
+          "interface_key": "rest_api:PATCH /workstreams/{workstream_id}",
+          "interface_kind": "rest_api",
+          "legacy_since": "2026-06-04T06:09:41.901035Z",
+          "replacement_ref": "/workplans/{workplan_id}",
+          "owner_component": "state-hub.api",
+          "status": "legacy",
+          "replacement_verified": true,
+          "manual_hold": false,
+          "hold_reason": null,
+          "notes": null,
+          "retired_at": null,
+          "created_at": "2026-06-04T06:09:41.901035Z",
+          "updated_at": "2026-06-04T06:09:41.901035Z"
+        },
+        "all_time": {
+          "calls": 571,
+          "tenant_count": 1,
+          "user_count": 1,
+          "component_count": 1,
+          "tenants": {
+            "unknown": 571
+          },
+          "users": {
+            "unknown": 571
+          },
+          "components": {
+            "unknown": 571
+          }
+        },
+        "window": {
+          "calls": 0,
+          "tenant_count": 0,
+          "user_count": 0,
+          "component_count": 0,
+          "tenants": {},
+          "users": {},
+          "components": {}
+        },
+        "last_seen_at": "2026-07-08T20:49:12.335710Z",
+        "retirement_candidate": true,
+        "retirement_reason": "no measured usage in review window"
+      },
+      {
+        "interface": {
+          "id": "4aea9591-970b-4918-ac4a-4da95a0a1a8c",
+          "interface_key": "rest_api:POST /decisions/ workstream_id",
+          "interface_kind": "rest_api",
+          "legacy_since": "2026-07-09T22:56:35.473130Z",
+          "replacement_ref": "POST /decisions/ with workplan_id",
+          "owner_component": "state-hub.api",
+          "status": "legacy",
+          "replacement_verified": true,
+          "manual_hold": false,
+          "hold_reason": null,
+          "notes": null,
+          "retired_at": null,
+          "created_at": "2026-07-09T22:56:35.473130Z",
+          "updated_at": "2026-07-09T22:56:35.473130Z"
+        },
+        "all_time": {
+          "calls": 3,
+          "tenant_count": 1,
+          "user_count": 1,
+          "component_count": 1,
+          "tenants": {
+            "unknown": 3
+          },
+          "users": {
+            "unknown": 3
+          },
+          "components": {
+            "unknown": 3
+          }
+        },
+        "window": {
+          "calls": 0,
+          "tenant_count": 0,
+          "user_count": 0,
+          "component_count": 0,
+          "tenants": {},
+          "users": {},
+          "components": {}
+        },
+        "last_seen_at": "2026-07-09T22:57:05.912456Z",
+        "retirement_candidate": true,
+        "retirement_reason": "no measured usage in review window"
+      },
+      {
+        "interface": {
+          "id": "4a70583c-1e41-4ec1-99a9-728856a7d79c",
+          "interface_key": "rest_api:POST /progress/ workstream_id",
+          "interface_kind": "rest_api",
+          "legacy_since": "2026-07-08T23:35:09.148333Z",
+          "replacement_ref": "POST /progress/ with workplan_id",
+          "owner_component": "state-hub.api",
+          "status": "legacy",
+          "replacement_verified": true,
+          "manual_hold": false,
+          "hold_reason": null,
+          "notes": null,
+          "retired_at": null,
+          "created_at": "2026-07-08T23:35:09.148333Z",
+          "updated_at": "2026-07-08T23:35:09.148333Z"
+        },
+        "all_time": {
+          "calls": 14,
+          "tenant_count": 1,
+          "user_count": 1,
+          "component_count": 1,
+          "tenants": {
+            "unknown": 14
+          },
+          "users": {
+            "unknown": 14
+          },
+          "components": {
+            "unknown": 14
+          }
+        },
+        "window": {
+          "calls": 0,
+          "tenant_count": 0,
+          "user_count": 0,
+          "component_count": 0,
+          "tenants": {},
+          "users": {},
+          "components": {}
+        },
+        "last_seen_at": "2026-07-10T08:34:42.959724Z",
+        "retirement_candidate": true,
+        "retirement_reason": "no measured usage in review window"
+      },
+      {
+        "interface": {
+          "id": "6df4e443-7bf1-461a-923b-a6eb52fe7b07",
+          "interface_key": "rest_api:POST /tasks/ workstream_id",
+          "interface_kind": "rest_api",
+          "legacy_since": "2026-07-08T22:38:29.405720Z",
+          "replacement_ref": "POST /tasks/ with workplan_id",
+          "owner_component": "state-hub.api",
+          "status": "legacy",
+          "replacement_verified": true,
+          "manual_hold": false,
+          "hold_reason": null,
+          "notes": null,
+          "retired_at": null,
+          "created_at": "2026-07-08T22:38:29.405720Z",
+          "updated_at": "2026-07-08T22:38:29.405720Z"
+        },
+        "all_time": {
+          "calls": 5,
+          "tenant_count": 1,
+          "user_count": 1,
+          "component_count": 1,
+          "tenants": {
+            "unknown": 5
+          },
+          "users": {
+            "unknown": 5
+          },
+          "components": {
+            "state-hub.fix-consistency": 5
+          }
+        },
+        "window": {
+          "calls": 0,
+          "tenant_count": 0,
+          "user_count": 0,
+          "component_count": 0,
+          "tenants": {},
+          "users": {},
+          "components": {}
+        },
+        "last_seen_at": "2026-07-08T22:38:29.976918Z",
+        "retirement_candidate": true,
+        "retirement_reason": "no measured usage in review window"
+      },
+      {
+        "interface": {
+          "id": "ed6451c9-d2cc-4486-9afe-d3852782cabc",
+          "interface_key": "rest_api:POST /workstreams/",
+          "interface_kind": "rest_api",
+          "legacy_since": "2026-06-04T07:40:24.168535Z",
+          "replacement_ref": "/workplans/",
+          "owner_component": "state-hub.api",
+          "status": "legacy",
+          "replacement_verified": true,
+          "manual_hold": false,
+          "hold_reason": null,
+          "notes": null,
+          "retired_at": null,
+          "created_at": "2026-06-04T07:40:24.168535Z",
+          "updated_at": "2026-06-04T07:40:24.168535Z"
+        },
+        "all_time": {
+          "calls": 824,
+          "tenant_count": 1,
+          "user_count": 1,
+          "component_count": 1,
+          "tenants": {
+            "unknown": 824
+          },
+          "users": {
+            "unknown": 824
+          },
+          "components": {
+            "unknown": 824
+          }
+        },
+        "window": {
+          "calls": 0,
+          "tenant_count": 0,
+          "user_count": 0,
+          "component_count": 0,
+          "tenants": {},
+          "users": {},
+          "components": {}
+        },
+        "last_seen_at": "2026-07-08T20:38:05.903144Z",
+        "retirement_candidate": true,
+        "retirement_reason": "no measured usage in review window"
+      },
+      {
+        "interface": {
+          "id": "281fd706-b192-4194-8055-2d8733c115f9",
+          "interface_key": "rest_api:POST /workstreams/{workstream_id}/dependencies/",
+          "interface_kind": "rest_api",
+          "legacy_since": "2026-06-04T22:57:37.149207Z",
+          "replacement_ref": "/workplans/{workplan_id}/dependencies/",
+          "owner_component": "state-hub.api",
+          "status": "legacy",
+          "replacement_verified": true,
+          "manual_hold": false,
+          "hold_reason": null,
+          "notes": null,
+          "retired_at": null,
+          "created_at": "2026-06-04T22:57:37.149207Z",
+          "updated_at": "2026-06-04T22:57:37.149207Z"
+        },
+        "all_time": {
+          "calls": 4971,
+          "tenant_count": 1,
+          "user_count": 1,
+          "component_count": 1,
+          "tenants": {
+            "unknown": 4971
+          },
+          "users": {
+            "unknown": 4971
+          },
+          "components": {
+            "unknown": 4971
+          }
+        },
+        "window": {
+          "calls": 0,
+          "tenant_count": 0,
+          "user_count": 0,
+          "component_count": 0,
+          "tenants": {},
+          "users": {},
+          "components": {}
+        },
+        "last_seen_at": "2026-07-01T22:09:24.229011Z",
+        "retirement_candidate": true,
+        "retirement_reason": "no measured usage in review window"
+      }
+    ]
+  },
+  "hours": 8
+}
diff --git a/docs/evidence/legacy-meter-weekly-review-20260812.json b/docs/evidence/legacy-meter-weekly-review-20260812.json
new file mode 100644
index 0000000..02bab7c
--- /dev/null
+++ b/docs/evidence/legacy-meter-weekly-review-20260812.json
@@ -0,0 +1,1677 @@
+{
+  "captured_at": "2026-08-12T14:00:07.903081+00:00",
+  "api_base": "http://127.0.0.1:8000",
+  "workplan": "STATE-WP-0070",
+  "retired_interfaces": [],
+  "weekly_review": {
+    "generated_at": "2026-08-12T14:00:07.896335Z",
+    "window_start": "2026-08-12T06:00:07.827280Z",
+    "window_end": "2026-08-12T14:00:07.827280Z",
+    "cadence": "weekly",
+    "activity_core_handoff": {
+      "activity_id": "statehub-legacy-interface-review",
+      "cadence": "weekly",
+      "source_endpoint": "/legacy-meter/weekly-review",
+      "state_owner": "state-hub",
+      "scheduler_owner": "activity-core"
+    },
+    "interfaces": [
+      {
+        "interface": {
+          "id": "8051fb40-66c9-4dc4-a413-13e8573e04a3",
+          "interface_key": "event_subject:org.statehub.workstream.completed",
+          "interface_kind": "event_subject",
+          "legacy_since": "2026-06-04T06:09:42.198193Z",
+          "replacement_ref": "org.statehub.workplan.completed",
+          "owner_component": "state-hub.events",
+          "status": "retired",
+          "replacement_verified": true,
+          "manual_hold": false,
+          "hold_reason": null,
+          "notes": "Retired by STATE-WP-0069 closeout",
+          "retired_at": "2026-07-08T21:38:52.773601Z",
+          "created_at": "2026-06-04T06:09:42.198193Z",
+          "updated_at": "2026-07-08T21:38:52.761243Z"
+        },
+        "all_time": {
+          "calls": 255,
+          "tenant_count": 1,
+          "user_count": 1,
+          "component_count": 1,
+          "tenants": {
+            "unknown": 255
+          },
+          "users": {
+            "unknown": 255
+          },
+          "components": {
+            "state-hub.events": 255
+          }
+        },
+        "window": {
+          "calls": 0,
+          "tenant_count": 0,
+          "user_count": 0,
+          "component_count": 0,
+          "tenants": {},
+          "users": {},
+          "components": {}
+        },
+        "last_seen_at": "2026-07-08T20:49:12.839383Z",
+        "retirement_candidate": false,
+        "retirement_reason": "already retired"
+      },
+      {
+        "interface": {
+          "id": "63ed90e3-42b4-431a-94db-e1254a52f9e2",
+          "interface_key": "mcp:create_workstream",
+          "interface_kind": "mcp_tool",
+          "legacy_since": "2026-07-10T13:19:44.205900Z",
+          "replacement_ref": "create_workplan",
+          "owner_component": "state-hub.mcp",
+          "status": "legacy",
+          "replacement_verified": true,
+          "manual_hold": false,
+          "hold_reason": null,
+          "notes": "Registered by STATE-WP-0070 T03 \u2014 zero-window streak starts at registration",
+          "retired_at": null,
+          "created_at": "2026-07-10T13:19:44.205900Z",
+          "updated_at": "2026-07-10T13:19:44.205900Z"
+        },
+        "all_time": {
+          "calls": 2,
+          "tenant_count": 1,
+          "user_count": 1,
+          "component_count": 1,
+          "tenants": {
+            "unknown": 2
+          },
+          "users": {
+            "unknown": 2
+          },
+          "components": {
+            "state-hub.mcp": 2
+          }
+        },
+        "window": {
+          "calls": 0,
+          "tenant_count": 0,
+          "user_count": 0,
+          "component_count": 0,
+          "tenants": {},
+          "users": {},
+          "components": {}
+        },
+        "last_seen_at": "2026-07-10T13:20:43.378546Z",
+        "retirement_candidate": true,
+        "retirement_reason": "no measured usage in review window"
+      },
+      {
+        "interface": {
+          "id": "b6a5fe44-fb85-4ef7-a273-78d09da777af",
+          "interface_key": "mcp:list_workstreams",
+          "interface_kind": "mcp_tool",
+          "legacy_since": "2026-07-10T13:19:26.075491Z",
+          "replacement_ref": "list_workplans",
+          "owner_component": "state-hub.mcp",
+          "status": "legacy",
+          "replacement_verified": true,
+          "manual_hold": false,
+          "hold_reason": null,
+          "notes": null,
+          "retired_at": null,
+          "created_at": "2026-07-10T13:19:26.075491Z",
+          "updated_at": "2026-07-10T13:19:26.075491Z"
+        },
+        "all_time": {
+          "calls": 2,
+          "tenant_count": 1,
+          "user_count": 1,
+          "component_count": 1,
+          "tenants": {
+            "unknown": 2
+          },
+          "users": {
+            "unknown": 2
+          },
+          "components": {
+            "state-hub.mcp": 2
+          }
+        },
+        "window": {
+          "calls": 0,
+          "tenant_count": 0,
+          "user_count": 0,
+          "component_count": 0,
+          "tenants": {},
+          "users": {},
+          "components": {}
+        },
+        "last_seen_at": "2026-07-10T13:20:42.374940Z",
+        "retirement_candidate": true,
+        "retirement_reason": "no measured usage in review window"
+      },
+      {
+        "interface": {
+          "id": "53c3372b-307d-4d6a-8ea4-bc36cacdcaf2",
+          "interface_key": "mcp:update_workstream",
+          "interface_kind": "mcp_tool",
+          "legacy_since": "2026-07-10T13:19:44.255216Z",
+          "replacement_ref": "update_workplan",
+          "owner_component": "state-hub.mcp",
+          "status": "legacy",
+          "replacement_verified": true,
+          "manual_hold": false,
+          "hold_reason": null,
+          "notes": "Registered by STATE-WP-0070 T03 \u2014 zero-window streak starts at registration",
+          "retired_at": null,
+          "created_at": "2026-07-10T13:19:44.255216Z",
+          "updated_at": "2026-07-10T13:19:44.255216Z"
+        },
+        "all_time": {
+          "calls": 0,
+          "tenant_count": 0,
+          "user_count": 0,
+          "component_count": 0,
+          "tenants": {},
+          "users": {},
+          "components": {}
+        },
+        "window": {
+          "calls": 0,
+          "tenant_count": 0,
+          "user_count": 0,
+          "component_count": 0,
+          "tenants": {},
+          "users": {},
+          "components": {}
+        },
+        "last_seen_at": null,
+        "retirement_candidate": true,
+        "retirement_reason": "no measured usage in review window"
+      },
+      {
+        "interface": {
+          "id": "bed4d08a-3471-48f5-9f0e-f9d550383a26",
+          "interface_key": "mcp:update_workstream_status",
+          "interface_kind": "mcp_tool",
+          "legacy_since": "2026-07-10T13:19:44.303612Z",
+          "replacement_ref": "update_workplan_status",
+          "owner_component": "state-hub.mcp",
+          "status": "legacy",
+          "replacement_verified": true,
+          "manual_hold": false,
+          "hold_reason": null,
+          "notes": "Registered by STATE-WP-0070 T03 \u2014 zero-window streak starts at registration",
+          "retired_at": null,
+          "created_at": "2026-07-10T13:19:44.303612Z",
+          "updated_at": "2026-07-10T13:19:44.303612Z"
+        },
+        "all_time": {
+          "calls": 0,
+          "tenant_count": 0,
+          "user_count": 0,
+          "component_count": 0,
+          "tenants": {},
+          "users": {},
+          "components": {}
+        },
+        "window": {
+          "calls": 0,
+          "tenant_count": 0,
+          "user_count": 0,
+          "component_count": 0,
+          "tenants": {},
+          "users": {},
+          "components": {}
+        },
+        "last_seen_at": null,
+        "retirement_candidate": true,
+        "retirement_reason": "no measured usage in review window"
+      },
+      {
+        "interface": {
+          "id": "46900dc2-0893-405b-ba59-80f31fb6ebb1",
+          "interface_key": "state://workstreams/{topic_slug}",
+          "interface_kind": "mcp_tool",
+          "legacy_since": "2026-07-10T13:19:44.344493Z",
+          "replacement_ref": "state://workplans/{topic_slug}",
+          "owner_component": "state-hub.mcp",
+          "status": "legacy",
+          "replacement_verified": true,
+          "manual_hold": false,
+          "hold_reason": null,
+          "notes": "Registered by STATE-WP-0070 T03 \u2014 zero-window streak starts at registration",
+          "retired_at": null,
+          "created_at": "2026-07-10T13:19:44.344493Z",
+          "updated_at": "2026-07-10T13:19:44.344493Z"
+        },
+        "all_time": {
+          "calls": 1,
+          "tenant_count": 1,
+          "user_count": 1,
+          "component_count": 1,
+          "tenants": {
+            "unknown": 1
+          },
+          "users": {
+            "unknown": 1
+          },
+          "components": {
+            "state-hub.mcp": 1
+          }
+        },
+        "window": {
+          "calls": 0,
+          "tenant_count": 0,
+          "user_count": 0,
+          "component_count": 0,
+          "tenants": {},
+          "users": {},
+          "components": {}
+        },
+        "last_seen_at": "2026-07-10T13:20:34.491811Z",
+        "retirement_candidate": true,
+        "retirement_reason": "no measured usage in review window"
+      },
+      {
+        "interface": {
+          "id": "cd9342fd-27e7-4a46-a1be-d41499e106a3",
+          "interface_key": "rest_api:DELETE /workstreams/{workstream_id}",
+          "interface_kind": "rest_api",
+          "legacy_since": "2026-06-06T17:28:13.052813Z",
+          "replacement_ref": "/workplans/{workplan_id}",
+          "owner_component": "state-hub.api",
+          "status": "legacy",
+          "replacement_verified": true,
+          "manual_hold": false,
+          "hold_reason": null,
+          "notes": null,
+          "retired_at": null,
+          "created_at": "2026-06-06T17:28:13.052813Z",
+          "updated_at": "2026-06-06T17:28:13.052813Z"
+        },
+        "all_time": {
+          "calls": 1,
+          "tenant_count": 1,
+          "user_count": 1,
+          "component_count": 1,
+          "tenants": {
+            "unknown": 1
+          },
+          "users": {
+            "unknown": 1
+          },
+          "components": {
+            "unknown": 1
+          }
+        },
+        "window": {
+          "calls": 0,
+          "tenant_count": 0,
+          "user_count": 0,
+          "component_count": 0,
+          "tenants": {},
+          "users": {},
+          "components": {}
+        },
+        "last_seen_at": "2026-06-06T17:28:13.047529Z",
+        "retirement_candidate": true,
+        "retirement_reason": "no measured usage in review window"
+      },
+      {
+        "interface": {
+          "id": "a4e0948c-cd4a-461e-8ae2-7fd7b51d04a7",
+          "interface_key": "rest_api:GET /decisions/?workstream_id",
+          "interface_kind": "rest_api",
+          "legacy_since": "2026-07-09T23:07:53.093223Z",
+          "replacement_ref": "/decisions/?workplan_id=<workplan_id>",
+          "owner_component": "state-hub.api",
+          "status": "legacy",
+          "replacement_verified": true,
+          "manual_hold": false,
+          "hold_reason": null,
+          "notes": null,
+          "retired_at": null,
+          "created_at": "2026-07-09T23:07:53.093223Z",
+          "updated_at": "2026-07-09T23:07:53.093223Z"
+        },
+        "all_time": {
+          "calls": 1,
+          "tenant_count": 1,
+          "user_count": 1,
+          "component_count": 1,
+          "tenants": {
+            "unknown": 1
+          },
+          "users": {
+            "unknown": 1
+          },
+          "components": {
+            "unknown": 1
+          }
+        },
+        "window": {
+          "calls": 0,
+          "tenant_count": 0,
+          "user_count": 0,
+          "component_count": 0,
+          "tenants": {},
+          "users": {},
+          "components": {}
+        },
+        "last_seen_at": "2026-07-09T23:07:53.083299Z",
+        "retirement_candidate": true,
+        "retirement_reason": "no measured usage in review window"
+      },
+      {
+        "interface": {
+          "id": "70a9346e-e0ee-42ac-874f-f160580b54dd",
+          "interface_key": "rest_api:GET /progress/?workstream_id",
+          "interface_kind": "rest_api",
+          "legacy_since": "2026-07-13T22:04:03.911449Z",
+          "replacement_ref": "/progress/?workplan_id=<workplan_id>",
+          "owner_component": "state-hub.api",
+          "status": "legacy",
+          "replacement_verified": true,
+          "manual_hold": false,
+          "hold_reason": null,
+          "notes": null,
+          "retired_at": null,
+          "created_at": "2026-07-13T22:04:03.911449Z",
+          "updated_at": "2026-07-13T22:04:03.911449Z"
+        },
+        "all_time": {
+          "calls": 2,
+          "tenant_count": 1,
+          "user_count": 1,
+          "component_count": 1,
+          "tenants": {
+            "unknown": 2
+          },
+          "users": {
+            "unknown": 2
+          },
+          "components": {
+            "unknown": 2
+          }
+        },
+        "window": {
+          "calls": 1,
+          "tenant_count": 1,
+          "user_count": 1,
+          "component_count": 1,
+          "tenants": {
+            "unknown": 1
+          },
+          "users": {
+            "unknown": 1
+          },
+          "components": {
+            "unknown": 1
+          }
+        },
+        "last_seen_at": "2026-08-12T08:55:33.912995Z",
+        "retirement_candidate": false,
+        "retirement_reason": "1 call(s) in review window"
+      },
+      {
+        "interface": {
+          "id": "be3cdcf8-250b-4bf0-801f-02ffd5f57e00",
+          "interface_key": "rest_api:GET /tasks/?workstream_id",
+          "interface_kind": "rest_api",
+          "legacy_since": "2026-07-08T19:32:21.628513Z",
+          "replacement_ref": "/tasks/?workplan_id=<workplan_id>",
+          "owner_component": "state-hub.api",
+          "status": "legacy",
+          "replacement_verified": true,
+          "manual_hold": false,
+          "hold_reason": null,
+          "notes": null,
+          "retired_at": null,
+          "created_at": "2026-07-08T19:32:21.628513Z",
+          "updated_at": "2026-07-08T19:32:21.628513Z"
+        },
+        "all_time": {
+          "calls": 590,
+          "tenant_count": 1,
+          "user_count": 1,
+          "component_count": 1,
+          "tenants": {
+            "unknown": 590
+          },
+          "users": {
+            "unknown": 590
+          },
+          "components": {
+            "unknown": 590
+          }
+        },
+        "window": {
+          "calls": 1,
+          "tenant_count": 1,
+          "user_count": 1,
+          "component_count": 1,
+          "tenants": {
+            "unknown": 1
+          },
+          "users": {
+            "unknown": 1
+          },
+          "components": {
+            "unknown": 1
+          }
+        },
+        "last_seen_at": "2026-08-12T08:55:27.763102Z",
+        "retirement_candidate": false,
+        "retirement_reason": "1 call(s) in review window"
+      },
+      {
+        "interface": {
+          "id": "3e4a3d0b-08fa-45c3-91e2-4f514a914b97",
+          "interface_key": "rest_api:GET /workstreams/",
+          "interface_kind": "rest_api",
+          "legacy_since": "2026-06-04T00:26:14.533764Z",
+          "replacement_ref": "/workplans/",
+          "owner_component": "state-hub.api",
+          "status": "legacy",
+          "replacement_verified": true,
+          "manual_hold": false,
+          "hold_reason": null,
+          "notes": null,
+          "retired_at": null,
+          "created_at": "2026-06-04T00:26:14.533764Z",
+          "updated_at": "2026-06-04T00:26:14.533764Z"
+        },
+        "all_time": {
+          "calls": 144086,
+          "tenant_count": 1,
+          "user_count": 1,
+          "component_count": 1,
+          "tenants": {
+            "unknown": 144086
+          },
+          "users": {
+            "unknown": 144086
+          },
+          "components": {
+            "unknown": 144086
+          }
+        },
+        "window": {
+          "calls": 0,
+          "tenant_count": 0,
+          "user_count": 0,
+          "component_count": 0,
+          "tenants": {},
+          "users": {},
+          "components": {}
+        },
+        "last_seen_at": "2026-08-10T18:06:05.032338Z",
+        "retirement_candidate": true,
+        "retirement_reason": "no measured usage in review window"
+      },
+      {
+        "interface": {
+          "id": "e4c140ec-7479-46f9-b185-4b533f19d639",
+          "interface_key": "rest_api:GET /workstreams/workplan-index",
+          "interface_kind": "rest_api",
+          "legacy_since": "2026-06-04T05:20:58.321869Z",
+          "replacement_ref": "/workplans/index",
+          "owner_component": "state-hub.api",
+          "status": "legacy",
+          "replacement_verified": true,
+          "manual_hold": false,
+          "hold_reason": null,
+          "notes": null,
+          "retired_at": null,
+          "created_at": "2026-06-04T05:20:58.321869Z",
+          "updated_at": "2026-06-04T05:20:58.321869Z"
+        },
+        "all_time": {
+          "calls": 30,
+          "tenant_count": 1,
+          "user_count": 1,
+          "component_count": 1,
+          "tenants": {
+            "unknown": 30
+          },
+          "users": {
+            "unknown": 30
+          },
+          "components": {
+            "unknown": 30
+          }
+        },
+        "window": {
+          "calls": 0,
+          "tenant_count": 0,
+          "user_count": 0,
+          "component_count": 0,
+          "tenants": {},
+          "users": {},
+          "components": {}
+        },
+        "last_seen_at": "2026-07-03T05:20:34.534439Z",
+        "retirement_candidate": true,
+        "retirement_reason": "no measured usage in review window"
+      },
+      {
+        "interface": {
+          "id": "3a00b19e-e7db-4403-98aa-a77c9ab61ecc",
+          "interface_key": "rest_api:GET /workstreams/{workstream_id}",
+          "interface_kind": "rest_api",
+          "legacy_since": "2026-06-04T00:25:59.014966Z",
+          "replacement_ref": "/workplans/{workplan_id}",
+          "owner_component": "state-hub.api",
+          "status": "legacy",
+          "replacement_verified": true,
+          "manual_hold": false,
+          "hold_reason": null,
+          "notes": null,
+          "retired_at": null,
+          "created_at": "2026-06-04T00:25:59.014966Z",
+          "updated_at": "2026-06-04T00:25:59.014966Z"
+        },
+        "all_time": {
+          "calls": 511406,
+          "tenant_count": 1,
+          "user_count": 1,
+          "component_count": 1,
+          "tenants": {
+            "unknown": 511406
+          },
+          "users": {
+            "unknown": 511406
+          },
+          "components": {
+            "unknown": 511406
+          }
+        },
+        "window": {
+          "calls": 0,
+          "tenant_count": 0,
+          "user_count": 0,
+          "component_count": 0,
+          "tenants": {},
+          "users": {},
+          "components": {}
+        },
+        "last_seen_at": "2026-07-31T16:25:32.004042Z",
+        "retirement_candidate": true,
+        "retirement_reason": "no measured usage in review window"
+      },
+      {
+        "interface": {
+          "id": "69e1a255-a8b9-4101-8a68-b1bed23abfda",
+          "interface_key": "rest_api:GET /workstreams/{workstream_id}/dependencies/",
+          "interface_kind": "rest_api",
+          "legacy_since": "2026-06-04T00:25:59.291135Z",
+          "replacement_ref": "/workplans/{workplan_id}/dependencies/",
+          "owner_component": "state-hub.api",
+          "status": "legacy",
+          "replacement_verified": true,
+          "manual_hold": false,
+          "hold_reason": null,
+          "notes": null,
+          "retired_at": null,
+          "created_at": "2026-06-04T00:25:59.291135Z",
+          "updated_at": "2026-06-04T00:25:59.291135Z"
+        },
+        "all_time": {
+          "calls": 255865,
+          "tenant_count": 1,
+          "user_count": 1,
+          "component_count": 1,
+          "tenants": {
+            "unknown": 255865
+          },
+          "users": {
+            "unknown": 255865
+          },
+          "components": {
+            "unknown": 255865
+          }
+        },
+        "window": {
+          "calls": 0,
+          "tenant_count": 0,
+          "user_count": 0,
+          "component_count": 0,
+          "tenants": {},
+          "users": {},
+          "components": {}
+        },
+        "last_seen_at": "2026-07-08T21:14:12.747005Z",
+        "retirement_candidate": true,
+        "retirement_reason": "no measured usage in review window"
+      },
+      {
+        "interface": {
+          "id": "b1aae931-b51f-4a85-a723-865dd65f6132",
+          "interface_key": "rest_api:PATCH /workstreams/{workstream_id}",
+          "interface_kind": "rest_api",
+          "legacy_since": "2026-06-04T06:09:41.901035Z",
+          "replacement_ref": "/workplans/{workplan_id}",
+          "owner_component": "state-hub.api",
+          "status": "legacy",
+          "replacement_verified": true,
+          "manual_hold": false,
+          "hold_reason": null,
+          "notes": null,
+          "retired_at": null,
+          "created_at": "2026-06-04T06:09:41.901035Z",
+          "updated_at": "2026-06-04T06:09:41.901035Z"
+        },
+        "all_time": {
+          "calls": 571,
+          "tenant_count": 1,
+          "user_count": 1,
+          "component_count": 1,
+          "tenants": {
+            "unknown": 571
+          },
+          "users": {
+            "unknown": 571
+          },
+          "components": {
+            "unknown": 571
+          }
+        },
+        "window": {
+          "calls": 0,
+          "tenant_count": 0,
+          "user_count": 0,
+          "component_count": 0,
+          "tenants": {},
+          "users": {},
+          "components": {}
+        },
+        "last_seen_at": "2026-07-08T20:49:12.335710Z",
+        "retirement_candidate": true,
+        "retirement_reason": "no measured usage in review window"
+      },
+      {
+        "interface": {
+          "id": "4aea9591-970b-4918-ac4a-4da95a0a1a8c",
+          "interface_key": "rest_api:POST /decisions/ workstream_id",
+          "interface_kind": "rest_api",
+          "legacy_since": "2026-07-09T22:56:35.473130Z",
+          "replacement_ref": "POST /decisions/ with workplan_id",
+          "owner_component": "state-hub.api",
+          "status": "legacy",
+          "replacement_verified": true,
+          "manual_hold": false,
+          "hold_reason": null,
+          "notes": null,
+          "retired_at": null,
+          "created_at": "2026-07-09T22:56:35.473130Z",
+          "updated_at": "2026-07-09T22:56:35.473130Z"
+        },
+        "all_time": {
+          "calls": 3,
+          "tenant_count": 1,
+          "user_count": 1,
+          "component_count": 1,
+          "tenants": {
+            "unknown": 3
+          },
+          "users": {
+            "unknown": 3
+          },
+          "components": {
+            "unknown": 3
+          }
+        },
+        "window": {
+          "calls": 0,
+          "tenant_count": 0,
+          "user_count": 0,
+          "component_count": 0,
+          "tenants": {},
+          "users": {},
+          "components": {}
+        },
+        "last_seen_at": "2026-07-09T22:57:05.912456Z",
+        "retirement_candidate": true,
+        "retirement_reason": "no measured usage in review window"
+      },
+      {
+        "interface": {
+          "id": "4a70583c-1e41-4ec1-99a9-728856a7d79c",
+          "interface_key": "rest_api:POST /progress/ workstream_id",
+          "interface_kind": "rest_api",
+          "legacy_since": "2026-07-08T23:35:09.148333Z",
+          "replacement_ref": "POST /progress/ with workplan_id",
+          "owner_component": "state-hub.api",
+          "status": "legacy",
+          "replacement_verified": true,
+          "manual_hold": false,
+          "hold_reason": null,
+          "notes": null,
+          "retired_at": null,
+          "created_at": "2026-07-08T23:35:09.148333Z",
+          "updated_at": "2026-07-08T23:35:09.148333Z"
+        },
+        "all_time": {
+          "calls": 14,
+          "tenant_count": 1,
+          "user_count": 1,
+          "component_count": 1,
+          "tenants": {
+            "unknown": 14
+          },
+          "users": {
+            "unknown": 14
+          },
+          "components": {
+            "unknown": 14
+          }
+        },
+        "window": {
+          "calls": 0,
+          "tenant_count": 0,
+          "user_count": 0,
+          "component_count": 0,
+          "tenants": {},
+          "users": {},
+          "components": {}
+        },
+        "last_seen_at": "2026-07-10T08:34:42.959724Z",
+        "retirement_candidate": true,
+        "retirement_reason": "no measured usage in review window"
+      },
+      {
+        "interface": {
+          "id": "6df4e443-7bf1-461a-923b-a6eb52fe7b07",
+          "interface_key": "rest_api:POST /tasks/ workstream_id",
+          "interface_kind": "rest_api",
+          "legacy_since": "2026-07-08T22:38:29.405720Z",
+          "replacement_ref": "POST /tasks/ with workplan_id",
+          "owner_component": "state-hub.api",
+          "status": "legacy",
+          "replacement_verified": true,
+          "manual_hold": false,
+          "hold_reason": null,
+          "notes": null,
+          "retired_at": null,
+          "created_at": "2026-07-08T22:38:29.405720Z",
+          "updated_at": "2026-07-08T22:38:29.405720Z"
+        },
+        "all_time": {
+          "calls": 5,
+          "tenant_count": 1,
+          "user_count": 1,
+          "component_count": 1,
+          "tenants": {
+            "unknown": 5
+          },
+          "users": {
+            "unknown": 5
+          },
+          "components": {
+            "state-hub.fix-consistency": 5
+          }
+        },
+        "window": {
+          "calls": 0,
+          "tenant_count": 0,
+          "user_count": 0,
+          "component_count": 0,
+          "tenants": {},
+          "users": {},
+          "components": {}
+        },
+        "last_seen_at": "2026-07-08T22:38:29.976918Z",
+        "retirement_candidate": true,
+        "retirement_reason": "no measured usage in review window"
+      },
+      {
+        "interface": {
+          "id": "ed6451c9-d2cc-4486-9afe-d3852782cabc",
+          "interface_key": "rest_api:POST /workstreams/",
+          "interface_kind": "rest_api",
+          "legacy_since": "2026-06-04T07:40:24.168535Z",
+          "replacement_ref": "/workplans/",
+          "owner_component": "state-hub.api",
+          "status": "legacy",
+          "replacement_verified": true,
+          "manual_hold": false,
+          "hold_reason": null,
+          "notes": null,
+          "retired_at": null,
+          "created_at": "2026-06-04T07:40:24.168535Z",
+          "updated_at": "2026-06-04T07:40:24.168535Z"
+        },
+        "all_time": {
+          "calls": 824,
+          "tenant_count": 1,
+          "user_count": 1,
+          "component_count": 1,
+          "tenants": {
+            "unknown": 824
+          },
+          "users": {
+            "unknown": 824
+          },
+          "components": {
+            "unknown": 824
+          }
+        },
+        "window": {
+          "calls": 0,
+          "tenant_count": 0,
+          "user_count": 0,
+          "component_count": 0,
+          "tenants": {},
+          "users": {},
+          "components": {}
+        },
+        "last_seen_at": "2026-07-08T20:38:05.903144Z",
+        "retirement_candidate": true,
+        "retirement_reason": "no measured usage in review window"
+      },
+      {
+        "interface": {
+          "id": "281fd706-b192-4194-8055-2d8733c115f9",
+          "interface_key": "rest_api:POST /workstreams/{workstream_id}/dependencies/",
+          "interface_kind": "rest_api",
+          "legacy_since": "2026-06-04T22:57:37.149207Z",
+          "replacement_ref": "/workplans/{workplan_id}/dependencies/",
+          "owner_component": "state-hub.api",
+          "status": "legacy",
+          "replacement_verified": true,
+          "manual_hold": false,
+          "hold_reason": null,
+          "notes": null,
+          "retired_at": null,
+          "created_at": "2026-06-04T22:57:37.149207Z",
+          "updated_at": "2026-06-04T22:57:37.149207Z"
+        },
+        "all_time": {
+          "calls": 4971,
+          "tenant_count": 1,
+          "user_count": 1,
+          "component_count": 1,
+          "tenants": {
+            "unknown": 4971
+          },
+          "users": {
+            "unknown": 4971
+          },
+          "components": {
+            "unknown": 4971
+          }
+        },
+        "window": {
+          "calls": 0,
+          "tenant_count": 0,
+          "user_count": 0,
+          "component_count": 0,
+          "tenants": {},
+          "users": {},
+          "components": {}
+        },
+        "last_seen_at": "2026-07-01T22:09:24.229011Z",
+        "retirement_candidate": true,
+        "retirement_reason": "no measured usage in review window"
+      }
+    ],
+    "retirement_candidates": [
+      {
+        "interface": {
+          "id": "63ed90e3-42b4-431a-94db-e1254a52f9e2",
+          "interface_key": "mcp:create_workstream",
+          "interface_kind": "mcp_tool",
+          "legacy_since": "2026-07-10T13:19:44.205900Z",
+          "replacement_ref": "create_workplan",
+          "owner_component": "state-hub.mcp",
+          "status": "legacy",
+          "replacement_verified": true,
+          "manual_hold": false,
+          "hold_reason": null,
+          "notes": "Registered by STATE-WP-0070 T03 \u2014 zero-window streak starts at registration",
+          "retired_at": null,
+          "created_at": "2026-07-10T13:19:44.205900Z",
+          "updated_at": "2026-07-10T13:19:44.205900Z"
+        },
+        "all_time": {
+          "calls": 2,
+          "tenant_count": 1,
+          "user_count": 1,
+          "component_count": 1,
+          "tenants": {
+            "unknown": 2
+          },
+          "users": {
+            "unknown": 2
+          },
+          "components": {
+            "state-hub.mcp": 2
+          }
+        },
+        "window": {
+          "calls": 0,
+          "tenant_count": 0,
+          "user_count": 0,
+          "component_count": 0,
+          "tenants": {},
+          "users": {},
+          "components": {}
+        },
+        "last_seen_at": "2026-07-10T13:20:43.378546Z",
+        "retirement_candidate": true,
+        "retirement_reason": "no measured usage in review window"
+      },
+      {
+        "interface": {
+          "id": "b6a5fe44-fb85-4ef7-a273-78d09da777af",
+          "interface_key": "mcp:list_workstreams",
+          "interface_kind": "mcp_tool",
+          "legacy_since": "2026-07-10T13:19:26.075491Z",
+          "replacement_ref": "list_workplans",
+          "owner_component": "state-hub.mcp",
+          "status": "legacy",
+          "replacement_verified": true,
+          "manual_hold": false,
+          "hold_reason": null,
+          "notes": null,
+          "retired_at": null,
+          "created_at": "2026-07-10T13:19:26.075491Z",
+          "updated_at": "2026-07-10T13:19:26.075491Z"
+        },
+        "all_time": {
+          "calls": 2,
+          "tenant_count": 1,
+          "user_count": 1,
+          "component_count": 1,
+          "tenants": {
+            "unknown": 2
+          },
+          "users": {
+            "unknown": 2
+          },
+          "components": {
+            "state-hub.mcp": 2
+          }
+        },
+        "window": {
+          "calls": 0,
+          "tenant_count": 0,
+          "user_count": 0,
+          "component_count": 0,
+          "tenants": {},
+          "users": {},
+          "components": {}
+        },
+        "last_seen_at": "2026-07-10T13:20:42.374940Z",
+        "retirement_candidate": true,
+        "retirement_reason": "no measured usage in review window"
+      },
+      {
+        "interface": {
+          "id": "53c3372b-307d-4d6a-8ea4-bc36cacdcaf2",
+          "interface_key": "mcp:update_workstream",
+          "interface_kind": "mcp_tool",
+          "legacy_since": "2026-07-10T13:19:44.255216Z",
+          "replacement_ref": "update_workplan",
+          "owner_component": "state-hub.mcp",
+          "status": "legacy",
+          "replacement_verified": true,
+          "manual_hold": false,
+          "hold_reason": null,
+          "notes": "Registered by STATE-WP-0070 T03 \u2014 zero-window streak starts at registration",
+          "retired_at": null,
+          "created_at": "2026-07-10T13:19:44.255216Z",
+          "updated_at": "2026-07-10T13:19:44.255216Z"
+        },
+        "all_time": {
+          "calls": 0,
+          "tenant_count": 0,
+          "user_count": 0,
+          "component_count": 0,
+          "tenants": {},
+          "users": {},
+          "components": {}
+        },
+        "window": {
+          "calls": 0,
+          "tenant_count": 0,
+          "user_count": 0,
+          "component_count": 0,
+          "tenants": {},
+          "users": {},
+          "components": {}
+        },
+        "last_seen_at": null,
+        "retirement_candidate": true,
+        "retirement_reason": "no measured usage in review window"
+      },
+      {
+        "interface": {
+          "id": "bed4d08a-3471-48f5-9f0e-f9d550383a26",
+          "interface_key": "mcp:update_workstream_status",
+          "interface_kind": "mcp_tool",
+          "legacy_since": "2026-07-10T13:19:44.303612Z",
+          "replacement_ref": "update_workplan_status",
+          "owner_component": "state-hub.mcp",
+          "status": "legacy",
+          "replacement_verified": true,
+          "manual_hold": false,
+          "hold_reason": null,
+          "notes": "Registered by STATE-WP-0070 T03 \u2014 zero-window streak starts at registration",
+          "retired_at": null,
+          "created_at": "2026-07-10T13:19:44.303612Z",
+          "updated_at": "2026-07-10T13:19:44.303612Z"
+        },
+        "all_time": {
+          "calls": 0,
+          "tenant_count": 0,
+          "user_count": 0,
+          "component_count": 0,
+          "tenants": {},
+          "users": {},
+          "components": {}
+        },
+        "window": {
+          "calls": 0,
+          "tenant_count": 0,
+          "user_count": 0,
+          "component_count": 0,
+          "tenants": {},
+          "users": {},
+          "components": {}
+        },
+        "last_seen_at": null,
+        "retirement_candidate": true,
+        "retirement_reason": "no measured usage in review window"
+      },
+      {
+        "interface": {
+          "id": "46900dc2-0893-405b-ba59-80f31fb6ebb1",
+          "interface_key": "state://workstreams/{topic_slug}",
+          "interface_kind": "mcp_tool",
+          "legacy_since": "2026-07-10T13:19:44.344493Z",
+          "replacement_ref": "state://workplans/{topic_slug}",
+          "owner_component": "state-hub.mcp",
+          "status": "legacy",
+          "replacement_verified": true,
+          "manual_hold": false,
+          "hold_reason": null,
+          "notes": "Registered by STATE-WP-0070 T03 \u2014 zero-window streak starts at registration",
+          "retired_at": null,
+          "created_at": "2026-07-10T13:19:44.344493Z",
+          "updated_at": "2026-07-10T13:19:44.344493Z"
+        },
+        "all_time": {
+          "calls": 1,
+          "tenant_count": 1,
+          "user_count": 1,
+          "component_count": 1,
+          "tenants": {
+            "unknown": 1
+          },
+          "users": {
+            "unknown": 1
+          },
+          "components": {
+            "state-hub.mcp": 1
+          }
+        },
+        "window": {
+          "calls": 0,
+          "tenant_count": 0,
+          "user_count": 0,
+          "component_count": 0,
+          "tenants": {},
+          "users": {},
+          "components": {}
+        },
+        "last_seen_at": "2026-07-10T13:20:34.491811Z",
+        "retirement_candidate": true,
+        "retirement_reason": "no measured usage in review window"
+      },
+      {
+        "interface": {
+          "id": "cd9342fd-27e7-4a46-a1be-d41499e106a3",
+          "interface_key": "rest_api:DELETE /workstreams/{workstream_id}",
+          "interface_kind": "rest_api",
+          "legacy_since": "2026-06-06T17:28:13.052813Z",
+          "replacement_ref": "/workplans/{workplan_id}",
+          "owner_component": "state-hub.api",
+          "status": "legacy",
+          "replacement_verified": true,
+          "manual_hold": false,
+          "hold_reason": null,
+          "notes": null,
+          "retired_at": null,
+          "created_at": "2026-06-06T17:28:13.052813Z",
+          "updated_at": "2026-06-06T17:28:13.052813Z"
+        },
+        "all_time": {
+          "calls": 1,
+          "tenant_count": 1,
+          "user_count": 1,
+          "component_count": 1,
+          "tenants": {
+            "unknown": 1
+          },
+          "users": {
+            "unknown": 1
+          },
+          "components": {
+            "unknown": 1
+          }
+        },
+        "window": {
+          "calls": 0,
+          "tenant_count": 0,
+          "user_count": 0,
+          "component_count": 0,
+          "tenants": {},
+          "users": {},
+          "components": {}
+        },
+        "last_seen_at": "2026-06-06T17:28:13.047529Z",
+        "retirement_candidate": true,
+        "retirement_reason": "no measured usage in review window"
+      },
+      {
+        "interface": {
+          "id": "a4e0948c-cd4a-461e-8ae2-7fd7b51d04a7",
+          "interface_key": "rest_api:GET /decisions/?workstream_id",
+          "interface_kind": "rest_api",
+          "legacy_since": "2026-07-09T23:07:53.093223Z",
+          "replacement_ref": "/decisions/?workplan_id=<workplan_id>",
+          "owner_component": "state-hub.api",
+          "status": "legacy",
+          "replacement_verified": true,
+          "manual_hold": false,
+          "hold_reason": null,
+          "notes": null,
+          "retired_at": null,
+          "created_at": "2026-07-09T23:07:53.093223Z",
+          "updated_at": "2026-07-09T23:07:53.093223Z"
+        },
+        "all_time": {
+          "calls": 1,
+          "tenant_count": 1,
+          "user_count": 1,
+          "component_count": 1,
+          "tenants": {
+            "unknown": 1
+          },
+          "users": {
+            "unknown": 1
+          },
+          "components": {
+            "unknown": 1
+          }
+        },
+        "window": {
+          "calls": 0,
+          "tenant_count": 0,
+          "user_count": 0,
+          "component_count": 0,
+          "tenants": {},
+          "users": {},
+          "components": {}
+        },
+        "last_seen_at": "2026-07-09T23:07:53.083299Z",
+        "retirement_candidate": true,
+        "retirement_reason": "no measured usage in review window"
+      },
+      {
+        "interface": {
+          "id": "3e4a3d0b-08fa-45c3-91e2-4f514a914b97",
+          "interface_key": "rest_api:GET /workstreams/",
+          "interface_kind": "rest_api",
+          "legacy_since": "2026-06-04T00:26:14.533764Z",
+          "replacement_ref": "/workplans/",
+          "owner_component": "state-hub.api",
+          "status": "legacy",
+          "replacement_verified": true,
+          "manual_hold": false,
+          "hold_reason": null,
+          "notes": null,
+          "retired_at": null,
+          "created_at": "2026-06-04T00:26:14.533764Z",
+          "updated_at": "2026-06-04T00:26:14.533764Z"
+        },
+        "all_time": {
+          "calls": 144086,
+          "tenant_count": 1,
+          "user_count": 1,
+          "component_count": 1,
+          "tenants": {
+            "unknown": 144086
+          },
+          "users": {
+            "unknown": 144086
+          },
+          "components": {
+            "unknown": 144086
+          }
+        },
+        "window": {
+          "calls": 0,
+          "tenant_count": 0,
+          "user_count": 0,
+          "component_count": 0,
+          "tenants": {},
+          "users": {},
+          "components": {}
+        },
+        "last_seen_at": "2026-08-10T18:06:05.032338Z",
+        "retirement_candidate": true,
+        "retirement_reason": "no measured usage in review window"
+      },
+      {
+        "interface": {
+          "id": "e4c140ec-7479-46f9-b185-4b533f19d639",
+          "interface_key": "rest_api:GET /workstreams/workplan-index",
+          "interface_kind": "rest_api",
+          "legacy_since": "2026-06-04T05:20:58.321869Z",
+          "replacement_ref": "/workplans/index",
+          "owner_component": "state-hub.api",
+          "status": "legacy",
+          "replacement_verified": true,
+          "manual_hold": false,
+          "hold_reason": null,
+          "notes": null,
+          "retired_at": null,
+          "created_at": "2026-06-04T05:20:58.321869Z",
+          "updated_at": "2026-06-04T05:20:58.321869Z"
+        },
+        "all_time": {
+          "calls": 30,
+          "tenant_count": 1,
+          "user_count": 1,
+          "component_count": 1,
+          "tenants": {
+            "unknown": 30
+          },
+          "users": {
+            "unknown": 30
+          },
+          "components": {
+            "unknown": 30
+          }
+        },
+        "window": {
+          "calls": 0,
+          "tenant_count": 0,
+          "user_count": 0,
+          "component_count": 0,
+          "tenants": {},
+          "users": {},
+          "components": {}
+        },
+        "last_seen_at": "2026-07-03T05:20:34.534439Z",
+        "retirement_candidate": true,
+        "retirement_reason": "no measured usage in review window"
+      },
+      {
+        "interface": {
+          "id": "3a00b19e-e7db-4403-98aa-a77c9ab61ecc",
+          "interface_key": "rest_api:GET /workstreams/{workstream_id}",
+          "interface_kind": "rest_api",
+          "legacy_since": "2026-06-04T00:25:59.014966Z",
+          "replacement_ref": "/workplans/{workplan_id}",
+          "owner_component": "state-hub.api",
+          "status": "legacy",
+          "replacement_verified": true,
+          "manual_hold": false,
+          "hold_reason": null,
+          "notes": null,
+          "retired_at": null,
+          "created_at": "2026-06-04T00:25:59.014966Z",
+          "updated_at": "2026-06-04T00:25:59.014966Z"
+        },
+        "all_time": {
+          "calls": 511406,
+          "tenant_count": 1,
+          "user_count": 1,
+          "component_count": 1,
+          "tenants": {
+            "unknown": 511406
+          },
+          "users": {
+            "unknown": 511406
+          },
+          "components": {
+            "unknown": 511406
+          }
+        },
+        "window": {
+          "calls": 0,
+          "tenant_count": 0,
+          "user_count": 0,
+          "component_count": 0,
+          "tenants": {},
+          "users": {},
+          "components": {}
+        },
+        "last_seen_at": "2026-07-31T16:25:32.004042Z",
+        "retirement_candidate": true,
+        "retirement_reason": "no measured usage in review window"
+      },
+      {
+        "interface": {
+          "id": "69e1a255-a8b9-4101-8a68-b1bed23abfda",
+          "interface_key": "rest_api:GET /workstreams/{workstream_id}/dependencies/",
+          "interface_kind": "rest_api",
+          "legacy_since": "2026-06-04T00:25:59.291135Z",
+          "replacement_ref": "/workplans/{workplan_id}/dependencies/",
+          "owner_component": "state-hub.api",
+          "status": "legacy",
+          "replacement_verified": true,
+          "manual_hold": false,
+          "hold_reason": null,
+          "notes": null,
+          "retired_at": null,
+          "created_at": "2026-06-04T00:25:59.291135Z",
+          "updated_at": "2026-06-04T00:25:59.291135Z"
+        },
+        "all_time": {
+          "calls": 255865,
+          "tenant_count": 1,
+          "user_count": 1,
+          "component_count": 1,
+          "tenants": {
+            "unknown": 255865
+          },
+          "users": {
+            "unknown": 255865
+          },
+          "components": {
+            "unknown": 255865
+          }
+        },
+        "window": {
+          "calls": 0,
+          "tenant_count": 0,
+          "user_count": 0,
+          "component_count": 0,
+          "tenants": {},
+          "users": {},
+          "components": {}
+        },
+        "last_seen_at": "2026-07-08T21:14:12.747005Z",
+        "retirement_candidate": true,
+        "retirement_reason": "no measured usage in review window"
+      },
+      {
+        "interface": {
+          "id": "b1aae931-b51f-4a85-a723-865dd65f6132",
+          "interface_key": "rest_api:PATCH /workstreams/{workstream_id}",
+          "interface_kind": "rest_api",
+          "legacy_since": "2026-06-04T06:09:41.901035Z",
+          "replacement_ref": "/workplans/{workplan_id}",
+          "owner_component": "state-hub.api",
+          "status": "legacy",
+          "replacement_verified": true,
+          "manual_hold": false,
+          "hold_reason": null,
+          "notes": null,
+          "retired_at": null,
+          "created_at": "2026-06-04T06:09:41.901035Z",
+          "updated_at": "2026-06-04T06:09:41.901035Z"
+        },
+        "all_time": {
+          "calls": 571,
+          "tenant_count": 1,
+          "user_count": 1,
+          "component_count": 1,
+          "tenants": {
+            "unknown": 571
+          },
+          "users": {
+            "unknown": 571
+          },
+          "components": {
+            "unknown": 571
+          }
+        },
+        "window": {
+          "calls": 0,
+          "tenant_count": 0,
+          "user_count": 0,
+          "component_count": 0,
+          "tenants": {},
+          "users": {},
+          "components": {}
+        },
+        "last_seen_at": "2026-07-08T20:49:12.335710Z",
+        "retirement_candidate": true,
+        "retirement_reason": "no measured usage in review window"
+      },
+      {
+        "interface": {
+          "id": "4aea9591-970b-4918-ac4a-4da95a0a1a8c",
+          "interface_key": "rest_api:POST /decisions/ workstream_id",
+          "interface_kind": "rest_api",
+          "legacy_since": "2026-07-09T22:56:35.473130Z",
+          "replacement_ref": "POST /decisions/ with workplan_id",
+          "owner_component": "state-hub.api",
+          "status": "legacy",
+          "replacement_verified": true,
+          "manual_hold": false,
+          "hold_reason": null,
+          "notes": null,
+          "retired_at": null,
+          "created_at": "2026-07-09T22:56:35.473130Z",
+          "updated_at": "2026-07-09T22:56:35.473130Z"
+        },
+        "all_time": {
+          "calls": 3,
+          "tenant_count": 1,
+          "user_count": 1,
+          "component_count": 1,
+          "tenants": {
+            "unknown": 3
+          },
+          "users": {
+            "unknown": 3
+          },
+          "components": {
+            "unknown": 3
+          }
+        },
+        "window": {
+          "calls": 0,
+          "tenant_count": 0,
+          "user_count": 0,
+          "component_count": 0,
+          "tenants": {},
+          "users": {},
+          "components": {}
+        },
+        "last_seen_at": "2026-07-09T22:57:05.912456Z",
+        "retirement_candidate": true,
+        "retirement_reason": "no measured usage in review window"
+      },
+      {
+        "interface": {
+          "id": "4a70583c-1e41-4ec1-99a9-728856a7d79c",
+          "interface_key": "rest_api:POST /progress/ workstream_id",
+          "interface_kind": "rest_api",
+          "legacy_since": "2026-07-08T23:35:09.148333Z",
+          "replacement_ref": "POST /progress/ with workplan_id",
+          "owner_component": "state-hub.api",
+          "status": "legacy",
+          "replacement_verified": true,
+          "manual_hold": false,
+          "hold_reason": null,
+          "notes": null,
+          "retired_at": null,
+          "created_at": "2026-07-08T23:35:09.148333Z",
+          "updated_at": "2026-07-08T23:35:09.148333Z"
+        },
+        "all_time": {
+          "calls": 14,
+          "tenant_count": 1,
+          "user_count": 1,
+          "component_count": 1,
+          "tenants": {
+            "unknown": 14
+          },
+          "users": {
+            "unknown": 14
+          },
+          "components": {
+            "unknown": 14
+          }
+        },
+        "window": {
+          "calls": 0,
+          "tenant_count": 0,
+          "user_count": 0,
+          "component_count": 0,
+          "tenants": {},
+          "users": {},
+          "components": {}
+        },
+        "last_seen_at": "2026-07-10T08:34:42.959724Z",
+        "retirement_candidate": true,
+        "retirement_reason": "no measured usage in review window"
+      },
+      {
+        "interface": {
+          "id": "6df4e443-7bf1-461a-923b-a6eb52fe7b07",
+          "interface_key": "rest_api:POST /tasks/ workstream_id",
+          "interface_kind": "rest_api",
+          "legacy_since": "2026-07-08T22:38:29.405720Z",
+          "replacement_ref": "POST /tasks/ with workplan_id",
+          "owner_component": "state-hub.api",
+          "status": "legacy",
+          "replacement_verified": true,
+          "manual_hold": false,
+          "hold_reason": null,
+          "notes": null,
+          "retired_at": null,
+          "created_at": "2026-07-08T22:38:29.405720Z",
+          "updated_at": "2026-07-08T22:38:29.405720Z"
+        },
+        "all_time": {
+          "calls": 5,
+          "tenant_count": 1,
+          "user_count": 1,
+          "component_count": 1,
+          "tenants": {
+            "unknown": 5
+          },
+          "users": {
+            "unknown": 5
+          },
+          "components": {
+            "state-hub.fix-consistency": 5
+          }
+        },
+        "window": {
+          "calls": 0,
+          "tenant_count": 0,
+          "user_count": 0,
+          "component_count": 0,
+          "tenants": {},
+          "users": {},
+          "components": {}
+        },
+        "last_seen_at": "2026-07-08T22:38:29.976918Z",
+        "retirement_candidate": true,
+        "retirement_reason": "no measured usage in review window"
+      },
+      {
+        "interface": {
+          "id": "ed6451c9-d2cc-4486-9afe-d3852782cabc",
+          "interface_key": "rest_api:POST /workstreams/",
+          "interface_kind": "rest_api",
+          "legacy_since": "2026-06-04T07:40:24.168535Z",
+          "replacement_ref": "/workplans/",
+          "owner_component": "state-hub.api",
+          "status": "legacy",
+          "replacement_verified": true,
+          "manual_hold": false,
+          "hold_reason": null,
+          "notes": null,
+          "retired_at": null,
+          "created_at": "2026-06-04T07:40:24.168535Z",
+          "updated_at": "2026-06-04T07:40:24.168535Z"
+        },
+        "all_time": {
+          "calls": 824,
+          "tenant_count": 1,
+          "user_count": 1,
+          "component_count": 1,
+          "tenants": {
+            "unknown": 824
+          },
+          "users": {
+            "unknown": 824
+          },
+          "components": {
+            "unknown": 824
+          }
+        },
+        "window": {
+          "calls": 0,
+          "tenant_count": 0,
+          "user_count": 0,
+          "component_count": 0,
+          "tenants": {},
+          "users": {},
+          "components": {}
+        },
+        "last_seen_at": "2026-07-08T20:38:05.903144Z",
+        "retirement_candidate": true,
+        "retirement_reason": "no measured usage in review window"
+      },
+      {
+        "interface": {
+          "id": "281fd706-b192-4194-8055-2d8733c115f9",
+          "interface_key": "rest_api:POST /workstreams/{workstream_id}/dependencies/",
+          "interface_kind": "rest_api",
+          "legacy_since": "2026-06-04T22:57:37.149207Z",
+          "replacement_ref": "/workplans/{workplan_id}/dependencies/",
+          "owner_component": "state-hub.api",
+          "status": "legacy",
+          "replacement_verified": true,
+          "manual_hold": false,
+          "hold_reason": null,
+          "notes": null,
+          "retired_at": null,
+          "created_at": "2026-06-04T22:57:37.149207Z",
+          "updated_at": "2026-06-04T22:57:37.149207Z"
+        },
+        "all_time": {
+          "calls": 4971,
+          "tenant_count": 1,
+          "user_count": 1,
+          "component_count": 1,
+          "tenants": {
+            "unknown": 4971
+          },
+          "users": {
+            "unknown": 4971
+          },
+          "components": {
+            "unknown": 4971
+          }
+        },
+        "window": {
+          "calls": 0,
+          "tenant_count": 0,
+          "user_count": 0,
+          "component_count": 0,
+          "tenants": {},
+          "users": {},
+          "components": {}
+        },
+        "last_seen_at": "2026-07-01T22:09:24.229011Z",
+        "retirement_candidate": true,
+        "retirement_reason": "no measured usage in review window"
+      }
+    ]
+  },
+  "hours": 8
+}
diff --git a/docs/evidence/legacy-meter-weekly-review-20260813.json b/docs/evidence/legacy-meter-weekly-review-20260813.json
new file mode 100644
index 0000000..b0d585f
--- /dev/null
+++ b/docs/evidence/legacy-meter-weekly-review-20260813.json
@@ -0,0 +1,1755 @@
+{
+  "captured_at": "2026-08-13T14:00:04.924801+00:00",
+  "api_base": "http://127.0.0.1:8000",
+  "workplan": "STATE-WP-0070",
+  "retired_interfaces": [],
+  "weekly_review": {
+    "generated_at": "2026-08-13T14:00:04.918885Z",
+    "window_start": "2026-08-13T06:00:04.503934Z",
+    "window_end": "2026-08-13T14:00:04.503934Z",
+    "cadence": "weekly",
+    "activity_core_handoff": {
+      "activity_id": "statehub-legacy-interface-review",
+      "cadence": "weekly",
+      "source_endpoint": "/legacy-meter/weekly-review",
+      "state_owner": "state-hub",
+      "scheduler_owner": "activity-core"
+    },
+    "interfaces": [
+      {
+        "interface": {
+          "id": "8051fb40-66c9-4dc4-a413-13e8573e04a3",
+          "interface_key": "event_subject:org.statehub.workstream.completed",
+          "interface_kind": "event_subject",
+          "legacy_since": "2026-06-04T06:09:42.198193Z",
+          "replacement_ref": "org.statehub.workplan.completed",
+          "owner_component": "state-hub.events",
+          "status": "retired",
+          "replacement_verified": true,
+          "manual_hold": false,
+          "hold_reason": null,
+          "notes": "Retired by STATE-WP-0069 closeout",
+          "retired_at": "2026-07-08T21:38:52.773601Z",
+          "created_at": "2026-06-04T06:09:42.198193Z",
+          "updated_at": "2026-07-08T21:38:52.761243Z"
+        },
+        "all_time": {
+          "calls": 255,
+          "tenant_count": 1,
+          "user_count": 1,
+          "component_count": 1,
+          "tenants": {
+            "unknown": 255
+          },
+          "users": {
+            "unknown": 255
+          },
+          "components": {
+            "state-hub.events": 255
+          }
+        },
+        "window": {
+          "calls": 0,
+          "tenant_count": 0,
+          "user_count": 0,
+          "component_count": 0,
+          "tenants": {},
+          "users": {},
+          "components": {}
+        },
+        "last_seen_at": "2026-07-08T20:49:12.839383Z",
+        "retirement_candidate": false,
+        "retirement_reason": "already retired"
+      },
+      {
+        "interface": {
+          "id": "63ed90e3-42b4-431a-94db-e1254a52f9e2",
+          "interface_key": "mcp:create_workstream",
+          "interface_kind": "mcp_tool",
+          "legacy_since": "2026-07-10T13:19:44.205900Z",
+          "replacement_ref": "create_workplan",
+          "owner_component": "state-hub.mcp",
+          "status": "legacy",
+          "replacement_verified": true,
+          "manual_hold": false,
+          "hold_reason": null,
+          "notes": "Registered by STATE-WP-0070 T03 \u2014 zero-window streak starts at registration",
+          "retired_at": null,
+          "created_at": "2026-07-10T13:19:44.205900Z",
+          "updated_at": "2026-07-10T13:19:44.205900Z"
+        },
+        "all_time": {
+          "calls": 2,
+          "tenant_count": 1,
+          "user_count": 1,
+          "component_count": 1,
+          "tenants": {
+            "unknown": 2
+          },
+          "users": {
+            "unknown": 2
+          },
+          "components": {
+            "state-hub.mcp": 2
+          }
+        },
+        "window": {
+          "calls": 0,
+          "tenant_count": 0,
+          "user_count": 0,
+          "component_count": 0,
+          "tenants": {},
+          "users": {},
+          "components": {}
+        },
+        "last_seen_at": "2026-07-10T13:20:43.378546Z",
+        "retirement_candidate": true,
+        "retirement_reason": "no measured usage in review window"
+      },
+      {
+        "interface": {
+          "id": "b6a5fe44-fb85-4ef7-a273-78d09da777af",
+          "interface_key": "mcp:list_workstreams",
+          "interface_kind": "mcp_tool",
+          "legacy_since": "2026-07-10T13:19:26.075491Z",
+          "replacement_ref": "list_workplans",
+          "owner_component": "state-hub.mcp",
+          "status": "legacy",
+          "replacement_verified": true,
+          "manual_hold": false,
+          "hold_reason": null,
+          "notes": null,
+          "retired_at": null,
+          "created_at": "2026-07-10T13:19:26.075491Z",
+          "updated_at": "2026-07-10T13:19:26.075491Z"
+        },
+        "all_time": {
+          "calls": 2,
+          "tenant_count": 1,
+          "user_count": 1,
+          "component_count": 1,
+          "tenants": {
+            "unknown": 2
+          },
+          "users": {
+            "unknown": 2
+          },
+          "components": {
+            "state-hub.mcp": 2
+          }
+        },
+        "window": {
+          "calls": 0,
+          "tenant_count": 0,
+          "user_count": 0,
+          "component_count": 0,
+          "tenants": {},
+          "users": {},
+          "components": {}
+        },
+        "last_seen_at": "2026-07-10T13:20:42.374940Z",
+        "retirement_candidate": true,
+        "retirement_reason": "no measured usage in review window"
+      },
+      {
+        "interface": {
+          "id": "53c3372b-307d-4d6a-8ea4-bc36cacdcaf2",
+          "interface_key": "mcp:update_workstream",
+          "interface_kind": "mcp_tool",
+          "legacy_since": "2026-07-10T13:19:44.255216Z",
+          "replacement_ref": "update_workplan",
+          "owner_component": "state-hub.mcp",
+          "status": "legacy",
+          "replacement_verified": true,
+          "manual_hold": false,
+          "hold_reason": null,
+          "notes": "Registered by STATE-WP-0070 T03 \u2014 zero-window streak starts at registration",
+          "retired_at": null,
+          "created_at": "2026-07-10T13:19:44.255216Z",
+          "updated_at": "2026-07-10T13:19:44.255216Z"
+        },
+        "all_time": {
+          "calls": 0,
+          "tenant_count": 0,
+          "user_count": 0,
+          "component_count": 0,
+          "tenants": {},
+          "users": {},
+          "components": {}
+        },
+        "window": {
+          "calls": 0,
+          "tenant_count": 0,
+          "user_count": 0,
+          "component_count": 0,
+          "tenants": {},
+          "users": {},
+          "components": {}
+        },
+        "last_seen_at": null,
+        "retirement_candidate": true,
+        "retirement_reason": "no measured usage in review window"
+      },
+      {
+        "interface": {
+          "id": "bed4d08a-3471-48f5-9f0e-f9d550383a26",
+          "interface_key": "mcp:update_workstream_status",
+          "interface_kind": "mcp_tool",
+          "legacy_since": "2026-07-10T13:19:44.303612Z",
+          "replacement_ref": "update_workplan_status",
+          "owner_component": "state-hub.mcp",
+          "status": "legacy",
+          "replacement_verified": true,
+          "manual_hold": false,
+          "hold_reason": null,
+          "notes": "Registered by STATE-WP-0070 T03 \u2014 zero-window streak starts at registration",
+          "retired_at": null,
+          "created_at": "2026-07-10T13:19:44.303612Z",
+          "updated_at": "2026-07-10T13:19:44.303612Z"
+        },
+        "all_time": {
+          "calls": 0,
+          "tenant_count": 0,
+          "user_count": 0,
+          "component_count": 0,
+          "tenants": {},
+          "users": {},
+          "components": {}
+        },
+        "window": {
+          "calls": 0,
+          "tenant_count": 0,
+          "user_count": 0,
+          "component_count": 0,
+          "tenants": {},
+          "users": {},
+          "components": {}
+        },
+        "last_seen_at": null,
+        "retirement_candidate": true,
+        "retirement_reason": "no measured usage in review window"
+      },
+      {
+        "interface": {
+          "id": "46900dc2-0893-405b-ba59-80f31fb6ebb1",
+          "interface_key": "state://workstreams/{topic_slug}",
+          "interface_kind": "mcp_tool",
+          "legacy_since": "2026-07-10T13:19:44.344493Z",
+          "replacement_ref": "state://workplans/{topic_slug}",
+          "owner_component": "state-hub.mcp",
+          "status": "legacy",
+          "replacement_verified": true,
+          "manual_hold": false,
+          "hold_reason": null,
+          "notes": "Registered by STATE-WP-0070 T03 \u2014 zero-window streak starts at registration",
+          "retired_at": null,
+          "created_at": "2026-07-10T13:19:44.344493Z",
+          "updated_at": "2026-07-10T13:19:44.344493Z"
+        },
+        "all_time": {
+          "calls": 1,
+          "tenant_count": 1,
+          "user_count": 1,
+          "component_count": 1,
+          "tenants": {
+            "unknown": 1
+          },
+          "users": {
+            "unknown": 1
+          },
+          "components": {
+            "state-hub.mcp": 1
+          }
+        },
+        "window": {
+          "calls": 0,
+          "tenant_count": 0,
+          "user_count": 0,
+          "component_count": 0,
+          "tenants": {},
+          "users": {},
+          "components": {}
+        },
+        "last_seen_at": "2026-07-10T13:20:34.491811Z",
+        "retirement_candidate": true,
+        "retirement_reason": "no measured usage in review window"
+      },
+      {
+        "interface": {
+          "id": "cd9342fd-27e7-4a46-a1be-d41499e106a3",
+          "interface_key": "rest_api:DELETE /workstreams/{workstream_id}",
+          "interface_kind": "rest_api",
+          "legacy_since": "2026-06-06T17:28:13.052813Z",
+          "replacement_ref": "/workplans/{workplan_id}",
+          "owner_component": "state-hub.api",
+          "status": "legacy",
+          "replacement_verified": true,
+          "manual_hold": false,
+          "hold_reason": null,
+          "notes": null,
+          "retired_at": null,
+          "created_at": "2026-06-06T17:28:13.052813Z",
+          "updated_at": "2026-06-06T17:28:13.052813Z"
+        },
+        "all_time": {
+          "calls": 1,
+          "tenant_count": 1,
+          "user_count": 1,
+          "component_count": 1,
+          "tenants": {
+            "unknown": 1
+          },
+          "users": {
+            "unknown": 1
+          },
+          "components": {
+            "unknown": 1
+          }
+        },
+        "window": {
+          "calls": 0,
+          "tenant_count": 0,
+          "user_count": 0,
+          "component_count": 0,
+          "tenants": {},
+          "users": {},
+          "components": {}
+        },
+        "last_seen_at": "2026-06-06T17:28:13.047529Z",
+        "retirement_candidate": true,
+        "retirement_reason": "no measured usage in review window"
+      },
+      {
+        "interface": {
+          "id": "a4e0948c-cd4a-461e-8ae2-7fd7b51d04a7",
+          "interface_key": "rest_api:GET /decisions/?workstream_id",
+          "interface_kind": "rest_api",
+          "legacy_since": "2026-07-09T23:07:53.093223Z",
+          "replacement_ref": "/decisions/?workplan_id=<workplan_id>",
+          "owner_component": "state-hub.api",
+          "status": "legacy",
+          "replacement_verified": true,
+          "manual_hold": false,
+          "hold_reason": null,
+          "notes": null,
+          "retired_at": null,
+          "created_at": "2026-07-09T23:07:53.093223Z",
+          "updated_at": "2026-07-09T23:07:53.093223Z"
+        },
+        "all_time": {
+          "calls": 1,
+          "tenant_count": 1,
+          "user_count": 1,
+          "component_count": 1,
+          "tenants": {
+            "unknown": 1
+          },
+          "users": {
+            "unknown": 1
+          },
+          "components": {
+            "unknown": 1
+          }
+        },
+        "window": {
+          "calls": 0,
+          "tenant_count": 0,
+          "user_count": 0,
+          "component_count": 0,
+          "tenants": {},
+          "users": {},
+          "components": {}
+        },
+        "last_seen_at": "2026-07-09T23:07:53.083299Z",
+        "retirement_candidate": true,
+        "retirement_reason": "no measured usage in review window"
+      },
+      {
+        "interface": {
+          "id": "70a9346e-e0ee-42ac-874f-f160580b54dd",
+          "interface_key": "rest_api:GET /progress/?workstream_id",
+          "interface_kind": "rest_api",
+          "legacy_since": "2026-07-13T22:04:03.911449Z",
+          "replacement_ref": "/progress/?workplan_id=<workplan_id>",
+          "owner_component": "state-hub.api",
+          "status": "legacy",
+          "replacement_verified": true,
+          "manual_hold": false,
+          "hold_reason": null,
+          "notes": null,
+          "retired_at": null,
+          "created_at": "2026-07-13T22:04:03.911449Z",
+          "updated_at": "2026-07-13T22:04:03.911449Z"
+        },
+        "all_time": {
+          "calls": 2,
+          "tenant_count": 1,
+          "user_count": 1,
+          "component_count": 1,
+          "tenants": {
+            "unknown": 2
+          },
+          "users": {
+            "unknown": 2
+          },
+          "components": {
+            "unknown": 2
+          }
+        },
+        "window": {
+          "calls": 0,
+          "tenant_count": 0,
+          "user_count": 0,
+          "component_count": 0,
+          "tenants": {},
+          "users": {},
+          "components": {}
+        },
+        "last_seen_at": "2026-08-12T08:55:33.912995Z",
+        "retirement_candidate": true,
+        "retirement_reason": "no measured usage in review window"
+      },
+      {
+        "interface": {
+          "id": "be3cdcf8-250b-4bf0-801f-02ffd5f57e00",
+          "interface_key": "rest_api:GET /tasks/?workstream_id",
+          "interface_kind": "rest_api",
+          "legacy_since": "2026-07-08T19:32:21.628513Z",
+          "replacement_ref": "/tasks/?workplan_id=<workplan_id>",
+          "owner_component": "state-hub.api",
+          "status": "legacy",
+          "replacement_verified": true,
+          "manual_hold": false,
+          "hold_reason": null,
+          "notes": null,
+          "retired_at": null,
+          "created_at": "2026-07-08T19:32:21.628513Z",
+          "updated_at": "2026-07-08T19:32:21.628513Z"
+        },
+        "all_time": {
+          "calls": 590,
+          "tenant_count": 1,
+          "user_count": 1,
+          "component_count": 1,
+          "tenants": {
+            "unknown": 590
+          },
+          "users": {
+            "unknown": 590
+          },
+          "components": {
+            "unknown": 590
+          }
+        },
+        "window": {
+          "calls": 0,
+          "tenant_count": 0,
+          "user_count": 0,
+          "component_count": 0,
+          "tenants": {},
+          "users": {},
+          "components": {}
+        },
+        "last_seen_at": "2026-08-12T08:55:27.763102Z",
+        "retirement_candidate": true,
+        "retirement_reason": "no measured usage in review window"
+      },
+      {
+        "interface": {
+          "id": "3e4a3d0b-08fa-45c3-91e2-4f514a914b97",
+          "interface_key": "rest_api:GET /workstreams/",
+          "interface_kind": "rest_api",
+          "legacy_since": "2026-06-04T00:26:14.533764Z",
+          "replacement_ref": "/workplans/",
+          "owner_component": "state-hub.api",
+          "status": "legacy",
+          "replacement_verified": true,
+          "manual_hold": false,
+          "hold_reason": null,
+          "notes": null,
+          "retired_at": null,
+          "created_at": "2026-06-04T00:26:14.533764Z",
+          "updated_at": "2026-06-04T00:26:14.533764Z"
+        },
+        "all_time": {
+          "calls": 144086,
+          "tenant_count": 1,
+          "user_count": 1,
+          "component_count": 1,
+          "tenants": {
+            "unknown": 144086
+          },
+          "users": {
+            "unknown": 144086
+          },
+          "components": {
+            "unknown": 144086
+          }
+        },
+        "window": {
+          "calls": 0,
+          "tenant_count": 0,
+          "user_count": 0,
+          "component_count": 0,
+          "tenants": {},
+          "users": {},
+          "components": {}
+        },
+        "last_seen_at": "2026-08-10T18:06:05.032338Z",
+        "retirement_candidate": true,
+        "retirement_reason": "no measured usage in review window"
+      },
+      {
+        "interface": {
+          "id": "e4c140ec-7479-46f9-b185-4b533f19d639",
+          "interface_key": "rest_api:GET /workstreams/workplan-index",
+          "interface_kind": "rest_api",
+          "legacy_since": "2026-06-04T05:20:58.321869Z",
+          "replacement_ref": "/workplans/index",
+          "owner_component": "state-hub.api",
+          "status": "legacy",
+          "replacement_verified": true,
+          "manual_hold": false,
+          "hold_reason": null,
+          "notes": null,
+          "retired_at": null,
+          "created_at": "2026-06-04T05:20:58.321869Z",
+          "updated_at": "2026-06-04T05:20:58.321869Z"
+        },
+        "all_time": {
+          "calls": 30,
+          "tenant_count": 1,
+          "user_count": 1,
+          "component_count": 1,
+          "tenants": {
+            "unknown": 30
+          },
+          "users": {
+            "unknown": 30
+          },
+          "components": {
+            "unknown": 30
+          }
+        },
+        "window": {
+          "calls": 0,
+          "tenant_count": 0,
+          "user_count": 0,
+          "component_count": 0,
+          "tenants": {},
+          "users": {},
+          "components": {}
+        },
+        "last_seen_at": "2026-07-03T05:20:34.534439Z",
+        "retirement_candidate": true,
+        "retirement_reason": "no measured usage in review window"
+      },
+      {
+        "interface": {
+          "id": "3a00b19e-e7db-4403-98aa-a77c9ab61ecc",
+          "interface_key": "rest_api:GET /workstreams/{workstream_id}",
+          "interface_kind": "rest_api",
+          "legacy_since": "2026-06-04T00:25:59.014966Z",
+          "replacement_ref": "/workplans/{workplan_id}",
+          "owner_component": "state-hub.api",
+          "status": "legacy",
+          "replacement_verified": true,
+          "manual_hold": false,
+          "hold_reason": null,
+          "notes": null,
+          "retired_at": null,
+          "created_at": "2026-06-04T00:25:59.014966Z",
+          "updated_at": "2026-06-04T00:25:59.014966Z"
+        },
+        "all_time": {
+          "calls": 511406,
+          "tenant_count": 1,
+          "user_count": 1,
+          "component_count": 1,
+          "tenants": {
+            "unknown": 511406
+          },
+          "users": {
+            "unknown": 511406
+          },
+          "components": {
+            "unknown": 511406
+          }
+        },
+        "window": {
+          "calls": 0,
+          "tenant_count": 0,
+          "user_count": 0,
+          "component_count": 0,
+          "tenants": {},
+          "users": {},
+          "components": {}
+        },
+        "last_seen_at": "2026-07-31T16:25:32.004042Z",
+        "retirement_candidate": true,
+        "retirement_reason": "no measured usage in review window"
+      },
+      {
+        "interface": {
+          "id": "69e1a255-a8b9-4101-8a68-b1bed23abfda",
+          "interface_key": "rest_api:GET /workstreams/{workstream_id}/dependencies/",
+          "interface_kind": "rest_api",
+          "legacy_since": "2026-06-04T00:25:59.291135Z",
+          "replacement_ref": "/workplans/{workplan_id}/dependencies/",
+          "owner_component": "state-hub.api",
+          "status": "legacy",
+          "replacement_verified": true,
+          "manual_hold": false,
+          "hold_reason": null,
+          "notes": null,
+          "retired_at": null,
+          "created_at": "2026-06-04T00:25:59.291135Z",
+          "updated_at": "2026-06-04T00:25:59.291135Z"
+        },
+        "all_time": {
+          "calls": 255865,
+          "tenant_count": 1,
+          "user_count": 1,
+          "component_count": 1,
+          "tenants": {
+            "unknown": 255865
+          },
+          "users": {
+            "unknown": 255865
+          },
+          "components": {
+            "unknown": 255865
+          }
+        },
+        "window": {
+          "calls": 0,
+          "tenant_count": 0,
+          "user_count": 0,
+          "component_count": 0,
+          "tenants": {},
+          "users": {},
+          "components": {}
+        },
+        "last_seen_at": "2026-07-08T21:14:12.747005Z",
+        "retirement_candidate": true,
+        "retirement_reason": "no measured usage in review window"
+      },
+      {
+        "interface": {
+          "id": "b1aae931-b51f-4a85-a723-865dd65f6132",
+          "interface_key": "rest_api:PATCH /workstreams/{workstream_id}",
+          "interface_kind": "rest_api",
+          "legacy_since": "2026-06-04T06:09:41.901035Z",
+          "replacement_ref": "/workplans/{workplan_id}",
+          "owner_component": "state-hub.api",
+          "status": "legacy",
+          "replacement_verified": true,
+          "manual_hold": false,
+          "hold_reason": null,
+          "notes": null,
+          "retired_at": null,
+          "created_at": "2026-06-04T06:09:41.901035Z",
+          "updated_at": "2026-06-04T06:09:41.901035Z"
+        },
+        "all_time": {
+          "calls": 571,
+          "tenant_count": 1,
+          "user_count": 1,
+          "component_count": 1,
+          "tenants": {
+            "unknown": 571
+          },
+          "users": {
+            "unknown": 571
+          },
+          "components": {
+            "unknown": 571
+          }
+        },
+        "window": {
+          "calls": 0,
+          "tenant_count": 0,
+          "user_count": 0,
+          "component_count": 0,
+          "tenants": {},
+          "users": {},
+          "components": {}
+        },
+        "last_seen_at": "2026-07-08T20:49:12.335710Z",
+        "retirement_candidate": true,
+        "retirement_reason": "no measured usage in review window"
+      },
+      {
+        "interface": {
+          "id": "4aea9591-970b-4918-ac4a-4da95a0a1a8c",
+          "interface_key": "rest_api:POST /decisions/ workstream_id",
+          "interface_kind": "rest_api",
+          "legacy_since": "2026-07-09T22:56:35.473130Z",
+          "replacement_ref": "POST /decisions/ with workplan_id",
+          "owner_component": "state-hub.api",
+          "status": "legacy",
+          "replacement_verified": true,
+          "manual_hold": false,
+          "hold_reason": null,
+          "notes": null,
+          "retired_at": null,
+          "created_at": "2026-07-09T22:56:35.473130Z",
+          "updated_at": "2026-07-09T22:56:35.473130Z"
+        },
+        "all_time": {
+          "calls": 3,
+          "tenant_count": 1,
+          "user_count": 1,
+          "component_count": 1,
+          "tenants": {
+            "unknown": 3
+          },
+          "users": {
+            "unknown": 3
+          },
+          "components": {
+            "unknown": 3
+          }
+        },
+        "window": {
+          "calls": 0,
+          "tenant_count": 0,
+          "user_count": 0,
+          "component_count": 0,
+          "tenants": {},
+          "users": {},
+          "components": {}
+        },
+        "last_seen_at": "2026-07-09T22:57:05.912456Z",
+        "retirement_candidate": true,
+        "retirement_reason": "no measured usage in review window"
+      },
+      {
+        "interface": {
+          "id": "4a70583c-1e41-4ec1-99a9-728856a7d79c",
+          "interface_key": "rest_api:POST /progress/ workstream_id",
+          "interface_kind": "rest_api",
+          "legacy_since": "2026-07-08T23:35:09.148333Z",
+          "replacement_ref": "POST /progress/ with workplan_id",
+          "owner_component": "state-hub.api",
+          "status": "legacy",
+          "replacement_verified": true,
+          "manual_hold": false,
+          "hold_reason": null,
+          "notes": null,
+          "retired_at": null,
+          "created_at": "2026-07-08T23:35:09.148333Z",
+          "updated_at": "2026-07-08T23:35:09.148333Z"
+        },
+        "all_time": {
+          "calls": 14,
+          "tenant_count": 1,
+          "user_count": 1,
+          "component_count": 1,
+          "tenants": {
+            "unknown": 14
+          },
+          "users": {
+            "unknown": 14
+          },
+          "components": {
+            "unknown": 14
+          }
+        },
+        "window": {
+          "calls": 0,
+          "tenant_count": 0,
+          "user_count": 0,
+          "component_count": 0,
+          "tenants": {},
+          "users": {},
+          "components": {}
+        },
+        "last_seen_at": "2026-07-10T08:34:42.959724Z",
+        "retirement_candidate": true,
+        "retirement_reason": "no measured usage in review window"
+      },
+      {
+        "interface": {
+          "id": "6df4e443-7bf1-461a-923b-a6eb52fe7b07",
+          "interface_key": "rest_api:POST /tasks/ workstream_id",
+          "interface_kind": "rest_api",
+          "legacy_since": "2026-07-08T22:38:29.405720Z",
+          "replacement_ref": "POST /tasks/ with workplan_id",
+          "owner_component": "state-hub.api",
+          "status": "legacy",
+          "replacement_verified": true,
+          "manual_hold": false,
+          "hold_reason": null,
+          "notes": null,
+          "retired_at": null,
+          "created_at": "2026-07-08T22:38:29.405720Z",
+          "updated_at": "2026-07-08T22:38:29.405720Z"
+        },
+        "all_time": {
+          "calls": 5,
+          "tenant_count": 1,
+          "user_count": 1,
+          "component_count": 1,
+          "tenants": {
+            "unknown": 5
+          },
+          "users": {
+            "unknown": 5
+          },
+          "components": {
+            "state-hub.fix-consistency": 5
+          }
+        },
+        "window": {
+          "calls": 0,
+          "tenant_count": 0,
+          "user_count": 0,
+          "component_count": 0,
+          "tenants": {},
+          "users": {},
+          "components": {}
+        },
+        "last_seen_at": "2026-07-08T22:38:29.976918Z",
+        "retirement_candidate": true,
+        "retirement_reason": "no measured usage in review window"
+      },
+      {
+        "interface": {
+          "id": "ed6451c9-d2cc-4486-9afe-d3852782cabc",
+          "interface_key": "rest_api:POST /workstreams/",
+          "interface_kind": "rest_api",
+          "legacy_since": "2026-06-04T07:40:24.168535Z",
+          "replacement_ref": "/workplans/",
+          "owner_component": "state-hub.api",
+          "status": "legacy",
+          "replacement_verified": true,
+          "manual_hold": false,
+          "hold_reason": null,
+          "notes": null,
+          "retired_at": null,
+          "created_at": "2026-06-04T07:40:24.168535Z",
+          "updated_at": "2026-06-04T07:40:24.168535Z"
+        },
+        "all_time": {
+          "calls": 824,
+          "tenant_count": 1,
+          "user_count": 1,
+          "component_count": 1,
+          "tenants": {
+            "unknown": 824
+          },
+          "users": {
+            "unknown": 824
+          },
+          "components": {
+            "unknown": 824
+          }
+        },
+        "window": {
+          "calls": 0,
+          "tenant_count": 0,
+          "user_count": 0,
+          "component_count": 0,
+          "tenants": {},
+          "users": {},
+          "components": {}
+        },
+        "last_seen_at": "2026-07-08T20:38:05.903144Z",
+        "retirement_candidate": true,
+        "retirement_reason": "no measured usage in review window"
+      },
+      {
+        "interface": {
+          "id": "281fd706-b192-4194-8055-2d8733c115f9",
+          "interface_key": "rest_api:POST /workstreams/{workstream_id}/dependencies/",
+          "interface_kind": "rest_api",
+          "legacy_since": "2026-06-04T22:57:37.149207Z",
+          "replacement_ref": "/workplans/{workplan_id}/dependencies/",
+          "owner_component": "state-hub.api",
+          "status": "legacy",
+          "replacement_verified": true,
+          "manual_hold": false,
+          "hold_reason": null,
+          "notes": null,
+          "retired_at": null,
+          "created_at": "2026-06-04T22:57:37.149207Z",
+          "updated_at": "2026-06-04T22:57:37.149207Z"
+        },
+        "all_time": {
+          "calls": 4971,
+          "tenant_count": 1,
+          "user_count": 1,
+          "component_count": 1,
+          "tenants": {
+            "unknown": 4971
+          },
+          "users": {
+            "unknown": 4971
+          },
+          "components": {
+            "unknown": 4971
+          }
+        },
+        "window": {
+          "calls": 0,
+          "tenant_count": 0,
+          "user_count": 0,
+          "component_count": 0,
+          "tenants": {},
+          "users": {},
+          "components": {}
+        },
+        "last_seen_at": "2026-07-01T22:09:24.229011Z",
+        "retirement_candidate": true,
+        "retirement_reason": "no measured usage in review window"
+      }
+    ],
+    "retirement_candidates": [
+      {
+        "interface": {
+          "id": "63ed90e3-42b4-431a-94db-e1254a52f9e2",
+          "interface_key": "mcp:create_workstream",
+          "interface_kind": "mcp_tool",
+          "legacy_since": "2026-07-10T13:19:44.205900Z",
+          "replacement_ref": "create_workplan",
+          "owner_component": "state-hub.mcp",
+          "status": "legacy",
+          "replacement_verified": true,
+          "manual_hold": false,
+          "hold_reason": null,
+          "notes": "Registered by STATE-WP-0070 T03 \u2014 zero-window streak starts at registration",
+          "retired_at": null,
+          "created_at": "2026-07-10T13:19:44.205900Z",
+          "updated_at": "2026-07-10T13:19:44.205900Z"
+        },
+        "all_time": {
+          "calls": 2,
+          "tenant_count": 1,
+          "user_count": 1,
+          "component_count": 1,
+          "tenants": {
+            "unknown": 2
+          },
+          "users": {
+            "unknown": 2
+          },
+          "components": {
+            "state-hub.mcp": 2
+          }
+        },
+        "window": {
+          "calls": 0,
+          "tenant_count": 0,
+          "user_count": 0,
+          "component_count": 0,
+          "tenants": {},
+          "users": {},
+          "components": {}
+        },
+        "last_seen_at": "2026-07-10T13:20:43.378546Z",
+        "retirement_candidate": true,
+        "retirement_reason": "no measured usage in review window"
+      },
+      {
+        "interface": {
+          "id": "b6a5fe44-fb85-4ef7-a273-78d09da777af",
+          "interface_key": "mcp:list_workstreams",
+          "interface_kind": "mcp_tool",
+          "legacy_since": "2026-07-10T13:19:26.075491Z",
+          "replacement_ref": "list_workplans",
+          "owner_component": "state-hub.mcp",
+          "status": "legacy",
+          "replacement_verified": true,
+          "manual_hold": false,
+          "hold_reason": null,
+          "notes": null,
+          "retired_at": null,
+          "created_at": "2026-07-10T13:19:26.075491Z",
+          "updated_at": "2026-07-10T13:19:26.075491Z"
+        },
+        "all_time": {
+          "calls": 2,
+          "tenant_count": 1,
+          "user_count": 1,
+          "component_count": 1,
+          "tenants": {
+            "unknown": 2
+          },
+          "users": {
+            "unknown": 2
+          },
+          "components": {
+            "state-hub.mcp": 2
+          }
+        },
+        "window": {
+          "calls": 0,
+          "tenant_count": 0,
+          "user_count": 0,
+          "component_count": 0,
+          "tenants": {},
+          "users": {},
+          "components": {}
+        },
+        "last_seen_at": "2026-07-10T13:20:42.374940Z",
+        "retirement_candidate": true,
+        "retirement_reason": "no measured usage in review window"
+      },
+      {
+        "interface": {
+          "id": "53c3372b-307d-4d6a-8ea4-bc36cacdcaf2",
+          "interface_key": "mcp:update_workstream",
+          "interface_kind": "mcp_tool",
+          "legacy_since": "2026-07-10T13:19:44.255216Z",
+          "replacement_ref": "update_workplan",
+          "owner_component": "state-hub.mcp",
+          "status": "legacy",
+          "replacement_verified": true,
+          "manual_hold": false,
+          "hold_reason": null,
+          "notes": "Registered by STATE-WP-0070 T03 \u2014 zero-window streak starts at registration",
+          "retired_at": null,
+          "created_at": "2026-07-10T13:19:44.255216Z",
+          "updated_at": "2026-07-10T13:19:44.255216Z"
+        },
+        "all_time": {
+          "calls": 0,
+          "tenant_count": 0,
+          "user_count": 0,
+          "component_count": 0,
+          "tenants": {},
+          "users": {},
+          "components": {}
+        },
+        "window": {
+          "calls": 0,
+          "tenant_count": 0,
+          "user_count": 0,
+          "component_count": 0,
+          "tenants": {},
+          "users": {},
+          "components": {}
+        },
+        "last_seen_at": null,
+        "retirement_candidate": true,
+        "retirement_reason": "no measured usage in review window"
+      },
+      {
+        "interface": {
+          "id": "bed4d08a-3471-48f5-9f0e-f9d550383a26",
+          "interface_key": "mcp:update_workstream_status",
+          "interface_kind": "mcp_tool",
+          "legacy_since": "2026-07-10T13:19:44.303612Z",
+          "replacement_ref": "update_workplan_status",
+          "owner_component": "state-hub.mcp",
+          "status": "legacy",
+          "replacement_verified": true,
+          "manual_hold": false,
+          "hold_reason": null,
+          "notes": "Registered by STATE-WP-0070 T03 \u2014 zero-window streak starts at registration",
+          "retired_at": null,
+          "created_at": "2026-07-10T13:19:44.303612Z",
+          "updated_at": "2026-07-10T13:19:44.303612Z"
+        },
+        "all_time": {
+          "calls": 0,
+          "tenant_count": 0,
+          "user_count": 0,
+          "component_count": 0,
+          "tenants": {},
+          "users": {},
+          "components": {}
+        },
+        "window": {
+          "calls": 0,
+          "tenant_count": 0,
+          "user_count": 0,
+          "component_count": 0,
+          "tenants": {},
+          "users": {},
+          "components": {}
+        },
+        "last_seen_at": null,
+        "retirement_candidate": true,
+        "retirement_reason": "no measured usage in review window"
+      },
+      {
+        "interface": {
+          "id": "46900dc2-0893-405b-ba59-80f31fb6ebb1",
+          "interface_key": "state://workstreams/{topic_slug}",
+          "interface_kind": "mcp_tool",
+          "legacy_since": "2026-07-10T13:19:44.344493Z",
+          "replacement_ref": "state://workplans/{topic_slug}",
+          "owner_component": "state-hub.mcp",
+          "status": "legacy",
+          "replacement_verified": true,
+          "manual_hold": false,
+          "hold_reason": null,
+          "notes": "Registered by STATE-WP-0070 T03 \u2014 zero-window streak starts at registration",
+          "retired_at": null,
+          "created_at": "2026-07-10T13:19:44.344493Z",
+          "updated_at": "2026-07-10T13:19:44.344493Z"
+        },
+        "all_time": {
+          "calls": 1,
+          "tenant_count": 1,
+          "user_count": 1,
+          "component_count": 1,
+          "tenants": {
+            "unknown": 1
+          },
+          "users": {
+            "unknown": 1
+          },
+          "components": {
+            "state-hub.mcp": 1
+          }
+        },
+        "window": {
+          "calls": 0,
+          "tenant_count": 0,
+          "user_count": 0,
+          "component_count": 0,
+          "tenants": {},
+          "users": {},
+          "components": {}
+        },
+        "last_seen_at": "2026-07-10T13:20:34.491811Z",
+        "retirement_candidate": true,
+        "retirement_reason": "no measured usage in review window"
+      },
+      {
+        "interface": {
+          "id": "cd9342fd-27e7-4a46-a1be-d41499e106a3",
+          "interface_key": "rest_api:DELETE /workstreams/{workstream_id}",
+          "interface_kind": "rest_api",
+          "legacy_since": "2026-06-06T17:28:13.052813Z",
+          "replacement_ref": "/workplans/{workplan_id}",
+          "owner_component": "state-hub.api",
+          "status": "legacy",
+          "replacement_verified": true,
+          "manual_hold": false,
+          "hold_reason": null,
+          "notes": null,
+          "retired_at": null,
+          "created_at": "2026-06-06T17:28:13.052813Z",
+          "updated_at": "2026-06-06T17:28:13.052813Z"
+        },
+        "all_time": {
+          "calls": 1,
+          "tenant_count": 1,
+          "user_count": 1,
+          "component_count": 1,
+          "tenants": {
+            "unknown": 1
+          },
+          "users": {
+            "unknown": 1
+          },
+          "components": {
+            "unknown": 1
+          }
+        },
+        "window": {
+          "calls": 0,
+          "tenant_count": 0,
+          "user_count": 0,
+          "component_count": 0,
+          "tenants": {},
+          "users": {},
+          "components": {}
+        },
+        "last_seen_at": "2026-06-06T17:28:13.047529Z",
+        "retirement_candidate": true,
+        "retirement_reason": "no measured usage in review window"
+      },
+      {
+        "interface": {
+          "id": "a4e0948c-cd4a-461e-8ae2-7fd7b51d04a7",
+          "interface_key": "rest_api:GET /decisions/?workstream_id",
+          "interface_kind": "rest_api",
+          "legacy_since": "2026-07-09T23:07:53.093223Z",
+          "replacement_ref": "/decisions/?workplan_id=<workplan_id>",
+          "owner_component": "state-hub.api",
+          "status": "legacy",
+          "replacement_verified": true,
+          "manual_hold": false,
+          "hold_reason": null,
+          "notes": null,
+          "retired_at": null,
+          "created_at": "2026-07-09T23:07:53.093223Z",
+          "updated_at": "2026-07-09T23:07:53.093223Z"
+        },
+        "all_time": {
+          "calls": 1,
+          "tenant_count": 1,
+          "user_count": 1,
+          "component_count": 1,
+          "tenants": {
+            "unknown": 1
+          },
+          "users": {
+            "unknown": 1
+          },
+          "components": {
+            "unknown": 1
+          }
+        },
+        "window": {
+          "calls": 0,
+          "tenant_count": 0,
+          "user_count": 0,
+          "component_count": 0,
+          "tenants": {},
+          "users": {},
+          "components": {}
+        },
+        "last_seen_at": "2026-07-09T23:07:53.083299Z",
+        "retirement_candidate": true,
+        "retirement_reason": "no measured usage in review window"
+      },
+      {
+        "interface": {
+          "id": "70a9346e-e0ee-42ac-874f-f160580b54dd",
+          "interface_key": "rest_api:GET /progress/?workstream_id",
+          "interface_kind": "rest_api",
+          "legacy_since": "2026-07-13T22:04:03.911449Z",
+          "replacement_ref": "/progress/?workplan_id=<workplan_id>",
+          "owner_component": "state-hub.api",
+          "status": "legacy",
+          "replacement_verified": true,
+          "manual_hold": false,
+          "hold_reason": null,
+          "notes": null,
+          "retired_at": null,
+          "created_at": "2026-07-13T22:04:03.911449Z",
+          "updated_at": "2026-07-13T22:04:03.911449Z"
+        },
+        "all_time": {
+          "calls": 2,
+          "tenant_count": 1,
+          "user_count": 1,
+          "component_count": 1,
+          "tenants": {
+            "unknown": 2
+          },
+          "users": {
+            "unknown": 2
+          },
+          "components": {
+            "unknown": 2
+          }
+        },
+        "window": {
+          "calls": 0,
+          "tenant_count": 0,
+          "user_count": 0,
+          "component_count": 0,
+          "tenants": {},
+          "users": {},
+          "components": {}
+        },
+        "last_seen_at": "2026-08-12T08:55:33.912995Z",
+        "retirement_candidate": true,
+        "retirement_reason": "no measured usage in review window"
+      },
+      {
+        "interface": {
+          "id": "be3cdcf8-250b-4bf0-801f-02ffd5f57e00",
+          "interface_key": "rest_api:GET /tasks/?workstream_id",
+          "interface_kind": "rest_api",
+          "legacy_since": "2026-07-08T19:32:21.628513Z",
+          "replacement_ref": "/tasks/?workplan_id=<workplan_id>",
+          "owner_component": "state-hub.api",
+          "status": "legacy",
+          "replacement_verified": true,
+          "manual_hold": false,
+          "hold_reason": null,
+          "notes": null,
+          "retired_at": null,
+          "created_at": "2026-07-08T19:32:21.628513Z",
+          "updated_at": "2026-07-08T19:32:21.628513Z"
+        },
+        "all_time": {
+          "calls": 590,
+          "tenant_count": 1,
+          "user_count": 1,
+          "component_count": 1,
+          "tenants": {
+            "unknown": 590
+          },
+          "users": {
+            "unknown": 590
+          },
+          "components": {
+            "unknown": 590
+          }
+        },
+        "window": {
+          "calls": 0,
+          "tenant_count": 0,
+          "user_count": 0,
+          "component_count": 0,
+          "tenants": {},
+          "users": {},
+          "components": {}
+        },
+        "last_seen_at": "2026-08-12T08:55:27.763102Z",
+        "retirement_candidate": true,
+        "retirement_reason": "no measured usage in review window"
+      },
+      {
+        "interface": {
+          "id": "3e4a3d0b-08fa-45c3-91e2-4f514a914b97",
+          "interface_key": "rest_api:GET /workstreams/",
+          "interface_kind": "rest_api",
+          "legacy_since": "2026-06-04T00:26:14.533764Z",
+          "replacement_ref": "/workplans/",
+          "owner_component": "state-hub.api",
+          "status": "legacy",
+          "replacement_verified": true,
+          "manual_hold": false,
+          "hold_reason": null,
+          "notes": null,
+          "retired_at": null,
+          "created_at": "2026-06-04T00:26:14.533764Z",
+          "updated_at": "2026-06-04T00:26:14.533764Z"
+        },
+        "all_time": {
+          "calls": 144086,
+          "tenant_count": 1,
+          "user_count": 1,
+          "component_count": 1,
+          "tenants": {
+            "unknown": 144086
+          },
+          "users": {
+            "unknown": 144086
+          },
+          "components": {
+            "unknown": 144086
+          }
+        },
+        "window": {
+          "calls": 0,
+          "tenant_count": 0,
+          "user_count": 0,
+          "component_count": 0,
+          "tenants": {},
+          "users": {},
+          "components": {}
+        },
+        "last_seen_at": "2026-08-10T18:06:05.032338Z",
+        "retirement_candidate": true,
+        "retirement_reason": "no measured usage in review window"
+      },
+      {
+        "interface": {
+          "id": "e4c140ec-7479-46f9-b185-4b533f19d639",
+          "interface_key": "rest_api:GET /workstreams/workplan-index",
+          "interface_kind": "rest_api",
+          "legacy_since": "2026-06-04T05:20:58.321869Z",
+          "replacement_ref": "/workplans/index",
+          "owner_component": "state-hub.api",
+          "status": "legacy",
+          "replacement_verified": true,
+          "manual_hold": false,
+          "hold_reason": null,
+          "notes": null,
+          "retired_at": null,
+          "created_at": "2026-06-04T05:20:58.321869Z",
+          "updated_at": "2026-06-04T05:20:58.321869Z"
+        },
+        "all_time": {
+          "calls": 30,
+          "tenant_count": 1,
+          "user_count": 1,
+          "component_count": 1,
+          "tenants": {
+            "unknown": 30
+          },
+          "users": {
+            "unknown": 30
+          },
+          "components": {
+            "unknown": 30
+          }
+        },
+        "window": {
+          "calls": 0,
+          "tenant_count": 0,
+          "user_count": 0,
+          "component_count": 0,
+          "tenants": {},
+          "users": {},
+          "components": {}
+        },
+        "last_seen_at": "2026-07-03T05:20:34.534439Z",
+        "retirement_candidate": true,
+        "retirement_reason": "no measured usage in review window"
+      },
+      {
+        "interface": {
+          "id": "3a00b19e-e7db-4403-98aa-a77c9ab61ecc",
+          "interface_key": "rest_api:GET /workstreams/{workstream_id}",
+          "interface_kind": "rest_api",
+          "legacy_since": "2026-06-04T00:25:59.014966Z",
+          "replacement_ref": "/workplans/{workplan_id}",
+          "owner_component": "state-hub.api",
+          "status": "legacy",
+          "replacement_verified": true,
+          "manual_hold": false,
+          "hold_reason": null,
+          "notes": null,
+          "retired_at": null,
+          "created_at": "2026-06-04T00:25:59.014966Z",
+          "updated_at": "2026-06-04T00:25:59.014966Z"
+        },
+        "all_time": {
+          "calls": 511406,
+          "tenant_count": 1,
+          "user_count": 1,
+          "component_count": 1,
+          "tenants": {
+            "unknown": 511406
+          },
+          "users": {
+            "unknown": 511406
+          },
+          "components": {
+            "unknown": 511406
+          }
+        },
+        "window": {
+          "calls": 0,
+          "tenant_count": 0,
+          "user_count": 0,
+          "component_count": 0,
+          "tenants": {},
+          "users": {},
+          "components": {}
+        },
+        "last_seen_at": "2026-07-31T16:25:32.004042Z",
+        "retirement_candidate": true,
+        "retirement_reason": "no measured usage in review window"
+      },
+      {
+        "interface": {
+          "id": "69e1a255-a8b9-4101-8a68-b1bed23abfda",
+          "interface_key": "rest_api:GET /workstreams/{workstream_id}/dependencies/",
+          "interface_kind": "rest_api",
+          "legacy_since": "2026-06-04T00:25:59.291135Z",
+          "replacement_ref": "/workplans/{workplan_id}/dependencies/",
+          "owner_component": "state-hub.api",
+          "status": "legacy",
+          "replacement_verified": true,
+          "manual_hold": false,
+          "hold_reason": null,
+          "notes": null,
+          "retired_at": null,
+          "created_at": "2026-06-04T00:25:59.291135Z",
+          "updated_at": "2026-06-04T00:25:59.291135Z"
+        },
+        "all_time": {
+          "calls": 255865,
+          "tenant_count": 1,
+          "user_count": 1,
+          "component_count": 1,
+          "tenants": {
+            "unknown": 255865
+          },
+          "users": {
+            "unknown": 255865
+          },
+          "components": {
+            "unknown": 255865
+          }
+        },
+        "window": {
+          "calls": 0,
+          "tenant_count": 0,
+          "user_count": 0,
+          "component_count": 0,
+          "tenants": {},
+          "users": {},
+          "components": {}
+        },
+        "last_seen_at": "2026-07-08T21:14:12.747005Z",
+        "retirement_candidate": true,
+        "retirement_reason": "no measured usage in review window"
+      },
+      {
+        "interface": {
+          "id": "b1aae931-b51f-4a85-a723-865dd65f6132",
+          "interface_key": "rest_api:PATCH /workstreams/{workstream_id}",
+          "interface_kind": "rest_api",
+          "legacy_since": "2026-06-04T06:09:41.901035Z",
+          "replacement_ref": "/workplans/{workplan_id}",
+          "owner_component": "state-hub.api",
+          "status": "legacy",
+          "replacement_verified": true,
+          "manual_hold": false,
+          "hold_reason": null,
+          "notes": null,
+          "retired_at": null,
+          "created_at": "2026-06-04T06:09:41.901035Z",
+          "updated_at": "2026-06-04T06:09:41.901035Z"
+        },
+        "all_time": {
+          "calls": 571,
+          "tenant_count": 1,
+          "user_count": 1,
+          "component_count": 1,
+          "tenants": {
+            "unknown": 571
+          },
+          "users": {
+            "unknown": 571
+          },
+          "components": {
+            "unknown": 571
+          }
+        },
+        "window": {
+          "calls": 0,
+          "tenant_count": 0,
+          "user_count": 0,
+          "component_count": 0,
+          "tenants": {},
+          "users": {},
+          "components": {}
+        },
+        "last_seen_at": "2026-07-08T20:49:12.335710Z",
+        "retirement_candidate": true,
+        "retirement_reason": "no measured usage in review window"
+      },
+      {
+        "interface": {
+          "id": "4aea9591-970b-4918-ac4a-4da95a0a1a8c",
+          "interface_key": "rest_api:POST /decisions/ workstream_id",
+          "interface_kind": "rest_api",
+          "legacy_since": "2026-07-09T22:56:35.473130Z",
+          "replacement_ref": "POST /decisions/ with workplan_id",
+          "owner_component": "state-hub.api",
+          "status": "legacy",
+          "replacement_verified": true,
+          "manual_hold": false,
+          "hold_reason": null,
+          "notes": null,
+          "retired_at": null,
+          "created_at": "2026-07-09T22:56:35.473130Z",
+          "updated_at": "2026-07-09T22:56:35.473130Z"
+        },
+        "all_time": {
+          "calls": 3,
+          "tenant_count": 1,
+          "user_count": 1,
+          "component_count": 1,
+          "tenants": {
+            "unknown": 3
+          },
+          "users": {
+            "unknown": 3
+          },
+          "components": {
+            "unknown": 3
+          }
+        },
+        "window": {
+          "calls": 0,
+          "tenant_count": 0,
+          "user_count": 0,
+          "component_count": 0,
+          "tenants": {},
+          "users": {},
+          "components": {}
+        },
+        "last_seen_at": "2026-07-09T22:57:05.912456Z",
+        "retirement_candidate": true,
+        "retirement_reason": "no measured usage in review window"
+      },
+      {
+        "interface": {
+          "id": "4a70583c-1e41-4ec1-99a9-728856a7d79c",
+          "interface_key": "rest_api:POST /progress/ workstream_id",
+          "interface_kind": "rest_api",
+          "legacy_since": "2026-07-08T23:35:09.148333Z",
+          "replacement_ref": "POST /progress/ with workplan_id",
+          "owner_component": "state-hub.api",
+          "status": "legacy",
+          "replacement_verified": true,
+          "manual_hold": false,
+          "hold_reason": null,
+          "notes": null,
+          "retired_at": null,
+          "created_at": "2026-07-08T23:35:09.148333Z",
+          "updated_at": "2026-07-08T23:35:09.148333Z"
+        },
+        "all_time": {
+          "calls": 14,
+          "tenant_count": 1,
+          "user_count": 1,
+          "component_count": 1,
+          "tenants": {
+            "unknown": 14
+          },
+          "users": {
+            "unknown": 14
+          },
+          "components": {
+            "unknown": 14
+          }
+        },
+        "window": {
+          "calls": 0,
+          "tenant_count": 0,
+          "user_count": 0,
+          "component_count": 0,
+          "tenants": {},
+          "users": {},
+          "components": {}
+        },
+        "last_seen_at": "2026-07-10T08:34:42.959724Z",
+        "retirement_candidate": true,
+        "retirement_reason": "no measured usage in review window"
+      },
+      {
+        "interface": {
+          "id": "6df4e443-7bf1-461a-923b-a6eb52fe7b07",
+          "interface_key": "rest_api:POST /tasks/ workstream_id",
+          "interface_kind": "rest_api",
+          "legacy_since": "2026-07-08T22:38:29.405720Z",
+          "replacement_ref": "POST /tasks/ with workplan_id",
+          "owner_component": "state-hub.api",
+          "status": "legacy",
+          "replacement_verified": true,
+          "manual_hold": false,
+          "hold_reason": null,
+          "notes": null,
+          "retired_at": null,
+          "created_at": "2026-07-08T22:38:29.405720Z",
+          "updated_at": "2026-07-08T22:38:29.405720Z"
+        },
+        "all_time": {
+          "calls": 5,
+          "tenant_count": 1,
+          "user_count": 1,
+          "component_count": 1,
+          "tenants": {
+            "unknown": 5
+          },
+          "users": {
+            "unknown": 5
+          },
+          "components": {
+            "state-hub.fix-consistency": 5
+          }
+        },
+        "window": {
+          "calls": 0,
+          "tenant_count": 0,
+          "user_count": 0,
+          "component_count": 0,
+          "tenants": {},
+          "users": {},
+          "components": {}
+        },
+        "last_seen_at": "2026-07-08T22:38:29.976918Z",
+        "retirement_candidate": true,
+        "retirement_reason": "no measured usage in review window"
+      },
+      {
+        "interface": {
+          "id": "ed6451c9-d2cc-4486-9afe-d3852782cabc",
+          "interface_key": "rest_api:POST /workstreams/",
+          "interface_kind": "rest_api",
+          "legacy_since": "2026-06-04T07:40:24.168535Z",
+          "replacement_ref": "/workplans/",
+          "owner_component": "state-hub.api",
+          "status": "legacy",
+          "replacement_verified": true,
+          "manual_hold": false,
+          "hold_reason": null,
+          "notes": null,
+          "retired_at": null,
+          "created_at": "2026-06-04T07:40:24.168535Z",
+          "updated_at": "2026-06-04T07:40:24.168535Z"
+        },
+        "all_time": {
+          "calls": 824,
+          "tenant_count": 1,
+          "user_count": 1,
+          "component_count": 1,
+          "tenants": {
+            "unknown": 824
+          },
+          "users": {
+            "unknown": 824
+          },
+          "components": {
+            "unknown": 824
+          }
+        },
+        "window": {
+          "calls": 0,
+          "tenant_count": 0,
+          "user_count": 0,
+          "component_count": 0,
+          "tenants": {},
+          "users": {},
+          "components": {}
+        },
+        "last_seen_at": "2026-07-08T20:38:05.903144Z",
+        "retirement_candidate": true,
+        "retirement_reason": "no measured usage in review window"
+      },
+      {
+        "interface": {
+          "id": "281fd706-b192-4194-8055-2d8733c115f9",
+          "interface_key": "rest_api:POST /workstreams/{workstream_id}/dependencies/",
+          "interface_kind": "rest_api",
+          "legacy_since": "2026-06-04T22:57:37.149207Z",
+          "replacement_ref": "/workplans/{workplan_id}/dependencies/",
+          "owner_component": "state-hub.api",
+          "status": "legacy",
+          "replacement_verified": true,
+          "manual_hold": false,
+          "hold_reason": null,
+          "notes": null,
+          "retired_at": null,
+          "created_at": "2026-06-04T22:57:37.149207Z",
+          "updated_at": "2026-06-04T22:57:37.149207Z"
+        },
+        "all_time": {
+          "calls": 4971,
+          "tenant_count": 1,
+          "user_count": 1,
+          "component_count": 1,
+          "tenants": {
+            "unknown": 4971
+          },
+          "users": {
+            "unknown": 4971
+          },
+          "components": {
+            "unknown": 4971
+          }
+        },
+        "window": {
+          "calls": 0,
+          "tenant_count": 0,
+          "user_count": 0,
+          "component_count": 0,
+          "tenants": {},
+          "users": {},
+          "components": {}
+        },
+        "last_seen_at": "2026-07-01T22:09:24.229011Z",
+        "retirement_candidate": true,
+        "retirement_reason": "no measured usage in review window"
+      }
+    ]
+  },
+  "hours": 8
+}
diff --git a/docs/evidence/legacy-meter-weekly-review-20260814.json b/docs/evidence/legacy-meter-weekly-review-20260814.json
new file mode 100644
index 0000000..edc64d1
--- /dev/null
+++ b/docs/evidence/legacy-meter-weekly-review-20260814.json
@@ -0,0 +1,1755 @@
+{
+  "captured_at": "2026-08-14T14:00:07.080388+00:00",
+  "api_base": "http://127.0.0.1:8000",
+  "workplan": "STATE-WP-0070",
+  "retired_interfaces": [],
+  "weekly_review": {
+    "generated_at": "2026-08-14T14:00:07.074501Z",
+    "window_start": "2026-08-14T06:00:07.012488Z",
+    "window_end": "2026-08-14T14:00:07.012488Z",
+    "cadence": "weekly",
+    "activity_core_handoff": {
+      "activity_id": "statehub-legacy-interface-review",
+      "cadence": "weekly",
+      "source_endpoint": "/legacy-meter/weekly-review",
+      "state_owner": "state-hub",
+      "scheduler_owner": "activity-core"
+    },
+    "interfaces": [
+      {
+        "interface": {
+          "id": "8051fb40-66c9-4dc4-a413-13e8573e04a3",
+          "interface_key": "event_subject:org.statehub.workstream.completed",
+          "interface_kind": "event_subject",
+          "legacy_since": "2026-06-04T06:09:42.198193Z",
+          "replacement_ref": "org.statehub.workplan.completed",
+          "owner_component": "state-hub.events",
+          "status": "retired",
+          "replacement_verified": true,
+          "manual_hold": false,
+          "hold_reason": null,
+          "notes": "Retired by STATE-WP-0069 closeout",
+          "retired_at": "2026-07-08T21:38:52.773601Z",
+          "created_at": "2026-06-04T06:09:42.198193Z",
+          "updated_at": "2026-07-08T21:38:52.761243Z"
+        },
+        "all_time": {
+          "calls": 255,
+          "tenant_count": 1,
+          "user_count": 1,
+          "component_count": 1,
+          "tenants": {
+            "unknown": 255
+          },
+          "users": {
+            "unknown": 255
+          },
+          "components": {
+            "state-hub.events": 255
+          }
+        },
+        "window": {
+          "calls": 0,
+          "tenant_count": 0,
+          "user_count": 0,
+          "component_count": 0,
+          "tenants": {},
+          "users": {},
+          "components": {}
+        },
+        "last_seen_at": "2026-07-08T20:49:12.839383Z",
+        "retirement_candidate": false,
+        "retirement_reason": "already retired"
+      },
+      {
+        "interface": {
+          "id": "63ed90e3-42b4-431a-94db-e1254a52f9e2",
+          "interface_key": "mcp:create_workstream",
+          "interface_kind": "mcp_tool",
+          "legacy_since": "2026-07-10T13:19:44.205900Z",
+          "replacement_ref": "create_workplan",
+          "owner_component": "state-hub.mcp",
+          "status": "legacy",
+          "replacement_verified": true,
+          "manual_hold": false,
+          "hold_reason": null,
+          "notes": "Registered by STATE-WP-0070 T03 \u2014 zero-window streak starts at registration",
+          "retired_at": null,
+          "created_at": "2026-07-10T13:19:44.205900Z",
+          "updated_at": "2026-07-10T13:19:44.205900Z"
+        },
+        "all_time": {
+          "calls": 2,
+          "tenant_count": 1,
+          "user_count": 1,
+          "component_count": 1,
+          "tenants": {
+            "unknown": 2
+          },
+          "users": {
+            "unknown": 2
+          },
+          "components": {
+            "state-hub.mcp": 2
+          }
+        },
+        "window": {
+          "calls": 0,
+          "tenant_count": 0,
+          "user_count": 0,
+          "component_count": 0,
+          "tenants": {},
+          "users": {},
+          "components": {}
+        },
+        "last_seen_at": "2026-07-10T13:20:43.378546Z",
+        "retirement_candidate": true,
+        "retirement_reason": "no measured usage in review window"
+      },
+      {
+        "interface": {
+          "id": "b6a5fe44-fb85-4ef7-a273-78d09da777af",
+          "interface_key": "mcp:list_workstreams",
+          "interface_kind": "mcp_tool",
+          "legacy_since": "2026-07-10T13:19:26.075491Z",
+          "replacement_ref": "list_workplans",
+          "owner_component": "state-hub.mcp",
+          "status": "legacy",
+          "replacement_verified": true,
+          "manual_hold": false,
+          "hold_reason": null,
+          "notes": null,
+          "retired_at": null,
+          "created_at": "2026-07-10T13:19:26.075491Z",
+          "updated_at": "2026-07-10T13:19:26.075491Z"
+        },
+        "all_time": {
+          "calls": 2,
+          "tenant_count": 1,
+          "user_count": 1,
+          "component_count": 1,
+          "tenants": {
+            "unknown": 2
+          },
+          "users": {
+            "unknown": 2
+          },
+          "components": {
+            "state-hub.mcp": 2
+          }
+        },
+        "window": {
+          "calls": 0,
+          "tenant_count": 0,
+          "user_count": 0,
+          "component_count": 0,
+          "tenants": {},
+          "users": {},
+          "components": {}
+        },
+        "last_seen_at": "2026-07-10T13:20:42.374940Z",
+        "retirement_candidate": true,
+        "retirement_reason": "no measured usage in review window"
+      },
+      {
+        "interface": {
+          "id": "53c3372b-307d-4d6a-8ea4-bc36cacdcaf2",
+          "interface_key": "mcp:update_workstream",
+          "interface_kind": "mcp_tool",
+          "legacy_since": "2026-07-10T13:19:44.255216Z",
+          "replacement_ref": "update_workplan",
+          "owner_component": "state-hub.mcp",
+          "status": "legacy",
+          "replacement_verified": true,
+          "manual_hold": false,
+          "hold_reason": null,
+          "notes": "Registered by STATE-WP-0070 T03 \u2014 zero-window streak starts at registration",
+          "retired_at": null,
+          "created_at": "2026-07-10T13:19:44.255216Z",
+          "updated_at": "2026-07-10T13:19:44.255216Z"
+        },
+        "all_time": {
+          "calls": 0,
+          "tenant_count": 0,
+          "user_count": 0,
+          "component_count": 0,
+          "tenants": {},
+          "users": {},
+          "components": {}
+        },
+        "window": {
+          "calls": 0,
+          "tenant_count": 0,
+          "user_count": 0,
+          "component_count": 0,
+          "tenants": {},
+          "users": {},
+          "components": {}
+        },
+        "last_seen_at": null,
+        "retirement_candidate": true,
+        "retirement_reason": "no measured usage in review window"
+      },
+      {
+        "interface": {
+          "id": "bed4d08a-3471-48f5-9f0e-f9d550383a26",
+          "interface_key": "mcp:update_workstream_status",
+          "interface_kind": "mcp_tool",
+          "legacy_since": "2026-07-10T13:19:44.303612Z",
+          "replacement_ref": "update_workplan_status",
+          "owner_component": "state-hub.mcp",
+          "status": "legacy",
+          "replacement_verified": true,
+          "manual_hold": false,
+          "hold_reason": null,
+          "notes": "Registered by STATE-WP-0070 T03 \u2014 zero-window streak starts at registration",
+          "retired_at": null,
+          "created_at": "2026-07-10T13:19:44.303612Z",
+          "updated_at": "2026-07-10T13:19:44.303612Z"
+        },
+        "all_time": {
+          "calls": 0,
+          "tenant_count": 0,
+          "user_count": 0,
+          "component_count": 0,
+          "tenants": {},
+          "users": {},
+          "components": {}
+        },
+        "window": {
+          "calls": 0,
+          "tenant_count": 0,
+          "user_count": 0,
+          "component_count": 0,
+          "tenants": {},
+          "users": {},
+          "components": {}
+        },
+        "last_seen_at": null,
+        "retirement_candidate": true,
+        "retirement_reason": "no measured usage in review window"
+      },
+      {
+        "interface": {
+          "id": "46900dc2-0893-405b-ba59-80f31fb6ebb1",
+          "interface_key": "state://workstreams/{topic_slug}",
+          "interface_kind": "mcp_tool",
+          "legacy_since": "2026-07-10T13:19:44.344493Z",
+          "replacement_ref": "state://workplans/{topic_slug}",
+          "owner_component": "state-hub.mcp",
+          "status": "legacy",
+          "replacement_verified": true,
+          "manual_hold": false,
+          "hold_reason": null,
+          "notes": "Registered by STATE-WP-0070 T03 \u2014 zero-window streak starts at registration",
+          "retired_at": null,
+          "created_at": "2026-07-10T13:19:44.344493Z",
+          "updated_at": "2026-07-10T13:19:44.344493Z"
+        },
+        "all_time": {
+          "calls": 1,
+          "tenant_count": 1,
+          "user_count": 1,
+          "component_count": 1,
+          "tenants": {
+            "unknown": 1
+          },
+          "users": {
+            "unknown": 1
+          },
+          "components": {
+            "state-hub.mcp": 1
+          }
+        },
+        "window": {
+          "calls": 0,
+          "tenant_count": 0,
+          "user_count": 0,
+          "component_count": 0,
+          "tenants": {},
+          "users": {},
+          "components": {}
+        },
+        "last_seen_at": "2026-07-10T13:20:34.491811Z",
+        "retirement_candidate": true,
+        "retirement_reason": "no measured usage in review window"
+      },
+      {
+        "interface": {
+          "id": "cd9342fd-27e7-4a46-a1be-d41499e106a3",
+          "interface_key": "rest_api:DELETE /workstreams/{workstream_id}",
+          "interface_kind": "rest_api",
+          "legacy_since": "2026-06-06T17:28:13.052813Z",
+          "replacement_ref": "/workplans/{workplan_id}",
+          "owner_component": "state-hub.api",
+          "status": "legacy",
+          "replacement_verified": true,
+          "manual_hold": false,
+          "hold_reason": null,
+          "notes": null,
+          "retired_at": null,
+          "created_at": "2026-06-06T17:28:13.052813Z",
+          "updated_at": "2026-06-06T17:28:13.052813Z"
+        },
+        "all_time": {
+          "calls": 1,
+          "tenant_count": 1,
+          "user_count": 1,
+          "component_count": 1,
+          "tenants": {
+            "unknown": 1
+          },
+          "users": {
+            "unknown": 1
+          },
+          "components": {
+            "unknown": 1
+          }
+        },
+        "window": {
+          "calls": 0,
+          "tenant_count": 0,
+          "user_count": 0,
+          "component_count": 0,
+          "tenants": {},
+          "users": {},
+          "components": {}
+        },
+        "last_seen_at": "2026-06-06T17:28:13.047529Z",
+        "retirement_candidate": true,
+        "retirement_reason": "no measured usage in review window"
+      },
+      {
+        "interface": {
+          "id": "a4e0948c-cd4a-461e-8ae2-7fd7b51d04a7",
+          "interface_key": "rest_api:GET /decisions/?workstream_id",
+          "interface_kind": "rest_api",
+          "legacy_since": "2026-07-09T23:07:53.093223Z",
+          "replacement_ref": "/decisions/?workplan_id=<workplan_id>",
+          "owner_component": "state-hub.api",
+          "status": "legacy",
+          "replacement_verified": true,
+          "manual_hold": false,
+          "hold_reason": null,
+          "notes": null,
+          "retired_at": null,
+          "created_at": "2026-07-09T23:07:53.093223Z",
+          "updated_at": "2026-07-09T23:07:53.093223Z"
+        },
+        "all_time": {
+          "calls": 1,
+          "tenant_count": 1,
+          "user_count": 1,
+          "component_count": 1,
+          "tenants": {
+            "unknown": 1
+          },
+          "users": {
+            "unknown": 1
+          },
+          "components": {
+            "unknown": 1
+          }
+        },
+        "window": {
+          "calls": 0,
+          "tenant_count": 0,
+          "user_count": 0,
+          "component_count": 0,
+          "tenants": {},
+          "users": {},
+          "components": {}
+        },
+        "last_seen_at": "2026-07-09T23:07:53.083299Z",
+        "retirement_candidate": true,
+        "retirement_reason": "no measured usage in review window"
+      },
+      {
+        "interface": {
+          "id": "70a9346e-e0ee-42ac-874f-f160580b54dd",
+          "interface_key": "rest_api:GET /progress/?workstream_id",
+          "interface_kind": "rest_api",
+          "legacy_since": "2026-07-13T22:04:03.911449Z",
+          "replacement_ref": "/progress/?workplan_id=<workplan_id>",
+          "owner_component": "state-hub.api",
+          "status": "legacy",
+          "replacement_verified": true,
+          "manual_hold": false,
+          "hold_reason": null,
+          "notes": null,
+          "retired_at": null,
+          "created_at": "2026-07-13T22:04:03.911449Z",
+          "updated_at": "2026-07-13T22:04:03.911449Z"
+        },
+        "all_time": {
+          "calls": 2,
+          "tenant_count": 1,
+          "user_count": 1,
+          "component_count": 1,
+          "tenants": {
+            "unknown": 2
+          },
+          "users": {
+            "unknown": 2
+          },
+          "components": {
+            "unknown": 2
+          }
+        },
+        "window": {
+          "calls": 0,
+          "tenant_count": 0,
+          "user_count": 0,
+          "component_count": 0,
+          "tenants": {},
+          "users": {},
+          "components": {}
+        },
+        "last_seen_at": "2026-08-12T08:55:33.912995Z",
+        "retirement_candidate": true,
+        "retirement_reason": "no measured usage in review window"
+      },
+      {
+        "interface": {
+          "id": "be3cdcf8-250b-4bf0-801f-02ffd5f57e00",
+          "interface_key": "rest_api:GET /tasks/?workstream_id",
+          "interface_kind": "rest_api",
+          "legacy_since": "2026-07-08T19:32:21.628513Z",
+          "replacement_ref": "/tasks/?workplan_id=<workplan_id>",
+          "owner_component": "state-hub.api",
+          "status": "legacy",
+          "replacement_verified": true,
+          "manual_hold": false,
+          "hold_reason": null,
+          "notes": null,
+          "retired_at": null,
+          "created_at": "2026-07-08T19:32:21.628513Z",
+          "updated_at": "2026-07-08T19:32:21.628513Z"
+        },
+        "all_time": {
+          "calls": 590,
+          "tenant_count": 1,
+          "user_count": 1,
+          "component_count": 1,
+          "tenants": {
+            "unknown": 590
+          },
+          "users": {
+            "unknown": 590
+          },
+          "components": {
+            "unknown": 590
+          }
+        },
+        "window": {
+          "calls": 0,
+          "tenant_count": 0,
+          "user_count": 0,
+          "component_count": 0,
+          "tenants": {},
+          "users": {},
+          "components": {}
+        },
+        "last_seen_at": "2026-08-12T08:55:27.763102Z",
+        "retirement_candidate": true,
+        "retirement_reason": "no measured usage in review window"
+      },
+      {
+        "interface": {
+          "id": "3e4a3d0b-08fa-45c3-91e2-4f514a914b97",
+          "interface_key": "rest_api:GET /workstreams/",
+          "interface_kind": "rest_api",
+          "legacy_since": "2026-06-04T00:26:14.533764Z",
+          "replacement_ref": "/workplans/",
+          "owner_component": "state-hub.api",
+          "status": "legacy",
+          "replacement_verified": true,
+          "manual_hold": false,
+          "hold_reason": null,
+          "notes": null,
+          "retired_at": null,
+          "created_at": "2026-06-04T00:26:14.533764Z",
+          "updated_at": "2026-06-04T00:26:14.533764Z"
+        },
+        "all_time": {
+          "calls": 144086,
+          "tenant_count": 1,
+          "user_count": 1,
+          "component_count": 1,
+          "tenants": {
+            "unknown": 144086
+          },
+          "users": {
+            "unknown": 144086
+          },
+          "components": {
+            "unknown": 144086
+          }
+        },
+        "window": {
+          "calls": 0,
+          "tenant_count": 0,
+          "user_count": 0,
+          "component_count": 0,
+          "tenants": {},
+          "users": {},
+          "components": {}
+        },
+        "last_seen_at": "2026-08-10T18:06:05.032338Z",
+        "retirement_candidate": true,
+        "retirement_reason": "no measured usage in review window"
+      },
+      {
+        "interface": {
+          "id": "e4c140ec-7479-46f9-b185-4b533f19d639",
+          "interface_key": "rest_api:GET /workstreams/workplan-index",
+          "interface_kind": "rest_api",
+          "legacy_since": "2026-06-04T05:20:58.321869Z",
+          "replacement_ref": "/workplans/index",
+          "owner_component": "state-hub.api",
+          "status": "legacy",
+          "replacement_verified": true,
+          "manual_hold": false,
+          "hold_reason": null,
+          "notes": null,
+          "retired_at": null,
+          "created_at": "2026-06-04T05:20:58.321869Z",
+          "updated_at": "2026-06-04T05:20:58.321869Z"
+        },
+        "all_time": {
+          "calls": 30,
+          "tenant_count": 1,
+          "user_count": 1,
+          "component_count": 1,
+          "tenants": {
+            "unknown": 30
+          },
+          "users": {
+            "unknown": 30
+          },
+          "components": {
+            "unknown": 30
+          }
+        },
+        "window": {
+          "calls": 0,
+          "tenant_count": 0,
+          "user_count": 0,
+          "component_count": 0,
+          "tenants": {},
+          "users": {},
+          "components": {}
+        },
+        "last_seen_at": "2026-07-03T05:20:34.534439Z",
+        "retirement_candidate": true,
+        "retirement_reason": "no measured usage in review window"
+      },
+      {
+        "interface": {
+          "id": "3a00b19e-e7db-4403-98aa-a77c9ab61ecc",
+          "interface_key": "rest_api:GET /workstreams/{workstream_id}",
+          "interface_kind": "rest_api",
+          "legacy_since": "2026-06-04T00:25:59.014966Z",
+          "replacement_ref": "/workplans/{workplan_id}",
+          "owner_component": "state-hub.api",
+          "status": "legacy",
+          "replacement_verified": true,
+          "manual_hold": false,
+          "hold_reason": null,
+          "notes": null,
+          "retired_at": null,
+          "created_at": "2026-06-04T00:25:59.014966Z",
+          "updated_at": "2026-06-04T00:25:59.014966Z"
+        },
+        "all_time": {
+          "calls": 511406,
+          "tenant_count": 1,
+          "user_count": 1,
+          "component_count": 1,
+          "tenants": {
+            "unknown": 511406
+          },
+          "users": {
+            "unknown": 511406
+          },
+          "components": {
+            "unknown": 511406
+          }
+        },
+        "window": {
+          "calls": 0,
+          "tenant_count": 0,
+          "user_count": 0,
+          "component_count": 0,
+          "tenants": {},
+          "users": {},
+          "components": {}
+        },
+        "last_seen_at": "2026-07-31T16:25:32.004042Z",
+        "retirement_candidate": true,
+        "retirement_reason": "no measured usage in review window"
+      },
+      {
+        "interface": {
+          "id": "69e1a255-a8b9-4101-8a68-b1bed23abfda",
+          "interface_key": "rest_api:GET /workstreams/{workstream_id}/dependencies/",
+          "interface_kind": "rest_api",
+          "legacy_since": "2026-06-04T00:25:59.291135Z",
+          "replacement_ref": "/workplans/{workplan_id}/dependencies/",
+          "owner_component": "state-hub.api",
+          "status": "legacy",
+          "replacement_verified": true,
+          "manual_hold": false,
+          "hold_reason": null,
+          "notes": null,
+          "retired_at": null,
+          "created_at": "2026-06-04T00:25:59.291135Z",
+          "updated_at": "2026-06-04T00:25:59.291135Z"
+        },
+        "all_time": {
+          "calls": 255865,
+          "tenant_count": 1,
+          "user_count": 1,
+          "component_count": 1,
+          "tenants": {
+            "unknown": 255865
+          },
+          "users": {
+            "unknown": 255865
+          },
+          "components": {
+            "unknown": 255865
+          }
+        },
+        "window": {
+          "calls": 0,
+          "tenant_count": 0,
+          "user_count": 0,
+          "component_count": 0,
+          "tenants": {},
+          "users": {},
+          "components": {}
+        },
+        "last_seen_at": "2026-07-08T21:14:12.747005Z",
+        "retirement_candidate": true,
+        "retirement_reason": "no measured usage in review window"
+      },
+      {
+        "interface": {
+          "id": "b1aae931-b51f-4a85-a723-865dd65f6132",
+          "interface_key": "rest_api:PATCH /workstreams/{workstream_id}",
+          "interface_kind": "rest_api",
+          "legacy_since": "2026-06-04T06:09:41.901035Z",
+          "replacement_ref": "/workplans/{workplan_id}",
+          "owner_component": "state-hub.api",
+          "status": "legacy",
+          "replacement_verified": true,
+          "manual_hold": false,
+          "hold_reason": null,
+          "notes": null,
+          "retired_at": null,
+          "created_at": "2026-06-04T06:09:41.901035Z",
+          "updated_at": "2026-06-04T06:09:41.901035Z"
+        },
+        "all_time": {
+          "calls": 571,
+          "tenant_count": 1,
+          "user_count": 1,
+          "component_count": 1,
+          "tenants": {
+            "unknown": 571
+          },
+          "users": {
+            "unknown": 571
+          },
+          "components": {
+            "unknown": 571
+          }
+        },
+        "window": {
+          "calls": 0,
+          "tenant_count": 0,
+          "user_count": 0,
+          "component_count": 0,
+          "tenants": {},
+          "users": {},
+          "components": {}
+        },
+        "last_seen_at": "2026-07-08T20:49:12.335710Z",
+        "retirement_candidate": true,
+        "retirement_reason": "no measured usage in review window"
+      },
+      {
+        "interface": {
+          "id": "4aea9591-970b-4918-ac4a-4da95a0a1a8c",
+          "interface_key": "rest_api:POST /decisions/ workstream_id",
+          "interface_kind": "rest_api",
+          "legacy_since": "2026-07-09T22:56:35.473130Z",
+          "replacement_ref": "POST /decisions/ with workplan_id",
+          "owner_component": "state-hub.api",
+          "status": "legacy",
+          "replacement_verified": true,
+          "manual_hold": false,
+          "hold_reason": null,
+          "notes": null,
+          "retired_at": null,
+          "created_at": "2026-07-09T22:56:35.473130Z",
+          "updated_at": "2026-07-09T22:56:35.473130Z"
+        },
+        "all_time": {
+          "calls": 3,
+          "tenant_count": 1,
+          "user_count": 1,
+          "component_count": 1,
+          "tenants": {
+            "unknown": 3
+          },
+          "users": {
+            "unknown": 3
+          },
+          "components": {
+            "unknown": 3
+          }
+        },
+        "window": {
+          "calls": 0,
+          "tenant_count": 0,
+          "user_count": 0,
+          "component_count": 0,
+          "tenants": {},
+          "users": {},
+          "components": {}
+        },
+        "last_seen_at": "2026-07-09T22:57:05.912456Z",
+        "retirement_candidate": true,
+        "retirement_reason": "no measured usage in review window"
+      },
+      {
+        "interface": {
+          "id": "4a70583c-1e41-4ec1-99a9-728856a7d79c",
+          "interface_key": "rest_api:POST /progress/ workstream_id",
+          "interface_kind": "rest_api",
+          "legacy_since": "2026-07-08T23:35:09.148333Z",
+          "replacement_ref": "POST /progress/ with workplan_id",
+          "owner_component": "state-hub.api",
+          "status": "legacy",
+          "replacement_verified": true,
+          "manual_hold": false,
+          "hold_reason": null,
+          "notes": null,
+          "retired_at": null,
+          "created_at": "2026-07-08T23:35:09.148333Z",
+          "updated_at": "2026-07-08T23:35:09.148333Z"
+        },
+        "all_time": {
+          "calls": 14,
+          "tenant_count": 1,
+          "user_count": 1,
+          "component_count": 1,
+          "tenants": {
+            "unknown": 14
+          },
+          "users": {
+            "unknown": 14
+          },
+          "components": {
+            "unknown": 14
+          }
+        },
+        "window": {
+          "calls": 0,
+          "tenant_count": 0,
+          "user_count": 0,
+          "component_count": 0,
+          "tenants": {},
+          "users": {},
+          "components": {}
+        },
+        "last_seen_at": "2026-07-10T08:34:42.959724Z",
+        "retirement_candidate": true,
+        "retirement_reason": "no measured usage in review window"
+      },
+      {
+        "interface": {
+          "id": "6df4e443-7bf1-461a-923b-a6eb52fe7b07",
+          "interface_key": "rest_api:POST /tasks/ workstream_id",
+          "interface_kind": "rest_api",
+          "legacy_since": "2026-07-08T22:38:29.405720Z",
+          "replacement_ref": "POST /tasks/ with workplan_id",
+          "owner_component": "state-hub.api",
+          "status": "legacy",
+          "replacement_verified": true,
+          "manual_hold": false,
+          "hold_reason": null,
+          "notes": null,
+          "retired_at": null,
+          "created_at": "2026-07-08T22:38:29.405720Z",
+          "updated_at": "2026-07-08T22:38:29.405720Z"
+        },
+        "all_time": {
+          "calls": 5,
+          "tenant_count": 1,
+          "user_count": 1,
+          "component_count": 1,
+          "tenants": {
+            "unknown": 5
+          },
+          "users": {
+            "unknown": 5
+          },
+          "components": {
+            "state-hub.fix-consistency": 5
+          }
+        },
+        "window": {
+          "calls": 0,
+          "tenant_count": 0,
+          "user_count": 0,
+          "component_count": 0,
+          "tenants": {},
+          "users": {},
+          "components": {}
+        },
+        "last_seen_at": "2026-07-08T22:38:29.976918Z",
+        "retirement_candidate": true,
+        "retirement_reason": "no measured usage in review window"
+      },
+      {
+        "interface": {
+          "id": "ed6451c9-d2cc-4486-9afe-d3852782cabc",
+          "interface_key": "rest_api:POST /workstreams/",
+          "interface_kind": "rest_api",
+          "legacy_since": "2026-06-04T07:40:24.168535Z",
+          "replacement_ref": "/workplans/",
+          "owner_component": "state-hub.api",
+          "status": "legacy",
+          "replacement_verified": true,
+          "manual_hold": false,
+          "hold_reason": null,
+          "notes": null,
+          "retired_at": null,
+          "created_at": "2026-06-04T07:40:24.168535Z",
+          "updated_at": "2026-06-04T07:40:24.168535Z"
+        },
+        "all_time": {
+          "calls": 824,
+          "tenant_count": 1,
+          "user_count": 1,
+          "component_count": 1,
+          "tenants": {
+            "unknown": 824
+          },
+          "users": {
+            "unknown": 824
+          },
+          "components": {
+            "unknown": 824
+          }
+        },
+        "window": {
+          "calls": 0,
+          "tenant_count": 0,
+          "user_count": 0,
+          "component_count": 0,
+          "tenants": {},
+          "users": {},
+          "components": {}
+        },
+        "last_seen_at": "2026-07-08T20:38:05.903144Z",
+        "retirement_candidate": true,
+        "retirement_reason": "no measured usage in review window"
+      },
+      {
+        "interface": {
+          "id": "281fd706-b192-4194-8055-2d8733c115f9",
+          "interface_key": "rest_api:POST /workstreams/{workstream_id}/dependencies/",
+          "interface_kind": "rest_api",
+          "legacy_since": "2026-06-04T22:57:37.149207Z",
+          "replacement_ref": "/workplans/{workplan_id}/dependencies/",
+          "owner_component": "state-hub.api",
+          "status": "legacy",
+          "replacement_verified": true,
+          "manual_hold": false,
+          "hold_reason": null,
+          "notes": null,
+          "retired_at": null,
+          "created_at": "2026-06-04T22:57:37.149207Z",
+          "updated_at": "2026-06-04T22:57:37.149207Z"
+        },
+        "all_time": {
+          "calls": 4971,
+          "tenant_count": 1,
+          "user_count": 1,
+          "component_count": 1,
+          "tenants": {
+            "unknown": 4971
+          },
+          "users": {
+            "unknown": 4971
+          },
+          "components": {
+            "unknown": 4971
+          }
+        },
+        "window": {
+          "calls": 0,
+          "tenant_count": 0,
+          "user_count": 0,
+          "component_count": 0,
+          "tenants": {},
+          "users": {},
+          "components": {}
+        },
+        "last_seen_at": "2026-07-01T22:09:24.229011Z",
+        "retirement_candidate": true,
+        "retirement_reason": "no measured usage in review window"
+      }
+    ],
+    "retirement_candidates": [
+      {
+        "interface": {
+          "id": "63ed90e3-42b4-431a-94db-e1254a52f9e2",
+          "interface_key": "mcp:create_workstream",
+          "interface_kind": "mcp_tool",
+          "legacy_since": "2026-07-10T13:19:44.205900Z",
+          "replacement_ref": "create_workplan",
+          "owner_component": "state-hub.mcp",
+          "status": "legacy",
+          "replacement_verified": true,
+          "manual_hold": false,
+          "hold_reason": null,
+          "notes": "Registered by STATE-WP-0070 T03 \u2014 zero-window streak starts at registration",
+          "retired_at": null,
+          "created_at": "2026-07-10T13:19:44.205900Z",
+          "updated_at": "2026-07-10T13:19:44.205900Z"
+        },
+        "all_time": {
+          "calls": 2,
+          "tenant_count": 1,
+          "user_count": 1,
+          "component_count": 1,
+          "tenants": {
+            "unknown": 2
+          },
+          "users": {
+            "unknown": 2
+          },
+          "components": {
+            "state-hub.mcp": 2
+          }
+        },
+        "window": {
+          "calls": 0,
+          "tenant_count": 0,
+          "user_count": 0,
+          "component_count": 0,
+          "tenants": {},
+          "users": {},
+          "components": {}
+        },
+        "last_seen_at": "2026-07-10T13:20:43.378546Z",
+        "retirement_candidate": true,
+        "retirement_reason": "no measured usage in review window"
+      },
+      {
+        "interface": {
+          "id": "b6a5fe44-fb85-4ef7-a273-78d09da777af",
+          "interface_key": "mcp:list_workstreams",
+          "interface_kind": "mcp_tool",
+          "legacy_since": "2026-07-10T13:19:26.075491Z",
+          "replacement_ref": "list_workplans",
+          "owner_component": "state-hub.mcp",
+          "status": "legacy",
+          "replacement_verified": true,
+          "manual_hold": false,
+          "hold_reason": null,
+          "notes": null,
+          "retired_at": null,
+          "created_at": "2026-07-10T13:19:26.075491Z",
+          "updated_at": "2026-07-10T13:19:26.075491Z"
+        },
+        "all_time": {
+          "calls": 2,
+          "tenant_count": 1,
+          "user_count": 1,
+          "component_count": 1,
+          "tenants": {
+            "unknown": 2
+          },
+          "users": {
+            "unknown": 2
+          },
+          "components": {
+            "state-hub.mcp": 2
+          }
+        },
+        "window": {
+          "calls": 0,
+          "tenant_count": 0,
+          "user_count": 0,
+          "component_count": 0,
+          "tenants": {},
+          "users": {},
+          "components": {}
+        },
+        "last_seen_at": "2026-07-10T13:20:42.374940Z",
+        "retirement_candidate": true,
+        "retirement_reason": "no measured usage in review window"
+      },
+      {
+        "interface": {
+          "id": "53c3372b-307d-4d6a-8ea4-bc36cacdcaf2",
+          "interface_key": "mcp:update_workstream",
+          "interface_kind": "mcp_tool",
+          "legacy_since": "2026-07-10T13:19:44.255216Z",
+          "replacement_ref": "update_workplan",
+          "owner_component": "state-hub.mcp",
+          "status": "legacy",
+          "replacement_verified": true,
+          "manual_hold": false,
+          "hold_reason": null,
+          "notes": "Registered by STATE-WP-0070 T03 \u2014 zero-window streak starts at registration",
+          "retired_at": null,
+          "created_at": "2026-07-10T13:19:44.255216Z",
+          "updated_at": "2026-07-10T13:19:44.255216Z"
+        },
+        "all_time": {
+          "calls": 0,
+          "tenant_count": 0,
+          "user_count": 0,
+          "component_count": 0,
+          "tenants": {},
+          "users": {},
+          "components": {}
+        },
+        "window": {
+          "calls": 0,
+          "tenant_count": 0,
+          "user_count": 0,
+          "component_count": 0,
+          "tenants": {},
+          "users": {},
+          "components": {}
+        },
+        "last_seen_at": null,
+        "retirement_candidate": true,
+        "retirement_reason": "no measured usage in review window"
+      },
+      {
+        "interface": {
+          "id": "bed4d08a-3471-48f5-9f0e-f9d550383a26",
+          "interface_key": "mcp:update_workstream_status",
+          "interface_kind": "mcp_tool",
+          "legacy_since": "2026-07-10T13:19:44.303612Z",
+          "replacement_ref": "update_workplan_status",
+          "owner_component": "state-hub.mcp",
+          "status": "legacy",
+          "replacement_verified": true,
+          "manual_hold": false,
+          "hold_reason": null,
+          "notes": "Registered by STATE-WP-0070 T03 \u2014 zero-window streak starts at registration",
+          "retired_at": null,
+          "created_at": "2026-07-10T13:19:44.303612Z",
+          "updated_at": "2026-07-10T13:19:44.303612Z"
+        },
+        "all_time": {
+          "calls": 0,
+          "tenant_count": 0,
+          "user_count": 0,
+          "component_count": 0,
+          "tenants": {},
+          "users": {},
+          "components": {}
+        },
+        "window": {
+          "calls": 0,
+          "tenant_count": 0,
+          "user_count": 0,
+          "component_count": 0,
+          "tenants": {},
+          "users": {},
+          "components": {}
+        },
+        "last_seen_at": null,
+        "retirement_candidate": true,
+        "retirement_reason": "no measured usage in review window"
+      },
+      {
+        "interface": {
+          "id": "46900dc2-0893-405b-ba59-80f31fb6ebb1",
+          "interface_key": "state://workstreams/{topic_slug}",
+          "interface_kind": "mcp_tool",
+          "legacy_since": "2026-07-10T13:19:44.344493Z",
+          "replacement_ref": "state://workplans/{topic_slug}",
+          "owner_component": "state-hub.mcp",
+          "status": "legacy",
+          "replacement_verified": true,
+          "manual_hold": false,
+          "hold_reason": null,
+          "notes": "Registered by STATE-WP-0070 T03 \u2014 zero-window streak starts at registration",
+          "retired_at": null,
+          "created_at": "2026-07-10T13:19:44.344493Z",
+          "updated_at": "2026-07-10T13:19:44.344493Z"
+        },
+        "all_time": {
+          "calls": 1,
+          "tenant_count": 1,
+          "user_count": 1,
+          "component_count": 1,
+          "tenants": {
+            "unknown": 1
+          },
+          "users": {
+            "unknown": 1
+          },
+          "components": {
+            "state-hub.mcp": 1
+          }
+        },
+        "window": {
+          "calls": 0,
+          "tenant_count": 0,
+          "user_count": 0,
+          "component_count": 0,
+          "tenants": {},
+          "users": {},
+          "components": {}
+        },
+        "last_seen_at": "2026-07-10T13:20:34.491811Z",
+        "retirement_candidate": true,
+        "retirement_reason": "no measured usage in review window"
+      },
+      {
+        "interface": {
+          "id": "cd9342fd-27e7-4a46-a1be-d41499e106a3",
+          "interface_key": "rest_api:DELETE /workstreams/{workstream_id}",
+          "interface_kind": "rest_api",
+          "legacy_since": "2026-06-06T17:28:13.052813Z",
+          "replacement_ref": "/workplans/{workplan_id}",
+          "owner_component": "state-hub.api",
+          "status": "legacy",
+          "replacement_verified": true,
+          "manual_hold": false,
+          "hold_reason": null,
+          "notes": null,
+          "retired_at": null,
+          "created_at": "2026-06-06T17:28:13.052813Z",
+          "updated_at": "2026-06-06T17:28:13.052813Z"
+        },
+        "all_time": {
+          "calls": 1,
+          "tenant_count": 1,
+          "user_count": 1,
+          "component_count": 1,
+          "tenants": {
+            "unknown": 1
+          },
+          "users": {
+            "unknown": 1
+          },
+          "components": {
+            "unknown": 1
+          }
+        },
+        "window": {
+          "calls": 0,
+          "tenant_count": 0,
+          "user_count": 0,
+          "component_count": 0,
+          "tenants": {},
+          "users": {},
+          "components": {}
+        },
+        "last_seen_at": "2026-06-06T17:28:13.047529Z",
+        "retirement_candidate": true,
+        "retirement_reason": "no measured usage in review window"
+      },
+      {
+        "interface": {
+          "id": "a4e0948c-cd4a-461e-8ae2-7fd7b51d04a7",
+          "interface_key": "rest_api:GET /decisions/?workstream_id",
+          "interface_kind": "rest_api",
+          "legacy_since": "2026-07-09T23:07:53.093223Z",
+          "replacement_ref": "/decisions/?workplan_id=<workplan_id>",
+          "owner_component": "state-hub.api",
+          "status": "legacy",
+          "replacement_verified": true,
+          "manual_hold": false,
+          "hold_reason": null,
+          "notes": null,
+          "retired_at": null,
+          "created_at": "2026-07-09T23:07:53.093223Z",
+          "updated_at": "2026-07-09T23:07:53.093223Z"
+        },
+        "all_time": {
+          "calls": 1,
+          "tenant_count": 1,
+          "user_count": 1,
+          "component_count": 1,
+          "tenants": {
+            "unknown": 1
+          },
+          "users": {
+            "unknown": 1
+          },
+          "components": {
+            "unknown": 1
+          }
+        },
+        "window": {
+          "calls": 0,
+          "tenant_count": 0,
+          "user_count": 0,
+          "component_count": 0,
+          "tenants": {},
+          "users": {},
+          "components": {}
+        },
+        "last_seen_at": "2026-07-09T23:07:53.083299Z",
+        "retirement_candidate": true,
+        "retirement_reason": "no measured usage in review window"
+      },
+      {
+        "interface": {
+          "id": "70a9346e-e0ee-42ac-874f-f160580b54dd",
+          "interface_key": "rest_api:GET /progress/?workstream_id",
+          "interface_kind": "rest_api",
+          "legacy_since": "2026-07-13T22:04:03.911449Z",
+          "replacement_ref": "/progress/?workplan_id=<workplan_id>",
+          "owner_component": "state-hub.api",
+          "status": "legacy",
+          "replacement_verified": true,
+          "manual_hold": false,
+          "hold_reason": null,
+          "notes": null,
+          "retired_at": null,
+          "created_at": "2026-07-13T22:04:03.911449Z",
+          "updated_at": "2026-07-13T22:04:03.911449Z"
+        },
+        "all_time": {
+          "calls": 2,
+          "tenant_count": 1,
+          "user_count": 1,
+          "component_count": 1,
+          "tenants": {
+            "unknown": 2
+          },
+          "users": {
+            "unknown": 2
+          },
+          "components": {
+            "unknown": 2
+          }
+        },
+        "window": {
+          "calls": 0,
+          "tenant_count": 0,
+          "user_count": 0,
+          "component_count": 0,
+          "tenants": {},
+          "users": {},
+          "components": {}
+        },
+        "last_seen_at": "2026-08-12T08:55:33.912995Z",
+        "retirement_candidate": true,
+        "retirement_reason": "no measured usage in review window"
+      },
+      {
+        "interface": {
+          "id": "be3cdcf8-250b-4bf0-801f-02ffd5f57e00",
+          "interface_key": "rest_api:GET /tasks/?workstream_id",
+          "interface_kind": "rest_api",
+          "legacy_since": "2026-07-08T19:32:21.628513Z",
+          "replacement_ref": "/tasks/?workplan_id=<workplan_id>",
+          "owner_component": "state-hub.api",
+          "status": "legacy",
+          "replacement_verified": true,
+          "manual_hold": false,
+          "hold_reason": null,
+          "notes": null,
+          "retired_at": null,
+          "created_at": "2026-07-08T19:32:21.628513Z",
+          "updated_at": "2026-07-08T19:32:21.628513Z"
+        },
+        "all_time": {
+          "calls": 590,
+          "tenant_count": 1,
+          "user_count": 1,
+          "component_count": 1,
+          "tenants": {
+            "unknown": 590
+          },
+          "users": {
+            "unknown": 590
+          },
+          "components": {
+            "unknown": 590
+          }
+        },
+        "window": {
+          "calls": 0,
+          "tenant_count": 0,
+          "user_count": 0,
+          "component_count": 0,
+          "tenants": {},
+          "users": {},
+          "components": {}
+        },
+        "last_seen_at": "2026-08-12T08:55:27.763102Z",
+        "retirement_candidate": true,
+        "retirement_reason": "no measured usage in review window"
+      },
+      {
+        "interface": {
+          "id": "3e4a3d0b-08fa-45c3-91e2-4f514a914b97",
+          "interface_key": "rest_api:GET /workstreams/",
+          "interface_kind": "rest_api",
+          "legacy_since": "2026-06-04T00:26:14.533764Z",
+          "replacement_ref": "/workplans/",
+          "owner_component": "state-hub.api",
+          "status": "legacy",
+          "replacement_verified": true,
+          "manual_hold": false,
+          "hold_reason": null,
+          "notes": null,
+          "retired_at": null,
+          "created_at": "2026-06-04T00:26:14.533764Z",
+          "updated_at": "2026-06-04T00:26:14.533764Z"
+        },
+        "all_time": {
+          "calls": 144086,
+          "tenant_count": 1,
+          "user_count": 1,
+          "component_count": 1,
+          "tenants": {
+            "unknown": 144086
+          },
+          "users": {
+            "unknown": 144086
+          },
+          "components": {
+            "unknown": 144086
+          }
+        },
+        "window": {
+          "calls": 0,
+          "tenant_count": 0,
+          "user_count": 0,
+          "component_count": 0,
+          "tenants": {},
+          "users": {},
+          "components": {}
+        },
+        "last_seen_at": "2026-08-10T18:06:05.032338Z",
+        "retirement_candidate": true,
+        "retirement_reason": "no measured usage in review window"
+      },
+      {
+        "interface": {
+          "id": "e4c140ec-7479-46f9-b185-4b533f19d639",
+          "interface_key": "rest_api:GET /workstreams/workplan-index",
+          "interface_kind": "rest_api",
+          "legacy_since": "2026-06-04T05:20:58.321869Z",
+          "replacement_ref": "/workplans/index",
+          "owner_component": "state-hub.api",
+          "status": "legacy",
+          "replacement_verified": true,
+          "manual_hold": false,
+          "hold_reason": null,
+          "notes": null,
+          "retired_at": null,
+          "created_at": "2026-06-04T05:20:58.321869Z",
+          "updated_at": "2026-06-04T05:20:58.321869Z"
+        },
+        "all_time": {
+          "calls": 30,
+          "tenant_count": 1,
+          "user_count": 1,
+          "component_count": 1,
+          "tenants": {
+            "unknown": 30
+          },
+          "users": {
+            "unknown": 30
+          },
+          "components": {
+            "unknown": 30
+          }
+        },
+        "window": {
+          "calls": 0,
+          "tenant_count": 0,
+          "user_count": 0,
+          "component_count": 0,
+          "tenants": {},
+          "users": {},
+          "components": {}
+        },
+        "last_seen_at": "2026-07-03T05:20:34.534439Z",
+        "retirement_candidate": true,
+        "retirement_reason": "no measured usage in review window"
+      },
+      {
+        "interface": {
+          "id": "3a00b19e-e7db-4403-98aa-a77c9ab61ecc",
+          "interface_key": "rest_api:GET /workstreams/{workstream_id}",
+          "interface_kind": "rest_api",
+          "legacy_since": "2026-06-04T00:25:59.014966Z",
+          "replacement_ref": "/workplans/{workplan_id}",
+          "owner_component": "state-hub.api",
+          "status": "legacy",
+          "replacement_verified": true,
+          "manual_hold": false,
+          "hold_reason": null,
+          "notes": null,
+          "retired_at": null,
+          "created_at": "2026-06-04T00:25:59.014966Z",
+          "updated_at": "2026-06-04T00:25:59.014966Z"
+        },
+        "all_time": {
+          "calls": 511406,
+          "tenant_count": 1,
+          "user_count": 1,
+          "component_count": 1,
+          "tenants": {
+            "unknown": 511406
+          },
+          "users": {
+            "unknown": 511406
+          },
+          "components": {
+            "unknown": 511406
+          }
+        },
+        "window": {
+          "calls": 0,
+          "tenant_count": 0,
+          "user_count": 0,
+          "component_count": 0,
+          "tenants": {},
+          "users": {},
+          "components": {}
+        },
+        "last_seen_at": "2026-07-31T16:25:32.004042Z",
+        "retirement_candidate": true,
+        "retirement_reason": "no measured usage in review window"
+      },
+      {
+        "interface": {
+          "id": "69e1a255-a8b9-4101-8a68-b1bed23abfda",
+          "interface_key": "rest_api:GET /workstreams/{workstream_id}/dependencies/",
+          "interface_kind": "rest_api",
+          "legacy_since": "2026-06-04T00:25:59.291135Z",
+          "replacement_ref": "/workplans/{workplan_id}/dependencies/",
+          "owner_component": "state-hub.api",
+          "status": "legacy",
+          "replacement_verified": true,
+          "manual_hold": false,
+          "hold_reason": null,
+          "notes": null,
+          "retired_at": null,
+          "created_at": "2026-06-04T00:25:59.291135Z",
+          "updated_at": "2026-06-04T00:25:59.291135Z"
+        },
+        "all_time": {
+          "calls": 255865,
+          "tenant_count": 1,
+          "user_count": 1,
+          "component_count": 1,
+          "tenants": {
+            "unknown": 255865
+          },
+          "users": {
+            "unknown": 255865
+          },
+          "components": {
+            "unknown": 255865
+          }
+        },
+        "window": {
+          "calls": 0,
+          "tenant_count": 0,
+          "user_count": 0,
+          "component_count": 0,
+          "tenants": {},
+          "users": {},
+          "components": {}
+        },
+        "last_seen_at": "2026-07-08T21:14:12.747005Z",
+        "retirement_candidate": true,
+        "retirement_reason": "no measured usage in review window"
+      },
+      {
+        "interface": {
+          "id": "b1aae931-b51f-4a85-a723-865dd65f6132",
+          "interface_key": "rest_api:PATCH /workstreams/{workstream_id}",
+          "interface_kind": "rest_api",
+          "legacy_since": "2026-06-04T06:09:41.901035Z",
+          "replacement_ref": "/workplans/{workplan_id}",
+          "owner_component": "state-hub.api",
+          "status": "legacy",
+          "replacement_verified": true,
+          "manual_hold": false,
+          "hold_reason": null,
+          "notes": null,
+          "retired_at": null,
+          "created_at": "2026-06-04T06:09:41.901035Z",
+          "updated_at": "2026-06-04T06:09:41.901035Z"
+        },
+        "all_time": {
+          "calls": 571,
+          "tenant_count": 1,
+          "user_count": 1,
+          "component_count": 1,
+          "tenants": {
+            "unknown": 571
+          },
+          "users": {
+            "unknown": 571
+          },
+          "components": {
+            "unknown": 571
+          }
+        },
+        "window": {
+          "calls": 0,
+          "tenant_count": 0,
+          "user_count": 0,
+          "component_count": 0,
+          "tenants": {},
+          "users": {},
+          "components": {}
+        },
+        "last_seen_at": "2026-07-08T20:49:12.335710Z",
+        "retirement_candidate": true,
+        "retirement_reason": "no measured usage in review window"
+      },
+      {
+        "interface": {
+          "id": "4aea9591-970b-4918-ac4a-4da95a0a1a8c",
+          "interface_key": "rest_api:POST /decisions/ workstream_id",
+          "interface_kind": "rest_api",
+          "legacy_since": "2026-07-09T22:56:35.473130Z",
+          "replacement_ref": "POST /decisions/ with workplan_id",
+          "owner_component": "state-hub.api",
+          "status": "legacy",
+          "replacement_verified": true,
+          "manual_hold": false,
+          "hold_reason": null,
+          "notes": null,
+          "retired_at": null,
+          "created_at": "2026-07-09T22:56:35.473130Z",
+          "updated_at": "2026-07-09T22:56:35.473130Z"
+        },
+        "all_time": {
+          "calls": 3,
+          "tenant_count": 1,
+          "user_count": 1,
+          "component_count": 1,
+          "tenants": {
+            "unknown": 3
+          },
+          "users": {
+            "unknown": 3
+          },
+          "components": {
+            "unknown": 3
+          }
+        },
+        "window": {
+          "calls": 0,
+          "tenant_count": 0,
+          "user_count": 0,
+          "component_count": 0,
+          "tenants": {},
+          "users": {},
+          "components": {}
+        },
+        "last_seen_at": "2026-07-09T22:57:05.912456Z",
+        "retirement_candidate": true,
+        "retirement_reason": "no measured usage in review window"
+      },
+      {
+        "interface": {
+          "id": "4a70583c-1e41-4ec1-99a9-728856a7d79c",
+          "interface_key": "rest_api:POST /progress/ workstream_id",
+          "interface_kind": "rest_api",
+          "legacy_since": "2026-07-08T23:35:09.148333Z",
+          "replacement_ref": "POST /progress/ with workplan_id",
+          "owner_component": "state-hub.api",
+          "status": "legacy",
+          "replacement_verified": true,
+          "manual_hold": false,
+          "hold_reason": null,
+          "notes": null,
+          "retired_at": null,
+          "created_at": "2026-07-08T23:35:09.148333Z",
+          "updated_at": "2026-07-08T23:35:09.148333Z"
+        },
+        "all_time": {
+          "calls": 14,
+          "tenant_count": 1,
+          "user_count": 1,
+          "component_count": 1,
+          "tenants": {
+            "unknown": 14
+          },
+          "users": {
+            "unknown": 14
+          },
+          "components": {
+            "unknown": 14
+          }
+        },
+        "window": {
+          "calls": 0,
+          "tenant_count": 0,
+          "user_count": 0,
+          "component_count": 0,
+          "tenants": {},
+          "users": {},
+          "components": {}
+        },
+        "last_seen_at": "2026-07-10T08:34:42.959724Z",
+        "retirement_candidate": true,
+        "retirement_reason": "no measured usage in review window"
+      },
+      {
+        "interface": {
+          "id": "6df4e443-7bf1-461a-923b-a6eb52fe7b07",
+          "interface_key": "rest_api:POST /tasks/ workstream_id",
+          "interface_kind": "rest_api",
+          "legacy_since": "2026-07-08T22:38:29.405720Z",
+          "replacement_ref": "POST /tasks/ with workplan_id",
+          "owner_component": "state-hub.api",
+          "status": "legacy",
+          "replacement_verified": true,
+          "manual_hold": false,
+          "hold_reason": null,
+          "notes": null,
+          "retired_at": null,
+          "created_at": "2026-07-08T22:38:29.405720Z",
+          "updated_at": "2026-07-08T22:38:29.405720Z"
+        },
+        "all_time": {
+          "calls": 5,
+          "tenant_count": 1,
+          "user_count": 1,
+          "component_count": 1,
+          "tenants": {
+            "unknown": 5
+          },
+          "users": {
+            "unknown": 5
+          },
+          "components": {
+            "state-hub.fix-consistency": 5
+          }
+        },
+        "window": {
+          "calls": 0,
+          "tenant_count": 0,
+          "user_count": 0,
+          "component_count": 0,
+          "tenants": {},
+          "users": {},
+          "components": {}
+        },
+        "last_seen_at": "2026-07-08T22:38:29.976918Z",
+        "retirement_candidate": true,
+        "retirement_reason": "no measured usage in review window"
+      },
+      {
+        "interface": {
+          "id": "ed6451c9-d2cc-4486-9afe-d3852782cabc",
+          "interface_key": "rest_api:POST /workstreams/",
+          "interface_kind": "rest_api",
+          "legacy_since": "2026-06-04T07:40:24.168535Z",
+          "replacement_ref": "/workplans/",
+          "owner_component": "state-hub.api",
+          "status": "legacy",
+          "replacement_verified": true,
+          "manual_hold": false,
+          "hold_reason": null,
+          "notes": null,
+          "retired_at": null,
+          "created_at": "2026-06-04T07:40:24.168535Z",
+          "updated_at": "2026-06-04T07:40:24.168535Z"
+        },
+        "all_time": {
+          "calls": 824,
+          "tenant_count": 1,
+          "user_count": 1,
+          "component_count": 1,
+          "tenants": {
+            "unknown": 824
+          },
+          "users": {
+            "unknown": 824
+          },
+          "components": {
+            "unknown": 824
+          }
+        },
+        "window": {
+          "calls": 0,
+          "tenant_count": 0,
+          "user_count": 0,
+          "component_count": 0,
+          "tenants": {},
+          "users": {},
+          "components": {}
+        },
+        "last_seen_at": "2026-07-08T20:38:05.903144Z",
+        "retirement_candidate": true,
+        "retirement_reason": "no measured usage in review window"
+      },
+      {
+        "interface": {
+          "id": "281fd706-b192-4194-8055-2d8733c115f9",
+          "interface_key": "rest_api:POST /workstreams/{workstream_id}/dependencies/",
+          "interface_kind": "rest_api",
+          "legacy_since": "2026-06-04T22:57:37.149207Z",
+          "replacement_ref": "/workplans/{workplan_id}/dependencies/",
+          "owner_component": "state-hub.api",
+          "status": "legacy",
+          "replacement_verified": true,
+          "manual_hold": false,
+          "hold_reason": null,
+          "notes": null,
+          "retired_at": null,
+          "created_at": "2026-06-04T22:57:37.149207Z",
+          "updated_at": "2026-06-04T22:57:37.149207Z"
+        },
+        "all_time": {
+          "calls": 4971,
+          "tenant_count": 1,
+          "user_count": 1,
+          "component_count": 1,
+          "tenants": {
+            "unknown": 4971
+          },
+          "users": {
+            "unknown": 4971
+          },
+          "components": {
+            "unknown": 4971
+          }
+        },
+        "window": {
+          "calls": 0,
+          "tenant_count": 0,
+          "user_count": 0,
+          "component_count": 0,
+          "tenants": {},
+          "users": {},
+          "components": {}
+        },
+        "last_seen_at": "2026-07-01T22:09:24.229011Z",
+        "retirement_candidate": true,
+        "retirement_reason": "no measured usage in review window"
+      }
+    ]
+  },
+  "hours": 8
+}
diff --git a/docs/evidence/legacy-meter-weekly-review-20260815.json b/docs/evidence/legacy-meter-weekly-review-20260815.json
new file mode 100644
index 0000000..767b8f2
--- /dev/null
+++ b/docs/evidence/legacy-meter-weekly-review-20260815.json
@@ -0,0 +1,1755 @@
+{
+  "captured_at": "2026-08-15T14:00:07.598236+00:00",
+  "api_base": "http://127.0.0.1:8000",
+  "workplan": "STATE-WP-0070",
+  "retired_interfaces": [],
+  "weekly_review": {
+    "generated_at": "2026-08-15T14:00:07.592443Z",
+    "window_start": "2026-08-15T06:00:07.535715Z",
+    "window_end": "2026-08-15T14:00:07.535715Z",
+    "cadence": "weekly",
+    "activity_core_handoff": {
+      "activity_id": "statehub-legacy-interface-review",
+      "cadence": "weekly",
+      "source_endpoint": "/legacy-meter/weekly-review",
+      "state_owner": "state-hub",
+      "scheduler_owner": "activity-core"
+    },
+    "interfaces": [
+      {
+        "interface": {
+          "id": "8051fb40-66c9-4dc4-a413-13e8573e04a3",
+          "interface_key": "event_subject:org.statehub.workstream.completed",
+          "interface_kind": "event_subject",
+          "legacy_since": "2026-06-04T06:09:42.198193Z",
+          "replacement_ref": "org.statehub.workplan.completed",
+          "owner_component": "state-hub.events",
+          "status": "retired",
+          "replacement_verified": true,
+          "manual_hold": false,
+          "hold_reason": null,
+          "notes": "Retired by STATE-WP-0069 closeout",
+          "retired_at": "2026-07-08T21:38:52.773601Z",
+          "created_at": "2026-06-04T06:09:42.198193Z",
+          "updated_at": "2026-07-08T21:38:52.761243Z"
+        },
+        "all_time": {
+          "calls": 255,
+          "tenant_count": 1,
+          "user_count": 1,
+          "component_count": 1,
+          "tenants": {
+            "unknown": 255
+          },
+          "users": {
+            "unknown": 255
+          },
+          "components": {
+            "state-hub.events": 255
+          }
+        },
+        "window": {
+          "calls": 0,
+          "tenant_count": 0,
+          "user_count": 0,
+          "component_count": 0,
+          "tenants": {},
+          "users": {},
+          "components": {}
+        },
+        "last_seen_at": "2026-07-08T20:49:12.839383Z",
+        "retirement_candidate": false,
+        "retirement_reason": "already retired"
+      },
+      {
+        "interface": {
+          "id": "63ed90e3-42b4-431a-94db-e1254a52f9e2",
+          "interface_key": "mcp:create_workstream",
+          "interface_kind": "mcp_tool",
+          "legacy_since": "2026-07-10T13:19:44.205900Z",
+          "replacement_ref": "create_workplan",
+          "owner_component": "state-hub.mcp",
+          "status": "legacy",
+          "replacement_verified": true,
+          "manual_hold": false,
+          "hold_reason": null,
+          "notes": "Registered by STATE-WP-0070 T03 \u2014 zero-window streak starts at registration",
+          "retired_at": null,
+          "created_at": "2026-07-10T13:19:44.205900Z",
+          "updated_at": "2026-07-10T13:19:44.205900Z"
+        },
+        "all_time": {
+          "calls": 2,
+          "tenant_count": 1,
+          "user_count": 1,
+          "component_count": 1,
+          "tenants": {
+            "unknown": 2
+          },
+          "users": {
+            "unknown": 2
+          },
+          "components": {
+            "state-hub.mcp": 2
+          }
+        },
+        "window": {
+          "calls": 0,
+          "tenant_count": 0,
+          "user_count": 0,
+          "component_count": 0,
+          "tenants": {},
+          "users": {},
+          "components": {}
+        },
+        "last_seen_at": "2026-07-10T13:20:43.378546Z",
+        "retirement_candidate": true,
+        "retirement_reason": "no measured usage in review window"
+      },
+      {
+        "interface": {
+          "id": "b6a5fe44-fb85-4ef7-a273-78d09da777af",
+          "interface_key": "mcp:list_workstreams",
+          "interface_kind": "mcp_tool",
+          "legacy_since": "2026-07-10T13:19:26.075491Z",
+          "replacement_ref": "list_workplans",
+          "owner_component": "state-hub.mcp",
+          "status": "legacy",
+          "replacement_verified": true,
+          "manual_hold": false,
+          "hold_reason": null,
+          "notes": null,
+          "retired_at": null,
+          "created_at": "2026-07-10T13:19:26.075491Z",
+          "updated_at": "2026-07-10T13:19:26.075491Z"
+        },
+        "all_time": {
+          "calls": 2,
+          "tenant_count": 1,
+          "user_count": 1,
+          "component_count": 1,
+          "tenants": {
+            "unknown": 2
+          },
+          "users": {
+            "unknown": 2
+          },
+          "components": {
+            "state-hub.mcp": 2
+          }
+        },
+        "window": {
+          "calls": 0,
+          "tenant_count": 0,
+          "user_count": 0,
+          "component_count": 0,
+          "tenants": {},
+          "users": {},
+          "components": {}
+        },
+        "last_seen_at": "2026-07-10T13:20:42.374940Z",
+        "retirement_candidate": true,
+        "retirement_reason": "no measured usage in review window"
+      },
+      {
+        "interface": {
+          "id": "53c3372b-307d-4d6a-8ea4-bc36cacdcaf2",
+          "interface_key": "mcp:update_workstream",
+          "interface_kind": "mcp_tool",
+          "legacy_since": "2026-07-10T13:19:44.255216Z",
+          "replacement_ref": "update_workplan",
+          "owner_component": "state-hub.mcp",
+          "status": "legacy",
+          "replacement_verified": true,
+          "manual_hold": false,
+          "hold_reason": null,
+          "notes": "Registered by STATE-WP-0070 T03 \u2014 zero-window streak starts at registration",
+          "retired_at": null,
+          "created_at": "2026-07-10T13:19:44.255216Z",
+          "updated_at": "2026-07-10T13:19:44.255216Z"
+        },
+        "all_time": {
+          "calls": 0,
+          "tenant_count": 0,
+          "user_count": 0,
+          "component_count": 0,
+          "tenants": {},
+          "users": {},
+          "components": {}
+        },
+        "window": {
+          "calls": 0,
+          "tenant_count": 0,
+          "user_count": 0,
+          "component_count": 0,
+          "tenants": {},
+          "users": {},
+          "components": {}
+        },
+        "last_seen_at": null,
+        "retirement_candidate": true,
+        "retirement_reason": "no measured usage in review window"
+      },
+      {
+        "interface": {
+          "id": "bed4d08a-3471-48f5-9f0e-f9d550383a26",
+          "interface_key": "mcp:update_workstream_status",
+          "interface_kind": "mcp_tool",
+          "legacy_since": "2026-07-10T13:19:44.303612Z",
+          "replacement_ref": "update_workplan_status",
+          "owner_component": "state-hub.mcp",
+          "status": "legacy",
+          "replacement_verified": true,
+          "manual_hold": false,
+          "hold_reason": null,
+          "notes": "Registered by STATE-WP-0070 T03 \u2014 zero-window streak starts at registration",
+          "retired_at": null,
+          "created_at": "2026-07-10T13:19:44.303612Z",
+          "updated_at": "2026-07-10T13:19:44.303612Z"
+        },
+        "all_time": {
+          "calls": 0,
+          "tenant_count": 0,
+          "user_count": 0,
+          "component_count": 0,
+          "tenants": {},
+          "users": {},
+          "components": {}
+        },
+        "window": {
+          "calls": 0,
+          "tenant_count": 0,
+          "user_count": 0,
+          "component_count": 0,
+          "tenants": {},
+          "users": {},
+          "components": {}
+        },
+        "last_seen_at": null,
+        "retirement_candidate": true,
+        "retirement_reason": "no measured usage in review window"
+      },
+      {
+        "interface": {
+          "id": "46900dc2-0893-405b-ba59-80f31fb6ebb1",
+          "interface_key": "state://workstreams/{topic_slug}",
+          "interface_kind": "mcp_tool",
+          "legacy_since": "2026-07-10T13:19:44.344493Z",
+          "replacement_ref": "state://workplans/{topic_slug}",
+          "owner_component": "state-hub.mcp",
+          "status": "legacy",
+          "replacement_verified": true,
+          "manual_hold": false,
+          "hold_reason": null,
+          "notes": "Registered by STATE-WP-0070 T03 \u2014 zero-window streak starts at registration",
+          "retired_at": null,
+          "created_at": "2026-07-10T13:19:44.344493Z",
+          "updated_at": "2026-07-10T13:19:44.344493Z"
+        },
+        "all_time": {
+          "calls": 1,
+          "tenant_count": 1,
+          "user_count": 1,
+          "component_count": 1,
+          "tenants": {
+            "unknown": 1
+          },
+          "users": {
+            "unknown": 1
+          },
+          "components": {
+            "state-hub.mcp": 1
+          }
+        },
+        "window": {
+          "calls": 0,
+          "tenant_count": 0,
+          "user_count": 0,
+          "component_count": 0,
+          "tenants": {},
+          "users": {},
+          "components": {}
+        },
+        "last_seen_at": "2026-07-10T13:20:34.491811Z",
+        "retirement_candidate": true,
+        "retirement_reason": "no measured usage in review window"
+      },
+      {
+        "interface": {
+          "id": "cd9342fd-27e7-4a46-a1be-d41499e106a3",
+          "interface_key": "rest_api:DELETE /workstreams/{workstream_id}",
+          "interface_kind": "rest_api",
+          "legacy_since": "2026-06-06T17:28:13.052813Z",
+          "replacement_ref": "/workplans/{workplan_id}",
+          "owner_component": "state-hub.api",
+          "status": "legacy",
+          "replacement_verified": true,
+          "manual_hold": false,
+          "hold_reason": null,
+          "notes": null,
+          "retired_at": null,
+          "created_at": "2026-06-06T17:28:13.052813Z",
+          "updated_at": "2026-06-06T17:28:13.052813Z"
+        },
+        "all_time": {
+          "calls": 1,
+          "tenant_count": 1,
+          "user_count": 1,
+          "component_count": 1,
+          "tenants": {
+            "unknown": 1
+          },
+          "users": {
+            "unknown": 1
+          },
+          "components": {
+            "unknown": 1
+          }
+        },
+        "window": {
+          "calls": 0,
+          "tenant_count": 0,
+          "user_count": 0,
+          "component_count": 0,
+          "tenants": {},
+          "users": {},
+          "components": {}
+        },
+        "last_seen_at": "2026-06-06T17:28:13.047529Z",
+        "retirement_candidate": true,
+        "retirement_reason": "no measured usage in review window"
+      },
+      {
+        "interface": {
+          "id": "a4e0948c-cd4a-461e-8ae2-7fd7b51d04a7",
+          "interface_key": "rest_api:GET /decisions/?workstream_id",
+          "interface_kind": "rest_api",
+          "legacy_since": "2026-07-09T23:07:53.093223Z",
+          "replacement_ref": "/decisions/?workplan_id=<workplan_id>",
+          "owner_component": "state-hub.api",
+          "status": "legacy",
+          "replacement_verified": true,
+          "manual_hold": false,
+          "hold_reason": null,
+          "notes": null,
+          "retired_at": null,
+          "created_at": "2026-07-09T23:07:53.093223Z",
+          "updated_at": "2026-07-09T23:07:53.093223Z"
+        },
+        "all_time": {
+          "calls": 1,
+          "tenant_count": 1,
+          "user_count": 1,
+          "component_count": 1,
+          "tenants": {
+            "unknown": 1
+          },
+          "users": {
+            "unknown": 1
+          },
+          "components": {
+            "unknown": 1
+          }
+        },
+        "window": {
+          "calls": 0,
+          "tenant_count": 0,
+          "user_count": 0,
+          "component_count": 0,
+          "tenants": {},
+          "users": {},
+          "components": {}
+        },
+        "last_seen_at": "2026-07-09T23:07:53.083299Z",
+        "retirement_candidate": true,
+        "retirement_reason": "no measured usage in review window"
+      },
+      {
+        "interface": {
+          "id": "70a9346e-e0ee-42ac-874f-f160580b54dd",
+          "interface_key": "rest_api:GET /progress/?workstream_id",
+          "interface_kind": "rest_api",
+          "legacy_since": "2026-07-13T22:04:03.911449Z",
+          "replacement_ref": "/progress/?workplan_id=<workplan_id>",
+          "owner_component": "state-hub.api",
+          "status": "legacy",
+          "replacement_verified": true,
+          "manual_hold": false,
+          "hold_reason": null,
+          "notes": null,
+          "retired_at": null,
+          "created_at": "2026-07-13T22:04:03.911449Z",
+          "updated_at": "2026-07-13T22:04:03.911449Z"
+        },
+        "all_time": {
+          "calls": 2,
+          "tenant_count": 1,
+          "user_count": 1,
+          "component_count": 1,
+          "tenants": {
+            "unknown": 2
+          },
+          "users": {
+            "unknown": 2
+          },
+          "components": {
+            "unknown": 2
+          }
+        },
+        "window": {
+          "calls": 0,
+          "tenant_count": 0,
+          "user_count": 0,
+          "component_count": 0,
+          "tenants": {},
+          "users": {},
+          "components": {}
+        },
+        "last_seen_at": "2026-08-12T08:55:33.912995Z",
+        "retirement_candidate": true,
+        "retirement_reason": "no measured usage in review window"
+      },
+      {
+        "interface": {
+          "id": "be3cdcf8-250b-4bf0-801f-02ffd5f57e00",
+          "interface_key": "rest_api:GET /tasks/?workstream_id",
+          "interface_kind": "rest_api",
+          "legacy_since": "2026-07-08T19:32:21.628513Z",
+          "replacement_ref": "/tasks/?workplan_id=<workplan_id>",
+          "owner_component": "state-hub.api",
+          "status": "legacy",
+          "replacement_verified": true,
+          "manual_hold": false,
+          "hold_reason": null,
+          "notes": null,
+          "retired_at": null,
+          "created_at": "2026-07-08T19:32:21.628513Z",
+          "updated_at": "2026-07-08T19:32:21.628513Z"
+        },
+        "all_time": {
+          "calls": 590,
+          "tenant_count": 1,
+          "user_count": 1,
+          "component_count": 1,
+          "tenants": {
+            "unknown": 590
+          },
+          "users": {
+            "unknown": 590
+          },
+          "components": {
+            "unknown": 590
+          }
+        },
+        "window": {
+          "calls": 0,
+          "tenant_count": 0,
+          "user_count": 0,
+          "component_count": 0,
+          "tenants": {},
+          "users": {},
+          "components": {}
+        },
+        "last_seen_at": "2026-08-12T08:55:27.763102Z",
+        "retirement_candidate": true,
+        "retirement_reason": "no measured usage in review window"
+      },
+      {
+        "interface": {
+          "id": "3e4a3d0b-08fa-45c3-91e2-4f514a914b97",
+          "interface_key": "rest_api:GET /workstreams/",
+          "interface_kind": "rest_api",
+          "legacy_since": "2026-06-04T00:26:14.533764Z",
+          "replacement_ref": "/workplans/",
+          "owner_component": "state-hub.api",
+          "status": "legacy",
+          "replacement_verified": true,
+          "manual_hold": false,
+          "hold_reason": null,
+          "notes": null,
+          "retired_at": null,
+          "created_at": "2026-06-04T00:26:14.533764Z",
+          "updated_at": "2026-06-04T00:26:14.533764Z"
+        },
+        "all_time": {
+          "calls": 144086,
+          "tenant_count": 1,
+          "user_count": 1,
+          "component_count": 1,
+          "tenants": {
+            "unknown": 144086
+          },
+          "users": {
+            "unknown": 144086
+          },
+          "components": {
+            "unknown": 144086
+          }
+        },
+        "window": {
+          "calls": 0,
+          "tenant_count": 0,
+          "user_count": 0,
+          "component_count": 0,
+          "tenants": {},
+          "users": {},
+          "components": {}
+        },
+        "last_seen_at": "2026-08-10T18:06:05.032338Z",
+        "retirement_candidate": true,
+        "retirement_reason": "no measured usage in review window"
+      },
+      {
+        "interface": {
+          "id": "e4c140ec-7479-46f9-b185-4b533f19d639",
+          "interface_key": "rest_api:GET /workstreams/workplan-index",
+          "interface_kind": "rest_api",
+          "legacy_since": "2026-06-04T05:20:58.321869Z",
+          "replacement_ref": "/workplans/index",
+          "owner_component": "state-hub.api",
+          "status": "legacy",
+          "replacement_verified": true,
+          "manual_hold": false,
+          "hold_reason": null,
+          "notes": null,
+          "retired_at": null,
+          "created_at": "2026-06-04T05:20:58.321869Z",
+          "updated_at": "2026-06-04T05:20:58.321869Z"
+        },
+        "all_time": {
+          "calls": 30,
+          "tenant_count": 1,
+          "user_count": 1,
+          "component_count": 1,
+          "tenants": {
+            "unknown": 30
+          },
+          "users": {
+            "unknown": 30
+          },
+          "components": {
+            "unknown": 30
+          }
+        },
+        "window": {
+          "calls": 0,
+          "tenant_count": 0,
+          "user_count": 0,
+          "component_count": 0,
+          "tenants": {},
+          "users": {},
+          "components": {}
+        },
+        "last_seen_at": "2026-07-03T05:20:34.534439Z",
+        "retirement_candidate": true,
+        "retirement_reason": "no measured usage in review window"
+      },
+      {
+        "interface": {
+          "id": "3a00b19e-e7db-4403-98aa-a77c9ab61ecc",
+          "interface_key": "rest_api:GET /workstreams/{workstream_id}",
+          "interface_kind": "rest_api",
+          "legacy_since": "2026-06-04T00:25:59.014966Z",
+          "replacement_ref": "/workplans/{workplan_id}",
+          "owner_component": "state-hub.api",
+          "status": "legacy",
+          "replacement_verified": true,
+          "manual_hold": false,
+          "hold_reason": null,
+          "notes": null,
+          "retired_at": null,
+          "created_at": "2026-06-04T00:25:59.014966Z",
+          "updated_at": "2026-06-04T00:25:59.014966Z"
+        },
+        "all_time": {
+          "calls": 511406,
+          "tenant_count": 1,
+          "user_count": 1,
+          "component_count": 1,
+          "tenants": {
+            "unknown": 511406
+          },
+          "users": {
+            "unknown": 511406
+          },
+          "components": {
+            "unknown": 511406
+          }
+        },
+        "window": {
+          "calls": 0,
+          "tenant_count": 0,
+          "user_count": 0,
+          "component_count": 0,
+          "tenants": {},
+          "users": {},
+          "components": {}
+        },
+        "last_seen_at": "2026-07-31T16:25:32.004042Z",
+        "retirement_candidate": true,
+        "retirement_reason": "no measured usage in review window"
+      },
+      {
+        "interface": {
+          "id": "69e1a255-a8b9-4101-8a68-b1bed23abfda",
+          "interface_key": "rest_api:GET /workstreams/{workstream_id}/dependencies/",
+          "interface_kind": "rest_api",
+          "legacy_since": "2026-06-04T00:25:59.291135Z",
+          "replacement_ref": "/workplans/{workplan_id}/dependencies/",
+          "owner_component": "state-hub.api",
+          "status": "legacy",
+          "replacement_verified": true,
+          "manual_hold": false,
+          "hold_reason": null,
+          "notes": null,
+          "retired_at": null,
+          "created_at": "2026-06-04T00:25:59.291135Z",
+          "updated_at": "2026-06-04T00:25:59.291135Z"
+        },
+        "all_time": {
+          "calls": 255865,
+          "tenant_count": 1,
+          "user_count": 1,
+          "component_count": 1,
+          "tenants": {
+            "unknown": 255865
+          },
+          "users": {
+            "unknown": 255865
+          },
+          "components": {
+            "unknown": 255865
+          }
+        },
+        "window": {
+          "calls": 0,
+          "tenant_count": 0,
+          "user_count": 0,
+          "component_count": 0,
+          "tenants": {},
+          "users": {},
+          "components": {}
+        },
+        "last_seen_at": "2026-07-08T21:14:12.747005Z",
+        "retirement_candidate": true,
+        "retirement_reason": "no measured usage in review window"
+      },
+      {
+        "interface": {
+          "id": "b1aae931-b51f-4a85-a723-865dd65f6132",
+          "interface_key": "rest_api:PATCH /workstreams/{workstream_id}",
+          "interface_kind": "rest_api",
+          "legacy_since": "2026-06-04T06:09:41.901035Z",
+          "replacement_ref": "/workplans/{workplan_id}",
+          "owner_component": "state-hub.api",
+          "status": "legacy",
+          "replacement_verified": true,
+          "manual_hold": false,
+          "hold_reason": null,
+          "notes": null,
+          "retired_at": null,
+          "created_at": "2026-06-04T06:09:41.901035Z",
+          "updated_at": "2026-06-04T06:09:41.901035Z"
+        },
+        "all_time": {
+          "calls": 571,
+          "tenant_count": 1,
+          "user_count": 1,
+          "component_count": 1,
+          "tenants": {
+            "unknown": 571
+          },
+          "users": {
+            "unknown": 571
+          },
+          "components": {
+            "unknown": 571
+          }
+        },
+        "window": {
+          "calls": 0,
+          "tenant_count": 0,
+          "user_count": 0,
+          "component_count": 0,
+          "tenants": {},
+          "users": {},
+          "components": {}
+        },
+        "last_seen_at": "2026-07-08T20:49:12.335710Z",
+        "retirement_candidate": true,
+        "retirement_reason": "no measured usage in review window"
+      },
+      {
+        "interface": {
+          "id": "4aea9591-970b-4918-ac4a-4da95a0a1a8c",
+          "interface_key": "rest_api:POST /decisions/ workstream_id",
+          "interface_kind": "rest_api",
+          "legacy_since": "2026-07-09T22:56:35.473130Z",
+          "replacement_ref": "POST /decisions/ with workplan_id",
+          "owner_component": "state-hub.api",
+          "status": "legacy",
+          "replacement_verified": true,
+          "manual_hold": false,
+          "hold_reason": null,
+          "notes": null,
+          "retired_at": null,
+          "created_at": "2026-07-09T22:56:35.473130Z",
+          "updated_at": "2026-07-09T22:56:35.473130Z"
+        },
+        "all_time": {
+          "calls": 3,
+          "tenant_count": 1,
+          "user_count": 1,
+          "component_count": 1,
+          "tenants": {
+            "unknown": 3
+          },
+          "users": {
+            "unknown": 3
+          },
+          "components": {
+            "unknown": 3
+          }
+        },
+        "window": {
+          "calls": 0,
+          "tenant_count": 0,
+          "user_count": 0,
+          "component_count": 0,
+          "tenants": {},
+          "users": {},
+          "components": {}
+        },
+        "last_seen_at": "2026-07-09T22:57:05.912456Z",
+        "retirement_candidate": true,
+        "retirement_reason": "no measured usage in review window"
+      },
+      {
+        "interface": {
+          "id": "4a70583c-1e41-4ec1-99a9-728856a7d79c",
+          "interface_key": "rest_api:POST /progress/ workstream_id",
+          "interface_kind": "rest_api",
+          "legacy_since": "2026-07-08T23:35:09.148333Z",
+          "replacement_ref": "POST /progress/ with workplan_id",
+          "owner_component": "state-hub.api",
+          "status": "legacy",
+          "replacement_verified": true,
+          "manual_hold": false,
+          "hold_reason": null,
+          "notes": null,
+          "retired_at": null,
+          "created_at": "2026-07-08T23:35:09.148333Z",
+          "updated_at": "2026-07-08T23:35:09.148333Z"
+        },
+        "all_time": {
+          "calls": 14,
+          "tenant_count": 1,
+          "user_count": 1,
+          "component_count": 1,
+          "tenants": {
+            "unknown": 14
+          },
+          "users": {
+            "unknown": 14
+          },
+          "components": {
+            "unknown": 14
+          }
+        },
+        "window": {
+          "calls": 0,
+          "tenant_count": 0,
+          "user_count": 0,
+          "component_count": 0,
+          "tenants": {},
+          "users": {},
+          "components": {}
+        },
+        "last_seen_at": "2026-07-10T08:34:42.959724Z",
+        "retirement_candidate": true,
+        "retirement_reason": "no measured usage in review window"
+      },
+      {
+        "interface": {
+          "id": "6df4e443-7bf1-461a-923b-a6eb52fe7b07",
+          "interface_key": "rest_api:POST /tasks/ workstream_id",
+          "interface_kind": "rest_api",
+          "legacy_since": "2026-07-08T22:38:29.405720Z",
+          "replacement_ref": "POST /tasks/ with workplan_id",
+          "owner_component": "state-hub.api",
+          "status": "legacy",
+          "replacement_verified": true,
+          "manual_hold": false,
+          "hold_reason": null,
+          "notes": null,
+          "retired_at": null,
+          "created_at": "2026-07-08T22:38:29.405720Z",
+          "updated_at": "2026-07-08T22:38:29.405720Z"
+        },
+        "all_time": {
+          "calls": 5,
+          "tenant_count": 1,
+          "user_count": 1,
+          "component_count": 1,
+          "tenants": {
+            "unknown": 5
+          },
+          "users": {
+            "unknown": 5
+          },
+          "components": {
+            "state-hub.fix-consistency": 5
+          }
+        },
+        "window": {
+          "calls": 0,
+          "tenant_count": 0,
+          "user_count": 0,
+          "component_count": 0,
+          "tenants": {},
+          "users": {},
+          "components": {}
+        },
+        "last_seen_at": "2026-07-08T22:38:29.976918Z",
+        "retirement_candidate": true,
+        "retirement_reason": "no measured usage in review window"
+      },
+      {
+        "interface": {
+          "id": "ed6451c9-d2cc-4486-9afe-d3852782cabc",
+          "interface_key": "rest_api:POST /workstreams/",
+          "interface_kind": "rest_api",
+          "legacy_since": "2026-06-04T07:40:24.168535Z",
+          "replacement_ref": "/workplans/",
+          "owner_component": "state-hub.api",
+          "status": "legacy",
+          "replacement_verified": true,
+          "manual_hold": false,
+          "hold_reason": null,
+          "notes": null,
+          "retired_at": null,
+          "created_at": "2026-06-04T07:40:24.168535Z",
+          "updated_at": "2026-06-04T07:40:24.168535Z"
+        },
+        "all_time": {
+          "calls": 824,
+          "tenant_count": 1,
+          "user_count": 1,
+          "component_count": 1,
+          "tenants": {
+            "unknown": 824
+          },
+          "users": {
+            "unknown": 824
+          },
+          "components": {
+            "unknown": 824
+          }
+        },
+        "window": {
+          "calls": 0,
+          "tenant_count": 0,
+          "user_count": 0,
+          "component_count": 0,
+          "tenants": {},
+          "users": {},
+          "components": {}
+        },
+        "last_seen_at": "2026-07-08T20:38:05.903144Z",
+        "retirement_candidate": true,
+        "retirement_reason": "no measured usage in review window"
+      },
+      {
+        "interface": {
+          "id": "281fd706-b192-4194-8055-2d8733c115f9",
+          "interface_key": "rest_api:POST /workstreams/{workstream_id}/dependencies/",
+          "interface_kind": "rest_api",
+          "legacy_since": "2026-06-04T22:57:37.149207Z",
+          "replacement_ref": "/workplans/{workplan_id}/dependencies/",
+          "owner_component": "state-hub.api",
+          "status": "legacy",
+          "replacement_verified": true,
+          "manual_hold": false,
+          "hold_reason": null,
+          "notes": null,
+          "retired_at": null,
+          "created_at": "2026-06-04T22:57:37.149207Z",
+          "updated_at": "2026-06-04T22:57:37.149207Z"
+        },
+        "all_time": {
+          "calls": 4971,
+          "tenant_count": 1,
+          "user_count": 1,
+          "component_count": 1,
+          "tenants": {
+            "unknown": 4971
+          },
+          "users": {
+            "unknown": 4971
+          },
+          "components": {
+            "unknown": 4971
+          }
+        },
+        "window": {
+          "calls": 0,
+          "tenant_count": 0,
+          "user_count": 0,
+          "component_count": 0,
+          "tenants": {},
+          "users": {},
+          "components": {}
+        },
+        "last_seen_at": "2026-07-01T22:09:24.229011Z",
+        "retirement_candidate": true,
+        "retirement_reason": "no measured usage in review window"
+      }
+    ],
+    "retirement_candidates": [
+      {
+        "interface": {
+          "id": "63ed90e3-42b4-431a-94db-e1254a52f9e2",
+          "interface_key": "mcp:create_workstream",
+          "interface_kind": "mcp_tool",
+          "legacy_since": "2026-07-10T13:19:44.205900Z",
+          "replacement_ref": "create_workplan",
+          "owner_component": "state-hub.mcp",
+          "status": "legacy",
+          "replacement_verified": true,
+          "manual_hold": false,
+          "hold_reason": null,
+          "notes": "Registered by STATE-WP-0070 T03 \u2014 zero-window streak starts at registration",
+          "retired_at": null,
+          "created_at": "2026-07-10T13:19:44.205900Z",
+          "updated_at": "2026-07-10T13:19:44.205900Z"
+        },
+        "all_time": {
+          "calls": 2,
+          "tenant_count": 1,
+          "user_count": 1,
+          "component_count": 1,
+          "tenants": {
+            "unknown": 2
+          },
+          "users": {
+            "unknown": 2
+          },
+          "components": {
+            "state-hub.mcp": 2
+          }
+        },
+        "window": {
+          "calls": 0,
+          "tenant_count": 0,
+          "user_count": 0,
+          "component_count": 0,
+          "tenants": {},
+          "users": {},
+          "components": {}
+        },
+        "last_seen_at": "2026-07-10T13:20:43.378546Z",
+        "retirement_candidate": true,
+        "retirement_reason": "no measured usage in review window"
+      },
+      {
+        "interface": {
+          "id": "b6a5fe44-fb85-4ef7-a273-78d09da777af",
+          "interface_key": "mcp:list_workstreams",
+          "interface_kind": "mcp_tool",
+          "legacy_since": "2026-07-10T13:19:26.075491Z",
+          "replacement_ref": "list_workplans",
+          "owner_component": "state-hub.mcp",
+          "status": "legacy",
+          "replacement_verified": true,
+          "manual_hold": false,
+          "hold_reason": null,
+          "notes": null,
+          "retired_at": null,
+          "created_at": "2026-07-10T13:19:26.075491Z",
+          "updated_at": "2026-07-10T13:19:26.075491Z"
+        },
+        "all_time": {
+          "calls": 2,
+          "tenant_count": 1,
+          "user_count": 1,
+          "component_count": 1,
+          "tenants": {
+            "unknown": 2
+          },
+          "users": {
+            "unknown": 2
+          },
+          "components": {
+            "state-hub.mcp": 2
+          }
+        },
+        "window": {
+          "calls": 0,
+          "tenant_count": 0,
+          "user_count": 0,
+          "component_count": 0,
+          "tenants": {},
+          "users": {},
+          "components": {}
+        },
+        "last_seen_at": "2026-07-10T13:20:42.374940Z",
+        "retirement_candidate": true,
+        "retirement_reason": "no measured usage in review window"
+      },
+      {
+        "interface": {
+          "id": "53c3372b-307d-4d6a-8ea4-bc36cacdcaf2",
+          "interface_key": "mcp:update_workstream",
+          "interface_kind": "mcp_tool",
+          "legacy_since": "2026-07-10T13:19:44.255216Z",
+          "replacement_ref": "update_workplan",
+          "owner_component": "state-hub.mcp",
+          "status": "legacy",
+          "replacement_verified": true,
+          "manual_hold": false,
+          "hold_reason": null,
+          "notes": "Registered by STATE-WP-0070 T03 \u2014 zero-window streak starts at registration",
+          "retired_at": null,
+          "created_at": "2026-07-10T13:19:44.255216Z",
+          "updated_at": "2026-07-10T13:19:44.255216Z"
+        },
+        "all_time": {
+          "calls": 0,
+          "tenant_count": 0,
+          "user_count": 0,
+          "component_count": 0,
+          "tenants": {},
+          "users": {},
+          "components": {}
+        },
+        "window": {
+          "calls": 0,
+          "tenant_count": 0,
+          "user_count": 0,
+          "component_count": 0,
+          "tenants": {},
+          "users": {},
+          "components": {}
+        },
+        "last_seen_at": null,
+        "retirement_candidate": true,
+        "retirement_reason": "no measured usage in review window"
+      },
+      {
+        "interface": {
+          "id": "bed4d08a-3471-48f5-9f0e-f9d550383a26",
+          "interface_key": "mcp:update_workstream_status",
+          "interface_kind": "mcp_tool",
+          "legacy_since": "2026-07-10T13:19:44.303612Z",
+          "replacement_ref": "update_workplan_status",
+          "owner_component": "state-hub.mcp",
+          "status": "legacy",
+          "replacement_verified": true,
+          "manual_hold": false,
+          "hold_reason": null,
+          "notes": "Registered by STATE-WP-0070 T03 \u2014 zero-window streak starts at registration",
+          "retired_at": null,
+          "created_at": "2026-07-10T13:19:44.303612Z",
+          "updated_at": "2026-07-10T13:19:44.303612Z"
+        },
+        "all_time": {
+          "calls": 0,
+          "tenant_count": 0,
+          "user_count": 0,
+          "component_count": 0,
+          "tenants": {},
+          "users": {},
+          "components": {}
+        },
+        "window": {
+          "calls": 0,
+          "tenant_count": 0,
+          "user_count": 0,
+          "component_count": 0,
+          "tenants": {},
+          "users": {},
+          "components": {}
+        },
+        "last_seen_at": null,
+        "retirement_candidate": true,
+        "retirement_reason": "no measured usage in review window"
+      },
+      {
+        "interface": {
+          "id": "46900dc2-0893-405b-ba59-80f31fb6ebb1",
+          "interface_key": "state://workstreams/{topic_slug}",
+          "interface_kind": "mcp_tool",
+          "legacy_since": "2026-07-10T13:19:44.344493Z",
+          "replacement_ref": "state://workplans/{topic_slug}",
+          "owner_component": "state-hub.mcp",
+          "status": "legacy",
+          "replacement_verified": true,
+          "manual_hold": false,
+          "hold_reason": null,
+          "notes": "Registered by STATE-WP-0070 T03 \u2014 zero-window streak starts at registration",
+          "retired_at": null,
+          "created_at": "2026-07-10T13:19:44.344493Z",
+          "updated_at": "2026-07-10T13:19:44.344493Z"
+        },
+        "all_time": {
+          "calls": 1,
+          "tenant_count": 1,
+          "user_count": 1,
+          "component_count": 1,
+          "tenants": {
+            "unknown": 1
+          },
+          "users": {
+            "unknown": 1
+          },
+          "components": {
+            "state-hub.mcp": 1
+          }
+        },
+        "window": {
+          "calls": 0,
+          "tenant_count": 0,
+          "user_count": 0,
+          "component_count": 0,
+          "tenants": {},
+          "users": {},
+          "components": {}
+        },
+        "last_seen_at": "2026-07-10T13:20:34.491811Z",
+        "retirement_candidate": true,
+        "retirement_reason": "no measured usage in review window"
+      },
+      {
+        "interface": {
+          "id": "cd9342fd-27e7-4a46-a1be-d41499e106a3",
+          "interface_key": "rest_api:DELETE /workstreams/{workstream_id}",
+          "interface_kind": "rest_api",
+          "legacy_since": "2026-06-06T17:28:13.052813Z",
+          "replacement_ref": "/workplans/{workplan_id}",
+          "owner_component": "state-hub.api",
+          "status": "legacy",
+          "replacement_verified": true,
+          "manual_hold": false,
+          "hold_reason": null,
+          "notes": null,
+          "retired_at": null,
+          "created_at": "2026-06-06T17:28:13.052813Z",
+          "updated_at": "2026-06-06T17:28:13.052813Z"
+        },
+        "all_time": {
+          "calls": 1,
+          "tenant_count": 1,
+          "user_count": 1,
+          "component_count": 1,
+          "tenants": {
+            "unknown": 1
+          },
+          "users": {
+            "unknown": 1
+          },
+          "components": {
+            "unknown": 1
+          }
+        },
+        "window": {
+          "calls": 0,
+          "tenant_count": 0,
+          "user_count": 0,
+          "component_count": 0,
+          "tenants": {},
+          "users": {},
+          "components": {}
+        },
+        "last_seen_at": "2026-06-06T17:28:13.047529Z",
+        "retirement_candidate": true,
+        "retirement_reason": "no measured usage in review window"
+      },
+      {
+        "interface": {
+          "id": "a4e0948c-cd4a-461e-8ae2-7fd7b51d04a7",
+          "interface_key": "rest_api:GET /decisions/?workstream_id",
+          "interface_kind": "rest_api",
+          "legacy_since": "2026-07-09T23:07:53.093223Z",
+          "replacement_ref": "/decisions/?workplan_id=<workplan_id>",
+          "owner_component": "state-hub.api",
+          "status": "legacy",
+          "replacement_verified": true,
+          "manual_hold": false,
+          "hold_reason": null,
+          "notes": null,
+          "retired_at": null,
+          "created_at": "2026-07-09T23:07:53.093223Z",
+          "updated_at": "2026-07-09T23:07:53.093223Z"
+        },
+        "all_time": {
+          "calls": 1,
+          "tenant_count": 1,
+          "user_count": 1,
+          "component_count": 1,
+          "tenants": {
+            "unknown": 1
+          },
+          "users": {
+            "unknown": 1
+          },
+          "components": {
+            "unknown": 1
+          }
+        },
+        "window": {
+          "calls": 0,
+          "tenant_count": 0,
+          "user_count": 0,
+          "component_count": 0,
+          "tenants": {},
+          "users": {},
+          "components": {}
+        },
+        "last_seen_at": "2026-07-09T23:07:53.083299Z",
+        "retirement_candidate": true,
+        "retirement_reason": "no measured usage in review window"
+      },
+      {
+        "interface": {
+          "id": "70a9346e-e0ee-42ac-874f-f160580b54dd",
+          "interface_key": "rest_api:GET /progress/?workstream_id",
+          "interface_kind": "rest_api",
+          "legacy_since": "2026-07-13T22:04:03.911449Z",
+          "replacement_ref": "/progress/?workplan_id=<workplan_id>",
+          "owner_component": "state-hub.api",
+          "status": "legacy",
+          "replacement_verified": true,
+          "manual_hold": false,
+          "hold_reason": null,
+          "notes": null,
+          "retired_at": null,
+          "created_at": "2026-07-13T22:04:03.911449Z",
+          "updated_at": "2026-07-13T22:04:03.911449Z"
+        },
+        "all_time": {
+          "calls": 2,
+          "tenant_count": 1,
+          "user_count": 1,
+          "component_count": 1,
+          "tenants": {
+            "unknown": 2
+          },
+          "users": {
+            "unknown": 2
+          },
+          "components": {
+            "unknown": 2
+          }
+        },
+        "window": {
+          "calls": 0,
+          "tenant_count": 0,
+          "user_count": 0,
+          "component_count": 0,
+          "tenants": {},
+          "users": {},
+          "components": {}
+        },
+        "last_seen_at": "2026-08-12T08:55:33.912995Z",
+        "retirement_candidate": true,
+        "retirement_reason": "no measured usage in review window"
+      },
+      {
+        "interface": {
+          "id": "be3cdcf8-250b-4bf0-801f-02ffd5f57e00",
+          "interface_key": "rest_api:GET /tasks/?workstream_id",
+          "interface_kind": "rest_api",
+          "legacy_since": "2026-07-08T19:32:21.628513Z",
+          "replacement_ref": "/tasks/?workplan_id=<workplan_id>",
+          "owner_component": "state-hub.api",
+          "status": "legacy",
+          "replacement_verified": true,
+          "manual_hold": false,
+          "hold_reason": null,
+          "notes": null,
+          "retired_at": null,
+          "created_at": "2026-07-08T19:32:21.628513Z",
+          "updated_at": "2026-07-08T19:32:21.628513Z"
+        },
+        "all_time": {
+          "calls": 590,
+          "tenant_count": 1,
+          "user_count": 1,
+          "component_count": 1,
+          "tenants": {
+            "unknown": 590
+          },
+          "users": {
+            "unknown": 590
+          },
+          "components": {
+            "unknown": 590
+          }
+        },
+        "window": {
+          "calls": 0,
+          "tenant_count": 0,
+          "user_count": 0,
+          "component_count": 0,
+          "tenants": {},
+          "users": {},
+          "components": {}
+        },
+        "last_seen_at": "2026-08-12T08:55:27.763102Z",
+        "retirement_candidate": true,
+        "retirement_reason": "no measured usage in review window"
+      },
+      {
+        "interface": {
+          "id": "3e4a3d0b-08fa-45c3-91e2-4f514a914b97",
+          "interface_key": "rest_api:GET /workstreams/",
+          "interface_kind": "rest_api",
+          "legacy_since": "2026-06-04T00:26:14.533764Z",
+          "replacement_ref": "/workplans/",
+          "owner_component": "state-hub.api",
+          "status": "legacy",
+          "replacement_verified": true,
+          "manual_hold": false,
+          "hold_reason": null,
+          "notes": null,
+          "retired_at": null,
+          "created_at": "2026-06-04T00:26:14.533764Z",
+          "updated_at": "2026-06-04T00:26:14.533764Z"
+        },
+        "all_time": {
+          "calls": 144086,
+          "tenant_count": 1,
+          "user_count": 1,
+          "component_count": 1,
+          "tenants": {
+            "unknown": 144086
+          },
+          "users": {
+            "unknown": 144086
+          },
+          "components": {
+            "unknown": 144086
+          }
+        },
+        "window": {
+          "calls": 0,
+          "tenant_count": 0,
+          "user_count": 0,
+          "component_count": 0,
+          "tenants": {},
+          "users": {},
+          "components": {}
+        },
+        "last_seen_at": "2026-08-10T18:06:05.032338Z",
+        "retirement_candidate": true,
+        "retirement_reason": "no measured usage in review window"
+      },
+      {
+        "interface": {
+          "id": "e4c140ec-7479-46f9-b185-4b533f19d639",
+          "interface_key": "rest_api:GET /workstreams/workplan-index",
+          "interface_kind": "rest_api",
+          "legacy_since": "2026-06-04T05:20:58.321869Z",
+          "replacement_ref": "/workplans/index",
+          "owner_component": "state-hub.api",
+          "status": "legacy",
+          "replacement_verified": true,
+          "manual_hold": false,
+          "hold_reason": null,
+          "notes": null,
+          "retired_at": null,
+          "created_at": "2026-06-04T05:20:58.321869Z",
+          "updated_at": "2026-06-04T05:20:58.321869Z"
+        },
+        "all_time": {
+          "calls": 30,
+          "tenant_count": 1,
+          "user_count": 1,
+          "component_count": 1,
+          "tenants": {
+            "unknown": 30
+          },
+          "users": {
+            "unknown": 30
+          },
+          "components": {
+            "unknown": 30
+          }
+        },
+        "window": {
+          "calls": 0,
+          "tenant_count": 0,
+          "user_count": 0,
+          "component_count": 0,
+          "tenants": {},
+          "users": {},
+          "components": {}
+        },
+        "last_seen_at": "2026-07-03T05:20:34.534439Z",
+        "retirement_candidate": true,
+        "retirement_reason": "no measured usage in review window"
+      },
+      {
+        "interface": {
+          "id": "3a00b19e-e7db-4403-98aa-a77c9ab61ecc",
+          "interface_key": "rest_api:GET /workstreams/{workstream_id}",
+          "interface_kind": "rest_api",
+          "legacy_since": "2026-06-04T00:25:59.014966Z",
+          "replacement_ref": "/workplans/{workplan_id}",
+          "owner_component": "state-hub.api",
+          "status": "legacy",
+          "replacement_verified": true,
+          "manual_hold": false,
+          "hold_reason": null,
+          "notes": null,
+          "retired_at": null,
+          "created_at": "2026-06-04T00:25:59.014966Z",
+          "updated_at": "2026-06-04T00:25:59.014966Z"
+        },
+        "all_time": {
+          "calls": 511406,
+          "tenant_count": 1,
+          "user_count": 1,
+          "component_count": 1,
+          "tenants": {
+            "unknown": 511406
+          },
+          "users": {
+            "unknown": 511406
+          },
+          "components": {
+            "unknown": 511406
+          }
+        },
+        "window": {
+          "calls": 0,
+          "tenant_count": 0,
+          "user_count": 0,
+          "component_count": 0,
+          "tenants": {},
+          "users": {},
+          "components": {}
+        },
+        "last_seen_at": "2026-07-31T16:25:32.004042Z",
+        "retirement_candidate": true,
+        "retirement_reason": "no measured usage in review window"
+      },
+      {
+        "interface": {
+          "id": "69e1a255-a8b9-4101-8a68-b1bed23abfda",
+          "interface_key": "rest_api:GET /workstreams/{workstream_id}/dependencies/",
+          "interface_kind": "rest_api",
+          "legacy_since": "2026-06-04T00:25:59.291135Z",
+          "replacement_ref": "/workplans/{workplan_id}/dependencies/",
+          "owner_component": "state-hub.api",
+          "status": "legacy",
+          "replacement_verified": true,
+          "manual_hold": false,
+          "hold_reason": null,
+          "notes": null,
+          "retired_at": null,
+          "created_at": "2026-06-04T00:25:59.291135Z",
+          "updated_at": "2026-06-04T00:25:59.291135Z"
+        },
+        "all_time": {
+          "calls": 255865,
+          "tenant_count": 1,
+          "user_count": 1,
+          "component_count": 1,
+          "tenants": {
+            "unknown": 255865
+          },
+          "users": {
+            "unknown": 255865
+          },
+          "components": {
+            "unknown": 255865
+          }
+        },
+        "window": {
+          "calls": 0,
+          "tenant_count": 0,
+          "user_count": 0,
+          "component_count": 0,
+          "tenants": {},
+          "users": {},
+          "components": {}
+        },
+        "last_seen_at": "2026-07-08T21:14:12.747005Z",
+        "retirement_candidate": true,
+        "retirement_reason": "no measured usage in review window"
+      },
+      {
+        "interface": {
+          "id": "b1aae931-b51f-4a85-a723-865dd65f6132",
+          "interface_key": "rest_api:PATCH /workstreams/{workstream_id}",
+          "interface_kind": "rest_api",
+          "legacy_since": "2026-06-04T06:09:41.901035Z",
+          "replacement_ref": "/workplans/{workplan_id}",
+          "owner_component": "state-hub.api",
+          "status": "legacy",
+          "replacement_verified": true,
+          "manual_hold": false,
+          "hold_reason": null,
+          "notes": null,
+          "retired_at": null,
+          "created_at": "2026-06-04T06:09:41.901035Z",
+          "updated_at": "2026-06-04T06:09:41.901035Z"
+        },
+        "all_time": {
+          "calls": 571,
+          "tenant_count": 1,
+          "user_count": 1,
+          "component_count": 1,
+          "tenants": {
+            "unknown": 571
+          },
+          "users": {
+            "unknown": 571
+          },
+          "components": {
+            "unknown": 571
+          }
+        },
+        "window": {
+          "calls": 0,
+          "tenant_count": 0,
+          "user_count": 0,
+          "component_count": 0,
+          "tenants": {},
+          "users": {},
+          "components": {}
+        },
+        "last_seen_at": "2026-07-08T20:49:12.335710Z",
+        "retirement_candidate": true,
+        "retirement_reason": "no measured usage in review window"
+      },
+      {
+        "interface": {
+          "id": "4aea9591-970b-4918-ac4a-4da95a0a1a8c",
+          "interface_key": "rest_api:POST /decisions/ workstream_id",
+          "interface_kind": "rest_api",
+          "legacy_since": "2026-07-09T22:56:35.473130Z",
+          "replacement_ref": "POST /decisions/ with workplan_id",
+          "owner_component": "state-hub.api",
+          "status": "legacy",
+          "replacement_verified": true,
+          "manual_hold": false,
+          "hold_reason": null,
+          "notes": null,
+          "retired_at": null,
+          "created_at": "2026-07-09T22:56:35.473130Z",
+          "updated_at": "2026-07-09T22:56:35.473130Z"
+        },
+        "all_time": {
+          "calls": 3,
+          "tenant_count": 1,
+          "user_count": 1,
+          "component_count": 1,
+          "tenants": {
+            "unknown": 3
+          },
+          "users": {
+            "unknown": 3
+          },
+          "components": {
+            "unknown": 3
+          }
+        },
+        "window": {
+          "calls": 0,
+          "tenant_count": 0,
+          "user_count": 0,
+          "component_count": 0,
+          "tenants": {},
+          "users": {},
+          "components": {}
+        },
+        "last_seen_at": "2026-07-09T22:57:05.912456Z",
+        "retirement_candidate": true,
+        "retirement_reason": "no measured usage in review window"
+      },
+      {
+        "interface": {
+          "id": "4a70583c-1e41-4ec1-99a9-728856a7d79c",
+          "interface_key": "rest_api:POST /progress/ workstream_id",
+          "interface_kind": "rest_api",
+          "legacy_since": "2026-07-08T23:35:09.148333Z",
+          "replacement_ref": "POST /progress/ with workplan_id",
+          "owner_component": "state-hub.api",
+          "status": "legacy",
+          "replacement_verified": true,
+          "manual_hold": false,
+          "hold_reason": null,
+          "notes": null,
+          "retired_at": null,
+          "created_at": "2026-07-08T23:35:09.148333Z",
+          "updated_at": "2026-07-08T23:35:09.148333Z"
+        },
+        "all_time": {
+          "calls": 14,
+          "tenant_count": 1,
+          "user_count": 1,
+          "component_count": 1,
+          "tenants": {
+            "unknown": 14
+          },
+          "users": {
+            "unknown": 14
+          },
+          "components": {
+            "unknown": 14
+          }
+        },
+        "window": {
+          "calls": 0,
+          "tenant_count": 0,
+          "user_count": 0,
+          "component_count": 0,
+          "tenants": {},
+          "users": {},
+          "components": {}
+        },
+        "last_seen_at": "2026-07-10T08:34:42.959724Z",
+        "retirement_candidate": true,
+        "retirement_reason": "no measured usage in review window"
+      },
+      {
+        "interface": {
+          "id": "6df4e443-7bf1-461a-923b-a6eb52fe7b07",
+          "interface_key": "rest_api:POST /tasks/ workstream_id",
+          "interface_kind": "rest_api",
+          "legacy_since": "2026-07-08T22:38:29.405720Z",
+          "replacement_ref": "POST /tasks/ with workplan_id",
+          "owner_component": "state-hub.api",
+          "status": "legacy",
+          "replacement_verified": true,
+          "manual_hold": false,
+          "hold_reason": null,
+          "notes": null,
+          "retired_at": null,
+          "created_at": "2026-07-08T22:38:29.405720Z",
+          "updated_at": "2026-07-08T22:38:29.405720Z"
+        },
+        "all_time": {
+          "calls": 5,
+          "tenant_count": 1,
+          "user_count": 1,
+          "component_count": 1,
+          "tenants": {
+            "unknown": 5
+          },
+          "users": {
+            "unknown": 5
+          },
+          "components": {
+            "state-hub.fix-consistency": 5
+          }
+        },
+        "window": {
+          "calls": 0,
+          "tenant_count": 0,
+          "user_count": 0,
+          "component_count": 0,
+          "tenants": {},
+          "users": {},
+          "components": {}
+        },
+        "last_seen_at": "2026-07-08T22:38:29.976918Z",
+        "retirement_candidate": true,
+        "retirement_reason": "no measured usage in review window"
+      },
+      {
+        "interface": {
+          "id": "ed6451c9-d2cc-4486-9afe-d3852782cabc",
+          "interface_key": "rest_api:POST /workstreams/",
+          "interface_kind": "rest_api",
+          "legacy_since": "2026-06-04T07:40:24.168535Z",
+          "replacement_ref": "/workplans/",
+          "owner_component": "state-hub.api",
+          "status": "legacy",
+          "replacement_verified": true,
+          "manual_hold": false,
+          "hold_reason": null,
+          "notes": null,
+          "retired_at": null,
+          "created_at": "2026-06-04T07:40:24.168535Z",
+          "updated_at": "2026-06-04T07:40:24.168535Z"
+        },
+        "all_time": {
+          "calls": 824,
+          "tenant_count": 1,
+          "user_count": 1,
+          "component_count": 1,
+          "tenants": {
+            "unknown": 824
+          },
+          "users": {
+            "unknown": 824
+          },
+          "components": {
+            "unknown": 824
+          }
+        },
+        "window": {
+          "calls": 0,
+          "tenant_count": 0,
+          "user_count": 0,
+          "component_count": 0,
+          "tenants": {},
+          "users": {},
+          "components": {}
+        },
+        "last_seen_at": "2026-07-08T20:38:05.903144Z",
+        "retirement_candidate": true,
+        "retirement_reason": "no measured usage in review window"
+      },
+      {
+        "interface": {
+          "id": "281fd706-b192-4194-8055-2d8733c115f9",
+          "interface_key": "rest_api:POST /workstreams/{workstream_id}/dependencies/",
+          "interface_kind": "rest_api",
+          "legacy_since": "2026-06-04T22:57:37.149207Z",
+          "replacement_ref": "/workplans/{workplan_id}/dependencies/",
+          "owner_component": "state-hub.api",
+          "status": "legacy",
+          "replacement_verified": true,
+          "manual_hold": false,
+          "hold_reason": null,
+          "notes": null,
+          "retired_at": null,
+          "created_at": "2026-06-04T22:57:37.149207Z",
+          "updated_at": "2026-06-04T22:57:37.149207Z"
+        },
+        "all_time": {
+          "calls": 4971,
+          "tenant_count": 1,
+          "user_count": 1,
+          "component_count": 1,
+          "tenants": {
+            "unknown": 4971
+          },
+          "users": {
+            "unknown": 4971
+          },
+          "components": {
+            "unknown": 4971
+          }
+        },
+        "window": {
+          "calls": 0,
+          "tenant_count": 0,
+          "user_count": 0,
+          "component_count": 0,
+          "tenants": {},
+          "users": {},
+          "components": {}
+        },
+        "last_seen_at": "2026-07-01T22:09:24.229011Z",
+        "retirement_candidate": true,
+        "retirement_reason": "no measured usage in review window"
+      }
+    ]
+  },
+  "hours": 8
+}
diff --git a/docs/evidence/legacy-meter-weekly-review-20260817.json b/docs/evidence/legacy-meter-weekly-review-20260817.json
new file mode 100644
index 0000000..4c1dac2
--- /dev/null
+++ b/docs/evidence/legacy-meter-weekly-review-20260817.json
@@ -0,0 +1,1755 @@
+{
+  "captured_at": "2026-08-17T14:00:07.160121+00:00",
+  "api_base": "http://127.0.0.1:8000",
+  "workplan": "STATE-WP-0070",
+  "retired_interfaces": [],
+  "weekly_review": {
+    "generated_at": "2026-08-17T14:00:07.153547Z",
+    "window_start": "2026-08-17T06:00:07.054958Z",
+    "window_end": "2026-08-17T14:00:07.054958Z",
+    "cadence": "weekly",
+    "activity_core_handoff": {
+      "activity_id": "statehub-legacy-interface-review",
+      "cadence": "weekly",
+      "source_endpoint": "/legacy-meter/weekly-review",
+      "state_owner": "state-hub",
+      "scheduler_owner": "activity-core"
+    },
+    "interfaces": [
+      {
+        "interface": {
+          "id": "8051fb40-66c9-4dc4-a413-13e8573e04a3",
+          "interface_key": "event_subject:org.statehub.workstream.completed",
+          "interface_kind": "event_subject",
+          "legacy_since": "2026-06-04T06:09:42.198193Z",
+          "replacement_ref": "org.statehub.workplan.completed",
+          "owner_component": "state-hub.events",
+          "status": "retired",
+          "replacement_verified": true,
+          "manual_hold": false,
+          "hold_reason": null,
+          "notes": "Retired by STATE-WP-0069 closeout",
+          "retired_at": "2026-07-08T21:38:52.773601Z",
+          "created_at": "2026-06-04T06:09:42.198193Z",
+          "updated_at": "2026-07-08T21:38:52.761243Z"
+        },
+        "all_time": {
+          "calls": 255,
+          "tenant_count": 1,
+          "user_count": 1,
+          "component_count": 1,
+          "tenants": {
+            "unknown": 255
+          },
+          "users": {
+            "unknown": 255
+          },
+          "components": {
+            "state-hub.events": 255
+          }
+        },
+        "window": {
+          "calls": 0,
+          "tenant_count": 0,
+          "user_count": 0,
+          "component_count": 0,
+          "tenants": {},
+          "users": {},
+          "components": {}
+        },
+        "last_seen_at": "2026-07-08T20:49:12.839383Z",
+        "retirement_candidate": false,
+        "retirement_reason": "already retired"
+      },
+      {
+        "interface": {
+          "id": "63ed90e3-42b4-431a-94db-e1254a52f9e2",
+          "interface_key": "mcp:create_workstream",
+          "interface_kind": "mcp_tool",
+          "legacy_since": "2026-07-10T13:19:44.205900Z",
+          "replacement_ref": "create_workplan",
+          "owner_component": "state-hub.mcp",
+          "status": "legacy",
+          "replacement_verified": true,
+          "manual_hold": false,
+          "hold_reason": null,
+          "notes": "Registered by STATE-WP-0070 T03 \u2014 zero-window streak starts at registration",
+          "retired_at": null,
+          "created_at": "2026-07-10T13:19:44.205900Z",
+          "updated_at": "2026-07-10T13:19:44.205900Z"
+        },
+        "all_time": {
+          "calls": 2,
+          "tenant_count": 1,
+          "user_count": 1,
+          "component_count": 1,
+          "tenants": {
+            "unknown": 2
+          },
+          "users": {
+            "unknown": 2
+          },
+          "components": {
+            "state-hub.mcp": 2
+          }
+        },
+        "window": {
+          "calls": 0,
+          "tenant_count": 0,
+          "user_count": 0,
+          "component_count": 0,
+          "tenants": {},
+          "users": {},
+          "components": {}
+        },
+        "last_seen_at": "2026-07-10T13:20:43.378546Z",
+        "retirement_candidate": true,
+        "retirement_reason": "no measured usage in review window"
+      },
+      {
+        "interface": {
+          "id": "b6a5fe44-fb85-4ef7-a273-78d09da777af",
+          "interface_key": "mcp:list_workstreams",
+          "interface_kind": "mcp_tool",
+          "legacy_since": "2026-07-10T13:19:26.075491Z",
+          "replacement_ref": "list_workplans",
+          "owner_component": "state-hub.mcp",
+          "status": "legacy",
+          "replacement_verified": true,
+          "manual_hold": false,
+          "hold_reason": null,
+          "notes": null,
+          "retired_at": null,
+          "created_at": "2026-07-10T13:19:26.075491Z",
+          "updated_at": "2026-07-10T13:19:26.075491Z"
+        },
+        "all_time": {
+          "calls": 2,
+          "tenant_count": 1,
+          "user_count": 1,
+          "component_count": 1,
+          "tenants": {
+            "unknown": 2
+          },
+          "users": {
+            "unknown": 2
+          },
+          "components": {
+            "state-hub.mcp": 2
+          }
+        },
+        "window": {
+          "calls": 0,
+          "tenant_count": 0,
+          "user_count": 0,
+          "component_count": 0,
+          "tenants": {},
+          "users": {},
+          "components": {}
+        },
+        "last_seen_at": "2026-07-10T13:20:42.374940Z",
+        "retirement_candidate": true,
+        "retirement_reason": "no measured usage in review window"
+      },
+      {
+        "interface": {
+          "id": "53c3372b-307d-4d6a-8ea4-bc36cacdcaf2",
+          "interface_key": "mcp:update_workstream",
+          "interface_kind": "mcp_tool",
+          "legacy_since": "2026-07-10T13:19:44.255216Z",
+          "replacement_ref": "update_workplan",
+          "owner_component": "state-hub.mcp",
+          "status": "legacy",
+          "replacement_verified": true,
+          "manual_hold": false,
+          "hold_reason": null,
+          "notes": "Registered by STATE-WP-0070 T03 \u2014 zero-window streak starts at registration",
+          "retired_at": null,
+          "created_at": "2026-07-10T13:19:44.255216Z",
+          "updated_at": "2026-07-10T13:19:44.255216Z"
+        },
+        "all_time": {
+          "calls": 0,
+          "tenant_count": 0,
+          "user_count": 0,
+          "component_count": 0,
+          "tenants": {},
+          "users": {},
+          "components": {}
+        },
+        "window": {
+          "calls": 0,
+          "tenant_count": 0,
+          "user_count": 0,
+          "component_count": 0,
+          "tenants": {},
+          "users": {},
+          "components": {}
+        },
+        "last_seen_at": null,
+        "retirement_candidate": true,
+        "retirement_reason": "no measured usage in review window"
+      },
+      {
+        "interface": {
+          "id": "bed4d08a-3471-48f5-9f0e-f9d550383a26",
+          "interface_key": "mcp:update_workstream_status",
+          "interface_kind": "mcp_tool",
+          "legacy_since": "2026-07-10T13:19:44.303612Z",
+          "replacement_ref": "update_workplan_status",
+          "owner_component": "state-hub.mcp",
+          "status": "legacy",
+          "replacement_verified": true,
+          "manual_hold": false,
+          "hold_reason": null,
+          "notes": "Registered by STATE-WP-0070 T03 \u2014 zero-window streak starts at registration",
+          "retired_at": null,
+          "created_at": "2026-07-10T13:19:44.303612Z",
+          "updated_at": "2026-07-10T13:19:44.303612Z"
+        },
+        "all_time": {
+          "calls": 0,
+          "tenant_count": 0,
+          "user_count": 0,
+          "component_count": 0,
+          "tenants": {},
+          "users": {},
+          "components": {}
+        },
+        "window": {
+          "calls": 0,
+          "tenant_count": 0,
+          "user_count": 0,
+          "component_count": 0,
+          "tenants": {},
+          "users": {},
+          "components": {}
+        },
+        "last_seen_at": null,
+        "retirement_candidate": true,
+        "retirement_reason": "no measured usage in review window"
+      },
+      {
+        "interface": {
+          "id": "46900dc2-0893-405b-ba59-80f31fb6ebb1",
+          "interface_key": "state://workstreams/{topic_slug}",
+          "interface_kind": "mcp_tool",
+          "legacy_since": "2026-07-10T13:19:44.344493Z",
+          "replacement_ref": "state://workplans/{topic_slug}",
+          "owner_component": "state-hub.mcp",
+          "status": "legacy",
+          "replacement_verified": true,
+          "manual_hold": false,
+          "hold_reason": null,
+          "notes": "Registered by STATE-WP-0070 T03 \u2014 zero-window streak starts at registration",
+          "retired_at": null,
+          "created_at": "2026-07-10T13:19:44.344493Z",
+          "updated_at": "2026-07-10T13:19:44.344493Z"
+        },
+        "all_time": {
+          "calls": 1,
+          "tenant_count": 1,
+          "user_count": 1,
+          "component_count": 1,
+          "tenants": {
+            "unknown": 1
+          },
+          "users": {
+            "unknown": 1
+          },
+          "components": {
+            "state-hub.mcp": 1
+          }
+        },
+        "window": {
+          "calls": 0,
+          "tenant_count": 0,
+          "user_count": 0,
+          "component_count": 0,
+          "tenants": {},
+          "users": {},
+          "components": {}
+        },
+        "last_seen_at": "2026-07-10T13:20:34.491811Z",
+        "retirement_candidate": true,
+        "retirement_reason": "no measured usage in review window"
+      },
+      {
+        "interface": {
+          "id": "cd9342fd-27e7-4a46-a1be-d41499e106a3",
+          "interface_key": "rest_api:DELETE /workstreams/{workstream_id}",
+          "interface_kind": "rest_api",
+          "legacy_since": "2026-06-06T17:28:13.052813Z",
+          "replacement_ref": "/workplans/{workplan_id}",
+          "owner_component": "state-hub.api",
+          "status": "legacy",
+          "replacement_verified": true,
+          "manual_hold": false,
+          "hold_reason": null,
+          "notes": null,
+          "retired_at": null,
+          "created_at": "2026-06-06T17:28:13.052813Z",
+          "updated_at": "2026-06-06T17:28:13.052813Z"
+        },
+        "all_time": {
+          "calls": 1,
+          "tenant_count": 1,
+          "user_count": 1,
+          "component_count": 1,
+          "tenants": {
+            "unknown": 1
+          },
+          "users": {
+            "unknown": 1
+          },
+          "components": {
+            "unknown": 1
+          }
+        },
+        "window": {
+          "calls": 0,
+          "tenant_count": 0,
+          "user_count": 0,
+          "component_count": 0,
+          "tenants": {},
+          "users": {},
+          "components": {}
+        },
+        "last_seen_at": "2026-06-06T17:28:13.047529Z",
+        "retirement_candidate": true,
+        "retirement_reason": "no measured usage in review window"
+      },
+      {
+        "interface": {
+          "id": "a4e0948c-cd4a-461e-8ae2-7fd7b51d04a7",
+          "interface_key": "rest_api:GET /decisions/?workstream_id",
+          "interface_kind": "rest_api",
+          "legacy_since": "2026-07-09T23:07:53.093223Z",
+          "replacement_ref": "/decisions/?workplan_id=<workplan_id>",
+          "owner_component": "state-hub.api",
+          "status": "legacy",
+          "replacement_verified": true,
+          "manual_hold": false,
+          "hold_reason": null,
+          "notes": null,
+          "retired_at": null,
+          "created_at": "2026-07-09T23:07:53.093223Z",
+          "updated_at": "2026-07-09T23:07:53.093223Z"
+        },
+        "all_time": {
+          "calls": 1,
+          "tenant_count": 1,
+          "user_count": 1,
+          "component_count": 1,
+          "tenants": {
+            "unknown": 1
+          },
+          "users": {
+            "unknown": 1
+          },
+          "components": {
+            "unknown": 1
+          }
+        },
+        "window": {
+          "calls": 0,
+          "tenant_count": 0,
+          "user_count": 0,
+          "component_count": 0,
+          "tenants": {},
+          "users": {},
+          "components": {}
+        },
+        "last_seen_at": "2026-07-09T23:07:53.083299Z",
+        "retirement_candidate": true,
+        "retirement_reason": "no measured usage in review window"
+      },
+      {
+        "interface": {
+          "id": "70a9346e-e0ee-42ac-874f-f160580b54dd",
+          "interface_key": "rest_api:GET /progress/?workstream_id",
+          "interface_kind": "rest_api",
+          "legacy_since": "2026-07-13T22:04:03.911449Z",
+          "replacement_ref": "/progress/?workplan_id=<workplan_id>",
+          "owner_component": "state-hub.api",
+          "status": "legacy",
+          "replacement_verified": true,
+          "manual_hold": false,
+          "hold_reason": null,
+          "notes": null,
+          "retired_at": null,
+          "created_at": "2026-07-13T22:04:03.911449Z",
+          "updated_at": "2026-07-13T22:04:03.911449Z"
+        },
+        "all_time": {
+          "calls": 2,
+          "tenant_count": 1,
+          "user_count": 1,
+          "component_count": 1,
+          "tenants": {
+            "unknown": 2
+          },
+          "users": {
+            "unknown": 2
+          },
+          "components": {
+            "unknown": 2
+          }
+        },
+        "window": {
+          "calls": 0,
+          "tenant_count": 0,
+          "user_count": 0,
+          "component_count": 0,
+          "tenants": {},
+          "users": {},
+          "components": {}
+        },
+        "last_seen_at": "2026-08-12T08:55:33.912995Z",
+        "retirement_candidate": true,
+        "retirement_reason": "no measured usage in review window"
+      },
+      {
+        "interface": {
+          "id": "be3cdcf8-250b-4bf0-801f-02ffd5f57e00",
+          "interface_key": "rest_api:GET /tasks/?workstream_id",
+          "interface_kind": "rest_api",
+          "legacy_since": "2026-07-08T19:32:21.628513Z",
+          "replacement_ref": "/tasks/?workplan_id=<workplan_id>",
+          "owner_component": "state-hub.api",
+          "status": "legacy",
+          "replacement_verified": true,
+          "manual_hold": false,
+          "hold_reason": null,
+          "notes": null,
+          "retired_at": null,
+          "created_at": "2026-07-08T19:32:21.628513Z",
+          "updated_at": "2026-07-08T19:32:21.628513Z"
+        },
+        "all_time": {
+          "calls": 590,
+          "tenant_count": 1,
+          "user_count": 1,
+          "component_count": 1,
+          "tenants": {
+            "unknown": 590
+          },
+          "users": {
+            "unknown": 590
+          },
+          "components": {
+            "unknown": 590
+          }
+        },
+        "window": {
+          "calls": 0,
+          "tenant_count": 0,
+          "user_count": 0,
+          "component_count": 0,
+          "tenants": {},
+          "users": {},
+          "components": {}
+        },
+        "last_seen_at": "2026-08-12T08:55:27.763102Z",
+        "retirement_candidate": true,
+        "retirement_reason": "no measured usage in review window"
+      },
+      {
+        "interface": {
+          "id": "3e4a3d0b-08fa-45c3-91e2-4f514a914b97",
+          "interface_key": "rest_api:GET /workstreams/",
+          "interface_kind": "rest_api",
+          "legacy_since": "2026-06-04T00:26:14.533764Z",
+          "replacement_ref": "/workplans/",
+          "owner_component": "state-hub.api",
+          "status": "legacy",
+          "replacement_verified": true,
+          "manual_hold": false,
+          "hold_reason": null,
+          "notes": null,
+          "retired_at": null,
+          "created_at": "2026-06-04T00:26:14.533764Z",
+          "updated_at": "2026-06-04T00:26:14.533764Z"
+        },
+        "all_time": {
+          "calls": 144086,
+          "tenant_count": 1,
+          "user_count": 1,
+          "component_count": 1,
+          "tenants": {
+            "unknown": 144086
+          },
+          "users": {
+            "unknown": 144086
+          },
+          "components": {
+            "unknown": 144086
+          }
+        },
+        "window": {
+          "calls": 0,
+          "tenant_count": 0,
+          "user_count": 0,
+          "component_count": 0,
+          "tenants": {},
+          "users": {},
+          "components": {}
+        },
+        "last_seen_at": "2026-08-10T18:06:05.032338Z",
+        "retirement_candidate": true,
+        "retirement_reason": "no measured usage in review window"
+      },
+      {
+        "interface": {
+          "id": "e4c140ec-7479-46f9-b185-4b533f19d639",
+          "interface_key": "rest_api:GET /workstreams/workplan-index",
+          "interface_kind": "rest_api",
+          "legacy_since": "2026-06-04T05:20:58.321869Z",
+          "replacement_ref": "/workplans/index",
+          "owner_component": "state-hub.api",
+          "status": "legacy",
+          "replacement_verified": true,
+          "manual_hold": false,
+          "hold_reason": null,
+          "notes": null,
+          "retired_at": null,
+          "created_at": "2026-06-04T05:20:58.321869Z",
+          "updated_at": "2026-06-04T05:20:58.321869Z"
+        },
+        "all_time": {
+          "calls": 30,
+          "tenant_count": 1,
+          "user_count": 1,
+          "component_count": 1,
+          "tenants": {
+            "unknown": 30
+          },
+          "users": {
+            "unknown": 30
+          },
+          "components": {
+            "unknown": 30
+          }
+        },
+        "window": {
+          "calls": 0,
+          "tenant_count": 0,
+          "user_count": 0,
+          "component_count": 0,
+          "tenants": {},
+          "users": {},
+          "components": {}
+        },
+        "last_seen_at": "2026-07-03T05:20:34.534439Z",
+        "retirement_candidate": true,
+        "retirement_reason": "no measured usage in review window"
+      },
+      {
+        "interface": {
+          "id": "3a00b19e-e7db-4403-98aa-a77c9ab61ecc",
+          "interface_key": "rest_api:GET /workstreams/{workstream_id}",
+          "interface_kind": "rest_api",
+          "legacy_since": "2026-06-04T00:25:59.014966Z",
+          "replacement_ref": "/workplans/{workplan_id}",
+          "owner_component": "state-hub.api",
+          "status": "legacy",
+          "replacement_verified": true,
+          "manual_hold": false,
+          "hold_reason": null,
+          "notes": null,
+          "retired_at": null,
+          "created_at": "2026-06-04T00:25:59.014966Z",
+          "updated_at": "2026-06-04T00:25:59.014966Z"
+        },
+        "all_time": {
+          "calls": 511406,
+          "tenant_count": 1,
+          "user_count": 1,
+          "component_count": 1,
+          "tenants": {
+            "unknown": 511406
+          },
+          "users": {
+            "unknown": 511406
+          },
+          "components": {
+            "unknown": 511406
+          }
+        },
+        "window": {
+          "calls": 0,
+          "tenant_count": 0,
+          "user_count": 0,
+          "component_count": 0,
+          "tenants": {},
+          "users": {},
+          "components": {}
+        },
+        "last_seen_at": "2026-07-31T16:25:32.004042Z",
+        "retirement_candidate": true,
+        "retirement_reason": "no measured usage in review window"
+      },
+      {
+        "interface": {
+          "id": "69e1a255-a8b9-4101-8a68-b1bed23abfda",
+          "interface_key": "rest_api:GET /workstreams/{workstream_id}/dependencies/",
+          "interface_kind": "rest_api",
+          "legacy_since": "2026-06-04T00:25:59.291135Z",
+          "replacement_ref": "/workplans/{workplan_id}/dependencies/",
+          "owner_component": "state-hub.api",
+          "status": "legacy",
+          "replacement_verified": true,
+          "manual_hold": false,
+          "hold_reason": null,
+          "notes": null,
+          "retired_at": null,
+          "created_at": "2026-06-04T00:25:59.291135Z",
+          "updated_at": "2026-06-04T00:25:59.291135Z"
+        },
+        "all_time": {
+          "calls": 255865,
+          "tenant_count": 1,
+          "user_count": 1,
+          "component_count": 1,
+          "tenants": {
+            "unknown": 255865
+          },
+          "users": {
+            "unknown": 255865
+          },
+          "components": {
+            "unknown": 255865
+          }
+        },
+        "window": {
+          "calls": 0,
+          "tenant_count": 0,
+          "user_count": 0,
+          "component_count": 0,
+          "tenants": {},
+          "users": {},
+          "components": {}
+        },
+        "last_seen_at": "2026-07-08T21:14:12.747005Z",
+        "retirement_candidate": true,
+        "retirement_reason": "no measured usage in review window"
+      },
+      {
+        "interface": {
+          "id": "b1aae931-b51f-4a85-a723-865dd65f6132",
+          "interface_key": "rest_api:PATCH /workstreams/{workstream_id}",
+          "interface_kind": "rest_api",
+          "legacy_since": "2026-06-04T06:09:41.901035Z",
+          "replacement_ref": "/workplans/{workplan_id}",
+          "owner_component": "state-hub.api",
+          "status": "legacy",
+          "replacement_verified": true,
+          "manual_hold": false,
+          "hold_reason": null,
+          "notes": null,
+          "retired_at": null,
+          "created_at": "2026-06-04T06:09:41.901035Z",
+          "updated_at": "2026-06-04T06:09:41.901035Z"
+        },
+        "all_time": {
+          "calls": 571,
+          "tenant_count": 1,
+          "user_count": 1,
+          "component_count": 1,
+          "tenants": {
+            "unknown": 571
+          },
+          "users": {
+            "unknown": 571
+          },
+          "components": {
+            "unknown": 571
+          }
+        },
+        "window": {
+          "calls": 0,
+          "tenant_count": 0,
+          "user_count": 0,
+          "component_count": 0,
+          "tenants": {},
+          "users": {},
+          "components": {}
+        },
+        "last_seen_at": "2026-07-08T20:49:12.335710Z",
+        "retirement_candidate": true,
+        "retirement_reason": "no measured usage in review window"
+      },
+      {
+        "interface": {
+          "id": "4aea9591-970b-4918-ac4a-4da95a0a1a8c",
+          "interface_key": "rest_api:POST /decisions/ workstream_id",
+          "interface_kind": "rest_api",
+          "legacy_since": "2026-07-09T22:56:35.473130Z",
+          "replacement_ref": "POST /decisions/ with workplan_id",
+          "owner_component": "state-hub.api",
+          "status": "legacy",
+          "replacement_verified": true,
+          "manual_hold": false,
+          "hold_reason": null,
+          "notes": null,
+          "retired_at": null,
+          "created_at": "2026-07-09T22:56:35.473130Z",
+          "updated_at": "2026-07-09T22:56:35.473130Z"
+        },
+        "all_time": {
+          "calls": 3,
+          "tenant_count": 1,
+          "user_count": 1,
+          "component_count": 1,
+          "tenants": {
+            "unknown": 3
+          },
+          "users": {
+            "unknown": 3
+          },
+          "components": {
+            "unknown": 3
+          }
+        },
+        "window": {
+          "calls": 0,
+          "tenant_count": 0,
+          "user_count": 0,
+          "component_count": 0,
+          "tenants": {},
+          "users": {},
+          "components": {}
+        },
+        "last_seen_at": "2026-07-09T22:57:05.912456Z",
+        "retirement_candidate": true,
+        "retirement_reason": "no measured usage in review window"
+      },
+      {
+        "interface": {
+          "id": "4a70583c-1e41-4ec1-99a9-728856a7d79c",
+          "interface_key": "rest_api:POST /progress/ workstream_id",
+          "interface_kind": "rest_api",
+          "legacy_since": "2026-07-08T23:35:09.148333Z",
+          "replacement_ref": "POST /progress/ with workplan_id",
+          "owner_component": "state-hub.api",
+          "status": "legacy",
+          "replacement_verified": true,
+          "manual_hold": false,
+          "hold_reason": null,
+          "notes": null,
+          "retired_at": null,
+          "created_at": "2026-07-08T23:35:09.148333Z",
+          "updated_at": "2026-07-08T23:35:09.148333Z"
+        },
+        "all_time": {
+          "calls": 14,
+          "tenant_count": 1,
+          "user_count": 1,
+          "component_count": 1,
+          "tenants": {
+            "unknown": 14
+          },
+          "users": {
+            "unknown": 14
+          },
+          "components": {
+            "unknown": 14
+          }
+        },
+        "window": {
+          "calls": 0,
+          "tenant_count": 0,
+          "user_count": 0,
+          "component_count": 0,
+          "tenants": {},
+          "users": {},
+          "components": {}
+        },
+        "last_seen_at": "2026-07-10T08:34:42.959724Z",
+        "retirement_candidate": true,
+        "retirement_reason": "no measured usage in review window"
+      },
+      {
+        "interface": {
+          "id": "6df4e443-7bf1-461a-923b-a6eb52fe7b07",
+          "interface_key": "rest_api:POST /tasks/ workstream_id",
+          "interface_kind": "rest_api",
+          "legacy_since": "2026-07-08T22:38:29.405720Z",
+          "replacement_ref": "POST /tasks/ with workplan_id",
+          "owner_component": "state-hub.api",
+          "status": "legacy",
+          "replacement_verified": true,
+          "manual_hold": false,
+          "hold_reason": null,
+          "notes": null,
+          "retired_at": null,
+          "created_at": "2026-07-08T22:38:29.405720Z",
+          "updated_at": "2026-07-08T22:38:29.405720Z"
+        },
+        "all_time": {
+          "calls": 5,
+          "tenant_count": 1,
+          "user_count": 1,
+          "component_count": 1,
+          "tenants": {
+            "unknown": 5
+          },
+          "users": {
+            "unknown": 5
+          },
+          "components": {
+            "state-hub.fix-consistency": 5
+          }
+        },
+        "window": {
+          "calls": 0,
+          "tenant_count": 0,
+          "user_count": 0,
+          "component_count": 0,
+          "tenants": {},
+          "users": {},
+          "components": {}
+        },
+        "last_seen_at": "2026-07-08T22:38:29.976918Z",
+        "retirement_candidate": true,
+        "retirement_reason": "no measured usage in review window"
+      },
+      {
+        "interface": {
+          "id": "ed6451c9-d2cc-4486-9afe-d3852782cabc",
+          "interface_key": "rest_api:POST /workstreams/",
+          "interface_kind": "rest_api",
+          "legacy_since": "2026-06-04T07:40:24.168535Z",
+          "replacement_ref": "/workplans/",
+          "owner_component": "state-hub.api",
+          "status": "legacy",
+          "replacement_verified": true,
+          "manual_hold": false,
+          "hold_reason": null,
+          "notes": null,
+          "retired_at": null,
+          "created_at": "2026-06-04T07:40:24.168535Z",
+          "updated_at": "2026-06-04T07:40:24.168535Z"
+        },
+        "all_time": {
+          "calls": 824,
+          "tenant_count": 1,
+          "user_count": 1,
+          "component_count": 1,
+          "tenants": {
+            "unknown": 824
+          },
+          "users": {
+            "unknown": 824
+          },
+          "components": {
+            "unknown": 824
+          }
+        },
+        "window": {
+          "calls": 0,
+          "tenant_count": 0,
+          "user_count": 0,
+          "component_count": 0,
+          "tenants": {},
+          "users": {},
+          "components": {}
+        },
+        "last_seen_at": "2026-07-08T20:38:05.903144Z",
+        "retirement_candidate": true,
+        "retirement_reason": "no measured usage in review window"
+      },
+      {
+        "interface": {
+          "id": "281fd706-b192-4194-8055-2d8733c115f9",
+          "interface_key": "rest_api:POST /workstreams/{workstream_id}/dependencies/",
+          "interface_kind": "rest_api",
+          "legacy_since": "2026-06-04T22:57:37.149207Z",
+          "replacement_ref": "/workplans/{workplan_id}/dependencies/",
+          "owner_component": "state-hub.api",
+          "status": "legacy",
+          "replacement_verified": true,
+          "manual_hold": false,
+          "hold_reason": null,
+          "notes": null,
+          "retired_at": null,
+          "created_at": "2026-06-04T22:57:37.149207Z",
+          "updated_at": "2026-06-04T22:57:37.149207Z"
+        },
+        "all_time": {
+          "calls": 4971,
+          "tenant_count": 1,
+          "user_count": 1,
+          "component_count": 1,
+          "tenants": {
+            "unknown": 4971
+          },
+          "users": {
+            "unknown": 4971
+          },
+          "components": {
+            "unknown": 4971
+          }
+        },
+        "window": {
+          "calls": 0,
+          "tenant_count": 0,
+          "user_count": 0,
+          "component_count": 0,
+          "tenants": {},
+          "users": {},
+          "components": {}
+        },
+        "last_seen_at": "2026-07-01T22:09:24.229011Z",
+        "retirement_candidate": true,
+        "retirement_reason": "no measured usage in review window"
+      }
+    ],
+    "retirement_candidates": [
+      {
+        "interface": {
+          "id": "63ed90e3-42b4-431a-94db-e1254a52f9e2",
+          "interface_key": "mcp:create_workstream",
+          "interface_kind": "mcp_tool",
+          "legacy_since": "2026-07-10T13:19:44.205900Z",
+          "replacement_ref": "create_workplan",
+          "owner_component": "state-hub.mcp",
+          "status": "legacy",
+          "replacement_verified": true,
+          "manual_hold": false,
+          "hold_reason": null,
+          "notes": "Registered by STATE-WP-0070 T03 \u2014 zero-window streak starts at registration",
+          "retired_at": null,
+          "created_at": "2026-07-10T13:19:44.205900Z",
+          "updated_at": "2026-07-10T13:19:44.205900Z"
+        },
+        "all_time": {
+          "calls": 2,
+          "tenant_count": 1,
+          "user_count": 1,
+          "component_count": 1,
+          "tenants": {
+            "unknown": 2
+          },
+          "users": {
+            "unknown": 2
+          },
+          "components": {
+            "state-hub.mcp": 2
+          }
+        },
+        "window": {
+          "calls": 0,
+          "tenant_count": 0,
+          "user_count": 0,
+          "component_count": 0,
+          "tenants": {},
+          "users": {},
+          "components": {}
+        },
+        "last_seen_at": "2026-07-10T13:20:43.378546Z",
+        "retirement_candidate": true,
+        "retirement_reason": "no measured usage in review window"
+      },
+      {
+        "interface": {
+          "id": "b6a5fe44-fb85-4ef7-a273-78d09da777af",
+          "interface_key": "mcp:list_workstreams",
+          "interface_kind": "mcp_tool",
+          "legacy_since": "2026-07-10T13:19:26.075491Z",
+          "replacement_ref": "list_workplans",
+          "owner_component": "state-hub.mcp",
+          "status": "legacy",
+          "replacement_verified": true,
+          "manual_hold": false,
+          "hold_reason": null,
+          "notes": null,
+          "retired_at": null,
+          "created_at": "2026-07-10T13:19:26.075491Z",
+          "updated_at": "2026-07-10T13:19:26.075491Z"
+        },
+        "all_time": {
+          "calls": 2,
+          "tenant_count": 1,
+          "user_count": 1,
+          "component_count": 1,
+          "tenants": {
+            "unknown": 2
+          },
+          "users": {
+            "unknown": 2
+          },
+          "components": {
+            "state-hub.mcp": 2
+          }
+        },
+        "window": {
+          "calls": 0,
+          "tenant_count": 0,
+          "user_count": 0,
+          "component_count": 0,
+          "tenants": {},
+          "users": {},
+          "components": {}
+        },
+        "last_seen_at": "2026-07-10T13:20:42.374940Z",
+        "retirement_candidate": true,
+        "retirement_reason": "no measured usage in review window"
+      },
+      {
+        "interface": {
+          "id": "53c3372b-307d-4d6a-8ea4-bc36cacdcaf2",
+          "interface_key": "mcp:update_workstream",
+          "interface_kind": "mcp_tool",
+          "legacy_since": "2026-07-10T13:19:44.255216Z",
+          "replacement_ref": "update_workplan",
+          "owner_component": "state-hub.mcp",
+          "status": "legacy",
+          "replacement_verified": true,
+          "manual_hold": false,
+          "hold_reason": null,
+          "notes": "Registered by STATE-WP-0070 T03 \u2014 zero-window streak starts at registration",
+          "retired_at": null,
+          "created_at": "2026-07-10T13:19:44.255216Z",
+          "updated_at": "2026-07-10T13:19:44.255216Z"
+        },
+        "all_time": {
+          "calls": 0,
+          "tenant_count": 0,
+          "user_count": 0,
+          "component_count": 0,
+          "tenants": {},
+          "users": {},
+          "components": {}
+        },
+        "window": {
+          "calls": 0,
+          "tenant_count": 0,
+          "user_count": 0,
+          "component_count": 0,
+          "tenants": {},
+          "users": {},
+          "components": {}
+        },
+        "last_seen_at": null,
+        "retirement_candidate": true,
+        "retirement_reason": "no measured usage in review window"
+      },
+      {
+        "interface": {
+          "id": "bed4d08a-3471-48f5-9f0e-f9d550383a26",
+          "interface_key": "mcp:update_workstream_status",
+          "interface_kind": "mcp_tool",
+          "legacy_since": "2026-07-10T13:19:44.303612Z",
+          "replacement_ref": "update_workplan_status",
+          "owner_component": "state-hub.mcp",
+          "status": "legacy",
+          "replacement_verified": true,
+          "manual_hold": false,
+          "hold_reason": null,
+          "notes": "Registered by STATE-WP-0070 T03 \u2014 zero-window streak starts at registration",
+          "retired_at": null,
+          "created_at": "2026-07-10T13:19:44.303612Z",
+          "updated_at": "2026-07-10T13:19:44.303612Z"
+        },
+        "all_time": {
+          "calls": 0,
+          "tenant_count": 0,
+          "user_count": 0,
+          "component_count": 0,
+          "tenants": {},
+          "users": {},
+          "components": {}
+        },
+        "window": {
+          "calls": 0,
+          "tenant_count": 0,
+          "user_count": 0,
+          "component_count": 0,
+          "tenants": {},
+          "users": {},
+          "components": {}
+        },
+        "last_seen_at": null,
+        "retirement_candidate": true,
+        "retirement_reason": "no measured usage in review window"
+      },
+      {
+        "interface": {
+          "id": "46900dc2-0893-405b-ba59-80f31fb6ebb1",
+          "interface_key": "state://workstreams/{topic_slug}",
+          "interface_kind": "mcp_tool",
+          "legacy_since": "2026-07-10T13:19:44.344493Z",
+          "replacement_ref": "state://workplans/{topic_slug}",
+          "owner_component": "state-hub.mcp",
+          "status": "legacy",
+          "replacement_verified": true,
+          "manual_hold": false,
+          "hold_reason": null,
+          "notes": "Registered by STATE-WP-0070 T03 \u2014 zero-window streak starts at registration",
+          "retired_at": null,
+          "created_at": "2026-07-10T13:19:44.344493Z",
+          "updated_at": "2026-07-10T13:19:44.344493Z"
+        },
+        "all_time": {
+          "calls": 1,
+          "tenant_count": 1,
+          "user_count": 1,
+          "component_count": 1,
+          "tenants": {
+            "unknown": 1
+          },
+          "users": {
+            "unknown": 1
+          },
+          "components": {
+            "state-hub.mcp": 1
+          }
+        },
+        "window": {
+          "calls": 0,
+          "tenant_count": 0,
+          "user_count": 0,
+          "component_count": 0,
+          "tenants": {},
+          "users": {},
+          "components": {}
+        },
+        "last_seen_at": "2026-07-10T13:20:34.491811Z",
+        "retirement_candidate": true,
+        "retirement_reason": "no measured usage in review window"
+      },
+      {
+        "interface": {
+          "id": "cd9342fd-27e7-4a46-a1be-d41499e106a3",
+          "interface_key": "rest_api:DELETE /workstreams/{workstream_id}",
+          "interface_kind": "rest_api",
+          "legacy_since": "2026-06-06T17:28:13.052813Z",
+          "replacement_ref": "/workplans/{workplan_id}",
+          "owner_component": "state-hub.api",
+          "status": "legacy",
+          "replacement_verified": true,
+          "manual_hold": false,
+          "hold_reason": null,
+          "notes": null,
+          "retired_at": null,
+          "created_at": "2026-06-06T17:28:13.052813Z",
+          "updated_at": "2026-06-06T17:28:13.052813Z"
+        },
+        "all_time": {
+          "calls": 1,
+          "tenant_count": 1,
+          "user_count": 1,
+          "component_count": 1,
+          "tenants": {
+            "unknown": 1
+          },
+          "users": {
+            "unknown": 1
+          },
+          "components": {
+            "unknown": 1
+          }
+        },
+        "window": {
+          "calls": 0,
+          "tenant_count": 0,
+          "user_count": 0,
+          "component_count": 0,
+          "tenants": {},
+          "users": {},
+          "components": {}
+        },
+        "last_seen_at": "2026-06-06T17:28:13.047529Z",
+        "retirement_candidate": true,
+        "retirement_reason": "no measured usage in review window"
+      },
+      {
+        "interface": {
+          "id": "a4e0948c-cd4a-461e-8ae2-7fd7b51d04a7",
+          "interface_key": "rest_api:GET /decisions/?workstream_id",
+          "interface_kind": "rest_api",
+          "legacy_since": "2026-07-09T23:07:53.093223Z",
+          "replacement_ref": "/decisions/?workplan_id=<workplan_id>",
+          "owner_component": "state-hub.api",
+          "status": "legacy",
+          "replacement_verified": true,
+          "manual_hold": false,
+          "hold_reason": null,
+          "notes": null,
+          "retired_at": null,
+          "created_at": "2026-07-09T23:07:53.093223Z",
+          "updated_at": "2026-07-09T23:07:53.093223Z"
+        },
+        "all_time": {
+          "calls": 1,
+          "tenant_count": 1,
+          "user_count": 1,
+          "component_count": 1,
+          "tenants": {
+            "unknown": 1
+          },
+          "users": {
+            "unknown": 1
+          },
+          "components": {
+            "unknown": 1
+          }
+        },
+        "window": {
+          "calls": 0,
+          "tenant_count": 0,
+          "user_count": 0,
+          "component_count": 0,
+          "tenants": {},
+          "users": {},
+          "components": {}
+        },
+        "last_seen_at": "2026-07-09T23:07:53.083299Z",
+        "retirement_candidate": true,
+        "retirement_reason": "no measured usage in review window"
+      },
+      {
+        "interface": {
+          "id": "70a9346e-e0ee-42ac-874f-f160580b54dd",
+          "interface_key": "rest_api:GET /progress/?workstream_id",
+          "interface_kind": "rest_api",
+          "legacy_since": "2026-07-13T22:04:03.911449Z",
+          "replacement_ref": "/progress/?workplan_id=<workplan_id>",
+          "owner_component": "state-hub.api",
+          "status": "legacy",
+          "replacement_verified": true,
+          "manual_hold": false,
+          "hold_reason": null,
+          "notes": null,
+          "retired_at": null,
+          "created_at": "2026-07-13T22:04:03.911449Z",
+          "updated_at": "2026-07-13T22:04:03.911449Z"
+        },
+        "all_time": {
+          "calls": 2,
+          "tenant_count": 1,
+          "user_count": 1,
+          "component_count": 1,
+          "tenants": {
+            "unknown": 2
+          },
+          "users": {
+            "unknown": 2
+          },
+          "components": {
+            "unknown": 2
+          }
+        },
+        "window": {
+          "calls": 0,
+          "tenant_count": 0,
+          "user_count": 0,
+          "component_count": 0,
+          "tenants": {},
+          "users": {},
+          "components": {}
+        },
+        "last_seen_at": "2026-08-12T08:55:33.912995Z",
+        "retirement_candidate": true,
+        "retirement_reason": "no measured usage in review window"
+      },
+      {
+        "interface": {
+          "id": "be3cdcf8-250b-4bf0-801f-02ffd5f57e00",
+          "interface_key": "rest_api:GET /tasks/?workstream_id",
+          "interface_kind": "rest_api",
+          "legacy_since": "2026-07-08T19:32:21.628513Z",
+          "replacement_ref": "/tasks/?workplan_id=<workplan_id>",
+          "owner_component": "state-hub.api",
+          "status": "legacy",
+          "replacement_verified": true,
+          "manual_hold": false,
+          "hold_reason": null,
+          "notes": null,
+          "retired_at": null,
+          "created_at": "2026-07-08T19:32:21.628513Z",
+          "updated_at": "2026-07-08T19:32:21.628513Z"
+        },
+        "all_time": {
+          "calls": 590,
+          "tenant_count": 1,
+          "user_count": 1,
+          "component_count": 1,
+          "tenants": {
+            "unknown": 590
+          },
+          "users": {
+            "unknown": 590
+          },
+          "components": {
+            "unknown": 590
+          }
+        },
+        "window": {
+          "calls": 0,
+          "tenant_count": 0,
+          "user_count": 0,
+          "component_count": 0,
+          "tenants": {},
+          "users": {},
+          "components": {}
+        },
+        "last_seen_at": "2026-08-12T08:55:27.763102Z",
+        "retirement_candidate": true,
+        "retirement_reason": "no measured usage in review window"
+      },
+      {
+        "interface": {
+          "id": "3e4a3d0b-08fa-45c3-91e2-4f514a914b97",
+          "interface_key": "rest_api:GET /workstreams/",
+          "interface_kind": "rest_api",
+          "legacy_since": "2026-06-04T00:26:14.533764Z",
+          "replacement_ref": "/workplans/",
+          "owner_component": "state-hub.api",
+          "status": "legacy",
+          "replacement_verified": true,
+          "manual_hold": false,
+          "hold_reason": null,
+          "notes": null,
+          "retired_at": null,
+          "created_at": "2026-06-04T00:26:14.533764Z",
+          "updated_at": "2026-06-04T00:26:14.533764Z"
+        },
+        "all_time": {
+          "calls": 144086,
+          "tenant_count": 1,
+          "user_count": 1,
+          "component_count": 1,
+          "tenants": {
+            "unknown": 144086
+          },
+          "users": {
+            "unknown": 144086
+          },
+          "components": {
+            "unknown": 144086
+          }
+        },
+        "window": {
+          "calls": 0,
+          "tenant_count": 0,
+          "user_count": 0,
+          "component_count": 0,
+          "tenants": {},
+          "users": {},
+          "components": {}
+        },
+        "last_seen_at": "2026-08-10T18:06:05.032338Z",
+        "retirement_candidate": true,
+        "retirement_reason": "no measured usage in review window"
+      },
+      {
+        "interface": {
+          "id": "e4c140ec-7479-46f9-b185-4b533f19d639",
+          "interface_key": "rest_api:GET /workstreams/workplan-index",
+          "interface_kind": "rest_api",
+          "legacy_since": "2026-06-04T05:20:58.321869Z",
+          "replacement_ref": "/workplans/index",
+          "owner_component": "state-hub.api",
+          "status": "legacy",
+          "replacement_verified": true,
+          "manual_hold": false,
+          "hold_reason": null,
+          "notes": null,
+          "retired_at": null,
+          "created_at": "2026-06-04T05:20:58.321869Z",
+          "updated_at": "2026-06-04T05:20:58.321869Z"
+        },
+        "all_time": {
+          "calls": 30,
+          "tenant_count": 1,
+          "user_count": 1,
+          "component_count": 1,
+          "tenants": {
+            "unknown": 30
+          },
+          "users": {
+            "unknown": 30
+          },
+          "components": {
+            "unknown": 30
+          }
+        },
+        "window": {
+          "calls": 0,
+          "tenant_count": 0,
+          "user_count": 0,
+          "component_count": 0,
+          "tenants": {},
+          "users": {},
+          "components": {}
+        },
+        "last_seen_at": "2026-07-03T05:20:34.534439Z",
+        "retirement_candidate": true,
+        "retirement_reason": "no measured usage in review window"
+      },
+      {
+        "interface": {
+          "id": "3a00b19e-e7db-4403-98aa-a77c9ab61ecc",
+          "interface_key": "rest_api:GET /workstreams/{workstream_id}",
+          "interface_kind": "rest_api",
+          "legacy_since": "2026-06-04T00:25:59.014966Z",
+          "replacement_ref": "/workplans/{workplan_id}",
+          "owner_component": "state-hub.api",
+          "status": "legacy",
+          "replacement_verified": true,
+          "manual_hold": false,
+          "hold_reason": null,
+          "notes": null,
+          "retired_at": null,
+          "created_at": "2026-06-04T00:25:59.014966Z",
+          "updated_at": "2026-06-04T00:25:59.014966Z"
+        },
+        "all_time": {
+          "calls": 511406,
+          "tenant_count": 1,
+          "user_count": 1,
+          "component_count": 1,
+          "tenants": {
+            "unknown": 511406
+          },
+          "users": {
+            "unknown": 511406
+          },
+          "components": {
+            "unknown": 511406
+          }
+        },
+        "window": {
+          "calls": 0,
+          "tenant_count": 0,
+          "user_count": 0,
+          "component_count": 0,
+          "tenants": {},
+          "users": {},
+          "components": {}
+        },
+        "last_seen_at": "2026-07-31T16:25:32.004042Z",
+        "retirement_candidate": true,
+        "retirement_reason": "no measured usage in review window"
+      },
+      {
+        "interface": {
+          "id": "69e1a255-a8b9-4101-8a68-b1bed23abfda",
+          "interface_key": "rest_api:GET /workstreams/{workstream_id}/dependencies/",
+          "interface_kind": "rest_api",
+          "legacy_since": "2026-06-04T00:25:59.291135Z",
+          "replacement_ref": "/workplans/{workplan_id}/dependencies/",
+          "owner_component": "state-hub.api",
+          "status": "legacy",
+          "replacement_verified": true,
+          "manual_hold": false,
+          "hold_reason": null,
+          "notes": null,
+          "retired_at": null,
+          "created_at": "2026-06-04T00:25:59.291135Z",
+          "updated_at": "2026-06-04T00:25:59.291135Z"
+        },
+        "all_time": {
+          "calls": 255865,
+          "tenant_count": 1,
+          "user_count": 1,
+          "component_count": 1,
+          "tenants": {
+            "unknown": 255865
+          },
+          "users": {
+            "unknown": 255865
+          },
+          "components": {
+            "unknown": 255865
+          }
+        },
+        "window": {
+          "calls": 0,
+          "tenant_count": 0,
+          "user_count": 0,
+          "component_count": 0,
+          "tenants": {},
+          "users": {},
+          "components": {}
+        },
+        "last_seen_at": "2026-07-08T21:14:12.747005Z",
+        "retirement_candidate": true,
+        "retirement_reason": "no measured usage in review window"
+      },
+      {
+        "interface": {
+          "id": "b1aae931-b51f-4a85-a723-865dd65f6132",
+          "interface_key": "rest_api:PATCH /workstreams/{workstream_id}",
+          "interface_kind": "rest_api",
+          "legacy_since": "2026-06-04T06:09:41.901035Z",
+          "replacement_ref": "/workplans/{workplan_id}",
+          "owner_component": "state-hub.api",
+          "status": "legacy",
+          "replacement_verified": true,
+          "manual_hold": false,
+          "hold_reason": null,
+          "notes": null,
+          "retired_at": null,
+          "created_at": "2026-06-04T06:09:41.901035Z",
+          "updated_at": "2026-06-04T06:09:41.901035Z"
+        },
+        "all_time": {
+          "calls": 571,
+          "tenant_count": 1,
+          "user_count": 1,
+          "component_count": 1,
+          "tenants": {
+            "unknown": 571
+          },
+          "users": {
+            "unknown": 571
+          },
+          "components": {
+            "unknown": 571
+          }
+        },
+        "window": {
+          "calls": 0,
+          "tenant_count": 0,
+          "user_count": 0,
+          "component_count": 0,
+          "tenants": {},
+          "users": {},
+          "components": {}
+        },
+        "last_seen_at": "2026-07-08T20:49:12.335710Z",
+        "retirement_candidate": true,
+        "retirement_reason": "no measured usage in review window"
+      },
+      {
+        "interface": {
+          "id": "4aea9591-970b-4918-ac4a-4da95a0a1a8c",
+          "interface_key": "rest_api:POST /decisions/ workstream_id",
+          "interface_kind": "rest_api",
+          "legacy_since": "2026-07-09T22:56:35.473130Z",
+          "replacement_ref": "POST /decisions/ with workplan_id",
+          "owner_component": "state-hub.api",
+          "status": "legacy",
+          "replacement_verified": true,
+          "manual_hold": false,
+          "hold_reason": null,
+          "notes": null,
+          "retired_at": null,
+          "created_at": "2026-07-09T22:56:35.473130Z",
+          "updated_at": "2026-07-09T22:56:35.473130Z"
+        },
+        "all_time": {
+          "calls": 3,
+          "tenant_count": 1,
+          "user_count": 1,
+          "component_count": 1,
+          "tenants": {
+            "unknown": 3
+          },
+          "users": {
+            "unknown": 3
+          },
+          "components": {
+            "unknown": 3
+          }
+        },
+        "window": {
+          "calls": 0,
+          "tenant_count": 0,
+          "user_count": 0,
+          "component_count": 0,
+          "tenants": {},
+          "users": {},
+          "components": {}
+        },
+        "last_seen_at": "2026-07-09T22:57:05.912456Z",
+        "retirement_candidate": true,
+        "retirement_reason": "no measured usage in review window"
+      },
+      {
+        "interface": {
+          "id": "4a70583c-1e41-4ec1-99a9-728856a7d79c",
+          "interface_key": "rest_api:POST /progress/ workstream_id",
+          "interface_kind": "rest_api",
+          "legacy_since": "2026-07-08T23:35:09.148333Z",
+          "replacement_ref": "POST /progress/ with workplan_id",
+          "owner_component": "state-hub.api",
+          "status": "legacy",
+          "replacement_verified": true,
+          "manual_hold": false,
+          "hold_reason": null,
+          "notes": null,
+          "retired_at": null,
+          "created_at": "2026-07-08T23:35:09.148333Z",
+          "updated_at": "2026-07-08T23:35:09.148333Z"
+        },
+        "all_time": {
+          "calls": 14,
+          "tenant_count": 1,
+          "user_count": 1,
+          "component_count": 1,
+          "tenants": {
+            "unknown": 14
+          },
+          "users": {
+            "unknown": 14
+          },
+          "components": {
+            "unknown": 14
+          }
+        },
+        "window": {
+          "calls": 0,
+          "tenant_count": 0,
+          "user_count": 0,
+          "component_count": 0,
+          "tenants": {},
+          "users": {},
+          "components": {}
+        },
+        "last_seen_at": "2026-07-10T08:34:42.959724Z",
+        "retirement_candidate": true,
+        "retirement_reason": "no measured usage in review window"
+      },
+      {
+        "interface": {
+          "id": "6df4e443-7bf1-461a-923b-a6eb52fe7b07",
+          "interface_key": "rest_api:POST /tasks/ workstream_id",
+          "interface_kind": "rest_api",
+          "legacy_since": "2026-07-08T22:38:29.405720Z",
+          "replacement_ref": "POST /tasks/ with workplan_id",
+          "owner_component": "state-hub.api",
+          "status": "legacy",
+          "replacement_verified": true,
+          "manual_hold": false,
+          "hold_reason": null,
+          "notes": null,
+          "retired_at": null,
+          "created_at": "2026-07-08T22:38:29.405720Z",
+          "updated_at": "2026-07-08T22:38:29.405720Z"
+        },
+        "all_time": {
+          "calls": 5,
+          "tenant_count": 1,
+          "user_count": 1,
+          "component_count": 1,
+          "tenants": {
+            "unknown": 5
+          },
+          "users": {
+            "unknown": 5
+          },
+          "components": {
+            "state-hub.fix-consistency": 5
+          }
+        },
+        "window": {
+          "calls": 0,
+          "tenant_count": 0,
+          "user_count": 0,
+          "component_count": 0,
+          "tenants": {},
+          "users": {},
+          "components": {}
+        },
+        "last_seen_at": "2026-07-08T22:38:29.976918Z",
+        "retirement_candidate": true,
+        "retirement_reason": "no measured usage in review window"
+      },
+      {
+        "interface": {
+          "id": "ed6451c9-d2cc-4486-9afe-d3852782cabc",
+          "interface_key": "rest_api:POST /workstreams/",
+          "interface_kind": "rest_api",
+          "legacy_since": "2026-06-04T07:40:24.168535Z",
+          "replacement_ref": "/workplans/",
+          "owner_component": "state-hub.api",
+          "status": "legacy",
+          "replacement_verified": true,
+          "manual_hold": false,
+          "hold_reason": null,
+          "notes": null,
+          "retired_at": null,
+          "created_at": "2026-06-04T07:40:24.168535Z",
+          "updated_at": "2026-06-04T07:40:24.168535Z"
+        },
+        "all_time": {
+          "calls": 824,
+          "tenant_count": 1,
+          "user_count": 1,
+          "component_count": 1,
+          "tenants": {
+            "unknown": 824
+          },
+          "users": {
+            "unknown": 824
+          },
+          "components": {
+            "unknown": 824
+          }
+        },
+        "window": {
+          "calls": 0,
+          "tenant_count": 0,
+          "user_count": 0,
+          "component_count": 0,
+          "tenants": {},
+          "users": {},
+          "components": {}
+        },
+        "last_seen_at": "2026-07-08T20:38:05.903144Z",
+        "retirement_candidate": true,
+        "retirement_reason": "no measured usage in review window"
+      },
+      {
+        "interface": {
+          "id": "281fd706-b192-4194-8055-2d8733c115f9",
+          "interface_key": "rest_api:POST /workstreams/{workstream_id}/dependencies/",
+          "interface_kind": "rest_api",
+          "legacy_since": "2026-06-04T22:57:37.149207Z",
+          "replacement_ref": "/workplans/{workplan_id}/dependencies/",
+          "owner_component": "state-hub.api",
+          "status": "legacy",
+          "replacement_verified": true,
+          "manual_hold": false,
+          "hold_reason": null,
+          "notes": null,
+          "retired_at": null,
+          "created_at": "2026-06-04T22:57:37.149207Z",
+          "updated_at": "2026-06-04T22:57:37.149207Z"
+        },
+        "all_time": {
+          "calls": 4971,
+          "tenant_count": 1,
+          "user_count": 1,
+          "component_count": 1,
+          "tenants": {
+            "unknown": 4971
+          },
+          "users": {
+            "unknown": 4971
+          },
+          "components": {
+            "unknown": 4971
+          }
+        },
+        "window": {
+          "calls": 0,
+          "tenant_count": 0,
+          "user_count": 0,
+          "component_count": 0,
+          "tenants": {},
+          "users": {},
+          "components": {}
+        },
+        "last_seen_at": "2026-07-01T22:09:24.229011Z",
+        "retirement_candidate": true,
+        "retirement_reason": "no measured usage in review window"
+      }
+    ]
+  },
+  "hours": 8
+}
diff --git a/docs/evidence/legacy-meter-weekly-review-20260818.json b/docs/evidence/legacy-meter-weekly-review-20260818.json
new file mode 100644
index 0000000..d44ce93
--- /dev/null
+++ b/docs/evidence/legacy-meter-weekly-review-20260818.json
@@ -0,0 +1,1755 @@
+{
+  "captured_at": "2026-08-18T14:00:07.142302+00:00",
+  "api_base": "http://127.0.0.1:8000",
+  "workplan": "STATE-WP-0070",
+  "retired_interfaces": [],
+  "weekly_review": {
+    "generated_at": "2026-08-18T14:00:07.136114Z",
+    "window_start": "2026-08-18T06:00:07.064020Z",
+    "window_end": "2026-08-18T14:00:07.064020Z",
+    "cadence": "weekly",
+    "activity_core_handoff": {
+      "activity_id": "statehub-legacy-interface-review",
+      "cadence": "weekly",
+      "source_endpoint": "/legacy-meter/weekly-review",
+      "state_owner": "state-hub",
+      "scheduler_owner": "activity-core"
+    },
+    "interfaces": [
+      {
+        "interface": {
+          "id": "8051fb40-66c9-4dc4-a413-13e8573e04a3",
+          "interface_key": "event_subject:org.statehub.workstream.completed",
+          "interface_kind": "event_subject",
+          "legacy_since": "2026-06-04T06:09:42.198193Z",
+          "replacement_ref": "org.statehub.workplan.completed",
+          "owner_component": "state-hub.events",
+          "status": "retired",
+          "replacement_verified": true,
+          "manual_hold": false,
+          "hold_reason": null,
+          "notes": "Retired by STATE-WP-0069 closeout",
+          "retired_at": "2026-07-08T21:38:52.773601Z",
+          "created_at": "2026-06-04T06:09:42.198193Z",
+          "updated_at": "2026-07-08T21:38:52.761243Z"
+        },
+        "all_time": {
+          "calls": 255,
+          "tenant_count": 1,
+          "user_count": 1,
+          "component_count": 1,
+          "tenants": {
+            "unknown": 255
+          },
+          "users": {
+            "unknown": 255
+          },
+          "components": {
+            "state-hub.events": 255
+          }
+        },
+        "window": {
+          "calls": 0,
+          "tenant_count": 0,
+          "user_count": 0,
+          "component_count": 0,
+          "tenants": {},
+          "users": {},
+          "components": {}
+        },
+        "last_seen_at": "2026-07-08T20:49:12.839383Z",
+        "retirement_candidate": false,
+        "retirement_reason": "already retired"
+      },
+      {
+        "interface": {
+          "id": "63ed90e3-42b4-431a-94db-e1254a52f9e2",
+          "interface_key": "mcp:create_workstream",
+          "interface_kind": "mcp_tool",
+          "legacy_since": "2026-07-10T13:19:44.205900Z",
+          "replacement_ref": "create_workplan",
+          "owner_component": "state-hub.mcp",
+          "status": "legacy",
+          "replacement_verified": true,
+          "manual_hold": false,
+          "hold_reason": null,
+          "notes": "Registered by STATE-WP-0070 T03 \u2014 zero-window streak starts at registration",
+          "retired_at": null,
+          "created_at": "2026-07-10T13:19:44.205900Z",
+          "updated_at": "2026-07-10T13:19:44.205900Z"
+        },
+        "all_time": {
+          "calls": 2,
+          "tenant_count": 1,
+          "user_count": 1,
+          "component_count": 1,
+          "tenants": {
+            "unknown": 2
+          },
+          "users": {
+            "unknown": 2
+          },
+          "components": {
+            "state-hub.mcp": 2
+          }
+        },
+        "window": {
+          "calls": 0,
+          "tenant_count": 0,
+          "user_count": 0,
+          "component_count": 0,
+          "tenants": {},
+          "users": {},
+          "components": {}
+        },
+        "last_seen_at": "2026-07-10T13:20:43.378546Z",
+        "retirement_candidate": true,
+        "retirement_reason": "no measured usage in review window"
+      },
+      {
+        "interface": {
+          "id": "b6a5fe44-fb85-4ef7-a273-78d09da777af",
+          "interface_key": "mcp:list_workstreams",
+          "interface_kind": "mcp_tool",
+          "legacy_since": "2026-07-10T13:19:26.075491Z",
+          "replacement_ref": "list_workplans",
+          "owner_component": "state-hub.mcp",
+          "status": "legacy",
+          "replacement_verified": true,
+          "manual_hold": false,
+          "hold_reason": null,
+          "notes": null,
+          "retired_at": null,
+          "created_at": "2026-07-10T13:19:26.075491Z",
+          "updated_at": "2026-07-10T13:19:26.075491Z"
+        },
+        "all_time": {
+          "calls": 2,
+          "tenant_count": 1,
+          "user_count": 1,
+          "component_count": 1,
+          "tenants": {
+            "unknown": 2
+          },
+          "users": {
+            "unknown": 2
+          },
+          "components": {
+            "state-hub.mcp": 2
+          }
+        },
+        "window": {
+          "calls": 0,
+          "tenant_count": 0,
+          "user_count": 0,
+          "component_count": 0,
+          "tenants": {},
+          "users": {},
+          "components": {}
+        },
+        "last_seen_at": "2026-07-10T13:20:42.374940Z",
+        "retirement_candidate": true,
+        "retirement_reason": "no measured usage in review window"
+      },
+      {
+        "interface": {
+          "id": "53c3372b-307d-4d6a-8ea4-bc36cacdcaf2",
+          "interface_key": "mcp:update_workstream",
+          "interface_kind": "mcp_tool",
+          "legacy_since": "2026-07-10T13:19:44.255216Z",
+          "replacement_ref": "update_workplan",
+          "owner_component": "state-hub.mcp",
+          "status": "legacy",
+          "replacement_verified": true,
+          "manual_hold": false,
+          "hold_reason": null,
+          "notes": "Registered by STATE-WP-0070 T03 \u2014 zero-window streak starts at registration",
+          "retired_at": null,
+          "created_at": "2026-07-10T13:19:44.255216Z",
+          "updated_at": "2026-07-10T13:19:44.255216Z"
+        },
+        "all_time": {
+          "calls": 0,
+          "tenant_count": 0,
+          "user_count": 0,
+          "component_count": 0,
+          "tenants": {},
+          "users": {},
+          "components": {}
+        },
+        "window": {
+          "calls": 0,
+          "tenant_count": 0,
+          "user_count": 0,
+          "component_count": 0,
+          "tenants": {},
+          "users": {},
+          "components": {}
+        },
+        "last_seen_at": null,
+        "retirement_candidate": true,
+        "retirement_reason": "no measured usage in review window"
+      },
+      {
+        "interface": {
+          "id": "bed4d08a-3471-48f5-9f0e-f9d550383a26",
+          "interface_key": "mcp:update_workstream_status",
+          "interface_kind": "mcp_tool",
+          "legacy_since": "2026-07-10T13:19:44.303612Z",
+          "replacement_ref": "update_workplan_status",
+          "owner_component": "state-hub.mcp",
+          "status": "legacy",
+          "replacement_verified": true,
+          "manual_hold": false,
+          "hold_reason": null,
+          "notes": "Registered by STATE-WP-0070 T03 \u2014 zero-window streak starts at registration",
+          "retired_at": null,
+          "created_at": "2026-07-10T13:19:44.303612Z",
+          "updated_at": "2026-07-10T13:19:44.303612Z"
+        },
+        "all_time": {
+          "calls": 0,
+          "tenant_count": 0,
+          "user_count": 0,
+          "component_count": 0,
+          "tenants": {},
+          "users": {},
+          "components": {}
+        },
+        "window": {
+          "calls": 0,
+          "tenant_count": 0,
+          "user_count": 0,
+          "component_count": 0,
+          "tenants": {},
+          "users": {},
+          "components": {}
+        },
+        "last_seen_at": null,
+        "retirement_candidate": true,
+        "retirement_reason": "no measured usage in review window"
+      },
+      {
+        "interface": {
+          "id": "46900dc2-0893-405b-ba59-80f31fb6ebb1",
+          "interface_key": "state://workstreams/{topic_slug}",
+          "interface_kind": "mcp_tool",
+          "legacy_since": "2026-07-10T13:19:44.344493Z",
+          "replacement_ref": "state://workplans/{topic_slug}",
+          "owner_component": "state-hub.mcp",
+          "status": "legacy",
+          "replacement_verified": true,
+          "manual_hold": false,
+          "hold_reason": null,
+          "notes": "Registered by STATE-WP-0070 T03 \u2014 zero-window streak starts at registration",
+          "retired_at": null,
+          "created_at": "2026-07-10T13:19:44.344493Z",
+          "updated_at": "2026-07-10T13:19:44.344493Z"
+        },
+        "all_time": {
+          "calls": 1,
+          "tenant_count": 1,
+          "user_count": 1,
+          "component_count": 1,
+          "tenants": {
+            "unknown": 1
+          },
+          "users": {
+            "unknown": 1
+          },
+          "components": {
+            "state-hub.mcp": 1
+          }
+        },
+        "window": {
+          "calls": 0,
+          "tenant_count": 0,
+          "user_count": 0,
+          "component_count": 0,
+          "tenants": {},
+          "users": {},
+          "components": {}
+        },
+        "last_seen_at": "2026-07-10T13:20:34.491811Z",
+        "retirement_candidate": true,
+        "retirement_reason": "no measured usage in review window"
+      },
+      {
+        "interface": {
+          "id": "cd9342fd-27e7-4a46-a1be-d41499e106a3",
+          "interface_key": "rest_api:DELETE /workstreams/{workstream_id}",
+          "interface_kind": "rest_api",
+          "legacy_since": "2026-06-06T17:28:13.052813Z",
+          "replacement_ref": "/workplans/{workplan_id}",
+          "owner_component": "state-hub.api",
+          "status": "legacy",
+          "replacement_verified": true,
+          "manual_hold": false,
+          "hold_reason": null,
+          "notes": null,
+          "retired_at": null,
+          "created_at": "2026-06-06T17:28:13.052813Z",
+          "updated_at": "2026-06-06T17:28:13.052813Z"
+        },
+        "all_time": {
+          "calls": 1,
+          "tenant_count": 1,
+          "user_count": 1,
+          "component_count": 1,
+          "tenants": {
+            "unknown": 1
+          },
+          "users": {
+            "unknown": 1
+          },
+          "components": {
+            "unknown": 1
+          }
+        },
+        "window": {
+          "calls": 0,
+          "tenant_count": 0,
+          "user_count": 0,
+          "component_count": 0,
+          "tenants": {},
+          "users": {},
+          "components": {}
+        },
+        "last_seen_at": "2026-06-06T17:28:13.047529Z",
+        "retirement_candidate": true,
+        "retirement_reason": "no measured usage in review window"
+      },
+      {
+        "interface": {
+          "id": "a4e0948c-cd4a-461e-8ae2-7fd7b51d04a7",
+          "interface_key": "rest_api:GET /decisions/?workstream_id",
+          "interface_kind": "rest_api",
+          "legacy_since": "2026-07-09T23:07:53.093223Z",
+          "replacement_ref": "/decisions/?workplan_id=<workplan_id>",
+          "owner_component": "state-hub.api",
+          "status": "legacy",
+          "replacement_verified": true,
+          "manual_hold": false,
+          "hold_reason": null,
+          "notes": null,
+          "retired_at": null,
+          "created_at": "2026-07-09T23:07:53.093223Z",
+          "updated_at": "2026-07-09T23:07:53.093223Z"
+        },
+        "all_time": {
+          "calls": 1,
+          "tenant_count": 1,
+          "user_count": 1,
+          "component_count": 1,
+          "tenants": {
+            "unknown": 1
+          },
+          "users": {
+            "unknown": 1
+          },
+          "components": {
+            "unknown": 1
+          }
+        },
+        "window": {
+          "calls": 0,
+          "tenant_count": 0,
+          "user_count": 0,
+          "component_count": 0,
+          "tenants": {},
+          "users": {},
+          "components": {}
+        },
+        "last_seen_at": "2026-07-09T23:07:53.083299Z",
+        "retirement_candidate": true,
+        "retirement_reason": "no measured usage in review window"
+      },
+      {
+        "interface": {
+          "id": "70a9346e-e0ee-42ac-874f-f160580b54dd",
+          "interface_key": "rest_api:GET /progress/?workstream_id",
+          "interface_kind": "rest_api",
+          "legacy_since": "2026-07-13T22:04:03.911449Z",
+          "replacement_ref": "/progress/?workplan_id=<workplan_id>",
+          "owner_component": "state-hub.api",
+          "status": "legacy",
+          "replacement_verified": true,
+          "manual_hold": false,
+          "hold_reason": null,
+          "notes": null,
+          "retired_at": null,
+          "created_at": "2026-07-13T22:04:03.911449Z",
+          "updated_at": "2026-07-13T22:04:03.911449Z"
+        },
+        "all_time": {
+          "calls": 2,
+          "tenant_count": 1,
+          "user_count": 1,
+          "component_count": 1,
+          "tenants": {
+            "unknown": 2
+          },
+          "users": {
+            "unknown": 2
+          },
+          "components": {
+            "unknown": 2
+          }
+        },
+        "window": {
+          "calls": 0,
+          "tenant_count": 0,
+          "user_count": 0,
+          "component_count": 0,
+          "tenants": {},
+          "users": {},
+          "components": {}
+        },
+        "last_seen_at": "2026-08-12T08:55:33.912995Z",
+        "retirement_candidate": true,
+        "retirement_reason": "no measured usage in review window"
+      },
+      {
+        "interface": {
+          "id": "be3cdcf8-250b-4bf0-801f-02ffd5f57e00",
+          "interface_key": "rest_api:GET /tasks/?workstream_id",
+          "interface_kind": "rest_api",
+          "legacy_since": "2026-07-08T19:32:21.628513Z",
+          "replacement_ref": "/tasks/?workplan_id=<workplan_id>",
+          "owner_component": "state-hub.api",
+          "status": "legacy",
+          "replacement_verified": true,
+          "manual_hold": false,
+          "hold_reason": null,
+          "notes": null,
+          "retired_at": null,
+          "created_at": "2026-07-08T19:32:21.628513Z",
+          "updated_at": "2026-07-08T19:32:21.628513Z"
+        },
+        "all_time": {
+          "calls": 590,
+          "tenant_count": 1,
+          "user_count": 1,
+          "component_count": 1,
+          "tenants": {
+            "unknown": 590
+          },
+          "users": {
+            "unknown": 590
+          },
+          "components": {
+            "unknown": 590
+          }
+        },
+        "window": {
+          "calls": 0,
+          "tenant_count": 0,
+          "user_count": 0,
+          "component_count": 0,
+          "tenants": {},
+          "users": {},
+          "components": {}
+        },
+        "last_seen_at": "2026-08-12T08:55:27.763102Z",
+        "retirement_candidate": true,
+        "retirement_reason": "no measured usage in review window"
+      },
+      {
+        "interface": {
+          "id": "3e4a3d0b-08fa-45c3-91e2-4f514a914b97",
+          "interface_key": "rest_api:GET /workstreams/",
+          "interface_kind": "rest_api",
+          "legacy_since": "2026-06-04T00:26:14.533764Z",
+          "replacement_ref": "/workplans/",
+          "owner_component": "state-hub.api",
+          "status": "legacy",
+          "replacement_verified": true,
+          "manual_hold": false,
+          "hold_reason": null,
+          "notes": null,
+          "retired_at": null,
+          "created_at": "2026-06-04T00:26:14.533764Z",
+          "updated_at": "2026-06-04T00:26:14.533764Z"
+        },
+        "all_time": {
+          "calls": 144086,
+          "tenant_count": 1,
+          "user_count": 1,
+          "component_count": 1,
+          "tenants": {
+            "unknown": 144086
+          },
+          "users": {
+            "unknown": 144086
+          },
+          "components": {
+            "unknown": 144086
+          }
+        },
+        "window": {
+          "calls": 0,
+          "tenant_count": 0,
+          "user_count": 0,
+          "component_count": 0,
+          "tenants": {},
+          "users": {},
+          "components": {}
+        },
+        "last_seen_at": "2026-08-10T18:06:05.032338Z",
+        "retirement_candidate": true,
+        "retirement_reason": "no measured usage in review window"
+      },
+      {
+        "interface": {
+          "id": "e4c140ec-7479-46f9-b185-4b533f19d639",
+          "interface_key": "rest_api:GET /workstreams/workplan-index",
+          "interface_kind": "rest_api",
+          "legacy_since": "2026-06-04T05:20:58.321869Z",
+          "replacement_ref": "/workplans/index",
+          "owner_component": "state-hub.api",
+          "status": "legacy",
+          "replacement_verified": true,
+          "manual_hold": false,
+          "hold_reason": null,
+          "notes": null,
+          "retired_at": null,
+          "created_at": "2026-06-04T05:20:58.321869Z",
+          "updated_at": "2026-06-04T05:20:58.321869Z"
+        },
+        "all_time": {
+          "calls": 30,
+          "tenant_count": 1,
+          "user_count": 1,
+          "component_count": 1,
+          "tenants": {
+            "unknown": 30
+          },
+          "users": {
+            "unknown": 30
+          },
+          "components": {
+            "unknown": 30
+          }
+        },
+        "window": {
+          "calls": 0,
+          "tenant_count": 0,
+          "user_count": 0,
+          "component_count": 0,
+          "tenants": {},
+          "users": {},
+          "components": {}
+        },
+        "last_seen_at": "2026-07-03T05:20:34.534439Z",
+        "retirement_candidate": true,
+        "retirement_reason": "no measured usage in review window"
+      },
+      {
+        "interface": {
+          "id": "3a00b19e-e7db-4403-98aa-a77c9ab61ecc",
+          "interface_key": "rest_api:GET /workstreams/{workstream_id}",
+          "interface_kind": "rest_api",
+          "legacy_since": "2026-06-04T00:25:59.014966Z",
+          "replacement_ref": "/workplans/{workplan_id}",
+          "owner_component": "state-hub.api",
+          "status": "legacy",
+          "replacement_verified": true,
+          "manual_hold": false,
+          "hold_reason": null,
+          "notes": null,
+          "retired_at": null,
+          "created_at": "2026-06-04T00:25:59.014966Z",
+          "updated_at": "2026-06-04T00:25:59.014966Z"
+        },
+        "all_time": {
+          "calls": 511406,
+          "tenant_count": 1,
+          "user_count": 1,
+          "component_count": 1,
+          "tenants": {
+            "unknown": 511406
+          },
+          "users": {
+            "unknown": 511406
+          },
+          "components": {
+            "unknown": 511406
+          }
+        },
+        "window": {
+          "calls": 0,
+          "tenant_count": 0,
+          "user_count": 0,
+          "component_count": 0,
+          "tenants": {},
+          "users": {},
+          "components": {}
+        },
+        "last_seen_at": "2026-07-31T16:25:32.004042Z",
+        "retirement_candidate": true,
+        "retirement_reason": "no measured usage in review window"
+      },
+      {
+        "interface": {
+          "id": "69e1a255-a8b9-4101-8a68-b1bed23abfda",
+          "interface_key": "rest_api:GET /workstreams/{workstream_id}/dependencies/",
+          "interface_kind": "rest_api",
+          "legacy_since": "2026-06-04T00:25:59.291135Z",
+          "replacement_ref": "/workplans/{workplan_id}/dependencies/",
+          "owner_component": "state-hub.api",
+          "status": "legacy",
+          "replacement_verified": true,
+          "manual_hold": false,
+          "hold_reason": null,
+          "notes": null,
+          "retired_at": null,
+          "created_at": "2026-06-04T00:25:59.291135Z",
+          "updated_at": "2026-06-04T00:25:59.291135Z"
+        },
+        "all_time": {
+          "calls": 255865,
+          "tenant_count": 1,
+          "user_count": 1,
+          "component_count": 1,
+          "tenants": {
+            "unknown": 255865
+          },
+          "users": {
+            "unknown": 255865
+          },
+          "components": {
+            "unknown": 255865
+          }
+        },
+        "window": {
+          "calls": 0,
+          "tenant_count": 0,
+          "user_count": 0,
+          "component_count": 0,
+          "tenants": {},
+          "users": {},
+          "components": {}
+        },
+        "last_seen_at": "2026-07-08T21:14:12.747005Z",
+        "retirement_candidate": true,
+        "retirement_reason": "no measured usage in review window"
+      },
+      {
+        "interface": {
+          "id": "b1aae931-b51f-4a85-a723-865dd65f6132",
+          "interface_key": "rest_api:PATCH /workstreams/{workstream_id}",
+          "interface_kind": "rest_api",
+          "legacy_since": "2026-06-04T06:09:41.901035Z",
+          "replacement_ref": "/workplans/{workplan_id}",
+          "owner_component": "state-hub.api",
+          "status": "legacy",
+          "replacement_verified": true,
+          "manual_hold": false,
+          "hold_reason": null,
+          "notes": null,
+          "retired_at": null,
+          "created_at": "2026-06-04T06:09:41.901035Z",
+          "updated_at": "2026-06-04T06:09:41.901035Z"
+        },
+        "all_time": {
+          "calls": 571,
+          "tenant_count": 1,
+          "user_count": 1,
+          "component_count": 1,
+          "tenants": {
+            "unknown": 571
+          },
+          "users": {
+            "unknown": 571
+          },
+          "components": {
+            "unknown": 571
+          }
+        },
+        "window": {
+          "calls": 0,
+          "tenant_count": 0,
+          "user_count": 0,
+          "component_count": 0,
+          "tenants": {},
+          "users": {},
+          "components": {}
+        },
+        "last_seen_at": "2026-07-08T20:49:12.335710Z",
+        "retirement_candidate": true,
+        "retirement_reason": "no measured usage in review window"
+      },
+      {
+        "interface": {
+          "id": "4aea9591-970b-4918-ac4a-4da95a0a1a8c",
+          "interface_key": "rest_api:POST /decisions/ workstream_id",
+          "interface_kind": "rest_api",
+          "legacy_since": "2026-07-09T22:56:35.473130Z",
+          "replacement_ref": "POST /decisions/ with workplan_id",
+          "owner_component": "state-hub.api",
+          "status": "legacy",
+          "replacement_verified": true,
+          "manual_hold": false,
+          "hold_reason": null,
+          "notes": null,
+          "retired_at": null,
+          "created_at": "2026-07-09T22:56:35.473130Z",
+          "updated_at": "2026-07-09T22:56:35.473130Z"
+        },
+        "all_time": {
+          "calls": 3,
+          "tenant_count": 1,
+          "user_count": 1,
+          "component_count": 1,
+          "tenants": {
+            "unknown": 3
+          },
+          "users": {
+            "unknown": 3
+          },
+          "components": {
+            "unknown": 3
+          }
+        },
+        "window": {
+          "calls": 0,
+          "tenant_count": 0,
+          "user_count": 0,
+          "component_count": 0,
+          "tenants": {},
+          "users": {},
+          "components": {}
+        },
+        "last_seen_at": "2026-07-09T22:57:05.912456Z",
+        "retirement_candidate": true,
+        "retirement_reason": "no measured usage in review window"
+      },
+      {
+        "interface": {
+          "id": "4a70583c-1e41-4ec1-99a9-728856a7d79c",
+          "interface_key": "rest_api:POST /progress/ workstream_id",
+          "interface_kind": "rest_api",
+          "legacy_since": "2026-07-08T23:35:09.148333Z",
+          "replacement_ref": "POST /progress/ with workplan_id",
+          "owner_component": "state-hub.api",
+          "status": "legacy",
+          "replacement_verified": true,
+          "manual_hold": false,
+          "hold_reason": null,
+          "notes": null,
+          "retired_at": null,
+          "created_at": "2026-07-08T23:35:09.148333Z",
+          "updated_at": "2026-07-08T23:35:09.148333Z"
+        },
+        "all_time": {
+          "calls": 14,
+          "tenant_count": 1,
+          "user_count": 1,
+          "component_count": 1,
+          "tenants": {
+            "unknown": 14
+          },
+          "users": {
+            "unknown": 14
+          },
+          "components": {
+            "unknown": 14
+          }
+        },
+        "window": {
+          "calls": 0,
+          "tenant_count": 0,
+          "user_count": 0,
+          "component_count": 0,
+          "tenants": {},
+          "users": {},
+          "components": {}
+        },
+        "last_seen_at": "2026-07-10T08:34:42.959724Z",
+        "retirement_candidate": true,
+        "retirement_reason": "no measured usage in review window"
+      },
+      {
+        "interface": {
+          "id": "6df4e443-7bf1-461a-923b-a6eb52fe7b07",
+          "interface_key": "rest_api:POST /tasks/ workstream_id",
+          "interface_kind": "rest_api",
+          "legacy_since": "2026-07-08T22:38:29.405720Z",
+          "replacement_ref": "POST /tasks/ with workplan_id",
+          "owner_component": "state-hub.api",
+          "status": "legacy",
+          "replacement_verified": true,
+          "manual_hold": false,
+          "hold_reason": null,
+          "notes": null,
+          "retired_at": null,
+          "created_at": "2026-07-08T22:38:29.405720Z",
+          "updated_at": "2026-07-08T22:38:29.405720Z"
+        },
+        "all_time": {
+          "calls": 5,
+          "tenant_count": 1,
+          "user_count": 1,
+          "component_count": 1,
+          "tenants": {
+            "unknown": 5
+          },
+          "users": {
+            "unknown": 5
+          },
+          "components": {
+            "state-hub.fix-consistency": 5
+          }
+        },
+        "window": {
+          "calls": 0,
+          "tenant_count": 0,
+          "user_count": 0,
+          "component_count": 0,
+          "tenants": {},
+          "users": {},
+          "components": {}
+        },
+        "last_seen_at": "2026-07-08T22:38:29.976918Z",
+        "retirement_candidate": true,
+        "retirement_reason": "no measured usage in review window"
+      },
+      {
+        "interface": {
+          "id": "ed6451c9-d2cc-4486-9afe-d3852782cabc",
+          "interface_key": "rest_api:POST /workstreams/",
+          "interface_kind": "rest_api",
+          "legacy_since": "2026-06-04T07:40:24.168535Z",
+          "replacement_ref": "/workplans/",
+          "owner_component": "state-hub.api",
+          "status": "legacy",
+          "replacement_verified": true,
+          "manual_hold": false,
+          "hold_reason": null,
+          "notes": null,
+          "retired_at": null,
+          "created_at": "2026-06-04T07:40:24.168535Z",
+          "updated_at": "2026-06-04T07:40:24.168535Z"
+        },
+        "all_time": {
+          "calls": 824,
+          "tenant_count": 1,
+          "user_count": 1,
+          "component_count": 1,
+          "tenants": {
+            "unknown": 824
+          },
+          "users": {
+            "unknown": 824
+          },
+          "components": {
+            "unknown": 824
+          }
+        },
+        "window": {
+          "calls": 0,
+          "tenant_count": 0,
+          "user_count": 0,
+          "component_count": 0,
+          "tenants": {},
+          "users": {},
+          "components": {}
+        },
+        "last_seen_at": "2026-07-08T20:38:05.903144Z",
+        "retirement_candidate": true,
+        "retirement_reason": "no measured usage in review window"
+      },
+      {
+        "interface": {
+          "id": "281fd706-b192-4194-8055-2d8733c115f9",
+          "interface_key": "rest_api:POST /workstreams/{workstream_id}/dependencies/",
+          "interface_kind": "rest_api",
+          "legacy_since": "2026-06-04T22:57:37.149207Z",
+          "replacement_ref": "/workplans/{workplan_id}/dependencies/",
+          "owner_component": "state-hub.api",
+          "status": "legacy",
+          "replacement_verified": true,
+          "manual_hold": false,
+          "hold_reason": null,
+          "notes": null,
+          "retired_at": null,
+          "created_at": "2026-06-04T22:57:37.149207Z",
+          "updated_at": "2026-06-04T22:57:37.149207Z"
+        },
+        "all_time": {
+          "calls": 4971,
+          "tenant_count": 1,
+          "user_count": 1,
+          "component_count": 1,
+          "tenants": {
+            "unknown": 4971
+          },
+          "users": {
+            "unknown": 4971
+          },
+          "components": {
+            "unknown": 4971
+          }
+        },
+        "window": {
+          "calls": 0,
+          "tenant_count": 0,
+          "user_count": 0,
+          "component_count": 0,
+          "tenants": {},
+          "users": {},
+          "components": {}
+        },
+        "last_seen_at": "2026-07-01T22:09:24.229011Z",
+        "retirement_candidate": true,
+        "retirement_reason": "no measured usage in review window"
+      }
+    ],
+    "retirement_candidates": [
+      {
+        "interface": {
+          "id": "63ed90e3-42b4-431a-94db-e1254a52f9e2",
+          "interface_key": "mcp:create_workstream",
+          "interface_kind": "mcp_tool",
+          "legacy_since": "2026-07-10T13:19:44.205900Z",
+          "replacement_ref": "create_workplan",
+          "owner_component": "state-hub.mcp",
+          "status": "legacy",
+          "replacement_verified": true,
+          "manual_hold": false,
+          "hold_reason": null,
+          "notes": "Registered by STATE-WP-0070 T03 \u2014 zero-window streak starts at registration",
+          "retired_at": null,
+          "created_at": "2026-07-10T13:19:44.205900Z",
+          "updated_at": "2026-07-10T13:19:44.205900Z"
+        },
+        "all_time": {
+          "calls": 2,
+          "tenant_count": 1,
+          "user_count": 1,
+          "component_count": 1,
+          "tenants": {
+            "unknown": 2
+          },
+          "users": {
+            "unknown": 2
+          },
+          "components": {
+            "state-hub.mcp": 2
+          }
+        },
+        "window": {
+          "calls": 0,
+          "tenant_count": 0,
+          "user_count": 0,
+          "component_count": 0,
+          "tenants": {},
+          "users": {},
+          "components": {}
+        },
+        "last_seen_at": "2026-07-10T13:20:43.378546Z",
+        "retirement_candidate": true,
+        "retirement_reason": "no measured usage in review window"
+      },
+      {
+        "interface": {
+          "id": "b6a5fe44-fb85-4ef7-a273-78d09da777af",
+          "interface_key": "mcp:list_workstreams",
+          "interface_kind": "mcp_tool",
+          "legacy_since": "2026-07-10T13:19:26.075491Z",
+          "replacement_ref": "list_workplans",
+          "owner_component": "state-hub.mcp",
+          "status": "legacy",
+          "replacement_verified": true,
+          "manual_hold": false,
+          "hold_reason": null,
+          "notes": null,
+          "retired_at": null,
+          "created_at": "2026-07-10T13:19:26.075491Z",
+          "updated_at": "2026-07-10T13:19:26.075491Z"
+        },
+        "all_time": {
+          "calls": 2,
+          "tenant_count": 1,
+          "user_count": 1,
+          "component_count": 1,
+          "tenants": {
+            "unknown": 2
+          },
+          "users": {
+            "unknown": 2
+          },
+          "components": {
+            "state-hub.mcp": 2
+          }
+        },
+        "window": {
+          "calls": 0,
+          "tenant_count": 0,
+          "user_count": 0,
+          "component_count": 0,
+          "tenants": {},
+          "users": {},
+          "components": {}
+        },
+        "last_seen_at": "2026-07-10T13:20:42.374940Z",
+        "retirement_candidate": true,
+        "retirement_reason": "no measured usage in review window"
+      },
+      {
+        "interface": {
+          "id": "53c3372b-307d-4d6a-8ea4-bc36cacdcaf2",
+          "interface_key": "mcp:update_workstream",
+          "interface_kind": "mcp_tool",
+          "legacy_since": "2026-07-10T13:19:44.255216Z",
+          "replacement_ref": "update_workplan",
+          "owner_component": "state-hub.mcp",
+          "status": "legacy",
+          "replacement_verified": true,
+          "manual_hold": false,
+          "hold_reason": null,
+          "notes": "Registered by STATE-WP-0070 T03 \u2014 zero-window streak starts at registration",
+          "retired_at": null,
+          "created_at": "2026-07-10T13:19:44.255216Z",
+          "updated_at": "2026-07-10T13:19:44.255216Z"
+        },
+        "all_time": {
+          "calls": 0,
+          "tenant_count": 0,
+          "user_count": 0,
+          "component_count": 0,
+          "tenants": {},
+          "users": {},
+          "components": {}
+        },
+        "window": {
+          "calls": 0,
+          "tenant_count": 0,
+          "user_count": 0,
+          "component_count": 0,
+          "tenants": {},
+          "users": {},
+          "components": {}
+        },
+        "last_seen_at": null,
+        "retirement_candidate": true,
+        "retirement_reason": "no measured usage in review window"
+      },
+      {
+        "interface": {
+          "id": "bed4d08a-3471-48f5-9f0e-f9d550383a26",
+          "interface_key": "mcp:update_workstream_status",
+          "interface_kind": "mcp_tool",
+          "legacy_since": "2026-07-10T13:19:44.303612Z",
+          "replacement_ref": "update_workplan_status",
+          "owner_component": "state-hub.mcp",
+          "status": "legacy",
+          "replacement_verified": true,
+          "manual_hold": false,
+          "hold_reason": null,
+          "notes": "Registered by STATE-WP-0070 T03 \u2014 zero-window streak starts at registration",
+          "retired_at": null,
+          "created_at": "2026-07-10T13:19:44.303612Z",
+          "updated_at": "2026-07-10T13:19:44.303612Z"
+        },
+        "all_time": {
+          "calls": 0,
+          "tenant_count": 0,
+          "user_count": 0,
+          "component_count": 0,
+          "tenants": {},
+          "users": {},
+          "components": {}
+        },
+        "window": {
+          "calls": 0,
+          "tenant_count": 0,
+          "user_count": 0,
+          "component_count": 0,
+          "tenants": {},
+          "users": {},
+          "components": {}
+        },
+        "last_seen_at": null,
+        "retirement_candidate": true,
+        "retirement_reason": "no measured usage in review window"
+      },
+      {
+        "interface": {
+          "id": "46900dc2-0893-405b-ba59-80f31fb6ebb1",
+          "interface_key": "state://workstreams/{topic_slug}",
+          "interface_kind": "mcp_tool",
+          "legacy_since": "2026-07-10T13:19:44.344493Z",
+          "replacement_ref": "state://workplans/{topic_slug}",
+          "owner_component": "state-hub.mcp",
+          "status": "legacy",
+          "replacement_verified": true,
+          "manual_hold": false,
+          "hold_reason": null,
+          "notes": "Registered by STATE-WP-0070 T03 \u2014 zero-window streak starts at registration",
+          "retired_at": null,
+          "created_at": "2026-07-10T13:19:44.344493Z",
+          "updated_at": "2026-07-10T13:19:44.344493Z"
+        },
+        "all_time": {
+          "calls": 1,
+          "tenant_count": 1,
+          "user_count": 1,
+          "component_count": 1,
+          "tenants": {
+            "unknown": 1
+          },
+          "users": {
+            "unknown": 1
+          },
+          "components": {
+            "state-hub.mcp": 1
+          }
+        },
+        "window": {
+          "calls": 0,
+          "tenant_count": 0,
+          "user_count": 0,
+          "component_count": 0,
+          "tenants": {},
+          "users": {},
+          "components": {}
+        },
+        "last_seen_at": "2026-07-10T13:20:34.491811Z",
+        "retirement_candidate": true,
+        "retirement_reason": "no measured usage in review window"
+      },
+      {
+        "interface": {
+          "id": "cd9342fd-27e7-4a46-a1be-d41499e106a3",
+          "interface_key": "rest_api:DELETE /workstreams/{workstream_id}",
+          "interface_kind": "rest_api",
+          "legacy_since": "2026-06-06T17:28:13.052813Z",
+          "replacement_ref": "/workplans/{workplan_id}",
+          "owner_component": "state-hub.api",
+          "status": "legacy",
+          "replacement_verified": true,
+          "manual_hold": false,
+          "hold_reason": null,
+          "notes": null,
+          "retired_at": null,
+          "created_at": "2026-06-06T17:28:13.052813Z",
+          "updated_at": "2026-06-06T17:28:13.052813Z"
+        },
+        "all_time": {
+          "calls": 1,
+          "tenant_count": 1,
+          "user_count": 1,
+          "component_count": 1,
+          "tenants": {
+            "unknown": 1
+          },
+          "users": {
+            "unknown": 1
+          },
+          "components": {
+            "unknown": 1
+          }
+        },
+        "window": {
+          "calls": 0,
+          "tenant_count": 0,
+          "user_count": 0,
+          "component_count": 0,
+          "tenants": {},
+          "users": {},
+          "components": {}
+        },
+        "last_seen_at": "2026-06-06T17:28:13.047529Z",
+        "retirement_candidate": true,
+        "retirement_reason": "no measured usage in review window"
+      },
+      {
+        "interface": {
+          "id": "a4e0948c-cd4a-461e-8ae2-7fd7b51d04a7",
+          "interface_key": "rest_api:GET /decisions/?workstream_id",
+          "interface_kind": "rest_api",
+          "legacy_since": "2026-07-09T23:07:53.093223Z",
+          "replacement_ref": "/decisions/?workplan_id=<workplan_id>",
+          "owner_component": "state-hub.api",
+          "status": "legacy",
+          "replacement_verified": true,
+          "manual_hold": false,
+          "hold_reason": null,
+          "notes": null,
+          "retired_at": null,
+          "created_at": "2026-07-09T23:07:53.093223Z",
+          "updated_at": "2026-07-09T23:07:53.093223Z"
+        },
+        "all_time": {
+          "calls": 1,
+          "tenant_count": 1,
+          "user_count": 1,
+          "component_count": 1,
+          "tenants": {
+            "unknown": 1
+          },
+          "users": {
+            "unknown": 1
+          },
+          "components": {
+            "unknown": 1
+          }
+        },
+        "window": {
+          "calls": 0,
+          "tenant_count": 0,
+          "user_count": 0,
+          "component_count": 0,
+          "tenants": {},
+          "users": {},
+          "components": {}
+        },
+        "last_seen_at": "2026-07-09T23:07:53.083299Z",
+        "retirement_candidate": true,
+        "retirement_reason": "no measured usage in review window"
+      },
+      {
+        "interface": {
+          "id": "70a9346e-e0ee-42ac-874f-f160580b54dd",
+          "interface_key": "rest_api:GET /progress/?workstream_id",
+          "interface_kind": "rest_api",
+          "legacy_since": "2026-07-13T22:04:03.911449Z",
+          "replacement_ref": "/progress/?workplan_id=<workplan_id>",
+          "owner_component": "state-hub.api",
+          "status": "legacy",
+          "replacement_verified": true,
+          "manual_hold": false,
+          "hold_reason": null,
+          "notes": null,
+          "retired_at": null,
+          "created_at": "2026-07-13T22:04:03.911449Z",
+          "updated_at": "2026-07-13T22:04:03.911449Z"
+        },
+        "all_time": {
+          "calls": 2,
+          "tenant_count": 1,
+          "user_count": 1,
+          "component_count": 1,
+          "tenants": {
+            "unknown": 2
+          },
+          "users": {
+            "unknown": 2
+          },
+          "components": {
+            "unknown": 2
+          }
+        },
+        "window": {
+          "calls": 0,
+          "tenant_count": 0,
+          "user_count": 0,
+          "component_count": 0,
+          "tenants": {},
+          "users": {},
+          "components": {}
+        },
+        "last_seen_at": "2026-08-12T08:55:33.912995Z",
+        "retirement_candidate": true,
+        "retirement_reason": "no measured usage in review window"
+      },
+      {
+        "interface": {
+          "id": "be3cdcf8-250b-4bf0-801f-02ffd5f57e00",
+          "interface_key": "rest_api:GET /tasks/?workstream_id",
+          "interface_kind": "rest_api",
+          "legacy_since": "2026-07-08T19:32:21.628513Z",
+          "replacement_ref": "/tasks/?workplan_id=<workplan_id>",
+          "owner_component": "state-hub.api",
+          "status": "legacy",
+          "replacement_verified": true,
+          "manual_hold": false,
+          "hold_reason": null,
+          "notes": null,
+          "retired_at": null,
+          "created_at": "2026-07-08T19:32:21.628513Z",
+          "updated_at": "2026-07-08T19:32:21.628513Z"
+        },
+        "all_time": {
+          "calls": 590,
+          "tenant_count": 1,
+          "user_count": 1,
+          "component_count": 1,
+          "tenants": {
+            "unknown": 590
+          },
+          "users": {
+            "unknown": 590
+          },
+          "components": {
+            "unknown": 590
+          }
+        },
+        "window": {
+          "calls": 0,
+          "tenant_count": 0,
+          "user_count": 0,
+          "component_count": 0,
+          "tenants": {},
+          "users": {},
+          "components": {}
+        },
+        "last_seen_at": "2026-08-12T08:55:27.763102Z",
+        "retirement_candidate": true,
+        "retirement_reason": "no measured usage in review window"
+      },
+      {
+        "interface": {
+          "id": "3e4a3d0b-08fa-45c3-91e2-4f514a914b97",
+          "interface_key": "rest_api:GET /workstreams/",
+          "interface_kind": "rest_api",
+          "legacy_since": "2026-06-04T00:26:14.533764Z",
+          "replacement_ref": "/workplans/",
+          "owner_component": "state-hub.api",
+          "status": "legacy",
+          "replacement_verified": true,
+          "manual_hold": false,
+          "hold_reason": null,
+          "notes": null,
+          "retired_at": null,
+          "created_at": "2026-06-04T00:26:14.533764Z",
+          "updated_at": "2026-06-04T00:26:14.533764Z"
+        },
+        "all_time": {
+          "calls": 144086,
+          "tenant_count": 1,
+          "user_count": 1,
+          "component_count": 1,
+          "tenants": {
+            "unknown": 144086
+          },
+          "users": {
+            "unknown": 144086
+          },
+          "components": {
+            "unknown": 144086
+          }
+        },
+        "window": {
+          "calls": 0,
+          "tenant_count": 0,
+          "user_count": 0,
+          "component_count": 0,
+          "tenants": {},
+          "users": {},
+          "components": {}
+        },
+        "last_seen_at": "2026-08-10T18:06:05.032338Z",
+        "retirement_candidate": true,
+        "retirement_reason": "no measured usage in review window"
+      },
+      {
+        "interface": {
+          "id": "e4c140ec-7479-46f9-b185-4b533f19d639",
+          "interface_key": "rest_api:GET /workstreams/workplan-index",
+          "interface_kind": "rest_api",
+          "legacy_since": "2026-06-04T05:20:58.321869Z",
+          "replacement_ref": "/workplans/index",
+          "owner_component": "state-hub.api",
+          "status": "legacy",
+          "replacement_verified": true,
+          "manual_hold": false,
+          "hold_reason": null,
+          "notes": null,
+          "retired_at": null,
+          "created_at": "2026-06-04T05:20:58.321869Z",
+          "updated_at": "2026-06-04T05:20:58.321869Z"
+        },
+        "all_time": {
+          "calls": 30,
+          "tenant_count": 1,
+          "user_count": 1,
+          "component_count": 1,
+          "tenants": {
+            "unknown": 30
+          },
+          "users": {
+            "unknown": 30
+          },
+          "components": {
+            "unknown": 30
+          }
+        },
+        "window": {
+          "calls": 0,
+          "tenant_count": 0,
+          "user_count": 0,
+          "component_count": 0,
+          "tenants": {},
+          "users": {},
+          "components": {}
+        },
+        "last_seen_at": "2026-07-03T05:20:34.534439Z",
+        "retirement_candidate": true,
+        "retirement_reason": "no measured usage in review window"
+      },
+      {
+        "interface": {
+          "id": "3a00b19e-e7db-4403-98aa-a77c9ab61ecc",
+          "interface_key": "rest_api:GET /workstreams/{workstream_id}",
+          "interface_kind": "rest_api",
+          "legacy_since": "2026-06-04T00:25:59.014966Z",
+          "replacement_ref": "/workplans/{workplan_id}",
+          "owner_component": "state-hub.api",
+          "status": "legacy",
+          "replacement_verified": true,
+          "manual_hold": false,
+          "hold_reason": null,
+          "notes": null,
+          "retired_at": null,
+          "created_at": "2026-06-04T00:25:59.014966Z",
+          "updated_at": "2026-06-04T00:25:59.014966Z"
+        },
+        "all_time": {
+          "calls": 511406,
+          "tenant_count": 1,
+          "user_count": 1,
+          "component_count": 1,
+          "tenants": {
+            "unknown": 511406
+          },
+          "users": {
+            "unknown": 511406
+          },
+          "components": {
+            "unknown": 511406
+          }
+        },
+        "window": {
+          "calls": 0,
+          "tenant_count": 0,
+          "user_count": 0,
+          "component_count": 0,
+          "tenants": {},
+          "users": {},
+          "components": {}
+        },
+        "last_seen_at": "2026-07-31T16:25:32.004042Z",
+        "retirement_candidate": true,
+        "retirement_reason": "no measured usage in review window"
+      },
+      {
+        "interface": {
+          "id": "69e1a255-a8b9-4101-8a68-b1bed23abfda",
+          "interface_key": "rest_api:GET /workstreams/{workstream_id}/dependencies/",
+          "interface_kind": "rest_api",
+          "legacy_since": "2026-06-04T00:25:59.291135Z",
+          "replacement_ref": "/workplans/{workplan_id}/dependencies/",
+          "owner_component": "state-hub.api",
+          "status": "legacy",
+          "replacement_verified": true,
+          "manual_hold": false,
+          "hold_reason": null,
+          "notes": null,
+          "retired_at": null,
+          "created_at": "2026-06-04T00:25:59.291135Z",
+          "updated_at": "2026-06-04T00:25:59.291135Z"
+        },
+        "all_time": {
+          "calls": 255865,
+          "tenant_count": 1,
+          "user_count": 1,
+          "component_count": 1,
+          "tenants": {
+            "unknown": 255865
+          },
+          "users": {
+            "unknown": 255865
+          },
+          "components": {
+            "unknown": 255865
+          }
+        },
+        "window": {
+          "calls": 0,
+          "tenant_count": 0,
+          "user_count": 0,
+          "component_count": 0,
+          "tenants": {},
+          "users": {},
+          "components": {}
+        },
+        "last_seen_at": "2026-07-08T21:14:12.747005Z",
+        "retirement_candidate": true,
+        "retirement_reason": "no measured usage in review window"
+      },
+      {
+        "interface": {
+          "id": "b1aae931-b51f-4a85-a723-865dd65f6132",
+          "interface_key": "rest_api:PATCH /workstreams/{workstream_id}",
+          "interface_kind": "rest_api",
+          "legacy_since": "2026-06-04T06:09:41.901035Z",
+          "replacement_ref": "/workplans/{workplan_id}",
+          "owner_component": "state-hub.api",
+          "status": "legacy",
+          "replacement_verified": true,
+          "manual_hold": false,
+          "hold_reason": null,
+          "notes": null,
+          "retired_at": null,
+          "created_at": "2026-06-04T06:09:41.901035Z",
+          "updated_at": "2026-06-04T06:09:41.901035Z"
+        },
+        "all_time": {
+          "calls": 571,
+          "tenant_count": 1,
+          "user_count": 1,
+          "component_count": 1,
+          "tenants": {
+            "unknown": 571
+          },
+          "users": {
+            "unknown": 571
+          },
+          "components": {
+            "unknown": 571
+          }
+        },
+        "window": {
+          "calls": 0,
+          "tenant_count": 0,
+          "user_count": 0,
+          "component_count": 0,
+          "tenants": {},
+          "users": {},
+          "components": {}
+        },
+        "last_seen_at": "2026-07-08T20:49:12.335710Z",
+        "retirement_candidate": true,
+        "retirement_reason": "no measured usage in review window"
+      },
+      {
+        "interface": {
+          "id": "4aea9591-970b-4918-ac4a-4da95a0a1a8c",
+          "interface_key": "rest_api:POST /decisions/ workstream_id",
+          "interface_kind": "rest_api",
+          "legacy_since": "2026-07-09T22:56:35.473130Z",
+          "replacement_ref": "POST /decisions/ with workplan_id",
+          "owner_component": "state-hub.api",
+          "status": "legacy",
+          "replacement_verified": true,
+          "manual_hold": false,
+          "hold_reason": null,
+          "notes": null,
+          "retired_at": null,
+          "created_at": "2026-07-09T22:56:35.473130Z",
+          "updated_at": "2026-07-09T22:56:35.473130Z"
+        },
+        "all_time": {
+          "calls": 3,
+          "tenant_count": 1,
+          "user_count": 1,
+          "component_count": 1,
+          "tenants": {
+            "unknown": 3
+          },
+          "users": {
+            "unknown": 3
+          },
+          "components": {
+            "unknown": 3
+          }
+        },
+        "window": {
+          "calls": 0,
+          "tenant_count": 0,
+          "user_count": 0,
+          "component_count": 0,
+          "tenants": {},
+          "users": {},
+          "components": {}
+        },
+        "last_seen_at": "2026-07-09T22:57:05.912456Z",
+        "retirement_candidate": true,
+        "retirement_reason": "no measured usage in review window"
+      },
+      {
+        "interface": {
+          "id": "4a70583c-1e41-4ec1-99a9-728856a7d79c",
+          "interface_key": "rest_api:POST /progress/ workstream_id",
+          "interface_kind": "rest_api",
+          "legacy_since": "2026-07-08T23:35:09.148333Z",
+          "replacement_ref": "POST /progress/ with workplan_id",
+          "owner_component": "state-hub.api",
+          "status": "legacy",
+          "replacement_verified": true,
+          "manual_hold": false,
+          "hold_reason": null,
+          "notes": null,
+          "retired_at": null,
+          "created_at": "2026-07-08T23:35:09.148333Z",
+          "updated_at": "2026-07-08T23:35:09.148333Z"
+        },
+        "all_time": {
+          "calls": 14,
+          "tenant_count": 1,
+          "user_count": 1,
+          "component_count": 1,
+          "tenants": {
+            "unknown": 14
+          },
+          "users": {
+            "unknown": 14
+          },
+          "components": {
+            "unknown": 14
+          }
+        },
+        "window": {
+          "calls": 0,
+          "tenant_count": 0,
+          "user_count": 0,
+          "component_count": 0,
+          "tenants": {},
+          "users": {},
+          "components": {}
+        },
+        "last_seen_at": "2026-07-10T08:34:42.959724Z",
+        "retirement_candidate": true,
+        "retirement_reason": "no measured usage in review window"
+      },
+      {
+        "interface": {
+          "id": "6df4e443-7bf1-461a-923b-a6eb52fe7b07",
+          "interface_key": "rest_api:POST /tasks/ workstream_id",
+          "interface_kind": "rest_api",
+          "legacy_since": "2026-07-08T22:38:29.405720Z",
+          "replacement_ref": "POST /tasks/ with workplan_id",
+          "owner_component": "state-hub.api",
+          "status": "legacy",
+          "replacement_verified": true,
+          "manual_hold": false,
+          "hold_reason": null,
+          "notes": null,
+          "retired_at": null,
+          "created_at": "2026-07-08T22:38:29.405720Z",
+          "updated_at": "2026-07-08T22:38:29.405720Z"
+        },
+        "all_time": {
+          "calls": 5,
+          "tenant_count": 1,
+          "user_count": 1,
+          "component_count": 1,
+          "tenants": {
+            "unknown": 5
+          },
+          "users": {
+            "unknown": 5
+          },
+          "components": {
+            "state-hub.fix-consistency": 5
+          }
+        },
+        "window": {
+          "calls": 0,
+          "tenant_count": 0,
+          "user_count": 0,
+          "component_count": 0,
+          "tenants": {},
+          "users": {},
+          "components": {}
+        },
+        "last_seen_at": "2026-07-08T22:38:29.976918Z",
+        "retirement_candidate": true,
+        "retirement_reason": "no measured usage in review window"
+      },
+      {
+        "interface": {
+          "id": "ed6451c9-d2cc-4486-9afe-d3852782cabc",
+          "interface_key": "rest_api:POST /workstreams/",
+          "interface_kind": "rest_api",
+          "legacy_since": "2026-06-04T07:40:24.168535Z",
+          "replacement_ref": "/workplans/",
+          "owner_component": "state-hub.api",
+          "status": "legacy",
+          "replacement_verified": true,
+          "manual_hold": false,
+          "hold_reason": null,
+          "notes": null,
+          "retired_at": null,
+          "created_at": "2026-06-04T07:40:24.168535Z",
+          "updated_at": "2026-06-04T07:40:24.168535Z"
+        },
+        "all_time": {
+          "calls": 824,
+          "tenant_count": 1,
+          "user_count": 1,
+          "component_count": 1,
+          "tenants": {
+            "unknown": 824
+          },
+          "users": {
+            "unknown": 824
+          },
+          "components": {
+            "unknown": 824
+          }
+        },
+        "window": {
+          "calls": 0,
+          "tenant_count": 0,
+          "user_count": 0,
+          "component_count": 0,
+          "tenants": {},
+          "users": {},
+          "components": {}
+        },
+        "last_seen_at": "2026-07-08T20:38:05.903144Z",
+        "retirement_candidate": true,
+        "retirement_reason": "no measured usage in review window"
+      },
+      {
+        "interface": {
+          "id": "281fd706-b192-4194-8055-2d8733c115f9",
+          "interface_key": "rest_api:POST /workstreams/{workstream_id}/dependencies/",
+          "interface_kind": "rest_api",
+          "legacy_since": "2026-06-04T22:57:37.149207Z",
+          "replacement_ref": "/workplans/{workplan_id}/dependencies/",
+          "owner_component": "state-hub.api",
+          "status": "legacy",
+          "replacement_verified": true,
+          "manual_hold": false,
+          "hold_reason": null,
+          "notes": null,
+          "retired_at": null,
+          "created_at": "2026-06-04T22:57:37.149207Z",
+          "updated_at": "2026-06-04T22:57:37.149207Z"
+        },
+        "all_time": {
+          "calls": 4971,
+          "tenant_count": 1,
+          "user_count": 1,
+          "component_count": 1,
+          "tenants": {
+            "unknown": 4971
+          },
+          "users": {
+            "unknown": 4971
+          },
+          "components": {
+            "unknown": 4971
+          }
+        },
+        "window": {
+          "calls": 0,
+          "tenant_count": 0,
+          "user_count": 0,
+          "component_count": 0,
+          "tenants": {},
+          "users": {},
+          "components": {}
+        },
+        "last_seen_at": "2026-07-01T22:09:24.229011Z",
+        "retirement_candidate": true,
+        "retirement_reason": "no measured usage in review window"
+      }
+    ]
+  },
+  "hours": 8
+}
diff --git a/docs/evidence/legacy-meter-weekly-review-20260819.json b/docs/evidence/legacy-meter-weekly-review-20260819.json
new file mode 100644
index 0000000..94834ba
--- /dev/null
+++ b/docs/evidence/legacy-meter-weekly-review-20260819.json
@@ -0,0 +1,1755 @@
+{
+  "captured_at": "2026-08-19T14:00:07.711509+00:00",
+  "api_base": "http://127.0.0.1:8000",
+  "workplan": "STATE-WP-0070",
+  "retired_interfaces": [],
+  "weekly_review": {
+    "generated_at": "2026-08-19T14:00:07.705476Z",
+    "window_start": "2026-08-19T06:00:07.601317Z",
+    "window_end": "2026-08-19T14:00:07.601317Z",
+    "cadence": "weekly",
+    "activity_core_handoff": {
+      "activity_id": "statehub-legacy-interface-review",
+      "cadence": "weekly",
+      "source_endpoint": "/legacy-meter/weekly-review",
+      "state_owner": "state-hub",
+      "scheduler_owner": "activity-core"
+    },
+    "interfaces": [
+      {
+        "interface": {
+          "id": "8051fb40-66c9-4dc4-a413-13e8573e04a3",
+          "interface_key": "event_subject:org.statehub.workstream.completed",
+          "interface_kind": "event_subject",
+          "legacy_since": "2026-06-04T06:09:42.198193Z",
+          "replacement_ref": "org.statehub.workplan.completed",
+          "owner_component": "state-hub.events",
+          "status": "retired",
+          "replacement_verified": true,
+          "manual_hold": false,
+          "hold_reason": null,
+          "notes": "Retired by STATE-WP-0069 closeout",
+          "retired_at": "2026-07-08T21:38:52.773601Z",
+          "created_at": "2026-06-04T06:09:42.198193Z",
+          "updated_at": "2026-07-08T21:38:52.761243Z"
+        },
+        "all_time": {
+          "calls": 255,
+          "tenant_count": 1,
+          "user_count": 1,
+          "component_count": 1,
+          "tenants": {
+            "unknown": 255
+          },
+          "users": {
+            "unknown": 255
+          },
+          "components": {
+            "state-hub.events": 255
+          }
+        },
+        "window": {
+          "calls": 0,
+          "tenant_count": 0,
+          "user_count": 0,
+          "component_count": 0,
+          "tenants": {},
+          "users": {},
+          "components": {}
+        },
+        "last_seen_at": "2026-07-08T20:49:12.839383Z",
+        "retirement_candidate": false,
+        "retirement_reason": "already retired"
+      },
+      {
+        "interface": {
+          "id": "63ed90e3-42b4-431a-94db-e1254a52f9e2",
+          "interface_key": "mcp:create_workstream",
+          "interface_kind": "mcp_tool",
+          "legacy_since": "2026-07-10T13:19:44.205900Z",
+          "replacement_ref": "create_workplan",
+          "owner_component": "state-hub.mcp",
+          "status": "legacy",
+          "replacement_verified": true,
+          "manual_hold": false,
+          "hold_reason": null,
+          "notes": "Registered by STATE-WP-0070 T03 \u2014 zero-window streak starts at registration",
+          "retired_at": null,
+          "created_at": "2026-07-10T13:19:44.205900Z",
+          "updated_at": "2026-07-10T13:19:44.205900Z"
+        },
+        "all_time": {
+          "calls": 2,
+          "tenant_count": 1,
+          "user_count": 1,
+          "component_count": 1,
+          "tenants": {
+            "unknown": 2
+          },
+          "users": {
+            "unknown": 2
+          },
+          "components": {
+            "state-hub.mcp": 2
+          }
+        },
+        "window": {
+          "calls": 0,
+          "tenant_count": 0,
+          "user_count": 0,
+          "component_count": 0,
+          "tenants": {},
+          "users": {},
+          "components": {}
+        },
+        "last_seen_at": "2026-07-10T13:20:43.378546Z",
+        "retirement_candidate": true,
+        "retirement_reason": "no measured usage in review window"
+      },
+      {
+        "interface": {
+          "id": "b6a5fe44-fb85-4ef7-a273-78d09da777af",
+          "interface_key": "mcp:list_workstreams",
+          "interface_kind": "mcp_tool",
+          "legacy_since": "2026-07-10T13:19:26.075491Z",
+          "replacement_ref": "list_workplans",
+          "owner_component": "state-hub.mcp",
+          "status": "legacy",
+          "replacement_verified": true,
+          "manual_hold": false,
+          "hold_reason": null,
+          "notes": null,
+          "retired_at": null,
+          "created_at": "2026-07-10T13:19:26.075491Z",
+          "updated_at": "2026-07-10T13:19:26.075491Z"
+        },
+        "all_time": {
+          "calls": 2,
+          "tenant_count": 1,
+          "user_count": 1,
+          "component_count": 1,
+          "tenants": {
+            "unknown": 2
+          },
+          "users": {
+            "unknown": 2
+          },
+          "components": {
+            "state-hub.mcp": 2
+          }
+        },
+        "window": {
+          "calls": 0,
+          "tenant_count": 0,
+          "user_count": 0,
+          "component_count": 0,
+          "tenants": {},
+          "users": {},
+          "components": {}
+        },
+        "last_seen_at": "2026-07-10T13:20:42.374940Z",
+        "retirement_candidate": true,
+        "retirement_reason": "no measured usage in review window"
+      },
+      {
+        "interface": {
+          "id": "53c3372b-307d-4d6a-8ea4-bc36cacdcaf2",
+          "interface_key": "mcp:update_workstream",
+          "interface_kind": "mcp_tool",
+          "legacy_since": "2026-07-10T13:19:44.255216Z",
+          "replacement_ref": "update_workplan",
+          "owner_component": "state-hub.mcp",
+          "status": "legacy",
+          "replacement_verified": true,
+          "manual_hold": false,
+          "hold_reason": null,
+          "notes": "Registered by STATE-WP-0070 T03 \u2014 zero-window streak starts at registration",
+          "retired_at": null,
+          "created_at": "2026-07-10T13:19:44.255216Z",
+          "updated_at": "2026-07-10T13:19:44.255216Z"
+        },
+        "all_time": {
+          "calls": 0,
+          "tenant_count": 0,
+          "user_count": 0,
+          "component_count": 0,
+          "tenants": {},
+          "users": {},
+          "components": {}
+        },
+        "window": {
+          "calls": 0,
+          "tenant_count": 0,
+          "user_count": 0,
+          "component_count": 0,
+          "tenants": {},
+          "users": {},
+          "components": {}
+        },
+        "last_seen_at": null,
+        "retirement_candidate": true,
+        "retirement_reason": "no measured usage in review window"
+      },
+      {
+        "interface": {
+          "id": "bed4d08a-3471-48f5-9f0e-f9d550383a26",
+          "interface_key": "mcp:update_workstream_status",
+          "interface_kind": "mcp_tool",
+          "legacy_since": "2026-07-10T13:19:44.303612Z",
+          "replacement_ref": "update_workplan_status",
+          "owner_component": "state-hub.mcp",
+          "status": "legacy",
+          "replacement_verified": true,
+          "manual_hold": false,
+          "hold_reason": null,
+          "notes": "Registered by STATE-WP-0070 T03 \u2014 zero-window streak starts at registration",
+          "retired_at": null,
+          "created_at": "2026-07-10T13:19:44.303612Z",
+          "updated_at": "2026-07-10T13:19:44.303612Z"
+        },
+        "all_time": {
+          "calls": 0,
+          "tenant_count": 0,
+          "user_count": 0,
+          "component_count": 0,
+          "tenants": {},
+          "users": {},
+          "components": {}
+        },
+        "window": {
+          "calls": 0,
+          "tenant_count": 0,
+          "user_count": 0,
+          "component_count": 0,
+          "tenants": {},
+          "users": {},
+          "components": {}
+        },
+        "last_seen_at": null,
+        "retirement_candidate": true,
+        "retirement_reason": "no measured usage in review window"
+      },
+      {
+        "interface": {
+          "id": "46900dc2-0893-405b-ba59-80f31fb6ebb1",
+          "interface_key": "state://workstreams/{topic_slug}",
+          "interface_kind": "mcp_tool",
+          "legacy_since": "2026-07-10T13:19:44.344493Z",
+          "replacement_ref": "state://workplans/{topic_slug}",
+          "owner_component": "state-hub.mcp",
+          "status": "legacy",
+          "replacement_verified": true,
+          "manual_hold": false,
+          "hold_reason": null,
+          "notes": "Registered by STATE-WP-0070 T03 \u2014 zero-window streak starts at registration",
+          "retired_at": null,
+          "created_at": "2026-07-10T13:19:44.344493Z",
+          "updated_at": "2026-07-10T13:19:44.344493Z"
+        },
+        "all_time": {
+          "calls": 1,
+          "tenant_count": 1,
+          "user_count": 1,
+          "component_count": 1,
+          "tenants": {
+            "unknown": 1
+          },
+          "users": {
+            "unknown": 1
+          },
+          "components": {
+            "state-hub.mcp": 1
+          }
+        },
+        "window": {
+          "calls": 0,
+          "tenant_count": 0,
+          "user_count": 0,
+          "component_count": 0,
+          "tenants": {},
+          "users": {},
+          "components": {}
+        },
+        "last_seen_at": "2026-07-10T13:20:34.491811Z",
+        "retirement_candidate": true,
+        "retirement_reason": "no measured usage in review window"
+      },
+      {
+        "interface": {
+          "id": "cd9342fd-27e7-4a46-a1be-d41499e106a3",
+          "interface_key": "rest_api:DELETE /workstreams/{workstream_id}",
+          "interface_kind": "rest_api",
+          "legacy_since": "2026-06-06T17:28:13.052813Z",
+          "replacement_ref": "/workplans/{workplan_id}",
+          "owner_component": "state-hub.api",
+          "status": "legacy",
+          "replacement_verified": true,
+          "manual_hold": false,
+          "hold_reason": null,
+          "notes": null,
+          "retired_at": null,
+          "created_at": "2026-06-06T17:28:13.052813Z",
+          "updated_at": "2026-06-06T17:28:13.052813Z"
+        },
+        "all_time": {
+          "calls": 1,
+          "tenant_count": 1,
+          "user_count": 1,
+          "component_count": 1,
+          "tenants": {
+            "unknown": 1
+          },
+          "users": {
+            "unknown": 1
+          },
+          "components": {
+            "unknown": 1
+          }
+        },
+        "window": {
+          "calls": 0,
+          "tenant_count": 0,
+          "user_count": 0,
+          "component_count": 0,
+          "tenants": {},
+          "users": {},
+          "components": {}
+        },
+        "last_seen_at": "2026-06-06T17:28:13.047529Z",
+        "retirement_candidate": true,
+        "retirement_reason": "no measured usage in review window"
+      },
+      {
+        "interface": {
+          "id": "a4e0948c-cd4a-461e-8ae2-7fd7b51d04a7",
+          "interface_key": "rest_api:GET /decisions/?workstream_id",
+          "interface_kind": "rest_api",
+          "legacy_since": "2026-07-09T23:07:53.093223Z",
+          "replacement_ref": "/decisions/?workplan_id=<workplan_id>",
+          "owner_component": "state-hub.api",
+          "status": "legacy",
+          "replacement_verified": true,
+          "manual_hold": false,
+          "hold_reason": null,
+          "notes": null,
+          "retired_at": null,
+          "created_at": "2026-07-09T23:07:53.093223Z",
+          "updated_at": "2026-07-09T23:07:53.093223Z"
+        },
+        "all_time": {
+          "calls": 1,
+          "tenant_count": 1,
+          "user_count": 1,
+          "component_count": 1,
+          "tenants": {
+            "unknown": 1
+          },
+          "users": {
+            "unknown": 1
+          },
+          "components": {
+            "unknown": 1
+          }
+        },
+        "window": {
+          "calls": 0,
+          "tenant_count": 0,
+          "user_count": 0,
+          "component_count": 0,
+          "tenants": {},
+          "users": {},
+          "components": {}
+        },
+        "last_seen_at": "2026-07-09T23:07:53.083299Z",
+        "retirement_candidate": true,
+        "retirement_reason": "no measured usage in review window"
+      },
+      {
+        "interface": {
+          "id": "70a9346e-e0ee-42ac-874f-f160580b54dd",
+          "interface_key": "rest_api:GET /progress/?workstream_id",
+          "interface_kind": "rest_api",
+          "legacy_since": "2026-07-13T22:04:03.911449Z",
+          "replacement_ref": "/progress/?workplan_id=<workplan_id>",
+          "owner_component": "state-hub.api",
+          "status": "legacy",
+          "replacement_verified": true,
+          "manual_hold": false,
+          "hold_reason": null,
+          "notes": null,
+          "retired_at": null,
+          "created_at": "2026-07-13T22:04:03.911449Z",
+          "updated_at": "2026-07-13T22:04:03.911449Z"
+        },
+        "all_time": {
+          "calls": 2,
+          "tenant_count": 1,
+          "user_count": 1,
+          "component_count": 1,
+          "tenants": {
+            "unknown": 2
+          },
+          "users": {
+            "unknown": 2
+          },
+          "components": {
+            "unknown": 2
+          }
+        },
+        "window": {
+          "calls": 0,
+          "tenant_count": 0,
+          "user_count": 0,
+          "component_count": 0,
+          "tenants": {},
+          "users": {},
+          "components": {}
+        },
+        "last_seen_at": "2026-08-12T08:55:33.912995Z",
+        "retirement_candidate": true,
+        "retirement_reason": "no measured usage in review window"
+      },
+      {
+        "interface": {
+          "id": "be3cdcf8-250b-4bf0-801f-02ffd5f57e00",
+          "interface_key": "rest_api:GET /tasks/?workstream_id",
+          "interface_kind": "rest_api",
+          "legacy_since": "2026-07-08T19:32:21.628513Z",
+          "replacement_ref": "/tasks/?workplan_id=<workplan_id>",
+          "owner_component": "state-hub.api",
+          "status": "legacy",
+          "replacement_verified": true,
+          "manual_hold": false,
+          "hold_reason": null,
+          "notes": null,
+          "retired_at": null,
+          "created_at": "2026-07-08T19:32:21.628513Z",
+          "updated_at": "2026-07-08T19:32:21.628513Z"
+        },
+        "all_time": {
+          "calls": 594,
+          "tenant_count": 1,
+          "user_count": 1,
+          "component_count": 1,
+          "tenants": {
+            "unknown": 594
+          },
+          "users": {
+            "unknown": 594
+          },
+          "components": {
+            "unknown": 594
+          }
+        },
+        "window": {
+          "calls": 0,
+          "tenant_count": 0,
+          "user_count": 0,
+          "component_count": 0,
+          "tenants": {},
+          "users": {},
+          "components": {}
+        },
+        "last_seen_at": "2026-08-18T19:39:03.154960Z",
+        "retirement_candidate": true,
+        "retirement_reason": "no measured usage in review window"
+      },
+      {
+        "interface": {
+          "id": "3e4a3d0b-08fa-45c3-91e2-4f514a914b97",
+          "interface_key": "rest_api:GET /workstreams/",
+          "interface_kind": "rest_api",
+          "legacy_since": "2026-06-04T00:26:14.533764Z",
+          "replacement_ref": "/workplans/",
+          "owner_component": "state-hub.api",
+          "status": "legacy",
+          "replacement_verified": true,
+          "manual_hold": false,
+          "hold_reason": null,
+          "notes": null,
+          "retired_at": null,
+          "created_at": "2026-06-04T00:26:14.533764Z",
+          "updated_at": "2026-06-04T00:26:14.533764Z"
+        },
+        "all_time": {
+          "calls": 144086,
+          "tenant_count": 1,
+          "user_count": 1,
+          "component_count": 1,
+          "tenants": {
+            "unknown": 144086
+          },
+          "users": {
+            "unknown": 144086
+          },
+          "components": {
+            "unknown": 144086
+          }
+        },
+        "window": {
+          "calls": 0,
+          "tenant_count": 0,
+          "user_count": 0,
+          "component_count": 0,
+          "tenants": {},
+          "users": {},
+          "components": {}
+        },
+        "last_seen_at": "2026-08-10T18:06:05.032338Z",
+        "retirement_candidate": true,
+        "retirement_reason": "no measured usage in review window"
+      },
+      {
+        "interface": {
+          "id": "e4c140ec-7479-46f9-b185-4b533f19d639",
+          "interface_key": "rest_api:GET /workstreams/workplan-index",
+          "interface_kind": "rest_api",
+          "legacy_since": "2026-06-04T05:20:58.321869Z",
+          "replacement_ref": "/workplans/index",
+          "owner_component": "state-hub.api",
+          "status": "legacy",
+          "replacement_verified": true,
+          "manual_hold": false,
+          "hold_reason": null,
+          "notes": null,
+          "retired_at": null,
+          "created_at": "2026-06-04T05:20:58.321869Z",
+          "updated_at": "2026-06-04T05:20:58.321869Z"
+        },
+        "all_time": {
+          "calls": 30,
+          "tenant_count": 1,
+          "user_count": 1,
+          "component_count": 1,
+          "tenants": {
+            "unknown": 30
+          },
+          "users": {
+            "unknown": 30
+          },
+          "components": {
+            "unknown": 30
+          }
+        },
+        "window": {
+          "calls": 0,
+          "tenant_count": 0,
+          "user_count": 0,
+          "component_count": 0,
+          "tenants": {},
+          "users": {},
+          "components": {}
+        },
+        "last_seen_at": "2026-07-03T05:20:34.534439Z",
+        "retirement_candidate": true,
+        "retirement_reason": "no measured usage in review window"
+      },
+      {
+        "interface": {
+          "id": "3a00b19e-e7db-4403-98aa-a77c9ab61ecc",
+          "interface_key": "rest_api:GET /workstreams/{workstream_id}",
+          "interface_kind": "rest_api",
+          "legacy_since": "2026-06-04T00:25:59.014966Z",
+          "replacement_ref": "/workplans/{workplan_id}",
+          "owner_component": "state-hub.api",
+          "status": "legacy",
+          "replacement_verified": true,
+          "manual_hold": false,
+          "hold_reason": null,
+          "notes": null,
+          "retired_at": null,
+          "created_at": "2026-06-04T00:25:59.014966Z",
+          "updated_at": "2026-06-04T00:25:59.014966Z"
+        },
+        "all_time": {
+          "calls": 511406,
+          "tenant_count": 1,
+          "user_count": 1,
+          "component_count": 1,
+          "tenants": {
+            "unknown": 511406
+          },
+          "users": {
+            "unknown": 511406
+          },
+          "components": {
+            "unknown": 511406
+          }
+        },
+        "window": {
+          "calls": 0,
+          "tenant_count": 0,
+          "user_count": 0,
+          "component_count": 0,
+          "tenants": {},
+          "users": {},
+          "components": {}
+        },
+        "last_seen_at": "2026-07-31T16:25:32.004042Z",
+        "retirement_candidate": true,
+        "retirement_reason": "no measured usage in review window"
+      },
+      {
+        "interface": {
+          "id": "69e1a255-a8b9-4101-8a68-b1bed23abfda",
+          "interface_key": "rest_api:GET /workstreams/{workstream_id}/dependencies/",
+          "interface_kind": "rest_api",
+          "legacy_since": "2026-06-04T00:25:59.291135Z",
+          "replacement_ref": "/workplans/{workplan_id}/dependencies/",
+          "owner_component": "state-hub.api",
+          "status": "legacy",
+          "replacement_verified": true,
+          "manual_hold": false,
+          "hold_reason": null,
+          "notes": null,
+          "retired_at": null,
+          "created_at": "2026-06-04T00:25:59.291135Z",
+          "updated_at": "2026-06-04T00:25:59.291135Z"
+        },
+        "all_time": {
+          "calls": 255865,
+          "tenant_count": 1,
+          "user_count": 1,
+          "component_count": 1,
+          "tenants": {
+            "unknown": 255865
+          },
+          "users": {
+            "unknown": 255865
+          },
+          "components": {
+            "unknown": 255865
+          }
+        },
+        "window": {
+          "calls": 0,
+          "tenant_count": 0,
+          "user_count": 0,
+          "component_count": 0,
+          "tenants": {},
+          "users": {},
+          "components": {}
+        },
+        "last_seen_at": "2026-07-08T21:14:12.747005Z",
+        "retirement_candidate": true,
+        "retirement_reason": "no measured usage in review window"
+      },
+      {
+        "interface": {
+          "id": "b1aae931-b51f-4a85-a723-865dd65f6132",
+          "interface_key": "rest_api:PATCH /workstreams/{workstream_id}",
+          "interface_kind": "rest_api",
+          "legacy_since": "2026-06-04T06:09:41.901035Z",
+          "replacement_ref": "/workplans/{workplan_id}",
+          "owner_component": "state-hub.api",
+          "status": "legacy",
+          "replacement_verified": true,
+          "manual_hold": false,
+          "hold_reason": null,
+          "notes": null,
+          "retired_at": null,
+          "created_at": "2026-06-04T06:09:41.901035Z",
+          "updated_at": "2026-06-04T06:09:41.901035Z"
+        },
+        "all_time": {
+          "calls": 571,
+          "tenant_count": 1,
+          "user_count": 1,
+          "component_count": 1,
+          "tenants": {
+            "unknown": 571
+          },
+          "users": {
+            "unknown": 571
+          },
+          "components": {
+            "unknown": 571
+          }
+        },
+        "window": {
+          "calls": 0,
+          "tenant_count": 0,
+          "user_count": 0,
+          "component_count": 0,
+          "tenants": {},
+          "users": {},
+          "components": {}
+        },
+        "last_seen_at": "2026-07-08T20:49:12.335710Z",
+        "retirement_candidate": true,
+        "retirement_reason": "no measured usage in review window"
+      },
+      {
+        "interface": {
+          "id": "4aea9591-970b-4918-ac4a-4da95a0a1a8c",
+          "interface_key": "rest_api:POST /decisions/ workstream_id",
+          "interface_kind": "rest_api",
+          "legacy_since": "2026-07-09T22:56:35.473130Z",
+          "replacement_ref": "POST /decisions/ with workplan_id",
+          "owner_component": "state-hub.api",
+          "status": "legacy",
+          "replacement_verified": true,
+          "manual_hold": false,
+          "hold_reason": null,
+          "notes": null,
+          "retired_at": null,
+          "created_at": "2026-07-09T22:56:35.473130Z",
+          "updated_at": "2026-07-09T22:56:35.473130Z"
+        },
+        "all_time": {
+          "calls": 3,
+          "tenant_count": 1,
+          "user_count": 1,
+          "component_count": 1,
+          "tenants": {
+            "unknown": 3
+          },
+          "users": {
+            "unknown": 3
+          },
+          "components": {
+            "unknown": 3
+          }
+        },
+        "window": {
+          "calls": 0,
+          "tenant_count": 0,
+          "user_count": 0,
+          "component_count": 0,
+          "tenants": {},
+          "users": {},
+          "components": {}
+        },
+        "last_seen_at": "2026-07-09T22:57:05.912456Z",
+        "retirement_candidate": true,
+        "retirement_reason": "no measured usage in review window"
+      },
+      {
+        "interface": {
+          "id": "4a70583c-1e41-4ec1-99a9-728856a7d79c",
+          "interface_key": "rest_api:POST /progress/ workstream_id",
+          "interface_kind": "rest_api",
+          "legacy_since": "2026-07-08T23:35:09.148333Z",
+          "replacement_ref": "POST /progress/ with workplan_id",
+          "owner_component": "state-hub.api",
+          "status": "legacy",
+          "replacement_verified": true,
+          "manual_hold": false,
+          "hold_reason": null,
+          "notes": null,
+          "retired_at": null,
+          "created_at": "2026-07-08T23:35:09.148333Z",
+          "updated_at": "2026-07-08T23:35:09.148333Z"
+        },
+        "all_time": {
+          "calls": 14,
+          "tenant_count": 1,
+          "user_count": 1,
+          "component_count": 1,
+          "tenants": {
+            "unknown": 14
+          },
+          "users": {
+            "unknown": 14
+          },
+          "components": {
+            "unknown": 14
+          }
+        },
+        "window": {
+          "calls": 0,
+          "tenant_count": 0,
+          "user_count": 0,
+          "component_count": 0,
+          "tenants": {},
+          "users": {},
+          "components": {}
+        },
+        "last_seen_at": "2026-07-10T08:34:42.959724Z",
+        "retirement_candidate": true,
+        "retirement_reason": "no measured usage in review window"
+      },
+      {
+        "interface": {
+          "id": "6df4e443-7bf1-461a-923b-a6eb52fe7b07",
+          "interface_key": "rest_api:POST /tasks/ workstream_id",
+          "interface_kind": "rest_api",
+          "legacy_since": "2026-07-08T22:38:29.405720Z",
+          "replacement_ref": "POST /tasks/ with workplan_id",
+          "owner_component": "state-hub.api",
+          "status": "legacy",
+          "replacement_verified": true,
+          "manual_hold": false,
+          "hold_reason": null,
+          "notes": null,
+          "retired_at": null,
+          "created_at": "2026-07-08T22:38:29.405720Z",
+          "updated_at": "2026-07-08T22:38:29.405720Z"
+        },
+        "all_time": {
+          "calls": 5,
+          "tenant_count": 1,
+          "user_count": 1,
+          "component_count": 1,
+          "tenants": {
+            "unknown": 5
+          },
+          "users": {
+            "unknown": 5
+          },
+          "components": {
+            "state-hub.fix-consistency": 5
+          }
+        },
+        "window": {
+          "calls": 0,
+          "tenant_count": 0,
+          "user_count": 0,
+          "component_count": 0,
+          "tenants": {},
+          "users": {},
+          "components": {}
+        },
+        "last_seen_at": "2026-07-08T22:38:29.976918Z",
+        "retirement_candidate": true,
+        "retirement_reason": "no measured usage in review window"
+      },
+      {
+        "interface": {
+          "id": "ed6451c9-d2cc-4486-9afe-d3852782cabc",
+          "interface_key": "rest_api:POST /workstreams/",
+          "interface_kind": "rest_api",
+          "legacy_since": "2026-06-04T07:40:24.168535Z",
+          "replacement_ref": "/workplans/",
+          "owner_component": "state-hub.api",
+          "status": "legacy",
+          "replacement_verified": true,
+          "manual_hold": false,
+          "hold_reason": null,
+          "notes": null,
+          "retired_at": null,
+          "created_at": "2026-06-04T07:40:24.168535Z",
+          "updated_at": "2026-06-04T07:40:24.168535Z"
+        },
+        "all_time": {
+          "calls": 824,
+          "tenant_count": 1,
+          "user_count": 1,
+          "component_count": 1,
+          "tenants": {
+            "unknown": 824
+          },
+          "users": {
+            "unknown": 824
+          },
+          "components": {
+            "unknown": 824
+          }
+        },
+        "window": {
+          "calls": 0,
+          "tenant_count": 0,
+          "user_count": 0,
+          "component_count": 0,
+          "tenants": {},
+          "users": {},
+          "components": {}
+        },
+        "last_seen_at": "2026-07-08T20:38:05.903144Z",
+        "retirement_candidate": true,
+        "retirement_reason": "no measured usage in review window"
+      },
+      {
+        "interface": {
+          "id": "281fd706-b192-4194-8055-2d8733c115f9",
+          "interface_key": "rest_api:POST /workstreams/{workstream_id}/dependencies/",
+          "interface_kind": "rest_api",
+          "legacy_since": "2026-06-04T22:57:37.149207Z",
+          "replacement_ref": "/workplans/{workplan_id}/dependencies/",
+          "owner_component": "state-hub.api",
+          "status": "legacy",
+          "replacement_verified": true,
+          "manual_hold": false,
+          "hold_reason": null,
+          "notes": null,
+          "retired_at": null,
+          "created_at": "2026-06-04T22:57:37.149207Z",
+          "updated_at": "2026-06-04T22:57:37.149207Z"
+        },
+        "all_time": {
+          "calls": 4971,
+          "tenant_count": 1,
+          "user_count": 1,
+          "component_count": 1,
+          "tenants": {
+            "unknown": 4971
+          },
+          "users": {
+            "unknown": 4971
+          },
+          "components": {
+            "unknown": 4971
+          }
+        },
+        "window": {
+          "calls": 0,
+          "tenant_count": 0,
+          "user_count": 0,
+          "component_count": 0,
+          "tenants": {},
+          "users": {},
+          "components": {}
+        },
+        "last_seen_at": "2026-07-01T22:09:24.229011Z",
+        "retirement_candidate": true,
+        "retirement_reason": "no measured usage in review window"
+      }
+    ],
+    "retirement_candidates": [
+      {
+        "interface": {
+          "id": "63ed90e3-42b4-431a-94db-e1254a52f9e2",
+          "interface_key": "mcp:create_workstream",
+          "interface_kind": "mcp_tool",
+          "legacy_since": "2026-07-10T13:19:44.205900Z",
+          "replacement_ref": "create_workplan",
+          "owner_component": "state-hub.mcp",
+          "status": "legacy",
+          "replacement_verified": true,
+          "manual_hold": false,
+          "hold_reason": null,
+          "notes": "Registered by STATE-WP-0070 T03 \u2014 zero-window streak starts at registration",
+          "retired_at": null,
+          "created_at": "2026-07-10T13:19:44.205900Z",
+          "updated_at": "2026-07-10T13:19:44.205900Z"
+        },
+        "all_time": {
+          "calls": 2,
+          "tenant_count": 1,
+          "user_count": 1,
+          "component_count": 1,
+          "tenants": {
+            "unknown": 2
+          },
+          "users": {
+            "unknown": 2
+          },
+          "components": {
+            "state-hub.mcp": 2
+          }
+        },
+        "window": {
+          "calls": 0,
+          "tenant_count": 0,
+          "user_count": 0,
+          "component_count": 0,
+          "tenants": {},
+          "users": {},
+          "components": {}
+        },
+        "last_seen_at": "2026-07-10T13:20:43.378546Z",
+        "retirement_candidate": true,
+        "retirement_reason": "no measured usage in review window"
+      },
+      {
+        "interface": {
+          "id": "b6a5fe44-fb85-4ef7-a273-78d09da777af",
+          "interface_key": "mcp:list_workstreams",
+          "interface_kind": "mcp_tool",
+          "legacy_since": "2026-07-10T13:19:26.075491Z",
+          "replacement_ref": "list_workplans",
+          "owner_component": "state-hub.mcp",
+          "status": "legacy",
+          "replacement_verified": true,
+          "manual_hold": false,
+          "hold_reason": null,
+          "notes": null,
+          "retired_at": null,
+          "created_at": "2026-07-10T13:19:26.075491Z",
+          "updated_at": "2026-07-10T13:19:26.075491Z"
+        },
+        "all_time": {
+          "calls": 2,
+          "tenant_count": 1,
+          "user_count": 1,
+          "component_count": 1,
+          "tenants": {
+            "unknown": 2
+          },
+          "users": {
+            "unknown": 2
+          },
+          "components": {
+            "state-hub.mcp": 2
+          }
+        },
+        "window": {
+          "calls": 0,
+          "tenant_count": 0,
+          "user_count": 0,
+          "component_count": 0,
+          "tenants": {},
+          "users": {},
+          "components": {}
+        },
+        "last_seen_at": "2026-07-10T13:20:42.374940Z",
+        "retirement_candidate": true,
+        "retirement_reason": "no measured usage in review window"
+      },
+      {
+        "interface": {
+          "id": "53c3372b-307d-4d6a-8ea4-bc36cacdcaf2",
+          "interface_key": "mcp:update_workstream",
+          "interface_kind": "mcp_tool",
+          "legacy_since": "2026-07-10T13:19:44.255216Z",
+          "replacement_ref": "update_workplan",
+          "owner_component": "state-hub.mcp",
+          "status": "legacy",
+          "replacement_verified": true,
+          "manual_hold": false,
+          "hold_reason": null,
+          "notes": "Registered by STATE-WP-0070 T03 \u2014 zero-window streak starts at registration",
+          "retired_at": null,
+          "created_at": "2026-07-10T13:19:44.255216Z",
+          "updated_at": "2026-07-10T13:19:44.255216Z"
+        },
+        "all_time": {
+          "calls": 0,
+          "tenant_count": 0,
+          "user_count": 0,
+          "component_count": 0,
+          "tenants": {},
+          "users": {},
+          "components": {}
+        },
+        "window": {
+          "calls": 0,
+          "tenant_count": 0,
+          "user_count": 0,
+          "component_count": 0,
+          "tenants": {},
+          "users": {},
+          "components": {}
+        },
+        "last_seen_at": null,
+        "retirement_candidate": true,
+        "retirement_reason": "no measured usage in review window"
+      },
+      {
+        "interface": {
+          "id": "bed4d08a-3471-48f5-9f0e-f9d550383a26",
+          "interface_key": "mcp:update_workstream_status",
+          "interface_kind": "mcp_tool",
+          "legacy_since": "2026-07-10T13:19:44.303612Z",
+          "replacement_ref": "update_workplan_status",
+          "owner_component": "state-hub.mcp",
+          "status": "legacy",
+          "replacement_verified": true,
+          "manual_hold": false,
+          "hold_reason": null,
+          "notes": "Registered by STATE-WP-0070 T03 \u2014 zero-window streak starts at registration",
+          "retired_at": null,
+          "created_at": "2026-07-10T13:19:44.303612Z",
+          "updated_at": "2026-07-10T13:19:44.303612Z"
+        },
+        "all_time": {
+          "calls": 0,
+          "tenant_count": 0,
+          "user_count": 0,
+          "component_count": 0,
+          "tenants": {},
+          "users": {},
+          "components": {}
+        },
+        "window": {
+          "calls": 0,
+          "tenant_count": 0,
+          "user_count": 0,
+          "component_count": 0,
+          "tenants": {},
+          "users": {},
+          "components": {}
+        },
+        "last_seen_at": null,
+        "retirement_candidate": true,
+        "retirement_reason": "no measured usage in review window"
+      },
+      {
+        "interface": {
+          "id": "46900dc2-0893-405b-ba59-80f31fb6ebb1",
+          "interface_key": "state://workstreams/{topic_slug}",
+          "interface_kind": "mcp_tool",
+          "legacy_since": "2026-07-10T13:19:44.344493Z",
+          "replacement_ref": "state://workplans/{topic_slug}",
+          "owner_component": "state-hub.mcp",
+          "status": "legacy",
+          "replacement_verified": true,
+          "manual_hold": false,
+          "hold_reason": null,
+          "notes": "Registered by STATE-WP-0070 T03 \u2014 zero-window streak starts at registration",
+          "retired_at": null,
+          "created_at": "2026-07-10T13:19:44.344493Z",
+          "updated_at": "2026-07-10T13:19:44.344493Z"
+        },
+        "all_time": {
+          "calls": 1,
+          "tenant_count": 1,
+          "user_count": 1,
+          "component_count": 1,
+          "tenants": {
+            "unknown": 1
+          },
+          "users": {
+            "unknown": 1
+          },
+          "components": {
+            "state-hub.mcp": 1
+          }
+        },
+        "window": {
+          "calls": 0,
+          "tenant_count": 0,
+          "user_count": 0,
+          "component_count": 0,
+          "tenants": {},
+          "users": {},
+          "components": {}
+        },
+        "last_seen_at": "2026-07-10T13:20:34.491811Z",
+        "retirement_candidate": true,
+        "retirement_reason": "no measured usage in review window"
+      },
+      {
+        "interface": {
+          "id": "cd9342fd-27e7-4a46-a1be-d41499e106a3",
+          "interface_key": "rest_api:DELETE /workstreams/{workstream_id}",
+          "interface_kind": "rest_api",
+          "legacy_since": "2026-06-06T17:28:13.052813Z",
+          "replacement_ref": "/workplans/{workplan_id}",
+          "owner_component": "state-hub.api",
+          "status": "legacy",
+          "replacement_verified": true,
+          "manual_hold": false,
+          "hold_reason": null,
+          "notes": null,
+          "retired_at": null,
+          "created_at": "2026-06-06T17:28:13.052813Z",
+          "updated_at": "2026-06-06T17:28:13.052813Z"
+        },
+        "all_time": {
+          "calls": 1,
+          "tenant_count": 1,
+          "user_count": 1,
+          "component_count": 1,
+          "tenants": {
+            "unknown": 1
+          },
+          "users": {
+            "unknown": 1
+          },
+          "components": {
+            "unknown": 1
+          }
+        },
+        "window": {
+          "calls": 0,
+          "tenant_count": 0,
+          "user_count": 0,
+          "component_count": 0,
+          "tenants": {},
+          "users": {},
+          "components": {}
+        },
+        "last_seen_at": "2026-06-06T17:28:13.047529Z",
+        "retirement_candidate": true,
+        "retirement_reason": "no measured usage in review window"
+      },
+      {
+        "interface": {
+          "id": "a4e0948c-cd4a-461e-8ae2-7fd7b51d04a7",
+          "interface_key": "rest_api:GET /decisions/?workstream_id",
+          "interface_kind": "rest_api",
+          "legacy_since": "2026-07-09T23:07:53.093223Z",
+          "replacement_ref": "/decisions/?workplan_id=<workplan_id>",
+          "owner_component": "state-hub.api",
+          "status": "legacy",
+          "replacement_verified": true,
+          "manual_hold": false,
+          "hold_reason": null,
+          "notes": null,
+          "retired_at": null,
+          "created_at": "2026-07-09T23:07:53.093223Z",
+          "updated_at": "2026-07-09T23:07:53.093223Z"
+        },
+        "all_time": {
+          "calls": 1,
+          "tenant_count": 1,
+          "user_count": 1,
+          "component_count": 1,
+          "tenants": {
+            "unknown": 1
+          },
+          "users": {
+            "unknown": 1
+          },
+          "components": {
+            "unknown": 1
+          }
+        },
+        "window": {
+          "calls": 0,
+          "tenant_count": 0,
+          "user_count": 0,
+          "component_count": 0,
+          "tenants": {},
+          "users": {},
+          "components": {}
+        },
+        "last_seen_at": "2026-07-09T23:07:53.083299Z",
+        "retirement_candidate": true,
+        "retirement_reason": "no measured usage in review window"
+      },
+      {
+        "interface": {
+          "id": "70a9346e-e0ee-42ac-874f-f160580b54dd",
+          "interface_key": "rest_api:GET /progress/?workstream_id",
+          "interface_kind": "rest_api",
+          "legacy_since": "2026-07-13T22:04:03.911449Z",
+          "replacement_ref": "/progress/?workplan_id=<workplan_id>",
+          "owner_component": "state-hub.api",
+          "status": "legacy",
+          "replacement_verified": true,
+          "manual_hold": false,
+          "hold_reason": null,
+          "notes": null,
+          "retired_at": null,
+          "created_at": "2026-07-13T22:04:03.911449Z",
+          "updated_at": "2026-07-13T22:04:03.911449Z"
+        },
+        "all_time": {
+          "calls": 2,
+          "tenant_count": 1,
+          "user_count": 1,
+          "component_count": 1,
+          "tenants": {
+            "unknown": 2
+          },
+          "users": {
+            "unknown": 2
+          },
+          "components": {
+            "unknown": 2
+          }
+        },
+        "window": {
+          "calls": 0,
+          "tenant_count": 0,
+          "user_count": 0,
+          "component_count": 0,
+          "tenants": {},
+          "users": {},
+          "components": {}
+        },
+        "last_seen_at": "2026-08-12T08:55:33.912995Z",
+        "retirement_candidate": true,
+        "retirement_reason": "no measured usage in review window"
+      },
+      {
+        "interface": {
+          "id": "be3cdcf8-250b-4bf0-801f-02ffd5f57e00",
+          "interface_key": "rest_api:GET /tasks/?workstream_id",
+          "interface_kind": "rest_api",
+          "legacy_since": "2026-07-08T19:32:21.628513Z",
+          "replacement_ref": "/tasks/?workplan_id=<workplan_id>",
+          "owner_component": "state-hub.api",
+          "status": "legacy",
+          "replacement_verified": true,
+          "manual_hold": false,
+          "hold_reason": null,
+          "notes": null,
+          "retired_at": null,
+          "created_at": "2026-07-08T19:32:21.628513Z",
+          "updated_at": "2026-07-08T19:32:21.628513Z"
+        },
+        "all_time": {
+          "calls": 594,
+          "tenant_count": 1,
+          "user_count": 1,
+          "component_count": 1,
+          "tenants": {
+            "unknown": 594
+          },
+          "users": {
+            "unknown": 594
+          },
+          "components": {
+            "unknown": 594
+          }
+        },
+        "window": {
+          "calls": 0,
+          "tenant_count": 0,
+          "user_count": 0,
+          "component_count": 0,
+          "tenants": {},
+          "users": {},
+          "components": {}
+        },
+        "last_seen_at": "2026-08-18T19:39:03.154960Z",
+        "retirement_candidate": true,
+        "retirement_reason": "no measured usage in review window"
+      },
+      {
+        "interface": {
+          "id": "3e4a3d0b-08fa-45c3-91e2-4f514a914b97",
+          "interface_key": "rest_api:GET /workstreams/",
+          "interface_kind": "rest_api",
+          "legacy_since": "2026-06-04T00:26:14.533764Z",
+          "replacement_ref": "/workplans/",
+          "owner_component": "state-hub.api",
+          "status": "legacy",
+          "replacement_verified": true,
+          "manual_hold": false,
+          "hold_reason": null,
+          "notes": null,
+          "retired_at": null,
+          "created_at": "2026-06-04T00:26:14.533764Z",
+          "updated_at": "2026-06-04T00:26:14.533764Z"
+        },
+        "all_time": {
+          "calls": 144086,
+          "tenant_count": 1,
+          "user_count": 1,
+          "component_count": 1,
+          "tenants": {
+            "unknown": 144086
+          },
+          "users": {
+            "unknown": 144086
+          },
+          "components": {
+            "unknown": 144086
+          }
+        },
+        "window": {
+          "calls": 0,
+          "tenant_count": 0,
+          "user_count": 0,
+          "component_count": 0,
+          "tenants": {},
+          "users": {},
+          "components": {}
+        },
+        "last_seen_at": "2026-08-10T18:06:05.032338Z",
+        "retirement_candidate": true,
+        "retirement_reason": "no measured usage in review window"
+      },
+      {
+        "interface": {
+          "id": "e4c140ec-7479-46f9-b185-4b533f19d639",
+          "interface_key": "rest_api:GET /workstreams/workplan-index",
+          "interface_kind": "rest_api",
+          "legacy_since": "2026-06-04T05:20:58.321869Z",
+          "replacement_ref": "/workplans/index",
+          "owner_component": "state-hub.api",
+          "status": "legacy",
+          "replacement_verified": true,
+          "manual_hold": false,
+          "hold_reason": null,
+          "notes": null,
+          "retired_at": null,
+          "created_at": "2026-06-04T05:20:58.321869Z",
+          "updated_at": "2026-06-04T05:20:58.321869Z"
+        },
+        "all_time": {
+          "calls": 30,
+          "tenant_count": 1,
+          "user_count": 1,
+          "component_count": 1,
+          "tenants": {
+            "unknown": 30
+          },
+          "users": {
+            "unknown": 30
+          },
+          "components": {
+            "unknown": 30
+          }
+        },
+        "window": {
+          "calls": 0,
+          "tenant_count": 0,
+          "user_count": 0,
+          "component_count": 0,
+          "tenants": {},
+          "users": {},
+          "components": {}
+        },
+        "last_seen_at": "2026-07-03T05:20:34.534439Z",
+        "retirement_candidate": true,
+        "retirement_reason": "no measured usage in review window"
+      },
+      {
+        "interface": {
+          "id": "3a00b19e-e7db-4403-98aa-a77c9ab61ecc",
+          "interface_key": "rest_api:GET /workstreams/{workstream_id}",
+          "interface_kind": "rest_api",
+          "legacy_since": "2026-06-04T00:25:59.014966Z",
+          "replacement_ref": "/workplans/{workplan_id}",
+          "owner_component": "state-hub.api",
+          "status": "legacy",
+          "replacement_verified": true,
+          "manual_hold": false,
+          "hold_reason": null,
+          "notes": null,
+          "retired_at": null,
+          "created_at": "2026-06-04T00:25:59.014966Z",
+          "updated_at": "2026-06-04T00:25:59.014966Z"
+        },
+        "all_time": {
+          "calls": 511406,
+          "tenant_count": 1,
+          "user_count": 1,
+          "component_count": 1,
+          "tenants": {
+            "unknown": 511406
+          },
+          "users": {
+            "unknown": 511406
+          },
+          "components": {
+            "unknown": 511406
+          }
+        },
+        "window": {
+          "calls": 0,
+          "tenant_count": 0,
+          "user_count": 0,
+          "component_count": 0,
+          "tenants": {},
+          "users": {},
+          "components": {}
+        },
+        "last_seen_at": "2026-07-31T16:25:32.004042Z",
+        "retirement_candidate": true,
+        "retirement_reason": "no measured usage in review window"
+      },
+      {
+        "interface": {
+          "id": "69e1a255-a8b9-4101-8a68-b1bed23abfda",
+          "interface_key": "rest_api:GET /workstreams/{workstream_id}/dependencies/",
+          "interface_kind": "rest_api",
+          "legacy_since": "2026-06-04T00:25:59.291135Z",
+          "replacement_ref": "/workplans/{workplan_id}/dependencies/",
+          "owner_component": "state-hub.api",
+          "status": "legacy",
+          "replacement_verified": true,
+          "manual_hold": false,
+          "hold_reason": null,
+          "notes": null,
+          "retired_at": null,
+          "created_at": "2026-06-04T00:25:59.291135Z",
+          "updated_at": "2026-06-04T00:25:59.291135Z"
+        },
+        "all_time": {
+          "calls": 255865,
+          "tenant_count": 1,
+          "user_count": 1,
+          "component_count": 1,
+          "tenants": {
+            "unknown": 255865
+          },
+          "users": {
+            "unknown": 255865
+          },
+          "components": {
+            "unknown": 255865
+          }
+        },
+        "window": {
+          "calls": 0,
+          "tenant_count": 0,
+          "user_count": 0,
+          "component_count": 0,
+          "tenants": {},
+          "users": {},
+          "components": {}
+        },
+        "last_seen_at": "2026-07-08T21:14:12.747005Z",
+        "retirement_candidate": true,
+        "retirement_reason": "no measured usage in review window"
+      },
+      {
+        "interface": {
+          "id": "b1aae931-b51f-4a85-a723-865dd65f6132",
+          "interface_key": "rest_api:PATCH /workstreams/{workstream_id}",
+          "interface_kind": "rest_api",
+          "legacy_since": "2026-06-04T06:09:41.901035Z",
+          "replacement_ref": "/workplans/{workplan_id}",
+          "owner_component": "state-hub.api",
+          "status": "legacy",
+          "replacement_verified": true,
+          "manual_hold": false,
+          "hold_reason": null,
+          "notes": null,
+          "retired_at": null,
+          "created_at": "2026-06-04T06:09:41.901035Z",
+          "updated_at": "2026-06-04T06:09:41.901035Z"
+        },
+        "all_time": {
+          "calls": 571,
+          "tenant_count": 1,
+          "user_count": 1,
+          "component_count": 1,
+          "tenants": {
+            "unknown": 571
+          },
+          "users": {
+            "unknown": 571
+          },
+          "components": {
+            "unknown": 571
+          }
+        },
+        "window": {
+          "calls": 0,
+          "tenant_count": 0,
+          "user_count": 0,
+          "component_count": 0,
+          "tenants": {},
+          "users": {},
+          "components": {}
+        },
+        "last_seen_at": "2026-07-08T20:49:12.335710Z",
+        "retirement_candidate": true,
+        "retirement_reason": "no measured usage in review window"
+      },
+      {
+        "interface": {
+          "id": "4aea9591-970b-4918-ac4a-4da95a0a1a8c",
+          "interface_key": "rest_api:POST /decisions/ workstream_id",
+          "interface_kind": "rest_api",
+          "legacy_since": "2026-07-09T22:56:35.473130Z",
+          "replacement_ref": "POST /decisions/ with workplan_id",
+          "owner_component": "state-hub.api",
+          "status": "legacy",
+          "replacement_verified": true,
+          "manual_hold": false,
+          "hold_reason": null,
+          "notes": null,
+          "retired_at": null,
+          "created_at": "2026-07-09T22:56:35.473130Z",
+          "updated_at": "2026-07-09T22:56:35.473130Z"
+        },
+        "all_time": {
+          "calls": 3,
+          "tenant_count": 1,
+          "user_count": 1,
+          "component_count": 1,
+          "tenants": {
+            "unknown": 3
+          },
+          "users": {
+            "unknown": 3
+          },
+          "components": {
+            "unknown": 3
+          }
+        },
+        "window": {
+          "calls": 0,
+          "tenant_count": 0,
+          "user_count": 0,
+          "component_count": 0,
+          "tenants": {},
+          "users": {},
+          "components": {}
+        },
+        "last_seen_at": "2026-07-09T22:57:05.912456Z",
+        "retirement_candidate": true,
+        "retirement_reason": "no measured usage in review window"
+      },
+      {
+        "interface": {
+          "id": "4a70583c-1e41-4ec1-99a9-728856a7d79c",
+          "interface_key": "rest_api:POST /progress/ workstream_id",
+          "interface_kind": "rest_api",
+          "legacy_since": "2026-07-08T23:35:09.148333Z",
+          "replacement_ref": "POST /progress/ with workplan_id",
+          "owner_component": "state-hub.api",
+          "status": "legacy",
+          "replacement_verified": true,
+          "manual_hold": false,
+          "hold_reason": null,
+          "notes": null,
+          "retired_at": null,
+          "created_at": "2026-07-08T23:35:09.148333Z",
+          "updated_at": "2026-07-08T23:35:09.148333Z"
+        },
+        "all_time": {
+          "calls": 14,
+          "tenant_count": 1,
+          "user_count": 1,
+          "component_count": 1,
+          "tenants": {
+            "unknown": 14
+          },
+          "users": {
+            "unknown": 14
+          },
+          "components": {
+            "unknown": 14
+          }
+        },
+        "window": {
+          "calls": 0,
+          "tenant_count": 0,
+          "user_count": 0,
+          "component_count": 0,
+          "tenants": {},
+          "users": {},
+          "components": {}
+        },
+        "last_seen_at": "2026-07-10T08:34:42.959724Z",
+        "retirement_candidate": true,
+        "retirement_reason": "no measured usage in review window"
+      },
+      {
+        "interface": {
+          "id": "6df4e443-7bf1-461a-923b-a6eb52fe7b07",
+          "interface_key": "rest_api:POST /tasks/ workstream_id",
+          "interface_kind": "rest_api",
+          "legacy_since": "2026-07-08T22:38:29.405720Z",
+          "replacement_ref": "POST /tasks/ with workplan_id",
+          "owner_component": "state-hub.api",
+          "status": "legacy",
+          "replacement_verified": true,
+          "manual_hold": false,
+          "hold_reason": null,
+          "notes": null,
+          "retired_at": null,
+          "created_at": "2026-07-08T22:38:29.405720Z",
+          "updated_at": "2026-07-08T22:38:29.405720Z"
+        },
+        "all_time": {
+          "calls": 5,
+          "tenant_count": 1,
+          "user_count": 1,
+          "component_count": 1,
+          "tenants": {
+            "unknown": 5
+          },
+          "users": {
+            "unknown": 5
+          },
+          "components": {
+            "state-hub.fix-consistency": 5
+          }
+        },
+        "window": {
+          "calls": 0,
+          "tenant_count": 0,
+          "user_count": 0,
+          "component_count": 0,
+          "tenants": {},
+          "users": {},
+          "components": {}
+        },
+        "last_seen_at": "2026-07-08T22:38:29.976918Z",
+        "retirement_candidate": true,
+        "retirement_reason": "no measured usage in review window"
+      },
+      {
+        "interface": {
+          "id": "ed6451c9-d2cc-4486-9afe-d3852782cabc",
+          "interface_key": "rest_api:POST /workstreams/",
+          "interface_kind": "rest_api",
+          "legacy_since": "2026-06-04T07:40:24.168535Z",
+          "replacement_ref": "/workplans/",
+          "owner_component": "state-hub.api",
+          "status": "legacy",
+          "replacement_verified": true,
+          "manual_hold": false,
+          "hold_reason": null,
+          "notes": null,
+          "retired_at": null,
+          "created_at": "2026-06-04T07:40:24.168535Z",
+          "updated_at": "2026-06-04T07:40:24.168535Z"
+        },
+        "all_time": {
+          "calls": 824,
+          "tenant_count": 1,
+          "user_count": 1,
+          "component_count": 1,
+          "tenants": {
+            "unknown": 824
+          },
+          "users": {
+            "unknown": 824
+          },
+          "components": {
+            "unknown": 824
+          }
+        },
+        "window": {
+          "calls": 0,
+          "tenant_count": 0,
+          "user_count": 0,
+          "component_count": 0,
+          "tenants": {},
+          "users": {},
+          "components": {}
+        },
+        "last_seen_at": "2026-07-08T20:38:05.903144Z",
+        "retirement_candidate": true,
+        "retirement_reason": "no measured usage in review window"
+      },
+      {
+        "interface": {
+          "id": "281fd706-b192-4194-8055-2d8733c115f9",
+          "interface_key": "rest_api:POST /workstreams/{workstream_id}/dependencies/",
+          "interface_kind": "rest_api",
+          "legacy_since": "2026-06-04T22:57:37.149207Z",
+          "replacement_ref": "/workplans/{workplan_id}/dependencies/",
+          "owner_component": "state-hub.api",
+          "status": "legacy",
+          "replacement_verified": true,
+          "manual_hold": false,
+          "hold_reason": null,
+          "notes": null,
+          "retired_at": null,
+          "created_at": "2026-06-04T22:57:37.149207Z",
+          "updated_at": "2026-06-04T22:57:37.149207Z"
+        },
+        "all_time": {
+          "calls": 4971,
+          "tenant_count": 1,
+          "user_count": 1,
+          "component_count": 1,
+          "tenants": {
+            "unknown": 4971
+          },
+          "users": {
+            "unknown": 4971
+          },
+          "components": {
+            "unknown": 4971
+          }
+        },
+        "window": {
+          "calls": 0,
+          "tenant_count": 0,
+          "user_count": 0,
+          "component_count": 0,
+          "tenants": {},
+          "users": {},
+          "components": {}
+        },
+        "last_seen_at": "2026-07-01T22:09:24.229011Z",
+        "retirement_candidate": true,
+        "retirement_reason": "no measured usage in review window"
+      }
+    ]
+  },
+  "hours": 8
+}
diff --git a/docs/evidence/legacy-meter-weekly-review-20260820.json b/docs/evidence/legacy-meter-weekly-review-20260820.json
new file mode 100644
index 0000000..c3d596a
--- /dev/null
+++ b/docs/evidence/legacy-meter-weekly-review-20260820.json
@@ -0,0 +1,917 @@
+{
+  "captured_at": "2026-08-20T14:00:08.638290+00:00",
+  "api_base": "http://127.0.0.1:8000",
+  "workplan": "STATE-WP-0070",
+  "retired_interfaces": [],
+  "weekly_review": {
+    "generated_at": "2026-08-20T14:00:08.633195Z",
+    "window_start": "2026-08-13T14:00:08.555948Z",
+    "window_end": "2026-08-20T14:00:08.555948Z",
+    "cadence": "weekly",
+    "activity_core_handoff": {
+      "activity_id": "statehub-legacy-interface-review",
+      "cadence": "weekly",
+      "source_endpoint": "/legacy-meter/weekly-review",
+      "state_owner": "state-hub",
+      "scheduler_owner": "activity-core"
+    },
+    "interfaces": [
+      {
+        "interface": {
+          "id": "8051fb40-66c9-4dc4-a413-13e8573e04a3",
+          "interface_key": "event_subject:org.statehub.workstream.completed",
+          "interface_kind": "event_subject",
+          "legacy_since": "2026-06-04T06:09:42.198193Z",
+          "replacement_ref": "org.statehub.workplan.completed",
+          "owner_component": "state-hub.events",
+          "status": "retired",
+          "replacement_verified": true,
+          "manual_hold": false,
+          "hold_reason": null,
+          "notes": "Retired by STATE-WP-0069 closeout",
+          "retired_at": "2026-07-08T21:38:52.773601Z",
+          "created_at": "2026-06-04T06:09:42.198193Z",
+          "updated_at": "2026-07-08T21:38:52.761243Z"
+        },
+        "all_time": {
+          "calls": 255,
+          "tenant_count": 1,
+          "user_count": 1,
+          "component_count": 1,
+          "tenants": {
+            "unknown": 255
+          },
+          "users": {
+            "unknown": 255
+          },
+          "components": {
+            "state-hub.events": 255
+          }
+        },
+        "window": {
+          "calls": 0,
+          "tenant_count": 0,
+          "user_count": 0,
+          "component_count": 0,
+          "tenants": {},
+          "users": {},
+          "components": {}
+        },
+        "last_seen_at": "2026-07-08T20:49:12.839383Z",
+        "retirement_candidate": false,
+        "retirement_reason": "already retired"
+      },
+      {
+        "interface": {
+          "id": "63ed90e3-42b4-431a-94db-e1254a52f9e2",
+          "interface_key": "mcp:create_workstream",
+          "interface_kind": "mcp_tool",
+          "legacy_since": "2026-07-10T13:19:44.205900Z",
+          "replacement_ref": "create_workplan",
+          "owner_component": "state-hub.mcp",
+          "status": "retired",
+          "replacement_verified": true,
+          "manual_hold": false,
+          "hold_reason": null,
+          "notes": "Retired by STATE-WP-0079-T05 (cutover slice E2); evidence: 7d review window + volume-scaled quiet ladder, capture 2026-08-20",
+          "retired_at": "2026-08-20T05:27:19.851030Z",
+          "created_at": "2026-07-10T13:19:44.205900Z",
+          "updated_at": "2026-08-20T05:27:19.844807Z"
+        },
+        "all_time": {
+          "calls": 2,
+          "tenant_count": 1,
+          "user_count": 1,
+          "component_count": 1,
+          "tenants": {
+            "unknown": 2
+          },
+          "users": {
+            "unknown": 2
+          },
+          "components": {
+            "state-hub.mcp": 2
+          }
+        },
+        "window": {
+          "calls": 0,
+          "tenant_count": 0,
+          "user_count": 0,
+          "component_count": 0,
+          "tenants": {},
+          "users": {},
+          "components": {}
+        },
+        "last_seen_at": "2026-07-10T13:20:43.378546Z",
+        "retirement_candidate": false,
+        "retirement_reason": "already retired"
+      },
+      {
+        "interface": {
+          "id": "b6a5fe44-fb85-4ef7-a273-78d09da777af",
+          "interface_key": "mcp:list_workstreams",
+          "interface_kind": "mcp_tool",
+          "legacy_since": "2026-07-10T13:19:26.075491Z",
+          "replacement_ref": "list_workplans",
+          "owner_component": "state-hub.mcp",
+          "status": "retired",
+          "replacement_verified": true,
+          "manual_hold": false,
+          "hold_reason": null,
+          "notes": "Retired by STATE-WP-0079-T05 (cutover slice E2); evidence: 7d review window + volume-scaled quiet ladder, capture 2026-08-20",
+          "retired_at": "2026-08-20T05:27:19.883196Z",
+          "created_at": "2026-07-10T13:19:26.075491Z",
+          "updated_at": "2026-08-20T05:27:19.876635Z"
+        },
+        "all_time": {
+          "calls": 2,
+          "tenant_count": 1,
+          "user_count": 1,
+          "component_count": 1,
+          "tenants": {
+            "unknown": 2
+          },
+          "users": {
+            "unknown": 2
+          },
+          "components": {
+            "state-hub.mcp": 2
+          }
+        },
+        "window": {
+          "calls": 0,
+          "tenant_count": 0,
+          "user_count": 0,
+          "component_count": 0,
+          "tenants": {},
+          "users": {},
+          "components": {}
+        },
+        "last_seen_at": "2026-07-10T13:20:42.374940Z",
+        "retirement_candidate": false,
+        "retirement_reason": "already retired"
+      },
+      {
+        "interface": {
+          "id": "53c3372b-307d-4d6a-8ea4-bc36cacdcaf2",
+          "interface_key": "mcp:update_workstream",
+          "interface_kind": "mcp_tool",
+          "legacy_since": "2026-07-10T13:19:44.255216Z",
+          "replacement_ref": "update_workplan",
+          "owner_component": "state-hub.mcp",
+          "status": "retired",
+          "replacement_verified": true,
+          "manual_hold": false,
+          "hold_reason": null,
+          "notes": "Retired by STATE-WP-0079-T05 (cutover slice E2); evidence: 7d review window + volume-scaled quiet ladder, capture 2026-08-20",
+          "retired_at": "2026-08-20T05:27:19.907081Z",
+          "created_at": "2026-07-10T13:19:44.255216Z",
+          "updated_at": "2026-08-20T05:27:19.902177Z"
+        },
+        "all_time": {
+          "calls": 0,
+          "tenant_count": 0,
+          "user_count": 0,
+          "component_count": 0,
+          "tenants": {},
+          "users": {},
+          "components": {}
+        },
+        "window": {
+          "calls": 0,
+          "tenant_count": 0,
+          "user_count": 0,
+          "component_count": 0,
+          "tenants": {},
+          "users": {},
+          "components": {}
+        },
+        "last_seen_at": null,
+        "retirement_candidate": false,
+        "retirement_reason": "already retired"
+      },
+      {
+        "interface": {
+          "id": "bed4d08a-3471-48f5-9f0e-f9d550383a26",
+          "interface_key": "mcp:update_workstream_status",
+          "interface_kind": "mcp_tool",
+          "legacy_since": "2026-07-10T13:19:44.303612Z",
+          "replacement_ref": "update_workplan_status",
+          "owner_component": "state-hub.mcp",
+          "status": "retired",
+          "replacement_verified": true,
+          "manual_hold": false,
+          "hold_reason": null,
+          "notes": "Retired by STATE-WP-0079-T05 (cutover slice E2); evidence: 7d review window + volume-scaled quiet ladder, capture 2026-08-20",
+          "retired_at": "2026-08-20T05:27:19.928988Z",
+          "created_at": "2026-07-10T13:19:44.303612Z",
+          "updated_at": "2026-08-20T05:27:19.925652Z"
+        },
+        "all_time": {
+          "calls": 0,
+          "tenant_count": 0,
+          "user_count": 0,
+          "component_count": 0,
+          "tenants": {},
+          "users": {},
+          "components": {}
+        },
+        "window": {
+          "calls": 0,
+          "tenant_count": 0,
+          "user_count": 0,
+          "component_count": 0,
+          "tenants": {},
+          "users": {},
+          "components": {}
+        },
+        "last_seen_at": null,
+        "retirement_candidate": false,
+        "retirement_reason": "already retired"
+      },
+      {
+        "interface": {
+          "id": "46900dc2-0893-405b-ba59-80f31fb6ebb1",
+          "interface_key": "state://workstreams/{topic_slug}",
+          "interface_kind": "mcp_tool",
+          "legacy_since": "2026-07-10T13:19:44.344493Z",
+          "replacement_ref": "state://workplans/{topic_slug}",
+          "owner_component": "state-hub.mcp",
+          "status": "retired",
+          "replacement_verified": true,
+          "manual_hold": false,
+          "hold_reason": null,
+          "notes": "Retired by STATE-WP-0079-T05 (cutover slice E2); evidence: 7d review window + volume-scaled quiet ladder, capture 2026-08-20",
+          "retired_at": "2026-08-20T05:27:19.948467Z",
+          "created_at": "2026-07-10T13:19:44.344493Z",
+          "updated_at": "2026-08-20T05:27:19.944874Z"
+        },
+        "all_time": {
+          "calls": 1,
+          "tenant_count": 1,
+          "user_count": 1,
+          "component_count": 1,
+          "tenants": {
+            "unknown": 1
+          },
+          "users": {
+            "unknown": 1
+          },
+          "components": {
+            "state-hub.mcp": 1
+          }
+        },
+        "window": {
+          "calls": 0,
+          "tenant_count": 0,
+          "user_count": 0,
+          "component_count": 0,
+          "tenants": {},
+          "users": {},
+          "components": {}
+        },
+        "last_seen_at": "2026-07-10T13:20:34.491811Z",
+        "retirement_candidate": false,
+        "retirement_reason": "already retired"
+      },
+      {
+        "interface": {
+          "id": "cd9342fd-27e7-4a46-a1be-d41499e106a3",
+          "interface_key": "rest_api:DELETE /workstreams/{workstream_id}",
+          "interface_kind": "rest_api",
+          "legacy_since": "2026-06-06T17:28:13.052813Z",
+          "replacement_ref": "/workplans/{workplan_id}",
+          "owner_component": "state-hub.api",
+          "status": "retired",
+          "replacement_verified": true,
+          "manual_hold": false,
+          "hold_reason": null,
+          "notes": "Retired by STATE-WP-0079-T05 (cutover slice E2); evidence: 7d review window + volume-scaled quiet ladder, capture 2026-08-20",
+          "retired_at": "2026-08-20T05:27:19.972086Z",
+          "created_at": "2026-06-06T17:28:13.052813Z",
+          "updated_at": "2026-08-20T05:27:19.966289Z"
+        },
+        "all_time": {
+          "calls": 1,
+          "tenant_count": 1,
+          "user_count": 1,
+          "component_count": 1,
+          "tenants": {
+            "unknown": 1
+          },
+          "users": {
+            "unknown": 1
+          },
+          "components": {
+            "unknown": 1
+          }
+        },
+        "window": {
+          "calls": 0,
+          "tenant_count": 0,
+          "user_count": 0,
+          "component_count": 0,
+          "tenants": {},
+          "users": {},
+          "components": {}
+        },
+        "last_seen_at": "2026-06-06T17:28:13.047529Z",
+        "retirement_candidate": false,
+        "retirement_reason": "already retired"
+      },
+      {
+        "interface": {
+          "id": "a4e0948c-cd4a-461e-8ae2-7fd7b51d04a7",
+          "interface_key": "rest_api:GET /decisions/?workstream_id",
+          "interface_kind": "rest_api",
+          "legacy_since": "2026-07-09T23:07:53.093223Z",
+          "replacement_ref": "/decisions/?workplan_id=<workplan_id>",
+          "owner_component": "state-hub.api",
+          "status": "retired",
+          "replacement_verified": true,
+          "manual_hold": false,
+          "hold_reason": null,
+          "notes": "Retired by STATE-WP-0079-T05 (cutover slice E2); evidence: 7d review window + volume-scaled quiet ladder, capture 2026-08-20",
+          "retired_at": "2026-08-20T05:27:19.996130Z",
+          "created_at": "2026-07-09T23:07:53.093223Z",
+          "updated_at": "2026-08-20T05:27:19.991877Z"
+        },
+        "all_time": {
+          "calls": 1,
+          "tenant_count": 1,
+          "user_count": 1,
+          "component_count": 1,
+          "tenants": {
+            "unknown": 1
+          },
+          "users": {
+            "unknown": 1
+          },
+          "components": {
+            "unknown": 1
+          }
+        },
+        "window": {
+          "calls": 0,
+          "tenant_count": 0,
+          "user_count": 0,
+          "component_count": 0,
+          "tenants": {},
+          "users": {},
+          "components": {}
+        },
+        "last_seen_at": "2026-07-09T23:07:53.083299Z",
+        "retirement_candidate": false,
+        "retirement_reason": "already retired"
+      },
+      {
+        "interface": {
+          "id": "70a9346e-e0ee-42ac-874f-f160580b54dd",
+          "interface_key": "rest_api:GET /progress/?workstream_id",
+          "interface_kind": "rest_api",
+          "legacy_since": "2026-07-13T22:04:03.911449Z",
+          "replacement_ref": "/progress/?workplan_id=<workplan_id>",
+          "owner_component": "state-hub.api",
+          "status": "retired",
+          "replacement_verified": true,
+          "manual_hold": false,
+          "hold_reason": null,
+          "notes": "Retired by STATE-WP-0079-T05 (cutover slice E2); evidence: 7d review window + volume-scaled quiet ladder, capture 2026-08-20",
+          "retired_at": "2026-08-20T05:27:20.017065Z",
+          "created_at": "2026-07-13T22:04:03.911449Z",
+          "updated_at": "2026-08-20T05:27:20.013500Z"
+        },
+        "all_time": {
+          "calls": 2,
+          "tenant_count": 1,
+          "user_count": 1,
+          "component_count": 1,
+          "tenants": {
+            "unknown": 2
+          },
+          "users": {
+            "unknown": 2
+          },
+          "components": {
+            "unknown": 2
+          }
+        },
+        "window": {
+          "calls": 0,
+          "tenant_count": 0,
+          "user_count": 0,
+          "component_count": 0,
+          "tenants": {},
+          "users": {},
+          "components": {}
+        },
+        "last_seen_at": "2026-08-12T08:55:33.912995Z",
+        "retirement_candidate": false,
+        "retirement_reason": "already retired"
+      },
+      {
+        "interface": {
+          "id": "be3cdcf8-250b-4bf0-801f-02ffd5f57e00",
+          "interface_key": "rest_api:GET /tasks/?workstream_id",
+          "interface_kind": "rest_api",
+          "legacy_since": "2026-07-08T19:32:21.628513Z",
+          "replacement_ref": "/tasks/?workplan_id=<workplan_id>",
+          "owner_component": "state-hub.api",
+          "status": "legacy",
+          "replacement_verified": true,
+          "manual_hold": false,
+          "hold_reason": null,
+          "notes": null,
+          "retired_at": null,
+          "created_at": "2026-07-08T19:32:21.628513Z",
+          "updated_at": "2026-07-08T19:32:21.628513Z"
+        },
+        "all_time": {
+          "calls": 595,
+          "tenant_count": 1,
+          "user_count": 1,
+          "component_count": 1,
+          "tenants": {
+            "unknown": 595
+          },
+          "users": {
+            "unknown": 595
+          },
+          "components": {
+            "unknown": 595
+          }
+        },
+        "window": {
+          "calls": 5,
+          "tenant_count": 1,
+          "user_count": 1,
+          "component_count": 1,
+          "tenants": {
+            "unknown": 5
+          },
+          "users": {
+            "unknown": 5
+          },
+          "components": {
+            "unknown": 5
+          }
+        },
+        "last_seen_at": "2026-08-19T21:18:17.899446Z",
+        "retirement_candidate": false,
+        "retirement_reason": "5 call(s) in review window"
+      },
+      {
+        "interface": {
+          "id": "3e4a3d0b-08fa-45c3-91e2-4f514a914b97",
+          "interface_key": "rest_api:GET /workstreams/",
+          "interface_kind": "rest_api",
+          "legacy_since": "2026-06-04T00:26:14.533764Z",
+          "replacement_ref": "/workplans/",
+          "owner_component": "state-hub.api",
+          "status": "legacy",
+          "replacement_verified": true,
+          "manual_hold": false,
+          "hold_reason": null,
+          "notes": null,
+          "retired_at": null,
+          "created_at": "2026-06-04T00:26:14.533764Z",
+          "updated_at": "2026-06-04T00:26:14.533764Z"
+        },
+        "all_time": {
+          "calls": 144086,
+          "tenant_count": 1,
+          "user_count": 1,
+          "component_count": 1,
+          "tenants": {
+            "unknown": 144086
+          },
+          "users": {
+            "unknown": 144086
+          },
+          "components": {
+            "unknown": 144086
+          }
+        },
+        "window": {
+          "calls": 0,
+          "tenant_count": 0,
+          "user_count": 0,
+          "component_count": 0,
+          "tenants": {},
+          "users": {},
+          "components": {}
+        },
+        "last_seen_at": "2026-08-10T18:06:05.032338Z",
+        "retirement_candidate": false,
+        "retirement_reason": "quiet 9d of 60d required for 144086 all-time call(s)"
+      },
+      {
+        "interface": {
+          "id": "e4c140ec-7479-46f9-b185-4b533f19d639",
+          "interface_key": "rest_api:GET /workstreams/workplan-index",
+          "interface_kind": "rest_api",
+          "legacy_since": "2026-06-04T05:20:58.321869Z",
+          "replacement_ref": "/workplans/index",
+          "owner_component": "state-hub.api",
+          "status": "retired",
+          "replacement_verified": true,
+          "manual_hold": false,
+          "hold_reason": null,
+          "notes": "Retired by STATE-WP-0079-T05 (cutover slice E2); evidence: 7d review window + volume-scaled quiet ladder, capture 2026-08-20",
+          "retired_at": "2026-08-20T05:27:20.041850Z",
+          "created_at": "2026-06-04T05:20:58.321869Z",
+          "updated_at": "2026-08-20T05:27:20.035160Z"
+        },
+        "all_time": {
+          "calls": 30,
+          "tenant_count": 1,
+          "user_count": 1,
+          "component_count": 1,
+          "tenants": {
+            "unknown": 30
+          },
+          "users": {
+            "unknown": 30
+          },
+          "components": {
+            "unknown": 30
+          }
+        },
+        "window": {
+          "calls": 0,
+          "tenant_count": 0,
+          "user_count": 0,
+          "component_count": 0,
+          "tenants": {},
+          "users": {},
+          "components": {}
+        },
+        "last_seen_at": "2026-07-03T05:20:34.534439Z",
+        "retirement_candidate": false,
+        "retirement_reason": "already retired"
+      },
+      {
+        "interface": {
+          "id": "3a00b19e-e7db-4403-98aa-a77c9ab61ecc",
+          "interface_key": "rest_api:GET /workstreams/{workstream_id}",
+          "interface_kind": "rest_api",
+          "legacy_since": "2026-06-04T00:25:59.014966Z",
+          "replacement_ref": "/workplans/{workplan_id}",
+          "owner_component": "state-hub.api",
+          "status": "legacy",
+          "replacement_verified": true,
+          "manual_hold": false,
+          "hold_reason": null,
+          "notes": null,
+          "retired_at": null,
+          "created_at": "2026-06-04T00:25:59.014966Z",
+          "updated_at": "2026-06-04T00:25:59.014966Z"
+        },
+        "all_time": {
+          "calls": 511406,
+          "tenant_count": 1,
+          "user_count": 1,
+          "component_count": 1,
+          "tenants": {
+            "unknown": 511406
+          },
+          "users": {
+            "unknown": 511406
+          },
+          "components": {
+            "unknown": 511406
+          }
+        },
+        "window": {
+          "calls": 0,
+          "tenant_count": 0,
+          "user_count": 0,
+          "component_count": 0,
+          "tenants": {},
+          "users": {},
+          "components": {}
+        },
+        "last_seen_at": "2026-07-31T16:25:32.004042Z",
+        "retirement_candidate": false,
+        "retirement_reason": "quiet 19d of 60d required for 511406 all-time call(s)"
+      },
+      {
+        "interface": {
+          "id": "69e1a255-a8b9-4101-8a68-b1bed23abfda",
+          "interface_key": "rest_api:GET /workstreams/{workstream_id}/dependencies/",
+          "interface_kind": "rest_api",
+          "legacy_since": "2026-06-04T00:25:59.291135Z",
+          "replacement_ref": "/workplans/{workplan_id}/dependencies/",
+          "owner_component": "state-hub.api",
+          "status": "legacy",
+          "replacement_verified": true,
+          "manual_hold": false,
+          "hold_reason": null,
+          "notes": null,
+          "retired_at": null,
+          "created_at": "2026-06-04T00:25:59.291135Z",
+          "updated_at": "2026-06-04T00:25:59.291135Z"
+        },
+        "all_time": {
+          "calls": 255865,
+          "tenant_count": 1,
+          "user_count": 1,
+          "component_count": 1,
+          "tenants": {
+            "unknown": 255865
+          },
+          "users": {
+            "unknown": 255865
+          },
+          "components": {
+            "unknown": 255865
+          }
+        },
+        "window": {
+          "calls": 0,
+          "tenant_count": 0,
+          "user_count": 0,
+          "component_count": 0,
+          "tenants": {},
+          "users": {},
+          "components": {}
+        },
+        "last_seen_at": "2026-07-08T21:14:12.747005Z",
+        "retirement_candidate": false,
+        "retirement_reason": "quiet 42d of 60d required for 255865 all-time call(s)"
+      },
+      {
+        "interface": {
+          "id": "b1aae931-b51f-4a85-a723-865dd65f6132",
+          "interface_key": "rest_api:PATCH /workstreams/{workstream_id}",
+          "interface_kind": "rest_api",
+          "legacy_since": "2026-06-04T06:09:41.901035Z",
+          "replacement_ref": "/workplans/{workplan_id}",
+          "owner_component": "state-hub.api",
+          "status": "retired",
+          "replacement_verified": true,
+          "manual_hold": false,
+          "hold_reason": null,
+          "notes": "Retired by STATE-WP-0079-T05 (cutover slice E2); evidence: 7d review window + volume-scaled quiet ladder, capture 2026-08-20",
+          "retired_at": "2026-08-20T05:27:20.069758Z",
+          "created_at": "2026-06-04T06:09:41.901035Z",
+          "updated_at": "2026-08-20T05:27:20.062648Z"
+        },
+        "all_time": {
+          "calls": 571,
+          "tenant_count": 1,
+          "user_count": 1,
+          "component_count": 1,
+          "tenants": {
+            "unknown": 571
+          },
+          "users": {
+            "unknown": 571
+          },
+          "components": {
+            "unknown": 571
+          }
+        },
+        "window": {
+          "calls": 0,
+          "tenant_count": 0,
+          "user_count": 0,
+          "component_count": 0,
+          "tenants": {},
+          "users": {},
+          "components": {}
+        },
+        "last_seen_at": "2026-07-08T20:49:12.335710Z",
+        "retirement_candidate": false,
+        "retirement_reason": "already retired"
+      },
+      {
+        "interface": {
+          "id": "4aea9591-970b-4918-ac4a-4da95a0a1a8c",
+          "interface_key": "rest_api:POST /decisions/ workstream_id",
+          "interface_kind": "rest_api",
+          "legacy_since": "2026-07-09T22:56:35.473130Z",
+          "replacement_ref": "POST /decisions/ with workplan_id",
+          "owner_component": "state-hub.api",
+          "status": "retired",
+          "replacement_verified": true,
+          "manual_hold": false,
+          "hold_reason": null,
+          "notes": "Retired by STATE-WP-0079-T05 (cutover slice E2); evidence: 7d review window + volume-scaled quiet ladder, capture 2026-08-20",
+          "retired_at": "2026-08-20T05:27:20.093372Z",
+          "created_at": "2026-07-09T22:56:35.473130Z",
+          "updated_at": "2026-08-20T05:27:20.090180Z"
+        },
+        "all_time": {
+          "calls": 3,
+          "tenant_count": 1,
+          "user_count": 1,
+          "component_count": 1,
+          "tenants": {
+            "unknown": 3
+          },
+          "users": {
+            "unknown": 3
+          },
+          "components": {
+            "unknown": 3
+          }
+        },
+        "window": {
+          "calls": 0,
+          "tenant_count": 0,
+          "user_count": 0,
+          "component_count": 0,
+          "tenants": {},
+          "users": {},
+          "components": {}
+        },
+        "last_seen_at": "2026-07-09T22:57:05.912456Z",
+        "retirement_candidate": false,
+        "retirement_reason": "already retired"
+      },
+      {
+        "interface": {
+          "id": "4a70583c-1e41-4ec1-99a9-728856a7d79c",
+          "interface_key": "rest_api:POST /progress/ workstream_id",
+          "interface_kind": "rest_api",
+          "legacy_since": "2026-07-08T23:35:09.148333Z",
+          "replacement_ref": "POST /progress/ with workplan_id",
+          "owner_component": "state-hub.api",
+          "status": "retired",
+          "replacement_verified": true,
+          "manual_hold": false,
+          "hold_reason": null,
+          "notes": "Retired by STATE-WP-0079-T05 (cutover slice E2); evidence: 7d review window + volume-scaled quiet ladder, capture 2026-08-20",
+          "retired_at": "2026-08-20T05:27:20.114395Z",
+          "created_at": "2026-07-08T23:35:09.148333Z",
+          "updated_at": "2026-08-20T05:27:20.110090Z"
+        },
+        "all_time": {
+          "calls": 14,
+          "tenant_count": 1,
+          "user_count": 1,
+          "component_count": 1,
+          "tenants": {
+            "unknown": 14
+          },
+          "users": {
+            "unknown": 14
+          },
+          "components": {
+            "unknown": 14
+          }
+        },
+        "window": {
+          "calls": 0,
+          "tenant_count": 0,
+          "user_count": 0,
+          "component_count": 0,
+          "tenants": {},
+          "users": {},
+          "components": {}
+        },
+        "last_seen_at": "2026-07-10T08:34:42.959724Z",
+        "retirement_candidate": false,
+        "retirement_reason": "already retired"
+      },
+      {
+        "interface": {
+          "id": "6df4e443-7bf1-461a-923b-a6eb52fe7b07",
+          "interface_key": "rest_api:POST /tasks/ workstream_id",
+          "interface_kind": "rest_api",
+          "legacy_since": "2026-07-08T22:38:29.405720Z",
+          "replacement_ref": "POST /tasks/ with workplan_id",
+          "owner_component": "state-hub.api",
+          "status": "retired",
+          "replacement_verified": true,
+          "manual_hold": false,
+          "hold_reason": null,
+          "notes": "Retired by STATE-WP-0079-T05 (cutover slice E2); evidence: 7d review window + volume-scaled quiet ladder, capture 2026-08-20",
+          "retired_at": "2026-08-20T05:27:20.134796Z",
+          "created_at": "2026-07-08T22:38:29.405720Z",
+          "updated_at": "2026-08-20T05:27:20.131430Z"
+        },
+        "all_time": {
+          "calls": 5,
+          "tenant_count": 1,
+          "user_count": 1,
+          "component_count": 1,
+          "tenants": {
+            "unknown": 5
+          },
+          "users": {
+            "unknown": 5
+          },
+          "components": {
+            "state-hub.fix-consistency": 5
+          }
+        },
+        "window": {
+          "calls": 0,
+          "tenant_count": 0,
+          "user_count": 0,
+          "component_count": 0,
+          "tenants": {},
+          "users": {},
+          "components": {}
+        },
+        "last_seen_at": "2026-07-08T22:38:29.976918Z",
+        "retirement_candidate": false,
+        "retirement_reason": "already retired"
+      },
+      {
+        "interface": {
+          "id": "ed6451c9-d2cc-4486-9afe-d3852782cabc",
+          "interface_key": "rest_api:POST /workstreams/",
+          "interface_kind": "rest_api",
+          "legacy_since": "2026-06-04T07:40:24.168535Z",
+          "replacement_ref": "/workplans/",
+          "owner_component": "state-hub.api",
+          "status": "retired",
+          "replacement_verified": true,
+          "manual_hold": false,
+          "hold_reason": null,
+          "notes": "Retired by STATE-WP-0079-T05 (cutover slice E2); evidence: 7d review window + volume-scaled quiet ladder, capture 2026-08-20",
+          "retired_at": "2026-08-20T05:27:20.157133Z",
+          "created_at": "2026-06-04T07:40:24.168535Z",
+          "updated_at": "2026-08-20T05:27:20.150639Z"
+        },
+        "all_time": {
+          "calls": 824,
+          "tenant_count": 1,
+          "user_count": 1,
+          "component_count": 1,
+          "tenants": {
+            "unknown": 824
+          },
+          "users": {
+            "unknown": 824
+          },
+          "components": {
+            "unknown": 824
+          }
+        },
+        "window": {
+          "calls": 0,
+          "tenant_count": 0,
+          "user_count": 0,
+          "component_count": 0,
+          "tenants": {},
+          "users": {},
+          "components": {}
+        },
+        "last_seen_at": "2026-07-08T20:38:05.903144Z",
+        "retirement_candidate": false,
+        "retirement_reason": "already retired"
+      },
+      {
+        "interface": {
+          "id": "281fd706-b192-4194-8055-2d8733c115f9",
+          "interface_key": "rest_api:POST /workstreams/{workstream_id}/dependencies/",
+          "interface_kind": "rest_api",
+          "legacy_since": "2026-06-04T22:57:37.149207Z",
+          "replacement_ref": "/workplans/{workplan_id}/dependencies/",
+          "owner_component": "state-hub.api",
+          "status": "retired",
+          "replacement_verified": true,
+          "manual_hold": false,
+          "hold_reason": null,
+          "notes": "Retired by STATE-WP-0079-T05 (cutover slice E2); evidence: 7d review window + volume-scaled quiet ladder, capture 2026-08-20",
+          "retired_at": "2026-08-20T05:27:20.186201Z",
+          "created_at": "2026-06-04T22:57:37.149207Z",
+          "updated_at": "2026-08-20T05:27:20.181406Z"
+        },
+        "all_time": {
+          "calls": 4971,
+          "tenant_count": 1,
+          "user_count": 1,
+          "component_count": 1,
+          "tenants": {
+            "unknown": 4971
+          },
+          "users": {
+            "unknown": 4971
+          },
+          "components": {
+            "unknown": 4971
+          }
+        },
+        "window": {
+          "calls": 0,
+          "tenant_count": 0,
+          "user_count": 0,
+          "component_count": 0,
+          "tenants": {},
+          "users": {},
+          "components": {}
+        },
+        "last_seen_at": "2026-07-01T22:09:24.229011Z",
+        "retirement_candidate": false,
+        "retirement_reason": "already retired"
+      }
+    ],
+    "retirement_candidates": []
+  },
+  "days": 7
+}
diff --git a/docs/evidence/legacy-meter-weekly-review-20260821.json b/docs/evidence/legacy-meter-weekly-review-20260821.json
new file mode 100644
index 0000000..19c3cd3
--- /dev/null
+++ b/docs/evidence/legacy-meter-weekly-review-20260821.json
@@ -0,0 +1,923 @@
+{
+  "captured_at": "2026-08-21T14:00:07.456038+00:00",
+  "api_base": "http://127.0.0.1:8000",
+  "workplan": "STATE-WP-0070",
+  "retired_interfaces": [],
+  "weekly_review": {
+    "generated_at": "2026-08-21T14:00:07.450639Z",
+    "window_start": "2026-08-14T14:00:07.390852Z",
+    "window_end": "2026-08-21T14:00:07.390852Z",
+    "cadence": "weekly",
+    "activity_core_handoff": {
+      "activity_id": "statehub-legacy-interface-review",
+      "cadence": "weekly",
+      "source_endpoint": "/legacy-meter/weekly-review",
+      "state_owner": "state-hub",
+      "scheduler_owner": "activity-core"
+    },
+    "interfaces": [
+      {
+        "interface": {
+          "id": "8051fb40-66c9-4dc4-a413-13e8573e04a3",
+          "interface_key": "event_subject:org.statehub.workstream.completed",
+          "interface_kind": "event_subject",
+          "legacy_since": "2026-06-04T06:09:42.198193Z",
+          "replacement_ref": "org.statehub.workplan.completed",
+          "owner_component": "state-hub.events",
+          "status": "retired",
+          "replacement_verified": true,
+          "manual_hold": false,
+          "hold_reason": null,
+          "notes": "Retired by STATE-WP-0069 closeout",
+          "retired_at": "2026-07-08T21:38:52.773601Z",
+          "created_at": "2026-06-04T06:09:42.198193Z",
+          "updated_at": "2026-07-08T21:38:52.761243Z"
+        },
+        "all_time": {
+          "calls": 255,
+          "tenant_count": 1,
+          "user_count": 1,
+          "component_count": 1,
+          "tenants": {
+            "unknown": 255
+          },
+          "users": {
+            "unknown": 255
+          },
+          "components": {
+            "state-hub.events": 255
+          }
+        },
+        "window": {
+          "calls": 0,
+          "tenant_count": 0,
+          "user_count": 0,
+          "component_count": 0,
+          "tenants": {},
+          "users": {},
+          "components": {}
+        },
+        "last_seen_at": "2026-07-08T20:49:12.839383Z",
+        "retirement_candidate": false,
+        "retirement_reason": "already retired"
+      },
+      {
+        "interface": {
+          "id": "63ed90e3-42b4-431a-94db-e1254a52f9e2",
+          "interface_key": "mcp:create_workstream",
+          "interface_kind": "mcp_tool",
+          "legacy_since": "2026-07-10T13:19:44.205900Z",
+          "replacement_ref": "create_workplan",
+          "owner_component": "state-hub.mcp",
+          "status": "retired",
+          "replacement_verified": true,
+          "manual_hold": false,
+          "hold_reason": null,
+          "notes": "Retired by STATE-WP-0079-T05 (cutover slice E2); evidence: 7d review window + volume-scaled quiet ladder, capture 2026-08-20",
+          "retired_at": "2026-08-20T05:27:19.851030Z",
+          "created_at": "2026-07-10T13:19:44.205900Z",
+          "updated_at": "2026-08-20T05:27:19.844807Z"
+        },
+        "all_time": {
+          "calls": 2,
+          "tenant_count": 1,
+          "user_count": 1,
+          "component_count": 1,
+          "tenants": {
+            "unknown": 2
+          },
+          "users": {
+            "unknown": 2
+          },
+          "components": {
+            "state-hub.mcp": 2
+          }
+        },
+        "window": {
+          "calls": 0,
+          "tenant_count": 0,
+          "user_count": 0,
+          "component_count": 0,
+          "tenants": {},
+          "users": {},
+          "components": {}
+        },
+        "last_seen_at": "2026-07-10T13:20:43.378546Z",
+        "retirement_candidate": false,
+        "retirement_reason": "already retired"
+      },
+      {
+        "interface": {
+          "id": "b6a5fe44-fb85-4ef7-a273-78d09da777af",
+          "interface_key": "mcp:list_workstreams",
+          "interface_kind": "mcp_tool",
+          "legacy_since": "2026-07-10T13:19:26.075491Z",
+          "replacement_ref": "list_workplans",
+          "owner_component": "state-hub.mcp",
+          "status": "retired",
+          "replacement_verified": true,
+          "manual_hold": false,
+          "hold_reason": null,
+          "notes": "Retired by STATE-WP-0079-T05 (cutover slice E2); evidence: 7d review window + volume-scaled quiet ladder, capture 2026-08-20",
+          "retired_at": "2026-08-20T05:27:19.883196Z",
+          "created_at": "2026-07-10T13:19:26.075491Z",
+          "updated_at": "2026-08-20T05:27:19.876635Z"
+        },
+        "all_time": {
+          "calls": 2,
+          "tenant_count": 1,
+          "user_count": 1,
+          "component_count": 1,
+          "tenants": {
+            "unknown": 2
+          },
+          "users": {
+            "unknown": 2
+          },
+          "components": {
+            "state-hub.mcp": 2
+          }
+        },
+        "window": {
+          "calls": 0,
+          "tenant_count": 0,
+          "user_count": 0,
+          "component_count": 0,
+          "tenants": {},
+          "users": {},
+          "components": {}
+        },
+        "last_seen_at": "2026-07-10T13:20:42.374940Z",
+        "retirement_candidate": false,
+        "retirement_reason": "already retired"
+      },
+      {
+        "interface": {
+          "id": "53c3372b-307d-4d6a-8ea4-bc36cacdcaf2",
+          "interface_key": "mcp:update_workstream",
+          "interface_kind": "mcp_tool",
+          "legacy_since": "2026-07-10T13:19:44.255216Z",
+          "replacement_ref": "update_workplan",
+          "owner_component": "state-hub.mcp",
+          "status": "retired",
+          "replacement_verified": true,
+          "manual_hold": false,
+          "hold_reason": null,
+          "notes": "Retired by STATE-WP-0079-T05 (cutover slice E2); evidence: 7d review window + volume-scaled quiet ladder, capture 2026-08-20",
+          "retired_at": "2026-08-20T05:27:19.907081Z",
+          "created_at": "2026-07-10T13:19:44.255216Z",
+          "updated_at": "2026-08-20T05:27:19.902177Z"
+        },
+        "all_time": {
+          "calls": 0,
+          "tenant_count": 0,
+          "user_count": 0,
+          "component_count": 0,
+          "tenants": {},
+          "users": {},
+          "components": {}
+        },
+        "window": {
+          "calls": 0,
+          "tenant_count": 0,
+          "user_count": 0,
+          "component_count": 0,
+          "tenants": {},
+          "users": {},
+          "components": {}
+        },
+        "last_seen_at": null,
+        "retirement_candidate": false,
+        "retirement_reason": "already retired"
+      },
+      {
+        "interface": {
+          "id": "bed4d08a-3471-48f5-9f0e-f9d550383a26",
+          "interface_key": "mcp:update_workstream_status",
+          "interface_kind": "mcp_tool",
+          "legacy_since": "2026-07-10T13:19:44.303612Z",
+          "replacement_ref": "update_workplan_status",
+          "owner_component": "state-hub.mcp",
+          "status": "retired",
+          "replacement_verified": true,
+          "manual_hold": false,
+          "hold_reason": null,
+          "notes": "Retired by STATE-WP-0079-T05 (cutover slice E2); evidence: 7d review window + volume-scaled quiet ladder, capture 2026-08-20",
+          "retired_at": "2026-08-20T05:27:19.928988Z",
+          "created_at": "2026-07-10T13:19:44.303612Z",
+          "updated_at": "2026-08-20T05:27:19.925652Z"
+        },
+        "all_time": {
+          "calls": 0,
+          "tenant_count": 0,
+          "user_count": 0,
+          "component_count": 0,
+          "tenants": {},
+          "users": {},
+          "components": {}
+        },
+        "window": {
+          "calls": 0,
+          "tenant_count": 0,
+          "user_count": 0,
+          "component_count": 0,
+          "tenants": {},
+          "users": {},
+          "components": {}
+        },
+        "last_seen_at": null,
+        "retirement_candidate": false,
+        "retirement_reason": "already retired"
+      },
+      {
+        "interface": {
+          "id": "46900dc2-0893-405b-ba59-80f31fb6ebb1",
+          "interface_key": "state://workstreams/{topic_slug}",
+          "interface_kind": "mcp_tool",
+          "legacy_since": "2026-07-10T13:19:44.344493Z",
+          "replacement_ref": "state://workplans/{topic_slug}",
+          "owner_component": "state-hub.mcp",
+          "status": "retired",
+          "replacement_verified": true,
+          "manual_hold": false,
+          "hold_reason": null,
+          "notes": "Retired by STATE-WP-0079-T05 (cutover slice E2); evidence: 7d review window + volume-scaled quiet ladder, capture 2026-08-20",
+          "retired_at": "2026-08-20T05:27:19.948467Z",
+          "created_at": "2026-07-10T13:19:44.344493Z",
+          "updated_at": "2026-08-20T05:27:19.944874Z"
+        },
+        "all_time": {
+          "calls": 1,
+          "tenant_count": 1,
+          "user_count": 1,
+          "component_count": 1,
+          "tenants": {
+            "unknown": 1
+          },
+          "users": {
+            "unknown": 1
+          },
+          "components": {
+            "state-hub.mcp": 1
+          }
+        },
+        "window": {
+          "calls": 0,
+          "tenant_count": 0,
+          "user_count": 0,
+          "component_count": 0,
+          "tenants": {},
+          "users": {},
+          "components": {}
+        },
+        "last_seen_at": "2026-07-10T13:20:34.491811Z",
+        "retirement_candidate": false,
+        "retirement_reason": "already retired"
+      },
+      {
+        "interface": {
+          "id": "cd9342fd-27e7-4a46-a1be-d41499e106a3",
+          "interface_key": "rest_api:DELETE /workstreams/{workstream_id}",
+          "interface_kind": "rest_api",
+          "legacy_since": "2026-06-06T17:28:13.052813Z",
+          "replacement_ref": "/workplans/{workplan_id}",
+          "owner_component": "state-hub.api",
+          "status": "retired",
+          "replacement_verified": true,
+          "manual_hold": false,
+          "hold_reason": null,
+          "notes": "Retired by STATE-WP-0079-T05 (cutover slice E2); evidence: 7d review window + volume-scaled quiet ladder, capture 2026-08-20",
+          "retired_at": "2026-08-20T05:27:19.972086Z",
+          "created_at": "2026-06-06T17:28:13.052813Z",
+          "updated_at": "2026-08-20T05:27:19.966289Z"
+        },
+        "all_time": {
+          "calls": 1,
+          "tenant_count": 1,
+          "user_count": 1,
+          "component_count": 1,
+          "tenants": {
+            "unknown": 1
+          },
+          "users": {
+            "unknown": 1
+          },
+          "components": {
+            "unknown": 1
+          }
+        },
+        "window": {
+          "calls": 0,
+          "tenant_count": 0,
+          "user_count": 0,
+          "component_count": 0,
+          "tenants": {},
+          "users": {},
+          "components": {}
+        },
+        "last_seen_at": "2026-06-06T17:28:13.047529Z",
+        "retirement_candidate": false,
+        "retirement_reason": "already retired"
+      },
+      {
+        "interface": {
+          "id": "a4e0948c-cd4a-461e-8ae2-7fd7b51d04a7",
+          "interface_key": "rest_api:GET /decisions/?workstream_id",
+          "interface_kind": "rest_api",
+          "legacy_since": "2026-07-09T23:07:53.093223Z",
+          "replacement_ref": "/decisions/?workplan_id=<workplan_id>",
+          "owner_component": "state-hub.api",
+          "status": "retired",
+          "replacement_verified": true,
+          "manual_hold": false,
+          "hold_reason": null,
+          "notes": "Retired by STATE-WP-0079-T05 (cutover slice E2); evidence: 7d review window + volume-scaled quiet ladder, capture 2026-08-20",
+          "retired_at": "2026-08-20T05:27:19.996130Z",
+          "created_at": "2026-07-09T23:07:53.093223Z",
+          "updated_at": "2026-08-20T05:27:19.991877Z"
+        },
+        "all_time": {
+          "calls": 1,
+          "tenant_count": 1,
+          "user_count": 1,
+          "component_count": 1,
+          "tenants": {
+            "unknown": 1
+          },
+          "users": {
+            "unknown": 1
+          },
+          "components": {
+            "unknown": 1
+          }
+        },
+        "window": {
+          "calls": 0,
+          "tenant_count": 0,
+          "user_count": 0,
+          "component_count": 0,
+          "tenants": {},
+          "users": {},
+          "components": {}
+        },
+        "last_seen_at": "2026-07-09T23:07:53.083299Z",
+        "retirement_candidate": false,
+        "retirement_reason": "already retired"
+      },
+      {
+        "interface": {
+          "id": "70a9346e-e0ee-42ac-874f-f160580b54dd",
+          "interface_key": "rest_api:GET /progress/?workstream_id",
+          "interface_kind": "rest_api",
+          "legacy_since": "2026-07-13T22:04:03.911449Z",
+          "replacement_ref": "/progress/?workplan_id=<workplan_id>",
+          "owner_component": "state-hub.api",
+          "status": "retired",
+          "replacement_verified": true,
+          "manual_hold": false,
+          "hold_reason": null,
+          "notes": "Retired by STATE-WP-0079-T05 (cutover slice E2); evidence: 7d review window + volume-scaled quiet ladder, capture 2026-08-20",
+          "retired_at": "2026-08-20T05:27:20.017065Z",
+          "created_at": "2026-07-13T22:04:03.911449Z",
+          "updated_at": "2026-08-20T05:27:20.013500Z"
+        },
+        "all_time": {
+          "calls": 2,
+          "tenant_count": 1,
+          "user_count": 1,
+          "component_count": 1,
+          "tenants": {
+            "unknown": 2
+          },
+          "users": {
+            "unknown": 2
+          },
+          "components": {
+            "unknown": 2
+          }
+        },
+        "window": {
+          "calls": 0,
+          "tenant_count": 0,
+          "user_count": 0,
+          "component_count": 0,
+          "tenants": {},
+          "users": {},
+          "components": {}
+        },
+        "last_seen_at": "2026-08-12T08:55:33.912995Z",
+        "retirement_candidate": false,
+        "retirement_reason": "already retired"
+      },
+      {
+        "interface": {
+          "id": "be3cdcf8-250b-4bf0-801f-02ffd5f57e00",
+          "interface_key": "rest_api:GET /tasks/?workstream_id",
+          "interface_kind": "rest_api",
+          "legacy_since": "2026-07-08T19:32:21.628513Z",
+          "replacement_ref": "/tasks/?workplan_id=<workplan_id>",
+          "owner_component": "state-hub.api",
+          "status": "legacy",
+          "replacement_verified": true,
+          "manual_hold": false,
+          "hold_reason": null,
+          "notes": null,
+          "retired_at": null,
+          "created_at": "2026-07-08T19:32:21.628513Z",
+          "updated_at": "2026-07-08T19:32:21.628513Z"
+        },
+        "all_time": {
+          "calls": 596,
+          "tenant_count": 1,
+          "user_count": 1,
+          "component_count": 1,
+          "tenants": {
+            "unknown": 596
+          },
+          "users": {
+            "unknown": 596
+          },
+          "components": {
+            "unknown": 596
+          }
+        },
+        "window": {
+          "calls": 6,
+          "tenant_count": 1,
+          "user_count": 1,
+          "component_count": 1,
+          "tenants": {
+            "unknown": 6
+          },
+          "users": {
+            "unknown": 6
+          },
+          "components": {
+            "unknown": 6
+          }
+        },
+        "last_seen_at": "2026-08-20T20:57:26.985884Z",
+        "retirement_candidate": false,
+        "retirement_reason": "6 call(s) in review window"
+      },
+      {
+        "interface": {
+          "id": "3e4a3d0b-08fa-45c3-91e2-4f514a914b97",
+          "interface_key": "rest_api:GET /workstreams/",
+          "interface_kind": "rest_api",
+          "legacy_since": "2026-06-04T00:26:14.533764Z",
+          "replacement_ref": "/workplans/",
+          "owner_component": "state-hub.api",
+          "status": "legacy",
+          "replacement_verified": true,
+          "manual_hold": false,
+          "hold_reason": null,
+          "notes": null,
+          "retired_at": null,
+          "created_at": "2026-06-04T00:26:14.533764Z",
+          "updated_at": "2026-06-04T00:26:14.533764Z"
+        },
+        "all_time": {
+          "calls": 144086,
+          "tenant_count": 1,
+          "user_count": 1,
+          "component_count": 1,
+          "tenants": {
+            "unknown": 144086
+          },
+          "users": {
+            "unknown": 144086
+          },
+          "components": {
+            "unknown": 144086
+          }
+        },
+        "window": {
+          "calls": 0,
+          "tenant_count": 0,
+          "user_count": 0,
+          "component_count": 0,
+          "tenants": {},
+          "users": {},
+          "components": {}
+        },
+        "last_seen_at": "2026-08-10T18:06:05.032338Z",
+        "retirement_candidate": false,
+        "retirement_reason": "quiet 10d of 60d required for 144086 all-time call(s)"
+      },
+      {
+        "interface": {
+          "id": "e4c140ec-7479-46f9-b185-4b533f19d639",
+          "interface_key": "rest_api:GET /workstreams/workplan-index",
+          "interface_kind": "rest_api",
+          "legacy_since": "2026-06-04T05:20:58.321869Z",
+          "replacement_ref": "/workplans/index",
+          "owner_component": "state-hub.api",
+          "status": "retired",
+          "replacement_verified": true,
+          "manual_hold": false,
+          "hold_reason": null,
+          "notes": "Retired by STATE-WP-0079-T05 (cutover slice E2); evidence: 7d review window + volume-scaled quiet ladder, capture 2026-08-20",
+          "retired_at": "2026-08-20T05:27:20.041850Z",
+          "created_at": "2026-06-04T05:20:58.321869Z",
+          "updated_at": "2026-08-20T05:27:20.035160Z"
+        },
+        "all_time": {
+          "calls": 30,
+          "tenant_count": 1,
+          "user_count": 1,
+          "component_count": 1,
+          "tenants": {
+            "unknown": 30
+          },
+          "users": {
+            "unknown": 30
+          },
+          "components": {
+            "unknown": 30
+          }
+        },
+        "window": {
+          "calls": 0,
+          "tenant_count": 0,
+          "user_count": 0,
+          "component_count": 0,
+          "tenants": {},
+          "users": {},
+          "components": {}
+        },
+        "last_seen_at": "2026-07-03T05:20:34.534439Z",
+        "retirement_candidate": false,
+        "retirement_reason": "already retired"
+      },
+      {
+        "interface": {
+          "id": "3a00b19e-e7db-4403-98aa-a77c9ab61ecc",
+          "interface_key": "rest_api:GET /workstreams/{workstream_id}",
+          "interface_kind": "rest_api",
+          "legacy_since": "2026-06-04T00:25:59.014966Z",
+          "replacement_ref": "/workplans/{workplan_id}",
+          "owner_component": "state-hub.api",
+          "status": "legacy",
+          "replacement_verified": true,
+          "manual_hold": false,
+          "hold_reason": null,
+          "notes": null,
+          "retired_at": null,
+          "created_at": "2026-06-04T00:25:59.014966Z",
+          "updated_at": "2026-06-04T00:25:59.014966Z"
+        },
+        "all_time": {
+          "calls": 511407,
+          "tenant_count": 1,
+          "user_count": 1,
+          "component_count": 1,
+          "tenants": {
+            "unknown": 511407
+          },
+          "users": {
+            "unknown": 511407
+          },
+          "components": {
+            "unknown": 511407
+          }
+        },
+        "window": {
+          "calls": 1,
+          "tenant_count": 1,
+          "user_count": 1,
+          "component_count": 1,
+          "tenants": {
+            "unknown": 1
+          },
+          "users": {
+            "unknown": 1
+          },
+          "components": {
+            "unknown": 1
+          }
+        },
+        "last_seen_at": "2026-08-20T23:32:31.368781Z",
+        "retirement_candidate": false,
+        "retirement_reason": "1 call(s) in review window"
+      },
+      {
+        "interface": {
+          "id": "69e1a255-a8b9-4101-8a68-b1bed23abfda",
+          "interface_key": "rest_api:GET /workstreams/{workstream_id}/dependencies/",
+          "interface_kind": "rest_api",
+          "legacy_since": "2026-06-04T00:25:59.291135Z",
+          "replacement_ref": "/workplans/{workplan_id}/dependencies/",
+          "owner_component": "state-hub.api",
+          "status": "legacy",
+          "replacement_verified": true,
+          "manual_hold": false,
+          "hold_reason": null,
+          "notes": null,
+          "retired_at": null,
+          "created_at": "2026-06-04T00:25:59.291135Z",
+          "updated_at": "2026-06-04T00:25:59.291135Z"
+        },
+        "all_time": {
+          "calls": 255865,
+          "tenant_count": 1,
+          "user_count": 1,
+          "component_count": 1,
+          "tenants": {
+            "unknown": 255865
+          },
+          "users": {
+            "unknown": 255865
+          },
+          "components": {
+            "unknown": 255865
+          }
+        },
+        "window": {
+          "calls": 0,
+          "tenant_count": 0,
+          "user_count": 0,
+          "component_count": 0,
+          "tenants": {},
+          "users": {},
+          "components": {}
+        },
+        "last_seen_at": "2026-07-08T21:14:12.747005Z",
+        "retirement_candidate": false,
+        "retirement_reason": "quiet 43d of 60d required for 255865 all-time call(s)"
+      },
+      {
+        "interface": {
+          "id": "b1aae931-b51f-4a85-a723-865dd65f6132",
+          "interface_key": "rest_api:PATCH /workstreams/{workstream_id}",
+          "interface_kind": "rest_api",
+          "legacy_since": "2026-06-04T06:09:41.901035Z",
+          "replacement_ref": "/workplans/{workplan_id}",
+          "owner_component": "state-hub.api",
+          "status": "retired",
+          "replacement_verified": true,
+          "manual_hold": false,
+          "hold_reason": null,
+          "notes": "Retired by STATE-WP-0079-T05 (cutover slice E2); evidence: 7d review window + volume-scaled quiet ladder, capture 2026-08-20",
+          "retired_at": "2026-08-20T05:27:20.069758Z",
+          "created_at": "2026-06-04T06:09:41.901035Z",
+          "updated_at": "2026-08-20T05:27:20.062648Z"
+        },
+        "all_time": {
+          "calls": 571,
+          "tenant_count": 1,
+          "user_count": 1,
+          "component_count": 1,
+          "tenants": {
+            "unknown": 571
+          },
+          "users": {
+            "unknown": 571
+          },
+          "components": {
+            "unknown": 571
+          }
+        },
+        "window": {
+          "calls": 0,
+          "tenant_count": 0,
+          "user_count": 0,
+          "component_count": 0,
+          "tenants": {},
+          "users": {},
+          "components": {}
+        },
+        "last_seen_at": "2026-07-08T20:49:12.335710Z",
+        "retirement_candidate": false,
+        "retirement_reason": "already retired"
+      },
+      {
+        "interface": {
+          "id": "4aea9591-970b-4918-ac4a-4da95a0a1a8c",
+          "interface_key": "rest_api:POST /decisions/ workstream_id",
+          "interface_kind": "rest_api",
+          "legacy_since": "2026-07-09T22:56:35.473130Z",
+          "replacement_ref": "POST /decisions/ with workplan_id",
+          "owner_component": "state-hub.api",
+          "status": "retired",
+          "replacement_verified": true,
+          "manual_hold": false,
+          "hold_reason": null,
+          "notes": "Retired by STATE-WP-0079-T05 (cutover slice E2); evidence: 7d review window + volume-scaled quiet ladder, capture 2026-08-20",
+          "retired_at": "2026-08-20T05:27:20.093372Z",
+          "created_at": "2026-07-09T22:56:35.473130Z",
+          "updated_at": "2026-08-20T05:27:20.090180Z"
+        },
+        "all_time": {
+          "calls": 3,
+          "tenant_count": 1,
+          "user_count": 1,
+          "component_count": 1,
+          "tenants": {
+            "unknown": 3
+          },
+          "users": {
+            "unknown": 3
+          },
+          "components": {
+            "unknown": 3
+          }
+        },
+        "window": {
+          "calls": 0,
+          "tenant_count": 0,
+          "user_count": 0,
+          "component_count": 0,
+          "tenants": {},
+          "users": {},
+          "components": {}
+        },
+        "last_seen_at": "2026-07-09T22:57:05.912456Z",
+        "retirement_candidate": false,
+        "retirement_reason": "already retired"
+      },
+      {
+        "interface": {
+          "id": "4a70583c-1e41-4ec1-99a9-728856a7d79c",
+          "interface_key": "rest_api:POST /progress/ workstream_id",
+          "interface_kind": "rest_api",
+          "legacy_since": "2026-07-08T23:35:09.148333Z",
+          "replacement_ref": "POST /progress/ with workplan_id",
+          "owner_component": "state-hub.api",
+          "status": "retired",
+          "replacement_verified": true,
+          "manual_hold": false,
+          "hold_reason": null,
+          "notes": "Retired by STATE-WP-0079-T05 (cutover slice E2); evidence: 7d review window + volume-scaled quiet ladder, capture 2026-08-20",
+          "retired_at": "2026-08-20T05:27:20.114395Z",
+          "created_at": "2026-07-08T23:35:09.148333Z",
+          "updated_at": "2026-08-20T05:27:20.110090Z"
+        },
+        "all_time": {
+          "calls": 14,
+          "tenant_count": 1,
+          "user_count": 1,
+          "component_count": 1,
+          "tenants": {
+            "unknown": 14
+          },
+          "users": {
+            "unknown": 14
+          },
+          "components": {
+            "unknown": 14
+          }
+        },
+        "window": {
+          "calls": 0,
+          "tenant_count": 0,
+          "user_count": 0,
+          "component_count": 0,
+          "tenants": {},
+          "users": {},
+          "components": {}
+        },
+        "last_seen_at": "2026-07-10T08:34:42.959724Z",
+        "retirement_candidate": false,
+        "retirement_reason": "already retired"
+      },
+      {
+        "interface": {
+          "id": "6df4e443-7bf1-461a-923b-a6eb52fe7b07",
+          "interface_key": "rest_api:POST /tasks/ workstream_id",
+          "interface_kind": "rest_api",
+          "legacy_since": "2026-07-08T22:38:29.405720Z",
+          "replacement_ref": "POST /tasks/ with workplan_id",
+          "owner_component": "state-hub.api",
+          "status": "retired",
+          "replacement_verified": true,
+          "manual_hold": false,
+          "hold_reason": null,
+          "notes": "Retired by STATE-WP-0079-T05 (cutover slice E2); evidence: 7d review window + volume-scaled quiet ladder, capture 2026-08-20",
+          "retired_at": "2026-08-20T05:27:20.134796Z",
+          "created_at": "2026-07-08T22:38:29.405720Z",
+          "updated_at": "2026-08-20T05:27:20.131430Z"
+        },
+        "all_time": {
+          "calls": 5,
+          "tenant_count": 1,
+          "user_count": 1,
+          "component_count": 1,
+          "tenants": {
+            "unknown": 5
+          },
+          "users": {
+            "unknown": 5
+          },
+          "components": {
+            "state-hub.fix-consistency": 5
+          }
+        },
+        "window": {
+          "calls": 0,
+          "tenant_count": 0,
+          "user_count": 0,
+          "component_count": 0,
+          "tenants": {},
+          "users": {},
+          "components": {}
+        },
+        "last_seen_at": "2026-07-08T22:38:29.976918Z",
+        "retirement_candidate": false,
+        "retirement_reason": "already retired"
+      },
+      {
+        "interface": {
+          "id": "ed6451c9-d2cc-4486-9afe-d3852782cabc",
+          "interface_key": "rest_api:POST /workstreams/",
+          "interface_kind": "rest_api",
+          "legacy_since": "2026-06-04T07:40:24.168535Z",
+          "replacement_ref": "/workplans/",
+          "owner_component": "state-hub.api",
+          "status": "retired",
+          "replacement_verified": true,
+          "manual_hold": false,
+          "hold_reason": null,
+          "notes": "Retired by STATE-WP-0079-T05 (cutover slice E2); evidence: 7d review window + volume-scaled quiet ladder, capture 2026-08-20",
+          "retired_at": "2026-08-20T05:27:20.157133Z",
+          "created_at": "2026-06-04T07:40:24.168535Z",
+          "updated_at": "2026-08-20T05:27:20.150639Z"
+        },
+        "all_time": {
+          "calls": 824,
+          "tenant_count": 1,
+          "user_count": 1,
+          "component_count": 1,
+          "tenants": {
+            "unknown": 824
+          },
+          "users": {
+            "unknown": 824
+          },
+          "components": {
+            "unknown": 824
+          }
+        },
+        "window": {
+          "calls": 0,
+          "tenant_count": 0,
+          "user_count": 0,
+          "component_count": 0,
+          "tenants": {},
+          "users": {},
+          "components": {}
+        },
+        "last_seen_at": "2026-07-08T20:38:05.903144Z",
+        "retirement_candidate": false,
+        "retirement_reason": "already retired"
+      },
+      {
+        "interface": {
+          "id": "281fd706-b192-4194-8055-2d8733c115f9",
+          "interface_key": "rest_api:POST /workstreams/{workstream_id}/dependencies/",
+          "interface_kind": "rest_api",
+          "legacy_since": "2026-06-04T22:57:37.149207Z",
+          "replacement_ref": "/workplans/{workplan_id}/dependencies/",
+          "owner_component": "state-hub.api",
+          "status": "retired",
+          "replacement_verified": true,
+          "manual_hold": false,
+          "hold_reason": null,
+          "notes": "Retired by STATE-WP-0079-T05 (cutover slice E2); evidence: 7d review window + volume-scaled quiet ladder, capture 2026-08-20",
+          "retired_at": "2026-08-20T05:27:20.186201Z",
+          "created_at": "2026-06-04T22:57:37.149207Z",
+          "updated_at": "2026-08-20T05:27:20.181406Z"
+        },
+        "all_time": {
+          "calls": 4971,
+          "tenant_count": 1,
+          "user_count": 1,
+          "component_count": 1,
+          "tenants": {
+            "unknown": 4971
+          },
+          "users": {
+            "unknown": 4971
+          },
+          "components": {
+            "unknown": 4971
+          }
+        },
+        "window": {
+          "calls": 0,
+          "tenant_count": 0,
+          "user_count": 0,
+          "component_count": 0,
+          "tenants": {},
+          "users": {},
+          "components": {}
+        },
+        "last_seen_at": "2026-07-01T22:09:24.229011Z",
+        "retirement_candidate": false,
+        "retirement_reason": "already retired"
+      }
+    ],
+    "retirement_candidates": []
+  },
+  "days": 7
+}
diff --git a/docs/evidence/legacy-meter-weekly-review-20260822.json b/docs/evidence/legacy-meter-weekly-review-20260822.json
new file mode 100644
index 0000000..c374f7b
--- /dev/null
+++ b/docs/evidence/legacy-meter-weekly-review-20260822.json
@@ -0,0 +1,929 @@
+{
+  "captured_at": "2026-08-22T14:00:05.083125+00:00",
+  "api_base": "http://127.0.0.1:8000",
+  "workplan": "STATE-WP-0070",
+  "retired_interfaces": [],
+  "weekly_review": {
+    "generated_at": "2026-08-22T14:00:05.076969Z",
+    "window_start": "2026-08-15T14:00:04.994574Z",
+    "window_end": "2026-08-22T14:00:04.994574Z",
+    "cadence": "weekly",
+    "activity_core_handoff": {
+      "activity_id": "statehub-legacy-interface-review",
+      "cadence": "weekly",
+      "source_endpoint": "/legacy-meter/weekly-review",
+      "state_owner": "state-hub",
+      "scheduler_owner": "activity-core"
+    },
+    "interfaces": [
+      {
+        "interface": {
+          "id": "8051fb40-66c9-4dc4-a413-13e8573e04a3",
+          "interface_key": "event_subject:org.statehub.workstream.completed",
+          "interface_kind": "event_subject",
+          "legacy_since": "2026-06-04T06:09:42.198193Z",
+          "replacement_ref": "org.statehub.workplan.completed",
+          "owner_component": "state-hub.events",
+          "status": "retired",
+          "replacement_verified": true,
+          "manual_hold": false,
+          "hold_reason": null,
+          "notes": "Retired by STATE-WP-0069 closeout",
+          "retired_at": "2026-07-08T21:38:52.773601Z",
+          "created_at": "2026-06-04T06:09:42.198193Z",
+          "updated_at": "2026-07-08T21:38:52.761243Z"
+        },
+        "all_time": {
+          "calls": 255,
+          "tenant_count": 1,
+          "user_count": 1,
+          "component_count": 1,
+          "tenants": {
+            "unknown": 255
+          },
+          "users": {
+            "unknown": 255
+          },
+          "components": {
+            "state-hub.events": 255
+          }
+        },
+        "window": {
+          "calls": 0,
+          "tenant_count": 0,
+          "user_count": 0,
+          "component_count": 0,
+          "tenants": {},
+          "users": {},
+          "components": {}
+        },
+        "last_seen_at": "2026-07-08T20:49:12.839383Z",
+        "retirement_candidate": false,
+        "retirement_reason": "already retired"
+      },
+      {
+        "interface": {
+          "id": "63ed90e3-42b4-431a-94db-e1254a52f9e2",
+          "interface_key": "mcp:create_workstream",
+          "interface_kind": "mcp_tool",
+          "legacy_since": "2026-07-10T13:19:44.205900Z",
+          "replacement_ref": "create_workplan",
+          "owner_component": "state-hub.mcp",
+          "status": "retired",
+          "replacement_verified": true,
+          "manual_hold": false,
+          "hold_reason": null,
+          "notes": "Retired by STATE-WP-0079-T05 (cutover slice E2); evidence: 7d review window + volume-scaled quiet ladder, capture 2026-08-20",
+          "retired_at": "2026-08-20T05:27:19.851030Z",
+          "created_at": "2026-07-10T13:19:44.205900Z",
+          "updated_at": "2026-08-20T05:27:19.844807Z"
+        },
+        "all_time": {
+          "calls": 2,
+          "tenant_count": 1,
+          "user_count": 1,
+          "component_count": 1,
+          "tenants": {
+            "unknown": 2
+          },
+          "users": {
+            "unknown": 2
+          },
+          "components": {
+            "state-hub.mcp": 2
+          }
+        },
+        "window": {
+          "calls": 0,
+          "tenant_count": 0,
+          "user_count": 0,
+          "component_count": 0,
+          "tenants": {},
+          "users": {},
+          "components": {}
+        },
+        "last_seen_at": "2026-07-10T13:20:43.378546Z",
+        "retirement_candidate": false,
+        "retirement_reason": "already retired"
+      },
+      {
+        "interface": {
+          "id": "b6a5fe44-fb85-4ef7-a273-78d09da777af",
+          "interface_key": "mcp:list_workstreams",
+          "interface_kind": "mcp_tool",
+          "legacy_since": "2026-07-10T13:19:26.075491Z",
+          "replacement_ref": "list_workplans",
+          "owner_component": "state-hub.mcp",
+          "status": "retired",
+          "replacement_verified": true,
+          "manual_hold": false,
+          "hold_reason": null,
+          "notes": "Retired by STATE-WP-0079-T05 (cutover slice E2); evidence: 7d review window + volume-scaled quiet ladder, capture 2026-08-20",
+          "retired_at": "2026-08-20T05:27:19.883196Z",
+          "created_at": "2026-07-10T13:19:26.075491Z",
+          "updated_at": "2026-08-20T05:27:19.876635Z"
+        },
+        "all_time": {
+          "calls": 2,
+          "tenant_count": 1,
+          "user_count": 1,
+          "component_count": 1,
+          "tenants": {
+            "unknown": 2
+          },
+          "users": {
+            "unknown": 2
+          },
+          "components": {
+            "state-hub.mcp": 2
+          }
+        },
+        "window": {
+          "calls": 0,
+          "tenant_count": 0,
+          "user_count": 0,
+          "component_count": 0,
+          "tenants": {},
+          "users": {},
+          "components": {}
+        },
+        "last_seen_at": "2026-07-10T13:20:42.374940Z",
+        "retirement_candidate": false,
+        "retirement_reason": "already retired"
+      },
+      {
+        "interface": {
+          "id": "53c3372b-307d-4d6a-8ea4-bc36cacdcaf2",
+          "interface_key": "mcp:update_workstream",
+          "interface_kind": "mcp_tool",
+          "legacy_since": "2026-07-10T13:19:44.255216Z",
+          "replacement_ref": "update_workplan",
+          "owner_component": "state-hub.mcp",
+          "status": "retired",
+          "replacement_verified": true,
+          "manual_hold": false,
+          "hold_reason": null,
+          "notes": "Retired by STATE-WP-0079-T05 (cutover slice E2); evidence: 7d review window + volume-scaled quiet ladder, capture 2026-08-20",
+          "retired_at": "2026-08-20T05:27:19.907081Z",
+          "created_at": "2026-07-10T13:19:44.255216Z",
+          "updated_at": "2026-08-20T05:27:19.902177Z"
+        },
+        "all_time": {
+          "calls": 0,
+          "tenant_count": 0,
+          "user_count": 0,
+          "component_count": 0,
+          "tenants": {},
+          "users": {},
+          "components": {}
+        },
+        "window": {
+          "calls": 0,
+          "tenant_count": 0,
+          "user_count": 0,
+          "component_count": 0,
+          "tenants": {},
+          "users": {},
+          "components": {}
+        },
+        "last_seen_at": null,
+        "retirement_candidate": false,
+        "retirement_reason": "already retired"
+      },
+      {
+        "interface": {
+          "id": "bed4d08a-3471-48f5-9f0e-f9d550383a26",
+          "interface_key": "mcp:update_workstream_status",
+          "interface_kind": "mcp_tool",
+          "legacy_since": "2026-07-10T13:19:44.303612Z",
+          "replacement_ref": "update_workplan_status",
+          "owner_component": "state-hub.mcp",
+          "status": "retired",
+          "replacement_verified": true,
+          "manual_hold": false,
+          "hold_reason": null,
+          "notes": "Retired by STATE-WP-0079-T05 (cutover slice E2); evidence: 7d review window + volume-scaled quiet ladder, capture 2026-08-20",
+          "retired_at": "2026-08-20T05:27:19.928988Z",
+          "created_at": "2026-07-10T13:19:44.303612Z",
+          "updated_at": "2026-08-20T05:27:19.925652Z"
+        },
+        "all_time": {
+          "calls": 0,
+          "tenant_count": 0,
+          "user_count": 0,
+          "component_count": 0,
+          "tenants": {},
+          "users": {},
+          "components": {}
+        },
+        "window": {
+          "calls": 0,
+          "tenant_count": 0,
+          "user_count": 0,
+          "component_count": 0,
+          "tenants": {},
+          "users": {},
+          "components": {}
+        },
+        "last_seen_at": null,
+        "retirement_candidate": false,
+        "retirement_reason": "already retired"
+      },
+      {
+        "interface": {
+          "id": "46900dc2-0893-405b-ba59-80f31fb6ebb1",
+          "interface_key": "state://workstreams/{topic_slug}",
+          "interface_kind": "mcp_tool",
+          "legacy_since": "2026-07-10T13:19:44.344493Z",
+          "replacement_ref": "state://workplans/{topic_slug}",
+          "owner_component": "state-hub.mcp",
+          "status": "retired",
+          "replacement_verified": true,
+          "manual_hold": false,
+          "hold_reason": null,
+          "notes": "Retired by STATE-WP-0079-T05 (cutover slice E2); evidence: 7d review window + volume-scaled quiet ladder, capture 2026-08-20",
+          "retired_at": "2026-08-20T05:27:19.948467Z",
+          "created_at": "2026-07-10T13:19:44.344493Z",
+          "updated_at": "2026-08-20T05:27:19.944874Z"
+        },
+        "all_time": {
+          "calls": 1,
+          "tenant_count": 1,
+          "user_count": 1,
+          "component_count": 1,
+          "tenants": {
+            "unknown": 1
+          },
+          "users": {
+            "unknown": 1
+          },
+          "components": {
+            "state-hub.mcp": 1
+          }
+        },
+        "window": {
+          "calls": 0,
+          "tenant_count": 0,
+          "user_count": 0,
+          "component_count": 0,
+          "tenants": {},
+          "users": {},
+          "components": {}
+        },
+        "last_seen_at": "2026-07-10T13:20:34.491811Z",
+        "retirement_candidate": false,
+        "retirement_reason": "already retired"
+      },
+      {
+        "interface": {
+          "id": "cd9342fd-27e7-4a46-a1be-d41499e106a3",
+          "interface_key": "rest_api:DELETE /workstreams/{workstream_id}",
+          "interface_kind": "rest_api",
+          "legacy_since": "2026-06-06T17:28:13.052813Z",
+          "replacement_ref": "/workplans/{workplan_id}",
+          "owner_component": "state-hub.api",
+          "status": "retired",
+          "replacement_verified": true,
+          "manual_hold": false,
+          "hold_reason": null,
+          "notes": "Retired by STATE-WP-0079-T05 (cutover slice E2); evidence: 7d review window + volume-scaled quiet ladder, capture 2026-08-20",
+          "retired_at": "2026-08-20T05:27:19.972086Z",
+          "created_at": "2026-06-06T17:28:13.052813Z",
+          "updated_at": "2026-08-20T05:27:19.966289Z"
+        },
+        "all_time": {
+          "calls": 1,
+          "tenant_count": 1,
+          "user_count": 1,
+          "component_count": 1,
+          "tenants": {
+            "unknown": 1
+          },
+          "users": {
+            "unknown": 1
+          },
+          "components": {
+            "unknown": 1
+          }
+        },
+        "window": {
+          "calls": 0,
+          "tenant_count": 0,
+          "user_count": 0,
+          "component_count": 0,
+          "tenants": {},
+          "users": {},
+          "components": {}
+        },
+        "last_seen_at": "2026-06-06T17:28:13.047529Z",
+        "retirement_candidate": false,
+        "retirement_reason": "already retired"
+      },
+      {
+        "interface": {
+          "id": "a4e0948c-cd4a-461e-8ae2-7fd7b51d04a7",
+          "interface_key": "rest_api:GET /decisions/?workstream_id",
+          "interface_kind": "rest_api",
+          "legacy_since": "2026-07-09T23:07:53.093223Z",
+          "replacement_ref": "/decisions/?workplan_id=<workplan_id>",
+          "owner_component": "state-hub.api",
+          "status": "retired",
+          "replacement_verified": true,
+          "manual_hold": false,
+          "hold_reason": null,
+          "notes": "Retired by STATE-WP-0079-T05 (cutover slice E2); evidence: 7d review window + volume-scaled quiet ladder, capture 2026-08-20",
+          "retired_at": "2026-08-20T05:27:19.996130Z",
+          "created_at": "2026-07-09T23:07:53.093223Z",
+          "updated_at": "2026-08-20T05:27:19.991877Z"
+        },
+        "all_time": {
+          "calls": 1,
+          "tenant_count": 1,
+          "user_count": 1,
+          "component_count": 1,
+          "tenants": {
+            "unknown": 1
+          },
+          "users": {
+            "unknown": 1
+          },
+          "components": {
+            "unknown": 1
+          }
+        },
+        "window": {
+          "calls": 0,
+          "tenant_count": 0,
+          "user_count": 0,
+          "component_count": 0,
+          "tenants": {},
+          "users": {},
+          "components": {}
+        },
+        "last_seen_at": "2026-07-09T23:07:53.083299Z",
+        "retirement_candidate": false,
+        "retirement_reason": "already retired"
+      },
+      {
+        "interface": {
+          "id": "70a9346e-e0ee-42ac-874f-f160580b54dd",
+          "interface_key": "rest_api:GET /progress/?workstream_id",
+          "interface_kind": "rest_api",
+          "legacy_since": "2026-07-13T22:04:03.911449Z",
+          "replacement_ref": "/progress/?workplan_id=<workplan_id>",
+          "owner_component": "state-hub.api",
+          "status": "retired",
+          "replacement_verified": true,
+          "manual_hold": false,
+          "hold_reason": null,
+          "notes": "Retired by STATE-WP-0079-T05 (cutover slice E2); evidence: 7d review window + volume-scaled quiet ladder, capture 2026-08-20",
+          "retired_at": "2026-08-20T05:27:20.017065Z",
+          "created_at": "2026-07-13T22:04:03.911449Z",
+          "updated_at": "2026-08-20T05:27:20.013500Z"
+        },
+        "all_time": {
+          "calls": 2,
+          "tenant_count": 1,
+          "user_count": 1,
+          "component_count": 1,
+          "tenants": {
+            "unknown": 2
+          },
+          "users": {
+            "unknown": 2
+          },
+          "components": {
+            "unknown": 2
+          }
+        },
+        "window": {
+          "calls": 0,
+          "tenant_count": 0,
+          "user_count": 0,
+          "component_count": 0,
+          "tenants": {},
+          "users": {},
+          "components": {}
+        },
+        "last_seen_at": "2026-08-12T08:55:33.912995Z",
+        "retirement_candidate": false,
+        "retirement_reason": "already retired"
+      },
+      {
+        "interface": {
+          "id": "be3cdcf8-250b-4bf0-801f-02ffd5f57e00",
+          "interface_key": "rest_api:GET /tasks/?workstream_id",
+          "interface_kind": "rest_api",
+          "legacy_since": "2026-07-08T19:32:21.628513Z",
+          "replacement_ref": "/tasks/?workplan_id=<workplan_id>",
+          "owner_component": "state-hub.api",
+          "status": "legacy",
+          "replacement_verified": true,
+          "manual_hold": false,
+          "hold_reason": null,
+          "notes": null,
+          "retired_at": null,
+          "created_at": "2026-07-08T19:32:21.628513Z",
+          "updated_at": "2026-07-08T19:32:21.628513Z"
+        },
+        "all_time": {
+          "calls": 596,
+          "tenant_count": 1,
+          "user_count": 1,
+          "component_count": 1,
+          "tenants": {
+            "unknown": 596
+          },
+          "users": {
+            "unknown": 596
+          },
+          "components": {
+            "unknown": 596
+          }
+        },
+        "window": {
+          "calls": 6,
+          "tenant_count": 1,
+          "user_count": 1,
+          "component_count": 1,
+          "tenants": {
+            "unknown": 6
+          },
+          "users": {
+            "unknown": 6
+          },
+          "components": {
+            "unknown": 6
+          }
+        },
+        "last_seen_at": "2026-08-20T20:57:26.985884Z",
+        "retirement_candidate": false,
+        "retirement_reason": "6 call(s) in review window"
+      },
+      {
+        "interface": {
+          "id": "3e4a3d0b-08fa-45c3-91e2-4f514a914b97",
+          "interface_key": "rest_api:GET /workstreams/",
+          "interface_kind": "rest_api",
+          "legacy_since": "2026-06-04T00:26:14.533764Z",
+          "replacement_ref": "/workplans/",
+          "owner_component": "state-hub.api",
+          "status": "legacy",
+          "replacement_verified": true,
+          "manual_hold": false,
+          "hold_reason": null,
+          "notes": null,
+          "retired_at": null,
+          "created_at": "2026-06-04T00:26:14.533764Z",
+          "updated_at": "2026-06-04T00:26:14.533764Z"
+        },
+        "all_time": {
+          "calls": 144087,
+          "tenant_count": 1,
+          "user_count": 1,
+          "component_count": 1,
+          "tenants": {
+            "unknown": 144087
+          },
+          "users": {
+            "unknown": 144087
+          },
+          "components": {
+            "unknown": 144087
+          }
+        },
+        "window": {
+          "calls": 1,
+          "tenant_count": 1,
+          "user_count": 1,
+          "component_count": 1,
+          "tenants": {
+            "unknown": 1
+          },
+          "users": {
+            "unknown": 1
+          },
+          "components": {
+            "unknown": 1
+          }
+        },
+        "last_seen_at": "2026-08-21T22:29:25.068158Z",
+        "retirement_candidate": false,
+        "retirement_reason": "1 call(s) in review window"
+      },
+      {
+        "interface": {
+          "id": "e4c140ec-7479-46f9-b185-4b533f19d639",
+          "interface_key": "rest_api:GET /workstreams/workplan-index",
+          "interface_kind": "rest_api",
+          "legacy_since": "2026-06-04T05:20:58.321869Z",
+          "replacement_ref": "/workplans/index",
+          "owner_component": "state-hub.api",
+          "status": "retired",
+          "replacement_verified": true,
+          "manual_hold": false,
+          "hold_reason": null,
+          "notes": "Retired by STATE-WP-0079-T05 (cutover slice E2); evidence: 7d review window + volume-scaled quiet ladder, capture 2026-08-20",
+          "retired_at": "2026-08-20T05:27:20.041850Z",
+          "created_at": "2026-06-04T05:20:58.321869Z",
+          "updated_at": "2026-08-20T05:27:20.035160Z"
+        },
+        "all_time": {
+          "calls": 30,
+          "tenant_count": 1,
+          "user_count": 1,
+          "component_count": 1,
+          "tenants": {
+            "unknown": 30
+          },
+          "users": {
+            "unknown": 30
+          },
+          "components": {
+            "unknown": 30
+          }
+        },
+        "window": {
+          "calls": 0,
+          "tenant_count": 0,
+          "user_count": 0,
+          "component_count": 0,
+          "tenants": {},
+          "users": {},
+          "components": {}
+        },
+        "last_seen_at": "2026-07-03T05:20:34.534439Z",
+        "retirement_candidate": false,
+        "retirement_reason": "already retired"
+      },
+      {
+        "interface": {
+          "id": "3a00b19e-e7db-4403-98aa-a77c9ab61ecc",
+          "interface_key": "rest_api:GET /workstreams/{workstream_id}",
+          "interface_kind": "rest_api",
+          "legacy_since": "2026-06-04T00:25:59.014966Z",
+          "replacement_ref": "/workplans/{workplan_id}",
+          "owner_component": "state-hub.api",
+          "status": "legacy",
+          "replacement_verified": true,
+          "manual_hold": false,
+          "hold_reason": null,
+          "notes": null,
+          "retired_at": null,
+          "created_at": "2026-06-04T00:25:59.014966Z",
+          "updated_at": "2026-06-04T00:25:59.014966Z"
+        },
+        "all_time": {
+          "calls": 511407,
+          "tenant_count": 1,
+          "user_count": 1,
+          "component_count": 1,
+          "tenants": {
+            "unknown": 511407
+          },
+          "users": {
+            "unknown": 511407
+          },
+          "components": {
+            "unknown": 511407
+          }
+        },
+        "window": {
+          "calls": 1,
+          "tenant_count": 1,
+          "user_count": 1,
+          "component_count": 1,
+          "tenants": {
+            "unknown": 1
+          },
+          "users": {
+            "unknown": 1
+          },
+          "components": {
+            "unknown": 1
+          }
+        },
+        "last_seen_at": "2026-08-20T23:32:31.368781Z",
+        "retirement_candidate": false,
+        "retirement_reason": "1 call(s) in review window"
+      },
+      {
+        "interface": {
+          "id": "69e1a255-a8b9-4101-8a68-b1bed23abfda",
+          "interface_key": "rest_api:GET /workstreams/{workstream_id}/dependencies/",
+          "interface_kind": "rest_api",
+          "legacy_since": "2026-06-04T00:25:59.291135Z",
+          "replacement_ref": "/workplans/{workplan_id}/dependencies/",
+          "owner_component": "state-hub.api",
+          "status": "legacy",
+          "replacement_verified": true,
+          "manual_hold": false,
+          "hold_reason": null,
+          "notes": null,
+          "retired_at": null,
+          "created_at": "2026-06-04T00:25:59.291135Z",
+          "updated_at": "2026-06-04T00:25:59.291135Z"
+        },
+        "all_time": {
+          "calls": 255865,
+          "tenant_count": 1,
+          "user_count": 1,
+          "component_count": 1,
+          "tenants": {
+            "unknown": 255865
+          },
+          "users": {
+            "unknown": 255865
+          },
+          "components": {
+            "unknown": 255865
+          }
+        },
+        "window": {
+          "calls": 0,
+          "tenant_count": 0,
+          "user_count": 0,
+          "component_count": 0,
+          "tenants": {},
+          "users": {},
+          "components": {}
+        },
+        "last_seen_at": "2026-07-08T21:14:12.747005Z",
+        "retirement_candidate": false,
+        "retirement_reason": "quiet 44d of 60d required for 255865 all-time call(s)"
+      },
+      {
+        "interface": {
+          "id": "b1aae931-b51f-4a85-a723-865dd65f6132",
+          "interface_key": "rest_api:PATCH /workstreams/{workstream_id}",
+          "interface_kind": "rest_api",
+          "legacy_since": "2026-06-04T06:09:41.901035Z",
+          "replacement_ref": "/workplans/{workplan_id}",
+          "owner_component": "state-hub.api",
+          "status": "retired",
+          "replacement_verified": true,
+          "manual_hold": false,
+          "hold_reason": null,
+          "notes": "Retired by STATE-WP-0079-T05 (cutover slice E2); evidence: 7d review window + volume-scaled quiet ladder, capture 2026-08-20",
+          "retired_at": "2026-08-20T05:27:20.069758Z",
+          "created_at": "2026-06-04T06:09:41.901035Z",
+          "updated_at": "2026-08-20T05:27:20.062648Z"
+        },
+        "all_time": {
+          "calls": 571,
+          "tenant_count": 1,
+          "user_count": 1,
+          "component_count": 1,
+          "tenants": {
+            "unknown": 571
+          },
+          "users": {
+            "unknown": 571
+          },
+          "components": {
+            "unknown": 571
+          }
+        },
+        "window": {
+          "calls": 0,
+          "tenant_count": 0,
+          "user_count": 0,
+          "component_count": 0,
+          "tenants": {},
+          "users": {},
+          "components": {}
+        },
+        "last_seen_at": "2026-07-08T20:49:12.335710Z",
+        "retirement_candidate": false,
+        "retirement_reason": "already retired"
+      },
+      {
+        "interface": {
+          "id": "4aea9591-970b-4918-ac4a-4da95a0a1a8c",
+          "interface_key": "rest_api:POST /decisions/ workstream_id",
+          "interface_kind": "rest_api",
+          "legacy_since": "2026-07-09T22:56:35.473130Z",
+          "replacement_ref": "POST /decisions/ with workplan_id",
+          "owner_component": "state-hub.api",
+          "status": "retired",
+          "replacement_verified": true,
+          "manual_hold": false,
+          "hold_reason": null,
+          "notes": "Retired by STATE-WP-0079-T05 (cutover slice E2); evidence: 7d review window + volume-scaled quiet ladder, capture 2026-08-20",
+          "retired_at": "2026-08-20T05:27:20.093372Z",
+          "created_at": "2026-07-09T22:56:35.473130Z",
+          "updated_at": "2026-08-20T05:27:20.090180Z"
+        },
+        "all_time": {
+          "calls": 3,
+          "tenant_count": 1,
+          "user_count": 1,
+          "component_count": 1,
+          "tenants": {
+            "unknown": 3
+          },
+          "users": {
+            "unknown": 3
+          },
+          "components": {
+            "unknown": 3
+          }
+        },
+        "window": {
+          "calls": 0,
+          "tenant_count": 0,
+          "user_count": 0,
+          "component_count": 0,
+          "tenants": {},
+          "users": {},
+          "components": {}
+        },
+        "last_seen_at": "2026-07-09T22:57:05.912456Z",
+        "retirement_candidate": false,
+        "retirement_reason": "already retired"
+      },
+      {
+        "interface": {
+          "id": "4a70583c-1e41-4ec1-99a9-728856a7d79c",
+          "interface_key": "rest_api:POST /progress/ workstream_id",
+          "interface_kind": "rest_api",
+          "legacy_since": "2026-07-08T23:35:09.148333Z",
+          "replacement_ref": "POST /progress/ with workplan_id",
+          "owner_component": "state-hub.api",
+          "status": "retired",
+          "replacement_verified": true,
+          "manual_hold": false,
+          "hold_reason": null,
+          "notes": "Retired by STATE-WP-0079-T05 (cutover slice E2); evidence: 7d review window + volume-scaled quiet ladder, capture 2026-08-20",
+          "retired_at": "2026-08-20T05:27:20.114395Z",
+          "created_at": "2026-07-08T23:35:09.148333Z",
+          "updated_at": "2026-08-20T05:27:20.110090Z"
+        },
+        "all_time": {
+          "calls": 14,
+          "tenant_count": 1,
+          "user_count": 1,
+          "component_count": 1,
+          "tenants": {
+            "unknown": 14
+          },
+          "users": {
+            "unknown": 14
+          },
+          "components": {
+            "unknown": 14
+          }
+        },
+        "window": {
+          "calls": 0,
+          "tenant_count": 0,
+          "user_count": 0,
+          "component_count": 0,
+          "tenants": {},
+          "users": {},
+          "components": {}
+        },
+        "last_seen_at": "2026-07-10T08:34:42.959724Z",
+        "retirement_candidate": false,
+        "retirement_reason": "already retired"
+      },
+      {
+        "interface": {
+          "id": "6df4e443-7bf1-461a-923b-a6eb52fe7b07",
+          "interface_key": "rest_api:POST /tasks/ workstream_id",
+          "interface_kind": "rest_api",
+          "legacy_since": "2026-07-08T22:38:29.405720Z",
+          "replacement_ref": "POST /tasks/ with workplan_id",
+          "owner_component": "state-hub.api",
+          "status": "retired",
+          "replacement_verified": true,
+          "manual_hold": false,
+          "hold_reason": null,
+          "notes": "Retired by STATE-WP-0079-T05 (cutover slice E2); evidence: 7d review window + volume-scaled quiet ladder, capture 2026-08-20",
+          "retired_at": "2026-08-20T05:27:20.134796Z",
+          "created_at": "2026-07-08T22:38:29.405720Z",
+          "updated_at": "2026-08-20T05:27:20.131430Z"
+        },
+        "all_time": {
+          "calls": 5,
+          "tenant_count": 1,
+          "user_count": 1,
+          "component_count": 1,
+          "tenants": {
+            "unknown": 5
+          },
+          "users": {
+            "unknown": 5
+          },
+          "components": {
+            "state-hub.fix-consistency": 5
+          }
+        },
+        "window": {
+          "calls": 0,
+          "tenant_count": 0,
+          "user_count": 0,
+          "component_count": 0,
+          "tenants": {},
+          "users": {},
+          "components": {}
+        },
+        "last_seen_at": "2026-07-08T22:38:29.976918Z",
+        "retirement_candidate": false,
+        "retirement_reason": "already retired"
+      },
+      {
+        "interface": {
+          "id": "ed6451c9-d2cc-4486-9afe-d3852782cabc",
+          "interface_key": "rest_api:POST /workstreams/",
+          "interface_kind": "rest_api",
+          "legacy_since": "2026-06-04T07:40:24.168535Z",
+          "replacement_ref": "/workplans/",
+          "owner_component": "state-hub.api",
+          "status": "retired",
+          "replacement_verified": true,
+          "manual_hold": false,
+          "hold_reason": null,
+          "notes": "Retired by STATE-WP-0079-T05 (cutover slice E2); evidence: 7d review window + volume-scaled quiet ladder, capture 2026-08-20",
+          "retired_at": "2026-08-20T05:27:20.157133Z",
+          "created_at": "2026-06-04T07:40:24.168535Z",
+          "updated_at": "2026-08-20T05:27:20.150639Z"
+        },
+        "all_time": {
+          "calls": 824,
+          "tenant_count": 1,
+          "user_count": 1,
+          "component_count": 1,
+          "tenants": {
+            "unknown": 824
+          },
+          "users": {
+            "unknown": 824
+          },
+          "components": {
+            "unknown": 824
+          }
+        },
+        "window": {
+          "calls": 0,
+          "tenant_count": 0,
+          "user_count": 0,
+          "component_count": 0,
+          "tenants": {},
+          "users": {},
+          "components": {}
+        },
+        "last_seen_at": "2026-07-08T20:38:05.903144Z",
+        "retirement_candidate": false,
+        "retirement_reason": "already retired"
+      },
+      {
+        "interface": {
+          "id": "281fd706-b192-4194-8055-2d8733c115f9",
+          "interface_key": "rest_api:POST /workstreams/{workstream_id}/dependencies/",
+          "interface_kind": "rest_api",
+          "legacy_since": "2026-06-04T22:57:37.149207Z",
+          "replacement_ref": "/workplans/{workplan_id}/dependencies/",
+          "owner_component": "state-hub.api",
+          "status": "retired",
+          "replacement_verified": true,
+          "manual_hold": false,
+          "hold_reason": null,
+          "notes": "Retired by STATE-WP-0079-T05 (cutover slice E2); evidence: 7d review window + volume-scaled quiet ladder, capture 2026-08-20",
+          "retired_at": "2026-08-20T05:27:20.186201Z",
+          "created_at": "2026-06-04T22:57:37.149207Z",
+          "updated_at": "2026-08-20T05:27:20.181406Z"
+        },
+        "all_time": {
+          "calls": 4971,
+          "tenant_count": 1,
+          "user_count": 1,
+          "component_count": 1,
+          "tenants": {
+            "unknown": 4971
+          },
+          "users": {
+            "unknown": 4971
+          },
+          "components": {
+            "unknown": 4971
+          }
+        },
+        "window": {
+          "calls": 0,
+          "tenant_count": 0,
+          "user_count": 0,
+          "component_count": 0,
+          "tenants": {},
+          "users": {},
+          "components": {}
+        },
+        "last_seen_at": "2026-07-01T22:09:24.229011Z",
+        "retirement_candidate": false,
+        "retirement_reason": "already retired"
+      }
+    ],
+    "retirement_candidates": []
+  },
+  "days": 7
+}
diff --git a/docs/evidence/legacy-meter-weekly-review-20260823.json b/docs/evidence/legacy-meter-weekly-review-20260823.json
new file mode 100644
index 0000000..359b891
--- /dev/null
+++ b/docs/evidence/legacy-meter-weekly-review-20260823.json
@@ -0,0 +1,986 @@
+{
+  "captured_at": "2026-08-23T14:00:07.579460+00:00",
+  "api_base": "http://127.0.0.1:8000",
+  "workplan": "STATE-WP-0070",
+  "retired_interfaces": [],
+  "weekly_review": {
+    "generated_at": "2026-08-23T14:00:07.574284Z",
+    "window_start": "2026-08-16T14:00:07.483905Z",
+    "window_end": "2026-08-23T14:00:07.483905Z",
+    "cadence": "weekly",
+    "activity_core_handoff": {
+      "activity_id": "statehub-legacy-interface-review",
+      "cadence": "weekly",
+      "source_endpoint": "/legacy-meter/weekly-review",
+      "state_owner": "state-hub",
+      "scheduler_owner": "activity-core"
+    },
+    "interfaces": [
+      {
+        "interface": {
+          "id": "8051fb40-66c9-4dc4-a413-13e8573e04a3",
+          "interface_key": "event_subject:org.statehub.workstream.completed",
+          "interface_kind": "event_subject",
+          "legacy_since": "2026-06-04T06:09:42.198193Z",
+          "replacement_ref": "org.statehub.workplan.completed",
+          "owner_component": "state-hub.events",
+          "status": "retired",
+          "replacement_verified": true,
+          "manual_hold": false,
+          "hold_reason": null,
+          "notes": "Retired by STATE-WP-0069 closeout",
+          "retired_at": "2026-07-08T21:38:52.773601Z",
+          "created_at": "2026-06-04T06:09:42.198193Z",
+          "updated_at": "2026-07-08T21:38:52.761243Z"
+        },
+        "all_time": {
+          "calls": 255,
+          "tenant_count": 1,
+          "user_count": 1,
+          "component_count": 1,
+          "tenants": {
+            "unknown": 255
+          },
+          "users": {
+            "unknown": 255
+          },
+          "components": {
+            "state-hub.events": 255
+          }
+        },
+        "window": {
+          "calls": 0,
+          "tenant_count": 0,
+          "user_count": 0,
+          "component_count": 0,
+          "tenants": {},
+          "users": {},
+          "components": {}
+        },
+        "last_seen_at": "2026-07-08T20:49:12.839383Z",
+        "retirement_candidate": false,
+        "retirement_reason": "already retired"
+      },
+      {
+        "interface": {
+          "id": "63ed90e3-42b4-431a-94db-e1254a52f9e2",
+          "interface_key": "mcp:create_workstream",
+          "interface_kind": "mcp_tool",
+          "legacy_since": "2026-07-10T13:19:44.205900Z",
+          "replacement_ref": "create_workplan",
+          "owner_component": "state-hub.mcp",
+          "status": "retired",
+          "replacement_verified": true,
+          "manual_hold": false,
+          "hold_reason": null,
+          "notes": "Retired by STATE-WP-0079-T05 (cutover slice E2); evidence: 7d review window + volume-scaled quiet ladder, capture 2026-08-20",
+          "retired_at": "2026-08-20T05:27:19.851030Z",
+          "created_at": "2026-07-10T13:19:44.205900Z",
+          "updated_at": "2026-08-20T05:27:19.844807Z"
+        },
+        "all_time": {
+          "calls": 2,
+          "tenant_count": 1,
+          "user_count": 1,
+          "component_count": 1,
+          "tenants": {
+            "unknown": 2
+          },
+          "users": {
+            "unknown": 2
+          },
+          "components": {
+            "state-hub.mcp": 2
+          }
+        },
+        "window": {
+          "calls": 0,
+          "tenant_count": 0,
+          "user_count": 0,
+          "component_count": 0,
+          "tenants": {},
+          "users": {},
+          "components": {}
+        },
+        "last_seen_at": "2026-07-10T13:20:43.378546Z",
+        "retirement_candidate": false,
+        "retirement_reason": "already retired"
+      },
+      {
+        "interface": {
+          "id": "b6a5fe44-fb85-4ef7-a273-78d09da777af",
+          "interface_key": "mcp:list_workstreams",
+          "interface_kind": "mcp_tool",
+          "legacy_since": "2026-07-10T13:19:26.075491Z",
+          "replacement_ref": "list_workplans",
+          "owner_component": "state-hub.mcp",
+          "status": "retired",
+          "replacement_verified": true,
+          "manual_hold": false,
+          "hold_reason": null,
+          "notes": "Retired by STATE-WP-0079-T05 (cutover slice E2); evidence: 7d review window + volume-scaled quiet ladder, capture 2026-08-20",
+          "retired_at": "2026-08-20T05:27:19.883196Z",
+          "created_at": "2026-07-10T13:19:26.075491Z",
+          "updated_at": "2026-08-20T05:27:19.876635Z"
+        },
+        "all_time": {
+          "calls": 2,
+          "tenant_count": 1,
+          "user_count": 1,
+          "component_count": 1,
+          "tenants": {
+            "unknown": 2
+          },
+          "users": {
+            "unknown": 2
+          },
+          "components": {
+            "state-hub.mcp": 2
+          }
+        },
+        "window": {
+          "calls": 0,
+          "tenant_count": 0,
+          "user_count": 0,
+          "component_count": 0,
+          "tenants": {},
+          "users": {},
+          "components": {}
+        },
+        "last_seen_at": "2026-07-10T13:20:42.374940Z",
+        "retirement_candidate": false,
+        "retirement_reason": "already retired"
+      },
+      {
+        "interface": {
+          "id": "53c3372b-307d-4d6a-8ea4-bc36cacdcaf2",
+          "interface_key": "mcp:update_workstream",
+          "interface_kind": "mcp_tool",
+          "legacy_since": "2026-07-10T13:19:44.255216Z",
+          "replacement_ref": "update_workplan",
+          "owner_component": "state-hub.mcp",
+          "status": "retired",
+          "replacement_verified": true,
+          "manual_hold": false,
+          "hold_reason": null,
+          "notes": "Retired by STATE-WP-0079-T05 (cutover slice E2); evidence: 7d review window + volume-scaled quiet ladder, capture 2026-08-20",
+          "retired_at": "2026-08-20T05:27:19.907081Z",
+          "created_at": "2026-07-10T13:19:44.255216Z",
+          "updated_at": "2026-08-20T05:27:19.902177Z"
+        },
+        "all_time": {
+          "calls": 0,
+          "tenant_count": 0,
+          "user_count": 0,
+          "component_count": 0,
+          "tenants": {},
+          "users": {},
+          "components": {}
+        },
+        "window": {
+          "calls": 0,
+          "tenant_count": 0,
+          "user_count": 0,
+          "component_count": 0,
+          "tenants": {},
+          "users": {},
+          "components": {}
+        },
+        "last_seen_at": null,
+        "retirement_candidate": false,
+        "retirement_reason": "already retired"
+      },
+      {
+        "interface": {
+          "id": "bed4d08a-3471-48f5-9f0e-f9d550383a26",
+          "interface_key": "mcp:update_workstream_status",
+          "interface_kind": "mcp_tool",
+          "legacy_since": "2026-07-10T13:19:44.303612Z",
+          "replacement_ref": "update_workplan_status",
+          "owner_component": "state-hub.mcp",
+          "status": "retired",
+          "replacement_verified": true,
+          "manual_hold": false,
+          "hold_reason": null,
+          "notes": "Retired by STATE-WP-0079-T05 (cutover slice E2); evidence: 7d review window + volume-scaled quiet ladder, capture 2026-08-20",
+          "retired_at": "2026-08-20T05:27:19.928988Z",
+          "created_at": "2026-07-10T13:19:44.303612Z",
+          "updated_at": "2026-08-20T05:27:19.925652Z"
+        },
+        "all_time": {
+          "calls": 0,
+          "tenant_count": 0,
+          "user_count": 0,
+          "component_count": 0,
+          "tenants": {},
+          "users": {},
+          "components": {}
+        },
+        "window": {
+          "calls": 0,
+          "tenant_count": 0,
+          "user_count": 0,
+          "component_count": 0,
+          "tenants": {},
+          "users": {},
+          "components": {}
+        },
+        "last_seen_at": null,
+        "retirement_candidate": false,
+        "retirement_reason": "already retired"
+      },
+      {
+        "interface": {
+          "id": "46900dc2-0893-405b-ba59-80f31fb6ebb1",
+          "interface_key": "state://workstreams/{topic_slug}",
+          "interface_kind": "mcp_tool",
+          "legacy_since": "2026-07-10T13:19:44.344493Z",
+          "replacement_ref": "state://workplans/{topic_slug}",
+          "owner_component": "state-hub.mcp",
+          "status": "retired",
+          "replacement_verified": true,
+          "manual_hold": false,
+          "hold_reason": null,
+          "notes": "Retired by STATE-WP-0079-T05 (cutover slice E2); evidence: 7d review window + volume-scaled quiet ladder, capture 2026-08-20",
+          "retired_at": "2026-08-20T05:27:19.948467Z",
+          "created_at": "2026-07-10T13:19:44.344493Z",
+          "updated_at": "2026-08-20T05:27:19.944874Z"
+        },
+        "all_time": {
+          "calls": 1,
+          "tenant_count": 1,
+          "user_count": 1,
+          "component_count": 1,
+          "tenants": {
+            "unknown": 1
+          },
+          "users": {
+            "unknown": 1
+          },
+          "components": {
+            "state-hub.mcp": 1
+          }
+        },
+        "window": {
+          "calls": 0,
+          "tenant_count": 0,
+          "user_count": 0,
+          "component_count": 0,
+          "tenants": {},
+          "users": {},
+          "components": {}
+        },
+        "last_seen_at": "2026-07-10T13:20:34.491811Z",
+        "retirement_candidate": false,
+        "retirement_reason": "already retired"
+      },
+      {
+        "interface": {
+          "id": "cd9342fd-27e7-4a46-a1be-d41499e106a3",
+          "interface_key": "rest_api:DELETE /workstreams/{workstream_id}",
+          "interface_kind": "rest_api",
+          "legacy_since": "2026-06-06T17:28:13.052813Z",
+          "replacement_ref": "/workplans/{workplan_id}",
+          "owner_component": "state-hub.api",
+          "status": "retired",
+          "replacement_verified": true,
+          "manual_hold": false,
+          "hold_reason": null,
+          "notes": "Retired by STATE-WP-0079-T05 (cutover slice E2); evidence: 7d review window + volume-scaled quiet ladder, capture 2026-08-20",
+          "retired_at": "2026-08-20T05:27:19.972086Z",
+          "created_at": "2026-06-06T17:28:13.052813Z",
+          "updated_at": "2026-08-20T05:27:19.966289Z"
+        },
+        "all_time": {
+          "calls": 1,
+          "tenant_count": 1,
+          "user_count": 1,
+          "component_count": 1,
+          "tenants": {
+            "unknown": 1
+          },
+          "users": {
+            "unknown": 1
+          },
+          "components": {
+            "unknown": 1
+          }
+        },
+        "window": {
+          "calls": 0,
+          "tenant_count": 0,
+          "user_count": 0,
+          "component_count": 0,
+          "tenants": {},
+          "users": {},
+          "components": {}
+        },
+        "last_seen_at": "2026-06-06T17:28:13.047529Z",
+        "retirement_candidate": false,
+        "retirement_reason": "already retired"
+      },
+      {
+        "interface": {
+          "id": "a4e0948c-cd4a-461e-8ae2-7fd7b51d04a7",
+          "interface_key": "rest_api:GET /decisions/?workstream_id",
+          "interface_kind": "rest_api",
+          "legacy_since": "2026-07-09T23:07:53.093223Z",
+          "replacement_ref": "/decisions/?workplan_id=<workplan_id>",
+          "owner_component": "state-hub.api",
+          "status": "retired",
+          "replacement_verified": true,
+          "manual_hold": false,
+          "hold_reason": null,
+          "notes": "Retired by STATE-WP-0079-T05 (cutover slice E2); evidence: 7d review window + volume-scaled quiet ladder, capture 2026-08-20",
+          "retired_at": "2026-08-20T05:27:19.996130Z",
+          "created_at": "2026-07-09T23:07:53.093223Z",
+          "updated_at": "2026-08-20T05:27:19.991877Z"
+        },
+        "all_time": {
+          "calls": 1,
+          "tenant_count": 1,
+          "user_count": 1,
+          "component_count": 1,
+          "tenants": {
+            "unknown": 1
+          },
+          "users": {
+            "unknown": 1
+          },
+          "components": {
+            "unknown": 1
+          }
+        },
+        "window": {
+          "calls": 0,
+          "tenant_count": 0,
+          "user_count": 0,
+          "component_count": 0,
+          "tenants": {},
+          "users": {},
+          "components": {}
+        },
+        "last_seen_at": "2026-07-09T23:07:53.083299Z",
+        "retirement_candidate": false,
+        "retirement_reason": "already retired"
+      },
+      {
+        "interface": {
+          "id": "70a9346e-e0ee-42ac-874f-f160580b54dd",
+          "interface_key": "rest_api:GET /progress/?workstream_id",
+          "interface_kind": "rest_api",
+          "legacy_since": "2026-07-13T22:04:03.911449Z",
+          "replacement_ref": "/progress/?workplan_id=<workplan_id>",
+          "owner_component": "state-hub.api",
+          "status": "retired",
+          "replacement_verified": true,
+          "manual_hold": false,
+          "hold_reason": null,
+          "notes": "Retired by STATE-WP-0079-T05 (cutover slice E2); evidence: 7d review window + volume-scaled quiet ladder, capture 2026-08-20",
+          "retired_at": "2026-08-20T05:27:20.017065Z",
+          "created_at": "2026-07-13T22:04:03.911449Z",
+          "updated_at": "2026-08-20T05:27:20.013500Z"
+        },
+        "all_time": {
+          "calls": 3,
+          "tenant_count": 1,
+          "user_count": 1,
+          "component_count": 1,
+          "tenants": {
+            "unknown": 3
+          },
+          "users": {
+            "unknown": 3
+          },
+          "components": {
+            "unknown": 3
+          }
+        },
+        "window": {
+          "calls": 1,
+          "tenant_count": 1,
+          "user_count": 1,
+          "component_count": 1,
+          "tenants": {
+            "unknown": 1
+          },
+          "users": {
+            "unknown": 1
+          },
+          "components": {
+            "unknown": 1
+          }
+        },
+        "last_seen_at": "2026-08-22T20:15:43.595231Z",
+        "retirement_candidate": false,
+        "retirement_reason": "already retired"
+      },
+      {
+        "interface": {
+          "id": "be3cdcf8-250b-4bf0-801f-02ffd5f57e00",
+          "interface_key": "rest_api:GET /tasks/?workstream_id",
+          "interface_kind": "rest_api",
+          "legacy_since": "2026-07-08T19:32:21.628513Z",
+          "replacement_ref": "/tasks/?workplan_id=<workplan_id>",
+          "owner_component": "state-hub.api",
+          "status": "legacy",
+          "replacement_verified": true,
+          "manual_hold": false,
+          "hold_reason": null,
+          "notes": null,
+          "retired_at": null,
+          "created_at": "2026-07-08T19:32:21.628513Z",
+          "updated_at": "2026-07-08T19:32:21.628513Z"
+        },
+        "all_time": {
+          "calls": 596,
+          "tenant_count": 1,
+          "user_count": 1,
+          "component_count": 1,
+          "tenants": {
+            "unknown": 596
+          },
+          "users": {
+            "unknown": 596
+          },
+          "components": {
+            "unknown": 596
+          }
+        },
+        "window": {
+          "calls": 6,
+          "tenant_count": 1,
+          "user_count": 1,
+          "component_count": 1,
+          "tenants": {
+            "unknown": 6
+          },
+          "users": {
+            "unknown": 6
+          },
+          "components": {
+            "unknown": 6
+          }
+        },
+        "last_seen_at": "2026-08-20T20:57:26.985884Z",
+        "retirement_candidate": false,
+        "retirement_reason": "6 call(s) in review window"
+      },
+      {
+        "interface": {
+          "id": "3e4a3d0b-08fa-45c3-91e2-4f514a914b97",
+          "interface_key": "rest_api:GET /workstreams/",
+          "interface_kind": "rest_api",
+          "legacy_since": "2026-06-04T00:26:14.533764Z",
+          "replacement_ref": "/workplans/",
+          "owner_component": "state-hub.api",
+          "status": "legacy",
+          "replacement_verified": true,
+          "manual_hold": false,
+          "hold_reason": null,
+          "notes": null,
+          "retired_at": null,
+          "created_at": "2026-06-04T00:26:14.533764Z",
+          "updated_at": "2026-06-04T00:26:14.533764Z"
+        },
+        "all_time": {
+          "calls": 144087,
+          "tenant_count": 1,
+          "user_count": 1,
+          "component_count": 1,
+          "tenants": {
+            "unknown": 144087
+          },
+          "users": {
+            "unknown": 144087
+          },
+          "components": {
+            "unknown": 144087
+          }
+        },
+        "window": {
+          "calls": 1,
+          "tenant_count": 1,
+          "user_count": 1,
+          "component_count": 1,
+          "tenants": {
+            "unknown": 1
+          },
+          "users": {
+            "unknown": 1
+          },
+          "components": {
+            "unknown": 1
+          }
+        },
+        "last_seen_at": "2026-08-21T22:29:25.068158Z",
+        "retirement_candidate": false,
+        "retirement_reason": "1 call(s) in review window"
+      },
+      {
+        "interface": {
+          "id": "e4c140ec-7479-46f9-b185-4b533f19d639",
+          "interface_key": "rest_api:GET /workstreams/workplan-index",
+          "interface_kind": "rest_api",
+          "legacy_since": "2026-06-04T05:20:58.321869Z",
+          "replacement_ref": "/workplans/index",
+          "owner_component": "state-hub.api",
+          "status": "retired",
+          "replacement_verified": true,
+          "manual_hold": false,
+          "hold_reason": null,
+          "notes": "Retired by STATE-WP-0079-T05 (cutover slice E2); evidence: 7d review window + volume-scaled quiet ladder, capture 2026-08-20",
+          "retired_at": "2026-08-20T05:27:20.041850Z",
+          "created_at": "2026-06-04T05:20:58.321869Z",
+          "updated_at": "2026-08-20T05:27:20.035160Z"
+        },
+        "all_time": {
+          "calls": 30,
+          "tenant_count": 1,
+          "user_count": 1,
+          "component_count": 1,
+          "tenants": {
+            "unknown": 30
+          },
+          "users": {
+            "unknown": 30
+          },
+          "components": {
+            "unknown": 30
+          }
+        },
+        "window": {
+          "calls": 0,
+          "tenant_count": 0,
+          "user_count": 0,
+          "component_count": 0,
+          "tenants": {},
+          "users": {},
+          "components": {}
+        },
+        "last_seen_at": "2026-07-03T05:20:34.534439Z",
+        "retirement_candidate": false,
+        "retirement_reason": "already retired"
+      },
+      {
+        "interface": {
+          "id": "3a00b19e-e7db-4403-98aa-a77c9ab61ecc",
+          "interface_key": "rest_api:GET /workstreams/{workstream_id}",
+          "interface_kind": "rest_api",
+          "legacy_since": "2026-06-04T00:25:59.014966Z",
+          "replacement_ref": "/workplans/{workplan_id}",
+          "owner_component": "state-hub.api",
+          "status": "legacy",
+          "replacement_verified": true,
+          "manual_hold": false,
+          "hold_reason": null,
+          "notes": null,
+          "retired_at": null,
+          "created_at": "2026-06-04T00:25:59.014966Z",
+          "updated_at": "2026-06-04T00:25:59.014966Z"
+        },
+        "all_time": {
+          "calls": 511408,
+          "tenant_count": 1,
+          "user_count": 1,
+          "component_count": 1,
+          "tenants": {
+            "unknown": 511408
+          },
+          "users": {
+            "unknown": 511408
+          },
+          "components": {
+            "unknown": 511408
+          }
+        },
+        "window": {
+          "calls": 2,
+          "tenant_count": 1,
+          "user_count": 1,
+          "component_count": 1,
+          "tenants": {
+            "unknown": 2
+          },
+          "users": {
+            "unknown": 2
+          },
+          "components": {
+            "unknown": 2
+          }
+        },
+        "last_seen_at": "2026-08-22T14:49:00.884854Z",
+        "retirement_candidate": false,
+        "retirement_reason": "2 call(s) in review window"
+      },
+      {
+        "interface": {
+          "id": "69e1a255-a8b9-4101-8a68-b1bed23abfda",
+          "interface_key": "rest_api:GET /workstreams/{workstream_id}/dependencies/",
+          "interface_kind": "rest_api",
+          "legacy_since": "2026-06-04T00:25:59.291135Z",
+          "replacement_ref": "/workplans/{workplan_id}/dependencies/",
+          "owner_component": "state-hub.api",
+          "status": "legacy",
+          "replacement_verified": true,
+          "manual_hold": false,
+          "hold_reason": null,
+          "notes": null,
+          "retired_at": null,
+          "created_at": "2026-06-04T00:25:59.291135Z",
+          "updated_at": "2026-06-04T00:25:59.291135Z"
+        },
+        "all_time": {
+          "calls": 255865,
+          "tenant_count": 1,
+          "user_count": 1,
+          "component_count": 1,
+          "tenants": {
+            "unknown": 255865
+          },
+          "users": {
+            "unknown": 255865
+          },
+          "components": {
+            "unknown": 255865
+          }
+        },
+        "window": {
+          "calls": 0,
+          "tenant_count": 0,
+          "user_count": 0,
+          "component_count": 0,
+          "tenants": {},
+          "users": {},
+          "components": {}
+        },
+        "last_seen_at": "2026-07-08T21:14:12.747005Z",
+        "retirement_candidate": false,
+        "retirement_reason": "quiet 45d of 60d required for 255865 all-time call(s)"
+      },
+      {
+        "interface": {
+          "id": "b1aae931-b51f-4a85-a723-865dd65f6132",
+          "interface_key": "rest_api:PATCH /workstreams/{workstream_id}",
+          "interface_kind": "rest_api",
+          "legacy_since": "2026-06-04T06:09:41.901035Z",
+          "replacement_ref": "/workplans/{workplan_id}",
+          "owner_component": "state-hub.api",
+          "status": "retired",
+          "replacement_verified": true,
+          "manual_hold": false,
+          "hold_reason": null,
+          "notes": "Retired by STATE-WP-0079-T05 (cutover slice E2); evidence: 7d review window + volume-scaled quiet ladder, capture 2026-08-20",
+          "retired_at": "2026-08-20T05:27:20.069758Z",
+          "created_at": "2026-06-04T06:09:41.901035Z",
+          "updated_at": "2026-08-20T05:27:20.062648Z"
+        },
+        "all_time": {
+          "calls": 571,
+          "tenant_count": 1,
+          "user_count": 1,
+          "component_count": 1,
+          "tenants": {
+            "unknown": 571
+          },
+          "users": {
+            "unknown": 571
+          },
+          "components": {
+            "unknown": 571
+          }
+        },
+        "window": {
+          "calls": 0,
+          "tenant_count": 0,
+          "user_count": 0,
+          "component_count": 0,
+          "tenants": {},
+          "users": {},
+          "components": {}
+        },
+        "last_seen_at": "2026-07-08T20:49:12.335710Z",
+        "retirement_candidate": false,
+        "retirement_reason": "already retired"
+      },
+      {
+        "interface": {
+          "id": "4aea9591-970b-4918-ac4a-4da95a0a1a8c",
+          "interface_key": "rest_api:POST /decisions/ workstream_id",
+          "interface_kind": "rest_api",
+          "legacy_since": "2026-07-09T22:56:35.473130Z",
+          "replacement_ref": "POST /decisions/ with workplan_id",
+          "owner_component": "state-hub.api",
+          "status": "retired",
+          "replacement_verified": true,
+          "manual_hold": false,
+          "hold_reason": null,
+          "notes": "Retired by STATE-WP-0079-T05 (cutover slice E2); evidence: 7d review window + volume-scaled quiet ladder, capture 2026-08-20",
+          "retired_at": "2026-08-20T05:27:20.093372Z",
+          "created_at": "2026-07-09T22:56:35.473130Z",
+          "updated_at": "2026-08-20T05:27:20.090180Z"
+        },
+        "all_time": {
+          "calls": 3,
+          "tenant_count": 1,
+          "user_count": 1,
+          "component_count": 1,
+          "tenants": {
+            "unknown": 3
+          },
+          "users": {
+            "unknown": 3
+          },
+          "components": {
+            "unknown": 3
+          }
+        },
+        "window": {
+          "calls": 0,
+          "tenant_count": 0,
+          "user_count": 0,
+          "component_count": 0,
+          "tenants": {},
+          "users": {},
+          "components": {}
+        },
+        "last_seen_at": "2026-07-09T22:57:05.912456Z",
+        "retirement_candidate": false,
+        "retirement_reason": "already retired"
+      },
+      {
+        "interface": {
+          "id": "5cb69159-f2b0-4a33-9456-ab93efee5f89",
+          "interface_key": "rest_api:POST /execution/launch-requests",
+          "interface_kind": "rest_api",
+          "legacy_since": "2026-08-22T22:32:56.668016Z",
+          "replacement_ref": "repo file queue or activity-core ActivityDefinition + ops_run",
+          "owner_component": "state-hub.api",
+          "status": "legacy",
+          "replacement_verified": true,
+          "manual_hold": false,
+          "hold_reason": null,
+          "notes": null,
+          "retired_at": null,
+          "created_at": "2026-08-22T22:32:56.668016Z",
+          "updated_at": "2026-08-22T22:32:56.668016Z"
+        },
+        "all_time": {
+          "calls": 1,
+          "tenant_count": 1,
+          "user_count": 1,
+          "component_count": 1,
+          "tenants": {
+            "unknown": 1
+          },
+          "users": {
+            "unknown": 1
+          },
+          "components": {
+            "unknown": 1
+          }
+        },
+        "window": {
+          "calls": 1,
+          "tenant_count": 1,
+          "user_count": 1,
+          "component_count": 1,
+          "tenants": {
+            "unknown": 1
+          },
+          "users": {
+            "unknown": 1
+          },
+          "components": {
+            "unknown": 1
+          }
+        },
+        "last_seen_at": "2026-08-22T22:32:56.454035Z",
+        "retirement_candidate": false,
+        "retirement_reason": "1 call(s) in review window"
+      },
+      {
+        "interface": {
+          "id": "4a70583c-1e41-4ec1-99a9-728856a7d79c",
+          "interface_key": "rest_api:POST /progress/ workstream_id",
+          "interface_kind": "rest_api",
+          "legacy_since": "2026-07-08T23:35:09.148333Z",
+          "replacement_ref": "POST /progress/ with workplan_id",
+          "owner_component": "state-hub.api",
+          "status": "retired",
+          "replacement_verified": true,
+          "manual_hold": false,
+          "hold_reason": null,
+          "notes": "Retired by STATE-WP-0079-T05 (cutover slice E2); evidence: 7d review window + volume-scaled quiet ladder, capture 2026-08-20",
+          "retired_at": "2026-08-20T05:27:20.114395Z",
+          "created_at": "2026-07-08T23:35:09.148333Z",
+          "updated_at": "2026-08-20T05:27:20.110090Z"
+        },
+        "all_time": {
+          "calls": 14,
+          "tenant_count": 1,
+          "user_count": 1,
+          "component_count": 1,
+          "tenants": {
+            "unknown": 14
+          },
+          "users": {
+            "unknown": 14
+          },
+          "components": {
+            "unknown": 14
+          }
+        },
+        "window": {
+          "calls": 0,
+          "tenant_count": 0,
+          "user_count": 0,
+          "component_count": 0,
+          "tenants": {},
+          "users": {},
+          "components": {}
+        },
+        "last_seen_at": "2026-07-10T08:34:42.959724Z",
+        "retirement_candidate": false,
+        "retirement_reason": "already retired"
+      },
+      {
+        "interface": {
+          "id": "6df4e443-7bf1-461a-923b-a6eb52fe7b07",
+          "interface_key": "rest_api:POST /tasks/ workstream_id",
+          "interface_kind": "rest_api",
+          "legacy_since": "2026-07-08T22:38:29.405720Z",
+          "replacement_ref": "POST /tasks/ with workplan_id",
+          "owner_component": "state-hub.api",
+          "status": "retired",
+          "replacement_verified": true,
+          "manual_hold": false,
+          "hold_reason": null,
+          "notes": "Retired by STATE-WP-0079-T05 (cutover slice E2); evidence: 7d review window + volume-scaled quiet ladder, capture 2026-08-20",
+          "retired_at": "2026-08-20T05:27:20.134796Z",
+          "created_at": "2026-07-08T22:38:29.405720Z",
+          "updated_at": "2026-08-20T05:27:20.131430Z"
+        },
+        "all_time": {
+          "calls": 5,
+          "tenant_count": 1,
+          "user_count": 1,
+          "component_count": 1,
+          "tenants": {
+            "unknown": 5
+          },
+          "users": {
+            "unknown": 5
+          },
+          "components": {
+            "state-hub.fix-consistency": 5
+          }
+        },
+        "window": {
+          "calls": 0,
+          "tenant_count": 0,
+          "user_count": 0,
+          "component_count": 0,
+          "tenants": {},
+          "users": {},
+          "components": {}
+        },
+        "last_seen_at": "2026-07-08T22:38:29.976918Z",
+        "retirement_candidate": false,
+        "retirement_reason": "already retired"
+      },
+      {
+        "interface": {
+          "id": "ed6451c9-d2cc-4486-9afe-d3852782cabc",
+          "interface_key": "rest_api:POST /workstreams/",
+          "interface_kind": "rest_api",
+          "legacy_since": "2026-06-04T07:40:24.168535Z",
+          "replacement_ref": "/workplans/",
+          "owner_component": "state-hub.api",
+          "status": "retired",
+          "replacement_verified": true,
+          "manual_hold": false,
+          "hold_reason": null,
+          "notes": "Retired by STATE-WP-0079-T05 (cutover slice E2); evidence: 7d review window + volume-scaled quiet ladder, capture 2026-08-20",
+          "retired_at": "2026-08-20T05:27:20.157133Z",
+          "created_at": "2026-06-04T07:40:24.168535Z",
+          "updated_at": "2026-08-20T05:27:20.150639Z"
+        },
+        "all_time": {
+          "calls": 824,
+          "tenant_count": 1,
+          "user_count": 1,
+          "component_count": 1,
+          "tenants": {
+            "unknown": 824
+          },
+          "users": {
+            "unknown": 824
+          },
+          "components": {
+            "unknown": 824
+          }
+        },
+        "window": {
+          "calls": 0,
+          "tenant_count": 0,
+          "user_count": 0,
+          "component_count": 0,
+          "tenants": {},
+          "users": {},
+          "components": {}
+        },
+        "last_seen_at": "2026-07-08T20:38:05.903144Z",
+        "retirement_candidate": false,
+        "retirement_reason": "already retired"
+      },
+      {
+        "interface": {
+          "id": "281fd706-b192-4194-8055-2d8733c115f9",
+          "interface_key": "rest_api:POST /workstreams/{workstream_id}/dependencies/",
+          "interface_kind": "rest_api",
+          "legacy_since": "2026-06-04T22:57:37.149207Z",
+          "replacement_ref": "/workplans/{workplan_id}/dependencies/",
+          "owner_component": "state-hub.api",
+          "status": "retired",
+          "replacement_verified": true,
+          "manual_hold": false,
+          "hold_reason": null,
+          "notes": "Retired by STATE-WP-0079-T05 (cutover slice E2); evidence: 7d review window + volume-scaled quiet ladder, capture 2026-08-20",
+          "retired_at": "2026-08-20T05:27:20.186201Z",
+          "created_at": "2026-06-04T22:57:37.149207Z",
+          "updated_at": "2026-08-20T05:27:20.181406Z"
+        },
+        "all_time": {
+          "calls": 4971,
+          "tenant_count": 1,
+          "user_count": 1,
+          "component_count": 1,
+          "tenants": {
+            "unknown": 4971
+          },
+          "users": {
+            "unknown": 4971
+          },
+          "components": {
+            "unknown": 4971
+          }
+        },
+        "window": {
+          "calls": 0,
+          "tenant_count": 0,
+          "user_count": 0,
+          "component_count": 0,
+          "tenants": {},
+          "users": {},
+          "components": {}
+        },
+        "last_seen_at": "2026-07-01T22:09:24.229011Z",
+        "retirement_candidate": false,
+        "retirement_reason": "already retired"
+      }
+    ],
+    "retirement_candidates": []
+  },
+  "days": 7
+}
diff --git a/docs/evidence/legacy-meter-weekly-review-20260824.json b/docs/evidence/legacy-meter-weekly-review-20260824.json
new file mode 100644
index 0000000..065a6bf
--- /dev/null
+++ b/docs/evidence/legacy-meter-weekly-review-20260824.json
@@ -0,0 +1,986 @@
+{
+  "captured_at": "2026-08-24T14:00:07.504715+00:00",
+  "api_base": "http://127.0.0.1:8000",
+  "workplan": "STATE-WP-0070",
+  "retired_interfaces": [],
+  "weekly_review": {
+    "generated_at": "2026-08-24T14:00:07.497225Z",
+    "window_start": "2026-08-17T14:00:07.419325Z",
+    "window_end": "2026-08-24T14:00:07.419325Z",
+    "cadence": "weekly",
+    "activity_core_handoff": {
+      "activity_id": "statehub-legacy-interface-review",
+      "cadence": "weekly",
+      "source_endpoint": "/legacy-meter/weekly-review",
+      "state_owner": "state-hub",
+      "scheduler_owner": "activity-core"
+    },
+    "interfaces": [
+      {
+        "interface": {
+          "id": "8051fb40-66c9-4dc4-a413-13e8573e04a3",
+          "interface_key": "event_subject:org.statehub.workstream.completed",
+          "interface_kind": "event_subject",
+          "legacy_since": "2026-06-04T06:09:42.198193Z",
+          "replacement_ref": "org.statehub.workplan.completed",
+          "owner_component": "state-hub.events",
+          "status": "retired",
+          "replacement_verified": true,
+          "manual_hold": false,
+          "hold_reason": null,
+          "notes": "Retired by STATE-WP-0069 closeout",
+          "retired_at": "2026-07-08T21:38:52.773601Z",
+          "created_at": "2026-06-04T06:09:42.198193Z",
+          "updated_at": "2026-07-08T21:38:52.761243Z"
+        },
+        "all_time": {
+          "calls": 255,
+          "tenant_count": 1,
+          "user_count": 1,
+          "component_count": 1,
+          "tenants": {
+            "unknown": 255
+          },
+          "users": {
+            "unknown": 255
+          },
+          "components": {
+            "state-hub.events": 255
+          }
+        },
+        "window": {
+          "calls": 0,
+          "tenant_count": 0,
+          "user_count": 0,
+          "component_count": 0,
+          "tenants": {},
+          "users": {},
+          "components": {}
+        },
+        "last_seen_at": "2026-07-08T20:49:12.839383Z",
+        "retirement_candidate": false,
+        "retirement_reason": "already retired"
+      },
+      {
+        "interface": {
+          "id": "63ed90e3-42b4-431a-94db-e1254a52f9e2",
+          "interface_key": "mcp:create_workstream",
+          "interface_kind": "mcp_tool",
+          "legacy_since": "2026-07-10T13:19:44.205900Z",
+          "replacement_ref": "create_workplan",
+          "owner_component": "state-hub.mcp",
+          "status": "retired",
+          "replacement_verified": true,
+          "manual_hold": false,
+          "hold_reason": null,
+          "notes": "Retired by STATE-WP-0079-T05 (cutover slice E2); evidence: 7d review window + volume-scaled quiet ladder, capture 2026-08-20",
+          "retired_at": "2026-08-20T05:27:19.851030Z",
+          "created_at": "2026-07-10T13:19:44.205900Z",
+          "updated_at": "2026-08-20T05:27:19.844807Z"
+        },
+        "all_time": {
+          "calls": 2,
+          "tenant_count": 1,
+          "user_count": 1,
+          "component_count": 1,
+          "tenants": {
+            "unknown": 2
+          },
+          "users": {
+            "unknown": 2
+          },
+          "components": {
+            "state-hub.mcp": 2
+          }
+        },
+        "window": {
+          "calls": 0,
+          "tenant_count": 0,
+          "user_count": 0,
+          "component_count": 0,
+          "tenants": {},
+          "users": {},
+          "components": {}
+        },
+        "last_seen_at": "2026-07-10T13:20:43.378546Z",
+        "retirement_candidate": false,
+        "retirement_reason": "already retired"
+      },
+      {
+        "interface": {
+          "id": "b6a5fe44-fb85-4ef7-a273-78d09da777af",
+          "interface_key": "mcp:list_workstreams",
+          "interface_kind": "mcp_tool",
+          "legacy_since": "2026-07-10T13:19:26.075491Z",
+          "replacement_ref": "list_workplans",
+          "owner_component": "state-hub.mcp",
+          "status": "retired",
+          "replacement_verified": true,
+          "manual_hold": false,
+          "hold_reason": null,
+          "notes": "Retired by STATE-WP-0079-T05 (cutover slice E2); evidence: 7d review window + volume-scaled quiet ladder, capture 2026-08-20",
+          "retired_at": "2026-08-20T05:27:19.883196Z",
+          "created_at": "2026-07-10T13:19:26.075491Z",
+          "updated_at": "2026-08-20T05:27:19.876635Z"
+        },
+        "all_time": {
+          "calls": 2,
+          "tenant_count": 1,
+          "user_count": 1,
+          "component_count": 1,
+          "tenants": {
+            "unknown": 2
+          },
+          "users": {
+            "unknown": 2
+          },
+          "components": {
+            "state-hub.mcp": 2
+          }
+        },
+        "window": {
+          "calls": 0,
+          "tenant_count": 0,
+          "user_count": 0,
+          "component_count": 0,
+          "tenants": {},
+          "users": {},
+          "components": {}
+        },
+        "last_seen_at": "2026-07-10T13:20:42.374940Z",
+        "retirement_candidate": false,
+        "retirement_reason": "already retired"
+      },
+      {
+        "interface": {
+          "id": "53c3372b-307d-4d6a-8ea4-bc36cacdcaf2",
+          "interface_key": "mcp:update_workstream",
+          "interface_kind": "mcp_tool",
+          "legacy_since": "2026-07-10T13:19:44.255216Z",
+          "replacement_ref": "update_workplan",
+          "owner_component": "state-hub.mcp",
+          "status": "retired",
+          "replacement_verified": true,
+          "manual_hold": false,
+          "hold_reason": null,
+          "notes": "Retired by STATE-WP-0079-T05 (cutover slice E2); evidence: 7d review window + volume-scaled quiet ladder, capture 2026-08-20",
+          "retired_at": "2026-08-20T05:27:19.907081Z",
+          "created_at": "2026-07-10T13:19:44.255216Z",
+          "updated_at": "2026-08-20T05:27:19.902177Z"
+        },
+        "all_time": {
+          "calls": 0,
+          "tenant_count": 0,
+          "user_count": 0,
+          "component_count": 0,
+          "tenants": {},
+          "users": {},
+          "components": {}
+        },
+        "window": {
+          "calls": 0,
+          "tenant_count": 0,
+          "user_count": 0,
+          "component_count": 0,
+          "tenants": {},
+          "users": {},
+          "components": {}
+        },
+        "last_seen_at": null,
+        "retirement_candidate": false,
+        "retirement_reason": "already retired"
+      },
+      {
+        "interface": {
+          "id": "bed4d08a-3471-48f5-9f0e-f9d550383a26",
+          "interface_key": "mcp:update_workstream_status",
+          "interface_kind": "mcp_tool",
+          "legacy_since": "2026-07-10T13:19:44.303612Z",
+          "replacement_ref": "update_workplan_status",
+          "owner_component": "state-hub.mcp",
+          "status": "retired",
+          "replacement_verified": true,
+          "manual_hold": false,
+          "hold_reason": null,
+          "notes": "Retired by STATE-WP-0079-T05 (cutover slice E2); evidence: 7d review window + volume-scaled quiet ladder, capture 2026-08-20",
+          "retired_at": "2026-08-20T05:27:19.928988Z",
+          "created_at": "2026-07-10T13:19:44.303612Z",
+          "updated_at": "2026-08-20T05:27:19.925652Z"
+        },
+        "all_time": {
+          "calls": 0,
+          "tenant_count": 0,
+          "user_count": 0,
+          "component_count": 0,
+          "tenants": {},
+          "users": {},
+          "components": {}
+        },
+        "window": {
+          "calls": 0,
+          "tenant_count": 0,
+          "user_count": 0,
+          "component_count": 0,
+          "tenants": {},
+          "users": {},
+          "components": {}
+        },
+        "last_seen_at": null,
+        "retirement_candidate": false,
+        "retirement_reason": "already retired"
+      },
+      {
+        "interface": {
+          "id": "46900dc2-0893-405b-ba59-80f31fb6ebb1",
+          "interface_key": "state://workstreams/{topic_slug}",
+          "interface_kind": "mcp_tool",
+          "legacy_since": "2026-07-10T13:19:44.344493Z",
+          "replacement_ref": "state://workplans/{topic_slug}",
+          "owner_component": "state-hub.mcp",
+          "status": "retired",
+          "replacement_verified": true,
+          "manual_hold": false,
+          "hold_reason": null,
+          "notes": "Retired by STATE-WP-0079-T05 (cutover slice E2); evidence: 7d review window + volume-scaled quiet ladder, capture 2026-08-20",
+          "retired_at": "2026-08-20T05:27:19.948467Z",
+          "created_at": "2026-07-10T13:19:44.344493Z",
+          "updated_at": "2026-08-20T05:27:19.944874Z"
+        },
+        "all_time": {
+          "calls": 1,
+          "tenant_count": 1,
+          "user_count": 1,
+          "component_count": 1,
+          "tenants": {
+            "unknown": 1
+          },
+          "users": {
+            "unknown": 1
+          },
+          "components": {
+            "state-hub.mcp": 1
+          }
+        },
+        "window": {
+          "calls": 0,
+          "tenant_count": 0,
+          "user_count": 0,
+          "component_count": 0,
+          "tenants": {},
+          "users": {},
+          "components": {}
+        },
+        "last_seen_at": "2026-07-10T13:20:34.491811Z",
+        "retirement_candidate": false,
+        "retirement_reason": "already retired"
+      },
+      {
+        "interface": {
+          "id": "cd9342fd-27e7-4a46-a1be-d41499e106a3",
+          "interface_key": "rest_api:DELETE /workstreams/{workstream_id}",
+          "interface_kind": "rest_api",
+          "legacy_since": "2026-06-06T17:28:13.052813Z",
+          "replacement_ref": "/workplans/{workplan_id}",
+          "owner_component": "state-hub.api",
+          "status": "retired",
+          "replacement_verified": true,
+          "manual_hold": false,
+          "hold_reason": null,
+          "notes": "Retired by STATE-WP-0079-T05 (cutover slice E2); evidence: 7d review window + volume-scaled quiet ladder, capture 2026-08-20",
+          "retired_at": "2026-08-20T05:27:19.972086Z",
+          "created_at": "2026-06-06T17:28:13.052813Z",
+          "updated_at": "2026-08-20T05:27:19.966289Z"
+        },
+        "all_time": {
+          "calls": 1,
+          "tenant_count": 1,
+          "user_count": 1,
+          "component_count": 1,
+          "tenants": {
+            "unknown": 1
+          },
+          "users": {
+            "unknown": 1
+          },
+          "components": {
+            "unknown": 1
+          }
+        },
+        "window": {
+          "calls": 0,
+          "tenant_count": 0,
+          "user_count": 0,
+          "component_count": 0,
+          "tenants": {},
+          "users": {},
+          "components": {}
+        },
+        "last_seen_at": "2026-06-06T17:28:13.047529Z",
+        "retirement_candidate": false,
+        "retirement_reason": "already retired"
+      },
+      {
+        "interface": {
+          "id": "a4e0948c-cd4a-461e-8ae2-7fd7b51d04a7",
+          "interface_key": "rest_api:GET /decisions/?workstream_id",
+          "interface_kind": "rest_api",
+          "legacy_since": "2026-07-09T23:07:53.093223Z",
+          "replacement_ref": "/decisions/?workplan_id=<workplan_id>",
+          "owner_component": "state-hub.api",
+          "status": "retired",
+          "replacement_verified": true,
+          "manual_hold": false,
+          "hold_reason": null,
+          "notes": "Retired by STATE-WP-0079-T05 (cutover slice E2); evidence: 7d review window + volume-scaled quiet ladder, capture 2026-08-20",
+          "retired_at": "2026-08-20T05:27:19.996130Z",
+          "created_at": "2026-07-09T23:07:53.093223Z",
+          "updated_at": "2026-08-20T05:27:19.991877Z"
+        },
+        "all_time": {
+          "calls": 1,
+          "tenant_count": 1,
+          "user_count": 1,
+          "component_count": 1,
+          "tenants": {
+            "unknown": 1
+          },
+          "users": {
+            "unknown": 1
+          },
+          "components": {
+            "unknown": 1
+          }
+        },
+        "window": {
+          "calls": 0,
+          "tenant_count": 0,
+          "user_count": 0,
+          "component_count": 0,
+          "tenants": {},
+          "users": {},
+          "components": {}
+        },
+        "last_seen_at": "2026-07-09T23:07:53.083299Z",
+        "retirement_candidate": false,
+        "retirement_reason": "already retired"
+      },
+      {
+        "interface": {
+          "id": "70a9346e-e0ee-42ac-874f-f160580b54dd",
+          "interface_key": "rest_api:GET /progress/?workstream_id",
+          "interface_kind": "rest_api",
+          "legacy_since": "2026-07-13T22:04:03.911449Z",
+          "replacement_ref": "/progress/?workplan_id=<workplan_id>",
+          "owner_component": "state-hub.api",
+          "status": "retired",
+          "replacement_verified": true,
+          "manual_hold": false,
+          "hold_reason": null,
+          "notes": "Retired by STATE-WP-0079-T05 (cutover slice E2); evidence: 7d review window + volume-scaled quiet ladder, capture 2026-08-20",
+          "retired_at": "2026-08-20T05:27:20.017065Z",
+          "created_at": "2026-07-13T22:04:03.911449Z",
+          "updated_at": "2026-08-20T05:27:20.013500Z"
+        },
+        "all_time": {
+          "calls": 3,
+          "tenant_count": 1,
+          "user_count": 1,
+          "component_count": 1,
+          "tenants": {
+            "unknown": 3
+          },
+          "users": {
+            "unknown": 3
+          },
+          "components": {
+            "unknown": 3
+          }
+        },
+        "window": {
+          "calls": 1,
+          "tenant_count": 1,
+          "user_count": 1,
+          "component_count": 1,
+          "tenants": {
+            "unknown": 1
+          },
+          "users": {
+            "unknown": 1
+          },
+          "components": {
+            "unknown": 1
+          }
+        },
+        "last_seen_at": "2026-08-22T20:15:43.595231Z",
+        "retirement_candidate": false,
+        "retirement_reason": "already retired"
+      },
+      {
+        "interface": {
+          "id": "be3cdcf8-250b-4bf0-801f-02ffd5f57e00",
+          "interface_key": "rest_api:GET /tasks/?workstream_id",
+          "interface_kind": "rest_api",
+          "legacy_since": "2026-07-08T19:32:21.628513Z",
+          "replacement_ref": "/tasks/?workplan_id=<workplan_id>",
+          "owner_component": "state-hub.api",
+          "status": "legacy",
+          "replacement_verified": true,
+          "manual_hold": false,
+          "hold_reason": null,
+          "notes": null,
+          "retired_at": null,
+          "created_at": "2026-07-08T19:32:21.628513Z",
+          "updated_at": "2026-07-08T19:32:21.628513Z"
+        },
+        "all_time": {
+          "calls": 596,
+          "tenant_count": 1,
+          "user_count": 1,
+          "component_count": 1,
+          "tenants": {
+            "unknown": 596
+          },
+          "users": {
+            "unknown": 596
+          },
+          "components": {
+            "unknown": 596
+          }
+        },
+        "window": {
+          "calls": 6,
+          "tenant_count": 1,
+          "user_count": 1,
+          "component_count": 1,
+          "tenants": {
+            "unknown": 6
+          },
+          "users": {
+            "unknown": 6
+          },
+          "components": {
+            "unknown": 6
+          }
+        },
+        "last_seen_at": "2026-08-20T20:57:26.985884Z",
+        "retirement_candidate": false,
+        "retirement_reason": "6 call(s) in review window"
+      },
+      {
+        "interface": {
+          "id": "3e4a3d0b-08fa-45c3-91e2-4f514a914b97",
+          "interface_key": "rest_api:GET /workstreams/",
+          "interface_kind": "rest_api",
+          "legacy_since": "2026-06-04T00:26:14.533764Z",
+          "replacement_ref": "/workplans/",
+          "owner_component": "state-hub.api",
+          "status": "legacy",
+          "replacement_verified": true,
+          "manual_hold": false,
+          "hold_reason": null,
+          "notes": null,
+          "retired_at": null,
+          "created_at": "2026-06-04T00:26:14.533764Z",
+          "updated_at": "2026-06-04T00:26:14.533764Z"
+        },
+        "all_time": {
+          "calls": 144087,
+          "tenant_count": 1,
+          "user_count": 1,
+          "component_count": 1,
+          "tenants": {
+            "unknown": 144087
+          },
+          "users": {
+            "unknown": 144087
+          },
+          "components": {
+            "unknown": 144087
+          }
+        },
+        "window": {
+          "calls": 1,
+          "tenant_count": 1,
+          "user_count": 1,
+          "component_count": 1,
+          "tenants": {
+            "unknown": 1
+          },
+          "users": {
+            "unknown": 1
+          },
+          "components": {
+            "unknown": 1
+          }
+        },
+        "last_seen_at": "2026-08-21T22:29:25.068158Z",
+        "retirement_candidate": false,
+        "retirement_reason": "1 call(s) in review window"
+      },
+      {
+        "interface": {
+          "id": "e4c140ec-7479-46f9-b185-4b533f19d639",
+          "interface_key": "rest_api:GET /workstreams/workplan-index",
+          "interface_kind": "rest_api",
+          "legacy_since": "2026-06-04T05:20:58.321869Z",
+          "replacement_ref": "/workplans/index",
+          "owner_component": "state-hub.api",
+          "status": "retired",
+          "replacement_verified": true,
+          "manual_hold": false,
+          "hold_reason": null,
+          "notes": "Retired by STATE-WP-0079-T05 (cutover slice E2); evidence: 7d review window + volume-scaled quiet ladder, capture 2026-08-20",
+          "retired_at": "2026-08-20T05:27:20.041850Z",
+          "created_at": "2026-06-04T05:20:58.321869Z",
+          "updated_at": "2026-08-20T05:27:20.035160Z"
+        },
+        "all_time": {
+          "calls": 30,
+          "tenant_count": 1,
+          "user_count": 1,
+          "component_count": 1,
+          "tenants": {
+            "unknown": 30
+          },
+          "users": {
+            "unknown": 30
+          },
+          "components": {
+            "unknown": 30
+          }
+        },
+        "window": {
+          "calls": 0,
+          "tenant_count": 0,
+          "user_count": 0,
+          "component_count": 0,
+          "tenants": {},
+          "users": {},
+          "components": {}
+        },
+        "last_seen_at": "2026-07-03T05:20:34.534439Z",
+        "retirement_candidate": false,
+        "retirement_reason": "already retired"
+      },
+      {
+        "interface": {
+          "id": "3a00b19e-e7db-4403-98aa-a77c9ab61ecc",
+          "interface_key": "rest_api:GET /workstreams/{workstream_id}",
+          "interface_kind": "rest_api",
+          "legacy_since": "2026-06-04T00:25:59.014966Z",
+          "replacement_ref": "/workplans/{workplan_id}",
+          "owner_component": "state-hub.api",
+          "status": "legacy",
+          "replacement_verified": true,
+          "manual_hold": false,
+          "hold_reason": null,
+          "notes": null,
+          "retired_at": null,
+          "created_at": "2026-06-04T00:25:59.014966Z",
+          "updated_at": "2026-06-04T00:25:59.014966Z"
+        },
+        "all_time": {
+          "calls": 511408,
+          "tenant_count": 1,
+          "user_count": 1,
+          "component_count": 1,
+          "tenants": {
+            "unknown": 511408
+          },
+          "users": {
+            "unknown": 511408
+          },
+          "components": {
+            "unknown": 511408
+          }
+        },
+        "window": {
+          "calls": 2,
+          "tenant_count": 1,
+          "user_count": 1,
+          "component_count": 1,
+          "tenants": {
+            "unknown": 2
+          },
+          "users": {
+            "unknown": 2
+          },
+          "components": {
+            "unknown": 2
+          }
+        },
+        "last_seen_at": "2026-08-22T14:49:00.884854Z",
+        "retirement_candidate": false,
+        "retirement_reason": "2 call(s) in review window"
+      },
+      {
+        "interface": {
+          "id": "69e1a255-a8b9-4101-8a68-b1bed23abfda",
+          "interface_key": "rest_api:GET /workstreams/{workstream_id}/dependencies/",
+          "interface_kind": "rest_api",
+          "legacy_since": "2026-06-04T00:25:59.291135Z",
+          "replacement_ref": "/workplans/{workplan_id}/dependencies/",
+          "owner_component": "state-hub.api",
+          "status": "legacy",
+          "replacement_verified": true,
+          "manual_hold": false,
+          "hold_reason": null,
+          "notes": null,
+          "retired_at": null,
+          "created_at": "2026-06-04T00:25:59.291135Z",
+          "updated_at": "2026-06-04T00:25:59.291135Z"
+        },
+        "all_time": {
+          "calls": 255865,
+          "tenant_count": 1,
+          "user_count": 1,
+          "component_count": 1,
+          "tenants": {
+            "unknown": 255865
+          },
+          "users": {
+            "unknown": 255865
+          },
+          "components": {
+            "unknown": 255865
+          }
+        },
+        "window": {
+          "calls": 0,
+          "tenant_count": 0,
+          "user_count": 0,
+          "component_count": 0,
+          "tenants": {},
+          "users": {},
+          "components": {}
+        },
+        "last_seen_at": "2026-07-08T21:14:12.747005Z",
+        "retirement_candidate": false,
+        "retirement_reason": "quiet 46d of 60d required for 255865 all-time call(s)"
+      },
+      {
+        "interface": {
+          "id": "b1aae931-b51f-4a85-a723-865dd65f6132",
+          "interface_key": "rest_api:PATCH /workstreams/{workstream_id}",
+          "interface_kind": "rest_api",
+          "legacy_since": "2026-06-04T06:09:41.901035Z",
+          "replacement_ref": "/workplans/{workplan_id}",
+          "owner_component": "state-hub.api",
+          "status": "retired",
+          "replacement_verified": true,
+          "manual_hold": false,
+          "hold_reason": null,
+          "notes": "Retired by STATE-WP-0079-T05 (cutover slice E2); evidence: 7d review window + volume-scaled quiet ladder, capture 2026-08-20",
+          "retired_at": "2026-08-20T05:27:20.069758Z",
+          "created_at": "2026-06-04T06:09:41.901035Z",
+          "updated_at": "2026-08-20T05:27:20.062648Z"
+        },
+        "all_time": {
+          "calls": 571,
+          "tenant_count": 1,
+          "user_count": 1,
+          "component_count": 1,
+          "tenants": {
+            "unknown": 571
+          },
+          "users": {
+            "unknown": 571
+          },
+          "components": {
+            "unknown": 571
+          }
+        },
+        "window": {
+          "calls": 0,
+          "tenant_count": 0,
+          "user_count": 0,
+          "component_count": 0,
+          "tenants": {},
+          "users": {},
+          "components": {}
+        },
+        "last_seen_at": "2026-07-08T20:49:12.335710Z",
+        "retirement_candidate": false,
+        "retirement_reason": "already retired"
+      },
+      {
+        "interface": {
+          "id": "4aea9591-970b-4918-ac4a-4da95a0a1a8c",
+          "interface_key": "rest_api:POST /decisions/ workstream_id",
+          "interface_kind": "rest_api",
+          "legacy_since": "2026-07-09T22:56:35.473130Z",
+          "replacement_ref": "POST /decisions/ with workplan_id",
+          "owner_component": "state-hub.api",
+          "status": "retired",
+          "replacement_verified": true,
+          "manual_hold": false,
+          "hold_reason": null,
+          "notes": "Retired by STATE-WP-0079-T05 (cutover slice E2); evidence: 7d review window + volume-scaled quiet ladder, capture 2026-08-20",
+          "retired_at": "2026-08-20T05:27:20.093372Z",
+          "created_at": "2026-07-09T22:56:35.473130Z",
+          "updated_at": "2026-08-20T05:27:20.090180Z"
+        },
+        "all_time": {
+          "calls": 3,
+          "tenant_count": 1,
+          "user_count": 1,
+          "component_count": 1,
+          "tenants": {
+            "unknown": 3
+          },
+          "users": {
+            "unknown": 3
+          },
+          "components": {
+            "unknown": 3
+          }
+        },
+        "window": {
+          "calls": 0,
+          "tenant_count": 0,
+          "user_count": 0,
+          "component_count": 0,
+          "tenants": {},
+          "users": {},
+          "components": {}
+        },
+        "last_seen_at": "2026-07-09T22:57:05.912456Z",
+        "retirement_candidate": false,
+        "retirement_reason": "already retired"
+      },
+      {
+        "interface": {
+          "id": "5cb69159-f2b0-4a33-9456-ab93efee5f89",
+          "interface_key": "rest_api:POST /execution/launch-requests",
+          "interface_kind": "rest_api",
+          "legacy_since": "2026-08-22T22:32:56.668016Z",
+          "replacement_ref": "repo file queue or activity-core ActivityDefinition + ops_run",
+          "owner_component": "state-hub.api",
+          "status": "legacy",
+          "replacement_verified": true,
+          "manual_hold": false,
+          "hold_reason": null,
+          "notes": null,
+          "retired_at": null,
+          "created_at": "2026-08-22T22:32:56.668016Z",
+          "updated_at": "2026-08-22T22:32:56.668016Z"
+        },
+        "all_time": {
+          "calls": 1,
+          "tenant_count": 1,
+          "user_count": 1,
+          "component_count": 1,
+          "tenants": {
+            "unknown": 1
+          },
+          "users": {
+            "unknown": 1
+          },
+          "components": {
+            "unknown": 1
+          }
+        },
+        "window": {
+          "calls": 1,
+          "tenant_count": 1,
+          "user_count": 1,
+          "component_count": 1,
+          "tenants": {
+            "unknown": 1
+          },
+          "users": {
+            "unknown": 1
+          },
+          "components": {
+            "unknown": 1
+          }
+        },
+        "last_seen_at": "2026-08-22T22:32:56.454035Z",
+        "retirement_candidate": false,
+        "retirement_reason": "1 call(s) in review window"
+      },
+      {
+        "interface": {
+          "id": "4a70583c-1e41-4ec1-99a9-728856a7d79c",
+          "interface_key": "rest_api:POST /progress/ workstream_id",
+          "interface_kind": "rest_api",
+          "legacy_since": "2026-07-08T23:35:09.148333Z",
+          "replacement_ref": "POST /progress/ with workplan_id",
+          "owner_component": "state-hub.api",
+          "status": "retired",
+          "replacement_verified": true,
+          "manual_hold": false,
+          "hold_reason": null,
+          "notes": "Retired by STATE-WP-0079-T05 (cutover slice E2); evidence: 7d review window + volume-scaled quiet ladder, capture 2026-08-20",
+          "retired_at": "2026-08-20T05:27:20.114395Z",
+          "created_at": "2026-07-08T23:35:09.148333Z",
+          "updated_at": "2026-08-20T05:27:20.110090Z"
+        },
+        "all_time": {
+          "calls": 14,
+          "tenant_count": 1,
+          "user_count": 1,
+          "component_count": 1,
+          "tenants": {
+            "unknown": 14
+          },
+          "users": {
+            "unknown": 14
+          },
+          "components": {
+            "unknown": 14
+          }
+        },
+        "window": {
+          "calls": 0,
+          "tenant_count": 0,
+          "user_count": 0,
+          "component_count": 0,
+          "tenants": {},
+          "users": {},
+          "components": {}
+        },
+        "last_seen_at": "2026-07-10T08:34:42.959724Z",
+        "retirement_candidate": false,
+        "retirement_reason": "already retired"
+      },
+      {
+        "interface": {
+          "id": "6df4e443-7bf1-461a-923b-a6eb52fe7b07",
+          "interface_key": "rest_api:POST /tasks/ workstream_id",
+          "interface_kind": "rest_api",
+          "legacy_since": "2026-07-08T22:38:29.405720Z",
+          "replacement_ref": "POST /tasks/ with workplan_id",
+          "owner_component": "state-hub.api",
+          "status": "retired",
+          "replacement_verified": true,
+          "manual_hold": false,
+          "hold_reason": null,
+          "notes": "Retired by STATE-WP-0079-T05 (cutover slice E2); evidence: 7d review window + volume-scaled quiet ladder, capture 2026-08-20",
+          "retired_at": "2026-08-20T05:27:20.134796Z",
+          "created_at": "2026-07-08T22:38:29.405720Z",
+          "updated_at": "2026-08-20T05:27:20.131430Z"
+        },
+        "all_time": {
+          "calls": 5,
+          "tenant_count": 1,
+          "user_count": 1,
+          "component_count": 1,
+          "tenants": {
+            "unknown": 5
+          },
+          "users": {
+            "unknown": 5
+          },
+          "components": {
+            "state-hub.fix-consistency": 5
+          }
+        },
+        "window": {
+          "calls": 0,
+          "tenant_count": 0,
+          "user_count": 0,
+          "component_count": 0,
+          "tenants": {},
+          "users": {},
+          "components": {}
+        },
+        "last_seen_at": "2026-07-08T22:38:29.976918Z",
+        "retirement_candidate": false,
+        "retirement_reason": "already retired"
+      },
+      {
+        "interface": {
+          "id": "ed6451c9-d2cc-4486-9afe-d3852782cabc",
+          "interface_key": "rest_api:POST /workstreams/",
+          "interface_kind": "rest_api",
+          "legacy_since": "2026-06-04T07:40:24.168535Z",
+          "replacement_ref": "/workplans/",
+          "owner_component": "state-hub.api",
+          "status": "retired",
+          "replacement_verified": true,
+          "manual_hold": false,
+          "hold_reason": null,
+          "notes": "Retired by STATE-WP-0079-T05 (cutover slice E2); evidence: 7d review window + volume-scaled quiet ladder, capture 2026-08-20",
+          "retired_at": "2026-08-20T05:27:20.157133Z",
+          "created_at": "2026-06-04T07:40:24.168535Z",
+          "updated_at": "2026-08-20T05:27:20.150639Z"
+        },
+        "all_time": {
+          "calls": 824,
+          "tenant_count": 1,
+          "user_count": 1,
+          "component_count": 1,
+          "tenants": {
+            "unknown": 824
+          },
+          "users": {
+            "unknown": 824
+          },
+          "components": {
+            "unknown": 824
+          }
+        },
+        "window": {
+          "calls": 0,
+          "tenant_count": 0,
+          "user_count": 0,
+          "component_count": 0,
+          "tenants": {},
+          "users": {},
+          "components": {}
+        },
+        "last_seen_at": "2026-07-08T20:38:05.903144Z",
+        "retirement_candidate": false,
+        "retirement_reason": "already retired"
+      },
+      {
+        "interface": {
+          "id": "281fd706-b192-4194-8055-2d8733c115f9",
+          "interface_key": "rest_api:POST /workstreams/{workstream_id}/dependencies/",
+          "interface_kind": "rest_api",
+          "legacy_since": "2026-06-04T22:57:37.149207Z",
+          "replacement_ref": "/workplans/{workplan_id}/dependencies/",
+          "owner_component": "state-hub.api",
+          "status": "retired",
+          "replacement_verified": true,
+          "manual_hold": false,
+          "hold_reason": null,
+          "notes": "Retired by STATE-WP-0079-T05 (cutover slice E2); evidence: 7d review window + volume-scaled quiet ladder, capture 2026-08-20",
+          "retired_at": "2026-08-20T05:27:20.186201Z",
+          "created_at": "2026-06-04T22:57:37.149207Z",
+          "updated_at": "2026-08-20T05:27:20.181406Z"
+        },
+        "all_time": {
+          "calls": 4971,
+          "tenant_count": 1,
+          "user_count": 1,
+          "component_count": 1,
+          "tenants": {
+            "unknown": 4971
+          },
+          "users": {
+            "unknown": 4971
+          },
+          "components": {
+            "unknown": 4971
+          }
+        },
+        "window": {
+          "calls": 0,
+          "tenant_count": 0,
+          "user_count": 0,
+          "component_count": 0,
+          "tenants": {},
+          "users": {},
+          "components": {}
+        },
+        "last_seen_at": "2026-07-01T22:09:24.229011Z",
+        "retirement_candidate": false,
+        "retirement_reason": "already retired"
+      }
+    ],
+    "retirement_candidates": []
+  },
+  "days": 7
+}
diff --git a/docs/evidence/legacy-meter-weekly-review-20260825.json b/docs/evidence/legacy-meter-weekly-review-20260825.json
new file mode 100644
index 0000000..918c8ed
--- /dev/null
+++ b/docs/evidence/legacy-meter-weekly-review-20260825.json
@@ -0,0 +1,882 @@
+{
+  "captured_at": "2026-08-25T14:00:04.748801+00:00",
+  "api_base": "http://127.0.0.1:8000",
+  "workplan": "STATE-WP-0070",
+  "retired_interfaces": [],
+  "weekly_review": {
+    "generated_at": "2026-08-25T14:00:06.897504Z",
+    "window_start": "2026-08-18T14:00:06.353209Z",
+    "window_end": "2026-08-25T14:00:06.353209Z",
+    "cadence": "weekly",
+    "activity_core_handoff": {
+      "activity_id": "statehub-legacy-interface-review",
+      "cadence": "weekly",
+      "source_endpoint": "/legacy-meter/weekly-review",
+      "state_owner": "state-hub",
+      "scheduler_owner": "activity-core"
+    },
+    "interfaces": [
+      {
+        "interface": {
+          "id": "8051fb40-66c9-4dc4-a413-13e8573e04a3",
+          "interface_key": "event_subject:org.statehub.workstream.completed",
+          "interface_kind": "event_subject",
+          "legacy_since": "2026-06-04T06:09:42.198193Z",
+          "replacement_ref": "org.statehub.workplan.completed",
+          "owner_component": "state-hub.events",
+          "status": "legacy",
+          "replacement_verified": true,
+          "manual_hold": false,
+          "hold_reason": null,
+          "notes": null,
+          "retired_at": null,
+          "created_at": "2026-06-04T06:09:42.198193Z",
+          "updated_at": "2026-06-04T06:09:42.198193Z"
+        },
+        "all_time": {
+          "calls": 247,
+          "tenant_count": 1,
+          "user_count": 1,
+          "component_count": 1,
+          "tenants": {
+            "unknown": 247
+          },
+          "users": {
+            "unknown": 247
+          },
+          "components": {
+            "state-hub.events": 247
+          }
+        },
+        "window": {
+          "calls": 0,
+          "tenant_count": 0,
+          "user_count": 0,
+          "component_count": 0,
+          "tenants": {},
+          "users": {},
+          "components": {}
+        },
+        "last_seen_at": "2026-07-13T13:22:00.748140Z",
+        "retirement_candidate": true,
+        "retirement_reason": "no usage in review window; quiet 43d (>= 30d required for 247 all-time call(s))"
+      },
+      {
+        "interface": {
+          "id": "cd9342fd-27e7-4a46-a1be-d41499e106a3",
+          "interface_key": "rest_api:DELETE /workstreams/{workstream_id}",
+          "interface_kind": "rest_api",
+          "legacy_since": "2026-06-06T17:28:13.052813Z",
+          "replacement_ref": "/workplans/{workplan_id}",
+          "owner_component": "state-hub.api",
+          "status": "legacy",
+          "replacement_verified": true,
+          "manual_hold": false,
+          "hold_reason": null,
+          "notes": null,
+          "retired_at": null,
+          "created_at": "2026-06-06T17:28:13.052813Z",
+          "updated_at": "2026-06-06T17:28:13.052813Z"
+        },
+        "all_time": {
+          "calls": 1,
+          "tenant_count": 1,
+          "user_count": 1,
+          "component_count": 1,
+          "tenants": {
+            "unknown": 1
+          },
+          "users": {
+            "unknown": 1
+          },
+          "components": {
+            "unknown": 1
+          }
+        },
+        "window": {
+          "calls": 0,
+          "tenant_count": 0,
+          "user_count": 0,
+          "component_count": 0,
+          "tenants": {},
+          "users": {},
+          "components": {}
+        },
+        "last_seen_at": "2026-06-06T17:28:13.047529Z",
+        "retirement_candidate": true,
+        "retirement_reason": "no usage in review window; quiet 79d (>= 7d required for 1 all-time call(s))"
+      },
+      {
+        "interface": {
+          "id": "d0294dce-7913-4268-94c3-1b2502aefb0f",
+          "interface_key": "rest_api:GET /sbom/",
+          "interface_kind": "rest_api",
+          "legacy_since": "2026-08-22T17:06:38.703608Z",
+          "replacement_ref": "sbom-nexus:/sbom/",
+          "owner_component": "state-hub.sbom-compat",
+          "status": "legacy",
+          "replacement_verified": true,
+          "manual_hold": false,
+          "hold_reason": null,
+          "notes": null,
+          "retired_at": null,
+          "created_at": "2026-08-22T17:06:38.703608Z",
+          "updated_at": "2026-08-22T17:23:43.730661Z"
+        },
+        "all_time": {
+          "calls": 4,
+          "tenant_count": 1,
+          "user_count": 1,
+          "component_count": 1,
+          "tenants": {
+            "unknown": 4
+          },
+          "users": {
+            "unknown": 4
+          },
+          "components": {
+            "unknown": 4
+          }
+        },
+        "window": {
+          "calls": 4,
+          "tenant_count": 1,
+          "user_count": 1,
+          "component_count": 1,
+          "tenants": {
+            "unknown": 4
+          },
+          "users": {
+            "unknown": 4
+          },
+          "components": {
+            "unknown": 4
+          }
+        },
+        "last_seen_at": "2026-08-22T17:23:46.146788Z",
+        "retirement_candidate": false,
+        "retirement_reason": "4 call(s) in review window"
+      },
+      {
+        "interface": {
+          "id": "2f77ac12-8c97-4974-a2f9-2996927982d1",
+          "interface_key": "rest_api:GET /sbom/report/licences/",
+          "interface_kind": "rest_api",
+          "legacy_since": "2026-08-22T17:06:41.978426Z",
+          "replacement_ref": "sbom-nexus:/sbom/",
+          "owner_component": "state-hub.sbom-compat",
+          "status": "legacy",
+          "replacement_verified": true,
+          "manual_hold": false,
+          "hold_reason": null,
+          "notes": null,
+          "retired_at": null,
+          "created_at": "2026-08-22T17:06:41.978426Z",
+          "updated_at": "2026-08-22T17:23:44.794796Z"
+        },
+        "all_time": {
+          "calls": 4,
+          "tenant_count": 1,
+          "user_count": 1,
+          "component_count": 1,
+          "tenants": {
+            "unknown": 4
+          },
+          "users": {
+            "unknown": 4
+          },
+          "components": {
+            "unknown": 4
+          }
+        },
+        "window": {
+          "calls": 4,
+          "tenant_count": 1,
+          "user_count": 1,
+          "component_count": 1,
+          "tenants": {
+            "unknown": 4
+          },
+          "users": {
+            "unknown": 4
+          },
+          "components": {
+            "unknown": 4
+          }
+        },
+        "last_seen_at": "2026-08-22T17:56:34.405129Z",
+        "retirement_candidate": false,
+        "retirement_reason": "4 call(s) in review window"
+      },
+      {
+        "interface": {
+          "id": "b627edf5-3302-4366-ba2e-547d32f634b5",
+          "interface_key": "rest_api:GET /sbom/snapshots/",
+          "interface_kind": "rest_api",
+          "legacy_since": "2026-08-22T17:06:37.057774Z",
+          "replacement_ref": "sbom-nexus:/sbom/",
+          "owner_component": "state-hub.sbom-compat",
+          "status": "legacy",
+          "replacement_verified": true,
+          "manual_hold": false,
+          "hold_reason": null,
+          "notes": null,
+          "retired_at": null,
+          "created_at": "2026-08-22T17:06:37.057774Z",
+          "updated_at": "2026-08-22T17:22:15.080213Z"
+        },
+        "all_time": {
+          "calls": 5,
+          "tenant_count": 1,
+          "user_count": 1,
+          "component_count": 1,
+          "tenants": {
+            "unknown": 5
+          },
+          "users": {
+            "unknown": 5
+          },
+          "components": {
+            "unknown": 5
+          }
+        },
+        "window": {
+          "calls": 5,
+          "tenant_count": 1,
+          "user_count": 1,
+          "component_count": 1,
+          "tenants": {
+            "unknown": 5
+          },
+          "users": {
+            "unknown": 5
+          },
+          "components": {
+            "unknown": 5
+          }
+        },
+        "last_seen_at": "2026-08-22T17:23:53.844021Z",
+        "retirement_candidate": false,
+        "retirement_reason": "5 call(s) in review window"
+      },
+      {
+        "interface": {
+          "id": "d03ee274-cd6f-4cd5-8f22-e4d298416299",
+          "interface_key": "rest_api:GET /sbom/snapshots/{snapshot_id}",
+          "interface_kind": "rest_api",
+          "legacy_since": "2026-08-22T17:23:45.969876Z",
+          "replacement_ref": "sbom-nexus:/sbom/",
+          "owner_component": "state-hub.sbom-compat",
+          "status": "legacy",
+          "replacement_verified": true,
+          "manual_hold": false,
+          "hold_reason": null,
+          "notes": null,
+          "retired_at": null,
+          "created_at": "2026-08-22T17:23:45.969876Z",
+          "updated_at": "2026-08-22T17:23:45.969876Z"
+        },
+        "all_time": {
+          "calls": 1,
+          "tenant_count": 1,
+          "user_count": 1,
+          "component_count": 1,
+          "tenants": {
+            "unknown": 1
+          },
+          "users": {
+            "unknown": 1
+          },
+          "components": {
+            "unknown": 1
+          }
+        },
+        "window": {
+          "calls": 1,
+          "tenant_count": 1,
+          "user_count": 1,
+          "component_count": 1,
+          "tenants": {
+            "unknown": 1
+          },
+          "users": {
+            "unknown": 1
+          },
+          "components": {
+            "unknown": 1
+          }
+        },
+        "last_seen_at": "2026-08-22T17:23:45.967492Z",
+        "retirement_candidate": false,
+        "retirement_reason": "1 call(s) in review window"
+      },
+      {
+        "interface": {
+          "id": "a6cb291e-8312-42f8-8a66-fde369482881",
+          "interface_key": "rest_api:GET /sbom/{repo_slug}",
+          "interface_kind": "rest_api",
+          "legacy_since": "2026-08-22T17:23:45.089542Z",
+          "replacement_ref": "sbom-nexus:/sbom/",
+          "owner_component": "state-hub.sbom-compat",
+          "status": "legacy",
+          "replacement_verified": true,
+          "manual_hold": false,
+          "hold_reason": null,
+          "notes": null,
+          "retired_at": null,
+          "created_at": "2026-08-22T17:23:45.089542Z",
+          "updated_at": "2026-08-22T17:23:45.089542Z"
+        },
+        "all_time": {
+          "calls": 1,
+          "tenant_count": 1,
+          "user_count": 1,
+          "component_count": 1,
+          "tenants": {
+            "unknown": 1
+          },
+          "users": {
+            "unknown": 1
+          },
+          "components": {
+            "unknown": 1
+          }
+        },
+        "window": {
+          "calls": 1,
+          "tenant_count": 1,
+          "user_count": 1,
+          "component_count": 1,
+          "tenants": {
+            "unknown": 1
+          },
+          "users": {
+            "unknown": 1
+          },
+          "components": {
+            "unknown": 1
+          }
+        },
+        "last_seen_at": "2026-08-22T17:23:45.670511Z",
+        "retirement_candidate": false,
+        "retirement_reason": "1 call(s) in review window"
+      },
+      {
+        "interface": {
+          "id": "3e4a3d0b-08fa-45c3-91e2-4f514a914b97",
+          "interface_key": "rest_api:GET /workstreams/",
+          "interface_kind": "rest_api",
+          "legacy_since": "2026-06-04T00:26:14.533764Z",
+          "replacement_ref": "/workplans/",
+          "owner_component": "state-hub.api",
+          "status": "legacy",
+          "replacement_verified": true,
+          "manual_hold": false,
+          "hold_reason": null,
+          "notes": null,
+          "retired_at": null,
+          "created_at": "2026-06-04T00:26:14.533764Z",
+          "updated_at": "2026-06-04T00:26:14.533764Z"
+        },
+        "all_time": {
+          "calls": 830269,
+          "tenant_count": 1,
+          "user_count": 1,
+          "component_count": 1,
+          "tenants": {
+            "unknown": 830269
+          },
+          "users": {
+            "unknown": 830269
+          },
+          "components": {
+            "unknown": 830269
+          }
+        },
+        "window": {
+          "calls": 57465,
+          "tenant_count": 1,
+          "user_count": 1,
+          "component_count": 1,
+          "tenants": {
+            "unknown": 57465
+          },
+          "users": {
+            "unknown": 57465
+          },
+          "components": {
+            "unknown": 57465
+          }
+        },
+        "last_seen_at": "2026-08-21T13:50:37.994459Z",
+        "retirement_candidate": false,
+        "retirement_reason": "57465 call(s) in review window"
+      },
+      {
+        "interface": {
+          "id": "e4c140ec-7479-46f9-b185-4b533f19d639",
+          "interface_key": "rest_api:GET /workstreams/workplan-index",
+          "interface_kind": "rest_api",
+          "legacy_since": "2026-06-04T05:20:58.321869Z",
+          "replacement_ref": "/workplans/index",
+          "owner_component": "state-hub.api",
+          "status": "legacy",
+          "replacement_verified": true,
+          "manual_hold": false,
+          "hold_reason": null,
+          "notes": null,
+          "retired_at": null,
+          "created_at": "2026-06-04T05:20:58.321869Z",
+          "updated_at": "2026-06-04T05:20:58.321869Z"
+        },
+        "all_time": {
+          "calls": 39,
+          "tenant_count": 1,
+          "user_count": 1,
+          "component_count": 1,
+          "tenants": {
+            "unknown": 39
+          },
+          "users": {
+            "unknown": 39
+          },
+          "components": {
+            "unknown": 39
+          }
+        },
+        "window": {
+          "calls": 0,
+          "tenant_count": 0,
+          "user_count": 0,
+          "component_count": 0,
+          "tenants": {},
+          "users": {},
+          "components": {}
+        },
+        "last_seen_at": "2026-07-08T05:20:33.378203Z",
+        "retirement_candidate": true,
+        "retirement_reason": "no usage in review window; quiet 48d (>= 7d required for 39 all-time call(s))"
+      },
+      {
+        "interface": {
+          "id": "3a00b19e-e7db-4403-98aa-a77c9ab61ecc",
+          "interface_key": "rest_api:GET /workstreams/{workstream_id}",
+          "interface_kind": "rest_api",
+          "legacy_since": "2026-06-04T00:25:59.014966Z",
+          "replacement_ref": "/workplans/{workplan_id}",
+          "owner_component": "state-hub.api",
+          "status": "legacy",
+          "replacement_verified": true,
+          "manual_hold": false,
+          "hold_reason": null,
+          "notes": null,
+          "retired_at": null,
+          "created_at": "2026-06-04T00:25:59.014966Z",
+          "updated_at": "2026-06-04T00:25:59.014966Z"
+        },
+        "all_time": {
+          "calls": 3411470,
+          "tenant_count": 1,
+          "user_count": 1,
+          "component_count": 1,
+          "tenants": {
+            "unknown": 3411470
+          },
+          "users": {
+            "unknown": 3411470
+          },
+          "components": {
+            "unknown": 3411470
+          }
+        },
+        "window": {
+          "calls": 258914,
+          "tenant_count": 1,
+          "user_count": 1,
+          "component_count": 1,
+          "tenants": {
+            "unknown": 258914
+          },
+          "users": {
+            "unknown": 258914
+          },
+          "components": {
+            "unknown": 258914
+          }
+        },
+        "last_seen_at": "2026-08-21T13:50:32.103349Z",
+        "retirement_candidate": false,
+        "retirement_reason": "258914 call(s) in review window"
+      },
+      {
+        "interface": {
+          "id": "69e1a255-a8b9-4101-8a68-b1bed23abfda",
+          "interface_key": "rest_api:GET /workstreams/{workstream_id}/dependencies/",
+          "interface_kind": "rest_api",
+          "legacy_since": "2026-06-04T00:25:59.291135Z",
+          "replacement_ref": "/workplans/{workplan_id}/dependencies/",
+          "owner_component": "state-hub.api",
+          "status": "legacy",
+          "replacement_verified": true,
+          "manual_hold": false,
+          "hold_reason": null,
+          "notes": null,
+          "retired_at": null,
+          "created_at": "2026-06-04T00:25:59.291135Z",
+          "updated_at": "2026-06-04T00:25:59.291135Z"
+        },
+        "all_time": {
+          "calls": 1643952,
+          "tenant_count": 1,
+          "user_count": 1,
+          "component_count": 1,
+          "tenants": {
+            "unknown": 1643952
+          },
+          "users": {
+            "unknown": 1643952
+          },
+          "components": {
+            "unknown": 1643952
+          }
+        },
+        "window": {
+          "calls": 121210,
+          "tenant_count": 1,
+          "user_count": 1,
+          "component_count": 1,
+          "tenants": {
+            "unknown": 121210
+          },
+          "users": {
+            "unknown": 121210
+          },
+          "components": {
+            "unknown": 121210
+          }
+        },
+        "last_seen_at": "2026-08-21T13:50:30.082480Z",
+        "retirement_candidate": false,
+        "retirement_reason": "121210 call(s) in review window"
+      },
+      {
+        "interface": {
+          "id": "b1aae931-b51f-4a85-a723-865dd65f6132",
+          "interface_key": "rest_api:PATCH /workstreams/{workstream_id}",
+          "interface_kind": "rest_api",
+          "legacy_since": "2026-06-04T06:09:41.901035Z",
+          "replacement_ref": "/workplans/{workplan_id}",
+          "owner_component": "state-hub.api",
+          "status": "legacy",
+          "replacement_verified": true,
+          "manual_hold": false,
+          "hold_reason": null,
+          "notes": null,
+          "retired_at": null,
+          "created_at": "2026-06-04T06:09:41.901035Z",
+          "updated_at": "2026-06-04T06:09:41.901035Z"
+        },
+        "all_time": {
+          "calls": 584,
+          "tenant_count": 1,
+          "user_count": 1,
+          "component_count": 1,
+          "tenants": {
+            "unknown": 584
+          },
+          "users": {
+            "unknown": 584
+          },
+          "components": {
+            "unknown": 584
+          }
+        },
+        "window": {
+          "calls": 0,
+          "tenant_count": 0,
+          "user_count": 0,
+          "component_count": 0,
+          "tenants": {},
+          "users": {},
+          "components": {}
+        },
+        "last_seen_at": "2026-08-16T16:33:34.045078Z",
+        "retirement_candidate": false,
+        "retirement_reason": "quiet 8d of 30d required for 584 all-time call(s)"
+      },
+      {
+        "interface": {
+          "id": "ed6451c9-d2cc-4486-9afe-d3852782cabc",
+          "interface_key": "rest_api:POST /workstreams/",
+          "interface_kind": "rest_api",
+          "legacy_since": "2026-06-04T07:40:24.168535Z",
+          "replacement_ref": "/workplans/",
+          "owner_component": "state-hub.api",
+          "status": "legacy",
+          "replacement_verified": true,
+          "manual_hold": false,
+          "hold_reason": null,
+          "notes": null,
+          "retired_at": null,
+          "created_at": "2026-06-04T07:40:24.168535Z",
+          "updated_at": "2026-06-04T07:40:24.168535Z"
+        },
+        "all_time": {
+          "calls": 811,
+          "tenant_count": 1,
+          "user_count": 1,
+          "component_count": 1,
+          "tenants": {
+            "unknown": 811
+          },
+          "users": {
+            "unknown": 811
+          },
+          "components": {
+            "unknown": 811
+          }
+        },
+        "window": {
+          "calls": 0,
+          "tenant_count": 0,
+          "user_count": 0,
+          "component_count": 0,
+          "tenants": {},
+          "users": {},
+          "components": {}
+        },
+        "last_seen_at": "2026-08-16T01:03:41.093965Z",
+        "retirement_candidate": false,
+        "retirement_reason": "quiet 9d of 30d required for 811 all-time call(s)"
+      },
+      {
+        "interface": {
+          "id": "281fd706-b192-4194-8055-2d8733c115f9",
+          "interface_key": "rest_api:POST /workstreams/{workstream_id}/dependencies/",
+          "interface_kind": "rest_api",
+          "legacy_since": "2026-06-04T22:57:37.149207Z",
+          "replacement_ref": "/workplans/{workplan_id}/dependencies/",
+          "owner_component": "state-hub.api",
+          "status": "legacy",
+          "replacement_verified": true,
+          "manual_hold": false,
+          "hold_reason": null,
+          "notes": null,
+          "retired_at": null,
+          "created_at": "2026-06-04T22:57:37.149207Z",
+          "updated_at": "2026-06-04T22:57:37.149207Z"
+        },
+        "all_time": {
+          "calls": 4975,
+          "tenant_count": 1,
+          "user_count": 1,
+          "component_count": 1,
+          "tenants": {
+            "unknown": 4975
+          },
+          "users": {
+            "unknown": 4975
+          },
+          "components": {
+            "unknown": 4975
+          }
+        },
+        "window": {
+          "calls": 0,
+          "tenant_count": 0,
+          "user_count": 0,
+          "component_count": 0,
+          "tenants": {},
+          "users": {},
+          "components": {}
+        },
+        "last_seen_at": "2026-07-07T20:31:35.389791Z",
+        "retirement_candidate": true,
+        "retirement_reason": "no usage in review window; quiet 48d (>= 30d required for 4975 all-time call(s))"
+      }
+    ],
+    "retirement_candidates": [
+      {
+        "interface": {
+          "id": "8051fb40-66c9-4dc4-a413-13e8573e04a3",
+          "interface_key": "event_subject:org.statehub.workstream.completed",
+          "interface_kind": "event_subject",
+          "legacy_since": "2026-06-04T06:09:42.198193Z",
+          "replacement_ref": "org.statehub.workplan.completed",
+          "owner_component": "state-hub.events",
+          "status": "legacy",
+          "replacement_verified": true,
+          "manual_hold": false,
+          "hold_reason": null,
+          "notes": null,
+          "retired_at": null,
+          "created_at": "2026-06-04T06:09:42.198193Z",
+          "updated_at": "2026-06-04T06:09:42.198193Z"
+        },
+        "all_time": {
+          "calls": 247,
+          "tenant_count": 1,
+          "user_count": 1,
+          "component_count": 1,
+          "tenants": {
+            "unknown": 247
+          },
+          "users": {
+            "unknown": 247
+          },
+          "components": {
+            "state-hub.events": 247
+          }
+        },
+        "window": {
+          "calls": 0,
+          "tenant_count": 0,
+          "user_count": 0,
+          "component_count": 0,
+          "tenants": {},
+          "users": {},
+          "components": {}
+        },
+        "last_seen_at": "2026-07-13T13:22:00.748140Z",
+        "retirement_candidate": true,
+        "retirement_reason": "no usage in review window; quiet 43d (>= 30d required for 247 all-time call(s))"
+      },
+      {
+        "interface": {
+          "id": "cd9342fd-27e7-4a46-a1be-d41499e106a3",
+          "interface_key": "rest_api:DELETE /workstreams/{workstream_id}",
+          "interface_kind": "rest_api",
+          "legacy_since": "2026-06-06T17:28:13.052813Z",
+          "replacement_ref": "/workplans/{workplan_id}",
+          "owner_component": "state-hub.api",
+          "status": "legacy",
+          "replacement_verified": true,
+          "manual_hold": false,
+          "hold_reason": null,
+          "notes": null,
+          "retired_at": null,
+          "created_at": "2026-06-06T17:28:13.052813Z",
+          "updated_at": "2026-06-06T17:28:13.052813Z"
+        },
+        "all_time": {
+          "calls": 1,
+          "tenant_count": 1,
+          "user_count": 1,
+          "component_count": 1,
+          "tenants": {
+            "unknown": 1
+          },
+          "users": {
+            "unknown": 1
+          },
+          "components": {
+            "unknown": 1
+          }
+        },
+        "window": {
+          "calls": 0,
+          "tenant_count": 0,
+          "user_count": 0,
+          "component_count": 0,
+          "tenants": {},
+          "users": {},
+          "components": {}
+        },
+        "last_seen_at": "2026-06-06T17:28:13.047529Z",
+        "retirement_candidate": true,
+        "retirement_reason": "no usage in review window; quiet 79d (>= 7d required for 1 all-time call(s))"
+      },
+      {
+        "interface": {
+          "id": "e4c140ec-7479-46f9-b185-4b533f19d639",
+          "interface_key": "rest_api:GET /workstreams/workplan-index",
+          "interface_kind": "rest_api",
+          "legacy_since": "2026-06-04T05:20:58.321869Z",
+          "replacement_ref": "/workplans/index",
+          "owner_component": "state-hub.api",
+          "status": "legacy",
+          "replacement_verified": true,
+          "manual_hold": false,
+          "hold_reason": null,
+          "notes": null,
+          "retired_at": null,
+          "created_at": "2026-06-04T05:20:58.321869Z",
+          "updated_at": "2026-06-04T05:20:58.321869Z"
+        },
+        "all_time": {
+          "calls": 39,
+          "tenant_count": 1,
+          "user_count": 1,
+          "component_count": 1,
+          "tenants": {
+            "unknown": 39
+          },
+          "users": {
+            "unknown": 39
+          },
+          "components": {
+            "unknown": 39
+          }
+        },
+        "window": {
+          "calls": 0,
+          "tenant_count": 0,
+          "user_count": 0,
+          "component_count": 0,
+          "tenants": {},
+          "users": {},
+          "components": {}
+        },
+        "last_seen_at": "2026-07-08T05:20:33.378203Z",
+        "retirement_candidate": true,
+        "retirement_reason": "no usage in review window; quiet 48d (>= 7d required for 39 all-time call(s))"
+      },
+      {
+        "interface": {
+          "id": "281fd706-b192-4194-8055-2d8733c115f9",
+          "interface_key": "rest_api:POST /workstreams/{workstream_id}/dependencies/",
+          "interface_kind": "rest_api",
+          "legacy_since": "2026-06-04T22:57:37.149207Z",
+          "replacement_ref": "/workplans/{workplan_id}/dependencies/",
+          "owner_component": "state-hub.api",
+          "status": "legacy",
+          "replacement_verified": true,
+          "manual_hold": false,
+          "hold_reason": null,
+          "notes": null,
+          "retired_at": null,
+          "created_at": "2026-06-04T22:57:37.149207Z",
+          "updated_at": "2026-06-04T22:57:37.149207Z"
+        },
+        "all_time": {
+          "calls": 4975,
+          "tenant_count": 1,
+          "user_count": 1,
+          "component_count": 1,
+          "tenants": {
+            "unknown": 4975
+          },
+          "users": {
+            "unknown": 4975
+          },
+          "components": {
+            "unknown": 4975
+          }
+        },
+        "window": {
+          "calls": 0,
+          "tenant_count": 0,
+          "user_count": 0,
+          "component_count": 0,
+          "tenants": {},
+          "users": {},
+          "components": {}
+        },
+        "last_seen_at": "2026-07-07T20:31:35.389791Z",
+        "retirement_candidate": true,
+        "retirement_reason": "no usage in review window; quiet 48d (>= 30d required for 4975 all-time call(s))"
+      }
+    ]
+  },
+  "days": 7
+}
diff --git a/docs/evidence/legacy-meter-weekly-review-20260826.json b/docs/evidence/legacy-meter-weekly-review-20260826.json
new file mode 100644
index 0000000..ae93050
--- /dev/null
+++ b/docs/evidence/legacy-meter-weekly-review-20260826.json
@@ -0,0 +1,882 @@
+{
+  "captured_at": "2026-08-26T06:00:08.092553+00:00",
+  "api_base": "http://127.0.0.1:8000",
+  "workplan": "STATE-WP-0070",
+  "retired_interfaces": [],
+  "weekly_review": {
+    "generated_at": "2026-08-26T06:00:08.325939Z",
+    "window_start": "2026-08-19T06:00:08.207373Z",
+    "window_end": "2026-08-26T06:00:08.207373Z",
+    "cadence": "weekly",
+    "activity_core_handoff": {
+      "activity_id": "statehub-legacy-interface-review",
+      "cadence": "weekly",
+      "source_endpoint": "/legacy-meter/weekly-review",
+      "state_owner": "state-hub",
+      "scheduler_owner": "activity-core"
+    },
+    "interfaces": [
+      {
+        "interface": {
+          "id": "8051fb40-66c9-4dc4-a413-13e8573e04a3",
+          "interface_key": "event_subject:org.statehub.workstream.completed",
+          "interface_kind": "event_subject",
+          "legacy_since": "2026-06-04T06:09:42.198193Z",
+          "replacement_ref": "org.statehub.workplan.completed",
+          "owner_component": "state-hub.events",
+          "status": "legacy",
+          "replacement_verified": true,
+          "manual_hold": false,
+          "hold_reason": null,
+          "notes": null,
+          "retired_at": null,
+          "created_at": "2026-06-04T06:09:42.198193Z",
+          "updated_at": "2026-06-04T06:09:42.198193Z"
+        },
+        "all_time": {
+          "calls": 247,
+          "tenant_count": 1,
+          "user_count": 1,
+          "component_count": 1,
+          "tenants": {
+            "unknown": 247
+          },
+          "users": {
+            "unknown": 247
+          },
+          "components": {
+            "state-hub.events": 247
+          }
+        },
+        "window": {
+          "calls": 0,
+          "tenant_count": 0,
+          "user_count": 0,
+          "component_count": 0,
+          "tenants": {},
+          "users": {},
+          "components": {}
+        },
+        "last_seen_at": "2026-07-13T13:22:00.748140Z",
+        "retirement_candidate": true,
+        "retirement_reason": "no usage in review window; quiet 43d (>= 30d required for 247 all-time call(s))"
+      },
+      {
+        "interface": {
+          "id": "cd9342fd-27e7-4a46-a1be-d41499e106a3",
+          "interface_key": "rest_api:DELETE /workstreams/{workstream_id}",
+          "interface_kind": "rest_api",
+          "legacy_since": "2026-06-06T17:28:13.052813Z",
+          "replacement_ref": "/workplans/{workplan_id}",
+          "owner_component": "state-hub.api",
+          "status": "legacy",
+          "replacement_verified": true,
+          "manual_hold": false,
+          "hold_reason": null,
+          "notes": null,
+          "retired_at": null,
+          "created_at": "2026-06-06T17:28:13.052813Z",
+          "updated_at": "2026-06-06T17:28:13.052813Z"
+        },
+        "all_time": {
+          "calls": 1,
+          "tenant_count": 1,
+          "user_count": 1,
+          "component_count": 1,
+          "tenants": {
+            "unknown": 1
+          },
+          "users": {
+            "unknown": 1
+          },
+          "components": {
+            "unknown": 1
+          }
+        },
+        "window": {
+          "calls": 0,
+          "tenant_count": 0,
+          "user_count": 0,
+          "component_count": 0,
+          "tenants": {},
+          "users": {},
+          "components": {}
+        },
+        "last_seen_at": "2026-06-06T17:28:13.047529Z",
+        "retirement_candidate": true,
+        "retirement_reason": "no usage in review window; quiet 80d (>= 7d required for 1 all-time call(s))"
+      },
+      {
+        "interface": {
+          "id": "d0294dce-7913-4268-94c3-1b2502aefb0f",
+          "interface_key": "rest_api:GET /sbom/",
+          "interface_kind": "rest_api",
+          "legacy_since": "2026-08-22T17:06:38.703608Z",
+          "replacement_ref": "sbom-nexus:/sbom/",
+          "owner_component": "state-hub.sbom-compat",
+          "status": "legacy",
+          "replacement_verified": true,
+          "manual_hold": false,
+          "hold_reason": null,
+          "notes": null,
+          "retired_at": null,
+          "created_at": "2026-08-22T17:06:38.703608Z",
+          "updated_at": "2026-08-22T17:23:43.730661Z"
+        },
+        "all_time": {
+          "calls": 4,
+          "tenant_count": 1,
+          "user_count": 1,
+          "component_count": 1,
+          "tenants": {
+            "unknown": 4
+          },
+          "users": {
+            "unknown": 4
+          },
+          "components": {
+            "unknown": 4
+          }
+        },
+        "window": {
+          "calls": 4,
+          "tenant_count": 1,
+          "user_count": 1,
+          "component_count": 1,
+          "tenants": {
+            "unknown": 4
+          },
+          "users": {
+            "unknown": 4
+          },
+          "components": {
+            "unknown": 4
+          }
+        },
+        "last_seen_at": "2026-08-22T17:23:46.146788Z",
+        "retirement_candidate": false,
+        "retirement_reason": "4 call(s) in review window"
+      },
+      {
+        "interface": {
+          "id": "2f77ac12-8c97-4974-a2f9-2996927982d1",
+          "interface_key": "rest_api:GET /sbom/report/licences/",
+          "interface_kind": "rest_api",
+          "legacy_since": "2026-08-22T17:06:41.978426Z",
+          "replacement_ref": "sbom-nexus:/sbom/",
+          "owner_component": "state-hub.sbom-compat",
+          "status": "legacy",
+          "replacement_verified": true,
+          "manual_hold": false,
+          "hold_reason": null,
+          "notes": null,
+          "retired_at": null,
+          "created_at": "2026-08-22T17:06:41.978426Z",
+          "updated_at": "2026-08-22T17:23:44.794796Z"
+        },
+        "all_time": {
+          "calls": 4,
+          "tenant_count": 1,
+          "user_count": 1,
+          "component_count": 1,
+          "tenants": {
+            "unknown": 4
+          },
+          "users": {
+            "unknown": 4
+          },
+          "components": {
+            "unknown": 4
+          }
+        },
+        "window": {
+          "calls": 4,
+          "tenant_count": 1,
+          "user_count": 1,
+          "component_count": 1,
+          "tenants": {
+            "unknown": 4
+          },
+          "users": {
+            "unknown": 4
+          },
+          "components": {
+            "unknown": 4
+          }
+        },
+        "last_seen_at": "2026-08-22T17:56:34.405129Z",
+        "retirement_candidate": false,
+        "retirement_reason": "4 call(s) in review window"
+      },
+      {
+        "interface": {
+          "id": "b627edf5-3302-4366-ba2e-547d32f634b5",
+          "interface_key": "rest_api:GET /sbom/snapshots/",
+          "interface_kind": "rest_api",
+          "legacy_since": "2026-08-22T17:06:37.057774Z",
+          "replacement_ref": "sbom-nexus:/sbom/",
+          "owner_component": "state-hub.sbom-compat",
+          "status": "legacy",
+          "replacement_verified": true,
+          "manual_hold": false,
+          "hold_reason": null,
+          "notes": null,
+          "retired_at": null,
+          "created_at": "2026-08-22T17:06:37.057774Z",
+          "updated_at": "2026-08-22T17:22:15.080213Z"
+        },
+        "all_time": {
+          "calls": 5,
+          "tenant_count": 1,
+          "user_count": 1,
+          "component_count": 1,
+          "tenants": {
+            "unknown": 5
+          },
+          "users": {
+            "unknown": 5
+          },
+          "components": {
+            "unknown": 5
+          }
+        },
+        "window": {
+          "calls": 5,
+          "tenant_count": 1,
+          "user_count": 1,
+          "component_count": 1,
+          "tenants": {
+            "unknown": 5
+          },
+          "users": {
+            "unknown": 5
+          },
+          "components": {
+            "unknown": 5
+          }
+        },
+        "last_seen_at": "2026-08-22T17:23:53.844021Z",
+        "retirement_candidate": false,
+        "retirement_reason": "5 call(s) in review window"
+      },
+      {
+        "interface": {
+          "id": "d03ee274-cd6f-4cd5-8f22-e4d298416299",
+          "interface_key": "rest_api:GET /sbom/snapshots/{snapshot_id}",
+          "interface_kind": "rest_api",
+          "legacy_since": "2026-08-22T17:23:45.969876Z",
+          "replacement_ref": "sbom-nexus:/sbom/",
+          "owner_component": "state-hub.sbom-compat",
+          "status": "legacy",
+          "replacement_verified": true,
+          "manual_hold": false,
+          "hold_reason": null,
+          "notes": null,
+          "retired_at": null,
+          "created_at": "2026-08-22T17:23:45.969876Z",
+          "updated_at": "2026-08-22T17:23:45.969876Z"
+        },
+        "all_time": {
+          "calls": 1,
+          "tenant_count": 1,
+          "user_count": 1,
+          "component_count": 1,
+          "tenants": {
+            "unknown": 1
+          },
+          "users": {
+            "unknown": 1
+          },
+          "components": {
+            "unknown": 1
+          }
+        },
+        "window": {
+          "calls": 1,
+          "tenant_count": 1,
+          "user_count": 1,
+          "component_count": 1,
+          "tenants": {
+            "unknown": 1
+          },
+          "users": {
+            "unknown": 1
+          },
+          "components": {
+            "unknown": 1
+          }
+        },
+        "last_seen_at": "2026-08-22T17:23:45.967492Z",
+        "retirement_candidate": false,
+        "retirement_reason": "1 call(s) in review window"
+      },
+      {
+        "interface": {
+          "id": "a6cb291e-8312-42f8-8a66-fde369482881",
+          "interface_key": "rest_api:GET /sbom/{repo_slug}",
+          "interface_kind": "rest_api",
+          "legacy_since": "2026-08-22T17:23:45.089542Z",
+          "replacement_ref": "sbom-nexus:/sbom/",
+          "owner_component": "state-hub.sbom-compat",
+          "status": "legacy",
+          "replacement_verified": true,
+          "manual_hold": false,
+          "hold_reason": null,
+          "notes": null,
+          "retired_at": null,
+          "created_at": "2026-08-22T17:23:45.089542Z",
+          "updated_at": "2026-08-22T17:23:45.089542Z"
+        },
+        "all_time": {
+          "calls": 1,
+          "tenant_count": 1,
+          "user_count": 1,
+          "component_count": 1,
+          "tenants": {
+            "unknown": 1
+          },
+          "users": {
+            "unknown": 1
+          },
+          "components": {
+            "unknown": 1
+          }
+        },
+        "window": {
+          "calls": 1,
+          "tenant_count": 1,
+          "user_count": 1,
+          "component_count": 1,
+          "tenants": {
+            "unknown": 1
+          },
+          "users": {
+            "unknown": 1
+          },
+          "components": {
+            "unknown": 1
+          }
+        },
+        "last_seen_at": "2026-08-22T17:23:45.670511Z",
+        "retirement_candidate": false,
+        "retirement_reason": "1 call(s) in review window"
+      },
+      {
+        "interface": {
+          "id": "3e4a3d0b-08fa-45c3-91e2-4f514a914b97",
+          "interface_key": "rest_api:GET /workstreams/",
+          "interface_kind": "rest_api",
+          "legacy_since": "2026-06-04T00:26:14.533764Z",
+          "replacement_ref": "/workplans/",
+          "owner_component": "state-hub.api",
+          "status": "legacy",
+          "replacement_verified": true,
+          "manual_hold": false,
+          "hold_reason": null,
+          "notes": null,
+          "retired_at": null,
+          "created_at": "2026-06-04T00:26:14.533764Z",
+          "updated_at": "2026-06-04T00:26:14.533764Z"
+        },
+        "all_time": {
+          "calls": 830269,
+          "tenant_count": 1,
+          "user_count": 1,
+          "component_count": 1,
+          "tenants": {
+            "unknown": 830269
+          },
+          "users": {
+            "unknown": 830269
+          },
+          "components": {
+            "unknown": 830269
+          }
+        },
+        "window": {
+          "calls": 41113,
+          "tenant_count": 1,
+          "user_count": 1,
+          "component_count": 1,
+          "tenants": {
+            "unknown": 41113
+          },
+          "users": {
+            "unknown": 41113
+          },
+          "components": {
+            "unknown": 41113
+          }
+        },
+        "last_seen_at": "2026-08-21T13:50:37.994459Z",
+        "retirement_candidate": false,
+        "retirement_reason": "41113 call(s) in review window"
+      },
+      {
+        "interface": {
+          "id": "e4c140ec-7479-46f9-b185-4b533f19d639",
+          "interface_key": "rest_api:GET /workstreams/workplan-index",
+          "interface_kind": "rest_api",
+          "legacy_since": "2026-06-04T05:20:58.321869Z",
+          "replacement_ref": "/workplans/index",
+          "owner_component": "state-hub.api",
+          "status": "legacy",
+          "replacement_verified": true,
+          "manual_hold": false,
+          "hold_reason": null,
+          "notes": null,
+          "retired_at": null,
+          "created_at": "2026-06-04T05:20:58.321869Z",
+          "updated_at": "2026-06-04T05:20:58.321869Z"
+        },
+        "all_time": {
+          "calls": 39,
+          "tenant_count": 1,
+          "user_count": 1,
+          "component_count": 1,
+          "tenants": {
+            "unknown": 39
+          },
+          "users": {
+            "unknown": 39
+          },
+          "components": {
+            "unknown": 39
+          }
+        },
+        "window": {
+          "calls": 0,
+          "tenant_count": 0,
+          "user_count": 0,
+          "component_count": 0,
+          "tenants": {},
+          "users": {},
+          "components": {}
+        },
+        "last_seen_at": "2026-07-08T05:20:33.378203Z",
+        "retirement_candidate": true,
+        "retirement_reason": "no usage in review window; quiet 49d (>= 7d required for 39 all-time call(s))"
+      },
+      {
+        "interface": {
+          "id": "3a00b19e-e7db-4403-98aa-a77c9ab61ecc",
+          "interface_key": "rest_api:GET /workstreams/{workstream_id}",
+          "interface_kind": "rest_api",
+          "legacy_since": "2026-06-04T00:25:59.014966Z",
+          "replacement_ref": "/workplans/{workplan_id}",
+          "owner_component": "state-hub.api",
+          "status": "legacy",
+          "replacement_verified": true,
+          "manual_hold": false,
+          "hold_reason": null,
+          "notes": null,
+          "retired_at": null,
+          "created_at": "2026-06-04T00:25:59.014966Z",
+          "updated_at": "2026-06-04T00:25:59.014966Z"
+        },
+        "all_time": {
+          "calls": 3411470,
+          "tenant_count": 1,
+          "user_count": 1,
+          "component_count": 1,
+          "tenants": {
+            "unknown": 3411470
+          },
+          "users": {
+            "unknown": 3411470
+          },
+          "components": {
+            "unknown": 3411470
+          }
+        },
+        "window": {
+          "calls": 185368,
+          "tenant_count": 1,
+          "user_count": 1,
+          "component_count": 1,
+          "tenants": {
+            "unknown": 185368
+          },
+          "users": {
+            "unknown": 185368
+          },
+          "components": {
+            "unknown": 185368
+          }
+        },
+        "last_seen_at": "2026-08-21T13:50:32.103349Z",
+        "retirement_candidate": false,
+        "retirement_reason": "185368 call(s) in review window"
+      },
+      {
+        "interface": {
+          "id": "69e1a255-a8b9-4101-8a68-b1bed23abfda",
+          "interface_key": "rest_api:GET /workstreams/{workstream_id}/dependencies/",
+          "interface_kind": "rest_api",
+          "legacy_since": "2026-06-04T00:25:59.291135Z",
+          "replacement_ref": "/workplans/{workplan_id}/dependencies/",
+          "owner_component": "state-hub.api",
+          "status": "legacy",
+          "replacement_verified": true,
+          "manual_hold": false,
+          "hold_reason": null,
+          "notes": null,
+          "retired_at": null,
+          "created_at": "2026-06-04T00:25:59.291135Z",
+          "updated_at": "2026-06-04T00:25:59.291135Z"
+        },
+        "all_time": {
+          "calls": 1643952,
+          "tenant_count": 1,
+          "user_count": 1,
+          "component_count": 1,
+          "tenants": {
+            "unknown": 1643952
+          },
+          "users": {
+            "unknown": 1643952
+          },
+          "components": {
+            "unknown": 1643952
+          }
+        },
+        "window": {
+          "calls": 86675,
+          "tenant_count": 1,
+          "user_count": 1,
+          "component_count": 1,
+          "tenants": {
+            "unknown": 86675
+          },
+          "users": {
+            "unknown": 86675
+          },
+          "components": {
+            "unknown": 86675
+          }
+        },
+        "last_seen_at": "2026-08-21T13:50:30.082480Z",
+        "retirement_candidate": false,
+        "retirement_reason": "86675 call(s) in review window"
+      },
+      {
+        "interface": {
+          "id": "b1aae931-b51f-4a85-a723-865dd65f6132",
+          "interface_key": "rest_api:PATCH /workstreams/{workstream_id}",
+          "interface_kind": "rest_api",
+          "legacy_since": "2026-06-04T06:09:41.901035Z",
+          "replacement_ref": "/workplans/{workplan_id}",
+          "owner_component": "state-hub.api",
+          "status": "legacy",
+          "replacement_verified": true,
+          "manual_hold": false,
+          "hold_reason": null,
+          "notes": null,
+          "retired_at": null,
+          "created_at": "2026-06-04T06:09:41.901035Z",
+          "updated_at": "2026-06-04T06:09:41.901035Z"
+        },
+        "all_time": {
+          "calls": 584,
+          "tenant_count": 1,
+          "user_count": 1,
+          "component_count": 1,
+          "tenants": {
+            "unknown": 584
+          },
+          "users": {
+            "unknown": 584
+          },
+          "components": {
+            "unknown": 584
+          }
+        },
+        "window": {
+          "calls": 0,
+          "tenant_count": 0,
+          "user_count": 0,
+          "component_count": 0,
+          "tenants": {},
+          "users": {},
+          "components": {}
+        },
+        "last_seen_at": "2026-08-16T16:33:34.045078Z",
+        "retirement_candidate": false,
+        "retirement_reason": "quiet 9d of 30d required for 584 all-time call(s)"
+      },
+      {
+        "interface": {
+          "id": "ed6451c9-d2cc-4486-9afe-d3852782cabc",
+          "interface_key": "rest_api:POST /workstreams/",
+          "interface_kind": "rest_api",
+          "legacy_since": "2026-06-04T07:40:24.168535Z",
+          "replacement_ref": "/workplans/",
+          "owner_component": "state-hub.api",
+          "status": "legacy",
+          "replacement_verified": true,
+          "manual_hold": false,
+          "hold_reason": null,
+          "notes": null,
+          "retired_at": null,
+          "created_at": "2026-06-04T07:40:24.168535Z",
+          "updated_at": "2026-06-04T07:40:24.168535Z"
+        },
+        "all_time": {
+          "calls": 811,
+          "tenant_count": 1,
+          "user_count": 1,
+          "component_count": 1,
+          "tenants": {
+            "unknown": 811
+          },
+          "users": {
+            "unknown": 811
+          },
+          "components": {
+            "unknown": 811
+          }
+        },
+        "window": {
+          "calls": 0,
+          "tenant_count": 0,
+          "user_count": 0,
+          "component_count": 0,
+          "tenants": {},
+          "users": {},
+          "components": {}
+        },
+        "last_seen_at": "2026-08-16T01:03:41.093965Z",
+        "retirement_candidate": false,
+        "retirement_reason": "quiet 10d of 30d required for 811 all-time call(s)"
+      },
+      {
+        "interface": {
+          "id": "281fd706-b192-4194-8055-2d8733c115f9",
+          "interface_key": "rest_api:POST /workstreams/{workstream_id}/dependencies/",
+          "interface_kind": "rest_api",
+          "legacy_since": "2026-06-04T22:57:37.149207Z",
+          "replacement_ref": "/workplans/{workplan_id}/dependencies/",
+          "owner_component": "state-hub.api",
+          "status": "legacy",
+          "replacement_verified": true,
+          "manual_hold": false,
+          "hold_reason": null,
+          "notes": null,
+          "retired_at": null,
+          "created_at": "2026-06-04T22:57:37.149207Z",
+          "updated_at": "2026-06-04T22:57:37.149207Z"
+        },
+        "all_time": {
+          "calls": 4975,
+          "tenant_count": 1,
+          "user_count": 1,
+          "component_count": 1,
+          "tenants": {
+            "unknown": 4975
+          },
+          "users": {
+            "unknown": 4975
+          },
+          "components": {
+            "unknown": 4975
+          }
+        },
+        "window": {
+          "calls": 0,
+          "tenant_count": 0,
+          "user_count": 0,
+          "component_count": 0,
+          "tenants": {},
+          "users": {},
+          "components": {}
+        },
+        "last_seen_at": "2026-07-07T20:31:35.389791Z",
+        "retirement_candidate": true,
+        "retirement_reason": "no usage in review window; quiet 49d (>= 30d required for 4975 all-time call(s))"
+      }
+    ],
+    "retirement_candidates": [
+      {
+        "interface": {
+          "id": "8051fb40-66c9-4dc4-a413-13e8573e04a3",
+          "interface_key": "event_subject:org.statehub.workstream.completed",
+          "interface_kind": "event_subject",
+          "legacy_since": "2026-06-04T06:09:42.198193Z",
+          "replacement_ref": "org.statehub.workplan.completed",
+          "owner_component": "state-hub.events",
+          "status": "legacy",
+          "replacement_verified": true,
+          "manual_hold": false,
+          "hold_reason": null,
+          "notes": null,
+          "retired_at": null,
+          "created_at": "2026-06-04T06:09:42.198193Z",
+          "updated_at": "2026-06-04T06:09:42.198193Z"
+        },
+        "all_time": {
+          "calls": 247,
+          "tenant_count": 1,
+          "user_count": 1,
+          "component_count": 1,
+          "tenants": {
+            "unknown": 247
+          },
+          "users": {
+            "unknown": 247
+          },
+          "components": {
+            "state-hub.events": 247
+          }
+        },
+        "window": {
+          "calls": 0,
+          "tenant_count": 0,
+          "user_count": 0,
+          "component_count": 0,
+          "tenants": {},
+          "users": {},
+          "components": {}
+        },
+        "last_seen_at": "2026-07-13T13:22:00.748140Z",
+        "retirement_candidate": true,
+        "retirement_reason": "no usage in review window; quiet 43d (>= 30d required for 247 all-time call(s))"
+      },
+      {
+        "interface": {
+          "id": "cd9342fd-27e7-4a46-a1be-d41499e106a3",
+          "interface_key": "rest_api:DELETE /workstreams/{workstream_id}",
+          "interface_kind": "rest_api",
+          "legacy_since": "2026-06-06T17:28:13.052813Z",
+          "replacement_ref": "/workplans/{workplan_id}",
+          "owner_component": "state-hub.api",
+          "status": "legacy",
+          "replacement_verified": true,
+          "manual_hold": false,
+          "hold_reason": null,
+          "notes": null,
+          "retired_at": null,
+          "created_at": "2026-06-06T17:28:13.052813Z",
+          "updated_at": "2026-06-06T17:28:13.052813Z"
+        },
+        "all_time": {
+          "calls": 1,
+          "tenant_count": 1,
+          "user_count": 1,
+          "component_count": 1,
+          "tenants": {
+            "unknown": 1
+          },
+          "users": {
+            "unknown": 1
+          },
+          "components": {
+            "unknown": 1
+          }
+        },
+        "window": {
+          "calls": 0,
+          "tenant_count": 0,
+          "user_count": 0,
+          "component_count": 0,
+          "tenants": {},
+          "users": {},
+          "components": {}
+        },
+        "last_seen_at": "2026-06-06T17:28:13.047529Z",
+        "retirement_candidate": true,
+        "retirement_reason": "no usage in review window; quiet 80d (>= 7d required for 1 all-time call(s))"
+      },
+      {
+        "interface": {
+          "id": "e4c140ec-7479-46f9-b185-4b533f19d639",
+          "interface_key": "rest_api:GET /workstreams/workplan-index",
+          "interface_kind": "rest_api",
+          "legacy_since": "2026-06-04T05:20:58.321869Z",
+          "replacement_ref": "/workplans/index",
+          "owner_component": "state-hub.api",
+          "status": "legacy",
+          "replacement_verified": true,
+          "manual_hold": false,
+          "hold_reason": null,
+          "notes": null,
+          "retired_at": null,
+          "created_at": "2026-06-04T05:20:58.321869Z",
+          "updated_at": "2026-06-04T05:20:58.321869Z"
+        },
+        "all_time": {
+          "calls": 39,
+          "tenant_count": 1,
+          "user_count": 1,
+          "component_count": 1,
+          "tenants": {
+            "unknown": 39
+          },
+          "users": {
+            "unknown": 39
+          },
+          "components": {
+            "unknown": 39
+          }
+        },
+        "window": {
+          "calls": 0,
+          "tenant_count": 0,
+          "user_count": 0,
+          "component_count": 0,
+          "tenants": {},
+          "users": {},
+          "components": {}
+        },
+        "last_seen_at": "2026-07-08T05:20:33.378203Z",
+        "retirement_candidate": true,
+        "retirement_reason": "no usage in review window; quiet 49d (>= 7d required for 39 all-time call(s))"
+      },
+      {
+        "interface": {
+          "id": "281fd706-b192-4194-8055-2d8733c115f9",
+          "interface_key": "rest_api:POST /workstreams/{workstream_id}/dependencies/",
+          "interface_kind": "rest_api",
+          "legacy_since": "2026-06-04T22:57:37.149207Z",
+          "replacement_ref": "/workplans/{workplan_id}/dependencies/",
+          "owner_component": "state-hub.api",
+          "status": "legacy",
+          "replacement_verified": true,
+          "manual_hold": false,
+          "hold_reason": null,
+          "notes": null,
+          "retired_at": null,
+          "created_at": "2026-06-04T22:57:37.149207Z",
+          "updated_at": "2026-06-04T22:57:37.149207Z"
+        },
+        "all_time": {
+          "calls": 4975,
+          "tenant_count": 1,
+          "user_count": 1,
+          "component_count": 1,
+          "tenants": {
+            "unknown": 4975
+          },
+          "users": {
+            "unknown": 4975
+          },
+          "components": {
+            "unknown": 4975
+          }
+        },
+        "window": {
+          "calls": 0,
+          "tenant_count": 0,
+          "user_count": 0,
+          "component_count": 0,
+          "tenants": {},
+          "users": {},
+          "components": {}
+        },
+        "last_seen_at": "2026-07-07T20:31:35.389791Z",
+        "retirement_candidate": true,
+        "retirement_reason": "no usage in review window; quiet 49d (>= 30d required for 4975 all-time call(s))"
+      }
+    ]
+  },
+  "days": 7
+}
diff --git a/docs/evidence/legacy-meter-weekly-review-20260827.json b/docs/evidence/legacy-meter-weekly-review-20260827.json
new file mode 100644
index 0000000..bc31c52
--- /dev/null
+++ b/docs/evidence/legacy-meter-weekly-review-20260827.json
@@ -0,0 +1,882 @@
+{
+  "captured_at": "2026-08-27T14:00:07.862953+00:00",
+  "api_base": "http://127.0.0.1:8000",
+  "workplan": "STATE-WP-0070",
+  "retired_interfaces": [],
+  "weekly_review": {
+    "generated_at": "2026-08-27T14:00:09.212468Z",
+    "window_start": "2026-08-20T14:00:09.134254Z",
+    "window_end": "2026-08-27T14:00:09.134254Z",
+    "cadence": "weekly",
+    "activity_core_handoff": {
+      "activity_id": "statehub-legacy-interface-review",
+      "cadence": "weekly",
+      "source_endpoint": "/legacy-meter/weekly-review",
+      "state_owner": "state-hub",
+      "scheduler_owner": "activity-core"
+    },
+    "interfaces": [
+      {
+        "interface": {
+          "id": "8051fb40-66c9-4dc4-a413-13e8573e04a3",
+          "interface_key": "event_subject:org.statehub.workstream.completed",
+          "interface_kind": "event_subject",
+          "legacy_since": "2026-06-04T06:09:42.198193Z",
+          "replacement_ref": "org.statehub.workplan.completed",
+          "owner_component": "state-hub.events",
+          "status": "legacy",
+          "replacement_verified": true,
+          "manual_hold": false,
+          "hold_reason": null,
+          "notes": null,
+          "retired_at": null,
+          "created_at": "2026-06-04T06:09:42.198193Z",
+          "updated_at": "2026-06-04T06:09:42.198193Z"
+        },
+        "all_time": {
+          "calls": 247,
+          "tenant_count": 1,
+          "user_count": 1,
+          "component_count": 1,
+          "tenants": {
+            "unknown": 247
+          },
+          "users": {
+            "unknown": 247
+          },
+          "components": {
+            "state-hub.events": 247
+          }
+        },
+        "window": {
+          "calls": 0,
+          "tenant_count": 0,
+          "user_count": 0,
+          "component_count": 0,
+          "tenants": {},
+          "users": {},
+          "components": {}
+        },
+        "last_seen_at": "2026-07-13T13:22:00.748140Z",
+        "retirement_candidate": true,
+        "retirement_reason": "no usage in review window; quiet 45d (>= 30d required for 247 all-time call(s))"
+      },
+      {
+        "interface": {
+          "id": "cd9342fd-27e7-4a46-a1be-d41499e106a3",
+          "interface_key": "rest_api:DELETE /workstreams/{workstream_id}",
+          "interface_kind": "rest_api",
+          "legacy_since": "2026-06-06T17:28:13.052813Z",
+          "replacement_ref": "/workplans/{workplan_id}",
+          "owner_component": "state-hub.api",
+          "status": "legacy",
+          "replacement_verified": true,
+          "manual_hold": false,
+          "hold_reason": null,
+          "notes": null,
+          "retired_at": null,
+          "created_at": "2026-06-06T17:28:13.052813Z",
+          "updated_at": "2026-06-06T17:28:13.052813Z"
+        },
+        "all_time": {
+          "calls": 1,
+          "tenant_count": 1,
+          "user_count": 1,
+          "component_count": 1,
+          "tenants": {
+            "unknown": 1
+          },
+          "users": {
+            "unknown": 1
+          },
+          "components": {
+            "unknown": 1
+          }
+        },
+        "window": {
+          "calls": 0,
+          "tenant_count": 0,
+          "user_count": 0,
+          "component_count": 0,
+          "tenants": {},
+          "users": {},
+          "components": {}
+        },
+        "last_seen_at": "2026-06-06T17:28:13.047529Z",
+        "retirement_candidate": true,
+        "retirement_reason": "no usage in review window; quiet 81d (>= 7d required for 1 all-time call(s))"
+      },
+      {
+        "interface": {
+          "id": "d0294dce-7913-4268-94c3-1b2502aefb0f",
+          "interface_key": "rest_api:GET /sbom/",
+          "interface_kind": "rest_api",
+          "legacy_since": "2026-08-22T17:06:38.703608Z",
+          "replacement_ref": "sbom-nexus:/sbom/",
+          "owner_component": "state-hub.sbom-compat",
+          "status": "legacy",
+          "replacement_verified": true,
+          "manual_hold": false,
+          "hold_reason": null,
+          "notes": null,
+          "retired_at": null,
+          "created_at": "2026-08-22T17:06:38.703608Z",
+          "updated_at": "2026-08-22T17:23:43.730661Z"
+        },
+        "all_time": {
+          "calls": 4,
+          "tenant_count": 1,
+          "user_count": 1,
+          "component_count": 1,
+          "tenants": {
+            "unknown": 4
+          },
+          "users": {
+            "unknown": 4
+          },
+          "components": {
+            "unknown": 4
+          }
+        },
+        "window": {
+          "calls": 4,
+          "tenant_count": 1,
+          "user_count": 1,
+          "component_count": 1,
+          "tenants": {
+            "unknown": 4
+          },
+          "users": {
+            "unknown": 4
+          },
+          "components": {
+            "unknown": 4
+          }
+        },
+        "last_seen_at": "2026-08-22T17:23:46.146788Z",
+        "retirement_candidate": false,
+        "retirement_reason": "4 call(s) in review window"
+      },
+      {
+        "interface": {
+          "id": "2f77ac12-8c97-4974-a2f9-2996927982d1",
+          "interface_key": "rest_api:GET /sbom/report/licences/",
+          "interface_kind": "rest_api",
+          "legacy_since": "2026-08-22T17:06:41.978426Z",
+          "replacement_ref": "sbom-nexus:/sbom/",
+          "owner_component": "state-hub.sbom-compat",
+          "status": "legacy",
+          "replacement_verified": true,
+          "manual_hold": false,
+          "hold_reason": null,
+          "notes": null,
+          "retired_at": null,
+          "created_at": "2026-08-22T17:06:41.978426Z",
+          "updated_at": "2026-08-22T17:23:44.794796Z"
+        },
+        "all_time": {
+          "calls": 4,
+          "tenant_count": 1,
+          "user_count": 1,
+          "component_count": 1,
+          "tenants": {
+            "unknown": 4
+          },
+          "users": {
+            "unknown": 4
+          },
+          "components": {
+            "unknown": 4
+          }
+        },
+        "window": {
+          "calls": 4,
+          "tenant_count": 1,
+          "user_count": 1,
+          "component_count": 1,
+          "tenants": {
+            "unknown": 4
+          },
+          "users": {
+            "unknown": 4
+          },
+          "components": {
+            "unknown": 4
+          }
+        },
+        "last_seen_at": "2026-08-22T17:56:34.405129Z",
+        "retirement_candidate": false,
+        "retirement_reason": "4 call(s) in review window"
+      },
+      {
+        "interface": {
+          "id": "b627edf5-3302-4366-ba2e-547d32f634b5",
+          "interface_key": "rest_api:GET /sbom/snapshots/",
+          "interface_kind": "rest_api",
+          "legacy_since": "2026-08-22T17:06:37.057774Z",
+          "replacement_ref": "sbom-nexus:/sbom/",
+          "owner_component": "state-hub.sbom-compat",
+          "status": "legacy",
+          "replacement_verified": true,
+          "manual_hold": false,
+          "hold_reason": null,
+          "notes": null,
+          "retired_at": null,
+          "created_at": "2026-08-22T17:06:37.057774Z",
+          "updated_at": "2026-08-22T17:22:15.080213Z"
+        },
+        "all_time": {
+          "calls": 5,
+          "tenant_count": 1,
+          "user_count": 1,
+          "component_count": 1,
+          "tenants": {
+            "unknown": 5
+          },
+          "users": {
+            "unknown": 5
+          },
+          "components": {
+            "unknown": 5
+          }
+        },
+        "window": {
+          "calls": 5,
+          "tenant_count": 1,
+          "user_count": 1,
+          "component_count": 1,
+          "tenants": {
+            "unknown": 5
+          },
+          "users": {
+            "unknown": 5
+          },
+          "components": {
+            "unknown": 5
+          }
+        },
+        "last_seen_at": "2026-08-22T17:23:53.844021Z",
+        "retirement_candidate": false,
+        "retirement_reason": "5 call(s) in review window"
+      },
+      {
+        "interface": {
+          "id": "d03ee274-cd6f-4cd5-8f22-e4d298416299",
+          "interface_key": "rest_api:GET /sbom/snapshots/{snapshot_id}",
+          "interface_kind": "rest_api",
+          "legacy_since": "2026-08-22T17:23:45.969876Z",
+          "replacement_ref": "sbom-nexus:/sbom/",
+          "owner_component": "state-hub.sbom-compat",
+          "status": "legacy",
+          "replacement_verified": true,
+          "manual_hold": false,
+          "hold_reason": null,
+          "notes": null,
+          "retired_at": null,
+          "created_at": "2026-08-22T17:23:45.969876Z",
+          "updated_at": "2026-08-22T17:23:45.969876Z"
+        },
+        "all_time": {
+          "calls": 1,
+          "tenant_count": 1,
+          "user_count": 1,
+          "component_count": 1,
+          "tenants": {
+            "unknown": 1
+          },
+          "users": {
+            "unknown": 1
+          },
+          "components": {
+            "unknown": 1
+          }
+        },
+        "window": {
+          "calls": 1,
+          "tenant_count": 1,
+          "user_count": 1,
+          "component_count": 1,
+          "tenants": {
+            "unknown": 1
+          },
+          "users": {
+            "unknown": 1
+          },
+          "components": {
+            "unknown": 1
+          }
+        },
+        "last_seen_at": "2026-08-22T17:23:45.967492Z",
+        "retirement_candidate": false,
+        "retirement_reason": "1 call(s) in review window"
+      },
+      {
+        "interface": {
+          "id": "a6cb291e-8312-42f8-8a66-fde369482881",
+          "interface_key": "rest_api:GET /sbom/{repo_slug}",
+          "interface_kind": "rest_api",
+          "legacy_since": "2026-08-22T17:23:45.089542Z",
+          "replacement_ref": "sbom-nexus:/sbom/",
+          "owner_component": "state-hub.sbom-compat",
+          "status": "legacy",
+          "replacement_verified": true,
+          "manual_hold": false,
+          "hold_reason": null,
+          "notes": null,
+          "retired_at": null,
+          "created_at": "2026-08-22T17:23:45.089542Z",
+          "updated_at": "2026-08-22T17:23:45.089542Z"
+        },
+        "all_time": {
+          "calls": 1,
+          "tenant_count": 1,
+          "user_count": 1,
+          "component_count": 1,
+          "tenants": {
+            "unknown": 1
+          },
+          "users": {
+            "unknown": 1
+          },
+          "components": {
+            "unknown": 1
+          }
+        },
+        "window": {
+          "calls": 1,
+          "tenant_count": 1,
+          "user_count": 1,
+          "component_count": 1,
+          "tenants": {
+            "unknown": 1
+          },
+          "users": {
+            "unknown": 1
+          },
+          "components": {
+            "unknown": 1
+          }
+        },
+        "last_seen_at": "2026-08-22T17:23:45.670511Z",
+        "retirement_candidate": false,
+        "retirement_reason": "1 call(s) in review window"
+      },
+      {
+        "interface": {
+          "id": "3e4a3d0b-08fa-45c3-91e2-4f514a914b97",
+          "interface_key": "rest_api:GET /workstreams/",
+          "interface_kind": "rest_api",
+          "legacy_since": "2026-06-04T00:26:14.533764Z",
+          "replacement_ref": "/workplans/",
+          "owner_component": "state-hub.api",
+          "status": "legacy",
+          "replacement_verified": true,
+          "manual_hold": false,
+          "hold_reason": null,
+          "notes": null,
+          "retired_at": null,
+          "created_at": "2026-06-04T00:26:14.533764Z",
+          "updated_at": "2026-06-04T00:26:14.533764Z"
+        },
+        "all_time": {
+          "calls": 830269,
+          "tenant_count": 1,
+          "user_count": 1,
+          "component_count": 1,
+          "tenants": {
+            "unknown": 830269
+          },
+          "users": {
+            "unknown": 830269
+          },
+          "components": {
+            "unknown": 830269
+          }
+        },
+        "window": {
+          "calls": 24746,
+          "tenant_count": 1,
+          "user_count": 1,
+          "component_count": 1,
+          "tenants": {
+            "unknown": 24746
+          },
+          "users": {
+            "unknown": 24746
+          },
+          "components": {
+            "unknown": 24746
+          }
+        },
+        "last_seen_at": "2026-08-21T13:50:37.994459Z",
+        "retirement_candidate": false,
+        "retirement_reason": "24746 call(s) in review window"
+      },
+      {
+        "interface": {
+          "id": "e4c140ec-7479-46f9-b185-4b533f19d639",
+          "interface_key": "rest_api:GET /workstreams/workplan-index",
+          "interface_kind": "rest_api",
+          "legacy_since": "2026-06-04T05:20:58.321869Z",
+          "replacement_ref": "/workplans/index",
+          "owner_component": "state-hub.api",
+          "status": "legacy",
+          "replacement_verified": true,
+          "manual_hold": false,
+          "hold_reason": null,
+          "notes": null,
+          "retired_at": null,
+          "created_at": "2026-06-04T05:20:58.321869Z",
+          "updated_at": "2026-06-04T05:20:58.321869Z"
+        },
+        "all_time": {
+          "calls": 39,
+          "tenant_count": 1,
+          "user_count": 1,
+          "component_count": 1,
+          "tenants": {
+            "unknown": 39
+          },
+          "users": {
+            "unknown": 39
+          },
+          "components": {
+            "unknown": 39
+          }
+        },
+        "window": {
+          "calls": 0,
+          "tenant_count": 0,
+          "user_count": 0,
+          "component_count": 0,
+          "tenants": {},
+          "users": {},
+          "components": {}
+        },
+        "last_seen_at": "2026-07-08T05:20:33.378203Z",
+        "retirement_candidate": true,
+        "retirement_reason": "no usage in review window; quiet 50d (>= 7d required for 39 all-time call(s))"
+      },
+      {
+        "interface": {
+          "id": "3a00b19e-e7db-4403-98aa-a77c9ab61ecc",
+          "interface_key": "rest_api:GET /workstreams/{workstream_id}",
+          "interface_kind": "rest_api",
+          "legacy_since": "2026-06-04T00:25:59.014966Z",
+          "replacement_ref": "/workplans/{workplan_id}",
+          "owner_component": "state-hub.api",
+          "status": "legacy",
+          "replacement_verified": true,
+          "manual_hold": false,
+          "hold_reason": null,
+          "notes": null,
+          "retired_at": null,
+          "created_at": "2026-06-04T00:25:59.014966Z",
+          "updated_at": "2026-06-04T00:25:59.014966Z"
+        },
+        "all_time": {
+          "calls": 3411470,
+          "tenant_count": 1,
+          "user_count": 1,
+          "component_count": 1,
+          "tenants": {
+            "unknown": 3411470
+          },
+          "users": {
+            "unknown": 3411470
+          },
+          "components": {
+            "unknown": 3411470
+          }
+        },
+        "window": {
+          "calls": 111410,
+          "tenant_count": 1,
+          "user_count": 1,
+          "component_count": 1,
+          "tenants": {
+            "unknown": 111410
+          },
+          "users": {
+            "unknown": 111410
+          },
+          "components": {
+            "unknown": 111410
+          }
+        },
+        "last_seen_at": "2026-08-21T13:50:32.103349Z",
+        "retirement_candidate": false,
+        "retirement_reason": "111410 call(s) in review window"
+      },
+      {
+        "interface": {
+          "id": "69e1a255-a8b9-4101-8a68-b1bed23abfda",
+          "interface_key": "rest_api:GET /workstreams/{workstream_id}/dependencies/",
+          "interface_kind": "rest_api",
+          "legacy_since": "2026-06-04T00:25:59.291135Z",
+          "replacement_ref": "/workplans/{workplan_id}/dependencies/",
+          "owner_component": "state-hub.api",
+          "status": "legacy",
+          "replacement_verified": true,
+          "manual_hold": false,
+          "hold_reason": null,
+          "notes": null,
+          "retired_at": null,
+          "created_at": "2026-06-04T00:25:59.291135Z",
+          "updated_at": "2026-06-04T00:25:59.291135Z"
+        },
+        "all_time": {
+          "calls": 1643952,
+          "tenant_count": 1,
+          "user_count": 1,
+          "component_count": 1,
+          "tenants": {
+            "unknown": 1643952
+          },
+          "users": {
+            "unknown": 1643952
+          },
+          "components": {
+            "unknown": 1643952
+          }
+        },
+        "window": {
+          "calls": 52105,
+          "tenant_count": 1,
+          "user_count": 1,
+          "component_count": 1,
+          "tenants": {
+            "unknown": 52105
+          },
+          "users": {
+            "unknown": 52105
+          },
+          "components": {
+            "unknown": 52105
+          }
+        },
+        "last_seen_at": "2026-08-21T13:50:30.082480Z",
+        "retirement_candidate": false,
+        "retirement_reason": "52105 call(s) in review window"
+      },
+      {
+        "interface": {
+          "id": "b1aae931-b51f-4a85-a723-865dd65f6132",
+          "interface_key": "rest_api:PATCH /workstreams/{workstream_id}",
+          "interface_kind": "rest_api",
+          "legacy_since": "2026-06-04T06:09:41.901035Z",
+          "replacement_ref": "/workplans/{workplan_id}",
+          "owner_component": "state-hub.api",
+          "status": "legacy",
+          "replacement_verified": true,
+          "manual_hold": false,
+          "hold_reason": null,
+          "notes": null,
+          "retired_at": null,
+          "created_at": "2026-06-04T06:09:41.901035Z",
+          "updated_at": "2026-06-04T06:09:41.901035Z"
+        },
+        "all_time": {
+          "calls": 584,
+          "tenant_count": 1,
+          "user_count": 1,
+          "component_count": 1,
+          "tenants": {
+            "unknown": 584
+          },
+          "users": {
+            "unknown": 584
+          },
+          "components": {
+            "unknown": 584
+          }
+        },
+        "window": {
+          "calls": 0,
+          "tenant_count": 0,
+          "user_count": 0,
+          "component_count": 0,
+          "tenants": {},
+          "users": {},
+          "components": {}
+        },
+        "last_seen_at": "2026-08-16T16:33:34.045078Z",
+        "retirement_candidate": false,
+        "retirement_reason": "quiet 10d of 30d required for 584 all-time call(s)"
+      },
+      {
+        "interface": {
+          "id": "ed6451c9-d2cc-4486-9afe-d3852782cabc",
+          "interface_key": "rest_api:POST /workstreams/",
+          "interface_kind": "rest_api",
+          "legacy_since": "2026-06-04T07:40:24.168535Z",
+          "replacement_ref": "/workplans/",
+          "owner_component": "state-hub.api",
+          "status": "legacy",
+          "replacement_verified": true,
+          "manual_hold": false,
+          "hold_reason": null,
+          "notes": null,
+          "retired_at": null,
+          "created_at": "2026-06-04T07:40:24.168535Z",
+          "updated_at": "2026-06-04T07:40:24.168535Z"
+        },
+        "all_time": {
+          "calls": 811,
+          "tenant_count": 1,
+          "user_count": 1,
+          "component_count": 1,
+          "tenants": {
+            "unknown": 811
+          },
+          "users": {
+            "unknown": 811
+          },
+          "components": {
+            "unknown": 811
+          }
+        },
+        "window": {
+          "calls": 0,
+          "tenant_count": 0,
+          "user_count": 0,
+          "component_count": 0,
+          "tenants": {},
+          "users": {},
+          "components": {}
+        },
+        "last_seen_at": "2026-08-16T01:03:41.093965Z",
+        "retirement_candidate": false,
+        "retirement_reason": "quiet 11d of 30d required for 811 all-time call(s)"
+      },
+      {
+        "interface": {
+          "id": "281fd706-b192-4194-8055-2d8733c115f9",
+          "interface_key": "rest_api:POST /workstreams/{workstream_id}/dependencies/",
+          "interface_kind": "rest_api",
+          "legacy_since": "2026-06-04T22:57:37.149207Z",
+          "replacement_ref": "/workplans/{workplan_id}/dependencies/",
+          "owner_component": "state-hub.api",
+          "status": "legacy",
+          "replacement_verified": true,
+          "manual_hold": false,
+          "hold_reason": null,
+          "notes": null,
+          "retired_at": null,
+          "created_at": "2026-06-04T22:57:37.149207Z",
+          "updated_at": "2026-06-04T22:57:37.149207Z"
+        },
+        "all_time": {
+          "calls": 4975,
+          "tenant_count": 1,
+          "user_count": 1,
+          "component_count": 1,
+          "tenants": {
+            "unknown": 4975
+          },
+          "users": {
+            "unknown": 4975
+          },
+          "components": {
+            "unknown": 4975
+          }
+        },
+        "window": {
+          "calls": 0,
+          "tenant_count": 0,
+          "user_count": 0,
+          "component_count": 0,
+          "tenants": {},
+          "users": {},
+          "components": {}
+        },
+        "last_seen_at": "2026-07-07T20:31:35.389791Z",
+        "retirement_candidate": true,
+        "retirement_reason": "no usage in review window; quiet 50d (>= 30d required for 4975 all-time call(s))"
+      }
+    ],
+    "retirement_candidates": [
+      {
+        "interface": {
+          "id": "8051fb40-66c9-4dc4-a413-13e8573e04a3",
+          "interface_key": "event_subject:org.statehub.workstream.completed",
+          "interface_kind": "event_subject",
+          "legacy_since": "2026-06-04T06:09:42.198193Z",
+          "replacement_ref": "org.statehub.workplan.completed",
+          "owner_component": "state-hub.events",
+          "status": "legacy",
+          "replacement_verified": true,
+          "manual_hold": false,
+          "hold_reason": null,
+          "notes": null,
+          "retired_at": null,
+          "created_at": "2026-06-04T06:09:42.198193Z",
+          "updated_at": "2026-06-04T06:09:42.198193Z"
+        },
+        "all_time": {
+          "calls": 247,
+          "tenant_count": 1,
+          "user_count": 1,
+          "component_count": 1,
+          "tenants": {
+            "unknown": 247
+          },
+          "users": {
+            "unknown": 247
+          },
+          "components": {
+            "state-hub.events": 247
+          }
+        },
+        "window": {
+          "calls": 0,
+          "tenant_count": 0,
+          "user_count": 0,
+          "component_count": 0,
+          "tenants": {},
+          "users": {},
+          "components": {}
+        },
+        "last_seen_at": "2026-07-13T13:22:00.748140Z",
+        "retirement_candidate": true,
+        "retirement_reason": "no usage in review window; quiet 45d (>= 30d required for 247 all-time call(s))"
+      },
+      {
+        "interface": {
+          "id": "cd9342fd-27e7-4a46-a1be-d41499e106a3",
+          "interface_key": "rest_api:DELETE /workstreams/{workstream_id}",
+          "interface_kind": "rest_api",
+          "legacy_since": "2026-06-06T17:28:13.052813Z",
+          "replacement_ref": "/workplans/{workplan_id}",
+          "owner_component": "state-hub.api",
+          "status": "legacy",
+          "replacement_verified": true,
+          "manual_hold": false,
+          "hold_reason": null,
+          "notes": null,
+          "retired_at": null,
+          "created_at": "2026-06-06T17:28:13.052813Z",
+          "updated_at": "2026-06-06T17:28:13.052813Z"
+        },
+        "all_time": {
+          "calls": 1,
+          "tenant_count": 1,
+          "user_count": 1,
+          "component_count": 1,
+          "tenants": {
+            "unknown": 1
+          },
+          "users": {
+            "unknown": 1
+          },
+          "components": {
+            "unknown": 1
+          }
+        },
+        "window": {
+          "calls": 0,
+          "tenant_count": 0,
+          "user_count": 0,
+          "component_count": 0,
+          "tenants": {},
+          "users": {},
+          "components": {}
+        },
+        "last_seen_at": "2026-06-06T17:28:13.047529Z",
+        "retirement_candidate": true,
+        "retirement_reason": "no usage in review window; quiet 81d (>= 7d required for 1 all-time call(s))"
+      },
+      {
+        "interface": {
+          "id": "e4c140ec-7479-46f9-b185-4b533f19d639",
+          "interface_key": "rest_api:GET /workstreams/workplan-index",
+          "interface_kind": "rest_api",
+          "legacy_since": "2026-06-04T05:20:58.321869Z",
+          "replacement_ref": "/workplans/index",
+          "owner_component": "state-hub.api",
+          "status": "legacy",
+          "replacement_verified": true,
+          "manual_hold": false,
+          "hold_reason": null,
+          "notes": null,
+          "retired_at": null,
+          "created_at": "2026-06-04T05:20:58.321869Z",
+          "updated_at": "2026-06-04T05:20:58.321869Z"
+        },
+        "all_time": {
+          "calls": 39,
+          "tenant_count": 1,
+          "user_count": 1,
+          "component_count": 1,
+          "tenants": {
+            "unknown": 39
+          },
+          "users": {
+            "unknown": 39
+          },
+          "components": {
+            "unknown": 39
+          }
+        },
+        "window": {
+          "calls": 0,
+          "tenant_count": 0,
+          "user_count": 0,
+          "component_count": 0,
+          "tenants": {},
+          "users": {},
+          "components": {}
+        },
+        "last_seen_at": "2026-07-08T05:20:33.378203Z",
+        "retirement_candidate": true,
+        "retirement_reason": "no usage in review window; quiet 50d (>= 7d required for 39 all-time call(s))"
+      },
+      {
+        "interface": {
+          "id": "281fd706-b192-4194-8055-2d8733c115f9",
+          "interface_key": "rest_api:POST /workstreams/{workstream_id}/dependencies/",
+          "interface_kind": "rest_api",
+          "legacy_since": "2026-06-04T22:57:37.149207Z",
+          "replacement_ref": "/workplans/{workplan_id}/dependencies/",
+          "owner_component": "state-hub.api",
+          "status": "legacy",
+          "replacement_verified": true,
+          "manual_hold": false,
+          "hold_reason": null,
+          "notes": null,
+          "retired_at": null,
+          "created_at": "2026-06-04T22:57:37.149207Z",
+          "updated_at": "2026-06-04T22:57:37.149207Z"
+        },
+        "all_time": {
+          "calls": 4975,
+          "tenant_count": 1,
+          "user_count": 1,
+          "component_count": 1,
+          "tenants": {
+            "unknown": 4975
+          },
+          "users": {
+            "unknown": 4975
+          },
+          "components": {
+            "unknown": 4975
+          }
+        },
+        "window": {
+          "calls": 0,
+          "tenant_count": 0,
+          "user_count": 0,
+          "component_count": 0,
+          "tenants": {},
+          "users": {},
+          "components": {}
+        },
+        "last_seen_at": "2026-07-07T20:31:35.389791Z",
+        "retirement_candidate": true,
+        "retirement_reason": "no usage in review window; quiet 50d (>= 30d required for 4975 all-time call(s))"
+      }
+    ]
+  },
+  "days": 7
+}
diff --git a/docs/evidence/legacy-meter-weekly-review-20260828.json b/docs/evidence/legacy-meter-weekly-review-20260828.json
new file mode 100644
index 0000000..d2ec210
--- /dev/null
+++ b/docs/evidence/legacy-meter-weekly-review-20260828.json
@@ -0,0 +1,864 @@
+{
+  "captured_at": "2026-08-28T14:00:05.975050+00:00",
+  "api_base": "http://127.0.0.1:8000",
+  "workplan": "STATE-WP-0070",
+  "retired_interfaces": [],
+  "weekly_review": {
+    "generated_at": "2026-08-28T14:00:08.582683Z",
+    "window_start": "2026-08-21T14:00:07.408074Z",
+    "window_end": "2026-08-28T14:00:07.408074Z",
+    "cadence": "weekly",
+    "activity_core_handoff": {
+      "activity_id": "statehub-legacy-interface-review",
+      "cadence": "weekly",
+      "source_endpoint": "/legacy-meter/weekly-review",
+      "state_owner": "state-hub",
+      "scheduler_owner": "activity-core"
+    },
+    "interfaces": [
+      {
+        "interface": {
+          "id": "8051fb40-66c9-4dc4-a413-13e8573e04a3",
+          "interface_key": "event_subject:org.statehub.workstream.completed",
+          "interface_kind": "event_subject",
+          "legacy_since": "2026-06-04T06:09:42.198193Z",
+          "replacement_ref": "org.statehub.workplan.completed",
+          "owner_component": "state-hub.events",
+          "status": "legacy",
+          "replacement_verified": true,
+          "manual_hold": false,
+          "hold_reason": null,
+          "notes": null,
+          "retired_at": null,
+          "created_at": "2026-06-04T06:09:42.198193Z",
+          "updated_at": "2026-06-04T06:09:42.198193Z"
+        },
+        "all_time": {
+          "calls": 247,
+          "tenant_count": 1,
+          "user_count": 1,
+          "component_count": 1,
+          "tenants": {
+            "unknown": 247
+          },
+          "users": {
+            "unknown": 247
+          },
+          "components": {
+            "state-hub.events": 247
+          }
+        },
+        "window": {
+          "calls": 0,
+          "tenant_count": 0,
+          "user_count": 0,
+          "component_count": 0,
+          "tenants": {},
+          "users": {},
+          "components": {}
+        },
+        "last_seen_at": "2026-07-13T13:22:00.748140Z",
+        "retirement_candidate": true,
+        "retirement_reason": "no usage in review window; quiet 46d (>= 30d required for 247 all-time call(s))"
+      },
+      {
+        "interface": {
+          "id": "cd9342fd-27e7-4a46-a1be-d41499e106a3",
+          "interface_key": "rest_api:DELETE /workstreams/{workstream_id}",
+          "interface_kind": "rest_api",
+          "legacy_since": "2026-06-06T17:28:13.052813Z",
+          "replacement_ref": "/workplans/{workplan_id}",
+          "owner_component": "state-hub.api",
+          "status": "legacy",
+          "replacement_verified": true,
+          "manual_hold": false,
+          "hold_reason": null,
+          "notes": null,
+          "retired_at": null,
+          "created_at": "2026-06-06T17:28:13.052813Z",
+          "updated_at": "2026-06-06T17:28:13.052813Z"
+        },
+        "all_time": {
+          "calls": 1,
+          "tenant_count": 1,
+          "user_count": 1,
+          "component_count": 1,
+          "tenants": {
+            "unknown": 1
+          },
+          "users": {
+            "unknown": 1
+          },
+          "components": {
+            "unknown": 1
+          }
+        },
+        "window": {
+          "calls": 0,
+          "tenant_count": 0,
+          "user_count": 0,
+          "component_count": 0,
+          "tenants": {},
+          "users": {},
+          "components": {}
+        },
+        "last_seen_at": "2026-06-06T17:28:13.047529Z",
+        "retirement_candidate": true,
+        "retirement_reason": "no usage in review window; quiet 82d (>= 7d required for 1 all-time call(s))"
+      },
+      {
+        "interface": {
+          "id": "d0294dce-7913-4268-94c3-1b2502aefb0f",
+          "interface_key": "rest_api:GET /sbom/",
+          "interface_kind": "rest_api",
+          "legacy_since": "2026-08-22T17:06:38.703608Z",
+          "replacement_ref": "sbom-nexus:/sbom/",
+          "owner_component": "state-hub.sbom-compat",
+          "status": "legacy",
+          "replacement_verified": true,
+          "manual_hold": false,
+          "hold_reason": null,
+          "notes": null,
+          "retired_at": null,
+          "created_at": "2026-08-22T17:06:38.703608Z",
+          "updated_at": "2026-08-22T17:23:43.730661Z"
+        },
+        "all_time": {
+          "calls": 4,
+          "tenant_count": 1,
+          "user_count": 1,
+          "component_count": 1,
+          "tenants": {
+            "unknown": 4
+          },
+          "users": {
+            "unknown": 4
+          },
+          "components": {
+            "unknown": 4
+          }
+        },
+        "window": {
+          "calls": 4,
+          "tenant_count": 1,
+          "user_count": 1,
+          "component_count": 1,
+          "tenants": {
+            "unknown": 4
+          },
+          "users": {
+            "unknown": 4
+          },
+          "components": {
+            "unknown": 4
+          }
+        },
+        "last_seen_at": "2026-08-22T17:23:46.146788Z",
+        "retirement_candidate": false,
+        "retirement_reason": "4 call(s) in review window"
+      },
+      {
+        "interface": {
+          "id": "2f77ac12-8c97-4974-a2f9-2996927982d1",
+          "interface_key": "rest_api:GET /sbom/report/licences/",
+          "interface_kind": "rest_api",
+          "legacy_since": "2026-08-22T17:06:41.978426Z",
+          "replacement_ref": "sbom-nexus:/sbom/",
+          "owner_component": "state-hub.sbom-compat",
+          "status": "legacy",
+          "replacement_verified": true,
+          "manual_hold": false,
+          "hold_reason": null,
+          "notes": null,
+          "retired_at": null,
+          "created_at": "2026-08-22T17:06:41.978426Z",
+          "updated_at": "2026-08-22T17:23:44.794796Z"
+        },
+        "all_time": {
+          "calls": 4,
+          "tenant_count": 1,
+          "user_count": 1,
+          "component_count": 1,
+          "tenants": {
+            "unknown": 4
+          },
+          "users": {
+            "unknown": 4
+          },
+          "components": {
+            "unknown": 4
+          }
+        },
+        "window": {
+          "calls": 4,
+          "tenant_count": 1,
+          "user_count": 1,
+          "component_count": 1,
+          "tenants": {
+            "unknown": 4
+          },
+          "users": {
+            "unknown": 4
+          },
+          "components": {
+            "unknown": 4
+          }
+        },
+        "last_seen_at": "2026-08-22T17:56:34.405129Z",
+        "retirement_candidate": false,
+        "retirement_reason": "4 call(s) in review window"
+      },
+      {
+        "interface": {
+          "id": "b627edf5-3302-4366-ba2e-547d32f634b5",
+          "interface_key": "rest_api:GET /sbom/snapshots/",
+          "interface_kind": "rest_api",
+          "legacy_since": "2026-08-22T17:06:37.057774Z",
+          "replacement_ref": "sbom-nexus:/sbom/",
+          "owner_component": "state-hub.sbom-compat",
+          "status": "legacy",
+          "replacement_verified": true,
+          "manual_hold": false,
+          "hold_reason": null,
+          "notes": null,
+          "retired_at": null,
+          "created_at": "2026-08-22T17:06:37.057774Z",
+          "updated_at": "2026-08-22T17:22:15.080213Z"
+        },
+        "all_time": {
+          "calls": 5,
+          "tenant_count": 1,
+          "user_count": 1,
+          "component_count": 1,
+          "tenants": {
+            "unknown": 5
+          },
+          "users": {
+            "unknown": 5
+          },
+          "components": {
+            "unknown": 5
+          }
+        },
+        "window": {
+          "calls": 5,
+          "tenant_count": 1,
+          "user_count": 1,
+          "component_count": 1,
+          "tenants": {
+            "unknown": 5
+          },
+          "users": {
+            "unknown": 5
+          },
+          "components": {
+            "unknown": 5
+          }
+        },
+        "last_seen_at": "2026-08-22T17:23:53.844021Z",
+        "retirement_candidate": false,
+        "retirement_reason": "5 call(s) in review window"
+      },
+      {
+        "interface": {
+          "id": "d03ee274-cd6f-4cd5-8f22-e4d298416299",
+          "interface_key": "rest_api:GET /sbom/snapshots/{snapshot_id}",
+          "interface_kind": "rest_api",
+          "legacy_since": "2026-08-22T17:23:45.969876Z",
+          "replacement_ref": "sbom-nexus:/sbom/",
+          "owner_component": "state-hub.sbom-compat",
+          "status": "legacy",
+          "replacement_verified": true,
+          "manual_hold": false,
+          "hold_reason": null,
+          "notes": null,
+          "retired_at": null,
+          "created_at": "2026-08-22T17:23:45.969876Z",
+          "updated_at": "2026-08-22T17:23:45.969876Z"
+        },
+        "all_time": {
+          "calls": 1,
+          "tenant_count": 1,
+          "user_count": 1,
+          "component_count": 1,
+          "tenants": {
+            "unknown": 1
+          },
+          "users": {
+            "unknown": 1
+          },
+          "components": {
+            "unknown": 1
+          }
+        },
+        "window": {
+          "calls": 1,
+          "tenant_count": 1,
+          "user_count": 1,
+          "component_count": 1,
+          "tenants": {
+            "unknown": 1
+          },
+          "users": {
+            "unknown": 1
+          },
+          "components": {
+            "unknown": 1
+          }
+        },
+        "last_seen_at": "2026-08-22T17:23:45.967492Z",
+        "retirement_candidate": false,
+        "retirement_reason": "1 call(s) in review window"
+      },
+      {
+        "interface": {
+          "id": "a6cb291e-8312-42f8-8a66-fde369482881",
+          "interface_key": "rest_api:GET /sbom/{repo_slug}",
+          "interface_kind": "rest_api",
+          "legacy_since": "2026-08-22T17:23:45.089542Z",
+          "replacement_ref": "sbom-nexus:/sbom/",
+          "owner_component": "state-hub.sbom-compat",
+          "status": "legacy",
+          "replacement_verified": true,
+          "manual_hold": false,
+          "hold_reason": null,
+          "notes": null,
+          "retired_at": null,
+          "created_at": "2026-08-22T17:23:45.089542Z",
+          "updated_at": "2026-08-22T17:23:45.089542Z"
+        },
+        "all_time": {
+          "calls": 1,
+          "tenant_count": 1,
+          "user_count": 1,
+          "component_count": 1,
+          "tenants": {
+            "unknown": 1
+          },
+          "users": {
+            "unknown": 1
+          },
+          "components": {
+            "unknown": 1
+          }
+        },
+        "window": {
+          "calls": 1,
+          "tenant_count": 1,
+          "user_count": 1,
+          "component_count": 1,
+          "tenants": {
+            "unknown": 1
+          },
+          "users": {
+            "unknown": 1
+          },
+          "components": {
+            "unknown": 1
+          }
+        },
+        "last_seen_at": "2026-08-22T17:23:45.670511Z",
+        "retirement_candidate": false,
+        "retirement_reason": "1 call(s) in review window"
+      },
+      {
+        "interface": {
+          "id": "3e4a3d0b-08fa-45c3-91e2-4f514a914b97",
+          "interface_key": "rest_api:GET /workstreams/",
+          "interface_kind": "rest_api",
+          "legacy_since": "2026-06-04T00:26:14.533764Z",
+          "replacement_ref": "/workplans/",
+          "owner_component": "state-hub.api",
+          "status": "legacy",
+          "replacement_verified": true,
+          "manual_hold": false,
+          "hold_reason": null,
+          "notes": null,
+          "retired_at": null,
+          "created_at": "2026-06-04T00:26:14.533764Z",
+          "updated_at": "2026-06-04T00:26:14.533764Z"
+        },
+        "all_time": {
+          "calls": 830269,
+          "tenant_count": 1,
+          "user_count": 1,
+          "component_count": 1,
+          "tenants": {
+            "unknown": 830269
+          },
+          "users": {
+            "unknown": 830269
+          },
+          "components": {
+            "unknown": 830269
+          }
+        },
+        "window": {
+          "calls": 0,
+          "tenant_count": 0,
+          "user_count": 0,
+          "component_count": 0,
+          "tenants": {},
+          "users": {},
+          "components": {}
+        },
+        "last_seen_at": "2026-08-21T13:50:37.994459Z",
+        "retirement_candidate": false,
+        "retirement_reason": "quiet 7d of 60d required for 830269 all-time call(s)"
+      },
+      {
+        "interface": {
+          "id": "e4c140ec-7479-46f9-b185-4b533f19d639",
+          "interface_key": "rest_api:GET /workstreams/workplan-index",
+          "interface_kind": "rest_api",
+          "legacy_since": "2026-06-04T05:20:58.321869Z",
+          "replacement_ref": "/workplans/index",
+          "owner_component": "state-hub.api",
+          "status": "legacy",
+          "replacement_verified": true,
+          "manual_hold": false,
+          "hold_reason": null,
+          "notes": null,
+          "retired_at": null,
+          "created_at": "2026-06-04T05:20:58.321869Z",
+          "updated_at": "2026-06-04T05:20:58.321869Z"
+        },
+        "all_time": {
+          "calls": 39,
+          "tenant_count": 1,
+          "user_count": 1,
+          "component_count": 1,
+          "tenants": {
+            "unknown": 39
+          },
+          "users": {
+            "unknown": 39
+          },
+          "components": {
+            "unknown": 39
+          }
+        },
+        "window": {
+          "calls": 0,
+          "tenant_count": 0,
+          "user_count": 0,
+          "component_count": 0,
+          "tenants": {},
+          "users": {},
+          "components": {}
+        },
+        "last_seen_at": "2026-07-08T05:20:33.378203Z",
+        "retirement_candidate": true,
+        "retirement_reason": "no usage in review window; quiet 51d (>= 7d required for 39 all-time call(s))"
+      },
+      {
+        "interface": {
+          "id": "3a00b19e-e7db-4403-98aa-a77c9ab61ecc",
+          "interface_key": "rest_api:GET /workstreams/{workstream_id}",
+          "interface_kind": "rest_api",
+          "legacy_since": "2026-06-04T00:25:59.014966Z",
+          "replacement_ref": "/workplans/{workplan_id}",
+          "owner_component": "state-hub.api",
+          "status": "legacy",
+          "replacement_verified": true,
+          "manual_hold": false,
+          "hold_reason": null,
+          "notes": null,
+          "retired_at": null,
+          "created_at": "2026-06-04T00:25:59.014966Z",
+          "updated_at": "2026-06-04T00:25:59.014966Z"
+        },
+        "all_time": {
+          "calls": 3411470,
+          "tenant_count": 1,
+          "user_count": 1,
+          "component_count": 1,
+          "tenants": {
+            "unknown": 3411470
+          },
+          "users": {
+            "unknown": 3411470
+          },
+          "components": {
+            "unknown": 3411470
+          }
+        },
+        "window": {
+          "calls": 0,
+          "tenant_count": 0,
+          "user_count": 0,
+          "component_count": 0,
+          "tenants": {},
+          "users": {},
+          "components": {}
+        },
+        "last_seen_at": "2026-08-21T13:50:32.103349Z",
+        "retirement_candidate": false,
+        "retirement_reason": "quiet 7d of 60d required for 3411470 all-time call(s)"
+      },
+      {
+        "interface": {
+          "id": "69e1a255-a8b9-4101-8a68-b1bed23abfda",
+          "interface_key": "rest_api:GET /workstreams/{workstream_id}/dependencies/",
+          "interface_kind": "rest_api",
+          "legacy_since": "2026-06-04T00:25:59.291135Z",
+          "replacement_ref": "/workplans/{workplan_id}/dependencies/",
+          "owner_component": "state-hub.api",
+          "status": "legacy",
+          "replacement_verified": true,
+          "manual_hold": false,
+          "hold_reason": null,
+          "notes": null,
+          "retired_at": null,
+          "created_at": "2026-06-04T00:25:59.291135Z",
+          "updated_at": "2026-06-04T00:25:59.291135Z"
+        },
+        "all_time": {
+          "calls": 1643952,
+          "tenant_count": 1,
+          "user_count": 1,
+          "component_count": 1,
+          "tenants": {
+            "unknown": 1643952
+          },
+          "users": {
+            "unknown": 1643952
+          },
+          "components": {
+            "unknown": 1643952
+          }
+        },
+        "window": {
+          "calls": 0,
+          "tenant_count": 0,
+          "user_count": 0,
+          "component_count": 0,
+          "tenants": {},
+          "users": {},
+          "components": {}
+        },
+        "last_seen_at": "2026-08-21T13:50:30.082480Z",
+        "retirement_candidate": false,
+        "retirement_reason": "quiet 7d of 60d required for 1643952 all-time call(s)"
+      },
+      {
+        "interface": {
+          "id": "b1aae931-b51f-4a85-a723-865dd65f6132",
+          "interface_key": "rest_api:PATCH /workstreams/{workstream_id}",
+          "interface_kind": "rest_api",
+          "legacy_since": "2026-06-04T06:09:41.901035Z",
+          "replacement_ref": "/workplans/{workplan_id}",
+          "owner_component": "state-hub.api",
+          "status": "legacy",
+          "replacement_verified": true,
+          "manual_hold": false,
+          "hold_reason": null,
+          "notes": null,
+          "retired_at": null,
+          "created_at": "2026-06-04T06:09:41.901035Z",
+          "updated_at": "2026-06-04T06:09:41.901035Z"
+        },
+        "all_time": {
+          "calls": 584,
+          "tenant_count": 1,
+          "user_count": 1,
+          "component_count": 1,
+          "tenants": {
+            "unknown": 584
+          },
+          "users": {
+            "unknown": 584
+          },
+          "components": {
+            "unknown": 584
+          }
+        },
+        "window": {
+          "calls": 0,
+          "tenant_count": 0,
+          "user_count": 0,
+          "component_count": 0,
+          "tenants": {},
+          "users": {},
+          "components": {}
+        },
+        "last_seen_at": "2026-08-16T16:33:34.045078Z",
+        "retirement_candidate": false,
+        "retirement_reason": "quiet 11d of 30d required for 584 all-time call(s)"
+      },
+      {
+        "interface": {
+          "id": "ed6451c9-d2cc-4486-9afe-d3852782cabc",
+          "interface_key": "rest_api:POST /workstreams/",
+          "interface_kind": "rest_api",
+          "legacy_since": "2026-06-04T07:40:24.168535Z",
+          "replacement_ref": "/workplans/",
+          "owner_component": "state-hub.api",
+          "status": "legacy",
+          "replacement_verified": true,
+          "manual_hold": false,
+          "hold_reason": null,
+          "notes": null,
+          "retired_at": null,
+          "created_at": "2026-06-04T07:40:24.168535Z",
+          "updated_at": "2026-06-04T07:40:24.168535Z"
+        },
+        "all_time": {
+          "calls": 811,
+          "tenant_count": 1,
+          "user_count": 1,
+          "component_count": 1,
+          "tenants": {
+            "unknown": 811
+          },
+          "users": {
+            "unknown": 811
+          },
+          "components": {
+            "unknown": 811
+          }
+        },
+        "window": {
+          "calls": 0,
+          "tenant_count": 0,
+          "user_count": 0,
+          "component_count": 0,
+          "tenants": {},
+          "users": {},
+          "components": {}
+        },
+        "last_seen_at": "2026-08-16T01:03:41.093965Z",
+        "retirement_candidate": false,
+        "retirement_reason": "quiet 12d of 30d required for 811 all-time call(s)"
+      },
+      {
+        "interface": {
+          "id": "281fd706-b192-4194-8055-2d8733c115f9",
+          "interface_key": "rest_api:POST /workstreams/{workstream_id}/dependencies/",
+          "interface_kind": "rest_api",
+          "legacy_since": "2026-06-04T22:57:37.149207Z",
+          "replacement_ref": "/workplans/{workplan_id}/dependencies/",
+          "owner_component": "state-hub.api",
+          "status": "legacy",
+          "replacement_verified": true,
+          "manual_hold": false,
+          "hold_reason": null,
+          "notes": null,
+          "retired_at": null,
+          "created_at": "2026-06-04T22:57:37.149207Z",
+          "updated_at": "2026-06-04T22:57:37.149207Z"
+        },
+        "all_time": {
+          "calls": 4975,
+          "tenant_count": 1,
+          "user_count": 1,
+          "component_count": 1,
+          "tenants": {
+            "unknown": 4975
+          },
+          "users": {
+            "unknown": 4975
+          },
+          "components": {
+            "unknown": 4975
+          }
+        },
+        "window": {
+          "calls": 0,
+          "tenant_count": 0,
+          "user_count": 0,
+          "component_count": 0,
+          "tenants": {},
+          "users": {},
+          "components": {}
+        },
+        "last_seen_at": "2026-07-07T20:31:35.389791Z",
+        "retirement_candidate": true,
+        "retirement_reason": "no usage in review window; quiet 51d (>= 30d required for 4975 all-time call(s))"
+      }
+    ],
+    "retirement_candidates": [
+      {
+        "interface": {
+          "id": "8051fb40-66c9-4dc4-a413-13e8573e04a3",
+          "interface_key": "event_subject:org.statehub.workstream.completed",
+          "interface_kind": "event_subject",
+          "legacy_since": "2026-06-04T06:09:42.198193Z",
+          "replacement_ref": "org.statehub.workplan.completed",
+          "owner_component": "state-hub.events",
+          "status": "legacy",
+          "replacement_verified": true,
+          "manual_hold": false,
+          "hold_reason": null,
+          "notes": null,
+          "retired_at": null,
+          "created_at": "2026-06-04T06:09:42.198193Z",
+          "updated_at": "2026-06-04T06:09:42.198193Z"
+        },
+        "all_time": {
+          "calls": 247,
+          "tenant_count": 1,
+          "user_count": 1,
+          "component_count": 1,
+          "tenants": {
+            "unknown": 247
+          },
+          "users": {
+            "unknown": 247
+          },
+          "components": {
+            "state-hub.events": 247
+          }
+        },
+        "window": {
+          "calls": 0,
+          "tenant_count": 0,
+          "user_count": 0,
+          "component_count": 0,
+          "tenants": {},
+          "users": {},
+          "components": {}
+        },
+        "last_seen_at": "2026-07-13T13:22:00.748140Z",
+        "retirement_candidate": true,
+        "retirement_reason": "no usage in review window; quiet 46d (>= 30d required for 247 all-time call(s))"
+      },
+      {
+        "interface": {
+          "id": "cd9342fd-27e7-4a46-a1be-d41499e106a3",
+          "interface_key": "rest_api:DELETE /workstreams/{workstream_id}",
+          "interface_kind": "rest_api",
+          "legacy_since": "2026-06-06T17:28:13.052813Z",
+          "replacement_ref": "/workplans/{workplan_id}",
+          "owner_component": "state-hub.api",
+          "status": "legacy",
+          "replacement_verified": true,
+          "manual_hold": false,
+          "hold_reason": null,
+          "notes": null,
+          "retired_at": null,
+          "created_at": "2026-06-06T17:28:13.052813Z",
+          "updated_at": "2026-06-06T17:28:13.052813Z"
+        },
+        "all_time": {
+          "calls": 1,
+          "tenant_count": 1,
+          "user_count": 1,
+          "component_count": 1,
+          "tenants": {
+            "unknown": 1
+          },
+          "users": {
+            "unknown": 1
+          },
+          "components": {
+            "unknown": 1
+          }
+        },
+        "window": {
+          "calls": 0,
+          "tenant_count": 0,
+          "user_count": 0,
+          "component_count": 0,
+          "tenants": {},
+          "users": {},
+          "components": {}
+        },
+        "last_seen_at": "2026-06-06T17:28:13.047529Z",
+        "retirement_candidate": true,
+        "retirement_reason": "no usage in review window; quiet 82d (>= 7d required for 1 all-time call(s))"
+      },
+      {
+        "interface": {
+          "id": "e4c140ec-7479-46f9-b185-4b533f19d639",
+          "interface_key": "rest_api:GET /workstreams/workplan-index",
+          "interface_kind": "rest_api",
+          "legacy_since": "2026-06-04T05:20:58.321869Z",
+          "replacement_ref": "/workplans/index",
+          "owner_component": "state-hub.api",
+          "status": "legacy",
+          "replacement_verified": true,
+          "manual_hold": false,
+          "hold_reason": null,
+          "notes": null,
+          "retired_at": null,
+          "created_at": "2026-06-04T05:20:58.321869Z",
+          "updated_at": "2026-06-04T05:20:58.321869Z"
+        },
+        "all_time": {
+          "calls": 39,
+          "tenant_count": 1,
+          "user_count": 1,
+          "component_count": 1,
+          "tenants": {
+            "unknown": 39
+          },
+          "users": {
+            "unknown": 39
+          },
+          "components": {
+            "unknown": 39
+          }
+        },
+        "window": {
+          "calls": 0,
+          "tenant_count": 0,
+          "user_count": 0,
+          "component_count": 0,
+          "tenants": {},
+          "users": {},
+          "components": {}
+        },
+        "last_seen_at": "2026-07-08T05:20:33.378203Z",
+        "retirement_candidate": true,
+        "retirement_reason": "no usage in review window; quiet 51d (>= 7d required for 39 all-time call(s))"
+      },
+      {
+        "interface": {
+          "id": "281fd706-b192-4194-8055-2d8733c115f9",
+          "interface_key": "rest_api:POST /workstreams/{workstream_id}/dependencies/",
+          "interface_kind": "rest_api",
+          "legacy_since": "2026-06-04T22:57:37.149207Z",
+          "replacement_ref": "/workplans/{workplan_id}/dependencies/",
+          "owner_component": "state-hub.api",
+          "status": "legacy",
+          "replacement_verified": true,
+          "manual_hold": false,
+          "hold_reason": null,
+          "notes": null,
+          "retired_at": null,
+          "created_at": "2026-06-04T22:57:37.149207Z",
+          "updated_at": "2026-06-04T22:57:37.149207Z"
+        },
+        "all_time": {
+          "calls": 4975,
+          "tenant_count": 1,
+          "user_count": 1,
+          "component_count": 1,
+          "tenants": {
+            "unknown": 4975
+          },
+          "users": {
+            "unknown": 4975
+          },
+          "components": {
+            "unknown": 4975
+          }
+        },
+        "window": {
+          "calls": 0,
+          "tenant_count": 0,
+          "user_count": 0,
+          "component_count": 0,
+          "tenants": {},
+          "users": {},
+          "components": {}
+        },
+        "last_seen_at": "2026-07-07T20:31:35.389791Z",
+        "retirement_candidate": true,
+        "retirement_reason": "no usage in review window; quiet 51d (>= 30d required for 4975 all-time call(s))"
+      }
+    ]
+  },
+  "days": 7
+}
diff --git a/docs/evidence/legacy-meter-weekly-review-20260829.json b/docs/evidence/legacy-meter-weekly-review-20260829.json
new file mode 100644
index 0000000..d857b97
--- /dev/null
+++ b/docs/evidence/legacy-meter-weekly-review-20260829.json
@@ -0,0 +1,915 @@
+{
+  "captured_at": "2026-08-29T14:00:07.694742+00:00",
+  "api_base": "http://127.0.0.1:8000",
+  "workplan": "STATE-WP-0070",
+  "retired_interfaces": [],
+  "weekly_review": {
+    "generated_at": "2026-08-29T14:00:07.910713Z",
+    "window_start": "2026-08-22T14:00:07.236179Z",
+    "window_end": "2026-08-29T14:00:07.236179Z",
+    "cadence": "weekly",
+    "activity_core_handoff": {
+      "activity_id": "statehub-legacy-interface-review",
+      "cadence": "weekly",
+      "source_endpoint": "/legacy-meter/weekly-review",
+      "state_owner": "state-hub",
+      "scheduler_owner": "activity-core"
+    },
+    "interfaces": [
+      {
+        "interface": {
+          "id": "8051fb40-66c9-4dc4-a413-13e8573e04a3",
+          "interface_key": "event_subject:org.statehub.workstream.completed",
+          "interface_kind": "event_subject",
+          "legacy_since": "2026-06-04T06:09:42.198193Z",
+          "replacement_ref": "org.statehub.workplan.completed",
+          "owner_component": "state-hub.events",
+          "status": "legacy",
+          "replacement_verified": true,
+          "manual_hold": false,
+          "hold_reason": null,
+          "notes": null,
+          "retired_at": null,
+          "created_at": "2026-06-04T06:09:42.198193Z",
+          "updated_at": "2026-06-04T06:09:42.198193Z"
+        },
+        "all_time": {
+          "calls": 247,
+          "tenant_count": 1,
+          "user_count": 1,
+          "component_count": 1,
+          "tenants": {
+            "unknown": 247
+          },
+          "users": {
+            "unknown": 247
+          },
+          "components": {
+            "state-hub.events": 247
+          }
+        },
+        "window": {
+          "calls": 0,
+          "tenant_count": 0,
+          "user_count": 0,
+          "component_count": 0,
+          "tenants": {},
+          "users": {},
+          "components": {}
+        },
+        "last_seen_at": "2026-07-13T13:22:00.748140Z",
+        "retirement_candidate": true,
+        "retirement_reason": "no usage in review window; quiet 47d (>= 30d required for 247 all-time call(s))"
+      },
+      {
+        "interface": {
+          "id": "cd9342fd-27e7-4a46-a1be-d41499e106a3",
+          "interface_key": "rest_api:DELETE /workstreams/{workstream_id}",
+          "interface_kind": "rest_api",
+          "legacy_since": "2026-06-06T17:28:13.052813Z",
+          "replacement_ref": "/workplans/{workplan_id}",
+          "owner_component": "state-hub.api",
+          "status": "legacy",
+          "replacement_verified": true,
+          "manual_hold": false,
+          "hold_reason": null,
+          "notes": null,
+          "retired_at": null,
+          "created_at": "2026-06-06T17:28:13.052813Z",
+          "updated_at": "2026-06-06T17:28:13.052813Z"
+        },
+        "all_time": {
+          "calls": 1,
+          "tenant_count": 1,
+          "user_count": 1,
+          "component_count": 1,
+          "tenants": {
+            "unknown": 1
+          },
+          "users": {
+            "unknown": 1
+          },
+          "components": {
+            "unknown": 1
+          }
+        },
+        "window": {
+          "calls": 0,
+          "tenant_count": 0,
+          "user_count": 0,
+          "component_count": 0,
+          "tenants": {},
+          "users": {},
+          "components": {}
+        },
+        "last_seen_at": "2026-06-06T17:28:13.047529Z",
+        "retirement_candidate": true,
+        "retirement_reason": "no usage in review window; quiet 83d (>= 7d required for 1 all-time call(s))"
+      },
+      {
+        "interface": {
+          "id": "d0294dce-7913-4268-94c3-1b2502aefb0f",
+          "interface_key": "rest_api:GET /sbom/",
+          "interface_kind": "rest_api",
+          "legacy_since": "2026-08-22T17:06:38.703608Z",
+          "replacement_ref": "sbom-nexus:/sbom/",
+          "owner_component": "state-hub.sbom-compat",
+          "status": "legacy",
+          "replacement_verified": true,
+          "manual_hold": false,
+          "hold_reason": null,
+          "notes": null,
+          "retired_at": null,
+          "created_at": "2026-08-22T17:06:38.703608Z",
+          "updated_at": "2026-08-22T17:23:43.730661Z"
+        },
+        "all_time": {
+          "calls": 5,
+          "tenant_count": 1,
+          "user_count": 1,
+          "component_count": 1,
+          "tenants": {
+            "unknown": 5
+          },
+          "users": {
+            "unknown": 5
+          },
+          "components": {
+            "unknown": 5
+          }
+        },
+        "window": {
+          "calls": 5,
+          "tenant_count": 1,
+          "user_count": 1,
+          "component_count": 1,
+          "tenants": {
+            "unknown": 5
+          },
+          "users": {
+            "unknown": 5
+          },
+          "components": {
+            "unknown": 5
+          }
+        },
+        "last_seen_at": "2026-08-28T18:46:10.645377Z",
+        "retirement_candidate": false,
+        "retirement_reason": "5 call(s) in review window"
+      },
+      {
+        "interface": {
+          "id": "2f77ac12-8c97-4974-a2f9-2996927982d1",
+          "interface_key": "rest_api:GET /sbom/report/licences/",
+          "interface_kind": "rest_api",
+          "legacy_since": "2026-08-22T17:06:41.978426Z",
+          "replacement_ref": "sbom-nexus:/sbom/",
+          "owner_component": "state-hub.sbom-compat",
+          "status": "legacy",
+          "replacement_verified": true,
+          "manual_hold": false,
+          "hold_reason": null,
+          "notes": null,
+          "retired_at": null,
+          "created_at": "2026-08-22T17:06:41.978426Z",
+          "updated_at": "2026-08-22T17:23:44.794796Z"
+        },
+        "all_time": {
+          "calls": 5,
+          "tenant_count": 1,
+          "user_count": 1,
+          "component_count": 1,
+          "tenants": {
+            "unknown": 5
+          },
+          "users": {
+            "unknown": 5
+          },
+          "components": {
+            "unknown": 5
+          }
+        },
+        "window": {
+          "calls": 5,
+          "tenant_count": 1,
+          "user_count": 1,
+          "component_count": 1,
+          "tenants": {
+            "unknown": 5
+          },
+          "users": {
+            "unknown": 5
+          },
+          "components": {
+            "unknown": 5
+          }
+        },
+        "last_seen_at": "2026-08-28T18:46:10.642164Z",
+        "retirement_candidate": false,
+        "retirement_reason": "5 call(s) in review window"
+      },
+      {
+        "interface": {
+          "id": "b627edf5-3302-4366-ba2e-547d32f634b5",
+          "interface_key": "rest_api:GET /sbom/snapshots/",
+          "interface_kind": "rest_api",
+          "legacy_since": "2026-08-22T17:06:37.057774Z",
+          "replacement_ref": "sbom-nexus:/sbom/",
+          "owner_component": "state-hub.sbom-compat",
+          "status": "legacy",
+          "replacement_verified": true,
+          "manual_hold": false,
+          "hold_reason": null,
+          "notes": null,
+          "retired_at": null,
+          "created_at": "2026-08-22T17:06:37.057774Z",
+          "updated_at": "2026-08-22T17:22:15.080213Z"
+        },
+        "all_time": {
+          "calls": 7,
+          "tenant_count": 1,
+          "user_count": 1,
+          "component_count": 1,
+          "tenants": {
+            "unknown": 7
+          },
+          "users": {
+            "unknown": 7
+          },
+          "components": {
+            "unknown": 7
+          }
+        },
+        "window": {
+          "calls": 7,
+          "tenant_count": 1,
+          "user_count": 1,
+          "component_count": 1,
+          "tenants": {
+            "unknown": 7
+          },
+          "users": {
+            "unknown": 7
+          },
+          "components": {
+            "unknown": 7
+          }
+        },
+        "last_seen_at": "2026-08-28T18:46:10.694185Z",
+        "retirement_candidate": false,
+        "retirement_reason": "7 call(s) in review window"
+      },
+      {
+        "interface": {
+          "id": "d03ee274-cd6f-4cd5-8f22-e4d298416299",
+          "interface_key": "rest_api:GET /sbom/snapshots/{snapshot_id}",
+          "interface_kind": "rest_api",
+          "legacy_since": "2026-08-22T17:23:45.969876Z",
+          "replacement_ref": "sbom-nexus:/sbom/",
+          "owner_component": "state-hub.sbom-compat",
+          "status": "legacy",
+          "replacement_verified": true,
+          "manual_hold": false,
+          "hold_reason": null,
+          "notes": null,
+          "retired_at": null,
+          "created_at": "2026-08-22T17:23:45.969876Z",
+          "updated_at": "2026-08-22T17:23:45.969876Z"
+        },
+        "all_time": {
+          "calls": 1,
+          "tenant_count": 1,
+          "user_count": 1,
+          "component_count": 1,
+          "tenants": {
+            "unknown": 1
+          },
+          "users": {
+            "unknown": 1
+          },
+          "components": {
+            "unknown": 1
+          }
+        },
+        "window": {
+          "calls": 1,
+          "tenant_count": 1,
+          "user_count": 1,
+          "component_count": 1,
+          "tenants": {
+            "unknown": 1
+          },
+          "users": {
+            "unknown": 1
+          },
+          "components": {
+            "unknown": 1
+          }
+        },
+        "last_seen_at": "2026-08-22T17:23:45.967492Z",
+        "retirement_candidate": false,
+        "retirement_reason": "1 call(s) in review window"
+      },
+      {
+        "interface": {
+          "id": "a6cb291e-8312-42f8-8a66-fde369482881",
+          "interface_key": "rest_api:GET /sbom/{repo_slug}",
+          "interface_kind": "rest_api",
+          "legacy_since": "2026-08-22T17:23:45.089542Z",
+          "replacement_ref": "sbom-nexus:/sbom/",
+          "owner_component": "state-hub.sbom-compat",
+          "status": "legacy",
+          "replacement_verified": true,
+          "manual_hold": false,
+          "hold_reason": null,
+          "notes": null,
+          "retired_at": null,
+          "created_at": "2026-08-22T17:23:45.089542Z",
+          "updated_at": "2026-08-22T17:23:45.089542Z"
+        },
+        "all_time": {
+          "calls": 1,
+          "tenant_count": 1,
+          "user_count": 1,
+          "component_count": 1,
+          "tenants": {
+            "unknown": 1
+          },
+          "users": {
+            "unknown": 1
+          },
+          "components": {
+            "unknown": 1
+          }
+        },
+        "window": {
+          "calls": 1,
+          "tenant_count": 1,
+          "user_count": 1,
+          "component_count": 1,
+          "tenants": {
+            "unknown": 1
+          },
+          "users": {
+            "unknown": 1
+          },
+          "components": {
+            "unknown": 1
+          }
+        },
+        "last_seen_at": "2026-08-22T17:23:45.670511Z",
+        "retirement_candidate": false,
+        "retirement_reason": "1 call(s) in review window"
+      },
+      {
+        "interface": {
+          "id": "cad13f19-ddb1-49b9-86d0-8789b7599f3a",
+          "interface_key": "rest_api:GET /tasks/?workstream_id",
+          "interface_kind": "rest_api",
+          "legacy_since": "2026-08-29T10:01:31.546213Z",
+          "replacement_ref": "/tasks/?workplan_id=<workplan_id>",
+          "owner_component": "state-hub.api",
+          "status": "legacy",
+          "replacement_verified": true,
+          "manual_hold": false,
+          "hold_reason": null,
+          "notes": null,
+          "retired_at": null,
+          "created_at": "2026-08-29T10:01:31.546213Z",
+          "updated_at": "2026-08-29T10:01:31.546213Z"
+        },
+        "all_time": {
+          "calls": 6,
+          "tenant_count": 1,
+          "user_count": 1,
+          "component_count": 1,
+          "tenants": {
+            "unknown": 6
+          },
+          "users": {
+            "unknown": 6
+          },
+          "components": {
+            "unknown": 6
+          }
+        },
+        "window": {
+          "calls": 6,
+          "tenant_count": 1,
+          "user_count": 1,
+          "component_count": 1,
+          "tenants": {
+            "unknown": 6
+          },
+          "users": {
+            "unknown": 6
+          },
+          "components": {
+            "unknown": 6
+          }
+        },
+        "last_seen_at": "2026-08-29T12:57:32.112670Z",
+        "retirement_candidate": false,
+        "retirement_reason": "6 call(s) in review window"
+      },
+      {
+        "interface": {
+          "id": "3e4a3d0b-08fa-45c3-91e2-4f514a914b97",
+          "interface_key": "rest_api:GET /workstreams/",
+          "interface_kind": "rest_api",
+          "legacy_since": "2026-06-04T00:26:14.533764Z",
+          "replacement_ref": "/workplans/",
+          "owner_component": "state-hub.api",
+          "status": "legacy",
+          "replacement_verified": true,
+          "manual_hold": false,
+          "hold_reason": null,
+          "notes": null,
+          "retired_at": null,
+          "created_at": "2026-06-04T00:26:14.533764Z",
+          "updated_at": "2026-06-04T00:26:14.533764Z"
+        },
+        "all_time": {
+          "calls": 830269,
+          "tenant_count": 1,
+          "user_count": 1,
+          "component_count": 1,
+          "tenants": {
+            "unknown": 830269
+          },
+          "users": {
+            "unknown": 830269
+          },
+          "components": {
+            "unknown": 830269
+          }
+        },
+        "window": {
+          "calls": 0,
+          "tenant_count": 0,
+          "user_count": 0,
+          "component_count": 0,
+          "tenants": {},
+          "users": {},
+          "components": {}
+        },
+        "last_seen_at": "2026-08-21T13:50:37.994459Z",
+        "retirement_candidate": false,
+        "retirement_reason": "quiet 8d of 60d required for 830269 all-time call(s)"
+      },
+      {
+        "interface": {
+          "id": "e4c140ec-7479-46f9-b185-4b533f19d639",
+          "interface_key": "rest_api:GET /workstreams/workplan-index",
+          "interface_kind": "rest_api",
+          "legacy_since": "2026-06-04T05:20:58.321869Z",
+          "replacement_ref": "/workplans/index",
+          "owner_component": "state-hub.api",
+          "status": "legacy",
+          "replacement_verified": true,
+          "manual_hold": false,
+          "hold_reason": null,
+          "notes": null,
+          "retired_at": null,
+          "created_at": "2026-06-04T05:20:58.321869Z",
+          "updated_at": "2026-06-04T05:20:58.321869Z"
+        },
+        "all_time": {
+          "calls": 39,
+          "tenant_count": 1,
+          "user_count": 1,
+          "component_count": 1,
+          "tenants": {
+            "unknown": 39
+          },
+          "users": {
+            "unknown": 39
+          },
+          "components": {
+            "unknown": 39
+          }
+        },
+        "window": {
+          "calls": 0,
+          "tenant_count": 0,
+          "user_count": 0,
+          "component_count": 0,
+          "tenants": {},
+          "users": {},
+          "components": {}
+        },
+        "last_seen_at": "2026-07-08T05:20:33.378203Z",
+        "retirement_candidate": true,
+        "retirement_reason": "no usage in review window; quiet 52d (>= 7d required for 39 all-time call(s))"
+      },
+      {
+        "interface": {
+          "id": "3a00b19e-e7db-4403-98aa-a77c9ab61ecc",
+          "interface_key": "rest_api:GET /workstreams/{workstream_id}",
+          "interface_kind": "rest_api",
+          "legacy_since": "2026-06-04T00:25:59.014966Z",
+          "replacement_ref": "/workplans/{workplan_id}",
+          "owner_component": "state-hub.api",
+          "status": "legacy",
+          "replacement_verified": true,
+          "manual_hold": false,
+          "hold_reason": null,
+          "notes": null,
+          "retired_at": null,
+          "created_at": "2026-06-04T00:25:59.014966Z",
+          "updated_at": "2026-06-04T00:25:59.014966Z"
+        },
+        "all_time": {
+          "calls": 3411470,
+          "tenant_count": 1,
+          "user_count": 1,
+          "component_count": 1,
+          "tenants": {
+            "unknown": 3411470
+          },
+          "users": {
+            "unknown": 3411470
+          },
+          "components": {
+            "unknown": 3411470
+          }
+        },
+        "window": {
+          "calls": 0,
+          "tenant_count": 0,
+          "user_count": 0,
+          "component_count": 0,
+          "tenants": {},
+          "users": {},
+          "components": {}
+        },
+        "last_seen_at": "2026-08-21T13:50:32.103349Z",
+        "retirement_candidate": false,
+        "retirement_reason": "quiet 8d of 60d required for 3411470 all-time call(s)"
+      },
+      {
+        "interface": {
+          "id": "69e1a255-a8b9-4101-8a68-b1bed23abfda",
+          "interface_key": "rest_api:GET /workstreams/{workstream_id}/dependencies/",
+          "interface_kind": "rest_api",
+          "legacy_since": "2026-06-04T00:25:59.291135Z",
+          "replacement_ref": "/workplans/{workplan_id}/dependencies/",
+          "owner_component": "state-hub.api",
+          "status": "legacy",
+          "replacement_verified": true,
+          "manual_hold": false,
+          "hold_reason": null,
+          "notes": null,
+          "retired_at": null,
+          "created_at": "2026-06-04T00:25:59.291135Z",
+          "updated_at": "2026-06-04T00:25:59.291135Z"
+        },
+        "all_time": {
+          "calls": 1643952,
+          "tenant_count": 1,
+          "user_count": 1,
+          "component_count": 1,
+          "tenants": {
+            "unknown": 1643952
+          },
+          "users": {
+            "unknown": 1643952
+          },
+          "components": {
+            "unknown": 1643952
+          }
+        },
+        "window": {
+          "calls": 0,
+          "tenant_count": 0,
+          "user_count": 0,
+          "component_count": 0,
+          "tenants": {},
+          "users": {},
+          "components": {}
+        },
+        "last_seen_at": "2026-08-21T13:50:30.082480Z",
+        "retirement_candidate": false,
+        "retirement_reason": "quiet 8d of 60d required for 1643952 all-time call(s)"
+      },
+      {
+        "interface": {
+          "id": "b1aae931-b51f-4a85-a723-865dd65f6132",
+          "interface_key": "rest_api:PATCH /workstreams/{workstream_id}",
+          "interface_kind": "rest_api",
+          "legacy_since": "2026-06-04T06:09:41.901035Z",
+          "replacement_ref": "/workplans/{workplan_id}",
+          "owner_component": "state-hub.api",
+          "status": "legacy",
+          "replacement_verified": true,
+          "manual_hold": false,
+          "hold_reason": null,
+          "notes": null,
+          "retired_at": null,
+          "created_at": "2026-06-04T06:09:41.901035Z",
+          "updated_at": "2026-06-04T06:09:41.901035Z"
+        },
+        "all_time": {
+          "calls": 584,
+          "tenant_count": 1,
+          "user_count": 1,
+          "component_count": 1,
+          "tenants": {
+            "unknown": 584
+          },
+          "users": {
+            "unknown": 584
+          },
+          "components": {
+            "unknown": 584
+          }
+        },
+        "window": {
+          "calls": 0,
+          "tenant_count": 0,
+          "user_count": 0,
+          "component_count": 0,
+          "tenants": {},
+          "users": {},
+          "components": {}
+        },
+        "last_seen_at": "2026-08-16T16:33:34.045078Z",
+        "retirement_candidate": false,
+        "retirement_reason": "quiet 12d of 30d required for 584 all-time call(s)"
+      },
+      {
+        "interface": {
+          "id": "ed6451c9-d2cc-4486-9afe-d3852782cabc",
+          "interface_key": "rest_api:POST /workstreams/",
+          "interface_kind": "rest_api",
+          "legacy_since": "2026-06-04T07:40:24.168535Z",
+          "replacement_ref": "/workplans/",
+          "owner_component": "state-hub.api",
+          "status": "legacy",
+          "replacement_verified": true,
+          "manual_hold": false,
+          "hold_reason": null,
+          "notes": null,
+          "retired_at": null,
+          "created_at": "2026-06-04T07:40:24.168535Z",
+          "updated_at": "2026-06-04T07:40:24.168535Z"
+        },
+        "all_time": {
+          "calls": 811,
+          "tenant_count": 1,
+          "user_count": 1,
+          "component_count": 1,
+          "tenants": {
+            "unknown": 811
+          },
+          "users": {
+            "unknown": 811
+          },
+          "components": {
+            "unknown": 811
+          }
+        },
+        "window": {
+          "calls": 0,
+          "tenant_count": 0,
+          "user_count": 0,
+          "component_count": 0,
+          "tenants": {},
+          "users": {},
+          "components": {}
+        },
+        "last_seen_at": "2026-08-16T01:03:41.093965Z",
+        "retirement_candidate": false,
+        "retirement_reason": "quiet 13d of 30d required for 811 all-time call(s)"
+      },
+      {
+        "interface": {
+          "id": "281fd706-b192-4194-8055-2d8733c115f9",
+          "interface_key": "rest_api:POST /workstreams/{workstream_id}/dependencies/",
+          "interface_kind": "rest_api",
+          "legacy_since": "2026-06-04T22:57:37.149207Z",
+          "replacement_ref": "/workplans/{workplan_id}/dependencies/",
+          "owner_component": "state-hub.api",
+          "status": "legacy",
+          "replacement_verified": true,
+          "manual_hold": false,
+          "hold_reason": null,
+          "notes": null,
+          "retired_at": null,
+          "created_at": "2026-06-04T22:57:37.149207Z",
+          "updated_at": "2026-06-04T22:57:37.149207Z"
+        },
+        "all_time": {
+          "calls": 4975,
+          "tenant_count": 1,
+          "user_count": 1,
+          "component_count": 1,
+          "tenants": {
+            "unknown": 4975
+          },
+          "users": {
+            "unknown": 4975
+          },
+          "components": {
+            "unknown": 4975
+          }
+        },
+        "window": {
+          "calls": 0,
+          "tenant_count": 0,
+          "user_count": 0,
+          "component_count": 0,
+          "tenants": {},
+          "users": {},
+          "components": {}
+        },
+        "last_seen_at": "2026-07-07T20:31:35.389791Z",
+        "retirement_candidate": true,
+        "retirement_reason": "no usage in review window; quiet 52d (>= 30d required for 4975 all-time call(s))"
+      }
+    ],
+    "retirement_candidates": [
+      {
+        "interface": {
+          "id": "8051fb40-66c9-4dc4-a413-13e8573e04a3",
+          "interface_key": "event_subject:org.statehub.workstream.completed",
+          "interface_kind": "event_subject",
+          "legacy_since": "2026-06-04T06:09:42.198193Z",
+          "replacement_ref": "org.statehub.workplan.completed",
+          "owner_component": "state-hub.events",
+          "status": "legacy",
+          "replacement_verified": true,
+          "manual_hold": false,
+          "hold_reason": null,
+          "notes": null,
+          "retired_at": null,
+          "created_at": "2026-06-04T06:09:42.198193Z",
+          "updated_at": "2026-06-04T06:09:42.198193Z"
+        },
+        "all_time": {
+          "calls": 247,
+          "tenant_count": 1,
+          "user_count": 1,
+          "component_count": 1,
+          "tenants": {
+            "unknown": 247
+          },
+          "users": {
+            "unknown": 247
+          },
+          "components": {
+            "state-hub.events": 247
+          }
+        },
+        "window": {
+          "calls": 0,
+          "tenant_count": 0,
+          "user_count": 0,
+          "component_count": 0,
+          "tenants": {},
+          "users": {},
+          "components": {}
+        },
+        "last_seen_at": "2026-07-13T13:22:00.748140Z",
+        "retirement_candidate": true,
+        "retirement_reason": "no usage in review window; quiet 47d (>= 30d required for 247 all-time call(s))"
+      },
+      {
+        "interface": {
+          "id": "cd9342fd-27e7-4a46-a1be-d41499e106a3",
+          "interface_key": "rest_api:DELETE /workstreams/{workstream_id}",
+          "interface_kind": "rest_api",
+          "legacy_since": "2026-06-06T17:28:13.052813Z",
+          "replacement_ref": "/workplans/{workplan_id}",
+          "owner_component": "state-hub.api",
+          "status": "legacy",
+          "replacement_verified": true,
+          "manual_hold": false,
+          "hold_reason": null,
+          "notes": null,
+          "retired_at": null,
+          "created_at": "2026-06-06T17:28:13.052813Z",
+          "updated_at": "2026-06-06T17:28:13.052813Z"
+        },
+        "all_time": {
+          "calls": 1,
+          "tenant_count": 1,
+          "user_count": 1,
+          "component_count": 1,
+          "tenants": {
+            "unknown": 1
+          },
+          "users": {
+            "unknown": 1
+          },
+          "components": {
+            "unknown": 1
+          }
+        },
+        "window": {
+          "calls": 0,
+          "tenant_count": 0,
+          "user_count": 0,
+          "component_count": 0,
+          "tenants": {},
+          "users": {},
+          "components": {}
+        },
+        "last_seen_at": "2026-06-06T17:28:13.047529Z",
+        "retirement_candidate": true,
+        "retirement_reason": "no usage in review window; quiet 83d (>= 7d required for 1 all-time call(s))"
+      },
+      {
+        "interface": {
+          "id": "e4c140ec-7479-46f9-b185-4b533f19d639",
+          "interface_key": "rest_api:GET /workstreams/workplan-index",
+          "interface_kind": "rest_api",
+          "legacy_since": "2026-06-04T05:20:58.321869Z",
+          "replacement_ref": "/workplans/index",
+          "owner_component": "state-hub.api",
+          "status": "legacy",
+          "replacement_verified": true,
+          "manual_hold": false,
+          "hold_reason": null,
+          "notes": null,
+          "retired_at": null,
+          "created_at": "2026-06-04T05:20:58.321869Z",
+          "updated_at": "2026-06-04T05:20:58.321869Z"
+        },
+        "all_time": {
+          "calls": 39,
+          "tenant_count": 1,
+          "user_count": 1,
+          "component_count": 1,
+          "tenants": {
+            "unknown": 39
+          },
+          "users": {
+            "unknown": 39
+          },
+          "components": {
+            "unknown": 39
+          }
+        },
+        "window": {
+          "calls": 0,
+          "tenant_count": 0,
+          "user_count": 0,
+          "component_count": 0,
+          "tenants": {},
+          "users": {},
+          "components": {}
+        },
+        "last_seen_at": "2026-07-08T05:20:33.378203Z",
+        "retirement_candidate": true,
+        "retirement_reason": "no usage in review window; quiet 52d (>= 7d required for 39 all-time call(s))"
+      },
+      {
+        "interface": {
+          "id": "281fd706-b192-4194-8055-2d8733c115f9",
+          "interface_key": "rest_api:POST /workstreams/{workstream_id}/dependencies/",
+          "interface_kind": "rest_api",
+          "legacy_since": "2026-06-04T22:57:37.149207Z",
+          "replacement_ref": "/workplans/{workplan_id}/dependencies/",
+          "owner_component": "state-hub.api",
+          "status": "legacy",
+          "replacement_verified": true,
+          "manual_hold": false,
+          "hold_reason": null,
+          "notes": null,
+          "retired_at": null,
+          "created_at": "2026-06-04T22:57:37.149207Z",
+          "updated_at": "2026-06-04T22:57:37.149207Z"
+        },
+        "all_time": {
+          "calls": 4975,
+          "tenant_count": 1,
+          "user_count": 1,
+          "component_count": 1,
+          "tenants": {
+            "unknown": 4975
+          },
+          "users": {
+            "unknown": 4975
+          },
+          "components": {
+            "unknown": 4975
+          }
+        },
+        "window": {
+          "calls": 0,
+          "tenant_count": 0,
+          "user_count": 0,
+          "component_count": 0,
+          "tenants": {},
+          "users": {},
+          "components": {}
+        },
+        "last_seen_at": "2026-07-07T20:31:35.389791Z",
+        "retirement_candidate": true,
+        "retirement_reason": "no usage in review window; quiet 52d (>= 30d required for 4975 all-time call(s))"
+      }
+    ]
+  },
+  "days": 7
+}
diff --git a/docs/evidence/legacy-meter-weekly-review-20260831.json b/docs/evidence/legacy-meter-weekly-review-20260831.json
new file mode 100644
index 0000000..1b8f37c
--- /dev/null
+++ b/docs/evidence/legacy-meter-weekly-review-20260831.json
@@ -0,0 +1,819 @@
+{
+  "captured_at": "2026-08-31T08:55:08.691404+00:00",
+  "api_base": "http://127.0.0.1:8000",
+  "workplan": "STATE-WP-0070",
+  "retired_interfaces": [
+    {
+      "id": "8051fb40-66c9-4dc4-a413-13e8573e04a3",
+      "interface_key": "event_subject:org.statehub.workstream.completed",
+      "interface_kind": "event_subject",
+      "legacy_since": "2026-06-04T06:09:42.198193Z",
+      "replacement_ref": "org.statehub.workplan.completed",
+      "owner_component": "state-hub.events",
+      "status": "retired",
+      "replacement_verified": true,
+      "manual_hold": false,
+      "hold_reason": null,
+      "notes": "Retired by STATE-WP-0069 closeout",
+      "retired_at": "2026-08-31T08:55:06.871333Z",
+      "created_at": "2026-06-04T06:09:42.198193Z",
+      "updated_at": "2026-08-31T08:55:06.756087Z"
+    },
+    {
+      "id": "cd9342fd-27e7-4a46-a1be-d41499e106a3",
+      "interface_key": "rest_api:DELETE /workstreams/{workstream_id}",
+      "interface_kind": "rest_api",
+      "legacy_since": "2026-06-06T17:28:13.052813Z",
+      "replacement_ref": "/workplans/{workplan_id}",
+      "owner_component": "state-hub.api",
+      "status": "retired",
+      "replacement_verified": true,
+      "manual_hold": false,
+      "hold_reason": null,
+      "notes": "Retired by STATE-WP-0069 closeout",
+      "retired_at": "2026-08-31T08:55:08.200322Z",
+      "created_at": "2026-06-06T17:28:13.052813Z",
+      "updated_at": "2026-08-31T08:55:08.089714Z"
+    },
+    {
+      "id": "d03ee274-cd6f-4cd5-8f22-e4d298416299",
+      "interface_key": "rest_api:GET /sbom/snapshots/{snapshot_id}",
+      "interface_kind": "rest_api",
+      "legacy_since": "2026-08-22T17:23:45.969876Z",
+      "replacement_ref": "sbom-nexus:/sbom/",
+      "owner_component": "state-hub.sbom-compat",
+      "status": "retired",
+      "replacement_verified": true,
+      "manual_hold": false,
+      "hold_reason": null,
+      "notes": "Retired by STATE-WP-0069 closeout",
+      "retired_at": "2026-08-31T08:55:08.470106Z",
+      "created_at": "2026-08-22T17:23:45.969876Z",
+      "updated_at": "2026-08-31T08:55:08.456139Z"
+    },
+    {
+      "id": "a6cb291e-8312-42f8-8a66-fde369482881",
+      "interface_key": "rest_api:GET /sbom/{repo_slug}",
+      "interface_kind": "rest_api",
+      "legacy_since": "2026-08-22T17:23:45.089542Z",
+      "replacement_ref": "sbom-nexus:/sbom/",
+      "owner_component": "state-hub.sbom-compat",
+      "status": "retired",
+      "replacement_verified": true,
+      "manual_hold": false,
+      "hold_reason": null,
+      "notes": "Retired by STATE-WP-0069 closeout",
+      "retired_at": "2026-08-31T08:55:08.754914Z",
+      "created_at": "2026-08-22T17:23:45.089542Z",
+      "updated_at": "2026-08-31T08:55:08.750826Z"
+    },
+    {
+      "id": "e4c140ec-7479-46f9-b185-4b533f19d639",
+      "interface_key": "rest_api:GET /workstreams/workplan-index",
+      "interface_kind": "rest_api",
+      "legacy_since": "2026-06-04T05:20:58.321869Z",
+      "replacement_ref": "/workplans/index",
+      "owner_component": "state-hub.api",
+      "status": "retired",
+      "replacement_verified": true,
+      "manual_hold": false,
+      "hold_reason": null,
+      "notes": "Retired by STATE-WP-0069 closeout",
+      "retired_at": "2026-08-31T08:55:08.939572Z",
+      "created_at": "2026-06-04T05:20:58.321869Z",
+      "updated_at": "2026-08-31T08:55:08.933482Z"
+    },
+    {
+      "id": "281fd706-b192-4194-8055-2d8733c115f9",
+      "interface_key": "rest_api:POST /workstreams/{workstream_id}/dependencies/",
+      "interface_kind": "rest_api",
+      "legacy_since": "2026-06-04T22:57:37.149207Z",
+      "replacement_ref": "/workplans/{workplan_id}/dependencies/",
+      "owner_component": "state-hub.api",
+      "status": "retired",
+      "replacement_verified": true,
+      "manual_hold": false,
+      "hold_reason": null,
+      "notes": "Retired by STATE-WP-0069 closeout",
+      "retired_at": "2026-08-31T08:55:09.130713Z",
+      "created_at": "2026-06-04T22:57:37.149207Z",
+      "updated_at": "2026-08-31T08:55:09.123888Z"
+    }
+  ],
+  "weekly_review": {
+    "generated_at": "2026-08-31T08:55:09.323212Z",
+    "window_start": "2026-08-24T08:55:09.243515Z",
+    "window_end": "2026-08-31T08:55:09.243515Z",
+    "cadence": "weekly",
+    "activity_core_handoff": {
+      "activity_id": "statehub-legacy-interface-review",
+      "cadence": "weekly",
+      "source_endpoint": "/legacy-meter/weekly-review",
+      "state_owner": "state-hub",
+      "scheduler_owner": "activity-core"
+    },
+    "interfaces": [
+      {
+        "interface": {
+          "id": "8051fb40-66c9-4dc4-a413-13e8573e04a3",
+          "interface_key": "event_subject:org.statehub.workstream.completed",
+          "interface_kind": "event_subject",
+          "legacy_since": "2026-06-04T06:09:42.198193Z",
+          "replacement_ref": "org.statehub.workplan.completed",
+          "owner_component": "state-hub.events",
+          "status": "retired",
+          "replacement_verified": true,
+          "manual_hold": false,
+          "hold_reason": null,
+          "notes": "Retired by STATE-WP-0069 closeout",
+          "retired_at": "2026-08-31T08:55:06.871333Z",
+          "created_at": "2026-06-04T06:09:42.198193Z",
+          "updated_at": "2026-08-31T08:55:06.756087Z"
+        },
+        "all_time": {
+          "calls": 247,
+          "tenant_count": 1,
+          "user_count": 1,
+          "component_count": 1,
+          "tenants": {
+            "unknown": 247
+          },
+          "users": {
+            "unknown": 247
+          },
+          "components": {
+            "state-hub.events": 247
+          }
+        },
+        "window": {
+          "calls": 0,
+          "tenant_count": 0,
+          "user_count": 0,
+          "component_count": 0,
+          "tenants": {},
+          "users": {},
+          "components": {}
+        },
+        "last_seen_at": "2026-07-13T13:22:00.748140Z",
+        "retirement_candidate": false,
+        "retirement_reason": "already retired"
+      },
+      {
+        "interface": {
+          "id": "cd9342fd-27e7-4a46-a1be-d41499e106a3",
+          "interface_key": "rest_api:DELETE /workstreams/{workstream_id}",
+          "interface_kind": "rest_api",
+          "legacy_since": "2026-06-06T17:28:13.052813Z",
+          "replacement_ref": "/workplans/{workplan_id}",
+          "owner_component": "state-hub.api",
+          "status": "retired",
+          "replacement_verified": true,
+          "manual_hold": false,
+          "hold_reason": null,
+          "notes": "Retired by STATE-WP-0069 closeout",
+          "retired_at": "2026-08-31T08:55:08.200322Z",
+          "created_at": "2026-06-06T17:28:13.052813Z",
+          "updated_at": "2026-08-31T08:55:08.089714Z"
+        },
+        "all_time": {
+          "calls": 1,
+          "tenant_count": 1,
+          "user_count": 1,
+          "component_count": 1,
+          "tenants": {
+            "unknown": 1
+          },
+          "users": {
+            "unknown": 1
+          },
+          "components": {
+            "unknown": 1
+          }
+        },
+        "window": {
+          "calls": 0,
+          "tenant_count": 0,
+          "user_count": 0,
+          "component_count": 0,
+          "tenants": {},
+          "users": {},
+          "components": {}
+        },
+        "last_seen_at": "2026-06-06T17:28:13.047529Z",
+        "retirement_candidate": false,
+        "retirement_reason": "already retired"
+      },
+      {
+        "interface": {
+          "id": "d0294dce-7913-4268-94c3-1b2502aefb0f",
+          "interface_key": "rest_api:GET /sbom/",
+          "interface_kind": "rest_api",
+          "legacy_since": "2026-08-22T17:06:38.703608Z",
+          "replacement_ref": "sbom-nexus:/sbom/",
+          "owner_component": "state-hub.sbom-compat",
+          "status": "legacy",
+          "replacement_verified": true,
+          "manual_hold": false,
+          "hold_reason": null,
+          "notes": null,
+          "retired_at": null,
+          "created_at": "2026-08-22T17:06:38.703608Z",
+          "updated_at": "2026-08-22T17:23:43.730661Z"
+        },
+        "all_time": {
+          "calls": 6,
+          "tenant_count": 1,
+          "user_count": 1,
+          "component_count": 1,
+          "tenants": {
+            "unknown": 6
+          },
+          "users": {
+            "unknown": 6
+          },
+          "components": {
+            "unknown": 6
+          }
+        },
+        "window": {
+          "calls": 2,
+          "tenant_count": 1,
+          "user_count": 1,
+          "component_count": 1,
+          "tenants": {
+            "unknown": 2
+          },
+          "users": {
+            "unknown": 2
+          },
+          "components": {
+            "unknown": 2
+          }
+        },
+        "last_seen_at": "2026-08-31T08:18:41.571768Z",
+        "retirement_candidate": false,
+        "retirement_reason": "2 call(s) in review window"
+      },
+      {
+        "interface": {
+          "id": "2f77ac12-8c97-4974-a2f9-2996927982d1",
+          "interface_key": "rest_api:GET /sbom/report/licences/",
+          "interface_kind": "rest_api",
+          "legacy_since": "2026-08-22T17:06:41.978426Z",
+          "replacement_ref": "sbom-nexus:/sbom/",
+          "owner_component": "state-hub.sbom-compat",
+          "status": "legacy",
+          "replacement_verified": true,
+          "manual_hold": false,
+          "hold_reason": null,
+          "notes": null,
+          "retired_at": null,
+          "created_at": "2026-08-22T17:06:41.978426Z",
+          "updated_at": "2026-08-22T17:23:44.794796Z"
+        },
+        "all_time": {
+          "calls": 5,
+          "tenant_count": 1,
+          "user_count": 1,
+          "component_count": 1,
+          "tenants": {
+            "unknown": 5
+          },
+          "users": {
+            "unknown": 5
+          },
+          "components": {
+            "unknown": 5
+          }
+        },
+        "window": {
+          "calls": 1,
+          "tenant_count": 1,
+          "user_count": 1,
+          "component_count": 1,
+          "tenants": {
+            "unknown": 1
+          },
+          "users": {
+            "unknown": 1
+          },
+          "components": {
+            "unknown": 1
+          }
+        },
+        "last_seen_at": "2026-08-28T18:46:10.642164Z",
+        "retirement_candidate": false,
+        "retirement_reason": "1 call(s) in review window"
+      },
+      {
+        "interface": {
+          "id": "b627edf5-3302-4366-ba2e-547d32f634b5",
+          "interface_key": "rest_api:GET /sbom/snapshots/",
+          "interface_kind": "rest_api",
+          "legacy_since": "2026-08-22T17:06:37.057774Z",
+          "replacement_ref": "sbom-nexus:/sbom/",
+          "owner_component": "state-hub.sbom-compat",
+          "status": "legacy",
+          "replacement_verified": true,
+          "manual_hold": false,
+          "hold_reason": null,
+          "notes": null,
+          "retired_at": null,
+          "created_at": "2026-08-22T17:06:37.057774Z",
+          "updated_at": "2026-08-22T17:22:15.080213Z"
+        },
+        "all_time": {
+          "calls": 7,
+          "tenant_count": 1,
+          "user_count": 1,
+          "component_count": 1,
+          "tenants": {
+            "unknown": 7
+          },
+          "users": {
+            "unknown": 7
+          },
+          "components": {
+            "unknown": 7
+          }
+        },
+        "window": {
+          "calls": 2,
+          "tenant_count": 1,
+          "user_count": 1,
+          "component_count": 1,
+          "tenants": {
+            "unknown": 2
+          },
+          "users": {
+            "unknown": 2
+          },
+          "components": {
+            "unknown": 2
+          }
+        },
+        "last_seen_at": "2026-08-28T18:46:10.694185Z",
+        "retirement_candidate": false,
+        "retirement_reason": "2 call(s) in review window"
+      },
+      {
+        "interface": {
+          "id": "d03ee274-cd6f-4cd5-8f22-e4d298416299",
+          "interface_key": "rest_api:GET /sbom/snapshots/{snapshot_id}",
+          "interface_kind": "rest_api",
+          "legacy_since": "2026-08-22T17:23:45.969876Z",
+          "replacement_ref": "sbom-nexus:/sbom/",
+          "owner_component": "state-hub.sbom-compat",
+          "status": "retired",
+          "replacement_verified": true,
+          "manual_hold": false,
+          "hold_reason": null,
+          "notes": "Retired by STATE-WP-0069 closeout",
+          "retired_at": "2026-08-31T08:55:08.470106Z",
+          "created_at": "2026-08-22T17:23:45.969876Z",
+          "updated_at": "2026-08-31T08:55:08.456139Z"
+        },
+        "all_time": {
+          "calls": 1,
+          "tenant_count": 1,
+          "user_count": 1,
+          "component_count": 1,
+          "tenants": {
+            "unknown": 1
+          },
+          "users": {
+            "unknown": 1
+          },
+          "components": {
+            "unknown": 1
+          }
+        },
+        "window": {
+          "calls": 0,
+          "tenant_count": 0,
+          "user_count": 0,
+          "component_count": 0,
+          "tenants": {},
+          "users": {},
+          "components": {}
+        },
+        "last_seen_at": "2026-08-22T17:23:45.967492Z",
+        "retirement_candidate": false,
+        "retirement_reason": "already retired"
+      },
+      {
+        "interface": {
+          "id": "a6cb291e-8312-42f8-8a66-fde369482881",
+          "interface_key": "rest_api:GET /sbom/{repo_slug}",
+          "interface_kind": "rest_api",
+          "legacy_since": "2026-08-22T17:23:45.089542Z",
+          "replacement_ref": "sbom-nexus:/sbom/",
+          "owner_component": "state-hub.sbom-compat",
+          "status": "retired",
+          "replacement_verified": true,
+          "manual_hold": false,
+          "hold_reason": null,
+          "notes": "Retired by STATE-WP-0069 closeout",
+          "retired_at": "2026-08-31T08:55:08.754914Z",
+          "created_at": "2026-08-22T17:23:45.089542Z",
+          "updated_at": "2026-08-31T08:55:08.750826Z"
+        },
+        "all_time": {
+          "calls": 1,
+          "tenant_count": 1,
+          "user_count": 1,
+          "component_count": 1,
+          "tenants": {
+            "unknown": 1
+          },
+          "users": {
+            "unknown": 1
+          },
+          "components": {
+            "unknown": 1
+          }
+        },
+        "window": {
+          "calls": 0,
+          "tenant_count": 0,
+          "user_count": 0,
+          "component_count": 0,
+          "tenants": {},
+          "users": {},
+          "components": {}
+        },
+        "last_seen_at": "2026-08-22T17:23:45.670511Z",
+        "retirement_candidate": false,
+        "retirement_reason": "already retired"
+      },
+      {
+        "interface": {
+          "id": "cad13f19-ddb1-49b9-86d0-8789b7599f3a",
+          "interface_key": "rest_api:GET /tasks/?workstream_id",
+          "interface_kind": "rest_api",
+          "legacy_since": "2026-08-29T10:01:31.546213Z",
+          "replacement_ref": "/tasks/?workplan_id=<workplan_id>",
+          "owner_component": "state-hub.api",
+          "status": "legacy",
+          "replacement_verified": true,
+          "manual_hold": false,
+          "hold_reason": null,
+          "notes": null,
+          "retired_at": null,
+          "created_at": "2026-08-29T10:01:31.546213Z",
+          "updated_at": "2026-08-29T10:01:31.546213Z"
+        },
+        "all_time": {
+          "calls": 6,
+          "tenant_count": 1,
+          "user_count": 1,
+          "component_count": 1,
+          "tenants": {
+            "unknown": 6
+          },
+          "users": {
+            "unknown": 6
+          },
+          "components": {
+            "unknown": 6
+          }
+        },
+        "window": {
+          "calls": 6,
+          "tenant_count": 1,
+          "user_count": 1,
+          "component_count": 1,
+          "tenants": {
+            "unknown": 6
+          },
+          "users": {
+            "unknown": 6
+          },
+          "components": {
+            "unknown": 6
+          }
+        },
+        "last_seen_at": "2026-08-29T12:57:32.112670Z",
+        "retirement_candidate": false,
+        "retirement_reason": "6 call(s) in review window"
+      },
+      {
+        "interface": {
+          "id": "3e4a3d0b-08fa-45c3-91e2-4f514a914b97",
+          "interface_key": "rest_api:GET /workstreams/",
+          "interface_kind": "rest_api",
+          "legacy_since": "2026-06-04T00:26:14.533764Z",
+          "replacement_ref": "/workplans/",
+          "owner_component": "state-hub.api",
+          "status": "legacy",
+          "replacement_verified": true,
+          "manual_hold": false,
+          "hold_reason": null,
+          "notes": null,
+          "retired_at": null,
+          "created_at": "2026-06-04T00:26:14.533764Z",
+          "updated_at": "2026-06-04T00:26:14.533764Z"
+        },
+        "all_time": {
+          "calls": 830269,
+          "tenant_count": 1,
+          "user_count": 1,
+          "component_count": 1,
+          "tenants": {
+            "unknown": 830269
+          },
+          "users": {
+            "unknown": 830269
+          },
+          "components": {
+            "unknown": 830269
+          }
+        },
+        "window": {
+          "calls": 0,
+          "tenant_count": 0,
+          "user_count": 0,
+          "component_count": 0,
+          "tenants": {},
+          "users": {},
+          "components": {}
+        },
+        "last_seen_at": "2026-08-21T13:50:37.994459Z",
+        "retirement_candidate": false,
+        "retirement_reason": "quiet 9d of 60d required for 830269 all-time call(s)"
+      },
+      {
+        "interface": {
+          "id": "e4c140ec-7479-46f9-b185-4b533f19d639",
+          "interface_key": "rest_api:GET /workstreams/workplan-index",
+          "interface_kind": "rest_api",
+          "legacy_since": "2026-06-04T05:20:58.321869Z",
+          "replacement_ref": "/workplans/index",
+          "owner_component": "state-hub.api",
+          "status": "retired",
+          "replacement_verified": true,
+          "manual_hold": false,
+          "hold_reason": null,
+          "notes": "Retired by STATE-WP-0069 closeout",
+          "retired_at": "2026-08-31T08:55:08.939572Z",
+          "created_at": "2026-06-04T05:20:58.321869Z",
+          "updated_at": "2026-08-31T08:55:08.933482Z"
+        },
+        "all_time": {
+          "calls": 39,
+          "tenant_count": 1,
+          "user_count": 1,
+          "component_count": 1,
+          "tenants": {
+            "unknown": 39
+          },
+          "users": {
+            "unknown": 39
+          },
+          "components": {
+            "unknown": 39
+          }
+        },
+        "window": {
+          "calls": 0,
+          "tenant_count": 0,
+          "user_count": 0,
+          "component_count": 0,
+          "tenants": {},
+          "users": {},
+          "components": {}
+        },
+        "last_seen_at": "2026-07-08T05:20:33.378203Z",
+        "retirement_candidate": false,
+        "retirement_reason": "already retired"
+      },
+      {
+        "interface": {
+          "id": "3a00b19e-e7db-4403-98aa-a77c9ab61ecc",
+          "interface_key": "rest_api:GET /workstreams/{workstream_id}",
+          "interface_kind": "rest_api",
+          "legacy_since": "2026-06-04T00:25:59.014966Z",
+          "replacement_ref": "/workplans/{workplan_id}",
+          "owner_component": "state-hub.api",
+          "status": "legacy",
+          "replacement_verified": true,
+          "manual_hold": false,
+          "hold_reason": null,
+          "notes": null,
+          "retired_at": null,
+          "created_at": "2026-06-04T00:25:59.014966Z",
+          "updated_at": "2026-06-04T00:25:59.014966Z"
+        },
+        "all_time": {
+          "calls": 3411470,
+          "tenant_count": 1,
+          "user_count": 1,
+          "component_count": 1,
+          "tenants": {
+            "unknown": 3411470
+          },
+          "users": {
+            "unknown": 3411470
+          },
+          "components": {
+            "unknown": 3411470
+          }
+        },
+        "window": {
+          "calls": 0,
+          "tenant_count": 0,
+          "user_count": 0,
+          "component_count": 0,
+          "tenants": {},
+          "users": {},
+          "components": {}
+        },
+        "last_seen_at": "2026-08-21T13:50:32.103349Z",
+        "retirement_candidate": false,
+        "retirement_reason": "quiet 9d of 60d required for 3411470 all-time call(s)"
+      },
+      {
+        "interface": {
+          "id": "69e1a255-a8b9-4101-8a68-b1bed23abfda",
+          "interface_key": "rest_api:GET /workstreams/{workstream_id}/dependencies/",
+          "interface_kind": "rest_api",
+          "legacy_since": "2026-06-04T00:25:59.291135Z",
+          "replacement_ref": "/workplans/{workplan_id}/dependencies/",
+          "owner_component": "state-hub.api",
+          "status": "legacy",
+          "replacement_verified": true,
+          "manual_hold": false,
+          "hold_reason": null,
+          "notes": null,
+          "retired_at": null,
+          "created_at": "2026-06-04T00:25:59.291135Z",
+          "updated_at": "2026-06-04T00:25:59.291135Z"
+        },
+        "all_time": {
+          "calls": 1643952,
+          "tenant_count": 1,
+          "user_count": 1,
+          "component_count": 1,
+          "tenants": {
+            "unknown": 1643952
+          },
+          "users": {
+            "unknown": 1643952
+          },
+          "components": {
+            "unknown": 1643952
+          }
+        },
+        "window": {
+          "calls": 0,
+          "tenant_count": 0,
+          "user_count": 0,
+          "component_count": 0,
+          "tenants": {},
+          "users": {},
+          "components": {}
+        },
+        "last_seen_at": "2026-08-21T13:50:30.082480Z",
+        "retirement_candidate": false,
+        "retirement_reason": "quiet 9d of 60d required for 1643952 all-time call(s)"
+      },
+      {
+        "interface": {
+          "id": "b1aae931-b51f-4a85-a723-865dd65f6132",
+          "interface_key": "rest_api:PATCH /workstreams/{workstream_id}",
+          "interface_kind": "rest_api",
+          "legacy_since": "2026-06-04T06:09:41.901035Z",
+          "replacement_ref": "/workplans/{workplan_id}",
+          "owner_component": "state-hub.api",
+          "status": "legacy",
+          "replacement_verified": true,
+          "manual_hold": false,
+          "hold_reason": null,
+          "notes": null,
+          "retired_at": null,
+          "created_at": "2026-06-04T06:09:41.901035Z",
+          "updated_at": "2026-06-04T06:09:41.901035Z"
+        },
+        "all_time": {
+          "calls": 584,
+          "tenant_count": 1,
+          "user_count": 1,
+          "component_count": 1,
+          "tenants": {
+            "unknown": 584
+          },
+          "users": {
+            "unknown": 584
+          },
+          "components": {
+            "unknown": 584
+          }
+        },
+        "window": {
+          "calls": 0,
+          "tenant_count": 0,
+          "user_count": 0,
+          "component_count": 0,
+          "tenants": {},
+          "users": {},
+          "components": {}
+        },
+        "last_seen_at": "2026-08-16T16:33:34.045078Z",
+        "retirement_candidate": false,
+        "retirement_reason": "quiet 14d of 30d required for 584 all-time call(s)"
+      },
+      {
+        "interface": {
+          "id": "ed6451c9-d2cc-4486-9afe-d3852782cabc",
+          "interface_key": "rest_api:POST /workstreams/",
+          "interface_kind": "rest_api",
+          "legacy_since": "2026-06-04T07:40:24.168535Z",
+          "replacement_ref": "/workplans/",
+          "owner_component": "state-hub.api",
+          "status": "legacy",
+          "replacement_verified": true,
+          "manual_hold": false,
+          "hold_reason": null,
+          "notes": null,
+          "retired_at": null,
+          "created_at": "2026-06-04T07:40:24.168535Z",
+          "updated_at": "2026-06-04T07:40:24.168535Z"
+        },
+        "all_time": {
+          "calls": 811,
+          "tenant_count": 1,
+          "user_count": 1,
+          "component_count": 1,
+          "tenants": {
+            "unknown": 811
+          },
+          "users": {
+            "unknown": 811
+          },
+          "components": {
+            "unknown": 811
+          }
+        },
+        "window": {
+          "calls": 0,
+          "tenant_count": 0,
+          "user_count": 0,
+          "component_count": 0,
+          "tenants": {},
+          "users": {},
+          "components": {}
+        },
+        "last_seen_at": "2026-08-16T01:03:41.093965Z",
+        "retirement_candidate": false,
+        "retirement_reason": "quiet 15d of 30d required for 811 all-time call(s)"
+      },
+      {
+        "interface": {
+          "id": "281fd706-b192-4194-8055-2d8733c115f9",
+          "interface_key": "rest_api:POST /workstreams/{workstream_id}/dependencies/",
+          "interface_kind": "rest_api",
+          "legacy_since": "2026-06-04T22:57:37.149207Z",
+          "replacement_ref": "/workplans/{workplan_id}/dependencies/",
+          "owner_component": "state-hub.api",
+          "status": "retired",
+          "replacement_verified": true,
+          "manual_hold": false,
+          "hold_reason": null,
+          "notes": "Retired by STATE-WP-0069 closeout",
+          "retired_at": "2026-08-31T08:55:09.130713Z",
+          "created_at": "2026-06-04T22:57:37.149207Z",
+          "updated_at": "2026-08-31T08:55:09.123888Z"
+        },
+        "all_time": {
+          "calls": 4975,
+          "tenant_count": 1,
+          "user_count": 1,
+          "component_count": 1,
+          "tenants": {
+            "unknown": 4975
+          },
+          "users": {
+            "unknown": 4975
+          },
+          "components": {
+            "unknown": 4975
+          }
+        },
+        "window": {
+          "calls": 0,
+          "tenant_count": 0,
+          "user_count": 0,
+          "component_count": 0,
+          "tenants": {},
+          "users": {},
+          "components": {}
+        },
+        "last_seen_at": "2026-07-07T20:31:35.389791Z",
+        "retirement_candidate": false,
+        "retirement_reason": "already retired"
+      }
+    ],
+    "retirement_candidates": []
+  },
+  "days": 7
+}
diff --git a/docs/evidence/legacy-meter-weekly-review-20260901.json b/docs/evidence/legacy-meter-weekly-review-20260901.json
new file mode 100644
index 0000000..b6c2451
--- /dev/null
+++ b/docs/evidence/legacy-meter-weekly-review-20260901.json
@@ -0,0 +1,722 @@
+{
+  "captured_at": "2026-09-01T06:00:07.767985+00:00",
+  "api_base": "http://127.0.0.1:8000",
+  "workplan": "STATE-WP-0070",
+  "retired_interfaces": [],
+  "weekly_review": {
+    "generated_at": "2026-09-01T06:00:08.728877Z",
+    "window_start": "2026-08-25T06:00:08.596463Z",
+    "window_end": "2026-09-01T06:00:08.596463Z",
+    "cadence": "weekly",
+    "activity_core_handoff": {
+      "activity_id": "statehub-legacy-interface-review",
+      "cadence": "weekly",
+      "source_endpoint": "/legacy-meter/weekly-review",
+      "state_owner": "state-hub",
+      "scheduler_owner": "activity-core"
+    },
+    "interfaces": [
+      {
+        "interface": {
+          "id": "8051fb40-66c9-4dc4-a413-13e8573e04a3",
+          "interface_key": "event_subject:org.statehub.workstream.completed",
+          "interface_kind": "event_subject",
+          "legacy_since": "2026-06-04T06:09:42.198193Z",
+          "replacement_ref": "org.statehub.workplan.completed",
+          "owner_component": "state-hub.events",
+          "status": "retired",
+          "replacement_verified": true,
+          "manual_hold": false,
+          "hold_reason": null,
+          "notes": "Retired by STATE-WP-0069 closeout",
+          "retired_at": "2026-08-31T08:55:06.871333Z",
+          "created_at": "2026-06-04T06:09:42.198193Z",
+          "updated_at": "2026-08-31T08:55:06.756087Z"
+        },
+        "all_time": {
+          "calls": 247,
+          "tenant_count": 1,
+          "user_count": 1,
+          "component_count": 1,
+          "tenants": {
+            "unknown": 247
+          },
+          "users": {
+            "unknown": 247
+          },
+          "components": {
+            "state-hub.events": 247
+          }
+        },
+        "window": {
+          "calls": 0,
+          "tenant_count": 0,
+          "user_count": 0,
+          "component_count": 0,
+          "tenants": {},
+          "users": {},
+          "components": {}
+        },
+        "last_seen_at": "2026-07-13T13:22:00.748140Z",
+        "retirement_candidate": false,
+        "retirement_reason": "already retired"
+      },
+      {
+        "interface": {
+          "id": "cd9342fd-27e7-4a46-a1be-d41499e106a3",
+          "interface_key": "rest_api:DELETE /workstreams/{workstream_id}",
+          "interface_kind": "rest_api",
+          "legacy_since": "2026-06-06T17:28:13.052813Z",
+          "replacement_ref": "/workplans/{workplan_id}",
+          "owner_component": "state-hub.api",
+          "status": "retired",
+          "replacement_verified": true,
+          "manual_hold": false,
+          "hold_reason": null,
+          "notes": "Retired by STATE-WP-0069 closeout",
+          "retired_at": "2026-08-31T08:55:08.200322Z",
+          "created_at": "2026-06-06T17:28:13.052813Z",
+          "updated_at": "2026-08-31T08:55:08.089714Z"
+        },
+        "all_time": {
+          "calls": 1,
+          "tenant_count": 1,
+          "user_count": 1,
+          "component_count": 1,
+          "tenants": {
+            "unknown": 1
+          },
+          "users": {
+            "unknown": 1
+          },
+          "components": {
+            "unknown": 1
+          }
+        },
+        "window": {
+          "calls": 0,
+          "tenant_count": 0,
+          "user_count": 0,
+          "component_count": 0,
+          "tenants": {},
+          "users": {},
+          "components": {}
+        },
+        "last_seen_at": "2026-06-06T17:28:13.047529Z",
+        "retirement_candidate": false,
+        "retirement_reason": "already retired"
+      },
+      {
+        "interface": {
+          "id": "d0294dce-7913-4268-94c3-1b2502aefb0f",
+          "interface_key": "rest_api:GET /sbom/",
+          "interface_kind": "rest_api",
+          "legacy_since": "2026-08-22T17:06:38.703608Z",
+          "replacement_ref": "sbom-nexus:/sbom/",
+          "owner_component": "state-hub.sbom-compat",
+          "status": "legacy",
+          "replacement_verified": true,
+          "manual_hold": false,
+          "hold_reason": null,
+          "notes": null,
+          "retired_at": null,
+          "created_at": "2026-08-22T17:06:38.703608Z",
+          "updated_at": "2026-08-22T17:23:43.730661Z"
+        },
+        "all_time": {
+          "calls": 6,
+          "tenant_count": 1,
+          "user_count": 1,
+          "component_count": 1,
+          "tenants": {
+            "unknown": 6
+          },
+          "users": {
+            "unknown": 6
+          },
+          "components": {
+            "unknown": 6
+          }
+        },
+        "window": {
+          "calls": 2,
+          "tenant_count": 1,
+          "user_count": 1,
+          "component_count": 1,
+          "tenants": {
+            "unknown": 2
+          },
+          "users": {
+            "unknown": 2
+          },
+          "components": {
+            "unknown": 2
+          }
+        },
+        "last_seen_at": "2026-08-31T08:18:41.571768Z",
+        "retirement_candidate": false,
+        "retirement_reason": "2 call(s) in review window"
+      },
+      {
+        "interface": {
+          "id": "2f77ac12-8c97-4974-a2f9-2996927982d1",
+          "interface_key": "rest_api:GET /sbom/report/licences/",
+          "interface_kind": "rest_api",
+          "legacy_since": "2026-08-22T17:06:41.978426Z",
+          "replacement_ref": "sbom-nexus:/sbom/",
+          "owner_component": "state-hub.sbom-compat",
+          "status": "legacy",
+          "replacement_verified": true,
+          "manual_hold": false,
+          "hold_reason": null,
+          "notes": null,
+          "retired_at": null,
+          "created_at": "2026-08-22T17:06:41.978426Z",
+          "updated_at": "2026-08-22T17:23:44.794796Z"
+        },
+        "all_time": {
+          "calls": 5,
+          "tenant_count": 1,
+          "user_count": 1,
+          "component_count": 1,
+          "tenants": {
+            "unknown": 5
+          },
+          "users": {
+            "unknown": 5
+          },
+          "components": {
+            "unknown": 5
+          }
+        },
+        "window": {
+          "calls": 1,
+          "tenant_count": 1,
+          "user_count": 1,
+          "component_count": 1,
+          "tenants": {
+            "unknown": 1
+          },
+          "users": {
+            "unknown": 1
+          },
+          "components": {
+            "unknown": 1
+          }
+        },
+        "last_seen_at": "2026-08-28T18:46:10.642164Z",
+        "retirement_candidate": false,
+        "retirement_reason": "1 call(s) in review window"
+      },
+      {
+        "interface": {
+          "id": "b627edf5-3302-4366-ba2e-547d32f634b5",
+          "interface_key": "rest_api:GET /sbom/snapshots/",
+          "interface_kind": "rest_api",
+          "legacy_since": "2026-08-22T17:06:37.057774Z",
+          "replacement_ref": "sbom-nexus:/sbom/",
+          "owner_component": "state-hub.sbom-compat",
+          "status": "legacy",
+          "replacement_verified": true,
+          "manual_hold": false,
+          "hold_reason": null,
+          "notes": null,
+          "retired_at": null,
+          "created_at": "2026-08-22T17:06:37.057774Z",
+          "updated_at": "2026-08-22T17:22:15.080213Z"
+        },
+        "all_time": {
+          "calls": 7,
+          "tenant_count": 1,
+          "user_count": 1,
+          "component_count": 1,
+          "tenants": {
+            "unknown": 7
+          },
+          "users": {
+            "unknown": 7
+          },
+          "components": {
+            "unknown": 7
+          }
+        },
+        "window": {
+          "calls": 2,
+          "tenant_count": 1,
+          "user_count": 1,
+          "component_count": 1,
+          "tenants": {
+            "unknown": 2
+          },
+          "users": {
+            "unknown": 2
+          },
+          "components": {
+            "unknown": 2
+          }
+        },
+        "last_seen_at": "2026-08-28T18:46:10.694185Z",
+        "retirement_candidate": false,
+        "retirement_reason": "2 call(s) in review window"
+      },
+      {
+        "interface": {
+          "id": "d03ee274-cd6f-4cd5-8f22-e4d298416299",
+          "interface_key": "rest_api:GET /sbom/snapshots/{snapshot_id}",
+          "interface_kind": "rest_api",
+          "legacy_since": "2026-08-22T17:23:45.969876Z",
+          "replacement_ref": "sbom-nexus:/sbom/",
+          "owner_component": "state-hub.sbom-compat",
+          "status": "retired",
+          "replacement_verified": true,
+          "manual_hold": false,
+          "hold_reason": null,
+          "notes": "Retired by STATE-WP-0069 closeout",
+          "retired_at": "2026-08-31T08:55:08.470106Z",
+          "created_at": "2026-08-22T17:23:45.969876Z",
+          "updated_at": "2026-08-31T08:55:08.456139Z"
+        },
+        "all_time": {
+          "calls": 1,
+          "tenant_count": 1,
+          "user_count": 1,
+          "component_count": 1,
+          "tenants": {
+            "unknown": 1
+          },
+          "users": {
+            "unknown": 1
+          },
+          "components": {
+            "unknown": 1
+          }
+        },
+        "window": {
+          "calls": 0,
+          "tenant_count": 0,
+          "user_count": 0,
+          "component_count": 0,
+          "tenants": {},
+          "users": {},
+          "components": {}
+        },
+        "last_seen_at": "2026-08-22T17:23:45.967492Z",
+        "retirement_candidate": false,
+        "retirement_reason": "already retired"
+      },
+      {
+        "interface": {
+          "id": "a6cb291e-8312-42f8-8a66-fde369482881",
+          "interface_key": "rest_api:GET /sbom/{repo_slug}",
+          "interface_kind": "rest_api",
+          "legacy_since": "2026-08-22T17:23:45.089542Z",
+          "replacement_ref": "sbom-nexus:/sbom/",
+          "owner_component": "state-hub.sbom-compat",
+          "status": "retired",
+          "replacement_verified": true,
+          "manual_hold": false,
+          "hold_reason": null,
+          "notes": "Retired by STATE-WP-0069 closeout",
+          "retired_at": "2026-08-31T08:55:08.754914Z",
+          "created_at": "2026-08-22T17:23:45.089542Z",
+          "updated_at": "2026-08-31T08:55:08.750826Z"
+        },
+        "all_time": {
+          "calls": 1,
+          "tenant_count": 1,
+          "user_count": 1,
+          "component_count": 1,
+          "tenants": {
+            "unknown": 1
+          },
+          "users": {
+            "unknown": 1
+          },
+          "components": {
+            "unknown": 1
+          }
+        },
+        "window": {
+          "calls": 0,
+          "tenant_count": 0,
+          "user_count": 0,
+          "component_count": 0,
+          "tenants": {},
+          "users": {},
+          "components": {}
+        },
+        "last_seen_at": "2026-08-22T17:23:45.670511Z",
+        "retirement_candidate": false,
+        "retirement_reason": "already retired"
+      },
+      {
+        "interface": {
+          "id": "cad13f19-ddb1-49b9-86d0-8789b7599f3a",
+          "interface_key": "rest_api:GET /tasks/?workstream_id",
+          "interface_kind": "rest_api",
+          "legacy_since": "2026-08-29T10:01:31.546213Z",
+          "replacement_ref": "/tasks/?workplan_id=<workplan_id>",
+          "owner_component": "state-hub.api",
+          "status": "legacy",
+          "replacement_verified": true,
+          "manual_hold": false,
+          "hold_reason": null,
+          "notes": null,
+          "retired_at": null,
+          "created_at": "2026-08-29T10:01:31.546213Z",
+          "updated_at": "2026-08-29T10:01:31.546213Z"
+        },
+        "all_time": {
+          "calls": 7,
+          "tenant_count": 1,
+          "user_count": 1,
+          "component_count": 1,
+          "tenants": {
+            "unknown": 7
+          },
+          "users": {
+            "unknown": 7
+          },
+          "components": {
+            "unknown": 7
+          }
+        },
+        "window": {
+          "calls": 7,
+          "tenant_count": 1,
+          "user_count": 1,
+          "component_count": 1,
+          "tenants": {
+            "unknown": 7
+          },
+          "users": {
+            "unknown": 7
+          },
+          "components": {
+            "unknown": 7
+          }
+        },
+        "last_seen_at": "2026-08-31T22:03:49.543354Z",
+        "retirement_candidate": false,
+        "retirement_reason": "7 call(s) in review window"
+      },
+      {
+        "interface": {
+          "id": "3e4a3d0b-08fa-45c3-91e2-4f514a914b97",
+          "interface_key": "rest_api:GET /workstreams/",
+          "interface_kind": "rest_api",
+          "legacy_since": "2026-06-04T00:26:14.533764Z",
+          "replacement_ref": "/workplans/",
+          "owner_component": "state-hub.api",
+          "status": "legacy",
+          "replacement_verified": true,
+          "manual_hold": false,
+          "hold_reason": null,
+          "notes": null,
+          "retired_at": null,
+          "created_at": "2026-06-04T00:26:14.533764Z",
+          "updated_at": "2026-06-04T00:26:14.533764Z"
+        },
+        "all_time": {
+          "calls": 830269,
+          "tenant_count": 1,
+          "user_count": 1,
+          "component_count": 1,
+          "tenants": {
+            "unknown": 830269
+          },
+          "users": {
+            "unknown": 830269
+          },
+          "components": {
+            "unknown": 830269
+          }
+        },
+        "window": {
+          "calls": 0,
+          "tenant_count": 0,
+          "user_count": 0,
+          "component_count": 0,
+          "tenants": {},
+          "users": {},
+          "components": {}
+        },
+        "last_seen_at": "2026-08-21T13:50:37.994459Z",
+        "retirement_candidate": false,
+        "retirement_reason": "quiet 10d of 60d required for 830269 all-time call(s)"
+      },
+      {
+        "interface": {
+          "id": "e4c140ec-7479-46f9-b185-4b533f19d639",
+          "interface_key": "rest_api:GET /workstreams/workplan-index",
+          "interface_kind": "rest_api",
+          "legacy_since": "2026-06-04T05:20:58.321869Z",
+          "replacement_ref": "/workplans/index",
+          "owner_component": "state-hub.api",
+          "status": "retired",
+          "replacement_verified": true,
+          "manual_hold": false,
+          "hold_reason": null,
+          "notes": "Retired by STATE-WP-0069 closeout",
+          "retired_at": "2026-08-31T08:55:08.939572Z",
+          "created_at": "2026-06-04T05:20:58.321869Z",
+          "updated_at": "2026-08-31T08:55:08.933482Z"
+        },
+        "all_time": {
+          "calls": 39,
+          "tenant_count": 1,
+          "user_count": 1,
+          "component_count": 1,
+          "tenants": {
+            "unknown": 39
+          },
+          "users": {
+            "unknown": 39
+          },
+          "components": {
+            "unknown": 39
+          }
+        },
+        "window": {
+          "calls": 0,
+          "tenant_count": 0,
+          "user_count": 0,
+          "component_count": 0,
+          "tenants": {},
+          "users": {},
+          "components": {}
+        },
+        "last_seen_at": "2026-07-08T05:20:33.378203Z",
+        "retirement_candidate": false,
+        "retirement_reason": "already retired"
+      },
+      {
+        "interface": {
+          "id": "3a00b19e-e7db-4403-98aa-a77c9ab61ecc",
+          "interface_key": "rest_api:GET /workstreams/{workstream_id}",
+          "interface_kind": "rest_api",
+          "legacy_since": "2026-06-04T00:25:59.014966Z",
+          "replacement_ref": "/workplans/{workplan_id}",
+          "owner_component": "state-hub.api",
+          "status": "legacy",
+          "replacement_verified": true,
+          "manual_hold": false,
+          "hold_reason": null,
+          "notes": null,
+          "retired_at": null,
+          "created_at": "2026-06-04T00:25:59.014966Z",
+          "updated_at": "2026-06-04T00:25:59.014966Z"
+        },
+        "all_time": {
+          "calls": 3411470,
+          "tenant_count": 1,
+          "user_count": 1,
+          "component_count": 1,
+          "tenants": {
+            "unknown": 3411470
+          },
+          "users": {
+            "unknown": 3411470
+          },
+          "components": {
+            "unknown": 3411470
+          }
+        },
+        "window": {
+          "calls": 0,
+          "tenant_count": 0,
+          "user_count": 0,
+          "component_count": 0,
+          "tenants": {},
+          "users": {},
+          "components": {}
+        },
+        "last_seen_at": "2026-08-21T13:50:32.103349Z",
+        "retirement_candidate": false,
+        "retirement_reason": "quiet 10d of 60d required for 3411470 all-time call(s)"
+      },
+      {
+        "interface": {
+          "id": "69e1a255-a8b9-4101-8a68-b1bed23abfda",
+          "interface_key": "rest_api:GET /workstreams/{workstream_id}/dependencies/",
+          "interface_kind": "rest_api",
+          "legacy_since": "2026-06-04T00:25:59.291135Z",
+          "replacement_ref": "/workplans/{workplan_id}/dependencies/",
+          "owner_component": "state-hub.api",
+          "status": "legacy",
+          "replacement_verified": true,
+          "manual_hold": false,
+          "hold_reason": null,
+          "notes": null,
+          "retired_at": null,
+          "created_at": "2026-06-04T00:25:59.291135Z",
+          "updated_at": "2026-06-04T00:25:59.291135Z"
+        },
+        "all_time": {
+          "calls": 1643952,
+          "tenant_count": 1,
+          "user_count": 1,
+          "component_count": 1,
+          "tenants": {
+            "unknown": 1643952
+          },
+          "users": {
+            "unknown": 1643952
+          },
+          "components": {
+            "unknown": 1643952
+          }
+        },
+        "window": {
+          "calls": 0,
+          "tenant_count": 0,
+          "user_count": 0,
+          "component_count": 0,
+          "tenants": {},
+          "users": {},
+          "components": {}
+        },
+        "last_seen_at": "2026-08-21T13:50:30.082480Z",
+        "retirement_candidate": false,
+        "retirement_reason": "quiet 10d of 60d required for 1643952 all-time call(s)"
+      },
+      {
+        "interface": {
+          "id": "b1aae931-b51f-4a85-a723-865dd65f6132",
+          "interface_key": "rest_api:PATCH /workstreams/{workstream_id}",
+          "interface_kind": "rest_api",
+          "legacy_since": "2026-06-04T06:09:41.901035Z",
+          "replacement_ref": "/workplans/{workplan_id}",
+          "owner_component": "state-hub.api",
+          "status": "legacy",
+          "replacement_verified": true,
+          "manual_hold": false,
+          "hold_reason": null,
+          "notes": null,
+          "retired_at": null,
+          "created_at": "2026-06-04T06:09:41.901035Z",
+          "updated_at": "2026-06-04T06:09:41.901035Z"
+        },
+        "all_time": {
+          "calls": 584,
+          "tenant_count": 1,
+          "user_count": 1,
+          "component_count": 1,
+          "tenants": {
+            "unknown": 584
+          },
+          "users": {
+            "unknown": 584
+          },
+          "components": {
+            "unknown": 584
+          }
+        },
+        "window": {
+          "calls": 0,
+          "tenant_count": 0,
+          "user_count": 0,
+          "component_count": 0,
+          "tenants": {},
+          "users": {},
+          "components": {}
+        },
+        "last_seen_at": "2026-08-16T16:33:34.045078Z",
+        "retirement_candidate": false,
+        "retirement_reason": "quiet 15d of 30d required for 584 all-time call(s)"
+      },
+      {
+        "interface": {
+          "id": "ed6451c9-d2cc-4486-9afe-d3852782cabc",
+          "interface_key": "rest_api:POST /workstreams/",
+          "interface_kind": "rest_api",
+          "legacy_since": "2026-06-04T07:40:24.168535Z",
+          "replacement_ref": "/workplans/",
+          "owner_component": "state-hub.api",
+          "status": "legacy",
+          "replacement_verified": true,
+          "manual_hold": false,
+          "hold_reason": null,
+          "notes": null,
+          "retired_at": null,
+          "created_at": "2026-06-04T07:40:24.168535Z",
+          "updated_at": "2026-06-04T07:40:24.168535Z"
+        },
+        "all_time": {
+          "calls": 811,
+          "tenant_count": 1,
+          "user_count": 1,
+          "component_count": 1,
+          "tenants": {
+            "unknown": 811
+          },
+          "users": {
+            "unknown": 811
+          },
+          "components": {
+            "unknown": 811
+          }
+        },
+        "window": {
+          "calls": 0,
+          "tenant_count": 0,
+          "user_count": 0,
+          "component_count": 0,
+          "tenants": {},
+          "users": {},
+          "components": {}
+        },
+        "last_seen_at": "2026-08-16T01:03:41.093965Z",
+        "retirement_candidate": false,
+        "retirement_reason": "quiet 16d of 30d required for 811 all-time call(s)"
+      },
+      {
+        "interface": {
+          "id": "281fd706-b192-4194-8055-2d8733c115f9",
+          "interface_key": "rest_api:POST /workstreams/{workstream_id}/dependencies/",
+          "interface_kind": "rest_api",
+          "legacy_since": "2026-06-04T22:57:37.149207Z",
+          "replacement_ref": "/workplans/{workplan_id}/dependencies/",
+          "owner_component": "state-hub.api",
+          "status": "retired",
+          "replacement_verified": true,
+          "manual_hold": false,
+          "hold_reason": null,
+          "notes": "Retired by STATE-WP-0069 closeout",
+          "retired_at": "2026-08-31T08:55:09.130713Z",
+          "created_at": "2026-06-04T22:57:37.149207Z",
+          "updated_at": "2026-08-31T08:55:09.123888Z"
+        },
+        "all_time": {
+          "calls": 4975,
+          "tenant_count": 1,
+          "user_count": 1,
+          "component_count": 1,
+          "tenants": {
+            "unknown": 4975
+          },
+          "users": {
+            "unknown": 4975
+          },
+          "components": {
+            "unknown": 4975
+          }
+        },
+        "window": {
+          "calls": 0,
+          "tenant_count": 0,
+          "user_count": 0,
+          "component_count": 0,
+          "tenants": {},
+          "users": {},
+          "components": {}
+        },
+        "last_seen_at": "2026-07-07T20:31:35.389791Z",
+        "retirement_candidate": false,
+        "retirement_reason": "already retired"
+      }
+    ],
+    "retirement_candidates": []
+  },
+  "days": 7
+}
diff --git a/docs/evidence/legacy-meter-weekly-review-20260902.json b/docs/evidence/legacy-meter-weekly-review-20260902.json
new file mode 100644
index 0000000..16449f8
--- /dev/null
+++ b/docs/evidence/legacy-meter-weekly-review-20260902.json
@@ -0,0 +1,734 @@
+{
+  "captured_at": "2026-09-02T14:00:08.045192+00:00",
+  "api_base": "http://127.0.0.1:8000",
+  "workplan": "STATE-WP-0070",
+  "retired_interfaces": [],
+  "weekly_review": {
+    "generated_at": "2026-09-02T14:00:09.170309Z",
+    "window_start": "2026-08-26T14:00:08.717330Z",
+    "window_end": "2026-09-02T14:00:08.717330Z",
+    "cadence": "weekly",
+    "activity_core_handoff": {
+      "activity_id": "statehub-legacy-interface-review",
+      "cadence": "weekly",
+      "source_endpoint": "/legacy-meter/weekly-review",
+      "state_owner": "state-hub",
+      "scheduler_owner": "activity-core"
+    },
+    "interfaces": [
+      {
+        "interface": {
+          "id": "8051fb40-66c9-4dc4-a413-13e8573e04a3",
+          "interface_key": "event_subject:org.statehub.workstream.completed",
+          "interface_kind": "event_subject",
+          "legacy_since": "2026-06-04T06:09:42.198193Z",
+          "replacement_ref": "org.statehub.workplan.completed",
+          "owner_component": "state-hub.events",
+          "status": "retired",
+          "replacement_verified": true,
+          "manual_hold": false,
+          "hold_reason": null,
+          "notes": "Retired by STATE-WP-0069 closeout",
+          "retired_at": "2026-08-31T08:55:06.871333Z",
+          "created_at": "2026-06-04T06:09:42.198193Z",
+          "updated_at": "2026-08-31T08:55:06.756087Z"
+        },
+        "all_time": {
+          "calls": 247,
+          "tenant_count": 1,
+          "user_count": 1,
+          "component_count": 1,
+          "tenants": {
+            "unknown": 247
+          },
+          "users": {
+            "unknown": 247
+          },
+          "components": {
+            "state-hub.events": 247
+          }
+        },
+        "window": {
+          "calls": 0,
+          "tenant_count": 0,
+          "user_count": 0,
+          "component_count": 0,
+          "tenants": {},
+          "users": {},
+          "components": {}
+        },
+        "last_seen_at": "2026-07-13T13:22:00.748140Z",
+        "retirement_candidate": false,
+        "retirement_reason": "already retired"
+      },
+      {
+        "interface": {
+          "id": "cd9342fd-27e7-4a46-a1be-d41499e106a3",
+          "interface_key": "rest_api:DELETE /workstreams/{workstream_id}",
+          "interface_kind": "rest_api",
+          "legacy_since": "2026-06-06T17:28:13.052813Z",
+          "replacement_ref": "/workplans/{workplan_id}",
+          "owner_component": "state-hub.api",
+          "status": "retired",
+          "replacement_verified": true,
+          "manual_hold": false,
+          "hold_reason": null,
+          "notes": "Retired by STATE-WP-0069 closeout",
+          "retired_at": "2026-08-31T08:55:08.200322Z",
+          "created_at": "2026-06-06T17:28:13.052813Z",
+          "updated_at": "2026-08-31T08:55:08.089714Z"
+        },
+        "all_time": {
+          "calls": 1,
+          "tenant_count": 1,
+          "user_count": 1,
+          "component_count": 1,
+          "tenants": {
+            "unknown": 1
+          },
+          "users": {
+            "unknown": 1
+          },
+          "components": {
+            "unknown": 1
+          }
+        },
+        "window": {
+          "calls": 0,
+          "tenant_count": 0,
+          "user_count": 0,
+          "component_count": 0,
+          "tenants": {},
+          "users": {},
+          "components": {}
+        },
+        "last_seen_at": "2026-06-06T17:28:13.047529Z",
+        "retirement_candidate": false,
+        "retirement_reason": "already retired"
+      },
+      {
+        "interface": {
+          "id": "d0294dce-7913-4268-94c3-1b2502aefb0f",
+          "interface_key": "rest_api:GET /sbom/",
+          "interface_kind": "rest_api",
+          "legacy_since": "2026-08-22T17:06:38.703608Z",
+          "replacement_ref": "sbom-nexus:/sbom/",
+          "owner_component": "state-hub.sbom-compat",
+          "status": "legacy",
+          "replacement_verified": true,
+          "manual_hold": false,
+          "hold_reason": null,
+          "notes": null,
+          "retired_at": null,
+          "created_at": "2026-08-22T17:06:38.703608Z",
+          "updated_at": "2026-08-22T17:23:43.730661Z"
+        },
+        "all_time": {
+          "calls": 6,
+          "tenant_count": 1,
+          "user_count": 1,
+          "component_count": 1,
+          "tenants": {
+            "unknown": 6
+          },
+          "users": {
+            "unknown": 6
+          },
+          "components": {
+            "unknown": 6
+          }
+        },
+        "window": {
+          "calls": 2,
+          "tenant_count": 1,
+          "user_count": 1,
+          "component_count": 1,
+          "tenants": {
+            "unknown": 2
+          },
+          "users": {
+            "unknown": 2
+          },
+          "components": {
+            "unknown": 2
+          }
+        },
+        "last_seen_at": "2026-08-31T08:18:41.571768Z",
+        "retirement_candidate": false,
+        "retirement_reason": "2 call(s) in review window"
+      },
+      {
+        "interface": {
+          "id": "2f77ac12-8c97-4974-a2f9-2996927982d1",
+          "interface_key": "rest_api:GET /sbom/report/licences/",
+          "interface_kind": "rest_api",
+          "legacy_since": "2026-08-22T17:06:41.978426Z",
+          "replacement_ref": "sbom-nexus:/sbom/",
+          "owner_component": "state-hub.sbom-compat",
+          "status": "legacy",
+          "replacement_verified": true,
+          "manual_hold": false,
+          "hold_reason": null,
+          "notes": null,
+          "retired_at": null,
+          "created_at": "2026-08-22T17:06:41.978426Z",
+          "updated_at": "2026-08-22T17:23:44.794796Z"
+        },
+        "all_time": {
+          "calls": 5,
+          "tenant_count": 1,
+          "user_count": 1,
+          "component_count": 1,
+          "tenants": {
+            "unknown": 5
+          },
+          "users": {
+            "unknown": 5
+          },
+          "components": {
+            "unknown": 5
+          }
+        },
+        "window": {
+          "calls": 1,
+          "tenant_count": 1,
+          "user_count": 1,
+          "component_count": 1,
+          "tenants": {
+            "unknown": 1
+          },
+          "users": {
+            "unknown": 1
+          },
+          "components": {
+            "unknown": 1
+          }
+        },
+        "last_seen_at": "2026-08-28T18:46:10.642164Z",
+        "retirement_candidate": false,
+        "retirement_reason": "1 call(s) in review window"
+      },
+      {
+        "interface": {
+          "id": "b627edf5-3302-4366-ba2e-547d32f634b5",
+          "interface_key": "rest_api:GET /sbom/snapshots/",
+          "interface_kind": "rest_api",
+          "legacy_since": "2026-08-22T17:06:37.057774Z",
+          "replacement_ref": "sbom-nexus:/sbom/",
+          "owner_component": "state-hub.sbom-compat",
+          "status": "legacy",
+          "replacement_verified": true,
+          "manual_hold": false,
+          "hold_reason": null,
+          "notes": null,
+          "retired_at": null,
+          "created_at": "2026-08-22T17:06:37.057774Z",
+          "updated_at": "2026-08-22T17:22:15.080213Z"
+        },
+        "all_time": {
+          "calls": 7,
+          "tenant_count": 1,
+          "user_count": 1,
+          "component_count": 1,
+          "tenants": {
+            "unknown": 7
+          },
+          "users": {
+            "unknown": 7
+          },
+          "components": {
+            "unknown": 7
+          }
+        },
+        "window": {
+          "calls": 2,
+          "tenant_count": 1,
+          "user_count": 1,
+          "component_count": 1,
+          "tenants": {
+            "unknown": 2
+          },
+          "users": {
+            "unknown": 2
+          },
+          "components": {
+            "unknown": 2
+          }
+        },
+        "last_seen_at": "2026-08-28T18:46:10.694185Z",
+        "retirement_candidate": false,
+        "retirement_reason": "2 call(s) in review window"
+      },
+      {
+        "interface": {
+          "id": "d03ee274-cd6f-4cd5-8f22-e4d298416299",
+          "interface_key": "rest_api:GET /sbom/snapshots/{snapshot_id}",
+          "interface_kind": "rest_api",
+          "legacy_since": "2026-08-22T17:23:45.969876Z",
+          "replacement_ref": "sbom-nexus:/sbom/",
+          "owner_component": "state-hub.sbom-compat",
+          "status": "retired",
+          "replacement_verified": true,
+          "manual_hold": false,
+          "hold_reason": null,
+          "notes": "Retired by STATE-WP-0069 closeout",
+          "retired_at": "2026-08-31T08:55:08.470106Z",
+          "created_at": "2026-08-22T17:23:45.969876Z",
+          "updated_at": "2026-08-31T08:55:08.456139Z"
+        },
+        "all_time": {
+          "calls": 1,
+          "tenant_count": 1,
+          "user_count": 1,
+          "component_count": 1,
+          "tenants": {
+            "unknown": 1
+          },
+          "users": {
+            "unknown": 1
+          },
+          "components": {
+            "unknown": 1
+          }
+        },
+        "window": {
+          "calls": 0,
+          "tenant_count": 0,
+          "user_count": 0,
+          "component_count": 0,
+          "tenants": {},
+          "users": {},
+          "components": {}
+        },
+        "last_seen_at": "2026-08-22T17:23:45.967492Z",
+        "retirement_candidate": false,
+        "retirement_reason": "already retired"
+      },
+      {
+        "interface": {
+          "id": "a6cb291e-8312-42f8-8a66-fde369482881",
+          "interface_key": "rest_api:GET /sbom/{repo_slug}",
+          "interface_kind": "rest_api",
+          "legacy_since": "2026-08-22T17:23:45.089542Z",
+          "replacement_ref": "sbom-nexus:/sbom/",
+          "owner_component": "state-hub.sbom-compat",
+          "status": "retired",
+          "replacement_verified": true,
+          "manual_hold": false,
+          "hold_reason": null,
+          "notes": "Retired by STATE-WP-0069 closeout",
+          "retired_at": "2026-08-31T08:55:08.754914Z",
+          "created_at": "2026-08-22T17:23:45.089542Z",
+          "updated_at": "2026-08-31T08:55:08.750826Z"
+        },
+        "all_time": {
+          "calls": 1,
+          "tenant_count": 1,
+          "user_count": 1,
+          "component_count": 1,
+          "tenants": {
+            "unknown": 1
+          },
+          "users": {
+            "unknown": 1
+          },
+          "components": {
+            "unknown": 1
+          }
+        },
+        "window": {
+          "calls": 0,
+          "tenant_count": 0,
+          "user_count": 0,
+          "component_count": 0,
+          "tenants": {},
+          "users": {},
+          "components": {}
+        },
+        "last_seen_at": "2026-08-22T17:23:45.670511Z",
+        "retirement_candidate": false,
+        "retirement_reason": "already retired"
+      },
+      {
+        "interface": {
+          "id": "cad13f19-ddb1-49b9-86d0-8789b7599f3a",
+          "interface_key": "rest_api:GET /tasks/?workstream_id",
+          "interface_kind": "rest_api",
+          "legacy_since": "2026-08-29T10:01:31.546213Z",
+          "replacement_ref": "/tasks/?workplan_id=<workplan_id>",
+          "owner_component": "state-hub.api",
+          "status": "legacy",
+          "replacement_verified": true,
+          "manual_hold": false,
+          "hold_reason": null,
+          "notes": null,
+          "retired_at": null,
+          "created_at": "2026-08-29T10:01:31.546213Z",
+          "updated_at": "2026-08-29T10:01:31.546213Z"
+        },
+        "all_time": {
+          "calls": 10,
+          "tenant_count": 1,
+          "user_count": 1,
+          "component_count": 1,
+          "tenants": {
+            "unknown": 10
+          },
+          "users": {
+            "unknown": 10
+          },
+          "components": {
+            "unknown": 10
+          }
+        },
+        "window": {
+          "calls": 10,
+          "tenant_count": 1,
+          "user_count": 1,
+          "component_count": 1,
+          "tenants": {
+            "unknown": 10
+          },
+          "users": {
+            "unknown": 10
+          },
+          "components": {
+            "unknown": 10
+          }
+        },
+        "last_seen_at": "2026-09-01T22:58:15.354257Z",
+        "retirement_candidate": false,
+        "retirement_reason": "10 call(s) in review window"
+      },
+      {
+        "interface": {
+          "id": "3e4a3d0b-08fa-45c3-91e2-4f514a914b97",
+          "interface_key": "rest_api:GET /workstreams/",
+          "interface_kind": "rest_api",
+          "legacy_since": "2026-06-04T00:26:14.533764Z",
+          "replacement_ref": "/workplans/",
+          "owner_component": "state-hub.api",
+          "status": "legacy",
+          "replacement_verified": true,
+          "manual_hold": false,
+          "hold_reason": null,
+          "notes": null,
+          "retired_at": null,
+          "created_at": "2026-06-04T00:26:14.533764Z",
+          "updated_at": "2026-06-04T00:26:14.533764Z"
+        },
+        "all_time": {
+          "calls": 830269,
+          "tenant_count": 1,
+          "user_count": 1,
+          "component_count": 1,
+          "tenants": {
+            "unknown": 830269
+          },
+          "users": {
+            "unknown": 830269
+          },
+          "components": {
+            "unknown": 830269
+          }
+        },
+        "window": {
+          "calls": 0,
+          "tenant_count": 0,
+          "user_count": 0,
+          "component_count": 0,
+          "tenants": {},
+          "users": {},
+          "components": {}
+        },
+        "last_seen_at": "2026-08-21T13:50:37.994459Z",
+        "retirement_candidate": false,
+        "retirement_reason": "quiet 12d of 60d required for 830269 all-time call(s)"
+      },
+      {
+        "interface": {
+          "id": "e4c140ec-7479-46f9-b185-4b533f19d639",
+          "interface_key": "rest_api:GET /workstreams/workplan-index",
+          "interface_kind": "rest_api",
+          "legacy_since": "2026-06-04T05:20:58.321869Z",
+          "replacement_ref": "/workplans/index",
+          "owner_component": "state-hub.api",
+          "status": "retired",
+          "replacement_verified": true,
+          "manual_hold": false,
+          "hold_reason": null,
+          "notes": "Retired by STATE-WP-0069 closeout",
+          "retired_at": "2026-08-31T08:55:08.939572Z",
+          "created_at": "2026-06-04T05:20:58.321869Z",
+          "updated_at": "2026-08-31T08:55:08.933482Z"
+        },
+        "all_time": {
+          "calls": 40,
+          "tenant_count": 1,
+          "user_count": 1,
+          "component_count": 1,
+          "tenants": {
+            "unknown": 40
+          },
+          "users": {
+            "unknown": 40
+          },
+          "components": {
+            "unknown": 40
+          }
+        },
+        "window": {
+          "calls": 1,
+          "tenant_count": 1,
+          "user_count": 1,
+          "component_count": 1,
+          "tenants": {
+            "unknown": 1
+          },
+          "users": {
+            "unknown": 1
+          },
+          "components": {
+            "unknown": 1
+          }
+        },
+        "last_seen_at": "2026-09-01T18:42:55.879795Z",
+        "retirement_candidate": false,
+        "retirement_reason": "already retired"
+      },
+      {
+        "interface": {
+          "id": "3a00b19e-e7db-4403-98aa-a77c9ab61ecc",
+          "interface_key": "rest_api:GET /workstreams/{workstream_id}",
+          "interface_kind": "rest_api",
+          "legacy_since": "2026-06-04T00:25:59.014966Z",
+          "replacement_ref": "/workplans/{workplan_id}",
+          "owner_component": "state-hub.api",
+          "status": "legacy",
+          "replacement_verified": true,
+          "manual_hold": false,
+          "hold_reason": null,
+          "notes": null,
+          "retired_at": null,
+          "created_at": "2026-06-04T00:25:59.014966Z",
+          "updated_at": "2026-06-04T00:25:59.014966Z"
+        },
+        "all_time": {
+          "calls": 3411471,
+          "tenant_count": 1,
+          "user_count": 1,
+          "component_count": 1,
+          "tenants": {
+            "unknown": 3411471
+          },
+          "users": {
+            "unknown": 3411471
+          },
+          "components": {
+            "unknown": 3411471
+          }
+        },
+        "window": {
+          "calls": 1,
+          "tenant_count": 1,
+          "user_count": 1,
+          "component_count": 1,
+          "tenants": {
+            "unknown": 1
+          },
+          "users": {
+            "unknown": 1
+          },
+          "components": {
+            "unknown": 1
+          }
+        },
+        "last_seen_at": "2026-09-01T18:43:07.476120Z",
+        "retirement_candidate": false,
+        "retirement_reason": "1 call(s) in review window"
+      },
+      {
+        "interface": {
+          "id": "69e1a255-a8b9-4101-8a68-b1bed23abfda",
+          "interface_key": "rest_api:GET /workstreams/{workstream_id}/dependencies/",
+          "interface_kind": "rest_api",
+          "legacy_since": "2026-06-04T00:25:59.291135Z",
+          "replacement_ref": "/workplans/{workplan_id}/dependencies/",
+          "owner_component": "state-hub.api",
+          "status": "legacy",
+          "replacement_verified": true,
+          "manual_hold": false,
+          "hold_reason": null,
+          "notes": null,
+          "retired_at": null,
+          "created_at": "2026-06-04T00:25:59.291135Z",
+          "updated_at": "2026-06-04T00:25:59.291135Z"
+        },
+        "all_time": {
+          "calls": 1643952,
+          "tenant_count": 1,
+          "user_count": 1,
+          "component_count": 1,
+          "tenants": {
+            "unknown": 1643952
+          },
+          "users": {
+            "unknown": 1643952
+          },
+          "components": {
+            "unknown": 1643952
+          }
+        },
+        "window": {
+          "calls": 0,
+          "tenant_count": 0,
+          "user_count": 0,
+          "component_count": 0,
+          "tenants": {},
+          "users": {},
+          "components": {}
+        },
+        "last_seen_at": "2026-08-21T13:50:30.082480Z",
+        "retirement_candidate": false,
+        "retirement_reason": "quiet 12d of 60d required for 1643952 all-time call(s)"
+      },
+      {
+        "interface": {
+          "id": "b1aae931-b51f-4a85-a723-865dd65f6132",
+          "interface_key": "rest_api:PATCH /workstreams/{workstream_id}",
+          "interface_kind": "rest_api",
+          "legacy_since": "2026-06-04T06:09:41.901035Z",
+          "replacement_ref": "/workplans/{workplan_id}",
+          "owner_component": "state-hub.api",
+          "status": "legacy",
+          "replacement_verified": true,
+          "manual_hold": false,
+          "hold_reason": null,
+          "notes": null,
+          "retired_at": null,
+          "created_at": "2026-06-04T06:09:41.901035Z",
+          "updated_at": "2026-06-04T06:09:41.901035Z"
+        },
+        "all_time": {
+          "calls": 584,
+          "tenant_count": 1,
+          "user_count": 1,
+          "component_count": 1,
+          "tenants": {
+            "unknown": 584
+          },
+          "users": {
+            "unknown": 584
+          },
+          "components": {
+            "unknown": 584
+          }
+        },
+        "window": {
+          "calls": 0,
+          "tenant_count": 0,
+          "user_count": 0,
+          "component_count": 0,
+          "tenants": {},
+          "users": {},
+          "components": {}
+        },
+        "last_seen_at": "2026-08-16T16:33:34.045078Z",
+        "retirement_candidate": false,
+        "retirement_reason": "quiet 16d of 30d required for 584 all-time call(s)"
+      },
+      {
+        "interface": {
+          "id": "ed6451c9-d2cc-4486-9afe-d3852782cabc",
+          "interface_key": "rest_api:POST /workstreams/",
+          "interface_kind": "rest_api",
+          "legacy_since": "2026-06-04T07:40:24.168535Z",
+          "replacement_ref": "/workplans/",
+          "owner_component": "state-hub.api",
+          "status": "legacy",
+          "replacement_verified": true,
+          "manual_hold": false,
+          "hold_reason": null,
+          "notes": null,
+          "retired_at": null,
+          "created_at": "2026-06-04T07:40:24.168535Z",
+          "updated_at": "2026-06-04T07:40:24.168535Z"
+        },
+        "all_time": {
+          "calls": 811,
+          "tenant_count": 1,
+          "user_count": 1,
+          "component_count": 1,
+          "tenants": {
+            "unknown": 811
+          },
+          "users": {
+            "unknown": 811
+          },
+          "components": {
+            "unknown": 811
+          }
+        },
+        "window": {
+          "calls": 0,
+          "tenant_count": 0,
+          "user_count": 0,
+          "component_count": 0,
+          "tenants": {},
+          "users": {},
+          "components": {}
+        },
+        "last_seen_at": "2026-08-16T01:03:41.093965Z",
+        "retirement_candidate": false,
+        "retirement_reason": "quiet 17d of 30d required for 811 all-time call(s)"
+      },
+      {
+        "interface": {
+          "id": "281fd706-b192-4194-8055-2d8733c115f9",
+          "interface_key": "rest_api:POST /workstreams/{workstream_id}/dependencies/",
+          "interface_kind": "rest_api",
+          "legacy_since": "2026-06-04T22:57:37.149207Z",
+          "replacement_ref": "/workplans/{workplan_id}/dependencies/",
+          "owner_component": "state-hub.api",
+          "status": "retired",
+          "replacement_verified": true,
+          "manual_hold": false,
+          "hold_reason": null,
+          "notes": "Retired by STATE-WP-0069 closeout",
+          "retired_at": "2026-08-31T08:55:09.130713Z",
+          "created_at": "2026-06-04T22:57:37.149207Z",
+          "updated_at": "2026-08-31T08:55:09.123888Z"
+        },
+        "all_time": {
+          "calls": 4975,
+          "tenant_count": 1,
+          "user_count": 1,
+          "component_count": 1,
+          "tenants": {
+            "unknown": 4975
+          },
+          "users": {
+            "unknown": 4975
+          },
+          "components": {
+            "unknown": 4975
+          }
+        },
+        "window": {
+          "calls": 0,
+          "tenant_count": 0,
+          "user_count": 0,
+          "component_count": 0,
+          "tenants": {},
+          "users": {},
+          "components": {}
+        },
+        "last_seen_at": "2026-07-07T20:31:35.389791Z",
+        "retirement_candidate": false,
+        "retirement_reason": "already retired"
+      }
+    ],
+    "retirement_candidates": []
+  },
+  "days": 7
+}
diff --git a/docs/evidence/legacy-meter-weekly-review-20260903.json b/docs/evidence/legacy-meter-weekly-review-20260903.json
new file mode 100644
index 0000000..8c102a4
--- /dev/null
+++ b/docs/evidence/legacy-meter-weekly-review-20260903.json
@@ -0,0 +1,734 @@
+{
+  "captured_at": "2026-09-02T22:00:08.180858+00:00",
+  "api_base": "http://127.0.0.1:8000",
+  "workplan": "STATE-WP-0070",
+  "retired_interfaces": [],
+  "weekly_review": {
+    "generated_at": "2026-09-02T22:00:09.989497Z",
+    "window_start": "2026-08-26T22:00:09.857120Z",
+    "window_end": "2026-09-02T22:00:09.857120Z",
+    "cadence": "weekly",
+    "activity_core_handoff": {
+      "activity_id": "statehub-legacy-interface-review",
+      "cadence": "weekly",
+      "source_endpoint": "/legacy-meter/weekly-review",
+      "state_owner": "state-hub",
+      "scheduler_owner": "activity-core"
+    },
+    "interfaces": [
+      {
+        "interface": {
+          "id": "8051fb40-66c9-4dc4-a413-13e8573e04a3",
+          "interface_key": "event_subject:org.statehub.workstream.completed",
+          "interface_kind": "event_subject",
+          "legacy_since": "2026-06-04T06:09:42.198193Z",
+          "replacement_ref": "org.statehub.workplan.completed",
+          "owner_component": "state-hub.events",
+          "status": "retired",
+          "replacement_verified": true,
+          "manual_hold": false,
+          "hold_reason": null,
+          "notes": "Retired by STATE-WP-0069 closeout",
+          "retired_at": "2026-08-31T08:55:06.871333Z",
+          "created_at": "2026-06-04T06:09:42.198193Z",
+          "updated_at": "2026-08-31T08:55:06.756087Z"
+        },
+        "all_time": {
+          "calls": 247,
+          "tenant_count": 1,
+          "user_count": 1,
+          "component_count": 1,
+          "tenants": {
+            "unknown": 247
+          },
+          "users": {
+            "unknown": 247
+          },
+          "components": {
+            "state-hub.events": 247
+          }
+        },
+        "window": {
+          "calls": 0,
+          "tenant_count": 0,
+          "user_count": 0,
+          "component_count": 0,
+          "tenants": {},
+          "users": {},
+          "components": {}
+        },
+        "last_seen_at": "2026-07-13T13:22:00.748140Z",
+        "retirement_candidate": false,
+        "retirement_reason": "already retired"
+      },
+      {
+        "interface": {
+          "id": "cd9342fd-27e7-4a46-a1be-d41499e106a3",
+          "interface_key": "rest_api:DELETE /workstreams/{workstream_id}",
+          "interface_kind": "rest_api",
+          "legacy_since": "2026-06-06T17:28:13.052813Z",
+          "replacement_ref": "/workplans/{workplan_id}",
+          "owner_component": "state-hub.api",
+          "status": "retired",
+          "replacement_verified": true,
+          "manual_hold": false,
+          "hold_reason": null,
+          "notes": "Retired by STATE-WP-0069 closeout",
+          "retired_at": "2026-08-31T08:55:08.200322Z",
+          "created_at": "2026-06-06T17:28:13.052813Z",
+          "updated_at": "2026-08-31T08:55:08.089714Z"
+        },
+        "all_time": {
+          "calls": 1,
+          "tenant_count": 1,
+          "user_count": 1,
+          "component_count": 1,
+          "tenants": {
+            "unknown": 1
+          },
+          "users": {
+            "unknown": 1
+          },
+          "components": {
+            "unknown": 1
+          }
+        },
+        "window": {
+          "calls": 0,
+          "tenant_count": 0,
+          "user_count": 0,
+          "component_count": 0,
+          "tenants": {},
+          "users": {},
+          "components": {}
+        },
+        "last_seen_at": "2026-06-06T17:28:13.047529Z",
+        "retirement_candidate": false,
+        "retirement_reason": "already retired"
+      },
+      {
+        "interface": {
+          "id": "d0294dce-7913-4268-94c3-1b2502aefb0f",
+          "interface_key": "rest_api:GET /sbom/",
+          "interface_kind": "rest_api",
+          "legacy_since": "2026-08-22T17:06:38.703608Z",
+          "replacement_ref": "sbom-nexus:/sbom/",
+          "owner_component": "state-hub.sbom-compat",
+          "status": "legacy",
+          "replacement_verified": true,
+          "manual_hold": false,
+          "hold_reason": null,
+          "notes": null,
+          "retired_at": null,
+          "created_at": "2026-08-22T17:06:38.703608Z",
+          "updated_at": "2026-08-22T17:23:43.730661Z"
+        },
+        "all_time": {
+          "calls": 6,
+          "tenant_count": 1,
+          "user_count": 1,
+          "component_count": 1,
+          "tenants": {
+            "unknown": 6
+          },
+          "users": {
+            "unknown": 6
+          },
+          "components": {
+            "unknown": 6
+          }
+        },
+        "window": {
+          "calls": 2,
+          "tenant_count": 1,
+          "user_count": 1,
+          "component_count": 1,
+          "tenants": {
+            "unknown": 2
+          },
+          "users": {
+            "unknown": 2
+          },
+          "components": {
+            "unknown": 2
+          }
+        },
+        "last_seen_at": "2026-08-31T08:18:41.571768Z",
+        "retirement_candidate": false,
+        "retirement_reason": "2 call(s) in review window"
+      },
+      {
+        "interface": {
+          "id": "2f77ac12-8c97-4974-a2f9-2996927982d1",
+          "interface_key": "rest_api:GET /sbom/report/licences/",
+          "interface_kind": "rest_api",
+          "legacy_since": "2026-08-22T17:06:41.978426Z",
+          "replacement_ref": "sbom-nexus:/sbom/",
+          "owner_component": "state-hub.sbom-compat",
+          "status": "legacy",
+          "replacement_verified": true,
+          "manual_hold": false,
+          "hold_reason": null,
+          "notes": null,
+          "retired_at": null,
+          "created_at": "2026-08-22T17:06:41.978426Z",
+          "updated_at": "2026-08-22T17:23:44.794796Z"
+        },
+        "all_time": {
+          "calls": 5,
+          "tenant_count": 1,
+          "user_count": 1,
+          "component_count": 1,
+          "tenants": {
+            "unknown": 5
+          },
+          "users": {
+            "unknown": 5
+          },
+          "components": {
+            "unknown": 5
+          }
+        },
+        "window": {
+          "calls": 1,
+          "tenant_count": 1,
+          "user_count": 1,
+          "component_count": 1,
+          "tenants": {
+            "unknown": 1
+          },
+          "users": {
+            "unknown": 1
+          },
+          "components": {
+            "unknown": 1
+          }
+        },
+        "last_seen_at": "2026-08-28T18:46:10.642164Z",
+        "retirement_candidate": false,
+        "retirement_reason": "1 call(s) in review window"
+      },
+      {
+        "interface": {
+          "id": "b627edf5-3302-4366-ba2e-547d32f634b5",
+          "interface_key": "rest_api:GET /sbom/snapshots/",
+          "interface_kind": "rest_api",
+          "legacy_since": "2026-08-22T17:06:37.057774Z",
+          "replacement_ref": "sbom-nexus:/sbom/",
+          "owner_component": "state-hub.sbom-compat",
+          "status": "legacy",
+          "replacement_verified": true,
+          "manual_hold": false,
+          "hold_reason": null,
+          "notes": null,
+          "retired_at": null,
+          "created_at": "2026-08-22T17:06:37.057774Z",
+          "updated_at": "2026-08-22T17:22:15.080213Z"
+        },
+        "all_time": {
+          "calls": 7,
+          "tenant_count": 1,
+          "user_count": 1,
+          "component_count": 1,
+          "tenants": {
+            "unknown": 7
+          },
+          "users": {
+            "unknown": 7
+          },
+          "components": {
+            "unknown": 7
+          }
+        },
+        "window": {
+          "calls": 2,
+          "tenant_count": 1,
+          "user_count": 1,
+          "component_count": 1,
+          "tenants": {
+            "unknown": 2
+          },
+          "users": {
+            "unknown": 2
+          },
+          "components": {
+            "unknown": 2
+          }
+        },
+        "last_seen_at": "2026-08-28T18:46:10.694185Z",
+        "retirement_candidate": false,
+        "retirement_reason": "2 call(s) in review window"
+      },
+      {
+        "interface": {
+          "id": "d03ee274-cd6f-4cd5-8f22-e4d298416299",
+          "interface_key": "rest_api:GET /sbom/snapshots/{snapshot_id}",
+          "interface_kind": "rest_api",
+          "legacy_since": "2026-08-22T17:23:45.969876Z",
+          "replacement_ref": "sbom-nexus:/sbom/",
+          "owner_component": "state-hub.sbom-compat",
+          "status": "retired",
+          "replacement_verified": true,
+          "manual_hold": false,
+          "hold_reason": null,
+          "notes": "Retired by STATE-WP-0069 closeout",
+          "retired_at": "2026-08-31T08:55:08.470106Z",
+          "created_at": "2026-08-22T17:23:45.969876Z",
+          "updated_at": "2026-08-31T08:55:08.456139Z"
+        },
+        "all_time": {
+          "calls": 1,
+          "tenant_count": 1,
+          "user_count": 1,
+          "component_count": 1,
+          "tenants": {
+            "unknown": 1
+          },
+          "users": {
+            "unknown": 1
+          },
+          "components": {
+            "unknown": 1
+          }
+        },
+        "window": {
+          "calls": 0,
+          "tenant_count": 0,
+          "user_count": 0,
+          "component_count": 0,
+          "tenants": {},
+          "users": {},
+          "components": {}
+        },
+        "last_seen_at": "2026-08-22T17:23:45.967492Z",
+        "retirement_candidate": false,
+        "retirement_reason": "already retired"
+      },
+      {
+        "interface": {
+          "id": "a6cb291e-8312-42f8-8a66-fde369482881",
+          "interface_key": "rest_api:GET /sbom/{repo_slug}",
+          "interface_kind": "rest_api",
+          "legacy_since": "2026-08-22T17:23:45.089542Z",
+          "replacement_ref": "sbom-nexus:/sbom/",
+          "owner_component": "state-hub.sbom-compat",
+          "status": "retired",
+          "replacement_verified": true,
+          "manual_hold": false,
+          "hold_reason": null,
+          "notes": "Retired by STATE-WP-0069 closeout",
+          "retired_at": "2026-08-31T08:55:08.754914Z",
+          "created_at": "2026-08-22T17:23:45.089542Z",
+          "updated_at": "2026-08-31T08:55:08.750826Z"
+        },
+        "all_time": {
+          "calls": 1,
+          "tenant_count": 1,
+          "user_count": 1,
+          "component_count": 1,
+          "tenants": {
+            "unknown": 1
+          },
+          "users": {
+            "unknown": 1
+          },
+          "components": {
+            "unknown": 1
+          }
+        },
+        "window": {
+          "calls": 0,
+          "tenant_count": 0,
+          "user_count": 0,
+          "component_count": 0,
+          "tenants": {},
+          "users": {},
+          "components": {}
+        },
+        "last_seen_at": "2026-08-22T17:23:45.670511Z",
+        "retirement_candidate": false,
+        "retirement_reason": "already retired"
+      },
+      {
+        "interface": {
+          "id": "cad13f19-ddb1-49b9-86d0-8789b7599f3a",
+          "interface_key": "rest_api:GET /tasks/?workstream_id",
+          "interface_kind": "rest_api",
+          "legacy_since": "2026-08-29T10:01:31.546213Z",
+          "replacement_ref": "/tasks/?workplan_id=<workplan_id>",
+          "owner_component": "state-hub.api",
+          "status": "legacy",
+          "replacement_verified": true,
+          "manual_hold": false,
+          "hold_reason": null,
+          "notes": null,
+          "retired_at": null,
+          "created_at": "2026-08-29T10:01:31.546213Z",
+          "updated_at": "2026-08-29T10:01:31.546213Z"
+        },
+        "all_time": {
+          "calls": 10,
+          "tenant_count": 1,
+          "user_count": 1,
+          "component_count": 1,
+          "tenants": {
+            "unknown": 10
+          },
+          "users": {
+            "unknown": 10
+          },
+          "components": {
+            "unknown": 10
+          }
+        },
+        "window": {
+          "calls": 10,
+          "tenant_count": 1,
+          "user_count": 1,
+          "component_count": 1,
+          "tenants": {
+            "unknown": 10
+          },
+          "users": {
+            "unknown": 10
+          },
+          "components": {
+            "unknown": 10
+          }
+        },
+        "last_seen_at": "2026-09-01T22:58:15.354257Z",
+        "retirement_candidate": false,
+        "retirement_reason": "10 call(s) in review window"
+      },
+      {
+        "interface": {
+          "id": "3e4a3d0b-08fa-45c3-91e2-4f514a914b97",
+          "interface_key": "rest_api:GET /workstreams/",
+          "interface_kind": "rest_api",
+          "legacy_since": "2026-06-04T00:26:14.533764Z",
+          "replacement_ref": "/workplans/",
+          "owner_component": "state-hub.api",
+          "status": "legacy",
+          "replacement_verified": true,
+          "manual_hold": false,
+          "hold_reason": null,
+          "notes": null,
+          "retired_at": null,
+          "created_at": "2026-06-04T00:26:14.533764Z",
+          "updated_at": "2026-06-04T00:26:14.533764Z"
+        },
+        "all_time": {
+          "calls": 830269,
+          "tenant_count": 1,
+          "user_count": 1,
+          "component_count": 1,
+          "tenants": {
+            "unknown": 830269
+          },
+          "users": {
+            "unknown": 830269
+          },
+          "components": {
+            "unknown": 830269
+          }
+        },
+        "window": {
+          "calls": 0,
+          "tenant_count": 0,
+          "user_count": 0,
+          "component_count": 0,
+          "tenants": {},
+          "users": {},
+          "components": {}
+        },
+        "last_seen_at": "2026-08-21T13:50:37.994459Z",
+        "retirement_candidate": false,
+        "retirement_reason": "quiet 12d of 60d required for 830269 all-time call(s)"
+      },
+      {
+        "interface": {
+          "id": "e4c140ec-7479-46f9-b185-4b533f19d639",
+          "interface_key": "rest_api:GET /workstreams/workplan-index",
+          "interface_kind": "rest_api",
+          "legacy_since": "2026-06-04T05:20:58.321869Z",
+          "replacement_ref": "/workplans/index",
+          "owner_component": "state-hub.api",
+          "status": "retired",
+          "replacement_verified": true,
+          "manual_hold": false,
+          "hold_reason": null,
+          "notes": "Retired by STATE-WP-0069 closeout",
+          "retired_at": "2026-08-31T08:55:08.939572Z",
+          "created_at": "2026-06-04T05:20:58.321869Z",
+          "updated_at": "2026-08-31T08:55:08.933482Z"
+        },
+        "all_time": {
+          "calls": 40,
+          "tenant_count": 1,
+          "user_count": 1,
+          "component_count": 1,
+          "tenants": {
+            "unknown": 40
+          },
+          "users": {
+            "unknown": 40
+          },
+          "components": {
+            "unknown": 40
+          }
+        },
+        "window": {
+          "calls": 1,
+          "tenant_count": 1,
+          "user_count": 1,
+          "component_count": 1,
+          "tenants": {
+            "unknown": 1
+          },
+          "users": {
+            "unknown": 1
+          },
+          "components": {
+            "unknown": 1
+          }
+        },
+        "last_seen_at": "2026-09-01T18:42:55.879795Z",
+        "retirement_candidate": false,
+        "retirement_reason": "already retired"
+      },
+      {
+        "interface": {
+          "id": "3a00b19e-e7db-4403-98aa-a77c9ab61ecc",
+          "interface_key": "rest_api:GET /workstreams/{workstream_id}",
+          "interface_kind": "rest_api",
+          "legacy_since": "2026-06-04T00:25:59.014966Z",
+          "replacement_ref": "/workplans/{workplan_id}",
+          "owner_component": "state-hub.api",
+          "status": "legacy",
+          "replacement_verified": true,
+          "manual_hold": false,
+          "hold_reason": null,
+          "notes": null,
+          "retired_at": null,
+          "created_at": "2026-06-04T00:25:59.014966Z",
+          "updated_at": "2026-06-04T00:25:59.014966Z"
+        },
+        "all_time": {
+          "calls": 3411471,
+          "tenant_count": 1,
+          "user_count": 1,
+          "component_count": 1,
+          "tenants": {
+            "unknown": 3411471
+          },
+          "users": {
+            "unknown": 3411471
+          },
+          "components": {
+            "unknown": 3411471
+          }
+        },
+        "window": {
+          "calls": 1,
+          "tenant_count": 1,
+          "user_count": 1,
+          "component_count": 1,
+          "tenants": {
+            "unknown": 1
+          },
+          "users": {
+            "unknown": 1
+          },
+          "components": {
+            "unknown": 1
+          }
+        },
+        "last_seen_at": "2026-09-01T18:43:07.476120Z",
+        "retirement_candidate": false,
+        "retirement_reason": "1 call(s) in review window"
+      },
+      {
+        "interface": {
+          "id": "69e1a255-a8b9-4101-8a68-b1bed23abfda",
+          "interface_key": "rest_api:GET /workstreams/{workstream_id}/dependencies/",
+          "interface_kind": "rest_api",
+          "legacy_since": "2026-06-04T00:25:59.291135Z",
+          "replacement_ref": "/workplans/{workplan_id}/dependencies/",
+          "owner_component": "state-hub.api",
+          "status": "legacy",
+          "replacement_verified": true,
+          "manual_hold": false,
+          "hold_reason": null,
+          "notes": null,
+          "retired_at": null,
+          "created_at": "2026-06-04T00:25:59.291135Z",
+          "updated_at": "2026-06-04T00:25:59.291135Z"
+        },
+        "all_time": {
+          "calls": 1643952,
+          "tenant_count": 1,
+          "user_count": 1,
+          "component_count": 1,
+          "tenants": {
+            "unknown": 1643952
+          },
+          "users": {
+            "unknown": 1643952
+          },
+          "components": {
+            "unknown": 1643952
+          }
+        },
+        "window": {
+          "calls": 0,
+          "tenant_count": 0,
+          "user_count": 0,
+          "component_count": 0,
+          "tenants": {},
+          "users": {},
+          "components": {}
+        },
+        "last_seen_at": "2026-08-21T13:50:30.082480Z",
+        "retirement_candidate": false,
+        "retirement_reason": "quiet 12d of 60d required for 1643952 all-time call(s)"
+      },
+      {
+        "interface": {
+          "id": "b1aae931-b51f-4a85-a723-865dd65f6132",
+          "interface_key": "rest_api:PATCH /workstreams/{workstream_id}",
+          "interface_kind": "rest_api",
+          "legacy_since": "2026-06-04T06:09:41.901035Z",
+          "replacement_ref": "/workplans/{workplan_id}",
+          "owner_component": "state-hub.api",
+          "status": "legacy",
+          "replacement_verified": true,
+          "manual_hold": false,
+          "hold_reason": null,
+          "notes": null,
+          "retired_at": null,
+          "created_at": "2026-06-04T06:09:41.901035Z",
+          "updated_at": "2026-06-04T06:09:41.901035Z"
+        },
+        "all_time": {
+          "calls": 584,
+          "tenant_count": 1,
+          "user_count": 1,
+          "component_count": 1,
+          "tenants": {
+            "unknown": 584
+          },
+          "users": {
+            "unknown": 584
+          },
+          "components": {
+            "unknown": 584
+          }
+        },
+        "window": {
+          "calls": 0,
+          "tenant_count": 0,
+          "user_count": 0,
+          "component_count": 0,
+          "tenants": {},
+          "users": {},
+          "components": {}
+        },
+        "last_seen_at": "2026-08-16T16:33:34.045078Z",
+        "retirement_candidate": false,
+        "retirement_reason": "quiet 17d of 30d required for 584 all-time call(s)"
+      },
+      {
+        "interface": {
+          "id": "ed6451c9-d2cc-4486-9afe-d3852782cabc",
+          "interface_key": "rest_api:POST /workstreams/",
+          "interface_kind": "rest_api",
+          "legacy_since": "2026-06-04T07:40:24.168535Z",
+          "replacement_ref": "/workplans/",
+          "owner_component": "state-hub.api",
+          "status": "legacy",
+          "replacement_verified": true,
+          "manual_hold": false,
+          "hold_reason": null,
+          "notes": null,
+          "retired_at": null,
+          "created_at": "2026-06-04T07:40:24.168535Z",
+          "updated_at": "2026-06-04T07:40:24.168535Z"
+        },
+        "all_time": {
+          "calls": 811,
+          "tenant_count": 1,
+          "user_count": 1,
+          "component_count": 1,
+          "tenants": {
+            "unknown": 811
+          },
+          "users": {
+            "unknown": 811
+          },
+          "components": {
+            "unknown": 811
+          }
+        },
+        "window": {
+          "calls": 0,
+          "tenant_count": 0,
+          "user_count": 0,
+          "component_count": 0,
+          "tenants": {},
+          "users": {},
+          "components": {}
+        },
+        "last_seen_at": "2026-08-16T01:03:41.093965Z",
+        "retirement_candidate": false,
+        "retirement_reason": "quiet 17d of 30d required for 811 all-time call(s)"
+      },
+      {
+        "interface": {
+          "id": "281fd706-b192-4194-8055-2d8733c115f9",
+          "interface_key": "rest_api:POST /workstreams/{workstream_id}/dependencies/",
+          "interface_kind": "rest_api",
+          "legacy_since": "2026-06-04T22:57:37.149207Z",
+          "replacement_ref": "/workplans/{workplan_id}/dependencies/",
+          "owner_component": "state-hub.api",
+          "status": "retired",
+          "replacement_verified": true,
+          "manual_hold": false,
+          "hold_reason": null,
+          "notes": "Retired by STATE-WP-0069 closeout",
+          "retired_at": "2026-08-31T08:55:09.130713Z",
+          "created_at": "2026-06-04T22:57:37.149207Z",
+          "updated_at": "2026-08-31T08:55:09.123888Z"
+        },
+        "all_time": {
+          "calls": 4975,
+          "tenant_count": 1,
+          "user_count": 1,
+          "component_count": 1,
+          "tenants": {
+            "unknown": 4975
+          },
+          "users": {
+            "unknown": 4975
+          },
+          "components": {
+            "unknown": 4975
+          }
+        },
+        "window": {
+          "calls": 0,
+          "tenant_count": 0,
+          "user_count": 0,
+          "component_count": 0,
+          "tenants": {},
+          "users": {},
+          "components": {}
+        },
+        "last_seen_at": "2026-07-07T20:31:35.389791Z",
+        "retirement_candidate": false,
+        "retirement_reason": "already retired"
+      }
+    ],
+    "retirement_candidates": []
+  },
+  "days": 7
+}
diff --git a/docs/evidence/legacy-meter-weekly-review-20260904.json b/docs/evidence/legacy-meter-weekly-review-20260904.json
new file mode 100644
index 0000000..ac842fd
--- /dev/null
+++ b/docs/evidence/legacy-meter-weekly-review-20260904.json
@@ -0,0 +1,734 @@
+{
+  "captured_at": "2026-09-04T14:00:09.844360+00:00",
+  "api_base": "http://127.0.0.1:8000",
+  "workplan": "STATE-WP-0070",
+  "retired_interfaces": [],
+  "weekly_review": {
+    "generated_at": "2026-09-04T14:00:12.141508Z",
+    "window_start": "2026-08-28T14:00:10.416532Z",
+    "window_end": "2026-09-04T14:00:10.416532Z",
+    "cadence": "weekly",
+    "activity_core_handoff": {
+      "activity_id": "statehub-legacy-interface-review",
+      "cadence": "weekly",
+      "source_endpoint": "/legacy-meter/weekly-review",
+      "state_owner": "state-hub",
+      "scheduler_owner": "activity-core"
+    },
+    "interfaces": [
+      {
+        "interface": {
+          "id": "8051fb40-66c9-4dc4-a413-13e8573e04a3",
+          "interface_key": "event_subject:org.statehub.workstream.completed",
+          "interface_kind": "event_subject",
+          "legacy_since": "2026-06-04T06:09:42.198193Z",
+          "replacement_ref": "org.statehub.workplan.completed",
+          "owner_component": "state-hub.events",
+          "status": "retired",
+          "replacement_verified": true,
+          "manual_hold": false,
+          "hold_reason": null,
+          "notes": "Retired by STATE-WP-0069 closeout",
+          "retired_at": "2026-08-31T08:55:06.871333Z",
+          "created_at": "2026-06-04T06:09:42.198193Z",
+          "updated_at": "2026-08-31T08:55:06.756087Z"
+        },
+        "all_time": {
+          "calls": 247,
+          "tenant_count": 1,
+          "user_count": 1,
+          "component_count": 1,
+          "tenants": {
+            "unknown": 247
+          },
+          "users": {
+            "unknown": 247
+          },
+          "components": {
+            "state-hub.events": 247
+          }
+        },
+        "window": {
+          "calls": 0,
+          "tenant_count": 0,
+          "user_count": 0,
+          "component_count": 0,
+          "tenants": {},
+          "users": {},
+          "components": {}
+        },
+        "last_seen_at": "2026-07-13T13:22:00.748140Z",
+        "retirement_candidate": false,
+        "retirement_reason": "already retired"
+      },
+      {
+        "interface": {
+          "id": "cd9342fd-27e7-4a46-a1be-d41499e106a3",
+          "interface_key": "rest_api:DELETE /workstreams/{workstream_id}",
+          "interface_kind": "rest_api",
+          "legacy_since": "2026-06-06T17:28:13.052813Z",
+          "replacement_ref": "/workplans/{workplan_id}",
+          "owner_component": "state-hub.api",
+          "status": "retired",
+          "replacement_verified": true,
+          "manual_hold": false,
+          "hold_reason": null,
+          "notes": "Retired by STATE-WP-0069 closeout",
+          "retired_at": "2026-08-31T08:55:08.200322Z",
+          "created_at": "2026-06-06T17:28:13.052813Z",
+          "updated_at": "2026-08-31T08:55:08.089714Z"
+        },
+        "all_time": {
+          "calls": 1,
+          "tenant_count": 1,
+          "user_count": 1,
+          "component_count": 1,
+          "tenants": {
+            "unknown": 1
+          },
+          "users": {
+            "unknown": 1
+          },
+          "components": {
+            "unknown": 1
+          }
+        },
+        "window": {
+          "calls": 0,
+          "tenant_count": 0,
+          "user_count": 0,
+          "component_count": 0,
+          "tenants": {},
+          "users": {},
+          "components": {}
+        },
+        "last_seen_at": "2026-06-06T17:28:13.047529Z",
+        "retirement_candidate": false,
+        "retirement_reason": "already retired"
+      },
+      {
+        "interface": {
+          "id": "d0294dce-7913-4268-94c3-1b2502aefb0f",
+          "interface_key": "rest_api:GET /sbom/",
+          "interface_kind": "rest_api",
+          "legacy_since": "2026-08-22T17:06:38.703608Z",
+          "replacement_ref": "sbom-nexus:/sbom/",
+          "owner_component": "state-hub.sbom-compat",
+          "status": "legacy",
+          "replacement_verified": true,
+          "manual_hold": false,
+          "hold_reason": null,
+          "notes": null,
+          "retired_at": null,
+          "created_at": "2026-08-22T17:06:38.703608Z",
+          "updated_at": "2026-08-22T17:23:43.730661Z"
+        },
+        "all_time": {
+          "calls": 6,
+          "tenant_count": 1,
+          "user_count": 1,
+          "component_count": 1,
+          "tenants": {
+            "unknown": 6
+          },
+          "users": {
+            "unknown": 6
+          },
+          "components": {
+            "unknown": 6
+          }
+        },
+        "window": {
+          "calls": 2,
+          "tenant_count": 1,
+          "user_count": 1,
+          "component_count": 1,
+          "tenants": {
+            "unknown": 2
+          },
+          "users": {
+            "unknown": 2
+          },
+          "components": {
+            "unknown": 2
+          }
+        },
+        "last_seen_at": "2026-08-31T08:18:41.571768Z",
+        "retirement_candidate": false,
+        "retirement_reason": "2 call(s) in review window"
+      },
+      {
+        "interface": {
+          "id": "2f77ac12-8c97-4974-a2f9-2996927982d1",
+          "interface_key": "rest_api:GET /sbom/report/licences/",
+          "interface_kind": "rest_api",
+          "legacy_since": "2026-08-22T17:06:41.978426Z",
+          "replacement_ref": "sbom-nexus:/sbom/",
+          "owner_component": "state-hub.sbom-compat",
+          "status": "legacy",
+          "replacement_verified": true,
+          "manual_hold": false,
+          "hold_reason": null,
+          "notes": null,
+          "retired_at": null,
+          "created_at": "2026-08-22T17:06:41.978426Z",
+          "updated_at": "2026-08-22T17:23:44.794796Z"
+        },
+        "all_time": {
+          "calls": 5,
+          "tenant_count": 1,
+          "user_count": 1,
+          "component_count": 1,
+          "tenants": {
+            "unknown": 5
+          },
+          "users": {
+            "unknown": 5
+          },
+          "components": {
+            "unknown": 5
+          }
+        },
+        "window": {
+          "calls": 1,
+          "tenant_count": 1,
+          "user_count": 1,
+          "component_count": 1,
+          "tenants": {
+            "unknown": 1
+          },
+          "users": {
+            "unknown": 1
+          },
+          "components": {
+            "unknown": 1
+          }
+        },
+        "last_seen_at": "2026-08-28T18:46:10.642164Z",
+        "retirement_candidate": false,
+        "retirement_reason": "1 call(s) in review window"
+      },
+      {
+        "interface": {
+          "id": "b627edf5-3302-4366-ba2e-547d32f634b5",
+          "interface_key": "rest_api:GET /sbom/snapshots/",
+          "interface_kind": "rest_api",
+          "legacy_since": "2026-08-22T17:06:37.057774Z",
+          "replacement_ref": "sbom-nexus:/sbom/",
+          "owner_component": "state-hub.sbom-compat",
+          "status": "legacy",
+          "replacement_verified": true,
+          "manual_hold": false,
+          "hold_reason": null,
+          "notes": null,
+          "retired_at": null,
+          "created_at": "2026-08-22T17:06:37.057774Z",
+          "updated_at": "2026-08-22T17:22:15.080213Z"
+        },
+        "all_time": {
+          "calls": 7,
+          "tenant_count": 1,
+          "user_count": 1,
+          "component_count": 1,
+          "tenants": {
+            "unknown": 7
+          },
+          "users": {
+            "unknown": 7
+          },
+          "components": {
+            "unknown": 7
+          }
+        },
+        "window": {
+          "calls": 2,
+          "tenant_count": 1,
+          "user_count": 1,
+          "component_count": 1,
+          "tenants": {
+            "unknown": 2
+          },
+          "users": {
+            "unknown": 2
+          },
+          "components": {
+            "unknown": 2
+          }
+        },
+        "last_seen_at": "2026-08-28T18:46:10.694185Z",
+        "retirement_candidate": false,
+        "retirement_reason": "2 call(s) in review window"
+      },
+      {
+        "interface": {
+          "id": "d03ee274-cd6f-4cd5-8f22-e4d298416299",
+          "interface_key": "rest_api:GET /sbom/snapshots/{snapshot_id}",
+          "interface_kind": "rest_api",
+          "legacy_since": "2026-08-22T17:23:45.969876Z",
+          "replacement_ref": "sbom-nexus:/sbom/",
+          "owner_component": "state-hub.sbom-compat",
+          "status": "retired",
+          "replacement_verified": true,
+          "manual_hold": false,
+          "hold_reason": null,
+          "notes": "Retired by STATE-WP-0069 closeout",
+          "retired_at": "2026-08-31T08:55:08.470106Z",
+          "created_at": "2026-08-22T17:23:45.969876Z",
+          "updated_at": "2026-08-31T08:55:08.456139Z"
+        },
+        "all_time": {
+          "calls": 1,
+          "tenant_count": 1,
+          "user_count": 1,
+          "component_count": 1,
+          "tenants": {
+            "unknown": 1
+          },
+          "users": {
+            "unknown": 1
+          },
+          "components": {
+            "unknown": 1
+          }
+        },
+        "window": {
+          "calls": 0,
+          "tenant_count": 0,
+          "user_count": 0,
+          "component_count": 0,
+          "tenants": {},
+          "users": {},
+          "components": {}
+        },
+        "last_seen_at": "2026-08-22T17:23:45.967492Z",
+        "retirement_candidate": false,
+        "retirement_reason": "already retired"
+      },
+      {
+        "interface": {
+          "id": "a6cb291e-8312-42f8-8a66-fde369482881",
+          "interface_key": "rest_api:GET /sbom/{repo_slug}",
+          "interface_kind": "rest_api",
+          "legacy_since": "2026-08-22T17:23:45.089542Z",
+          "replacement_ref": "sbom-nexus:/sbom/",
+          "owner_component": "state-hub.sbom-compat",
+          "status": "retired",
+          "replacement_verified": true,
+          "manual_hold": false,
+          "hold_reason": null,
+          "notes": "Retired by STATE-WP-0069 closeout",
+          "retired_at": "2026-08-31T08:55:08.754914Z",
+          "created_at": "2026-08-22T17:23:45.089542Z",
+          "updated_at": "2026-08-31T08:55:08.750826Z"
+        },
+        "all_time": {
+          "calls": 1,
+          "tenant_count": 1,
+          "user_count": 1,
+          "component_count": 1,
+          "tenants": {
+            "unknown": 1
+          },
+          "users": {
+            "unknown": 1
+          },
+          "components": {
+            "unknown": 1
+          }
+        },
+        "window": {
+          "calls": 0,
+          "tenant_count": 0,
+          "user_count": 0,
+          "component_count": 0,
+          "tenants": {},
+          "users": {},
+          "components": {}
+        },
+        "last_seen_at": "2026-08-22T17:23:45.670511Z",
+        "retirement_candidate": false,
+        "retirement_reason": "already retired"
+      },
+      {
+        "interface": {
+          "id": "cad13f19-ddb1-49b9-86d0-8789b7599f3a",
+          "interface_key": "rest_api:GET /tasks/?workstream_id",
+          "interface_kind": "rest_api",
+          "legacy_since": "2026-08-29T10:01:31.546213Z",
+          "replacement_ref": "/tasks/?workplan_id=<workplan_id>",
+          "owner_component": "state-hub.api",
+          "status": "legacy",
+          "replacement_verified": true,
+          "manual_hold": false,
+          "hold_reason": null,
+          "notes": null,
+          "retired_at": null,
+          "created_at": "2026-08-29T10:01:31.546213Z",
+          "updated_at": "2026-08-29T10:01:31.546213Z"
+        },
+        "all_time": {
+          "calls": 10,
+          "tenant_count": 1,
+          "user_count": 1,
+          "component_count": 1,
+          "tenants": {
+            "unknown": 10
+          },
+          "users": {
+            "unknown": 10
+          },
+          "components": {
+            "unknown": 10
+          }
+        },
+        "window": {
+          "calls": 10,
+          "tenant_count": 1,
+          "user_count": 1,
+          "component_count": 1,
+          "tenants": {
+            "unknown": 10
+          },
+          "users": {
+            "unknown": 10
+          },
+          "components": {
+            "unknown": 10
+          }
+        },
+        "last_seen_at": "2026-09-01T22:58:15.354257Z",
+        "retirement_candidate": false,
+        "retirement_reason": "10 call(s) in review window"
+      },
+      {
+        "interface": {
+          "id": "3e4a3d0b-08fa-45c3-91e2-4f514a914b97",
+          "interface_key": "rest_api:GET /workstreams/",
+          "interface_kind": "rest_api",
+          "legacy_since": "2026-06-04T00:26:14.533764Z",
+          "replacement_ref": "/workplans/",
+          "owner_component": "state-hub.api",
+          "status": "legacy",
+          "replacement_verified": true,
+          "manual_hold": false,
+          "hold_reason": null,
+          "notes": null,
+          "retired_at": null,
+          "created_at": "2026-06-04T00:26:14.533764Z",
+          "updated_at": "2026-06-04T00:26:14.533764Z"
+        },
+        "all_time": {
+          "calls": 830269,
+          "tenant_count": 1,
+          "user_count": 1,
+          "component_count": 1,
+          "tenants": {
+            "unknown": 830269
+          },
+          "users": {
+            "unknown": 830269
+          },
+          "components": {
+            "unknown": 830269
+          }
+        },
+        "window": {
+          "calls": 0,
+          "tenant_count": 0,
+          "user_count": 0,
+          "component_count": 0,
+          "tenants": {},
+          "users": {},
+          "components": {}
+        },
+        "last_seen_at": "2026-08-21T13:50:37.994459Z",
+        "retirement_candidate": false,
+        "retirement_reason": "quiet 14d of 60d required for 830269 all-time call(s)"
+      },
+      {
+        "interface": {
+          "id": "e4c140ec-7479-46f9-b185-4b533f19d639",
+          "interface_key": "rest_api:GET /workstreams/workplan-index",
+          "interface_kind": "rest_api",
+          "legacy_since": "2026-06-04T05:20:58.321869Z",
+          "replacement_ref": "/workplans/index",
+          "owner_component": "state-hub.api",
+          "status": "retired",
+          "replacement_verified": true,
+          "manual_hold": false,
+          "hold_reason": null,
+          "notes": "Retired by STATE-WP-0069 closeout",
+          "retired_at": "2026-08-31T08:55:08.939572Z",
+          "created_at": "2026-06-04T05:20:58.321869Z",
+          "updated_at": "2026-08-31T08:55:08.933482Z"
+        },
+        "all_time": {
+          "calls": 40,
+          "tenant_count": 1,
+          "user_count": 1,
+          "component_count": 1,
+          "tenants": {
+            "unknown": 40
+          },
+          "users": {
+            "unknown": 40
+          },
+          "components": {
+            "unknown": 40
+          }
+        },
+        "window": {
+          "calls": 1,
+          "tenant_count": 1,
+          "user_count": 1,
+          "component_count": 1,
+          "tenants": {
+            "unknown": 1
+          },
+          "users": {
+            "unknown": 1
+          },
+          "components": {
+            "unknown": 1
+          }
+        },
+        "last_seen_at": "2026-09-01T18:42:55.879795Z",
+        "retirement_candidate": false,
+        "retirement_reason": "already retired"
+      },
+      {
+        "interface": {
+          "id": "3a00b19e-e7db-4403-98aa-a77c9ab61ecc",
+          "interface_key": "rest_api:GET /workstreams/{workstream_id}",
+          "interface_kind": "rest_api",
+          "legacy_since": "2026-06-04T00:25:59.014966Z",
+          "replacement_ref": "/workplans/{workplan_id}",
+          "owner_component": "state-hub.api",
+          "status": "legacy",
+          "replacement_verified": true,
+          "manual_hold": false,
+          "hold_reason": null,
+          "notes": null,
+          "retired_at": null,
+          "created_at": "2026-06-04T00:25:59.014966Z",
+          "updated_at": "2026-06-04T00:25:59.014966Z"
+        },
+        "all_time": {
+          "calls": 3411477,
+          "tenant_count": 1,
+          "user_count": 1,
+          "component_count": 1,
+          "tenants": {
+            "unknown": 3411477
+          },
+          "users": {
+            "unknown": 3411477
+          },
+          "components": {
+            "unknown": 3411477
+          }
+        },
+        "window": {
+          "calls": 7,
+          "tenant_count": 1,
+          "user_count": 1,
+          "component_count": 1,
+          "tenants": {
+            "unknown": 7
+          },
+          "users": {
+            "unknown": 7
+          },
+          "components": {
+            "unknown": 7
+          }
+        },
+        "last_seen_at": "2026-09-03T22:02:35.348363Z",
+        "retirement_candidate": false,
+        "retirement_reason": "7 call(s) in review window"
+      },
+      {
+        "interface": {
+          "id": "69e1a255-a8b9-4101-8a68-b1bed23abfda",
+          "interface_key": "rest_api:GET /workstreams/{workstream_id}/dependencies/",
+          "interface_kind": "rest_api",
+          "legacy_since": "2026-06-04T00:25:59.291135Z",
+          "replacement_ref": "/workplans/{workplan_id}/dependencies/",
+          "owner_component": "state-hub.api",
+          "status": "legacy",
+          "replacement_verified": true,
+          "manual_hold": false,
+          "hold_reason": null,
+          "notes": null,
+          "retired_at": null,
+          "created_at": "2026-06-04T00:25:59.291135Z",
+          "updated_at": "2026-06-04T00:25:59.291135Z"
+        },
+        "all_time": {
+          "calls": 1643952,
+          "tenant_count": 1,
+          "user_count": 1,
+          "component_count": 1,
+          "tenants": {
+            "unknown": 1643952
+          },
+          "users": {
+            "unknown": 1643952
+          },
+          "components": {
+            "unknown": 1643952
+          }
+        },
+        "window": {
+          "calls": 0,
+          "tenant_count": 0,
+          "user_count": 0,
+          "component_count": 0,
+          "tenants": {},
+          "users": {},
+          "components": {}
+        },
+        "last_seen_at": "2026-08-21T13:50:30.082480Z",
+        "retirement_candidate": false,
+        "retirement_reason": "quiet 14d of 60d required for 1643952 all-time call(s)"
+      },
+      {
+        "interface": {
+          "id": "b1aae931-b51f-4a85-a723-865dd65f6132",
+          "interface_key": "rest_api:PATCH /workstreams/{workstream_id}",
+          "interface_kind": "rest_api",
+          "legacy_since": "2026-06-04T06:09:41.901035Z",
+          "replacement_ref": "/workplans/{workplan_id}",
+          "owner_component": "state-hub.api",
+          "status": "legacy",
+          "replacement_verified": true,
+          "manual_hold": false,
+          "hold_reason": null,
+          "notes": null,
+          "retired_at": null,
+          "created_at": "2026-06-04T06:09:41.901035Z",
+          "updated_at": "2026-06-04T06:09:41.901035Z"
+        },
+        "all_time": {
+          "calls": 584,
+          "tenant_count": 1,
+          "user_count": 1,
+          "component_count": 1,
+          "tenants": {
+            "unknown": 584
+          },
+          "users": {
+            "unknown": 584
+          },
+          "components": {
+            "unknown": 584
+          }
+        },
+        "window": {
+          "calls": 0,
+          "tenant_count": 0,
+          "user_count": 0,
+          "component_count": 0,
+          "tenants": {},
+          "users": {},
+          "components": {}
+        },
+        "last_seen_at": "2026-08-16T16:33:34.045078Z",
+        "retirement_candidate": false,
+        "retirement_reason": "quiet 18d of 30d required for 584 all-time call(s)"
+      },
+      {
+        "interface": {
+          "id": "ed6451c9-d2cc-4486-9afe-d3852782cabc",
+          "interface_key": "rest_api:POST /workstreams/",
+          "interface_kind": "rest_api",
+          "legacy_since": "2026-06-04T07:40:24.168535Z",
+          "replacement_ref": "/workplans/",
+          "owner_component": "state-hub.api",
+          "status": "legacy",
+          "replacement_verified": true,
+          "manual_hold": false,
+          "hold_reason": null,
+          "notes": null,
+          "retired_at": null,
+          "created_at": "2026-06-04T07:40:24.168535Z",
+          "updated_at": "2026-06-04T07:40:24.168535Z"
+        },
+        "all_time": {
+          "calls": 811,
+          "tenant_count": 1,
+          "user_count": 1,
+          "component_count": 1,
+          "tenants": {
+            "unknown": 811
+          },
+          "users": {
+            "unknown": 811
+          },
+          "components": {
+            "unknown": 811
+          }
+        },
+        "window": {
+          "calls": 0,
+          "tenant_count": 0,
+          "user_count": 0,
+          "component_count": 0,
+          "tenants": {},
+          "users": {},
+          "components": {}
+        },
+        "last_seen_at": "2026-08-16T01:03:41.093965Z",
+        "retirement_candidate": false,
+        "retirement_reason": "quiet 19d of 30d required for 811 all-time call(s)"
+      },
+      {
+        "interface": {
+          "id": "281fd706-b192-4194-8055-2d8733c115f9",
+          "interface_key": "rest_api:POST /workstreams/{workstream_id}/dependencies/",
+          "interface_kind": "rest_api",
+          "legacy_since": "2026-06-04T22:57:37.149207Z",
+          "replacement_ref": "/workplans/{workplan_id}/dependencies/",
+          "owner_component": "state-hub.api",
+          "status": "retired",
+          "replacement_verified": true,
+          "manual_hold": false,
+          "hold_reason": null,
+          "notes": "Retired by STATE-WP-0069 closeout",
+          "retired_at": "2026-08-31T08:55:09.130713Z",
+          "created_at": "2026-06-04T22:57:37.149207Z",
+          "updated_at": "2026-08-31T08:55:09.123888Z"
+        },
+        "all_time": {
+          "calls": 4975,
+          "tenant_count": 1,
+          "user_count": 1,
+          "component_count": 1,
+          "tenants": {
+            "unknown": 4975
+          },
+          "users": {
+            "unknown": 4975
+          },
+          "components": {
+            "unknown": 4975
+          }
+        },
+        "window": {
+          "calls": 0,
+          "tenant_count": 0,
+          "user_count": 0,
+          "component_count": 0,
+          "tenants": {},
+          "users": {},
+          "components": {}
+        },
+        "last_seen_at": "2026-07-07T20:31:35.389791Z",
+        "retirement_candidate": false,
+        "retirement_reason": "already retired"
+      }
+    ],
+    "retirement_candidates": []
+  },
+  "days": 7
+}
diff --git a/docs/evidence/repository-collection-projection-20260905.md b/docs/evidence/repository-collection-projection-20260905.md
new file mode 100644
index 0000000..c8aef04
--- /dev/null
+++ b/docs/evidence/repository-collection-projection-20260905.md
@@ -0,0 +1,47 @@
+# Repository collection query bound — 2026-09-05
+
+STATE-WP-0087 review of the pending patch found a second loading path to bound:
+`ManagedRepo.domain` could eagerly fetch domain topics/goals, and resolving a
+filter with a full `Domain` object could load its entire repository graph.
+The collection now joins only the domain row needed for `domain_slug`, suppresses
+other relationships, and resolves domain filters with a scalar ID query.
+Canonical/alias records are fetched together in one registry query.
+
+## Production-shaped measurement
+
+Command: `uv run pytest -q -s tests/test_repository_collection_projection.py`
+
+Real local PostgreSQL (`custodian_test`), FastAPI through HTTPX ASGITransport,
+with canonical slug records, an alias, and a pre-backfill repository. Measurements
+cover HTTP handling and serialization, excluding fixture setup. These are single
+local samples, not deployed-service latency or a percentile benchmark. The
+regression asserts SQL counts rather than timing thresholds.
+
+| Repository count | Domain filter | SQL SELECTs | Request seconds |
+| --- | --- | --- | --- |
+| 4 | No | 2 | 0.0377 |
+| 131 | No | 2 | 0.0627 |
+| 501 | No | 2 | 0.1751 |
+| 4 | Yes | 3 | 0.0480 |
+| 131 | Yes | 3 | 0.0642 |
+| 501 | Yes | 3 | 0.1686 |
+
+Exactly one SELECT reads `repository_slugs` in each nonempty case. The 501-row
+case exceeds SQLAlchemy's usual select-in batch size and guards against
+accidentally restoring eager relationship batching. An empty collection skips
+the registry query. Tests also compare collection/detail behavior for absent
+registry entries, missing canonicals, and mismatched canonicals; classification
+and secondary-domain filters retain their existing behavior.
+
+This bounds database round trips, not response size: the existing unpaginated
+list still requires memory and serialization proportional to the fleet size.
+The optional SBOM owner read remains unchanged. No deployment was performed.
+
+## Regression validation
+
+`uv run pytest -q tests/test_repository_collection_projection.py
+ tests/test_routers_core.py tests/test_repository_alias_routing.py
+ tests/test_repository_rename_api.py tests/test_repository_rename_persistence.py
+ tests/test_sbom_nexus_compat.py`
+
+Result: **102 passed in 129.14s**. `git diff --check` passed.
diff --git a/docs/evidence/repository-registry-audit-20260904.json b/docs/evidence/repository-registry-audit-20260904.json
new file mode 100644
index 0000000..2f0301a
--- /dev/null
+++ b/docs/evidence/repository-registry-audit-20260904.json
@@ -0,0 +1,36 @@
+{
+  "schema": "state-hub.repository-registry-audit.v1",
+  "captured_at": "2026-09-04T19:50:00Z",
+  "source": "primary/railliance01 managed_repos database projection",
+  "workplan_task": "STATE-WP-0081-T05",
+  "counts": {
+    "repositories": 131,
+    "active": 126,
+    "active_missing_remote": 0,
+    "stale_gitea_remote": 0,
+    "workstation_local_path": 127
+  },
+  "repairs": [
+    {
+      "repo": "maturity-engine",
+      "field": "remote_url",
+      "value": "forgejo-remote:coulomb/maturity-engine.git",
+      "evidence": "verified origin of /home/worsch/maturity-engine"
+    }
+  ],
+  "archived_missing_remote": [
+    "markitect-project",
+    "railiance-bootstrap",
+    "railiance-hosts",
+    "vergabe_teilnahme"
+  ],
+  "interpretation": {
+    "local_path": "compatibility projection for workstation tools; not consumed by central Forge reconciliation",
+    "host_paths": "per-host checkout observations; not a cluster storage contract",
+    "central_source": "exact Forge commit fetched ephemerally by primary reconciliation"
+  },
+  "observations": [
+    "GET /repos/ did not return within 180 seconds; direct read-only database projection was used for this bounded audit",
+    "Archived records without a remote are retained as history and are not active reconciliation inputs"
+  ]
+}
diff --git a/docs/evidence/statehub-inbox-pilot-20260905.json b/docs/evidence/statehub-inbox-pilot-20260905.json
new file mode 100644
index 0000000..185b3e8
--- /dev/null
+++ b/docs/evidence/statehub-inbox-pilot-20260905.json
@@ -0,0 +1,116 @@
+{
+  "date": "2026-09-05",
+  "scope": "frozen-source-snapshot; no production reader switch",
+  "source": "state-hub/primary/railiance01",
+  "captured_at": "2026-09-05T08:38:37.982640+00:00",
+  "owner_commit": "6fb5ce2",
+  "package_enable_commit": "6972db5",
+  "image_digest": "sha256:a3461c0da805ef2b58caa0c862be3dc6562abcca186300d1257df9b96569b4c0",
+  "endpoint": "GET /ports/projections/statehub-inbox",
+  "import": {
+    "runs": [
+      {
+        "status": "validated",
+        "count": 20,
+        "content_hash": "f952b1fb46469f43bbf8ec7de1041a6feae943708c3496d8b55287428e6ed60d"
+      },
+      {
+        "status": "applied",
+        "count": 20,
+        "content_hash": "f952b1fb46469f43bbf8ec7de1041a6feae943708c3496d8b55287428e6ed60d"
+      },
+      {
+        "status": "noop",
+        "count": 20,
+        "content_hash": "f952b1fb46469f43bbf8ec7de1041a6feae943708c3496d8b55287428e6ed60d"
+      }
+    ],
+    "target_hash": "f952b1fb46469f43bbf8ec7de1041a6feae943708c3496d8b55287428e6ed60d",
+    "source_count": 20
+  },
+  "parity": {
+    "source_count": 20,
+    "snapshot_hash": "f952b1fb46469f43bbf8ec7de1041a6feae943708c3496d8b55287428e6ed60d",
+    "cases": [
+      {
+        "params": {},
+        "count": 19,
+        "content_hash": "1b3d5beff1d081bec7c552d0c463ffe48999bd75caf5bae1189e421651467295",
+        "mode": "snapshot-pilot",
+        "parity": true
+      },
+      {
+        "params": {
+          "unread_only": "true"
+        },
+        "count": 0,
+        "content_hash": "4f53cda18c2baa0c0354bb5f9a3ecbe5ed12ab4d8e11ba873c2f11161202b945",
+        "mode": "snapshot-pilot",
+        "parity": true
+      },
+      {
+        "params": {
+          "from_agent": "activity-core"
+        },
+        "count": 8,
+        "content_hash": "a6fb59f2a35ecc7c9c445bbcd1056955828062179ee52b2c15f497ea76a5656a",
+        "mode": "snapshot-pilot",
+        "parity": true
+      },
+      {
+        "params": {
+          "from_agent": "missing-pilot-sender"
+        },
+        "count": 0,
+        "content_hash": "4f53cda18c2baa0c0354bb5f9a3ecbe5ed12ab4d8e11ba873c2f11161202b945",
+        "mode": "snapshot-pilot",
+        "parity": true
+      },
+      {
+        "params": {
+          "limit": "1"
+        },
+        "count": 1,
+        "content_hash": "84a3d3ea5eb407629009eef7440fca14219be63486ab7d61b7e1f2d44adc3bba",
+        "mode": "snapshot-pilot",
+        "parity": true
+      },
+      {
+        "params": {
+          "limit": "1000"
+        },
+        "count": 19,
+        "content_hash": "1b3d5beff1d081bec7c552d0c463ffe48999bd75caf5bae1189e421651467295",
+        "mode": "snapshot-pilot",
+        "parity": true
+      }
+    ],
+    "no_auth": 401,
+    "bad_auth": 401,
+    "post": 405,
+    "scope": "frozen-source-snapshot"
+  },
+  "live_source_check": {
+    "live_source_api_count": 19,
+    "live_source_api_hash": "1b3d5beff1d081bec7c552d0c463ffe48999bd75caf5bae1189e421651467295",
+    "frozen_inbox_hash": "1b3d5beff1d081bec7c552d0c463ffe48999bd75caf5bae1189e421651467295",
+    "matches_frozen": true
+  },
+  "transport_from_state_hub_without_token": 401,
+  "rollback": {
+    "configuration_revision": 25,
+    "rollback_revision": 27,
+    "readyz": 200,
+    "disabled_inbox": 404,
+    "restored_revision": 28,
+    "parity_repeated": true
+  },
+  "checks": {
+    "hub_core_tests_passed": 116,
+    "packaging_tests_passed": 11,
+    "helm_lint": "passed",
+    "server_dry_run": "passed",
+    "family_validation": "14 declarations, 0 errors, 1 existing reef-railiance warning",
+    "verify_live": "passed"
+  }
+}
diff --git a/docs/evidence/statehub-inbox-pilot-20260905.md b/docs/evidence/statehub-inbox-pilot-20260905.md
new file mode 100644
index 0000000..6c22dc4
--- /dev/null
+++ b/docs/evidence/statehub-inbox-pilot-20260905.md
@@ -0,0 +1,38 @@
+# Private State Hub inbox snapshot pilot — 2026-09-05
+
+T08 receiving-readiness proof is complete. Hub Core exposes the authenticated,
+GET-only `/ports/projections/statehub-inbox` for the literal `state-hub` inbox.
+It is private, default-disabled in the chart, and enabled in the current private
+production package. State Hub remains the writer; no production reader switched.
+
+A consistent source transaction captured 20 historical rows (including archived
+rows and thread closure) at 08:38:37.982640 UTC. Import preserved identities,
+timestamps and flags; validation, apply, identical replay/no-op and target hash
+all agree. The visible inbox contains 19 rows. Six read cases match ordered IDs
+and normalized whole-record hashes, covering unread/sender filters and limits.
+The live source inbox also matched the frozen oracle at verification time.
+Bodies and credentials are excluded from this evidence.
+
+Missing/bad authentication returns 401; POST returns 405. Scoped NetworkPolicy
+admission now permits State Hub API pods to reach the authenticated boundary.
+The prior prefix-only probe overlooked existing `/ports/messaging/messages`,
+`/ports/events/progress` and named projection ports. Those native envelopes do
+not by themselves establish State Hub history/read/archive compatibility.
+
+Image source is `hub-core@6fb5ce2`; package enablement is
+`rapp-core-hub@6972db5`. Exact digest and content hashes are in the adjacent JSON.
+Helm revision 25 installed the image with the pilot disabled; revision 26 enabled
+it after import. Rollback to configuration 25 produced revision 27, readiness
+200 and pilot 404. Roll-forward to revision 28 passed the same parity cases and
+`make verify-live`. No State Hub image or writer configuration changed.
+
+Validation: 116 owner tests, 11 packaging tests, Helm lint and server dry-run
+passed. Family validation passed 14 declarations with zero errors and one
+pre-existing reef-railiance warning. The rmgr wrapper lacked jsonschema; the
+same family validator succeeded with the State Hub virtualenv interpreter.
+
+Residual **HUB-WP-0011**, tracked by **STATE-WP-0079-T09**, owns ongoing monotonic
+freshness/staleness, caller-specific credentials, canonical/alias scope and a
+reviewed production reader switch. The operator-authenticated frozen pilot must
+not be presented as a fresh inbox. B2/B3 migration and message-writer cutover
+remain open; this proof does not retire those families.
diff --git a/docs/examples/repository-rename-handoff-v1.json b/docs/examples/repository-rename-handoff-v1.json
new file mode 100644
index 0000000..5cc96f5
--- /dev/null
+++ b/docs/examples/repository-rename-handoff-v1.json
@@ -0,0 +1,43 @@
+{
+  "schema_version": "state-hub.repository-rename-handoff.v1",
+  "handoff_id": "FABRIC-WP-0042-T03",
+  "operation_id": "11111111-1111-4111-8111-111111111111",
+  "renamed_repository_id": "22222222-2222-4222-8222-222222222222",
+  "source_repository": "railiance-fabric",
+  "old_slug": "old-repository",
+  "new_slug": "new-repository",
+  "surface": "fabric-projection",
+  "affected": {
+    "paths": [
+      "graph/repositories.yaml"
+    ],
+    "graph_ids": [
+      "repo:old-repository"
+    ]
+  },
+  "required_reingest": {
+    "required": true,
+    "procedure": "Run the owning repository's documented fabric import after committing the canonical slug.",
+    "expected_source_revision": "0123456789abcdef0123456789abcdef01234567"
+  },
+  "verification": [
+    {
+      "check": "Canonical repository node is projected from the owning source revision.",
+      "expected": "repo:new-repository resolves to the unchanged State Hub repository UUID",
+      "evidence_ref": "docs/evidence/repository-rename-fabric-verification.json"
+    },
+    {
+      "check": "Historical graph evidence remains queryable.",
+      "expected": "Prior repo:old-repository observations remain historical evidence",
+      "evidence_ref": null
+    }
+  ],
+  "owning_work_record": {
+    "repository": "railiance-fabric",
+    "workplan_id": "FABRIC-WP-0042",
+    "task_id": "FABRIC-WP-0042-T03"
+  },
+  "status": "open",
+  "evidence": [],
+  "sensitive_data_prohibited": true
+}
diff --git a/docs/fabric-graph-read-model.md b/docs/fabric-graph-read-model.md
index 15ddcec..da83e4c 100644
--- a/docs/fabric-graph-read-model.md
+++ b/docs/fabric-graph-read-model.md
@@ -61,6 +61,20 @@ curl -s http://127.0.0.1:8000/fabric/graph-exports/latest
 curl -s http://127.0.0.1:8000/fabric/graph/summary
 ```
 
+Imports are immutable and retained. To roll the read model back to a previously
+validated import without depending on the source service, activate its import
+record; repeat the operation with the newer import id to roll forward again:
+
+```bash
+curl -s -X POST \
+  http://127.0.0.1:8000/fabric/graph-exports/<import-id>/activate \
+  -H "Content-Type: application/json" \
+  -d '{"requested_by":"operator-rollback"}'
+```
+
+Activation only moves the per-source latest marker. It does not alter or delete
+either graph snapshot, and activating the current import is idempotent.
+
 Representative relationship queries:
 
 ```bash
diff --git a/docs/nats-event-subjects.md b/docs/nats-event-subjects.md
index a3876b9..93a12f1 100644
--- a/docs/nats-event-subjects.md
+++ b/docs/nats-event-subjects.md
@@ -42,6 +42,11 @@ those publishers from colliding on the same `{noun}.{verb}` shape.
 | Subject                              | When                                                         | Required attributes                                                                                                          |
 | ------------------------------------ | ------------------------------------------------------------ | ---------------------------------------------------------------------------------------------------------------------------- |
 | `org.statehub.repo.registered`       | A new repo is registered via `POST /repos/`                  | `repo_id`, `repo_slug`, `domain_slug`, `remote_url?`, `local_path?`                                                          |
+| `org.statehub.repo.rename.phase`     | A rename operation starts, advances, or is safely retried    | `operation_id`, `repo_id`, `forge_repository_id`, `old_slug`, `new_slug`, `phase`, `actor`, `expected_source_commit`, `outcome`, `no_op`, phase metrics, `evidence_ref` |
+| `org.statehub.repo.rename.failed`    | A rename or rollback phase fails closed                      | Rename phase attributes plus `error_code`; never error details or supplied evidence                                         |
+| `org.statehub.repo.rename.verified`  | An operator/API verification evaluates continuity            | Rename phase attributes plus `verification_outcome`                                                                          |
+| `org.statehub.repo.rename.rolled_back` | A rename operation reaches `rolled-back`                   | Rename phase attributes plus rollback attempts and outcome                                                                   |
+| `org.statehub.repo.renamed`          | A rename operation reaches `completed`                       | Rename phase attributes; repository and Forge immutable IDs remain unchanged                                                 |
 | `org.statehub.workplan.completed`    | A workplan transitions to canonical status `finished`        | `workplan_id`, `slug`, `title`, `topic_id`, `repo_id?`, `repo_goal_id?`                                                    |
 | ~~`org.statehub.workstream.completed`~~ | **Retired 2026-07-08** (`STATE-WP-0069` T05). Use `org.statehub.workplan.completed`. | — |
 | `org.statehub.decision.resolved`     | A decision is resolved via `POST /decisions/{id}/resolve`    | `decision_id`, `title`, `topic_id?`, `workstream_id?`, `decided_by`, `rationale_snippet`                                     |
diff --git a/docs/offline-write-buffer.md b/docs/offline-write-buffer.md
index fd8fe14..44b8265 100644
--- a/docs/offline-write-buffer.md
+++ b/docs/offline-write-buffer.md
@@ -109,6 +109,7 @@ remain queueable or rejected per the write allowlist above.
 2. Run statehub outbox status on each host that may have queued writes.
 3. Run statehub outbox replay until no due queued envelopes remain.
 4. Review conflict envelopes manually.
-5. Run `statehub fix-consistency` so file-backed workplan/task state
-   remains canonical after replay.
+5. Run `rmgr sync --path <repo> --push` for repositories with file-backed
+   changes. Use `statehub fix-consistency` afterward only if a deep audit is
+   required.
 6. Record a progress note with non-secret replay counts.
diff --git a/docs/onboarding.md b/docs/onboarding.md
index 1faa6f7..027cbda 100644
--- a/docs/onboarding.md
+++ b/docs/onboarding.md
@@ -19,6 +19,28 @@ cd ~/state-hub
 make bootstrap-env
 ```
 
+The bootstrap enables `sandbox_workspace_write.network_access` in the
+operator's Codex `config.toml`, removes any default `dev-hub` Codex MCP
+registration, then checks whether a Codex sandbox can reach
+`http://127.0.0.1:8000/state/health`. Use `--skip-codex` to omit this step, or
+run it independently:
+
+```bash
+make configure-codex
+```
+
+If verification still reports isolated networking, a managed Codex permission
+profile is overriding user configuration. Retry State Hub REST/CLI commands with
+escalated execution or change that managed profile; do not infer that the API is
+down until the same health check has been run outside the sandbox.
+
+The slim six-tool Codex MCP server remains available for explicit testing, but
+is not recommended while the Codex MCP bridge adds substantial call latency:
+
+```bash
+make configure-codex WITH_MCP=1
+```
+
 On a clean Ubuntu 24.04 machine, allow package installation explicitly:
 
 ```bash
diff --git a/docs/ops-run-read-projection.md b/docs/ops-run-read-projection.md
new file mode 100644
index 0000000..a778dfb
--- /dev/null
+++ b/docs/ops-run-read-projection.md
@@ -0,0 +1,56 @@
+# Ops run read projection
+
+State Hub projects activity-core `ops_run` queue health for fleet visibility.
+Activity-core remains the authority for run creation, claims, leases,
+completion, failure, and expiry under ACT-ADR-005 and ACTIVITY-WP-0026.
+
+## V1 contract
+
+V1 is a cached **pull** projection. State Hub reads activity-core:
+
+```text
+GET {ACTIVITY_CORE_URL}/ops-runs?limit=200
+X-Worker-Token: ${ACTIVITY_CORE_WORKER_TOKEN}
+```
+
+The credential is owned by the OpenBao/railiance-platform path and must be
+injected at runtime. State Hub never persists or returns it.
+
+The upstream fields consumed are:
+
+| Upstream field | Projection field |
+| --- | --- |
+| `id` | `id` |
+| `activity_definition_id` | `definition` |
+| `target_repo` | `target_repo` |
+| `state` | `state` |
+| `claim_owner`, `lease_until`, `attempt` | `lease` |
+| `updated_at` | `updated_at` |
+| `result.error` or `last_error` | `last_error` |
+
+State Hub exposes:
+
+- `GET /ops-runs/summary`
+- `/state/summary` field `ops_runs`
+
+Both provide `open`, `claimed`, `failed_24h`, `stuck_open_or_claimed`, and a
+bounded list of open/claimed/failed rows. There are deliberately no claim,
+heartbeat, complete, fail, or expiry endpoints in State Hub.
+
+## Cache and failure behavior
+
+`OPS_RUN_PROJECTION_TTL_SECONDS` defaults to 15 seconds. A refresh failure
+serves the last successful projection with `stale: true` and an `error` field.
+Before the first successful read, the projection returns `available: false`;
+State Hub summary and work-record APIs remain healthy.
+
+`OPS_RUN_SLA_HOURS` defaults to 1 hour and classifies open or claimed runs older
+than the threshold as stuck. This is an operator signal, not a state transition.
+
+## Railiance and coulombcore boundary
+
+Claims happen against activity-core on Railiance. State Hub on coulombcore only
+pulls visibility through the configured private activity-core endpoint. If the
+edge/tunnel path is unavailable, visibility may lag and the projection is marked
+stale; operators should alert on stale/unavailable projection state rather than
+moving claim authority into State Hub.
diff --git a/docs/repository-rename-operations.md b/docs/repository-rename-operations.md
new file mode 100644
index 0000000..117d3ba
--- /dev/null
+++ b/docs/repository-rename-operations.md
@@ -0,0 +1,332 @@
+# Repository rename operations
+
+This is the operator runbook for a lineage-preserving repository rename within
+one Forgejo instance and owner. It coordinates State Hub, Forgejo, HelixForge,
+and repository-owned work without changing the repository UUID or Forge numeric
+ID. It does not authorize a live rename; the target repository's reviewed
+migration workplan and a human cutover decision do that.
+
+The identity and failure contract is
+[`ADR-001`](adr/ADR-001-repository-rename-identity-contract.md). The automated
+recovery proof is
+[`STATE-WP-0085-T07`](evidence/STATE-WP-0085-T07-repository-rename-recovery-matrix.md).
+
+## Ownership
+
+| Owner | Owns | Must not do |
+| --- | --- | --- |
+| State Hub | Repository UUID, canonical slug, protected aliases, verified Forge identity, operation journal, continuity verification, lifecycle events | Rename Forgejo directly, rewrite another repository's source, or register a replacement repository |
+| Forgejo | Git repository, numeric repository ID, canonical Forge name, Git data, redirects and Forge-owned settings | Decide State Hub UUID/alias history or consumer completion |
+| HelixForge/operator | Cutover window, credentials routed through their approved custodian, Forgejo rename call, pause/continue/rollback decision, destructive cleanup approval | Put credentials in CLI arguments, evidence, Git, State Hub, or chat |
+| Target repository | Repository-native migration plan, product/runtime naming decisions, source updates, fresh clone, file-first work records, aggregation of owned handoff evidence | Claim another repository's source change complete |
+| External source repository | Its own CI, deployment, policy, fabric, SBOM, credential-route, package, or documentation source and its live handoff work record | Let the target repository edit or close that obligation on its behalf |
+
+Forgejo credentials are never accepted by `statehub repo rename`. Resolve
+credential ownership before the window with `warden route find` and use the
+operator-approved Forgejo/HelixForge mechanism outside State Hub. Examples below
+use identifiers and placeholder paths only.
+
+## Choose the scope before planning
+
+### Repository-only rename checklist
+
+Use this when the Git repository coordinate changes but the product/runtime
+identity does not.
+
+- [ ] Forgejo repository name and canonical clone/web URL change.
+- [ ] State Hub canonical slug changes on the existing UUID; old slug remains a
+  protected alias.
+- [ ] Local checkout and automation checkout coordinates are re-registered.
+- [ ] Repository metadata and intentional live source references are updated.
+- [ ] Consumers that name the Git coordinate receive owned handoffs.
+- [ ] Binary, module/import path, API names, environment variables, Kubernetes
+  namespace/services, packages/images, policy vocabulary, and telemetry labels
+  explicitly remain unchanged.
+
+### Product/runtime rename checklist
+
+Use this only when separate product decisions authorize broader changes. Treat
+each item as independently deployable and independently reversible.
+
+- [ ] Record keep/rename decisions for binary and module/import path.
+- [ ] Record compatibility policy for APIs, CLI names, environment variables,
+  configuration keys, policy vocabulary, and user-facing names.
+- [ ] Plan package/image coordinates, releases, redirects, and deprecation
+  windows without assuming Forge redirects cover registries.
+- [ ] Plan Kubernetes namespace, Service/DNS, Helm chart/release, secrets paths,
+  dashboards, alerts, and telemetry labels.
+- [ ] Give each owning repository/platform a live workplan/task handoff.
+- [ ] Define deployment order, compatibility window, rollback boundary, and
+  irreversible migrations separately from the repository rename.
+
+A repository-only approval never implies the product/runtime checklist.
+
+## Prepare the operation
+
+1. Generate and review the target-owned adoption plan:
+
+   ```text
+   statehub repo rename generate-workplan <old-slug> <new-slug> --json
+   ```
+
+2. Secure all branches, tags, and local changes to Forgejo. Capture the State
+   Hub repository UUID, Forge numeric ID, default branch, and head commit.
+3. Inventory every slug-bearing source. Create one live handoff record in each
+   owning repository using the format below. Unknown ownership is a blocker.
+4. Resolve or deliberately coordinate active work and drain/replay edge outbox
+   writes. A queued receipt is not central evidence.
+5. Choose a client-owned operation UUID and keep it for every retry:
+
+   ```text
+   <operation-id> = <uuid-generated-by-operator-or-orchestrator>
+   <confirmation> = rename:<state-hub-repository-uuid>:<old-slug>:<new-slug>
+   ```
+
+6. Capture a new preflight immediately before the window. The output file is
+   private and single-use; do not commit it:
+
+   ```text
+   statehub repo rename preflight <old-slug> <new-slug> \
+     --operation-id <operation-id> \
+     --output <private-mode-0600-preflight.json> --json
+   ```
+
+Proceed only when `ok` and `result.safe_to_apply` are true, `blockers` is empty,
+the immutable IDs/head match the approved baseline, and every warning has a
+recorded disposition.
+
+## Execute one phase at a time
+
+Start the durable journal before asking HelixForge to mutate Forgejo:
+
+```text
+statehub repo rename start <old-slug> <new-slug> \
+  --operation-id <operation-id> \
+  --preflight-file <private-mode-0600-preflight.json> \
+  --actor <operator-id> --confirm '<confirmation>' --json
+```
+
+The operation is now `preflighted`. Apply only the phase named by
+`next_safe_action`:
+
+```text
+statehub repo rename apply <operation-id> --phase forge-renamed \
+  --confirm '<confirmation>' --json
+statehub repo rename apply <operation-id> --phase statehub-rebound \
+  --confirm '<confirmation>' --json
+```
+
+After the State Hub rebind, make a fresh clone from the canonical URL. Do not
+trust an old-slug redirect as identity. Verify the Forge numeric ID and head,
+register the new path against the existing State Hub UUID, commit canonical
+source/frontmatter updates, and run `statehub fix-consistency` in the new clone.
+
+The private source evidence file must include the assertions enforced by State
+Hub. Extra non-secret references are allowed:
+
+```json
+{
+  "fresh_clone": true,
+  "forge_repository_id": 12345,
+  "head_commit": "0123456789abcdef0123456789abcdef01234567",
+  "clone_path": "<new-local-checkout>",
+  "registration_evidence_ref": "<progress-event-or-file-reference>",
+  "consistency_evidence_ref": "<progress-event-or-file-reference>"
+}
+```
+
+```text
+statehub repo rename apply <operation-id> --phase source-synced \
+  --evidence-file <private-mode-0600-source-evidence.json> \
+  --confirm '<confirmation>' --json
+```
+
+Collect evidence from every owning handoff. The checks file is a JSON object of
+named booleans; false or missing required checks block the phase:
+
+```json
+{
+  "old-and-new-slugs-one-uuid": true,
+  "forge-id-and-head": true,
+  "work-record-relationships": true,
+  "telemetry-relationships": true,
+  "external-handoffs-verified": true,
+  "build-and-deployment-health": true
+}
+```
+
+```text
+statehub repo rename verify <operation-id> --json
+statehub repo rename apply <operation-id> --phase consumers-verified \
+  --checks-file <private-mode-0600-checks.json> \
+  --evidence-file <private-mode-0600-consumer-evidence.json> \
+  --confirm '<confirmation>' --json
+statehub repo rename apply <operation-id> --phase completed \
+  --confirm '<confirmation>' --json
+```
+
+## Read status without source code
+
+At any time run:
+
+```text
+statehub repo rename status <operation-id> --json
+```
+
+Interpret the stable CLI envelope as follows:
+
+| Field | Meaning |
+| --- | --- |
+| `state` | `planned` means resumable/incomplete, `achieved` means completed, `failed` means the last attempt failed, and `rolled-back` is terminal rollback. |
+| `phase` | Last durably achieved phase. An `error_code` does not advance it. |
+| `result.no_op` | The submitted phase was already achieved; operation identity was preserved. |
+| `next_safe_action.action` | Operator action permitted by the recorded phase. |
+| `next_safe_action.command` | Exact credential-free command skeleton for that action. |
+| `result.error_code` | Code from the last failed attempt; inspect it before retrying. |
+| `result.evidence.telemetry` | Phase duration, attempts, retries, failures, rollback, and verification outcome. |
+
+The phase table is the recovery map:
+
+| Achieved phase | What is true | Normal next command |
+| --- | --- | --- |
+| `preflighted` | Journal and immutable baseline exist; Forge may still use old name. | Apply `forge-renamed`. |
+| `forge-renamed` | Forge numeric ID is visible at the new name; State Hub may still be canonical on old slug. | Apply `statehub-rebound`. |
+| `statehub-rebound` | New slug is canonical and old slug is a protected alias on the same UUID. | Fresh clone/register, then apply `source-synced`. |
+| `source-synced` | Canonical clone and source projection are recorded. | Verify owned handoffs; apply `consumers-verified`. |
+| `consumers-verified` | Required checks and handoff evidence passed. | Re-run verify, then apply `completed`. |
+| `completed` | Rename is terminal; aliases/history remain. | Soak, residual handoff, then separately approved cleanup. |
+| `rollback-preflight` | Rollback safety and irreversible effects are recorded. | Review; use `rollback --execute` only if still safe. |
+| `rolled-back` | Old canonical coordinate is restored and the attempt remains auditable. | Verify consumers; a new attempt needs a new operation. |
+
+The REST equivalents are repository-UUID addressed:
+
+| CLI operation | REST operation |
+| --- | --- |
+| preflight | `POST /repos/{repo_id}/rename/preflight` |
+| start | `POST /repos/{repo_id}/rename/operations` |
+| status | `GET /repository-renames/operations/{operation_id}` |
+| apply phase | `POST /repos/{repo_id}/rename/operations/{operation_id}/phases/{phase}` |
+| verify | `GET /repos/{repo_id}/rename/operations/{operation_id}/verify` |
+| rollback preflight | `POST /repos/{repo_id}/rename/operations/{operation_id}/rollback-preflight` |
+| execute rollback | `POST /repos/{repo_id}/rename/operations/{operation_id}/rollback` |
+
+Do not construct mutating REST requests when the CLI can express the operation;
+the CLI supplies confirmation, private-file, redaction, and next-action guards.
+
+## Dashboard interpretation
+
+The dashboard is a read surface, not the rename executor.
+
+- Open `/repos/<old-slug>` after `statehub-rebound`. The amber alias banner must
+  identify `<old-slug>` as an alias and link to `<new-slug>`.
+- Old and new routes must show the same repository UUID. The canonical page must
+  list the protected alias.
+- Review repository dispatch, workplans/tasks, token totals, SBOM, services,
+  capabilities, interface changes, inbox, and stale external-reference notices.
+- A stale Fabric/external projection is a visible handoff, not permission for
+  State Hub to rewrite its source.
+- The dashboard does not currently render the phase journal. Use `statehub repo
+  rename status` and `verify` as the authoritative operational views.
+- A healthy dashboard count is insufficient: final acceptance requires the
+  relationship checksums in `verify`.
+
+## Recovery playbook
+
+Always reuse the same operation UUID. First run `status`; treat `phase` as the
+achieved state and the error as the failed attempt.
+
+| Observation | Action |
+| --- | --- |
+| State Hub unavailable | Stop mutations. Restore central connectivity; then query the operation UUID. Rename phases are not edge-queueable. |
+| Preflight expired or evidence/head changed | Do not start. Resolve drift and issue a fresh preflight; keep or abandon the unused client operation UUID deliberately. |
+| Forge rename committed but journal remains `preflighted` | Retry `forge-renamed`; State Hub recognizes the expected numeric ID at the new coordinate and records a resumed phase. |
+| Forge old-slug lookup redirects to new slug | Treat the redirect as compatibility only. Verify numeric ID at the requested canonical coordinate; never use the redirect as identity evidence. |
+| Journal is `forge-renamed` | Prefer `statehub-rebound`; do not register a new State Hub repository. |
+| Journal is `statehub-rebound` but clone evidence is wrong | Keep both checkouts. Correct the fresh clone/remote/Forge-ID/head evidence and retry `source-synced`. |
+| Consumer check fails | Remain `source-synced` or `consumers-verified`; repair the named owner handoff or enter rollback preflight. Do not complete. |
+| Same phase submitted twice | A matching retry returns `no_op`. A changed operation/target/actor is a conflict, not a retry. |
+| Edge outbox contains old-slug writes | Pause preflight until replayed or explicitly resolved. Alias-aware central handlers preserve idempotency after rebind. |
+| Private Forge repository unreadable | Stop. Restore approved Forge access; never infer identity from a local checkout or redirect. |
+
+## Rollback limits
+
+Rollback is a separately confirmed two-step operation:
+
+```text
+statehub repo rename rollback <operation-id> \
+  --confirm 'rollback:<operation-id>' --json
+# Only after reviewing safe_to_rollback, blockers, and irreversible effects:
+statehub repo rename rollback <operation-id> \
+  --confirm 'rollback:<operation-id>' --execute --json
+```
+
+Rollback is unavailable when the old Forge slug is claimed, the expected Forge
+numeric ID/head is not observable, a competing operation exists, or State Hub
+routes are inconsistent. Never steal/delete a slug to make rollback appear
+safe.
+
+The following are not automatically reversed:
+
+- consumer commits, deployments, package/image publication, releases, or cache
+  propagation;
+- external redirects and links already observed by users/automation;
+- credential-route, policy, DNS, namespace, or product/runtime changes;
+- fabric/SBOM/source projections owned by another repository;
+- the operation journal, lifecycle events, historical messages, aliases, or
+  telemetry evidence.
+
+After `source-synced`, every reversed external effect needs its own owner
+handoff and evidence. If an irreversible effect makes rollback unsafe, continue
+forward or stop for an explicit incident decision.
+
+## Repository-boundary handoff format
+
+Every external slug-bearing source is represented by both:
+
+1. a live file-backed workplan/task or residual intake in the owning repository;
+2. a payload conforming to
+   [`repository-rename-handoff-v1.schema.json`](schemas/repository-rename-handoff-v1.schema.json),
+   attached to or referenced by that work record.
+
+The example is
+[`repository-rename-handoff-v1.json`](examples/repository-rename-handoff-v1.json).
+The `handoff_id` is the live owning task/intake ID—not an informal label. The
+record names the source repository, old/new slug, affected paths or graph IDs,
+re-ingest procedure, verification checks, owning workplan/task, status, and
+non-secret evidence references.
+
+Handoff rules:
+
+- The target repository creates/routes the obligation but does not edit or
+  close another repository's source task.
+- The owner acknowledges it in its own file-first workplan and synchronizes it
+  to State Hub.
+- `verified` requires evidence from the owner. Equal counts, a message saying
+  "done", or an uncommitted local edit are insufficient.
+- Evidence contains commit/check/report/receipt references and optional
+  checksums only. Never include credentials, authorization headers, cookies,
+  private preflight tokens, secret-bearing URLs, or secret values.
+- Unresolved handoffs become live residual records before the target workplan
+  finishes. They are never parked only in this runbook, `SCOPE.md`, or prose.
+
+## Cleanup is deliberately last
+
+The old local checkout is the final removable asset because it is a recovery
+input, a comparison point, and evidence of the pre-cutover source. Removing it
+before terminal verification can strand the operator after an external rename,
+hide unpushed work, and destroy the easiest rollback comparison.
+
+Only remove the old checkout after all of the following:
+
+- operation is `completed` or intentionally `rolled-back`;
+- relationship verification passes;
+- canonical fresh clone is registered against the same State Hub UUID;
+- required owner handoffs are verified or represented as accepted live
+  residuals;
+- the soak window covers deployments, automation, policies, packages, alerts,
+  dashboards, and telemetry;
+- explicit cleanup approval identifies the exact old path and recovery source.
+
+Record what was removed and whether recovery remains possible from Forgejo.
+The protected old slug alias is not cleanup material in this workflow; alias
+retirement requires a separate compatibility decision and operation.
diff --git a/docs/retirement-cutover-slice-plan.md b/docs/retirement-cutover-slice-plan.md
new file mode 100644
index 0000000..092f226
--- /dev/null
+++ b/docs/retirement-cutover-slice-plan.md
@@ -0,0 +1,91 @@
+# State Hub retirement — cutover slice plan
+
+**Execution owner:** STATE-WP-0079-T04/T05
+**Re-baselined:** 2026-09-05
+**Inventory:** SHR-INV-0001, original 425-item inventory in
+`prj-state-hub-retirement/inventory/`. Counts below identify historical slices;
+current owner contracts take precedence over the original owner assignments.
+
+This checklist replaces the obsolete August 19–20 readiness snapshot. That
+snapshot and the original off/dual/owner proposal remain in Git history.
+`RM_SLICE_*` names were proposed controls, not proof of deployed flags. Do not
+execute the old workstation dual-run instructions against the cluster service:
+ADR-002 forbids central services from mutating workstation checkouts.
+
+## Evidence required to switch a slice
+
+For each route family, identify the current caller and destination endpoint,
+compare representative identities/content/counts in a read-only parity run,
+record the exact deployment/source revisions, exercise rollback, and retain the
+switch receipt. An owner workplan marked finished or an imported Python router
+proves neither deployed endpoint availability nor data migration. Production
+writer changes require a concrete recoverable cutover, within user authorization.
+No new permanent receiving authority belongs in State Hub during retirement.
+
+## Current route-family checklist
+
+| Slice / historical items | Receiver and contract evidence | Caller / route-switch evidence | Remaining gate and rollback |
+| --- | --- | --- | --- |
+| A1 registry / 27 | Repo Manager observation/scaffolding; STATE-WP-0081 and 0086 establish forge-derived projection | `rmgr sync` verified pushed commit `74a3b22` on primary/railiance01 in the preceding session | Inventory remaining registry callers per endpoint. Keep current projection while proving the owner read; do not restore checkout mutation in central |
+| A2 work records / 59 | RMGR-WP-0008 implements file-backed workplan, intake, decision, dependency and task mutations; RMGR-WP-0005 identifiers finished | Repository files + `rmgr sync` are the current write convention. Two ad-hoc task-filter callers identified and guidance corrected in this review | Work-record caller inventory and per-kind writer receipts still required. Revert source commit and reconcile for a reviewed rollback; no second file authority |
+| A3 registers / 49 | RMGR-WP-0008 register spine; **SBOM Nexus** is the current SBOM product owner | Live State Hub config uses Nexus for both SBOM reads/writes. Direct Nexus licence and snapshot reads return 200. Two more compatibility interfaces retired in the meter September 5 | Other registers need individual caller/parity receipts. Preserve SBOM history; remaining `/sbom/` traffic and retained compatibility handlers prevent deleting the whole router |
+| A4 work/repo UI / 22 | hub-core projection + UI clients; RMGR-ADR-003 excludes a Repo Manager dashboard | No complete State Hub UI redirect receipt established | First prove backing reads; rollback redirects to the retained UI |
+| A5 topic spine / 8 | Published Repo Manager classification contract, accepted by HUB-WP-0004 | No complete State Hub caller-switch receipt established | Prove deployed consumer contract and parity; retain source-backed classification projection |
+| B1 catalogs / 34 | HUB-WP-0004/0005 receiving architecture and `/api/v2` absorption | Completion covers the Core Hub route groups, not every State Hub capability/registry route | Map each State Hub catalog to a deployed endpoint and migration receipt |
+| B2 messaging/interface log / 22 | Native `/ports/messaging/messages` uses a distinct envelope; new authenticated `/ports/projections/statehub-inbox` preserves bounded State Hub history | T08 complete: 20-row import, six parity cases, private transport and disable/re-enable proof; no production reader switched | T09 / HUB-WP-0011: freshness, caller credentials and aliases before one reader switch. Interface log and writer cutover remain separate |
+| B3 telemetry / 32 | Native `/ports/events/progress` exists; token/software catalogs need separate mappings | Literal `/progress` and `/token-events` absence does not imply no native receiving contract | Map native semantics and historical identity/count parity; writer exclusivity and rollback receipts remain necessary |
+| B4 projection/policy / 20 | HUB-WP-0004/0005; policy publication belongs to policy-nexus | State Hub still serves its projection routes; no full family receipt established | Map individual projections and policy publication; retain source/runtime boundaries and current reads |
+| B5 hub UI / 17 | Hub Core runtime/console exists | Core Hub absorption does not establish replacement of State Hub dashboard pages | Prove A4/B1–B4 data contracts before redirect; retain UI rollback |
+| C1 execution / 13 | ACTIVITY-WP-0029 finished; Activity Core owns scheduling/ops_run | STATE-WP-0079 records launch-request rejection (410), replacement semantics, and corrected unconsumed requests | Verify every remaining execution caller uses the owner contract. Do not revive the obsolete launch queue for rollback |
+| C2 jobs / 5 | ACTIVITY-WP-0029 finished; scheduler is Activity Core, reconciliation engine is Repo Manager | Receiving/sweep handoffs recorded in owner workplan | Attach remaining per-job deployment and caller receipts; keep scheduler ownership distinct from work-record authority |
+| D1 service catalog / 11 | OPS-WP-0003 finished; reviewed packages and `/api/v2` conformance gate | Owner contract completion established; State Hub family-switch receipt still missing | Compare catalog identities and UI bindings; preserve current reads until switched |
+| D2 Fabric / 10 | **railiance-fabric** authority, FIN-WP-0003 consumer gate | August 31 dual-read import: 131 nodes/117 edges; green hash/count/provenance checks, rollback and roll-forward exercised | Hosted runtime/persistence/auth/freshness remains RAIL-FAB-WP-0028 (`proposed`). Keep retained import rollback; do not claim the local authority is a hosted production receiver |
+| D3 kaizen / 2 | the-custodian, original two-tool disposition | No fresh removal/delegation receipt collected in this review | Locate current tools/consumers and owner contract before removal |
+| E1 suggestions / 17 | Archived history in the-custodian | STATE-WP-0079 records eight read routes at 410, six MCP tools removed, dashboard removed | Completed surface removal; tables retained for final dump |
+| E2 legacy workplans / 13 | Preferred `/workplans` routes and `workplan_id` parameters | Workstream REST handlers return 410 and meter rejected calls. Task query alias still accepted | Seven legacy meter records remain after today's two SBOM retirements; observe volume-scaled quiet periods and complete T07 attribution |
+| E3 UI feedback / 1 | State Hub until cutover | Feedback still needed during transition | T06 zero-normal-traffic gate; do not confuse it with retired suggestions |
+| E4 meter / 9 | State Hub until all other retirement evidence complete | Eight retired / seven legacy interfaces, zero current candidates after September 5 action | Retire last, after the remaining interfaces and final evidence are closed |
+
+## What today's probes establish
+
+- Central health identifies `primary/railiance01`.
+- The live State Hub configuration has `SBOM_NEXUS_READ_MODE=nexus` and
+  `SBOM_NEXUS_WRITE_MODE=nexus`, using the cluster SBOM Nexus service.
+- Direct Nexus `/sbom/report/licences/` and `/sbom/snapshots/` returned 200 from
+  the State Hub pod. Their State Hub meter entries are now retired. This does
+  **not** delete the compatibility handlers or historical data.
+- The earlier literal-prefix probe missed existing native messaging, event and
+  projection ports. The bounded inbox projection now has live parity evidence.
+  Scoped NetworkPolicy admission resolved State Hub-to-candidate transport;
+  unauthenticated requests from the source pod now reach the 401 boundary.
+- Session trace identifies ad-hoc legacy task reads in fluid-telegram and
+  ops-warden. Their corrected canonical queries return 200 with 8 and 5 tasks.
+  No evidence identifies the other historical callers yet.
+
+Evidence: `docs/evidence/STATE-WP-0079-sbom-retirement-20260905.json` and
+`docs/evidence/STATE-WP-0079-caller-and-receiver-review-20260905.md`.
+
+## Next executable work
+
+1. T07: observe the remaining legacy readers with component attribution. The
+   known caller repositories and bundled State Hub skill now prescribe canonical
+   reads. Preserve the quiet clocks; do not exercise legacy URLs to test them.
+2. T09 / HUB-WP-0011: establish monotonic freshness and stale-source behavior,
+   caller-specific credentials and canonical/alias scope before one production
+   inbox reader switch. T08's frozen snapshot parity and rollback are complete;
+   see `docs/evidence/statehub-inbox-pilot-20260905.md` and JSON receipt.
+3. RAIL-FAB-WP-0028-T01 remains the owner decision for runtime, persistent store,
+   auth, backup/restore and deployment repository. Its T02–T04 deliver deployment,
+   freshness and final direct-consumer receipts; no new Fabric authority here.
+4. Re-evaluate eligible interfaces from a fresh seven-day meter capture. The
+   quiet ladder is 7 days for 1–99 historical calls, 30 for 100–9,999, and 60 for
+   10,000+. A new call restarts the relevant clock, including rejected requests.
+
+## Freeze and infrastructure boundary
+
+T06 remains blocked until move/replace families and legacy retirement complete,
+followed by a fresh zero-normal-read/write window. Final dump, restore proof,
+service stop and repository archive then form one separately reviewable
+operation. The original schema-history/keep items and nine infrastructure
+couplings (database, scheduler, connectivity) remain explicit final-window
+checks; they are not route flags. Ops Bridge connectivity survives retirement.
diff --git a/docs/review-contracts-v1.md b/docs/review-contracts-v1.md
new file mode 100644
index 0000000..b87aa6f
--- /dev/null
+++ b/docs/review-contracts-v1.md
@@ -0,0 +1,77 @@
+# Review contracts and receipts v1
+
+State Hub exposes a replaceable projection of repository-authoritative review
+contracts and immutable receipt files. This is coordination evidence, not an
+authorization system: a satisfied aggregate always says that it does not
+authorize execution.
+
+## Ownership and extraction boundary
+
+- The contract-owning repository owns the contract file and its full Git
+  revision.
+- Each reviewing repository owns its receipt file and full Git revision.
+- State Hub validates, indexes, derives owner/gate state, and can be rebuilt
+  from those files. Agent messages may link to record IDs but are not receipt
+  storage.
+- State Hub never executes a check named by a consumer. Receipt producers run
+  their own closed, read-only check interfaces and submit only their results.
+- Actor strings are coordination identities in v1, not authenticated proof.
+  Authenticated actor-to-owner delegation belongs in the extracted hub-core
+  service.
+
+All timestamps stored or emitted by State Hub are canonical UTC. Local calendar
+and time rendering is an I/O or UI concern.
+
+## Contract
+
+POST /review-contracts/projections accepts a wrapper containing:
+
+- source: repository, relative path, and a full Git revision;
+- optional decision, workplan, and task UUID links;
+- required_for_decision, which makes a linked decision wait for the gate;
+- contract: a review-contract/v1 document.
+
+The contract document has a stable contract key, typed subject, the two allowed
+dispositions approve and request_changes, SHA-256 artifacts, owner scopes with
+stable assertion and named check IDs, and gates. Version 1 supports only the
+all_required gate policy.
+
+Projecting a new digest under the same contract key makes the prior revision
+inactive. Its receipts remain immutable and are reported as stale until the
+owner submits evidence against the active digest. The bounded
+railiance.owner-review version 1 adapter derives stable assertion IDs and
+preserves that prototype's canonical source digest.
+
+## Receipt
+
+POST /review-contracts/{contract_key}/receipts accepts an authoritative receipt
+document. An approval must exactly cover the owner's artifacts, assertion IDs,
+and named checks. Every check must say both passed true and read_only true.
+request_changes requires a note and becomes the owner's latest blocking
+disposition. Reposting byte-equivalent evidence is idempotent.
+
+The service assigns submitted_at in UTC and a SHA-256 receipt digest. Receipts
+cannot be patched or deleted through this API.
+
+Direct client examples:
+
+    statehub review project interfaces/review.json
+    statehub review submit EXAMPLE-REVIEW-1 receipt.json
+    statehub review status EXAMPLE-REVIEW-1
+
+The CLI derives the repository-relative path and full current Git revision, so
+those projection fields do not need to be embedded in the authoritative file.
+Use --source-repo only when the repository directory name is not its canonical
+slug.
+
+If an active contract is linked to a decision with required_for_decision true,
+the legacy decision resolve action returns 409 until every v1 all_required gate
+is satisfied. Decisions without such a contract retain their existing
+behavior.
+
+## Rollback and rebuild
+
+The Alembic downgrade drops only the two projection tables. It does not rewrite
+or delete existing decisions. Rebuild by replaying contract projection files
+in revision order, then their receipt files. Repository files remain the
+recovery source throughout.
diff --git a/docs/schemas/repository-rename-handoff-v1.schema.json b/docs/schemas/repository-rename-handoff-v1.schema.json
new file mode 100644
index 0000000..f99d63c
--- /dev/null
+++ b/docs/schemas/repository-rename-handoff-v1.schema.json
@@ -0,0 +1,160 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "$id": "https://state-hub.coulomb.social/schemas/repository-rename-handoff-v1.schema.json",
+  "title": "State Hub repository rename handoff v1",
+  "type": "object",
+  "additionalProperties": false,
+  "required": [
+    "schema_version",
+    "handoff_id",
+    "operation_id",
+    "renamed_repository_id",
+    "source_repository",
+    "old_slug",
+    "new_slug",
+    "surface",
+    "affected",
+    "required_reingest",
+    "verification",
+    "owning_work_record",
+    "status",
+    "evidence",
+    "sensitive_data_prohibited"
+  ],
+  "properties": {
+    "schema_version": {
+      "const": "state-hub.repository-rename-handoff.v1"
+    },
+    "handoff_id": {
+      "type": "string",
+      "minLength": 1,
+      "description": "Canonical live task or intake record ID in the owning repository."
+    },
+    "operation_id": {
+      "type": "string",
+      "format": "uuid"
+    },
+    "renamed_repository_id": {
+      "type": "string",
+      "format": "uuid"
+    },
+    "source_repository": {
+      "type": "string",
+      "pattern": "^[a-z0-9][a-z0-9-]*$",
+      "description": "Repository that owns the slug-bearing source to change or re-ingest."
+    },
+    "old_slug": {
+      "type": "string",
+      "pattern": "^[a-z0-9][a-z0-9-]*$"
+    },
+    "new_slug": {
+      "type": "string",
+      "pattern": "^[a-z0-9][a-z0-9-]*$"
+    },
+    "surface": {
+      "enum": [
+        "fabric-projection",
+        "ci",
+        "package",
+        "deployment",
+        "credential-route",
+        "policy",
+        "sbom",
+        "documentation",
+        "consumer",
+        "other"
+      ]
+    },
+    "affected": {
+      "type": "object",
+      "additionalProperties": false,
+      "required": ["paths", "graph_ids"],
+      "properties": {
+        "paths": {
+          "type": "array",
+          "items": {"type": "string", "minLength": 1},
+          "uniqueItems": true
+        },
+        "graph_ids": {
+          "type": "array",
+          "items": {"type": "string", "minLength": 1},
+          "uniqueItems": true
+        }
+      },
+      "anyOf": [
+        {"properties": {"paths": {"minItems": 1}}},
+        {"properties": {"graph_ids": {"minItems": 1}}}
+      ]
+    },
+    "required_reingest": {
+      "type": "object",
+      "additionalProperties": false,
+      "required": ["required", "procedure"],
+      "properties": {
+        "required": {"type": "boolean"},
+        "procedure": {"type": "string", "minLength": 1},
+        "expected_source_revision": {"type": ["string", "null"]}
+      }
+    },
+    "verification": {
+      "type": "array",
+      "minItems": 1,
+      "items": {
+        "type": "object",
+        "additionalProperties": false,
+        "required": ["check", "expected", "evidence_ref"],
+        "properties": {
+          "check": {"type": "string", "minLength": 1},
+          "expected": {"type": "string", "minLength": 1},
+          "evidence_ref": {"type": ["string", "null"]}
+        }
+      }
+    },
+    "owning_work_record": {
+      "type": "object",
+      "additionalProperties": false,
+      "required": ["repository", "workplan_id", "task_id"],
+      "properties": {
+        "repository": {
+          "type": "string",
+          "pattern": "^[a-z0-9][a-z0-9-]*$"
+        },
+        "workplan_id": {"type": "string", "minLength": 1},
+        "task_id": {"type": "string", "minLength": 1}
+      }
+    },
+    "status": {
+      "enum": ["open", "acknowledged", "verified", "cancelled"]
+    },
+    "evidence": {
+      "type": "array",
+      "items": {
+        "type": "object",
+        "additionalProperties": false,
+        "required": ["kind", "ref"],
+        "properties": {
+          "kind": {
+            "enum": [
+              "commit",
+              "progress-event",
+              "decision",
+              "test-report",
+              "deployment-observation",
+              "reingest-receipt",
+              "other"
+            ]
+          },
+          "ref": {"type": "string", "minLength": 1},
+          "checksum": {
+            "type": ["string", "null"],
+            "pattern": "^[a-fA-F0-9]{64}$"
+          }
+        }
+      }
+    },
+    "sensitive_data_prohibited": {
+      "const": true,
+      "description": "Evidence contains references and checksums only, never credentials or secret values."
+    }
+  }
+}
diff --git a/docs/sealed-prederivation-projection-repair.md b/docs/sealed-prederivation-projection-repair.md
new file mode 100644
index 0000000..85a140a
--- /dev/null
+++ b/docs/sealed-prederivation-projection-repair.md
@@ -0,0 +1,45 @@
+# Sealed pre-derivation projection repair
+
+This temporary compatibility surface supports the deterministic-identifier
+cutover in `STATE-WP-0079-T04`. It restores one exact random-UUID workplan unit
+into a partial State Hub projection so the existing transactional migration can
+replace the old UUIDs with their deterministic UUIDv5 targets.
+
+Ordinary `statehub fix-consistency` behavior is unchanged: a missing random UUID
+remains a non-fixable C-03 stale reference.
+
+## Endpoint
+
+`POST /identifier-migrations/sealed-projection-repairs`
+
+The request must contain:
+
+- the complete sealed Repo Manager migration plan;
+- the exact plan SHA-256, repository slug, pinned 40-character Git revision,
+  and source fingerprint recorded in that plan;
+- `source_clean`, `source_synchronized`, and `primary_confirmed` set to true;
+- one explicit authoritative workplan projection and every `replace` task
+  mapped to the same sealed workplan file; and
+- a non-secret projection identity for the receipt.
+
+The workplan projection supplies its canonical `record_id`, exact old UUID,
+topic UUID, projection slug, title, status, and optional projection fields.
+Each task supplies its canonical `record_id`, exact old UUID, title, state, and
+optional projection fields. Parentage uses `parent_record_id`, never a path- or
+position-derived identity.
+
+The server rejects source drift, plan-seal drift, repository/topic mismatch,
+partial old-row presence, any derived-target presence, alias conflicts, slug
+conflicts, incomplete task units, and non-identical retries. The workplan and
+tasks are created in one database transaction. An exact retry returns a
+`verified_noop` receipt.
+
+The receipt contains no source content or secrets: repository/projection
+identity, canonical IDs and old UUIDs, plan/source seals, outcome, and a UTC
+observation timestamp.
+
+## Removal condition
+
+Remove this endpoint with the identifier-migration executor after every sealed
+pre-derivation unit has either completed deterministic cutover or been rejected
+and residual-owned. It is not a general projection-import API.
diff --git a/docs/work-record-flavor.md b/docs/work-record-flavor.md
new file mode 100644
index 0000000..93f255f
--- /dev/null
+++ b/docs/work-record-flavor.md
@@ -0,0 +1,57 @@
+# Work-record flavor and residual default-exclusion
+
+Status: active (STATE-WP-0092)  
+Canon: `the-custodian/canon/standards/work-record-types_v0.1.md` § Flavor
+
+## Rule
+
+Workplans and tasks carry an optional **flavor** bucket:
+
+`planning` | `implementation` | `refactoring` | `extension` | `residual`
+
+Flavor is not a kind and not a status. Unset flavor is **not** residual.
+
+`flavor: residual` means leftover work that is **not** as valuable as the
+main functional and non-functional requirements. Default State Hub views of
+open work **omit** residuals. Agents must not pick residual workplans or
+residual tasks for implementation unless the flavor has been promoted.
+
+Promotion is a file edit:
+
+```yaml
+flavor: implementation          # or planning | refactoring | extension
+flavor_promoted_from: residual
+flavor_promotion_reason: demand # or risk
+```
+
+Then `statehub fix-consistency`. After promotion the record re-enters the
+default view.
+
+`origin: residual` on intakes remains provenance. It does not hide a
+workplan; `flavor` does.
+
+## `depends_on`
+
+Workplan frontmatter `depends_on` is the canonical list of blocker
+**workplan ids**. C-20 indexes it (legacy alias: `depends_on_workplans`).
+Do not use `depends_on_workplans` on new files.
+
+## API
+
+| Surface | Default | Residual access |
+| --- | --- | --- |
+| `GET /workplans/` | includes residuals (full index) | `?flavor=residual` or `?include_residuals=false` to hide |
+| `GET /state/summary` `open_workplans` | omits residuals | `?include_residuals=true` fills `residual_open_workplans`; `totals.workstreams.residual_open` is always the count |
+| `GET /state/next_steps` | never recommends residual work | — |
+| `GET /state/deps` | omits residuals | `?include_residuals=true` |
+
+Unknown flavor values fail closed on write (HTTP 422). Consistency check
+C-36 warns; it does not invent a flavor for historic files.
+
+## Fleet follow-on
+
+- Backfill existing files: `CUST-WP-0072`
+- Fabric graph: `RAIL-FAB-WP-0030`
+- Cross-owner waits: `COORDINATION-WP-0005`
+
+Do not message `ops-warden` for secrets; see credential routing.
diff --git a/docs/work-record-quality-gates.md b/docs/work-record-quality-gates.md
new file mode 100644
index 0000000..addefd6
--- /dev/null
+++ b/docs/work-record-quality-gates.md
@@ -0,0 +1,213 @@
+# Work-record quality gates (Definition family)
+
+Status: active convention (STATE-WP-0076 policies; STATE-WP-0077 recording + soft visibility)  
+Related: `dashboard/src/docs/work-records.md`, `policies/intake-doc.md`,
+`policies/work-item-dor.md`, `policies/workstream-dod.md`,
+`policies/repo-doi.md`, `policies/service-dom.md`,
+`policies/retirement-freeze.md`
+
+## Purpose
+
+Define how **Definition-of-X** policies relate to work records without merging
+quality into lifecycle status and without a freeform badge product.
+
+## Definition family
+
+| Policy | Key (API `/policy/<key>`) | Rates | Applies to |
+|--------|---------------------------|-------|------------|
+| **DoI** — Definition of Integrated | `repo-doi` | Repo integration maturity (tiered) | managed repos |
+| **DoM** — Definition of Mature | `service-dom` | Service operability/maturity (leveled) | long-running services |
+| **DoC** — Definition of Comprehension | `intake-doc` | Discovery quality | **`intake`** only |
+| **DoR** — Definition of Ready | `work-item-dor` | Implementation-readiness | **`task`**, **`workplan`** (per-kind sections) |
+| **DoD** — Definition of Done | `workstream-dod` | Completion quality | **workplan** (filename legacy; title is Workplan DoD) |
+
+DoI/DoM rate **assets** (repo/service). DoC/DoR/DoD rate **work-record quality**
+at discovery / ready / done. Do not mix the axes.
+
+## Lifecycle vs assessment
+
+| Axis | Field / surface | Meaning |
+|------|-----------------|--------|
+| Lifecycle | kind-specific `status` | Process position (e.g. workplan `ready`, intake `vetted`) |
+| Definition assessment | convention / prose (later optional storage) | Whether a named policy was satisfied when last assessed |
+
+These are independent:
+
+- `status=ready` is a process claim; **DoR-Ok** means the DoR checklist passed.
+- `status=finished` is a process claim; **DoD-Ok** means the DoD checklist passed.
+- Counting finished workplans without DoD-Ok is a valid quality metric, not an error.
+
+## Badge spelling (closed)
+
+For each Definition policy that applies to a record:
+
+| Outcome | Spelling | Meaning |
+|---------|----------|---------|
+| Not assessed | **unassessed** (or absent) | No assessment recorded |
+| Passed | **`DoC-Ok`**, **`DoR-Ok`**, **`DoD-Ok`** | Last assessment passed |
+| Failed | **`DoC-Failed`**, **`DoR-Failed`**, **`DoD-Failed`** | Assessment ran and failed |
+| Tiered (DoI/DoM) | **`DoM-Ok-1`**, **`DoI-Ok-2`**, … | Level/tier met; **`DoM-Failed`** if assessed and short |
+
+No open-ended custom badges. New badge families require a new Definition policy
+in `policies/`.
+
+## Recording assessments (STATE-WP-0077)
+
+Canonical storage is **file fields** (preferred) plus optional **progress
+events**. No badge DB table.
+
+### Field names
+
+| Policy | Field | Values |
+|--------|-------|--------|
+| DoC | `quality_doc` | `DoC-Ok` \| `DoC-Failed` (or bare `Ok` / `Failed`) |
+| DoR | `quality_dor` | `DoR-Ok` \| `DoR-Failed` (or bare `Ok` / `Failed`) |
+| DoD | `quality_dod` | `DoD-Ok` \| `DoD-Failed` (or bare `Ok` / `Failed`) |
+
+Optional companions (same prefix): `quality_*_at` (ISO date), `quality_*_by`,
+`quality_*_note`.
+
+### Workplan frontmatter example (DoR + later DoD)
+
+```yaml
+---
+id: STATE-WP-0077
+status: ready
+quality_dor: DoR-Ok
+quality_dor_at: "2026-07-22"
+quality_dor_by: "grok"
+# quality_dod: DoD-Ok   # when finishing with quality complete
+---
+```
+
+### Task block example (DoR)
+
+````markdown
+```task
+id: STATE-WP-0077-T01
+status: todo
+priority: high
+quality_dor: DoR-Ok
+quality_dor_at: "2026-07-22"
+quality_dor_by: "grok"
+```
+````
+
+### Intake YAML example (DoC)
+
+Use a real `{PREFIX}-IN-NNNN` id only in the owning repo file — not in docs
+(examples with live id patterns get registered by fix-consistency). Field shape:
+
+```text
+id: <PREFIX>-IN-NNNN
+status: routed
+quality_doc: DoC-Ok
+quality_doc_at: "YYYY-MM-DD"
+quality_doc_by: "agent-or-human"
+quality_doc_note: "optional"
+```
+
+Hub-only intakes (no file yet): add a note whose body includes `DoC-Ok` or
+`quality_doc: DoC-Ok`, and/or post a progress event (below).
+
+### Progress event (optional audit)
+
+```bash
+curl -s -X POST http://127.0.0.1:8000/progress/ \
+  -H "Content-Type: application/json" \
+  -d '{
+    "event_type": "quality_assessment",
+    "summary": "DoR-Ok for workplan STATE-WP-0077",
+    "author": "grok",
+    "topic_id": "<uuid>",
+    "workplan_id": "<uuid>",
+    "detail": {
+      "policy": "DoR",
+      "outcome": "Ok",
+      "badge": "DoR-Ok",
+      "record_kind": "workplan",
+      "record_id": "STATE-WP-0077",
+      "assessed_by": "grok",
+      "note": null
+    }
+  }'
+```
+
+Helpers: `scripts/quality_assessment.py` (`badge()`, `progress_event_body()`).
+
+## Soft visibility
+
+```bash
+statehub quality-debt                  # cwd repo + hub intakes
+statehub quality-debt --json --no-hub
+python scripts/quality_debt.py --here
+```
+
+Reports:
+
+- workplans `status=ready` without `quality_dor` DoR-Ok  
+- workplans `status=finished` without `quality_dod` DoD-Ok  
+- file intakes `vetted`/`routed` without `quality_doc` DoC-Ok  
+- hub intakes `vetted`/`routed` without DoC-Ok in notes  
+
+`fix-consistency` soft warns **C-34** (ready without DoR-Ok). Finished
+plans without DoD-Ok appear in `quality-debt` only (not C-warns), so historical
+finished workplans do not flood every consistency run. Never fixable
+auto-write; never FAIL.
+
+## Unit vs structure (reminder)
+
+| Role | Kinds | Quality gates of interest |
+|------|-------|---------------------------|
+| Unit | task, intake, decision, … | DoC (intake); DoR (task); others later |
+| Structure | workplan | DoR (plan-level); DoD (completion) |
+
+Workplan is a work record mechanically; it is not a “large task.”
+
+## Outside-originated profile
+
+When signal or work originates outside structural knowledge of the owning repo
+(external demand, true third-party, sparse founder/mail signal), use the
+**Outside-originated** sections in DoC and DoR. Detection is by fields/tags such
+as `origin`, `origin_ref`, `third-party`, `external-demand` — not by inventing a
+new kind.
+
+Pipeline (unenforceable mental model):
+
+```text
+outside / sparse signal
+  → intake
+  → DoC assessment (DoC-Ok before confident route/promote)
+  → task / workplan
+  → DoR assessment (DoR-Ok before confident implementation)
+  → work
+  → DoD assessment (DoD-Ok when claiming quality-complete)
+```
+
+## Enforcement level (STATE-WP-0077)
+
+| Mechanism | Behaviour |
+|-----------|-----------|
+| Convention + this doc | Primary |
+| `statehub quality-debt` | Read-only debt list |
+| C-34 | Soft WARN in fix-consistency (ready without DoR-Ok) |
+| `promote-intake` | Soft WARNING on stderr if no DoC-Ok; **still promotes** |
+| Hard API / status blocks | **None** |
+
+Task-flow assertions must implement policy, not replace it.
+
+## Non-goals
+
+- Freeform badge product
+- Renaming kinds (intake→find, task→item)
+- DiscoveryMap as a kind
+- Enforced value-chain typing (exp→def→…→evo)
+- Contribution retirement (separate)
+
+## Dashboard
+
+- [Intake DoC](/policy/intake-doc)
+- [Work-item DoR](/policy/work-item-dor)
+- [Workplan DoD](/policy/workstream-dod)
+- [Repository DoI](/policy/repo-doi)
+- [Service DoM](/policy/service-dom)
diff --git a/docs/workplan-convention.md b/docs/workplan-convention.md
index 95b6584..6c763ac 100644
--- a/docs/workplan-convention.md
+++ b/docs/workplan-convention.md
@@ -17,8 +17,15 @@ repo: state-hub
 status: proposed
 owner: custodian
 topic_slug: custodian
+flavor: planning
+depends_on: []
 ```
 
+`flavor` is `planning` | `implementation` | `refactoring` | `extension` |
+`residual`. Unset is not residual. Default State Hub open views omit
+`flavor: residual` until demand or risk promotes it (STATE-WP-0092).
+`depends_on` lists blocker workplan ids; C-20 indexes that field.
+
 During extraction, legacy `CUST-WP-*` plans may be bridged or migrated with
 their existing `state_hub_workstream_id` values. Write files first, then run
 State Hub consistency sync after this repo is registered.
@@ -44,3 +51,16 @@ Use `proposed` for a new plan that still needs review, `ready` after it has
 been checked against the current repo state, and `finished` when implementation
 is complete. `stalled` and `needs_review` are derived health labels, not stored
 frontmatter statuses.
+
+### Residuals when finishing
+
+If work remains after a plan is complete, **do not** leave it only as prose or
+in `SCOPE.md`. Before `status: finished`, hand off each actionable residual as
+a live work record:
+
+- parkable Green/Blue → **intake** with `origin: residual`, `origin_ref: <WP-id>`
+- multi-step → **new workplan** (optional promote from residual intake)
+- founder gate/time → **decision** / **engagement**
+
+Canon: `the-custodian/canon/standards/work-record-types_v0.1.md` § Residuals.
+Hub index/list: State Hub (not domain-local residual files).
diff --git a/mcp_server/TOOLS.md b/mcp_server/TOOLS.md
index 7113c80..5875faf 100644
--- a/mcp_server/TOOLS.md
+++ b/mcp_server/TOOLS.md
@@ -12,8 +12,12 @@ Sanctioned writes (cross-cutting coordination — not bootstrap-only):
 | Use Case | Tools |
 |---|---|
 | **Resolving Decisions** | `resolve_decision()` |
-| **Next Steps + demand signals** | `get_next_steps()` — derived steps; bumps relevance on surfaced open suggestions |
-| **Suggestion backlog** | `create_suggestion()`, `vet_suggestion()`, `decline_suggestion()`, `promote_suggestion_to_task()`, `bump_suggestion_relevance()` |
+| **Next Steps + demand signals** | `get_next_steps()` — derived steps (open **suggestion** signals still come from the legacy table when any remain open) |
+| **Intake (work-record kind)** | `create_intake()`, `list_intakes()`, `route_intake()`, `close_intake()` — sparks/findings; promote with `statehub promote-intake` / `scripts/promote_intake.py`. **Residuals** from finished workplans are intakes (or child WPs) with `origin: residual` + `origin_ref: <WP-id>` — not a separate kind; see work-record-types § Residuals |
+| **Suggestion backlog (legacy)** | `create_suggestion()`, `vet_suggestion()`, `decline_suggestion()`, `promote_suggestion_to_task()`, `bump_suggestion_relevance()` — **retired (HTTP 410)**; use intake tools |
+
+Work-record umbrella (kinds, ids, lifecycles): fleet canon
+`work-record-types_v0.1.md`; dashboard reference `/docs/work-records`.
 
 All other mutate tools are **bootstrap-only**: use them during First Session Protocol
 to give a freshly-registered project its initial workplan structure.
diff --git a/mcp_server/codex_server.py b/mcp_server/codex_server.py
new file mode 100644
index 0000000..ce2883f
--- /dev/null
+++ b/mcp_server/codex_server.py
@@ -0,0 +1,123 @@
+"""Small State Hub MCP surface for Codex repository sessions.
+
+The full dev-hub MCP server intentionally exposes administrative and catalog
+operations. Codex repository work needs a much smaller coordination surface;
+keeping it separate reduces tool discovery cost and makes the contract clear.
+"""
+
+from __future__ import annotations
+
+import json
+import os
+from typing import Any
+
+import httpx
+from fastmcp import FastMCP
+
+from mcp_server.server import get_domain_summary as _full_get_domain_summary
+
+
+API_BASE = os.environ.get("API_BASE", "http://127.0.0.1:8000").rstrip("/")
+
+mcp = FastMCP(
+    name="dev-hub-codex",
+    instructions=(
+        "Slim State Hub coordination surface for Codex repository sessions. "
+        "Start with get_domain_summary, check the repository inbox, and record "
+        "progress when work closes. Workplan files remain the source of truth."
+    ),
+)
+
+
+def _request(method: str, path: str, body: dict[str, Any] | None = None) -> Any:
+    with httpx.Client(
+        base_url=API_BASE,
+        timeout=15.0,
+        follow_redirects=True,
+        trust_env=False,
+    ) as client:
+        response = client.request(method, path, json=body)
+        response.raise_for_status()
+        return response.json()
+
+
+def _json(value: Any) -> str:
+    return json.dumps(value, indent=2)
+
+
+@mcp.tool()
+def get_domain_summary(domain_slug: str) -> str:
+    """Return actionable State Hub orientation scoped to one domain."""
+    return _full_get_domain_summary(domain_slug)
+
+
+@mcp.tool()
+def get_messages(to_agent: str, unread_only: bool = True) -> str:
+    """Get coordination messages for one repository agent."""
+    suffix = "true" if unread_only else "false"
+    return _json(_request("GET", f"/messages/?to_agent={to_agent}&unread_only={suffix}"))
+
+
+@mcp.tool()
+def mark_message_read(message_id: str) -> str:
+    """Mark one coordination message as read."""
+    return _json(_request("PATCH", f"/messages/{message_id}/read", {}))
+
+
+@mcp.tool()
+def add_progress_event(
+    summary: str,
+    author: str = "codex",
+    workplan_id: str | None = None,
+    task_id: str | None = None,
+) -> str:
+    """Record a State Hub progress note for completed or significant work."""
+    body: dict[str, Any] = {
+        "summary": summary,
+        "event_type": "note",
+        "author": author,
+    }
+    if workplan_id:
+        body["workplan_id"] = workplan_id
+    if task_id:
+        body["task_id"] = task_id
+    return _json(_request("POST", "/progress/", body))
+
+
+@mcp.tool()
+def record_decision(
+    title: str,
+    description: str,
+    topic_id: str,
+    proposed_by: str = "codex",
+    workplan_id: str | None = None,
+) -> str:
+    """Record a pending decision linked to a topic and optionally a workplan."""
+    body: dict[str, Any] = {
+        "title": title,
+        "description": description,
+        "topic_id": topic_id,
+        "decision_type": "pending",
+        "status": "open",
+        "proposed_by": proposed_by,
+    }
+    if workplan_id:
+        body["workplan_id"] = workplan_id
+    return _json(_request("POST", "/decisions/", body))
+
+
+@mcp.tool()
+def update_task_status(
+    task_id: str,
+    status: str,
+    blocking_reason: str | None = None,
+) -> str:
+    """Update a task to wait, todo, progress, done, or cancel."""
+    body: dict[str, Any] = {"status": status}
+    if blocking_reason is not None:
+        body["blocking_reason"] = blocking_reason
+    return _json(_request("PATCH", f"/tasks/{task_id}", body))
+
+
+if __name__ == "__main__":
+    mcp.run(transport="stdio")
diff --git a/mcp_server/server.py b/mcp_server/server.py
index e85416a..51469c2 100644
--- a/mcp_server/server.py
+++ b/mcp_server/server.py
@@ -57,7 +57,12 @@ HubCoreMCPServer(
 # ---------------------------------------------------------------------------
 
 def _client() -> httpx.Client:
-    return httpx.Client(base_url=API_BASE, timeout=30.0, follow_redirects=True)
+    return httpx.Client(
+        base_url=API_BASE,
+        timeout=30.0,
+        follow_redirects=True,
+        trust_env=False,
+    )
 
 
 def _get(path: str, params: dict | None = None) -> Any:
@@ -268,6 +273,11 @@ def get_domain_summary(domain_slug: str) -> str:
     blocking = _get("/decisions", {"decision_type": "pending", "topic_id": topic_id})
     recent = _get("/progress", {"topic_id": topic_id, "limit": 5})
     repos = _get("/repos", {"domain": domain_slug})
+    active_goals = _get("/repo-goals", {"status": "active"})
+    goals_by_repo: dict[str, list[dict]] = {}
+    for goal in active_goals:
+        repo_key = str(goal.get("repo_id") or goal.get("repo_slug") or "")
+        goals_by_repo.setdefault(repo_key, []).append(goal)
 
     # ── Goal guidance ──────────────────────────────────────────────────────────
     # Fetch active repo goals per repo, then cross-reference with workstreams.
@@ -289,12 +299,12 @@ def get_domain_summary(domain_slug: str) -> str:
     for repo in repos:
         repo_slug = repo["slug"]
         repo_id   = repo["id"]
-        active_goals = _get("/repo-goals", {"repo_slug": repo_slug, "status": "active"})
-        if not active_goals:
+        repo_goals = goals_by_repo.get(str(repo_id), goals_by_repo.get(repo_slug, []))
+        if not repo_goals:
             continue
-        active_goal_ids = {g["id"] for g in active_goals}
+        active_goal_ids = {g["id"] for g in repo_goals}
 
-        for goal in active_goals:
+        for goal in repo_goals:
             linked = ws_by_repo_goal.get(goal["id"], [])
             if not linked:
                 needs_workplan.append({
@@ -324,7 +334,7 @@ def get_domain_summary(domain_slug: str) -> str:
                 "recent_workplan_title": recent_ws["title"],
                 "recent_workstream_id": recent_ws["id"],
                 "recent_workstream_title": recent_ws["title"],
-                "active_goal_titles": [g["title"] for g in active_goals],
+                "active_goal_titles": [g["title"] for g in repo_goals],
                 "message": (
                     f"Workplan '{recent_ws['title']}' is not linked to the current "
                     f"repo goal(s) for {repo_slug}. "
@@ -353,31 +363,6 @@ def get_domain_summary(domain_slug: str) -> str:
     if goal_guidance:
         result["goal_guidance"] = goal_guidance
 
-    inbox_hygiene: dict[str, Any] = {}
-    try:
-        from scripts.consistency_check import collect_inbox_hygiene, STALE_UNREAD_DAYS
-    except ImportError:
-        collect_inbox_hygiene = None  # type: ignore[assignment]
-        STALE_UNREAD_DAYS = 3
-    if collect_inbox_hygiene is not None:
-        for repo in repos:
-            repo_slug = repo["slug"]
-            hygiene = collect_inbox_hygiene(API_BASE, repo_slug)
-            if (
-                hygiene["stale_unread_count"]
-                or hygiene["missing_thread"]
-                or hygiene["work_requests_unpromoted"]
-            ):
-                inbox_hygiene[repo_slug] = {
-                    "stale_unread_count": hygiene["stale_unread_count"],
-                    "stale_unread_days": STALE_UNREAD_DAYS,
-                    "stale_unread": hygiene["stale_unread"][:5],
-                    "missing_thread_count": len(hygiene["missing_thread"]),
-                    "work_requests_unpromoted": hygiene["work_requests_unpromoted"][:3],
-                }
-    if inbox_hygiene:
-        result["inbox_hygiene"] = inbox_hygiene
-
     # Compact capabilities list (type + title + repo_slug only, capped at 20)
     caps_raw = _get("/capability-catalog/", {"domain": domain_slug, "status": "active"})
     if isinstance(caps_raw, list):
@@ -1013,6 +998,114 @@ def resolve_decision(
     return _json_result(decision)
 
 
+@mcp.tool()
+def create_intake(
+    title: str,
+    topic_id: str | None = None,
+    workplan_id: str | None = None,
+    repo_id: str | None = None,
+    description: str | None = None,
+    lane: str = "green",
+    origin: str | None = None,
+    origin_ref: str | None = None,
+    source_repo_path: str | None = None,
+) -> str:
+    """Record an intake item — a spark: idea, finding, directive, or
+    request (work-record kind `intake`, canon/standards/
+    work-record-types_v0.1.md). Lifecycle: open -> vetted -> routed ->
+    closed(promoted|declined|absorbed).
+
+    Args:
+        title: short description of the intake item
+        topic_id: optional topic UUID (at least one of topic_id/workplan_id/repo_id required)
+        workplan_id: optional workplan UUID to scope this to
+        repo_id: optional managed-repo UUID to scope this to
+        description: optional longer context
+        lane: autonomy lane — green | blue | yellow | orange | red
+        origin: free-text source of the finding (e.g. "mail-triage", "founder-directive")
+        origin_ref: stable reference into the origin (e.g. a mail-log row id)
+        source_repo_path: repo-relative path of the file this was authored in, if known
+    """
+    intake = _post("/intakes", {
+        "title": title,
+        "topic_id": topic_id,
+        "workplan_id": workplan_id,
+        "repo_id": repo_id,
+        "description": description,
+        "lane": lane,
+        "origin": origin,
+        "origin_ref": origin_ref,
+        "source_repo_path": source_repo_path,
+    })
+    if error := _response_error("create_intake", intake, ("id",)):
+        return _json_result(error)
+    return _json_result(intake)
+
+
+@mcp.tool()
+def list_intakes(
+    topic_id: str | None = None,
+    workplan_id: str | None = None,
+    repo_id: str | None = None,
+    status: str | None = None,
+) -> str:
+    """List intake items, optionally filtered by scope and/or status.
+
+    Args:
+        topic_id: optional topic UUID
+        workplan_id: optional workplan UUID
+        repo_id: optional managed-repo UUID
+        status: open | vetted | routed | closed
+    """
+    return _json_result(_get("/intakes", {
+        "topic_id": topic_id,
+        "workplan_id": workplan_id,
+        "repo_id": repo_id,
+        "status_": status,
+    }))
+
+
+@mcp.tool()
+def route_intake(intake_id: str, routed_note: str | None = None) -> str:
+    """Move an intake from open/vetted into routed — the state that makes
+    it eligible for promotion into a workplan, task, decision, or
+    engagement.
+
+    Args:
+        intake_id: UUID of the intake item
+        routed_note: optional note on where/how it should be routed
+    """
+    result = _post(f"/intakes/{intake_id}/route", {"routed_note": routed_note})
+    if error := _response_error("route_intake", result, ("id",)):
+        return _json_result(error)
+    return _json_result(result)
+
+
+@mcp.tool()
+def close_intake(
+    intake_id: str,
+    outcome: str,
+    promoted_to: str | None = None,
+    note: str | None = None,
+) -> str:
+    """Close an intake item with an outcome.
+
+    Args:
+        intake_id: UUID of the intake item
+        outcome: promoted | declined | absorbed
+        promoted_to: canonical id of the record it became (required if outcome=promoted)
+        note: optional closing note
+    """
+    result = _post(f"/intakes/{intake_id}/close", {
+        "outcome": outcome,
+        "promoted_to": promoted_to,
+        "note": note,
+    })
+    if error := _response_error("close_intake", result, ("id",)):
+        return _json_result(error)
+    return _json_result(result)
+
+
 @mcp.tool()
 def add_progress_event(
     summary: str,
@@ -1129,95 +1222,20 @@ def get_next_steps() -> str:
 
 
 # ---------------------------------------------------------------------------
-# Demand-weighted suggestion backlog (STATE-WP-0061)
+# Suggestion backlog — RETIRED (STATE-WP-0079-T05, slice E1)
 # ---------------------------------------------------------------------------
-
-@mcp.tool()
-def list_suggestions(
-    domain: str | None = None,
-    stage: str | None = None,
-    rank: str | None = None,
-    limit: int = 50,
-) -> str:
-    """List persisted suggestions, optionally ranked by WSJF."""
-    return json.dumps(
-        _get("/suggestions", {
-            "domain": domain,
-            "stage": stage,
-            "rank": rank,
-            "limit": limit,
-        }),
-        indent=2,
-    )
-
-
-@mcp.tool()
-def create_suggestion(
-    domain: str,
-    title: str,
-    description: str | None = None,
-    origin_ref: str | None = None,
-    workplan_id: str | None = None,
-    base_value: float = 3.0,
-    job_size: float = 3.0,
-) -> str:
-    """Record a gated need as a relevance-accruing suggestion."""
-    return json.dumps(_post("/suggestions", {
-        "domain": domain,
-        "title": title,
-        "description": description,
-        "origin_ref": origin_ref,
-        "workplan_id": workplan_id,
-        "base_value": base_value,
-        "job_size": job_size,
-    }), indent=2)
-
-
-@mcp.tool()
-def vet_suggestion(suggestion_id: str, note: str, author: str | None = None) -> str:
-    """Promote a suggestion to a vetted requirement with an append-only note."""
-    return json.dumps(_post(f"/suggestions/{suggestion_id}/vet", {
-        "note": note,
-        "author": author,
-    }), indent=2)
-
-
-@mcp.tool()
-def decline_suggestion(suggestion_id: str, note: str, author: str | None = None) -> str:
-    """Decline a suggestion or requirement."""
-    return json.dumps(_post(f"/suggestions/{suggestion_id}/decline", {
-        "note": note,
-        "author": author,
-    }), indent=2)
-
-
-@mcp.tool()
-def promote_suggestion_to_task(
-    suggestion_id: str,
-    note: str | None = None,
-    task_title: str | None = None,
-    author: str | None = None,
-) -> str:
-    """Promote a vetted requirement into a real Task."""
-    return json.dumps(_post(f"/suggestions/{suggestion_id}/promote", {
-        "note": note,
-        "task_title": task_title,
-        "author": author,
-    }), indent=2)
-
-
-@mcp.tool()
-def bump_suggestion_relevance(
-    suggestion_id: str,
-    reason: str | None = None,
-    author: str | None = None,
-) -> str:
-    """Explicitly bump demand relevance when an agent hits an unmet gated need."""
-    return json.dumps(_post(f"/suggestions/{suggestion_id}/bump-relevance", {
-        "reason": reason,
-        "author": author,
-    }), indent=2)
-
+# The six suggestion tools (list/create/vet/decline/promote/bump) were removed
+# on 2026-08-20. Mutations had 410'd since CUST-WP-0061-T06; the reads existed
+# only to keep the historical backlog reachable, and that history is now
+# archived at the-custodian/docs/archived-suggestion-backlog.md.
+#
+# Successor: the intake work-record entity — create_intake / route_intake /
+# close_intake, and scripts/promote_intake.py --to task. See
+# canon/standards/work-record-types_v0.1.md.
+#
+# Kept as a comment rather than as 410 stubs: a retired tool that still appears
+# in the tool list costs every agent session context on every call, which is the
+# opposite of retiring it.
 
 # ---------------------------------------------------------------------------
 # Dependency graph tools (S1.4)
@@ -3194,4 +3212,9 @@ if __name__ == "__main__":
         mcp.run(transport="stdio")
     else:
         port = int(os.environ.get("MCP_PORT", "8001"))
-        mcp.run(transport=transport, host="127.0.0.1", port=port)
+        # Default to loopback: this server is an unauthenticated proxy over the
+        # API, so it must not land on every interface by accident. In-cluster
+        # deployment sets MCP_HOST=0.0.0.0 because a Service routes to the pod
+        # IP, and a loopback bind is unreachable there (CUST-WP-0067-T08).
+        host = os.environ.get("MCP_HOST", "127.0.0.1")
+        mcp.run(transport=transport, host=host, port=port)
diff --git a/migrations/versions/a4d5e6f7b8c9_allow_guarded_slug_rollback.py b/migrations/versions/a4d5e6f7b8c9_allow_guarded_slug_rollback.py
new file mode 100644
index 0000000..41f39a8
--- /dev/null
+++ b/migrations/versions/a4d5e6f7b8c9_allow_guarded_slug_rollback.py
@@ -0,0 +1,89 @@
+"""allow only operation-guarded alias restoration during rollback
+
+Revision ID: a4d5e6f7b8c9
+Revises: f3c4d5e6a7b8
+"""
+
+from alembic import op
+import sqlalchemy as sa
+
+
+revision = "a4d5e6f7b8c9"
+down_revision = "f3c4d5e6a7b8"
+branch_labels = None
+depends_on = None
+
+
+def upgrade() -> None:
+    # T02 made aliases immutable.  Rollback needs exactly one controlled
+    # exception: the alias created by this operation may become canonical while
+    # that same operation is in rollback-preflight.  Ownership, spelling,
+    # protection, and provenance remain immutable.
+    op.execute(
+        sa.text(
+            """
+            CREATE OR REPLACE FUNCTION guard_repository_slug_history()
+            RETURNS trigger AS $$
+            BEGIN
+                IF TG_OP = 'DELETE' THEN
+                    RAISE EXCEPTION 'repository slug rows are durable';
+                END IF;
+                IF NEW.repo_id IS DISTINCT FROM OLD.repo_id
+                   OR NEW.slug IS DISTINCT FROM OLD.slug THEN
+                    RAISE EXCEPTION 'repository slug ownership is immutable';
+                END IF;
+                IF OLD.kind = 'alias' AND ROW(
+                    NEW.kind, NEW.protected, NEW.source_operation_id
+                ) IS DISTINCT FROM ROW(
+                    OLD.kind, OLD.protected, OLD.source_operation_id
+                ) THEN
+                    IF NOT (
+                        NEW.kind = 'canonical'
+                        AND NEW.protected
+                        AND NEW.source_operation_id = OLD.source_operation_id
+                        AND EXISTS (
+                            SELECT 1
+                            FROM repository_rename_operations operation
+                            WHERE operation.id = OLD.source_operation_id
+                              AND operation.repo_id = OLD.repo_id
+                              AND operation.phase = 'rollback-preflight'
+                        )
+                    ) THEN
+                        RAISE EXCEPTION 'protected repository alias is immutable';
+                    END IF;
+                END IF;
+                RETURN NEW;
+            END;
+            $$ LANGUAGE plpgsql
+            """
+        )
+    )
+
+
+def downgrade() -> None:
+    op.execute(
+        sa.text(
+            """
+            CREATE OR REPLACE FUNCTION guard_repository_slug_history()
+            RETURNS trigger AS $$
+            BEGIN
+                IF TG_OP = 'DELETE' THEN
+                    RAISE EXCEPTION 'repository slug rows are durable';
+                END IF;
+                IF NEW.repo_id IS DISTINCT FROM OLD.repo_id
+                   OR NEW.slug IS DISTINCT FROM OLD.slug THEN
+                    RAISE EXCEPTION 'repository slug ownership is immutable';
+                END IF;
+                IF OLD.kind = 'alias' AND ROW(
+                    NEW.kind, NEW.protected, NEW.source_operation_id
+                ) IS DISTINCT FROM ROW(
+                    OLD.kind, OLD.protected, OLD.source_operation_id
+                ) THEN
+                    RAISE EXCEPTION 'protected repository alias is immutable';
+                END IF;
+                RETURN NEW;
+            END;
+            $$ LANGUAGE plpgsql
+            """
+        )
+    )
diff --git a/migrations/versions/a7c3e9f1b4d2_intake_work_record_entity.py b/migrations/versions/a7c3e9f1b4d2_intake_work_record_entity.py
new file mode 100644
index 0000000..6d29be0
--- /dev/null
+++ b/migrations/versions/a7c3e9f1b4d2_intake_work_record_entity.py
@@ -0,0 +1,100 @@
+"""add intakes + intake_notes tables (CUST-WP-0061-T01, work-record stage 3)
+
+Revision ID: a7c3e9f1b4d2
+Revises: f0a1b2c3d4e5
+Create Date: 2026-07-21
+
+"""
+from alembic import op
+import sqlalchemy as sa
+from sqlalchemy.dialects import postgresql
+from sqlalchemy.dialects.postgresql import UUID
+
+revision = "a7c3e9f1b4d2"
+down_revision = "f0a1b2c3d4e5"
+branch_labels = None
+depends_on = None
+
+intakelane = postgresql.ENUM(
+    "green", "blue", "yellow", "orange", "red",
+    name="intakelane",
+    create_type=False,
+)
+intakestatus = postgresql.ENUM(
+    "open", "vetted", "routed", "closed",
+    name="intakestatus",
+    create_type=False,
+)
+intakeoutcome = postgresql.ENUM(
+    "promoted", "declined", "absorbed",
+    name="intakeoutcome",
+    create_type=False,
+)
+
+
+def upgrade() -> None:
+    intakelane.create(op.get_bind(), checkfirst=True)
+    intakestatus.create(op.get_bind(), checkfirst=True)
+    intakeoutcome.create(op.get_bind(), checkfirst=True)
+
+    op.create_table(
+        "intakes",
+        sa.Column("id", UUID(as_uuid=True), primary_key=True),
+        sa.Column("topic_id", UUID(as_uuid=True), sa.ForeignKey("topics.id", ondelete="SET NULL"), nullable=True),
+        sa.Column("workplan_id", UUID(as_uuid=True), sa.ForeignKey("workplans.id", ondelete="SET NULL"), nullable=True),
+        sa.Column("repo_id", UUID(as_uuid=True), sa.ForeignKey("managed_repos.id", ondelete="SET NULL"), nullable=True),
+        sa.Column("title", sa.String(length=500), nullable=False),
+        sa.Column("description", sa.Text(), nullable=True),
+        sa.Column("lane", intakelane, nullable=False, server_default="green"),
+        sa.Column("status", intakestatus, nullable=False, server_default="open"),
+        sa.Column("outcome", intakeoutcome, nullable=True),
+        sa.Column("origin", sa.String(length=200), nullable=True),
+        sa.Column("origin_ref", sa.String(length=200), nullable=True),
+        sa.Column("promoted_to", sa.String(length=200), nullable=True),
+        sa.Column("source_repo_path", sa.Text(), nullable=True),
+        sa.Column("routed_note", sa.Text(), nullable=True),
+        sa.Column("closed_at", sa.DateTime(timezone=True), nullable=True),
+        sa.Column("created_at", sa.DateTime(timezone=True), server_default=sa.text("now()"), nullable=False),
+        sa.Column("updated_at", sa.DateTime(timezone=True), server_default=sa.text("now()"), nullable=False),
+        sa.CheckConstraint(
+            "topic_id IS NOT NULL OR workplan_id IS NOT NULL OR repo_id IS NOT NULL",
+            name="ck_intakes_topic_or_workplan_or_repo",
+        ),
+        sa.CheckConstraint(
+            "(status != 'closed') OR (outcome IS NOT NULL)",
+            name="ck_intakes_closed_requires_outcome",
+        ),
+        sa.CheckConstraint(
+            "(outcome != 'promoted') OR (promoted_to IS NOT NULL)",
+            name="ck_intakes_promoted_requires_promoted_to",
+        ),
+    )
+    op.create_index("ix_intakes_topic_id", "intakes", ["topic_id"])
+    op.create_index("ix_intakes_workplan_id", "intakes", ["workplan_id"])
+    op.create_index("ix_intakes_repo_id", "intakes", ["repo_id"])
+    op.create_index("ix_intakes_status", "intakes", ["status"])
+    op.create_index("ix_intakes_origin_ref", "intakes", ["origin_ref"])
+
+    op.create_table(
+        "intake_notes",
+        sa.Column("id", UUID(as_uuid=True), primary_key=True),
+        sa.Column("intake_id", UUID(as_uuid=True), sa.ForeignKey("intakes.id", ondelete="CASCADE"), nullable=False),
+        sa.Column("author", sa.String(length=100), nullable=True),
+        sa.Column("content", sa.Text(), nullable=False),
+        sa.Column("created_at", sa.DateTime(timezone=True), server_default=sa.text("now()"), nullable=False),
+    )
+    op.create_index("ix_intake_notes_intake_id", "intake_notes", ["intake_id"])
+
+
+def downgrade() -> None:
+    op.drop_index("ix_intake_notes_intake_id", table_name="intake_notes")
+    op.drop_table("intake_notes")
+    op.drop_index("ix_intakes_origin_ref", table_name="intakes")
+    op.drop_index("ix_intakes_status", table_name="intakes")
+    op.drop_index("ix_intakes_repo_id", table_name="intakes")
+    op.drop_index("ix_intakes_workplan_id", table_name="intakes")
+    op.drop_index("ix_intakes_topic_id", table_name="intakes")
+    op.drop_table("intakes")
+    intakeoutcome.drop(op.get_bind(), checkfirst=True)
+    intakestatus.drop(op.get_bind(), checkfirst=True)
+    intakelane.drop(op.get_bind(), checkfirst=True)
diff --git a/migrations/versions/b5e6f7a8c9d0_fabric_snapshot_set_revision.py b/migrations/versions/b5e6f7a8c9d0_fabric_snapshot_set_revision.py
new file mode 100644
index 0000000..d6c1235
--- /dev/null
+++ b/migrations/versions/b5e6f7a8c9d0_fabric_snapshot_set_revision.py
@@ -0,0 +1,35 @@
+"""accept deterministic Fabric snapshot-set revisions
+
+Revision ID: b5e6f7a8c9d0
+Revises: a4d5e6f7b8c9
+"""
+
+from alembic import op
+import sqlalchemy as sa
+
+
+revision = "b5e6f7a8c9d0"
+down_revision = "a4d5e6f7b8c9"
+branch_labels = None
+depends_on = None
+
+
+def upgrade() -> None:
+    op.alter_column(
+        "fabric_graph_imports",
+        "source_commit",
+        existing_type=sa.String(length=80),
+        type_=sa.String(length=255),
+        existing_nullable=True,
+    )
+
+
+def downgrade() -> None:
+    op.alter_column(
+        "fabric_graph_imports",
+        "source_commit",
+        existing_type=sa.String(length=255),
+        type_=sa.String(length=80),
+        existing_nullable=True,
+        postgresql_using="left(source_commit, 80)",
+    )
diff --git a/migrations/versions/b8d4f0a2c6e1_work_record_identifier_aliases.py b/migrations/versions/b8d4f0a2c6e1_work_record_identifier_aliases.py
new file mode 100644
index 0000000..730156c
--- /dev/null
+++ b/migrations/versions/b8d4f0a2c6e1_work_record_identifier_aliases.py
@@ -0,0 +1,182 @@
+"""add reversible work-record identifier migration support
+
+Revision ID: b8d4f0a2c6e1
+Revises: a7c3e9f1b4d2
+Create Date: 2026-08-22
+
+"""
+import sqlalchemy as sa
+from alembic import op
+from sqlalchemy.dialects.postgresql import UUID
+
+revision = "b8d4f0a2c6e1"
+down_revision = "a7c3e9f1b4d2"
+branch_labels = None
+depends_on = None
+
+
+_CASCADE_REFERENCES = """
+DO $$
+DECLARE
+    fk RECORD;
+    updated_definition TEXT;
+BEGIN
+    FOR fk IN
+        SELECT
+            constraint_row.conrelid::regclass AS relation_name,
+            constraint_row.conname AS constraint_name,
+            pg_get_constraintdef(constraint_row.oid) AS definition
+        FROM pg_constraint AS constraint_row
+        WHERE constraint_row.contype = 'f'
+          AND constraint_row.confrelid IN (
+              'workplans'::regclass,
+              'tasks'::regclass
+          )
+    LOOP
+        updated_definition := regexp_replace(
+            fk.definition,
+            ' ON UPDATE (NO ACTION|RESTRICT|CASCADE|SET NULL|SET DEFAULT)',
+            '',
+            'i'
+        );
+        IF position(' ON DELETE ' IN updated_definition) > 0 THEN
+            updated_definition := regexp_replace(
+                updated_definition,
+                ' ON DELETE ',
+                ' ON UPDATE CASCADE ON DELETE ',
+                'i'
+            );
+        ELSE
+            updated_definition := updated_definition || ' ON UPDATE CASCADE';
+        END IF;
+
+        EXECUTE format(
+            'ALTER TABLE %s DROP CONSTRAINT %I',
+            fk.relation_name,
+            fk.constraint_name
+        );
+        EXECUTE format(
+            'ALTER TABLE %s ADD CONSTRAINT %I %s',
+            fk.relation_name,
+            fk.constraint_name,
+            updated_definition
+        );
+    END LOOP;
+END $$;
+"""
+
+_REMOVE_UPDATE_CASCADE = """
+DO $$
+DECLARE
+    fk RECORD;
+    updated_definition TEXT;
+BEGIN
+    FOR fk IN
+        SELECT
+            constraint_row.conrelid::regclass AS relation_name,
+            constraint_row.conname AS constraint_name,
+            pg_get_constraintdef(constraint_row.oid) AS definition
+        FROM pg_constraint AS constraint_row
+        WHERE constraint_row.contype = 'f'
+          AND constraint_row.confrelid IN (
+              'workplans'::regclass,
+              'tasks'::regclass
+          )
+    LOOP
+        updated_definition := regexp_replace(
+            fk.definition,
+            ' ON UPDATE CASCADE',
+            '',
+            'i'
+        );
+        EXECUTE format(
+            'ALTER TABLE %s DROP CONSTRAINT %I',
+            fk.relation_name,
+            fk.constraint_name
+        );
+        EXECUTE format(
+            'ALTER TABLE %s ADD CONSTRAINT %I %s',
+            fk.relation_name,
+            fk.constraint_name,
+            updated_definition
+        );
+    END LOOP;
+END $$;
+"""
+
+
+def upgrade() -> None:
+    op.create_table(
+        "work_record_identifier_aliases",
+        sa.Column("id", UUID(as_uuid=True), primary_key=True),
+        sa.Column("old_id", UUID(as_uuid=True), nullable=False),
+        sa.Column("new_id", UUID(as_uuid=True), nullable=False),
+        sa.Column("record_kind", sa.String(length=20), nullable=False),
+        sa.Column("record_id", sa.String(length=160), nullable=False),
+        sa.Column("repo_slug", sa.String(length=100), nullable=False),
+        sa.Column("namespace", sa.String(length=64), nullable=False),
+        sa.Column("plan_sha256", sa.String(length=64), nullable=False),
+        sa.Column(
+            "migration_status",
+            sa.String(length=20),
+            nullable=False,
+            server_default="prepared",
+        ),
+        sa.Column("applied_at", sa.DateTime(timezone=True), nullable=True),
+        sa.Column("reversed_at", sa.DateTime(timezone=True), nullable=True),
+        sa.Column(
+            "created_at",
+            sa.DateTime(timezone=True),
+            server_default=sa.text("now()"),
+            nullable=False,
+        ),
+        sa.Column(
+            "updated_at",
+            sa.DateTime(timezone=True),
+            server_default=sa.text("now()"),
+            nullable=False,
+        ),
+        sa.CheckConstraint(
+            "record_kind IN ('workplan', 'task')",
+            name="ck_work_record_identifier_aliases_kind",
+        ),
+        sa.CheckConstraint(
+            "migration_status IN ('prepared', 'applied', 'reversed')",
+            name="ck_work_record_identifier_aliases_status",
+        ),
+        sa.UniqueConstraint("old_id", name="uq_work_record_identifier_aliases_old_id"),
+        sa.UniqueConstraint("new_id", name="uq_work_record_identifier_aliases_new_id"),
+    )
+    op.create_index(
+        "ix_work_record_identifier_aliases_record_id",
+        "work_record_identifier_aliases",
+        ["record_id"],
+    )
+    op.create_index(
+        "ix_work_record_identifier_aliases_repo_slug",
+        "work_record_identifier_aliases",
+        ["repo_slug"],
+    )
+    op.create_index(
+        "ix_work_record_identifier_aliases_plan_sha256",
+        "work_record_identifier_aliases",
+        ["plan_sha256"],
+    )
+    op.execute(_CASCADE_REFERENCES)
+
+
+def downgrade() -> None:
+    op.execute(_REMOVE_UPDATE_CASCADE)
+    op.drop_index(
+        "ix_work_record_identifier_aliases_plan_sha256",
+        table_name="work_record_identifier_aliases",
+    )
+    op.drop_index(
+        "ix_work_record_identifier_aliases_repo_slug",
+        table_name="work_record_identifier_aliases",
+    )
+    op.drop_index(
+        "ix_work_record_identifier_aliases_record_id",
+        table_name="work_record_identifier_aliases",
+    )
+    op.drop_table("work_record_identifier_aliases")
diff --git a/migrations/versions/c6f7a8b9d0e1_work_record_flavor.py b/migrations/versions/c6f7a8b9d0e1_work_record_flavor.py
new file mode 100644
index 0000000..ae0632a
--- /dev/null
+++ b/migrations/versions/c6f7a8b9d0e1_work_record_flavor.py
@@ -0,0 +1,39 @@
+"""work-record flavor on workplans and tasks (STATE-WP-0092)
+
+Flavor is a closed bucket (planning, implementation, refactoring, extension,
+residual), orthogonal to kind and status. Nullable: unset is not residual.
+
+Revision ID: c6f7a8b9d0e1
+Revises: b5e6f7a8c9d0
+"""
+from alembic import op
+import sqlalchemy as sa
+
+revision = "c6f7a8b9d0e1"
+down_revision = "b5e6f7a8c9d0"
+branch_labels = None
+depends_on = None
+
+
+def upgrade() -> None:
+    op.add_column("workplans", sa.Column("flavor", sa.String(length=32), nullable=True))
+    op.add_column(
+        "workplans",
+        sa.Column("flavor_promotion_reason", sa.String(length=32), nullable=True),
+    )
+    op.add_column(
+        "workplans",
+        sa.Column("flavor_promoted_from", sa.String(length=32), nullable=True),
+    )
+    op.create_index("ix_workplans_flavor", "workplans", ["flavor"])
+    op.add_column("tasks", sa.Column("flavor", sa.String(length=32), nullable=True))
+    op.create_index("ix_tasks_flavor", "tasks", ["flavor"])
+
+
+def downgrade() -> None:
+    op.drop_index("ix_tasks_flavor", table_name="tasks")
+    op.drop_column("tasks", "flavor")
+    op.drop_index("ix_workplans_flavor", table_name="workplans")
+    op.drop_column("workplans", "flavor_promoted_from")
+    op.drop_column("workplans", "flavor_promotion_reason")
+    op.drop_column("workplans", "flavor")
diff --git a/migrations/versions/c9e5a1b3d7f2_review_contracts_and_receipts.py b/migrations/versions/c9e5a1b3d7f2_review_contracts_and_receipts.py
new file mode 100644
index 0000000..6c9a5ea
--- /dev/null
+++ b/migrations/versions/c9e5a1b3d7f2_review_contracts_and_receipts.py
@@ -0,0 +1,151 @@
+"""add multi-owner review contract projections and immutable receipts
+
+Revision ID: c9e5a1b3d7f2
+Revises: b8d4f0a2c6e1
+Create Date: 2026-08-22
+"""
+
+import sqlalchemy as sa
+from alembic import op
+from sqlalchemy.dialects.postgresql import JSONB, UUID
+
+revision = "c9e5a1b3d7f2"
+down_revision = "b8d4f0a2c6e1"
+branch_labels = None
+depends_on = None
+
+
+def upgrade() -> None:
+    op.create_table(
+        "review_contracts",
+        sa.Column("id", UUID(as_uuid=True), primary_key=True),
+        sa.Column("contract_key", sa.String(160), nullable=False),
+        sa.Column("schema_version", sa.String(40), nullable=False),
+        sa.Column("contract_digest", sa.String(64), nullable=False, unique=True),
+        sa.Column("source_repo", sa.String(100), nullable=False),
+        sa.Column("source_path", sa.Text(), nullable=False),
+        sa.Column("source_revision", sa.String(64), nullable=False),
+        sa.Column("document", JSONB(), nullable=False),
+        sa.Column("active", sa.Boolean(), nullable=False, server_default=sa.true()),
+        sa.Column(
+            "required_for_decision",
+            sa.Boolean(),
+            nullable=False,
+            server_default=sa.false(),
+        ),
+        sa.Column(
+            "decision_id",
+            UUID(as_uuid=True),
+            sa.ForeignKey("decisions.id", ondelete="RESTRICT"),
+            nullable=True,
+        ),
+        sa.Column(
+            "workplan_id",
+            UUID(as_uuid=True),
+            sa.ForeignKey("workplans.id", ondelete="RESTRICT", onupdate="CASCADE"),
+            nullable=True,
+        ),
+        sa.Column(
+            "task_id",
+            UUID(as_uuid=True),
+            sa.ForeignKey("tasks.id", ondelete="RESTRICT", onupdate="CASCADE"),
+            nullable=True,
+        ),
+        sa.Column("projected_at", sa.DateTime(timezone=True), nullable=False),
+        sa.Column(
+            "created_at",
+            sa.DateTime(timezone=True),
+            server_default=sa.text("now()"),
+            nullable=False,
+        ),
+        sa.Column(
+            "updated_at",
+            sa.DateTime(timezone=True),
+            server_default=sa.text("now()"),
+            nullable=False,
+        ),
+        sa.UniqueConstraint(
+            "contract_key",
+            "source_repo",
+            "source_path",
+            "source_revision",
+            name="uq_review_contract_source_revision",
+        ),
+    )
+    op.create_index(
+        "ix_review_contracts_contract_key", "review_contracts", ["contract_key"]
+    )
+    op.create_index("ix_review_contracts_active", "review_contracts", ["active"])
+    op.create_index(
+        "ix_review_contract_key_active", "review_contracts", ["contract_key", "active"]
+    )
+    op.create_index(
+        "ix_review_contracts_decision_id", "review_contracts", ["decision_id"]
+    )
+    op.create_index(
+        "ix_review_contracts_workplan_id", "review_contracts", ["workplan_id"]
+    )
+    op.create_index("ix_review_contracts_task_id", "review_contracts", ["task_id"])
+
+    op.create_table(
+        "review_receipts",
+        sa.Column("id", UUID(as_uuid=True), primary_key=True),
+        sa.Column(
+            "contract_id",
+            UUID(as_uuid=True),
+            sa.ForeignKey("review_contracts.id", ondelete="RESTRICT"),
+            nullable=False,
+        ),
+        sa.Column("owner_id", sa.String(160), nullable=False),
+        sa.Column("actor", sa.String(160), nullable=False),
+        sa.Column("disposition", sa.String(32), nullable=False),
+        sa.Column("contract_digest", sa.String(64), nullable=False),
+        sa.Column("receipt_digest", sa.String(64), nullable=False, unique=True),
+        sa.Column("artifact_hashes", JSONB(), nullable=False),
+        sa.Column("assertion_ids", JSONB(), nullable=False),
+        sa.Column("checks", JSONB(), nullable=False),
+        sa.Column("note", sa.Text(), nullable=True),
+        sa.Column("source_repo", sa.String(100), nullable=False),
+        sa.Column("source_path", sa.Text(), nullable=False),
+        sa.Column("source_revision", sa.String(64), nullable=False),
+        sa.Column("submitted_at", sa.DateTime(timezone=True), nullable=False),
+        sa.Column("document", JSONB(), nullable=False),
+        sa.Column(
+            "created_at",
+            sa.DateTime(timezone=True),
+            server_default=sa.text("now()"),
+            nullable=False,
+        ),
+        sa.Column(
+            "updated_at",
+            sa.DateTime(timezone=True),
+            server_default=sa.text("now()"),
+            nullable=False,
+        ),
+        sa.UniqueConstraint(
+            "source_repo",
+            "source_path",
+            "source_revision",
+            name="uq_review_receipt_source_revision",
+        ),
+    )
+    op.create_index(
+        "ix_review_receipts_contract_id", "review_receipts", ["contract_id"]
+    )
+    op.create_index("ix_review_receipts_owner_id", "review_receipts", ["owner_id"])
+    op.create_index(
+        "ix_review_receipts_contract_digest", "review_receipts", ["contract_digest"]
+    )
+    op.create_index(
+        "ix_review_receipts_submitted_at", "review_receipts", ["submitted_at"]
+    )
+    op.create_index(
+        "ix_review_receipt_contract_owner_time",
+        "review_receipts",
+        ["contract_id", "owner_id", "submitted_at"],
+    )
+
+
+def downgrade() -> None:
+    op.drop_table("review_receipts")
+    op.drop_table("review_contracts")
diff --git a/migrations/versions/d1a2b3c4e5f6_workplan_projection_retirement.py b/migrations/versions/d1a2b3c4e5f6_workplan_projection_retirement.py
new file mode 100644
index 0000000..632a816
--- /dev/null
+++ b/migrations/versions/d1a2b3c4e5f6_workplan_projection_retirement.py
@@ -0,0 +1,49 @@
+"""workplan projection retirement (STATE-WP-0083-T03)
+
+A forge-derived projection must be able to say that a record no longer derives
+from the forge. It cannot say so by deleting the row: progress events, tasks,
+decisions and review contracts reference workplans with ON DELETE RESTRICT, and
+those hub-native records must survive (ADR-010 decision 4, ADR-012 decision 7 as
+amended 2026-08-25).
+
+Nor can it say so through `status`. A workplan that is `archived` was closed by
+its owner; one that no longer derives is a different fact, and overloading the
+same field would destroy the distinction exactly where it matters.
+
+Revision ID: d1a2b3c4e5f6
+Revises: c9e5a1b3d7f2
+"""
+from alembic import op
+import sqlalchemy as sa
+
+revision = "d1a2b3c4e5f6"
+down_revision = "c9e5a1b3d7f2"
+branch_labels = None
+depends_on = None
+
+
+def upgrade() -> None:
+    op.add_column(
+        "workplans",
+        sa.Column("projection_retired_at", sa.DateTime(timezone=True), nullable=True),
+    )
+    op.add_column(
+        "workplans",
+        sa.Column("projection_retired_reason", sa.String(length=255), nullable=True),
+    )
+    op.add_column(
+        "workplans",
+        sa.Column("derived_from_commit", sa.String(length=40), nullable=True),
+    )
+    op.create_index(
+        "ix_workplans_projection_retired_at",
+        "workplans",
+        ["projection_retired_at"],
+    )
+
+
+def downgrade() -> None:
+    op.drop_index("ix_workplans_projection_retired_at", table_name="workplans")
+    op.drop_column("workplans", "derived_from_commit")
+    op.drop_column("workplans", "projection_retired_reason")
+    op.drop_column("workplans", "projection_retired_at")
diff --git a/migrations/versions/e2b3c4d5f6a7_task_canonical_record_id.py b/migrations/versions/e2b3c4d5f6a7_task_canonical_record_id.py
new file mode 100644
index 0000000..ce983a3
--- /dev/null
+++ b/migrations/versions/e2b3c4d5f6a7_task_canonical_record_id.py
@@ -0,0 +1,36 @@
+"""task canonical record id (STATE-WP-0083-T06)
+
+Every work-record type carries a stable canonical identifier except tasks. A
+task row holds `id, workplan_id, title, status, priority` — nothing connecting it
+to `CUST-WP-0067-T01` in the file it came from.
+
+The consequence is that a file task and a hub task can only be matched by title,
+so a renamed heading looks like one task disappearing and another appearing. That
+is why the forge-derived reset deliberately refuses to touch tasks of existing
+workplans: destroying and recreating a record because someone edited a heading is
+not an acceptable failure mode.
+
+Nullable on purpose. Existing rows have no canonical id and cannot be given one
+by this migration — only the repository files know the mapping, and backfilling
+from them is a separate, reversible step.
+
+Revision ID: e2b3c4d5f6a7
+Revises: d1a2b3c4e5f6
+"""
+from alembic import op
+import sqlalchemy as sa
+
+revision = "e2b3c4d5f6a7"
+down_revision = "d1a2b3c4e5f6"
+branch_labels = None
+depends_on = None
+
+
+def upgrade() -> None:
+    op.add_column("tasks", sa.Column("record_id", sa.String(length=120), nullable=True))
+    op.create_index("ix_tasks_record_id", "tasks", ["record_id"])
+
+
+def downgrade() -> None:
+    op.drop_index("ix_tasks_record_id", table_name="tasks")
+    op.drop_column("tasks", "record_id")
diff --git a/migrations/versions/f3c4d5e6a7b8_repository_rename_identity.py b/migrations/versions/f3c4d5e6a7b8_repository_rename_identity.py
new file mode 100644
index 0000000..f7fc8d3
--- /dev/null
+++ b/migrations/versions/f3c4d5e6a7b8_repository_rename_identity.py
@@ -0,0 +1,475 @@
+"""repository identity, protected slugs, and rename journal (STATE-WP-0085-T02)
+
+The existing repository UUID remains the durable State Hub identity. This
+migration adds only new rows around it: an explicit unverified Forge identity,
+one canonical slug record, and empty operation history. It deliberately does
+not infer Forge coordinates from a slug, remote URL, checkout, or Git commit.
+
+Revision ID: f3c4d5e6a7b8
+Revises: e2b3c4d5f6a7
+"""
+
+from alembic import op
+import sqlalchemy as sa
+from sqlalchemy.dialects.postgresql import JSONB, UUID
+
+revision = "f3c4d5e6a7b8"
+down_revision = "e2b3c4d5f6a7"
+branch_labels = None
+depends_on = None
+
+
+def upgrade() -> None:
+    op.create_table(
+        "repository_forge_identities",
+        sa.Column(
+            "id",
+            UUID(as_uuid=True),
+            primary_key=True,
+            server_default=sa.text("gen_random_uuid()"),
+        ),
+        sa.Column(
+            "repo_id",
+            UUID(as_uuid=True),
+            sa.ForeignKey("managed_repos.id", ondelete="RESTRICT"),
+            nullable=False,
+        ),
+        sa.Column("provider", sa.String(length=40), nullable=True),
+        sa.Column("forge_instance", sa.String(length=255), nullable=True),
+        sa.Column("forge_owner", sa.String(length=255), nullable=True),
+        sa.Column("forge_repository_id", sa.BigInteger(), nullable=True),
+        sa.Column(
+            "verification_state",
+            sa.String(length=20),
+            nullable=False,
+            server_default="unverified",
+        ),
+        sa.Column("verified_at", sa.DateTime(timezone=True), nullable=True),
+        sa.Column("verified_by", sa.String(length=160), nullable=True),
+        sa.Column(
+            "verification_evidence", JSONB(), nullable=False, server_default="{}"
+        ),
+        sa.Column(
+            "created_at",
+            sa.DateTime(timezone=True),
+            nullable=False,
+            server_default=sa.text("now()"),
+        ),
+        sa.Column(
+            "updated_at",
+            sa.DateTime(timezone=True),
+            nullable=False,
+            server_default=sa.text("now()"),
+        ),
+        sa.UniqueConstraint(
+            "repo_id", name="uq_repository_forge_identities_repo_id"
+        ),
+        sa.UniqueConstraint(
+            "id",
+            "repo_id",
+            "verification_state",
+            name="uq_repository_forge_identity_verified_ref",
+        ),
+        sa.UniqueConstraint(
+            "provider",
+            "forge_instance",
+            "forge_owner",
+            "forge_repository_id",
+            name="uq_repository_forge_identity_tuple",
+        ),
+        sa.CheckConstraint(
+            "verification_state IN ('unverified', 'verified')",
+            name="ck_repository_forge_identity_state",
+        ),
+        sa.CheckConstraint(
+            "forge_repository_id IS NULL OR forge_repository_id > 0",
+            name="ck_repository_forge_id_positive",
+        ),
+        sa.CheckConstraint(
+            "verification_state != 'verified' OR "
+            "(provider IS NOT NULL AND forge_instance IS NOT NULL "
+            "AND forge_owner IS NOT NULL AND forge_repository_id IS NOT NULL "
+            "AND verified_at IS NOT NULL AND verified_by IS NOT NULL)",
+            name="ck_repository_forge_verified_complete",
+        ),
+        sa.CheckConstraint(
+            "verification_state = 'verified' OR "
+            "(verified_at IS NULL AND verified_by IS NULL)",
+            name="ck_repository_forge_unverified_has_no_attestation",
+        ),
+    )
+
+    op.create_table(
+        "repository_rename_operations",
+        sa.Column(
+            "id",
+            UUID(as_uuid=True),
+            primary_key=True,
+            server_default=sa.text("gen_random_uuid()"),
+        ),
+        sa.Column(
+            "repo_id",
+            UUID(as_uuid=True),
+            sa.ForeignKey("managed_repos.id", ondelete="RESTRICT"),
+            nullable=False,
+        ),
+        sa.Column("forge_identity_id", UUID(as_uuid=True), nullable=False),
+        sa.Column(
+            "forge_identity_state",
+            sa.String(length=20),
+            nullable=False,
+            server_default="verified",
+        ),
+        sa.Column("expected_provider", sa.String(length=40), nullable=False),
+        sa.Column(
+            "expected_forge_instance", sa.String(length=255), nullable=False
+        ),
+        sa.Column("expected_forge_owner", sa.String(length=255), nullable=False),
+        sa.Column("expected_forge_repository_id", sa.BigInteger(), nullable=False),
+        sa.Column("expected_source_commit", sa.String(length=64), nullable=False),
+        sa.Column("expected_default_branch", sa.String(length=255), nullable=False),
+        sa.Column("old_slug", sa.String(length=100), nullable=False),
+        sa.Column("new_slug", sa.String(length=100), nullable=False),
+        sa.Column("old_coordinates", JSONB(), nullable=False),
+        sa.Column("new_coordinates", JSONB(), nullable=False),
+        sa.Column(
+            "phase", sa.String(length=32), nullable=False, server_default="draft"
+        ),
+        sa.Column("actor", sa.String(length=160), nullable=False),
+        sa.Column("phase_changed_at", sa.DateTime(timezone=True), nullable=False),
+        sa.Column("preflighted_at", sa.DateTime(timezone=True), nullable=True),
+        sa.Column("preflight_expires_at", sa.DateTime(timezone=True), nullable=True),
+        sa.Column("completed_at", sa.DateTime(timezone=True), nullable=True),
+        sa.Column("rolled_back_at", sa.DateTime(timezone=True), nullable=True),
+        sa.Column("evidence", JSONB(), nullable=False, server_default="{}"),
+        sa.Column("error_code", sa.String(length=80), nullable=True),
+        sa.Column("error_message", sa.Text(), nullable=True),
+        sa.Column("error_details", JSONB(), nullable=True),
+        sa.Column("error_at", sa.DateTime(timezone=True), nullable=True),
+        sa.Column(
+            "created_at",
+            sa.DateTime(timezone=True),
+            nullable=False,
+            server_default=sa.text("now()"),
+        ),
+        sa.Column(
+            "updated_at",
+            sa.DateTime(timezone=True),
+            nullable=False,
+            server_default=sa.text("now()"),
+        ),
+        sa.CheckConstraint(
+            "phase IN ('draft', 'preflighted', 'forge-renamed', "
+            "'statehub-rebound', 'source-synced', 'consumers-verified', "
+            "'completed', 'rollback-preflight', 'rolled-back')",
+            name="ck_repository_rename_phase",
+        ),
+        sa.CheckConstraint(
+            "old_slug != new_slug", name="ck_repository_rename_distinct_slugs"
+        ),
+        sa.CheckConstraint(
+            "expected_forge_repository_id > 0",
+            name="ck_repository_rename_forge_id_positive",
+        ),
+        sa.CheckConstraint(
+            "forge_identity_state = 'verified'",
+            name="ck_repository_rename_verified_identity",
+        ),
+        sa.CheckConstraint(
+            "phase = 'draft' OR preflighted_at IS NOT NULL",
+            name="ck_repository_rename_preflight_timestamp",
+        ),
+        sa.CheckConstraint(
+            "phase != 'completed' OR completed_at IS NOT NULL",
+            name="ck_repository_rename_completed_timestamp",
+        ),
+        sa.CheckConstraint(
+            "phase != 'rolled-back' OR rolled_back_at IS NOT NULL",
+            name="ck_repository_rename_rollback_timestamp",
+        ),
+        sa.ForeignKeyConstraint(
+            ["forge_identity_id", "repo_id", "forge_identity_state"],
+            [
+                "repository_forge_identities.id",
+                "repository_forge_identities.repo_id",
+                "repository_forge_identities.verification_state",
+            ],
+            name="fk_repository_rename_verified_identity",
+            ondelete="RESTRICT",
+        ),
+    )
+    op.create_index(
+        "ix_repository_rename_operations_repo_id",
+        "repository_rename_operations",
+        ["repo_id"],
+    )
+    op.create_index(
+        "ix_repository_rename_operations_old_slug",
+        "repository_rename_operations",
+        ["old_slug"],
+    )
+    op.create_index(
+        "ix_repository_rename_operations_new_slug",
+        "repository_rename_operations",
+        ["new_slug"],
+    )
+    op.create_index(
+        "ix_repository_rename_phase",
+        "repository_rename_operations",
+        ["phase"],
+    )
+    op.create_index(
+        "uq_repository_rename_active_repo",
+        "repository_rename_operations",
+        ["repo_id"],
+        unique=True,
+        postgresql_where=sa.text("phase NOT IN ('completed', 'rolled-back')"),
+    )
+    op.create_index(
+        "uq_repository_rename_active_new_slug",
+        "repository_rename_operations",
+        ["new_slug"],
+        unique=True,
+        postgresql_where=sa.text("phase NOT IN ('completed', 'rolled-back')"),
+    )
+
+    op.create_table(
+        "repository_slugs",
+        sa.Column(
+            "id",
+            UUID(as_uuid=True),
+            primary_key=True,
+            server_default=sa.text("gen_random_uuid()"),
+        ),
+        sa.Column(
+            "repo_id",
+            UUID(as_uuid=True),
+            sa.ForeignKey("managed_repos.id", ondelete="RESTRICT"),
+            nullable=False,
+        ),
+        sa.Column("slug", sa.String(length=100), nullable=False),
+        sa.Column("kind", sa.String(length=16), nullable=False),
+        sa.Column(
+            "protected", sa.Boolean(), nullable=False, server_default=sa.true()
+        ),
+        sa.Column(
+            "source_operation_id",
+            UUID(as_uuid=True),
+            sa.ForeignKey("repository_rename_operations.id", ondelete="RESTRICT"),
+            nullable=True,
+        ),
+        sa.Column(
+            "created_at",
+            sa.DateTime(timezone=True),
+            nullable=False,
+            server_default=sa.text("now()"),
+        ),
+        sa.Column(
+            "updated_at",
+            sa.DateTime(timezone=True),
+            nullable=False,
+            server_default=sa.text("now()"),
+        ),
+        sa.UniqueConstraint("slug", name="uq_repository_slugs_slug"),
+        sa.CheckConstraint(
+            "kind IN ('canonical', 'alias')", name="ck_repository_slug_kind"
+        ),
+        sa.CheckConstraint(
+            "kind != 'alias' OR protected",
+            name="ck_repository_slug_alias_protected",
+        ),
+    )
+    op.create_index(
+        "ix_repository_slugs_source_operation_id",
+        "repository_slugs",
+        ["source_operation_id"],
+    )
+    op.create_index(
+        "ix_repository_slugs_repo_kind",
+        "repository_slugs",
+        ["repo_id", "kind"],
+    )
+    op.create_index(
+        "uq_repository_slugs_one_canonical",
+        "repository_slugs",
+        ["repo_id"],
+        unique=True,
+        postgresql_where=sa.text("kind = 'canonical'"),
+    )
+
+    # Explicitly mark every existing repository unverified. Do not parse or
+    # infer Forge coordinates from current mutable fields.
+    op.execute(
+        sa.text(
+            """
+            INSERT INTO repository_forge_identities
+                (id, repo_id, verification_state, verification_evidence,
+                 created_at, updated_at)
+            SELECT gen_random_uuid(), id, 'unverified', '{}'::jsonb, now(), now()
+            FROM managed_repos
+            """
+        )
+    )
+
+    op.execute(
+        sa.text(
+            """
+            CREATE FUNCTION guard_repository_forge_identity_history()
+            RETURNS trigger AS $$
+            BEGIN
+                IF TG_OP = 'DELETE' THEN
+                    RAISE EXCEPTION 'repository Forge identity rows are durable';
+                END IF;
+                IF OLD.verification_state = 'verified' AND ROW(
+                    NEW.repo_id,
+                    NEW.provider,
+                    NEW.forge_instance,
+                    NEW.forge_owner,
+                    NEW.forge_repository_id,
+                    NEW.verification_state,
+                    NEW.verified_at,
+                    NEW.verified_by,
+                    NEW.verification_evidence
+                ) IS DISTINCT FROM ROW(
+                    OLD.repo_id,
+                    OLD.provider,
+                    OLD.forge_instance,
+                    OLD.forge_owner,
+                    OLD.forge_repository_id,
+                    OLD.verification_state,
+                    OLD.verified_at,
+                    OLD.verified_by,
+                    OLD.verification_evidence
+                ) THEN
+                    RAISE EXCEPTION 'verified repository Forge identity is immutable';
+                END IF;
+                RETURN NEW;
+            END;
+            $$ LANGUAGE plpgsql
+            """
+        )
+    )
+    op.execute(
+        sa.text(
+            """
+            CREATE TRIGGER repository_forge_identity_history_guard
+            BEFORE UPDATE OR DELETE ON repository_forge_identities
+            FOR EACH ROW EXECUTE FUNCTION guard_repository_forge_identity_history()
+            """
+        )
+    )
+    op.execute(
+        sa.text(
+            """
+            CREATE FUNCTION guard_repository_slug_history()
+            RETURNS trigger AS $$
+            BEGIN
+                IF TG_OP = 'DELETE' THEN
+                    RAISE EXCEPTION 'repository slug rows are durable';
+                END IF;
+                IF NEW.repo_id IS DISTINCT FROM OLD.repo_id
+                   OR NEW.slug IS DISTINCT FROM OLD.slug THEN
+                    RAISE EXCEPTION 'repository slug ownership is immutable';
+                END IF;
+                IF OLD.kind = 'alias' AND ROW(
+                    NEW.kind, NEW.protected, NEW.source_operation_id
+                ) IS DISTINCT FROM ROW(
+                    OLD.kind, OLD.protected, OLD.source_operation_id
+                ) THEN
+                    RAISE EXCEPTION 'protected repository alias is immutable';
+                END IF;
+                RETURN NEW;
+            END;
+            $$ LANGUAGE plpgsql
+            """
+        )
+    )
+    op.execute(
+        sa.text(
+            """
+            CREATE TRIGGER repository_slug_history_guard
+            BEFORE UPDATE OR DELETE ON repository_slugs
+            FOR EACH ROW EXECUTE FUNCTION guard_repository_slug_history()
+            """
+        )
+    )
+    op.execute(
+        sa.text(
+            """
+            CREATE FUNCTION guard_repository_rename_operation_history()
+            RETURNS trigger AS $$
+            BEGIN
+                IF TG_OP = 'DELETE' THEN
+                    RAISE EXCEPTION 'repository rename operation rows are durable';
+                END IF;
+                IF ROW(
+                    NEW.repo_id,
+                    NEW.forge_identity_id,
+                    NEW.forge_identity_state,
+                    NEW.expected_provider,
+                    NEW.expected_forge_instance,
+                    NEW.expected_forge_owner,
+                    NEW.expected_forge_repository_id,
+                    NEW.expected_source_commit,
+                    NEW.expected_default_branch,
+                    NEW.old_slug,
+                    NEW.new_slug,
+                    NEW.old_coordinates,
+                    NEW.new_coordinates,
+                    NEW.actor,
+                    NEW.created_at
+                ) IS DISTINCT FROM ROW(
+                    OLD.repo_id,
+                    OLD.forge_identity_id,
+                    OLD.forge_identity_state,
+                    OLD.expected_provider,
+                    OLD.expected_forge_instance,
+                    OLD.expected_forge_owner,
+                    OLD.expected_forge_repository_id,
+                    OLD.expected_source_commit,
+                    OLD.expected_default_branch,
+                    OLD.old_slug,
+                    OLD.new_slug,
+                    OLD.old_coordinates,
+                    OLD.new_coordinates,
+                    OLD.actor,
+                    OLD.created_at
+                ) THEN
+                    RAISE EXCEPTION 'repository rename operation assertions are immutable';
+                END IF;
+                RETURN NEW;
+            END;
+            $$ LANGUAGE plpgsql
+            """
+        )
+    )
+    op.execute(
+        sa.text(
+            """
+            CREATE TRIGGER repository_rename_operation_history_guard
+            BEFORE UPDATE OR DELETE ON repository_rename_operations
+            FOR EACH ROW EXECUTE FUNCTION guard_repository_rename_operation_history()
+            """
+        )
+    )
+    op.execute(
+        sa.text(
+            """
+            INSERT INTO repository_slugs
+                (id, repo_id, slug, kind, protected, created_at, updated_at)
+            SELECT gen_random_uuid(), id, slug, 'canonical', true, now(), now()
+            FROM managed_repos
+            """
+        )
+    )
+
+
+def downgrade() -> None:
+    # These tables are additive. Dropping them restores the prior schema and
+    # cannot rewrite or delete any pre-existing work or telemetry row.
+    op.drop_table("repository_slugs")
+    op.drop_table("repository_rename_operations")
+    op.drop_table("repository_forge_identities")
+    op.execute(sa.text("DROP FUNCTION guard_repository_slug_history()"))
+    op.execute(sa.text("DROP FUNCTION guard_repository_rename_operation_history()"))
+    op.execute(sa.text("DROP FUNCTION guard_repository_forge_identity_history()"))
diff --git a/policies/intake-doc.md b/policies/intake-doc.md
new file mode 100644
index 0000000..0175e7c
--- /dev/null
+++ b/policies/intake-doc.md
@@ -0,0 +1,95 @@
+# Intake Definition of Comprehension (DoC)
+
+**applies_to:** `intake`  
+**Assessment outcomes:** `unassessed` | `DoC-Ok` | `DoC-Failed`  
+**Does not apply to:** workplan, task, decision, engagement, register-entry
+
+An intake is a **discovery** work record (a find / spark). **DoC** is the quality
+policy for “we understand this demand or signal well enough to route or promote.”
+It is **not** implementation design and **not** Definition of Ready.
+
+Lifecycle `status` (open / vetted / routed / closed) is independent of DoC
+assessment. Prefer: treat **DoC-Ok** as the quality bar before confident
+`vetted` → `routed` → promote. Process may still move without DoC-Ok; that is
+quality debt, not forbidden.
+
+Related:
+
+- Work-record umbrella: `dashboard/src/docs/work-records.md`
+- Quality model: `docs/work-record-quality-gates.md`
+- Delivery readiness: `policies/work-item-dor.md` (DoR)
+- Intake reference: `dashboard/src/docs/intakes.md`
+
+---
+
+## Core checklist (all intakes)
+
+An intake may be assessed **DoC-Ok** when all of the following hold:
+
+- [ ] **Signal stated** — title (and description if non-obvious) says what was
+  observed, asked, or found, not a vague “look into X.”
+- [ ] **Why it matters** — at least one sentence of consequence if ignored
+  (risk, opportunity, blocker, cost of delay).
+- [ ] **Known unknowns listed** — what we do *not* know yet (owner, repo, scope,
+  feasibility, counterparty intent, …), or an explicit “no material unknowns.”
+- [ ] **Provisional ownership** — at least one of: `topic_id` / `workplan_id` /
+  `repo_id` / domain hypothesis — **or** an explicit statement that ownership is
+  still unknown and who will decide.
+- [ ] **Next action** — one of: route, promote (to which kind if known), decline,
+  absorb, or “needs more discovery” with a named follow-up.
+- [ ] **Not a premature workplan** — the intake does not pretend to be a full
+  task breakdown, DoD, or implementation design (those belong after promotion
+  under DoR).
+
+If any core item fails after assessment, record **DoC-Failed** and note the gap.
+
+---
+
+## Outside-originated profile
+
+Use this section when the signal is **external** or **structurally sparse**:
+external demand into the fleet, true third-party/upstream, mail/founder note
+without repo context, or `origin` / tags such as `external-demand` /
+`third-party`.
+
+Additional criteria for **DoC-Ok** (on top of the core checklist):
+
+- [ ] **Source of signal** — `origin` and, when available, `origin_ref` (or
+  equivalent note) identify where the demand came from.
+- [ ] **Boundary named** — one of: *ecosystem* (another fleet repo), *true
+  third-party*, *external demand into us*, or *unknown* with a plan to classify.
+- [ ] **No invented foreign structure** — we do not schedule *their* backlog as
+  our workplan graph; we only record *our* understanding and *our* possible
+  response.
+- [ ] **Enough context to avoid premature promote** — promoting to task/workplan
+  would not require guessing the owning repo or outcome shape; if it would,
+  keep the intake open/vetted and list the missing facts under known unknowns.
+- [ ] **Counterparty or channel** (when third-party or external) — who/what is
+  outside, even if only “unknown maintainer of package X.”
+
+Ecosystem-only signals (work for another registered repo) usually need routing
+clarity, not the full third-party bar; still record boundary as ecosystem.
+
+---
+
+## Assessment practice (convention)
+
+- Assessors: owning agent, domain owner, or human operator.
+- Record outcome in a note, progress event, or later frontmatter/badge field:
+  `DoC-Ok` or `DoC-Failed` plus date and short reason if failed.
+- Re-assess after material new information; a prior DoC-Ok can become Failed or
+  be superseded by a new Ok.
+- **DoC-Ok does not authorize implementation** — only comprehension for
+  routing/promotion. Delivery readiness is **DoR** on the resulting task or
+  workplan.
+
+---
+
+## Explicit non-requirements
+
+DoC does **not** require:
+
+- Task breakdown, estimates, or acceptance tests
+- Full solution design
+- DoR or DoD criteria
+- A workplan file to already exist
diff --git a/policies/retirement-freeze.md b/policies/retirement-freeze.md
new file mode 100644
index 0000000..f17f25f
--- /dev/null
+++ b/policies/retirement-freeze.md
@@ -0,0 +1,87 @@
+# Retirement Freeze Policy
+
+**Policy key:** `retirement-freeze`
+**applies_to:** every change to `state-hub` from 2026-08-20 until the archive
+window closes
+**Assessment outcomes:** `Freeze-Ok` | `Freeze-Failed`
+**Owner task:** `STATE-WP-0079-T01`
+**Related:** `docs/retirement-cutover-slice-plan.md`, `SHR-INV-0001`,
+decision `747011c6`, `prj-state-hub-retirement/GOAL.md`
+
+## Why this exists
+
+State Hub is being retired: its 425 inventoried surfaces move, are replaced, or
+are retired under `STATE-WP-0079`. A retiring component attracts a specific
+failure — work lands here because this is where the code already is, and each
+such change quietly re-establishes State Hub as the permanent owner of something
+the program is trying to relocate. Every one of those makes the cutover larger
+and the archive later.
+
+The freeze does not stop work. It constrains *what kind* of work is admissible.
+
+## The rule
+
+A change to `state-hub` is admissible only if it does at least one of:
+
+1. **Preserves compatibility** — keeps existing callers working across a cutover
+   step (adapters, dual-run shims, writeback reconciliation).
+2. **Enables extraction** — makes a capability easier to move to its inventoried
+   owner (seam-cutting, dependency untangling, contract extraction).
+3. **Reduces scope** — deletes, retires, or delegates a surface.
+4. **Fixes operational risk** — corrects a defect that would cause data loss,
+   corrupt evidence, or break a live caller before cutover.
+
+A change is **inadmissible** if it establishes new permanent ownership here:
+a new capability, a new authority, a new durable schema, or new automation whose
+natural home is one of the receiving owners.
+
+## The load-bearing case
+
+The four admissible reasons are deliberately broad, and reason 4 is the one that
+will be stretched. The test is not "is this a good change?" — most inadmissible
+changes are good changes. The test is **"where does this live after cutover?"**
+
+If the answer is "an owner repo," build it there and let State Hub adapt to it.
+If the answer is "nowhere, it disappears at archive," it is admissible here.
+If the answer is "State Hub, indefinitely," it is inadmissible regardless of merit.
+
+Worked example, from this program: `STATE-WP-0080` was drafted as a full
+flavor-awareness implementation inside `statehub_register.py`. It was good work
+and it fixed a real defect. It was still inadmissible — repository standards
+land in `repo-manager` after cutover — so it was retargeted to a guard plus a
+delegation, and the implementation moved to `RMGR-WP-0004`.
+
+## Enforcement
+
+**By review, not by new automation.** Building a freeze-checker inside State Hub
+would be new permanent automation in the component being retired — the policy
+would violate itself. The gate is applied where changes are already reviewed:
+
+| Point | Gate |
+| --- | --- |
+| New workplan in `workplans/` | Goal statement names which of the four reasons applies, or the plan is retargeted to an owner repo |
+| Task marked `progress` on a non-trivial change | Same question, answered in the task body |
+| Cutover slice execution (`STATE-WP-0079-T04`) | Slices are admissible by construction — they are reasons 1–3 |
+| Any new table, route, or MCP tool | Presumed inadmissible; requires an explicit note saying why it dies at archive |
+
+The last row is the only hard stop. New durable surface is exactly what the
+freeze exists to prevent, so it carries a presumption against, and the burden
+sits with the change.
+
+## What the freeze does not cover
+
+- **Receiving repos.** `repo-manager`, `hub-core`, `activity-core`, `ops-hub`,
+  and `fin-hub` are building the successor surfaces; they are unconstrained by
+  this policy and should be where new capability lands.
+- **Work records.** Workplans, ADRs, decision docs, and evidence files in this
+  repo are the retirement program's own record. Writing them is reason 2 or 3.
+- **`keep` items.** The 45 `keep`-dispositioned surfaces (`schema-history`,
+  ops-bridge connectivity, and the rest) stay operational until the freeze
+  window; maintaining them is reason 1.
+
+## Interaction with the quality gates
+
+Freeze admissibility is orthogonal to DoR/DoD (`docs/work-record-quality-gates.md`).
+A workplan can be `DoR-Ok` and still `Freeze-Failed` — well-specified work in the
+wrong repo is the exact failure this policy catches. Assess freeze first: it
+decides *whether* the work belongs here, before DoR asks whether it is ready.
diff --git a/policies/work-item-dor.md b/policies/work-item-dor.md
new file mode 100644
index 0000000..59ca581
--- /dev/null
+++ b/policies/work-item-dor.md
@@ -0,0 +1,129 @@
+# Definition of Ready (DoR)
+
+**Policy key:** `work-item-dor`  
+**applies_to:** `task`, `workplan` (separate sections below)  
+**Assessment outcomes:** `unassessed` | `DoR-Ok` | `DoR-Failed`  
+**Does not apply to:** intake (use DoC), decision, engagement (no DoR yet)
+
+**DoR** is the quality policy for **implementation-readiness** of delivery
+records. “Work-item” in the policy name means the **delivery side** of the
+work-record framework (executable units and their plans). In body text:
+
+- **task** = unit work-item  
+- **workplan** = structure (collection/plan over tasks), **not** “a large task”
+
+Lifecycle `status` is independent of DoR assessment:
+
+- Workplan `status=ready` is a process claim; **DoR-Ok** means this checklist
+  passed when last assessed.
+- A workplan may be `ready` or `active` without DoR-Ok (quality debt).
+- A task may enter `progress` without DoR-Ok; that is allowed but discouraged
+  for non-trivial work.
+
+Related:
+
+- Comprehension (discovery): `policies/intake-doc.md` (DoC)
+- Completion: `policies/workstream-dod.md` (DoD; exit companion)
+- Model: `docs/work-record-quality-gates.md`
+- Lifecycle: `dashboard/src/docs/workstream-lifecycle.md`
+
+---
+
+## Shared criteria (task and workplan)
+
+For **DoR-Ok**, the following always hold (kind sections add specifics):
+
+- [ ] **Outcome or done-condition** — what “good enough to stop” looks like, or
+  an explicit pointer to DoD / acceptance criteria.
+- [ ] **Scope in / out** — what is included and what is explicitly out of scope
+  (or “no material out-of-scope items”).
+- [ ] **Owning repo** — delivery repo is known and matches ADR-001 anchoring
+  (or the task’s parent workplan repo).
+- [ ] **Who executes** — owner/assignee or named agent role is clear enough to
+  start.
+- [ ] **Dependencies / blockers** — known dependencies listed, or an explicit
+  “none.” Unresolved hard blockers mean DoR-Failed until cleared or redesigned.
+- [ ] **Verification signal** — how we will know it worked (test, check,
+  manual verification note, or “N/A: pure docs” with reason).
+- [ ] **Lane / autonomy** — lane is set or inherited where the record supports
+  it; red/yellow work has human expectation stated if required by autonomy
+  policy.
+
+---
+
+## Section: task (`kind: task`)
+
+Additional **DoR-Ok** criteria for a task:
+
+- [ ] **Parent workplan** — task is attached to a workplan (or today’s ADHOC
+  workplan) so execution context is not free-floating.
+- [ ] **Actionable title** — describes a completable unit, not a multi-week
+  program (programs belong in a workplan with multiple tasks).
+- [ ] **Status intent** — starting `progress` is justified (not blocked on
+  missing input that should keep the task in `wait`).
+
+Tasks that are pure residual cleanup may be thin; still state done-condition
+and verification, even if one line each.
+
+---
+
+## Section: workplan (`kind: workplan`)
+
+Additional **DoR-Ok** criteria for a workplan:
+
+- [ ] **Goal** — one paragraph (or equivalent) for why this plan exists.
+- [ ] **Task decomposition** — open work is broken into tasks, or an explicit
+  note that the first task is “decompose further” with a bound.
+- [ ] **Review vs execute** — if `status=ready`, review metadata is present when
+  the plan claims repo-state review (`reviewed_at` / `reviewed_against_commit`
+  or equivalent narrative). Missing review metadata ⇒ prefer DoR-Failed for a
+  `ready` claim, or leave unassessed.
+- [ ] **Structure role respected** — the plan does not substitute for missing
+  DoC on a vague external spark; if the plan was promoted from intake, origin
+  link is present when available (`origin: intake:…`).
+
+Workplan **DoR-Ok** does not require all child tasks to be DoR-Ok; it requires
+the plan itself to be ready to *run as a structure*. Child tasks should be
+assessed when they are about to be executed.
+
+---
+
+## Outside-originated profile
+
+When the work-item or plan came from outside structural knowledge (promoted
+intake with external origin, third-party response work, external demand):
+
+- [ ] **Origin link** — `origin` / `origin_ref` or intake id / progress note
+  ties back to the discovery record.
+- [ ] **Boundary decision recorded** — ecosystem vs true third-party vs
+  external demand into us.
+- [ ] **Our work only** — scope describes *our* deliverable (patch, adapter,
+  doc, decision), not control of an external backlog.
+- [ ] **External reference** — issue/PR/URL or “none yet” with reason, when
+  third-party interaction is in scope.
+- [ ] **Residual unknowns** — still-open external uncertainties listed; none
+  that would make the first implementation step pure guesswork.
+
+---
+
+## Relationship to DoD and lifecycle
+
+| Gate | When | Policy |
+|------|------|--------|
+| DoC | Discovery understood | `intake-doc` |
+| DoR | Ready to implement | this file |
+| DoD | Quality-complete when finishing | `workstream-dod` |
+
+Finishing a workplan (`status=finished`) without **DoD-Ok** is allowed; treat
+as quality debt. Prefer DoR-Ok before heavy implementation; prefer DoD-Ok before
+calling the outcome high-quality complete.
+
+---
+
+## Assessment practice (convention)
+
+- Assessors: workplan owner, executing agent, or human operator.
+- Record `DoR-Ok` or `DoR-Failed` with date and failed criteria if any.
+- Re-assess after major scope change; stale DoR-Ok after large context shift
+  should be treated as unassessed or re-checked.
+- Enforcement is convention only (STATE-WP-0076); no API hard-block.
diff --git a/policies/workstream-dod.md b/policies/workstream-dod.md
index fca2713..2463a63 100644
--- a/policies/workstream-dod.md
+++ b/policies/workstream-dod.md
@@ -1,9 +1,40 @@
-# Workstream Definition of Done
+# Workplan Definition of Done (DoD)
 
-A workstream is considered finished if and only if:
-- All tasks in the workstream have been finished, found unnecessary or been transfered to another workstream
-- All referenced requirements have been adressed with nothing relevent missing or documented as out of scope with a stated reason
-- Relevant usecases have been captured in automated tests so that future changes can be tested to not break prior functionality unintendedly
-- The Repos README.txt and other documentation has been updated to optimize reusability for agents and humans
-- All tests can be run successfully 
-- Everything is properly checked in.
\ No newline at end of file
+**applies_to:** `workplan`  
+**Assessment outcomes:** `unassessed` | `DoD-Ok` | `DoD-Failed`  
+**Policy key:** `workstream-dod` (filename legacy; product term is **workplan**)
+
+A workplan may be assessed **DoD-Ok** when implementation quality is complete
+per the checklist below. Lifecycle **`status=finished` is not the same as
+DoD-Ok** — finishing without DoD-Ok is allowed quality debt (see
+`docs/work-record-quality-gates.md`).
+
+Record assessments with frontmatter:
+
+```yaml
+quality_dod: DoD-Ok   # or DoD-Failed
+quality_dod_at: "YYYY-MM-DD"
+quality_dod_by: "agent-or-human"
+# quality_dod_note: "optional"
+```
+
+Related: DoR (`policies/work-item-dor.md`), DoC (`policies/intake-doc.md`).
+
+---
+
+## Checklist
+
+A workplan is considered **DoD-Ok** when:
+
+- [ ] All tasks in the workplan have been finished, found unnecessary, or been
+  transferred to another workplan
+- [ ] All referenced requirements have been addressed with nothing relevant
+  missing, or documented as out of scope with a stated reason
+- [ ] Relevant use cases have been captured in automated tests so that future
+  changes can be tested to not break prior functionality unintentionally
+- [ ] The repo README and other documentation have been updated to optimize
+  reusability for agents and humans
+- [ ] All tests can be run successfully
+- [ ] Everything is properly checked in
+
+If assessed and any item fails, record **DoD-Failed** with a short note.
diff --git a/pyproject.toml b/pyproject.toml
index 44a18ec..c6580a2 100644
--- a/pyproject.toml
+++ b/pyproject.toml
@@ -33,14 +33,32 @@ build-backend = "hatchling.build"
 packages = ["api", "mcp_server", "task_flow_engine"]
 artifacts = [
     "custodian_cli.py",
+    "repository_rename_cli.py",
+    "repository_rename_workplan.py",
     "statehub_register.py",
     "scripts/consistency_check.py",
+    "scripts/quality_assessment.py",
+    "scripts/quality_debt.py",
     "scripts/repo_sync.py",
     "scripts/mcp_registration.py",
     "scripts/project_claude_md.template",
     "scripts/project_rules/*.template",
 ]
 
+[tool.hatch.build.targets.wheel.force-include]
+"custodian_cli.py" = "custodian_cli.py"
+"repository_rename_cli.py" = "repository_rename_cli.py"
+"repository_rename_workplan.py" = "repository_rename_workplan.py"
+"statehub_register.py" = "statehub_register.py"
+"scripts/consistency_check.py" = "scripts/consistency_check.py"
+"scripts/ensure_gitignore_claude_rules.py" = "scripts/ensure_gitignore_claude_rules.py"
+"scripts/quality_assessment.py" = "scripts/quality_assessment.py"
+"scripts/quality_debt.py" = "scripts/quality_debt.py"
+"scripts/repo_sync.py" = "scripts/repo_sync.py"
+"scripts/mcp_registration.py" = "scripts/mcp_registration.py"
+"scripts/project_claude_md.template" = "scripts/project_claude_md.template"
+"scripts/project_rules" = "scripts/project_rules"
+
 [tool.uv.sources]
 llm-connect = { path = "/home/worsch/llm-connect", editable = true }
 hub-core = { path = "/home/worsch/hub-core", editable = true }
diff --git a/repository_rename_cli.py b/repository_rename_cli.py
new file mode 100644
index 0000000..02e2fd1
--- /dev/null
+++ b/repository_rename_cli.py
@@ -0,0 +1,961 @@
+"""Non-interactive State Hub repository-rename orchestration CLI."""
+
+from __future__ import annotations
+
+import argparse
+import json
+import os
+import re
+import shlex
+import stat
+import sys
+import urllib.error
+import urllib.parse
+import urllib.request
+import uuid
+from pathlib import Path
+from typing import Any, Callable
+
+from repository_rename_workplan import (
+    WorkplanGenerationError,
+    build_generation_snapshot,
+    content_checksum,
+    default_output_path,
+    render_workplan,
+    write_workplan_exclusive,
+)
+
+
+CLI_SCHEMA_VERSION = "state-hub.repository-rename-cli.v1"
+DEFAULT_API_BASE = os.environ.get("API_BASE", "http://127.0.0.1:8000")
+FORWARD_PHASES = (
+    "forge-renamed",
+    "statehub-rebound",
+    "source-synced",
+    "consumers-verified",
+    "completed",
+)
+NEXT_PHASE = {
+    "preflighted": "forge-renamed",
+    "forge-renamed": "statehub-rebound",
+    "statehub-rebound": "source-synced",
+    "source-synced": "consumers-verified",
+    "consumers-verified": "completed",
+}
+_HEADERS = {"X-StateHub-Component": "state-hub.repository-rename-cli"}
+_SENSITIVE_KEYS = {
+    "authorization",
+    "cookie",
+    "set-cookie",
+    "password",
+    "secret",
+    "api-key",
+    "api_key",
+    "access-token",
+    "access_token",
+    "refresh-token",
+    "refresh_token",
+    "credential",
+}
+
+
+class RenameCLIError(RuntimeError):
+    def __init__(
+        self,
+        message: str,
+        *,
+        code: str = "rename_cli_error",
+        status_code: int | None = None,
+        details: Any = None,
+    ) -> None:
+        super().__init__(message)
+        self.code = code
+        self.status_code = status_code
+        self.details = details
+
+
+def _redact_text(value: str) -> str:
+    value = re.sub(
+        r"(https?://)[^/@\s]+:[^/@\s]+@",
+        r"\1[REDACTED]@",
+        value,
+        flags=re.IGNORECASE,
+    )
+    value = re.sub(
+        r"\b(Bearer|Basic)\s+[A-Za-z0-9._~+/=-]+",
+        r"\1 [REDACTED]",
+        value,
+        flags=re.IGNORECASE,
+    )
+    value = re.sub(
+        r"((?:^|[\s?&])[^=&#\s]*(?:api[_-]?key|authorization|password|secret|signature|token|credential)"
+        r"[^=&#\s]*=)[^&#\s]+",
+        r"\1[REDACTED]",
+        value,
+        flags=re.IGNORECASE,
+    )
+    return value
+
+
+def _public(value: Any, *, redact_preflight_token: bool = True) -> Any:
+    if isinstance(value, dict):
+        result: dict[str, Any] = {}
+        for key, item in value.items():
+            normalized = key.lower()
+            if normalized in _SENSITIVE_KEYS or any(
+                marker in normalized
+                for marker in ("password", "authorization", "credential")
+            ):
+                result[key] = "[REDACTED]"
+            elif key == "preflight_token" and redact_preflight_token and item:
+                result[key] = "[REDACTED: use --output preflight file]"
+            else:
+                result[key] = _public(
+                    item, redact_preflight_token=redact_preflight_token
+                )
+        return result
+    if isinstance(value, list):
+        return [
+            _public(item, redact_preflight_token=redact_preflight_token)
+            for item in value
+        ]
+    if isinstance(value, str):
+        return _redact_text(value)
+    return value
+
+
+def _api_request(
+    api_base: str,
+    method: str,
+    path: str,
+    body: dict[str, Any] | None = None,
+    *,
+    expected: type | tuple[type, ...] = dict,
+) -> Any:
+    data = json.dumps(body).encode("utf-8") if body is not None else None
+    headers = dict(_HEADERS)
+    if data is not None:
+        headers["Content-Type"] = "application/json"
+    request = urllib.request.Request(
+        api_base.rstrip("/") + path,
+        data=data,
+        headers=headers,
+        method=method,
+    )
+    try:
+        with urllib.request.urlopen(request, timeout=30) as response:
+            payload = json.loads(response.read())
+    except urllib.error.HTTPError as exc:
+        try:
+            payload = json.loads(exc.read())
+        except (json.JSONDecodeError, UnicodeDecodeError):
+            payload = {}
+        detail = payload.get("detail", payload) if isinstance(payload, dict) else {}
+        if isinstance(detail, dict):
+            message = str(detail.get("message") or f"State Hub returned HTTP {exc.code}")
+            code = str(detail.get("code") or "state_hub_http_error")
+            details = detail.get("details")
+        else:
+            message = str(detail or f"State Hub returned HTTP {exc.code}")
+            code = "state_hub_http_error"
+            details = None
+        raise RenameCLIError(
+            _redact_text(message),
+            code=code,
+            status_code=exc.code,
+            details=_public(details),
+        ) from exc
+    except (urllib.error.URLError, TimeoutError) as exc:
+        raise RenameCLIError(
+            "State Hub is unavailable",
+            code="state_hub_unavailable",
+            details={"reason": _redact_text(str(exc.reason if hasattr(exc, "reason") else exc))},
+        ) from exc
+    except (json.JSONDecodeError, UnicodeDecodeError) as exc:
+        raise RenameCLIError(
+            "State Hub returned an invalid JSON response",
+            code="invalid_state_hub_response",
+        ) from exc
+    if not isinstance(payload, expected):
+        expected_name = (
+            ", ".join(item.__name__ for item in expected)
+            if isinstance(expected, tuple)
+            else expected.__name__
+        )
+        raise RenameCLIError(
+            f"State Hub returned JSON with the wrong shape; expected {expected_name}",
+            code="invalid_state_hub_response",
+        )
+    return payload
+
+
+def _load_json(path: str, *, expected: type | tuple[type, ...]) -> Any:
+    try:
+        if path == "-":
+            value = json.load(sys.stdin)
+        else:
+            target = Path(path)
+            if target.stat().st_mode & (stat.S_IRWXG | stat.S_IRWXO):
+                raise RenameCLIError(
+                    f"Refusing non-private input file {target}; require mode 0600",
+                    code="unsafe_input_permissions",
+                )
+            value = json.loads(target.read_text(encoding="utf-8"))
+    except RenameCLIError:
+        raise
+    except (OSError, json.JSONDecodeError) as exc:
+        raise RenameCLIError(
+            f"Could not read JSON input {path}",
+            code="invalid_json_input",
+            details={"reason": _redact_text(str(exc))},
+        ) from exc
+    if not isinstance(value, expected):
+        names = (
+            ", ".join(item.__name__ for item in expected)
+            if isinstance(expected, tuple)
+            else expected.__name__
+        )
+        raise RenameCLIError(
+            f"JSON input {path} must contain {names}", code="invalid_json_input"
+        )
+    return value
+
+
+def _write_private_json(path: str, payload: dict[str, Any]) -> None:
+    target = Path(path)
+    target.parent.mkdir(parents=True, exist_ok=True)
+    try:
+        descriptor = os.open(target, os.O_WRONLY | os.O_CREAT | os.O_EXCL, 0o600)
+    except FileExistsError as exc:
+        raise RenameCLIError(
+            f"Refusing to overwrite existing preflight file {target}",
+            code="output_exists",
+        ) from exc
+    try:
+        with os.fdopen(descriptor, "w", encoding="utf-8") as handle:
+            json.dump(payload, handle, indent=2, sort_keys=True)
+            handle.write("\n")
+    except Exception:
+        target.unlink(missing_ok=True)
+        raise
+
+
+def _confirmation(repo_id: str, old_slug: str, new_slug: str) -> str:
+    return f"rename:{repo_id}:{old_slug}:{new_slug}"
+
+
+def _rollback_confirmation(operation_id: str) -> str:
+    return f"rollback:{operation_id}"
+
+
+def _validated_uuid(value: str, *, field: str = "operation ID") -> str:
+    try:
+        return str(uuid.UUID(value))
+    except (AttributeError, TypeError, ValueError) as exc:
+        raise RenameCLIError(
+            f"{field} must be a UUID",
+            code="invalid_operation_id",
+        ) from exc
+
+
+def _command(*parts: str | None) -> list[str]:
+    return [part for part in parts if part is not None]
+
+
+def _next_for_operation(operation: dict[str, Any]) -> dict[str, Any]:
+    operation_id = str(operation["id"])
+    repo_id = str(operation["repo_id"])
+    phase = str(operation["phase"])
+    confirmation = _confirmation(
+        repo_id, str(operation["old_slug"]), str(operation["new_slug"])
+    )
+    if phase in NEXT_PHASE:
+        target = NEXT_PHASE[phase]
+        command = _command(
+            "statehub",
+            "repo",
+            "rename",
+            "apply",
+            operation_id,
+            "--phase",
+            target,
+            "--confirm",
+            confirmation,
+        )
+        if target in {"source-synced", "consumers-verified"}:
+            command.extend(["--evidence-file", "<evidence.json>"])
+        if target == "consumers-verified":
+            command.extend(["--checks-file", "<checks.json>"])
+        return {
+            "action": "apply-phase",
+            "phase": target,
+            "expected_phase": phase,
+            "requires_confirmation": True,
+            "requires_evidence": target in {"source-synced", "consumers-verified"},
+            "requires_checks": target == "consumers-verified",
+            "command": command,
+        }
+    if phase == "rollback-preflight":
+        return {
+            "action": "execute-rollback",
+            "requires_confirmation": True,
+            "command": [
+                "statehub",
+                "repo",
+                "rename",
+                "rollback",
+                operation_id,
+                "--confirm",
+                _rollback_confirmation(operation_id),
+                "--execute",
+            ],
+        }
+    if phase == "completed":
+        return {"action": "none", "reason": "rename completed", "command": None}
+    if phase == "rolled-back":
+        return {"action": "none", "reason": "rename rolled back", "command": None}
+    return {
+        "action": "inspect",
+        "reason": f"unsupported or unknown phase {phase!r}",
+        "command": ["statehub", "repo", "rename", "status", operation_id],
+    }
+
+
+def _state_for_operation(operation: dict[str, Any]) -> str:
+    if operation.get("phase") == "rolled-back":
+        return "rolled-back"
+    if operation.get("error_code"):
+        return "failed"
+    if operation.get("phase") == "completed":
+        return "achieved"
+    return "planned"
+
+
+def _envelope(
+    command: str,
+    *,
+    state: str,
+    ok: bool,
+    result: dict[str, Any] | None = None,
+    operation_id: str | None = None,
+    repo_id: str | None = None,
+    phase: str | None = None,
+    next_safe_action: dict[str, Any] | None = None,
+    error: dict[str, Any] | None = None,
+) -> dict[str, Any]:
+    return {
+        "schema_version": CLI_SCHEMA_VERSION,
+        "command": command,
+        "ok": ok,
+        "state": state,
+        "operation_id": operation_id,
+        "repo_id": repo_id,
+        "phase": phase,
+        "next_safe_action": next_safe_action,
+        "result": result,
+        "error": error,
+    }
+
+
+def _emit(payload: dict[str, Any], *, as_json: bool) -> None:
+    public = _public(payload)
+    if as_json:
+        print(json.dumps(public, indent=2, sort_keys=True))
+        return
+    state = str(public["state"]).upper()
+    stream = sys.stderr if not public["ok"] else sys.stdout
+    print(f"{state}: repository rename {public['command']}", file=stream)
+    if public.get("operation_id"):
+        print(f"  operation: {public['operation_id']}", file=stream)
+    if public.get("repo_id"):
+        print(f"  repository: {public['repo_id']}", file=stream)
+    if public.get("phase"):
+        print(f"  phase: {public['phase']}", file=stream)
+    result = public.get("result") or {}
+    if public["command"] == "preflight":
+        print(f"  safe to apply: {bool(result.get('safe_to_apply'))}", file=stream)
+        print(f"  blockers: {len(result.get('blockers') or [])}", file=stream)
+        if result.get("preflight_file"):
+            print(f"  private preflight: {result['preflight_file']}", file=stream)
+    elif public["command"] == "generate-workplan" and result.get("output"):
+        print(f"  workplan: {result['output']}", file=stream)
+        print(f"  workplan id: {result.get('workplan_id')}", file=stream)
+    error = public.get("error")
+    if error:
+        print(f"  error: {error.get('message')}", file=stream)
+    action = public.get("next_safe_action") or {}
+    if action.get("action"):
+        print(f"  next safe action: {action['action']}", file=stream)
+    if action.get("command"):
+        print(f"  command: {shlex.join(action['command'])}", file=stream)
+
+
+def _run(args: argparse.Namespace, action: Callable[[], dict[str, Any]]) -> None:
+    try:
+        payload = action()
+    except RenameCLIError as exc:
+        payload = _envelope(
+            args.rename_command,
+            state="failed",
+            ok=False,
+            operation_id=getattr(args, "operation_id", None),
+            error={
+                "code": exc.code,
+                "message": str(exc),
+                "status_code": exc.status_code,
+                "details": exc.details,
+            },
+            next_safe_action={"action": "inspect-input-or-status", "command": None},
+        )
+        _emit(payload, as_json=args.as_json)
+        raise SystemExit(1) from exc
+    _emit(payload, as_json=args.as_json)
+    if not payload["ok"]:
+        raise SystemExit(2)
+
+
+def _resolve_repo(args: argparse.Namespace, slug: str) -> dict[str, Any]:
+    quoted = urllib.parse.quote(slug, safe="")
+    repo = _api_request(args.api_base, "GET", f"/repos/{quoted}")
+    if repo.get("slug_status") == "alias":
+        raise RenameCLIError(
+            f"{slug!r} is a prior alias; current canonical slug is {repo.get('canonical_slug')!r}",
+            code="old_slug_is_alias",
+        )
+    return repo
+
+
+def cmd_preflight(args: argparse.Namespace) -> None:
+    def action() -> dict[str, Any]:
+        operation_id = (
+            _validated_uuid(args.operation_id)
+            if args.operation_id
+            else str(uuid.uuid4())
+        )
+        if args.output and Path(args.output).exists():
+            raise RenameCLIError(
+                f"Refusing to overwrite existing preflight file {args.output}",
+                code="output_exists",
+            )
+        repo = _resolve_repo(args, args.old_slug)
+        edge_writes: list[dict[str, Any]] = []
+        if args.queued_edge_writes:
+            edge_writes = _load_json(args.queued_edge_writes, expected=list)
+            if not all(isinstance(item, dict) for item in edge_writes):
+                raise RenameCLIError(
+                    "Queued edge-write input must be a list of objects",
+                    code="invalid_json_input",
+                )
+        report = _api_request(
+            args.api_base,
+            "POST",
+            f"/repos/{repo['id']}/rename/preflight",
+            {"new_slug": args.new_slug, "queued_edge_writes": edge_writes},
+        )
+        confirmation = _confirmation(str(repo["id"]), args.old_slug, args.new_slug)
+        private = _envelope(
+            "preflight",
+            state="planned",
+            ok=bool(report.get("safe_to_apply")),
+            result=report,
+            operation_id=operation_id,
+            repo_id=str(repo["id"]),
+            phase=None,
+        )
+        if args.output:
+            _write_private_json(args.output, private)
+        if report.get("safe_to_apply") and args.output:
+            next_action = {
+                "action": "start-operation",
+                "requires_confirmation": True,
+                "command": [
+                    "statehub", "repo", "rename", "start",
+                    args.old_slug, args.new_slug,
+                    "--operation-id", operation_id,
+                    "--preflight-file", args.output,
+                    "--actor", "<actor>",
+                    "--confirm", confirmation,
+                ],
+            }
+        elif report.get("safe_to_apply"):
+            next_action = {
+                "action": "save-private-preflight",
+                "requires_confirmation": False,
+                "command": [
+                    "statehub", "repo", "rename", "preflight",
+                    args.old_slug, args.new_slug,
+                    "--operation-id", operation_id,
+                    "--output", "<preflight-report.json>",
+                ],
+            }
+        else:
+            next_action = {
+                "action": "resolve-blockers",
+                "requires_confirmation": False,
+                "command": None,
+            }
+        public_report = dict(report)
+        public_report["preflight_file"] = args.output
+        return _envelope(
+            "preflight",
+            state="planned" if report.get("safe_to_apply") else "failed",
+            ok=bool(report.get("safe_to_apply")),
+            result=public_report,
+            operation_id=operation_id,
+            repo_id=str(repo["id"]),
+            next_safe_action=next_action,
+        )
+
+    _run(args, action)
+
+
+def cmd_generate_workplan(args: argparse.Namespace) -> None:
+    def action() -> dict[str, Any]:
+        if args.output and Path(args.output).expanduser().exists():
+            raise RenameCLIError(
+                f"Refusing to overwrite existing workplan {args.output}",
+                code="output_exists",
+            )
+        repo = _resolve_repo(args, args.old_slug)
+        workplans = _api_request(
+            args.api_base,
+            "GET",
+            f"/workplans/?repo_id={urllib.parse.quote(str(repo['id']), safe='')}",
+            expected=list,
+        )
+        if args.preflight_file:
+            wrapper = _load_json(args.preflight_file, expected=dict)
+            if (
+                wrapper.get("schema_version") != CLI_SCHEMA_VERSION
+                or wrapper.get("command") != "preflight"
+                or str(wrapper.get("repo_id")) != str(repo["id"])
+            ):
+                raise RenameCLIError(
+                    "Preflight file is not for this registered repository",
+                    code="invalid_preflight_file",
+                )
+            report = wrapper.get("result") or {}
+        else:
+            report = _api_request(
+                args.api_base,
+                "POST",
+                f"/repos/{repo['id']}/rename/preflight",
+                {"new_slug": args.new_slug, "queued_edge_writes": []},
+            )
+        if (
+            report.get("old_slug") != args.old_slug
+            or report.get("new_slug") != args.new_slug
+        ):
+            raise RenameCLIError(
+                "Preflight snapshot does not address the requested rename",
+                code="invalid_preflight_file",
+            )
+        try:
+            snapshot = build_generation_snapshot(
+                repo=repo,
+                preflight=report,
+                workplans=workplans,
+                repo_path_override=args.repo_path,
+            )
+            content = render_workplan(snapshot, owner=args.owner)
+            output = (
+                Path(args.output).expanduser().resolve()
+                if args.output
+                else default_output_path(snapshot)
+            )
+            write_workplan_exclusive(output, content)
+        except WorkplanGenerationError as exc:
+            raise RenameCLIError(str(exc), code=exc.code) from exc
+        return _envelope(
+            "generate-workplan",
+            state="achieved",
+            ok=True,
+            result={
+                "output": str(output),
+                "workplan_id": snapshot.workplan_id,
+                "workplan_prefix": snapshot.prefix,
+                "content_checksum": content_checksum(content),
+                "preflight_report_checksum": report.get("report_checksum"),
+                "safe_to_apply_at_capture": bool(report.get("safe_to_apply")),
+                "path_available": snapshot.path_available,
+                "state_hub_uuid_fields_written": [],
+            },
+            repo_id=str(repo["id"]),
+            next_safe_action={
+                "action": "review-generated-workplan",
+                "requires_confirmation": False,
+                "command": None,
+            },
+        )
+
+    _run(args, action)
+
+
+def cmd_start(args: argparse.Namespace) -> None:
+    def action() -> dict[str, Any]:
+        operation_id = _validated_uuid(args.operation_id)
+        try:
+            existing = _api_request(
+                args.api_base,
+                "GET",
+                f"/repository-renames/operations/{operation_id}",
+            )
+        except RenameCLIError as exc:
+            if exc.status_code != 404:
+                raise
+        else:
+            expected_confirmation = _confirmation(
+                str(existing["repo_id"]),
+                str(existing["old_slug"]),
+                str(existing["new_slug"]),
+            )
+            if (
+                existing.get("old_slug") != args.old_slug
+                or existing.get("new_slug") != args.new_slug
+                or existing.get("actor") != args.actor
+                or args.confirm != expected_confirmation
+            ):
+                raise RenameCLIError(
+                    "Operation ID is already bound to another repository rename",
+                    code="operation_id_conflict",
+                )
+            existing = {**existing, "no_op": True}
+            return _operation_envelope("start", existing)
+
+        wrapper = _load_json(args.preflight_file, expected=dict)
+        if (
+            wrapper.get("schema_version") != CLI_SCHEMA_VERSION
+            or wrapper.get("command") != "preflight"
+        ):
+            raise RenameCLIError(
+                "Preflight file is not a repository-rename CLI preflight",
+                code="invalid_preflight_file",
+            )
+        if str(wrapper.get("operation_id")) != operation_id:
+            raise RenameCLIError(
+                "Preflight operation ID does not match --operation-id",
+                code="invalid_preflight_file",
+            )
+        report = wrapper.get("result") or {}
+        repo = _resolve_repo(args, args.old_slug)
+        if (
+            str(wrapper.get("repo_id")) != str(repo["id"])
+            or report.get("old_slug") != args.old_slug
+            or report.get("new_slug") != args.new_slug
+            or not report.get("safe_to_apply")
+            or not report.get("preflight_token")
+        ):
+            raise RenameCLIError(
+                "Preflight file does not authorize this repository rename",
+                code="invalid_preflight_file",
+            )
+        expected_confirmation = _confirmation(
+            str(repo["id"]), args.old_slug, args.new_slug
+        )
+        if args.confirm != expected_confirmation:
+            raise RenameCLIError(
+                "Explicit repository rename confirmation is incorrect",
+                code="confirmation_mismatch",
+            )
+        operation = _api_request(
+            args.api_base,
+            "POST",
+            f"/repos/{repo['id']}/rename/operations",
+            {
+                "operation_id": operation_id,
+                "new_slug": args.new_slug,
+                "preflight_token": report["preflight_token"],
+                "confirmation": args.confirm,
+                "actor": args.actor,
+                "queued_edge_writes": report.get("queued_edge_writes") or [],
+            },
+        )
+        return _operation_envelope("start", operation)
+
+    _run(args, action)
+
+
+def _load_operation(args: argparse.Namespace) -> dict[str, Any]:
+    operation_id = _validated_uuid(args.operation_id)
+    return _api_request(
+        args.api_base,
+        "GET",
+        f"/repository-renames/operations/{operation_id}",
+    )
+
+
+def _operation_envelope(command: str, operation: dict[str, Any]) -> dict[str, Any]:
+    return _envelope(
+        command,
+        state=_state_for_operation(operation),
+        ok=not bool(operation.get("error_code")),
+        result=operation,
+        operation_id=str(operation["id"]),
+        repo_id=str(operation["repo_id"]),
+        phase=str(operation["phase"]),
+        next_safe_action=_next_for_operation(operation),
+    )
+
+
+def cmd_status(args: argparse.Namespace) -> None:
+    _run(args, lambda: _operation_envelope("status", _load_operation(args)))
+
+
+def cmd_apply(args: argparse.Namespace) -> None:
+    def action() -> dict[str, Any]:
+        operation = _load_operation(args)
+        expected_confirmation = _confirmation(
+            str(operation["repo_id"]),
+            str(operation["old_slug"]),
+            str(operation["new_slug"]),
+        )
+        if args.confirm != expected_confirmation:
+            raise RenameCLIError(
+                "Explicit repository rename confirmation is incorrect",
+                code="confirmation_mismatch",
+            )
+        evidence = (
+            _load_json(args.evidence_file, expected=dict)
+            if args.evidence_file
+            else {}
+        )
+        checks = (
+            _load_json(args.checks_file, expected=dict)
+            if args.checks_file
+            else {}
+        )
+        if any(not isinstance(value, bool) for value in checks.values()):
+            raise RenameCLIError(
+                "Checks file values must all be booleans",
+                code="invalid_json_input",
+            )
+        updated = _api_request(
+            args.api_base,
+            "POST",
+            f"/repos/{operation['repo_id']}/rename/operations/{operation['id']}/phases/{args.phase}",
+            {
+                "expected_phase": args.expected_phase or operation["phase"],
+                "confirmation": args.confirm,
+                "checks": checks,
+                "evidence": evidence,
+            },
+        )
+        return _operation_envelope("apply", updated)
+
+    _run(args, action)
+
+
+def cmd_verify(args: argparse.Namespace) -> None:
+    def action() -> dict[str, Any]:
+        operation = _load_operation(args)
+        verification = _api_request(
+            args.api_base,
+            "GET",
+            f"/repos/{operation['repo_id']}/rename/operations/{operation['id']}/verify",
+        )
+        if verification.get("ok"):
+            next_action = _next_for_operation(operation)
+            state = "achieved"
+        else:
+            next_action = {
+                "action": "resolve-verification-failures",
+                "command": [
+                    "statehub", "repo", "rename", "status", str(operation["id"])
+                ],
+            }
+            state = "failed"
+        return _envelope(
+            "verify",
+            state=state,
+            ok=bool(verification.get("ok")),
+            result=verification,
+            operation_id=str(operation["id"]),
+            repo_id=str(operation["repo_id"]),
+            phase=str(operation["phase"]),
+            next_safe_action=next_action,
+        )
+
+    _run(args, action)
+
+
+def cmd_rollback(args: argparse.Namespace) -> None:
+    def action() -> dict[str, Any]:
+        operation = _load_operation(args)
+        operation_id = str(operation["id"])
+        expected_confirmation = _rollback_confirmation(operation_id)
+        if args.confirm != expected_confirmation:
+            raise RenameCLIError(
+                "Explicit rollback confirmation is incorrect",
+                code="confirmation_mismatch",
+            )
+        if operation["phase"] == "rolled-back":
+            return _operation_envelope("rollback", operation)
+        if operation["phase"] != "rollback-preflight":
+            preflight = _api_request(
+                args.api_base,
+                "POST",
+                f"/repos/{operation['repo_id']}/rename/operations/{operation_id}/rollback-preflight",
+                {
+                    "expected_phase": args.expected_phase or operation["phase"],
+                    "confirmation": args.confirm,
+                },
+            )
+            operation = preflight["operation"]
+            if not preflight.get("safe_to_rollback"):
+                raise RenameCLIError(
+                    "Repository rename rollback is unsafe",
+                    code="rollback_unsafe",
+                    details=preflight,
+                )
+        if not args.execute:
+            return _operation_envelope("rollback", operation)
+        rolled_back = _api_request(
+            args.api_base,
+            "POST",
+            f"/repos/{operation['repo_id']}/rename/operations/{operation_id}/rollback",
+            {"expected_phase": "rollback-preflight", "confirmation": args.confirm},
+        )
+        return _operation_envelope("rollback", rolled_back)
+
+    _run(args, action)
+
+
+def _common(parser: argparse.ArgumentParser) -> None:
+    parser.add_argument(
+        "--api-base", default=DEFAULT_API_BASE, help="State Hub API base URL"
+    )
+    parser.add_argument(
+        "--json",
+        action="store_true",
+        dest="as_json",
+        help="Emit the stable orchestration JSON contract",
+    )
+
+
+def configure_repo_commands(subparsers: argparse._SubParsersAction) -> None:
+    repo = subparsers.add_parser("repo", help="Repository lifecycle commands")
+    repo_sub = repo.add_subparsers(dest="repo_command", required=True)
+    rename = repo_sub.add_parser(
+        "rename", help="Governed repository rename lifecycle"
+    )
+    rename_sub = rename.add_subparsers(dest="rename_command", required=True)
+
+    preflight = rename_sub.add_parser(
+        "preflight",
+        help="Inspect rename safety without mutating State Hub or Forgejo",
+    )
+    preflight.add_argument("old_slug")
+    preflight.add_argument("new_slug")
+    preflight.add_argument(
+        "--operation-id",
+        default=None,
+        help="Client-owned UUID; generated when omitted",
+    )
+    preflight.add_argument(
+        "--queued-edge-writes",
+        default=None,
+        help="Mode-0600 JSON list of queued-write evidence",
+    )
+    preflight.add_argument(
+        "--output",
+        default=None,
+        help="Write the token-bearing preflight envelope to a new mode-0600 file",
+    )
+    _common(preflight)
+    preflight.set_defaults(func=cmd_preflight)
+
+    generate = rename_sub.add_parser(
+        "generate-workplan",
+        help="Generate a repository-native rename adoption workplan",
+    )
+    generate.add_argument("old_slug")
+    generate.add_argument("new_slug")
+    generate.add_argument(
+        "--preflight-file",
+        default=None,
+        help="Use a private mode-0600 preflight envelope instead of refreshing",
+    )
+    generate.add_argument(
+        "--repo-path",
+        default=None,
+        help="Visible target checkout used for workplan convention discovery",
+    )
+    generate.add_argument(
+        "--output",
+        default=None,
+        help="Exclusive output path; defaults to the target workplans directory",
+    )
+    generate.add_argument("--owner", default="codex")
+    _common(generate)
+    generate.set_defaults(func=cmd_generate_workplan)
+
+    start = rename_sub.add_parser(
+        "start",
+        help="Create an idempotent operation journal from a private preflight file",
+    )
+    start.add_argument("old_slug")
+    start.add_argument("new_slug")
+    start.add_argument("--operation-id", required=True)
+    start.add_argument(
+        "--preflight-file",
+        required=True,
+        help="Mode-0600 preflight file, or - for stdin",
+    )
+    start.add_argument("--actor", required=True)
+    start.add_argument("--confirm", required=True, metavar="CONFIRMATION")
+    _common(start)
+    start.set_defaults(func=cmd_start)
+
+    apply = rename_sub.add_parser(
+        "apply", help="Apply exactly one compare-and-set lifecycle phase"
+    )
+    apply.add_argument("operation_id")
+    apply.add_argument("--phase", required=True, choices=FORWARD_PHASES)
+    apply.add_argument("--expected-phase", default=None)
+    apply.add_argument("--confirm", required=True, metavar="CONFIRMATION")
+    apply.add_argument(
+        "--evidence-file",
+        default=None,
+        help="Mode-0600 JSON object, or - for stdin",
+    )
+    apply.add_argument(
+        "--checks-file", default=None, help="Mode-0600 JSON boolean map"
+    )
+    _common(apply)
+    apply.set_defaults(func=cmd_apply)
+
+    status_parser = rename_sub.add_parser(
+        "status", help="Read the durable operation journal"
+    )
+    status_parser.add_argument("operation_id")
+    _common(status_parser)
+    status_parser.set_defaults(func=cmd_status)
+
+    verify = rename_sub.add_parser(
+        "verify", help="Verify Forge identity and State Hub continuity"
+    )
+    verify.add_argument("operation_id")
+    _common(verify)
+    verify.set_defaults(func=cmd_verify)
+
+    rollback = rename_sub.add_parser(
+        "rollback",
+        help="Preflight rollback; --execute is required to perform it",
+    )
+    rollback.add_argument("operation_id")
+    rollback.add_argument("--expected-phase", default=None)
+    rollback.add_argument("--confirm", required=True, metavar="CONFIRMATION")
+    rollback.add_argument(
+        "--execute",
+        action="store_true",
+        help="Execute after rollback preflight succeeds",
+    )
+    _common(rollback)
+    rollback.set_defaults(func=cmd_rollback)
+
+
+__all__ = [
+    "CLI_SCHEMA_VERSION",
+    "RenameCLIError",
+    "configure_repo_commands",
+]
diff --git a/repository_rename_workplan.py b/repository_rename_workplan.py
new file mode 100644
index 0000000..4f67fcf
--- /dev/null
+++ b/repository_rename_workplan.py
@@ -0,0 +1,732 @@
+"""Deterministic repository-native workplan generation for repository renames."""
+
+from __future__ import annotations
+
+import hashlib
+import json
+import os
+import re
+import uuid
+from collections import Counter
+from dataclasses import dataclass
+from pathlib import Path
+from typing import Any, Iterable
+
+import yaml
+
+
+_WORKPLAN_ID = re.compile(
+    r"^(?P<prefix>[A-Z][A-Z0-9]*(?:-[A-Z][A-Z0-9]*)*-WP)-"
+    r"(?P<number>\d+)$"
+)
+_DECLARED_PREFIX = re.compile(
+    r"workplan\s+prefix[^`\n]*`?(?P<prefix>[A-Z][A-Z0-9-]*-WP)-?`?",
+    re.IGNORECASE,
+)
+_FRONTMATTER = re.compile(r"\A---\s*\n(?P<yaml>.*?)\n---(?:\s*\n|\Z)", re.DOTALL)
+
+
+class WorkplanGenerationError(RuntimeError):
+    """Raised when a safe repository-native plan cannot be generated."""
+
+    def __init__(self, message: str, *, code: str) -> None:
+        super().__init__(message)
+        self.code = code
+
+
+@dataclass(frozen=True)
+class WorkplanGenerationSnapshot:
+    repo: dict[str, Any]
+    preflight: dict[str, Any]
+    workplans: tuple[dict[str, Any], ...]
+    prefix: str
+    workplan_id: str
+    task_width: int
+    topic_slug: str
+    repo_path: str | None
+    path_available: bool
+    observed_workplan_ids: tuple[str, ...]
+    archived_workplan_ids: tuple[str, ...]
+
+    @property
+    def old_slug(self) -> str:
+        return str(self.preflight["old_slug"])
+
+    @property
+    def new_slug(self) -> str:
+        return str(self.preflight["new_slug"])
+
+
+def _frontmatter(path: Path) -> dict[str, Any]:
+    try:
+        text = path.read_text(encoding="utf-8")
+    except OSError:
+        return {}
+    match = _FRONTMATTER.match(text)
+    if match is None:
+        return {}
+    try:
+        value = yaml.safe_load(match.group("yaml")) or {}
+    except yaml.YAMLError:
+        return {}
+    return value if isinstance(value, dict) else {}
+
+
+def _local_metadata(repo_path: Path | None) -> tuple[list[dict[str, Any]], str | None]:
+    if repo_path is None or not repo_path.is_dir():
+        return [], None
+    declared: str | None = None
+    agents = repo_path / "AGENTS.md"
+    try:
+        match = _DECLARED_PREFIX.search(agents.read_text(encoding="utf-8"))
+    except OSError:
+        match = None
+    if match:
+        declared = match.group("prefix").upper().rstrip("-")
+
+    rows: list[dict[str, Any]] = []
+    workplans = repo_path / "workplans"
+    if workplans.is_dir():
+        for path in sorted(workplans.rglob("*.md")):
+            meta = _frontmatter(path)
+            record_id = str(meta.get("id") or "").upper()
+            if not _WORKPLAN_ID.match(record_id):
+                filename = path.name
+                if re.match(r"^\d{6}-", filename):
+                    filename = filename[7:]
+                filename_match = re.match(
+                    r"^(?P<id>[A-Z][A-Z0-9-]*-WP-\d+)", filename
+                )
+                record_id = filename_match.group("id") if filename_match else ""
+            if _WORKPLAN_ID.match(record_id):
+                rows.append(
+                    {
+                        "record_id": record_id,
+                        "topic_slug": meta.get("topic_slug"),
+                        "status": meta.get("status"),
+                        "archived": "archived" in path.relative_to(workplans).parts,
+                        "state_hub_workstream_id": meta.get(
+                            "state_hub_workstream_id"
+                        ),
+                    }
+                )
+    return rows, declared
+
+
+def _record_id(row: dict[str, Any]) -> str | None:
+    candidates = (
+        row.get("record_id"),
+        row.get("slug"),
+        row.get("backing_filename"),
+        row.get("backing_relative_path"),
+    )
+    for candidate in candidates:
+        if not candidate:
+            continue
+        match = re.search(
+            r"([A-Z][A-Z0-9]*(?:-[A-Z][A-Z0-9]*)*-WP-\d+)",
+            str(candidate).upper(),
+        )
+        if match and _WORKPLAN_ID.match(match.group(1)):
+            return match.group(1)
+    return None
+
+
+def _select_prefix(
+    records: Iterable[dict[str, Any]], declared_prefix: str | None
+) -> tuple[str, list[str]]:
+    ids = sorted({record_id for row in records if (record_id := _record_id(row))})
+    matches = [_WORKPLAN_ID.match(record_id) for record_id in ids]
+    prefixes = Counter(
+        match.group("prefix") for match in matches if match is not None
+    )
+    if declared_prefix:
+        if prefixes and declared_prefix not in prefixes:
+            raise WorkplanGenerationError(
+                f"Declared workplan prefix {declared_prefix!r} conflicts with "
+                f"observed prefixes {sorted(prefixes)!r}",
+                code="workplan_prefix_conflict",
+            )
+        return declared_prefix, ids
+    if not prefixes:
+        raise WorkplanGenerationError(
+            "Repository has no established workplan prefix; scaffold or declare one first",
+            code="workplan_prefix_missing",
+        )
+    if len(prefixes) != 1:
+        raise WorkplanGenerationError(
+            f"Repository workplan prefix is ambiguous: {sorted(prefixes)!r}",
+            code="workplan_prefix_ambiguous",
+        )
+    return next(iter(prefixes)), ids
+
+
+def _next_workplan_id(prefix: str, ids: Iterable[str]) -> str:
+    numbers: list[int] = []
+    widths: list[int] = []
+    for record_id in ids:
+        match = _WORKPLAN_ID.match(record_id)
+        if match and match.group("prefix") == prefix:
+            raw = match.group("number")
+            numbers.append(int(raw))
+            widths.append(len(raw))
+    width = max([4, *widths])
+    return f"{prefix}-{max(numbers, default=0) + 1:0{width}d}"
+
+
+def _repo_path(repo: dict[str, Any], override: str | None) -> Path | None:
+    candidates = [override, repo.get("local_path")]
+    candidates.extend((repo.get("host_paths") or {}).values())
+    for candidate in candidates:
+        if candidate:
+            path = Path(str(candidate)).expanduser()
+            if path.is_dir():
+                return path.resolve()
+    if override:
+        return Path(override).expanduser().resolve()
+    return None
+
+
+def build_generation_snapshot(
+    *,
+    repo: dict[str, Any],
+    preflight: dict[str, Any],
+    workplans: Iterable[dict[str, Any]],
+    repo_path_override: str | None = None,
+) -> WorkplanGenerationSnapshot:
+    """Normalize volatile API data into a deterministic render snapshot."""
+    try:
+        repo_id = str(uuid.UUID(str(repo.get("id"))))
+    except (TypeError, ValueError) as exc:
+        raise WorkplanGenerationError(
+            "Registered repository is missing its stable State Hub UUID",
+            code="repository_identity_missing",
+        ) from exc
+    if repo_id != str(preflight.get("repo_id")):
+        raise WorkplanGenerationError(
+            "Preflight repository UUID does not match the registered repository",
+            code="preflight_repository_mismatch",
+        )
+    if not preflight.get("old_slug") or not preflight.get("new_slug"):
+        raise WorkplanGenerationError(
+            "Preflight snapshot is missing old/new repository slugs",
+            code="invalid_preflight_snapshot",
+        )
+    if not re.match(
+        r"^\d{4}-\d{2}-\d{2}", str(preflight.get("preflighted_at") or "")
+    ):
+        raise WorkplanGenerationError(
+            "Preflight snapshot is missing a stable capture date",
+            code="invalid_preflight_snapshot",
+        )
+
+    path = _repo_path(repo, repo_path_override)
+    local_rows, declared_prefix = _local_metadata(
+        path if path and path.is_dir() else None
+    )
+    api_rows = [dict(row) for row in workplans]
+    all_rows = [*api_rows, *local_rows]
+    prefix, ids = _select_prefix(all_rows, declared_prefix)
+    workplan_id = _next_workplan_id(prefix, ids)
+
+    topic_counts = Counter(
+        str(row.get("topic_slug"))
+        for row in local_rows
+        if row.get("topic_slug")
+    )
+    topic_slug = (
+        topic_counts.most_common(1)[0][0]
+        if topic_counts
+        else str(repo.get("domain_slug") or "repository-rename")
+    )
+    archived = sorted(
+        {
+            record_id
+            for row in all_rows
+            if (record_id := _record_id(row))
+            and (
+                bool(row.get("archived"))
+                or str(row.get("status", "")).lower() == "archived"
+                or bool(row.get("backing_archived"))
+            )
+        }
+    )
+    return WorkplanGenerationSnapshot(
+        repo=dict(repo),
+        preflight=dict(preflight),
+        workplans=tuple(sorted(api_rows, key=lambda row: str(row.get("slug", "")))),
+        prefix=prefix,
+        workplan_id=workplan_id,
+        task_width=2,
+        topic_slug=topic_slug,
+        repo_path=str(path) if path else None,
+        path_available=bool(path and path.is_dir()),
+        observed_workplan_ids=tuple(ids),
+        archived_workplan_ids=tuple(archived),
+    )
+
+
+def _json_detail(item: dict[str, Any]) -> str:
+    safe = {
+        key: value
+        for key, value in item.items()
+        if key not in {"preflight_token", "authorization", "credential", "password"}
+    }
+    return json.dumps(safe, sort_keys=True, separators=(",", ":"))
+
+
+def _risk_register(snapshot: WorkplanGenerationSnapshot) -> str:
+    report = snapshot.preflight
+    rows: list[tuple[str, str, str]] = []
+    for severity, key in (("blocker", "blockers"), ("warning", "warnings")):
+        for item in report.get(key) or []:
+            rows.append(
+                (
+                    severity,
+                    str(item.get("code") or "unnamed"),
+                    _json_detail(item),
+                )
+            )
+    for handoff in (report.get("affected") or {}).get("external_handoffs") or []:
+        rows.append(
+            (
+                "external-handoff",
+                str(handoff),
+                "Owning repository must be recorded during inventory",
+            )
+        )
+    forge_identity = (report.get("current") or {}).get("forge_identity") or {}
+    if forge_identity.get("verification_state") != "verified":
+        rows.append(
+            (
+                "blocker",
+                "forge-identity-unverified",
+                "Immutable Forge identity must be verified before mutation",
+            )
+        )
+    if not (report.get("current") or {}).get("forge_available", False):
+        rows.append(
+            (
+                "blocker",
+                "forge-repository-unreadable",
+                "Private/unreadable Forge state cannot be inferred from a local clone",
+            )
+        )
+    if not snapshot.path_available:
+        rows.append(
+            (
+                "warning",
+                "local-path-unavailable",
+                "Generation used indexed workplans; baseline needs a visible checkout",
+            )
+        )
+    if not rows:
+        rows.append(("none", "no-preflight-risks", "No blocker or warning reported"))
+    return "\n".join(
+        f"| {severity} | `{code}` | `{detail.replace('|', '\\|')}` |"
+        for severity, code, detail in sorted(rows)
+    )
+
+
+def _active_work(snapshot: WorkplanGenerationSnapshot) -> str:
+    active = snapshot.preflight.get("active_work") or {}
+    rows: list[str] = []
+    for workplan in sorted(active.get("workplans") or [], key=lambda row: str(row.get("slug"))):
+        rows.append(
+            f"- workplan `{workplan.get('slug')}` / `{workplan.get('id')}` "
+            f"is `{workplan.get('status')}`"
+        )
+    for task in sorted(active.get("tasks") or [], key=lambda row: str(row.get("id"))):
+        rows.append(
+            f"- task `{task.get('record_id') or task.get('id')}` / `{task.get('id')}` "
+            f"is `{task.get('status')}`"
+        )
+    return "\n".join(rows) if rows else "- No active work was reported by preflight."
+
+
+def _task(snapshot: WorkplanGenerationSnapshot, number: int, title: str, status: str) -> str:
+    task_id = f"{snapshot.workplan_id}-T{number:0{snapshot.task_width}d}"
+    return (
+        f"## {number}. {title}\n\n"
+        "```task\n"
+        f"id: {task_id}\n"
+        f"status: {status}\n"
+        "priority: high\n"
+        "```\n"
+    )
+
+
+def render_workplan(snapshot: WorkplanGenerationSnapshot, *, owner: str) -> str:
+    """Render the adoption plan. No current clock or random value is consulted."""
+    report = snapshot.preflight
+    repo = snapshot.repo
+    old_slug = snapshot.old_slug
+    new_slug = snapshot.new_slug
+    current = report.get("current") or {}
+    statehub = current.get("statehub") or {}
+    forge = current.get("forge") or {}
+    forge_identity = current.get("forge_identity") or {}
+    preflight_at = str(report.get("preflighted_at") or "")[:10]
+    created = preflight_at
+    source_commit = forge.get("head_commit") or "UNAVAILABLE"
+    forge_id = (
+        forge_identity.get("forge_repository_id")
+        or forge.get("repository_id")
+        or "UNVERIFIED"
+    )
+    aliases = sorted(
+        {
+            str(alias)
+            for alias in [*(repo.get("aliases") or []), old_slug]
+            if alias
+        }
+    )
+    safe = bool(report.get("safe_to_apply"))
+    status = "ready" if safe and source_commit != "UNAVAILABLE" else "proposed"
+    reviewed = (
+        f'reviewed_at: "{created}"\n'
+        "reviewed_by: statehub-repository-rename-generator\n"
+        f'reviewed_against_commit: "{source_commit}"\n'
+        if source_commit != "UNAVAILABLE"
+        else ""
+    )
+    confirmation = f"rename:{repo['id']}:{old_slug}:{new_slug}"
+    output = f'''---
+id: {snapshot.workplan_id}
+type: workplan
+title: "Repository identity migration from {old_slug} to {new_slug}"
+domain: {json.dumps(str(repo.get("domain_slug") or "unknown"))}
+repo: {json.dumps(old_slug)}
+status: {status}
+owner: {json.dumps(owner)}
+topic_slug: {json.dumps(snapshot.topic_slug)}
+created: "{created}"
+updated: "{created}"
+{reviewed}quality_dor: DoR-Ok
+quality_dor_at: "{created}"
+quality_dor_by: statehub-repository-rename-generator
+---
+
+# {snapshot.workplan_id} — {old_slug} to {new_slug}
+
+## Goal and authority boundary
+
+Adopt the new repository coordinate `{new_slug}` while preserving State Hub
+repository UUID `{repo['id']}`, Forge repository ID `{forge_id}`, source commit
+`{source_commit}`, work-record identities, and telemetry relationships.
+
+This plan changes repository coordinates only. Product/runtime names are a
+separate explicit decision. No task in this file may close work owned by
+another repository: it records the external handoff ID and waits for evidence
+from that owning repository.
+
+Live Forgejo rename, State Hub rebind, rollback, and old-checkout cleanup are
+Red-lane actions. They require the exact confirmations below and recorded
+human approval; redirects are compatibility evidence, not completion.
+
+## Captured preflight
+
+- schema: `{report.get('schema_version')}`
+- report checksum: `{report.get('report_checksum') or 'UNAVAILABLE'}`
+- safe to apply at capture: `{str(safe).lower()}`
+- State Hub repository UUID: `{repo['id']}`
+- Forge repository ID: `{forge_id}`
+- default branch: `{forge.get('default_branch') or 'UNAVAILABLE'}`
+- source commit: `{source_commit}`
+- registered local path: `{statehub.get('local_path') or repo.get('local_path') or 'UNAVAILABLE'}`
+- host paths: `{json.dumps(statehub.get('host_paths') or repo.get('host_paths') or {}, sort_keys=True)}`
+- protected/current aliases: `{json.dumps(aliases)}`
+- existing workplans observed: `{len(snapshot.observed_workplan_ids)}`
+- archived workplans observed: `{len(snapshot.archived_workplan_ids)}`
+
+The preflight token is deliberately not stored in this workplan. Generate a
+fresh private mode-0600 preflight file immediately before execution.
+
+## Preflight risk register
+
+Every blocker, warning, and external handoff from the captured snapshot is
+retained here. T05 must reconcile every row; unknown ownership is a blocker.
+
+| Severity | Code | Captured detail |
+| --- | --- | --- |
+{_risk_register(snapshot)}
+
+## Active-work coordination snapshot
+
+{_active_work(snapshot)}
+
+## External ownership ledger
+
+| Effect | Owning repository | What this plan may claim |
+| --- | --- | --- |
+| State Hub identity and aliases | `state-hub` | Record operation phase/evidence only; State Hub owns the mutation. |
+| Forge-derived fabric projection | `railiance-fabric` | Record a handoff ID; only that repository closes its source change. |
+| Credential-route catalog | `ops-warden` | Record route-review handoff; never request or store a secret here. |
+| SBOM projection | `sbom-nexus` | Record re-ingestion evidence; SBOM Nexus owns its projection. |
+| CI, package, deployment, policy, and runtime consumers | `<owning-repository>` | T04 must replace this with one exact repository slug and handoff ID per consumer. |
+
+'''
+
+    output += _task(snapshot, 1, "Capture immutable cleanliness and identity baseline", "todo")
+    output += f'''
+Owner: `{old_slug}`.
+
+- Require a clean target checkout and every branch/tag/change secured to Forgejo.
+- Record `git status`, branch, remote, source commit, default branch, Forge ID,
+  visibility/readability, protected branches, releases, packages, hooks, deploy
+  keys, Actions variables, and redirects.
+- Reconcile active work above: quiesce it or record an explicit concurrent-work
+  decision. A moved source commit requires a new preflight.
+- If no registered path is visible, stop and register/verify a checkout; do not
+  infer private Forge state from local Git.
+
+Gate: repository UUID, Forge ID, branch, commit, and clean-state evidence are
+recorded and match a fresh State Hub preflight.
+
+'''
+    output += _task(snapshot, 2, "Prepare repository metadata and work-record frontmatter", "todo")
+    output += f'''
+Owner: `{old_slug}`.
+
+- Prepare repository metadata, README/INTENT/SCOPE/AGENTS references, Forge
+  description/topics, and canonical clone coordinates for `{new_slug}`.
+- Keep the established `{snapshot.prefix}-` workplan/task prefix and all existing
+  `state_hub_workstream_id` / `state_hub_task_id` values unchanged.
+- Do not mass-rewrite historical prose or old-slug provenance. New live
+  frontmatter may adopt `repo: {new_slug}` only after State Hub rebind.
+- Commit preparatory source changes before the final preflight; record the new
+  intended source commit.
+
+Gate: work-record parsing succeeds and no existing UUID field was removed,
+replaced, or invented.
+
+'''
+    output += _task(snapshot, 3, "Decide product and runtime naming separately", "todo")
+    output += f'''
+Owner: `{old_slug}`.
+
+Record explicit keep/rename decisions for the binary, Go module/import path,
+`FLEX_AUTH_*` environment variables, Kubernetes namespace, service/DNS names,
+Helm release/chart, container/package coordinates, policy vocabulary, API
+names, dashboards, and telemetry service labels. Repository rename approval
+does not authorize any of these runtime/product changes.
+
+Gate: every item has a decision record and independently deployable changes
+have their own workplan or residual handoff.
+
+'''
+    output += _task(snapshot, 4, "Inventory consumers and create owned handoffs", "todo")
+    output += f'''
+Owner: `{old_slug}` for inventory and handoff creation only.
+
+- Inventory CI includes/actions, package and image publishers, deployments,
+  GitOps/Helm/Kubernetes references, credential routes (using `warden route`),
+  authorization and NetKingdom policy consumers, fabric sources, SBOM scans,
+  docs, badges, webhooks, mirrors, caches, dashboards, alerts, and local clones.
+- For each external effect, replace `<owning-repository>` in the ledger with the
+  exact repository slug and create a live residual/intake/workplan there.
+- Record each external work-record ID here and attach a
+  `state-hub.repository-rename-handoff.v1` payload following
+  `state-hub/docs/schemas/repository-rename-handoff-v1.schema.json`. It names
+  the source repository, old/new slug, affected paths or graph IDs, required
+  re-ingest and verification, owning workplan/task, and non-secret evidence.
+- Do not mark that external work done from this repository; completion evidence
+  must come from its owner.
+- Include every row in the preflight risk register, even when it is only a
+  warning or currently zero-count projection.
+
+Gate: every discovered external change has one named owning repository and
+durable handoff ID; unknown ownership blocks the live rename.
+
+'''
+    output += _task(snapshot, 5, "Renew State Hub preflight and record approval", "todo")
+    output += f'''
+Owner: `{old_slug}`.
+
+```text
+statehub repo rename preflight {old_slug} {new_slug} \\
+  --operation-id <operation-id> \\
+  --output <private-preflight.json> --json
+```
+
+Verify zero blockers, immutable IDs/commit, active-work disposition, target
+availability, every risk-register row, and no queued edge writes. Record a
+human decision approving exact operation ID, source commit, target slug, owner,
+window, rollback limits, and confirmation `{confirmation}`.
+
+Gate: a current private preflight and explicit human approval exist. Never
+commit the private preflight file or its token.
+
+'''
+    output += _task(snapshot, 6, "Execute the Forgejo repository rename", "wait")
+    output += f'''
+Owner: `{old_slug}`; human approval required.
+
+Start/retry the durable journal, then apply exactly the Forge phase:
+
+```text
+statehub repo rename start {old_slug} {new_slug} \\
+  --operation-id <operation-id> --preflight-file <private-preflight.json> \\
+  --actor <actor> --confirm '{confirmation}' --json
+statehub repo rename apply <operation-id> --phase forge-renamed \\
+  --confirm '{confirmation}' --json
+```
+
+Confirm Forgejo reports the same numeric repository ID and commit under
+`{new_slug}`. Stop on identity drift, unreadability, target conflict, or moved
+source; do not create a second State Hub repository.
+
+Gate: operation journal is `forge-renamed` with immutable identity evidence.
+
+'''
+    output += _task(snapshot, 7, "Record the State Hub identity rebind", "wait")
+    output += f'''
+Owner: `{old_slug}` for coordination; `state-hub` owns the mutation.
+
+```text
+statehub repo rename apply <operation-id> --phase statehub-rebound \\
+  --confirm '{confirmation}' --json
+statehub repo rename status <operation-id> --json
+```
+
+Record State Hub's phase evidence. Verify both `{old_slug}` and `{new_slug}`
+resolve to repository UUID `{repo['id']}`, `{new_slug}` is canonical, and the old
+slug is a protected alias. Do not manually update the database.
+
+Gate: State Hub journal is `statehub-rebound`; IDs and historical relationships
+are unchanged.
+
+'''
+    output += _task(snapshot, 8, "Establish and register a fresh canonical clone", "wait")
+    output += f'''
+Owner: `{new_slug}` after rebind.
+
+- Preserve the old checkout until verification and rollback decisions finish.
+- Clone `{new_slug}` into a new path; verify origin and Forge numeric ID before
+  trusting redirects.
+- Register the fresh path against the existing State Hub UUID, update canonical
+  source metadata/frontmatter, commit the source-synchronization revision, and
+  run `statehub fix-consistency` from the new clone.
+- Apply `source-synced` with mode-0600 evidence containing
+  `fresh_clone: true`, Forge numeric `forge_repository_id`, exact `head_commit`,
+  clone path, registration result, and consistency result. Remote coordinates
+  contain no embedded credential.
+
+Gate: no duplicate repository registration exists and the journal is
+`source-synced`.
+
+'''
+    output += _task(
+        snapshot,
+        9,
+        "Verify identity, history, routes, builds, and deployments",
+        "wait",
+    )
+    output += f'''
+Owner: `{new_slug}` for aggregation; each external owner supplies its evidence.
+
+Compare relationship checksums—not only counts—for repository UUID, workplans,
+tasks, progress, decisions, token events/totals, SBOM snapshots, services,
+capabilities, messages, aliases, bindings, and active dispatch. Verify old/new
+routes, Forge ID/commit, clean builds/tests, package/image publication, policy
+and credential routes, fabric/SBOM projections, deployments, health, dashboards,
+alerts, and telemetry continuity.
+
+```text
+statehub repo rename verify <operation-id> --json
+statehub repo rename apply <operation-id> --phase consumers-verified \\
+  --checks-file <private-checks.json> --evidence-file <private-evidence.json> \\
+  --confirm '{confirmation}' --json
+statehub repo rename apply <operation-id> --phase completed \\
+  --confirm '{confirmation}' --json
+```
+
+Gate: every required local check passes and every external handoff is `verified`
+with evidence from its owning repository before completion.
+
+'''
+    output += _task(snapshot, 10, "Exercise rollback decision points", "wait")
+    output += f'''
+Owner: `{new_slug}` for the decision; State Hub and Forge owners execute their
+own reversible phases.
+
+At every phase decide continue, pause safely, or enter rollback preflight.
+Rollback is allowed only if the old Forge slug remains available and named
+external effects are reversible. It never deletes aliases or history.
+
+```text
+statehub repo rename rollback <operation-id> \\
+  --confirm 'rollback:<operation-id>' --json
+# Execute only after reviewing safe_to_rollback and irreversible handoffs:
+statehub repo rename rollback <operation-id> \\
+  --confirm 'rollback:<operation-id>' --execute --json
+```
+
+Gate: the forward completion or rolled-back terminal state is explicit; no
+generic error is treated as proof of rollback.
+
+'''
+    output += _task(snapshot, 11, "Soak, hand off residuals, and clean up the old checkout", "wait")
+    output += f'''
+Owner: `{new_slug}`; destructive cleanup requires separate human approval.
+
+- Define and observe a soak window covering deployments, policy decisions,
+  alerts, telemetry, packages, automation, and old-slug compatibility reads.
+- Convert every unresolved item into a live residual (`origin: residual`,
+  `origin_ref: {snapshot.workplan_id}`) in its owning repository before finishing;
+  retain its repository-rename handoff payload and owner work-record ID.
+- Retain the protected `{old_slug}` alias. Alias retirement is out of scope.
+- Only after terminal verification, soak, residual handoff, and explicit cleanup
+  approval may the old local checkout be removed. Record what was removed and
+  whether recovery remains possible from Forgejo.
+
+Gate: no actionable residual exists only in prose, the new clone is canonical,
+and old-checkout cleanup evidence is recorded.
+'''
+    return output.rstrip() + "\n"
+
+
+def default_output_path(snapshot: WorkplanGenerationSnapshot) -> Path:
+    if not snapshot.path_available or not snapshot.repo_path:
+        raise WorkplanGenerationError(
+            "No registered local checkout is visible; pass --output explicitly",
+            code="repository_path_unavailable",
+        )
+    return (
+        Path(snapshot.repo_path)
+        / "workplans"
+        / f"{snapshot.workplan_id}-repository-rename-to-{snapshot.new_slug}.md"
+    )
+
+
+def write_workplan_exclusive(path: Path, content: str) -> None:
+    """Create a workplan exactly once; overwriting is intentionally unsupported."""
+    path.parent.mkdir(parents=True, exist_ok=True)
+    try:
+        descriptor = os.open(path, os.O_WRONLY | os.O_CREAT | os.O_EXCL, 0o644)
+    except FileExistsError as exc:
+        raise WorkplanGenerationError(
+            f"Refusing to overwrite existing workplan {path}",
+            code="output_exists",
+        ) from exc
+    try:
+        with os.fdopen(descriptor, "w", encoding="utf-8") as handle:
+            handle.write(content)
+    except Exception:
+        path.unlink(missing_ok=True)
+        raise
+
+
+def content_checksum(content: str) -> str:
+    return hashlib.sha256(content.encode("utf-8")).hexdigest()
+
+
+__all__ = [
+    "WorkplanGenerationError",
+    "WorkplanGenerationSnapshot",
+    "build_generation_snapshot",
+    "content_checksum",
+    "default_output_path",
+    "render_workplan",
+    "write_workplan_exclusive",
+]
diff --git a/scripts/bootstrap-env.sh b/scripts/bootstrap-env.sh
index c9d3b2a..bcbe83f 100755
--- a/scripts/bootstrap-env.sh
+++ b/scripts/bootstrap-env.sh
@@ -14,6 +14,7 @@ AUTHORIZE_SSH=0
 ALLOW_PLAINTEXT_STORE=0
 SKIP_GITEA=0
 SKIP_MCP=0
+SKIP_CODEX=0
 SSH_KEY="${SSH_KEY:-$HOME/.ssh/id_ed25519}"
 SSH_TARGETS=(
   "tegwick@92.205.62.239"
@@ -39,6 +40,7 @@ Options:
   --gitea-token TOKEN       Gitea token; otherwise prompted when interactive.
   --skip-gitea              Do not create or update ~/.railiance_gitea.conf.
   --skip-mcp                Do not run make register-mcp.
+  --skip-codex              Do not configure Codex sandbox networking.
   -h, --help                Show this help.
 USAGE
 }
@@ -118,6 +120,10 @@ while [ "$#" -gt 0 ]; do
       SKIP_MCP=1
       shift
       ;;
+    --skip-codex)
+      SKIP_CODEX=1
+      shift
+      ;;
     -h|--help)
       usage
       exit 0
@@ -342,6 +348,19 @@ register_mcp() {
   fi
 }
 
+configure_codex() {
+  step "Configuring Codex State Hub access"
+  if [ "$SKIP_CODEX" -eq 1 ]; then
+    warn "Skipping Codex configuration by request."
+    return
+  fi
+  local args=()
+  if [ "$DRY_RUN" -eq 1 ]; then
+    args+=(--dry-run)
+  fi
+  "$STATE_HUB_DIR/scripts/configure-codex.sh" "${args[@]}"
+}
+
 health_check() {
   step "Checking State Hub reachability"
   if curl -fsS --max-time 2 "http://127.0.0.1:8000/state/health" >/dev/null 2>&1; then
@@ -362,6 +381,7 @@ main() {
   setup_ssh_key
   write_gitea_conf
   register_mcp
+  configure_codex
   health_check
   ok "Bootstrap checks complete."
 }
diff --git a/scripts/capture_legacy_meter_evidence.py b/scripts/capture_legacy_meter_evidence.py
index e587a9b..79b0b58 100644
--- a/scripts/capture_legacy_meter_evidence.py
+++ b/scripts/capture_legacy_meter_evidence.py
@@ -71,10 +71,20 @@ def _retire_interfaces(base: str, keys: list[str]) -> list[dict]:
     return retired
 
 
+DEFAULT_REVIEW_DAYS = 7
+
+
 def _review_query(*, days: int | None, hours: int | None) -> str:
-    if days is not None:
-        return f"days={days}"
-    return f"hours={hours or 8}"
+    """Build the review-window query.
+
+    Defaults to a 7-day window to match the ``weekly-review`` endpoint and the
+    ``cadence: weekly`` label in the payload. An hours-scoped window only
+    samples part of each day, so an interface called outside that band reads as
+    unused and is falsely reported as a retirement candidate.
+    """
+    if hours is not None:
+        return f"hours={hours}"
+    return f"days={days or DEFAULT_REVIEW_DAYS}"
 
 
 def capture(
@@ -101,10 +111,10 @@ def capture(
         "retired_interfaces": retired,
         "weekly_review": review,
     }
-    if days is not None:
-        payload["days"] = days
+    if hours is not None:
+        payload["hours"] = hours
     else:
-        payload["hours"] = hours or 8
+        payload["days"] = days or DEFAULT_REVIEW_DAYS
 
     if dry_run:
         print(json.dumps(payload, indent=2))
@@ -124,14 +134,15 @@ def main() -> None:
     parser.add_argument(
         "--hours",
         type=int,
-        default=8,
-        help="Review window in hours (default: 8; used when --days is omitted)",
+        default=None,
+        help="Review window in hours; only samples part of each day — use for "
+        "spot checks, never as retirement evidence",
     )
     parser.add_argument(
         "--days",
         type=int,
         default=None,
-        help="Review window in days (weekly cadence; overrides --hours)",
+        help=f"Review window in days (default: {DEFAULT_REVIEW_DAYS}, weekly cadence)",
     )
     parser.add_argument(
         "--api-base",
diff --git a/scripts/codex-state-hub-mcp.sh b/scripts/codex-state-hub-mcp.sh
index 1c9caa6..beaafc5 100755
--- a/scripts/codex-state-hub-mcp.sh
+++ b/scripts/codex-state-hub-mcp.sh
@@ -1,7 +1,9 @@
 #!/usr/bin/env bash
 set -euo pipefail
 
-cd /home/worsch/state-hub
+STATE_HUB_DIR="$(cd "$(dirname "${BASH_SOURCE[0]}")/.." && pwd)"
+STATE_HUB_PYTHON="${STATE_HUB_PYTHON:-$STATE_HUB_DIR/.venv/bin/python}"
+cd "$STATE_HUB_DIR"
 
 API_BASE="${API_BASE:-http://127.0.0.1:8000}"
 HEALTH_URL="${API_BASE%/}/state/health"
@@ -24,6 +26,12 @@ if ! api_healthy; then
   exit 1
 fi
 
+if [ ! -x "$STATE_HUB_PYTHON" ]; then
+  echo "state-hub Python is not executable at $STATE_HUB_PYTHON" >&2
+  echo "install the repository environment before starting the Codex MCP server" >&2
+  exit 1
+fi
+
 export API_BASE
 export MCP_TRANSPORT=stdio
-exec uv run python mcp_server/server.py
+exec "$STATE_HUB_PYTHON" mcp_server/codex_server.py
diff --git a/scripts/configure-codex.sh b/scripts/configure-codex.sh
new file mode 100755
index 0000000..ac33e74
--- /dev/null
+++ b/scripts/configure-codex.sh
@@ -0,0 +1,142 @@
+#!/usr/bin/env bash
+set -euo pipefail
+
+CODEX_HOME_DIR="${CODEX_HOME:-$HOME/.codex}"
+CONFIG_PATH="${CODEX_CONFIG_PATH:-$CODEX_HOME_DIR/config.toml}"
+API_BASE="${API_BASE:-http://127.0.0.1:8000}"
+DRY_RUN=0
+SKIP_VERIFY=0
+MCP_MODE="remove"
+MCP_NAME="${STATE_HUB_MCP_NAME:-dev-hub}"
+MCP_COMMAND="$(cd "$(dirname "${BASH_SOURCE[0]}")" && pwd)/codex-state-hub-mcp.sh"
+
+usage() {
+  cat <<'USAGE'
+Usage: scripts/configure-codex.sh [options]
+
+Enable direct network access for Codex workspace-write sandboxes and verify
+that the sandbox can reach the local State Hub.
+
+Options:
+  --codex-home DIR  Codex home containing config.toml. Default: $CODEX_HOME or ~/.codex.
+  --api-base URL    State Hub API base. Default: http://127.0.0.1:8000.
+  --dry-run         Show the configuration change without writing it.
+  --skip-verify     Do not run the sandboxed State Hub health check.
+  --with-mcp        Opt in to the experimental slim State Hub MCP server.
+  --skip-mcp        Do not add or remove a State Hub MCP registration.
+  -h, --help        Show this help.
+USAGE
+}
+
+while [ "$#" -gt 0 ]; do
+  case "$1" in
+    --codex-home)
+      test -n "${2:-}" || { echo "ERROR: --codex-home requires a directory" >&2; exit 2; }
+      CODEX_HOME_DIR="$2"
+      CONFIG_PATH="$CODEX_HOME_DIR/config.toml"
+      shift 2
+      ;;
+    --api-base)
+      test -n "${2:-}" || { echo "ERROR: --api-base requires a URL" >&2; exit 2; }
+      API_BASE="$2"
+      shift 2
+      ;;
+    --dry-run) DRY_RUN=1; shift ;;
+    --skip-verify) SKIP_VERIFY=1; shift ;;
+    --with-mcp) MCP_MODE="add"; shift ;;
+    --skip-mcp) MCP_MODE="skip"; shift ;;
+    -h|--help) usage; exit 0 ;;
+    *) echo "ERROR: unknown argument: $1" >&2; usage >&2; exit 2 ;;
+  esac
+done
+
+python3 - "$CONFIG_PATH" "$DRY_RUN" <<'PY'
+import re
+import sys
+import tomllib
+from pathlib import Path
+
+path = Path(sys.argv[1])
+dry_run = sys.argv[2] == "1"
+original = path.read_text(encoding="utf-8") if path.exists() else ""
+if original:
+    tomllib.loads(original)
+
+header = "[sandbox_workspace_write]"
+lines = original.splitlines()
+start = next((i for i, line in enumerate(lines) if line.strip() == header), None)
+
+if start is None:
+    if lines and lines[-1].strip():
+        lines.append("")
+    lines.extend([header, "network_access = true"])
+else:
+    end = next(
+        (i for i in range(start + 1, len(lines)) if re.match(r"^\s*\[", lines[i])),
+        len(lines),
+    )
+    setting = next(
+        (i for i in range(start + 1, end) if re.match(r"^\s*network_access\s*=", lines[i])),
+        None,
+    )
+    if setting is None:
+        lines.insert(end, "network_access = true")
+    else:
+        lines[setting] = "network_access = true"
+
+updated = "\n".join(lines).rstrip() + "\n"
+tomllib.loads(updated)
+
+if updated == original:
+    print(f"OK: {path} already enables sandbox workspace-write network access")
+elif dry_run:
+    print(f"DRY-RUN: would enable sandbox_workspace_write.network_access in {path}")
+else:
+    path.parent.mkdir(parents=True, exist_ok=True)
+    temporary = path.with_suffix(path.suffix + ".tmp")
+    temporary.write_text(updated, encoding="utf-8")
+    temporary.chmod(0o600)
+    temporary.replace(path)
+    print(f"OK: enabled sandbox_workspace_write.network_access in {path}")
+PY
+
+if [ "$MCP_MODE" = "add" ]; then
+  if [ "$DRY_RUN" -eq 1 ]; then
+    echo "DRY-RUN: would register Codex MCP server $MCP_NAME -> $MCP_COMMAND"
+  elif ! command -v codex >/dev/null 2>&1; then
+    echo "WARN: codex is not on PATH; State Hub MCP registration was skipped." >&2
+  elif CODEX_HOME="$CODEX_HOME_DIR" codex mcp get "$MCP_NAME" >/dev/null 2>&1; then
+    echo "OK: Codex MCP server $MCP_NAME is already registered"
+  else
+    CODEX_HOME="$CODEX_HOME_DIR" codex mcp add "$MCP_NAME" -- "$MCP_COMMAND"
+    echo "OK: registered Codex MCP server $MCP_NAME -> $MCP_COMMAND"
+  fi
+elif [ "$MCP_MODE" = "remove" ]; then
+  if [ "$DRY_RUN" -eq 1 ]; then
+    echo "DRY-RUN: would remove Codex MCP server $MCP_NAME if registered"
+  elif command -v codex >/dev/null 2>&1 \
+      && CODEX_HOME="$CODEX_HOME_DIR" codex mcp get "$MCP_NAME" >/dev/null 2>&1; then
+    CODEX_HOME="$CODEX_HOME_DIR" codex mcp remove "$MCP_NAME"
+    echo "OK: removed Codex MCP server $MCP_NAME; use REST/statehub CLI by default"
+  else
+    echo "OK: Codex MCP server $MCP_NAME is not registered"
+  fi
+fi
+
+if [ "$DRY_RUN" -eq 1 ] || [ "$SKIP_VERIFY" -eq 1 ]; then
+  exit 0
+fi
+
+if ! command -v codex >/dev/null 2>&1; then
+  echo "WARN: codex is not on PATH; configuration was written but not verified." >&2
+  exit 0
+fi
+
+HEALTH_URL="${API_BASE%/}/state/health"
+if timeout 10 codex sandbox -- curl -fsS --max-time 3 "$HEALTH_URL" >/dev/null 2>&1; then
+  echo "OK: Codex sandbox can reach State Hub at $HEALTH_URL"
+else
+  echo "WARN: Codex sandbox still cannot reach $HEALTH_URL." >&2
+  echo "WARN: A managed permission profile may enforce restricted networking/--unshare-net." >&2
+  echo "WARN: Retry State Hub REST/CLI commands with escalated execution or change the managed profile." >&2
+fi
diff --git a/scripts/consistency_check.py b/scripts/consistency_check.py
index 84a5183..a2078c1 100644
--- a/scripts/consistency_check.py
+++ b/scripts/consistency_check.py
@@ -11,6 +11,7 @@ Checks:
   C-04  workstream-status-drift  WARN  Yes  File status != DB status (file wins)
   C-05  workstream-title-drift   WARN  Yes  File title != DB title (file wins)
   C-06  workstream-unlinked      WARN  Yes  Workplan has no state_hub_workstream_id
+        --fix derives the UUID from the canonical record id and writes it back
   C-07  orphan-db-active         FAIL  No   Active DB workstream, no backing file
   C-08  orphan-db-closed         INFO  No   Finished/archived DB workstream, no file
   C-09  workstream-repo-mismatch FAIL  Yes  DB workstream repo_id != file location
@@ -19,7 +20,7 @@ Checks:
   C-12  orphan-db-task           WARN  Yes  DB task in workstream has no file backing unless terminal in a closed workstream
   C-13  workstream-auto-complete WARN  Yes  All DB tasks done but workstream still active
   C-14  ghost-duplicate          WARN  No   Active topic workstream with no repo_id matches a file-backed title — probable ghost from premature create_workstream() call
-  C-15  task-db-ahead            WARN  Yes  DB task status is ahead of file — regression prevented; writeback syncs file
+  C-15  task-db-ahead            WARN  No   DB task is terminal and file is not — report only; file wins (ADR-001)
   C-16  repo-behind-remote       WARN  No   Local repo is behind remote tracking branch — --fix skipped to avoid clobbering remote progress
   C-17  repo-ahead-push-failed   WARN  No   Local repo has unpushed commits and push failed — writes skipped to prevent runaway divergence
   C-19  workstream-planning-drift WARN Yes  planning_priority/planning_order differs between file and DB
@@ -33,12 +34,26 @@ Checks:
   C-28  inbox-stale-unread       WARN  No   Unread inbox messages older than INBOX_STALE_DAYS
   C-29  inbox-work-unpromoted    WARN  No   Stale unread message looks like a multi-step work request without a workplan
   C-30  scope-current-state-stale WARN No   SCOPE.md Current State contradicts live workplan statuses
+  C-31  work-record-unregistered  WARN No   YAML-block id matches no kind in the canon work-record type registry (sidetrack detector, CUST-WP-0060)
+  C-32  work-record-not-indexed  WARN  Yes  kind: intake/decision YAML block has no hub id — not indexed in DB (registration, CUST-WP-0061-T02)
+  C-33  work-record-index-stale WARN  Yes  WORK-RECORDS.md missing or stale — generated per-repo index (CUST-WP-0061-T04)
+  C-34  quality-dor-ready       WARN  No   status=ready without quality_dor DoR-Ok (STATE-WP-0077 soft)
+  C-35  repo-manager-conformance WARN No  Repo Manager flavor/standards contract reports findings
+  C-36  work-record-flavor-unknown WARN No  flavor is set but not in the closed list
+  C-37  residual-provenance-missing WARN No  flavor: residual without origin/origin_ref
+  C-38  task-flavor-drift       WARN Yes  task flavor differs between file and DB (file wins)
+  (finished¬DoD-Ok is listed by `statehub quality-debt`, not per-file C-warn — avoids historical flood)
 
 Usage:
     python scripts/consistency_check.py --repo SLUG [--fix] [--no-writeback] [--json] [--api-base URL]
     python scripts/consistency_check.py --all [--fix] [--no-writeback] [--json] [--api-base URL]
     python scripts/consistency_check.py --here [PATH] [--fix] [--no-writeback] [--json] [--api-base URL]
 
+Identifiers (ADR-007 / RMGR-WP-0005):
+    C-06 / C-11 / C-32 derive UUIDv5 identifiers from the fleet namespace and
+    canonical record id. Any instance may reconcile; independent instances
+    produce the same identifier and byte-identical writeback.
+
 Exit codes (single-repo / local CLI):
     0 — clean (no FAILs or WARNs; INFOs are allowed)
     1 — one or more assessment FAILs or automation ERRORs (C-00) present
@@ -62,10 +77,12 @@ import argparse
 import os
 import json
 import re
+import shutil
 import socket
 import subprocess
 import sys
 import time
+import uuid
 from contextlib import contextmanager
 from dataclasses import dataclass, field
 from collections import Counter
@@ -104,6 +121,19 @@ from api.task_status import (  # noqa: E402
     TERMINAL_TASK_STATUSES,
     normalize_task_status,
 )
+from api.work_record_flavor import (  # noqa: E402
+    FLAVOR_PROMOTION_REASONS,
+    WORK_RECORD_FLAVORS,
+    is_residual_flavor,
+    normalize_flavor,
+    normalize_promotion_reason,
+)
+
+_WORK_RECORD_NAMESPACE_UUID = uuid.UUID("a4058507-5c4a-5a00-ab06-fffa4fb46009")
+
+
+def _derived_work_record_uuid(record_id: str) -> str:
+    return str(uuid.uuid5(_WORK_RECORD_NAMESPACE_UUID, f"helixforge\n{record_id}"))
 
 try:
     import yaml as _yaml
@@ -153,6 +183,56 @@ _WORK_REQUEST_RE = re.compile(
 )
 _OPEN_WORKPLAN_STATUSES = {"proposed", "ready", "active", "blocked", "backlog"}
 
+
+def _check_repo_manager_conformance(repo_dir: Path, report: "ConsistencyReport") -> None:
+    """C-35: consume Repo Manager's conformance contract without reimplementing it."""
+    configured = os.environ.get("RMGR_BIN", "").strip()
+    candidates = [configured] if configured else []
+    candidates.extend(
+        [
+            str(Path.home() / "repo-manager" / ".venv" / "bin" / "rmgr"),
+            shutil.which("rmgr") or "",
+        ]
+    )
+    executable = next((item for item in candidates if item and Path(item).is_file()), None)
+    if executable is None:
+        report.add(
+            severity="INFO",
+            check_id="C-35",
+            message="Repo Manager conformance adapter unavailable; set RMGR_BIN or install rmgr",
+            fixable=False,
+        )
+        return
+    try:
+        completed = subprocess.run(
+            [executable, "conform", "--path", str(repo_dir)],
+            capture_output=True,
+            text=True,
+            check=False,
+            timeout=30,
+        )
+        payload = json.loads(completed.stdout)
+    except (OSError, subprocess.TimeoutExpired, json.JSONDecodeError) as exc:
+        report.add(
+            severity="INFO",
+            check_id="C-35",
+            message=f"Repo Manager conformance adapter could not run: {exc}",
+            fixable=False,
+        )
+        return
+    for finding in payload.get("findings") or []:
+        severity = str(finding.get("severity") or "warning")
+        report.add(
+            severity="WARN" if severity in {"missing", "contradictory", "warning"} else "INFO",
+            check_id="C-35",
+            message=(
+                f"Repo Manager {severity}: {finding.get('path') or '(repository)'}: "
+                f"{finding.get('message') or finding.get('code') or 'conformance finding'}"
+            ),
+            file_path=finding.get("path"),
+            fixable=False,
+        )
+
 # Legacy file/API aliases translated before comparison and PATCHing.
 FILE_TO_DB_WORKSTREAM_STATUS: dict[str, str] = dict(LEGACY_WORKSTREAM_STATUS_ALIASES)
 
@@ -276,7 +356,10 @@ RENORMALIZATION_RULES: tuple[RenormalizationRule, ...] = (
             "Workplan status is proposed, ready, or backlog while a linked "
             "task is progress or wait."
         ),
-        repair="Patch the DB workstream and workplan frontmatter to status=active.",
+        repair=(
+            "ready/backlog: patch DB and file to active. "
+            "proposed: report only (ADR-007 decision 3)."
+        ),
         test_anchor="tests/test_consistency_check.py::TestLifecycleRenormalization",
     ),
 )
@@ -436,6 +519,36 @@ def _as_list(value: Any) -> list[str]:
     return [str(value).strip().strip('"')]
 
 
+_TASK_RECORD_ID_RE = re.compile(r"-T\d{2,3}$")
+
+
+def _dedupe_preserve(items: list[str]) -> list[str]:
+    seen: set[str] = set()
+    out: list[str] = []
+    for item in items:
+        if item in seen:
+            continue
+        seen.add(item)
+        out.append(item)
+    return out
+
+
+def _frontmatter_depends_on_workplans(meta: dict) -> list[str]:
+    """Canonical `depends_on` plus legacy `depends_on_workplans` alias."""
+    combined = _as_list(meta.get("depends_on")) + _as_list(meta.get("depends_on_workplans"))
+    return _dedupe_preserve(
+        [item for item in combined if item and not _TASK_RECORD_ID_RE.search(item)]
+    )
+
+
+def _frontmatter_depends_on_tasks(meta: dict) -> list[str]:
+    from_alias = _as_list(meta.get("depends_on_tasks"))
+    from_depends_on = [
+        item for item in _as_list(meta.get("depends_on")) if _TASK_RECORD_ID_RE.search(item)
+    ]
+    return _dedupe_preserve(from_alias + from_depends_on)
+
+
 def _as_int_or_none(value: Any) -> int | None:
     if value in (None, "", "~", "null", "None", "none"):
         return None
@@ -557,6 +670,24 @@ def _inject_task_id_frontmatter_list(
 # API helpers
 # ---------------------------------------------------------------------------
 
+_API_CLIENTS: dict[tuple[str, object], Any] = {}
+
+
+def _api_client(api_base: str) -> Any:
+    """Reuse one keep-alive pool per API/client implementation for this run."""
+    key = (api_base.rstrip("/"), _httpx.Client)
+    client = _API_CLIENTS.get(key)
+    if client is None:
+        client = _httpx.Client(
+            base_url=api_base,
+            timeout=10.0,
+            follow_redirects=True,
+            headers=_legacy_meter_headers(),
+        )
+        _API_CLIENTS[key] = client
+    return client
+
+
 def _api_get(
     api_base: str,
     path: str,
@@ -573,15 +704,9 @@ def _api_get(
     last_error: Exception | None = None
     for attempt in range(_API_GET_RETRIES):
         try:
-            with _httpx.Client(
-                base_url=api_base,
-                timeout=10.0,
-                follow_redirects=True,
-                headers=_legacy_meter_headers(),
-            ) as c:
-                r = c.get(path, params=filtered if filtered else None)
-                r.raise_for_status()
-                return r.json()
+            r = _api_client(api_base).get(path, params=filtered if filtered else None)
+            r.raise_for_status()
+            return r.json()
         except _httpx.HTTPStatusError as exc:
             if exc.response.status_code == 404:
                 return None
@@ -616,15 +741,9 @@ def _api_patch(api_base: str, path: str, body: dict) -> Any:
     if not path.endswith("/"):
         path += "/"
     try:
-        with _httpx.Client(
-            base_url=api_base,
-            timeout=10.0,
-            follow_redirects=True,
-            headers=_legacy_meter_headers(),
-        ) as c:
-            r = c.patch(path, json=body)
-            r.raise_for_status()
-            return r.json()
+        r = _api_client(api_base).patch(path, json=body)
+        r.raise_for_status()
+        return r.json()
     except Exception as exc:
         # Return a sentinel dict so callers can distinguish "API error" from "success"
         # and report it rather than silently dropping the fix.
@@ -637,15 +756,9 @@ def _api_put(api_base: str, path: str, body: dict) -> Any:
     if not path.endswith("/"):
         path += "/"
     try:
-        with _httpx.Client(
-            base_url=api_base,
-            timeout=30.0,
-            follow_redirects=True,
-            headers=_legacy_meter_headers(),
-        ) as c:
-            r = c.put(path, json=body)
-            r.raise_for_status()
-            return r.json()
+        r = _api_client(api_base).put(path, json=body, timeout=30.0)
+        r.raise_for_status()
+        return r.json()
     except Exception as exc:
         return {"_error": str(exc)}
 
@@ -656,15 +769,9 @@ def _api_post(api_base: str, path: str, body: dict) -> Any:
     if not path.endswith("/"):
         path += "/"
     try:
-        with _httpx.Client(
-            base_url=api_base,
-            timeout=10.0,
-            follow_redirects=True,
-            headers=_legacy_meter_headers(),
-        ) as c:
-            r = c.post(path, json=body)
-            r.raise_for_status()
-            return r.json()
+        r = _api_client(api_base).post(path, json=body)
+        r.raise_for_status()
+        return r.json()
     except _httpx.HTTPStatusError as exc:
         detail = exc.response.text
         if len(detail) > 500:
@@ -772,7 +879,357 @@ def _infer_slug_from_path(api_base: str, path: str) -> "tuple[str, str] | None":
     return None
 
 
-def check_repo(api_base: str, repo_slug: str, repo_path_override: str | None = None) -> ConsistencyReport:
+_WORK_RECORD_FENCE_RE = re.compile(r"```(?:yaml|task)\n(.*?)```", re.S)
+_WORK_RECORD_ID_LINE_RE = re.compile(r"^id:\s*[\"']?([A-Za-z0-9_-]+)[\"']?\s*$", re.M)
+_WORK_RECORD_ID_LIKE_RE = re.compile(r"^[A-Z][A-Z0-9]*(-[A-Z0-9]+)+$")
+_WORK_RECORD_SKIP_DIRS = frozenset({".git", "node_modules", ".venv", "history"})
+
+
+def _load_work_record_kind_registry() -> list[dict] | None:
+    """Load [{kind, patterns}] from the canon work-record type registry.
+
+    Location: $WORK_RECORD_REGISTRY, else ~/the-custodian/canon/standards/
+    work-record-types.yaml. Returns None (checks skipped) when unavailable.
+    Kind-aware: shared by C-31 (flat sidetrack detection) and C-32
+    (kind-aware registration — needs to know intake vs. decision vs.
+    engagement to pick the right hub entity).
+    """
+    if not _HAS_YAML:
+        return None
+    candidates = []
+    env = os.environ.get("WORK_RECORD_REGISTRY")
+    if env:
+        candidates.append(Path(env))
+    candidates.append(
+        Path.home() / "the-custodian/canon/standards/work-record-types.yaml")
+    for path in candidates:
+        if not path.is_file():
+            continue
+        try:
+            reg = _yaml.safe_load(path.read_text())
+            kinds = []
+            for kind in reg.get("kinds", []):
+                patterns = [re.compile(p) for p in kind.get("id_patterns", [])]
+                patterns += [re.compile(lp["pattern"])
+                             for lp in kind.get("legacy_patterns", [])]
+                kinds.append({"kind": kind["kind"], "patterns": patterns})
+            return kinds
+        except Exception:
+            return None
+    return None
+
+
+def _load_work_record_patterns() -> list[re.Pattern] | None:
+    """Flat id-pattern list across all kinds — used by C-31's sidetrack
+    detector, which only needs to know "is this id registered at all",
+    not which kind it belongs to."""
+    kinds = _load_work_record_kind_registry()
+    if kinds is None:
+        return None
+    return [p for k in kinds for p in k["patterns"]]
+
+
+def _check_unregistered_work_records(repo_dir: Path, report: "ConsistencyReport") -> None:
+    """C-31: warn on YAML-block ids matching no registered work-record kind.
+
+    Detection only (CUST-WP-0060-T05); registration of non-workplan kinds is
+    a later stage. An unregistered id scheme is a coordination sidetrack that
+    will need manual reintegration — surface it the day it appears.
+    """
+    patterns = _load_work_record_patterns()
+    if patterns is None:
+        return
+    seen: set[str] = set()
+    for md in sorted(repo_dir.rglob("*.md")):
+        if any(part in _WORK_RECORD_SKIP_DIRS for part in md.parts):
+            continue
+        try:
+            text = md.read_text(errors="replace")
+        except OSError:
+            continue
+        for body in _WORK_RECORD_FENCE_RE.findall(text):
+            for rid in _WORK_RECORD_ID_LINE_RE.findall(body):
+                if rid in seen or "NNN" in rid or rid.endswith("-TNN"):
+                    continue
+                if not _WORK_RECORD_ID_LIKE_RE.match(rid):
+                    continue
+                if any(p.match(rid) for p in patterns):
+                    continue
+                seen.add(rid)
+                report.add(
+                    severity="WARN",
+                    check_id="C-31",
+                    message=(
+                        f"[{md.relative_to(repo_dir)}] id '{rid}' matches no "
+                        f"kind in the canon work-record type registry — "
+                        f"unregistered species become sidetracks needing "
+                        f"manual reintegration (work-record-types_v0.1)"
+                    ),
+                    fixable=False,
+                )
+
+
+_YAML_ONLY_FENCE_RE = re.compile(r"```yaml\n(.*?)\n```", re.S)
+_WORK_RECORD_ID_FIELD_BY_KIND = {
+    "intake": "state_hub_intake_id",
+    "decision": "state_hub_decision_id",
+    "engagement": "state_hub_engagement_id",
+}
+_WORK_RECORD_CREATE_ENDPOINT_BY_KIND = {
+    "intake": "/intakes",
+    "decision": "/decisions",
+}
+
+
+def _classify_work_record_kind(record_id: str, kind_registry: list[dict]) -> str | None:
+    for k in kind_registry:
+        if any(p.match(record_id) for p in k["patterns"]):
+            return k["kind"]
+    return None
+
+
+def _inject_yaml_block_field(
+    file_path: Path, field_name: str, field_value: str, match_id: str
+) -> bool:
+    """Inject a field into the ```yaml``` block whose id == match_id.
+    Mirrors _inject_task_id_into_block, adapted for fenced yaml blocks
+    (intake/decision/engagement records live as ```yaml, not ```task)."""
+    text = file_path.read_text(encoding="utf-8")
+
+    def _replace(m: re.Match) -> str:
+        block_content = m.group(1)
+        meta = _parse_yaml_block(block_content.strip())
+        if not isinstance(meta, dict) or str(meta.get("id", "")) != match_id:
+            return m.group(0)
+        existing_val = meta.get(field_name)
+        if existing_val is not None and str(existing_val).strip() not in ("", "~", "null", "None", "none"):
+            return m.group(0)
+        new_content = re.sub(
+            rf"^{re.escape(field_name)}:.*$",
+            f'{field_name}: "{field_value}"',
+            block_content,
+            flags=re.MULTILINE,
+        )
+        if new_content == block_content:
+            new_content = block_content.rstrip() + f"\n{field_name}: \"{field_value}\""
+        return f"```yaml\n{new_content}\n```"
+
+    new_text = _YAML_ONLY_FENCE_RE.sub(_replace, text)
+    if new_text != text:
+        file_path.write_text(new_text, encoding="utf-8")
+        return True
+    return False
+
+
+def _check_work_record_registration(
+    repo_dir: Path,
+    report: "ConsistencyReport",
+    api_base: str = "http://127.0.0.1:8000",
+    bootstrap_empty_projection: bool = False,
+) -> None:
+    """C-32: register kind: intake / kind: decision YAML blocks found
+    anywhere in the repo against the hub (CUST-WP-0061-T02, work-record
+    stage 3) — writes state_hub_intake_id / state_hub_decision_id back into
+    the source block, same write-back pattern as C-06 for workplans.
+
+    kind: engagement has no hub entity yet (deferred; reported INFO, not
+    fixable) — building one is a separate stage-3 follow-on, not this task.
+    """
+    kind_registry = _load_work_record_kind_registry()
+    if kind_registry is None:
+        return
+    for md in sorted(repo_dir.rglob("*.md")):
+        if any(part in _WORK_RECORD_SKIP_DIRS for part in md.parts):
+            continue
+        try:
+            text = md.read_text(errors="replace")
+        except OSError:
+            continue
+        for block in _YAML_ONLY_FENCE_RE.findall(text):
+            meta = _parse_yaml_block(block.strip())
+            if not isinstance(meta, dict) or meta.get("_parse_error"):
+                continue
+            rid = str(meta.get("id", "")).strip()
+            if not rid or "NNN" in rid:
+                continue
+            kind = _classify_work_record_kind(rid, kind_registry)
+            if kind not in _WORK_RECORD_ID_FIELD_BY_KIND:
+                continue
+
+            id_field = _WORK_RECORD_ID_FIELD_BY_KIND[kind]
+            existing = str(meta.get(id_field, "")).strip().strip('"')
+            if existing and existing not in ("~", "null", "None", "none"):
+                if not bootstrap_empty_projection:
+                    continue
+                endpoint = _WORK_RECORD_CREATE_ENDPOINT_BY_KIND.get(kind)
+                if endpoint and _api_get(api_base, f"{endpoint}/{existing}") is not None:
+                    continue
+
+            rel = md.relative_to(repo_dir)
+            if kind not in _WORK_RECORD_CREATE_ENDPOINT_BY_KIND:
+                report.add(
+                    severity="INFO", check_id="C-32",
+                    message=(
+                        f"[{rel}] engagement '{rid}' has no hub entity yet — "
+                        f"registration deferred (CUST-WP-0061 stage-3 seed)"
+                    ),
+                    fixable=False,
+                )
+                continue
+
+            report.add(
+                severity="WARN", check_id="C-32",
+                message=(
+                    f"[{rel}] {kind} '{rid}' is absent from the explicitly empty projection"
+                    if existing
+                    else f"[{rel}] {kind} '{rid}' has no {id_field} — not indexed in DB"
+                ),
+                file_path=str(rel),
+                file_value=rid,
+                fixable=True,
+                _fix_context={
+                    "md_path": md,
+                    "kind": kind,
+                    "rid": rid,
+                    "meta": meta,
+                    "desired_record_id": existing or None,
+                },
+            )
+
+
+_WORK_RECORD_INDEX_NAME = "WORK-RECORDS.md"
+_WORK_RECORD_INDEX_KIND_ORDER = {
+    "workplan": 0, "task": 1, "intake": 2, "decision": 3, "engagement": 4,
+}
+
+
+def _generate_work_record_index(repo_dir: Path, repo_slug: str) -> str | None:
+    """CUST-WP-0061-T04: the generated per-repo work-record index — every
+    registered work record (workplan, task, intake, decision, engagement)
+    with kind/id/status/lane/source, derivable purely from repo files (no
+    hub query — matches the ADR-001 rebuild principle). Full transclusion
+    rendering (markitect integration) is a follow-on; this is the flat
+    first cut. Returns None (no file written) when the repo has no work
+    records at all, to avoid clutter in small repos.
+    """
+    rows: list[tuple[str, str, str, str, str]] = []  # kind, id, status, lane, source
+
+    workplans_dir = repo_dir / "workplans"
+    if workplans_dir.is_dir():
+        for wp_file in iter_workplan_files(workplans_dir, include_archived=False):
+            try:
+                text = wp_file.read_text(encoding="utf-8", errors="replace")
+            except OSError:
+                continue
+            meta, body = parse_frontmatter(text)
+            wp_id = str(meta.get("id", "")).strip()
+            if not wp_id:
+                continue
+            source = str(wp_file.relative_to(repo_dir))
+            rows.append(("workplan", wp_id, str(meta.get("status", "")).strip() or "—", "—", source))
+            for task in get_tasks_from_workplan(meta, body):
+                if task.get("_parse_error"):
+                    continue
+                t_id = str(task.get("id", "")).strip()
+                if not t_id:
+                    continue
+                rows.append(("task", t_id, str(task.get("status", "")).strip() or "—", "—", source))
+
+    kind_registry = _load_work_record_kind_registry()
+    if kind_registry:
+        for md in sorted(repo_dir.rglob("*.md")):
+            if any(part in _WORK_RECORD_SKIP_DIRS for part in md.parts):
+                continue
+            if md.name == _WORK_RECORD_INDEX_NAME:
+                continue
+            try:
+                text = md.read_text(errors="replace")
+            except OSError:
+                continue
+            for block in _YAML_ONLY_FENCE_RE.findall(text):
+                meta = _parse_yaml_block(block.strip())
+                if not isinstance(meta, dict) or meta.get("_parse_error"):
+                    continue
+                rid = str(meta.get("id", "")).strip()
+                if not rid or "NNN" in rid:
+                    continue
+                kind = _classify_work_record_kind(rid, kind_registry)
+                if kind not in ("intake", "decision", "engagement"):
+                    continue
+                status = str(meta.get("status", "")).strip() or "—"
+                lane = str(meta.get("lane", "")).strip() or "—"
+                source = str(md.relative_to(repo_dir))
+                rows.append((kind, rid, status, lane, source))
+
+    if not rows:
+        return None
+
+    rows.sort(key=lambda r: (_WORK_RECORD_INDEX_KIND_ORDER.get(r[0], 99), r[4], r[1]))
+    return _work_record_index_document(repo_slug, rows)
+
+
+def _work_record_index_document(
+    repo_slug: str, rows: list[tuple[str, str, str, str, str]]
+) -> str:
+    """Render WORK-RECORDS.md. An empty row list still produces the header
+    and table so a leftover index can be rewritten after every live record
+    is archived or removed.
+    """
+    lines = [
+        f"# Work Records — {repo_slug}",
+        "",
+        "> Generated by `statehub fix-consistency` (CUST-WP-0061-T04, work-record",
+        "> stage 3). Do not edit by hand — edit the source file/block listed for",
+        "> each record and re-run fix-consistency to refresh this index. Archived",
+        "> workplans are omitted; closed decisions/intakes/engagements stay listed",
+        "> so recently-resolved work is still visible. [auto]",
+        "",
+        "| Kind | ID | Status | Lane | Source |",
+        "| --- | --- | --- | --- | --- |",
+    ]
+    lines.extend(
+        f"| {kind} | {rid} | {status} | {lane} | {source} |"
+        for kind, rid, status, lane, source in rows
+    )
+    lines.append("")
+    return "\n".join(lines)
+
+
+def _check_work_record_index_freshness(
+    repo_dir: Path, repo_slug: str, report: "ConsistencyReport"
+) -> None:
+    """C-33: WORK-RECORDS.md missing or stale relative to the current
+    file-derived work-record set."""
+    content = _generate_work_record_index(repo_dir, repo_slug)
+    index_file = repo_dir / _WORK_RECORD_INDEX_NAME
+    existing = index_file.read_text(encoding="utf-8") if index_file.is_file() else None
+    if content is None:
+        if existing is None:
+            return
+        empty = _work_record_index_document(repo_slug, [])
+        if existing == empty:
+            return
+        content = empty
+    elif existing == content:
+        return
+    report.add(
+        severity="WARN", check_id="C-33",
+        message=(
+            f"{_WORK_RECORD_INDEX_NAME} is missing or stale — regenerate via "
+            f"fix-consistency (CUST-WP-0061-T04 generated work-record index)"
+        ),
+        file_path=_WORK_RECORD_INDEX_NAME,
+        fixable=True,
+        _fix_context={"index_file": index_file, "content": content},
+    )
+
+
+def check_repo(
+    api_base: str,
+    repo_slug: str,
+    repo_path_override: str | None = None,
+    bootstrap_empty_projection: bool = False,
+) -> ConsistencyReport:
     """Run all consistency checks for a registered repo."""
     repo = _api_get(api_base, f"/repos/{repo_slug}", return_error=True)
     if isinstance(repo, dict) and "_error" in repo:
@@ -794,10 +1251,35 @@ def check_repo(api_base: str, repo_slug: str, repo_path_override: str | None = N
         )
         return report
 
+    # Repository aliases are accepted at the API boundary, but every new
+    # binding, inbox write, and generated file must use the current identity.
+    repo_slug = str(repo.get("canonical_slug") or repo.get("slug") or repo_slug)
     repo_id: str = repo["id"]
     repo_path: str = resolve_repo_path(repo, repo_path_override)
     report = ConsistencyReport(repo_slug=repo_slug, repo_path=repo_path)
 
+    if bootstrap_empty_projection:
+        projected = _api_get(api_base, "/workplans", {"repo_id": repo_id}, return_error=True)
+        if not isinstance(projected, list):
+            report.add(
+                severity="FAIL",
+                check_id="C-36",
+                message="Could not prove that the repository projection is empty",
+                fixable=False,
+            )
+            return report
+        if projected:
+            report.add(
+                severity="FAIL",
+                check_id="C-36",
+                message=(
+                    "Empty-projection bootstrap refused: repository already has "
+                    f"{len(projected)} projected workplan(s)"
+                ),
+                fixable=False,
+            )
+            return report
+
     if not repo_path:
         report.add(
             severity="FAIL", check_id="C-00",
@@ -835,6 +1317,23 @@ def check_repo(api_base: str, repo_slug: str, repo_path_override: str | None = N
             fixable=False,
         )
 
+    # C-35: consume the repository-standard answer from Repo Manager.
+    _check_repo_manager_conformance(repo_dir, report)
+
+    # C-31: work-record sidetrack detector (canon work-record-types registry)
+    _check_unregistered_work_records(repo_dir, report)
+
+    # C-32: intake/decision work-record registration (CUST-WP-0061-T02)
+    _check_work_record_registration(
+        repo_dir,
+        report,
+        api_base=api_base,
+        bootstrap_empty_projection=bootstrap_empty_projection,
+    )
+
+    # C-33: generated per-repo work-record index (CUST-WP-0061-T04)
+    _check_work_record_index_freshness(repo_dir, repo_slug, report)
+
     # C-01: workplans/ directory missing
     if not workplans_dir.is_dir():
         report.add(
@@ -892,6 +1391,37 @@ def check_repo(api_base: str, repo_slug: str, repo_path_override: str | None = N
             if task_file_id and task_sh_id and task_sh_id not in ("~", "null", "None", "none"):
                 task_file_id_to_sh_id[task_file_id] = task_sh_id
 
+    # Modern hubs expose the entire repo-scoped read model in one response.
+    # Keep the older per-record calls as a rolling-deploy compatibility path.
+    projection_snapshot = _api_get(
+        api_base,
+        f"/repos/{repo_slug}/work-record-projection/snapshot",
+        return_error=True,
+    )
+    snapshot_available = (
+        isinstance(projection_snapshot, dict)
+        and projection_snapshot.get("schema")
+        == "state-hub.repository-projection-snapshot.v1"
+        and str(projection_snapshot.get("repo_id")) == repo_id
+    )
+    snapshot_workplans_by_id: dict[str, dict] = {}
+    snapshot_tasks_by_workplan: dict[str, list[dict]] = {}
+    snapshot_dependencies_by_workplan: dict[str, list[dict]] = {}
+    if snapshot_available:
+        for row in projection_snapshot.get("workplans", []):
+            if isinstance(row, dict) and row.get("id"):
+                snapshot_workplans_by_id[str(row["id"])] = row
+        for row in projection_snapshot.get("tasks", []):
+            if isinstance(row, dict) and row.get("workplan_id"):
+                snapshot_tasks_by_workplan.setdefault(
+                    str(row["workplan_id"]), []
+                ).append(row)
+        for row in projection_snapshot.get("dependencies", []):
+            if isinstance(row, dict) and row.get("from_workplan_id"):
+                snapshot_dependencies_by_workplan.setdefault(
+                    str(row["from_workplan_id"]), []
+                ).append(row)
+
     # Per-workplan checks
     for wp_file, meta, body in workplan_infos:
         fname = workplan_display_path(repo_dir, wp_file)
@@ -931,16 +1461,53 @@ def check_repo(api_base: str, repo_slug: str, repo_path_override: str | None = N
             )
             continue
 
-        ws = _api_get(api_base, f"/workplans/{ws_id}")
+        ws = (
+            snapshot_workplans_by_id.get(ws_id)
+            if snapshot_available
+            else _api_get(api_base, f"/workplans/{ws_id}")
+        )
         if ws is None:
-            # C-03: stale workstream reference
-            report.add(
-                severity="FAIL", check_id="C-03",
-                message=f"state_hub_workstream_id {ws_id[:8]}… not found in DB (stale reference)",
-                file_path=fname,
-                db_id=ws_id,
-                fixable=False,
-            )
+            wp_id = str(meta.get("id", "")).strip()
+            if wp_id and (
+                ws_id == _derived_work_record_uuid(wp_id) or bootstrap_empty_projection
+            ):
+                # A deterministic file identifier missing from a replaceable
+                # projection is registration work, not a stale reference.
+                report.add(
+                    severity="WARN",
+                    check_id="C-06",
+                    message=(
+                        f"Authoritative workplan {ws_id[:8]}… is absent from this "
+                        + (
+                            "explicitly empty projection"
+                            if bootstrap_empty_projection
+                            else "projection"
+                        )
+                    ),
+                    file_path=fname,
+                    db_id=ws_id,
+                    fixable=True,
+                    _fix_context={
+                        "wp_file": str(wp_file),
+                        "meta": meta,
+                        "body": body,
+                        "repo_id": repo_id,
+                        "domain": file_domain,
+                        "repo_market_domain": repo_market_domain,
+                        "repo_slug": repo_slug,
+                        "desired_ws_id": ws_id,
+                    },
+                )
+            else:
+                # A non-derived missing identifier may be genuine stale state;
+                # preserve the conservative manual-review behavior.
+                report.add(
+                    severity="FAIL", check_id="C-03",
+                    message=f"state_hub_workstream_id {ws_id[:8]}… not found in DB (stale reference)",
+                    file_path=fname,
+                    db_id=ws_id,
+                    fixable=False,
+                )
             continue
 
         # C-09: repo mismatch — file is here but DB says different repo
@@ -963,7 +1530,16 @@ def check_repo(api_base: str, repo_slug: str, repo_path_override: str | None = N
             # Continue to check drift even with mismatched repo
 
         tasks = get_tasks_from_workplan(meta, body)
-        db_tasks = _api_get(api_base, "/tasks", {"workplan_id": ws_id})
+        db_tasks = (
+            snapshot_tasks_by_workplan.get(ws_id, [])
+            if snapshot_available
+            else _api_get(api_base, "/tasks", {"workplan_id": ws_id})
+        )
+        db_tasks_by_id = {
+            str(row.get("id")): row
+            for row in db_tasks
+            if isinstance(row, dict) and row.get("id")
+        } if isinstance(db_tasks, list) else {}
         file_task_statuses = [
             str(task.get("status", "")).strip()
             for task in tasks
@@ -979,18 +1555,27 @@ def check_repo(api_base: str, repo_slug: str, repo_path_override: str | None = N
             task_statuses=[*file_task_statuses, *db_task_statuses],
         )
         if active_task_requires_activation:
+            # ADR-007 decision 3 / RMGR-WP-0005-T06: automation may report
+            # that a proposed workplan has started work, but must not promote
+            # proposed → active. proposed is a human review gate.
+            proposed_gate = file_status == "proposed"
             report.add(
                 severity="WARN",
                 check_id="C-23",
                 message=(
                     f"Lifecycle drift in '{ws.get('slug')}': workplan status "
-                    f"{file_status!r} has an active task — repair to 'active'"
+                    f"{file_status!r} has an active task"
+                    + (
+                        " — report only (ADR-007: do not auto-promote proposed)"
+                        if proposed_gate
+                        else " — repair to 'active'"
+                    )
                 ),
                 file_path=fname,
                 db_id=ws_id,
                 file_value=file_status,
                 db_value=ws.get("status", ""),
-                fixable=True,
+                fixable=not proposed_gate,
                 _fix_context={
                     "ws_id": ws_id,
                     "wp_file": str(wp_file),
@@ -1050,6 +1635,25 @@ def check_repo(api_base: str, repo_slug: str, repo_path_override: str | None = N
                     db_value="needs_review",
                     fixable=False,
                 )
+            # C-34: soft DoR quality debt (STATE-WP-0077) — never blocks
+            try:
+                from quality_assessment import assessment_from_mapping, is_ok
+            except ImportError:
+                sys.path.insert(0, str(Path(__file__).resolve().parent))
+                from quality_assessment import assessment_from_mapping, is_ok  # type: ignore
+            dor = assessment_from_mapping(meta, "DoR")
+            if not is_ok(dor):
+                report.add(
+                    severity="WARN",
+                    check_id="C-34",
+                    message=(
+                        "status=ready without quality_dor DoR-Ok — process claim "
+                        "without DoR assessment (soft; see docs/work-record-quality-gates.md)"
+                    ),
+                    file_path=fname,
+                    file_value=str(dor or "unassessed"),
+                    fixable=False,
+                )
 
         # C-05: title drift
         db_title = ws.get("title", "")
@@ -1100,13 +1704,97 @@ def check_repo(api_base: str, repo_slug: str, repo_path_override: str | None = N
                 _fix_context={"ws_id": ws_id, "field": "planning_order", "value": planning_order},
             )
 
+        file_flavor = normalize_flavor(meta.get("flavor"))
+        if file_flavor is not None and file_flavor not in WORK_RECORD_FLAVORS:
+            report.add(
+                severity="WARN",
+                check_id="C-36",
+                message=(
+                    f"Unknown work-record flavor {file_flavor!r} in '{ws.get('slug')}'; "
+                    f"expected one of {', '.join(WORK_RECORD_FLAVORS)}"
+                ),
+                file_path=fname,
+                db_id=ws_id,
+                file_value=file_flavor,
+                fixable=False,
+            )
+            file_flavor = None
+        db_flavor = normalize_flavor(ws.get("flavor"))
+        if file_flavor != db_flavor:
+            report.add(
+                severity="WARN", check_id="C-19",
+                message=(
+                    f"Flavor drift in '{ws.get('slug')}': "
+                    f"file={file_flavor!r} db={db_flavor!r} (file wins)"
+                ),
+                file_path=fname,
+                db_id=ws_id,
+                file_value=file_flavor,
+                db_value=db_flavor,
+                fixable=True,
+                _fix_context={"ws_id": ws_id, "field": "flavor", "value": file_flavor},
+            )
+        file_reason = normalize_promotion_reason(meta.get("flavor_promotion_reason"))
+        if file_reason is not None and file_reason not in FLAVOR_PROMOTION_REASONS:
+            report.add(
+                severity="WARN",
+                check_id="C-36",
+                message=(
+                    f"Unknown flavor_promotion_reason {file_reason!r} in '{ws.get('slug')}'; "
+                    f"expected one of {', '.join(FLAVOR_PROMOTION_REASONS)}"
+                ),
+                file_path=fname,
+                db_id=ws_id,
+                file_value=file_reason,
+                fixable=False,
+            )
+            file_reason = None
+        db_reason = normalize_promotion_reason(ws.get("flavor_promotion_reason"))
+        if file_reason != db_reason:
+            report.add(
+                severity="WARN", check_id="C-19",
+                message=(
+                    f"Flavor promotion reason drift in '{ws.get('slug')}': "
+                    f"file={file_reason!r} db={db_reason!r} (file wins)"
+                ),
+                file_path=fname,
+                db_id=ws_id,
+                file_value=file_reason,
+                db_value=db_reason,
+                fixable=True,
+                _fix_context={
+                    "ws_id": ws_id,
+                    "field": "flavor_promotion_reason",
+                    "value": file_reason,
+                },
+            )
+        if is_residual_flavor(file_flavor):
+            origin = str(meta.get("origin") or "").strip()
+            origin_ref = str(meta.get("origin_ref") or "").strip()
+            if not origin and not origin_ref:
+                report.add(
+                    severity="WARN",
+                    check_id="C-37",
+                    message=(
+                        f"Residual workplan '{ws.get('slug')}' has no origin/origin_ref "
+                        "provenance (not invented)"
+                    ),
+                    file_path=fname,
+                    db_id=ws_id,
+                    fixable=False,
+                )
+
         # C-10, C-11, C-12: task-level checks
         db_task_by_id: dict[str, dict] = {}
         if isinstance(db_tasks, list):
             for t in db_tasks:
                 db_task_by_id[t["id"]] = t
 
-        existing_deps = _api_get(api_base, f"/workplans/{ws_id}/dependencies") or []
+        existing_deps = (
+            snapshot_dependencies_by_workplan.get(ws_id, [])
+            if snapshot_available
+            else _api_get(api_base, f"/workplans/{ws_id}/dependencies") or []
+        )
         existing_dep_keys = set()
         if isinstance(existing_deps, list):
             for dep in existing_deps:
@@ -1120,7 +1808,7 @@ def check_repo(api_base: str, repo_slug: str, repo_path_override: str | None = N
                 if dep.get("to_task_id"):
                     existing_dep_keys.add(("task", dep["to_task_id"], rel))
 
-        for target_wp_id in _as_list(meta.get("depends_on_workplans")):
+        for target_wp_id in _frontmatter_depends_on_workplans(meta):
             target_ws_id = workplan_id_to_ws_id.get(target_wp_id)
             if not target_ws_id:
                 report.add(
@@ -1149,7 +1837,7 @@ def check_repo(api_base: str, repo_slug: str, repo_path_override: str | None = N
                     },
                 )
 
-        for target_task_id in _as_list(meta.get("depends_on_tasks")):
+        for target_task_id in _frontmatter_depends_on_tasks(meta):
             target_sh_id = task_file_id_to_sh_id.get(target_task_id)
             if not target_sh_id:
                 report.add(
@@ -1192,58 +1880,74 @@ def check_repo(api_base: str, repo_slug: str, repo_path_override: str | None = N
 
             if t_sh_id:
                 file_task_sh_ids.add(t_sh_id)
-                db_task = _api_get(api_base, f"/tasks/{t_sh_id}")
+                db_task = db_tasks_by_id.get(t_sh_id)
                 if db_task is None:
-                    report.add(
-                        severity="FAIL", check_id="C-03",
-                        message=f"state_hub_task_id {t_sh_id[:8]}… not found in DB",
-                        file_path=f"{fname}#{t_id}",
-                        db_id=t_sh_id,
-                        fixable=False,
-                    )
+                    if t_id and t_sh_id == _derived_work_record_uuid(t_id):
+                        report.add(
+                            severity="WARN",
+                            check_id="C-11",
+                            message=f"Derived task '{t_id}' is absent from this projection",
+                            file_path=f"{fname}#{t_id}",
+                            db_id=t_sh_id,
+                            fixable=True,
+                            _fix_context={
+                                "ws_id": ws_id,
+                                "ws_status": ws.get("status", ""),
+                                "task": task,
+                                "wp_file": str(wp_file),
+                                "meta": meta,
+                                "body": body,
+                                "desired_task_id": t_sh_id,
+                            },
+                        )
+                    else:
+                        report.add(
+                            severity="FAIL", check_id="C-03",
+                            message=f"state_hub_task_id {t_sh_id[:8]}… not found in DB",
+                            file_path=f"{fname}#{t_id}",
+                            db_id=t_sh_id,
+                            fixable=False,
+                        )
                     continue
-                # C-10 / C-15: task status drift
+                # C-10 / C-15: task status drift. ADR-001: the file originates
+                # work. Same-rank wait/progress is not "DB ahead" — writing
+                # wait over progress/todo is the CFED/RMGR-WP-0004-T02 bug.
+                # C-15 remains a report-only review signal when the DB is
+                # terminal and the file is not.
                 db_t_status = normalise_task_status(db_task.get("status", "todo"))
                 if t_status and db_t_status and t_status != db_t_status:
                     db_rank = STATUS_ORDER.get(db_t_status, 0)
                     file_rank = STATUS_ORDER.get(t_status, 0)
-                    if db_rank >= file_rank:
-                        # C-15: DB is already at the same rank or ahead — prevent
-                        # regression.  Writeback syncs the file to match DB.
+                    db_terminal = db_t_status in {"done", "cancel"}
+                    file_terminal = t_status in {"done", "cancel"}
+                    if db_terminal and not file_terminal:
                         report.add(
                             severity="WARN", check_id="C-15",
                             message=(
-                                f"DB task '{t_id}' is ahead of file "
+                                f"DB task '{t_id}' is terminal "
                                 f"(db={db_t_status!r}, file={t_status!r}) "
-                                f"— regression prevented; writeback will sync file"
+                                f"— report only; file wins (ADR-001 / RMGR-WP-0005-T06)"
                             ),
                             file_path=f"{fname}#{t_id}",
                             db_id=t_sh_id,
                             file_value=t_status,
                             db_value=db_t_status,
-                            fixable=True,
-                            _fix_context={
-                                "task_id": t_sh_id,
-                                "wp_file": str(wp_file),
-                                "task_block_id": t_id,
-                                "db_status": db_t_status,
-                            },
-                        )
-                    else:
-                        # C-10: file is ahead — apply file→DB sync (normal drift)
-                        report.add(
-                            severity="WARN", check_id="C-10",
-                            message=(
-                                f"Task status drift '{t_id}': "
-                                f"file={t_status!r} db={db_t_status!r} (file wins)"
-                            ),
-                            file_path=f"{fname}#{t_id}",
-                            db_id=t_sh_id,
-                            file_value=t_status,
-                            db_value=db_t_status,
-                            fixable=True,
-                            _fix_context={"task_id": t_sh_id, "status": t_status},
+                            fixable=False,
                         )
+                    # File always wins, including same-rank wait ↔ progress.
+                    report.add(
+                        severity="WARN", check_id="C-10",
+                        message=(
+                            f"Task status drift '{t_id}': "
+                            f"file={t_status!r} db={db_t_status!r} (file wins)"
+                        ),
+                        file_path=f"{fname}#{t_id}",
+                        db_id=t_sh_id,
+                        file_value=t_status,
+                        db_value=db_t_status,
+                        fixable=True,
+                        _fix_context={"task_id": t_sh_id, "status": t_status},
+                    )
                 file_description = task.get("description")
                 if isinstance(file_description, str):
                     file_description = file_description.strip() or None
@@ -1265,6 +1969,36 @@ def check_repo(api_base: str, repo_slug: str, repo_path_override: str | None = N
                         fixable=True,
                         _fix_context={"task_id": t_sh_id, "description": file_description},
                     )
+                file_task_flavor = normalize_flavor(task.get("flavor"))
+                if file_task_flavor is not None and file_task_flavor not in WORK_RECORD_FLAVORS:
+                    report.add(
+                        severity="WARN",
+                        check_id="C-36",
+                        message=(
+                            f"Unknown work-record flavor {file_task_flavor!r} on task '{t_id}'"
+                        ),
+                        file_path=f"{fname}#{t_id}",
+                        db_id=t_sh_id,
+                        file_value=file_task_flavor,
+                        fixable=False,
+                    )
+                    file_task_flavor = None
+                db_task_flavor = normalize_flavor(db_task.get("flavor"))
+                if file_task_flavor != db_task_flavor:
+                    report.add(
+                        severity="WARN",
+                        check_id="C-38",
+                        message=(
+                            f"Task flavor drift '{t_id}': "
+                            f"file={file_task_flavor!r} db={db_task_flavor!r} (file wins)"
+                        ),
+                        file_path=f"{fname}#{t_id}",
+                        db_id=t_sh_id,
+                        file_value=file_task_flavor,
+                        db_value=db_task_flavor,
+                        fixable=True,
+                        _fix_context={"task_id": t_sh_id, "flavor": file_task_flavor},
+                    )
             elif t_id:
                 # C-11: task exists in file but not linked to DB
                 ws_status = ws.get("status", "")
@@ -2025,10 +2759,10 @@ def _write_custodian_brief(api_base: str, repo_slug: str, repo_path: str) -> boo
         return False
 
     repo_id: str = repo.get("id", "")
-    domain_slug: str = ""
+    domain_slug = str(repo.get("domain_slug") or "")
 
-    # Resolve domain slug: prefer active workstreams, fall back to any workstream
-    # so that a fully-finished repo doesn't degrade to "(unknown)".
+    # The repository projection owns domain identity. Retain the workplan/topic
+    # lookup only for compatibility with older API responses that omitted it.
     workstreams: list[dict] = []
     for status in OPEN_WORKSTREAM_STATUSES:
         rows = _api_get(api_base, "/workplans", {"repo_id": repo_id, "status": status}) or []
@@ -2038,7 +2772,7 @@ def _write_custodian_brief(api_base: str, repo_slug: str, repo_path: str) -> boo
     if not _ws_for_domain:
         all_ws = _api_get(api_base, "/workplans", {"repo_id": repo_id}) or []
         _ws_for_domain = all_ws if isinstance(all_ws, list) else []
-    if _ws_for_domain:
+    if not domain_slug and _ws_for_domain:
         topic = _api_get(api_base, f"/topics/{_ws_for_domain[0].get('topic_id', '')}")
         if topic:
             domain_slug = topic.get("domain_slug", "")
@@ -2259,12 +2993,35 @@ def fix_repo(
     repo_slug: str,
     repo_path_override: str | None = None,
     no_writeback: bool = False,
+    bootstrap_empty_projection: bool = False,
 ) -> ConsistencyReport:
     """Run checks then apply all auto-fixable issues. Returns updated report."""
-    report = check_repo(api_base, repo_slug, repo_path_override)
-    if any(i.check_id == "C-00" for i in report.failures):
+    report = check_repo(
+        api_base,
+        repo_slug,
+        repo_path_override,
+        bootstrap_empty_projection=bootstrap_empty_projection,
+    )
+    if any(i.check_id in {"C-00", "C-36"} for i in report.failures):
         return report
 
+    # RMGR-WP-0002: optional repo-manager reconcile proxy (index rebuild) for pilots
+    try:
+        from api.services.repo_manager_dual_run import reconcile_for_repo, rm_reconcile
+
+        if reconcile_for_repo(repo_slug) and report.repo_path:
+            rm_rec = rm_reconcile(repo_path=report.repo_path, repo_slug=repo_slug)
+            if rm_rec.get("ok") or rm_rec.get("exit_code") == 0:
+                report.fixes_applied.append(
+                    f"RM dual-run reconcile ok: index={rm_rec.get('index_path') or 'written'}"
+                )
+            else:
+                report.fixes_applied.append(
+                    f"RM dual-run reconcile note: {rm_rec.get('error') or rm_rec}"
+                )
+    except Exception as rec_exc:  # noqa: BLE001
+        report.fixes_applied.append(f"RM dual-run reconcile skipped: {rec_exc}")
+
     # Auto-register this machine's path in host_paths so future runs work
     # without --repo-path.  Idempotent: skipped when already correct.
     repo_path = report.repo_path
@@ -2387,6 +3144,9 @@ def fix_repo(
                 repo_id_val = ctx["repo_id"]
                 body = ctx.get("body", "")
                 wp_id = str(meta.get("id", "")).strip()
+                desired_ws_id = str(
+                    ctx.get("desired_ws_id") or _derived_work_record_uuid(wp_id)
+                )
                 title = str(meta.get("title", "")).strip()
                 status = str(meta.get("status", "active")).strip()
                 status = normalise_workstream_status(status)
@@ -2437,16 +3197,32 @@ def fix_repo(
                             (w for w in existing if w.get("repo_id") == repo_id_val),
                             None,
                         )
-                        if existing_same_repo and existing_same_repo.get("title") == (title or wp_id):
+                        if (
+                            existing_same_repo
+                            and existing_same_repo.get("title") == (title or wp_id)
+                            and existing_same_repo.get("id") == desired_ws_id
+                        ):
                             ws_data = existing_same_repo
                             report.fixes_applied.append(
                                 f"C-06 reusing existing workstream {ws_data['id'][:8]}... for {wp_id}"
                             )
                             break
-                        last_error = f"slug {slug!r} already belongs to another workstream"
+                        last_error = (
+                            f"slug {slug!r} already belongs to a different workplan identity"
+                        )
                         continue
 
+                    create_flavor = normalize_flavor(meta.get("flavor"))
+                    if create_flavor is not None and create_flavor not in WORK_RECORD_FLAVORS:
+                        create_flavor = None
+                    create_reason = normalize_promotion_reason(meta.get("flavor_promotion_reason"))
+                    if create_reason is not None and create_reason not in FLAVOR_PROMOTION_REASONS:
+                        create_reason = None
+                    create_from = normalize_flavor(meta.get("flavor_promoted_from"))
+                    if create_from is not None and create_from not in WORK_RECORD_FLAVORS:
+                        create_from = None
                     ws_data = _api_post(api_base, "/workplans", {
+                        "id": desired_ws_id,
                         "topic_id": topic_id,
                         "repo_id": repo_id_val,
                         "slug": slug,
@@ -2455,6 +3231,9 @@ def fix_repo(
                         "owner": str(meta.get("owner", "")).strip() or None,
                         "planning_priority": str(meta.get("planning_priority", "")).strip() or None,
                         "planning_order": _as_int_or_none(meta.get("planning_order")),
+                        "flavor": create_flavor,
+                        "flavor_promotion_reason": create_reason,
+                        "flavor_promoted_from": create_from,
                     })
                     if ws_data is None or (isinstance(ws_data, dict) and "_error" in ws_data):
                         last_error = ws_data.get("_error") if isinstance(ws_data, dict) else "no response"
@@ -2469,7 +3248,13 @@ def fix_repo(
                     continue
 
                 new_ws_id = ws_data["id"]
-                _add_frontmatter_field(wp_file, "state_hub_workstream_id", new_ws_id)
+                if new_ws_id != desired_ws_id:
+                    report.fixes_applied.append(
+                        f"C-06 FAIL {wp_id}: projection returned unexpected UUID {new_ws_id}"
+                    )
+                    continue
+                if not meta.get("state_hub_workstream_id"):
+                    _add_frontmatter_field(wp_file, "state_hub_workstream_id", new_ws_id)
                 report.fixes_applied.append(
                     f"C-06 fixed: created workstream {new_ws_id[:8]}… "
                     f"for {wp_id}, wrote ID to {wp_file.name}"
@@ -2487,27 +3272,135 @@ def fix_repo(
                     t_priority = str(task.get("priority", "medium")).strip()
                     if t_priority not in VALID_TASK_PRIORITIES:
                         t_priority = "medium"
+                    raw_task_id = task.get("state_hub_task_id")
+                    desired_task_id = (
+                        str(raw_task_id).strip().strip('"')
+                        if raw_task_id not in (None, "", "~", "null", "None", "none")
+                        else _derived_work_record_uuid(t_id)
+                    )
+                    task_flavor = normalize_flavor(task.get("flavor"))
+                    if task_flavor is not None and task_flavor not in WORK_RECORD_FLAVORS:
+                        task_flavor = None
                     t_data = _api_post(api_base, "/tasks", {
+                        "id": desired_task_id,
                         "workplan_id": new_ws_id,
                         "title": str(task.get("title", t_id)).strip() or t_id,
                         "description": task.get("description") or None,
                         "status": t_status,
                         "priority": t_priority,
                         "assignee": task.get("assignee") or None,
+                        "flavor": task_flavor,
                     })
                     if t_data and "_error" not in t_data:
                         t_db_id = t_data["id"]
-                        injected = _inject_task_id_into_block(
-                            wp_file, "state_hub_task_id", t_db_id, t_id
-                        )
-                        if not injected:
-                            _inject_task_id_frontmatter_list(wp_file, t_db_id, t_id)
+                        if t_db_id != desired_task_id:
+                            report.fixes_applied.append(
+                                f"  ! task {t_id} returned unexpected UUID {t_db_id}"
+                            )
+                            continue
+                        if not raw_task_id:
+                            injected = _inject_task_id_into_block(
+                                wp_file, "state_hub_task_id", t_db_id, t_id
+                            )
+                            if not injected:
+                                _inject_task_id_frontmatter_list(wp_file, t_db_id, t_id)
                         report.fixes_applied.append(f"  + task {t_id} → {t_db_id[:8]}…")
                     elif t_data:
                         report.fixes_applied.append(
                             f"  ! task {t_id} not created: {t_data.get('_error', t_data)}"
                         )
 
+            elif issue.check_id == "C-32":
+                md_path = ctx["md_path"]
+                kind = ctx["kind"]
+                rid = ctx["rid"]
+                meta = ctx["meta"]
+                id_field = _WORK_RECORD_ID_FIELD_BY_KIND[kind]
+                title = str(meta.get("title") or rid)
+                desired_record_id = ctx.get("desired_record_id")
+
+                repo_record = _api_get(api_base, f"/repos/{repo_slug}")
+                if not repo_record:
+                    report.fixes_applied.append(
+                        f"C-32 SKIP {rid}: could not look up repo '{repo_slug}'"
+                    )
+                    continue
+                created = None
+                if kind == "intake":
+                    payload = {
+                        "id": desired_record_id,
+                        "title": title,
+                        "repo_id": repo_record.get("id"),
+                        "description": meta.get("description"),
+                        "lane": meta.get("lane", "green"),
+                        "origin": meta.get("origin"),
+                        "origin_ref": meta.get("origin_ref"),
+                        "source_repo_path": str(md_path.relative_to(Path(report.repo_path))),
+                    }
+                    created = _api_post(api_base, "/intakes", payload)
+                elif kind == "decision":
+                    repo_market_domain = str(repo_record.get("domain_slug") or "").strip()
+                    topic_domain = resolve_topic_domain_slug(
+                        repo_market_domain, repo_market_domain=repo_market_domain or None
+                    )
+                    topics = _api_get(api_base, "/topics")
+                    topic_id = None
+                    if isinstance(topics, list):
+                        for t in topics:
+                            if t.get("domain_slug") == topic_domain:
+                                topic_id = t["id"]
+                                break
+                    if topic_id is None:
+                        report.fixes_applied.append(
+                            f"C-32 SKIP {rid}: no topic found for domain '{topic_domain}'"
+                        )
+                        continue
+                    payload = {
+                        "id": desired_record_id,
+                        "title": title,
+                        "topic_id": topic_id,
+                        "decision_type": meta.get("decision_type", "pending"),
+                        "description": meta.get("description"),
+                        "rationale": meta.get("agent_recommendation") or meta.get("rationale"),
+                    }
+                    created = _api_post(api_base, "/decisions", payload)
+
+                if not created or "_error" in created:
+                    report.fixes_applied.append(
+                        f"C-32 FAIL {rid}: could not create {kind} in DB: "
+                        f"{(created or {}).get('_error', 'no response')}"
+                    )
+                    continue
+
+                new_id = created["id"]
+                if desired_record_id and new_id != desired_record_id:
+                    report.fixes_applied.append(
+                        f"C-32 FAIL {rid}: projection returned unexpected UUID {new_id}"
+                    )
+                    continue
+                if desired_record_id:
+                    report.fixes_applied.append(
+                        f"C-32 fixed: created {kind} {new_id[:8]}… for {rid} "
+                        "with the authoritative ID"
+                    )
+                    continue
+                if _inject_yaml_block_field(md_path, id_field, new_id, rid):
+                    report.fixes_applied.append(
+                        f"C-32 fixed: created {kind} {new_id[:8]}… for {rid}, "
+                        f"wrote {id_field} to {md_path.name}"
+                    )
+                else:
+                    report.fixes_applied.append(
+                        f"C-32 WARN {rid}: created {kind} {new_id[:8]}… but "
+                        f"failed to write {id_field} back to {md_path.name}"
+                    )
+
+            elif issue.check_id == "C-33":
+                ctx["index_file"].write_text(ctx["content"], encoding="utf-8")
+                report.fixes_applied.append(
+                    f"C-33 fixed: regenerated {ctx['index_file'].name}"
+                )
+
             elif issue.check_id == "C-09":
                 ws_id = ctx["ws_id"]
                 correct_repo_id = ctx["correct_repo_id"]
@@ -2571,7 +3464,11 @@ def fix_repo(
                     t_priority = str(task.get("priority", "medium")).strip()
                     if t_priority not in VALID_TASK_PRIORITIES:
                         t_priority = "medium"
+                    desired_task_id = str(
+                        ctx.get("desired_task_id") or _derived_work_record_uuid(t_id)
+                    )
                     t_data = _api_post(api_base, "/tasks", {
+                        "id": desired_task_id,
                         "workplan_id": ws_id,
                         "title": str(task.get("title", t_id)).strip() or t_id,
                         "description": task.get("description") or None,
@@ -2581,11 +3478,17 @@ def fix_repo(
                     })
                     if t_data:
                         t_db_id = t_data["id"]
-                        injected = _inject_task_id_into_block(
-                            wp_file, "state_hub_task_id", t_db_id, t_id
-                        )
-                        if not injected:
-                            _inject_task_id_frontmatter_list(wp_file, t_db_id, t_id)
+                        if t_db_id != desired_task_id:
+                            report.fixes_applied.append(
+                                f"C-11 FAIL: task '{t_id}' returned unexpected UUID {t_db_id}"
+                            )
+                            continue
+                        if not task.get("state_hub_task_id"):
+                            injected = _inject_task_id_into_block(
+                                wp_file, "state_hub_task_id", t_db_id, t_id
+                            )
+                            if not injected:
+                                _inject_task_id_frontmatter_list(wp_file, t_db_id, t_id)
                         report.fixes_applied.append(
                             f"C-11 fixed: task '{t_id}' → {t_db_id[:8]}…"
                         )
@@ -2612,6 +3515,19 @@ def fix_repo(
                         f"C-22 FAILED: task {task_id[:8]}… description update: {result['_error']}"
                     )
 
+            elif issue.check_id == "C-38":
+                task_id = ctx["task_id"]
+                flavor = ctx.get("flavor")
+                result = _api_patch(api_base, f"/tasks/{task_id}", {"flavor": flavor})
+                if result is not None and "_error" not in result:
+                    report.fixes_applied.append(
+                        f"C-38 fixed: task {task_id[:8]}… flavor → {flavor!r}"
+                    )
+                elif result is not None:
+                    report.fixes_applied.append(
+                        f"C-38 FAILED: task {task_id[:8]}… flavor → {flavor!r}: {result['_error']}"
+                    )
+
             elif issue.check_id == "C-15":
                 # T03 — writeback: DB is ahead of file — patch file to match DB.
                 if no_writeback:
@@ -2624,22 +3540,68 @@ def fix_repo(
                     task_block_id = ctx["task_block_id"]
                     db_status = ctx["db_status"]
                     old_status = issue.file_value
-                    if _patch_task_status_in_file(wp_file, task_block_id, db_status):
-                        committed = _git_commit_writeback(
-                            repo_path,
-                            wp_file,
-                            [f"{task_block_id}: {old_status} → {db_status}"],
+                    # RMGR-WP-0002 dual-run: prefer repo-manager writeback when flagged
+                    rm_done = False
+                    try:
+                        from api.services.repo_manager_dual_run import (
+                            try_writeback_for_task,
+                            writeback_for_repo,
                         )
-                        suffix = " (committed)" if committed else " (file patched, commit failed)"
+
+                        if writeback_for_repo(repo_slug) and repo_path:
+                            # Prefer hub UUID when available for robust matching
+                            task_ref = ctx.get("task_id") or task_block_id
+                            rm_result = try_writeback_for_task(
+                                repo_path=repo_path,
+                                repo_slug=repo_slug,
+                                task_id=str(task_ref),
+                                status=db_status,
+                                reason="state-hub C-15 dual-run writeback",
+                            )
+                            if rm_result and rm_result.get("status") == "applied":
+                                git_sha = (rm_result.get("evidence") or {}).get("git_sha")
+                                suffix = f" (repo-manager git_sha={git_sha})" if git_sha else " (repo-manager)"
+                                report.fixes_applied.append(
+                                    f"C-15 fixed: task '{task_block_id}' "
+                                    f"{old_status} → {db_status}{suffix}"
+                                )
+                                rm_done = True
+                    except Exception as rm_exc:  # noqa: BLE001
                         report.fixes_applied.append(
-                            f"C-15 fixed: task '{task_block_id}' "
-                            f"{old_status} → {db_status}{suffix}"
-                        )
-                    else:
-                        report.fixes_applied.append(
-                            f"C-15 SKIP: could not locate task block '{task_block_id}' "
-                            f"in {wp_file.name}"
+                            f"C-15 dual-run fallback to native: {rm_exc}"
                         )
+                    if not rm_done:
+                        if _patch_task_status_in_file(wp_file, task_block_id, db_status):
+                            committed = _git_commit_writeback(
+                                repo_path,
+                                wp_file,
+                                [f"{task_block_id}: {old_status} → {db_status}"],
+                            )
+                            try:
+                                from api.services.repo_manager_dual_run import record_mutation
+
+                                record_mutation(
+                                    source="state-hub",
+                                    kind="task_status_writeback_c15",
+                                    repo_slug=repo_slug,
+                                    detail={
+                                        "task_block_id": task_block_id,
+                                        "status": db_status,
+                                        "committed": committed,
+                                    },
+                                )
+                            except Exception:
+                                pass
+                            suffix = " (committed)" if committed else " (file patched, commit failed)"
+                            report.fixes_applied.append(
+                                f"C-15 fixed: task '{task_block_id}' "
+                                f"{old_status} → {db_status}{suffix}"
+                            )
+                        else:
+                            report.fixes_applied.append(
+                                f"C-15 SKIP: could not locate task block '{task_block_id}' "
+                                f"in {wp_file.name}"
+                            )
 
         except Exception as e:
             report.fixes_applied.append(f"{issue.check_id} ERROR: {e}")
@@ -2994,6 +3956,14 @@ def main() -> None:
                              f"(default: {DEFAULT_REMOTE_ALL_MAX_SECONDS}; 0 disables)")
     parser.add_argument("--no-writeback", action="store_true", dest="no_writeback",
                         help="Disable DB→file status writeback (C-15) while keeping other fixes")
+    parser.add_argument(
+        "--bootstrap-empty-projection",
+        action="store_true",
+        help=(
+            "Rebuild authoritative legacy UUIDs only after proving the target "
+            "repository has zero projected workplans"
+        ),
+    )
     parser.add_argument("--archive-closed", action="store_true",
                         help="Move closed root workplans to workplans/archived/YYMMDD-*.md")
     parser.add_argument("--archive-workplan", metavar="ID_OR_FILE", default=None,
@@ -3031,6 +4001,11 @@ def main() -> None:
     import os as _os
     no_wb = getattr(args, "no_writeback", False)
     do_fix = args.fix or args.remote
+    if args.bootstrap_empty_projection and (not do_fix or args.all or args.remote):
+        parser.error(
+            "--bootstrap-empty-projection requires --fix for one local repository "
+            "and cannot be combined with --all or --remote"
+        )
 
     # --here: infer slug from git remote URL, then run as single-repo check/fix
     if args.here is not None:
@@ -3049,7 +4024,15 @@ def main() -> None:
         inferred_slug, git_root = inferred
         print(f"  Detected: {inferred_slug}  ({git_root})")
         if do_fix:
-            reports = [fix_repo(args.api_base, inferred_slug, git_root, no_writeback=no_wb)]
+            reports = [
+                fix_repo(
+                    args.api_base,
+                    inferred_slug,
+                    git_root,
+                    no_writeback=no_wb,
+                    bootstrap_empty_projection=args.bootstrap_empty_projection,
+                )
+            ]
         else:
             reports = [check_repo(args.api_base, inferred_slug, git_root)]
         if args.archive_closed:
@@ -3111,7 +4094,13 @@ def main() -> None:
             reports = [report]
         elif do_fix:
             reports = [
-                fix_repo(args.api_base, slug, path_override, no_writeback=no_wb)
+                fix_repo(
+                    args.api_base,
+                    slug,
+                    path_override,
+                    no_writeback=no_wb,
+                    bootstrap_empty_projection=args.bootstrap_empty_projection,
+                )
                 for slug in repo_slugs
             ]
         else:
diff --git a/scripts/project_rules/agents-codex.template b/scripts/project_rules/agents-codex.template
index 7576be9..9550e53 100644
--- a/scripts/project_rules/agents-codex.template
+++ b/scripts/project_rules/agents-codex.template
@@ -13,8 +13,10 @@
 
 ## State Hub Integration
 
-The Custodian State Hub tracks work across all domains. Interact via HTTP REST —
-there is no MCP server for Codex agents.
+The Custodian State Hub tracks work across all domains. Codex uses HTTP REST and
+the `statehub` CLI by default. MCP is opt-in because the current Codex MCP bridge
+adds severe call latency; the full administrative MCP surface remains available
+to clients that need it.
 
 | Context | URL |
 |---------|-----|
@@ -27,6 +29,19 @@ Queueable writes return an explicit queued receipt if the central hub is
 unreachable. Treat that as pending local evidence, then ask the operator to run
 statehub outbox status/replay after connectivity returns.
 
+Codex workspace-write sandboxes need network access enabled to reach the host's
+loopback listener. Bootstrap this once with `make -C ~/state-hub configure-codex`
+and restart Codex. The canonical REST health endpoint is `/state/health`, not
+`/health`. If a sandboxed loopback probe fails, retry it with escalated execution
+before declaring State Hub unavailable; a managed Codex permission profile may
+still enforce isolated networking. Experimental MCP can be enabled explicitly
+with `make -C ~/state-hub configure-codex WITH_MCP=1`.
+
+Repository files cross machine boundaries through committed Forge revisions:
+workstation agents push to Forgejo and cluster infrastructure reads a verified
+commit into ephemeral storage. Neither side reads or writes the other's
+checkout. `local_path` and `host_paths` describe host-local observations only.
+
 ### Orient at session start
 
 ```bash
@@ -97,13 +112,19 @@ curl -s -X PATCH "http://127.0.0.1:8000/tasks/<task_id>" \
 
 **Close:**
 1. Update workplan file task statuses to reflect progress
-2. Log: `POST /progress/` with a summary of what changed
-3. After workplan file changes, run:
+2. If finishing a workplan: hand off **residuals** as live work records first
+   (intake with `origin: residual` + `origin_ref: <WP-id>`, or a next workplan /
+   decision / engagement). Do not park leftovers only in prose or `SCOPE.md`.
+   Canon: `the-custodian/canon/standards/work-record-types_v0.1.md` § Residuals.
+3. Log: `POST /progress/` with a summary of what changed (name handoff ids)
+4. After workplan file changes, run:
    ```bash
-   statehub fix-consistency
+   uv run --project ~/repo-manager rmgr sync --path . --push
    ```
-   Coding agents should run this directly; ask the operator only if the CLI or
-   State Hub API is unavailable. This syncs task status from files into the hub DB.
+   This assigns only missing deterministic identifiers, verifies the pushed
+   Forgejo commit and `primary/railliance01`, then requests one central
+   reconciliation. A queued receipt is pending evidence; rerun after
+   connectivity returns. Use `statehub fix-consistency` for a separate deep audit.
 
 ---
 
@@ -127,9 +148,13 @@ read/cache/index layer that rebuilds from files.
 the completion/archive date; the frontmatter `id` does not change.
 
 **Ad Hoc Tasks:** small opportunistic fixes discovered during a session use
-`workplans/ADHOC-YYYY-MM-DD.md` with task ids `ADHOC-YYYY-MM-DD-T01`, etc. Use
-this only for low-risk work completed directly; create a normal workplan for
-anything needing analysis, design, approval, dependencies, or multiple phases.
+`workplans/ADHOC-YYYY-MM-DD.md`, workplan id
+`{WP_PREFIX}-ADHOC-YYYY-MM-DD`, and task ids
+`{WP_PREFIX}-ADHOC-YYYY-MM-DD-T01`, etc. `{WP_PREFIX}` includes its final `-WP`
+token. Unqualified historic `ADHOC-*` ids are grandfathered and must not be
+copied into new records. Use this only for low-risk work completed directly;
+create a normal workplan for anything needing analysis, design, approval,
+dependencies, or multiple phases.
 
 **Frontmatter:**
 
@@ -145,7 +170,7 @@ owner: codex
 topic_slug: ...
 created: "YYYY-MM-DD"
 updated: "YYYY-MM-DD"
-state_hub_workstream_id: "<uuid>"   # fix-consistency — do not edit (legacy field name; workplan UUID)
+state_hub_workstream_id: "<uuid>"   # deterministic UUIDv5; managed by Repo Manager
 ---
 ```
 
@@ -166,7 +191,7 @@ API/MCP/frontmatter bridges until `STATE-WP-0069` retires them — see
 id: {WP_PREFIX}-NNNN-T01
 status: wait | todo | progress | done | cancel
 priority: high | medium | low
-state_hub_task_id: "<uuid>"         # written by fix-consistency — do not edit
+state_hub_task_id: "<uuid>"         # deterministic UUIDv5; managed by Repo Manager
 ` ` `
 
 Task description text.
@@ -174,7 +199,12 @@ Task description text.
 
 Status progression: `todo` → `progress` → `done`; use `wait` for waiting/blocked work and `cancel` for stopped work.
 
+**Residuals when finishing:** actionable leftovers become live work records
+before `status: finished` — usually an intake (`origin: residual`,
+`origin_ref: {WP_PREFIX}-NNNN`) or a spawned workplan. Residual is a *role*,
+not a kind. Fleet list lives on State Hub, not in `SCOPE.md`.
+
 To create a new workplan:
 1. Write the file following the format above
-2. Run `statehub fix-consistency` locally; ask the operator only if the CLI or
-   State Hub API is unavailable.
+2. Run `uv run --project ~/repo-manager rmgr sync --path . --push`.
+3. Run `statehub fix-consistency` only when a separate deep audit is needed.
diff --git a/scripts/project_rules/first-session.template b/scripts/project_rules/first-session.template
index 195f8ca..1bdb179 100644
--- a/scripts/project_rules/first-session.template
+++ b/scripts/project_rules/first-session.template
@@ -15,19 +15,19 @@ Look for TODOs, open branches, half-finished files. Note done vs. started but in
 Propose 1–3 workplans — each a coherent strand, weeks to months, anchored to a
 roadmap phase. **Wait for approval before creating.**
 
-**Step 4 — Write the workplan file; fix-consistency registers it (ADR-001)**
+**Step 4 — Write the workplan file; Repo Manager projects it (ADR-001)**
 ```
 workplans/{WP_PREFIX}-NNNN-<slug>.md   ← write this, commit it
 ```
-Then register by running the consistency check — do **not** call
-`create_workplan`/`create_task` yourself; manual registration duplicates what
-C-06 creates from the file:
+Then run the deterministic, forge-derived sync — do **not** call
+`create_workplan`/`create_task` yourself:
 ```bash
-statehub fix-consistency --repo {REPO_SLUG}
+uv run --project ~/repo-manager rmgr sync --path . --push
 ```
-C-06 creates the hub workplan + tasks and writes `state_hub_workstream_id`
-(legacy frontmatter name — holds the workplan UUID) and `state_hub_task_id`
-back into the file.
+Repo Manager writes deterministic `state_hub_workstream_id` and
+`state_hub_task_id` values, pushes the file, verifies `primary/railliance01`,
+and asks central to derive that exact Forgejo commit. If connectivity is down,
+the queued receipt is pending evidence; rerun the same command later.
 
 **Step 5 — Record the setup**
 ```
diff --git a/scripts/project_rules/session-protocol.template b/scripts/project_rules/session-protocol.template
index 5c73ffa..06ff8ab 100644
--- a/scripts/project_rules/session-protocol.template
+++ b/scripts/project_rules/session-protocol.template
@@ -58,14 +58,24 @@ If no workplans: follow First Session Protocol (`first-session.md`).
 
 > State Hub is a *read model*. **Never register workplans or tasks by hand**
 > (`create_workplan`, `create_task`) — write the workplan file in `workplans/`
-> and run `fix-consistency`; C-06 registers the workplan and tasks and writes
-> IDs back into the file. Manual registration creates duplicates when
-> fix-consistency runs. Work structure belongs in repo files (ADR-001).
+> and run `uv run --project ~/repo-manager rmgr sync --path . --push`.
+> Repo Manager assigns missing deterministic IDs; central derives the exact
+> pushed Forgejo commit. Manual registration creates duplicate ownership.
+> Work structure belongs in repo files (ADR-001).
 >
 > Legacy: `create_workstream` and `/workstreams/` remain as metered aliases —
 > see `workplan-convention.md` (compatibility footnote).
 
 **Session close:**
+1. Update workplan/task statuses in repo files.
+2. If marking a workplan **finished**: hand off residuals as **live work
+   records** first (intake with `origin: residual` + `origin_ref: <WP-id>`, or
+   a child workplan / decision / engagement). Do not leave actionable leftovers
+   only as prose or in `SCOPE.md`. See work-record-types § Residuals.
+3. Log progress (below).
+4. `uv run --project ~/repo-manager rmgr sync --path . --push` when workplan
+   files changed. Use `statehub fix-consistency` separately for a deep audit.
+
 With MCP tools:
 ```
 add_progress_event(summary="...", topic_id="{TOPIC_ID}", workplan_id="<uuid>")
@@ -80,13 +90,7 @@ If workplan files were modified, ensure the local copy is up to date first,
 then sync from the repo checkout:
 ```bash
 git pull --ff-only
-statehub fix-consistency
+uv run --project ~/repo-manager rmgr sync --path . --push
 ```
-For repos where implementation runs on a remote machine (e.g. CoulombCore),
-use the pull-before-fix mode from any shell with the State Hub CLI:
-```bash
-statehub fix-consistency --repo {REPO_SLUG} --remote
-```
-**C-15** (DB task ahead of file) is normal in multi-machine workflows — writeback
-will sync the file to match DB.  **C-16** (repo behind remote) blocks all writes
-until you pull — intentional to prevent clobbering remote progress.
+The sync refuses uncommitted workplan files and a branch behind its upstream.
+This prevents a workstation projection from getting ahead of the forge source.
diff --git a/scripts/project_rules/workplan-convention.template b/scripts/project_rules/workplan-convention.template
index ca9b4d9..81b73be 100644
--- a/scripts/project_rules/workplan-convention.template
+++ b/scripts/project_rules/workplan-convention.template
@@ -16,15 +16,26 @@ prefix: `YYMMDD-{WP_PREFIX}-NNNN-<slug>.md`. The frontmatter id remains
 unchanged; the prefix is only for quick visual reference.
 
 Small opportunistic tasks discovered during another session use **Ad Hoc Tasks**:
-`workplans/ADHOC-YYYY-MM-DD.md`, workplan slug `adhoc-YYYY-MM-DD`, and task ids
-`ADHOC-YYYY-MM-DD-T01`, `T02`, etc. Use adhocs only for low-risk work completed
-directly. Promote anything requiring analysis, design, approval, dependencies, or
-multiple planned phases into a normal workplan.
+`workplans/ADHOC-YYYY-MM-DD.md`, workplan id
+`{WP_PREFIX}-ADHOC-YYYY-MM-DD`, and task ids
+`{WP_PREFIX}-ADHOC-YYYY-MM-DD-T01`, `T02`, etc. `{WP_PREFIX}` includes its final
+`-WP` token. Unqualified historic `ADHOC-*` ids are grandfathered and must not
+be copied into new records. Use adhocs only for low-risk work completed directly.
+Promote anything requiring analysis, design, approval, dependencies, or multiple
+planned phases into a normal workplan.
 
 Ecosystem todos from other agents arrive as `[repo:{REPO_SLUG}]` hub tasks —
-visible at session start. Pick one up by creating the workplan file, committing,
-and running `statehub fix-consistency` — C-06 registers the workplan in the hub.
-Never register by hand with `create_workplan` (legacy MCP alias: `create_workstream`).
+visible at session start. Pick one up by creating the workplan file, then run
+the fast authoritative projection path:
+
+```bash
+uv run --project ~/repo-manager rmgr sync --path . --push
+```
+
+Repo Manager assigns only missing deterministic identifiers. Central reads the
+exact pushed Forgejo commit and updates its replaceable projection. Never
+register by hand with `create_workplan` or `create_task`. Use
+`statehub fix-consistency` separately for a deep audit.
 
 Task blocks use this shape:
 
@@ -38,6 +49,22 @@ state_hub_task_id: "<uuid>"         # written by fix-consistency — do not edit
 Status progression is `todo` → `progress` → `done`; use `wait` for waiting or
 blocked work and `cancel` for stopped work.
 
+### Residuals (role, not kind)
+
+When finishing a workplan, **actionable leftovers must become live work
+records** before `status: finished`. Residual is not a registered kind and
+must not be parked only in `SCOPE.md` or finished-file prose.
+
+| Shape | Capture as | Links |
+| --- | --- | --- |
+| Small Green/Blue parkable | intake (queue YAML / `*-IN-*`) | `origin: residual`, `origin_ref: {WP_PREFIX}-NNNN` |
+| Multi-step | next workplan | name parent WP; optional promote from residual intake |
+| Founder gate / time | decision / engagement | same origin fields when from residual intake |
+
+Fleet listing of residuals is a State Hub concern (`list_intakes` + origin
+filters; planned `statehub residuals`). Canon:
+`the-custodian/canon/standards/work-record-types_v0.1.md` § Residuals.
+
 Workplan frontmatter carries `state_hub_workstream_id` — a legacy field name
 kept for compatibility; it holds the hub workplan UUID and is written by
 fix-consistency. Do not edit or rename it.
diff --git a/scripts/promote_intake.py b/scripts/promote_intake.py
new file mode 100644
index 0000000..6a8b731
--- /dev/null
+++ b/scripts/promote_intake.py
@@ -0,0 +1,448 @@
+#!/usr/bin/env python3
+"""Promote a routed intake work record into a workplan, task, decision, or
+engagement — CUST-WP-0061-T03, the promotion transition named in
+canon/standards/work-record-types_v0.1.md:
+
+    "Promotion is a first-class transition: intake.routed -> workplan |
+    task | decision | engagement, executed by one CLI/MCP call that writes
+    both artefacts, sets promoted_to/origin back-links, and re-syncs.
+    Manual transcription of an intake item into other kinds is a process
+    defect."
+
+This is the mechanism AWQ-010 needed and didn't have: a human/agent had to
+notice, transcribe, and re-register it by hand (binky-control, 2026-07-19).
+One call does what that manual pass did.
+
+Kinds:
+  workplan    — new ADR-001 file at workplans/{ID}-{slug}.md, registered
+                against the hub the same way C-06 registers workplans.
+  task        — appended as a ```task``` block to an existing workplan
+                file (--workplan-file), registered via POST /tasks.
+  decision    — appended as a ```yaml``` block with a fresh {PREFIX}-DEC-
+                {YYYY}-{NNN} id to --target-file, registered the same way
+                C-32 registers decisions.
+  engagement  — appended as a ```yaml``` block with a fresh {PREFIX}-ENG-
+                {YYYY}-{NNN} id to --target-file. File-only: no hub entity
+                exists for engagements yet (CUST-WP-0061 stage-3 seed) —
+                this is reported, not silently skipped.
+
+In every case: the intake is closed with outcome=promoted and
+promoted_to=<new canonical id>; the new record's file carries an
+`origin: intake:<intake-id>` back-link.
+"""
+from __future__ import annotations
+
+import argparse
+import re
+import sys
+from datetime import date, datetime, timezone
+from pathlib import Path
+
+sys.path.insert(0, str(Path(__file__).parent))
+
+from consistency_check import (  # noqa: E402
+    _api_get,
+    _api_patch,
+    _api_post,
+    _inject_task_id_into_block,
+    _inject_yaml_block_field,
+    infer_wp_prefix,
+    resolve_topic_domain_slug,
+)
+
+_SKIP_DIRS = frozenset({".git", "node_modules", ".venv", "history", "agents_backup"})
+
+
+class PromotionError(Exception):
+    pass
+
+
+def _slugify(title: str) -> str:
+    slug = re.sub(r"[^a-z0-9]+", "-", title.lower()).strip("-")
+    return slug[:60].rstrip("-") or "untitled"
+
+
+def _next_number(repo_dir: Path, id_regex: re.Pattern, *, width: int = 4) -> int:
+    """Scan every .md file for ids matching id_regex (capture group 1 = the
+    numeric part); return the next free sequence number."""
+    max_n = 0
+    for md in repo_dir.rglob("*.md"):
+        if any(part in _SKIP_DIRS for part in md.parts):
+            continue
+        try:
+            text = md.read_text(errors="replace")
+        except OSError:
+            continue
+        for m in id_regex.finditer(text):
+            try:
+                max_n = max(max_n, int(m.group(1)))
+            except (ValueError, IndexError):
+                continue
+    return max_n + 1
+
+
+def _fetch_intake(api_base: str, intake_id: str) -> dict:
+    intake = _api_get(api_base, f"/intakes/{intake_id}")
+    if not intake or (isinstance(intake, dict) and "_error" in intake):
+        raise PromotionError(f"could not fetch intake {intake_id}: {intake}")
+    if intake.get("status") != "routed":
+        raise PromotionError(
+            f"intake {intake_id} is '{intake.get('status')}', not 'routed' — "
+            f"route it first (POST /intakes/{intake_id}/route)"
+        )
+    return intake
+
+
+def _close_intake(api_base: str, intake_id: str, canonical_id: str, to_kind: str) -> dict:
+    result = _api_post(api_base, f"/intakes/{intake_id}/close", {
+        "outcome": "promoted",
+        "promoted_to": canonical_id,
+        "note": f"promoted to {to_kind} {canonical_id}",
+    })
+    if not result or (isinstance(result, dict) and "_error" in result):
+        raise PromotionError(f"created {canonical_id} but failed to close intake: {result}")
+    return result
+
+
+def _origin_line(intake_id: str) -> str:
+    return f'origin: "intake:{intake_id}"'
+
+
+# ---------------------------------------------------------------------------
+# workplan
+# ---------------------------------------------------------------------------
+
+def _promote_to_workplan(
+    api_base: str, repo_dir: Path, repo_slug: str, domain: str, intake: dict,
+) -> tuple[str, Path]:
+    prefix = infer_wp_prefix(repo_dir, repo_slug)
+    id_re = re.compile(rf"\b{re.escape(prefix)}-(\d+)\b")
+    number = _next_number(repo_dir, id_re)
+    new_id = f"{prefix}-{str(number).zfill(4)}"
+    slug = _slugify(intake["title"])
+    workplans_dir = repo_dir / "workplans"
+    workplans_dir.mkdir(exist_ok=True)
+    new_file = workplans_dir / f"{new_id}-{slug}.md"
+    if new_file.exists():
+        raise PromotionError(f"target file already exists: {new_file}")
+
+    today = date.today().isoformat()
+    body = intake.get("description") or intake["title"]
+    flavor = (
+        "residual"
+        if (intake.get("origin") or "") in ("residual", "handoff")
+        else "planning"
+    )
+    origin_lines = ""
+    if intake.get("origin"):
+        origin_lines = (
+            f"origin: {intake.get('origin')}\n"
+            f"origin_ref: {intake.get('id')}\n"
+        )
+    content = (
+        f"---\n"
+        f'id: {new_id}\n'
+        f"type: workplan\n"
+        f'title: "{intake["title"]}"\n'
+        f"domain: {domain}\n"
+        f"repo: {repo_slug}\n"
+        f"status: proposed\n"
+        f"flavor: {flavor}\n"
+        f"depends_on: []\n"
+        f"{origin_lines}"
+        f"owner: codex\n"
+        f'created: "{today}"\n'
+        f'updated: "{today}"\n'
+        f"---\n\n"
+        f'# {intake["title"]}\n\n'
+        f"{body}\n\n"
+        f"**Promoted from intake** `{intake['id']}` — {_origin_line(intake['id'])}\n"
+    )
+    new_file.write_text(content, encoding="utf-8")
+
+    topics = _api_get(api_base, "/topics")
+    topic_domain = resolve_topic_domain_slug(domain, repo_market_domain=domain or None)
+    topic_id = None
+    if isinstance(topics, list):
+        for t in topics:
+            if t.get("domain_slug") == topic_domain:
+                topic_id = t["id"]
+                break
+    if topic_id is None:
+        raise PromotionError(
+            f"wrote {new_file.name} but no topic found for domain '{topic_domain}' "
+            f"— could not register the workstream; run fix-consistency to finish registration"
+        )
+
+    repo_record = _api_get(api_base, f"/repos/{repo_slug}")
+    if not repo_record or (isinstance(repo_record, dict) and "_error" in repo_record):
+        raise PromotionError(
+            f"wrote {new_file.name} but could not look up repo '{repo_slug}' "
+            f"({repo_record}) — could not register the workstream; "
+            f"run fix-consistency to finish registration"
+        )
+
+    ws = _api_post(api_base, "/workplans", {
+        "topic_id": topic_id,
+        "repo_id": repo_record["id"],
+        "title": intake["title"],
+        "slug": f"{repo_slug}-{slug}",
+        "status": "active",
+        "owner": "codex",
+    })
+    if not ws or (isinstance(ws, dict) and "_error" in ws):
+        raise PromotionError(
+            f"wrote {new_file.name} but workstream registration failed: {ws} "
+            f"— run fix-consistency to finish registration (C-06 will pick it up)"
+        )
+    _inject_field_in_frontmatter(new_file, "state_hub_workstream_id", ws["id"])
+
+    return new_id, new_file
+
+
+def _inject_field_in_frontmatter(file_path: Path, field: str, value: str) -> None:
+    text = file_path.read_text(encoding="utf-8")
+    parts = text.split("---", 2)
+    if len(parts) < 3:
+        return
+    parts[1] = parts[1].rstrip() + f'\n{field}: "{value}"\n'
+    file_path.write_text("---".join(parts), encoding="utf-8")
+
+
+# ---------------------------------------------------------------------------
+# task
+# ---------------------------------------------------------------------------
+
+def _promote_to_task(api_base: str, workplan_file: Path, intake: dict) -> str:
+    if not workplan_file.is_file():
+        raise PromotionError(f"--workplan-file not found: {workplan_file}")
+    text = workplan_file.read_text(encoding="utf-8")
+    wp_id_match = re.search(r"^id:\s*(\S+)", text, re.MULTILINE)
+    if not wp_id_match:
+        raise PromotionError(f"could not find workplan id in {workplan_file}")
+    wp_id = wp_id_match.group(1).strip().strip('"')
+    ws_id_match = re.search(r'^state_hub_workstream_id:\s*"?([\w-]+)"?', text, re.MULTILINE)
+    if not ws_id_match:
+        raise PromotionError(
+            f"{workplan_file} has no state_hub_workstream_id — run fix-consistency on it first"
+        )
+    ws_id = ws_id_match.group(1)
+
+    existing_t_re = re.compile(rf"{re.escape(wp_id)}-T(\d+)")
+    number = _next_number(workplan_file.parent.parent, existing_t_re)
+    t_id = f"{wp_id}-T{str(number).zfill(2)}"
+
+    body = intake.get("description") or intake["title"]
+    section = (
+        f'\n## Task: {intake["title"]}\n\n'
+        f"{body}\n\n"
+        f"Promoted from intake `{intake['id']}`.\n\n"
+        f"```task\n"
+        f"id: {t_id}\n"
+        f"status: todo\n"
+        f"priority: medium\n"
+        f"```\n"
+    )
+    workplan_file.write_text(text.rstrip() + "\n" + section, encoding="utf-8")
+
+    task = _api_post(api_base, "/tasks", {
+        "workplan_id": ws_id,
+        "title": intake["title"],
+        "description": intake.get("description"),
+        "status": "todo",
+        "priority": "medium",
+    })
+    if task and "_error" not in task:
+        _inject_task_id_into_block(workplan_file, "state_hub_task_id", task["id"], t_id)
+
+    return t_id
+
+
+# ---------------------------------------------------------------------------
+# decision / engagement — share the "yaml block appended to a target file"
+# shape; decision has a hub entity (C-32-style registration), engagement
+# does not yet.
+# ---------------------------------------------------------------------------
+
+def _next_dec_or_eng_id(repo_dir: Path, prefix: str, kind_infix: str) -> str:
+    year = date.today().year
+    id_re = re.compile(rf"\b{re.escape(prefix)}-{kind_infix}-{year}-(\d+)\b")
+    number = _next_number(repo_dir, id_re, width=3)
+    return f"{prefix}-{kind_infix}-{year}-{str(number).zfill(3)}"
+
+
+def _promote_to_decision(
+    api_base: str, repo_dir: Path, repo_slug: str, domain: str,
+    target_file: Path, intake: dict,
+) -> str:
+    prefix = infer_wp_prefix(repo_dir, repo_slug).replace("-WP", "")
+    new_id = _next_dec_or_eng_id(repo_dir, prefix, "DEC")
+    _append_yaml_block(target_file, {
+        "id": new_id,
+        "title": intake["title"],
+        "status": "prepared",
+        "lane": intake.get("lane", "yellow"),
+        "agent_recommendation": intake.get("description") or "(fill in before founder review)",
+        "fallback_if_no_response": "no degradation — remains pending",
+        "created_at": date.today().isoformat(),
+    }, origin_intake_id=intake["id"])
+
+    topics = _api_get(api_base, "/topics")
+    topic_domain = resolve_topic_domain_slug(domain, repo_market_domain=domain or None)
+    topic_id = None
+    if isinstance(topics, list):
+        for t in topics:
+            if t.get("domain_slug") == topic_domain:
+                topic_id = t["id"]
+                break
+    if topic_id is None:
+        raise PromotionError(
+            f"wrote {new_id} to {target_file.name} but no topic found for domain "
+            f"'{topic_domain}' — run fix-consistency to finish registration"
+        )
+
+    decision = _api_post(api_base, "/decisions", {
+        "title": intake["title"],
+        "topic_id": topic_id,
+        "decision_type": "pending",
+        "description": intake.get("description"),
+    })
+    if decision and "_error" not in decision:
+        _inject_yaml_block_field(target_file, "state_hub_decision_id", decision["id"], new_id)
+
+    return new_id
+
+
+def _promote_to_engagement(repo_dir: Path, repo_slug: str, target_file: Path, intake: dict) -> str:
+    prefix = infer_wp_prefix(repo_dir, repo_slug).replace("-WP", "")
+    new_id = _next_dec_or_eng_id(repo_dir, prefix, "ENG")
+    _append_yaml_block(target_file, {
+        "id": new_id,
+        "title": intake["title"],
+        "status": "queued",
+        "counterparty": "(fill in)",
+        "prepared_material": [],
+        "deadline_pressure": "none",
+    }, origin_intake_id=intake["id"])
+    return new_id
+
+
+def _append_yaml_block(target_file: Path, fields: dict, *, origin_intake_id: str) -> None:
+    lines = ["```yaml"]
+    for k, v in fields.items():
+        if isinstance(v, str):
+            lines.append(f'{k}: "{v}"')
+        elif isinstance(v, list):
+            lines.append(f"{k}: {v!r}")
+        else:
+            lines.append(f"{k}: {v}")
+    lines.append(f'origin: "intake:{origin_intake_id}"')
+    lines.append("```")
+    block = "\n".join(lines) + "\n"
+
+    if target_file.exists():
+        existing = target_file.read_text(encoding="utf-8")
+        target_file.write_text(existing.rstrip() + "\n\n" + block, encoding="utf-8")
+    else:
+        target_file.parent.mkdir(parents=True, exist_ok=True)
+        target_file.write_text(block, encoding="utf-8")
+
+
+# ---------------------------------------------------------------------------
+# entry point
+# ---------------------------------------------------------------------------
+
+def _soft_warn_missing_doc(intake: dict) -> None:
+    """STATE-WP-0077: warn (do not block) if DoC-Ok is not recorded."""
+    try:
+        from quality_assessment import intake_has_doc_ok
+    except ImportError:
+        sys.path.insert(0, str(Path(__file__).resolve().parent))
+        from quality_assessment import intake_has_doc_ok  # type: ignore
+    if intake_has_doc_ok(intake):
+        return
+    print(
+        "WARNING: intake has no DoC-Ok recorded (quality_doc / notes). "
+        "Promotion continues (soft only). Assess Definition of Comprehension "
+        "before confident promote — docs/work-record-quality-gates.md",
+        file=sys.stderr,
+    )
+
+
+def promote_intake(
+    api_base: str,
+    intake_id: str,
+    to_kind: str,
+    repo_dir: Path,
+    repo_slug: str,
+    domain: str,
+    *,
+    target_file: str | None = None,
+    workplan_file: str | None = None,
+) -> dict:
+    intake = _fetch_intake(api_base, intake_id)
+    _soft_warn_missing_doc(intake)
+
+    if to_kind == "workplan":
+        canonical_id, new_file = _promote_to_workplan(api_base, repo_dir, repo_slug, domain, intake)
+        location = str(new_file.relative_to(repo_dir))
+    elif to_kind == "task":
+        if not workplan_file:
+            raise PromotionError("--to task requires --workplan-file")
+        wp_path = repo_dir / workplan_file
+        canonical_id = _promote_to_task(api_base, wp_path, intake)
+        location = workplan_file
+    elif to_kind == "decision":
+        if not target_file:
+            raise PromotionError("--to decision requires --target-file")
+        canonical_id = _promote_to_decision(
+            api_base, repo_dir, repo_slug, domain, repo_dir / target_file, intake
+        )
+        location = target_file
+    elif to_kind == "engagement":
+        if not target_file:
+            raise PromotionError("--to engagement requires --target-file")
+        canonical_id = _promote_to_engagement(repo_dir, repo_slug, repo_dir / target_file, intake)
+        location = target_file
+    else:
+        raise PromotionError(f"unsupported --to kind: {to_kind!r} (workplan|task|decision|engagement)")
+
+    _close_intake(api_base, intake_id, canonical_id, to_kind)
+
+    return {
+        "intake_id": intake_id,
+        "to_kind": to_kind,
+        "canonical_id": canonical_id,
+        "location": location,
+    }
+
+
+def main() -> None:
+    ap = argparse.ArgumentParser(description=__doc__, formatter_class=argparse.RawDescriptionHelpFormatter)
+    ap.add_argument("intake_id")
+    ap.add_argument("--to", required=True, choices=["workplan", "task", "decision", "engagement"])
+    ap.add_argument("--repo-path", default=".", help="local checkout path of the target repo")
+    ap.add_argument("--repo-slug", required=True)
+    ap.add_argument("--domain", required=True, help="market domain slug, e.g. infotech")
+    ap.add_argument("--target-file", default=None, help="repo-relative path (decision/engagement)")
+    ap.add_argument("--workplan-file", default=None, help="repo-relative workplan file path (task)")
+    ap.add_argument("--api-base", default="http://127.0.0.1:8000")
+    args = ap.parse_args()
+
+    try:
+        result = promote_intake(
+            args.api_base, args.intake_id, args.to,
+            Path(args.repo_path).resolve(), args.repo_slug, args.domain,
+            target_file=args.target_file, workplan_file=args.workplan_file,
+        )
+    except PromotionError as e:
+        print(f"ERROR: {e}", file=sys.stderr)
+        sys.exit(1)
+
+    print(f"Promoted intake {result['intake_id']} -> {result['to_kind']} {result['canonical_id']}")
+    print(f"  file: {result['location']}")
+    print("  Review, commit, and push the change — promotion writes files but does not commit.")
+
+
+if __name__ == "__main__":
+    main()
diff --git a/scripts/quality_assessment.py b/scripts/quality_assessment.py
new file mode 100644
index 0000000..8edc5f0
--- /dev/null
+++ b/scripts/quality_assessment.py
@@ -0,0 +1,187 @@
+#!/usr/bin/env python3
+"""DoX quality assessment helpers (STATE-WP-0077).
+
+Canonical recording fields and parsing for Definition assessments.
+See docs/work-record-quality-gates.md.
+"""
+from __future__ import annotations
+
+import re
+from dataclasses import dataclass
+from typing import Any
+
+POLICIES = ("DoC", "DoR", "DoD")
+
+FIELD_FOR_POLICY = {
+    "DoC": "quality_doc",
+    "DoR": "quality_dor",
+    "DoD": "quality_dod",
+}
+
+
+def _norm_policy(policy: str) -> str:
+    p = policy.strip()
+    upper = p.upper().replace(" ", "").replace("_", "")
+    if upper in ("DOC", "COMPREHENSION", "DEFINITIONOFCOMPREHENSION"):
+        return "DoC"
+    if upper in ("DOR", "READY", "DEFINITIONOFREADY"):
+        return "DoR"
+    if upper in ("DOD", "DONE", "DEFINITIONOFDONE"):
+        return "DoD"
+    if p in POLICIES:
+        return p
+    raise ValueError(f"unknown policy {policy!r}; use DoC, DoR, or DoD")
+
+
+def badge(policy: str, outcome: str) -> str:
+    """Map policy + Ok|Failed (or full badge) to DoX-Ok / DoX-Failed."""
+    pol = _norm_policy(policy)
+    out = outcome.strip().strip('"')
+    if out in (f"{pol}-Ok", f"{pol}-Failed"):
+        return out
+    if out.lower() in ("ok", "pass", "passed"):
+        return f"{pol}-Ok"
+    if out.lower() in ("failed", "fail", "no"):
+        return f"{pol}-Failed"
+    raise ValueError(f"unknown outcome {outcome!r} for {pol}")
+
+
+def assessment_from_mapping(meta: dict, policy: str) -> str | None:
+    """Read assessment badge for policy from frontmatter / YAML / task fields."""
+    pol = _norm_policy(policy)
+    key = FIELD_FOR_POLICY[pol]
+    raw = meta.get(key)
+    if raw is None:
+        return None
+    s = str(raw).strip().strip('"').strip("'")
+    if not s or s.lower() in ("unassessed", "none", "null", "~", "-"):
+        return None
+    try:
+        return badge(pol, s)
+    except ValueError:
+        return None
+
+
+def is_ok(badge_value: str | None) -> bool:
+    return bool(badge_value) and str(badge_value).endswith("-Ok")
+
+
+@dataclass(frozen=True)
+class QualityDebtItem:
+    kind: str
+    record_id: str
+    lifecycle_status: str
+    missing: str
+    path: str
+    detail: str = ""
+
+
+def debt_for_workplan_meta(meta: dict, *, path: str) -> list[QualityDebtItem]:
+    """Quality debt for a workplan frontmatter dict."""
+    items: list[QualityDebtItem] = []
+    wp_id = str(meta.get("id", "")).strip() or path
+    status = str(meta.get("status", "")).strip().lower()
+    dor = assessment_from_mapping(meta, "DoR")
+    dod = assessment_from_mapping(meta, "DoD")
+    if status == "ready" and not is_ok(dor):
+        items.append(
+            QualityDebtItem(
+                kind="workplan",
+                record_id=wp_id,
+                lifecycle_status=status,
+                missing="DoR-Ok",
+                path=path,
+                detail=f"quality_dor={dor or 'unassessed'}",
+            )
+        )
+    if status in ("finished", "completed") and not is_ok(dod):
+        items.append(
+            QualityDebtItem(
+                kind="workplan",
+                record_id=wp_id,
+                lifecycle_status=status,
+                missing="DoD-Ok",
+                path=path,
+                detail=f"quality_dod={dod or 'unassessed'}",
+            )
+        )
+    return items
+
+
+def debt_for_intake_meta(meta: dict, *, path: str) -> list[QualityDebtItem]:
+    """Quality debt for intake blocks in vetted/routed without DoC-Ok."""
+    items: list[QualityDebtItem] = []
+    iid = str(meta.get("id", "")).strip() or path
+    status = str(meta.get("status", "")).strip().lower()
+    doc = assessment_from_mapping(meta, "DoC")
+    if status in ("vetted", "routed") and not is_ok(doc):
+        items.append(
+            QualityDebtItem(
+                kind="intake",
+                record_id=iid,
+                lifecycle_status=status,
+                missing="DoC-Ok",
+                path=path,
+                detail=f"quality_doc={doc or 'unassessed'}",
+            )
+        )
+    return items
+
+
+def intake_has_doc_ok(intake: dict) -> bool:
+    """Soft check: hub intake notes/description record DoC-Ok."""
+    chunks: list[str] = []
+    for key in ("description", "routed_note", "title"):
+        v = intake.get(key)
+        if v:
+            chunks.append(str(v))
+    for note in intake.get("notes") or []:
+        if isinstance(note, dict):
+            chunks.append(str(note.get("content") or ""))
+        else:
+            chunks.append(str(note))
+    # structured future field
+    if assessment_from_mapping(intake, "DoC") and is_ok(assessment_from_mapping(intake, "DoC")):
+        return True
+    text = "\n".join(chunks)
+    if re.search(r"\bDoC-Ok\b", text):
+        return True
+    if re.search(r"quality_doc\s*[:=]\s*[\"']?(DoC-Ok|Ok)\b", text, re.I):
+        return True
+    return False
+
+
+def progress_event_body(
+    *,
+    policy: str,
+    outcome: str,
+    record_kind: str,
+    record_id: str,
+    assessed_by: str | None = None,
+    note: str | None = None,
+    topic_id: str | None = None,
+    workplan_id: str | None = None,
+    author: str | None = None,
+) -> dict[str, Any]:
+    """JSON body for POST /progress/ recording a quality assessment."""
+    b = badge(policy, outcome)
+    pol = b.rsplit("-", 1)[0]
+    body: dict[str, Any] = {
+        "event_type": "quality_assessment",
+        "summary": f"{b} for {record_kind} {record_id}",
+        "author": author or assessed_by or "agent",
+        "detail": {
+            "policy": pol,
+            "outcome": "Ok" if b.endswith("-Ok") else "Failed",
+            "badge": b,
+            "record_kind": record_kind,
+            "record_id": record_id,
+            "assessed_by": assessed_by,
+            "note": note,
+        },
+    }
+    if topic_id:
+        body["topic_id"] = topic_id
+    if workplan_id:
+        body["workplan_id"] = workplan_id
+    return body
diff --git a/scripts/quality_debt.py b/scripts/quality_debt.py
new file mode 100644
index 0000000..b25f444
--- /dev/null
+++ b/scripts/quality_debt.py
@@ -0,0 +1,226 @@
+#!/usr/bin/env python3
+"""List DoX quality debt for a repo (STATE-WP-0077-T02).
+
+Scans local workplan frontmatter and intake YAML blocks; optionally lists
+hub intakes (vetted/routed) without DoC-Ok in notes.
+
+Usage:
+  python scripts/quality_debt.py --here
+  python scripts/quality_debt.py --repo-path /path/to/repo
+  statehub quality-debt [--repo-path PATH] [--json] [--api-base URL]
+
+Exit 0 always (report only); use --strict for exit 1 when debt found.
+"""
+from __future__ import annotations
+
+import argparse
+import json
+import os
+import re
+import sys
+import urllib.error
+import urllib.request
+from pathlib import Path
+
+sys.path.insert(0, str(Path(__file__).resolve().parent))
+
+from quality_assessment import (  # noqa: E402
+    QualityDebtItem,
+    debt_for_intake_meta,
+    debt_for_workplan_meta,
+    intake_has_doc_ok,
+)
+
+try:
+    import yaml
+except ImportError:  # pragma: no cover
+    yaml = None  # type: ignore
+
+_SKIP_DIRS = frozenset({".git", "node_modules", ".venv", "history", "agents_backup", "dist"})
+
+
+def _parse_frontmatter(text: str) -> dict:
+    if not text.startswith("---"):
+        return {}
+    parts = text.split("---", 2)
+    if len(parts) < 3:
+        return {}
+    raw = parts[1]
+    if yaml is not None:
+        try:
+            data = yaml.safe_load(raw) or {}
+            return data if isinstance(data, dict) else {}
+        except Exception:
+            pass
+    # minimal fallback: key: value lines
+    meta: dict = {}
+    for line in raw.splitlines():
+        if ":" not in line:
+            continue
+        k, _, v = line.partition(":")
+        meta[k.strip()] = v.strip().strip('"').strip("'")
+    return meta
+
+
+def _scan_workplans(repo_dir: Path) -> list[QualityDebtItem]:
+    items: list[QualityDebtItem] = []
+    wp_dir = repo_dir / "workplans"
+    if not wp_dir.is_dir():
+        return items
+    for path in sorted(wp_dir.rglob("*.md")):
+        if path.name == "README.md":
+            continue
+        if "archived" in path.parts:
+            # still scan finished debt in archived? skip archived for noise
+            continue
+        try:
+            text = path.read_text(encoding="utf-8", errors="replace")
+        except OSError:
+            continue
+        meta = _parse_frontmatter(text)
+        if not meta:
+            continue
+        rel = str(path.relative_to(repo_dir))
+        items.extend(debt_for_workplan_meta(meta, path=rel))
+    return items
+
+
+def _scan_intake_blocks(repo_dir: Path) -> list[QualityDebtItem]:
+    items: list[QualityDebtItem] = []
+    if yaml is None:
+        return items
+    fence = re.compile(r"```ya?ml\n(.*?)```", re.DOTALL | re.IGNORECASE)
+    for path in sorted(repo_dir.rglob("*.md")):
+        if any(p in _SKIP_DIRS for p in path.parts):
+            continue
+        try:
+            text = path.read_text(encoding="utf-8", errors="replace")
+        except OSError:
+            continue
+        rel = str(path.relative_to(repo_dir))
+        for m in fence.finditer(text):
+            block = m.group(1)
+            try:
+                data = yaml.safe_load(block)
+            except Exception:
+                continue
+            if not isinstance(data, dict):
+                continue
+            rid = str(data.get("id", ""))
+            # intake ids: PREFIX-IN-NNNN or grandfathered AWQ-
+            if not re.match(r"^[A-Z]+-IN-\d+", rid) and not re.match(r"^AWQ-\d+", rid):
+                if data.get("kind") != "intake":
+                    continue
+            items.extend(debt_for_intake_meta(data, path=rel))
+    return items
+
+
+def _hub_intake_debt(api_base: str) -> list[QualityDebtItem]:
+    items: list[QualityDebtItem] = []
+    try:
+        req = urllib.request.Request(
+            f"{api_base.rstrip('/')}/intakes/",
+            headers={"Accept": "application/json"},
+        )
+        with urllib.request.urlopen(req, timeout=15) as resp:
+            rows = json.loads(resp.read())
+    except Exception as e:
+        items.append(
+            QualityDebtItem(
+                kind="intake",
+                record_id="(hub)",
+                lifecycle_status="?",
+                missing="DoC-Ok",
+                path="api:/intakes/",
+                detail=f"could not list intakes: {e}",
+            )
+        )
+        return items
+    if not isinstance(rows, list):
+        return items
+    for row in rows:
+        if row.get("status") not in ("vetted", "routed"):
+            continue
+        if intake_has_doc_ok(row):
+            continue
+        items.append(
+            QualityDebtItem(
+                kind="intake",
+                record_id=str(row.get("id", "")),
+                lifecycle_status=str(row.get("status", "")),
+                missing="DoC-Ok",
+                path="api:/intakes/",
+                detail=(row.get("title") or "")[:80],
+            )
+        )
+    return items
+
+
+def collect(
+    repo_dir: Path,
+    *,
+    api_base: str | None = None,
+    include_hub_intakes: bool = True,
+) -> list[QualityDebtItem]:
+    items = _scan_workplans(repo_dir) + _scan_intake_blocks(repo_dir)
+    if include_hub_intakes and api_base:
+        items.extend(_hub_intake_debt(api_base))
+    return items
+
+
+def main() -> None:
+    ap = argparse.ArgumentParser(description=__doc__)
+    ap.add_argument("--here", action="store_true", help="Use cwd as repo")
+    ap.add_argument("--repo-path", default=None, help="Repo root (default: cwd)")
+    ap.add_argument("--api-base", default=os.environ.get("API_BASE", "http://127.0.0.1:8000"))
+    ap.add_argument("--no-hub", action="store_true", help="Skip hub intake list")
+    ap.add_argument("--json", action="store_true", dest="as_json")
+    ap.add_argument("--strict", action="store_true", help="Exit 1 if any debt")
+    args = ap.parse_args()
+
+    repo_dir = Path(args.repo_path or os.getcwd()).expanduser().resolve()
+    items = collect(
+        repo_dir,
+        api_base=None if args.no_hub else args.api_base,
+        include_hub_intakes=not args.no_hub,
+    )
+
+    if args.as_json:
+        print(
+            json.dumps(
+                [
+                    {
+                        "kind": i.kind,
+                        "record_id": i.record_id,
+                        "lifecycle_status": i.lifecycle_status,
+                        "missing": i.missing,
+                        "path": i.path,
+                        "detail": i.detail,
+                    }
+                    for i in items
+                ],
+                indent=2,
+            )
+        )
+    else:
+        print(f"Quality debt — {repo_dir}")
+        print(f"  ({len(items)} item(s); lifecycle may advance without DoX-Ok)\n")
+        if not items:
+            print("  (none)")
+        for i in items:
+            print(
+                f"  [{i.kind}] {i.record_id}  status={i.lifecycle_status}  "
+                f"missing {i.missing}  ({i.path})  {i.detail}"
+            )
+        print(
+            "\nRecord assessments with quality_dor / quality_dod / quality_doc "
+            "fields — see docs/work-record-quality-gates.md"
+        )
+
+    if args.strict and items:
+        sys.exit(1)
+    sys.exit(0)
+
+
+if __name__ == "__main__":
+    main()
diff --git a/scripts/register_from_classification.py b/scripts/register_from_classification.py
index aa99be5..6f684eb 100644
--- a/scripts/register_from_classification.py
+++ b/scripts/register_from_classification.py
@@ -39,6 +39,7 @@ from api.config import settings  # noqa: E402
 from api.database import async_session_factory, engine  # noqa: E402
 from api.models.domain import Domain  # noqa: E402
 from api.models.managed_repo import ManagedRepo  # noqa: E402
+from api.services.repository_identity import stage_initial_repository_identity  # noqa: E402
 
 try:
     import httpx
@@ -136,6 +137,21 @@ def _git_root(path: Path) -> Path:
     return Path(root) if root else path.resolve()
 
 
+def _git_fingerprint(repo_path: Path) -> str | None:
+    """Return the same single-root fingerprint used by token attribution.
+
+    A repository can contain multiple unrelated root commits.  ``git rev-list``
+    emits one SHA per line in that case, while ``managed_repos.git_fingerprint``
+    stores one 40-character SHA.  Token attribution already uses the first root,
+    so registration must use the same projection rather than sending a multiline
+    value to the API/database.
+    """
+    roots = _git_value(repo_path, ["rev-list", "--max-parents=0", "HEAD"])
+    if not roots:
+        return None
+    return roots.splitlines()[0].strip() or None
+
+
 def _resolve_repo_path_for_host(repo: ManagedRepo) -> str | None:
     hostname = socket.gethostname()
     host_paths = repo.host_paths or {}
@@ -226,7 +242,7 @@ async def _upsert_via_db(
 ) -> None:
     git_root = _git_root(repo_path)
     remote_url = _git_value(git_root, ["remote", "get-url", "origin"])
-    git_fingerprint = _git_value(git_root, ["rev-list", "--max-parents=0", "HEAD"])
+    git_fingerprint = _git_fingerprint(git_root)
     hostname = socket.gethostname()
     display_name = git_root.name.replace("-", " ").replace("_", " ").title()
 
@@ -271,6 +287,8 @@ async def _upsert_via_db(
             )
             _apply_classification(repo, data, domain_id)
             session.add(repo)
+            await session.flush()
+            stage_initial_repository_identity(session, repo)
             await session.commit()
             report.add(
                 RowResult(slug, str(git_root), "registered", f"domain={data.domain}")
@@ -345,7 +363,7 @@ async def _upsert_via_api(
 ) -> None:
     git_root = _git_root(repo_path)
     remote_url = _git_value(git_root, ["remote", "get-url", "origin"])
-    git_fingerprint = _git_value(git_root, ["rev-list", "--max-parents=0", "HEAD"])
+    git_fingerprint = _git_fingerprint(git_root)
     hostname = socket.gethostname()
     display_name = git_root.name.replace("-", " ").replace("_", " ").title()
 
@@ -363,7 +381,7 @@ async def _upsert_via_api(
         )
         return
 
-    patch_body = {
+    classification_body = {
         "category": data.category,
         "secondary_domains": data.secondary_domains,
         "capability_tags": data.capability_tags,
@@ -373,9 +391,6 @@ async def _upsert_via_api(
         "classified_by": data.classified_by,
         "standard_version": data.standard_version,
         "domain_slug": data.domain,
-        "local_path": str(git_root),
-        "remote_url": remote_url,
-        "git_fingerprint": git_fingerprint,
     }
 
     if existing is None:
@@ -404,7 +419,7 @@ async def _upsert_via_api(
             report.add(RowResult(slug, str(git_root), "invalid", f"POST failed: {detail}"))
             return
         code, updated = _api_request(
-            "PATCH", f"/repos/{slug}", api_base=api_base, body=patch_body
+            "PATCH", f"/repos/{slug}", api_base=api_base, body=classification_body
         )
         if code != 200:
             detail = updated.get("detail", updated) if isinstance(updated, dict) else updated
@@ -432,7 +447,7 @@ async def _upsert_via_api(
         return
 
     code, updated = _api_request(
-        "PATCH", f"/repos/{slug}", api_base=api_base, body=patch_body
+        "PATCH", f"/repos/{slug}", api_base=api_base, body=classification_body
     )
     if code != 200:
         detail = updated.get("detail", updated) if isinstance(updated, dict) else updated
@@ -632,4 +647,4 @@ def main(argv: list[str] | None = None) -> int:
 
 
 if __name__ == "__main__":
-    raise SystemExit(main())
\ No newline at end of file
+    raise SystemExit(main())
diff --git a/scripts/release_headroom_preflight.py b/scripts/release_headroom_preflight.py
new file mode 100644
index 0000000..d369cc5
--- /dev/null
+++ b/scripts/release_headroom_preflight.py
@@ -0,0 +1,239 @@
+#!/usr/bin/env python3
+"""Read-only scheduling-headroom preflight for State Hub Helm promotion.
+
+STATE-WP-0091-T01. Does not start Helm, does not lower requests, and does not
+claim a scheduling guarantee from an aggregate remaining-millicores sum.
+"""
+from __future__ import annotations
+
+import argparse
+import json
+import subprocess
+import sys
+from datetime import datetime, timezone
+from pathlib import Path
+from typing import Any
+
+
+CPU_FACTORS = {"n": 0.000001, "u": 0.001, "m": 1.0, "": 1000.0}
+BYTE_FACTORS = {
+    "": 1,
+    "Ki": 1024,
+    "Mi": 1024**2,
+    "Gi": 1024**3,
+    "Ti": 1024**4,
+    "K": 1000,
+    "M": 1000**2,
+    "G": 1000**3,
+    "T": 1000**4,
+}
+
+# Historical State Hub API surge (maxSurge=1, maxUnavailable=0).
+DEFAULT_API_SURGE_CPU_M = 100
+DEFAULT_MCP_SURGE_CPU_M = 10
+DEFAULT_MIGRATE_CPU_M = 50
+DEFAULT_API_SURGE_MEMORY = 512 * 1024**2
+DEFAULT_FRESHNESS_SECONDS = 15 * 60
+
+
+def cpu_millicores(value: str | None) -> int:
+    import re
+
+    match = re.fullmatch(r"([0-9]+(?:\.[0-9]+)?)(n|u|m)?", str(value or "0"))
+    if not match:
+        raise ValueError(f"unsupported CPU quantity: {value}")
+    return round(float(match.group(1)) * CPU_FACTORS[match.group(2) or ""])
+
+
+def bytes_value(value: str | None) -> int:
+    import re
+
+    match = re.fullmatch(r"([0-9]+(?:\.[0-9]+)?)(Ki|Mi|Gi|Ti|K|M|G|T)?", str(value or "0"))
+    if not match:
+        raise ValueError(f"unsupported byte quantity: {value}")
+    return round(float(match.group(1)) * BYTE_FACTORS[match.group(2) or ""])
+
+
+def pod_effective_requests(pod: dict[str, Any]) -> tuple[int, int]:
+    """Pod request is max(sum(containers), max(init containers))."""
+    spec = pod.get("spec") or {}
+    containers = spec.get("containers") or []
+    inits = spec.get("initContainers") or []
+    cpu = sum(cpu_millicores((c.get("resources") or {}).get("requests", {}).get("cpu")) for c in containers)
+    mem = sum(bytes_value((c.get("resources") or {}).get("requests", {}).get("memory")) for c in containers)
+    init_cpu = max((cpu_millicores((c.get("resources") or {}).get("requests", {}).get("cpu")) for c in inits), default=0)
+    init_mem = max((bytes_value((c.get("resources") or {}).get("requests", {}).get("memory")) for c in inits), default=0)
+    return max(cpu, init_cpu), max(mem, init_mem)
+
+
+def evaluate(observation: dict[str, Any], release: dict[str, Any] | None = None) -> dict[str, Any]:
+    """Return a preflight report. `ok` is whether Helm may start, not a guarantee."""
+    release = release or {}
+    api_cpu = int(release.get("api_surge_cpu_m", DEFAULT_API_SURGE_CPU_M))
+    mcp_cpu = int(release.get("mcp_surge_cpu_m", DEFAULT_MCP_SURGE_CPU_M))
+    migrate_cpu = int(release.get("migrate_cpu_m", DEFAULT_MIGRATE_CPU_M))
+    api_mem = int(release.get("api_surge_memory_bytes", DEFAULT_API_SURGE_MEMORY))
+    freshness_limit = int(release.get("freshness_seconds", DEFAULT_FRESHNESS_SECONDS))
+    atomic = bool(release.get("atomic", True))
+
+    reasons: list[str] = []
+    notes: list[str] = []
+    nodes = observation.get("nodes") or []
+    if not nodes:
+        reasons.append("no node capacity evidence")
+    remaining_cpu = 0
+    remaining_mem = 0
+    for node in nodes:
+        if node.get("unschedulable") or not node.get("ready", True):
+            reasons.append(f"node {node.get('name')} is not schedulable")
+            continue
+        remaining_cpu += int(node["allocatable_cpu_m"]) - int(node["allocated_cpu_m"])
+        remaining_mem += int(node["allocatable_memory_bytes"]) - int(node["allocated_memory_bytes"])
+
+    pending = observation.get("pending_unrelated") or []
+    pending_cpu = sum(int(p.get("cpu_m", 0)) for p in pending)
+    pending_mem = sum(int(p.get("memory_bytes", 0)) for p in pending)
+
+    observed_at = observation.get("observed_at")
+    freshness_seconds = observation.get("freshness_seconds")
+    if freshness_seconds is None and observed_at:
+        try:
+            stamp = datetime.fromisoformat(str(observed_at).replace("Z", "+00:00"))
+            freshness_seconds = int((datetime.now(timezone.utc) - stamp).total_seconds())
+        except ValueError:
+            freshness_seconds = None
+            reasons.append("observed_at is not parseable")
+    if freshness_seconds is not None and freshness_seconds > freshness_limit:
+        reasons.append(
+            f"capacity evidence is {freshness_seconds}s old (limit {freshness_limit}s)"
+        )
+
+    if remaining_cpu < migrate_cpu:
+        reasons.append(
+            f"migration hook needs {migrate_cpu}m CPU; remaining {remaining_cpu}m"
+        )
+    if remaining_cpu < api_cpu:
+        reasons.append(
+            f"API maxSurge=1 needs {api_cpu}m CPU; remaining {remaining_cpu}m "
+            f"(Insufficient CPU class; revision 61 had 65m remaining)"
+        )
+    if remaining_mem < api_mem:
+        reasons.append(
+            f"API maxSurge=1 needs {api_mem} bytes memory; remaining {remaining_mem}"
+        )
+    concurrent = api_cpu + mcp_cpu
+    if remaining_cpu < concurrent:
+        notes.append(
+            f"API+MCP concurrent surge would need {concurrent}m; remaining {remaining_cpu}m. "
+            "Helm may roll both deployments together; this is not a scheduling guarantee."
+        )
+    effective_cpu = remaining_cpu - pending_cpu
+    effective_mem = remaining_mem - pending_mem
+    if pending and effective_cpu < api_cpu:
+        reasons.append(
+            f"unrelated pending demand {pending_cpu}m leaves {effective_cpu}m "
+            f"against API surge {api_cpu}m"
+        )
+    if pending and effective_mem < api_mem:
+        reasons.append(
+            f"unrelated pending memory {pending_mem} leaves {effective_mem} against API surge"
+        )
+
+    if not atomic:
+        reasons.append("promotion path must keep helm --atomic; preflight will not start a non-atomic upgrade")
+
+    ok = not reasons
+    if ok and remaining_cpu - api_cpu < 50:
+        notes.append(
+            f"remaining {remaining_cpu}m is only {remaining_cpu - api_cpu}m above the "
+            f"{api_cpu}m API surge (revision 63 was 105m). Not factory capacity admission."
+        )
+    notes.append("Aggregate remaining millicores is not a kube-scheduler guarantee.")
+    notes.append("Preflight does not lower requests and does not start Helm.")
+
+    return {
+        "schema": "state-hub.release-headroom-preflight.v1",
+        "ok": ok,
+        "observed_at": observed_at,
+        "freshness_seconds": freshness_seconds,
+        "remaining_cpu_m": remaining_cpu,
+        "remaining_memory_bytes": remaining_mem,
+        "pending_unrelated_cpu_m": pending_cpu,
+        "api_surge_cpu_m": api_cpu,
+        "mcp_surge_cpu_m": mcp_cpu,
+        "migrate_cpu_m": migrate_cpu,
+        "atomic": atomic,
+        "reasons": reasons,
+        "notes": notes,
+        "hook_order": [
+            "pre-upgrade migrate job (helm.sh/hook-weight -5)",
+            "API RollingUpdate maxSurge=1 maxUnavailable=0",
+            "MCP RollingUpdate maxSurge=1 maxUnavailable=0",
+        ],
+    }
+
+
+def collect_live(kubectl: str = "kubectl") -> dict[str, Any]:
+    nodes = json.loads(subprocess.check_output([kubectl, "get", "nodes", "-o", "json"], timeout=60))
+    pods = json.loads(subprocess.check_output([kubectl, "get", "pods", "-A", "-o", "json"], timeout=60))
+    allocated: dict[str, dict[str, int]] = {}
+    pending_unrelated: list[dict[str, Any]] = []
+    now = datetime.now(timezone.utc)
+    for node in nodes.get("items") or []:
+        name = node["metadata"]["name"]
+        alloc = node.get("status", {}).get("allocatable") or {}
+        allocated[name] = {
+            "allocatable_cpu_m": cpu_millicores(alloc.get("cpu")),
+            "allocatable_memory_bytes": bytes_value(alloc.get("memory")),
+            "allocated_cpu_m": 0,
+            "allocated_memory_bytes": 0,
+            "ready": any(
+                c.get("type") == "Ready" and c.get("status") == "True"
+                for c in (node.get("status") or {}).get("conditions") or []
+            ),
+            "unschedulable": bool((node.get("spec") or {}).get("unschedulable")),
+            "name": name,
+        }
+    for pod in pods.get("items") or []:
+        phase = (pod.get("status") or {}).get("phase")
+        ns = pod.get("metadata", {}).get("namespace")
+        name = pod.get("metadata", {}).get("name")
+        cpu, mem = pod_effective_requests(pod)
+        node_name = (pod.get("spec") or {}).get("nodeName")
+        if phase == "Pending" and not node_name:
+            if ns != "state-hub":
+                pending_unrelated.append({"name": f"{ns}/{name}", "cpu_m": cpu, "memory_bytes": mem})
+            continue
+        if phase in {"Succeeded", "Failed"}:
+            continue
+        if node_name in allocated:
+            allocated[node_name]["allocated_cpu_m"] += cpu
+            allocated[node_name]["allocated_memory_bytes"] += mem
+    return {
+        "observed_at": now.isoformat(),
+        "freshness_seconds": 0,
+        "nodes": list(allocated.values()),
+        "pending_unrelated": pending_unrelated,
+        "source": "kubectl",
+    }
+
+
+def main(argv: list[str] | None = None) -> int:
+    parser = argparse.ArgumentParser(description=__doc__)
+    parser.add_argument("--fixture", type=Path, help="JSON observation instead of live kubectl")
+    parser.add_argument("--release", type=Path, help="JSON release surge description")
+    parser.add_argument("--kubectl", default="kubectl")
+    args = parser.parse_args(argv)
+    if args.fixture:
+        observation = json.loads(args.fixture.read_text())
+    else:
+        observation = collect_live(args.kubectl)
+    release = json.loads(args.release.read_text()) if args.release else {}
+    report = evaluate(observation, release)
+    json.dump(report, sys.stdout, indent=2)
+    sys.stdout.write("\n")
+    return 0 if report["ok"] else 1
+
+
+if __name__ == "__main__":
+    raise SystemExit(main())
diff --git a/scripts/sync_classification_allowed.py b/scripts/sync_classification_allowed.py
new file mode 100755
index 0000000..322770f
--- /dev/null
+++ b/scripts/sync_classification_allowed.py
@@ -0,0 +1,91 @@
+#!/usr/bin/env python3
+"""Sync the canon classification allowed-values into the chart (CUST-WP-0067-T09).
+
+The State Hub validates repository classification against
+``the-custodian/canon/standards/repo-classification.allowed.yaml``. That file is
+canon and must stay authoritative, but a container has no the-custodian
+checkout, so a copy has to travel with the release.
+
+A copy that nobody checks is a copy that silently drifts. This script owns the
+copy: ``--check`` fails when it diverges from canon, so the release can refuse
+to ship a stale vocabulary rather than validate against yesterday's rules.
+
+Usage:
+    python scripts/sync_classification_allowed.py            # write the copy
+    python scripts/sync_classification_allowed.py --check    # verify, exit 1 on drift
+"""
+from __future__ import annotations
+
+import argparse
+import difflib
+import sys
+from pathlib import Path
+
+REPO_ROOT = Path(__file__).resolve().parent.parent
+CHART_COPY = (
+    REPO_ROOT
+    / "deploy/railiance/apps/charts/state-hub/files/repo-classification.allowed.yaml"
+)
+CANON_CANDIDATES = (
+    Path("/home/worsch/the-custodian/canon/standards/repo-classification.allowed.yaml"),
+    Path("/home/tegwick/the-custodian/canon/standards/repo-classification.allowed.yaml"),
+    REPO_ROOT.parent / "the-custodian/canon/standards/repo-classification.allowed.yaml",
+)
+
+HEADER = (
+    "# GENERATED — do not edit.\n"
+    "# Synced from the-custodian/canon/standards/repo-classification.allowed.yaml\n"
+    "# by scripts/sync_classification_allowed.py (CUST-WP-0067-T09).\n"
+    "# Canon is authoritative; this copy exists only so the container has one.\n"
+)
+
+
+def find_canon() -> Path:
+    for candidate in CANON_CANDIDATES:
+        if candidate.is_file():
+            return candidate
+    raise SystemExit(
+        "ERROR: canon allowed-values not found. Looked in:\n  "
+        + "\n  ".join(str(c) for c in CANON_CANDIDATES)
+    )
+
+
+def main() -> int:
+    parser = argparse.ArgumentParser(description=__doc__)
+    parser.add_argument(
+        "--check",
+        action="store_true",
+        help="Verify the chart copy matches canon; exit 1 on drift",
+    )
+    args = parser.parse_args()
+
+    canon = find_canon()
+    desired = HEADER + canon.read_text(encoding="utf-8")
+
+    if args.check:
+        if not CHART_COPY.is_file():
+            print(f"DRIFT: {CHART_COPY} is missing; run without --check to create it")
+            return 1
+        current = CHART_COPY.read_text(encoding="utf-8")
+        if current != desired:
+            print(f"DRIFT: chart copy differs from canon ({canon})")
+            sys.stdout.writelines(
+                difflib.unified_diff(
+                    current.splitlines(keepends=True),
+                    desired.splitlines(keepends=True),
+                    fromfile="chart copy",
+                    tofile="canon",
+                )
+            )
+            return 1
+        print(f"OK: chart copy matches canon ({canon})")
+        return 0
+
+    CHART_COPY.parent.mkdir(parents=True, exist_ok=True)
+    CHART_COPY.write_text(desired, encoding="utf-8")
+    print(f"Synced {canon} -> {CHART_COPY}")
+    return 0
+
+
+if __name__ == "__main__":
+    raise SystemExit(main())
diff --git a/scripts/validate_repo_adr.py b/scripts/validate_repo_adr.py
index 8f7bf5c..7f23ad0 100644
--- a/scripts/validate_repo_adr.py
+++ b/scripts/validate_repo_adr.py
@@ -74,8 +74,15 @@ SUPPORTED_WP_STATUSES = set(SUPPORTED_WORKSTREAM_STATUSES)
 VALID_TASK_STATUSES = set(CANONICAL_TASK_STATUSES)
 VALID_TASK_PRIORITIES = {"low", "medium", "high", "critical"}
 
-_WP_ID_RE = re.compile(r"^(?:[A-Z]+-WP-\d+|ADHOC-\d{4}-\d{2}-\d{2})$")
-_TASK_ID_RE = re.compile(r"^(?:[A-Z]+-WP-\d+|ADHOC-\d{4}-\d{2}-\d{2})-T\d+$")
+_PREFIX_RE = r"[A-Z][A-Z0-9]*(?:-[A-Z][A-Z0-9]*)*"
+_WP_ID_RE = re.compile(
+    rf"^(?:{_PREFIX_RE}-WP-\d+|{_PREFIX_RE}-WP-ADHOC-\d{{4}}-\d{{2}}-\d{{2}}"
+    r"|ADHOC-\d{4}-\d{2}-\d{2})$"
+)
+_TASK_ID_RE = re.compile(
+    rf"^(?:{_PREFIX_RE}-WP-\d+|{_PREFIX_RE}-WP-ADHOC-\d{{4}}-\d{{2}}-\d{{2}}"
+    r"|ADHOC-\d{4}-\d{2}-\d{2})-T\d+$"
+)
 _TASK_BLOCK_RE = re.compile(r"```task\s*\n(.*?)\n```", re.DOTALL)
 _ARCHIVED_WP_RE = re.compile(r"^\d{6}-(.+\.md)$")
 
@@ -223,12 +230,18 @@ def _check_workplan_file(wp_file: Path, report: Report) -> dict | None:
     wp_id = str(meta.get("id", ""))
     if not _WP_ID_RE.match(wp_id):
         report.add(Level.FAIL, "frontmatter-id-format",
-                   f"id must match [A-Z]+-WP-\\d+ (e.g. CUST-WP-0001), got {wp_id!r}", fname)
+                   "id must be a numbered or repository-qualified ad-hoc "
+                   f"workplan id, got {wp_id!r}", fname)
     else:
         report.add(Level.PASS, "frontmatter-id-format", f"id={wp_id}", fname)
 
     # filename prefix
-    if wp_id and not canonical_fname.startswith(wp_id):
+    adhoc_filename_id = Path(canonical_fname).stem
+    qualified_adhoc_filename = (
+        adhoc_filename_id.startswith("ADHOC-")
+        and wp_id.endswith(f"-WP-{adhoc_filename_id}")
+    )
+    if wp_id and not canonical_fname.startswith(wp_id) and not qualified_adhoc_filename:
         report.add(Level.WARN, "filename-id-prefix",
                    f"Filename should start with id '{wp_id}', got {fname!r}", fname)
     elif wp_id:
@@ -260,7 +273,7 @@ def _check_workplan_file(wp_file: Path, report: Report) -> dict | None:
             report.add(Level.FAIL, "task-id", "Missing 'id' field", tref)
         elif not _TASK_ID_RE.match(t_id):
             report.add(Level.WARN, "task-id-format",
-                       f"id {t_id!r} doesn't match [A-Z]+-WP-\\d+-T\\d+", tref)
+                       f"id {t_id!r} is not a canonical or grandfathered task id", tref)
 
         t_status = str(task.get("status", ""))
         if not t_status:
diff --git a/scripts/verify_image_pin.py b/scripts/verify_image_pin.py
new file mode 100755
index 0000000..e8860b9
--- /dev/null
+++ b/scripts/verify_image_pin.py
@@ -0,0 +1,65 @@
+#!/usr/bin/env python3
+"""Check that the pinned image tag was actually built (STATE-WP-0084-T02).
+
+A helm upgrade pinned to a tag no registry holds fails as a pre-upgrade hook
+timeout after ~5 minutes, and the message names a timeout rather than a missing
+image. The cause is easy to reach honestly: `.forgejo/workflows/image.yaml` has
+a `paths:` filter, so a chart-only commit is green in CI and builds nothing. A
+green pipeline is not evidence of an image.
+
+Exits non-zero if the pinned tag's commit never ran `build-and-push`.
+"""
+
+from __future__ import annotations
+
+import json
+import re
+import subprocess
+import sys
+import urllib.request
+from pathlib import Path
+
+VALUES = Path(__file__).resolve().parents[1] / "deploy/railiance/apps/helm/state-hub-values.yaml"
+API = "https://forgejo.coulomb.social/api/v1/repos/coulomb/state-hub/actions/tasks?limit=50"
+
+
+def main() -> int:
+    m = re.search(r'^\s*tag:\s*"?main-([0-9a-f]{7,40})"?\s*$', VALUES.read_text(), re.M)
+    if not m:
+        print(f"could not read a main-<sha> tag from {VALUES}")
+        return 2
+    sha = m.group(1)
+
+    try:
+        with urllib.request.urlopen(API, timeout=30) as r:
+            runs = json.load(r).get("workflow_runs", [])
+    except Exception as exc:  # noqa: BLE001 - offline is inconclusive, not a failure
+        print(f"could not reach the forge ({type(exc).__name__}); pin unverified")
+        return 0
+
+    built = {
+        run["head_sha"][:7]
+        for run in runs
+        if run.get("name") == "build-and-push" and run.get("status") == "success"
+    }
+    if sha[:7] in built:
+        print(f"ok: main-{sha} was built by build-and-push")
+        return 0
+
+    print(f"main-{sha} has no successful build-and-push run.")
+    try:
+        changed = subprocess.run(
+            ["git", "show", "--name-only", "--format=", sha],
+            capture_output=True, text=True, cwd=VALUES.parents[3],
+        ).stdout.split()
+        if changed and all(p.startswith("deploy/") or p.endswith(".md") for p in changed):
+            print("It is a chart/docs-only commit, which the paths: filter excludes.")
+    except Exception:  # noqa: BLE001
+        pass
+    recent = [r["head_sha"][:7] for r in runs if r.get("name") == "build-and-push"][:3]
+    print(f"Most recent built commits: {', '.join(recent) or 'none found'}")
+    return 1
+
+
+if __name__ == "__main__":
+    sys.exit(main())
diff --git a/scripts/verify_preflight_signing_runtime.py b/scripts/verify_preflight_signing_runtime.py
new file mode 100644
index 0000000..3b1f607
--- /dev/null
+++ b/scripts/verify_preflight_signing_runtime.py
@@ -0,0 +1,89 @@
+#!/usr/bin/env python3
+"""Non-mutating live signing acceptance. Prints metadata and booleans only."""
+import argparse
+import base64
+import hashlib
+import hmac
+import json
+import os
+from pathlib import Path
+import subprocess
+import sys
+import urllib.request
+
+
+def kube(args, stdin=None):
+    r = subprocess.run(['kubectl', '-n', 'state-hub', *args], input=stdin,
+                       capture_output=True, timeout=60)
+    if r.returncode:
+        raise RuntimeError('kubernetes_check_failed')
+    return r.stdout
+
+
+def main():
+    parser = argparse.ArgumentParser(description=__doc__)
+    parser.add_argument('--save-token', type=Path)
+    parser.add_argument('--predecessor-file', type=Path)
+    args = parser.parse_args()
+    secret = json.loads(kube(['get', 'secret', 'state-hub-rename-preflight', '-o', 'json']))
+    key = base64.b64decode(secret['data']['REPOSITORY_RENAME_PREFLIGHT_SECRET'])
+    pods = json.loads(kube(['get', 'pods', '-l', 'app=state-hub', '-o', 'json']))['items']
+    deployment = json.loads(kube(['get', 'deployment', 'state-hub', '-o', 'json']))
+    replicas = deployment['spec']['replicas']
+    assert replicas > 0 and len(pods) == replicas
+    health = json.load(urllib.request.urlopen('http://127.0.0.1:8000/state/health', timeout=20))
+    assert health['status'] == 'ok' and health['db'] == 'connected'
+    assert health['instance_role'] == 'primary' and health['instance_label'] == 'railiance01'
+    # Fixture is read-only and is the existing consuming migration's source ID.
+    req = urllib.request.Request(
+        'http://127.0.0.1:8000/repos/fda8ad85-a7d7-4055-8f21-902a533e59df/rename/preflight',
+        data=json.dumps({'new_slug': 'access-engine'}).encode(), method='POST',
+        headers={'Content-Type': 'application/json', 'X-StateHub-Component': 'state-hub.signing-acceptance'})
+    with urllib.request.urlopen(req, timeout=60) as response:
+        report = json.load(response)
+    assert report['safe_to_apply'] and report['preflight_token']
+    token = report['preflight_token']
+    encoded, sig = token.split('.')
+    assert hmac.compare_digest(hmac.new(key, encoded.encode(), hashlib.sha256).digest(),
+                               base64.urlsafe_b64decode(sig + '=' * (-len(sig) % 4)))
+    predecessor = args.predecessor_file.read_text().strip() if args.predecessor_file else None
+    results = []
+    for pod in pods:
+        assert not pod['metadata'].get('deletionTimestamp')
+        assert any(c['type'] == 'Ready' and c['status'] == 'True' for c in pod['status']['conditions'])
+        # Only tokens, never the key, travel to the pod; no mutation endpoint runs.
+        payload = json.dumps({'token': token, 'predecessor': predecessor})
+        script = '''import json
+from api.services.repository_rename import _verify_preflight_token, RenamePreconditionFailed
+payload = json.loads(%r)
+_verify_preflight_token(payload['token'])
+if payload['predecessor']:
+    try:
+        _verify_preflight_token(payload['predecessor'])
+    except RenamePreconditionFailed as error:
+        if str(error) != 'Invalid repository rename preflight token':
+            raise RuntimeError('predecessor_rejection_was_not_signature_invalidation')
+    else:
+        raise RuntimeError('predecessor_not_invalidated')
+print('verified')
+''' % payload
+        assert kube(['exec', '-i', pod['metadata']['name'], '-c', 'state-hub', '--', 'python', '-'],
+                    script.encode()).strip() == b'verified'
+        results.append({'pod_uid': pod['metadata']['uid'], 'accepted_key_version': True,
+                        'predecessor_rejected': predecessor is not None})
+    if args.save_token:
+        fd = os.open(args.save_token, os.O_WRONLY | os.O_CREAT | os.O_EXCL, 0o600)
+        with os.fdopen(fd, 'w') as out:
+            out.write(token)
+    print(json.dumps({'schema': 'state-hub.signing-runtime-acceptance.v1',
+                      'health': 'passed', 'signed_preflight': True, 'replicas': replicas,
+                      'secret_resource_version': secret['metadata']['resourceVersion'],
+                      'pods': results, 'repository_mutations': 0}))
+
+
+if __name__ == '__main__':
+    try:
+        main()
+    except Exception:
+        print('{"status":"failed","error":"runtime_acceptance_failed"}')
+        sys.exit(1)
diff --git a/skills/state-hub/SKILL.md b/skills/state-hub/SKILL.md
index a6b3aa7..736cd59 100644
--- a/skills/state-hub/SKILL.md
+++ b/skills/state-hub/SKILL.md
@@ -1,6 +1,6 @@
 ---
 name: state-hub
-description: Use when coordinating with Custodian State Hub: orienting with domain summaries, checking agent inbox messages, updating workplan-backed task status, recording decisions/progress, or batching task status sync through MCP/REST without re-discovering tool schemas.
+description: Coordinate repository-backed work through State Hub REST or optional MCP, including canonical workplan reads, inbox checks, task status sync, and progress logging.
 ---
 
 # State Hub Coordination
@@ -11,16 +11,31 @@ work structure in the hub when a workplan file is the canon.
 
 ## Session Flow
 
-1. Orient with `get_domain_summary(domain_slug)` when working inside one domain
-   repo. Use `get_state_summary()` only for cross-domain/custodian-wide work.
+1. Prefer REST/`statehub` for Codex. Verify `/state/health` identifies the expected
+   primary, then read `/workplans/` with repo/topic filters. MCP is opt-in; use
+   `get_domain_summary(domain_slug)` when enabled.
 2. Check inbox with `get_messages(to_agent=<repo-slug>, unread_only=true)`.
    Mark acted-on messages with `mark_message_read(message_id)`.
-3. During work, edit the workplan file first. Mirror task/workstream status to
-   the hub at checkpoints.
+3. During work, edit the workplan file first. Use `workplan_id` in API payloads
+   and task queries; legacy `workstream_id` is accepted only for compatibility.
 4. Prefer `bulk_update_task_statuses(...)` for checkpoint syncs with multiple
    task updates. Use `update_task_status(...)` for one-off changes.
-5. Close with one concise `add_progress_event(...)`, then run the repo's
-   `make fix-consistency REPO=<repo-slug>` command when workplan files changed.
+5. Close with one concise progress event. After committing workplan file changes,
+   run `uv run --project ~/repo-manager rmgr sync --path . --push`. Reserve
+   `statehub fix-consistency` for a separate deep audit.
+6. If finishing a workplan with leftovers: create **residual** work records
+   first (intake with `origin: residual` + `origin_ref: <WP-id>`, or a child
+   workplan). Residual is a role, not a kind; do not leave backlog only in
+   finished-file prose or `SCOPE.md`. Canon: work-record-types § Residuals.
+
+## Canonical reads and caller attribution
+
+Use `GET /workplans/{id}` and `GET /tasks/?workplan_id=<id>`.
+The `/workstreams/` REST routes return 410 and the `create_workstream` MCP tool
+has been removed. Create repository-owned records in files before syncing.
+For direct HTTP calls, send `X-StateHub-Component: <repo-slug>` so a remaining
+legacy call can be attributed to its caller. Do not replace authoritative
+`state_hub_workstream_id` frontmatter fields; those are a separate file contract.
 
 ## High-Frequency MCP Signatures
 
@@ -29,12 +44,12 @@ get_domain_summary(domain_slug: str) -> str
 get_messages(to_agent?: str, from_agent?: str, unread_only: bool = false, limit: int = 20) -> str
 send_message(from_agent: str, to_agent: str, subject: str, body: str, thread_id?: str) -> str
 
-create_workstream(topic_id: str, title: str, slug?: str, description?: str, owner?: str, due_date?: str, repo_id?: str, planning_priority?: str, planning_order?: int) -> str
-create_task(workstream_id: str, title: str, priority: str = "medium", description?: str, assignee?: str, due_date?: str) -> str
+create_workplan(repo_id: str, title: str, topic_id?: str, slug?: str, description?: str, owner?: str, due_date?: str, planning_priority?: str, planning_order?: int) -> str
+create_task(workplan_id: str, title: str, priority: str = "medium", description?: str, assignee?: str, due_date?: str) -> str
 update_task_status(task_id: str, status: str, blocking_reason?: str, tokens_in?: int, tokens_out?: int, workplan_tokens_in?: int, workplan_tokens_out?: int, note?: str, model?: str, agent?: str, session_id?: str) -> str
 bulk_update_task_statuses(updates: list[dict], author?: str = "custodian", session_id?: str) -> str
-add_progress_event(summary: str, event_type: str = "note", topic_id?: str, workstream_id?: str, task_id?: str, detail?: dict | str) -> str
-record_decision(title: str, decision_type: str = "pending", topic_id?: str, workstream_id?: str, description?: str, rationale?: str, decided_by?: str, deadline?: str) -> str
+add_progress_event(summary: str, event_type: str = "note", topic_id?: str, workplan_id?: str, task_id?: str, detail?: dict | str) -> str
+record_decision(title: str, decision_type: str = "pending", topic_id?: str, workplan_id?: str, description?: str, rationale?: str, decided_by?: str, deadline?: str) -> str
 ```
 
 `bulk_update_task_statuses` updates `N` task statuses in one call:
diff --git a/skills/state-hub/references/tool-signatures.md b/skills/state-hub/references/tool-signatures.md
index 18decfa..562b954 100644
--- a/skills/state-hub/references/tool-signatures.md
+++ b/skills/state-hub/references/tool-signatures.md
@@ -10,8 +10,8 @@ MCP: get_domain_summary(domain_slug)
 REST: GET /state/summary then filter by topic/domain when MCP is unavailable
 ```
 
-Use `get_domain_summary("custodian")` inside State Hub work. It returns the
-domain topic, active workstreams, blocking decisions, recent progress, repos,
+Use `get_domain_summary("infotech")` inside State Hub work. It returns the
+domain topic, active workplans, blocking decisions, recent progress, repos,
 and compact capability hints.
 
 ## Agent Messages
@@ -30,19 +30,25 @@ REST: PATCH /messages/{message_id}/read
 Use repo slugs as agent names. Use `broadcast` only for genuinely shared
 coordination.
 
-## Workstreams and Tasks
+## Workplans and Tasks
 
 ```text
-MCP: create_workstream(topic_id, title, slug?, description?, owner?, due_date?, repo_id?, planning_priority?, planning_order?)
-REST: POST /workstreams/
+MCP: create_workplan(repo_id, title, topic_id?, slug?, description?, owner?, due_date?, planning_priority?, planning_order?)
+REST: POST /workplans/
 
-MCP: create_task(workstream_id, title, priority="medium", description?, assignee?, due_date?)
+MCP: create_task(workplan_id, title, priority="medium", description?, assignee?, due_date?)
 REST: POST /tasks/
 
 MCP: update_task_status(task_id, status, blocking_reason?, tokens_in?, tokens_out?, workplan_tokens_in?, workplan_tokens_out?, note?, model?, agent?, session_id?)
 REST: PATCH /tasks/{task_id}
 ```
 
+For repository-owned work, write the workplan/task files and sync with Repo
+Manager; the create signatures above describe the projection API. Read using
+`GET /workplans/{id}` and `GET /tasks/?workplan_id=<id>`. Send
+`X-StateHub-Component: <repo-slug>` on direct HTTP requests for caller attribution.
+The removed workstream tools and `/workstreams/` routes are not fallbacks.
+
 Canonical task statuses are `wait`, `todo`, `progress`, `done`, and `cancel`.
 Legacy aliases are accepted during migration, but do not emit new workplan files
 with old vocabulary.
@@ -86,10 +92,10 @@ The endpoint rejects duplicate task ids with `400` and missing task ids with
 ## Progress and Decisions
 
 ```text
-MCP: add_progress_event(summary, event_type="note", topic_id?, workstream_id?, task_id?, detail?)
+MCP: add_progress_event(summary, event_type="note", topic_id?, workplan_id?, task_id?, detail?)
 REST: POST /progress/
 
-MCP: record_decision(title, decision_type="pending", topic_id?, workstream_id?, description?, rationale?, decided_by?, deadline?)
+MCP: record_decision(title, decision_type="pending", topic_id?, workplan_id?, description?, rationale?, decided_by?, deadline?)
 REST: POST /decisions/
 ```
 
diff --git a/statehub_register.py b/statehub_register.py
index 76778f4..ecc3e79 100644
--- a/statehub_register.py
+++ b/statehub_register.py
@@ -15,11 +15,18 @@ from datetime import date
 from pathlib import Path
 from typing import Any
 
+import yaml
+
 
 STATE_HUB_DIR = Path(__file__).resolve().parent
 API_BASE = os.environ.get("API_BASE", "http://127.0.0.1:8000")
 RULES_TEMPLATES_DIR = STATE_HUB_DIR / "scripts" / "project_rules"
 
+from api.classification import (  # noqa: E402
+    CLASSIFICATION_FILENAME,
+    extract_classification_block,
+    load_classification_document,
+)
 from scripts.ensure_gitignore_claude_rules import ensure_claude_gitignore  # noqa: E402
 
 KEY_CONTEXT_FILES = [
@@ -60,12 +67,159 @@ class RegisterInference:
     current_state: str | None = None
 
 
+_FRONTMATTER_RE = re.compile(r"\A---\s*\n(.*?)\n---", re.DOTALL)
+
+
+def detect_project_flavor_signal(
+    project_path: Path,
+    repo_slug: str | None = None,
+) -> str | None:
+    """Return the first project-flavor signal, or None for durable repos.
+
+    Precedence matches repo-manager: classification category, GOAL.md
+    ``repo_flavor``, then a ``prj-`` slug prefix. Any match is enough to
+    refuse scaffolding here (STATE-WP-0080-T01).
+    """
+    category = _classification_category(project_path)
+    if category == "project":
+        return f"{CLASSIFICATION_FILENAME} category=project"
+
+    goal_flavor = _goal_repo_flavor(project_path)
+    if goal_flavor == "project":
+        return "GOAL.md repo_flavor=project"
+
+    for candidate in (repo_slug, project_path.name):
+        if not candidate:
+            continue
+        slug = _slugify(candidate)
+        if slug.startswith("prj-"):
+            return f"slug prefix prj- ({slug})"
+    return None
+
+
+def refuse_project_flavor_scaffold(
+    project_path: Path,
+    repo_slug: str | None = None,
+) -> None:
+    """Exit before writing INTENT.md / PRJ-WP- files into a project repo."""
+    signal = detect_project_flavor_signal(project_path, repo_slug)
+    if signal is None:
+        return
+    raise SystemExit(_project_scaffold_refusal_message(project_path, signal))
+
+
+def project_already_scaffolded(project_path: Path) -> bool:
+    """True when the project purpose document already exists."""
+    return (project_path / "GOAL.md").is_file()
+
+
+def project_registration_plan(
+    project_path: Path,
+    repo_slug: str | None = None,
+    wp_prefix: str | None = None,
+) -> tuple[str, str | None]:
+    """Decide how ``statehub register`` treats a checkout.
+
+    Returns one of:
+    - ``("durable", None)`` — existing hub templating for non-project repos
+    - ``("refuse", signal)`` — project flavor, not yet scaffolded, no prefix
+    - ``("delegate", prefix)`` — call ``rmgr scaffold``, then register only
+    - ``("register-only", None)`` — files already exist; hub records the repo
+    """
+    signal = detect_project_flavor_signal(project_path, repo_slug)
+    if signal is None:
+        return "durable", None
+    if project_already_scaffolded(project_path):
+        return "register-only", None
+    prefix = (wp_prefix or "").strip()
+    if not prefix:
+        return "refuse", signal
+    return "delegate", prefix
+
+
+def _project_scaffold_refusal_message(project_path: Path, signal: str) -> str:
+    return (
+        "ERROR: statehub register refuses to scaffold a project-flavor repository.\n"
+        f"  Detected via: {signal}\n"
+        "  Durable-repo registration is unchanged. Scaffold project repos with Repo Manager:\n"
+        f"    rmgr scaffold --path {project_path} --flavor project --wp-prefix <PREFIX>-WP\n"
+        "  Then re-run ``statehub register`` (or pass --wp-prefix now to delegate).\n"
+        "  Choose --wp-prefix from the project identity, never PRJ-WP-."
+    )
+
+
+def delegate_project_scaffold(
+    project_path: Path,
+    *,
+    slug: str,
+    wp_prefix: str,
+    domain: str = "infotech",
+    force: bool = False,
+) -> dict[str, Any]:
+    """Call ``rmgr scaffold`` via the dual-run adapter (STATE-WP-0080-T02)."""
+    from api.services.repo_manager_dual_run import record_mutation, rm_scaffold
+
+    result = rm_scaffold(
+        repo_path=project_path,
+        flavor="project",
+        wp_prefix=wp_prefix,
+        slug=slug,
+        domain=domain,
+        force=force,
+        commit=False,
+    )
+    record_mutation(
+        source="state-hub-register",
+        kind="project_scaffold_delegated",
+        repo_slug=slug,
+        detail={
+            "status": result.get("status"),
+            "wp_prefix": wp_prefix,
+            "exit_code": result.get("exit_code"),
+        },
+    )
+    return result
+
+
+def _classification_category(project_path: Path) -> str | None:
+    doc = load_classification_document(project_path / CLASSIFICATION_FILENAME)
+    block = extract_classification_block(doc)
+    if not block:
+        return None
+    raw = block.get("category")
+    return str(raw).strip().lower() if raw else None
+
+
+def _goal_repo_flavor(project_path: Path) -> str | None:
+    path = project_path / "GOAL.md"
+    if not path.is_file():
+        return None
+    match = _FRONTMATTER_RE.match(_read_limited(path, 4000))
+    if not match:
+        return None
+    try:
+        frontmatter = yaml.safe_load(match.group(1)) or {}
+    except yaml.YAMLError:
+        return None
+    if not isinstance(frontmatter, dict):
+        return None
+    raw = frontmatter.get("repo_flavor")
+    return str(raw).strip().lower() if raw else None
+
+
 def run_register(args: argparse.Namespace) -> None:
     project_path = Path(args.path).expanduser().resolve()
     if not project_path.is_dir():
         print(f"ERROR: {project_path} is not a directory.")
         sys.exit(1)
 
+    explicit_prefix = getattr(args, "wp_prefix", None)
+    plan, _ = project_registration_plan(
+        project_path, getattr(args, "repo_slug", None), explicit_prefix
+    )
+    if plan == "refuse":
+        refuse_project_flavor_scaffold(project_path, getattr(args, "repo_slug", None))
+
     snapshot = collect_repo_snapshot(project_path)
     print(f"==> Inspecting repo at {snapshot.path}")
 
@@ -75,7 +229,16 @@ def run_register(args: argparse.Namespace) -> None:
 
     inference = infer_registration(snapshot, args, domain_slugs)
     repo_slug = args.repo_slug or inference.repo_slug or _slugify(snapshot.project_name)
-    wp_prefix = args.wp_prefix or inference.workplan_prefix or _default_wp_prefix(repo_slug)
+    plan, delegated_prefix = project_registration_plan(
+        project_path, repo_slug, explicit_prefix
+    )
+    if plan == "refuse":
+        refuse_project_flavor_scaffold(project_path, repo_slug)
+    wp_prefix = (
+        explicit_prefix
+        or inference.workplan_prefix
+        or _default_wp_prefix(repo_slug)
+    )
     domain = args.domain or inference.domain_slug or _detect_domain_from_files(snapshot)
     project_description = (
         args.description
@@ -87,29 +250,57 @@ def run_register(args: argparse.Namespace) -> None:
     if domain not in domain_slugs:
         domain = _ask_for_domain(domain, domain_slugs)
 
-    intent_markdown = _resolve_intent_markdown(snapshot, inference, args, project_description)
-    topic = _find_or_create_topic(domain, snapshot.project_name, repo_slug, inference, args.api_base)
+    topic = _find_or_create_topic(
+        domain,
+        snapshot.project_name,
+        repo_slug,
+        inference,
+        args.api_base,
+        requested_topic_slug=getattr(args, "topic", None),
+    )
     topic_id = topic["id"]
     topic_slug = topic.get("slug") or domain
 
-    print(f"==> Writing State Hub agent files for '{repo_slug}'")
-    written = write_registration_files(
-        project_path=project_path,
-        project_name=snapshot.project_name,
-        project_description=project_description,
-        domain=domain,
-        topic_id=topic_id,
-        topic_slug=topic_slug,
-        repo_slug=repo_slug,
-        wp_prefix=wp_prefix,
-        intent_markdown=intent_markdown,
-        inference=inference,
-        force=args.force,
-    )
-    for path in written:
-        print(f"    wrote {path}")
-    if not written:
-        print("    files already present; nothing overwritten")
+    skip_hub_templating = plan in {"delegate", "register-only"}
+    if plan == "delegate":
+        print(f"==> Delegating project scaffold to rmgr (prefix {delegated_prefix})")
+        result = delegate_project_scaffold(
+            project_path,
+            slug=repo_slug,
+            wp_prefix=delegated_prefix or wp_prefix,
+            domain=domain,
+            force=bool(getattr(args, "force", False)),
+        )
+        status = result.get("status")
+        if status != "applied" and not project_already_scaffolded(project_path):
+            err = (result.get("error") or {}).get("message") or result
+            raise SystemExit(f"ERROR: rmgr scaffold failed: {err}")
+        print(f"    rmgr scaffold status={status}")
+    elif plan == "register-only":
+        print("==> Project files already present; skipping hub templating")
+
+    if not skip_hub_templating:
+        intent_markdown = _resolve_intent_markdown(
+            snapshot, inference, args, project_description
+        )
+        print(f"==> Writing State Hub agent files for '{repo_slug}'")
+        written = write_registration_files(
+            project_path=project_path,
+            project_name=snapshot.project_name,
+            project_description=project_description,
+            domain=domain,
+            topic_id=topic_id,
+            topic_slug=topic_slug,
+            repo_slug=repo_slug,
+            wp_prefix=wp_prefix,
+            intent_markdown=intent_markdown,
+            inference=inference,
+            force=args.force,
+        )
+        for path in written:
+            print(f"    wrote {path}")
+        if not written:
+            print("    files already present; nothing overwritten")
 
     repo = _register_or_update_repo(
         domain=domain,
@@ -548,6 +739,8 @@ title: "Bootstrap State Hub integration"
 domain: {domain}
 repo: {repo_slug}
 status: ready
+flavor: planning
+depends_on: []
 owner: codex
 topic_slug: {topic_slug}
 created: "{today}"
@@ -647,11 +840,54 @@ def _find_or_create_topic(
     repo_slug: str,
     inference: RegisterInference,
     api_base: str,
+    *,
+    requested_topic_slug: str | None = None,
 ) -> dict[str, Any]:
     topics = _api_get("/topics/?status=active", api_base)
-    existing = next((t for t in topics if t.get("domain_slug") == domain), None)
-    if existing:
-        return existing
+    domain_topics = [topic for topic in topics if topic.get("domain_slug") == domain]
+
+    explicit_slug = _slugify(requested_topic_slug or "") or None
+    inferred_slug = inference.topic_slug
+    preferred_slug = explicit_slug or inferred_slug
+    if preferred_slug:
+        existing = next(
+            (topic for topic in domain_topics if topic.get("slug") == preferred_slug),
+            None,
+        )
+        if existing:
+            return existing
+
+    if explicit_slug:
+        cross_domain = [
+            str(topic.get("domain_slug"))
+            for topic in topics
+            if topic.get("slug") == explicit_slug and topic.get("domain_slug") != domain
+        ]
+        if cross_domain:
+            domains = ", ".join(sorted(set(cross_domain)))
+            raise SystemExit(
+                f"ERROR: Topic '{explicit_slug}' belongs to domain(s) {domains}, "
+                f"not '{domain}'."
+            )
+        available = ", ".join(
+            sorted(str(topic.get("slug")) for topic in domain_topics if topic.get("slug"))
+        ) or "(none)"
+        raise SystemExit(
+            f"ERROR: Active topic '{explicit_slug}' was not found in domain '{domain}'. "
+            f"Available: {available}"
+        )
+
+    if len(domain_topics) == 1:
+        return domain_topics[0]
+    if len(domain_topics) > 1:
+        available = ", ".join(
+            sorted(str(topic.get("slug")) for topic in domain_topics if topic.get("slug"))
+        )
+        raise SystemExit(
+            f"ERROR: Domain '{domain}' has multiple active topics: {available}. "
+            "Pass --topic <slug>."
+        )
+
     slug = inference.topic_slug or repo_slug
     title = inference.topic_title or project_name
     print(f"==> Creating active topic '{slug}' for domain '{domain}'")
diff --git a/tests/fixtures/release_headroom/rev61-65m.json b/tests/fixtures/release_headroom/rev61-65m.json
new file mode 100644
index 0000000..6d0f237
--- /dev/null
+++ b/tests/fixtures/release_headroom/rev61-65m.json
@@ -0,0 +1,16 @@
+{
+  "observed_at": "2026-09-10T12:00:00+00:00",
+  "freshness_seconds": 0,
+  "nodes": [
+    {
+      "name": "railiance01",
+      "ready": true,
+      "unschedulable": false,
+      "allocatable_cpu_m": 4000,
+      "allocatable_memory_bytes": 16000000000,
+      "allocated_cpu_m": 3935,
+      "allocated_memory_bytes": 8000000000
+    }
+  ],
+  "pending_unrelated": []
+}
diff --git a/tests/fixtures/release_headroom/rev63-105m-concurrent-pending.json b/tests/fixtures/release_headroom/rev63-105m-concurrent-pending.json
new file mode 100644
index 0000000..39860f0
--- /dev/null
+++ b/tests/fixtures/release_headroom/rev63-105m-concurrent-pending.json
@@ -0,0 +1,22 @@
+{
+  "observed_at": "2026-09-10T13:05:00+00:00",
+  "freshness_seconds": 0,
+  "nodes": [
+    {
+      "name": "railiance01",
+      "ready": true,
+      "unschedulable": false,
+      "allocatable_cpu_m": 4000,
+      "allocatable_memory_bytes": 16000000000,
+      "allocated_cpu_m": 3895,
+      "allocated_memory_bytes": 8000000000
+    }
+  ],
+  "pending_unrelated": [
+    {
+      "name": "other/unrelated-worker",
+      "cpu_m": 50,
+      "memory_bytes": 0
+    }
+  ]
+}
diff --git a/tests/fixtures/release_headroom/rev63-105m.json b/tests/fixtures/release_headroom/rev63-105m.json
new file mode 100644
index 0000000..685e083
--- /dev/null
+++ b/tests/fixtures/release_headroom/rev63-105m.json
@@ -0,0 +1,16 @@
+{
+  "observed_at": "2026-09-10T13:00:00+00:00",
+  "freshness_seconds": 0,
+  "nodes": [
+    {
+      "name": "railiance01",
+      "ready": true,
+      "unschedulable": false,
+      "allocatable_cpu_m": 4000,
+      "allocatable_memory_bytes": 16000000000,
+      "allocated_cpu_m": 3895,
+      "allocated_memory_bytes": 8000000000
+    }
+  ],
+  "pending_unrelated": []
+}
diff --git a/tests/test_codex_mcp_launcher.py b/tests/test_codex_mcp_launcher.py
new file mode 100644
index 0000000..2d404b7
--- /dev/null
+++ b/tests/test_codex_mcp_launcher.py
@@ -0,0 +1,40 @@
+import os
+import subprocess
+from pathlib import Path
+
+
+ROOT = Path(__file__).resolve().parents[1]
+LAUNCHER = ROOT / "scripts" / "codex-state-hub-mcp.sh"
+
+
+def test_codex_mcp_launcher_uses_configured_python(tmp_path: Path) -> None:
+    fake_python = tmp_path / "python"
+    fake_python.write_text(
+        "#!/usr/bin/env bash\n"
+        "printf 'python=%s\\nscript=%s\\ntransport=%s\\n' "
+        '"$0" "$1" "$MCP_TRANSPORT"\n'
+    )
+    fake_python.chmod(0o755)
+    env = os.environ.copy()
+    env["STATE_HUB_PYTHON"] = str(fake_python)
+    env["API_BASE"] = "http://127.0.0.1:8000"
+
+    result = subprocess.run(
+        [str(LAUNCHER)],
+        cwd=ROOT,
+        env=env,
+        text=True,
+        capture_output=True,
+        check=True,
+        timeout=5,
+    )
+
+    assert f"python={fake_python}" in result.stdout
+    assert "script=mcp_server/codex_server.py" in result.stdout
+    assert "transport=stdio" in result.stdout
+
+
+def test_codex_mcp_launcher_has_no_uv_runtime_dependency() -> None:
+    launcher = LAUNCHER.read_text()
+    assert "uv run" not in launcher
+    assert ".venv/bin/python" in launcher
diff --git a/tests/test_codex_mcp_server.py b/tests/test_codex_mcp_server.py
new file mode 100644
index 0000000..5c41efb
--- /dev/null
+++ b/tests/test_codex_mcp_server.py
@@ -0,0 +1,19 @@
+import asyncio
+
+from mcp_server import codex_server
+
+
+def test_codex_server_has_only_repository_coordination_tools() -> None:
+    tools = asyncio.run(codex_server.mcp.list_tools())
+    assert {tool.name for tool in tools} == {
+        "get_domain_summary",
+        "get_messages",
+        "mark_message_read",
+        "add_progress_event",
+        "record_decision",
+        "update_task_status",
+    }
+
+
+def test_codex_server_uses_distinct_server_identity() -> None:
+    assert codex_server.mcp.name == "dev-hub-codex"
diff --git a/tests/test_configure_codex.py b/tests/test_configure_codex.py
new file mode 100644
index 0000000..945fd40
--- /dev/null
+++ b/tests/test_configure_codex.py
@@ -0,0 +1,92 @@
+import os
+import subprocess
+import tomllib
+from pathlib import Path
+
+
+ROOT = Path(__file__).resolve().parents[1]
+SCRIPT = ROOT / "scripts" / "configure-codex.sh"
+
+
+def run_configure(codex_home: Path, *args: str) -> subprocess.CompletedProcess[str]:
+    env = os.environ.copy()
+    env["CODEX_HOME"] = str(codex_home)
+    return subprocess.run(
+        [str(SCRIPT), *args],
+        cwd=ROOT,
+        env=env,
+        text=True,
+        capture_output=True,
+        check=True,
+    )
+
+
+def test_configure_codex_creates_network_setting(tmp_path: Path) -> None:
+    codex_home = tmp_path / ".codex"
+
+    run_configure(codex_home, "--skip-verify", "--skip-mcp")
+
+    config = tomllib.loads((codex_home / "config.toml").read_text())
+    assert config["sandbox_workspace_write"]["network_access"] is True
+
+
+def test_configure_codex_preserves_existing_settings_and_is_idempotent(
+    tmp_path: Path,
+) -> None:
+    codex_home = tmp_path / ".codex"
+    codex_home.mkdir()
+    config_path = codex_home / "config.toml"
+    config_path.write_text(
+        'model = "gpt-test"\n\n'
+        "[sandbox_workspace_write]\n"
+        "network_access = false\n"
+        'writable_roots = ["/tmp/example"]\n'
+    )
+
+    run_configure(codex_home, "--skip-verify", "--skip-mcp")
+    first = config_path.read_text()
+    run_configure(codex_home, "--skip-verify", "--skip-mcp")
+
+    assert config_path.read_text() == first
+    config = tomllib.loads(first)
+    assert config["model"] == "gpt-test"
+    assert config["sandbox_workspace_write"] == {
+        "network_access": True,
+        "writable_roots": ["/tmp/example"],
+    }
+
+
+def test_configure_codex_dry_run_does_not_write(tmp_path: Path) -> None:
+    codex_home = tmp_path / ".codex"
+
+    result = run_configure(codex_home, "--dry-run", "--skip-mcp")
+
+    assert "DRY-RUN" in result.stdout
+    assert not (codex_home / "config.toml").exists()
+
+
+def test_configure_codex_removes_dev_hub_registration_by_default(
+    tmp_path: Path,
+) -> None:
+    codex_home = tmp_path / ".codex"
+    codex_home.mkdir()
+    config_path = codex_home / "config.toml"
+    config_path.write_text(
+        '[mcp_servers.dev-hub]\ncommand = "/tmp/dev-hub"\n'
+    )
+
+    result = run_configure(codex_home, "--skip-verify")
+
+    assert "removed Codex MCP server dev-hub" in result.stdout
+    config = tomllib.loads(config_path.read_text())
+    assert "dev-hub" not in config.get("mcp_servers", {})
+
+
+def test_configure_codex_mcp_is_explicit_opt_in(tmp_path: Path) -> None:
+    codex_home = tmp_path / ".codex"
+
+    run_configure(codex_home, "--skip-verify", "--with-mcp")
+
+    config = tomllib.loads((codex_home / "config.toml").read_text())
+    command = config["mcp_servers"]["dev-hub"]["command"]
+    assert command.endswith("/scripts/codex-state-hub-mcp.sh")
diff --git a/tests/test_consistency_check.py b/tests/test_consistency_check.py
index 6a8cccd..7eeb439 100644
--- a/tests/test_consistency_check.py
+++ b/tests/test_consistency_check.py
@@ -12,6 +12,7 @@ No network calls, no DB, no live API — these tests run fully offline.
 """
 from __future__ import annotations
 
+import json
 import os
 import shutil
 import subprocess
@@ -33,11 +34,14 @@ from consistency_check import (
     _BACKGROUND_CHECKS,
     _api_get,
     _check_scope_freshness,
+    _check_repo_manager_conformance,
     _detect_behind_remote,
+    _derived_work_record_uuid,
     _git_pull,
     _patch_frontmatter_field,
     _patch_task_status_in_file,
     _report_needs_action,
+    _write_custodian_brief,
     archive_closed_workplans,
     canonical_workplan_filename,
     check_repo,
@@ -69,6 +73,99 @@ class TestResolveTopicDomainSlug:
         assert resolve_topic_domain_slug("custodian", repo_market_domain="infotech") == "infotech"
 
 
+class TestCustodianBriefDomain:
+    @staticmethod
+    def _install_common_mocks(monkeypatch, calls, repo_payload, topic_payload=None):
+        def fake_get(_api_base, path, params=None):
+            calls.append((path, params))
+            if path == "/repos/demo":
+                return repo_payload
+            if path == "/workplans":
+                return [{"id": "wp-1", "title": "Open", "topic_id": None}]
+            if path == "/tasks":
+                return []
+            if path == "/repo-goals":
+                return []
+            if path.startswith("/topics/"):
+                return topic_payload
+            if path == "/messages":
+                return []
+            return None
+
+        monkeypatch.setattr("consistency_check._api_get", fake_get)
+        monkeypatch.setattr(
+            "consistency_check._git_commit_writeback", lambda *args, **kwargs: True
+        )
+
+    def test_brief_prefers_repository_domain_when_workplan_topic_is_null(
+        self, tmp_path, monkeypatch
+    ):
+        calls = []
+        self._install_common_mocks(
+            monkeypatch,
+            calls,
+            {"id": "repo-1", "domain_slug": "infotech"},
+        )
+
+        assert _write_custodian_brief("http://unused", "demo", str(tmp_path)) is True
+        brief = (tmp_path / ".custodian-brief.md").read_text(encoding="utf-8")
+        assert "**Domain:** infotech" in brief
+        assert '`get_domain_summary("infotech")`' in brief
+        assert not any(path.startswith("/topics/") for path, _params in calls)
+
+    def test_brief_retains_topic_fallback_for_legacy_repo_response(
+        self, tmp_path, monkeypatch
+    ):
+        calls = []
+        self._install_common_mocks(
+            monkeypatch,
+            calls,
+            {"id": "repo-1"},
+            {"domain_slug": "financials"},
+        )
+
+        assert _write_custodian_brief("http://unused", "demo", str(tmp_path)) is True
+        brief = (tmp_path / ".custodian-brief.md").read_text(encoding="utf-8")
+        assert "**Domain:** financials" in brief
+        assert any(path.startswith("/topics/") for path, _params in calls)
+
+
+class TestRepoManagerConformanceAdapter:
+    def test_surfaces_repo_manager_findings_without_reimplementing_rules(self, tmp_path, monkeypatch):
+        rmgr = tmp_path / "rmgr"
+        rmgr.write_text("stub", encoding="utf-8")
+        monkeypatch.setenv("RMGR_BIN", str(rmgr))
+        payload = {
+            "ok": False,
+            "findings": [
+                {
+                    "code": "intent-and-goal",
+                    "severity": "contradictory",
+                    "path": "INTENT.md",
+                    "message": "project flavor forbids both purpose files",
+                }
+            ],
+        }
+        monkeypatch.setattr(
+            "consistency_check.subprocess.run",
+            lambda *args, **kwargs: subprocess.CompletedProcess(args[0], 1, json.dumps(payload), ""),
+        )
+        report = ConsistencyReport(repo_slug="demo", repo_path=str(tmp_path))
+        _check_repo_manager_conformance(tmp_path, report)
+        assert len(report.warnings) == 1
+        assert report.warnings[0].check_id == "C-35"
+        assert "project flavor forbids" in report.warnings[0].message
+
+    def test_missing_adapter_is_informational(self, tmp_path, monkeypatch):
+        monkeypatch.setenv("RMGR_BIN", str(tmp_path / "missing"))
+        monkeypatch.setattr("consistency_check.shutil.which", lambda _name: None)
+        monkeypatch.setattr(Path, "home", classmethod(lambda cls: tmp_path))
+        report = ConsistencyReport(repo_slug="demo", repo_path=str(tmp_path))
+        _check_repo_manager_conformance(tmp_path, report)
+        assert len(report.infos) == 1
+        assert report.infos[0].check_id == "C-35"
+
+
 # ---------------------------------------------------------------------------
 # parse_frontmatter
 # ---------------------------------------------------------------------------
@@ -993,10 +1090,10 @@ class TestLifecycleRenormalization:
         assert "C-23" in check_ids
         assert "C-04" not in check_ids
         issue = next(issue for issue in report.issues if issue.check_id == "C-23")
-        assert issue.fixable is True
+        assert issue.fixable is False
         assert issue.file_value == "proposed"
 
-    def test_fix_repo_repairs_planning_workplan_with_active_task(self, tmp_path, monkeypatch):
+    def test_fix_repo_does_not_promote_proposed(self, tmp_path, monkeypatch):
         repo = self._make_repo(tmp_path)
         wp = repo / "workplans" / "STATE-WP-0001-demo.md"
         patches = []
@@ -1015,6 +1112,29 @@ class TestLifecycleRenormalization:
 
         report = fix_repo("http://unused", "state-hub")
 
+        assert ("/workplans/ws-1", {"status": "active"}) not in patches
+        assert "status: proposed" in wp.read_text(encoding="utf-8")
+        assert not any("C-23 fixed" in fix for fix in report.fixes_applied)
+
+    def test_fix_repo_repairs_planning_workplan_with_active_task(self, tmp_path, monkeypatch):
+        repo = self._make_repo(tmp_path, status="ready")
+        wp = repo / "workplans" / "STATE-WP-0001-demo.md"
+        patches = []
+
+        def fake_patch(_api_base, path, body):
+            patches.append((path, body))
+            return {"ok": True}
+
+        monkeypatch.setattr("consistency_check._api_get", self._api_get_for_repo(repo))
+        monkeypatch.setattr("consistency_check._api_patch", fake_patch)
+        monkeypatch.setattr("consistency_check._detect_behind_remote", lambda _repo_path: False)
+        monkeypatch.setattr("consistency_check._detect_ahead_of_remote", lambda _repo_path: 0)
+        monkeypatch.setattr("consistency_check._git_commit_writeback", lambda *args, **kwargs: True)
+        monkeypatch.setattr("consistency_check._write_custodian_brief", lambda *args, **kwargs: False)
+        monkeypatch.setattr("consistency_check._git_push", lambda _repo_path: (True, "pushed"))
+
+        report = fix_repo("http://unused", "state-hub")
+
         assert ("/workplans/ws-1", {"status": "active"}) in patches
         assert "status: active" in wp.read_text(encoding="utf-8")
         assert any("C-23 fixed" in fix for fix in report.fixes_applied)
@@ -1208,8 +1328,353 @@ class TestC20DependencyDetection:
 
         assert "C-20" not in [issue.check_id for issue in report.issues]
 
+    def test_depends_on_alias_satisfies_workplan_dependency(self, tmp_path, monkeypatch):
+        repo = tmp_path / "repo"
+        workplans = repo / "workplans"
+        workplans.mkdir(parents=True)
+        (workplans / "STATE-WP-0001-base.md").write_text(
+            "---\n"
+            "id: STATE-WP-0001\n"
+            "title: Base\n"
+            "domain: financials\n"
+            "repo: demo-repo\n"
+            "status: active\n"
+            "state_hub_workstream_id: \"base-ws\"\n"
+            "---\n\n",
+            encoding="utf-8",
+        )
+        (workplans / "STATE-WP-0002-dependent.md").write_text(
+            "---\n"
+            "id: STATE-WP-0002\n"
+            "title: Dependent\n"
+            "domain: financials\n"
+            "repo: demo-repo\n"
+            "status: active\n"
+            "state_hub_workstream_id: \"dependent-ws\"\n"
+            "depends_on:\n"
+            "  - STATE-WP-0001\n"
+            "---\n\n",
+            encoding="utf-8",
+        )
+
+        def fake_get(_api_base, path, params=None, **_kwargs):
+            if path == "/repos/demo-repo":
+                import socket
+
+                return {
+                    "id": "repo-1",
+                    "slug": "demo-repo",
+                    "local_path": str(repo),
+                    "host_paths": {socket.gethostname(): str(repo)},
+                    "domain_slug": "financials",
+                }
+            if path == "/workplans/base-ws":
+                return {"id": "base-ws", "repo_id": "repo-1", "slug": "state-wp-0001", "title": "Base", "status": "active"}
+            if path == "/workplans/dependent-ws":
+                return {"id": "dependent-ws", "repo_id": "repo-1", "slug": "state-wp-0002", "title": "Dependent", "status": "active"}
+            if path == "/tasks" and params and params.get("workstream_id") in {"base-ws", "dependent-ws"}:
+                return []
+            if path == "/workplans/base-ws/dependencies":
+                return []
+            if path == "/workplans/dependent-ws/dependencies":
+                return [
+                    {
+                        "id": "dep-1",
+                        "from_workplan_id": "dependent-ws",
+                        "to_workplan_id": "base-ws",
+                        "to_task_id": None,
+                        "relationship_type": "blocks",
+                    }
+                ]
+            if path == "/workplans" and params == {"repo_id": "repo-1"}:
+                return []
+            return []
+
+        monkeypatch.setattr("consistency_check._api_get", fake_get)
+
+        report = check_repo("http://unused", "demo-repo")
+
+        assert "C-20" not in [issue.check_id for issue in report.issues]
+
+
+class TestFlavorChecks:
+    def test_unknown_flavor_warns_c36(self, tmp_path, monkeypatch):
+        repo = tmp_path / "repo"
+        workplans = repo / "workplans"
+        workplans.mkdir(parents=True)
+        (workplans / "STATE-WP-0001-odd.md").write_text(
+            "---\n"
+            "id: STATE-WP-0001\n"
+            "title: Odd\n"
+            "domain: financials\n"
+            "repo: demo-repo\n"
+            "status: active\n"
+            "flavor: sidetrack\n"
+            "state_hub_workstream_id: \"odd-ws\"\n"
+            "---\n\n",
+            encoding="utf-8",
+        )
+
+        def fake_get(_api_base, path, params=None, **_kwargs):
+            if path == "/repos/demo-repo":
+                import socket
+
+                return {
+                    "id": "repo-1",
+                    "slug": "demo-repo",
+                    "local_path": str(repo),
+                    "host_paths": {socket.gethostname(): str(repo)},
+                    "domain_slug": "financials",
+                }
+            if path == "/workplans/odd-ws":
+                return {
+                    "id": "odd-ws",
+                    "repo_id": "repo-1",
+                    "slug": "state-wp-0001",
+                    "title": "Odd",
+                    "status": "active",
+                }
+            if path == "/tasks":
+                return []
+            if path.endswith("/dependencies"):
+                return []
+            if path == "/workplans":
+                return []
+            return []
+
+        monkeypatch.setattr("consistency_check._api_get", fake_get)
+        report = check_repo("http://unused", "demo-repo")
+        assert "C-36" in [issue.check_id for issue in report.issues]
+
+    def test_residual_without_origin_warns_c37(self, tmp_path, monkeypatch):
+        repo = tmp_path / "repo"
+        workplans = repo / "workplans"
+        workplans.mkdir(parents=True)
+        (workplans / "STATE-WP-0001-left.md").write_text(
+            "---\n"
+            "id: STATE-WP-0001\n"
+            "title: Left\n"
+            "domain: financials\n"
+            "repo: demo-repo\n"
+            "status: active\n"
+            "flavor: residual\n"
+            "state_hub_workstream_id: \"left-ws\"\n"
+            "---\n\n",
+            encoding="utf-8",
+        )
+
+        def fake_get(_api_base, path, params=None, **_kwargs):
+            if path == "/repos/demo-repo":
+                import socket
+
+                return {
+                    "id": "repo-1",
+                    "slug": "demo-repo",
+                    "local_path": str(repo),
+                    "host_paths": {socket.gethostname(): str(repo)},
+                    "domain_slug": "financials",
+                }
+            if path == "/workplans/left-ws":
+                return {
+                    "id": "left-ws",
+                    "repo_id": "repo-1",
+                    "slug": "state-wp-0001",
+                    "title": "Left",
+                    "status": "active",
+                    "flavor": "residual",
+                }
+            if path == "/tasks":
+                return []
+            if path.endswith("/dependencies"):
+                return []
+            if path == "/workplans":
+                return []
+            return []
+
+        monkeypatch.setattr("consistency_check._api_get", fake_get)
+        report = check_repo("http://unused", "demo-repo")
+        assert "C-37" in [issue.check_id for issue in report.issues]
+
 
 class TestC06WorkstreamCreation:
+    def test_fix_repo_bootstraps_legacy_ids_only_into_empty_projection(
+        self, tmp_path, monkeypatch
+    ):
+        repo = tmp_path / "repo"
+        workplans = repo / "workplans"
+        workplans.mkdir(parents=True)
+        workplan_id = "11111111-1111-4111-8111-111111111111"
+        task_id = "22222222-2222-4222-8222-222222222222"
+        wp = workplans / "DEMO-WP-0001.md"
+        wp.write_text(
+            "---\n"
+            "id: DEMO-WP-0001\n"
+            "type: workplan\n"
+            "title: Demo Workplan\n"
+            "domain: financials\n"
+            "repo: demo-repo\n"
+            "status: ready\n"
+            f'state_hub_workstream_id: "{workplan_id}"\n'
+            "---\n\n"
+            "## Task\n\n"
+            "```task\n"
+            "id: DEMO-WP-0001-T01\n"
+            "status: todo\n"
+            "priority: high\n"
+            f'state_hub_task_id: "{task_id}"\n'
+            "```\n",
+            encoding="utf-8",
+        )
+        created = []
+
+        def fake_get(_api_base, path, params=None, **_kwargs):
+            if path == "/repos/demo-repo":
+                return {
+                    "id": "repo-1",
+                    "slug": "demo-repo",
+                    "local_path": str(repo),
+                    "host_paths": {},
+                    "domain_slug": "financials",
+                }
+            if path == "/topics":
+                return [{"id": "topic-1", "domain_slug": "financials"}]
+            if path == "/workplans" and params == {"repo_id": "repo-1"}:
+                return []
+            if path == f"/workplans/{workplan_id}":
+                return None
+            if path == "/workplans" and params and "slug" in params:
+                return []
+            return []
+
+        def fake_post(_api_base, path, body):
+            created.append((path, body))
+            return body
+
+        monkeypatch.setattr("consistency_check._api_get", fake_get)
+        monkeypatch.setattr("consistency_check._api_post", fake_post)
+        monkeypatch.setattr("consistency_check._api_patch", lambda *args, **kwargs: {"ok": True})
+        monkeypatch.setattr("consistency_check._detect_behind_remote", lambda _repo_path: False)
+        monkeypatch.setattr("consistency_check._detect_ahead_of_remote", lambda _repo_path: 0)
+        monkeypatch.setattr("consistency_check._write_custodian_brief", lambda *args, **kwargs: False)
+        monkeypatch.setattr("consistency_check._git_push", lambda _repo_path: (True, "pushed"))
+        monkeypatch.setenv("STATEHUB_REGISTRAR", "1")
+
+        report = fix_repo(
+            "http://unused",
+            "demo-repo",
+            bootstrap_empty_projection=True,
+        )
+
+        assert [body["id"] for path, body in created if path == "/workplans"] == [workplan_id]
+        assert [body["id"] for path, body in created if path == "/tasks"] == [task_id]
+        assert any("explicitly empty projection" in issue.message for issue in report.issues)
+
+    def test_fix_repo_refuses_empty_bootstrap_when_projection_has_rows(
+        self, tmp_path, monkeypatch
+    ):
+        repo = tmp_path / "repo"
+        (repo / "workplans").mkdir(parents=True)
+
+        def fake_get(_api_base, path, params=None, **_kwargs):
+            if path == "/repos/demo-repo":
+                return {
+                    "id": "repo-1",
+                    "slug": "demo-repo",
+                    "local_path": str(repo),
+                    "host_paths": {},
+                    "domain_slug": "financials",
+                }
+            if path == "/workplans" and params == {"repo_id": "repo-1"}:
+                return [{"id": "existing"}]
+            return []
+
+        monkeypatch.setattr("consistency_check._api_get", fake_get)
+        monkeypatch.setattr(
+            "consistency_check._api_post",
+            lambda *_args, **_kwargs: pytest.fail("bootstrap must not mutate a non-empty projection"),
+        )
+
+        report = fix_repo(
+            "http://unused",
+            "demo-repo",
+            bootstrap_empty_projection=True,
+        )
+
+        assert len(report.failures) == 1
+        assert report.failures[0].check_id == "C-36"
+
+    def test_fix_repo_rebuilds_missing_projection_from_derived_file_ids(
+        self, tmp_path, monkeypatch
+    ):
+        repo = tmp_path / "repo"
+        workplans = repo / "workplans"
+        workplans.mkdir(parents=True)
+        workplan_id = _derived_work_record_uuid("STATE-WP-0001")
+        task_id = _derived_work_record_uuid("STATE-WP-0001-T01")
+        wp = workplans / "STATE-WP-0001-demo.md"
+        original = (
+            "---\n"
+            "id: STATE-WP-0001\n"
+            "type: workplan\n"
+            "title: Demo Workplan\n"
+            "domain: financials\n"
+            "repo: demo-repo\n"
+            "status: ready\n"
+            f'state_hub_workstream_id: "{workplan_id}"\n'
+            "---\n\n"
+            "## Implement Demo\n\n"
+            "```task\n"
+            "id: STATE-WP-0001-T01\n"
+            "status: todo\n"
+            "priority: high\n"
+            f'state_hub_task_id: "{task_id}"\n'
+            "```\n"
+        )
+        wp.write_text(original, encoding="utf-8")
+        created = []
+
+        def fake_get(_api_base, path, params=None, **_kwargs):
+            if path == "/repos/demo-repo":
+                import socket
+
+                return {
+                    "id": "repo-1",
+                    "slug": "demo-repo",
+                    "local_path": str(repo),
+                    "host_paths": {socket.gethostname(): str(repo)},
+                    "domain_slug": "financials",
+                }
+            if path == "/topics":
+                return [{"id": "topic-1", "domain_slug": "financials"}]
+            if path == f"/workplans/{workplan_id}":
+                return None
+            if path == "/workplans" and params and "slug" in params:
+                return []
+            if path == "/workplans" and params:
+                return []
+            return []
+
+        def fake_post(_api_base, path, body):
+            created.append((path, body))
+            return body
+
+        monkeypatch.setattr("consistency_check._api_get", fake_get)
+        monkeypatch.setattr("consistency_check._api_post", fake_post)
+        monkeypatch.setattr("consistency_check._api_patch", lambda *args, **kwargs: {"ok": True})
+        monkeypatch.setattr("consistency_check._detect_behind_remote", lambda _repo_path: False)
+        monkeypatch.setattr("consistency_check._detect_ahead_of_remote", lambda _repo_path: 0)
+        monkeypatch.setattr("consistency_check._write_custodian_brief", lambda *args, **kwargs: False)
+        monkeypatch.setattr("consistency_check._git_push", lambda _repo_path: (True, "pushed"))
+        monkeypatch.setenv("STATEHUB_REGISTRAR", "1")
+
+        report = fix_repo("http://unused", "demo-repo")
+
+        assert created[0][1]["id"] == workplan_id
+        assert created[1][1]["id"] == task_id
+        assert created[1][1]["workplan_id"] == workplan_id
+        assert wp.read_text(encoding="utf-8") == original
+        assert any("C-06 fixed" in fix for fix in report.fixes_applied)
+
     def test_fix_repo_uses_repo_qualified_slug_when_base_slug_is_taken(self, tmp_path, monkeypatch):
         repo = tmp_path / "repo"
         workplans = repo / "workplans"
@@ -1276,16 +1741,154 @@ class TestC06WorkstreamCreation:
         monkeypatch.setattr("consistency_check._detect_ahead_of_remote", lambda _repo_path: 0)
         monkeypatch.setattr("consistency_check._write_custodian_brief", lambda *args, **kwargs: False)
         monkeypatch.setattr("consistency_check._git_push", lambda _repo_path: (True, "pushed"))
+        monkeypatch.setenv("STATEHUB_REGISTRAR", "1")
 
         report = fix_repo("http://unused", "demo-repo")
 
         assert created_workstreams[0]["slug"] == "demo-repo-state-wp-0001"
-        assert created_tasks[0]["workplan_id"] == "new-ws"
+        expected_workplan_id = created_workstreams[0]["id"]
+        expected_task_id = created_tasks[0]["id"]
+        assert created_tasks[0]["workplan_id"] == expected_workplan_id
         patched = wp.read_text(encoding="utf-8")
-        assert 'state_hub_workstream_id: "new-ws"' in patched
-        assert 'state_hub_task_id: "new-task"' in patched
+        assert f'state_hub_workstream_id: "{expected_workplan_id}"' in patched
+        assert f'state_hub_task_id: "{expected_task_id}"' in patched
         assert any("C-06 fixed" in fix for fix in report.fixes_applied)
 
+    def test_fix_repo_derives_identical_writeback_across_instances(
+        self, tmp_path, monkeypatch
+    ):
+        import socket
+
+        source = (
+            "---\n"
+            "id: STATE-WP-0001\n"
+            "type: workplan\n"
+            "title: Demo Workplan\n"
+            "domain: financials\n"
+            "repo: demo-repo\n"
+            "status: ready\n"
+            "owner: codex\n"
+            "---\n\n"
+            "## Implement Demo\n\n"
+            "```task\n"
+            "id: STATE-WP-0001-T01\n"
+            "status: todo\n"
+            "priority: high\n"
+            "```\n"
+        )
+        repos = {}
+        for instance in ("hub-a", "hub-b"):
+            repo = tmp_path / instance
+            workplans = repo / "workplans"
+            workplans.mkdir(parents=True)
+            (workplans / "STATE-WP-0001-demo.md").write_text(source, encoding="utf-8")
+            repos[instance] = repo
+
+        stores = {
+            instance: {"workplans": {}, "tasks": {}}
+            for instance in repos
+        }
+        create_attempts = {
+            instance: {"workplans": 0, "tasks": 0}
+            for instance in repos
+        }
+
+        def instance_name(api_base):
+            return api_base.rsplit("/", 1)[-1]
+
+        def fake_get(api_base, path, params=None, **_kwargs):
+            instance = instance_name(api_base)
+            store = stores[instance]
+            if path == "/repos/demo-repo":
+                return {
+                    "id": f"repo-{instance}",
+                    "slug": "demo-repo",
+                    "local_path": str(repos[instance]),
+                    "host_paths": {socket.gethostname(): str(repos[instance])},
+                    "domain_slug": "financials",
+                }
+            if path == "/topics":
+                return [{"id": f"topic-{instance}", "domain_slug": "financials"}]
+            if path.startswith("/workplans/"):
+                return store["workplans"].get(path.rsplit("/", 1)[-1])
+            if path.startswith("/tasks/"):
+                return store["tasks"].get(path.rsplit("/", 1)[-1])
+            if path == "/workplans":
+                rows = list(store["workplans"].values())
+                if params:
+                    rows = [
+                        row for row in rows
+                        if all(row.get(key) == value for key, value in params.items())
+                    ]
+                return rows
+            if path == "/tasks":
+                rows = list(store["tasks"].values())
+                if params:
+                    rows = [
+                        row for row in rows
+                        if all(row.get(key) == value for key, value in params.items())
+                    ]
+                return rows
+            return []
+
+        def fake_post(api_base, path, body):
+            instance = instance_name(api_base)
+            collection = path.strip("/")
+            if collection not in {"workplans", "tasks"}:
+                return {"ok": True}
+            create_attempts[instance][collection] += 1
+            existing = stores[instance][collection].get(body["id"])
+            if existing is not None:
+                return existing
+            stored = dict(body)
+            stores[instance][collection][body["id"]] = stored
+            return stored
+
+        monkeypatch.setattr("consistency_check._api_get", fake_get)
+        monkeypatch.setattr("consistency_check._api_post", fake_post)
+        monkeypatch.setattr("consistency_check._api_patch", lambda *args, **kwargs: {"ok": True})
+        monkeypatch.setattr("consistency_check._detect_behind_remote", lambda _repo_path: False)
+        monkeypatch.setattr("consistency_check._detect_ahead_of_remote", lambda _repo_path: 0)
+        monkeypatch.setattr("consistency_check._write_custodian_brief", lambda *args, **kwargs: False)
+        monkeypatch.setattr("consistency_check._git_push", lambda _repo_path: (True, "pushed"))
+        monkeypatch.setattr(
+            "consistency_check._git_commit_writeback", lambda *args, **kwargs: False
+        )
+        monkeypatch.setenv("STATEHUB_REGISTRAR", "0")
+
+        reports = {
+            instance: fix_repo(f"http://{instance}", "demo-repo")
+            for instance in repos
+        }
+        written = [
+            (repo / "workplans" / "STATE-WP-0001-demo.md").read_bytes()
+            for repo in repos.values()
+        ]
+        assert written[0] == written[1]
+        workplan_id = _derived_work_record_uuid("STATE-WP-0001")
+        task_id = _derived_work_record_uuid("STATE-WP-0001-T01")
+        text = written[0].decode("utf-8")
+        assert f'state_hub_workstream_id: "{workplan_id}"' in text
+        assert f'state_hub_task_id: "{task_id}"' in text
+        for instance in repos:
+            assert set(stores[instance]["workplans"]) == {workplan_id}
+            assert set(stores[instance]["tasks"]) == {task_id}
+            assert create_attempts[instance] == {"workplans": 1, "tasks": 1}
+            assert not any("identifier registrar" in fix for fix in reports[instance].fixes_applied)
+
+        # A second reconcile is idempotent: neither independent hub creates a
+        # duplicate record and the repository bytes remain unchanged.
+        for instance in repos:
+            fix_repo(f"http://{instance}", "demo-repo")
+        assert create_attempts == {
+            "hub-a": {"workplans": 1, "tasks": 1},
+            "hub-b": {"workplans": 1, "tasks": 1},
+        }
+        assert [
+            (repo / "workplans" / "STATE-WP-0001-demo.md").read_bytes()
+            for repo in repos.values()
+        ] == written
+
 # ---------------------------------------------------------------------------
 # _git_pull (T02 remote fix helper)
 # ---------------------------------------------------------------------------
diff --git a/tests/test_forge_projection.py b/tests/test_forge_projection.py
new file mode 100644
index 0000000..57641d3
--- /dev/null
+++ b/tests/test_forge_projection.py
@@ -0,0 +1,1355 @@
+"""Deriving a projection from the forge (STATE-WP-0083-T01).
+
+The properties that matter are identity and determinism: a forge-derived
+projection must compute the same record identities as repo-manager, and the same
+commit must always yield the same projection. Without both, the reset in T03
+cannot be verified against anything.
+"""
+
+from __future__ import annotations
+
+from pathlib import Path
+
+import pytest
+
+from api.services import forge_credential as fc
+
+from api.services import forge_projection as fp
+
+
+def test_task_description_retains_nested_sections_and_matches_consistency(monkeypatch):
+    monkeypatch.syspath_prepend(str(Path(__file__).parents[1] / "scripts"))
+    from scripts.consistency_check import parse_task_blocks
+
+    body = '''## Factory admission
+
+```task
+id: HFACT-WP-0001-T01
+status: progress
+description: Earlier inline summary.
+intervention_note: ""
+blocking_reason: ""
+```
+
+---
+Current native admission requirements.
+
+### Local proof
+
+Retain the source evidence and limitations.
+
+#### Remaining return
+
+Exact operator binding remains open.
+---
+
+## Next task
+
+```task
+id: HFACT-WP-0001-T02
+status: wait
+```
+
+Separate next-task description.
+'''
+    derived = fp._parse_tasks(body, "HFACT-WP-0001")
+    authoritative = parse_task_blocks(body)
+    assert derived[0].description == authoritative[0]["description"]
+    assert "### Local proof" in derived[0].description
+    assert "#### Remaining return" in derived[0].description
+    assert "Next task" not in derived[0].description
+    assert not derived[0].description.startswith("---")
+    assert derived[0].intervention_note == ""
+    assert derived[0].blocking_reason == ""
+    assert derived[1].description == authoritative[1]["description"]
+    assert derived[1].intervention_note is None
+
+
+@pytest.mark.parametrize("heading", ["", "# Workplan\n", "## Task\n", "### Task\n"])
+def test_task_description_stops_before_next_task_block(heading, monkeypatch):
+    monkeypatch.syspath_prepend(str(Path(__file__).parents[1] / "scripts"))
+    from scripts.consistency_check import parse_task_blocks
+
+    body = heading + '''```task
+id: DEMO-WP-0001-T01
+status: todo
+```
+
+First description.
+
+```task
+id: DEMO-WP-0001-T02
+status: wait
+description: Inline fallback.
+intervention_note: null
+blocking_reason: null
+```
+'''
+    derived = fp._parse_tasks(body, "DEMO-WP-0001")
+    authoritative = parse_task_blocks(body)
+    assert derived[0].description == authoritative[0]["description"] == "First description."
+    assert derived[1].description == authoritative[1]["description"] == "Inline fallback."
+    assert derived[1].intervention_note is derived[1].blocking_reason is None
+
+
+def test_identity_matches_the_fleet_derivation():
+    """Same namespace as ADR-007, so overlay and forge agree on identity."""
+    assert fp.derived_record_uuid("CUST-WP-0067") == "16249302-2767-55df-aec0-d92c2751c225"
+    assert fp.derived_record_uuid("CUST-WP-0067-T01") == "f3608db4-20a5-58fb-a965-885eb14858af"
+
+
+def _repo(tmp_path: Path) -> Path:
+    root = tmp_path / "demo"
+    (root / "workplans" / "archived").mkdir(parents=True)
+    (root / "workplans" / "DEMO-WP-0001-a.md").write_text(
+        "---\nid: DEMO-WP-0001\ntype: workplan\ntitle: \"First\"\nstatus: active\n---\n\n"
+        "## Do the thing\n\n```task\nid: DEMO-WP-0001-T01\nstatus: todo\npriority: high\n```\n\n"
+        "## Do the other\n\n```task\nid: DEMO-WP-0001-T02\nstatus: done\npriority: low\n```\n",
+        encoding="utf-8",
+    )
+    (root / "workplans" / "archived" / "260101-DEMO-WP-0002-b.md").write_text(
+        "---\nid: DEMO-WP-0002\ntype: workplan\ntitle: \"Second\"\nstatus: finished\n---\n\n# b\n",
+        encoding="utf-8",
+    )
+    (root / "workplans" / "NOTES.md").write_text(
+        "---\nid: NOT-A-WORKPLAN\ntype: note\n---\n\n# not a workplan\n", encoding="utf-8"
+    )
+    return root
+
+
+def test_derives_workplans_tasks_and_archived_flag(tmp_path):
+    p = fp.derive_from_checkout(_repo(tmp_path), "demo", "abc123")
+    assert [w.record_id for w in p.workplans] == ["DEMO-WP-0001", "DEMO-WP-0002"]
+    first, second = p.workplans
+    assert first.status == "active" and first.archived is False
+    assert second.archived is True
+    assert p.task_count == 2
+    assert [t.record_id for t in first.tasks] == ["DEMO-WP-0001-T01", "DEMO-WP-0001-T02"]
+
+
+def test_ignores_files_that_are_not_workplans(tmp_path):
+    """Selection is by `type: workplan`; anything else is not this hub's business."""
+    p = fp.derive_from_checkout(_repo(tmp_path), "demo", "abc123")
+    assert all(w.record_id != "NOT-A-WORKPLAN" for w in p.workplans)
+
+
+def test_task_titles_fall_back_to_the_preceding_heading(tmp_path):
+    p = fp.derive_from_checkout(_repo(tmp_path), "demo", "abc123")
+    titles = [t.title for t in p.workplans[0].tasks]
+    assert titles == ["Do the thing", "Do the other"]
+
+
+def test_identifiers_are_derived_not_read_from_the_file(tmp_path):
+    """A forge projection must not inherit whatever id a file happens to carry."""
+    root = _repo(tmp_path)
+    f = root / "workplans" / "DEMO-WP-0001-a.md"
+    f.write_text(
+        f.read_text(encoding="utf-8").replace(
+            "status: active",
+            'status: active\nstate_hub_workstream_id: "00000000-0000-4000-8000-000000000000"',
+        ),
+        encoding="utf-8",
+    )
+    p = fp.derive_from_checkout(root, "demo", "abc123")
+    assert p.workplans[0].uuid == fp.derived_record_uuid("DEMO-WP-0001")
+    assert p.workplans[0].uuid != "00000000-0000-4000-8000-000000000000"
+
+
+def test_same_input_yields_identical_output(tmp_path):
+    root = _repo(tmp_path)
+    assert fp.derive_from_checkout(root, "demo", "abc").to_dict() == \
+           fp.derive_from_checkout(root, "demo", "abc").to_dict()
+
+
+def test_missing_workplans_directory_is_empty_not_an_error(tmp_path):
+    (tmp_path / "bare").mkdir()
+    p = fp.derive_from_checkout(tmp_path / "bare", "bare", "abc")
+    assert p.workplans == [] and p.commit == "abc"
+
+
+def test_clone_failure_is_reported_not_swallowed(monkeypatch):
+    def boom(*a, **k):
+        raise fp.ForgeDeriveError("repository not found")
+    monkeypatch.setattr(fp, "_run_git", boom)
+    with pytest.raises(fp.ForgeDeriveError, match="not found"):
+        fp.derive_from_forge("nope")
+
+
+class TestReset:
+    """Applying the reset (STATE-WP-0083-T03).
+
+    The properties worth guarding are the refusals, not the happy path. A reset
+    that quietly retires a record someone still needs is worse than one that
+    does nothing.
+    """
+
+    @staticmethod
+    def _derived(*records):
+        wps = []
+        for rid, status, path in records:
+            wps.append(
+                fp.DerivedWorkplan(
+                    record_id=rid, uuid=fp.derived_record_uuid(rid), title=rid,
+                    status=status, relative_path=path, archived=False, tasks=[],
+                )
+            )
+        return fp.DerivedProjection(repo_slug="demo", commit="c0ffee", workplans=wps)
+
+    @pytest.mark.asyncio
+    async def test_refuses_retirement_unless_acknowledged(self, monkeypatch):
+        """A record that stops deriving may mean a deleted file — or a wrong branch."""
+        session = _FakeSession(
+            repo=_Repo(),
+            rows=[_Row(slug="demo-wp-0001", status="active", path="workplans/a.md")],
+        )
+        out = await fp.reset_repository_projection(
+            session, "demo", derived=self._derived()  # forge has nothing
+        )
+        assert out.status == "refused"
+        assert out.refused and out.refused[0]["slug"] == "demo-wp-0001"
+        assert out.retired == []
+        assert session.committed is False
+
+    @pytest.mark.asyncio
+    async def test_retires_when_acknowledged(self):
+        row = _Row(slug="demo-wp-0001", status="active", path="workplans/a.md")
+        session = _FakeSession(repo=_Repo(), rows=[row])
+        out = await fp.reset_repository_projection(
+            session, "demo", derived=self._derived(), acknowledge_retirements=True
+        )
+        assert out.status == "applied" and out.retired == ["demo-wp-0001"]
+        assert row.projection_retired_at is not None
+        assert row.projection_retired_reason == fp.RETIRE_REASON
+
+    @pytest.mark.asyncio
+    async def test_retirement_is_not_deletion(self):
+        """Hub-native records reference workplans with RESTRICT; the row survives."""
+        row = _Row(slug="demo-wp-0001", status="active", path="workplans/a.md")
+        session = _FakeSession(repo=_Repo(), rows=[row])
+        await fp.reset_repository_projection(
+            session, "demo", derived=self._derived(), acknowledge_retirements=True
+        )
+        assert row in session.rows
+        assert session.deleted == []
+
+    @pytest.mark.asyncio
+    async def test_unretires_a_record_that_derives_again(self):
+        from datetime import datetime, timezone
+        row = _Row(slug="demo-wp-0001", status="active", path="workplans/a.md")
+        row.projection_retired_at = datetime.now(tz=timezone.utc)
+        row.projection_retired_reason = fp.RETIRE_REASON
+        session = _FakeSession(repo=_Repo(), rows=[row])
+        out = await fp.reset_repository_projection(
+            session, "demo",
+            derived=self._derived(("DEMO-WP-0001", "active", "workplans/a.md")),
+        )
+        assert out.status == "applied"
+        assert row.projection_retired_at is None
+
+    @pytest.mark.asyncio
+    async def test_unregistered_repository_is_refused_not_created(self):
+        session = _FakeSession(repo=None, rows=[])
+        out = await fp.reset_repository_projection(session, "nope", derived=self._derived())
+        assert out.status == "refused"
+        assert "not registered" in out.refused[0]["reason"]
+
+    @pytest.mark.asyncio
+    async def test_records_the_commit_it_derived_from(self):
+        row = _Row(slug="demo-wp-0001", status="proposed", path="workplans/a.md")
+        session = _FakeSession(repo=_Repo(), rows=[row])
+        await fp.reset_repository_projection(
+            session, "demo",
+            derived=self._derived(("DEMO-WP-0001", "active", "workplans/a.md")),
+        )
+        assert row.derived_from_commit == "c0ffee"
+        assert row.status == "active"
+
+
+class _Repo:
+    def __init__(self):
+        import uuid as _u
+        self.id = _u.uuid4()
+        self.topic_id = None
+
+
+class _Row:
+    def __init__(self, slug, status, path, title=None):
+        import uuid as _u
+        self.id = _u.uuid4()
+        self.slug = slug
+        self.status = status
+        # The title is a derived field the reset syncs; the fixture carried no
+        # `title` at all, so it could not have caught the drift that left
+        # cust-wp-0010 describing another workplan's work.
+        self.title = title
+        self.backing_relative_path = path
+        self.backing_filename = path.rsplit("/", 1)[-1]
+        self.backing_archived = False
+        self.projection_retired_at = None
+        self.projection_retired_reason = None
+        self.derived_from_commit = None
+
+
+class _FakeSession:
+    """Stands in for AsyncSession: enough to prove intent without a database."""
+
+    def __init__(
+        self,
+        repo,
+        rows,
+        foreign=None,
+        slug_clash=None,
+        task_rows=None,
+        task_collision_rows=None,
+    ):
+        self._repo = repo
+        self.rows = list(rows)
+        self._foreign = list(foreign or [])
+        self._slug_clash = list(slug_clash or [])
+        self._task_rows = task_rows
+        self._task_collision_rows = list(task_collision_rows or [])
+        self.added = []
+        self.deleted = []
+        self.committed = False
+        self._calls = 0
+
+    async def execute(self, *_a, **_k):
+        self._calls += 1
+        repo, rows = self._repo, self.rows
+        # 1 resolves the repo, 2 loads its workplans, 3 is the identifier
+        # lookup, 4 the slug lookup. On the update-only path (no creates)
+        # the 3rd call is the existing-task load instead.
+        update_only = (
+            self._task_rows is not None
+            and not self._foreign
+            and not self._slug_clash
+        )
+        if self._calls == 2:
+            payload = rows
+        elif update_only and self._calls == 3:
+            payload = self._task_rows
+        elif update_only and self._calls == 4:
+            payload = self._task_collision_rows
+        elif self._calls == 3:
+            payload = self._foreign
+        elif self._calls == 4:
+            payload = self._slug_clash
+        elif self._calls == 5:
+            payload = self._task_collision_rows
+        else:
+            payload = []
+
+        class R:
+            def scalar_one_or_none(self_inner):
+                return repo
+
+            def scalars(self_inner):
+                return iter(payload)
+
+        return R()
+
+    def add(self, obj):
+        self.added.append(obj)
+
+    def delete(self, obj):
+        self.deleted.append(obj)
+
+    async def flush(self):
+        return None
+
+    async def commit(self):
+        self.committed = True
+
+    async def rollback(self):
+        self.rolled_back = True
+
+
+class TestCollisionRefusal:
+    """A colliding identifier must refuse, not raise (STATE-WP-0083-T03).
+
+    net-kingdom's ADHOC-2026-08-23 derives to an identifier another repository
+    already holds — the case CUST-WP-0066 documents. The reset previously failed
+    on a database constraint, which tells the caller nothing they can act on.
+    """
+
+    @staticmethod
+    def _derived(rid="DEMO-WP-0001"):
+        return fp.DerivedProjection(
+            repo_slug="demo", commit="c0ffee",
+            workplans=[fp.DerivedWorkplan(
+                record_id=rid, uuid=fp.derived_record_uuid(rid), title=rid,
+                status="active", relative_path="workplans/a.md",
+                archived=False, tasks=[])],
+        )
+
+    @pytest.mark.asyncio
+    async def test_refuses_when_the_identifier_belongs_elsewhere(self):
+        derived = self._derived()
+        foreign = _Row(slug="held-by-someone-else", status="finished", path="workplans/x.md")
+        foreign.id = __import__("uuid").UUID(derived.workplans[0].uuid)
+        session = _FakeSession(repo=_Repo(), rows=[], foreign=[foreign])
+        out = await fp.reset_repository_projection(session, "demo", derived=derived)
+        assert out.status == "refused"
+        assert out.refused[0]["reason"].startswith("derived identifier already belongs")
+        assert out.refused[0]["held_by_slug"] == "held-by-someone-else"
+        assert out.created == [] and session.added == []
+
+    @pytest.mark.asyncio
+    async def test_acknowledging_retirements_does_not_authorise_a_collision(self):
+        """Different decision, different authorisation."""
+        derived = self._derived()
+        foreign = _Row(slug="held-by-someone-else", status="finished", path="workplans/x.md")
+        foreign.id = __import__("uuid").UUID(derived.workplans[0].uuid)
+        session = _FakeSession(repo=_Repo(), rows=[], foreign=[foreign])
+        out = await fp.reset_repository_projection(
+            session, "demo", derived=derived, acknowledge_retirements=True
+        )
+        assert out.status == "refused"
+        assert session.added == []
+
+    @pytest.mark.asyncio
+    async def test_no_collision_still_creates(self):
+        derived = self._derived()
+        session = _FakeSession(repo=_Repo(), rows=[], foreign=[])
+        out = await fp.reset_repository_projection(session, "demo", derived=derived)
+        assert out.status == "applied" and out.created == ["DEMO-WP-0001"]
+
+
+class TestFleetReset:
+    """The fleet form must be a loop over the repository form (T04).
+
+    Its value is entirely in what it does with failure: a wide reset that stops
+    at the first refusal is one nobody can run, because there is always one
+    unresolved repository somewhere.
+    """
+
+    class _Factory:
+        def __init__(self, sessions):
+            self._sessions = list(sessions)
+
+        def __call__(self):
+            session = self._sessions.pop(0)
+            class Ctx:
+                async def __aenter__(self_inner):
+                    return session
+                async def __aexit__(self_inner, *a):
+                    return False
+            return Ctx()
+
+    @staticmethod
+    def _derived(rid):
+        return fp.DerivedProjection(
+            repo_slug="x", commit="c0ffee",
+            workplans=[fp.DerivedWorkplan(
+                record_id=rid, uuid=fp.derived_record_uuid(rid), title=rid,
+                status="active", relative_path="workplans/a.md", archived=False, tasks=[])])
+
+    @pytest.mark.asyncio
+    async def test_a_refusal_does_not_stop_the_pass(self, monkeypatch):
+        calls = []
+
+        async def fake(session, slug, **kw):
+            calls.append(slug)
+            out = fp.ResetOutcome(repo_slug=slug, commit="c0ffee", status="applied")
+            if slug == "bad":
+                out.status = "refused"
+                out.refused.append({"reason": "would be retired", "slug": "x"})
+            else:
+                out.updated.append("A-WP-0001")
+            return out
+
+        monkeypatch.setattr(fp, "reset_repository_projection", fake)
+        s = [_FakeSession(repo=_Repo(), rows=[]) for _ in range(3)]
+        res = await fp.reset_fleet_projection(self._Factory(s), ["good", "bad", "also-good"])
+        assert calls == ["good", "bad", "also-good"]
+        d = res.to_dict()
+        assert d["by_status"] == {"applied": 2, "refused": 1}
+        assert d["totals"]["updated"] == 2
+
+    @pytest.mark.asyncio
+    async def test_an_error_does_not_stop_the_pass(self, monkeypatch):
+        async def fake(session, slug, **kw):
+            if slug == "boom":
+                raise RuntimeError("clone failed")
+            return fp.ResetOutcome(repo_slug=slug, commit="c", status="noop")
+
+        monkeypatch.setattr(fp, "reset_repository_projection", fake)
+        s = [_FakeSession(repo=_Repo(), rows=[]) for _ in range(3)]
+        res = await fp.reset_fleet_projection(self._Factory(s), ["a", "boom", "b"])
+        d = res.to_dict()
+        assert d["errored"] == 1 and "clone failed" in res.errors["boom"]
+        assert set(res.results) == {"a", "b"}
+
+    @pytest.mark.asyncio
+    async def test_only_applied_repositories_are_committed(self, monkeypatch):
+        async def fake(session, slug, **kw):
+            out = fp.ResetOutcome(repo_slug=slug, commit="c", status="applied")
+            if slug == "refuser":
+                out.status = "refused"
+            else:
+                out.updated.append("A-WP-0001")
+            return out
+
+        monkeypatch.setattr(fp, "reset_repository_projection", fake)
+        s = [_FakeSession(repo=_Repo(), rows=[]) for _ in range(2)]
+        await fp.reset_fleet_projection(self._Factory(s), ["applier", "refuser"])
+        assert s[0].committed is True
+        assert s[1].committed is False
+
+
+class TestSlugCollisionRefusal:
+    """slug carries its own unique constraint (STATE-WP-0083-T04).
+
+    Checking the identifier alone left disaster-control raising IntegrityError:
+    two repositories can derive different identifiers whose slugs still collide.
+    """
+
+    @pytest.mark.asyncio
+    async def test_refuses_when_the_slug_belongs_elsewhere(self):
+        derived = fp.DerivedProjection(
+            repo_slug="demo", commit="c0ffee",
+            workplans=[fp.DerivedWorkplan(
+                record_id="REPO-WP-0001", uuid=fp.derived_record_uuid("REPO-WP-0001"),
+                title="x", status="active", relative_path="workplans/a.md",
+                archived=False, tasks=[])])
+        clash = _Row(slug="repo-wp-0001", status="finished", path="workplans/other.md")
+        session = _FakeSession(repo=_Repo(), rows=[], foreign=[], slug_clash=[clash])
+        out = await fp.reset_repository_projection(session, "demo", derived=derived)
+        assert out.status == "refused"
+        assert out.refused[0]["reason"].startswith("slug already belongs")
+        assert session.added == []
+
+
+class TestUnreadableIsNotMissing:
+    """STATE-WP-0084-T01.
+
+    A repository central is not permitted to read and a repository whose
+    records no longer derive authorise opposite things. Every test here exists
+    to keep the retirement path unreachable from an answer that cannot support
+    it — by construction, not by the reset happening to fail first.
+    """
+
+    @pytest.mark.parametrize(
+        "stderr",
+        [
+            "fatal: could not read Username for 'https://forgejo.coulomb.social'",
+            "remote: Invalid username or password.\nfatal: Authentication failed",
+            "fatal: could not read Username for 'https://f': terminal prompts disabled",
+            "fatal: repository 'https://forgejo.coulomb.social/rapp-openbao.git' not found",
+            "fatal: unable to access '...': The requested URL returned error: 403",
+        ],
+    )
+    def test_permission_shaped_failures_are_classified_unreadable(self, stderr, monkeypatch):
+        def boom(*a, **k):
+            raise fp.ForgeDeriveError(stderr)
+
+        monkeypatch.setattr(fp, "_run_git", boom)
+        with pytest.raises(fp.ForgeUnreadableError):
+            fp.derive_from_forge("rapp-openbao")
+
+    def test_a_genuine_fault_stays_a_plain_error(self, monkeypatch):
+        def boom(*a, **k):
+            raise fp.ForgeDeriveError("fatal: early EOF\nfatal: index-pack failed")
+
+        monkeypatch.setattr(fp, "_run_git", boom)
+        with pytest.raises(fp.ForgeDeriveError) as exc:
+            fp.derive_from_forge("demo")
+        assert not isinstance(exc.value, fp.ForgeUnreadableError)
+
+    def test_unreadable_is_a_derive_error_so_old_callers_still_catch_it(self):
+        assert issubclass(fp.ForgeUnreadableError, fp.ForgeDeriveError)
+
+    def test_a_checkout_without_workplans_cannot_evidence_absence(self, tmp_path):
+        (tmp_path / "bare").mkdir()
+        p = fp.derive_from_checkout(tmp_path / "bare", "bare", "abc")
+        assert p.workplans == []
+        assert p.records_source_present is False
+        assert p.retirement_eligible is False
+
+    def test_a_real_checkout_can(self, tmp_path):
+        p = fp.derive_from_checkout(_repo(tmp_path), "demo", "abc")
+        assert p.records_source_present is True
+        assert p.retirement_eligible is True
+
+    def test_the_diff_withholds_stale_rather_than_computing_it(self):
+        derived = fp.DerivedProjection(
+            repo_slug="demo", commit="c0ffee", records_source_present=False
+        )
+        hub = [{"id": "11111111-1111-1111-1111-111111111111", "slug": "demo-wp-0001",
+                "status": "active", "backing_relative_path": "workplans/a.md"}]
+        d = fp.diff_against_hub(derived, hub, {})
+        assert d.stale == []
+        assert d.would_remove == 0
+        assert d.stale_withheld
+
+    @pytest.mark.asyncio
+    async def test_an_empty_source_cannot_retire_even_when_acknowledged(self):
+        derived = fp.DerivedProjection(
+            repo_slug="demo", commit="c0ffee", records_source_present=False
+        )
+        row = _Row(slug="demo-wp-0001", status="active", path="workplans/a.md")
+        session = _FakeSession(repo=_Repo(), rows=[row])
+        out = await fp.reset_repository_projection(
+            session, "demo", derived=derived, acknowledge_retirements=True
+        )
+        assert out.status == "refused"
+        assert out.retired == []
+        assert row.projection_retired_at is None
+        assert out.refused[0]["reason"].startswith("source produced no records")
+
+    @pytest.mark.asyncio
+    async def test_an_unreadable_repository_reports_unreadable_not_error(self, monkeypatch):
+        def boom(*a, **k):
+            raise fp.ForgeUnreadableError("rapp-openbao could not be read from the forge")
+
+        monkeypatch.setattr(fp, "derive_from_forge", boom)
+        session = _FakeSession(repo=_Repo(), rows=[])
+        out = await fp.reset_repository_projection(session, "rapp-openbao")
+        assert out.status == "unreadable"
+        assert out.retired == [] and out.created == [] and out.updated == []
+
+    @pytest.mark.asyncio
+    async def test_the_fleet_keeps_unreadable_out_of_the_error_bucket(self, monkeypatch):
+        async def fake(session, slug, **kw):
+            if slug == "private":
+                out = fp.ResetOutcome(repo_slug=slug, commit="", status="unreadable")
+                out.refused.append({"reason": "repository could not be read from the forge",
+                                    "slug": slug, "detail": "could not read Username"})
+                return out
+            if slug == "broken":
+                raise RuntimeError("index-pack failed")
+            out = fp.ResetOutcome(repo_slug=slug, commit="c0ffee", status="applied")
+            out.updated.append("A-WP-0001")
+            return out
+
+        monkeypatch.setattr(fp, "reset_repository_projection", fake)
+        sessions = [_FakeSession(repo=_Repo(), rows=[]) for _ in range(3)]
+        outcome = await fp.reset_fleet_projection(
+            TestFleetReset._Factory(sessions), ["ok", "private", "broken"]
+        )
+        assert list(outcome.unreadable) == ["private"]
+        assert list(outcome.errors) == ["broken"]
+        assert "private" not in outcome.results
+        d = outcome.to_dict()
+        assert d["unreadable_count"] == 1 and d["errored"] == 1
+        assert d["repositories"] == 3
+
+
+class TestForgeCredential:
+    """Optional forge read credential (STATE-WP-0084-T03).
+
+    Absent is a valid state: a hub with no credential must still derive every
+    public repository. The credential must never reach argv, a log, or an
+    exception — the places a secret leaks without anyone deciding to leak it.
+    """
+
+    @pytest.fixture(autouse=True)
+    def _clear_cache(self):
+        """The resolved credential is cached for 5 minutes in production.
+
+        That cache is deliberate — a fleet reset of 121 repositories must not
+        authenticate to OpenBao 121 times — so tests clear it rather than
+        disable it, and exercise the same code path production uses.
+        """
+        fc.reset_cache()
+        yield
+        fc.reset_cache()
+
+    def test_absent_credential_is_none_not_empty_string(self, monkeypatch):
+        monkeypatch.delenv(fc.TOKEN_ENV, raising=False)
+        monkeypatch.delenv(fc.TOKEN_FILE_ENV, raising=False)
+        assert fc.forge_read_token() is None
+
+    def test_a_file_is_preferred_over_the_environment(self, tmp_path, monkeypatch):
+        """Kubernetes rotates a mounted file without a redeploy."""
+        f = tmp_path / "token"
+        f.write_text("from-file\n", encoding="utf-8")
+        monkeypatch.setenv(fc.TOKEN_ENV, "from-env")
+        monkeypatch.setenv(fc.TOKEN_FILE_ENV, str(f))
+        assert fc.forge_read_token() == "from-file"
+
+    def test_an_unreadable_token_file_does_not_fall_back_silently(self, monkeypatch):
+        """Falling back to a stale env value would hide a broken mount."""
+        monkeypatch.setenv(fc.TOKEN_FILE_ENV, "/nonexistent/token")
+        monkeypatch.setenv(fc.TOKEN_ENV, "from-env")
+        assert fc.forge_read_token() is None
+
+    def test_openbao_is_the_last_resort_not_the_first(self, tmp_path, monkeypatch):
+        """A file or env value must not trigger a network call."""
+        f = tmp_path / "token"
+        f.write_text("local", encoding="utf-8")
+        monkeypatch.setenv(fc.TOKEN_FILE_ENV, str(f))
+        monkeypatch.setattr(
+            fc, "_from_openbao", lambda: pytest.fail("OpenBao consulted unnecessarily")
+        )
+        assert fc.forge_read_token() == "local"
+
+    def test_openbao_failure_resolves_to_absent_not_an_exception(self, monkeypatch):
+        """A hub that cannot reach OpenBao must still derive public repos.
+
+        Raising here would turn "nine repositories are unreadable" into "the
+        whole derivation pass failed" — the outcome STATE-WP-0084-T01 exists to
+        prevent.
+        """
+        monkeypatch.delenv(fc.TOKEN_FILE_ENV, raising=False)
+        monkeypatch.delenv(fc.TOKEN_ENV, raising=False)
+        monkeypatch.setenv(fc.OPENBAO_ADDR_ENV, "https://openbao.invalid")
+        monkeypatch.setenv(fc.SECRET_PATH_ENV, "kv/data/forge")
+        monkeypatch.setenv(fc.OPENBAO_ROLE_ENV, "state-hub-forge-derivation")
+        monkeypatch.setenv(fc.OPENBAO_JWT_PATH_ENV, "/nonexistent/sa-token")
+        assert fc.forge_read_token() is None
+
+    def test_openbao_unwraps_kv_v2(self, tmp_path, monkeypatch):
+        jwt = tmp_path / "sa"
+        jwt.write_text("jwt-value", encoding="utf-8")
+        monkeypatch.delenv(fc.TOKEN_FILE_ENV, raising=False)
+        monkeypatch.delenv(fc.TOKEN_ENV, raising=False)
+        monkeypatch.setenv(fc.OPENBAO_ADDR_ENV, "https://openbao.test")
+        monkeypatch.setenv(fc.SECRET_PATH_ENV, "kv/data/forge")
+        monkeypatch.setenv(fc.OPENBAO_ROLE_ENV, "state-hub-forge-derivation")
+        monkeypatch.setenv(fc.OPENBAO_JWT_PATH_ENV, str(jwt))
+
+        class R:
+            def __init__(self, payload):
+                self._p = payload
+
+            def raise_for_status(self):
+                return None
+
+            def json(self):
+                return self._p
+
+        class C:
+            def __enter__(self):
+                return self
+
+            def __exit__(self, *a):
+                return False
+
+            def post(self, url, json):
+                assert json["jwt"] == "jwt-value"
+                assert json["role"] == "state-hub-forge-derivation"
+                return R({"auth": {"client_token": "bao-token"}})
+
+            def get(self, url, headers):
+                assert headers["X-Vault-Token"] == "bao-token"
+                return R({"data": {"data": {"token": "forge-secret"}}})
+
+        monkeypatch.setattr(fc.httpx, "Client", lambda **kw: C())
+        assert fc.forge_read_token() == "forge-secret"
+
+    def test_credential_never_appears_in_argv(self, monkeypatch):
+        """`-c http.extraHeader=` would put the token in every ps listing."""
+        seen = {}
+
+        class P:
+            returncode = 0
+            stdout = ""
+            stderr = ""
+
+        def fake_run(cmd, **kw):
+            seen["cmd"] = cmd
+            seen["env"] = kw.get("env") or {}
+            return P()
+
+        monkeypatch.setattr(fp.subprocess, "run", fake_run)
+        fp._run_git("clone", "url", "dir", token="s3cret")
+        assert not any("s3cret" in part for part in seen["cmd"])
+        assert seen["env"]["GIT_CONFIG_COUNT"] == "1"
+        assert "s3cret" not in seen["env"]["GIT_CONFIG_KEY_0"]
+
+    def test_credential_is_redacted_from_failures(self, monkeypatch):
+        class P:
+            returncode = 128
+            stdout = ""
+            stderr = "fatal: auth failed using s3cret"
+
+        monkeypatch.setattr(fp.subprocess, "run", lambda *a, **k: P())
+        with pytest.raises(fp.ForgeDeriveError) as exc:
+            fp._run_git("clone", token="s3cret")
+        assert "s3cret" not in str(exc.value) and "***" in str(exc.value)
+
+    def test_no_credential_still_runs(self, monkeypatch):
+        class P:
+            returncode = 0
+            stdout = "ok"
+            stderr = ""
+        seen = {}
+
+        def fake_run(cmd, **kw):
+            seen["env"] = kw.get("env") or {}
+            return P()
+
+        monkeypatch.setattr(fp.subprocess, "run", fake_run)
+        assert fp._run_git("status") == "ok"
+        assert "GIT_CONFIG_COUNT" not in seen["env"]
+
+
+class TestRekeyIsNotRename:
+    """A changed identifier is a new record, not a moved file.
+
+    The ad-hoc requalification (CUST-WP-0066) keeps the filename by design, so
+    for those records a re-key never changes the path. Matching on path there
+    cannot distinguish the two cases, and choosing rename updates a row whose
+    UUID still encodes the old identifier — leaving the file and the hub
+    disagreeing about what the record is called.
+    """
+
+    class _Row:
+        def __init__(self, id, slug, path):
+            self.id = id
+            self.slug = slug
+            self.backing_relative_path = path
+            self.projection_retired_at = None
+            self.status = "finished"
+
+    def test_a_derived_row_is_not_matched_by_path(self):
+        """uuid5 means identity is a function of the identifier."""
+        import uuid as _u
+        old = self._Row(
+            _u.UUID(fp.derived_record_uuid("ADHOC-2026-08-25")),
+            "adhoc-2026-08-25",
+            "workplans/ADHOC-2026-08-25.md",
+        )
+        assert fp._identity_is_derived(old)
+
+    def test_a_legacy_row_keeps_path_matching(self):
+        """v4 rows predate derived identity; there the identifier is a label."""
+        import uuid as _u
+        legacy = self._Row(_u.uuid4(), "repo-wp-0001", "workplans/REPO-WP-0001.md")
+        assert not fp._identity_is_derived(legacy)
+
+    def test_the_two_uuids_actually_differ(self):
+        """Guards the premise: if they were equal the distinction is moot."""
+        assert fp.derived_record_uuid("ADHOC-2026-08-25") != fp.derived_record_uuid(
+            "CUST-WP-ADHOC-2026-08-25"
+        )
+
+    @pytest.mark.parametrize(
+        "slug",
+        [
+            "adhoc-2026-07-02",                # grandfathered daily ad-hoc
+            "cust-wp-adhoc-2026-08-25",        # qualified daily ad-hoc
+            "net-kingdom-adhoc-2026-07-02",    # repo-name-qualified legacy form
+            "adhoc-llmc-2026-06-02",           # another legacy qualification
+            "rcluster-wp-0007",                # ordinary workplan
+            "cust-wp-0066-t01",                # task
+        ],
+    )
+    def test_identifier_slugs_are_recognised(self, slug):
+        """A slug that claims to be an identifier is one, whatever its UUID.
+
+        25 of 44 ad-hoc rows are legacy v4, so a UUID-version test alone would
+        leave them path-matched and silently diverged from their files.
+        """
+        assert fp._slug_is_identifier(slug)
+
+    @pytest.mark.parametrize(
+        "slug",
+        ["three-phoenix-ha-cluster", "testdrive-jsui-publication", "state-hub-v0.1", ""],
+    )
+    def test_title_slugs_keep_path_matching(self, slug):
+        """Hub-first rows never claimed an identifier; the path is their only link."""
+        assert not fp._slug_is_identifier(slug)
+
+
+class TestRetirementReleasesTheIdentifier:
+    """`slug` is unique table-wide, so retirement must free it.
+
+    Retirement that only sets a timestamp leaves the identifier locked to a
+    record nothing derives, and the repository that owns it can never claim it.
+    """
+
+    def test_the_identifier_is_released(self):
+        from datetime import datetime, timezone
+        when = datetime(2026, 8, 28, tzinfo=timezone.utc)
+        assert fp._tombstone_slug("repo-wp-0001", when) == "repo-wp-0001@retired-20260828"
+
+    def test_re_retiring_does_not_stack_marks(self):
+        """Otherwise the 100-char column overflows after a few passes."""
+        from datetime import datetime, timezone
+        a = fp._tombstone_slug("repo-wp-0001", datetime(2026, 8, 28, tzinfo=timezone.utc))
+        b = fp._tombstone_slug(a, datetime(2026, 9, 1, tzinfo=timezone.utc))
+        assert b == "repo-wp-0001@retired-20260901"
+        assert b.count(fp.RETIRED_SLUG_MARK) == 1
+
+    def test_a_long_slug_stays_within_the_column(self):
+        from datetime import datetime, timezone
+        out = fp._tombstone_slug("x" * 140, datetime(2026, 8, 28, tzinfo=timezone.utc))
+        assert len(out) <= 100
+
+    class _Retired:
+        def __init__(self, slug, when, id=None):
+            import uuid as _u
+            self.id = id or _u.uuid4()
+            self.slug = slug
+            self.projection_retired_at = when
+            self.projection_retired_reason = "x"
+            self.backing_relative_path = None
+            self.status = "finished"
+
+    def test_rows_retired_before_the_stamp_existed_are_repaired(self):
+        """`stale` excludes already-retired rows, so nothing else revisits them.
+
+        The 32 rows retired earlier today still hold their identifiers; without
+        this they would block the owning repository forever.
+        """
+        from datetime import datetime, timezone
+        when = datetime(2026, 8, 28, tzinfo=timezone.utc)
+        row = self._Retired("repo-wp-0001", when)
+        assert fp.RETIRED_SLUG_MARK not in row.slug
+        row.slug = fp._tombstone_slug(row.slug, row.projection_retired_at)
+        assert row.slug == "repo-wp-0001@retired-20260828"
+
+    def test_an_already_stamped_row_is_left_alone(self):
+        """Otherwise every reset rewrites the date and churns the row."""
+        from datetime import datetime, timezone
+        row = self._Retired(
+            "repo-wp-0001@retired-20260828", datetime(2026, 8, 28, tzinfo=timezone.utc)
+        )
+        assert fp.RETIRED_SLUG_MARK in row.slug
+
+    def test_a_release_is_committed_even_when_the_repo_refuses(self):
+        """The fleet driver commits only on `applied` and rolls back otherwise.
+
+        Moving the release ahead of the refusal returns achieves nothing if the
+        rollback then discards it — which is the state railiance-cluster and
+        inter-hub were in.
+        """
+        import inspect
+        src = inspect.getsource(fp.reset_fleet_projection)
+        assert 'result.status == "applied" or result.released' in src
+
+
+class TestUuidMatchWins:
+    """A row whose UUID is uuid5 of the identifier IS that record.
+
+    `testdrive-jsui-publication` and `three-phoenix-ha-cluster` carry legacy
+    title slugs while their UUIDs are derived from MARKITECT-WP-0002 and
+    RCLUSTER-WP-0007. The slug-identifier rule alone reads them as re-keys and
+    proposes retiring records that were correct all along.
+    """
+
+    def test_a_title_slugged_row_is_still_its_derived_record(self):
+        import uuid as _u
+        rid = "MARKITECT-WP-0002"
+        row_id = _u.UUID(fp.derived_record_uuid(rid))
+        # The slug says one thing, the UUID says another; the UUID is identity.
+        assert not fp._slug_is_identifier("testdrive-jsui-publication")
+        assert str(row_id) == fp.derived_record_uuid(rid)
+
+    def test_uuid_match_is_checked_before_the_rekey_rules(self):
+        import inspect
+        src = inspect.getsource(fp.reset_repository_projection)
+        uuid_at = src.index("want_by_uuid.get(str(row.id))")
+        rekey_at = src.index("_identity_is_derived(row) or _slug_is_identifier")
+        assert uuid_at < rekey_at, "UUID match must precede the re-key heuristics"
+
+
+class TestTaskIdentityIsQualified:
+    """A bare `T01` is unique within its workplan, not in the fleet.
+
+    Unqualified, `uuid5("T01")` is the same UUID for every workplan that has a
+    T01 — llm-connect's 91 task blocks derive 49 distinct UUIDs, and creating
+    its workplans dies on `duplicate key value violates unique constraint
+    "tasks_pkey"`.
+    """
+
+    BODY = """
+```task
+id: T01
+status: done
+```
+
+```task
+id: T02
+status: todo
+```
+"""
+
+    def test_short_ids_are_qualified_by_their_workplan(self):
+        a = fp._parse_tasks(self.BODY, "LLM-WP-0001")
+        b = fp._parse_tasks(self.BODY, "LLM-WP-0002")
+        assert [t.record_id for t in a] == ["LLM-WP-0001-T01", "LLM-WP-0001-T02"]
+        assert {t.uuid for t in a}.isdisjoint({t.uuid for t in b})
+
+    def test_an_already_qualified_id_is_left_alone(self):
+        body = "```task\nid: LLM-WP-0009-T03\nstatus: todo\n```"
+        assert fp._parse_tasks(body, "LLM-WP-0001")[0].record_id == "LLM-WP-0009-T03"
+
+    def test_it_agrees_with_the_backfill(self):
+        """Both must apply the same rule or they disagree on a task's name."""
+        from api.services.task_record_id_backfill import qualify_task_id
+        got = fp._parse_tasks(self.BODY, "LLM-WP-0001")[0].record_id
+        assert got == qualify_task_id("T01", "LLM-WP-0001")
+
+    def test_uuid_follows_the_qualified_id(self):
+        t = fp._parse_tasks(self.BODY, "LLM-WP-0001")[0]
+        assert t.uuid == fp.derived_record_uuid("LLM-WP-0001-T01")
+
+
+class TestRetirementIsNotUndoneByPath:
+    """A retired row is matched by UUID or not at all.
+
+    Releasing the identifier removes the evidence that made the row a re-key:
+    the tombstoned slug is no longer an identifier, and a legacy row is not
+    UUID-derived, so both guards fall through to path matching — which matches
+    the very file the row was retired for and resurrects it beside the correct
+    record created from that same file.
+    """
+
+    def test_a_tombstoned_slug_is_not_an_identifier(self):
+        """This is the signal the tombstone destroys."""
+        assert fp._slug_is_identifier("adhoc-2026-06-01")
+        assert not fp._slug_is_identifier("adhoc-2026-06-01@retired-20260827")
+
+    def test_retired_rows_are_skipped_before_path_matching(self):
+        import inspect
+        src = inspect.getsource(fp.reset_repository_projection)
+        skip_at = src.index("if row.projection_retired_at is not None:")
+        path_at = src.index("if bp and _path_key(bp) in want_paths:")
+        assert skip_at < path_at, "retired rows must be skipped before path matching"
+
+    def test_uuid_match_still_precedes_the_skip(self):
+        """A record that genuinely returns must still be un-retired."""
+        import inspect
+        src = inspect.getsource(fp.reset_repository_projection)
+        assert src.index("want_by_uuid.get(str(row.id))") < src.index(
+            "if row.projection_retired_at is not None:"
+        )
+
+    def test_a_row_that_derives_again_is_not_tombstoned(self):
+        """Releasing it would change the slug out from under the matching.
+
+        The row would then fail to match its own file and never be un-retired —
+        which is how five rows ended up tombstoned but not retired.
+        """
+        import inspect
+        src = inspect.getsource(fp.reset_repository_projection)
+        rel = src.index("outcome.released.append(before)")
+        guard = src.index('in want or str(r.id) in want_by_uuid')
+        assert guard < rel, "the release must exempt records the forge still derives"
+
+    def test_a_stamped_slug_counts_as_retired_even_if_the_flag_is_clear(self):
+        """Otherwise a resurrected row path-matches its file and reports noop forever."""
+        import inspect
+        src = inspect.getsource(fp.reset_repository_projection)
+        assert "projection_retired_at is None and RETIRED_SLUG_MARK in" in src
+
+    def test_a_resurrected_row_becomes_stale_rather_than_being_skipped(self):
+        """Skipping it outright is what left six rows reporting noop forever.
+
+        `stale` is computed from `matched`, so a row that never enters `matched`
+        is invisible: not retired, so not stale; path-matching its own file, so
+        never reported.
+        """
+        import inspect
+        src = inspect.getsource(fp.reset_repository_projection)
+        zombie = src.index("projection_retired_at is None and RETIRED_SLUG_MARK in")
+        tail = src[zombie:zombie + 700]
+        assert "matched[key] = row" in tail, "a resurrected row must enter `matched`"
+
+
+class TestCompetingClaims:
+    """Two rows can claim one record; the weaker must not vanish.
+
+    `cust-wp-0010` claimed CUST-WP-0010 by its own identifier while
+    `workstream-lifecycle-documentation` claimed it by path. Assigning into
+    `matched` unconditionally let the later one win and dropped the other
+    silently — never matched, so never stale, so never reported by any pass.
+    """
+
+    def test_claims_are_ranked_not_overwritten(self):
+        import inspect
+        src = inspect.getsource(fp.reset_repository_projection)
+        assert "def _claim(" in src
+        assert "displaced.append" in src
+
+    def test_a_displaced_row_becomes_stale(self):
+        import inspect
+        src = inspect.getsource(fp.reset_repository_projection)
+        stale_at = src.index("stale = [")
+        assert "displaced" in src[stale_at:stale_at + 400]
+
+    def test_identifier_beats_path(self):
+        """A row naming the record outranks one that merely shares its file."""
+        import inspect
+        src = inspect.getsource(fp.reset_repository_projection)
+        assert src.index("UUID_MATCH, SLUG_MATCH, PATH_MATCH, PREFIX_MATCH = 0, 1, 2, 3") > 0
+        # Strength is ordered strongest-first, so a lower number wins.
+        assert "if strength < held:" in src
+
+
+class TestTitleIsDerivedToo:
+    """The title is a derived field and must follow the file.
+
+    Not syncing it left `cust-wp-0010` correctly identified and correctly backed
+    while describing a different workplan's work.
+    """
+
+    def test_title_is_synced(self):
+        import inspect
+        src = inspect.getsource(fp.reset_repository_projection)
+        assert "row.title = w.title.strip()" in src
+
+    def test_an_empty_derived_title_does_not_blank_a_real_one(self):
+        """Three activity-core files parse to no title; blanking is worse than stale."""
+        import inspect
+        src = inspect.getsource(fp.reset_repository_projection)
+        i = src.index("row.title = w.title.strip()")
+        guard = src[max(0, i - 200):i]
+        assert "w.title and w.title.strip()" in guard
+
+
+class TestTitleSyncBehaviour:
+    """Exercised against the fake session rather than asserted on source."""
+
+    @pytest.mark.asyncio
+    async def test_a_drifted_title_is_corrected(self):
+        row = _Row(slug="demo-wp-0001", status="active",
+                   path="workplans/a.md", title="Some Other Workplan")
+        session = _FakeSession(repo=_Repo(), rows=[row])
+        out = await fp.reset_repository_projection(
+            session, "demo",
+            derived=TestReset()._derived(("DEMO-WP-0001", "active", "workplans/a.md")),
+        )
+        assert out.status == "applied"
+        assert row.title != "Some Other Workplan"
+
+    @pytest.mark.asyncio
+    async def test_an_empty_derived_title_leaves_the_existing_one(self):
+        row = _Row(slug="demo-wp-0001", status="active",
+                   path="workplans/a.md", title="Real Title")
+        d = TestReset()._derived(("DEMO-WP-0001", "active", "workplans/a.md"))
+        d.workplans[0].title = None
+        session = _FakeSession(repo=_Repo(), rows=[row])
+        await fp.reset_repository_projection(session, "demo", derived=d)
+        assert row.title == "Real Title"
+
+
+class _TaskRow:
+    def __init__(self, record_id, status="todo", title="t", workplan_id=None):
+        import uuid as _u
+        self.id = _u.uuid4()
+        self.record_id = record_id
+        self.status = status
+        self.title = title
+        self.priority = "medium"
+        self.workplan_id = workplan_id
+
+
+class TestExistingWorkplanTasks:
+    """Tasks of an existing workplan are matched by record_id (CUST-WP-0068-T09)."""
+
+    def _derived(self, *tasks):
+        dts = [
+            fp.DerivedTask(
+                record_id=tid,
+                uuid=fp.derived_record_uuid(tid),
+                title=title,
+                status=st,
+                priority="medium",
+            )
+            for tid, title, st in tasks
+        ]
+        return fp.DerivedProjection(
+            repo_slug="demo",
+            commit="c0ffee",
+            workplans=[
+                fp.DerivedWorkplan(
+                    record_id="DEMO-WP-0001",
+                    uuid=fp.derived_record_uuid("DEMO-WP-0001"),
+                    title="DEMO-WP-0001",
+                    status="active",
+                    relative_path="workplans/a.md",
+                    archived=False,
+                    tasks=dts,
+                )
+            ],
+        )
+
+    @pytest.mark.asyncio
+    async def test_creates_a_missing_identified_task(self):
+        row = _Row(slug="demo-wp-0001", status="active", path="workplans/a.md")
+        session = _FakeSession(repo=_Repo(), rows=[row], task_rows=[])
+        out = await fp.reset_repository_projection(
+            session, "demo",
+            derived=self._derived(("DEMO-WP-0001-T01", "Do it", "todo")),
+        )
+        assert out.created_tasks == ["DEMO-WP-0001-T01"]
+        assert session.added
+        assert session.added[0].record_id == "DEMO-WP-0001-T01"
+
+    @pytest.mark.asyncio
+    async def test_cancels_an_open_task_the_file_no_longer_derives(self):
+        row = _Row(slug="demo-wp-0001", status="active", path="workplans/a.md")
+        stale = _TaskRow("DEMO-WP-0001-T09", status="todo", workplan_id=row.id)
+        session = _FakeSession(repo=_Repo(), rows=[row], task_rows=[stale])
+        out = await fp.reset_repository_projection(
+            session, "demo",
+            derived=self._derived(("DEMO-WP-0001-T01", "Do it", "todo")),
+        )
+        assert stale.status.value == "cancel" or stale.status == "cancel" or str(stale.status).endswith("cancel")
+        assert "DEMO-WP-0001-T09" in out.cancelled_tasks
+        assert session.deleted == []
+
+    @pytest.mark.asyncio
+    async def test_sets_record_id_when_the_derived_uuid_already_exists(self):
+        row = _Row(slug="demo-wp-0001", status="active", path="workplans/a.md")
+        existing = _TaskRow(None, status="done", title="Clear the stale hub rows", workplan_id=row.id)
+        derived = self._derived(("DEMO-WP-0001-T01", "Clear the stale hub rows", "done"))
+        existing.id = __import__("uuid").UUID(derived.workplans[0].tasks[0].uuid)
+        session = _FakeSession(repo=_Repo(), rows=[row], task_rows=[existing])
+        out = await fp.reset_repository_projection(session, "demo", derived=derived)
+        assert out.created_tasks == []
+        assert existing.record_id == "DEMO-WP-0001-T01"
+        assert session.added == []
+
+    @pytest.mark.asyncio
+    async def test_leaves_unidentified_tasks_alone(self):
+        row = _Row(slug="demo-wp-0001", status="active", path="workplans/a.md")
+        orphan = _TaskRow(None, status="todo", title="legacy", workplan_id=row.id)
+        session = _FakeSession(repo=_Repo(), rows=[row], task_rows=[orphan])
+        await fp.reset_repository_projection(
+            session, "demo",
+            derived=self._derived(("DEMO-WP-0001-T01", "Do it", "todo")),
+        )
+        assert orphan.status == "todo"
+
+    @pytest.mark.asyncio
+    async def test_duplicate_identity_inside_current_workplan_is_refused(self):
+        row = _Row(slug="demo-wp-0001", status="active", path="workplans/a.md")
+        first = _TaskRow("DEMO-WP-0001-T01", workplan_id=row.id)
+        second = _TaskRow("demo-wp-0001-t01", workplan_id=row.id)
+        session = _FakeSession(repo=_Repo(), rows=[row], task_rows=[first, second])
+        out = await fp.reset_repository_projection(
+            session,
+            "demo",
+            derived=self._derived(("DEMO-WP-0001-T01", "Do it", "todo")),
+        )
+        assert out.status == "refused"
+        assert out.refused[0]["reason"].startswith("current workplan contains duplicate")
+        assert session.added == []
+
+    @pytest.mark.asyncio
+    async def test_duplicate_stale_history_inside_current_workplan_does_not_block(self):
+        row = _Row(slug="demo-wp-0001", status="active", path="workplans/a.md")
+        desired = _TaskRow("DEMO-WP-0001-T01", status="todo", workplan_id=row.id)
+        stale_a = _TaskRow("DEMO-WP-0001-T09", status="done", workplan_id=row.id)
+        stale_b = _TaskRow("demo-wp-0001-t09", status="done", workplan_id=row.id)
+        session = _FakeSession(
+            repo=_Repo(), rows=[row], task_rows=[desired, stale_a, stale_b]
+        )
+        out = await fp.reset_repository_projection(
+            session,
+            "demo",
+            derived=self._derived(("DEMO-WP-0001-T01", "Do it", "todo")),
+        )
+        assert out.status in {"applied", "noop"}
+        assert out.refused == []
+
+    @pytest.mark.asyncio
+    async def test_derived_task_uuid_held_elsewhere_is_refused_before_insert(self):
+        row = _Row(slug="demo-wp-0001", status="active", path="workplans/a.md")
+        derived = self._derived(("DEMO-WP-0001-T01", "Do it", "todo"))
+        holder = _TaskRow("DEMO-WP-0001-T01", workplan_id=__import__("uuid").uuid4())
+        holder.id = __import__("uuid").UUID(derived.workplans[0].tasks[0].uuid)
+        session = _FakeSession(
+            repo=_Repo(),
+            rows=[row],
+            task_rows=[],
+            task_collision_rows=[holder],
+        )
+        out = await fp.reset_repository_projection(session, "demo", derived=derived)
+        assert out.status == "refused"
+        assert out.refused[0]["reason"].startswith("derived task identifier already belongs")
+        assert session.added == []
+
+    @pytest.mark.asyncio
+    async def test_tasks_on_retired_copy_do_not_block_current_projection(self):
+        from datetime import datetime, timezone
+
+        current = _Row(slug="demo-wp-0001", status="active", path="workplans/a.md")
+        current.id = __import__("uuid").UUID(fp.derived_record_uuid("DEMO-WP-0001"))
+        retired = _Row(
+            slug="demo-wp-0001@retired-20260831",
+            status="finished",
+            path="workplans/a.md",
+        )
+        retired.projection_retired_at = datetime.now(tz=timezone.utc)
+        task = _TaskRow("DEMO-WP-0001-T01", status="todo", workplan_id=current.id)
+        session = _FakeSession(repo=_Repo(), rows=[current, retired], task_rows=[task])
+        out = await fp.reset_repository_projection(
+            session,
+            "demo",
+            derived=self._derived(("DEMO-WP-0001-T01", "Do it", "todo")),
+        )
+        assert out.status in {"applied", "noop"}
+        assert out.refused == []
+
+
+def test_diff_reports_duplicate_current_task_identity_as_ambiguous():
+    derived = TestExistingWorkplanTasks()._derived(
+        ("DEMO-WP-0001-T01", "Do it", "todo")
+    )
+    workplan_id = derived.workplans[0].uuid
+    hub_workplans = [
+        {
+            "id": workplan_id,
+            "slug": "demo-wp-0001",
+            "status": "active",
+            "backing_relative_path": "workplans/a.md",
+        }
+    ]
+    hub_tasks = {
+        workplan_id: [
+            {
+                "id": "11111111-1111-4111-8111-111111111111",
+                "record_id": "DEMO-WP-0001-T01",
+                "title": "a",
+                "status": "todo",
+            },
+            {
+                "id": "22222222-2222-4222-8222-222222222222",
+                "record_id": "demo-wp-0001-t01",
+                "title": "b",
+                "status": "todo",
+            },
+        ]
+    }
+    diff = fp.diff_against_hub(derived, hub_workplans, hub_tasks)
+    assert diff.clean is False
+    assert diff.to_dict()["counts"]["ambiguous"] == 1
+    assert diff.ambiguous[0]["source"] == "hub"
+
+
+@pytest.mark.asyncio
+async def test_reset_refuses_duplicate_task_identity_in_forge_projection():
+    first = TestExistingWorkplanTasks()._derived(
+        ("SHARED-WP-0001-T01", "First", "todo")
+    ).workplans[0]
+    second = fp.DerivedWorkplan(
+        record_id="DEMO-WP-0002",
+        uuid=fp.derived_record_uuid("DEMO-WP-0002"),
+        title="Second",
+        status="active",
+        relative_path="workplans/b.md",
+        archived=False,
+        tasks=[
+            fp.DerivedTask(
+                record_id="SHARED-WP-0001-T01",
+                uuid=fp.derived_record_uuid("SHARED-WP-0001-T01"),
+                title="Second claim",
+                status="todo",
+                priority="medium",
+            )
+        ],
+    )
+    derived = fp.DerivedProjection(
+        repo_slug="demo", commit="c0ffee", workplans=[first, second]
+    )
+    session = _FakeSession(repo=_Repo(), rows=[])
+    out = await fp.reset_repository_projection(session, "demo", derived=derived)
+    assert out.status == "refused"
+    assert any(item.get("source") == "forge" for item in out.refused)
+    assert session.added == []
diff --git a/tests/test_instance_identity.py b/tests/test_instance_identity.py
new file mode 100644
index 0000000..6ed5b4e
--- /dev/null
+++ b/tests/test_instance_identity.py
@@ -0,0 +1,38 @@
+"""The instance-identity env vars must actually bind (CUST-WP-0067-T03).
+
+The chart sets STATE_HUB_INSTANCE_ROLE. pydantic-settings derives the env var
+from the *field name*, so a field called `instance_role` silently ignores it and
+the hub reports "unknown" while the ConfigMap says "primary" — config that is
+declared but never reaches what it configures, which is the entire failure this
+workplan exists to close.
+"""
+
+from __future__ import annotations
+
+import pytest
+
+from api.config import Settings
+
+
+@pytest.mark.parametrize(
+    "env_name,attr,value",
+    [
+        ("STATE_HUB_INSTANCE_ROLE", "state_hub_instance_role", "primary"),
+        ("STATE_HUB_INSTANCE_LABEL", "state_hub_instance_label", "railiance01"),
+    ],
+)
+def test_env_var_binds_to_setting(monkeypatch, env_name, attr, value):
+    monkeypatch.setenv(env_name, value)
+    assert getattr(Settings(), attr) == value
+
+
+def test_role_defaults_to_unknown(monkeypatch):
+    """An instance that has not declared itself is not the primary."""
+    monkeypatch.delenv("STATE_HUB_INSTANCE_ROLE", raising=False)
+    assert Settings().state_hub_instance_role == "unknown"
+
+
+def test_role_rejects_unknown_values(monkeypatch):
+    monkeypatch.setenv("STATE_HUB_INSTANCE_ROLE", "authoritative")
+    with pytest.raises(Exception):
+        Settings()
diff --git a/tests/test_intake.py b/tests/test_intake.py
new file mode 100644
index 0000000..ed69157
--- /dev/null
+++ b/tests/test_intake.py
@@ -0,0 +1,168 @@
+"""Tests for the `intake` work-record entity (CUST-WP-0061-T01, work-record
+stage 3). Real PostgreSQL test database, no mocking — matches
+tests/test_routers_core.py conventions.
+"""
+from __future__ import annotations
+
+import pytest
+
+
+async def _create_domain(client, slug="testdomain", name="Test Domain"):
+    r = await client.post("/domains/", json={"slug": slug, "name": name})
+    assert r.status_code == 201, r.text
+    return r.json()
+
+
+async def _create_topic(client, domain_slug="testdomain", slug="testtopic", title="Test Topic"):
+    r = await client.post("/topics/", json={
+        "slug": slug, "title": title, "domain": domain_slug,
+    })
+    assert r.status_code == 201, r.text
+    return r.json()
+
+
+async def _create_intake(client, topic_id=None, workplan_id=None, repo_id=None,
+                          title="Qonto MCP mailing", lane="green", **extra):
+    payload = {"title": title, "lane": lane, **extra}
+    if topic_id is not None:
+        payload["topic_id"] = topic_id
+    if workplan_id is not None:
+        payload["workplan_id"] = workplan_id
+    if repo_id is not None:
+        payload["repo_id"] = repo_id
+    r = await client.post("/intakes/", json=payload)
+    assert r.status_code == 201, r.text
+    return r.json()
+
+
+class TestIntakeCreateAndRead:
+    async def test_create_requires_a_scope(self, client):
+        r = await client.post("/intakes/", json={"title": "orphan intake", "lane": "green"})
+        assert r.status_code == 422
+
+    async def test_create_with_topic_scope(self, client):
+        await _create_domain(client)
+        topic = await _create_topic(client)
+        body = await _create_intake(client, topic_id=topic["id"])
+        assert body["status"] == "open"
+        assert body["lane"] == "green"
+        assert body["outcome"] is None
+
+    async def test_create_preserves_explicit_authoritative_id(self, client):
+        await _create_domain(client)
+        topic = await _create_topic(client)
+        expected = "11111111-1111-4111-8111-111111111111"
+        r = await client.post(
+            "/intakes/",
+            json={"id": expected, "title": "file intake", "topic_id": topic["id"]},
+        )
+        assert r.status_code == 201
+        assert r.json()["id"] == expected
+
+    async def test_get_unknown_intake_404s(self, client):
+        r = await client.get("/intakes/00000000-0000-0000-0000-000000000000")
+        assert r.status_code == 404
+
+    async def test_list_filters_by_topic(self, client):
+        await _create_domain(client)
+        topic = await _create_topic(client)
+        other_topic = await _create_topic(client, slug="other-topic", title="Other")
+        await _create_intake(client, topic_id=topic["id"], title="in scope")
+        await _create_intake(client, topic_id=other_topic["id"], title="out of scope")
+
+        r = await client.get("/intakes/", params={"topic_id": topic["id"]})
+        assert r.status_code == 200
+        titles = [i["title"] for i in r.json()]
+        assert titles == ["in scope"]
+
+
+class TestIntakeLifecycle:
+    async def test_route_moves_open_to_routed(self, client):
+        await _create_domain(client)
+        topic = await _create_topic(client)
+        intake = await _create_intake(client, topic_id=topic["id"])
+
+        r = await client.post(f"/intakes/{intake['id']}/route", json={"routed_note": "green lane, ready"})
+        assert r.status_code == 200
+        assert r.json()["status"] == "routed"
+        assert r.json()["routed_note"] == "green lane, ready"
+
+    async def test_route_from_closed_is_rejected(self, client):
+        await _create_domain(client)
+        topic = await _create_topic(client)
+        intake = await _create_intake(client, topic_id=topic["id"])
+        await client.post(f"/intakes/{intake['id']}/close", json={"outcome": "declined"})
+
+        r = await client.post(f"/intakes/{intake['id']}/route", json={})
+        assert r.status_code == 409
+
+    async def test_close_declined_does_not_require_promoted_to(self, client):
+        await _create_domain(client)
+        topic = await _create_topic(client)
+        intake = await _create_intake(client, topic_id=topic["id"])
+
+        r = await client.post(f"/intakes/{intake['id']}/close", json={"outcome": "declined"})
+        assert r.status_code == 200
+        body = r.json()
+        assert body["status"] == "closed"
+        assert body["outcome"] == "declined"
+        assert body["closed_at"] is not None
+
+    async def test_close_promoted_without_promoted_to_is_rejected(self, client):
+        await _create_domain(client)
+        topic = await _create_topic(client)
+        intake = await _create_intake(client, topic_id=topic["id"])
+
+        r = await client.post(f"/intakes/{intake['id']}/close", json={"outcome": "promoted"})
+        assert r.status_code == 422
+
+    async def test_close_promoted_with_promoted_to_succeeds(self, client):
+        await _create_domain(client)
+        topic = await _create_topic(client)
+        intake = await _create_intake(client, topic_id=topic["id"], title="AWQ-010")
+
+        r = await client.post(
+            f"/intakes/{intake['id']}/close",
+            json={"outcome": "promoted", "promoted_to": "BINKY-WP-0005"},
+        )
+        assert r.status_code == 200
+        body = r.json()
+        assert body["outcome"] == "promoted"
+        assert body["promoted_to"] == "BINKY-WP-0005"
+
+    async def test_close_already_closed_is_rejected(self, client):
+        await _create_domain(client)
+        topic = await _create_topic(client)
+        intake = await _create_intake(client, topic_id=topic["id"])
+        await client.post(f"/intakes/{intake['id']}/close", json={"outcome": "declined"})
+
+        r = await client.post(f"/intakes/{intake['id']}/close", json={"outcome": "absorbed"})
+        assert r.status_code == 409
+
+
+class TestIntakeNotes:
+    async def test_add_note_appears_on_intake(self, client):
+        await _create_domain(client)
+        topic = await _create_topic(client)
+        intake = await _create_intake(client, topic_id=topic["id"])
+
+        r = await client.post(
+            f"/intakes/{intake['id']}/notes",
+            json={"content": "vetted, looks real", "author": "agt-rhythm-bridge"},
+        )
+        assert r.status_code == 201
+        notes = r.json()["notes"]
+        assert len(notes) == 1
+        assert notes[0]["content"] == "vetted, looks real"
+        assert notes[0]["author"] == "agt-rhythm-bridge"
+
+
+class TestIntakeUUIDv7:
+    async def test_id_is_uuidv7(self, client):
+        await _create_domain(client)
+        topic = await _create_topic(client)
+        intake = await _create_intake(client, topic_id=topic["id"])
+
+        import uuid
+        u = uuid.UUID(intake["id"])
+        assert u.version == 7
diff --git a/tests/test_legacy_meter.py b/tests/test_legacy_meter.py
index a895a96..8d2a90b 100644
--- a/tests/test_legacy_meter.py
+++ b/tests/test_legacy_meter.py
@@ -486,3 +486,137 @@ class TestWorkplanAliasesAndLegacyMeter:
         assert items["rest_api:DELETE /workstreams/{workstream_id}/dependencies/{dep_id}"]["window"]["components"] == {
             "old-dep-archiver": 1
         }
+
+
+# --- retirement quiet-period ladder (STATE-WP-0079-T05) ---------------------
+#
+# A clean review window only proves silence for that window. For an interface
+# that carried heavy traffic, that is weak evidence: an infrequent caller can
+# fall outside the window entirely. The ladder requires silence proportional to
+# all-time volume before an interface becomes a retirement candidate.
+
+
+def _iface(**kw):
+    from types import SimpleNamespace
+
+    defaults = dict(
+        status="legacy",
+        manual_hold=False,
+        hold_reason=None,
+        replacement_ref="replacement",
+        replacement_verified=True,
+    )
+    defaults.update(kw)
+    return SimpleNamespace(**defaults)
+
+
+def test_required_quiet_days_scales_with_volume():
+    from api.services.legacy_meter import _required_quiet_days
+
+    assert _required_quiet_days(0) == 0
+    assert _required_quiet_days(1) == 7
+    assert _required_quiet_days(99) == 7
+    assert _required_quiet_days(100) == 30
+    assert _required_quiet_days(9_999) == 30
+    assert _required_quiet_days(10_000) == 60
+    assert _required_quiet_days(511_406) == 60
+
+
+def test_high_volume_interface_held_until_quiet_period_elapses():
+    """A six-figure interface quiet for 9 days is not yet retirable."""
+    from api.services.legacy_meter import _retirement_state
+
+    window_end = datetime(2026, 8, 20, tzinfo=timezone.utc)
+    candidate, reason = _retirement_state(
+        _iface(),
+        0,
+        all_time_calls=144_086,
+        last_seen_at=datetime(2026, 8, 11, tzinfo=timezone.utc),
+        window_end=window_end,
+    )
+    assert candidate is False
+    assert "9d of 60d required" in reason
+
+
+def test_high_volume_interface_retirable_once_quiet_long_enough():
+    from api.services.legacy_meter import _retirement_state
+
+    window_end = datetime(2026, 8, 20, tzinfo=timezone.utc)
+    candidate, reason = _retirement_state(
+        _iface(),
+        0,
+        all_time_calls=144_086,
+        last_seen_at=datetime(2026, 5, 1, tzinfo=timezone.utc),
+        window_end=window_end,
+    )
+    assert candidate is True
+    assert "60d required" in reason
+
+
+def test_low_volume_interface_uses_short_quiet_period():
+    from api.services.legacy_meter import _retirement_state
+
+    window_end = datetime(2026, 8, 20, tzinfo=timezone.utc)
+    candidate, _ = _retirement_state(
+        _iface(),
+        0,
+        all_time_calls=2,
+        last_seen_at=datetime(2026, 8, 12, tzinfo=timezone.utc),
+        window_end=window_end,
+    )
+    assert candidate is True
+
+
+def test_never_used_interface_needs_no_quiet_period():
+    from api.services.legacy_meter import _retirement_state
+
+    candidate, reason = _retirement_state(
+        _iface(),
+        0,
+        all_time_calls=0,
+        last_seen_at=None,
+        window_end=datetime(2026, 8, 20, tzinfo=timezone.utc),
+    )
+    assert candidate is True
+    assert reason == "no measured usage in review window"
+
+
+def test_in_window_traffic_still_wins_over_quiet_ladder():
+    """Traffic inside the window blocks retirement regardless of volume."""
+    from api.services.legacy_meter import _retirement_state
+
+    candidate, reason = _retirement_state(
+        _iface(),
+        3,
+        all_time_calls=5,
+        last_seen_at=datetime(2026, 8, 19, tzinfo=timezone.utc),
+        window_end=datetime(2026, 8, 20, tzinfo=timezone.utc),
+    )
+    assert candidate is False
+    assert "3 call(s) in review window" in reason
+
+
+def test_existing_guards_precede_quiet_ladder():
+    from api.services.legacy_meter import _retirement_state
+
+    window_end = datetime(2026, 8, 20, tzinfo=timezone.utc)
+    long_quiet = dict(
+        all_time_calls=1,
+        last_seen_at=datetime(2026, 1, 1, tzinfo=timezone.utc),
+        window_end=window_end,
+    )
+    assert _retirement_state(_iface(status="retired"), 0, **long_quiet) == (
+        False,
+        "already retired",
+    )
+    assert _retirement_state(
+        _iface(manual_hold=True, hold_reason="pinned"), 0, **long_quiet
+    ) == (False, "pinned")
+    assert _retirement_state(_iface(replacement_ref="  "), 0, **long_quiet) == (
+        False,
+        "missing replacement reference",
+    )
+    assert _retirement_state(_iface(replacement_verified=False), 0, **long_quiet) == (
+        False,
+        "replacement not verified",
+    )
diff --git a/tests/test_mcp_legacy_deprecation.py b/tests/test_mcp_legacy_deprecation.py
index 0beb709..bb7abc2 100644
--- a/tests/test_mcp_legacy_deprecation.py
+++ b/tests/test_mcp_legacy_deprecation.py
@@ -48,17 +48,30 @@ def _fake_get(path: str, params: dict | None = None):
     if path == "/repos":
         return [{"id": "repo-1", "slug": "demo-repo", "domain_slug": "infotech"}]
     if path == "/repo-goals":
-        return [{"id": "goal-1", "title": "Ship it", "description": "d", "priority": "high"}]
+        return [{
+            "id": "goal-1",
+            "repo_id": "repo-1",
+            "repo_slug": "demo-repo",
+            "title": "Ship it",
+            "description": "d",
+            "priority": "high",
+        }]
     if path == "/capability-catalog/":
         return []
     return []
 
 
 def test_get_domain_summary_goal_guidance_is_workplan_first(monkeypatch) -> None:
-    monkeypatch.setattr(server, "_get", lambda path, params=None: _fake_get(path, params))
+    calls = []
+    monkeypatch.setattr(
+        server,
+        "_get",
+        lambda path, params=None: calls.append((path, params)) or _fake_get(path, params),
+    )
     payload = json.loads(server.get_domain_summary("infotech"))
     assert "workplans" in payload
     assert payload["workstreams"] == payload["workplans"]
     action = payload["goal_guidance"]["needs_workplan"][0]["action"]
     assert "workplan" in action.lower()
-    assert "workstream is linked" not in action.lower()
\ No newline at end of file
+    assert "workstream is linked" not in action.lower()
+    assert [path for path, _ in calls].count("/repo-goals") == 1
diff --git a/tests/test_ops_run_projection.py b/tests/test_ops_run_projection.py
new file mode 100644
index 0000000..9ffa24a
--- /dev/null
+++ b/tests/test_ops_run_projection.py
@@ -0,0 +1,119 @@
+from datetime import datetime, timedelta, timezone
+
+import pytest
+
+from api.config import settings
+from api.services import ops_run_projection as projection
+
+
+@pytest.fixture(autouse=True)
+def reset_projection_cache() -> None:
+    projection.reset_ops_run_projection_cache()
+
+
+@pytest.mark.asyncio
+async def test_ops_run_projection_counts_and_contract(monkeypatch) -> None:
+    now = datetime.now(timezone.utc)
+    payload = {
+        "counts": {"open": 2, "claimed": 1, "succeeded": 9, "failed": 2},
+        "items": [
+            {
+                "id": "run-open",
+                "activity_definition_id": "definition-1",
+                "target_repo": "state-hub",
+                "state": "open",
+                "created_at": (now - timedelta(hours=2)).isoformat(),
+                "updated_at": (now - timedelta(hours=2)).isoformat(),
+                "result": {},
+            },
+            {
+                "id": "run-claimed",
+                "activity_definition_id": "definition-2",
+                "target_repo": "activity-core",
+                "state": "claimed",
+                "claim_owner": "rein-aharness@railiance01",
+                "lease_until": (now + timedelta(minutes=10)).isoformat(),
+                "attempt": 1,
+                "created_at": (now - timedelta(minutes=10)).isoformat(),
+                "updated_at": now.isoformat(),
+                "result": {},
+            },
+            {
+                "id": "run-failed",
+                "activity_definition_id": "definition-3",
+                "target_repo": "binky-control",
+                "state": "failed",
+                "created_at": (now - timedelta(hours=3)).isoformat(),
+                "updated_at": (now - timedelta(hours=1)).isoformat(),
+                "result": {"error": "executor timeout"},
+            },
+        ],
+    }
+
+    async def fake_fetch():
+        return payload
+
+    monkeypatch.setattr(projection, "_fetch_ops_runs", fake_fetch)
+    result = await projection.get_ops_run_projection(refresh=True)
+
+    assert result.available is True
+    assert result.open == 2
+    assert result.claimed == 1
+    assert result.failed_24h == 1
+    assert result.stuck_open_or_claimed == 1
+    assert {item.id for item in result.items} == {"run-open", "run-claimed", "run-failed"}
+    failed = next(item for item in result.items if item.id == "run-failed")
+    assert failed.last_error == "executor timeout"
+    claimed = next(item for item in result.items if item.id == "run-claimed")
+    assert claimed.lease["owner"] == "rein-aharness@railiance01"
+
+
+@pytest.mark.asyncio
+async def test_ops_run_projection_serves_stale_cache_on_refresh_failure(monkeypatch) -> None:
+    async def initial_fetch():
+        return {"counts": {"open": 1}, "items": []}
+
+    monkeypatch.setattr(projection, "_fetch_ops_runs", initial_fetch)
+    initial = await projection.get_ops_run_projection(refresh=True)
+    assert initial.available is True
+
+    async def failed_fetch():
+        raise RuntimeError("upstream down")
+
+    monkeypatch.setattr(projection, "_fetch_ops_runs", failed_fetch)
+    stale = await projection.get_ops_run_projection(refresh=True)
+    assert stale.available is True
+    assert stale.stale is True
+    assert "upstream down" in stale.error
+
+
+@pytest.mark.asyncio
+async def test_ops_run_projection_reports_unconfigured(monkeypatch) -> None:
+    monkeypatch.setattr(settings, "activity_core_url", None)
+    result = await projection.get_ops_run_projection(refresh=True)
+    assert result.available is False
+    assert "ACTIVITY_CORE_URL is not configured" in result.error
+
+
+@pytest.mark.asyncio
+async def test_ops_runs_summary_route(client, monkeypatch) -> None:
+    async def fake_fetch():
+        return {"counts": {"open": 3, "claimed": 2}, "items": []}
+
+    monkeypatch.setattr(projection, "_fetch_ops_runs", fake_fetch)
+    response = await client.get("/ops-runs/summary", params={"refresh": "true"})
+    assert response.status_code == 200
+    assert response.json()["open"] == 3
+    assert response.json()["claimed"] == 2
+    assert (await client.post("/ops-runs/claim", json={})).status_code == 404
+
+
+@pytest.mark.asyncio
+async def test_state_summary_contains_ops_run_projection(client, monkeypatch) -> None:
+    async def fake_fetch():
+        return {"counts": {"open": 4}, "items": []}
+
+    monkeypatch.setattr(projection, "_fetch_ops_runs", fake_fetch)
+    response = await client.get("/state/summary", params={"refresh": "true"})
+    assert response.status_code == 200
+    assert response.json()["ops_runs"]["open"] == 4
diff --git a/tests/test_preflight_signing_rotation.py b/tests/test_preflight_signing_rotation.py
new file mode 100644
index 0000000..ae0e3d6
--- /dev/null
+++ b/tests/test_preflight_signing_rotation.py
@@ -0,0 +1,38 @@
+"""Single-key invalidation guarantees needed by the platform rotation fence."""
+from datetime import datetime, timedelta, timezone
+
+import pytest
+
+from api.config import settings
+from api.services.repository_rename import (
+    RenamePreconditionFailed, RenameServiceUnavailable,
+    _sign_preflight, _verify_preflight_token,
+)
+
+
+def test_rotation_invalidates_predecessor_and_accepts_successor(monkeypatch):
+    payload = {'expires_at': (datetime.now(timezone.utc) + timedelta(minutes=15)).isoformat()}
+    monkeypatch.setattr(settings, 'repository_rename_preflight_secret', 'fixture-old-key')
+    predecessor = _sign_preflight(payload)
+    assert _verify_preflight_token(predecessor) == payload
+    monkeypatch.setattr(settings, 'repository_rename_preflight_secret', 'fixture-new-key')
+    with pytest.raises(RenamePreconditionFailed):
+        _verify_preflight_token(predecessor)
+    assert _verify_preflight_token(_sign_preflight(payload)) == payload
+
+
+def test_tamper_expiry_and_no_key_fail_closed(monkeypatch):
+    monkeypatch.setattr(settings, 'repository_rename_preflight_secret', 'fixture-key')
+    future = {'expires_at': (datetime.now(timezone.utc) + timedelta(minutes=15)).isoformat()}
+    token = _sign_preflight(future)
+    encoded, signature = token.split('.')
+    with pytest.raises(RenamePreconditionFailed):
+        _verify_preflight_token(encoded + '.' + ('A' if signature[0] != 'A' else 'B') + signature[1:])
+    past = {'expires_at': (datetime.now(timezone.utc) - timedelta(seconds=1)).isoformat()}
+    with pytest.raises(RenamePreconditionFailed, match='expired'):
+        _verify_preflight_token(_sign_preflight(past))
+    monkeypatch.setattr(settings, 'repository_rename_preflight_secret', None)
+    with pytest.raises(RenameServiceUnavailable):
+        _sign_preflight(future)
+    with pytest.raises(RenameServiceUnavailable):
+        _verify_preflight_token(token)
diff --git a/tests/test_promote_intake.py b/tests/test_promote_intake.py
new file mode 100644
index 0000000..59fe2f1
--- /dev/null
+++ b/tests/test_promote_intake.py
@@ -0,0 +1,238 @@
+"""Tests for the promotion transition (CUST-WP-0061-T03,
+scripts/promote_intake.py): intake.routed -> workplan | task | decision |
+engagement.
+
+Pure file-manipulation logic (_slugify, _next_number, _append_yaml_block,
+_inject_field_in_frontmatter) is tested offline. The full promote_intake()
+flow is tested with the hub API layer mocked (monkeypatched _api_get/
+_api_post) so these run without a live server; the real end-to-end proof
+(actual DB writes) is documented in CUST-WP-0061's progress notes, mirroring
+the live-verification discipline used for T01/T02.
+"""
+from __future__ import annotations
+
+import sys
+from pathlib import Path
+
+import pytest
+
+sys.path.insert(0, str(Path(__file__).parent.parent / "scripts"))
+
+import promote_intake as pi  # noqa: E402
+
+
+class TestSlugify:
+    def test_lowercases_and_hyphenates(self):
+        assert pi._slugify("Qonto MCP integration: bank account") == "qonto-mcp-integration-bank-account"
+
+    def test_truncates_long_titles(self):
+        long_title = "a " * 100
+        assert len(pi._slugify(long_title)) <= 60
+
+    def test_empty_title_gets_placeholder(self):
+        assert pi._slugify("!!!") == "untitled"
+
+
+class TestNextNumber:
+    def test_finds_max_and_increments(self, tmp_path):
+        (tmp_path / "a.md").write_text("id: CUST-WP-0005\nid: CUST-WP-0012\n")
+        (tmp_path / "b.md").write_text("id: CUST-WP-0003\n")
+        import re
+        n = pi._next_number(tmp_path, re.compile(r"CUST-WP-(\d+)"))
+        assert n == 13
+
+    def test_empty_repo_starts_at_one(self, tmp_path):
+        import re
+        n = pi._next_number(tmp_path, re.compile(r"CUST-WP-(\d+)"))
+        assert n == 1
+
+    def test_skips_skip_dirs(self, tmp_path):
+        import re
+        skipped = tmp_path / ".git"
+        skipped.mkdir()
+        (skipped / "a.md").write_text("id: CUST-WP-9999\n")
+        n = pi._next_number(tmp_path, re.compile(r"CUST-WP-(\d+)"))
+        assert n == 1
+
+
+class TestAppendYamlBlock:
+    def test_creates_new_file(self, tmp_path):
+        target = tmp_path / "DecisionQueue.md"
+        pi._append_yaml_block(target, {"id": "X-DEC-2026-001", "title": "test"}, origin_intake_id="abc-123")
+        text = target.read_text()
+        assert "id: \"X-DEC-2026-001\"" in text
+        assert 'origin: "intake:abc-123"' in text
+
+    def test_appends_to_existing_file(self, tmp_path):
+        target = tmp_path / "DecisionQueue.md"
+        target.write_text("# Decision Queue\n\nSome existing content.\n")
+        pi._append_yaml_block(target, {"id": "X-DEC-2026-002", "title": "second"}, origin_intake_id="def-456")
+        text = target.read_text()
+        assert "Some existing content." in text
+        assert "X-DEC-2026-002" in text
+
+
+class TestInjectFieldInFrontmatter:
+    def test_injects_field_into_frontmatter(self, tmp_path):
+        f = tmp_path / "wp.md"
+        f.write_text("---\nid: CUST-WP-0099\ntitle: x\n---\n\nBody.\n")
+        pi._inject_field_in_frontmatter(f, "state_hub_workstream_id", "019f0000-0000-7000-8000-000000000000")
+        text = f.read_text()
+        assert 'state_hub_workstream_id: "019f0000-0000-7000-8000-000000000000"' in text
+        assert "Body." in text
+
+
+class TestPromoteIntakeMocked:
+    """Full promote_intake() flow with the hub API mocked."""
+
+    def _fake_routed_intake(self, **overrides):
+        base = {
+            "id": "019f0000-0000-7000-8000-000000000001",
+            "title": "Qonto MCP mailing — actionable",
+            "status": "routed",
+            "lane": "green",
+            "description": "found in mail triage",
+        }
+        base.update(overrides)
+        return base
+
+    def test_rejects_intake_not_routed(self, tmp_path, monkeypatch):
+        monkeypatch.setattr(pi, "_api_get", lambda *a, **k: self._fake_routed_intake(status="open"))
+        with pytest.raises(pi.PromotionError, match="not 'routed'"):
+            pi.promote_intake("http://x", "019f0000", "workplan", tmp_path, "testrepo", "infotech")
+
+    def test_promote_to_workplan_writes_file_and_closes_intake(self, tmp_path, monkeypatch):
+        calls = []
+
+        def fake_get(api_base, path, *a, **k):
+            if path.startswith("/intakes/"):
+                return self._fake_routed_intake()
+            if path == "/topics":
+                return [{"id": "019ftopic", "domain_slug": "infotech"}]
+            if path == "/repos/testrepo":
+                return {"id": "019frepo", "slug": "testrepo"}
+            return None
+
+        def fake_post(api_base, path, body):
+            calls.append((path, body))
+            if path == "/workplans":
+                return {"id": "019fworkplan", "title": body["title"]}
+            if path.startswith("/intakes/") and path.endswith("/close"):
+                return {"id": "019f0000", "status": "closed", "outcome": "promoted"}
+            return {"id": "019fgeneric"}
+
+        monkeypatch.setattr(pi, "_api_get", fake_get)
+        monkeypatch.setattr(pi, "_api_post", fake_post)
+
+        result = pi.promote_intake(
+            "http://x", "019f0000-0000-7000-8000-000000000001", "workplan",
+            tmp_path, "testrepo", "infotech",
+        )
+
+        assert result["to_kind"] == "workplan"
+        new_file = tmp_path / result["location"]
+        assert new_file.is_file()
+        text = new_file.read_text()
+        assert "Qonto MCP mailing" in text
+        assert 'state_hub_workstream_id: "019fworkplan"' in text
+        assert "intake:019f0000-0000-7000-8000-000000000001" in text
+
+        close_calls = [c for c in calls if c[0].endswith("/close")]
+        assert len(close_calls) == 1
+        assert close_calls[0][1]["outcome"] == "promoted"
+        assert close_calls[0][1]["promoted_to"] == result["canonical_id"]
+
+    def test_promote_to_workplan_raises_loudly_when_repo_lookup_fails(self, tmp_path, monkeypatch):
+        """Regression: the live proof against binky-control (2026-07-21) found
+        /workplans/ requires repo_id, which promote_to_workplan originally
+        never resolved -- the POST 422'd and the failure was silently
+        swallowed (file written, no state_hub_workstream_id, no error).
+        Must raise, not write a half-registered file silently."""
+        def fake_get(api_base, path, *a, **k):
+            if path.startswith("/intakes/"):
+                return self._fake_routed_intake()
+            if path == "/topics":
+                return [{"id": "019ftopic", "domain_slug": "infotech"}]
+            if path == "/repos/testrepo":
+                return {"_error": "404: not found"}
+            return None
+
+        monkeypatch.setattr(pi, "_api_get", fake_get)
+        monkeypatch.setattr(pi, "_api_post", lambda *a, **k: {"id": "x"})
+
+        with pytest.raises(pi.PromotionError, match="could not look up repo"):
+            pi.promote_intake("http://x", "019f0000", "workplan", tmp_path, "testrepo", "infotech")
+
+    def test_promote_to_workplan_raises_loudly_when_workstream_post_fails(self, tmp_path, monkeypatch):
+        def fake_get(api_base, path, *a, **k):
+            if path.startswith("/intakes/"):
+                return self._fake_routed_intake()
+            if path == "/topics":
+                return [{"id": "019ftopic", "domain_slug": "infotech"}]
+            if path == "/repos/testrepo":
+                return {"id": "019frepo"}
+            return None
+
+        def fake_post(api_base, path, body):
+            if path == "/workplans":
+                return {"_error": "422: repo_id required"}
+            return {"id": "x"}
+
+        monkeypatch.setattr(pi, "_api_get", fake_get)
+        monkeypatch.setattr(pi, "_api_post", fake_post)
+
+        with pytest.raises(pi.PromotionError, match="workstream registration failed"):
+            pi.promote_intake("http://x", "019f0000", "workplan", tmp_path, "testrepo", "infotech")
+
+    def test_promote_to_workplan_refuses_existing_file(self, tmp_path, monkeypatch):
+        monkeypatch.setattr(pi, "_api_get", lambda *a, **k: self._fake_routed_intake())
+        wp_dir = tmp_path / "workplans"
+        wp_dir.mkdir()
+        # pre-create the file the promotion would try to write
+        prefix = pi.infer_wp_prefix(tmp_path, "testrepo")
+        (wp_dir / f"{prefix}-0001-qonto-mcp-mailing-actionable.md").write_text("already here")
+
+        def fake_post(api_base, path, body):
+            return {"id": "x"}
+
+        monkeypatch.setattr(pi, "_api_post", fake_post)
+        with pytest.raises(pi.PromotionError, match="already exists"):
+            pi.promote_intake("http://x", "019f0000", "workplan", tmp_path, "testrepo", "infotech")
+
+    def test_promote_to_decision_requires_target_file(self, tmp_path, monkeypatch):
+        monkeypatch.setattr(pi, "_api_get", lambda *a, **k: self._fake_routed_intake())
+        with pytest.raises(pi.PromotionError, match="--target-file"):
+            pi.promote_intake("http://x", "019f0000", "decision", tmp_path, "testrepo", "infotech")
+
+    def test_promote_to_task_requires_workplan_file(self, tmp_path, monkeypatch):
+        monkeypatch.setattr(pi, "_api_get", lambda *a, **k: self._fake_routed_intake())
+        with pytest.raises(pi.PromotionError, match="--workplan-file"):
+            pi.promote_intake("http://x", "019f0000", "task", tmp_path, "testrepo", "infotech")
+
+    def test_promote_to_engagement_is_file_only_no_hub_call(self, tmp_path, monkeypatch):
+        post_calls = []
+
+        def fake_get(api_base, path, *a, **k):
+            return self._fake_routed_intake()
+
+        def fake_post(api_base, path, body):
+            post_calls.append(path)
+            if path.startswith("/intakes/") and path.endswith("/close"):
+                return {"id": "x", "status": "closed"}
+            return {"id": "x"}
+
+        monkeypatch.setattr(pi, "_api_get", fake_get)
+        monkeypatch.setattr(pi, "_api_post", fake_post)
+
+        result = pi.promote_intake(
+            "http://x", "019f0000", "engagement", tmp_path, "testrepo", "infotech",
+            target_file="OfficeHourQueue.md",
+        )
+        assert result["to_kind"] == "engagement"
+        target = tmp_path / "OfficeHourQueue.md"
+        assert target.is_file()
+        assert "queued" in target.read_text()
+        # only the intake-close call should have hit the API — no
+        # engagement-creation endpoint exists yet
+        non_close_calls = [c for c in post_calls if not c.endswith("/close")]
+        assert non_close_calls == []
diff --git a/tests/test_quality_assessment.py b/tests/test_quality_assessment.py
new file mode 100644
index 0000000..2a1fb50
--- /dev/null
+++ b/tests/test_quality_assessment.py
@@ -0,0 +1,73 @@
+"""Unit tests for DoX quality assessment helpers (STATE-WP-0077)."""
+from __future__ import annotations
+
+import sys
+from pathlib import Path
+
+sys.path.insert(0, str(Path(__file__).resolve().parents[1] / "scripts"))
+
+from quality_assessment import (  # noqa: E402
+    assessment_from_mapping,
+    badge,
+    debt_for_intake_meta,
+    debt_for_workplan_meta,
+    intake_has_doc_ok,
+    is_ok,
+    progress_event_body,
+)
+
+
+def test_badge_ok_failed():
+    assert badge("DoR", "Ok") == "DoR-Ok"
+    assert badge("DoC", "Failed") == "DoC-Failed"
+    assert badge("DoD", "DoD-Ok") == "DoD-Ok"
+
+
+def test_assessment_from_mapping():
+    assert assessment_from_mapping({"quality_dor": "DoR-Ok"}, "DoR") == "DoR-Ok"
+    assert assessment_from_mapping({"quality_dor": "Ok"}, "DoR") == "DoR-Ok"
+    assert assessment_from_mapping({}, "DoR") is None
+    assert is_ok(assessment_from_mapping({"quality_dod": "Failed"}, "DoD")) is False
+
+
+def test_debt_ready_without_dor():
+    items = debt_for_workplan_meta(
+        {"id": "STATE-WP-0001", "status": "ready"},
+        path="workplans/x.md",
+    )
+    assert len(items) == 1
+    assert items[0].missing == "DoR-Ok"
+
+
+def test_debt_finished_without_dod():
+    items = debt_for_workplan_meta(
+        {"id": "STATE-WP-0001", "status": "finished", "quality_dod": "DoD-Ok"},
+        path="workplans/x.md",
+    )
+    assert items == []
+
+
+def test_debt_intake_routed():
+    items = debt_for_intake_meta(
+        {"id": "CUST-IN-0001", "status": "routed"},
+        path="notes.md",
+    )
+    assert len(items) == 1
+    assert items[0].missing == "DoC-Ok"
+
+
+def test_intake_has_doc_ok_from_note():
+    assert intake_has_doc_ok({"notes": [{"content": "Assessed DoC-Ok today"}]})
+    assert not intake_has_doc_ok({"notes": [{"content": "still open"}]})
+
+
+def test_progress_event_body():
+    body = progress_event_body(
+        policy="DoR",
+        outcome="Ok",
+        record_kind="workplan",
+        record_id="STATE-WP-0077",
+        assessed_by="grok",
+    )
+    assert body["event_type"] == "quality_assessment"
+    assert body["detail"]["badge"] == "DoR-Ok"
diff --git a/tests/test_register_from_classification.py b/tests/test_register_from_classification.py
index 9b7a6ac..65302d7 100644
--- a/tests/test_register_from_classification.py
+++ b/tests/test_register_from_classification.py
@@ -8,6 +8,8 @@ from pathlib import Path
 
 import pytest
 
+from api.classification import ClassificationData
+
 REPO_ROOT = Path(__file__).resolve().parent.parent
 SCRIPT = REPO_ROOT / "scripts" / "register_from_classification.py"
 
@@ -68,4 +70,58 @@ def test_json_report_shape():
     assert payload["summary"]["invalid"] == 0
     assert "summary" in payload
     assert "results" in payload
-    assert set(payload["summary"]) == {"registered", "updated", "skipped", "invalid"}
\ No newline at end of file
+    assert set(payload["summary"]) == {"registered", "updated", "skipped", "invalid"}
+
+
+def test_git_fingerprint_uses_one_root(monkeypatch, tmp_path):
+    from scripts import register_from_classification as registration
+
+    first = "a" * 40
+    second = "b" * 40
+    monkeypatch.setattr(
+        registration,
+        "_git_value",
+        lambda _path, _args: f"{first}\n{second}",
+    )
+
+    assert registration._git_fingerprint(tmp_path) == first
+
+
+@pytest.mark.asyncio
+async def test_api_update_separates_classification_from_identity(monkeypatch, tmp_path):
+    from scripts import register_from_classification as registration
+
+    calls = []
+
+    def fake_api_request(method, path, *, api_base, body=None):
+        calls.append((method, path, body))
+        if method == "GET":
+            return 200, {"slug": "example"}
+        return 200, {"slug": "example"}
+
+    monkeypatch.setattr(registration, "_api_request", fake_api_request)
+    monkeypatch.setattr(registration, "_git_root", lambda path: path)
+    monkeypatch.setattr(registration, "_git_value", lambda _path, _args: "origin")
+    monkeypatch.setattr(registration, "_git_fingerprint", lambda _path: "a" * 40)
+    report = registration.RegistrationReport()
+    data = ClassificationData(
+        category="infrastructure",
+        domain="infotech",
+        capability_tags=["infrastructure.state"],
+    )
+
+    await registration._upsert_via_api(
+        slug="example",
+        repo_path=tmp_path,
+        data=data,
+        dry_run=False,
+        api_base="http://state-hub.test",
+        report=report,
+    )
+
+    patch = next(call for call in calls if call[:2] == ("PATCH", "/repos/example"))
+    assert patch[2]["domain_slug"] == "infotech"
+    assert "local_path" not in patch[2]
+    assert "remote_url" not in patch[2]
+    assert "git_fingerprint" not in patch[2]
+    assert ("POST", "/repos/example/paths") in [call[:2] for call in calls]
diff --git a/tests/test_release_headroom_preflight.py b/tests/test_release_headroom_preflight.py
new file mode 100644
index 0000000..db09bf9
--- /dev/null
+++ b/tests/test_release_headroom_preflight.py
@@ -0,0 +1,66 @@
+from __future__ import annotations
+
+import json
+from pathlib import Path
+
+from scripts.release_headroom_preflight import evaluate, main, pod_effective_requests
+
+FIXTURES = Path(__file__).parent / "fixtures" / "release_headroom"
+
+
+def _load(name: str) -> dict:
+    return json.loads((FIXTURES / name).read_text())
+
+
+def test_revision_61_65m_refuses_api_surge() -> None:
+    report = evaluate(_load("rev61-65m.json"))
+    assert report["ok"] is False
+    assert report["remaining_cpu_m"] == 65
+    assert any("65m remaining" in r or "needs 100m" in r for r in report["reasons"])
+    assert "not a kube-scheduler guarantee" in " ".join(report["notes"]).lower() or any(
+        "guarantee" in n.lower() for n in report["notes"]
+    )
+
+
+def test_revision_63_105m_is_narrowly_sufficient() -> None:
+    report = evaluate(_load("rev63-105m.json"))
+    assert report["ok"] is True
+    assert report["remaining_cpu_m"] == 105
+    assert report["reasons"] == []
+    assert any("105m" in n or "Not factory" in n for n in report["notes"])
+
+
+def test_unrelated_pending_demand_refuses_105m() -> None:
+    report = evaluate(_load("rev63-105m-concurrent-pending.json"))
+    assert report["ok"] is False
+    assert any("unrelated pending" in r for r in report["reasons"])
+
+
+def test_stale_observation_refuses() -> None:
+    observation = _load("rev63-105m.json")
+    observation["freshness_seconds"] = 3600
+    report = evaluate(observation)
+    assert report["ok"] is False
+    assert any("old" in r for r in report["reasons"])
+
+
+def test_non_atomic_refuses() -> None:
+    report = evaluate(_load("rev63-105m.json"), {"atomic": False})
+    assert report["ok"] is False
+    assert any("atomic" in r for r in report["reasons"])
+
+
+def test_init_overhead_uses_max_not_sum() -> None:
+    pod = {
+        "spec": {
+            "initContainers": [{"resources": {"requests": {"cpu": "80m", "memory": "64Mi"}}}],
+            "containers": [{"resources": {"requests": {"cpu": "100m", "memory": "512Mi"}}}],
+        }
+    }
+    cpu, _mem = pod_effective_requests(pod)
+    assert cpu == 100
+
+
+def test_cli_fixture_exit_codes() -> None:
+    assert main(["--fixture", str(FIXTURES / "rev63-105m.json")]) == 0
+    assert main(["--fixture", str(FIXTURES / "rev61-65m.json")]) == 1
diff --git a/tests/test_repo_manager_workplan_adapter.py b/tests/test_repo_manager_workplan_adapter.py
new file mode 100644
index 0000000..3eb7cb4
--- /dev/null
+++ b/tests/test_repo_manager_workplan_adapter.py
@@ -0,0 +1,115 @@
+"""Compatibility adapter coverage for RMGR-WP-0008-T01."""
+
+from api.services import repo_manager_dual_run as adapter
+
+
+def test_rm_update_workplan_builds_governed_cli_command(monkeypatch):
+    seen = {}
+
+    def fake_run(args, *, timeout=120):
+        seen["args"] = args
+        return 0, '{"status":"applied","evidence":{"git_sha":"abc"}}', ""
+
+    monkeypatch.setattr(adapter, "run_rmgr", fake_run)
+    result = adapter.rm_update_workplan(
+        repo_path="/repos/demo",
+        workplan_id="DEMO-WP-0001",
+        operation="update",
+        title="Renamed",
+        status="active",
+        repo_slug="demo",
+        correlation_id="00000000-0000-4000-8000-000000000001",
+        push=True,
+    )
+
+    assert result["status"] == "applied"
+    assert seen["args"][:5] == [
+        "workplan",
+        "update",
+        "--path",
+        "/repos/demo",
+        "--workplan-id",
+    ]
+    assert "--title" in seen["args"]
+    assert "--status" in seen["args"]
+    assert "--push" in seen["args"]
+
+
+def test_rm_update_workplan_maps_delete_to_confirmed_archive(monkeypatch):
+    seen = {}
+
+    def fake_run(args, *, timeout=120):
+        seen["args"] = args
+        return 0, '{"status":"applied"}', ""
+
+    monkeypatch.setattr(adapter, "run_rmgr", fake_run)
+    result = adapter.rm_update_workplan(
+        repo_path="/repos/demo",
+        workplan_id="DEMO-WP-0001",
+        operation="archive",
+        confirm_archive=True,
+        push=False,
+    )
+
+    assert result["status"] == "applied"
+    assert seen["args"][0:2] == ["workplan", "delete"]
+    assert "--confirm" in seen["args"]
+    assert "--push" not in seen["args"]
+
+
+def test_rm_update_workplan_rejects_unknown_operation_without_invocation(monkeypatch):
+    def fail_run(*args, **kwargs):
+        raise AssertionError("rmgr must not run")
+
+    monkeypatch.setattr(adapter, "run_rmgr", fail_run)
+    result = adapter.rm_update_workplan(
+        repo_path="/repos/demo",
+        workplan_id="DEMO-WP-0001",
+        operation="erase",
+    )
+    assert result["status"] == "rejected"
+    assert result["error"]["code"] == "validation_error"
+
+
+def test_rm_update_register_entry_builds_shared_spine_command(monkeypatch):
+    seen = {}
+
+    def fake_run(args, *, timeout=120):
+        seen["args"] = args
+        return 0, '{"status":"applied"}', ""
+
+    monkeypatch.setattr(adapter, "run_rmgr", fake_run)
+    result = adapter.rm_update_register_entry(
+        repo_path="/repos/demo",
+        kind="technical-debt",
+        entry_id="TD-001",
+        operation="put",
+        title="Debt",
+        data={"severity": "high"},
+        push=False,
+    )
+
+    assert result["status"] == "applied"
+    assert seen["args"][0:2] == ["register", "put"]
+    assert "technical-debt" in seen["args"]
+    assert '{"severity":"high"}' in seen["args"]
+
+
+def test_rm_scan_sbom_builds_derived_snapshot_command(monkeypatch):
+    seen = {}
+
+    def fake_run(args, *, timeout=120):
+        seen["args"] = args
+        return (
+            0,
+            '{"schema":"repo-manager.sbom-snapshot.v1","ok":true,"entry_count":3}',
+            "",
+        )
+
+    monkeypatch.setattr(adapter, "run_rmgr", fake_run)
+    result = adapter.rm_scan_sbom(repo_path="/repos/demo", repo_slug="demo")
+
+    assert result["ok"] is True
+    assert result["schema"] == "repo-manager.sbom-snapshot.v1"
+    assert result["exit_code"] == 0
+    assert seen["args"] == ["sbom", "scan", "--path", "/repos/demo", "--slug", "demo"]
diff --git a/tests/test_repository_alias_routing.py b/tests/test_repository_alias_routing.py
new file mode 100644
index 0000000..800c6ed
--- /dev/null
+++ b/tests/test_repository_alias_routing.py
@@ -0,0 +1,292 @@
+from __future__ import annotations
+
+from datetime import datetime, timezone
+
+import pytest
+from sqlalchemy import func, select
+from sqlalchemy.ext.asyncio import AsyncSession, async_sessionmaker
+
+from api.models.agent_message import AgentMessage
+from api.models.fabric_graph import FabricGraphImport, FabricGraphNode
+from api.models.interface_change import InterfaceChange
+from api.models.managed_repo import ManagedRepo
+from api.models.repository_rename import RepositorySlug
+from tests.conftest import (
+    create_test_domain,
+    create_test_repo,
+    create_test_workplan,
+)
+
+
+async def _rename_in_state_hub(test_engine, repo_id: str) -> None:
+    factory = async_sessionmaker(test_engine, class_=AsyncSession, expire_on_commit=False)
+    async with factory() as session:
+        repo = await session.get(ManagedRepo, repo_id)
+        old = (
+            await session.execute(
+                select(RepositorySlug).where(RepositorySlug.slug == "flex-auth")
+            )
+        ).scalar_one()
+        old.kind = "alias"
+        old.protected = True
+        repo.slug = "access-engine"
+        repo.name = "Access Engine"
+        session.add(
+            RepositorySlug(
+                repo_id=repo.id,
+                slug="access-engine",
+                kind="canonical",
+                protected=True,
+            )
+        )
+        await session.commit()
+
+
+@pytest.mark.asyncio
+async def test_alias_lookup_dispatch_bindings_and_external_staleness(
+    client, test_engine
+):
+    domain = await create_test_domain(client)
+    repo = await create_test_repo(client, domain_slug=domain["slug"], slug="flex-auth")
+    workplan = await create_test_workplan(
+        client,
+        repo_id=repo["id"],
+        slug="FLEX-WP-0001",
+        title="Security stack migration",
+    )
+    task = await client.post(
+        "/tasks/",
+        json={
+            "workplan_id": workplan["id"],
+            "title": "Preserve identity",
+            "status": "todo",
+            "priority": "high",
+        },
+    )
+    assert task.status_code == 201, task.text
+
+    await _rename_in_state_hub(test_engine, repo["id"])
+    factory = async_sessionmaker(test_engine, class_=AsyncSession, expire_on_commit=False)
+    async with factory() as session:
+        change = InterfaceChange(
+            repo_id=repo["id"],
+            interface_type="rest_api",
+            change_type="breaking",
+            title="Historical consumer notice",
+            description="Recorded before cutover",
+            affected_paths=["/authorize"],
+            affected_repo_slugs=["flex-auth"],
+            status="published",
+            published_at=datetime.now(timezone.utc),
+            author="pytest",
+        )
+        import_run = FabricGraphImport(
+            source_repo_slug="railiance-fabric",
+            content_hash="a" * 64,
+            graph_json={},
+            validation_status="valid",
+            is_latest=True,
+        )
+        session.add_all([change, import_run])
+        await session.flush()
+        session.add(
+            FabricGraphNode(
+                import_id=import_run.id,
+                source_repo_slug="railiance-fabric",
+                graph_id="repo:flex-auth",
+                kind="repository",
+                name="Flex Auth",
+                repo_slug="flex-auth",
+                domain_slug="infotech",
+                lifecycle="active",
+            )
+        )
+        await session.commit()
+
+    old_lookup = await client.get("/repos/flex-auth")
+    new_lookup = await client.get("/repos/access-engine")
+    assert old_lookup.status_code == new_lookup.status_code == 200
+    assert old_lookup.json()["id"] == new_lookup.json()["id"] == repo["id"]
+    assert old_lookup.json()["requested_slug"] == "flex-auth"
+    assert old_lookup.json()["canonical_slug"] == "access-engine"
+    assert old_lookup.json()["slug_status"] == "alias"
+    assert old_lookup.json()["aliases"] == ["flex-auth"]
+    assert new_lookup.json()["slug_status"] == "canonical"
+    assert old_lookup.json()["stale_external_references"] == [
+        {
+            "owner": "railiance-fabric",
+            "surface": "fabric_graph_nodes",
+            "field": "repo_slug",
+            "value": "flex-auth",
+            "count": 1,
+            "status": "stale",
+            "handoff": "owner update or re-ingest required",
+        }
+    ]
+
+    dispatch = await client.get("/repos/access-engine/dispatch")
+    assert dispatch.status_code == 200, dispatch.text
+    assert dispatch.json()["repo_slug"] == "access-engine"
+    assert dispatch.json()["pending_interface_changes"][0]["title"] == change.title
+
+    bound = await client.get(f"/workplans/{workplan['id']}")
+    assert bound.status_code == 200
+    assert bound.json()["id"] == workplan["id"]
+    assert bound.json()["repo_id"] == repo["id"]
+    bound_task = await client.get(f"/tasks/{task.json()['id']}")
+    assert bound_task.status_code == 200
+    assert bound_task.json()["id"] == task.json()["id"]
+
+
+@pytest.mark.asyncio
+async def test_message_history_is_immutable_and_old_slug_write_replays_once(
+    client, test_engine
+):
+    domain = await create_test_domain(client)
+    repo = await create_test_repo(client, domain_slug=domain["slug"], slug="flex-auth")
+    await _rename_in_state_hub(test_engine, repo["id"])
+    factory = async_sessionmaker(test_engine, class_=AsyncSession, expire_on_commit=False)
+    async with factory() as session:
+        historical = AgentMessage(
+            from_agent="security-review",
+            to_agent="flex-auth",
+            subject="Before cutover",
+            body="Historical recipient must not be rewritten",
+        )
+        session.add(historical)
+        await session.commit()
+        historical_id = historical.id
+
+    history = await client.get("/messages/", params={"to_agent": "access-engine"})
+    assert history.status_code == 200
+    assert [item["id"] for item in history.json()] == [str(historical_id)]
+    assert history.json()[0]["to_agent"] == "flex-auth"
+
+    payload = {
+        "from_agent": "flex-auth",
+        "to_agent": "flex-auth",
+        "subject": "Queued during cutover",
+        "body": "Replay exactly once",
+    }
+    headers = {"Idempotency-Key": "repo-rename-old-slug-message"}
+    first = await client.post("/messages/", json=payload, headers=headers)
+    replay = await client.post("/messages/", json=payload, headers=headers)
+    assert first.status_code == replay.status_code == 201
+    assert first.json()["id"] == replay.json()["id"]
+    assert first.json()["from_agent"] == "access-engine"
+    assert first.json()["to_agent"] == "access-engine"
+
+    async with factory() as session:
+        assert await session.scalar(
+            select(func.count())
+            .select_from(AgentMessage)
+            .where(AgentMessage.subject == "Queued during cutover")
+        ) == 1
+        unchanged = await session.get(AgentMessage, historical_id)
+        assert unchanged.to_agent == "flex-auth"
+
+
+@pytest.mark.asyncio
+async def test_alias_aware_interface_catalog_sbom_and_telemetry_reads(
+    client, test_engine
+):
+    domain = await create_test_domain(client)
+    repo = await create_test_repo(client, domain_slug=domain["slug"], slug="flex-auth")
+    await _rename_in_state_hub(test_engine, repo["id"])
+
+    interface = await client.post(
+        "/interface-changes/",
+        json={
+            "repo_slug": "flex-auth",
+            "interface_type": "rest_api",
+            "change_type": "additive",
+            "title": "Canonical write",
+            "description": "New references use the current slug",
+            "affected_repo_slugs": ["flex-auth"],
+        },
+    )
+    assert interface.status_code == 201, interface.text
+    assert interface.json()["repo_slug"] == "access-engine"
+    assert interface.json()["affected_repo_slugs"] == ["access-engine"]
+    affected = await client.get(
+        "/interface-changes/", params={"affected_repo": "flex-auth"}
+    )
+    assert [item["id"] for item in affected.json()] == [interface.json()["id"]]
+
+    goal = await client.post(
+        "/repo-goals/",
+        json={
+            "repo_id": repo["id"],
+            "title": "Preserve authorization continuity",
+            "description": "Keep Net Kingdom consumers online",
+        },
+    )
+    assert goal.status_code == 201, goal.text
+    goals = await client.get("/repo-goals/", params={"repo_slug": "flex-auth"})
+    assert [item["id"] for item in goals.json()] == [goal.json()["id"]]
+    assert goals.json()[0]["repo_slug"] == "access-engine"
+
+    capability = await client.post(
+        "/capability-catalog/",
+        json={
+            "domain": "infotech",
+            "repo_slug": "flex-auth",
+            "capability_type": "authorization",
+            "title": "Policy decisions",
+            "description": "Net Kingdom authorization",
+            "keywords": ["authorize"],
+        },
+    )
+    assert capability.status_code == 201, capability.text
+    catalog = await client.get(
+        "/capability-catalog/", params={"repo_slug": "access-engine"}
+    )
+    assert [item["id"] for item in catalog.json()] == [capability.json()["id"]]
+    assert catalog.json()[0]["repo_slug"] == "access-engine"
+
+    service = await client.post(
+        "/services/catalog",
+        json={
+            "slug": "access-engine-api",
+            "name": "Access Engine API",
+            "hosting_type": "self_hosted",
+            "development_type": "first_party",
+            "first_party": {"repo_slug": "flex-auth", "owning_domain": "infotech"},
+            "self_hosted": {},
+        },
+    )
+    assert service.status_code == 201, service.text
+    services = await client.get("/services/catalog", params={"repo_slug": "flex-auth"})
+    assert [item["id"] for item in services.json()] == [service.json()["id"]]
+
+    ingested = await client.post(
+        "/sbom/ingest/",
+        json={
+            "repo_slug": "flex-auth",
+            "entries": [
+                {
+                    "package_name": "opa",
+                    "package_version": "1.0",
+                    "ecosystem": "go",
+                }
+            ],
+        },
+    )
+    assert ingested.status_code == 200, ingested.text
+    assert ingested.json()["repo_slug"] == "access-engine"
+    sbom = await client.get("/sbom/flex-auth")
+    assert sbom.status_code == 200
+    assert sbom.json()["repo_slug"] == "access-engine"
+
+    event = await client.post(
+        "/token-events/",
+        json={"repo_id": repo["id"], "tokens_in": 12, "tokens_out": 3},
+    )
+    assert event.status_code == 201, event.text
+    summary = await client.get(
+        "/token-events/by-repo/", params={"repo_slug": "flex-auth"}
+    )
+    assert summary.status_code == 200
+    assert len(summary.json()) == 1
+    assert summary.json()[0]["repo_slug"] == "access-engine"
+    assert summary.json()[0]["tokens_total"] == 15
diff --git a/tests/test_repository_collection_projection.py b/tests/test_repository_collection_projection.py
new file mode 100644
index 0000000..5aefc49
--- /dev/null
+++ b/tests/test_repository_collection_projection.py
@@ -0,0 +1,168 @@
+from __future__ import annotations
+
+import time
+import uuid
+
+import pytest
+from sqlalchemy import delete, event, update
+from sqlalchemy.ext.asyncio import AsyncSession, async_sessionmaker
+
+from api.models.managed_repo import ManagedRepo
+from api.models.repository_rename import RepositorySlug
+from tests.conftest import create_test_domain, create_test_repo
+
+
+@pytest.mark.asyncio
+@pytest.mark.parametrize("repository_count", [4, 131, 501])
+@pytest.mark.parametrize("filter_domain", [False, True])
+async def test_repository_collection_projects_identities_with_one_registry_query(
+    client, test_engine, monkeypatch, repository_count, filter_domain
+):
+    domain = await create_test_domain(client)
+    repositories = [
+        ManagedRepo(
+            id=uuid.uuid4(),
+            domain_id=uuid.UUID(domain["id"]),
+            slug=f"bounded-repo-{index}",
+            name=f"Bounded repo {index:04d}",
+        )
+        for index in range(repository_count)
+    ]
+
+    factory = async_sessionmaker(test_engine, class_=AsyncSession, expire_on_commit=False)
+    async with factory() as session:
+        session.add_all(repositories)
+        await session.flush()
+        session.add_all([
+            RepositorySlug(repo_id=repo.id, slug=repo.slug, kind="canonical")
+            for repo in repositories[:-1]
+        ])
+        session.add(
+            RepositorySlug(
+                repo_id=repositories[0].id,
+                slug="bounded-repo-old-name",
+                kind="alias",
+                protected=True,
+            )
+        )
+        await session.commit()
+
+    async def reject_per_repository_resolution(*_args, **_kwargs):
+        raise AssertionError("collection must not resolve repository identities one at a time")
+
+    monkeypatch.setattr(
+        "api.routers.repos.repository_resolution_for_id",
+        reject_per_repository_resolution,
+    )
+
+    statements: list[str] = []
+
+    def capture_statement(_conn, _cursor, statement, _parameters, _context, _executemany):
+        statements.append(statement)
+
+    event.listen(test_engine.sync_engine, "before_cursor_execute", capture_statement)
+    try:
+        started = time.perf_counter()
+        response = await client.get("/repos/", params={"domain": domain["slug"]} if filter_domain else {})
+        elapsed = time.perf_counter() - started
+    finally:
+        event.remove(test_engine.sync_engine, "before_cursor_execute", capture_statement)
+
+    assert response.status_code == 200, response.text
+    assert len(response.json()) == repository_count
+    assert all(repo["domain_slug"] == domain["slug"] for repo in response.json())
+    by_slug = {repository["slug"]: repository for repository in response.json()}
+    assert by_slug["bounded-repo-0"]["aliases"] == ["bounded-repo-old-name"]
+    assert by_slug["bounded-repo-0"]["slug_status"] == "canonical"
+    assert by_slug[repositories[-1].slug]["aliases"] == []
+    assert by_slug[repositories[-1].slug]["canonical_slug"] == repositories[-1].slug
+
+    registry_selects = [
+        statement
+        for statement in statements
+        if statement.lstrip().upper().startswith("SELECT")
+        and "repository_slugs" in statement.lower()
+    ]
+    assert len(registry_selects) == 1
+
+    selects = [statement for statement in statements if statement.lstrip().upper().startswith("SELECT")]
+    assert len(selects) == (3 if filter_domain else 2), selects
+    print(f"\ncollection: repositories={repository_count}, filtered={filter_domain}, selects={len(selects)}, elapsed_seconds={elapsed:.4f}")
+
+
+@pytest.mark.asyncio
+async def test_empty_repository_collection_skips_registry_query(client, test_engine):
+    statements = []
+
+    def capture(_conn, _cursor, statement, *_args):
+        statements.append(statement)
+
+    event.listen(test_engine.sync_engine, "before_cursor_execute", capture)
+    try:
+        response = await client.get("/repos/")
+    finally:
+        event.remove(test_engine.sync_engine, "before_cursor_execute", capture)
+    assert response.status_code == 200
+    assert response.json() == []
+    assert not any("repository_slugs" in statement for statement in statements)
+
+
+@pytest.mark.asyncio
+@pytest.mark.parametrize("registry_state", ["missing", "alias_only", "canonical_mismatch"])
+async def test_collection_matches_detail_identity_compatibility(
+    client, test_engine, registry_state
+):
+    domain = await create_test_domain(client)
+    repo = await create_test_repo(client, domain_slug=domain["slug"])
+    factory = async_sessionmaker(test_engine, class_=AsyncSession, expire_on_commit=False)
+    async with factory() as session:
+        if registry_state == "missing":
+            await session.execute(delete(RepositorySlug).where(RepositorySlug.repo_id == repo["id"]))
+        else:
+            await session.execute(
+                update(RepositorySlug).where(RepositorySlug.repo_id == repo["id"]).values(kind="alias")
+            )
+            if registry_state == "canonical_mismatch":
+                session.add(RepositorySlug(repo_id=repo["id"], slug="different-canonical", kind="canonical"))
+        await session.commit()
+    detail = await client.get(f"/repos/{repo['slug']}")
+    collection = await client.get("/repos/")
+    if registry_state == "missing":
+        assert detail.status_code == collection.status_code == 200
+        for field in ("canonical_slug", "requested_slug", "aliases", "slug_status"):
+            assert collection.json()[0][field] == detail.json()[field]
+    else:
+        assert detail.status_code == collection.status_code == 409
+        assert collection.json() == detail.json()
+
+
+@pytest.mark.asyncio
+async def test_collection_filters_secondary_domain_and_classification(client, test_engine):
+    primary = await create_test_domain(client)
+    secondary = await create_test_domain(client, slug="secondary", name="Secondary")
+    factory = async_sessionmaker(test_engine, class_=AsyncSession, expire_on_commit=False)
+    async with factory() as session:
+        session.add_all([
+            ManagedRepo(
+                domain_id=uuid.UUID(primary["id"]), slug="included", name="Included",
+                secondary_domains=[secondary["slug"]], category="service",
+                capability_tags=["projection"], business_stake=["internal"],
+            ),
+            ManagedRepo(
+                domain_id=uuid.UUID(primary["id"]), slug="excluded", name="Excluded",
+                category="service", capability_tags=["projection"], business_stake=["internal"],
+            ),
+        ])
+        await session.commit()
+    params = {"domain": secondary["slug"], "category": "service",
+              "capability_tag": "projection", "business_stake": "internal"}
+    response = await client.get("/repos/", params=params)
+    assert response.status_code == 200, response.text
+    assert [repo["slug"] for repo in response.json()] == ["included"]
+    assert response.json()[0]["domain_slug"] == primary["slug"]
+    for key in ("category", "capability_tag", "business_stake"):
+        response = await client.get("/repos/", params={**params, key: "absent"})
+        assert response.status_code == 200
+        assert response.json() == []
+    response = await client.get("/repos/", params={"domain": "missing"})
+    assert response.status_code == 404
diff --git a/tests/test_repository_rename_api.py b/tests/test_repository_rename_api.py
new file mode 100644
index 0000000..2597961
--- /dev/null
+++ b/tests/test_repository_rename_api.py
@@ -0,0 +1,1006 @@
+from __future__ import annotations
+
+import uuid
+from datetime import datetime, timezone
+
+import pytest
+import pytest_asyncio
+from sqlalchemy import delete, func, select
+from sqlalchemy.ext.asyncio import AsyncSession, async_sessionmaker
+
+from api.config import settings
+from api.main import app
+from api.models.managed_repo import ManagedRepo
+from api.models.repository_rename import RepositoryRenameOperation, RepositorySlug
+from api.models.agent_message import AgentMessage
+from api.models.decision import Decision
+from api.models.sbom_entry import Ecosystem, SBOMEntry
+from api.models.sbom_snapshot import SBOMSnapshot
+from api.models.token_event import TokenEvent
+from api.models.workplan import Workplan
+from api.routers.repository_renames import repository_rename_events
+from api.services.forge_repository import (
+    ForgeRepositorySnapshot,
+    get_forge_repository_gateway,
+)
+from tests.conftest import (
+    create_test_domain,
+    create_test_repo,
+    create_test_workplan,
+)
+
+
+class FakeForge:
+    def __init__(self, *, name: str = "flex-auth", repository_id: int = 417, head: str = "a" * 40):
+        self.name = name
+        self.repository_id = repository_id
+        self.head = head
+        self.rename_calls = 0
+        self.extra: dict[str, int] = {}
+        self.unreadable = False
+
+    def snapshot(self, name: str, repository_id: int | None = None) -> ForgeRepositorySnapshot:
+        return ForgeRepositorySnapshot(
+            repository_id=repository_id or self.repository_id,
+            owner="coulomb",
+            name=name,
+            full_name=f"coulomb/{name}",
+            default_branch="main",
+            head_commit=self.head,
+            clone_url=f"https://forge.example/coulomb/{name}.git",
+            html_url=f"https://forge.example/coulomb/{name}",
+            projection_readable=True,
+            projection_source_present=True,
+            projection_entry_count=1,
+        )
+
+    async def inspect(self, *, instance: str, owner: str, name: str):
+        if self.unreadable:
+            from api.services.forge_repository import ForgeRepositoryUnreadable
+
+            raise ForgeRepositoryUnreadable("simulated unreadable forge")
+        if name == self.name:
+            return self.snapshot(name)
+        if name in self.extra:
+            return self.snapshot(name, self.extra[name])
+        return None
+
+    async def rename(self, *, instance: str, owner: str, old_name: str, new_name: str):
+        assert old_name == self.name
+        assert new_name not in self.extra
+        self.rename_calls += 1
+        self.name = new_name
+        return self.snapshot(new_name)
+
+
+@pytest_asyncio.fixture
+async def rename_setup(client, monkeypatch):
+    monkeypatch.setattr(settings, "repository_rename_preflight_secret", "test-only-preflight-secret")
+    domain = await create_test_domain(client)
+    repo = await create_test_repo(
+        client,
+        domain_slug=domain["slug"],
+        slug="flex-auth",
+        remote_url="https://forge.example/coulomb/flex-auth.git",
+        local_path="/srv/flex-auth",
+        host_paths={"workstation": "/home/operator/flex-auth"},
+    )
+    forge = FakeForge()
+    app.dependency_overrides[get_forge_repository_gateway] = lambda: forge
+    verified = await client.post(
+        f"/repos/{repo['id']}/forge-identity/verify",
+        json={
+            "provider": "forgejo",
+            "forge_instance": "https://forge.example",
+            "forge_owner": "coulomb",
+            "forge_repository_id": forge.repository_id,
+            "verified_by": "pytest",
+        },
+    )
+    assert verified.status_code == 200, verified.text
+    return repo, forge
+
+
+async def _preflight(client, repo_id: str, new_slug: str = "access-engine"):
+    response = await client.post(
+        f"/repos/{repo_id}/rename/preflight", json={"new_slug": new_slug}
+    )
+    assert response.status_code == 200, response.text
+    return response.json()
+
+
+async def _operation(client, repo_id: str, preflight: dict):
+    confirmation = f"rename:{repo_id}:flex-auth:access-engine"
+    response = await client.post(
+        f"/repos/{repo_id}/rename/operations",
+        json={
+            "new_slug": "access-engine",
+            "preflight_token": preflight["preflight_token"],
+            "confirmation": confirmation,
+            "actor": "pytest",
+        },
+    )
+    assert response.status_code == 201, response.text
+    return response.json(), confirmation
+
+
+async def _phase(client, repo_id: str, operation_id: str, phase: str, expected: str, confirmation: str, **extra):
+    response = await client.post(
+        f"/repos/{repo_id}/rename/operations/{operation_id}/phases/{phase}",
+        json={
+            "expected_phase": expected,
+            "confirmation": confirmation,
+            **extra,
+        },
+    )
+    assert response.status_code == 200, response.text
+    return response.json()
+
+
+@pytest.mark.asyncio
+async def test_dry_run_has_no_persistent_changes(client, test_engine, rename_setup):
+    repo, _forge = rename_setup
+    factory = async_sessionmaker(test_engine, class_=AsyncSession, expire_on_commit=False)
+    async with factory() as session:
+        before_operations = await session.scalar(select(func.count()).select_from(RepositoryRenameOperation))
+        before_slugs = await session.scalar(select(func.count()).select_from(RepositorySlug))
+        before_repo = await session.get(ManagedRepo, uuid.UUID(repo["id"]))
+        before = (before_operations, before_slugs, before_repo.slug, before_repo.updated_at)
+
+    report = await _preflight(client, repo["id"])
+    assert report["safe_to_apply"] is True
+    assert report["preflight_token"]
+    assert report["current"]["statehub"]["repo_id"] == repo["id"]
+    assert report["current"]["forge"]["repository_id"] == 417
+    assert report["retained_history"]
+
+    async with factory() as session:
+        after_operations = await session.scalar(select(func.count()).select_from(RepositoryRenameOperation))
+        after_slugs = await session.scalar(select(func.count()).select_from(RepositorySlug))
+        after_repo = await session.get(ManagedRepo, uuid.UUID(repo["id"]))
+        after = (after_operations, after_slugs, after_repo.slug, after_repo.updated_at)
+    assert after == before
+
+
+@pytest.mark.asyncio
+async def test_client_operation_id_is_idempotent_and_globally_discoverable(
+    client, rename_setup
+):
+    repo, _forge = rename_setup
+    preflight = await _preflight(client, repo["id"])
+    operation_id = str(uuid.uuid4())
+    confirmation = f"rename:{repo['id']}:flex-auth:access-engine"
+    payload = {
+        "operation_id": operation_id,
+        "new_slug": "access-engine",
+        "preflight_token": preflight["preflight_token"],
+        "confirmation": confirmation,
+        "actor": "helixforge-test",
+    }
+
+    created = await client.post(
+        f"/repos/{repo['id']}/rename/operations", json=payload
+    )
+    replay = await client.post(
+        f"/repos/{repo['id']}/rename/operations",
+        json={**payload, "preflight_token": "expired-after-creation"},
+    )
+    assert created.status_code == replay.status_code == 201
+    assert created.json()["id"] == replay.json()["id"] == operation_id
+    assert created.json()["no_op"] is False
+    assert replay.json()["no_op"] is True
+
+    discovered = await client.get(
+        f"/repository-renames/operations/{operation_id}"
+    )
+    assert discovered.status_code == 200
+    assert discovered.json()["repo_id"] == repo["id"]
+    assert discovered.json()["phase"] == "preflighted"
+
+    collision = await client.post(
+        f"/repos/{repo['id']}/rename/operations",
+        json={**payload, "new_slug": "another-name"},
+    )
+    assert collision.status_code == 412
+    assert collision.json()["detail"]["code"] == "repository_rename_precondition_failed"
+
+    actor_collision = await client.post(
+        f"/repos/{repo['id']}/rename/operations",
+        json={**payload, "actor": "different-actor"},
+    )
+    assert actor_collision.status_code == 412
+
+
+@pytest.mark.asyncio
+async def test_interrupt_resume_every_phase_and_preserve_uuid(client, rename_setup):
+    repo, forge = rename_setup
+    workplan = await create_test_workplan(
+        client, repo_id=repo["id"], slug="FLEX-WP-0001", status="active"
+    )
+    task = await client.post(
+        "/tasks/",
+        json={
+            "workplan_id": workplan["id"],
+            "title": "Security migration",
+            "status": "todo",
+            "priority": "high",
+        },
+    )
+    assert task.status_code == 201, task.text
+    progress = await client.post(
+        "/progress/",
+        json={"workplan_id": workplan["id"], "task_id": task.json()["id"], "summary": "baseline", "event_type": "note"},
+    )
+    assert progress.status_code == 201, progress.text
+
+    preflight = await _preflight(client, repo["id"])
+    operation, confirmation = await _operation(client, repo["id"], preflight)
+    operation_id = operation["id"]
+    discover = await client.get(
+        f"/repos/{repo['id']}/rename/operations", params={"active_only": True}
+    )
+    assert discover.status_code == 200
+    assert [item["id"] for item in discover.json()] == [operation_id]
+
+    # Simulate the hardest interruption: Forge committed the rename but the
+    # State Hub request died before recording forge-renamed.
+    await forge.rename(
+        instance="https://forge.example",
+        owner="coulomb",
+        old_name="flex-auth",
+        new_name="access-engine",
+    )
+    phase = await _phase(
+        client, repo["id"], operation_id, "forge-renamed", "preflighted", confirmation
+    )
+    assert phase["phase"] == "forge-renamed"
+    assert phase["evidence"]["phases"]["forge-renamed"]["resumed"] is True
+    assert forge.rename_calls == 1
+
+    sequence = [
+        ("statehub-rebound", "forge-renamed", {}),
+        (
+            "source-synced",
+            "statehub-rebound",
+            {
+                "evidence": {
+                    "fresh_clone": True,
+                    "forge_repository_id": 417,
+                    "head_commit": "a" * 40,
+                }
+            },
+        ),
+        ("consumers-verified", "source-synced", {"checks": {"routes": True, "security-stack": True}}),
+        ("completed", "consumers-verified", {}),
+    ]
+    for requested, expected, extra in sequence:
+        read = await client.get(f"/repos/{repo['id']}/rename/operations/{operation_id}")
+        assert read.status_code == 200
+        assert read.json()["phase"] == expected
+        phase = await _phase(
+            client, repo["id"], operation_id, requested, expected, confirmation, **extra
+        )
+        assert phase["phase"] == requested
+        if requested == "source-synced":
+            appended = await client.post(
+                "/progress/",
+                json={
+                    "workplan_id": workplan["id"],
+                    "task_id": task.json()["id"],
+                    "summary": "rename phase completed",
+                    "event_type": "note",
+                },
+            )
+            assert appended.status_code == 201, appended.text
+        replay = await _phase(
+            client, repo["id"], operation_id, requested, expected, confirmation, **extra
+        )
+        assert replay["id"] == operation_id
+        assert replay["no_op"] is True
+
+    verification = await client.get(
+        f"/repos/{repo['id']}/rename/operations/{operation_id}/verify"
+    )
+    assert verification.status_code == 200, verification.text
+    assert verification.json()["ok"] is True
+    discover = await client.get(
+        f"/repos/{repo['id']}/rename/operations", params={"active_only": True}
+    )
+    assert discover.json() == []
+    current = await client.get(f"/repos/by-id/{repo['id']}")
+    assert current.status_code == 200, current.text
+    assert current.json()["id"] == repo["id"]
+    assert current.json()["slug"] == "access-engine"
+
+
+@pytest.mark.asyncio
+async def test_stale_head_wrong_id_target_conflict_and_queued_writes_fail_closed(client, rename_setup):
+    repo, forge = rename_setup
+
+    queued = await client.post(
+        f"/repos/{repo['id']}/rename/preflight",
+        json={
+            "new_slug": "access-engine",
+            "queued_edge_writes": [{"id": "edge-1", "source_host": "laptop"}],
+        },
+    )
+    assert queued.status_code == 200
+    assert queued.json()["safe_to_apply"] is False
+    assert queued.json()["preflight_token"] is None
+
+    forge.extra["access-engine"] = 999
+    conflict = await _preflight(client, repo["id"])
+    assert conflict["safe_to_apply"] is False
+    assert {item["code"] for item in conflict["blockers"]} >= {"forge_target_claimed"}
+    del forge.extra["access-engine"]
+
+    forge.repository_id = 999
+    wrong_id = await _preflight(client, repo["id"])
+    assert wrong_id["safe_to_apply"] is False
+    assert {item["code"] for item in wrong_id["blockers"]} >= {"wrong_forge_repository_id"}
+    forge.repository_id = 417
+
+    preflight = await _preflight(client, repo["id"])
+    forge.head = "b" * 40
+    create = await client.post(
+        f"/repos/{repo['id']}/rename/operations",
+        json={
+            "new_slug": "access-engine",
+            "preflight_token": preflight["preflight_token"],
+            "confirmation": f"rename:{repo['id']}:flex-auth:access-engine",
+            "actor": "pytest",
+        },
+    )
+    assert create.status_code == 412, create.text
+    assert "stale" in create.json()["detail"]["message"].lower()
+
+
+@pytest.mark.asyncio
+async def test_expired_token_bad_confirmation_and_unreadable_forge_fail_closed(
+    client, rename_setup, monkeypatch
+):
+    repo, forge = rename_setup
+    monkeypatch.setattr(settings, "repository_rename_preflight_ttl_seconds", -1)
+    expired = await _preflight(client, repo["id"])
+    response = await client.post(
+        f"/repos/{repo['id']}/rename/operations",
+        json={
+            "new_slug": "access-engine",
+            "preflight_token": expired["preflight_token"],
+            "confirmation": f"rename:{repo['id']}:flex-auth:access-engine",
+            "actor": "pytest",
+        },
+    )
+    assert response.status_code == 412
+    assert "expired" in response.json()["detail"]["message"].lower()
+
+    monkeypatch.setattr(settings, "repository_rename_preflight_ttl_seconds", 900)
+    preflight = await _preflight(client, repo["id"])
+    response = await client.post(
+        f"/repos/{repo['id']}/rename/operations",
+        json={
+            "new_slug": "access-engine",
+            "preflight_token": preflight["preflight_token"],
+            "confirmation": "yes",
+            "actor": "pytest",
+        },
+    )
+    assert response.status_code == 412
+    forge.unreadable = True
+    unreadable = await _preflight(client, repo["id"])
+    assert unreadable["safe_to_apply"] is False
+    assert {item["code"] for item in unreadable["blockers"]} >= {"forge_unreadable"}
+
+
+@pytest.mark.asyncio
+async def test_rollback_restores_old_canonical_and_remains_auditable(client, rename_setup):
+    repo, forge = rename_setup
+    preflight = await _preflight(client, repo["id"])
+    operation, confirmation = await _operation(client, repo["id"], preflight)
+    operation_id = operation["id"]
+    for requested, expected, extra in [
+        ("forge-renamed", "preflighted", {}),
+        ("statehub-rebound", "forge-renamed", {}),
+        (
+            "source-synced",
+            "statehub-rebound",
+            {
+                "evidence": {
+                    "fresh_clone": True,
+                    "forge_repository_id": 417,
+                    "head_commit": "a" * 40,
+                }
+            },
+        ),
+    ]:
+        await _phase(client, repo["id"], operation_id, requested, expected, confirmation, **extra)
+
+    rollback_confirmation = f"rollback:{operation_id}"
+    report = await client.post(
+        f"/repos/{repo['id']}/rename/operations/{operation_id}/rollback-preflight",
+        json={"expected_phase": "source-synced", "confirmation": rollback_confirmation},
+    )
+    assert report.status_code == 200, report.text
+    assert report.json()["safe_to_rollback"] is True
+    assert report.json()["irreversible"]
+
+    rollback = await client.post(
+        f"/repos/{repo['id']}/rename/operations/{operation_id}/rollback",
+        json={"expected_phase": "rollback-preflight", "confirmation": rollback_confirmation},
+    )
+    assert rollback.status_code == 200, rollback.text
+    assert rollback.json()["phase"] == "rolled-back"
+    assert forge.name == "flex-auth"
+    current = await client.get(f"/repos/by-id/{repo['id']}")
+    assert current.json()["id"] == repo["id"]
+    assert current.json()["slug"] == "flex-auth"
+    history = rollback.json()["evidence"]["phases"]
+    assert set(history) >= {"preflighted", "forge-renamed", "statehub-rebound", "source-synced", "rollback-preflight", "rolled-back"}
+    replay = await client.post(
+        f"/repos/{repo['id']}/rename/operations/{operation_id}/rollback",
+        json={"expected_phase": "rollback-preflight", "confirmation": rollback_confirmation},
+    )
+    assert replay.status_code == 200
+    assert replay.json()["no_op"] is True
+
+
+@pytest.mark.asyncio
+async def test_rollback_recovers_unrecorded_forge_rename(client, rename_setup):
+    repo, forge = rename_setup
+    preflight = await _preflight(client, repo["id"])
+    operation, _confirmation = await _operation(client, repo["id"], preflight)
+    await forge.rename(
+        instance="https://forge.example",
+        owner="coulomb",
+        old_name="flex-auth",
+        new_name="access-engine",
+    )
+    rollback_confirmation = f"rollback:{operation['id']}"
+    report = await client.post(
+        f"/repos/{repo['id']}/rename/operations/{operation['id']}/rollback-preflight",
+        json={"expected_phase": "preflighted", "confirmation": rollback_confirmation},
+    )
+    assert report.status_code == 200, report.text
+    assert report.json()["rollback_from_phase"] == "forge-renamed-unrecorded"
+    rollback = await client.post(
+        f"/repos/{repo['id']}/rename/operations/{operation['id']}/rollback",
+        json={"expected_phase": "rollback-preflight", "confirmation": rollback_confirmation},
+    )
+    assert rollback.status_code == 200, rollback.text
+    assert rollback.json()["phase"] == "rolled-back"
+    assert forge.name == "flex-auth"
+
+
+@pytest.mark.asyncio
+async def test_continuity_evidence_covers_relationships_totals_routes_and_dispatch(
+    client, test_engine, rename_setup
+):
+    repo, _forge = rename_setup
+    workplan = await create_test_workplan(
+        client, repo_id=repo["id"], slug="FLEX-WP-0042", status="active"
+    )
+    task = await client.post(
+        "/tasks/",
+        json={
+            "workplan_id": workplan["id"],
+            "title": "Preserve security-stack lineage",
+            "status": "todo",
+            "priority": "high",
+        },
+    )
+    assert task.status_code == 201, task.text
+    now = datetime.now(timezone.utc)
+    factory = async_sessionmaker(test_engine, class_=AsyncSession, expire_on_commit=False)
+    async with factory() as session:
+        bound = await session.get(Workplan, uuid.UUID(workplan["id"]))
+        bound.backing_filename = "FLEX-WP-0042-lineage.md"
+        bound.backing_relative_path = "workplans/FLEX-WP-0042-lineage.md"
+        decision = Decision(
+            workplan_id=bound.id,
+            title="Retain immutable repository identity",
+        )
+        token = TokenEvent(
+            repo_id=uuid.UUID(repo["id"]),
+            workplan_id=bound.id,
+            task_id=uuid.UUID(task.json()["id"]),
+            tokens_in=120,
+            tokens_out=30,
+            cached_input_tokens=10,
+            reasoning_output_tokens=5,
+            raw_total_tokens=165,
+        )
+        snapshot = SBOMSnapshot(
+            repo_id=uuid.UUID(repo["id"]),
+            snapshot_at=now,
+            source="pytest",
+            entry_count=1,
+            created_at=now,
+        )
+        message = AgentMessage(
+            from_agent="security-review",
+            to_agent="flex-auth",
+            subject="Historical route",
+            body="Keep the recorded coordinate",
+        )
+        session.add_all([decision, token, snapshot, message])
+        await session.flush()
+        session.add(
+            SBOMEntry(
+                repo_id=uuid.UUID(repo["id"]),
+                snapshot_id=snapshot.id,
+                package_name="policy-engine",
+                package_version="1.0",
+                ecosystem=Ecosystem.python,
+                snapshot_at=now,
+                created_at=now,
+            )
+        )
+        await session.commit()
+
+    preflight = await _preflight(client, repo["id"])
+    baseline = preflight["baselines"]
+    assert set(baseline) >= {
+        "repository",
+        "workplans",
+        "tasks",
+        "progress_events",
+        "decisions",
+        "token_events",
+        "sbom_snapshots",
+        "active_dispatch",
+        "aliases",
+        "messages",
+        "workplan_bindings",
+        "continuity_checksum",
+    }
+    assert baseline["token_events"]["totals"] == {
+        "tokens_in": 120,
+        "tokens_out": 30,
+        "cached_input_tokens": 10,
+        "reasoning_output_tokens": 5,
+        "raw_total_tokens": 165,
+    }
+    assert baseline["workplan_bindings"]["relationships"][0]["repo_id"] == repo["id"]
+
+    operation, confirmation = await _operation(client, repo["id"], preflight)
+    for requested, expected, extra in [
+        ("forge-renamed", "preflighted", {}),
+        ("statehub-rebound", "forge-renamed", {}),
+        (
+            "source-synced",
+            "statehub-rebound",
+            {
+                "evidence": {
+                    "fresh_clone": True,
+                    "forge_repository_id": 417,
+                    "head_commit": "a" * 40,
+                }
+            },
+        ),
+        ("consumers-verified", "source-synced", {"checks": {"dispatch": True}}),
+        ("completed", "consumers-verified", {}),
+    ]:
+        await _phase(
+            client,
+            repo["id"],
+            operation["id"],
+            requested,
+            expected,
+            confirmation,
+            **extra,
+        )
+
+    verification = await client.get(
+        f"/repos/{repo['id']}/rename/operations/{operation['id']}/verify"
+    )
+    assert verification.status_code == 200, verification.text
+    evidence = verification.json()
+    assert evidence["ok"] is True
+    for name, expected_checksum in evidence["relationship_checksums"]["baseline"].items():
+        assert evidence["relationship_checksums"]["preserved"][name] == expected_checksum
+    assert (await client.get("/repos/flex-auth")).json()["slug_status"] == "alias"
+    dispatch = await client.get("/repos/flex-auth/dispatch")
+    assert dispatch.status_code == 200
+    assert dispatch.json()["canonical_slug"] == "access-engine"
+    assert dispatch.json()["active_workplans"][0]["id"] == workplan["id"]
+
+
+@pytest.mark.asyncio
+async def test_equal_counts_do_not_hide_detached_work_and_telemetry(
+    client, test_engine, rename_setup
+):
+    repo, _forge = rename_setup
+    workplan = await create_test_workplan(
+        client, repo_id=repo["id"], slug="FLEX-WP-0050", status="active"
+    )
+    factory = async_sessionmaker(test_engine, class_=AsyncSession, expire_on_commit=False)
+    async with factory() as session:
+        original_token = TokenEvent(
+            repo_id=uuid.UUID(repo["id"]), tokens_in=11, tokens_out=7
+        )
+        session.add(original_token)
+        await session.commit()
+    preflight = await _preflight(client, repo["id"])
+    operation, _confirmation = await _operation(client, repo["id"], preflight)
+
+    other_domain = await create_test_domain(client, slug="other-domain")
+    other_repo = await create_test_repo(
+        client, domain_slug=other_domain["slug"], slug="other-repo"
+    )
+    async with factory() as session:
+        detached = await session.get(Workplan, uuid.UUID(workplan["id"]))
+        detached.repo_id = uuid.UUID(other_repo["id"])
+        token = await session.get(TokenEvent, original_token.id)
+        token.repo_id = uuid.UUID(other_repo["id"])
+        session.add(
+            Workplan(
+                repo_id=uuid.UUID(repo["id"]),
+                slug="FLEX-WP-0050-RECREATED",
+                title="Count-preserving replacement",
+                status="active",
+            )
+        )
+        session.add(
+            TokenEvent(repo_id=uuid.UUID(repo["id"]), tokens_in=11, tokens_out=7)
+        )
+        await session.commit()
+
+    verification = await client.get(
+        f"/repos/{repo['id']}/rename/operations/{operation['id']}/verify"
+    )
+    assert verification.status_code == 200, verification.text
+    result = verification.json()
+    assert result["ok"] is False
+    relationship = next(
+        check for check in result["checks"] if check["name"] == "relationship_continuity"
+    )
+    assert relationship["ok"] is False
+    assert set(relationship["actual"]["missing"]) >= {"workplans", "token_events"}
+    counts = next(
+        check for check in result["checks"] if check["name"] == "record_counts_non_decreasing"
+    )
+    assert counts["actual"]["workplans"] == counts["expected"]["workplans"]
+    assert counts["actual"]["token_events"] == counts["expected"]["token_events"]
+
+
+@pytest.mark.asyncio
+async def test_redirected_forge_and_wrong_fresh_clone_identity_fail_closed_then_resume(
+    client, rename_setup
+):
+    repo, forge = rename_setup
+    original_inspect = forge.inspect
+
+    async def redirected(*, instance: str, owner: str, name: str):
+        if name == "flex-auth":
+            return forge.snapshot("access-engine")
+        if name == "access-engine":
+            return None
+        return await original_inspect(instance=instance, owner=owner, name=name)
+
+    forge.inspect = redirected
+    redirected_report = await _preflight(client, repo["id"])
+    assert redirected_report["safe_to_apply"] is False
+    assert {item["code"] for item in redirected_report["blockers"]} >= {"forge_redirected"}
+    forge.inspect = original_inspect
+
+    preflight = await _preflight(client, repo["id"])
+    operation, confirmation = await _operation(client, repo["id"], preflight)
+    await _phase(client, repo["id"], operation["id"], "forge-renamed", "preflighted", confirmation)
+    await _phase(client, repo["id"], operation["id"], "statehub-rebound", "forge-renamed", confirmation)
+    wrong = await client.post(
+        f"/repos/{repo['id']}/rename/operations/{operation['id']}/phases/source-synced",
+        json={
+            "expected_phase": "statehub-rebound",
+            "confirmation": confirmation,
+            "evidence": {
+                "fresh_clone": True,
+                "forge_repository_id": 999,
+                "head_commit": "a" * 40,
+                "password": "must-never-reach-an-event",
+            },
+        },
+    )
+    assert wrong.status_code == 412
+    status = (await client.get(f"/repository-renames/operations/{operation['id']}")).json()
+    assert status["phase"] == "statehub-rebound"
+    assert status["evidence"]["telemetry"]["failures"] == 1
+    resumed = await _phase(
+        client,
+        repo["id"],
+        operation["id"],
+        "source-synced",
+        "statehub-rebound",
+        confirmation,
+        evidence={
+            "fresh_clone": True,
+            "forge_repository_id": 417,
+            "head_commit": "a" * 40,
+        },
+    )
+    replay = await _phase(
+        client,
+        repo["id"],
+        operation["id"],
+        "source-synced",
+        "statehub-rebound",
+        confirmation,
+        evidence={
+            "fresh_clone": True,
+            "forge_repository_id": 417,
+            "head_commit": "a" * 40,
+        },
+    )
+    assert resumed["phase"] == "source-synced"
+    assert replay["no_op"] is True
+    assert replay["evidence"]["telemetry"]["retries"] == 1
+
+
+@pytest.mark.asyncio
+async def test_rollback_recovers_when_old_statehub_slug_temporarily_unavailable(
+    client, test_engine, rename_setup
+):
+    repo, forge = rename_setup
+    preflight = await _preflight(client, repo["id"])
+    operation, confirmation = await _operation(client, repo["id"], preflight)
+    for requested, expected, extra in [
+        ("forge-renamed", "preflighted", {}),
+        ("statehub-rebound", "forge-renamed", {}),
+        (
+            "source-synced",
+            "statehub-rebound",
+            {
+                "evidence": {
+                    "fresh_clone": True,
+                    "forge_repository_id": 417,
+                    "head_commit": "a" * 40,
+                }
+            },
+        ),
+    ]:
+        await _phase(client, repo["id"], operation["id"], requested, expected, confirmation, **extra)
+    rollback_confirmation = f"rollback:{operation['id']}"
+    report = await client.post(
+        f"/repos/{repo['id']}/rename/operations/{operation['id']}/rollback-preflight",
+        json={"expected_phase": "source-synced", "confirmation": rollback_confirmation},
+    )
+    assert report.status_code == 200, report.text
+
+    factory = async_sessionmaker(test_engine, class_=AsyncSession, expire_on_commit=False)
+    async with factory() as session:
+        await session.execute(delete(RepositorySlug).where(RepositorySlug.slug == "flex-auth"))
+        await session.commit()
+    failed = await client.post(
+        f"/repos/{repo['id']}/rename/operations/{operation['id']}/rollback",
+        json={"expected_phase": "rollback-preflight", "confirmation": rollback_confirmation},
+    )
+    assert failed.status_code == 412
+    assert forge.name == "flex-auth"
+    async with factory() as session:
+        session.add(
+            RepositorySlug(
+                repo_id=uuid.UUID(repo["id"]),
+                slug="flex-auth",
+                kind="alias",
+                protected=True,
+                source_operation_id=uuid.UUID(operation["id"]),
+            )
+        )
+        await session.commit()
+    resumed = await client.post(
+        f"/repos/{repo['id']}/rename/operations/{operation['id']}/rollback",
+        json={"expected_phase": "rollback-preflight", "confirmation": rollback_confirmation},
+    )
+    assert resumed.status_code == 200, resumed.text
+    assert resumed.json()["phase"] == "rolled-back"
+    assert resumed.json()["evidence"]["telemetry"]["failures"] == 1
+    assert resumed.json()["evidence"]["telemetry"]["rollback_outcome"] == "completed"
+
+
+@pytest.mark.asyncio
+async def test_rename_events_expose_metrics_without_operator_evidence_or_secrets(
+    client, test_engine, rename_setup
+):
+    repo, _forge = rename_setup
+    preflight = await _preflight(client, repo["id"])
+    operation, confirmation = await _operation(client, repo["id"], preflight)
+    await _phase(client, repo["id"], operation["id"], "forge-renamed", "preflighted", confirmation)
+    replay = await _phase(client, repo["id"], operation["id"], "forge-renamed", "preflighted", confirmation)
+    assert replay["evidence"]["telemetry"]["retries"] == 1
+
+    factory = async_sessionmaker(test_engine, class_=AsyncSession, expire_on_commit=False)
+    async with factory() as session:
+        persisted = await session.get(RepositoryRenameOperation, uuid.UUID(operation["id"]))
+        events = repository_rename_events(persisted, outcome="succeeded", no_op=True)
+    assert [subject for subject, _event in events] == ["org.statehub.repo.rename.phase"]
+    attributes = events[0][1].attributes
+    assert attributes["repo_id"] == repo["id"]
+    assert attributes["phase"] == "forge-renamed"
+    assert attributes["phase_duration_ms"] >= 0
+    assert attributes["retries"] == 1
+    assert set(attributes) >= {
+        "failures",
+        "rollback_attempts",
+        "verification_outcome",
+        "evidence_ref",
+    }
+    serialized = events[0][1].model_dump_json().lower()
+    assert "preflight_token" not in serialized
+    assert "operator_evidence" not in serialized
+    assert "password" not in serialized
+    persisted.phase = "completed"
+    completion = repository_rename_events(persisted, outcome="succeeded")
+    assert [subject for subject, _event in completion] == [
+        "org.statehub.repo.rename.phase",
+        "org.statehub.repo.renamed",
+    ]
+    persisted.phase = "forge-renamed"
+    persisted.error_code = "repository_rename_precondition_failed"
+    persisted.error_details = {"authorization": "Bearer must-not-publish"}
+    failure = repository_rename_events(persisted, outcome="failed")
+    failure_json = failure[0][1].model_dump_json()
+    assert failure[0][0] == "org.statehub.repo.rename.failed"
+    assert "must-not-publish" not in failure_json
+
+
+@pytest.mark.asyncio
+async def test_every_forward_phase_failure_is_retry_safe(client, rename_setup):
+    repo, forge = rename_setup
+    preflight = await _preflight(client, repo["id"])
+    operation, confirmation = await _operation(client, repo["id"], preflight)
+    operation_id = operation["id"]
+
+    async def fail_unreadable(requested: str, expected: str) -> None:
+        forge.unreadable = True
+        response = await client.post(
+            f"/repos/{repo['id']}/rename/operations/{operation_id}/phases/{requested}",
+            json={"expected_phase": expected, "confirmation": confirmation},
+        )
+        forge.unreadable = False
+        assert response.status_code == 412
+        status = await client.get(f"/repository-renames/operations/{operation_id}")
+        assert status.json()["phase"] == expected
+
+    await fail_unreadable("forge-renamed", "preflighted")
+    await _phase(client, repo["id"], operation_id, "forge-renamed", "preflighted", confirmation)
+    await fail_unreadable("statehub-rebound", "forge-renamed")
+    await _phase(client, repo["id"], operation_id, "statehub-rebound", "forge-renamed", confirmation)
+
+    wrong_clone = await client.post(
+        f"/repos/{repo['id']}/rename/operations/{operation_id}/phases/source-synced",
+        json={
+            "expected_phase": "statehub-rebound",
+            "confirmation": confirmation,
+            "evidence": {
+                "fresh_clone": True,
+                "forge_repository_id": 999,
+                "head_commit": "a" * 40,
+            },
+        },
+    )
+    assert wrong_clone.status_code == 412
+    await _phase(
+        client,
+        repo["id"],
+        operation_id,
+        "source-synced",
+        "statehub-rebound",
+        confirmation,
+        evidence={
+            "fresh_clone": True,
+            "forge_repository_id": 417,
+            "head_commit": "a" * 40,
+        },
+    )
+
+    bad_consumers = await client.post(
+        f"/repos/{repo['id']}/rename/operations/{operation_id}/phases/consumers-verified",
+        json={
+            "expected_phase": "source-synced",
+            "confirmation": confirmation,
+            "checks": {"security-stack": False},
+        },
+    )
+    assert bad_consumers.status_code == 412
+    await _phase(
+        client,
+        repo["id"],
+        operation_id,
+        "consumers-verified",
+        "source-synced",
+        confirmation,
+        checks={"security-stack": True},
+    )
+
+    await fail_unreadable("completed", "consumers-verified")
+    completed = await _phase(
+        client,
+        repo["id"],
+        operation_id,
+        "completed",
+        "consumers-verified",
+        confirmation,
+    )
+    assert completed["evidence"]["telemetry"]["failures"] == 5
+    assert completed["evidence"]["telemetry"]["verification_outcome"] == "passed"
+    assert set(completed["evidence"]["telemetry"]["failures_by_phase"]) == {
+        "forge-renamed",
+        "statehub-rebound",
+        "source-synced",
+        "consumers-verified",
+        "completed",
+    }
+
+
+@pytest.mark.asyncio
+@pytest.mark.parametrize('location', [
+    '/api/v1/repos/coulomb/access-engine',
+    'https://forge.example/api/v1/repos/coulomb/access-engine',
+])
+async def test_resume_external_rename_with_verified_old_coordinate_redirect(client, rename_setup, location):
+    from api.services.forge_repository import ForgeRepositoryRedirected
+    repo, forge = rename_setup
+    operation, confirmation = await _operation(client, repo['id'], await _preflight(client, repo['id']))
+    forge.name = 'access-engine'  # operator renamed before the journal advanced
+    inspect = forge.inspect
+
+    async def redirected(**kwargs):
+        if kwargs['name'] == 'flex-auth':
+            raise ForgeRepositoryRedirected('https://forge.example/api/v1/repos/coulomb/flex-auth', location)
+        return await inspect(**kwargs)
+
+    forge.inspect = redirected
+    result = await _phase(client, repo['id'], operation['id'], 'forge-renamed', 'preflighted', confirmation)
+    assert result['phase'] == 'forge-renamed'
+    assert forge.rename_calls == 0
+    rebound = await _phase(client, repo['id'], operation['id'], 'statehub-rebound', 'forge-renamed', confirmation)
+    assert rebound['phase'] == 'statehub-rebound'
+
+
+@pytest.mark.asyncio
+@pytest.mark.parametrize('location,wrong_identity', [
+    ('https://evil.example/api/v1/repos/coulomb/access-engine', False),
+    ('/api/v1/repos/other/access-engine', False),
+    ('', False),
+    ('/api/v1/repos/coulomb/access-engine', True),
+])
+async def test_redirect_resume_rejects_wrong_target_or_identity(client, rename_setup, location, wrong_identity):
+    from api.services.forge_repository import ForgeRepositoryRedirected
+    repo, forge = rename_setup
+    operation, confirmation = await _operation(client, repo['id'], await _preflight(client, repo['id']))
+    forge.name = 'access-engine'
+    if wrong_identity:
+        forge.repository_id += 1
+    inspect = forge.inspect
+
+    async def redirected(**kwargs):
+        if kwargs['name'] == 'flex-auth':
+            raise ForgeRepositoryRedirected('https://forge.example/api/v1/repos/coulomb/flex-auth', location)
+        return await inspect(**kwargs)
+
+    forge.inspect = redirected
+    response = await client.post(
+        f"/repos/{repo['id']}/rename/operations/{operation['id']}/phases/forge-renamed",
+        json={'expected_phase': 'preflighted', 'confirmation': confirmation},
+    )
+    assert response.status_code == 412
+    assert forge.rename_calls == 0
+    status = (await client.get(f"/repository-renames/operations/{operation['id']}")).json()
+    assert status['phase'] == 'preflighted'
+
+
+@pytest.mark.asyncio
+async def test_forge_http_redirect_is_reported_without_following(monkeypatch):
+    import httpx
+    from api.services.forge_repository import ForgejoRepositoryGateway, ForgeRepositoryRedirected
+    seen = []
+
+    def handler(request):
+        seen.append(str(request.url))
+        return httpx.Response(307, headers={'location': '/api/v1/repos/coulomb/access-engine'})
+
+    original = httpx.AsyncClient
+    monkeypatch.setattr(httpx, 'AsyncClient', lambda **kwargs: original(transport=httpx.MockTransport(handler), **kwargs))
+    with pytest.raises(ForgeRepositoryRedirected) as error:
+        await ForgejoRepositoryGateway()._inspect_with_token(instance='https://forge.example', owner='coulomb', name='flex-auth', token='test-only')
+    assert error.value.target_url == 'https://forge.example/api/v1/repos/coulomb/access-engine'
+    assert seen == ['https://forge.example/api/v1/repos/coulomb/flex-auth']
diff --git a/tests/test_repository_rename_cli.py b/tests/test_repository_rename_cli.py
new file mode 100644
index 0000000..753a93b
--- /dev/null
+++ b/tests/test_repository_rename_cli.py
@@ -0,0 +1,495 @@
+from __future__ import annotations
+
+import json
+import stat
+import sys
+import urllib.error
+import uuid
+
+import pytest
+
+import custodian_cli
+import repository_rename_cli as rename_cli
+
+
+REPO_ID = "11111111-1111-4111-8111-111111111111"
+OPERATION_ID = "22222222-2222-4222-8222-222222222222"
+CONFIRMATION = f"rename:{REPO_ID}:flex-auth:access-engine"
+
+
+def _repo() -> dict:
+    return {
+        "id": REPO_ID,
+        "slug": "flex-auth",
+        "canonical_slug": "flex-auth",
+        "requested_slug": "flex-auth",
+        "slug_status": "canonical",
+    }
+
+
+def _operation(phase: str, *, no_op: bool = False) -> dict:
+    return {
+        "id": OPERATION_ID,
+        "repo_id": REPO_ID,
+        "phase": phase,
+        "old_slug": "flex-auth",
+        "new_slug": "access-engine",
+        "actor": "helixforge",
+        "error_code": None,
+        "error_message": None,
+        "no_op": no_op,
+    }
+
+
+def _preflight() -> dict:
+    return {
+        "schema_version": "state-hub.repository-rename-preflight.v1",
+        "repo_id": REPO_ID,
+        "old_slug": "flex-auth",
+        "new_slug": "access-engine",
+        "safe_to_apply": True,
+        "blockers": [],
+        "warnings": [],
+        "queued_edge_writes": [],
+        "preflight_token": "signed-preflight-token",
+    }
+
+
+def _run(monkeypatch, *args: str) -> None:
+    monkeypatch.setattr(sys, "argv", ["statehub", *args])
+    custodian_cli.main()
+
+
+def test_preflight_writes_private_token_file_and_redacts_stdout(
+    monkeypatch, tmp_path, capsys
+):
+    calls = []
+
+    def request(_api_base, method, path, body=None):
+        calls.append((method, path, body))
+        if method == "GET":
+            return _repo()
+        return _preflight()
+
+    monkeypatch.setattr(rename_cli, "_api_request", request)
+    output = tmp_path / "preflight.json"
+    _run(
+        monkeypatch,
+        "repo", "rename", "preflight", "flex-auth", "access-engine",
+        "--operation-id", OPERATION_ID,
+        "--output", str(output),
+        "--json",
+    )
+
+    public = json.loads(capsys.readouterr().out)
+    private = json.loads(output.read_text())
+    assert public["schema_version"] == rename_cli.CLI_SCHEMA_VERSION
+    assert public["operation_id"] == OPERATION_ID
+    assert public["next_safe_action"]["action"] == "start-operation"
+    assert public["result"]["preflight_token"].startswith("[REDACTED")
+    assert "signed-preflight-token" not in json.dumps(public)
+    assert private["result"]["preflight_token"] == "signed-preflight-token"
+    assert stat.S_IMODE(output.stat().st_mode) == 0o600
+    assert calls[1][2] == {
+        "new_slug": "access-engine",
+        "queued_edge_writes": [],
+    }
+
+
+def test_start_uses_client_operation_id_and_retry_safe_api_body(
+    monkeypatch, tmp_path, capsys
+):
+    preflight_file = tmp_path / "preflight.json"
+    preflight_file.write_text(
+        json.dumps(
+            {
+                "schema_version": rename_cli.CLI_SCHEMA_VERSION,
+                "command": "preflight",
+                "operation_id": OPERATION_ID,
+                "repo_id": REPO_ID,
+                "result": _preflight(),
+            }
+        )
+    )
+    preflight_file.chmod(0o600)
+    calls = []
+
+    def request(_api_base, method, path, body=None):
+        calls.append((method, path, body))
+        if path.startswith("/repository-renames/"):
+            raise rename_cli.RenameCLIError(
+                "not found", code="repository_rename_not_found", status_code=404
+            )
+        return _repo() if method == "GET" else _operation("preflighted")
+
+    monkeypatch.setattr(rename_cli, "_api_request", request)
+    _run(
+        monkeypatch,
+        "repo", "rename", "start", "flex-auth", "access-engine",
+        "--operation-id", OPERATION_ID,
+        "--preflight-file", str(preflight_file),
+        "--actor", "helixforge",
+        "--confirm", CONFIRMATION,
+        "--json",
+    )
+
+    result = json.loads(capsys.readouterr().out)
+    assert result["phase"] == "preflighted"
+    assert result["next_safe_action"]["phase"] == "forge-renamed"
+    create_body = calls[2][2]
+    assert create_body["operation_id"] == OPERATION_ID
+    assert create_body["preflight_token"] == "signed-preflight-token"
+    assert create_body["actor"] == "helixforge"
+    assert "signed-preflight-token" not in json.dumps(result)
+
+
+def test_start_retry_uses_operation_journal_after_old_slug_becomes_alias(
+    monkeypatch, capsys
+):
+    calls = []
+
+    def request(_api_base, method, path, body=None):
+        calls.append((method, path, body))
+        return _operation("statehub-rebound")
+
+    monkeypatch.setattr(rename_cli, "_api_request", request)
+    _run(
+        monkeypatch,
+        "repo",
+        "rename",
+        "start",
+        "flex-auth",
+        "access-engine",
+        "--operation-id",
+        OPERATION_ID,
+        "--preflight-file",
+        "/already-consumed/preflight.json",
+        "--actor",
+        "helixforge",
+        "--confirm",
+        CONFIRMATION,
+        "--json",
+    )
+
+    result = json.loads(capsys.readouterr().out)
+    assert result["phase"] == "statehub-rebound"
+    assert result["result"]["no_op"] is True
+    assert calls == [
+        (
+            "GET",
+            f"/repository-renames/operations/{OPERATION_ID}",
+            None,
+        )
+    ]
+
+
+def test_apply_uses_files_and_names_the_next_safe_phase(
+    monkeypatch, tmp_path, capsys
+):
+    evidence = tmp_path / "evidence.json"
+    evidence.write_text('{"fresh_clone": true}')
+    evidence.chmod(0o600)
+    calls = []
+
+    def request(_api_base, method, path, body=None):
+        calls.append((method, path, body))
+        if method == "GET":
+            return _operation("statehub-rebound")
+        return _operation("source-synced")
+
+    monkeypatch.setattr(rename_cli, "_api_request", request)
+    _run(
+        monkeypatch,
+        "repo", "rename", "apply", OPERATION_ID,
+        "--phase", "source-synced",
+        "--confirm", CONFIRMATION,
+        "--evidence-file", str(evidence),
+        "--json",
+    )
+
+    result = json.loads(capsys.readouterr().out)
+    assert result["state"] == "planned"
+    assert result["phase"] == "source-synced"
+    assert result["next_safe_action"]["phase"] == "consumers-verified"
+    apply_body = calls[1][2]
+    assert apply_body["expected_phase"] == "statehub-rebound"
+    assert apply_body["evidence"] == {"fresh_clone": True}
+
+
+def test_rollback_requires_separate_execute_flag(monkeypatch, capsys):
+    calls = []
+
+    def request(_api_base, method, path, body=None):
+        calls.append((method, path, body))
+        if method == "GET":
+            return _operation("source-synced")
+        return {
+            "safe_to_rollback": True,
+            "operation": _operation("rollback-preflight"),
+        }
+
+    monkeypatch.setattr(rename_cli, "_api_request", request)
+    _run(
+        monkeypatch,
+        "repo", "rename", "rollback", OPERATION_ID,
+        "--confirm", f"rollback:{OPERATION_ID}",
+        "--json",
+    )
+    result = json.loads(capsys.readouterr().out)
+    assert result["phase"] == "rollback-preflight"
+    assert result["next_safe_action"]["action"] == "execute-rollback"
+    assert [method for method, _path, _body in calls] == ["GET", "POST"]
+
+
+def test_state_hub_outage_fails_without_losing_operation_identity_or_leaking_secrets(
+    monkeypatch,
+):
+    def unavailable(*_args, **_kwargs):
+        raise urllib.error.URLError(
+            "connection refused token=super-secret authorization=Bearer-secret"
+        )
+
+    monkeypatch.setattr(rename_cli.urllib.request, "urlopen", unavailable)
+    with pytest.raises(rename_cli.RenameCLIError) as raised:
+        rename_cli._api_request(
+            "http://127.0.0.1:8000",
+            "GET",
+            f"/repository-renames/operations/{OPERATION_ID}",
+        )
+    assert raised.value.code == "state_hub_unavailable"
+    assert str(raised.value) == "State Hub is unavailable"
+    assert "super-secret" not in json.dumps(raised.value.details)
+    assert OPERATION_ID not in raised.value.details.get("reason", "")
+
+
+def test_rollback_execute_reaches_terminal_state(monkeypatch, capsys):
+    calls = []
+
+    def request(_api_base, method, path, body=None):
+        calls.append((method, path, body))
+        return (
+            _operation("rollback-preflight")
+            if method == "GET"
+            else _operation("rolled-back")
+        )
+
+    monkeypatch.setattr(rename_cli, "_api_request", request)
+    _run(
+        monkeypatch,
+        "repo", "rename", "rollback", OPERATION_ID,
+        "--confirm", f"rollback:{OPERATION_ID}",
+        "--execute",
+        "--json",
+    )
+    result = json.loads(capsys.readouterr().out)
+    assert result["state"] == "rolled-back"
+    assert result["next_safe_action"]["action"] == "none"
+    assert [method for method, _path, _body in calls] == ["GET", "POST"]
+
+
+def test_json_error_output_redacts_credentials_and_userinfo(monkeypatch, capsys):
+    def request(*_args, **_kwargs):
+        raise rename_cli.RenameCLIError(
+            "failed via https://user:password@forge.example/repo"
+            "?X-Amz-Credential=url-credential&X-Amz-Signature=url-secret",
+            code="simulated",
+            details={"authorization": "Bearer top-secret", "password": "hidden"},
+        )
+
+    monkeypatch.setattr(rename_cli, "_api_request", request)
+    with pytest.raises(SystemExit) as exc:
+        _run(
+            monkeypatch,
+            "repo", "rename", "status", OPERATION_ID, "--json",
+        )
+    assert exc.value.code == 1
+    output = capsys.readouterr().out
+    assert "user:password" not in output
+    assert "top-secret" not in output
+    assert "hidden" not in output
+    assert "url-secret" not in output
+    assert "url-credential" not in output
+    assert "[REDACTED]" in output
+
+
+def test_invalid_confirmation_stops_before_mutating_request(monkeypatch, capsys):
+    calls = []
+
+    def request(_api_base, method, path, body=None):
+        calls.append((method, path, body))
+        return _operation("preflighted")
+
+    monkeypatch.setattr(rename_cli, "_api_request", request)
+    with pytest.raises(SystemExit) as exc:
+        _run(
+            monkeypatch,
+            "repo", "rename", "apply", OPERATION_ID,
+            "--phase", "forge-renamed",
+            "--confirm", "yes",
+            "--json",
+        )
+    assert exc.value.code == 1
+    assert [method for method, _path, _body in calls] == ["GET"]
+    result = json.loads(capsys.readouterr().out)
+    assert result["error"]["code"] == "confirmation_mismatch"
+
+
+def test_unsafe_preflight_is_machine_detectable(monkeypatch, capsys):
+    def request(_api_base, method, _path, body=None):
+        del body
+        if method == "GET":
+            return _repo()
+        return {
+            **_preflight(),
+            "safe_to_apply": False,
+            "blockers": [{"code": "target_exists"}],
+            "preflight_token": None,
+        }
+
+    monkeypatch.setattr(rename_cli, "_api_request", request)
+    with pytest.raises(SystemExit) as exc:
+        _run(
+            monkeypatch,
+            "repo",
+            "rename",
+            "preflight",
+            "flex-auth",
+            "access-engine",
+            "--json",
+        )
+    assert exc.value.code == 2
+    result = json.loads(capsys.readouterr().out)
+    assert result["state"] == "failed"
+    assert result["next_safe_action"]["action"] == "resolve-blockers"
+
+
+def test_invalid_operation_id_is_stable_json(monkeypatch, capsys):
+    monkeypatch.setattr(
+        rename_cli,
+        "_api_request",
+        lambda *_args, **_kwargs: pytest.fail("API should not be called"),
+    )
+    with pytest.raises(SystemExit) as exc:
+        _run(
+            monkeypatch,
+            "repo",
+            "rename",
+            "status",
+            "not-a-uuid",
+            "--json",
+        )
+    assert exc.value.code == 1
+    result = json.loads(capsys.readouterr().out)
+    assert result["schema_version"] == rename_cli.CLI_SCHEMA_VERSION
+    assert result["state"] == "failed"
+    assert result["error"]["code"] == "invalid_operation_id"
+
+
+@pytest.mark.parametrize(
+    ("operation", "label"),
+    [
+        (_operation("preflighted"), "PLANNED"),
+        (_operation("completed"), "ACHIEVED"),
+        ({**_operation("source-synced"), "error_code": "failed"}, "FAILED"),
+        (_operation("rolled-back"), "ROLLED-BACK"),
+    ],
+)
+def test_human_status_distinguishes_lifecycle_states(
+    monkeypatch, capsys, operation, label
+):
+    monkeypatch.setattr(
+        rename_cli,
+        "_api_request",
+        lambda *_args, **_kwargs: operation,
+    )
+    if label == "FAILED":
+        with pytest.raises(SystemExit) as exc:
+            _run(monkeypatch, "repo", "rename", "status", OPERATION_ID)
+        assert exc.value.code == 2
+    else:
+        _run(monkeypatch, "repo", "rename", "status", OPERATION_ID)
+    captured = capsys.readouterr()
+    assert f"{label}: repository rename status" in captured.out + captured.err
+
+
+def test_generate_workplan_cli_writes_once_and_reports_contract(
+    monkeypatch, tmp_path, capsys
+):
+    repo_root = tmp_path / "flex-auth"
+    repo_root.mkdir()
+    (repo_root / "AGENTS.md").write_text(
+        "**Workplan prefix:** `FLEX-WP-`\n"
+    )
+    output = repo_root / "workplans" / "rename.md"
+    report = {
+        "schema_version": "state-hub.repository-rename-preflight.v1",
+        "repo_id": REPO_ID,
+        "old_slug": "flex-auth",
+        "new_slug": "access-engine",
+        "safe_to_apply": True,
+        "blockers": [],
+        "warnings": [],
+        "report_checksum": "a" * 64,
+        "preflight_token": "private-token",
+        "preflighted_at": "2026-08-29T08:00:00Z",
+        "current": {
+            "statehub": {"local_path": str(repo_root), "host_paths": {}},
+            "forge_identity": {
+                "verification_state": "verified",
+                "forge_repository_id": 42,
+            },
+            "forge_available": True,
+            "forge": {
+                "repository_id": 42,
+                "default_branch": "main",
+                "head_commit": "b" * 40,
+            },
+        },
+        "active_work": {"workplans": [], "tasks": []},
+        "affected": {"external_handoffs": []},
+    }
+    repo = {**_repo(), "local_path": str(repo_root), "host_paths": {}}
+    workplans = [
+        {
+            "slug": "flex-wp-0018",
+            "backing_filename": "FLEX-WP-0018-last.md",
+            "status": "finished",
+        }
+    ]
+
+    def request(_api_base, method, path, body=None, *, expected=dict):
+        del body
+        if path.startswith("/repos/flex-auth"):
+            return repo
+        if path.startswith("/workplans/"):
+            assert expected is list
+            return workplans
+        assert method == "POST"
+        return report
+
+    monkeypatch.setattr(rename_cli, "_api_request", request)
+    args = (
+        "repo",
+        "rename",
+        "generate-workplan",
+        "flex-auth",
+        "access-engine",
+        "--repo-path",
+        str(repo_root),
+        "--output",
+        str(output),
+        "--json",
+    )
+    _run(monkeypatch, *args)
+    result = json.loads(capsys.readouterr().out)
+    assert result["state"] == "achieved"
+    assert result["result"]["workplan_id"] == "FLEX-WP-0019"
+    assert result["result"]["workplan_prefix"] == "FLEX-WP"
+    assert result["result"]["state_hub_uuid_fields_written"] == []
+    assert "private-token" not in output.read_text()
+
+    with pytest.raises(SystemExit) as exc:
+        _run(monkeypatch, *args)
+    assert exc.value.code == 1
+    refused = json.loads(capsys.readouterr().out)
+    assert refused["error"]["code"] == "output_exists"
diff --git a/tests/test_repository_rename_docs.py b/tests/test_repository_rename_docs.py
new file mode 100644
index 0000000..bf68af3
--- /dev/null
+++ b/tests/test_repository_rename_docs.py
@@ -0,0 +1,88 @@
+from __future__ import annotations
+
+import json
+from pathlib import Path
+
+from jsonschema import Draft202012Validator, FormatChecker
+
+
+ROOT = Path(__file__).resolve().parents[1]
+RUNBOOK = ROOT / "docs" / "repository-rename-operations.md"
+HANDOFF_SCHEMA = (
+    ROOT / "docs" / "schemas" / "repository-rename-handoff-v1.schema.json"
+)
+HANDOFF_EXAMPLE = (
+    ROOT / "docs" / "examples" / "repository-rename-handoff-v1.json"
+)
+DASHBOARD_DOC = ROOT / "dashboard" / "src" / "docs" / "repository-renames.md"
+
+
+def test_repository_rename_handoff_example_validates_and_contains_no_secret_value():
+    schema = json.loads(HANDOFF_SCHEMA.read_text(encoding="utf-8"))
+    example = json.loads(HANDOFF_EXAMPLE.read_text(encoding="utf-8"))
+    Draft202012Validator.check_schema(schema)
+    Draft202012Validator(schema, format_checker=FormatChecker()).validate(example)
+
+    assert example["handoff_id"] == example["owning_work_record"]["task_id"]
+    assert example["source_repository"] == example["owning_work_record"]["repository"]
+    assert example["affected"]["paths"] or example["affected"]["graph_ids"]
+    assert example["verification"]
+    assert example["sensitive_data_prohibited"] is True
+    serialized = json.dumps(example).lower()
+    for forbidden in (
+        "bearer ",
+        "basic ",
+        "password=",
+        "token=",
+        "authorization=",
+        "begin private key",
+        "://user:",
+    ):
+        assert forbidden not in serialized
+
+
+def test_operator_runbook_names_phases_commands_owners_and_last_cleanup():
+    text = RUNBOOK.read_text(encoding="utf-8")
+    for owner in ("State Hub", "Forgejo", "HelixForge/operator", "Target repository"):
+        assert f"| {owner} |" in text
+    for phase in (
+        "preflighted",
+        "forge-renamed",
+        "statehub-rebound",
+        "source-synced",
+        "consumers-verified",
+        "completed",
+        "rollback-preflight",
+        "rolled-back",
+    ):
+        assert f"`{phase}`" in text
+    for command in (
+        "statehub repo rename preflight",
+        "statehub repo rename start",
+        "statehub repo rename apply",
+        "statehub repo rename status",
+        "statehub repo rename verify",
+        "statehub repo rename rollback",
+    ):
+        assert command in text
+    assert "### Repository-only rename checklist" in text
+    assert "### Product/runtime rename checklist" in text
+    assert "## Dashboard interpretation" in text
+    assert "## Recovery playbook" in text
+    assert "## Rollback limits" in text
+    assert "## Repository-boundary handoff format" in text
+    assert "## Cleanup is deliberately last" in text
+    assert "The old local checkout is the final removable asset" in text
+    assert "The protected old slug alias is not cleanup material" in text
+    assert "never parked only" in text
+    assert "<private-mode-0600-preflight.json>" in text
+
+
+def test_dashboard_reference_explains_alias_and_status_boundaries():
+    text = DASHBOARD_DOC.read_text(encoding="utf-8")
+    assert "/repos/<old-slug>" in text
+    assert "same repository UUID" in text
+    assert "statehub repo rename status <operation-id> --json" in text
+    assert "relationship checksums" in text
+    assert "dashboard is a read surface" in text.lower()
+    assert "old checkout is removed last" in text
diff --git a/tests/test_repository_rename_persistence.py b/tests/test_repository_rename_persistence.py
new file mode 100644
index 0000000..a260b9e
--- /dev/null
+++ b/tests/test_repository_rename_persistence.py
@@ -0,0 +1,664 @@
+from __future__ import annotations
+
+import importlib
+import uuid
+from datetime import datetime, timedelta, timezone
+
+import pytest
+from alembic.migration import MigrationContext
+from alembic.operations import Operations
+from sqlalchemy import inspect, select, text
+from sqlalchemy.exc import DBAPIError, IntegrityError
+from sqlalchemy.ext.asyncio import AsyncSession, async_sessionmaker
+
+from api.models.decision import Decision
+from api.models.domain import Domain
+from api.models.managed_repo import ManagedRepo
+from api.models.progress_event import ProgressEvent
+from api.models.repository_rename import (
+    RepositoryForgeIdentity,
+    RepositoryRenameOperation,
+    RepositorySlug,
+)
+from api.models.sbom_snapshot import SBOMSnapshot
+from api.models.task import Task
+from api.models.token_event import TokenEvent
+from api.models.workplan import Workplan
+from tests.conftest import create_test_domain, create_test_repo
+
+
+def _operation(
+    *,
+    repo_id: uuid.UUID,
+    identity_id: uuid.UUID,
+    old_slug: str,
+    new_slug: str,
+    forge_repository_id: int,
+    phase: str = "draft",
+) -> RepositoryRenameOperation:
+    now = datetime.now(timezone.utc)
+    return RepositoryRenameOperation(
+        repo_id=repo_id,
+        forge_identity_id=identity_id,
+        forge_identity_state="verified",
+        expected_provider="forgejo",
+        expected_forge_instance="https://forgejo.coulomb.social",
+        expected_forge_owner="coulomb",
+        expected_forge_repository_id=forge_repository_id,
+        expected_source_commit="a" * 40,
+        expected_default_branch="main",
+        old_slug=old_slug,
+        new_slug=new_slug,
+        old_coordinates={"slug": old_slug},
+        new_coordinates={"slug": new_slug},
+        phase=phase,
+        actor="test",
+        phase_changed_at=now,
+        preflighted_at=now if phase != "draft" else None,
+        preflight_expires_at=(now + timedelta(minutes=30)) if phase != "draft" else None,
+    )
+
+
+@pytest.mark.asyncio
+async def test_repo_registration_creates_unverified_identity_and_canonical_slug(
+    client, test_engine
+):
+    await create_test_domain(client)
+    repo = await create_test_repo(client, slug="identity-test")
+    factory = async_sessionmaker(
+        test_engine, class_=AsyncSession, expire_on_commit=False
+    )
+
+    async with factory() as session:
+        identity = await session.scalar(
+            select(RepositoryForgeIdentity).where(
+                RepositoryForgeIdentity.repo_id == uuid.UUID(repo["id"])
+            )
+        )
+        slug = await session.scalar(
+            select(RepositorySlug).where(
+                RepositorySlug.repo_id == uuid.UUID(repo["id"])
+            )
+        )
+
+    assert identity is not None
+    assert identity.verification_state == "unverified"
+    assert identity.provider is None
+    assert identity.forge_instance is None
+    assert identity.forge_owner is None
+    assert identity.forge_repository_id is None
+    assert slug is not None
+    assert (slug.slug, slug.kind, slug.protected) == (
+        "identity-test",
+        "canonical",
+        True,
+    )
+
+
+@pytest.mark.asyncio
+async def test_protected_alias_cannot_be_claimed_by_another_repository(
+    client, test_engine
+):
+    await create_test_domain(client)
+    source = await create_test_repo(client, slug="access-engine")
+    other = await create_test_repo(client, slug="another-repo")
+    factory = async_sessionmaker(
+        test_engine, class_=AsyncSession, expire_on_commit=False
+    )
+
+    async with factory() as session:
+        session.add(
+            RepositorySlug(
+                repo_id=uuid.UUID(source["id"]),
+                slug="flex-auth",
+                kind="alias",
+                protected=True,
+            )
+        )
+        await session.commit()
+
+    response = await client.post(
+        "/repos/",
+        json={
+            "domain_slug": "infotech",
+            "slug": "flex-auth",
+            "name": "Conflicting repository",
+        },
+    )
+    assert response.status_code == 409
+
+    async with factory() as session:
+        session.add(
+            RepositorySlug(
+                repo_id=uuid.UUID(other["id"]),
+                slug="flex-auth",
+                kind="alias",
+                protected=True,
+            )
+        )
+        with pytest.raises(IntegrityError):
+            await session.commit()
+
+    async with factory() as session:
+        session.add(
+            RepositorySlug(
+                repo_id=uuid.UUID(source["id"]),
+                slug="second-canonical",
+                kind="canonical",
+                protected=True,
+            )
+        )
+        with pytest.raises(IntegrityError):
+            await session.commit()
+
+
+@pytest.mark.asyncio
+async def test_forge_identity_is_unique_and_unverified_repo_cannot_open_operation(
+    client, test_engine
+):
+    await create_test_domain(client)
+    first = await create_test_repo(client, slug="first-repo")
+    second = await create_test_repo(client, slug="second-repo")
+    factory = async_sessionmaker(
+        test_engine, class_=AsyncSession, expire_on_commit=False
+    )
+    now = datetime.now(timezone.utc)
+
+    async with factory() as session:
+        first_identity = await session.scalar(
+            select(RepositoryForgeIdentity).where(
+                RepositoryForgeIdentity.repo_id == uuid.UUID(first["id"])
+            )
+        )
+        assert first_identity is not None
+        first_identity.provider = "forgejo"
+        first_identity.forge_instance = "https://forgejo.coulomb.social"
+        first_identity.forge_owner = "coulomb"
+        first_identity.forge_repository_id = 42
+        first_identity.verification_state = "verified"
+        first_identity.verified_at = now
+        first_identity.verified_by = "test"
+        first_identity.verification_evidence = {"source": "forge-api"}
+        await session.commit()
+
+    async with factory() as session:
+        second_identity = await session.scalar(
+            select(RepositoryForgeIdentity).where(
+                RepositoryForgeIdentity.repo_id == uuid.UUID(second["id"])
+            )
+        )
+        assert second_identity is not None
+        session.add(
+            _operation(
+                repo_id=uuid.UUID(second["id"]),
+                identity_id=second_identity.id,
+                old_slug="second-repo",
+                new_slug="second-repo-renamed",
+                forge_repository_id=43,
+            )
+        )
+        with pytest.raises(IntegrityError):
+            await session.commit()
+
+    async with factory() as session:
+        second_identity = await session.scalar(
+            select(RepositoryForgeIdentity).where(
+                RepositoryForgeIdentity.repo_id == uuid.UUID(second["id"])
+            )
+        )
+        assert second_identity is not None
+        second_identity.provider = "forgejo"
+        second_identity.forge_instance = "https://forgejo.coulomb.social"
+        second_identity.forge_owner = "coulomb"
+        second_identity.forge_repository_id = 42
+        second_identity.verification_state = "verified"
+        second_identity.verified_at = now
+        second_identity.verified_by = "test"
+        with pytest.raises(IntegrityError):
+            await session.commit()
+
+
+@pytest.mark.asyncio
+async def test_only_one_active_operation_can_hold_a_repo_or_target_slug(
+    client, test_engine
+):
+    await create_test_domain(client)
+    first = await create_test_repo(client, slug="first-active")
+    second = await create_test_repo(client, slug="second-active")
+    factory = async_sessionmaker(
+        test_engine, class_=AsyncSession, expire_on_commit=False
+    )
+    now = datetime.now(timezone.utc)
+    identities: dict[str, RepositoryForgeIdentity] = {}
+
+    async with factory() as session:
+        for repo, forge_repository_id in ((first, 101), (second, 102)):
+            identity = await session.scalar(
+                select(RepositoryForgeIdentity).where(
+                    RepositoryForgeIdentity.repo_id == uuid.UUID(repo["id"])
+                )
+            )
+            assert identity is not None
+            identity.provider = "forgejo"
+            identity.forge_instance = "https://forgejo.coulomb.social"
+            identity.forge_owner = "coulomb"
+            identity.forge_repository_id = forge_repository_id
+            identity.verification_state = "verified"
+            identity.verified_at = now
+            identity.verified_by = "test"
+            identities[repo["slug"]] = identity
+        await session.commit()
+
+    async with factory() as session:
+        session.add(
+            _operation(
+                repo_id=uuid.UUID(first["id"]),
+                identity_id=identities["first-active"].id,
+                old_slug="first-active",
+                new_slug="shared-target",
+                forge_repository_id=101,
+            )
+        )
+        await session.commit()
+
+    async with factory() as session:
+        session.add(
+            _operation(
+                repo_id=uuid.UUID(first["id"]),
+                identity_id=identities["first-active"].id,
+                old_slug="first-active",
+                new_slug="another-target",
+                forge_repository_id=101,
+            )
+        )
+        with pytest.raises(IntegrityError):
+            await session.commit()
+
+    async with factory() as session:
+        session.add(
+            _operation(
+                repo_id=uuid.UUID(second["id"]),
+                identity_id=identities["second-active"].id,
+                old_slug="second-active",
+                new_slug="shared-target",
+                forge_repository_id=102,
+            )
+        )
+        with pytest.raises(IntegrityError):
+            await session.commit()
+
+@pytest.mark.asyncio
+async def test_flex_auth_preflight_representation_preserves_all_existing_ids(test_engine):
+    factory = async_sessionmaker(
+        test_engine, class_=AsyncSession, expire_on_commit=False
+    )
+    repo_id = uuid.UUID("fda8ad85-a7d7-4055-8f21-902a533e59df")
+    domain_id = uuid.uuid4()
+    workplan_id = uuid.uuid4()
+    task_id = uuid.uuid4()
+    progress_id = uuid.uuid4()
+    decision_id = uuid.uuid4()
+    token_id = uuid.uuid4()
+    sbom_id = uuid.uuid4()
+    identity_id = uuid.uuid4()
+    now = datetime.now(timezone.utc)
+
+    async with factory() as session:
+        session.add_all(
+            [
+                Domain(id=domain_id, slug="net-kingdom", name="Net Kingdom"),
+                ManagedRepo(
+                    id=repo_id,
+                    domain_id=domain_id,
+                    slug="flex-auth",
+                    name="Flex Auth",
+                ),
+            ]
+        )
+        await session.flush()
+        session.add_all(
+            [
+                RepositoryForgeIdentity(
+                    id=identity_id,
+                    repo_id=repo_id,
+                    provider="forgejo",
+                    forge_instance="https://forgejo.coulomb.social",
+                    forge_owner="coulomb",
+                    forge_repository_id=42,
+                    verification_state="verified",
+                    verified_at=now,
+                    verified_by="test",
+                    verification_evidence={"source": "forge-api", "repository_id": 42},
+                ),
+                RepositorySlug(
+                    repo_id=repo_id,
+                    slug="flex-auth",
+                    kind="canonical",
+                    protected=True,
+                ),
+                Workplan(
+                    id=workplan_id,
+                    repo_id=repo_id,
+                    slug="flex-wp-0001",
+                    title="Existing work",
+                ),
+                TokenEvent(
+                    id=token_id,
+                    repo_id=repo_id,
+                    tokens_in=10,
+                    tokens_out=5,
+                ),
+                SBOMSnapshot(
+                    id=sbom_id,
+                    repo_id=repo_id,
+                    snapshot_at=now,
+                    entry_count=0,
+                    created_at=now,
+                ),
+            ]
+        )
+        await session.flush()
+        session.add_all(
+            [
+                Task(
+                    id=task_id,
+                    workplan_id=workplan_id,
+                    record_id="FLEX-WP-0001-T01",
+                    title="Existing task",
+                ),
+                Decision(
+                    id=decision_id,
+                    workplan_id=workplan_id,
+                    title="Existing decision",
+                ),
+            ]
+        )
+        await session.flush()
+        session.add(
+            ProgressEvent(
+                id=progress_id,
+                workplan_id=workplan_id,
+                task_id=task_id,
+                decision_id=decision_id,
+                event_type="note",
+                summary="Existing evidence",
+            )
+        )
+        session.add(
+            _operation(
+                repo_id=repo_id,
+                identity_id=identity_id,
+                old_slug="flex-auth",
+                new_slug="access-engine",
+                forge_repository_id=42,
+                phase="preflighted",
+            )
+        )
+        await session.flush()
+
+        assert await session.scalar(
+            select(ManagedRepo.slug).where(ManagedRepo.id == repo_id)
+        ) == "flex-auth"
+        assert await session.scalar(
+            select(RepositoryRenameOperation.expected_forge_repository_id).where(
+                RepositoryRenameOperation.repo_id == repo_id
+            )
+        ) == 42
+        assert await session.scalar(select(Workplan.id)) == workplan_id
+        assert await session.scalar(select(Task.id)) == task_id
+        assert await session.scalar(select(ProgressEvent.id)) == progress_id
+        assert await session.scalar(select(Decision.id)) == decision_id
+        assert await session.scalar(select(TokenEvent.id)) == token_id
+        assert await session.scalar(select(SBOMSnapshot.id)) == sbom_id
+
+        # No commit: this proves representability without touching either live
+        # State Hub or Forgejo and leaves the test database unchanged.
+        await session.rollback()
+
+
+@pytest.mark.asyncio
+async def test_migration_upgrade_and_downgrade_are_additive(test_engine):
+    migration = importlib.import_module(
+        "migrations.versions.f3c4d5e6a7b8_repository_rename_identity"
+    )
+    rollback_migration = importlib.import_module(
+        "migrations.versions.a4d5e6f7b8c9_allow_guarded_slug_rollback"
+    )
+    schema = f"rename_migration_{uuid.uuid4().hex}"
+    repo_ids = [uuid.uuid4(), uuid.uuid4()]
+    sentinel_ids = {
+        "workplans": uuid.uuid4(),
+        "tasks": uuid.uuid4(),
+        "progress_events": uuid.uuid4(),
+        "decisions": uuid.uuid4(),
+        "token_events": uuid.uuid4(),
+        "sbom_snapshots": uuid.uuid4(),
+    }
+
+    async with test_engine.begin() as connection:
+        def run(sync_connection):
+            quoted_schema = sync_connection.dialect.identifier_preparer.quote(schema)
+            sync_connection.exec_driver_sql(f"CREATE SCHEMA {quoted_schema}")
+            sync_connection.exec_driver_sql(
+                f"SET LOCAL search_path TO {quoted_schema}, public"
+            )
+            sync_connection.exec_driver_sql(
+                "CREATE TABLE managed_repos "
+                "(id uuid PRIMARY KEY, slug varchar(100) NOT NULL UNIQUE, name text)"
+            )
+            for table_name in sentinel_ids:
+                sync_connection.exec_driver_sql(
+                    f"CREATE TABLE {table_name} (id uuid PRIMARY KEY, marker text)"
+                )
+            sync_connection.execute(
+                text(
+                    "INSERT INTO managed_repos (id, slug, name) "
+                    "VALUES (:first, 'flex-auth', 'Flex Auth'), "
+                    "(:second, 'state-hub', 'State Hub')"
+                ),
+                {"first": repo_ids[0], "second": repo_ids[1]},
+            )
+            for table_name, sentinel_id in sentinel_ids.items():
+                sync_connection.execute(
+                    text(f"INSERT INTO {table_name} (id, marker) VALUES (:id, 'keep')"),
+                    {"id": sentinel_id},
+                )
+
+            original_op = migration.op
+            original_rollback_op = rollback_migration.op
+            migration.op = Operations(MigrationContext.configure(sync_connection))
+            rollback_migration.op = migration.op
+            try:
+                migration.upgrade()
+                rollback_migration.upgrade()
+                tables = set(inspect(sync_connection).get_table_names(schema=schema))
+                assert {
+                    "repository_forge_identities",
+                    "repository_rename_operations",
+                    "repository_slugs",
+                }.issubset(tables)
+                identity_rows = sync_connection.execute(
+                    text(
+                        "SELECT repo_id, verification_state, provider, forge_repository_id "
+                        "FROM repository_forge_identities ORDER BY repo_id"
+                    )
+                ).all()
+                assert len(identity_rows) == 2
+                assert all(
+                    row.verification_state == "unverified"
+                    and row.provider is None
+                    and row.forge_repository_id is None
+                    for row in identity_rows
+                )
+                slug_rows = sync_connection.execute(
+                    text(
+                        "SELECT repo_id, slug, kind, protected "
+                        "FROM repository_slugs ORDER BY slug"
+                    )
+                ).all()
+                assert {(row.slug, row.kind, row.protected) for row in slug_rows} == {
+                    ("flex-auth", "canonical", True),
+                    ("state-hub", "canonical", True),
+                }
+                identity_id = sync_connection.execute(
+                    text(
+                        "UPDATE repository_forge_identities SET "
+                        "provider = 'forgejo', "
+                        "forge_instance = 'https://forgejo.coulomb.social', "
+                        "forge_owner = 'coulomb', forge_repository_id = 42, "
+                        "verification_state = 'verified', verified_at = now(), "
+                        "verified_by = 'migration-test' "
+                        "WHERE repo_id = :repo_id RETURNING id"
+                    ),
+                    {"repo_id": repo_ids[0]},
+                ).scalar_one()
+                with pytest.raises(DBAPIError):
+                    with sync_connection.begin_nested():
+                        sync_connection.execute(
+                            text(
+                                "UPDATE repository_forge_identities "
+                                "SET forge_repository_id = 43 WHERE id = :id"
+                            ),
+                            {"id": identity_id},
+                        )
+                with pytest.raises(DBAPIError):
+                    with sync_connection.begin_nested():
+                        sync_connection.execute(
+                            text(
+                                "DELETE FROM repository_slugs "
+                                "WHERE repo_id = :repo_id"
+                            ),
+                            {"repo_id": repo_ids[0]},
+                        )
+
+                operation_id = uuid.uuid4()
+                sync_connection.execute(
+                    text(
+                        "INSERT INTO repository_rename_operations ("
+                        "id, repo_id, forge_identity_id, forge_identity_state, "
+                        "expected_provider, expected_forge_instance, "
+                        "expected_forge_owner, expected_forge_repository_id, "
+                        "expected_source_commit, expected_default_branch, "
+                        "old_slug, new_slug, old_coordinates, new_coordinates, "
+                        "phase, actor, phase_changed_at, evidence, created_at, updated_at"
+                        ") VALUES ("
+                        ":id, :repo_id, :identity_id, 'verified', 'forgejo', "
+                        "'https://forgejo.coulomb.social', 'coulomb', 42, "
+                        ":commit, 'main', 'flex-auth', 'access-engine', "
+                        "'{\"slug\": \"flex-auth\"}'::jsonb, "
+                        "'{\"slug\": \"access-engine\"}'::jsonb, "
+                        "'draft', 'migration-test', now(), '{}'::jsonb, now(), now()"
+                        ")"
+                    ),
+                    {
+                        "id": operation_id,
+                        "repo_id": repo_ids[0],
+                        "identity_id": identity_id,
+                        "commit": "a" * 40,
+                    },
+                )
+                sync_connection.execute(
+                    text(
+                        "UPDATE repository_rename_operations SET "
+                        "phase = 'preflighted', preflighted_at = now(), "
+                        "phase_changed_at = now() WHERE id = :id"
+                    ),
+                    {"id": operation_id},
+                )
+                with pytest.raises(DBAPIError):
+                    with sync_connection.begin_nested():
+                        sync_connection.execute(
+                            text(
+                                "UPDATE repository_rename_operations "
+                                "SET old_slug = 'rewritten' WHERE id = :id"
+                            ),
+                            {"id": operation_id},
+                        )
+                # A forward cutover may make the old canonical an alias.  T03
+                # permits restoring it only while its own operation is in the
+                # durable rollback-preflight phase.
+                sync_connection.execute(
+                    text(
+                        "UPDATE repository_slugs SET kind = 'alias', "
+                        "source_operation_id = :operation_id "
+                        "WHERE repo_id = :repo_id AND slug = 'flex-auth'"
+                    ),
+                    {"operation_id": operation_id, "repo_id": repo_ids[0]},
+                )
+                sync_connection.execute(
+                    text(
+                        "INSERT INTO repository_slugs "
+                        "(id, repo_id, slug, kind, protected, source_operation_id, created_at, updated_at) "
+                        "VALUES (gen_random_uuid(), :repo_id, 'access-engine', 'canonical', true, "
+                        ":operation_id, now(), now())"
+                    ),
+                    {"operation_id": operation_id, "repo_id": repo_ids[0]},
+                )
+                sync_connection.execute(
+                    text(
+                        "UPDATE repository_slugs SET kind = 'alias' "
+                        "WHERE repo_id = :repo_id AND slug = 'access-engine'"
+                    ),
+                    {"repo_id": repo_ids[0]},
+                )
+                with pytest.raises(DBAPIError):
+                    with sync_connection.begin_nested():
+                        sync_connection.execute(
+                            text(
+                                "UPDATE repository_slugs SET kind = 'canonical' "
+                                "WHERE repo_id = :repo_id AND slug = 'flex-auth'"
+                            ),
+                            {"repo_id": repo_ids[0]},
+                        )
+                sync_connection.execute(
+                    text(
+                        "UPDATE repository_rename_operations SET "
+                        "phase = 'rollback-preflight', phase_changed_at = now() "
+                        "WHERE id = :id"
+                    ),
+                    {"id": operation_id},
+                )
+                sync_connection.execute(
+                    text(
+                        "UPDATE repository_slugs SET kind = 'canonical' "
+                        "WHERE repo_id = :repo_id AND slug = 'flex-auth'"
+                    ),
+                    {"repo_id": repo_ids[0]},
+                )
+                with pytest.raises(DBAPIError):
+                    with sync_connection.begin_nested():
+                        sync_connection.execute(
+                            text(
+                                "DELETE FROM repository_rename_operations "
+                                "WHERE id = :id"
+                            ),
+                            {"id": operation_id},
+                        )
+                assert sync_connection.execute(
+                    text("SELECT id, slug FROM managed_repos ORDER BY slug")
+                ).all() == sorted(
+                    [(repo_ids[0], "flex-auth"), (repo_ids[1], "state-hub")],
+                    key=lambda item: item[1],
+                )
+                for table_name, sentinel_id in sentinel_ids.items():
+                    assert sync_connection.execute(
+                        text(f"SELECT id, marker FROM {table_name}")
+                    ).one() == (sentinel_id, "keep")
+
+                rollback_migration.downgrade()
+                migration.downgrade()
+                tables = set(inspect(sync_connection).get_table_names(schema=schema))
+                assert "repository_forge_identities" not in tables
+                assert "repository_rename_operations" not in tables
+                assert "repository_slugs" not in tables
+                for table_name, sentinel_id in sentinel_ids.items():
+                    assert sync_connection.execute(
+                        text(f"SELECT id, marker FROM {table_name}")
+                    ).one() == (sentinel_id, "keep")
+            finally:
+                migration.op = original_op
+                rollback_migration.op = original_rollback_op
+                sync_connection.exec_driver_sql("SET LOCAL search_path TO public")
+                sync_connection.exec_driver_sql(f"DROP SCHEMA {quoted_schema} CASCADE")
+
+        await connection.run_sync(run)
diff --git a/tests/test_repository_rename_workplan.py b/tests/test_repository_rename_workplan.py
new file mode 100644
index 0000000..e191f17
--- /dev/null
+++ b/tests/test_repository_rename_workplan.py
@@ -0,0 +1,329 @@
+from __future__ import annotations
+
+import hashlib
+from pathlib import Path
+
+import pytest
+
+from repository_rename_workplan import (
+    WorkplanGenerationError,
+    build_generation_snapshot,
+    content_checksum,
+    default_output_path,
+    render_workplan,
+    write_workplan_exclusive,
+)
+from scripts.quality_debt import collect as collect_quality_debt
+from scripts.validate_repo_adr import validate
+
+
+REPO_ID = "fda8ad85-a7d7-4055-8f21-902a533e59df"
+
+
+def _repo(path: str | None = None, **extra) -> dict:
+    return {
+        "id": REPO_ID,
+        "slug": "flex-auth",
+        "canonical_slug": "flex-auth",
+        "domain_slug": "infotech",
+        "local_path": path,
+        "host_paths": {},
+        "aliases": [],
+        **extra,
+    }
+
+
+def _preflight(**extra) -> dict:
+    report = {
+        "schema_version": "state-hub.repository-rename-preflight.v1",
+        "repo_id": REPO_ID,
+        "old_slug": "flex-auth",
+        "new_slug": "access-engine",
+        "safe_to_apply": True,
+        "blockers": [],
+        "warnings": [],
+        "report_checksum": "a" * 64,
+        "preflight_token": "must-never-appear-in-workplan",
+        "preflighted_at": "2026-08-29T08:00:00Z",
+        "current": {
+            "statehub": {
+                "repo_id": REPO_ID,
+                "local_path": None,
+                "host_paths": {},
+            },
+            "forge_identity": {
+                "verification_state": "verified",
+                "forge_repository_id": 42,
+                "forge_owner": "coulomb",
+            },
+            "forge_available": True,
+            "forge": {
+                "repository_id": 42,
+                "default_branch": "main",
+                "head_commit": "b" * 40,
+            },
+        },
+        "active_work": {"workplans": [], "tasks": []},
+        "affected": {"external_handoffs": []},
+    }
+    report.update(extra)
+    return report
+
+
+def _workplans() -> list[dict]:
+    return [
+        {
+            "id": "11111111-1111-4111-8111-111111111111",
+            "slug": "flex-wp-0017",
+            "status": "active",
+            "backing_filename": "FLEX-WP-0017-action-contract.md",
+        },
+        {
+            "id": "22222222-2222-4222-8222-222222222222",
+            "slug": "flex-wp-0018",
+            "status": "archived",
+            "backing_filename": "260828-FLEX-WP-0018-inbound-corrections.md",
+            "backing_archived": True,
+        },
+    ]
+
+
+def _repo_root(tmp_path: Path) -> Path:
+    root = tmp_path / "flex-auth"
+    root.mkdir()
+    (root / "AGENTS.md").write_text("**Workplan prefix:** `FLEX-WP-`\n")
+    return root
+
+
+def test_flex_auth_snapshot_is_deterministic_and_complete(tmp_path):
+    root = _repo_root(tmp_path)
+    report = _preflight(
+        warnings=[
+            {
+                "code": "active_work_present",
+                "message": "coordinate NetKingdom security-stack work",
+                "workplan_count": 1,
+            }
+        ],
+        affected={
+            "external_handoffs": [
+                "fabric-graph-projections",
+                "interface-change-consumers",
+            ]
+        },
+        active_work={
+            "workplans": [
+                {
+                    "id": "33333333-3333-4333-8333-333333333333",
+                    "slug": "FLEX-WP-0017",
+                    "status": "active",
+                }
+            ],
+            "tasks": [
+                {
+                    "id": "44444444-4444-4444-8444-444444444444",
+                    "record_id": "FLEX-WP-0017-T05",
+                    "status": "progress",
+                }
+            ],
+        },
+    )
+    snapshot = build_generation_snapshot(
+        repo=_repo(str(root), aliases=["flexauth-legacy"]),
+        preflight=report,
+        workplans=_workplans(),
+    )
+    first = render_workplan(snapshot, owner="codex")
+    second = render_workplan(snapshot, owner="codex")
+
+    assert first == second
+    assert content_checksum(first) == hashlib.sha256(first.encode()).hexdigest()
+    assert snapshot.prefix == "FLEX-WP"
+    assert snapshot.workplan_id == "FLEX-WP-0019"
+    assert first.count("```task\n") == 11
+    assert "id: FLEX-WP-0019-T06\nstatus: wait" in first
+    assert "id: FLEX-WP-0019-T11\nstatus: wait" in first
+    assert "state_hub_workstream_id:" not in first
+    assert "state_hub_task_id:" not in first
+    assert "must-never-appear-in-workplan" not in first
+    assert "`active_work_present`" in first
+    assert "`fabric-graph-projections`" in first
+    assert "`interface-change-consumers`" in first
+    assert "FLEX_AUTH_*" in first
+    assert "NetKingdom policy consumers" in first
+    assert "flexauth-legacy" in first
+    assert "| Credential-route catalog | `ops-warden` |" in first
+    assert "only that repository closes" in first
+    assert "state-hub.repository-rename-handoff.v1" in first
+    assert "state-hub/docs/schemas/repository-rename-handoff-v1.schema.json" in first
+    assert "fresh_clone: true" in first
+    assert "Forge numeric `forge_repository_id`" in first
+    assert "exact `head_commit`" in first
+    assert "every external handoff is `verified`" in first
+
+
+def test_generated_snapshot_passes_parser_and_quality_debt(tmp_path):
+    root = _repo_root(tmp_path)
+    snapshot = build_generation_snapshot(
+        repo=_repo(str(root)),
+        preflight=_preflight(),
+        workplans=_workplans(),
+    )
+    content = render_workplan(snapshot, owner="codex")
+    output = default_output_path(snapshot)
+    write_workplan_exclusive(output, content)
+
+    report = validate(root, skip_api=True)
+    assert report.failures == []
+    assert collect_quality_debt(
+        root, api_base=None, include_hub_intakes=False
+    ) == []
+    assert output.name.startswith("FLEX-WP-0019-")
+
+
+def test_snapshot_counts_archived_workplans_when_allocating_id(tmp_path):
+    root = _repo_root(tmp_path)
+    snapshot = build_generation_snapshot(
+        repo=_repo(str(root)),
+        preflight=_preflight(),
+        workplans=[
+            {
+                "slug": "flex-wp-0004",
+                "status": "active",
+                "backing_filename": "FLEX-WP-0004-live.md",
+            },
+            {
+                "slug": "flex-wp-0099",
+                "status": "archived",
+                "backing_filename": "260101-FLEX-WP-0099-old.md",
+                "backing_archived": True,
+            },
+        ],
+    )
+    assert snapshot.workplan_id == "FLEX-WP-0100"
+    assert snapshot.archived_workplan_ids == ("FLEX-WP-0099",)
+
+
+def test_snapshot_renders_active_work_and_private_forge_failure(tmp_path):
+    root = _repo_root(tmp_path)
+    report = _preflight(
+        safe_to_apply=False,
+        blockers=[
+            {
+                "code": "forge_unreadable",
+                "message": "private repository could not be inspected",
+            }
+        ],
+        current={
+            "statehub": {"repo_id": REPO_ID, "host_paths": {}},
+            "forge_identity": {"verification_state": "unverified"},
+            "forge_available": False,
+            "forge": None,
+        },
+        active_work={
+            "workplans": [
+                {"id": "active-uuid", "slug": "FLEX-WP-0017", "status": "active"}
+            ],
+            "tasks": [],
+        },
+    )
+    snapshot = build_generation_snapshot(
+        repo=_repo(str(root)), preflight=report, workplans=_workplans()
+    )
+    rendered = render_workplan(snapshot, owner="codex")
+    assert "status: proposed" in rendered
+    assert "`forge_unreadable`" in rendered
+    assert "`forge-identity-unverified`" in rendered
+    assert "`forge-repository-unreadable`" in rendered
+    assert "workplan `FLEX-WP-0017` / `active-uuid` is `active`" in rendered
+    assert "id: FLEX-WP-0019-T06\nstatus: wait" in rendered
+
+
+def test_snapshot_supports_missing_local_path_from_indexed_workplans(tmp_path):
+    missing = tmp_path / "not-mounted"
+    snapshot = build_generation_snapshot(
+        repo=_repo(str(missing)),
+        preflight=_preflight(),
+        workplans=_workplans(),
+    )
+    rendered = render_workplan(snapshot, owner="codex")
+    assert snapshot.prefix == "FLEX-WP"
+    assert snapshot.path_available is False
+    assert "`local-path-unavailable`" in rendered
+    with pytest.raises(WorkplanGenerationError) as exc:
+        default_output_path(snapshot)
+    assert exc.value.code == "repository_path_unavailable"
+
+
+def test_snapshot_preserves_old_alias_context(tmp_path):
+    root = _repo_root(tmp_path)
+    snapshot = build_generation_snapshot(
+        repo=_repo(str(root), aliases=["old-flex", "flex-auth"]),
+        preflight=_preflight(),
+        workplans=_workplans(),
+    )
+    rendered = render_workplan(snapshot, owner="codex")
+    assert 'protected/current aliases: `["flex-auth", "old-flex"]`' in rendered
+    assert "Retain the protected `flex-auth` alias" in rendered
+
+
+def test_existing_uuid_fields_are_untouched_and_not_copied_to_new_plan(tmp_path):
+    root = _repo_root(tmp_path)
+    workplans = root / "workplans"
+    workplans.mkdir()
+    existing = workplans / "FLEX-WP-0001-existing.md"
+    original = """---
+id: FLEX-WP-0001
+type: workplan
+title: Existing
+domain: infotech
+status: active
+owner: codex
+created: "2026-01-01"
+state_hub_workstream_id: "55555555-5555-4555-8555-555555555555"
+---
+"""
+    existing.write_text(original)
+    snapshot = build_generation_snapshot(
+        repo=_repo(str(root)), preflight=_preflight(), workplans=[]
+    )
+    rendered = render_workplan(snapshot, owner="codex")
+    assert existing.read_text() == original
+    assert "55555555-5555-4555-8555-555555555555" not in rendered
+    assert "state_hub_workstream_id:" not in rendered
+
+
+def test_exclusive_writer_refuses_existing_output(tmp_path):
+    output = tmp_path / "existing.md"
+    output.write_text("operator content\n")
+    with pytest.raises(WorkplanGenerationError) as exc:
+        write_workplan_exclusive(output, "replacement\n")
+    assert exc.value.code == "output_exists"
+    assert output.read_text() == "operator content\n"
+
+
+def test_prefix_is_never_derived_from_new_slug(tmp_path):
+    root = tmp_path / "repo"
+    root.mkdir()
+    snapshot = build_generation_snapshot(
+        repo=_repo(str(root)),
+        preflight=_preflight(),
+        workplans=_workplans(),
+    )
+    assert snapshot.prefix == "FLEX-WP"
+    assert not snapshot.workplan_id.startswith("ACCESS-ENGINE")
+
+
+def test_ambiguous_indexed_prefixes_fail_closed(tmp_path):
+    root = tmp_path / "repo"
+    root.mkdir()
+    with pytest.raises(WorkplanGenerationError) as exc:
+        build_generation_snapshot(
+            repo=_repo(str(root)),
+            preflight=_preflight(),
+            workplans=[
+                {"slug": "flex-wp-0001"},
+                {"slug": "other-wp-0001"},
+            ],
+        )
+    assert exc.value.code == "workplan_prefix_ambiguous"
diff --git a/tests/test_review_contracts.py b/tests/test_review_contracts.py
new file mode 100644
index 0000000..9a0743f
--- /dev/null
+++ b/tests/test_review_contracts.py
@@ -0,0 +1,264 @@
+import hashlib
+import json
+
+import pytest
+
+from tests.conftest import (
+    create_test_domain,
+    create_test_repo,
+    create_test_topic,
+    create_test_workplan,
+)
+
+
+def _digest(value):
+    return hashlib.sha256(
+        json.dumps(
+            value, sort_keys=True, separators=(",", ":"), ensure_ascii=True
+        ).encode()
+    ).hexdigest()
+
+
+def _contract(artifact_digest="a" * 64):
+    return {
+        "schema_version": "review-contract/v1",
+        "contract_key": "TEST-REVIEW-1",
+        "subject": {"kind": "task", "id": "TEST-WP-1-T01"},
+        "allowed_dispositions": ["approve", "request_changes"],
+        "artifacts": {
+            "docs/runbook.md": {"algorithm": "sha256", "digest": artifact_digest}
+        },
+        "owners": [
+            {
+                "id": "railiance-infra",
+                "artifact_ids": ["docs/runbook.md"],
+                "assertions": [
+                    {
+                        "id": "safe-boundary",
+                        "statement": "No live action is authorized.",
+                    }
+                ],
+                "check_ids": ["runbook-lint"],
+            }
+        ],
+        "gates": [
+            {
+                "id": "TEST-WP-1-T01",
+                "policy": "all_required",
+                "owners": ["railiance-infra"],
+            }
+        ],
+    }
+
+
+def _source(repo, path, revision):
+    return {"repo": repo, "path": path, "revision": revision}
+
+
+def _approval(contract, revision="2" * 40):
+    return {
+        "owner_id": "railiance-infra",
+        "actor": "operator:test",
+        "disposition": "approve",
+        "contract_digest": _digest(contract),
+        "artifact_hashes": {
+            "docs/runbook.md": contract["artifacts"]["docs/runbook.md"]["digest"]
+        },
+        "assertion_ids": ["safe-boundary"],
+        "checks": [{"id": "runbook-lint", "passed": True, "read_only": True}],
+        "source": _source("railiance-infra", "reviews/receipt.json", revision),
+    }
+
+
+@pytest.mark.asyncio
+async def test_review_round_trip_and_idempotency(client):
+    contract = _contract()
+    projected = await client.post(
+        "/review-contracts/projections",
+        json={
+            "contract": contract,
+            "source": _source("test-owner", "interfaces/review.json", "1" * 40),
+        },
+    )
+    assert projected.status_code == 201, projected.text
+    assert projected.json()["contract_digest"] == _digest(contract)
+
+    missing = await client.get("/review-contracts/TEST-REVIEW-1/aggregate")
+    assert missing.json()["satisfied"] is False
+    assert missing.json()["authorizes_execution"] is False
+    assert missing.json()["owners"][0]["status"] == "missing"
+
+    approval = _approval(contract)
+    first = await client.post("/review-contracts/TEST-REVIEW-1/receipts", json=approval)
+    second = await client.post(
+        "/review-contracts/TEST-REVIEW-1/receipts", json=approval
+    )
+    assert first.status_code == second.status_code == 201
+    assert first.json()["id"] == second.json()["id"]
+    assert first.json()["submitted_at"].endswith("+00:00") or first.json()[
+        "submitted_at"
+    ].endswith("Z")
+
+    result = (await client.get("/review-contracts/TEST-REVIEW-1/aggregate")).json()
+    assert result["satisfied"] is True
+    assert result["owners"][0]["status"] == "approved"
+
+
+@pytest.mark.asyncio
+async def test_receipt_rejects_wrong_owner_and_artifact_drift(client):
+    contract = _contract()
+    await client.post(
+        "/review-contracts/projections",
+        json={
+            "contract": contract,
+            "source": _source("test-owner", "interfaces/review.json", "1" * 40),
+        },
+    )
+    wrong_owner = _approval(contract)
+    wrong_owner["owner_id"] = "somebody-else"
+    assert (
+        await client.post("/review-contracts/TEST-REVIEW-1/receipts", json=wrong_owner)
+    ).status_code == 422
+
+    drift = _approval(contract)
+    drift["artifact_hashes"]["docs/runbook.md"] = "f" * 64
+    assert (
+        await client.post("/review-contracts/TEST-REVIEW-1/receipts", json=drift)
+    ).status_code == 422
+
+
+@pytest.mark.asyncio
+async def test_new_contract_revision_marks_prior_receipt_stale(client):
+    old = _contract()
+    await client.post(
+        "/review-contracts/projections",
+        json={
+            "contract": old,
+            "source": _source("test-owner", "interfaces/review.json", "1" * 40),
+        },
+    )
+    await client.post("/review-contracts/TEST-REVIEW-1/receipts", json=_approval(old))
+
+    new = _contract("b" * 64)
+    replaced = await client.post(
+        "/review-contracts/projections",
+        json={
+            "contract": new,
+            "source": _source("test-owner", "interfaces/review.json", "3" * 40),
+        },
+    )
+    assert replaced.status_code == 201, replaced.text
+    state = (await client.get("/review-contracts/TEST-REVIEW-1/aggregate")).json()
+    assert state["owners"][0]["status"] == "stale"
+    assert state["satisfied"] is False
+
+
+@pytest.mark.asyncio
+async def test_request_changes_supersedes_approval(client):
+    contract = _contract()
+    await client.post(
+        "/review-contracts/projections",
+        json={
+            "contract": contract,
+            "source": _source("test-owner", "interfaces/review.json", "1" * 40),
+        },
+    )
+    await client.post(
+        "/review-contracts/TEST-REVIEW-1/receipts", json=_approval(contract)
+    )
+    change = {
+        "owner_id": "railiance-infra",
+        "actor": "operator:test",
+        "disposition": "request_changes",
+        "contract_digest": _digest(contract),
+        "note": "Clarify the recovery owner.",
+        "source": _source("railiance-infra", "reviews/request-changes.json", "4" * 40),
+    }
+    assert (
+        await client.post("/review-contracts/TEST-REVIEW-1/receipts", json=change)
+    ).status_code == 201
+    state = (await client.get("/review-contracts/TEST-REVIEW-1/aggregate")).json()
+    assert state["owners"][0]["status"] == "request_changes"
+    assert state["satisfied"] is False
+
+
+@pytest.mark.asyncio
+async def test_required_review_blocks_legacy_decision_resolution(client):
+    domain = await create_test_domain(client)
+    topic = await create_test_topic(client, domain_slug=domain["slug"])
+    repo = await create_test_repo(client, domain_slug=domain["slug"])
+    workplan = await create_test_workplan(client, repo["id"], topic["id"])
+    decision = (
+        await client.post(
+            "/decisions/",
+            json={"title": "Run attended procedure", "workplan_id": workplan["id"]},
+        )
+    ).json()
+    contract = _contract()
+    projected = await client.post(
+        "/review-contracts/projections",
+        json={
+            "contract": contract,
+            "source": _source("test-owner", "interfaces/review.json", "1" * 40),
+            "decision_id": decision["id"],
+            "required_for_decision": True,
+        },
+    )
+    assert projected.status_code == 201, projected.text
+    blocked = await client.post(
+        f"/decisions/{decision['id']}/resolve",
+        json={
+            "rationale": "Proceed",
+            "decided_by": "operator:test",
+            "write_log": False,
+        },
+    )
+    assert blocked.status_code == 409
+
+    await client.post(
+        "/review-contracts/TEST-REVIEW-1/receipts", json=_approval(contract)
+    )
+    resolved = await client.post(
+        f"/decisions/{decision['id']}/resolve",
+        json={
+            "rationale": "Reviewed",
+            "decided_by": "operator:test",
+            "write_log": False,
+        },
+    )
+    assert resolved.status_code == 200
+
+
+@pytest.mark.asyncio
+async def test_legacy_wp0024_contract_adapter(client):
+    legacy = {
+        "interface": "railiance.owner-review",
+        "version": 1,
+        "workplan_id": "RAILIANCE-WP-0024",
+        "decisions": ["approve", "request-changes"],
+        "task_owners": {"RAILIANCE-WP-0024-T03": ["railiance-infra"]},
+        "owners": {
+            "railiance-infra": {
+                "artifacts": ["docs/runbook.md"],
+                "assertions": ["No live execution is authorized."],
+                "checks": ["node-reboot-preflight"],
+            }
+        },
+        "artifact_sha256": {"docs/runbook.md": "a" * 64},
+    }
+    result = await client.post(
+        "/review-contracts/projections",
+        json={
+            "contract": legacy,
+            "source": _source(
+                "railiance-platform",
+                "interfaces/RAILIANCE-WP-0024-owner-reviews.json",
+                "5" * 40,
+            ),
+        },
+    )
+    assert result.status_code == 201, result.text
+    body = result.json()
+    assert body["contract_key"] == "RAILIANCE-WP-0024"
+    assert body["contract_digest"] == _digest(legacy)
+    assert body["document"]["owners"][0]["assertions"][0]["id"].startswith("assertion:")
diff --git a/tests/test_routers_core.py b/tests/test_routers_core.py
index c1601f6..42ef6ea 100644
--- a/tests/test_routers_core.py
+++ b/tests/test_routers_core.py
@@ -7,6 +7,8 @@ the FastAPI ASGI app.
 """
 from __future__ import annotations
 
+import uuid
+
 import pytest
 
 
@@ -106,6 +108,29 @@ class TestRepos:
         assert r.status_code == 201
         assert r.json()["host_paths"] == {"workstation": "/srv/hosted-repo"}
 
+    async def test_patch_reclassifies_primary_domain(self, client):
+        await _create_domain(client, slug="infotech", name="Infotech")
+        await _create_domain(client, slug="financials", name="Financials")
+        await _create_repo(client, domain_slug="infotech", slug="reclassified-repo")
+
+        r = await client.patch(
+            "/repos/reclassified-repo",
+            json={
+                "domain_slug": "financials",
+                "category": "product",
+                "secondary_domains": [],
+                "capability_tags": ["accounting"],
+                "business_stake": [],
+                "business_mechanics": [],
+                "classified_at": "2026-08-23",
+                "classified_by": "human",
+                "standard_version": "1.0",
+            },
+        )
+
+        assert r.status_code == 200, r.text
+        assert r.json()["domain_slug"] == "financials"
+
 
 # ---------------------------------------------------------------------------
 # Topic tests
@@ -139,6 +164,30 @@ class TestTopics:
 # ---------------------------------------------------------------------------
 
 class TestWorkstreams:
+    async def test_create_preserves_authoritative_projection_ids(self, client):
+        await _create_domain(client)
+        repo = await _create_repo(client, slug="projection-id-repo")
+        workplan_id = str(uuid.uuid4())
+        workplan = await _create_workplan(
+            client,
+            repo["id"],
+            slug="projection-id-wp",
+            id=workplan_id,
+        )
+        assert workplan["id"] == workplan_id
+
+        task_id = str(uuid.uuid4())
+        response = await client.post(
+            "/tasks/",
+            json={
+                "id": task_id,
+                "workplan_id": workplan_id,
+                "title": "File-backed task",
+            },
+        )
+        assert response.status_code == 201, response.text
+        assert response.json()["id"] == task_id
+
     async def test_create_and_list_by_topic(self, client):
         await _create_domain(client)
         topic = await _create_topic(client)
@@ -381,6 +430,17 @@ class TestTasks:
 # ---------------------------------------------------------------------------
 
 class TestDecisions:
+    async def test_create_preserves_explicit_authoritative_id(self, client):
+        await _create_domain(client)
+        topic = await _create_topic(client)
+        expected = "22222222-2222-4222-8222-222222222222"
+        r = await client.post(
+            "/decisions/",
+            json={"id": expected, "title": "File decision", "topic_id": topic["id"]},
+        )
+        assert r.status_code == 201
+        assert r.json()["id"] == expected
+
     async def test_create_and_resolve(self, client):
         await _create_domain(client)
         topic = await _create_topic(client)
@@ -969,7 +1029,7 @@ class TestReconciliationEndpoints:
 
 
 class TestExecutionQueueEndpoints:
-    async def test_execution_semantics_separates_state_hub_and_activity_core(self, client):
+    async def test_execution_semantics_retires_workplan_launch_pickup(self, client):
         r = await client.get("/execution/semantics")
 
         assert r.status_code == 200
@@ -977,8 +1037,15 @@ class TestExecutionQueueEndpoints:
         assert "queued" in body["execution_states"]
         assert "immediate" in body["launch_modes"]
         assert "parallel" in body["concurrency_modes"]
-        assert any("launch requests" in item for item in body["state_hub_responsibility"])
-        assert any("dispatch" in item for item in body["activity_core_responsibility"])
+        assert body["launch_requests_accepted"] is False
+        assert "authoritative repository file" in body["replacements"][
+            "POST /execution/launch-requests"
+        ]
+        assert any(
+            "reject new workplan launch" in item
+            for item in body["state_hub_responsibility"]
+        )
+        assert any("do not consume" in item for item in body["activity_core_responsibility"])
 
     async def test_execution_intent_update_does_not_change_lifecycle_status(self, client):
         await _create_domain(client)
@@ -1070,7 +1137,7 @@ class TestExecutionQueueEndpoints:
         assert rows[2]["eligible"] is False
         assert rows[2]["blocked_by_workstream_ids"] == [dependency["id"]]
 
-    async def test_launch_request_records_handoff_and_updates_execution_intent(self, client):
+    async def test_launch_request_is_gone_and_does_not_update_execution_intent(self, client):
         await _create_domain(client)
         topic = await _create_topic(client)
         ws = await _create_workstream(client, topic["id"], status="ready")
@@ -1087,21 +1154,18 @@ class TestExecutionQueueEndpoints:
             "notes": "start now",
         })
 
-        assert r.status_code == 201, r.text
-        body = r.json()
-        assert body["workstream_id"] == ws["id"]
-        assert body["launch_mode"] == "immediate"
-        assert body["immediate_pickup"] is True
-        assert body["status"] == "requested"
+        assert r.status_code == 410, r.text
+        assert "no consumer picks up these rows" in r.json()["detail"]
+        assert "repo file queue" in r.headers["x-statehub-replacement"]
 
         r = await client.get(f"/workplans/{ws['id']}")
         updated = r.json()
         assert updated["status"] == "ready"
-        assert updated["execution_state"] == "launching"
-        assert updated["launch_mode"] == "immediate"
+        assert updated["execution_state"] == "manual"
+        assert updated["launch_mode"] == "manual"
 
         r = await client.get(f"/execution/launch-requests?workstream_id={ws['id']}")
-        assert len(r.json()) == 1
+        assert r.json() == []
 
 
 def _fabric_graph_export(generated_at="2026-05-23T12:00:00Z", extra_node=False):
@@ -1227,7 +1291,8 @@ def _financial_fabric_graph_export(generated_at="2026-05-24T00:00:00Z"):
         "source": {
             "producer": "railiance-fabric",
             "registry": "registry",
-            "commit": "financial-example",
+            "commit": "snapshot-set:sha256:" + ("a" * 64),
+            "path": "registry://accepted-snapshots",
             "generation_reason": "operator_refresh",
         },
         "compatibility": {
@@ -1309,6 +1374,11 @@ def _financial_fabric_graph_export(generated_at="2026-05-24T00:00:00Z"):
                     "cost_center_id": "cc.platform.shared",
                     "allocation_model": "direct",
                 },
+                "deployment_overlay": {
+                    "deployment_environment": "local",
+                    "routing_authority": "ops-hub",
+                    "route_evidence": {"observed": True, "port": 8000},
+                },
                 "evidence": {
                     "state": "declared",
                     "review_state": "accepted",
@@ -1475,6 +1545,33 @@ class TestFabricGraphReadModel:
         assert latest_flags[first_id] is False
         assert latest_flags[second_id] is True
 
+    async def test_retained_valid_import_can_be_activated_for_rollback(self, client):
+        r = await client.post("/fabric/graph-exports", json=_fabric_graph_export())
+        first_id = r.json()["import_run"]["id"]
+        r = await client.post("/fabric/graph-exports", json=_fabric_graph_export(extra_node=True))
+        second_id = r.json()["import_run"]["id"]
+
+        r = await client.post(
+            f"/fabric/graph-exports/{first_id}/activate",
+            json={"requested_by": "cutover-test"},
+        )
+        assert r.status_code == 200, r.text
+        assert r.json()["activated"] is True
+        assert r.json()["idempotent"] is False
+        assert r.json()["previous_import_id"] == second_id
+        assert r.json()["import_run"]["id"] == first_id
+        assert (await client.get("/fabric/graph/summary")).json()["node_count"] == 3
+
+        r = await client.post(f"/fabric/graph-exports/{first_id}/activate")
+        assert r.status_code == 200, r.text
+        assert r.json()["activated"] is False
+        assert r.json()["idempotent"] is True
+
+        r = await client.post(f"/fabric/graph-exports/{second_id}/activate")
+        assert r.status_code == 200, r.text
+        assert r.json()["previous_import_id"] == first_id
+        assert (await client.get("/fabric/graph/summary")).json()["node_count"] == 4
+
     async def test_read_only_queries_filter_graph_without_mutating_state_hub_entities(self, client):
         await _create_domain(client)
         topic = await _create_topic(client)
@@ -1517,6 +1614,8 @@ class TestFabricGraphReadModel:
         body = r.json()
         assert body["import_run"]["api_version"] == "railiance.fabric/v1alpha2"
         assert body["import_run"]["schema_version"] == "financial-fabric-v1"
+        assert body["import_run"]["source_commit"] == "snapshot-set:sha256:" + ("a" * 64)
+        assert body["import_run"]["source_path"] == "registry://accepted-snapshots"
         assert body["import_run"]["netkingdom_id"] == "railiance.netkingdom"
         assert body["import_run"]["actor_count"] == 3
         assert body["import_run"]["fabric_count"] == 2
@@ -1582,6 +1681,19 @@ class TestFabricGraphReadModel:
         r = await client.get("/fabric/graph/nodes")
         assert r.status_code == 404
 
+    async def test_invalid_export_with_oversized_revision_is_recorded_not_500(self, client):
+        payload = _financial_fabric_graph_export()
+        payload["source"]["commit"] = "x" * 300
+
+        r = await client.post("/fabric/graph-exports", json=payload)
+
+        assert r.status_code == 422, r.text
+        import_id = r.json()["detail"]["import_id"]
+        r = await client.get("/fabric/graph-exports?validation_status=invalid")
+        invalid = next(item for item in r.json() if item["id"] == import_id)
+        assert invalid["source_commit"] == "x" * 255
+        assert "at most 255 characters" in invalid["error_details"]["error"]
+
     async def test_legacy_fabric_exports_remain_compatible_with_null_financial_fields(self, client):
         r = await client.post("/fabric/graph-exports", json=_fabric_graph_export())
         assert r.status_code == 200, r.text
diff --git a/tests/test_sbom_nexus_compat.py b/tests/test_sbom_nexus_compat.py
new file mode 100644
index 0000000..018aa3b
--- /dev/null
+++ b/tests/test_sbom_nexus_compat.py
@@ -0,0 +1,280 @@
+"""Compatibility coverage for the reversible SBOM Nexus read facade."""
+from __future__ import annotations
+
+import uuid
+
+from api.config import settings
+from api.services.sbom_nexus import SBOMNexusError
+
+
+async def _create_repo(client) -> dict:
+    domain = await client.post(
+        "/domains/", json={"slug": "sbom-test", "name": "SBOM Test"}
+    )
+    assert domain.status_code == 201
+    repo = await client.post(
+        "/repos/",
+        json={
+            "slug": "testrepo",
+            "name": "Test Repo",
+            "domain_slug": "sbom-test",
+            "local_path": "/tmp/testrepo",
+        },
+    )
+    assert repo.status_code == 201
+    return repo.json()
+
+
+def _entry(snapshot_id: str, nexus_repo_id: str) -> dict:
+    return {
+        "id": str(uuid.uuid4()),
+        "repo_id": nexus_repo_id,
+        "repo_slug": "testrepo",
+        "snapshot_id": snapshot_id,
+        "package_name": "fastapi",
+        "package_version": "0.115.0",
+        "ecosystem": "python",
+        "license_spdx": "MIT",
+        "is_direct": True,
+        "is_dev": False,
+        "snapshot_at": "2026-08-22T12:00:00+00:00",
+        "created_at": "2026-08-22T12:00:01+00:00",
+        "source_path": "uv.lock",
+    }
+
+
+async def test_nexus_read_mode_preserves_state_hub_response_contract(client, monkeypatch):
+    repo = await _create_repo(client)
+    snapshot_id = str(uuid.uuid4())
+    nexus_repo_id = str(uuid.uuid4())
+    entry = _entry(snapshot_id, nexus_repo_id)
+    snapshot = {
+        "id": snapshot_id,
+        "repo_id": nexus_repo_id,
+        "repo_slug": "testrepo",
+        "snapshot_at": "2026-08-22T12:00:00+00:00",
+        "source": "state-hub:manual",
+        "legacy_id": snapshot_id,
+        "entry_count": 1,
+        "created_at": "2026-08-22T12:00:01+00:00",
+        "status": "imported",
+    }
+
+    async def fake_get(path: str, *, params=None):
+        if path == "/sbom/snapshots/":
+            assert params == {"repo_slug": "testrepo"}
+            return [snapshot]
+        if path == f"/sbom/snapshots/{snapshot_id}":
+            return {**snapshot, "entries": [entry]}
+        if path == "/sbom/":
+            assert params == {
+                "repo_slug": "testrepo",
+                "ecosystem": "python",
+                "is_direct": True,
+            }
+            return [entry]
+        if path == "/sbom/report/licences/":
+            return {
+                "groups": [
+                    {
+                        "license_spdx": "MIT",
+                        "count": 1,
+                        "repos": ["testrepo"],
+                        "is_copyleft": False,
+                    }
+                ],
+                "copyleft_direct_count": 0,
+                "signal_qualification": "extra Nexus field",
+            }
+        if path == "/sbom/testrepo":
+            return {
+                "repo_slug": "testrepo",
+                "last_sbom_at": "2026-08-22T12:00:00+00:00",
+                "last_attempt_at": "2026-08-22T12:00:00+00:00",
+                "entry_count": 1,
+                "entries": [entry],
+            }
+        raise AssertionError(f"unexpected Nexus path {path}")
+
+    monkeypatch.setattr(settings, "sbom_nexus_read_mode", "nexus")
+    monkeypatch.setattr("api.routers.sbom.get_json", fake_get)
+
+    snapshots = await client.get("/sbom/snapshots/?repo_slug=testrepo")
+    detail = await client.get(f"/sbom/snapshots/{snapshot_id}")
+    entries = await client.get(
+        "/sbom/?repo_slug=testrepo&ecosystem=python&is_direct=true"
+    )
+    licences = await client.get("/sbom/report/licences/")
+    repo_view = await client.get("/sbom/testrepo")
+
+    assert snapshots.status_code == 200
+    assert detail.status_code == 200
+    assert entries.status_code == 200
+    assert licences.status_code == 200
+    assert repo_view.status_code == 200
+    assert snapshots.json()[0]["id"] == snapshot_id
+    assert snapshots.json()[0]["repo_id"] == repo["id"]
+    assert snapshots.json()[0]["source"] == "manual"
+    assert detail.json()["source"] == "manual"
+    assert detail.json()["entries"][0]["repo_id"] == repo["id"]
+    assert entries.json()[0]["repo_id"] == repo["id"]
+    assert "source_path" not in entries.json()[0]
+    assert set(licences.json()) == {"groups", "copyleft_direct_count"}
+    assert repo_view.json()["entries"][0]["repo_id"] == repo["id"]
+    assert set(repo_view.json()) == {
+        "repo_slug",
+        "last_sbom_at",
+        "entry_count",
+        "entries",
+    }
+
+
+async def test_nexus_read_mode_does_not_move_ingest_write_authority(client, monkeypatch):
+    await _create_repo(client)
+
+    async def unexpected_get(*args, **kwargs):
+        raise AssertionError("POST /sbom/ingest/ must not call SBOM Nexus")
+
+    monkeypatch.setattr(settings, "sbom_nexus_read_mode", "nexus")
+    monkeypatch.setattr("api.routers.sbom.get_json", unexpected_get)
+    response = await client.post(
+        "/sbom/ingest/",
+        json={
+            "repo_slug": "testrepo",
+            "entries": [
+                {
+                    "package_name": "fastapi",
+                    "package_version": "0.115.0",
+                    "ecosystem": "python",
+                    "license_spdx": "MIT",
+                }
+            ],
+        },
+    )
+
+    assert response.status_code == 200
+    assert response.json()["ingested"] == 1
+
+
+async def test_nexus_write_mode_moves_authority_and_updates_projection(client, monkeypatch):
+    repo = await _create_repo(client)
+    snapshot_id = str(uuid.uuid4())
+    observed = {}
+
+    async def fake_post(path: str, *, body):
+        observed["path"] = path
+        observed["body"] = body
+        return {
+            "repo_slug": "testrepo",
+            "snapshot_id": snapshot_id,
+            "ingested": 1,
+            "snapshot_at": "2026-08-22T13:00:00Z",
+            "status": "ingested",
+        }
+
+    monkeypatch.setattr(settings, "sbom_nexus_read_mode", "legacy")
+    monkeypatch.setattr(settings, "sbom_nexus_write_mode", "nexus")
+    monkeypatch.setattr("api.routers.sbom.post_json", fake_post)
+    response = await client.post(
+        "/sbom/ingest/",
+        json={
+            "repo_slug": "testrepo",
+            "entries": [
+                {
+                    "package_name": "fastapi",
+                    "package_version": "0.115.0",
+                    "ecosystem": "python",
+                    "license_spdx": "MIT",
+                }
+            ],
+        },
+    )
+
+    assert response.status_code == 200
+    assert response.json() == {
+        "repo_slug": "testrepo",
+        "snapshot_id": snapshot_id,
+        "ingested": 1,
+        "snapshot_at": "2026-08-22T13:00:00Z",
+    }
+    assert observed["path"] == "/sbom/ingest/"
+    assert observed["body"]["entries"][0]["ecosystem"] == "python"
+
+    legacy_snapshots = await client.get("/sbom/snapshots/?repo_slug=testrepo")
+    projected_repo = await client.get("/repos/testrepo")
+    assert legacy_snapshots.json() == []
+    assert projected_repo.json()["id"] == repo["id"]
+    assert projected_repo.json()["last_sbom_at"] == "2026-08-22T13:00:00Z"
+    assert projected_repo.json()["sbom_source"] == "sbom-nexus"
+
+
+async def test_nexus_failure_is_visible_and_does_not_fall_back(client, monkeypatch):
+    await _create_repo(client)
+
+    async def unavailable(*args, **kwargs):
+        raise SBOMNexusError(502, "SBOM Nexus is unavailable: ConnectError")
+
+    monkeypatch.setattr(settings, "sbom_nexus_read_mode", "nexus")
+    monkeypatch.setattr("api.routers.sbom.get_json", unavailable)
+    response = await client.get("/sbom/snapshots/")
+
+    assert response.status_code == 502
+    assert response.json()["detail"] == "SBOM Nexus is unavailable: ConnectError"
+
+
+async def test_repo_reads_project_nexus_last_attempt_at(client, monkeypatch):
+    await _create_repo(client)
+
+    async def repositories(path: str, **kwargs):
+        assert path == "/repositories/"
+        return [
+            {
+                "slug": "testrepo",
+                "last_attempt_at": "2026-08-22T14:00:00Z",
+            }
+        ]
+
+    monkeypatch.setattr(settings, "sbom_nexus_read_mode", "nexus")
+    monkeypatch.setattr("api.routers.repos.get_sbom_nexus_json", repositories)
+
+    collection = await client.get("/repos/")
+    detail = await client.get("/repos/testrepo")
+
+    assert collection.status_code == 200
+    assert detail.status_code == 200
+    assert collection.json()[0]["last_sbom_at"] == "2026-08-22T14:00:00Z"
+    assert collection.json()[0]["sbom_source"] == "sbom-nexus"
+    assert detail.json()["last_sbom_at"] == "2026-08-22T14:00:00Z"
+    assert detail.json()["sbom_source"] == "sbom-nexus"
+
+
+async def test_state_summaries_use_nexus_metrics(client, monkeypatch):
+    async def sbom_metrics(path: str, **kwargs):
+        if path == "/sbom/snapshots/":
+            return [
+                {
+                    "snapshot_at": "2026-08-22T12:00:00Z",
+                    "entry_count": 3,
+                },
+                {
+                    "snapshot_at": "2026-08-22T14:00:00Z",
+                    "entry_count": 5,
+                },
+            ]
+        if path == "/sbom/report/licences/":
+            return {"groups": [], "copyleft_direct_count": 7}
+        raise AssertionError(f"unexpected Nexus path {path}")
+
+    monkeypatch.setattr(settings, "sbom_nexus_read_mode", "nexus")
+    monkeypatch.setattr("api.routers.state.get_sbom_nexus_json", sbom_metrics)
+    monkeypatch.setattr("api.services.summary_cache.get_sbom_nexus_json", sbom_metrics)
+
+    summary = await client.get("/state/summary", params={"refresh": "true"})
+    overview = await client.get("/state/overview", params={"refresh": "true"})
+
+    assert summary.status_code == 200
+    assert overview.status_code == 200
+    assert summary.json()["licence_risk_count"] == 7
+    assert overview.json()["licence_risk_count"] == 7
+    assert overview.json()["sbom_snapshot_count"] == 2
+    assert overview.json()["sbom_package_total"] == 8
diff --git a/tests/test_schema_state.py b/tests/test_schema_state.py
new file mode 100644
index 0000000..ed8f98e
--- /dev/null
+++ b/tests/test_schema_state.py
@@ -0,0 +1,56 @@
+"""Schema/code agreement must be observable (STATE-WP-0083-T07).
+
+Central served two revisions behind the code with no signal at all. The API
+started fine and would only have failed when a request touched a missing table.
+"""
+
+from __future__ import annotations
+
+import pytest
+
+from api.services import schema_state as ss
+
+
+class _Session:
+    def __init__(self, revision=None, raises=False):
+        self._revision = revision
+        self._raises = raises
+
+    async def execute(self, *_a, **_k):
+        if self._raises:
+            raise RuntimeError("no connection")
+        rev = self._revision
+
+        class R:
+            def scalar(self_inner):
+                return rev
+
+        return R()
+
+
+def test_code_head_is_readable_from_the_shipped_migrations():
+    """Must not require a database: it is what the code expects, not what ran."""
+    assert ss.code_head_revision()
+
+
+@pytest.mark.asyncio
+async def test_matching_revision_reports_ok(monkeypatch):
+    monkeypatch.setattr(ss, "code_head_revision", lambda: "abc123")
+    assert (await ss.schema_state(_Session("abc123")))["status"] == "ok"
+
+
+@pytest.mark.asyncio
+async def test_behind_revision_is_reported_with_both_values(monkeypatch):
+    monkeypatch.setattr(ss, "code_head_revision", lambda: "newrev")
+    state = await ss.schema_state(_Session("oldrev"))
+    assert state["status"] == "behind"
+    assert state["applied"] == "oldrev" and state["expected"] == "newrev"
+
+
+@pytest.mark.asyncio
+async def test_unknown_is_not_reported_as_ok(monkeypatch):
+    """An instance that cannot establish agreement must not claim it."""
+    monkeypatch.setattr(ss, "code_head_revision", lambda: "newrev")
+    assert (await ss.schema_state(_Session(raises=True)))["status"] == "unknown"
+    monkeypatch.setattr(ss, "code_head_revision", lambda: None)
+    assert (await ss.schema_state(_Session("oldrev")))["status"] == "unknown"
diff --git a/tests/test_statehub_register_cli.py b/tests/test_statehub_register_cli.py
index a5f7b05..9863342 100644
--- a/tests/test_statehub_register_cli.py
+++ b/tests/test_statehub_register_cli.py
@@ -3,6 +3,7 @@ from __future__ import annotations
 import argparse
 import json
 import sys
+import tomllib
 from pathlib import Path
 
 import pytest
@@ -11,6 +12,11 @@ import custodian_cli
 from custodian_cli import cmd_fix_consistency
 from statehub_register import (
     RegisterInference,
+    detect_project_flavor_signal,
+    project_registration_plan,
+    refuse_project_flavor_scaffold,
+    run_register,
+    _find_or_create_topic,
     _invoke_llm,
     _normalise_inference,
     _parse_json_object,
@@ -101,6 +107,348 @@ def test_write_registration_files_primes_codex_repo(tmp_path: Path):
     assert "statehub fix-consistency" in workplan
 
 
+def test_detect_project_flavor_from_classification(tmp_path: Path):
+    (tmp_path / ".repo-classification.yaml").write_text(
+        "repo_classification:\n  category: project\n  domain: infotech\n",
+        encoding="utf-8",
+    )
+
+    assert detect_project_flavor_signal(tmp_path) == (
+        ".repo-classification.yaml category=project"
+    )
+
+
+def test_detect_project_flavor_from_goal_md(tmp_path: Path):
+    (tmp_path / "GOAL.md").write_text(
+        "---\nrepo_flavor: project\n---\n\n# Project goal\n",
+        encoding="utf-8",
+    )
+
+    assert detect_project_flavor_signal(tmp_path) == "GOAL.md repo_flavor=project"
+
+
+def test_detect_project_flavor_from_prj_directory_name(tmp_path: Path):
+    repo = tmp_path / "prj-example"
+    repo.mkdir()
+
+    assert detect_project_flavor_signal(repo) == "slug prefix prj- (prj-example)"
+
+
+def test_detect_project_flavor_from_repo_slug_argument(tmp_path: Path):
+    repo = tmp_path / "example"
+    repo.mkdir()
+
+    assert detect_project_flavor_signal(repo) is None
+    assert detect_project_flavor_signal(repo, "prj-example") == (
+        "slug prefix prj- (prj-example)"
+    )
+
+
+def test_classification_project_takes_precedence_over_slug(tmp_path: Path):
+    repo = tmp_path / "prj-example"
+    repo.mkdir()
+    (repo / ".repo-classification.yaml").write_text(
+        "repo_classification:\n  category: project\n  domain: infotech\n",
+        encoding="utf-8",
+    )
+
+    assert detect_project_flavor_signal(repo) == (
+        ".repo-classification.yaml category=project"
+    )
+
+
+def test_durable_repo_is_not_project_flavor(tmp_path: Path):
+    (tmp_path / ".repo-classification.yaml").write_text(
+        "repo_classification:\n  category: tooling\n  domain: infotech\n",
+        encoding="utf-8",
+    )
+
+    assert detect_project_flavor_signal(tmp_path, "demo-service") is None
+
+
+def test_refuse_project_flavor_scaffold_points_at_rmgr(tmp_path: Path):
+    repo = tmp_path / "prj-example"
+    repo.mkdir()
+
+    with pytest.raises(SystemExit, match="rmgr scaffold") as exc:
+        refuse_project_flavor_scaffold(repo)
+
+    message = str(exc.value)
+    assert "refuses to scaffold a project-flavor repository" in message
+    assert "never PRJ-WP-" in message
+    assert str(repo) in message
+
+
+def test_run_register_refuses_prj_repo_without_writing_or_calling_api(
+    tmp_path: Path, monkeypatch: pytest.MonkeyPatch
+):
+    repo = tmp_path / "prj-example"
+    repo.mkdir()
+    (repo / ".repo-classification.yaml").write_text(
+        "repo_classification:\n  category: project\n  domain: infotech\n",
+        encoding="utf-8",
+    )
+    called: list[str] = []
+    monkeypatch.setattr(
+        "statehub_register._check_api",
+        lambda *_args, **_kwargs: called.append("api"),
+    )
+    monkeypatch.setattr(
+        "statehub_register.write_registration_files",
+        lambda **_kwargs: called.append("write") or [],
+    )
+
+    args = argparse.Namespace(path=str(repo), repo_slug=None)
+
+    with pytest.raises(SystemExit, match="rmgr scaffold"):
+        run_register(args)
+
+    assert called == []
+    assert not (repo / "INTENT.md").exists()
+    assert not (repo / "workplans").exists()
+
+
+def test_project_registration_plan_durable_vs_refuse_vs_delegate(tmp_path: Path):
+    durable = tmp_path / "demo-service"
+    durable.mkdir()
+    assert project_registration_plan(durable) == ("durable", None)
+
+    fresh = tmp_path / "prj-example"
+    fresh.mkdir()
+    assert project_registration_plan(fresh)[0] == "refuse"
+    assert project_registration_plan(fresh, wp_prefix="EXCO-WP") == (
+        "delegate",
+        "EXCO-WP",
+    )
+
+    (fresh / "GOAL.md").write_text(
+        "---\nrepo_flavor: project\n---\n# Goal\n", encoding="utf-8"
+    )
+    assert project_registration_plan(fresh) == ("register-only", None)
+    assert project_registration_plan(fresh, wp_prefix="EXCO-WP") == (
+        "register-only",
+        None,
+    )
+
+
+def _stub_register_io(monkeypatch: pytest.MonkeyPatch):
+    written: list[dict] = []
+    registered: list[tuple] = []
+
+    monkeypatch.setattr("statehub_register._check_api", lambda *_a, **_k: None)
+    monkeypatch.setattr(
+        "statehub_register._api_get",
+        lambda path, *_a, **_k: (
+            [{"slug": "infotech", "id": "dom-1"}]
+            if str(path).startswith("/domains")
+            else [{"id": "topic-1", "slug": "infotech", "domain_slug": "infotech"}]
+        ),
+    )
+    monkeypatch.setattr(
+        "statehub_register.write_registration_files",
+        lambda **kwargs: written.append(kwargs) or [],
+    )
+    monkeypatch.setattr(
+        "statehub_register._register_or_update_repo",
+        lambda **kwargs: registered.append(("repo", kwargs)) or {"id": "repo-1"},
+    )
+    monkeypatch.setattr(
+        "statehub_register._register_host_path",
+        lambda *a, **k: registered.append(("path", a, k)),
+    )
+    monkeypatch.setattr("statehub_register._record_progress", lambda *_a, **_k: None)
+    return written, registered
+
+
+def _register_args(path: Path, **overrides):
+    values = {
+        "path": str(path),
+        "repo_slug": None,
+        "wp_prefix": None,
+        "domain": "infotech",
+        "topic": None,
+        "description": "Test project.",
+        "intent": None,
+        "api_base": "http://unused",
+        "no_llm": True,
+        "force": False,
+        "llm_provider": "mock",
+        "llm_model": None,
+        "llm_api_key": None,
+        "llm_timeout": 5,
+    }
+    values.update(overrides)
+    return argparse.Namespace(**values)
+
+
+def test_run_register_delegates_project_scaffold_and_skips_templating(
+    tmp_path: Path, monkeypatch: pytest.MonkeyPatch
+):
+    repo = tmp_path / "prj-example"
+    repo.mkdir()
+    written, registered = _stub_register_io(monkeypatch)
+    delegated: list[dict] = []
+
+    def fake_delegate(project_path, **kwargs):
+        delegated.append(kwargs)
+        (project_path / "GOAL.md").write_text(
+            "---\nrepo_flavor: project\n---\n# Goal\n", encoding="utf-8"
+        )
+        return {"status": "applied"}
+
+    monkeypatch.setattr("statehub_register.delegate_project_scaffold", fake_delegate)
+
+    run_register(_register_args(repo, wp_prefix="EXCO-WP"))
+
+    assert delegated == [
+        {
+            "slug": "prj-example",
+            "wp_prefix": "EXCO-WP",
+            "domain": "infotech",
+            "force": False,
+        }
+    ]
+    assert written == []
+    assert [kind for kind, *_ in registered] == ["repo", "path"]
+    assert not (repo / "INTENT.md").exists()
+    assert (repo / "GOAL.md").is_file()
+
+
+def test_run_register_existing_project_skips_scaffold_and_templating(
+    tmp_path: Path, monkeypatch: pytest.MonkeyPatch
+):
+    repo = tmp_path / "prj-example"
+    repo.mkdir()
+    (repo / "GOAL.md").write_text(
+        "---\nrepo_flavor: project\n---\n# Goal\n", encoding="utf-8"
+    )
+    written, registered = _stub_register_io(monkeypatch)
+    monkeypatch.setattr(
+        "statehub_register.delegate_project_scaffold",
+        lambda *_a, **_k: (_ for _ in ()).throw(AssertionError("should not scaffold")),
+    )
+
+    run_register(_register_args(repo))
+
+    assert written == []
+    assert [kind for kind, *_ in registered] == ["repo", "path"]
+    assert not (repo / "INTENT.md").exists()
+
+
+def test_run_register_honors_explicit_topic_slug(
+    tmp_path: Path, monkeypatch: pytest.MonkeyPatch
+):
+    repo = tmp_path / "demo-service"
+    repo.mkdir()
+    written, registered = _stub_register_io(monkeypatch)
+    monkeypatch.setattr(
+        "statehub_register._api_get",
+        lambda path, *_a, **_k: (
+            [{"slug": "infotech", "id": "dom-1"}]
+            if str(path).startswith("/domains")
+            else [
+                {"id": "topic-1", "slug": "custodian", "domain_slug": "infotech"},
+                {"id": "topic-2", "slug": "activity-core", "domain_slug": "infotech"},
+            ]
+        ),
+    )
+
+    run_register(
+        _register_args(
+            repo,
+            topic="activity-core",
+            intent="Register the demo service with the requested topic.",
+        )
+    )
+
+    assert written[0]["topic_id"] == "topic-2"
+    repo_registration = next(item for kind, item in registered if kind == "repo")
+    assert repo_registration["topic_id"] == "topic-2"
+
+
+def test_topic_selection_refuses_ambiguous_domain(
+    monkeypatch: pytest.MonkeyPatch,
+):
+    monkeypatch.setattr(
+        "statehub_register._api_get",
+        lambda *_a, **_k: [
+            {"id": "topic-1", "slug": "custodian", "domain_slug": "infotech"},
+            {"id": "topic-2", "slug": "activity-core", "domain_slug": "infotech"},
+        ],
+    )
+
+    with pytest.raises(SystemExit, match=r"Pass --topic <slug>"):
+        _find_or_create_topic(
+            "infotech",
+            "demo",
+            "demo",
+            RegisterInference(),
+            "http://unused",
+        )
+
+
+def test_topic_selection_uses_exact_inferred_topic(
+    monkeypatch: pytest.MonkeyPatch,
+):
+    topics = [
+        {"id": "topic-1", "slug": "custodian", "domain_slug": "infotech"},
+        {"id": "topic-2", "slug": "activity-core", "domain_slug": "infotech"},
+    ]
+    monkeypatch.setattr("statehub_register._api_get", lambda *_a, **_k: topics)
+
+    selected = _find_or_create_topic(
+        "infotech",
+        "activity-core",
+        "activity-core",
+        RegisterInference(topic_slug="activity-core"),
+        "http://unused",
+    )
+
+    assert selected == topics[1]
+
+
+def test_topic_selection_refuses_cross_domain_topic(
+    monkeypatch: pytest.MonkeyPatch,
+):
+    monkeypatch.setattr(
+        "statehub_register._api_get",
+        lambda *_a, **_k: [
+            {"id": "topic-1", "slug": "activity-core", "domain_slug": "agents"},
+        ],
+    )
+
+    with pytest.raises(SystemExit, match=r"belongs to domain\(s\) agents"):
+        _find_or_create_topic(
+            "infotech",
+            "demo",
+            "demo",
+            RegisterInference(),
+            "http://unused",
+            requested_topic_slug="activity-core",
+        )
+
+
+def test_topic_selection_refuses_missing_explicit_topic(
+    monkeypatch: pytest.MonkeyPatch,
+):
+    monkeypatch.setattr(
+        "statehub_register._api_get",
+        lambda *_a, **_k: [
+            {"id": "topic-1", "slug": "custodian", "domain_slug": "infotech"},
+        ],
+    )
+
+    with pytest.raises(SystemExit, match=r"Available: custodian"):
+        _find_or_create_topic(
+            "infotech",
+            "demo",
+            "demo",
+            RegisterInference(),
+            "http://unused",
+            requested_topic_slug="activity-core",
+        )
+
+
 def test_write_registration_files_is_idempotent_without_force(tmp_path: Path):
     inference = RegisterInference()
     kwargs = {
@@ -244,3 +592,20 @@ def test_fix_consistency_remote_requires_explicit_repo_or_all(monkeypatch, tmp_p
 
     assert exc.value.code == 1
     assert calls == []
+
+
+def test_quality_debt_cli_support_files_ship_in_the_wheel():
+    config = tomllib.loads(
+        (Path(__file__).resolve().parents[1] / "pyproject.toml").read_text(
+            encoding="utf-8"
+        )
+    )
+    force_include = config["tool"]["hatch"]["build"]["targets"]["wheel"][
+        "force-include"
+    ]
+
+    assert force_include["scripts/quality_debt.py"] == "scripts/quality_debt.py"
+    assert (
+        force_include["scripts/quality_assessment.py"]
+        == "scripts/quality_assessment.py"
+    )
diff --git a/tests/test_suggestions.py b/tests/test_suggestions.py
index 54a3b47..801fba3 100644
--- a/tests/test_suggestions.py
+++ b/tests/test_suggestions.py
@@ -1,158 +1,111 @@
-"""Demand-weighted suggestion backlog tests (STATE-WP-0061)."""
+"""Suggestion (legacy) tests — CUST-WP-0061-T06, 2026-07-21.
+
+The suggestions table/router is retired to read-only legacy: a fresh
+`intake` work-record entity replaces it (canon/standards/
+work-record-types_v0.1.md), not a rename. The 10 records still open at
+retirement were migrated to file-backed intake records (see
+the-custodian/intake-legacy-suggestions-migration.md) and declined here.
+
+These tests verify the retirement itself: every mutation endpoint 410s;
+GET/list still works for the historical record. Since creation is
+retired, historical rows are seeded directly via the ORM/DB session
+(bypassing the retired POST) rather than through the API.
+"""
 from __future__ import annotations
 
+import uuid
+
 import pytest
+from sqlalchemy.ext.asyncio import AsyncSession, async_sessionmaker
 
-from tests.conftest import create_test_repo, create_test_workplan
-from tests.test_capability_requests import _create_domain, _create_topic
+from tests.test_capability_requests import _create_domain
 
 
-async def _create_suggestion(client, **kwargs):
-    payload = {
-        "domain": "custodian",
-        "title": "Issue-core ingestion API key path",
-        "description": "OpenBao KV path for issue-core ingestion",
-        "origin_ref": "issue-core-ingestion-api-key",
-        "base_value": 4.0,
-        "job_size": 2.0,
-    }
-    payload.update(kwargs)
-    r = await client.post("/suggestions/", json=payload)
-    assert r.status_code == 201, r.text
-    return r.json()
+async def _seed_suggestion(test_engine, *, domain_slug: str, **overrides) -> str:
+    """Insert a Suggestion row directly, bypassing the retired POST
+    endpoint — this is now the only way historical rows get created."""
+    from api.models.domain import Domain
+    from api.models.suggestion import Suggestion
+    from sqlalchemy import select
+
+    factory = async_sessionmaker(test_engine, class_=AsyncSession, expire_on_commit=False)
+    async with factory() as session:
+        domain_id = (
+            await session.execute(select(Domain.id).where(Domain.slug == domain_slug))
+        ).scalar_one()
+        suggestion = Suggestion(
+            domain_id=domain_id,
+            title=overrides.get("title", "Legacy suggestion"),
+            description=overrides.get("description"),
+            origin=overrides.get("origin"),
+            origin_ref=overrides.get("origin_ref"),
+            base_value=overrides.get("base_value", 3.0),
+            job_size=overrides.get("job_size", 3.0),
+        )
+        session.add(suggestion)
+        await session.commit()
+        await session.refresh(suggestion)
+        return str(suggestion.id)
 
 
 @pytest.mark.asyncio
-async def test_create_list_and_wsjf_ranking(client):
-    await _create_domain(client, "custodian", "Custodian")
-    low = await _create_suggestion(
-        client,
-        title="Low priority path",
-        origin_ref="low-priority",
-        base_value=1.0,
-        job_size=5.0,
-    )
-    high = await _create_suggestion(
-        client,
-        title="High priority path",
-        origin_ref="high-priority",
-        base_value=5.0,
-        job_size=1.0,
-    )
+class TestSuggestionsRetired:
+    async def test_create_returns_410(self, client):
+        await _create_domain(client, "custodian", "Custodian")
+        r = await client.post("/suggestions/", json={
+            "domain": "custodian",
+            "title": "New suggestion attempt",
+        })
+        assert r.status_code == 410
+        assert "intake" in r.json()["detail"].lower()
 
-    r = await client.get("/suggestions/?rank=wsjf")
-    assert r.status_code == 200
-    ranked = r.json()
-    assert ranked[0]["id"] == high["id"]
-    assert ranked[0]["wsjf"] > ranked[1]["wsjf"]
+    async def test_vet_returns_410(self, client, test_engine):
+        await _create_domain(client, "custodian", "Custodian")
+        sid = await _seed_suggestion(test_engine, domain_slug="custodian")
+        r = await client.post(f"/suggestions/{sid}/vet", json={"note": "x"})
+        assert r.status_code == 410
 
-    await client.post(
-        f"/suggestions/{low['id']}/bump-relevance",
-        json={"reason": "hit again", "author": "agent-a"},
-    )
-    await client.post(
-        f"/suggestions/{low['id']}/bump-relevance",
-        json={"reason": "hit again", "author": "agent-b"},
-    )
-    r2 = await client.get(f"/suggestions/{low['id']}")
-    assert r2.json()["relevance"] == 2
+    async def test_decline_returns_410(self, client, test_engine):
+        await _create_domain(client, "custodian", "Custodian")
+        sid = await _seed_suggestion(test_engine, domain_slug="custodian")
+        r = await client.post(f"/suggestions/{sid}/decline", json={"note": "x"})
+        assert r.status_code == 410
 
+    async def test_promote_returns_410(self, client, test_engine):
+        await _create_domain(client, "custodian", "Custodian")
+        sid = await _seed_suggestion(test_engine, domain_slug="custodian")
+        r = await client.post(f"/suggestions/{sid}/promote", json={})
+        assert r.status_code == 410
 
-@pytest.mark.asyncio
-async def test_bump_relevance_debounces_duplicate_explicit_bumps(client):
-    await _create_domain(client, "custodian", "Custodian")
-    suggestion = await _create_suggestion(client)
-    first = await client.post(
-        f"/suggestions/{suggestion['id']}/bump-relevance",
-        json={"reason": "routing gap", "author": "codex"},
-    )
-    second = await client.post(
-        f"/suggestions/{suggestion['id']}/bump-relevance",
-        json={"reason": "routing gap", "author": "codex"},
-    )
-    assert first.status_code == 200
-    assert second.status_code == 200
-    refreshed = await client.get(f"/suggestions/{suggestion['id']}")
-    assert refreshed.json()["relevance"] == 1
+    async def test_bump_relevance_returns_410(self, client, test_engine):
+        await _create_domain(client, "custodian", "Custodian")
+        sid = await _seed_suggestion(test_engine, domain_slug="custodian")
+        r = await client.post(f"/suggestions/{sid}/bump-relevance", json={})
+        assert r.status_code == 410
 
+    async def test_reads_are_retired_too(self, client, test_engine):
+        """Slice E1 (STATE-WP-0079-T05, 2026-08-20): reads were kept live only
+        to keep the historical backlog reachable. That history is archived at
+        the-custodian/docs/archived-suggestion-backlog.md, so the read surface
+        is retired as well."""
+        await _create_domain(client, "custodian", "Custodian")
+        sid = await _seed_suggestion(
+            test_engine, domain_slug="custodian",
+            title="Historical gated-need signal",
+            origin="WARDEN-WP-0012", origin_ref="example",
+        )
 
-@pytest.mark.asyncio
-async def test_vet_decline_and_promote_flow(client):
-    await _create_domain(client, "custodian", "Custodian")
-    topic = await _create_topic(client, "custodian")
-    repo = await create_test_repo(client, domain_slug="custodian", slug="state-hub")
-    workplan = await create_test_workplan(
-        client, repo_id=repo["id"], topic_id=topic["id"], slug="state-wp-0061", title="WP-0061",
-    )
+        for path in (f"/suggestions/{sid}", "/suggestions/", f"/suggestions/{sid}/notes"):
+            r = await client.get(path)
+            assert r.status_code == 410, path
 
-    suggestion = await _create_suggestion(
-        client,
-        workplan_id=workplan["id"],
-        title="Promotable gated need",
-        origin_ref="promote-me",
-    )
+    async def test_unknown_id_also_410s(self, client):
+        """The whole prefix is retired, so there is nothing left to 404 on."""
+        r = await client.get(f"/suggestions/{uuid.uuid4()}")
+        assert r.status_code == 410
 
-    vet = await client.post(
-        f"/suggestions/{suggestion['id']}/vet",
-        json={"note": "Vetted as requirement", "author": "codex"},
-    )
-    assert vet.status_code == 200
-    assert vet.json()["stage"] == "requirement"
-
-    bad_promote = await client.post(
-        f"/suggestions/{suggestion['id']}/promote",
-        json={"note": "too early"},
-    )
-    assert bad_promote.status_code == 200
-
-    promoted = bad_promote.json()
-    assert promoted["stage"] == "promoted"
-    assert promoted["promoted_task_id"] is not None
-
-    task = await client.get(f"/tasks/{promoted['promoted_task_id']}")
-    assert task.status_code == 200
-    assert task.json()["title"] == "Promotable gated need"
-
-    fresh = await _create_suggestion(client, title="Decline me", origin_ref="decline-me")
-    declined = await client.post(
-        f"/suggestions/{fresh['id']}/decline",
-        json={"note": "Not needed", "author": "codex"},
-    )
-    assert declined.status_code == 200
-    assert declined.json()["stage"] == "declined"
-
-    illegal = await client.post(
-        f"/suggestions/{fresh['id']}/vet",
-        json={"note": "too late"},
-    )
-    assert illegal.status_code == 409
-
-
-@pytest.mark.asyncio
-async def test_next_steps_surfaces_and_bumps_suggestions(client):
-    await _create_domain(client, "custodian", "Custodian")
-    await _create_suggestion(client, title="Surfaced need", origin_ref="surfaced-need")
-    before = await client.get("/suggestions/?origin_ref=surfaced-need")
-    # no filter by origin_ref on list - get all and find
-    all_items = await client.get("/suggestions/")
-    item = next(i for i in all_items.json() if i["origin_ref"] == "surfaced-need")
-    assert item["relevance"] == 0
-
-    steps = await client.get("/state/next_steps")
-    assert steps.status_code == 200
-    payload = steps.json()
-    assert any(s["type"] == "open_suggestion" for s in payload)
-
-    after = await client.get(f"/suggestions/{item['id']}")
-    assert after.json()["relevance"] >= 1
-
-
-@pytest.mark.asyncio
-async def test_summary_includes_ranked_suggestions(client):
-    await _create_domain(client, "custodian", "Custodian")
-    await _create_suggestion(client, title="Summary ranked", origin_ref="summary-ranked")
-    summary = await client.get("/state/summary")
-    assert summary.status_code == 200
-    data = summary.json()
-    assert "ranked_suggestions" in data
-    assert any(s["origin_ref"] == "summary-ranked" for s in data["ranked_suggestions"])
\ No newline at end of file
+    async def test_retirement_detail_points_at_intake_and_archive(self, client):
+        r = await client.get("/suggestions/")
+        detail = r.json()["detail"]
+        assert "POST /intakes/" in detail
+        assert "archived-suggestion-backlog.md" in detail
diff --git a/tests/test_task_record_id_backfill.py b/tests/test_task_record_id_backfill.py
new file mode 100644
index 0000000..0b2f905
--- /dev/null
+++ b/tests/test_task_record_id_backfill.py
@@ -0,0 +1,161 @@
+"""Recovering canonical identity for existing task rows (STATE-WP-0083-T06).
+
+The mapping exists only in the repository files, where a task declares both its
+canonical id and the projection UUID it was registered under. Reading the pairing
+is safe; inferring it from titles is not, which is the whole reason this exists.
+"""
+
+from __future__ import annotations
+
+from pathlib import Path
+
+import pytest
+
+from api.services import task_record_id_backfill as bf
+
+
+def _repo(tmp_path: Path, name: str, body: str) -> Path:
+    root = tmp_path / name
+    (root / "workplans").mkdir(parents=True)
+    (root / "workplans" / "WP.md").write_text(body, encoding="utf-8")
+    return root
+
+
+def test_reads_the_pairing_a_file_declares(tmp_path):
+    root = _repo(tmp_path, "a", (
+        "---\nid: DEMO-WP-0001\ntype: workplan\n---\n\n"
+        '```task\nid: DEMO-WP-0001-T01\nstate_hub_task_id: "11111111-1111-5111-8111-111111111111"\n```\n'
+    ))
+    pairs, rep = bf.collect_pairs([root])
+    assert pairs == {"11111111-1111-5111-8111-111111111111": "DEMO-WP-0001-T01"}
+    assert rep.pairs_found == 1
+
+
+def test_task_without_a_projection_uuid_is_skipped(tmp_path):
+    """No pairing to read means no identity to assign."""
+    root = _repo(tmp_path, "b", (
+        "---\nid: DEMO-WP-0001\ntype: workplan\n---\n\n"
+        "```task\nid: DEMO-WP-0001-T01\nstatus: todo\n```\n"
+    ))
+    pairs, _ = bf.collect_pairs([root])
+    assert pairs == {}
+
+
+def test_one_uuid_claimed_twice_is_a_conflict_not_a_guess(tmp_path):
+    """Duplicate registration: picking a winner would fabricate an identity."""
+    dup = "22222222-2222-5222-8222-222222222222"
+    a = _repo(tmp_path, "a", (
+        "---\nid: A-WP-0001\ntype: workplan\n---\n\n"
+        f'```task\nid: A-WP-0001-T01\nstate_hub_task_id: "{dup}"\n```\n'
+    ))
+    b = _repo(tmp_path, "b", (
+        "---\nid: B-WP-0001\ntype: workplan\n---\n\n"
+        f'```task\nid: B-WP-0001-T01\nstate_hub_task_id: "{dup}"\n```\n'
+    ))
+    pairs, rep = bf.collect_pairs([a, b])
+    assert len(rep.conflicts) == 1
+    assert pairs[dup] == "A-WP-0001-T01"  # first wins, second recorded not applied
+
+
+class _Row:
+    def __init__(self, tid, record_id=None):
+        self.id = tid
+        self.record_id = record_id
+
+
+class _Session:
+    def __init__(self, rows):
+        self.rows = rows
+
+    async def execute(self, *_a, **_k):
+        rows = self.rows
+
+        class R:
+            def scalars(self_inner):
+                return iter(rows)
+
+        return R()
+
+
+@pytest.mark.asyncio
+async def test_dry_run_changes_nothing(tmp_path):
+    root = _repo(tmp_path, "a", (
+        "---\nid: DEMO-WP-0001\ntype: workplan\n---\n\n"
+        '```task\nid: DEMO-WP-0001-T01\nstate_hub_task_id: "11111111-1111-5111-8111-111111111111"\n```\n'
+    ))
+    row = _Row("11111111-1111-5111-8111-111111111111")
+    rep = await bf.backfill_task_record_ids(_Session([row]), [root], dry_run=True)
+    assert rep.updated == 1 and row.record_id is None
+
+
+@pytest.mark.asyncio
+async def test_applies_the_identity_when_not_dry_run(tmp_path):
+    root = _repo(tmp_path, "a", (
+        "---\nid: DEMO-WP-0001\ntype: workplan\n---\n\n"
+        '```task\nid: DEMO-WP-0001-T01\nstate_hub_task_id: "11111111-1111-5111-8111-111111111111"\n```\n'
+    ))
+    row = _Row("11111111-1111-5111-8111-111111111111")
+    rep = await bf.backfill_task_record_ids(_Session([row]), [root], dry_run=False)
+    assert rep.updated == 1 and row.record_id == "DEMO-WP-0001-T01"
+
+
+@pytest.mark.asyncio
+async def test_a_row_the_files_do_not_claim_keeps_no_identity(tmp_path):
+    """Unknown must stay unknown; the reset then keeps refusing to act on it."""
+    root = _repo(tmp_path, "a", (
+        "---\nid: DEMO-WP-0001\ntype: workplan\n---\n\n"
+        '```task\nid: DEMO-WP-0001-T01\nstate_hub_task_id: "11111111-1111-5111-8111-111111111111"\n```\n'
+    ))
+    orphan = _Row("99999999-9999-4999-8999-999999999999")
+    await bf.backfill_task_record_ids(_Session([orphan]), [root], dry_run=False)
+    assert orphan.record_id is None
+
+
+@pytest.mark.asyncio
+async def test_existing_identity_is_never_overwritten(tmp_path):
+    root = _repo(tmp_path, "a", (
+        "---\nid: DEMO-WP-0001\ntype: workplan\n---\n\n"
+        '```task\nid: DEMO-WP-0001-T01\nstate_hub_task_id: "11111111-1111-5111-8111-111111111111"\n```\n'
+    ))
+    row = _Row("11111111-1111-5111-8111-111111111111", record_id="OTHER-WP-0001-T09")
+    rep = await bf.backfill_task_record_ids(_Session([row]), [root], dry_run=False)
+    assert row.record_id == "OTHER-WP-0001-T09"
+    assert rep.conflicts and rep.updated == 0
+
+
+def test_a_bare_task_id_is_qualified_by_its_workplan(tmp_path):
+    """`T01` is unique inside one workplan and meaningless outside it.
+
+    Stored raw, every workplan's first task shares one identity — 51 such ids
+    were assigned to 148 rows on central before this was caught.
+    """
+    root = _repo(tmp_path, "a", (
+        "---\nid: LLM-WP-0001\ntype: workplan\n---\n\n"
+        '```task\nid: T01\nstate_hub_task_id: "11111111-1111-5111-8111-111111111111"\n```\n'
+    ))
+    pairs, _ = bf.collect_pairs([root])
+    assert pairs == {"11111111-1111-5111-8111-111111111111": "LLM-WP-0001-T01"}
+
+
+def test_two_workplans_first_tasks_do_not_collide(tmp_path):
+    a = _repo(tmp_path, "a", (
+        "---\nid: A-WP-0001\ntype: workplan\n---\n\n"
+        '```task\nid: T01\nstate_hub_task_id: "11111111-1111-5111-8111-111111111111"\n```\n'
+    ))
+    b = _repo(tmp_path, "b", (
+        "---\nid: B-WP-0001\ntype: workplan\n---\n\n"
+        '```task\nid: T01\nstate_hub_task_id: "22222222-2222-5222-8222-222222222222"\n```\n'
+    ))
+    pairs, rep = bf.collect_pairs([a, b])
+    assert set(pairs.values()) == {"A-WP-0001-T01", "B-WP-0001-T01"}
+    assert rep.conflicts == []
+
+
+def test_unqualifiable_short_id_gets_no_identity(tmp_path):
+    """No identity beats a non-unique one."""
+    root = _repo(tmp_path, "a", (
+        "id: not-frontmatter\n\n"
+        '```task\nid: T01\nstate_hub_task_id: "11111111-1111-5111-8111-111111111111"\n```\n'
+    ))
+    pairs, _ = bf.collect_pairs([root])
+    assert pairs == {}
diff --git a/tests/test_validate_repo_adr.py b/tests/test_validate_repo_adr.py
new file mode 100644
index 0000000..ac16ca6
--- /dev/null
+++ b/tests/test_validate_repo_adr.py
@@ -0,0 +1,36 @@
+from __future__ import annotations
+
+from scripts.validate_repo_adr import Report, _check_workplan_file
+
+
+def test_repository_qualified_ad_hoc_id_matches_daily_filename(tmp_path) -> None:
+    workplans = tmp_path / "workplans"
+    workplans.mkdir()
+    path = workplans / "ADHOC-2026-08-23.md"
+    path.write_text(
+        """---
+id: ACTIVITY-WP-ADHOC-2026-08-23
+type: workplan
+title: Daily repair
+domain: infotech
+status: finished
+owner: codex
+created: "2026-08-23"
+---
+
+## Repair
+
+```task
+id: ACTIVITY-WP-ADHOC-2026-08-23-T01
+status: done
+priority: low
+```
+""",
+        encoding="utf-8",
+    )
+    report = Report(repo_path=str(tmp_path))
+
+    _check_workplan_file(path, report)
+
+    assert not report.failures
+    assert not [finding for finding in report.warnings if finding.check == "filename-id-prefix"]
diff --git a/tests/test_work_record_check.py b/tests/test_work_record_check.py
new file mode 100644
index 0000000..9e43c01
--- /dev/null
+++ b/tests/test_work_record_check.py
@@ -0,0 +1,182 @@
+"""Unit tests for C-31 (work-record sidetrack detector, CUST-WP-0060-T05).
+
+Covers:
+  - _load_work_record_patterns — registry discovery + parsing, missing/broken
+    registry handling
+  - _check_unregistered_work_records — rogue ids flagged, registered kinds
+    (incl. grandfathered legacy patterns) pass, template placeholders and
+    skip-dirs ignored, malformed yaml doesn't crash the scan
+
+No network calls, no DB, no live API — these tests run fully offline and use
+a synthetic registry fixture rather than the live canon checkout, so they
+are stable independent of the-custodian's on-disk state.
+"""
+from __future__ import annotations
+
+import sys
+import textwrap
+from pathlib import Path
+
+import pytest
+import yaml
+
+sys.path.insert(0, str(Path(__file__).parent.parent / "scripts"))
+
+from consistency_check import (  # noqa: E402
+    ConsistencyReport,
+    _check_unregistered_work_records,
+    _load_work_record_patterns,
+)
+
+REGISTRY_YAML = textwrap.dedent(
+    """
+    version: "0.1"
+    status: active
+    kinds:
+      - kind: workplan
+        id_patterns: ['^[A-Z]+-WP-[0-9]{4}$']
+      - kind: task
+        id_patterns: ['^[A-Z]+-WP-[0-9]{4}-T[0-9]{2,3}$']
+        legacy_patterns:
+          - pattern: '^[A-Z]+-WP-[0-9]{4}-T[0-9]$'
+            source: single-digit legacy
+      - kind: intake
+        id_patterns: ['^[A-Z]+-IN-[0-9]{4}$']
+        legacy_patterns:
+          - pattern: '^AWQ-[0-9]{3}$'
+            source: binky AutopilotWorkQueue
+      - kind: decision
+        id_patterns: ['^[A-Z]+-DEC-[0-9]{4}-[0-9]{3}$']
+        legacy_patterns:
+          - pattern: '^DEC-[0-9]{4}-[0-9]{3}$'
+            source: binky DecisionQueue
+      - kind: engagement
+        id_patterns: ['^[A-Z]+-ENG-[0-9]{4}-[0-9]{3}$']
+        legacy_patterns:
+          - pattern: '^OH-[0-9]{4}-[0-9]{3}$'
+            source: binky OfficeHourQueue
+    """
+)
+
+
+@pytest.fixture
+def registry_file(tmp_path, monkeypatch):
+    reg = tmp_path / "work-record-types.yaml"
+    reg.write_text(REGISTRY_YAML, encoding="utf-8")
+    monkeypatch.setenv("WORK_RECORD_REGISTRY", str(reg))
+    return reg
+
+
+class TestLoadWorkRecordPatterns:
+    def test_loads_patterns_from_env_override(self, registry_file):
+        patterns = _load_work_record_patterns()
+        assert patterns is not None
+        assert any(p.match("AWQ-010") for p in patterns)
+        assert any(p.match("CUST-WP-0060") for p in patterns)
+
+    def test_returns_none_when_no_registry_available(self, tmp_path, monkeypatch):
+        monkeypatch.setenv("WORK_RECORD_REGISTRY", str(tmp_path / "missing.yaml"))
+        monkeypatch.setattr(Path, "home", lambda: tmp_path / "nohome")
+        assert _load_work_record_patterns() is None
+
+    def test_returns_none_on_unparseable_registry(self, tmp_path, monkeypatch):
+        bad = tmp_path / "bad.yaml"
+        bad.write_text("kinds: [unterminated", encoding="utf-8")
+        monkeypatch.setenv("WORK_RECORD_REGISTRY", str(bad))
+        assert _load_work_record_patterns() is None
+
+
+class TestCheckUnregisteredWorkRecords:
+    def _report(self, repo_dir: Path) -> ConsistencyReport:
+        report = ConsistencyReport(repo_slug="test", repo_path=str(repo_dir))
+        _check_unregistered_work_records(repo_dir, report)
+        return report
+
+    def test_flags_id_matching_no_registered_kind(self, tmp_path, registry_file):
+        (tmp_path / "notes.md").write_text(
+            "```yaml\nid: FOO-QX-001\ntitle: rogue species\n```\n",
+            encoding="utf-8",
+        )
+        report = self._report(tmp_path)
+        assert [i.check_id for i in report.issues] == ["C-31"]
+        assert "FOO-QX-001" in report.issues[0].message
+        assert report.issues[0].severity == "WARN"
+        assert report.issues[0].fixable is False
+
+    def test_passes_registered_kind_ids(self, tmp_path, registry_file):
+        (tmp_path / "notes.md").write_text(
+            "```yaml\nid: CUST-WP-0060\n```\n"
+            "```yaml\nid: CUST-WP-0060-T01\n```\n"
+            "```yaml\nid: BINKY-IN-0001\n```\n"
+            "```yaml\nid: BINKY-DEC-2026-001\n```\n"
+            "```yaml\nid: BINKY-ENG-2026-001\n```\n",
+            encoding="utf-8",
+        )
+        report = self._report(tmp_path)
+        assert report.issues == []
+
+    @pytest.mark.parametrize(
+        "legacy_id",
+        ["AWQ-010", "DEC-2026-004", "OH-2026-003", "CUST-WP-0060-T1"],
+    )
+    def test_passes_grandfathered_legacy_ids(self, tmp_path, registry_file, legacy_id):
+        (tmp_path / "queue.md").write_text(
+            f"```yaml\nid: {legacy_id}\ntitle: legacy item\n```\n",
+            encoding="utf-8",
+        )
+        report = self._report(tmp_path)
+        assert report.issues == [], f"{legacy_id} should be grandfathered, got {report.issues}"
+
+    @pytest.mark.parametrize("placeholder", ["BINKY-WP-NNNN", "CUST-WP-0060-TNN"])
+    def test_ignores_template_placeholders(self, tmp_path, registry_file, placeholder):
+        (tmp_path / "AGENTS.md").write_text(
+            f"```yaml\nid: {placeholder}\n```\n", encoding="utf-8"
+        )
+        report = self._report(tmp_path)
+        assert report.issues == []
+
+    def test_ignores_non_id_like_strings(self, tmp_path, registry_file):
+        (tmp_path / "prose.md").write_text(
+            "```yaml\nid: not-an-id-scheme\n```\n"
+            "```yaml\nid: 12345\n```\n",
+            encoding="utf-8",
+        )
+        report = self._report(tmp_path)
+        assert report.issues == []
+
+    def test_deduplicates_repeated_ids_in_same_repo(self, tmp_path, registry_file):
+        (tmp_path / "a.md").write_text("```yaml\nid: FOO-QX-001\n```\n", encoding="utf-8")
+        (tmp_path / "b.md").write_text("```yaml\nid: FOO-QX-001\n```\n", encoding="utf-8")
+        report = self._report(tmp_path)
+        assert len(report.issues) == 1
+
+    def test_skips_git_and_history_directories(self, tmp_path, registry_file):
+        skipped = tmp_path / ".git" / "nested"
+        skipped.mkdir(parents=True)
+        (skipped / "notes.md").write_text(
+            "```yaml\nid: FOO-QX-001\n```\n", encoding="utf-8"
+        )
+        report = self._report(tmp_path)
+        assert report.issues == []
+
+    def test_malformed_fenced_block_does_not_crash_scan(self, tmp_path, registry_file):
+        (tmp_path / "broken.md").write_text(
+            "```yaml\nid: [unterminated\n```\n"
+            "```yaml\nid: FOO-QX-001\n```\n",
+            encoding="utf-8",
+        )
+        report = self._report(tmp_path)
+        # the malformed block is silently skipped by the id-line regex
+        # (it never matches `id: <value>` on its own line); the well-formed
+        # rogue id in the same file is still caught.
+        assert [i.check_id for i in report.issues] == ["C-31"]
+        assert "FOO-QX-001" in report.issues[0].message
+
+    def test_no_op_when_registry_unavailable(self, tmp_path, monkeypatch):
+        monkeypatch.setenv("WORK_RECORD_REGISTRY", str(tmp_path / "missing.yaml"))
+        monkeypatch.setattr(Path, "home", lambda: tmp_path / "nohome")
+        (tmp_path / "notes.md").write_text(
+            "```yaml\nid: FOO-QX-001\n```\n", encoding="utf-8"
+        )
+        report = self._report(tmp_path)
+        assert report.issues == []
diff --git a/tests/test_work_record_flavor.py b/tests/test_work_record_flavor.py
new file mode 100644
index 0000000..c81e910
--- /dev/null
+++ b/tests/test_work_record_flavor.py
@@ -0,0 +1,136 @@
+"""STATE-WP-0092: flavor indexing, residual default-exclusion, depends_on alias."""
+from __future__ import annotations
+
+import pytest
+
+from tests.test_routers_core import (
+    _create_domain,
+    _create_repo,
+    _create_task,
+    _create_topic,
+    _create_workstream,
+)
+
+
+@pytest.mark.asyncio
+async def test_unknown_flavor_rejected_on_create(client):
+    await _create_domain(client)
+    topic = await _create_topic(client)
+    repo = await _create_repo(client)
+    r = await client.post(
+        "/workplans/",
+        json={
+            "repo_id": repo["id"],
+            "topic_id": topic["id"],
+            "slug": "bad-flavor",
+            "title": "Bad flavor",
+            "flavor": "sidetrack",
+        },
+    )
+    assert r.status_code == 422
+
+
+@pytest.mark.asyncio
+async def test_flavor_round_trip_and_list_filters(client):
+    await _create_domain(client)
+    topic = await _create_topic(client)
+    relevant = await _create_workstream(
+        client, topic["id"], slug="rel-wp", title="Relevant", flavor="implementation"
+    )
+    residual = await _create_workstream(
+        client, topic["id"], slug="res-wp", title="Leftover", flavor="residual"
+    )
+    unspecified = await _create_workstream(
+        client, topic["id"], slug="unset-wp", title="Historic"
+    )
+
+    listed = await client.get("/workplans/")
+    ids = {row["id"] for row in listed.json()}
+    assert relevant["id"] in ids
+    assert residual["id"] in ids
+    assert unspecified["id"] in ids
+
+    hidden = await client.get("/workplans/", params={"include_residuals": "false"})
+    hidden_ids = {row["id"] for row in hidden.json()}
+    assert relevant["id"] in hidden_ids
+    assert unspecified["id"] in hidden_ids
+    assert residual["id"] not in hidden_ids
+
+    only_residual = await client.get("/workplans/", params={"flavor": "residual"})
+    only_ids = {row["id"] for row in only_residual.json()}
+    assert only_ids == {residual["id"]}
+
+    got = await client.get(f"/workplans/{residual['id']}")
+    assert got.json()["flavor"] == "residual"
+
+
+@pytest.mark.asyncio
+async def test_summary_omits_residuals_unless_included(client):
+    await _create_domain(client)
+    topic = await _create_topic(client)
+    relevant = await _create_workstream(
+        client, topic["id"], slug="sum-rel", title="Do this", flavor="planning"
+    )
+    residual = await _create_workstream(
+        client, topic["id"], slug="sum-res", title="Later maybe", flavor="residual"
+    )
+
+    summary = (await client.get("/state/summary")).json()
+    open_ids = {row["id"] for row in summary["open_workplans"]}
+    assert relevant["id"] in open_ids
+    assert residual["id"] not in open_ids
+    assert summary["totals"]["workstreams"]["residual_open"] == 1
+    assert summary["residual_open_workplans"] == []
+
+    included = (await client.get("/state/summary", params={"include_residuals": "true"})).json()
+    residual_ids = {row["id"] for row in included["residual_open_workplans"]}
+    assert residual["id"] in residual_ids
+    assert relevant["id"] not in residual_ids
+    open_ids_still = {row["id"] for row in included["open_workplans"]}
+    assert residual["id"] not in open_ids_still
+
+    deps = (await client.get("/state/deps")).json()
+    dep_ids = {row["id"] for row in deps}
+    assert relevant["id"] in dep_ids
+    assert residual["id"] not in dep_ids
+
+
+@pytest.mark.asyncio
+async def test_next_steps_skips_residual_workplan(client):
+    await _create_domain(client)
+    topic = await _create_topic(client)
+    blocker = await _create_workstream(
+        client, topic["id"], slug="done-dep", title="Finished dep", status="finished"
+    )
+    residual = await _create_workstream(
+        client, topic["id"], slug="res-ready", title="Residual leftover", flavor="residual"
+    )
+    r = await client.post(
+        f"/workplans/{residual['id']}/dependencies/",
+        json={"to_workstream_id": blocker["id"]},
+    )
+    assert r.status_code == 201
+    await _create_task(client, residual["id"], title="Do not start this")
+
+    steps = (await client.get("/state/next_steps")).json()
+    assert all(step.get("workplan_id") != residual["id"] for step in steps)
+    assert all("Residual leftover" not in (step.get("message") or "") for step in steps)
+
+
+@pytest.mark.asyncio
+async def test_task_flavor_round_trip(client):
+    await _create_domain(client)
+    topic = await _create_topic(client)
+    ws = await _create_workstream(client, topic["id"], slug="task-flavor-wp")
+    r = await client.post(
+        "/tasks/",
+        json={"workplan_id": ws["id"], "title": "Leftover task", "flavor": "residual"},
+    )
+    assert r.status_code == 201
+    assert r.json()["flavor"] == "residual"
+    patched = await client.patch(
+        f"/tasks/{r.json()['id']}",
+        json={"flavor": "implementation", "suppress_token_event": True},
+    )
+    assert patched.status_code == 200
+    assert patched.json()["flavor"] == "implementation"
diff --git a/tests/test_work_record_identifier_migration.py b/tests/test_work_record_identifier_migration.py
new file mode 100644
index 0000000..80c443b
--- /dev/null
+++ b/tests/test_work_record_identifier_migration.py
@@ -0,0 +1,786 @@
+from __future__ import annotations
+
+import hashlib
+import json
+import uuid
+
+import pytest
+from sqlalchemy import select, text
+from sqlalchemy.ext.asyncio import AsyncSession, async_sessionmaker
+
+from api.models import Base
+from api.models.domain import Domain
+from api.models.managed_repo import ManagedRepo
+from api.models.progress_event import ProgressEvent
+from api.models.repository_rename import RepositorySlug
+from api.models.task import Task
+from api.models.topic import Topic
+from api.models.token_event import TokenEvent
+from api.models.work_record_identifier_alias import WorkRecordIdentifierAlias
+from api.models.workplan import Workplan
+from api.models.workplan_dependency import WorkplanDependency
+from api.services.work_record_identifier_migration import (
+    DERIVATION_NAMESPACE_UUID,
+    IdentifierMigrationError,
+    apply_repository_identifier_migration,
+    repair_absent_prederivation_projection,
+    reverse_repository_identifier_migration,
+)
+
+
+def _derived(record_id: str) -> uuid.UUID:
+    return uuid.uuid5(DERIVATION_NAMESPACE_UUID, f"helixforge\n{record_id}")
+
+
+def _sealed_plan(
+    repo_slug: str,
+    workplan_old: uuid.UUID,
+    task_old: uuid.UUID,
+    *,
+    task_source_override: uuid.UUID | None = None,
+) -> dict:
+    mappings = [
+        {
+            "repo": repo_slug,
+            "path": "workplans/TEST-WP-0001-migration.md",
+            "kind": "workplan",
+            "record_id": "TEST-WP-0001",
+            "current_uuid": str(workplan_old),
+            "derived_uuid": str(_derived("TEST-WP-0001")),
+            "action": "replace",
+        },
+        {
+            "repo": repo_slug,
+            "path": "workplans/TEST-WP-0001-migration.md",
+            "kind": "task",
+            "record_id": "TEST-WP-0001-T01",
+            "current_uuid": str(task_source_override or task_old),
+            "derived_uuid": str(_derived("TEST-WP-0001-T01")),
+            "action": "replace",
+        },
+        {
+            "repo": repo_slug,
+            "path": "workplans/TEST-WP-0001-migration.md",
+            "kind": "task",
+            "record_id": "TEST-WP-0001-T02",
+            "current_uuid": None,
+            "derived_uuid": str(_derived("TEST-WP-0001-T02")),
+            "action": "assign",
+        },
+    ]
+    plan = {
+        "schema": "repo-manager.identifier-migration-plan.v1",
+        "ok": True,
+        "ready_to_apply": True,
+        "root": "/test",
+        "namespace": "helixforge",
+        "derivation_version": "repo-manager.work-record-uuid.v1",
+        "namespace_uuid": str(DERIVATION_NAMESPACE_UUID),
+        "scope": "live workplans and unfinished tasks",
+        "apply_policy": "all-or-nothing per repository",
+        "generated_at": "2026-08-21T00:00:00Z",
+        "totals": {
+            "repositories": 1,
+            "eligible": 1,
+            "skipped": 0,
+            "records": 3,
+            "replace": 2,
+            "assign": 1,
+            "unchanged": 0,
+        },
+        "repositories": [
+            {
+                "repo": repo_slug,
+                "path": "/test/repo",
+                "planned_head_sha": "0" * 40,
+                "source_fingerprint": "1" * 64,
+                "eligible": True,
+                "atomic_unit": True,
+                "blockers": [],
+                "mappings": mappings,
+            }
+        ],
+    }
+    canonical = json.dumps(plan, sort_keys=True, separators=(",", ":")).encode()
+    plan["plan_sha256"] = hashlib.sha256(canonical).hexdigest()
+    return plan
+
+
+async def _seed_projection(factory, repo_slug: str):
+    domain_id = uuid.uuid4()
+    repo_id = uuid.uuid4()
+    workplan_old = uuid.uuid4()
+    task_old = uuid.uuid4()
+    child_task_id = uuid.uuid4()
+    progress_id = uuid.uuid4()
+    token_id = uuid.uuid4()
+    dependency_id = uuid.uuid4()
+    async with factory() as session:
+        session.add_all(
+            [
+                Domain(id=domain_id, slug="infotech", name="Infotech", status="active"),
+                ManagedRepo(
+                    id=repo_id,
+                    domain_id=domain_id,
+                    slug=repo_slug,
+                    name="Test Repository",
+                    status="active",
+                ),
+                Workplan(
+                    id=workplan_old,
+                    repo_id=repo_id,
+                    slug="test-wp-0001",
+                    title="Migration test",
+                    status="active",
+                ),
+                Task(
+                    id=task_old,
+                    workplan_id=workplan_old,
+                    title="Mapped task",
+                    status="progress",
+                    priority="high",
+                ),
+                Task(
+                    id=child_task_id,
+                    workplan_id=workplan_old,
+                    parent_task_id=task_old,
+                    title="Unmapped child",
+                    status="todo",
+                    priority="medium",
+                ),
+                ProgressEvent(
+                    id=progress_id,
+                    workplan_id=workplan_old,
+                    task_id=task_old,
+                    event_type="note",
+                    summary="migration evidence",
+                ),
+                TokenEvent(
+                    id=token_id,
+                    workplan_id=workplan_old,
+                    task_id=task_old,
+                    tokens_in=1,
+                    tokens_out=1,
+                ),
+                WorkplanDependency(
+                    id=dependency_id,
+                    from_workplan_id=workplan_old,
+                    to_task_id=task_old,
+                    relationship_type="blocks",
+                ),
+            ]
+        )
+        await session.commit()
+    return {
+        "workplan": workplan_old,
+        "task": task_old,
+        "child": child_task_id,
+        "progress": progress_id,
+        "token": token_id,
+        "dependency": dependency_id,
+    }
+
+
+def test_every_work_record_foreign_key_cascades_on_update():
+    references = [
+        foreign_key
+        for table in Base.metadata.sorted_tables
+        for foreign_key in table.foreign_keys
+        if foreign_key.target_fullname in {"workplans.id", "tasks.id"}
+    ]
+    assert len(references) == 22
+    assert all(foreign_key.onupdate == "CASCADE" for foreign_key in references)
+
+
+@pytest.mark.asyncio
+async def test_repository_migration_cascades_and_reverses(test_engine):
+    factory = async_sessionmaker(test_engine, class_=AsyncSession, expire_on_commit=False)
+    ids = await _seed_projection(factory, "test-repo")
+    plan = _sealed_plan("test-repo", ids["workplan"], ids["task"])
+    workplan_new = _derived("TEST-WP-0001")
+    task_new = _derived("TEST-WP-0001-T01")
+
+    async with factory() as session:
+        result = await apply_repository_identifier_migration(session, plan, "test-repo")
+    assert result.direction == "forward"
+    assert result.replacements == 2
+    assert result.migrated == 2
+    assert result.already_derived == 0
+    assert result.assignments_deferred == 1
+
+    async with factory() as session:
+        assert await session.scalar(
+            text("SELECT id FROM workplans WHERE id = :id"), {"id": workplan_new}
+        ) == workplan_new
+        assert await session.scalar(
+            text("SELECT workplan_id FROM tasks WHERE id = :id"), {"id": task_new}
+        ) == workplan_new
+        assert await session.scalar(
+            text("SELECT parent_task_id FROM tasks WHERE id = :id"), {"id": ids["child"]}
+        ) == task_new
+        assert tuple(
+            (
+                await session.execute(
+                    text(
+                        "SELECT workplan_id, task_id FROM progress_events WHERE id = :id"
+                    ),
+                    {"id": ids["progress"]},
+                )
+            ).one()
+        ) == (workplan_new, task_new)
+        assert tuple(
+            (
+                await session.execute(
+                    text("SELECT workplan_id, task_id FROM token_events WHERE id = :id"),
+                    {"id": ids["token"]},
+                )
+            ).one()
+        ) == (workplan_new, task_new)
+        assert tuple(
+            (
+                await session.execute(
+                    text(
+                        "SELECT from_workplan_id, to_task_id "
+                        "FROM workplan_dependencies WHERE id = :id"
+                    ),
+                    {"id": ids["dependency"]},
+                )
+            ).one()
+        ) == (workplan_new, task_new)
+        aliases = list(
+            (
+                await session.execute(
+                    select(WorkRecordIdentifierAlias).order_by(
+                        WorkRecordIdentifierAlias.record_kind
+                    )
+                )
+            ).scalars()
+        )
+        assert len(aliases) == 2
+        assert all(alias.migration_status == "applied" for alias in aliases)
+
+    async with factory() as session:
+        result = await reverse_repository_identifier_migration(session, plan, "test-repo")
+    assert result.direction == "reverse"
+
+    async with factory() as session:
+        assert await session.scalar(
+            text("SELECT id FROM workplans WHERE id = :id"), {"id": ids["workplan"]}
+        ) == ids["workplan"]
+        assert await session.scalar(
+            text("SELECT workplan_id FROM tasks WHERE id = :id"), {"id": ids["task"]}
+        ) == ids["workplan"]
+        assert await session.scalar(
+            text("SELECT parent_task_id FROM tasks WHERE id = :id"), {"id": ids["child"]}
+        ) == ids["task"]
+        aliases = list((await session.execute(select(WorkRecordIdentifierAlias))).scalars())
+        assert len(aliases) == 2
+        assert all(alias.migration_status == "reversed" for alias in aliases)
+        assert all(alias.reversed_at is not None for alias in aliases)
+
+
+@pytest.mark.asyncio
+async def test_repository_migration_accepts_mixed_legacy_and_derived_projection(test_engine):
+    factory = async_sessionmaker(test_engine, class_=AsyncSession, expire_on_commit=False)
+    ids = await _seed_projection(factory, "mixed-repo")
+    plan = _sealed_plan("mixed-repo", ids["workplan"], ids["task"])
+    task_new = _derived("TEST-WP-0001-T01")
+
+    # Forge reconciliation reached the task before the sealed repository
+    # migration. The parent remains legacy, so the repository is genuinely
+    # mixed rather than already migrated as one unit.
+    async with factory() as session:
+        await session.execute(
+            text("UPDATE tasks SET id = :new_id, record_id = :record_id WHERE id = :old_id"),
+            {
+                "old_id": ids["task"],
+                "new_id": task_new,
+                "record_id": "TEST-WP-0001-T01",
+            },
+        )
+        await session.commit()
+
+    async with factory() as session:
+        result = await apply_repository_identifier_migration(session, plan, "mixed-repo")
+    assert result.replacements == 2
+    assert result.migrated == 1
+    assert result.already_derived == 1
+
+    async with factory() as session:
+        aliases = list((await session.execute(select(WorkRecordIdentifierAlias))).scalars())
+        assert len(aliases) == 2
+        assert all(alias.migration_status == "applied" for alias in aliases)
+
+    # Retry is a verified idempotent convergence, not a conflicting target.
+    async with factory() as session:
+        retried = await apply_repository_identifier_migration(session, plan, "mixed-repo")
+    assert retried.migrated == 0
+    assert retried.already_derived == 2
+
+
+@pytest.mark.asyncio
+async def test_repository_migration_coalesces_identical_unreferenced_task_duplicate(
+    test_engine,
+):
+    factory = async_sessionmaker(test_engine, class_=AsyncSession, expire_on_commit=False)
+    ids = await _seed_projection(factory, "duplicate-repo")
+    plan = _sealed_plan("duplicate-repo", ids["workplan"], ids["task"])
+    task_new = _derived("TEST-WP-0001-T01")
+    workplan_new = _derived("TEST-WP-0001")
+
+    async with factory() as session:
+        await session.execute(
+            text("DELETE FROM workplan_dependencies WHERE to_task_id = :task_id"),
+            {"task_id": ids["task"]},
+        )
+        await session.execute(
+            text("DELETE FROM progress_events WHERE task_id = :task_id"),
+            {"task_id": ids["task"]},
+        )
+        await session.execute(
+            text("DELETE FROM token_events WHERE task_id = :task_id"),
+            {"task_id": ids["task"]},
+        )
+        await session.execute(
+            text("DELETE FROM tasks WHERE parent_task_id = :task_id"),
+            {"task_id": ids["task"]},
+        )
+        legacy = await session.get(Task, ids["task"])
+        session.add(
+            Task(
+                id=task_new,
+                workplan_id=legacy.workplan_id,
+                record_id="TEST-WP-0001-T01",
+                title=legacy.title,
+                description=legacy.description,
+                status=legacy.status,
+                priority=legacy.priority,
+                assignee=legacy.assignee,
+                due_date=legacy.due_date,
+                blocking_reason=legacy.blocking_reason,
+                needs_human=legacy.needs_human,
+                intervention_note=legacy.intervention_note,
+                parent_task_id=legacy.parent_task_id,
+            )
+        )
+        await session.commit()
+
+    async with factory() as session:
+        result = await apply_repository_identifier_migration(
+            session, plan, "duplicate-repo"
+        )
+    assert result.migrated == 2
+    assert result.already_derived == 0
+
+    async with factory() as session:
+        assert await session.get(Task, ids["task"]) is None
+        task = await session.get(Task, task_new)
+        assert task is not None
+        assert task.workplan_id == workplan_new
+        assert task.record_id == "TEST-WP-0001-T01"
+
+    async with factory() as session:
+        await reverse_repository_identifier_migration(session, plan, "duplicate-repo")
+    async with factory() as session:
+        task = await session.get(Task, ids["task"])
+        assert task is not None
+        assert task.record_id == "TEST-WP-0001-T01"
+        assert await session.get(Task, task_new) is None
+
+
+@pytest.mark.asyncio
+async def test_repository_migration_rejects_referenced_task_duplicate(test_engine):
+    factory = async_sessionmaker(test_engine, class_=AsyncSession, expire_on_commit=False)
+    ids = await _seed_projection(factory, "referenced-duplicate-repo")
+    plan = _sealed_plan(
+        "referenced-duplicate-repo", ids["workplan"], ids["task"]
+    )
+    async with factory() as session:
+        legacy = await session.get(Task, ids["task"])
+        session.add(
+            Task(
+                id=_derived("TEST-WP-0001-T01"),
+                workplan_id=legacy.workplan_id,
+                record_id="TEST-WP-0001-T01",
+                title=legacy.title,
+                description=legacy.description,
+                status=legacy.status,
+                priority=legacy.priority,
+                assignee=legacy.assignee,
+                due_date=legacy.due_date,
+                blocking_reason=legacy.blocking_reason,
+                needs_human=legacy.needs_human,
+                intervention_note=legacy.intervention_note,
+                parent_task_id=legacy.parent_task_id,
+            )
+        )
+        await session.commit()
+
+    async with factory() as session:
+        with pytest.raises(IdentifierMigrationError, match="inbound references"):
+            await apply_repository_identifier_migration(
+                session, plan, "referenced-duplicate-repo"
+            )
+
+
+@pytest.mark.asyncio
+async def test_repository_migration_rejects_neither_legacy_nor_derived(test_engine):
+    factory = async_sessionmaker(test_engine, class_=AsyncSession, expire_on_commit=False)
+    ids = await _seed_projection(factory, "missing-repo")
+    plan = _sealed_plan(
+        "missing-repo", ids["workplan"], ids["task"], task_source_override=uuid.uuid4()
+    )
+
+    async with factory() as session:
+        with pytest.raises(IdentifierMigrationError, match="neither legacy nor derived task"):
+            await apply_repository_identifier_migration(session, plan, "missing-repo")
+
+    async with factory() as session:
+        assert await session.scalar(
+            text("SELECT count(*) FROM work_record_identifier_aliases")
+        ) == 0
+
+
+@pytest.mark.asyncio
+async def test_identifier_migration_http_apply_and_reverse(client, test_engine, monkeypatch):
+    from api.routers import identifier_migrations
+
+    monkeypatch.setattr(
+        identifier_migrations.settings, "state_hub_instance_role", "primary"
+    )
+    monkeypatch.setattr(
+        identifier_migrations.settings, "state_hub_instance_label", "railliance01"
+    )
+    factory = async_sessionmaker(test_engine, class_=AsyncSession, expire_on_commit=False)
+    ids = await _seed_projection(factory, "http-migration-repo")
+    plan = _sealed_plan("http-migration-repo", ids["workplan"], ids["task"])
+    body = {
+        "plan": plan,
+        "expected_plan_sha256": plan["plan_sha256"],
+        "primary_confirmed": True,
+    }
+
+    response = await client.post(
+        "/identifier-migrations/repositories/http-migration-repo/apply", json=body
+    )
+    assert response.status_code == 200, response.text
+    assert response.json()["result"] == {
+        "repo_slug": "http-migration-repo",
+        "plan_sha256": plan["plan_sha256"],
+        "direction": "forward",
+        "replacements": 2,
+        "migrated": 2,
+        "already_derived": 0,
+        "assignments_deferred": 1,
+    }
+
+    response = await client.post(
+        "/identifier-migrations/repositories/http-migration-repo/reverse", json=body
+    )
+    assert response.status_code == 200, response.text
+    assert response.json()["result"]["direction"] == "reverse"
+
+
+@pytest.mark.asyncio
+async def test_repository_migration_accepts_protected_prior_slug(test_engine):
+    factory = async_sessionmaker(test_engine, class_=AsyncSession, expire_on_commit=False)
+    ids = await _seed_projection(factory, "flex-auth")
+    plan = _sealed_plan("flex-auth", ids["workplan"], ids["task"])
+
+    async with factory() as session:
+        repo = (
+            await session.execute(
+                select(ManagedRepo).where(ManagedRepo.slug == "flex-auth")
+            )
+        ).scalar_one()
+        repo.slug = "access-engine"
+        session.add_all(
+            [
+                RepositorySlug(
+                    repo_id=repo.id,
+                    slug="flex-auth",
+                    kind="alias",
+                    protected=True,
+                ),
+                RepositorySlug(
+                    repo_id=repo.id,
+                    slug="access-engine",
+                    kind="canonical",
+                    protected=True,
+                ),
+            ]
+        )
+        await session.commit()
+
+    async with factory() as session:
+        result = await apply_repository_identifier_migration(session, plan, "flex-auth")
+    assert result.direction == "forward"
+
+    async with factory() as session:
+        aliases = list((await session.execute(select(WorkRecordIdentifierAlias))).scalars())
+        assert len(aliases) == 2
+        assert {alias.repo_slug for alias in aliases} == {"flex-auth"}
+        repo = (
+            await session.execute(
+                select(ManagedRepo).where(ManagedRepo.slug == "access-engine")
+            )
+        ).scalar_one()
+        assert repo.id is not None
+
+    async with factory() as session:
+        result = await reverse_repository_identifier_migration(session, plan, "flex-auth")
+    assert result.direction == "reverse"
+
+
+@pytest.mark.asyncio
+async def test_repository_migration_is_atomic_when_a_source_is_missing(test_engine):
+    factory = async_sessionmaker(test_engine, class_=AsyncSession, expire_on_commit=False)
+    ids = await _seed_projection(factory, "atomic-repo")
+    plan = _sealed_plan(
+        "atomic-repo",
+        ids["workplan"],
+        ids["task"],
+        task_source_override=uuid.uuid4(),
+    )
+
+    async with factory() as session:
+        with pytest.raises(IdentifierMigrationError, match="neither legacy nor derived task"):
+            await apply_repository_identifier_migration(session, plan, "atomic-repo")
+
+    async with factory() as session:
+        assert await session.scalar(
+            text("SELECT id FROM workplans WHERE id = :id"), {"id": ids["workplan"]}
+        ) == ids["workplan"]
+        assert await session.scalar(
+            text("SELECT count(*) FROM work_record_identifier_aliases")
+        ) == 0
+
+
+async def _seed_empty_repository(factory, repo_slug: str):
+    domain_id = uuid.uuid4()
+    topic_id = uuid.uuid4()
+    repo_id = uuid.uuid4()
+    async with factory() as session:
+        session.add(Domain(id=domain_id, slug="infotech", name="Infotech", status="active"))
+        await session.flush()
+        session.add(
+            Topic(
+                id=topic_id,
+                domain_id=domain_id,
+                slug="infotech",
+                title="Infotech",
+                status="active",
+            )
+        )
+        await session.flush()
+        session.add(
+            ManagedRepo(
+                id=repo_id,
+                domain_id=domain_id,
+                topic_id=topic_id,
+                slug=repo_slug,
+                name="Repair Repository",
+                status="active",
+            )
+        )
+        await session.commit()
+    return repo_id, topic_id
+
+
+def _repair_unit(plan: dict, topic_id: uuid.UUID) -> dict:
+    repository = plan["repositories"][0]
+    replacements = [m for m in repository["mappings"] if m["action"] == "replace"]
+    workplan = next(m for m in replacements if m["kind"] == "workplan")
+    task = next(m for m in replacements if m["kind"] == "task")
+    return {
+        "workplan": {
+            "record_id": workplan["record_id"],
+            "id": workplan["current_uuid"],
+            "topic_id": str(topic_id),
+            "slug": "test-wp-0001",
+            "title": "Migration test",
+            "description": "Exact authoritative projection",
+            "status": "active",
+            "owner": "codex",
+            "planning_priority": "high",
+            "planning_order": 1,
+        },
+        "tasks": [
+            {
+                "record_id": task["record_id"],
+                "id": task["current_uuid"],
+                "title": "Mapped task",
+                "description": "Exact task projection",
+                "status": "progress",
+                "priority": "high",
+                "assignee": "codex",
+            }
+        ],
+    }
+
+
+def _repair_kwargs(plan: dict) -> dict:
+    repository = plan["repositories"][0]
+    return {
+        "expected_plan_sha256": plan["plan_sha256"],
+        "source_revision": repository["planned_head_sha"],
+        "source_fingerprint": repository["source_fingerprint"],
+        "source_clean": True,
+        "source_synchronized": True,
+        "primary_confirmed": True,
+        "projection_identity": "test-projection",
+    }
+
+
+@pytest.mark.asyncio
+async def test_sealed_repair_restores_absent_projection_and_retries_as_noop(test_engine):
+    factory = async_sessionmaker(test_engine, class_=AsyncSession, expire_on_commit=False)
+    repo_id, topic_id = await _seed_empty_repository(factory, "repair-repo")
+    workplan_old = uuid.uuid4()
+    task_old = uuid.uuid4()
+    plan = _sealed_plan("repair-repo", workplan_old, task_old)
+    unit = _repair_unit(plan, topic_id)
+
+    async with factory() as session:
+        receipt = await repair_absent_prederivation_projection(
+            session, plan, "repair-repo", unit, **_repair_kwargs(plan)
+        )
+    assert receipt.outcome == "repaired"
+    assert receipt.repository_id == str(repo_id)
+    assert receipt.workplan_old_id == str(workplan_old)
+    assert receipt.task_records == (("TEST-WP-0001-T01", str(task_old)),)
+
+    async with factory() as session:
+        assert await session.get(Workplan, workplan_old) is not None
+        assert await session.get(Task, task_old) is not None
+        assert await session.get(Workplan, _derived("TEST-WP-0001")) is None
+        assert await session.get(Task, _derived("TEST-WP-0001-T01")) is None
+
+    async with factory() as session:
+        retry = await repair_absent_prederivation_projection(
+            session, plan, "repair-repo", unit, **_repair_kwargs(plan)
+        )
+    assert retry.outcome == "verified_noop"
+
+
+@pytest.mark.asyncio
+@pytest.mark.parametrize(
+    ("override", "message"),
+    [
+        ({"source_clean": False}, "clean synchronized"),
+        ({"source_synchronized": False}, "clean synchronized"),
+        ({"source_revision": "f" * 40}, "source revision drifted"),
+        ({"source_fingerprint": "e" * 64}, "source fingerprint drifted"),
+        ({"expected_plan_sha256": "0" * 64}, "explicit plan SHA-256"),
+        ({"primary_confirmed": False}, "primary confirmation"),
+    ],
+)
+async def test_sealed_repair_rejects_untrusted_source(test_engine, override, message):
+    factory = async_sessionmaker(test_engine, class_=AsyncSession, expire_on_commit=False)
+    _repo_id, topic_id = await _seed_empty_repository(factory, "untrusted-repo")
+    workplan_old = uuid.uuid4()
+    task_old = uuid.uuid4()
+    plan = _sealed_plan("untrusted-repo", workplan_old, task_old)
+    kwargs = _repair_kwargs(plan) | override
+
+    async with factory() as session:
+        with pytest.raises(IdentifierMigrationError, match=message):
+            await repair_absent_prederivation_projection(
+                session, plan, "untrusted-repo", _repair_unit(plan, topic_id), **kwargs
+            )
+    async with factory() as session:
+        assert await session.get(Workplan, workplan_old) is None
+        assert await session.get(Task, task_old) is None
+
+
+@pytest.mark.asyncio
+async def test_sealed_repair_rejects_partial_or_derived_projection_presence(test_engine):
+    factory = async_sessionmaker(test_engine, class_=AsyncSession, expire_on_commit=False)
+    repo_id, topic_id = await _seed_empty_repository(factory, "partial-repo")
+    workplan_old = uuid.uuid4()
+    task_old = uuid.uuid4()
+    plan = _sealed_plan("partial-repo", workplan_old, task_old)
+    unit = _repair_unit(plan, topic_id)
+
+    async with factory() as session:
+        session.add(
+            Workplan(
+                id=workplan_old,
+                repo_id=repo_id,
+                topic_id=topic_id,
+                slug="test-wp-0001",
+                title="Migration test",
+                status="active",
+            )
+        )
+        await session.commit()
+    async with factory() as session:
+        with pytest.raises(IdentifierMigrationError, match="partial old projection"):
+            await repair_absent_prederivation_projection(
+                session, plan, "partial-repo", unit, **_repair_kwargs(plan)
+            )
+
+    async with factory() as session:
+        await session.execute(text("DELETE FROM workplans WHERE id = :id"), {"id": workplan_old})
+        session.add(
+            Workplan(
+                id=_derived("TEST-WP-0001"),
+                repo_id=repo_id,
+                topic_id=topic_id,
+                slug="derived-conflict",
+                title="Derived conflict",
+                status="active",
+            )
+        )
+        await session.commit()
+    async with factory() as session:
+        with pytest.raises(IdentifierMigrationError, match="derived target presence"):
+            await repair_absent_prederivation_projection(
+                session, plan, "partial-repo", unit, **_repair_kwargs(plan)
+            )
+
+
+@pytest.mark.asyncio
+async def test_sealed_repair_http_surface_returns_receipt(client, test_engine):
+    factory = async_sessionmaker(test_engine, class_=AsyncSession, expire_on_commit=False)
+    repo_id, topic_id = await _seed_empty_repository(factory, "http-repair-repo")
+    workplan_old = uuid.uuid4()
+    task_old = uuid.uuid4()
+    plan = _sealed_plan("http-repair-repo", workplan_old, task_old)
+    response = await client.post(
+        "/identifier-migrations/sealed-projection-repairs",
+        json={
+            "plan": plan,
+            "repo_slug": "http-repair-repo",
+            "unit": _repair_unit(plan, topic_id),
+            **_repair_kwargs(plan),
+        },
+    )
+    assert response.status_code == 200, response.text
+    receipt = response.json()
+    assert receipt["outcome"] == "repaired"
+    assert receipt["repository_id"] == str(repo_id)
+    assert receipt["task_records"] == [["TEST-WP-0001-T01", str(task_old)]]
+    assert (await client.get(f"/workplans/{workplan_old}")).status_code == 200
+    assert (await client.get(f"/tasks/{task_old}")).status_code == 200
+    assert (await client.get(f"/workplans/{_derived('TEST-WP-0001')}")).status_code == 404
+    assert (await client.get(f"/tasks/{_derived('TEST-WP-0001-T01')}")).status_code == 404
+
+
+@pytest.mark.asyncio
+async def test_sealed_repair_http_surface_rejects_missing_confirmation(client, test_engine):
+    factory = async_sessionmaker(test_engine, class_=AsyncSession, expire_on_commit=False)
+    _repo_id, topic_id = await _seed_empty_repository(factory, "http-reject-repo")
+    plan = _sealed_plan("http-reject-repo", uuid.uuid4(), uuid.uuid4())
+    payload = {
+        "plan": plan,
+        "repo_slug": "http-reject-repo",
+        "unit": _repair_unit(plan, topic_id),
+        **_repair_kwargs(plan),
+    }
+    payload["primary_confirmed"] = False
+    response = await client.post(
+        "/identifier-migrations/sealed-projection-repairs", json=payload
+    )
+    assert response.status_code == 409
+    assert "primary confirmation" in response.json()["detail"]
diff --git a/tests/test_work_record_index.py b/tests/test_work_record_index.py
new file mode 100644
index 0000000..b91e2ab
--- /dev/null
+++ b/tests/test_work_record_index.py
@@ -0,0 +1,221 @@
+"""Tests for C-33 (generated per-repo work-record index, CUST-WP-0061-T04):
+_generate_work_record_index() and _check_work_record_index_freshness().
+Offline, synthetic registry fixture — same conventions as
+test_work_record_check.py / test_work_record_registration.py.
+"""
+from __future__ import annotations
+
+import sys
+import textwrap
+from pathlib import Path
+
+import pytest
+
+sys.path.insert(0, str(Path(__file__).parent.parent / "scripts"))
+
+from consistency_check import (  # noqa: E402
+    ConsistencyReport,
+    _check_work_record_index_freshness,
+    _generate_work_record_index,
+    _work_record_index_document,
+)
+
+REGISTRY_YAML = textwrap.dedent(
+    """
+    version: "0.1"
+    kinds:
+      - kind: workplan
+        id_patterns: ['^[A-Z]+-WP-[0-9]{4}$']
+      - kind: task
+        id_patterns: ['^[A-Z]+-WP-[0-9]{4}-T[0-9]{2,3}$']
+      - kind: intake
+        id_patterns: ['^[A-Z]+-IN-[0-9]{4}$']
+        legacy_patterns:
+          - pattern: '^AWQ-[0-9]{3}$'
+            source: binky AutopilotWorkQueue
+      - kind: decision
+        id_patterns: ['^[A-Z]+-DEC-[0-9]{4}-[0-9]{3}$']
+      - kind: engagement
+        id_patterns: ['^[A-Z]+-ENG-[0-9]{4}-[0-9]{3}$']
+    """
+)
+
+
+@pytest.fixture
+def registry_file(tmp_path, monkeypatch):
+    reg = tmp_path / "work-record-types.yaml"
+    reg.write_text(REGISTRY_YAML, encoding="utf-8")
+    monkeypatch.setenv("WORK_RECORD_REGISTRY", str(reg))
+    return reg
+
+
+class TestGenerateWorkRecordIndex:
+    def test_empty_repo_returns_none(self, tmp_path, registry_file):
+        assert _generate_work_record_index(tmp_path, "testrepo") is None
+
+    def test_includes_workplan_and_tasks(self, tmp_path, registry_file):
+        wp_dir = tmp_path / "workplans"
+        wp_dir.mkdir()
+        (wp_dir / "CUST-WP-0001-demo.md").write_text(
+            textwrap.dedent(
+                """\
+                ---
+                id: CUST-WP-0001
+                status: active
+                ---
+                ```task
+                id: CUST-WP-0001-T01
+                status: done
+                priority: high
+                ```
+                """
+            ),
+            encoding="utf-8",
+        )
+        content = _generate_work_record_index(tmp_path, "testrepo")
+        assert content is not None
+        assert "| workplan | CUST-WP-0001 | active | — | workplans/CUST-WP-0001-demo.md |" in content
+        assert "| task | CUST-WP-0001-T01 | done | — |" in content
+
+    def test_excludes_archived_workplans(self, tmp_path, registry_file):
+        wp_dir = tmp_path / "workplans" / "archived"
+        wp_dir.mkdir(parents=True)
+        (wp_dir / "260101-CUST-WP-0000-old.md").write_text(
+            "---\nid: CUST-WP-0000\nstatus: finished\n---\n", encoding="utf-8"
+        )
+        assert _generate_work_record_index(tmp_path, "testrepo") is None
+
+    def test_includes_intake_decision_engagement(self, tmp_path, registry_file):
+        (tmp_path / "queue.md").write_text(
+            textwrap.dedent(
+                """
+                ```yaml
+                id: AWQ-010
+                title: qonto mcp
+                status: open
+                lane: green
+                ```
+                ```yaml
+                id: BINKY-DEC-2026-004
+                title: qonto approval
+                status: resolved
+                lane: red
+                ```
+                ```yaml
+                id: BINKY-ENG-2026-001
+                title: bank call
+                status: queued
+                ```
+                """
+            ),
+            encoding="utf-8",
+        )
+        content = _generate_work_record_index(tmp_path, "testrepo")
+        assert "| intake | AWQ-010 | open | green | queue.md |" in content
+        assert "| decision | BINKY-DEC-2026-004 | resolved | red | queue.md |" in content
+        assert "| engagement | BINKY-ENG-2026-001 | queued | — | queue.md |" in content
+
+    def test_ignores_unregistered_ids(self, tmp_path, registry_file):
+        (tmp_path / "queue.md").write_text(
+            "```yaml\nid: FOO-QX-001\nstatus: open\n```\n", encoding="utf-8"
+        )
+        assert _generate_work_record_index(tmp_path, "testrepo") is None
+
+    def test_ignores_template_placeholders(self, tmp_path, registry_file):
+        (tmp_path / "AGENTS.md").write_text(
+            "```yaml\nid: BINKY-IN-NNNN\nstatus: open\n```\n", encoding="utf-8"
+        )
+        assert _generate_work_record_index(tmp_path, "testrepo") is None
+
+    def test_does_not_scan_its_own_output_file(self, tmp_path, registry_file):
+        (tmp_path / "WORK-RECORDS.md").write_text(
+            "| intake | AWQ-999 | open | green | ghost.md |\n", encoding="utf-8"
+        )
+        assert _generate_work_record_index(tmp_path, "testrepo") is None
+
+    def test_header_and_sort_order(self, tmp_path, registry_file):
+        (tmp_path / "b.md").write_text("```yaml\nid: AWQ-002\nstatus: open\n```\n", encoding="utf-8")
+        (tmp_path / "a.md").write_text("```yaml\nid: AWQ-001\nstatus: open\n```\n", encoding="utf-8")
+        content = _generate_work_record_index(tmp_path, "testrepo")
+        assert content.startswith("# Work Records — testrepo")
+        assert "[auto]" in content
+        # sorted by source path first (a.md before b.md)
+        assert content.index("AWQ-001") < content.index("AWQ-002")
+
+
+class TestCheckWorkRecordIndexFreshness:
+    def _report(self, repo_dir: Path, repo_slug: str = "testrepo") -> ConsistencyReport:
+        report = ConsistencyReport(repo_slug=repo_slug, repo_path=str(repo_dir))
+        _check_work_record_index_freshness(repo_dir, repo_slug, report)
+        return report
+
+    def test_no_issue_when_no_records(self, tmp_path, registry_file):
+        report = self._report(tmp_path)
+        assert report.issues == []
+
+    def test_flags_missing_index(self, tmp_path, registry_file):
+        (tmp_path / "queue.md").write_text("```yaml\nid: AWQ-001\nstatus: open\n```\n", encoding="utf-8")
+        report = self._report(tmp_path)
+        assert len(report.issues) == 1
+        assert report.issues[0].check_id == "C-33"
+        assert report.issues[0].fixable is True
+
+    def test_no_issue_when_index_already_current(self, tmp_path, registry_file):
+        (tmp_path / "queue.md").write_text("```yaml\nid: AWQ-001\nstatus: open\n```\n", encoding="utf-8")
+        content = _generate_work_record_index(tmp_path, "testrepo")
+        (tmp_path / "WORK-RECORDS.md").write_text(content, encoding="utf-8")
+        report = self._report(tmp_path)
+        assert report.issues == []
+
+    def test_flags_stale_index_after_new_record_added(self, tmp_path, registry_file):
+        (tmp_path / "queue.md").write_text("```yaml\nid: AWQ-001\nstatus: open\n```\n", encoding="utf-8")
+        content = _generate_work_record_index(tmp_path, "testrepo")
+        (tmp_path / "WORK-RECORDS.md").write_text(content, encoding="utf-8")
+        # a new record appears
+        (tmp_path / "queue.md").write_text(
+            "```yaml\nid: AWQ-001\nstatus: open\n```\n```yaml\nid: AWQ-002\nstatus: open\n```\n",
+            encoding="utf-8",
+        )
+        report = self._report(tmp_path)
+        assert len(report.issues) == 1
+        assert report.issues[0].check_id == "C-33"
+
+    def test_fix_context_carries_correct_content(self, tmp_path, registry_file):
+        (tmp_path / "queue.md").write_text("```yaml\nid: AWQ-001\nstatus: open\n```\n", encoding="utf-8")
+        report = self._report(tmp_path)
+        ctx = report.issues[0]._fix_context
+        assert ctx["index_file"] == tmp_path / "WORK-RECORDS.md"
+        assert "AWQ-001" in ctx["content"]
+
+    def test_flags_stale_index_when_only_archived_workplans_remain(
+        self, tmp_path, registry_file
+    ):
+        wp_dir = tmp_path / "workplans" / "archived"
+        wp_dir.mkdir(parents=True)
+        (wp_dir / "260101-CUST-WP-0000-old.md").write_text(
+            "---\nid: CUST-WP-0000\nstatus: finished\n---\n", encoding="utf-8"
+        )
+        (tmp_path / "WORK-RECORDS.md").write_text(
+            "| workplan | CUST-WP-0000 | active | — | workplans/CUST-WP-0000-old.md |\n",
+            encoding="utf-8",
+        )
+        report = self._report(tmp_path)
+        assert len(report.issues) == 1
+        assert report.issues[0].check_id == "C-33"
+        content = report.issues[0]._fix_context["content"]
+        assert "CUST-WP-0000" not in content
+        assert "| Kind | ID | Status | Lane | Source |" in content
+
+    def test_no_issue_when_empty_index_matches_archived_only_repo(
+        self, tmp_path, registry_file
+    ):
+        wp_dir = tmp_path / "workplans" / "archived"
+        wp_dir.mkdir(parents=True)
+        (wp_dir / "260101-CUST-WP-0000-old.md").write_text(
+            "---\nid: CUST-WP-0000\nstatus: finished\n---\n", encoding="utf-8"
+        )
+        (tmp_path / "WORK-RECORDS.md").write_text(
+            _work_record_index_document("testrepo", []), encoding="utf-8"
+        )
+        report = self._report(tmp_path)
+        assert report.issues == []
diff --git a/tests/test_work_record_projection_api.py b/tests/test_work_record_projection_api.py
new file mode 100644
index 0000000..81ab1b1
--- /dev/null
+++ b/tests/test_work_record_projection_api.py
@@ -0,0 +1,206 @@
+from __future__ import annotations
+
+from api.services import forge_projection as fp
+from tests.conftest import create_test_domain, create_test_repo
+
+
+def _derived(commit: str) -> fp.DerivedProjection:
+    workplan_id = "TEST-WP-ADHOC-2026-08-30"
+    task_id = f"{workplan_id}-T01"
+    return fp.DerivedProjection(
+        repo_slug="projection-test",
+        commit=commit,
+        workplans=[
+            fp.DerivedWorkplan(
+                record_id=workplan_id,
+                uuid=fp.derived_record_uuid(workplan_id),
+                title="Ad Hoc — 2026-08-30",
+                status="active",
+                relative_path="workplans/ADHOC-2026-08-30.md",
+                archived=False,
+                owner="codex",
+                description="Small opportunistic fixes.",
+                tasks=[
+                    fp.DerivedTask(
+                        record_id=task_id,
+                        uuid=fp.derived_record_uuid(task_id),
+                        title="Repair registration",
+                        status="progress",
+                        priority="high",
+                        description="Make registration deterministic.",
+                        needs_human=True,
+                        intervention_note="Review the rollout.",
+                        blocking_reason="Waiting for rollout approval.",
+                    )
+                ],
+            )
+        ],
+    )
+
+
+async def test_primary_reconciles_exact_commit_and_replays(client, monkeypatch) -> None:
+    await create_test_domain(client)
+    repo = await create_test_repo(client, slug="projection-test")
+    commit = "a" * 40
+    calls = 0
+
+    def derive(_slug: str):
+        nonlocal calls
+        calls += 1
+        return _derived(commit)
+
+    from api.config import settings
+    from api.routers import work_record_projection as route
+
+    monkeypatch.setattr(settings, "state_hub_instance_role", "primary")
+    monkeypatch.setattr(settings, "state_hub_instance_label", "railliance01")
+    monkeypatch.setattr(route, "derive_from_forge", derive)
+    headers = {"Idempotency-Key": f"projection-test:{commit}"}
+    response = await client.post(
+        "/repos/projection-test/work-record-projection/reconcile",
+        json={"expected_commit": commit},
+        headers=headers,
+    )
+    assert response.status_code == 200, response.text
+    assert response.json()["outcome"]["status"] == "applied"
+
+    replay = await client.post(
+        "/repos/projection-test/work-record-projection/reconcile",
+        json={"expected_commit": commit},
+        headers=headers,
+    )
+    assert replay.status_code == 200
+    assert replay.headers["X-StateHub-Idempotency-Replay"] == "true"
+    assert calls == 1
+
+    workplan_id = fp.derived_record_uuid("TEST-WP-ADHOC-2026-08-30")
+    workplan = await client.get(f"/workplans/{workplan_id}")
+    assert workplan.status_code == 200
+    assert workplan.json()["repo_id"] == repo["id"]
+    assert workplan.json()["owner"] == "codex"
+    assert workplan.json()["description"] == "Small opportunistic fixes."
+
+    tasks = await client.get("/tasks/", params={"workplan_id": workplan_id})
+    assert tasks.status_code == 200
+    task = tasks.json()[0]
+    assert task["record_id"] == "TEST-WP-ADHOC-2026-08-30-T01"
+    assert task["status"] == "progress"
+    assert task["priority"] == "high"
+    assert task["needs_human"] is True
+    assert task["intervention_note"] == "Review the rollout."
+
+    snapshot = await client.get(
+        "/repos/projection-test/work-record-projection/snapshot"
+    )
+    assert snapshot.status_code == 200, snapshot.text
+    payload = snapshot.json()
+    assert payload["schema"] == "state-hub.repository-projection-snapshot.v1"
+    assert payload["repo_id"] == repo["id"]
+    assert [row["id"] for row in payload["workplans"]] == [str(workplan_id)]
+    assert [row["record_id"] for row in payload["tasks"]] == [
+        "TEST-WP-ADHOC-2026-08-30-T01"
+    ]
+    assert payload["dependencies"] == []
+
+
+async def test_reconcile_rejects_non_primary_before_forge_access(
+    client, monkeypatch
+) -> None:
+    from api.config import settings
+    from api.routers import work_record_projection as route
+
+    monkeypatch.setattr(settings, "state_hub_instance_role", "cache")
+    monkeypatch.setattr(settings, "state_hub_instance_label", "workstation")
+
+    def forbidden(_slug: str):
+        raise AssertionError("forge must not be read by a non-primary endpoint")
+
+    monkeypatch.setattr(route, "derive_from_forge", forbidden)
+    response = await client.post(
+        "/repos/projection-test/work-record-projection/reconcile",
+        json={"expected_commit": "a" * 40},
+    )
+    assert response.status_code == 409
+    assert response.json()["detail"]["instance_role"] == "cache"
+
+
+async def test_reconcile_rejects_commit_mismatch_without_db_changes(
+    client, monkeypatch
+) -> None:
+    await create_test_domain(client)
+    await create_test_repo(client, slug="projection-test")
+    from api.config import settings
+    from api.routers import work_record_projection as route
+
+    monkeypatch.setattr(settings, "state_hub_instance_role", "primary")
+    monkeypatch.setattr(settings, "state_hub_instance_label", "railliance01")
+    monkeypatch.setattr(route, "derive_from_forge", lambda _slug: _derived("b" * 40))
+    response = await client.post(
+        "/repos/projection-test/work-record-projection/reconcile",
+        json={"expected_commit": "a" * 40},
+    )
+    assert response.status_code == 409
+    rows = await client.get(
+        "/workplans/",
+        params={"repo_id": (await client.get("/repos/projection-test")).json()["id"]},
+    )
+    assert rows.status_code == 200
+    assert rows.json() == []
+
+
+async def test_real_source_projection_converges_without_followup_task_patches(client, monkeypatch, tmp_path):
+    """Derive source through the real parser and persist it through the real API/DB."""
+    await create_test_domain(client)
+    await create_test_repo(client, slug="projection-test")
+    from api.config import settings
+    from api.routers import work_record_projection as route
+
+    monkeypatch.setattr(settings, "state_hub_instance_role", "primary")
+    monkeypatch.setattr(settings, "state_hub_instance_label", "railiance01")
+    root = tmp_path / "projection-test"
+    (root / "workplans").mkdir(parents=True)
+    path = root / "workplans/TEST-WP-0001.md"
+    path.write_text('''---
+id: TEST-WP-0001
+type: workplan
+title: Factory test
+status: active
+---
+## Native admission
+
+```task
+id: TEST-WP-0001-T01
+status: wait
+intervention_note: Review needed.
+blocking_reason: Waiting.
+needs_human: true
+```
+
+Admission context.
+
+### Proof
+
+Retain full proof.
+''')
+    commit = "a" * 40
+    monkeypatch.setattr(route, "derive_from_forge", lambda slug: fp.derive_from_checkout(root, slug, commit))
+    endpoint = "/repos/projection-test/work-record-projection/reconcile"
+    first = await client.post(endpoint, json={"expected_commit": commit}, headers={"Idempotency-Key": "source:first"})
+    assert first.status_code == 200, first.text
+    task_id = fp.derived_record_uuid("TEST-WP-0001-T01")
+    created = (await client.get(f"/tasks/{task_id}")).json()
+    assert created["description"] == "Admission context.\n\n### Proof\n\nRetain full proof."
+    assert created["needs_human"] is True
+
+    path.write_text(path.read_text().replace("Review needed.", '""').replace("Waiting.", '""').replace("needs_human: true", "needs_human: false"))
+    commit = "b" * 40
+    for key in ["source:updated", "source:independent-rederivation"]:
+        result = await client.post(endpoint, json={"expected_commit": commit}, headers={"Idempotency-Key": key})
+        assert result.status_code == 200, result.text
+        assert result.json()["outcome"]["status"] in {"applied", "noop"}
+        actual = (await client.get(f"/tasks/{task_id}")).json()
+        assert actual["description"] == created["description"]
+        assert actual["intervention_note"] == actual["blocking_reason"] == ""
+        assert actual["needs_human"] is False
+        if key == "source:independent-rederivation":
+            assert result.json()["outcome"]["counts"]["updated_tasks"] == 0
diff --git a/tests/test_work_record_registration.py b/tests/test_work_record_registration.py
new file mode 100644
index 0000000..5a03186
--- /dev/null
+++ b/tests/test_work_record_registration.py
@@ -0,0 +1,201 @@
+"""Unit tests for C-32 (work-record registration: intake/decision kinds,
+CUST-WP-0061-T02) — detection and file write-back only. The live
+create-in-DB path is covered by the fix_repo integration path, proven
+manually against a real repo/API (see CUST-WP-0061 progress notes); these
+tests stay offline and use a synthetic registry fixture, matching the
+conventions in test_work_record_check.py.
+"""
+from __future__ import annotations
+
+import sys
+import textwrap
+from pathlib import Path
+
+import pytest
+import yaml
+
+sys.path.insert(0, str(Path(__file__).parent.parent / "scripts"))
+
+from consistency_check import (  # noqa: E402
+    ConsistencyReport,
+    _check_work_record_registration,
+    _classify_work_record_kind,
+    _inject_yaml_block_field,
+    _load_work_record_kind_registry,
+)
+
+REGISTRY_YAML = textwrap.dedent(
+    """
+    version: "0.1"
+    kinds:
+      - kind: intake
+        id_patterns: ['^[A-Z]+-IN-[0-9]{4}$']
+        legacy_patterns:
+          - pattern: '^AWQ-[0-9]{3}$'
+            source: binky AutopilotWorkQueue
+      - kind: decision
+        id_patterns: ['^[A-Z]+-DEC-[0-9]{4}-[0-9]{3}$']
+        legacy_patterns:
+          - pattern: '^DEC-[0-9]{4}-[0-9]{3}$'
+            source: binky DecisionQueue
+      - kind: engagement
+        id_patterns: ['^[A-Z]+-ENG-[0-9]{4}-[0-9]{3}$']
+        legacy_patterns:
+          - pattern: '^OH-[0-9]{4}-[0-9]{3}$'
+            source: binky OfficeHourQueue
+      - kind: workplan
+        id_patterns: ['^[A-Z]+-WP-[0-9]{4}$']
+    """
+)
+
+
+@pytest.fixture
+def registry_file(tmp_path, monkeypatch):
+    reg = tmp_path / "work-record-types.yaml"
+    reg.write_text(REGISTRY_YAML, encoding="utf-8")
+    monkeypatch.setenv("WORK_RECORD_REGISTRY", str(reg))
+    return reg
+
+
+class TestClassifyWorkRecordKind:
+    def test_classifies_intake(self, registry_file):
+        kinds = _load_work_record_kind_registry()
+        assert _classify_work_record_kind("BINKY-IN-0001", kinds) == "intake"
+
+    def test_classifies_legacy_awq(self, registry_file):
+        kinds = _load_work_record_kind_registry()
+        assert _classify_work_record_kind("AWQ-010", kinds) == "intake"
+
+    def test_classifies_decision(self, registry_file):
+        kinds = _load_work_record_kind_registry()
+        assert _classify_work_record_kind("DEC-2026-004", kinds) == "decision"
+
+    def test_unregistered_returns_none(self, registry_file):
+        kinds = _load_work_record_kind_registry()
+        assert _classify_work_record_kind("FOO-QX-001", kinds) is None
+
+
+class TestCheckWorkRecordRegistration:
+    def _report(self, repo_dir: Path) -> ConsistencyReport:
+        report = ConsistencyReport(repo_slug="test", repo_path=str(repo_dir))
+        _check_work_record_registration(repo_dir, report)
+        return report
+
+    def test_intake_without_hub_id_is_flagged_fixable(self, tmp_path, registry_file):
+        (tmp_path / "queue.md").write_text(
+            "```yaml\nid: BINKY-IN-0001\ntitle: needs registration\n```\n",
+            encoding="utf-8",
+        )
+        report = self._report(tmp_path)
+        assert len(report.issues) == 1
+        issue = report.issues[0]
+        assert issue.check_id == "C-32"
+        assert issue.fixable is True
+        assert issue._fix_context["kind"] == "intake"
+        assert issue._fix_context["rid"] == "BINKY-IN-0001"
+
+    def test_intake_with_hub_id_is_skipped(self, tmp_path, registry_file):
+        (tmp_path / "queue.md").write_text(
+            '```yaml\nid: BINKY-IN-0001\ntitle: already linked\n'
+            'state_hub_intake_id: "019f8000-0000-7000-8000-000000000000"\n```\n',
+            encoding="utf-8",
+        )
+        report = self._report(tmp_path)
+        assert report.issues == []
+
+    def test_decision_without_hub_id_is_flagged_fixable(self, tmp_path, registry_file):
+        (tmp_path / "DecisionQueue.md").write_text(
+            "```yaml\nid: DEC-2026-005\ntitle: a new decision\n```\n",
+            encoding="utf-8",
+        )
+        report = self._report(tmp_path)
+        assert len(report.issues) == 1
+        assert report.issues[0]._fix_context["kind"] == "decision"
+
+    def test_engagement_without_hub_id_is_info_not_fixable(self, tmp_path, registry_file):
+        (tmp_path / "OfficeHourQueue.md").write_text(
+            "```yaml\nid: OH-2026-001\ntitle: bank call\n```\n",
+            encoding="utf-8",
+        )
+        report = self._report(tmp_path)
+        assert len(report.issues) == 1
+        assert report.issues[0].severity == "INFO"
+        assert report.issues[0].fixable is False
+
+    def test_workplan_kind_is_untouched_by_c32(self, tmp_path, registry_file):
+        """Workplans keep their own C-06 registration path; C-32 must not
+        double-register them."""
+        (tmp_path / "workplans" / "CUST-WP-0099-x.md").parent.mkdir(parents=True)
+        (tmp_path / "workplans" / "CUST-WP-0099-x.md").write_text(
+            "---\nid: CUST-WP-0099\n---\n```yaml\nid: CUST-WP-0099\ntitle: x\n```\n",
+            encoding="utf-8",
+        )
+        report = self._report(tmp_path)
+        assert report.issues == []
+
+    def test_template_placeholder_ignored(self, tmp_path, registry_file):
+        (tmp_path / "AGENTS.md").write_text(
+            "```yaml\nid: BINKY-IN-NNNN\ntitle: template\n```\n", encoding="utf-8"
+        )
+        report = self._report(tmp_path)
+        assert report.issues == []
+
+    def test_no_op_when_registry_unavailable(self, tmp_path, monkeypatch):
+        monkeypatch.setenv("WORK_RECORD_REGISTRY", str(tmp_path / "missing.yaml"))
+        monkeypatch.setattr(Path, "home", lambda: tmp_path / "nohome")
+        (tmp_path / "queue.md").write_text(
+            "```yaml\nid: BINKY-IN-0001\ntitle: x\n```\n", encoding="utf-8"
+        )
+        report = self._report(tmp_path)
+        assert report.issues == []
+
+
+class TestInjectYamlBlockField:
+    def test_injects_field_into_matching_block(self, tmp_path):
+        md = tmp_path / "queue.md"
+        md.write_text(
+            "```yaml\nid: BINKY-IN-0001\ntitle: needs registration\n```\n",
+            encoding="utf-8",
+        )
+        changed = _inject_yaml_block_field(
+            md, "state_hub_intake_id", "019f8000-0000-7000-8000-000000000000", "BINKY-IN-0001"
+        )
+        assert changed is True
+        text = md.read_text()
+        assert 'state_hub_intake_id: "019f8000-0000-7000-8000-000000000000"' in text
+        # round-trips as valid yaml
+        block = text.split("```yaml\n", 1)[1].rsplit("```", 1)[0]
+        parsed = yaml.safe_load(block)
+        assert parsed["state_hub_intake_id"] == "019f8000-0000-7000-8000-000000000000"
+
+    def test_does_not_touch_other_blocks(self, tmp_path):
+        md = tmp_path / "queue.md"
+        md.write_text(
+            "```yaml\nid: BINKY-IN-0001\ntitle: first\n```\n"
+            "```yaml\nid: BINKY-IN-0002\ntitle: second\n```\n",
+            encoding="utf-8",
+        )
+        _inject_yaml_block_field(md, "state_hub_intake_id", "abc-123", "BINKY-IN-0001")
+        text = md.read_text()
+        assert "abc-123" in text
+        second_block = text.split("BINKY-IN-0002")[1]
+        assert "state_hub_intake_id" not in second_block
+
+    def test_no_op_when_id_not_found(self, tmp_path):
+        md = tmp_path / "queue.md"
+        original = "```yaml\nid: BINKY-IN-0001\ntitle: x\n```\n"
+        md.write_text(original, encoding="utf-8")
+        changed = _inject_yaml_block_field(md, "state_hub_intake_id", "abc-123", "BINKY-IN-9999")
+        assert changed is False
+        assert md.read_text() == original
+
+    def test_idempotent_when_field_already_set(self, tmp_path):
+        md = tmp_path / "queue.md"
+        md.write_text(
+            '```yaml\nid: BINKY-IN-0001\nstate_hub_intake_id: "already-there"\n```\n',
+            encoding="utf-8",
+        )
+        changed = _inject_yaml_block_field(md, "state_hub_intake_id", "new-value", "BINKY-IN-0001")
+        assert changed is False
+        assert "already-there" in md.read_text()
+        assert "new-value" not in md.read_text()
diff --git a/uv.lock b/uv.lock
index 6ed4f25..1341983 100644
--- a/uv.lock
+++ b/uv.lock
@@ -538,17 +538,29 @@ dependencies = [
     { name = "fastapi" },
     { name = "fastmcp" },
     { name = "httpx" },
+    { name = "jsonschema" },
     { name = "pydantic" },
     { name = "sqlalchemy", extra = ["asyncio"] },
 ]
 
 [package.metadata]
 requires-dist = [
+    { name = "alembic", marker = "extra == 'runtime'", specifier = ">=1.13.0" },
+    { name = "asyncpg", marker = "extra == 'runtime'", specifier = ">=0.29.0" },
     { name = "fastapi", specifier = ">=0.115.0" },
     { name = "fastmcp", specifier = ">=2.0.0" },
     { name = "httpx", specifier = ">=0.28.0" },
+    { name = "jsonschema", specifier = ">=4.23.0" },
+    { name = "psycopg2-binary", marker = "extra == 'runtime'", specifier = ">=2.9.0" },
     { name = "pydantic", specifier = ">=2.10.0" },
     { name = "sqlalchemy", extras = ["asyncio"], specifier = ">=2.0.0" },
+    { name = "uvicorn", extras = ["standard"], marker = "extra == 'runtime'", specifier = ">=0.30.0" },
+]
+
+[package.metadata.requires-dev]
+dev = [
+    { name = "aiosqlite", specifier = ">=0.20.0" },
+    { name = "pytest", specifier = ">=8.0.0" },
 ]
 
 [[package]]
diff --git a/workplans/ADHOC-2026-06-04.md b/workplans/ADHOC-2026-06-04.md
index 3eae519..4c37d48 100644
--- a/workplans/ADHOC-2026-06-04.md
+++ b/workplans/ADHOC-2026-06-04.md
@@ -1,5 +1,5 @@
 ---
-id: ADHOC-2026-06-04
+id: STATE-WP-ADHOC-2026-06-04
 type: workplan
 title: "Ad hoc fixes - 2026-06-04"
 domain: custodian
@@ -9,7 +9,7 @@ owner: codex
 topic_slug: custodian
 created: "2026-06-04"
 updated: "2026-06-04"
-state_hub_workstream_id: "2a8f3aff-8f5d-4e42-b33f-225d60e0b30b"
+state_hub_workstream_id: "b13e38a7-8623-5a31-b6b0-3d94d42afcd6"
 ---
 
 # Ad hoc fixes - 2026-06-04
@@ -17,10 +17,10 @@ state_hub_workstream_id: "2a8f3aff-8f5d-4e42-b33f-225d60e0b30b"
 ## Fix Dashboard Overview API Loading
 
 ```task
-id: ADHOC-2026-06-04-T01
+id: STATE-WP-ADHOC-2026-06-04-T01
 status: done
 priority: high
-state_hub_task_id: "5f6aa1e4-ccc5-4c8b-8183-cc1578190b7b"
+state_hub_task_id: "ef58247a-24c2-5362-a851-adb31c747abf"
 ```
 
 The overview page reported `Dashboard data load failed: NetworkError when
diff --git a/workplans/ADHOC-2026-07-01.md b/workplans/ADHOC-2026-07-01.md
index a32ed96..0c73772 100644
--- a/workplans/ADHOC-2026-07-01.md
+++ b/workplans/ADHOC-2026-07-01.md
@@ -1,5 +1,5 @@
 ---
-id: ADHOC-2026-07-01
+id: STATE-WP-ADHOC-2026-07-01
 type: workplan
 title: "Ad hoc fixes - 2026-07-01"
 domain: infotech
@@ -9,7 +9,7 @@ owner: codex
 topic_slug: custodian
 created: "2026-07-01"
 updated: "2026-07-01"
-state_hub_workstream_id: "1cdb288a-9bcb-4e53-8c4f-cb43e3abe9c5"
+state_hub_workstream_id: "61e04529-bc2a-50b7-815a-f09a4733eb92"
 ---
 
 # Ad hoc fixes - 2026-07-01
@@ -17,10 +17,10 @@ state_hub_workstream_id: "1cdb288a-9bcb-4e53-8c4f-cb43e3abe9c5"
 ## Add Local State Hub Consistency CLI
 
 ```task
-id: ADHOC-2026-07-01-T01
+id: STATE-WP-ADHOC-2026-07-01-T01
 status: done
 priority: medium
-state_hub_task_id: "060e6e63-b456-418e-83c5-7660fa206800"
+state_hub_task_id: "a7e2fb28-ee88-511f-8ed6-ebcd9f778094"
 ```
 
 Add `statehub fix-consistency` so agents can reconcile ADR-001 workplan files
@@ -31,10 +31,10 @@ agent instructions to make the CLI sync a normal agent close-out step.
 ## Clear Closed-Workstream C-12 Orphan Warnings
 
 ```task
-id: ADHOC-2026-07-01-T02
+id: STATE-WP-ADHOC-2026-07-01-T02
 status: done
 priority: medium
-state_hub_task_id: "076b97bd-fb97-47f9-9733-c8eac6cd6355"
+state_hub_task_id: "b33205fc-135a-53ac-83db-c1697a9476e8"
 ```
 
 Treat terminal DB-only tasks in closed workstreams as non-actionable historical
diff --git a/workplans/ADHOC-2026-08-08.md b/workplans/ADHOC-2026-08-08.md
new file mode 100644
index 0000000..0a10c26
--- /dev/null
+++ b/workplans/ADHOC-2026-08-08.md
@@ -0,0 +1,65 @@
+---
+id: STATE-WP-ADHOC-2026-08-08
+type: workplan
+title: "Ad hoc fixes — 2026-08-08"
+domain: infotech
+repo: state-hub
+status: finished
+owner: codex
+topic_slug: state-hub
+created: "2026-08-08"
+updated: "2026-08-08"
+state_hub_workstream_id: "f2f173fd-23bb-5623-9921-f0032f03059f"
+---
+
+## Integrate State Hub connectivity into Codex setup
+
+```task
+id: STATE-WP-ADHOC-2026-08-08-T01
+status: done
+priority: medium
+state_hub_task_id: "219e6d19-90bf-59c0-b056-c3e654b6ddf4"
+```
+
+Add an idempotent Codex configuration step to the operator bootstrap, verify
+State Hub loopback access from the Codex sandbox, distinguish managed-policy
+isolation from an actual hub outage, and propagate accurate agent guidance.
+
+## Repair Codex stdio MCP launcher
+
+```task
+id: STATE-WP-ADHOC-2026-08-08-T02
+status: done
+priority: high
+state_hub_task_id: "3a0441e7-f6c1-57e5-be8d-22f209f7a775"
+```
+
+Remove the stdio MCP launcher's runtime dependency on the read-only global uv
+cache, execute the repository virtual environment directly, and verify an MCP
+initialize exchange through the registered launcher.
+
+## Split a slim Codex MCP surface from full dev-hub administration
+
+```task
+id: STATE-WP-ADHOC-2026-08-08-T03
+status: done
+priority: high
+state_hub_task_id: "28c4ee09-58ba-5856-b012-978feb068bad"
+```
+
+Limit Codex registration to essential repository coordination tools while
+leaving the full State Hub MCP server and SSE transport available to clients
+that need the administrative surface.
+
+## Make Codex MCP opt-in
+
+```task
+id: STATE-WP-ADHOC-2026-08-08-T04
+status: done
+priority: high
+state_hub_task_id: "2b4f236b-21a9-5a1f-b082-555c0aa42c97"
+```
+
+Remove the default Codex dev-hub registration after bridge-level latency and
+startup interruption persisted, retain the slim server for explicit testing,
+and make REST plus the statehub CLI the documented Codex default.
diff --git a/workplans/ADHOC-2026-08-23.md b/workplans/ADHOC-2026-08-23.md
new file mode 100644
index 0000000..e4f7deb
--- /dev/null
+++ b/workplans/ADHOC-2026-08-23.md
@@ -0,0 +1,27 @@
+---
+id: STATE-WP-ADHOC-2026-08-23
+type: workplan
+title: "Ad hoc fixes — 2026-08-23"
+domain: infotech
+repo: state-hub
+status: finished
+owner: codex
+topic_slug: state-hub
+created: "2026-08-23"
+updated: "2026-08-23"
+state_hub_workstream_id: "ca64e5e1-e524-549f-b908-cc9aeed2da1c"
+---
+
+## Repair classification registration updates
+
+```task
+id: STATE-WP-ADHOC-2026-08-23-T01
+status: done
+priority: high
+state_hub_task_id: "0f3365cc-ba90-52d3-9588-1c687248d944"
+```
+
+Keep existing-repo classification PATCHes separate from Git identity metadata,
+support primary-domain reclassification through the API, and normalize
+multi-root Git histories to the same single-root fingerprint used by token
+attribution. Add regression coverage for each affected contract.
diff --git a/workplans/ADHOC-2026-08-30.md b/workplans/ADHOC-2026-08-30.md
new file mode 100644
index 0000000..b6011fa
--- /dev/null
+++ b/workplans/ADHOC-2026-08-30.md
@@ -0,0 +1,46 @@
+---
+id: STATE-WP-ADHOC-2026-08-30
+type: workplan
+title: "Ad hoc fixes — 2026-08-30"
+domain: infotech
+repo: state-hub
+status: finished
+owner: codex
+topic_slug: state-hub
+created: "2026-08-30"
+updated: "2026-08-30"
+state_hub_workstream_id: "0b6218b2-8dce-5c11-aa5a-196c0521f3fe"
+---
+
+## Align UI startup with the production State Hub
+
+```task
+id: STATE-WP-ADHOC-2026-08-30-T01
+status: done
+priority: high
+state_hub_task_id: "82e36947-3ca3-522d-b5ae-78c2e00e16d8"
+```
+
+Make the railiance01 production tunnel plus workstation dashboard the normal
+documented startup path. Clearly separate local fallback commands and prevent
+the normal dashboard/tunnel targets from silently using an empty local API.
+
+Completed 2026-08-30. The README and Makefile now present `make bridges`
+followed by `make dashboard` as the normal production UI path. The bridge guard
+rejects a non-primary listener on port 8000; the dashboard and `make check`
+require `primary/railiance01`; `make dashboard-local` remains available for
+intentional fallback development. `make dashboard-check` built all 71 pages
+successfully (with the pre-existing `/docs/intakes` → `/suggestions` broken-link
+warning).
+
+## Package the quality-debt CLI
+
+```task
+id: STATE-WP-ADHOC-2026-08-30-T02
+status: done
+priority: medium
+state_hub_task_id: "2fdc57f8-af0b-54e5-98b6-8476d53cddb1"
+description: "Included scripts/quality_debt.py and scripts/quality_assessment.py in State Hub wheels. Added a packaging regression; 21 focused CLI tests pass. A clean wheel install ran statehub quality-debt successfully and reported 43 existing quality-debt items."
+```
+
+Include the quality-debt scanner and its assessment helper in State Hub wheels, and verify the installed CLI works outside the source checkout.
diff --git a/workplans/ADHOC-2026-09-04.md b/workplans/ADHOC-2026-09-04.md
new file mode 100644
index 0000000..c1d8050
--- /dev/null
+++ b/workplans/ADHOC-2026-09-04.md
@@ -0,0 +1,36 @@
+---
+id: STATE-WP-ADHOC-2026-09-04
+type: workplan
+title: "Ad hoc fixes — 2026-09-04"
+domain: infotech
+repo: state-hub
+status: finished
+owner: codex
+topic_slug: state-hub
+created: "2026-09-04"
+updated: "2026-09-04"
+state_hub_workstream_id: "b4dbf82d-3a94-59ae-bbc4-2bed72af74fd"
+---
+
+## Add explicit topic selection to statehub register
+
+```task
+id: STATE-WP-ADHOC-2026-09-04-T01
+status: done
+priority: high
+state_hub_task_id: "dc232f74-e2c4-57d6-83fe-d0fb28f12397"
+```
+
+Add a `--topic` option that selects an existing active topic by slug within the
+chosen domain. Refuse missing, cross-domain, or ambiguous topic selection rather
+than silently assigning the first active topic in the domain. Preserve the
+single-topic fallback and exact inferred-topic selection for compatibility.
+
+Completed 2026-09-04. `statehub register --domain <domain> --topic <slug>` now
+selects the exact active topic and propagates its UUID to generated files, the
+repository registration/update, and the progress receipt. An explicit missing
+or cross-domain slug fails with a targeted error. Without `--topic`, an exact
+inference match wins, a sole domain topic remains backward-compatible, and an
+ambiguous domain now requires an explicit choice. Focused registration tests
+pass (`26 passed`); the full suite passes (`835 passed`, one pre-existing
+SQLAlchemy warning). Source distribution and wheel builds succeed.
diff --git a/workplans/CUST-WP-0038-state-hub-threephoenix-ha.md b/workplans/CUST-WP-0038-state-hub-threephoenix-ha.md
index 18857dd..53162b6 100644
--- a/workplans/CUST-WP-0038-state-hub-threephoenix-ha.md
+++ b/workplans/CUST-WP-0038-state-hub-threephoenix-ha.md
@@ -5,12 +5,13 @@ title: "State Hub Full ThreePhoenix HA Migration"
 domain: infotech
 repo: state-hub
 status: backlog
+flavor: implementation
 owner: custodian
 topic_slug: custodian
 created: "2026-05-02"
-updated: "2026-07-07"
+updated: "2026-08-08"
 depends_on: CUST-WP-0011
-state_hub_workstream_id: "8d0c1b5d-44da-4b91-8357-e6526d3e0a85"
+state_hub_workstream_id: "ccb87fa4-6381-5f22-b097-6e026f56a9c1"
 ---
 
 # State Hub Full ThreePhoenix HA Migration
@@ -49,10 +50,16 @@ keeps the ultimate target visible and reviewable.
 - Railiance architecture decision for storage replication is current:
   Longhorn, cnpg replication, external backup, or a documented replacement.
 - Backup and restore tooling has an owner and runbook.
+- `RAIL-BS-WP-0007` has published a passing ThreePhoenix one-server-loss
+  acceptance record. This workplan consumes that S2 evidence; it does not own
+  Kubernetes topology or cluster-runtime readiness.
 
 ## Target Properties
 
-- Three healthy Kubernetes nodes: Railiance01, Railiance02, Railiance03.
+- Three healthy Kubernetes server nodes mapped to source-backed
+  `reef-railiance` members and documented failure domains. Railiance01 is the
+  current member; future member names must come from reef/S1 declarations
+  rather than being assumed here.
 - State Hub database survives loss of one node.
 - State Hub API recovers from pod loss without manual repair.
 - Backups are encrypted, off-node, and restorable into a test namespace.
@@ -67,7 +74,7 @@ keeps the ultimate target visible and reviewable.
 id: CUST-WP-0038-T01
 status: todo
 priority: high
-state_hub_task_id: "aa1bf291-3b6c-4940-a4f5-7680b0349110"
+state_hub_task_id: "5c79e069-281e-5b3c-a45e-3e906b9053fa"
 ```
 
 Verify the target cluster state:
@@ -76,9 +83,13 @@ Verify the target cluster state:
 - Control-plane and worker roles are documented.
 - Cluster version and node resources are recorded.
 - Smoke tests pass from the operator machine and from CoulombCore.
+- The current `RAIL-BS-WP-0007` acceptance record proves etcd quorum, API,
+  scheduling, DNS, networking, and the private service path survive loss of
+  any one server.
 
 **Done when:** a current readiness report exists and no node is marked
-NotReady or operationally unknown.
+NotReady or operationally unknown, and the report cites the passing S2
+one-server-loss evidence.
 
 ---
 
@@ -88,7 +99,7 @@ NotReady or operationally unknown.
 id: CUST-WP-0038-T02
 status: todo
 priority: high
-state_hub_task_id: "5575f244-5cef-47aa-a168-24027cd08140"
+state_hub_task_id: "b91f9086-c526-5452-bade-ad2451ce3bd3"
 ```
 
 Choose and document the durable data strategy for State Hub:
@@ -110,7 +121,7 @@ production data movement.
 id: CUST-WP-0038-T03
 status: todo
 priority: high
-state_hub_task_id: "5330fcc3-684b-49f6-8d28-ea8c929733d6"
+state_hub_task_id: "b6fbdfe2-7561-561d-936b-d531300f88aa"
 ```
 
 Apply the chosen database/storage architecture to State Hub.
@@ -133,7 +144,7 @@ namespace.
 id: CUST-WP-0038-T04
 status: todo
 priority: medium
-state_hub_task_id: "64175ed0-af36-47ea-9401-74c4b15ffe24"
+state_hub_task_id: "c7f59893-6042-540c-ada7-e3661ffdabf7"
 ```
 
 Run State Hub API with the right availability posture for its workload:
@@ -153,7 +164,7 @@ Run State Hub API with the right availability posture for its workload:
 id: CUST-WP-0038-T05
 status: todo
 priority: high
-state_hub_task_id: "73c5008a-380e-42bf-ad57-1c9d0bda3a86"
+state_hub_task_id: "390f292d-1d74-5ca7-a08c-530e9c679bd3"
 ```
 
 Perform a controlled failover drill for the State Hub database.
@@ -164,6 +175,10 @@ Checks:
 - API behavior during failover is observed.
 - Recovery time is measured.
 - No data loss is detected after recovery.
+- The failure trigger removes the node hosting the database primary, not only
+  the database pod, and API behavior is observed throughout node loss.
+- Kubernetes control-plane continuity is cited from `RAIL-BS-WP-0007`; this
+  task records the State Hub-specific database and API result.
 
 **Done when:** the failover drill passes and results are logged.
 
@@ -175,7 +190,7 @@ Checks:
 id: CUST-WP-0038-T06
 status: todo
 priority: high
-state_hub_task_id: "4e5b97ff-ef1c-414d-812b-39b87b242c74"
+state_hub_task_id: "e7640bd3-827b-5f8c-b03b-93e76eb8c412"
 ```
 
 Restore the latest encrypted State Hub backup into an isolated namespace or
@@ -199,7 +214,7 @@ Checks:
 id: CUST-WP-0038-T07
 status: todo
 priority: medium
-state_hub_task_id: "959062d8-decb-4969-a60b-0d3b618a8d6c"
+state_hub_task_id: "6492555c-aa6a-5c91-a2cf-3824fe1f1b12"
 ```
 
 Update the private access model after the HA endpoint is available:
@@ -222,7 +237,7 @@ status: todo
 priority: low
 needs_human: true
 intervention_note: "Requires explicit approval after HA failover and restore drills pass."
-state_hub_task_id: "d4a7ca26-c338-48a1-b8b1-85a356550add"
+state_hub_task_id: "57412aef-f47a-5b58-b0a3-ca066d05ca09"
 ```
 
 Retire the WSL2 State Hub as a disaster-recovery fallback only after the HA
@@ -241,6 +256,10 @@ model, and the cluster runbook is the source of truth.
 ## References
 
 - `CUST-WP-0011` — pragmatic railiance01 migration
+- `railiance-cluster/RAIL-BS-WP-0007` — ThreePhoenix S2 topology and
+  one-server-loss acceptance evidence
+- `reef-railiance/REEF-RAILIANCE-WP-0003` — separate Qonto workload
+  production gate; not satisfied by the State Hub migration
 - Railiance ThreePhoenix infrastructure goal
 - State Hub backup/restore runbooks
 - Constitution constraint: irreversible retirement requires human approval
diff --git a/workplans/STATE-WP-0071-railiance01-workstream-caller-deploy.md b/workplans/STATE-WP-0071-railiance01-workstream-caller-deploy.md
index 4e0b2bf..ba5b181 100644
--- a/workplans/STATE-WP-0071-railiance01-workstream-caller-deploy.md
+++ b/workplans/STATE-WP-0071-railiance01-workstream-caller-deploy.md
@@ -11,7 +11,7 @@ planning_priority: high
 planning_order: 71
 created: "2026-07-09"
 updated: "2026-07-09"
-state_hub_workstream_id: "cf7199a1-ee62-437f-994a-30c32111d747"
+state_hub_workstream_id: "fb442549-8491-4a83-87d6-c2849dd85b30"
 ---
 
 # STATE-WP-0071 — Railiance01 workstream caller migration deploy
diff --git a/workplans/STATE-WP-0072-workstream-caller-remediation.md b/workplans/STATE-WP-0072-workstream-caller-remediation.md
index 5df9c5f..a7bee4f 100644
--- a/workplans/STATE-WP-0072-workstream-caller-remediation.md
+++ b/workplans/STATE-WP-0072-workstream-caller-remediation.md
@@ -11,7 +11,7 @@ planning_priority: high
 planning_order: 72
 created: "2026-07-09"
 updated: "2026-07-09"
-state_hub_workstream_id: "b7122b4b-c253-48dd-877b-24243a064fb2"
+state_hub_workstream_id: "e5b1ba1b-6302-5699-a888-819d017e710f"
 ---
 
 # STATE-WP-0072 — Workstream caller remediation
@@ -31,7 +31,7 @@ show declining `GET /workstreams/*` counts.
 id: STATE-WP-0072-T01
 status: done
 priority: high
-state_hub_task_id: "918df047-277f-41e4-ad04-b6f1095f8e45"
+state_hub_task_id: "6d2f85d4-6fb5-58d1-be96-8cb37c9726d8"
 ```
 
 - `dashboard/src/workstreams/[id].md` — tasks fetch uses `?workplan_id=`
@@ -46,7 +46,7 @@ Done when no state-hub runtime file POSTs or GETs legacy workstream paths/params
 id: STATE-WP-0072-T02
 status: done
 priority: high
-state_hub_task_id: "856fc563-435d-48b4-928e-9c1f00558b7e"
+state_hub_task_id: "0bd0bd0a-4d43-5342-a5bc-ff431bcdcd10"
 ```
 
 - `the-custodian/runtime/prompts/daily_statehub_wsgi_triage.md` — `/workplans/index`, `?workplan_id=`
@@ -60,7 +60,7 @@ Done when prompt no longer references `/workstreams/workplan-index`.
 id: STATE-WP-0072-T03
 status: done
 priority: medium
-state_hub_task_id: "57cf1bf9-e05b-4cd8-aa30-c4e9846d6e4a"
+state_hub_task_id: "9bff3e4a-34a3-5c3b-854e-495762dd2f51"
 ```
 
 - `wise-validator/src/wisevalidator/reporter.py` — `workplan_id` on progress POST
@@ -75,7 +75,7 @@ Done when tests pass and POST bodies use `workplan_id` only.
 id: STATE-WP-0072-T04
 status: done
 priority: high
-state_hub_task_id: "4a3b58d5-3bff-4057-a468-d6e2cf66b6aa"
+state_hub_task_id: "afb558e6-5bb3-511d-b481-47356f06fca4"
 ```
 
 1. `rg` confirm no missed runtime callers in fixed repos.
diff --git a/workplans/STATE-WP-0074-hub-ecosystem-boundary-alignment.md b/workplans/STATE-WP-0074-hub-ecosystem-boundary-alignment.md
index d2abe5d..a2dd215 100644
--- a/workplans/STATE-WP-0074-hub-ecosystem-boundary-alignment.md
+++ b/workplans/STATE-WP-0074-hub-ecosystem-boundary-alignment.md
@@ -9,7 +9,7 @@ owner: codex
 topic_slug: infotech
 created: "2026-07-09"
 updated: "2026-07-11"
-state_hub_workstream_id: "7bddf82c-82bc-4abe-8060-046c62eefc23"
+state_hub_workstream_id: "3977ba44-f470-56df-bc03-7d4201cba1ac"
 ---
 
 # Hub ecosystem boundary alignment
@@ -27,7 +27,7 @@ toward core-hub framework surfaces.
 id: STATE-WP-0074-T01
 status: done
 priority: high
-state_hub_task_id: "4e028511-b1ec-472e-a34d-e0701c3281c2"
+state_hub_task_id: "3b4c32ce-4f0b-5f04-a165-556db062a3ca"
 ```
 
 Publish `docs/hub-ecosystem-route-audit.md` classifying hub-core factory vs
@@ -41,7 +41,7 @@ Done 2026-07-09.
 id: STATE-WP-0074-T02
 status: done
 priority: medium
-state_hub_task_id: "609fa167-e3e0-486f-8c10-9d65c419ada0"
+state_hub_task_id: "cfd81160-1c40-5922-9124-0b4c39c95030"
 ```
 
 Record deferral: core-hub does not duplicate progress/message tables in
@@ -56,7 +56,7 @@ Decision documented in route audit and `hub-ecosystem-architecture.md`.
 id: STATE-WP-0074-T03
 status: done
 priority: high
-state_hub_task_id: "4f2bbf15-bb0f-4224-b619-04db33a8fbab"
+state_hub_task_id: "2e790571-c183-5b95-aec0-38840ed4e151"
 ```
 
 Add ecosystem position sections to `INTENT.md` and `SCOPE.md`.
@@ -69,7 +69,7 @@ Done 2026-07-09.
 id: STATE-WP-0074-T04
 status: done
 priority: high
-state_hub_task_id: "a9c26e95-b5cb-4cda-9fd7-050dd195794c"
+state_hub_task_id: "10c1cd9b-27af-5a74-ac36-88843900a7a3"
 ```
 
 Verify `api/main.py` does not mount Inter-Hub `/api/v2` routes. Document in
@@ -83,7 +83,7 @@ Done 2026-07-09: no `/api/v2` in state-hub.
 id: STATE-WP-0074-T05
 status: done
 priority: medium
-state_hub_task_id: "047805fa-2302-4ad3-b2be-c2b0a48454df"
+state_hub_task_id: "2e417a49-dff4-5b0c-a8f3-c9297683e2ea"
 ```
 
 Add `make ecosystem-regression` target or README pointer to
diff --git a/workplans/STATE-WP-0075-workstream-route-410-stranglers.md b/workplans/STATE-WP-0075-workstream-route-410-stranglers.md
index 4e31c97..bd6f8a1 100644
--- a/workplans/STATE-WP-0075-workstream-route-410-stranglers.md
+++ b/workplans/STATE-WP-0075-workstream-route-410-stranglers.md
@@ -11,7 +11,7 @@ planning_priority: high
 planning_order: 75
 created: "2026-07-10"
 updated: "2026-07-10"
-state_hub_workstream_id: "b3f4f2cd-f6f4-4518-bc66-6b9f4be9349d"
+state_hub_workstream_id: "a7fc6116-6587-5c17-9a64-d47634aa6a59"
 ---
 
 # STATE-WP-0075 — Workstream REST route 410 stranglers
@@ -38,7 +38,7 @@ Preferred `/workplans/*` routes remain the only functional surface.
 id: STATE-WP-0075-T01
 status: done
 priority: high
-state_hub_task_id: "a8908d16-3966-4819-a9f9-96697ec8b6a3"
+state_hub_task_id: "cce857a7-cdec-5ceb-a8e4-b0c54498fe41"
 ```
 
 1. Add `retire_legacy_route()` to `api/services/legacy_compat.py` — meter usage,
@@ -53,7 +53,7 @@ Done when all 410 stranglers share one code path for metering and headers.
 id: STATE-WP-0075-T02
 status: done
 priority: high
-state_hub_task_id: "f62b7f22-0f84-4a4b-83d7-5df6d9d93c47"
+state_hub_task_id: "819494cf-5539-5c2e-897b-9650835c6aee"
 ```
 
 Return **410 Gone** on:
@@ -71,7 +71,7 @@ Keep `/workplans/*` handlers unchanged.
 id: STATE-WP-0075-T03
 status: done
 priority: high
-state_hub_task_id: "5bf41f1a-a8d9-4514-b0c7-5db84050bd3f"
+state_hub_task_id: "cac01081-f78e-5d55-90d1-5b486fb9b9f6"
 ```
 
 Return **410 Gone** on:
@@ -85,7 +85,7 @@ Return **410 Gone** on:
 id: STATE-WP-0075-T04
 status: done
 priority: high
-state_hub_task_id: "19ebaaa8-5720-4773-a9c6-02f4e1c88e0d"
+state_hub_task_id: "df8e19fb-93ad-5b00-ab62-431d27d9c8a0"
 ```
 
 1. Update `tests/test_legacy_meter.py` and `tests/test_routers_core.py` for 410
diff --git a/workplans/STATE-WP-0076-definition-of-ready-and-comprehension.md b/workplans/STATE-WP-0076-definition-of-ready-and-comprehension.md
new file mode 100644
index 0000000..fbec9f7
--- /dev/null
+++ b/workplans/STATE-WP-0076-definition-of-ready-and-comprehension.md
@@ -0,0 +1,183 @@
+---
+id: STATE-WP-0076
+type: workplan
+title: "Definition of Ready (DoR) and Definition of Comprehension (DoC) quality gates"
+domain: infotech
+repo: state-hub
+status: finished
+owner: grok
+topic_slug: infotech
+created: "2026-07-22"
+updated: "2026-07-22"
+reviewed_at: "2026-07-22"
+reviewed_by: "grok"
+reviewed_against_commit: "d8a2bb5c6ba8d3db73eff565242e6c7fbe63d181"
+context_paths:
+  - "policies/"
+  - "dashboard/src/docs/work-records.md"
+  - "dashboard/src/docs/intakes.md"
+  - "dashboard/src/docs/workstream-lifecycle.md"
+  - "dashboard/src/policy/"
+  - "docs/work-record-quality-gates.md"
+  - "workplans/STATE-WP-0076-definition-of-ready-and-comprehension.md"
+state_hub_workstream_id: "e5d06c02-6431-5bef-a83d-fbd70d40cc3a"
+---
+
+# STATE-WP-0076 — DoR and DoC quality gates
+
+## Goal
+
+Ship the next slice of the work-record quality model that pays off soon:
+
+1. **Policies** in the existing DoI / DoM / DoD family: **DoC** (intake) and **DoR**
+   (task + workplan sections).
+2. **Dashboard** edit/view surfaces like the other policies.
+3. **Docs** that fix terminology: work-record as generic coordination artefact
+   (units *and* structure), lifecycle **≠** definition assessment, badge spelling
+   `DoX-Ok` / `DoX-Failed` / unassessed.
+
+No badge engine, no hard API blocks, no new kinds, no value-chain typing.
+
+## Delivered (2026-07-22)
+
+| Deliverable | Path |
+|-------------|------|
+| Quality model note | `docs/work-record-quality-gates.md` |
+| DoC policy | `policies/intake-doc.md` → `GET /policy/intake-doc` |
+| DoR policy | `policies/work-item-dor.md` → `GET /policy/work-item-dor` |
+| Dashboard pages | `dashboard/src/policy/intake-doc.md`, `work-item-dor.md` |
+| Nav | Policies: Intake DoC, Work-item DoR |
+| Reference links | work-records, intakes, workplan lifecycle, tasks |
+
+## Design constraints (shipped)
+
+1. Lifecycle state ≠ definition badge (`DoX-Ok` / `DoX-Failed` / unassessed).
+2. Badge family closed and named after policies.
+3. Policies declare applies_to; DoR has task and workplan sections.
+4. DoC = intake only; DoR = task + workplan.
+5. Outside-originated = policy sections, not a new kind.
+6. Enforcement = convention + docs only.
+
+---
+
+## Task: Quality model + work-record roles in docs
+
+```task
+id: STATE-WP-0076-T01
+status: done
+priority: high
+state_hub_task_id: "f62c4ade-8258-5626-a735-a64b49bcbbb0"
+```
+
+Short design/reference write-up only (no product build):
+
+- Update `dashboard/src/docs/work-records.md`: work-record as **generic** mode
+  for units *and* structure (plans/collections); unit vs structure table; quality
+  badges vs lifecycle; link to policies when they exist.
+- Add `docs/work-record-quality-gates.md`: Definition family (DoI/DoM/DoC/DoR/DoD),
+  badge spelling, applies_to matrix, outside profile pointer, explicit non-goals.
+- One cross-link from intakes + workplan lifecycle docs.
+
+**Done when:** an agent can explain unit vs structure and DoR-Ok vs `status=ready`
+from the docs alone.
+
+---
+
+## Task: Author DoC policy
+
+```task
+id: STATE-WP-0076-T02
+status: done
+priority: high
+state_hub_task_id: "c09bf944-fd02-51b6-9862-e0ddff04ee51"
+```
+
+Create `policies/intake-doc.md` (Definition of Comprehension).
+
+- `applies_to: intake`
+- Core checklist (signal, why it matters, unknowns, provisional ownership or
+  “unknown”, next action)
+- Outside-originated section
+- Explicit: DoC ≠ DoR; assessment outcomes DoC-Ok / DoC-Failed / unassessed
+- Loadable as `GET /policy/intake-doc`
+
+**Done when:** policy file exists and is readable via the policy API.
+
+---
+
+## Task: Author DoR policy
+
+```task
+id: STATE-WP-0076-T03
+status: done
+priority: high
+state_hub_task_id: "f2f44ee7-f3ac-5750-8fce-0a8a8bca18d1"
+```
+
+Create `policies/work-item-dor.md` (Definition of Ready) — filename keeps
+“work-item” as the delivery-side gate name; body uses **task** and **workplan**
+sections (not “workplan is a work-item”).
+
+- Per-kind sections: task, workplan
+- Outside-originated section
+- Link to `workstream-dod.md` as exit companion (DoD-Ok separate from finished)
+- Assessment outcomes DoR-Ok / DoR-Failed / unassessed
+- Loadable as `GET /policy/work-item-dor`
+
+**Done when:** policy file exists and is readable via the policy API.
+
+---
+
+## Task: Dashboard policy pages + nav
+
+```task
+id: STATE-WP-0076-T04
+status: done
+priority: high
+state_hub_task_id: "7ffaece5-e7ea-5821-a3a1-3741d13c282c"
+```
+
+Mirror DoI/DoM/DoD:
+
+- `dashboard/src/policy/intake-doc.md`, `dashboard/src/policy/work-item-dor.md`
+- Policies entries in `observablehq.config.js`
+- Links from work-records reference (+ quality-gates doc)
+
+**Done when:** Policies menu shows DoC and DoR; edit/view works against the API.
+
+---
+
+## Cancelled / deferred tasks
+
+```task
+id: STATE-WP-0076-T05
+status: cancel
+priority: medium
+state_hub_task_id: "48ed892b-b8c9-5754-8a15-fc4fc85d583d"
+```
+
+Soft enforcement hooks — deferred until DoC/DoR text is in use.
+
+```task
+id: STATE-WP-0076-T06
+status: cancel
+priority: low
+state_hub_task_id: "f5f81b8e-11ce-5908-bc7c-a0e291d8d73d"
+```
+
+Standalone DoD naming / family index task — folded into T01 quality-gates doc.
+
+## Acceptance criteria
+
+- [x] Docs: generic work-record (unit + structure), lifecycle ≠ DoX badge
+- [x] `policies/intake-doc.md` and `policies/work-item-dor.md` live and API-served
+- [x] Outside-originated sections present in both
+- [x] Dashboard Policies nav includes both
+- [x] No new kinds, no badge engine, no hard enforcement
+
+## References
+
+- `the-custodian/canon/standards/work-record-types_v0.1.md`
+- `policies/repo-doi.md`, `policies/service-dom.md`, `policies/workstream-dod.md`
+- `dashboard/src/docs/work-records.md`, `intakes.md`, `workstream-lifecycle.md`
+- `api/routers/policy.py`
diff --git a/workplans/STATE-WP-0077-dox-assessment-recording-and-soft-visibility.md b/workplans/STATE-WP-0077-dox-assessment-recording-and-soft-visibility.md
new file mode 100644
index 0000000..e6a89ec
--- /dev/null
+++ b/workplans/STATE-WP-0077-dox-assessment-recording-and-soft-visibility.md
@@ -0,0 +1,136 @@
+---
+id: STATE-WP-0077
+type: workplan
+title: "DoX assessment recording and soft visibility"
+domain: infotech
+repo: state-hub
+status: finished
+owner: grok
+topic_slug: infotech
+created: "2026-07-22"
+updated: "2026-07-22"
+reviewed_at: "2026-07-22"
+reviewed_by: "grok"
+reviewed_against_commit: "3008d9e"
+context_paths:
+  - "docs/work-record-quality-gates.md"
+  - "policies/intake-doc.md"
+  - "policies/work-item-dor.md"
+  - "policies/workstream-dod.md"
+  - "dashboard/src/docs/work-records.md"
+  - "scripts/"
+  - ".claude/rules/"
+  - "AGENTS.md"
+quality_dor: DoR-Ok
+quality_dor_at: "2026-07-22"
+quality_dor_by: "grok"
+quality_dod: DoD-Ok
+quality_dod_at: "2026-07-22"
+quality_dod_by: "grok"
+state_hub_workstream_id: "94f8149a-ee7c-59a9-97ad-63e786f1d7a5"
+---
+
+# STATE-WP-0077 — DoX assessment recording and soft visibility
+
+## Goal
+
+Make the **DoX badge convention from STATE-WP-0076 operational** without a
+badge engine or hard gates:
+
+1. **Record** last Definition assessments on work records (convention + light
+   storage).
+2. **See** quality debt: e.g. workplans `finished` without DoD-Ok, `ready`
+   without DoR-Ok, intakes promoted/routed without DoC-Ok.
+3. **Guide agents** with soft protocol (and optional cheap warnings).
+
+Parent: `STATE-WP-0076` (finished).
+
+## Delivered (2026-07-22)
+
+| Deliverable | Location |
+|-------------|----------|
+| Recording convention + examples | `docs/work-record-quality-gates.md` |
+| Parse helpers | `scripts/quality_assessment.py` |
+| Debt list CLI | `scripts/quality_debt.py`, `statehub quality-debt` |
+| Soft promote warning | `scripts/promote_intake.py` |
+| Soft consistency | C-34 (ready¬DoR); finished¬DoD via quality-debt only |
+| Agent protocol | `AGENTS.md`, `.claude/rules/session-protocol.md` |
+| DoD badge language | `policies/workstream-dod.md` |
+| Tests | `tests/test_quality_assessment.py` |
+
+---
+
+## Task: Assessment recording convention
+
+```task
+id: STATE-WP-0077-T01
+status: done
+priority: high
+state_hub_task_id: "a525082c-78ce-57d4-b001-791d63459713"
+quality_dor: DoR-Ok
+quality_dor_at: "2026-07-22"
+```
+
+Canonical fields `quality_doc` / `quality_dor` / `quality_dod` (+ `_at`/`_by`/`_note`),
+progress `event_type=quality_assessment`, examples in quality-gates doc.
+
+---
+
+## Task: Soft visibility — quality-debt list or digest
+
+```task
+id: STATE-WP-0077-T02
+status: done
+priority: high
+state_hub_task_id: "07176070-df27-5746-9679-6dd072d463fd"
+quality_dor: DoR-Ok
+quality_dor_at: "2026-07-22"
+```
+
+`statehub quality-debt` / `scripts/quality_debt.py` — file workplans + intakes +
+optional hub intakes.
+
+---
+
+## Task: Agent protocol and soft warnings
+
+```task
+id: STATE-WP-0077-T03
+status: done
+priority: medium
+state_hub_task_id: "12bf4277-db50-55fc-b674-d027fbb7dbcd"
+quality_dor: DoR-Ok
+quality_dor_at: "2026-07-22"
+```
+
+AGENTS + session protocol; promote-intake soft WARN; C-34/C-35 soft WARN.
+
+---
+
+## Task: Align DoD policy wording with badge family
+
+```task
+id: STATE-WP-0077-T04
+status: done
+priority: low
+state_hub_task_id: "499fe884-a3d6-5707-9666-e23e72a89058"
+quality_dor: DoR-Ok
+quality_dor_at: "2026-07-22"
+```
+
+`policies/workstream-dod.md` — applies_to workplan, DoD-Ok/Failed, finished ≠ DoD-Ok.
+
+---
+
+## Acceptance criteria
+
+- [x] Canonical recording form documented and exemplified
+- [x] At least one quality-debt list/digest works against live data
+- [x] Agent protocol documents when to assess and how to record
+- [x] No hard gates; no freeform badge engine
+- [x] DoD policy mentions DoD-Ok / Failed / unassessed
+
+## References
+
+- `docs/work-record-quality-gates.md`
+- `STATE-WP-0076` (parent)
diff --git a/workplans/STATE-WP-0078-ops-run-read-projection.md b/workplans/STATE-WP-0078-ops-run-read-projection.md
new file mode 100644
index 0000000..9ca0332
--- /dev/null
+++ b/workplans/STATE-WP-0078-ops-run-read-projection.md
@@ -0,0 +1,114 @@
+---
+id: STATE-WP-0078
+type: workplan
+title: "Ops run read projection for fleet visibility"
+domain: infotech
+repo: state-hub
+status: finished
+owner: codex
+topic_slug: state-hub
+priority: low
+created: "2026-08-03"
+updated: "2026-08-08"
+depends_on:
+  - ACTIVITY-WP-0026
+related:
+  - ACT-ADR-005
+  - STATE-WP-0074
+state_hub_workstream_id: "81ed67ec-e3f8-52cd-bce9-4432ff9095cb"
+---
+
+# STATE-WP-0078 — Ops run read projection
+
+## Origin
+
+ACT-ADR-005: State Hub remains the **work-record** read model on coulombcore.
+It may **project** activity-core `ops_run` state for fleet ops UI without becoming
+the claim authority.
+
+## Goal
+
+Expose open/failed/recent ops runs to operators and agents via State Hub
+summary/API **read paths**, fed from activity-core (edge/NATS/pull) — so
+coulombcore-oriented agents see automation health without claiming work.
+
+## Tasks
+
+### T01 — Contract with activity-core
+
+```task
+id: STATE-WP-0078-T01
+status: done
+priority: medium
+state_hub_task_id: "ff4f5ae8-67fb-5fe2-a5cf-75c551cfdeef"
+```
+
+Agree payload shape with ACTIVITY-WP-0026 (id, definition, target_repo, state,
+lease, updated_at, last_error). Document whether pull (hub polls actcore) or
+push (actcore posts progress summary) is v1.
+
+**Done when:** short contract note in `docs/` or linked from ACT-ADR-005.
+
+Implemented in `docs/ops-run-read-projection.md`: v1 is an authenticated,
+cached pull from activity-core `GET /ops-runs`; activity-core remains the only
+claim/lease/completion authority.
+
+---
+
+### T02 — Read API + summary field
+
+```task
+id: STATE-WP-0078-T02
+status: done
+priority: medium
+state_hub_task_id: "07deec86-26aa-5dc4-8605-f9b704d33151"
+```
+
+Minimal:
+
+- `GET /ops-runs/summary` or extend `/state/summary` with `ops_runs: { open, claimed, failed_24h }`  
+- No claim/complete endpoints on State Hub  
+
+**Done when:** MCP/summary consumers can show stuck automation.
+
+Implemented `GET /ops-runs/summary` and the `/state/summary.ops_runs` projection,
+including open/claimed/failed-24h counts, SLA-stuck count, bounded run details,
+and stale/unavailable behavior. No write endpoints exist under State Hub's
+`/ops-runs` route.
+
+---
+
+### T03 — Edge/federation notes
+
+```task
+id: STATE-WP-0078-T03
+status: done
+priority: low
+state_hub_task_id: "63e14866-4804-5c45-8bab-46d949adfd00"
+```
+
+Document coulombcore vs railiance: claim on railiance actcore-api; visibility
+may lag if edge relay down — alert preference.
+
+**Done when:** cluster-operating-model or ops doc updated.
+
+Documented in `docs/cluster-operating-model.md` and
+`docs/ops-run-read-projection.md`.
+
+## Acceptance
+
+- [x] Hub does not claim ops_runs
+- [x] Operators see automation backlog on primary hub views
+- [x] No Forgejo/Gitea dependency
+
+## Residual handoff
+
+Production deployment wiring is tracked as State Hub intake
+`019fe359-debb-71a6-958c-b8f4ac3574a0` (`origin: residual`,
+`origin_ref: STATE-WP-0078`). It covers the private activity-core URL,
+OpenBao/ESO token injection, rollout, and live fleet verification.
+
+## Out of scope
+
+- Moving claim API to State Hub  
+- Workplan file generation for daily ops  
diff --git a/workplans/STATE-WP-0079-retirement-strangler.md b/workplans/STATE-WP-0079-retirement-strangler.md
new file mode 100644
index 0000000..b2705e4
--- /dev/null
+++ b/workplans/STATE-WP-0079-retirement-strangler.md
@@ -0,0 +1,659 @@
+---
+id: STATE-WP-0079
+type: workplan
+title: "State Hub retirement strangler and disposition execution"
+domain: infotech
+repo: state-hub
+status: blocked
+flavor: refactoring
+owner: codex
+topic_slug: infotech
+created: "2026-08-09"
+updated: "2026-09-05"
+parent_project: prj-state-hub-retirement
+parent_workplan: SHR-WP-0001
+related:
+  - STATE-WP-0074
+  - SHR-INV-0001
+  - RMGR-WP-0001
+  - HUB-WP-0004
+state_hub_workstream_id: "ed077b62-7048-5752-bf65-f90471f45854"
+---
+
+# State Hub retirement strangler and disposition execution
+
+## Goal
+
+Execute the **keep/move/replace/retire** dispositions from
+`prj-state-hub-retirement/inventory` via strangler adapters and owner handoffs,
+without adding new permanent authorities here. End state: freeze window with no
+normal traffic, then archive.
+
+## Dual-run handoff (RMGR-WP-0002)
+
+Repo Manager Stage B dual-run is available:
+
+- Flags: `RM_WRITEBACK`, `RM_RECONCILE`, `RM_PILOT_REPOS` (see `repo-manager/docs/dual-run.md`)
+- SH adapter: `api/services/repo_manager_dual_run.py` (PATCH `/tasks` + C-15 writeback + reconcile proxy)
+- Evidence: `repo-manager/docs/evidence/wp0002-completion.md`
+
+Expand pilot list here as cutover progresses; do not add new checkout mutators in State Hub.
+
+## Freeze policy for new scope
+
+```task
+id: STATE-WP-0079-T01
+status: done
+priority: high
+state_hub_task_id: "3e8659a1-54bd-5329-bfee-24fdaca5374d"
+```
+
+Document and enforce: changes during retirement must preserve compatibility,
+enable extraction, reduce scope, or fix operational risk — not establish new
+permanent ownership (INTENT retirement status).
+
+**Result (2026-08-20):** `policies/retirement-freeze.md`, following the existing
+`policies/` convention. States the four admissible reasons, the inadmissible
+case (new permanent ownership here), and the operative test — *where does this
+live after cutover?* — since most inadmissible changes are otherwise good
+changes. Uses `STATE-WP-0080`'s retarget as the worked example.
+
+**Enforced by review, not by new automation.** A freeze-checker built inside
+State Hub would be new permanent automation in the component being retired, so
+the policy would violate itself. Gates attach to points where changes are
+already reviewed: new workplan goal statements, non-trivial task starts, and
+slice execution. New tables, routes, or MCP tools carry a presumption against
+and are the one hard stop.
+
+## Capability strangler plan
+
+```task
+id: STATE-WP-0079-T02
+status: done
+priority: high
+state_hub_task_id: "fcf280dd-cf42-5c41-bd55-69b4b409db3b"
+```
+
+Group SHR-INV-0001 items into cutover slices (repo/work → repo-manager;
+messages/progress/projections → hub-core; catalogs → owners; retire aliases).
+Per slice: adapter flag, owner API, rollback.
+
+**Result (2026-08-19):** `docs/retirement-cutover-slice-plan.md`. All 425
+inventory items assigned to 19 slices in five waves plus Keep, computed against
+`state-hub-disposition.yaml` rather than hand-counted. Each slice carries an
+`RM_SLICE_*` flag (off/dual/owner), owner API, and rollback; Wave A reuses the
+RMGR-WP-0002/0003 dual-run adapter rather than adding a mechanism.
+
+Owner readiness verified: only **Wave A (repo-manager, 165 items)** is
+executable — RMGR-WP-0001/0002/0003 are `finished`. Wave B is gated on
+HUB-WP-0004 (`proposed`), D1 on OPS-WP-0003 (`proposed`), D2 on FIN-WP-0003
+(`proposed`). Recommended first cut is A3 (registers), lowest blast radius.
+
+Two findings for T04/T05: the 9 `ops_dependency` items carry no capability and
+cannot be strangled behind a flag — they resolve at the T06 freeze window; and
+the legacy-meter review window is 8 hours despite `cadence: weekly`, which is
+not sufficient evidence to retire high-volume `/workstreams/` interfaces (E2).
+
+## Register CLI and GOAL.md support
+
+```task
+id: STATE-WP-0079-T03
+status: done
+priority: medium
+state_hub_task_id: "757bad31-b5d9-5ff7-b33e-d8c1dfb1bcde"
+```
+
+Adapt `statehub register` / scaffolding so `prj-` repos with `GOAL.md` and
+`repo_flavor: project` are valid without inventing durable-product `INTENT.md`
+(residual from SHR-WP-0001-T01).
+
+**Result (2026-08-19):** Implemented by `STATE-WP-0080-T01/T02`. Project
+flavor is detected from classification, `GOAL.md`, or the `prj-` slug; a repo
+with an existing `GOAL.md` is registered without durable scaffolding, while a
+fresh project delegates scaffolding to `rmgr scaffold`. The focused State Hub
+registration suite passes (`20 passed`).
+
+## Execute move/replace slices
+
+```task
+id: STATE-WP-0079-T04
+status: wait
+priority: high
+state_hub_task_id: "3a454438-1955-547f-a491-8eab7cd25710"
+```
+
+Implement strangler handoffs coordinated with RMGR-WP-0001 and HUB-WP-0004.
+Compatibility tests for each dispositioned route family.
+
+**Owner-readiness correction (2026-08-20):** T02's slice plan marked all 167
+repo-manager items receivable because RMGR-WP-0001/0002/0003 are `finished`.
+That reads readiness off workplan status, which is too coarse. Verified against
+`repo-manager/src/repo_manager/`: those workplans delivered work-record
+dual-run, repository observation, and scaffolding. `parse/` holds only
+`workplan.py`, and the source tree has **no** reference to `sbom`, `repo_goal`,
+`contribution`, `technical_debt`, or `extension_point`.
+
+So only **A1 (partial) and A2** are receivable — 86 items, not 165. A3
+(registers, 49), A4 (UI, 22) and A5 (topic spine, 8) have no owner-side surface
+at all, and RMGR-WP-0004/0005 do not cover them.
+
+**Critical path is now repo-manager-side**, not here: a repo-manager workplan
+must build the register, UI, and topic surfaces before 79 Wave A items can move.
+Building them in State Hub is inadmissible under `policies/retirement-freeze.md`
+— it would be new permanent ownership in the component being retired.
+
+**A2 checked the same way (2026-08-20):** the State Hub adapter exposes exactly
+three operations — `rm_update_task_status`, `rm_reconcile`, `rm_scaffold`. There
+is no adapter for workplan CRUD, intake, decision, dependency, or human-flag
+records, and no repo-manager parser for them either. A2 therefore splits into
+**A2a** (task status + reconcile, ~6 items, receivable) and A2b–A2e (~32 items,
+not receivable).
+
+**A2a is the only slice in the whole plan executable today.** Its next step is
+operational rather than code: `rmgr dual-run-status` shows dual-run entirely off
+(`config_exists: false`, writeback/reconcile false, no pilot repos; the 23
+metered mutations are RMGR-WP-0002/0003 pilot residue). Moving A2a from `off` to
+`dual` means creating `~/.repo-manager/dual-run.yaml`, enabling `RM_WRITEBACK`
+and `RM_RECONCILE` for one pilot repo, and watching the mutation meter for
+divergence. Reversible by clearing the flags; needs an operator decision because
+it changes how live task writes flow.
+
+Net: of 425 inventory items, roughly **6 can move today**. The retirement is
+gated almost entirely on owner-side capability in `repo-manager` and `hub-core`.
+
+**Readiness update (2026-08-21):** RMGR-WP-0008 is finished, HUB-WP-0004 is
+finished, and the cutover slice plan now records the corrected receiving/UI
+boundaries. Workplan/register/classification adapters and compatibility tests
+exist; execute them by slice rather than relying on this earlier readiness
+snapshot.
+
+**Deterministic-identifier compatibility sub-slice (2026-08-21):** fleet owner
+declared namespace `helixforge`. Repo Manager's sealed plan covers 242 live
+records across 42/42 eligible repositories with zero collisions, but apply is
+not yet authorized. State Hub uses workplan/task UUIDs as primary keys referenced
+by progress, decisions, dependencies, token events, launches, and other tables;
+those foreign keys do not use `ON UPDATE CASCADE`. This task owns the temporary
+transactional projection migration, durable old-id aliases, rollback rehearsal,
+and compatibility evidence needed by RMGR-WP-0005-T04. Do not rewrite repository
+UUID fields until that sub-slice passes in isolated PostgreSQL.
+
+**Identifier projection gate implemented and rehearsed (2026-08-22):** Alembic
+revision `b8d4f0a2c6e1` adds durable old→new alias provenance and converts all 20
+foreign keys into `workplans.id` / `tasks.id` to `ON UPDATE CASCADE`, while
+retaining their existing delete behavior. The internal executor verifies the
+Repo Manager plan seal, `helixforge` namespace, UUIDv5 derivation, repository
+membership, source presence, target absence, and alias consistency before a
+repository-atomic apply. Reverse runs task-first/workplan-second and retains the
+aliases as `reversed`; plan entries with `action: assign` are deferred to normal
+file reconciliation because there is no old projection row to rewrite.
+
+Isolated PostgreSQL evidence: migration upgrade produced 20/20 update-cascade
+constraints plus the alias table; downgrade restored 20/20 no-action update
+constraints and removed the table. Service tests cover cascades through task
+parentage, progress, token accounting and dependency edges, forward/reverse
+alias state, and all-or-nothing failure (`3 passed`). Full State Hub regression:
+`622 passed`. No live database migration or repository UUID rewrite was run.
+The remaining gate is an operator-approved pilot ordering the central database
+transaction and authoritative file rewrite/reconciliation as one recoverable
+cutover unit.
+
+**Repo Manager pilot executed (2026-08-22):** the workstation projection was
+the only instance holding `RMGR-WP-0005`; the production/registrar projection
+had no matching row. A verified 4.4 MiB preapply PostgreSQL dump was retained at
+`/tmp/state-hub-rmgr-wp-0005-pilot-preapply.dump`. The live schema advanced to
+`b8d4f0a2c6e1`, then six workplan/task primary keys migrated in one transaction.
+All 12 child-task links, 12 workplan progress links, one decision link, and
+three task progress links followed. Six aliases are `applied`; all old rows are
+absent and all new rows present. Repo Manager committed the matching file
+rewrite in `5de754a`; two consistency runs produced a fresh, non-stale index and
+the new workplan API lookup returns 200 while the old lookup returns 404.
+
+The absent registrar row exposed the final rebuild gap before remote ingestion:
+create schemas did not accept authoritative UUIDs and consistency classified a
+missing derived row as an unfixable stale reference. The projection rebuild path
+now accepts file UUIDs, derives IDs when a live file has none, and registers a
+missing derived workplan/task without rewriting the authoritative identifier.
+Focused rebuild/API tests and the full State Hub suite pass (`624 passed`).
+
+**Empty-projection rebuild proof (2026-08-22):** consistency now has an explicit,
+registrar-only `--bootstrap-empty-projection` mode. It is limited to one local
+repository, proves the target has zero projected workplans before mutation, and
+preserves authoritative UUIDs for workplans, tasks, intakes, and decisions.
+Repo Manager's governed wrapper additionally verifies every expected UUID and
+fails on authoritative checkout mutation. A fresh disposable database rebuilt
+all 9 Repo Manager workplans, 62 tasks, and 2 intakes; a second read-only pass
+reported zero issues and 9/9 bindings. State Hub commits `03c7924` and
+`059de93`; evidence is recorded in Repo Manager under
+`docs/evidence/RMGR-WP-0005-isolated-rebuild-2026-08-22.md`. Hub-native history
+remains a separate, unresolved centralization gate and was not copied.
+
+**Production registrar pilot completed (2026-08-22):** a verified 4.6 MiB
+custom-format dump was retained at
+`/tmp/state-hub-registrar-rmgr-wp-0005-preapply.dump` (SHA-256
+`01753744bc844b154900ead916f122946c5414e77f888c3e18016cae6d3d8929`). Helm
+revision 10 atomically promoted image `main-697dd49`; the dry-run and live pod
+both confirmed `sweep.enabled: false` with no host or SSH mounts. The production
+schema advanced from `f0a1b2c3d4e5` to `b8d4f0a2c6e1`; health remained green,
+all 20 relevant foreign keys use `ON UPDATE CASCADE`, and the alias table exists.
+
+The registrar did not previously contain the logical `repo-manager` repository
+or its workplans. After registering that repository, governed projection repair
+created only deterministic `RMGR-WP-0005` UUID
+`6dcf854e-9229-569d-90f0-2d9df235a61d` and its 12 authoritative task UUIDs.
+File and production task-ID sets match exactly; the new workplan lookup returns
+200, the former random UUID returns 404, and a second read-only consistency pass
+has no `RMGR-WP-0005` issue. The eight other random-ID Repo Manager workplans
+remain explicit non-fixable stale references in this formerly empty projection
+and were not ingested. Production aliases remain empty as expected for a rebuild
+rather than an in-place rewrite. Widening beyond this one-repository pilot still
+requires a separate fleet cutover decision.
+
+**Sealed pre-derivation repair interface approved with safeguards
+(2026-08-23):** Repo Manager interface
+`helixforge.identifiers.state-hub-sealed-projection-repair.v1` is accepted as a
+temporary T04 compatibility sub-slice. The owner implementation adds
+`POST /identifier-migrations/sealed-projection-repairs` and keeps ordinary C-03
+refusal unchanged. Repair is limited to one explicitly named workplan and all
+of its sealed `replace` task mappings; it requires the exact plan seal, clean
+synchronized Git revision and source fingerprint, explicit primary
+confirmation, existing repository/topic projection, and complete absence of
+both the old unit and derived targets. Creation is one database transaction;
+an exact retry returns a verified no-op receipt, while partial presence, source
+drift, aliases, target rows, or content mismatch fail closed. Operational and
+removal contract: `docs/sealed-prederivation-projection-repair.md`.
+
+Verification: focused identifier-migration coverage passes (`13 passed`), the
+ordinary consistency suite passes (`129 passed`), and the full API plus
+dashboard build passes (`650 passed`). The full run retained one pre-existing
+SQLAlchemy resource warning and one pre-existing dashboard link warning.
+
+**A2a executed (2026-08-20) — first live cutover slice.** Dual-run is on for the
+pilot repo:
+
+- `~/.repo-manager/dual-run.yaml` installed from
+  `repo-manager/config/dual-run.pilot.example.yaml` — `writeback: true`,
+  `reconcile: true`, `writeback_push: false`, `pilot_repos: [repo-manager]`
+- State Hub API reloaded via its own `--reload` watcher (no service restart, the
+  operator's foreground `make api` was left alone)
+- `statehub fix-consistency --repo repo-manager` reported
+  `RM dual-run reconcile ok: index=/home/worsch/repo-manager/.repo-manager/index.json`
+- mutation meter grew 23 → 24 with
+  `{"kind": "reconcile", "repo_slug": "repo-manager", "workplan_count": 8, "task_count": 53, "record_count": 61}`
+
+**Divergence check:** rmgr's index holds 8 workplans; the hub has
+`rmgr-wp-0001`–`0007` registered. The single-item delta is `RMGR-WP-0008`, whose
+C-06 registration was skipped because this instance is not the identifier
+registrar (ADR-007 interim). That is a known registrar limitation, **not**
+dual-run divergence — rmgr correctly indexed the file that exists on disk.
+
+Slice state: **A2a is `dual`, not `owner`** — the hub remains authoritative and
+rmgr executes checkout mutation alongside it. Promotion to `owner` needs a full
+consistency-sweep cycle at `dual` with zero divergence, per this plan's adapter
+rules. Rollback is `rm ~/.repo-manager/dual-run.yaml`.
+
+### Registrar bottleneck — status check 2026-08-21
+
+**The registrar is reachable, and was all along.** `bridge status` shows all
+seven tunnels `connected` and LIVE, including `state-hub-primary`. It binds
+`[::1]:8000` — IPv6 localhost — while the workstation API listens on
+`127.0.0.1:8000` (IPv4). Same port number, different stacks, so a `127.0.0.1`
+probe silently hits the local hub and looks like the tunnel is down. Anything
+checking registrar reachability must use the bracketed IPv6 form.
+
+**But the two databases have diverged badly:**
+
+| | workstation (`127.0.0.1:8000`) | registrar (`[::1]:8000`) |
+| --- | --- | --- |
+| workplans | 987 | 649 |
+| tasks | 5 710 | 4 037 |
+| decisions | 119 | 80 |
+
+The registrar is **338 workplans and 1 673 tasks behind**. It also runs older
+code — its `/state/summary` still returns `open_workstreams` where the
+workstation returns `open_workplans`, so it predates the terminology rename.
+
+This is exactly the `ADR-007` defect `RMGR-WP-0005` describes, at fleet scale:
+two instances over two databases, each minting database-local primary keys into
+shared git artifacts.
+
+**A queue has formed.** Ten unread messages to `state-hub`, nine of them
+registrar sync requests from three agents (`agentic-resources`, `glas-harness`,
+`kaizen-agentic`), all dated 2026-08-20 — plus this repo's own `RMGR-WP-0008`.
+Agents fleet-wide are now blocked on identifier registration.
+
+**The dependency chain, re-checked:**
+
+- `RMGR-WP-0004-T08` (prefix uniqueness enforcement) — **`done`** 2026-08-18
+- `RMGR-WP-0004-T09` (assign shared prefixes) — executed 2026-08-17 as an
+  authorized exception, still `wait`, with one stated residual: *"Not yet
+  reconciled — the workstation is not the registrar"*
+- `RMGR-WP-0005-T03` (deterministic UUIDv5 derivation) — still `wait`, but its
+  stated blocker `RMGR-WP-0004-T08` **has closed**
+
+T03 is the permanent fix: derived identifiers make writeback idempotent, so any
+number of hubs write identical bytes and the queue disappears. Its formal gate is
+clear. Its *substantive* gate is not — `ADR-007` § Migration option 2 lets
+historical files keep colliding identifiers (`CUST-WP`, `RAILIANCE-WP`, and
+`PRJ-WP` in `prj-forgejo-org-refactor` all still present in the 2026-08-18 scan),
+and deriving UUIDv5 from a non-unique identifier manufactures collisions rather
+than removing them. That tension needs a ruling before T03 can start.
+
+
+**Inherited (2026-08-19) from `STATE-WP-0080-T04`:** this slice now also owns
+deletion of the templating path in `statehub_register.py` — `INTENT.md`
+generation, the `AGENTS.md` / `CLAUDE.md` / `.custodian-brief.md` templates,
+`project_rules/`, and bootstrap-workplan generation. The code is dead-but-present:
+project repos are already routed to `rmgr scaffold`. Gate the deletion on
+`RMGR-WP-0004-T06` proving byte-identical durable output and idempotent
+re-scaffolding.
+
+**Brief compatibility repair (2026-08-23):** the surviving consistency
+generator degraded `the-custodian` to `Domain: (unknown)` and emitted
+`get_domain_summary("")` even though `GET /repos/the-custodian` correctly
+projected `domain_slug: infotech`. Active workplans can legitimately have no
+topic, so topic inference is not authoritative. The generator now prefers the
+repository projection and retains topic lookup only for legacy API responses
+that omit `domain_slug`. Two regression tests cover both paths; all 131
+consistency-check tests pass. This is a compatibility fix until the generator
+moves or retires, not new permanent State Hub authority.
+
+**Ad-hoc identity compatibility repair (2026-08-23):** the surviving project
+instruction templates prescribed fleet-wide `ADHOC-YYYY-MM-DD` identifiers.
+Activity Core and Net Kingdom used that form on the same day, and deterministic
+derivation correctly refused the second record. Templates and the legacy ADR
+validator now accept and prescribe `{WP_PREFIX}-ADHOC-YYYY-MM-DD` while keeping
+the daily filename unchanged. A regression test covers the filename/id pairing.
+This prevents new collisions without making State Hub the long-term convention
+owner.
+
+**Owner-gate reconciliation 2026-08-31.** The previously open receiving-side
+gates have advanced materially: RMGR-WP-0005 finished the deterministic
+identifier migration, HUB-WP-0005 put all hub-core route and writer groups into
+production ownership with exercised rollback, and ACTIVITY-WP-0029 finished
+the schedule, consistency-sweep, interaction-event, and execution-boundary
+handoffs. Those are durable owner records and no longer block this task.
+
+They establish receiving-side readiness only. They do not, by themselves,
+prove that State Hub callers and route families have switched or that the
+required parity, rollback, and production receipts exist.
+
+**D1 receiving contract completed 2026-08-31.** OPS-WP-0003 is finished with
+all three tasks done. Ops Hub now publishes the reviewed
+`capability.operations.ops-hub` and
+`capability.operations.service-catalog` owner package, passes hub-core's
+schemas/catalog and all eight implemented conformance checks, and passes the
+post-cutover public `/api/v2` gate. Framework checks absent from contract 0.1.0
+are live owner residual `HUB-WP-0009` / State Hub UUID
+`0d6e94f3-fd15-5f57-af41-60f0b862da5e`; they do not return D1 ownership here.
+
+**D2 receiving contract completed 2026-08-31.** FIN-WP-0003 is finished with
+all three tasks done. `railiance-fabric` revision `113445d` now publishes the
+direct `financial-fabric-v1` authority export, deterministic accepted-snapshot
+revision provenance, graph edge/summary reads, and regression coverage.
+Fin-hub revisions `debe67e` / `5fe943d` publish the consumer contract and
+executable schema/content-hash/count/provenance gate. Retirement-project
+revision `1812170` corrects all ten Fabric items from `fin-hub/move` to
+`railiance-fabric/replace`; hub-core projection is explicitly deferred.
+
+The receiving contract is ready, but the production cutover is not. The first
+gate run correctly returned no-go: the authority has 131 nodes / 117 edges,
+while State Hub has 49 / 58, with a different content hash and null source
+revision/path/export time. T04 therefore remains `wait` on selecting and
+refreshing one authority snapshot into the dual-read window, obtaining a green
+`finhub fabric-cutover-check`, recording route-switch/rollback receipts for the
+remaining repo-manager/hub-core/activity-core/ops-hub families, and explicit
+authorization for production writer changes. It must resume from a fresh
+caller scan, not from the obsolete 2026-08-20 snapshot.
+
+**D2 dual-read evidence completed 2026-08-31.** The deterministic authority
+snapshot is now the active `railiance01` read model at import
+`47e5358e-d04b-4969-99a2-ca88423ad054`: 131 nodes, 117 edges, 2 actors, 1
+fabric, 0 unresolved, content hash `caae6679…`, snapshot-set revision
+`991bca29…`. `finhub fabric-cutover-check` is green on every schema, content,
+count, and provenance check; exact re-ingest is idempotent. A receiver contract
+drift/column-width defect was fixed in `cf40c7b` and deployed with migration
+`b5e6f7a8c9d0` as Helm revision 56. Immutable-import activation was added in
+`cdff3b7` and deployed as revision 57. Production rollback to retained import
+`f844733d…` (49/58) and roll-forward to `47e5358e…` (131/117) were both
+exercised, followed by another green gate.
+
+The fresh named-repo caller scan found no runtime consumers of
+`/fabric/graph*`; only contracts, docs, and retirement inventory matched. The
+owner service is still workstation-local and its accepted-snapshot freshness is
+not automated, so hosted runtime/persistence/auth/freshness and the eventual
+direct route are live owner residual `RAIL-FAB-WP-0028`. Evidence:
+`docs/evidence/STATE-WP-0079-d2-dual-read-20260831.md`. T04 remains `wait` on
+the non-D2 repo-manager/hub-core/activity-core/ops-hub route receipts and the
+explicit writer-change authorization already stated above.
+
+**Cutover re-baseline 2026-09-05.** Replaced the obsolete slice-readiness
+snapshot in `docs/retirement-cutover-slice-plan.md` with a family-by-family
+receiver/caller/parity/rollback checklist. Live Hub Core runtime OpenAPI lacks
+`/messages`, `/progress`, `/token-events` and `/interface-changes`; its working
+`/api/v2/interaction-events` is not assumed equivalent. Shared library routers
+and HUB-WP-0005 completion are insufficient receiving receipts. T08 now records
+the concrete first read-contract gap. State Hub-to-Core Hub service probes were
+connection-refused although deployments were ready; transport is also part of
+that gate. RAIL-FAB-WP-0028 remains proposed and owns hosted Fabric readiness.
+
+## Retire legacy surfaces
+
+```task
+id: STATE-WP-0079-T05
+status: wait
+priority: medium
+state_hub_task_id: "f6cf8c01-eb59-5ca8-a541-23928d4a000c"
+```
+
+Complete retirement of suggestions, workstream aliases, and other `retire`
+inventory items once meters/callers allow. Keep historical rows archive-readable.
+
+**Blocker identified (2026-08-20):** the legacy-meter evidence this task gates
+on was being captured over an 8-hour band, not a week —
+`capture_legacy_meter_evidence.py` fell back to `hours=8` whenever `--days` was
+omitted, so 39 of 40 captures sampled only 06:00Z–14:00Z. Interfaces called
+outside that band read as unused. Three candidates on the 2026-08-19 capture had
+live callers, including `GET /tasks/?workstream_id` (seen 2026-08-18).
+
+Script default corrected to `days=7`; corrected capture
+`docs/evidence/legacy-meter-weekly-review-20260820.json`.
+
+**Candidate rule tightened (2026-08-20):** `_retirement_state` now requires a
+quiet period scaled to all-time call volume (`RETIREMENT_QUIET_LADDER`: 7d under
+100 calls, 30d under 10 000, 60d above). On the 2026-08-20 capture this makes 15
+of 19 legacy interfaces retirable — all `workstream` MCP tools, the `state://`
+resource, and the low-volume REST aliases — while holding the three six-figure
+read paths (`GET /workstreams/`, `GET /workstreams/{id}`,
+`GET /workstreams/{id}/dependencies/`) and `GET /tasks/?workstream_id`, which
+still has live traffic. Covered by 7 new tests in `tests/test_legacy_meter.py`.
+
+**Slice E2 executed (2026-08-20):** the 15 evidenced interfaces are retired in
+the legacy meter — all four `workstream` MCP tools, the `state://` resource, and
+the low-volume REST aliases including `PATCH /workstreams/{id}` (571 calls),
+`POST /workstreams/` (824) and `POST /workstreams/{id}/dependencies/` (4 971).
+Meter now reads 16 retired / 4 legacy, 0 outstanding candidates. Evidence:
+`docs/evidence/legacy-meter-weekly-review-20260820.json`.
+
+Retirements are journalled fleet-side at
+`the-custodian/docs/retired-legacy-interfaces.md` — deliberately outside this
+repo, since State Hub is being archived and the record must outlive it.
+
+**Remaining work for this task:** the 4 held interfaces
+(`GET /workstreams/`, `GET /workstreams/{id}`,
+`GET /workstreams/{id}/dependencies/`, `GET /tasks/?workstream_id`) clear as
+their quiet counters run; earliest is 18 more silent days. Re-capture before
+deciding — the ladder evaluates at review time. **Slice E1 part-executed (2026-08-20):** `suggestion-backlog` history archived
+to `the-custodian/docs/archived-suggestion-backlog.md` — 10 suggestions, 10
+notes, 5 bumps, all `declined` in the 2026-07-21 intake migration, none
+promoted. Mutations already 410 since `CUST-WP-0061-T06`; reads were open only
+to keep that history reachable, which the archive now replaces.
+
+**E1 removal executed the same day:** the 8 read routes 410 with a pointer to
+intake and the archive, the 6 MCP tools are removed outright, the 5
+`/suggestions` write-idempotency rules are dropped, and the dashboard page is
+deleted with nav, `reference.md` and `wsjf-triage.md` updated;
+`dashboard/src/docs/suggestions.md` is now the archive pointer. Tables remain
+for the T06 dump. Two tests that pinned the old read-live behaviour were
+rewritten to pin the retirement contract.
+
+Naming trap for cutover: `ui-feedback.md` / `todo.md` "suggestions" are
+Shift+click dashboard feedback backed by `technical_debt`, **not** this
+capability. Untouched.
+
+**E3 (`dashboard-meta`) is `/ui-feedback`** — that same feedback surface. Owner
+is `state-hub-until-cutover` and it is still in use, so it retires at the T06
+freeze window, not now.
+
+Then `dashboard-meta` (E3, 1); `legacy-meter` itself (E4, 9) retires last,
+being the instrument.
+
+**Execution launch-request defect closed (2026-08-23):** the surviving
+`POST /execution/launch-requests` route claimed Activity Core pickup after that
+mapping was explicitly retired by `ACTIVITY-WP-0029-T04`. New submissions now
+return 410 with the repository-file / ActivityDefinition+ops_run replacement;
+`GET /execution/semantics` explicitly says launch requests are not accepted,
+that Activity Core does not consume them, and that legacy `launching` does not
+prove pickup. Historical launch rows remain readable. The two reported
+requests (`7052b20f…`, `5628fe55…`) were cancelled as never consumed and their
+workplans restored from `launching/immediate` to `manual/manual`.
+Focused execution coverage passes (`4 passed`); the combined full regression
+and dashboard build remains green (`650 passed`).
+
+**Central meter review 2026-08-31.** The corrected seven-day review found six
+replacement-verified interfaces past their volume-scaled quiet period. They
+were marked retired on the sole `railliance01` primary: the old workstream
+completion event subject, `DELETE /workstreams/{id}`, two low-volume SBOM
+compatibility reads, `GET /workstreams/workplan-index`, and
+`POST /workstreams/{id}/dependencies/`. The recapture now reports 6 retired,
+9 legacy, and zero currently eligible candidates. The remaining nine include
+live SBOM callers, live `GET /tasks/?workstream_id`, the three high-volume
+workstream reads still inside their 60-day quiet window, and two workstream
+mutations still inside 30 days. Evidence:
+`docs/evidence/legacy-meter-weekly-review-20260831.json`. T05 remains
+`wait`; T06 must not start.
+
+The nine held interfaces are explicitly owned by this task until the meter
+allows retirement; they are not untracked prose residuals. Three SBOM reads and
+`GET /tasks/?workstream_id` still had calls in the seven-day review window.
+Three high-volume workstream reads have only 9 of 60 required quiet days, while
+the two workstream mutations have 14/30 and 15/30 quiet days. A future review
+must recapture central-primary evidence and apply the existing volume ladder;
+calendar passage alone is not retirement evidence.
+
+**Repository review 2026-09-05.** Reviewed the four existing daily captures
+`docs/evidence/legacy-meter-weekly-review-20260901.json` through
+`legacy-meter-weekly-review-20260904.json`: each reports 6 retired interfaces,
+9 legacy interfaces, and zero retirement candidates. These captures corroborate
+the existing hold; no additional retirement is justified. T04/T05/T06 remain
+`wait` with their existing owner and quiet-window dependencies.
+
+**Authorized retirement and caller migration 2026-09-05.** Fresh seven-day
+primary evidence made `GET /sbom/report/licences/` and `GET /sbom/snapshots/`
+eligible. Verified direct Nexus endpoints (200), then marked both interfaces
+retired with T05 provenance. Receipt:
+`docs/evidence/STATE-WP-0079-sbom-retirement-20260905.json`. Eight retired,
+seven legacy, zero remaining candidates. Compatibility handlers/history remain;
+this is meter retirement, not a router deletion or application deployment.
+
+Session traces identified ad-hoc task-filter callers in fluid-telegram and
+ops-warden. Corrected their AGENTS.md canonical-query/component-header guidance,
+plus this repository's stale skill and API documentation. Canonical verification
+returned 200 with 8/5 tasks. This does not explain every historical call or prove
+future silence: unresolved task/workstream-detail/SBOM-index attribution is T07.
+Available pod logs begin after the last calls. Evidence and limits:
+`docs/evidence/STATE-WP-0079-caller-and-receiver-review-20260905.md`.
+
+## Stabilization window and archive prep
+
+```task
+id: STATE-WP-0079-T06
+status: wait
+priority: high
+state_hub_task_id: "9230c99b-af58-5794-9291-452e619a30fa"
+```
+
+With T06 gates: zero normal read/write window, final dump, backup/restore
+evidence, stop service, archive repo read-only. Residuals → live owners.
+
+**Blocked 2026-08-31.** The sole `railiance01` primary is healthy and remains
+the active coordination service, the legacy meter has live callers, and T04
+still has owner-side cutovers. A freeze, final dump/restore rehearsal, service
+stop, or repository archive would therefore interrupt normal work and destroy
+the evidence needed by T05. T06 remains `wait` until T04 and T05 are done and a
+fresh central meter demonstrates the required zero normal read/write window.
+
+## Attribute and finish migrating remaining legacy readers
+
+```task
+id: STATE-WP-0079-T07
+status: wait
+priority: high
+state_hub_task_id: "2ac16837-454a-5a92-9385-c91cd3219aa2"
+```
+
+Owner: state-hub. T05 follow-up from the 2026-09-05 scan. Two ad-hoc task-query
+callers were identified and their instructions corrected; the full 11 task
+calls, seven workstream-detail calls and one SBOM index call remain only
+partially attributed. Existing retained logs postdate these calls. Wait for
+new attributed observations or recoverable historical request evidence; do not
+reset the clocks with test calls. Trace remaining callers, migrate them to the
+verified replacements, and attach fresh quiet-window evidence before retirement.
+Use `X-StateHub-Component` for direct agent HTTP requests. No inference from
+an `unknown` bucket alone is sufficient to assign an owner.
+
+## Prove the first deployed hub-core message-read contract
+
+```task
+id: STATE-WP-0079-T08
+status: done
+priority: high
+state_hub_task_id: "9d508739-6123-5204-b829-750b3ebf0e63"
+```
+
+Receiving owner: hub-core; State Hub owns source/caller evidence under T04.
+The initial prefix-only probe overlooked the existing native
+`/ports/messaging/messages` and `/ports/events/progress` contracts. Their
+semantics differ from State Hub message history. The owner supplies the bounded
+inbox projection; scoped NetworkPolicy admission resolves source-pod transport.
+
+Then run a bounded read-only inbox parity pilot over one consistent snapshot,
+checking message IDs, ordering, read/archive flags and scope filters; record
+exact revisions and rollback to the retained State Hub read. Done when receiving
+readiness and parity/rollback receipts make one concrete reader switch reviewable.
+Production message writers stay unchanged during this proof. Related owners:
+HUB-WP-0004/0005; the full B2/B3 route migration is not implied by this task.
+
+**Result (2026-09-05):** HUB-WP-0010 and RAPPCOREHUB-WP-0004 delivered
+and deployed the private snapshot reader. Twenty imported rows retain the source
+hash; six filter/order/content parity cases passed, with 19 visible inbox rows.
+Authentication and method rejection passed. Disable/re-enable was rehearsed
+(Helm revisions 27/28); the restored reader passed parity and live verification.
+Evidence: `docs/evidence/statehub-inbox-pilot-20260905.md` and JSON receipt.
+Ongoing freshness, caller credentials and alias handling remain explicit owner
+residual HUB-WP-0011 and T09; no production client or writer switched.
+
+## Gate the production inbox reader switch
+
+```task
+id: STATE-WP-0079-T09
+status: wait
+priority: high
+state_hub_task_id: "da1d9a95-91bb-5662-a063-eed2a2f96c92"
+```
+
+Owner handoff: HUB-WP-0011 (`origin: residual`, `origin_ref: HUB-WP-0010`).
+T08 proves a frozen snapshot, not ongoing freshness or a production client
+switch. Wait for the owner's monotonic refresh/staleness contract, caller-specific
+credential delivery and canonical/alias scope semantics. Then review one client
+switch and rollback using current source parity. State Hub remains the message
+writer throughout this read cutover. The private snapshot reader must not be
+advertised as a fresh production inbox.
+
+## Acceptance
+
+- [x] Freeze policy documented
+- [x] Strangler plan covers all inventory capabilities
+- [x] prj-/GOAL.md register path works
+- [ ] Move/replace slices evidenced with tests/counts
+- [ ] Retire list closed or residual-owned
+- [ ] Stabilization + archive prep ready for project retirement
diff --git a/workplans/STATE-WP-0080-register-project-flavor-awareness.md b/workplans/STATE-WP-0080-register-project-flavor-awareness.md
new file mode 100644
index 0000000..6ef84a0
--- /dev/null
+++ b/workplans/STATE-WP-0080-register-project-flavor-awareness.md
@@ -0,0 +1,279 @@
+---
+id: STATE-WP-0080
+type: workplan
+title: "statehub register: stop repo scaffolding, hand off to repo-manager"
+domain: infotech
+repo: state-hub
+status: finished
+owner: codex
+topic_slug: infotech
+created: "2026-08-16"
+updated: "2026-08-19"
+parent_project: prj-state-hub-retirement
+parent_workplan: SHR-WP-0001
+related:
+  - RMGR-WP-0004
+  - STATE-WP-0079
+  - CFED-WP-0001
+  - SHR-WP-0001
+state_hub_workstream_id: "bbfce36a-0b19-462f-af78-167f9eb89b86"
+---
+
+# statehub register: stop repo scaffolding, hand off to repo-manager
+
+## Goal
+
+Stop `statehub register` from producing non-conformant repository files, and
+hand repository scaffolding and standards conformance to `repo-manager` — where
+decision `747011c6` places them.
+
+**This workplan does not implement flavor awareness.** That is `RMGR-WP-0004`.
+The state-hub side is a guard, a delegation, and a clean exit.
+
+## Why this changed shape
+
+Drafted 2026-08-16 as a full flavor-awareness implementation inside
+`statehub_register.py`; retargeted the same day after decision `747011c6`:
+
+> Hubs are registers: they index and project repository-owned records. They do
+> not scaffold, template, or rewrite repository files. Repo Manager owns
+> repository representation and governed mutation, and therefore owns the
+> standards repositories must comply with.
+
+Implementing here would have built the capability twice, inside the component
+being retired under `STATE-WP-0079`, and deepened exactly the boundary violation
+the hub refactor exists to remove. The originating residual (`SHR-WP-0001-T01`)
+is unchanged; only its owner is.
+
+Tasks T05–T08 below are `cancel`led with pointers to their `RMGR-WP-0004`
+successors. They are retained rather than deleted so the handoff is legible.
+
+## The defect being contained
+
+`statehub_register.py` has no reference to `.repo-classification.yaml`,
+`category`, or `repo_flavor` in 872 lines, so it cannot distinguish a project
+repository from a durable product repository. It therefore:
+
+- writes `INTENT.md` unconditionally (`:248`) and treats missing intent as a hard
+  error (`:786`–`:790`), though `project-repository-flavor_v0.1` calls shipping
+  both `INTENT.md` and `GOAL.md` an anti-pattern and forbids requiring
+  `INTENT.md` on `prj-` repos;
+- derives the workplan prefix from the slug (`:78`, `_default_wp_prefix`),
+  yielding `PRJ-WP-` for every project repo, so all `prj-` repos collide;
+- writes a generic `{PREFIX}-0001-statehub-bootstrap.md` (`:269`) that competes
+  with the project's real foundation workplan.
+
+Hit twice: `prj-state-hub-retirement` and `prj-canon-federation`, both requiring
+manual deletion after registration.
+
+## Guard against non-conformant scaffolding
+
+```task
+id: STATE-WP-0080-T01
+status: done
+priority: high
+state_hub_task_id: "65c52600-15fe-45bd-82b1-dfeff54698af"
+```
+
+Add a minimal flavor guard to the register path — detect project flavor from
+`.repo-classification.yaml` `category`, `GOAL.md` `repo_flavor`, or the `prj-`
+slug prefix, and on a match **refuse to scaffold**, with a message pointing at
+`repo-manager`, rather than writing files the standard forbids.
+
+Deliberately a refusal, not an implementation: a partial flavor-aware templating
+path here would become a second source of truth competing with `RMGR-WP-0004`.
+
+Durable-repo behaviour is untouched.
+
+**Result (2026-08-18):** `statehub register` exits before writing files when any
+of those three signals match. Message points at
+`rmgr scaffold --path <repo> --flavor project --wp-prefix <PREFIX>-WP`.
+Durable path (`write_registration_files`) is unchanged.
+
+## Delegate registration scaffolding
+
+```task
+id: STATE-WP-0080-T02
+status: done
+priority: high
+state_hub_task_id: "ab1e079c-b36f-4bfc-a9fd-fb43f7f93924"
+```
+
+Once `RMGR-WP-0004-T03` lands, route scaffolding through Repo Manager instead of
+refusing, using the dual-run strangler pattern already proven in `RMGR-WP-0002`
+and `RMGR-WP-0003`. Hub-side registration keeps only what a register legitimately
+does: record the repo, its identity, and its host path.
+
+Coordinate the cutover point with `RMGR-WP-0004-T05`.
+
+**Opened (2026-08-18):** T01 guard is live and `RMGR-WP-0004-T03` (`rmgr scaffold`)
+has landed. Ready to replace the refusal with a delegated scaffold call.
+
+**Result (2026-08-18):** `statehub register` on a project-flavor checkout:
+refuses without `--wp-prefix` if `GOAL.md` is missing (T01); with
+`--wp-prefix` calls `rmgr scaffold` via the dual-run adapter and skips
+`write_registration_files`; if `GOAL.md` already exists, registers the
+repo + host path only. Durable repos still use hub templating.
+
+## Correct the inventory disposition
+
+```task
+id: STATE-WP-0080-T03
+status: done
+priority: medium
+state_hub_task_id: "91cb1a33-7748-4d65-bfbc-bad21234e364"
+```
+
+Confirm the register/scaffolding capability is dispositioned `move` →
+`repo-manager` in `prj-state-hub-retirement/inventory/`, not `keep`. If it is
+recorded as `keep`, correct it and cite decision `747011c6` — `SHR-INV-0001` is
+the retirement lane's source of truth, and a stale disposition would resurrect
+the boundary violation during cutover.
+
+**Result (2026-08-18):** Already `move`. `jobs-callers-ops.yaml`
+`caller:custodian-cli` (`custodian_cli / statehub register`) is
+`disposition: move`, `owner: repo-manager`, capability `repo-onboarding`.
+No inventory edit required.
+
+## Moved: remove the templating path
+
+```task
+id: STATE-WP-0080-T04
+status: cancel
+priority: low
+state_hub_task_id: "342aa5e8-96d0-4832-be60-f48815a86f71"
+```
+
+After delegation is live and `RMGR-WP-0004-T06` compatibility tests pass, delete
+the templating code from `statehub_register.py` — `INTENT.md` generation, the
+`AGENTS.md` / `CLAUDE.md` / `.custodian-brief.md` templates, `project_rules/`,
+and bootstrap-workplan generation.
+
+Sequence behind `STATE-WP-0079`'s strangler so removal lands with the rest of the
+retirement rather than as an isolated breaking change.
+
+**Readiness audit (2026-08-19):** Delegation remains live and the State Hub
+registration regression suite passes (`20 passed`). Repo Manager's focused
+scaffold/standards suite also passes (`11 passed`), but `RMGR-WP-0004-T06`
+correctly remains `wait`: it does not yet test byte-identical durable output
+against the State Hub path or idempotent re-scaffolding. `STATE-WP-0079-T03` is
+now recorded done because T01/T02 above supply its project/`GOAL.md` adapter;
+the broader `STATE-WP-0079-T04` move/replace slice is still `todo`. Do not
+delete this path until both gates close.
+
+**Cancelled (2026-08-19) — moved to `STATE-WP-0079-T04`.** Both gates above are
+still open, and this task always specified that removal should land inside
+`STATE-WP-0079`'s strangler rather than as an isolated breaking change. Holding
+`STATE-WP-0080` open to wait on another workplan's slice adds no information:
+the removal is now recorded where it will actually be executed, alongside the
+other move/replace slices and their compatibility tests.
+
+The guard and the delegation — this workplan's own contribution — are live and
+unchanged. The templating code in `statehub_register.py` is dead-but-present
+until `RMGR-WP-0004-T06` proves byte-identical durable output.
+
+## Moved: generated templates and briefs
+
+```task
+id: STATE-WP-0080-T05
+status: cancel
+priority: medium
+state_hub_task_id: "03224fa5-56f1-4e32-bc2e-40457dceb9cc"
+```
+
+Cancelled — moved to **`RMGR-WP-0004-T04`** by decision `747011c6`.
+
+Worth carrying forward explicitly: `make update-agent-instructions` runs
+fleet-wide and shares the flavor-blind templates, so it silently re-breaks
+conformant `prj-` repos on every run. That is a larger blast radius than first
+registration, and it must not be lost in the handoff.
+
+## Moved: conformance check
+
+```task
+id: STATE-WP-0080-T06
+status: cancel
+priority: low
+state_hub_task_id: "47adb8e3-2a03-45b9-9647-fc4e42c58cd1"
+```
+
+Cancelled — moved to **`RMGR-WP-0004-T02`** by decision `747011c6`.
+
+Conformance checking is the clearest case for the new boundary: judging whether a
+repository satisfies its standard is repository representation, not hub
+projection. Repo Manager exposes it as a command and a contract; the hub consumes
+the result rather than computing it.
+
+## Moved: tests
+
+```task
+id: STATE-WP-0080-T07
+status: cancel
+priority: medium
+state_hub_task_id: "c056b8fd-d91b-4cf0-973c-d74d8e718dd1"
+```
+
+Cancelled — moved to **`RMGR-WP-0004-T06`** by decision `747011c6`.
+
+The byte-identical-output regression guard for durable repos stays essential:
+the handoff must not change what ordinary repositories receive.
+
+## Superseded: carry the fix forward
+
+```task
+id: STATE-WP-0080-T08
+status: cancel
+priority: medium
+state_hub_task_id: "15eca52e-7c3b-40a7-b2a8-38b0313f57a8"
+```
+
+Cancelled — superseded by decision `747011c6`, which answered this task's open
+question outright. It asked whether `repo-manager` was close enough to take the
+work; the decision settled that repository standards belong there regardless of
+timing, and `RMGR-WP-0004` now carries the whole implementation.
+
+Retained as the record of where the retarget originated.
+
+## Outcome
+
+Closed 2026-08-19. The defect is contained: `statehub register` no longer writes
+non-conformant files into project-flavor repositories, and fresh project repos
+are scaffolded by `rmgr scaffold` through the dual-run adapter. Repository
+standards and representation now sit with `repo-manager`, per decision
+`747011c6`.
+
+| Task | Disposition |
+| --- | --- |
+| T01 guard | done |
+| T02 delegation | done |
+| T03 inventory disposition | done (already correct) |
+| T04 templating removal | moved to `STATE-WP-0079-T04` |
+| T05–T08 | moved to `RMGR-WP-0004-T02/T04/T06`, or superseded |
+
+Nothing in this workplan remains executable here.
+
+## Projection note (2026-08-25)
+
+Closing this on the hub exposed a duplicate registration. The file carried
+`03f38314`, minted by the retired local hub; central held a **different** record
+for the same file, `bbfce36a` — `ADR-010`'s "same filename, different UUID"
+class. The file now carries central's identifier, because central is
+authoritative (`ADR-010` decision 1) and decision 6 says to mitigate by changing
+the repository file rather than editing central. The cache-side identifier dies
+with the cache.
+
+Central's workplan status is now `finished`, matching this file.
+
+**Its task projection is still the superseded draft.** Central holds the eight
+pre-retarget tasks — "Detect repository flavor", "Fix workplan prefix
+inference", "Scaffold GOAL.md instead of INTENT.md", "Decide the bootstrap
+workplan" — four of them still open, because central never saw the 2026-08-16
+retarget. None of this file's own task identifiers exist on central.
+
+That is left deliberately rather than repaired here: re-registering these tasks
+would add eight new records alongside the eight stale ones. Resolving duplicate
+task identities belongs to `CUST-WP-0068` (T05/T06), which exists for exactly
+this class.
+
+**Until then, treat central's open tasks on this workplan as superseded.** The
+work they name moved to `RMGR-WP-0004`; nothing here is owed.
diff --git a/workplans/STATE-WP-0081-cluster-self-sufficiency-and-registrar.md b/workplans/STATE-WP-0081-cluster-self-sufficiency-and-registrar.md
new file mode 100644
index 0000000..7215287
--- /dev/null
+++ b/workplans/STATE-WP-0081-cluster-self-sufficiency-and-registrar.md
@@ -0,0 +1,308 @@
+---
+id: STATE-WP-0081
+type: workplan
+title: "Cluster self-sufficiency: remove workstation coupling and fix the registrar"
+domain: infotech
+repo: state-hub
+status: finished
+owner: codex
+topic_slug: infotech
+created: "2026-08-21"
+updated: "2026-09-04"
+parent_project: prj-state-hub-retirement
+parent_workplan: SHR-WP-0001
+related:
+  - STATE-WP-0079
+  - RMGR-WP-0005
+  - RMGR-WP-0008
+  - STATE-WP-0083
+  - STATE-WP-0084
+  - STATE-WP-0086
+  - 01a06e07-658e-73fa-9164-0b522504c0ee
+  - 01a06e0c-3feb-7920-a6f2-961b03dc170d
+  - ADR-007
+  - ADR-010
+state_hub_workstream_id: "bb2798fd-0680-5027-8479-3af3a5b048de"
+---
+
+# Cluster self-sufficiency: remove workstation coupling and fix the registrar
+
+## Goal
+
+Make the railiance01-hosted State Hub stand on its own: its own clones, its own
+git identity, no hostPath into an operator's home directory, and no dependence
+on workstation paths, processes, or checkouts. Fix the identifier registrar as
+part of that, because the registrar is broken *by* this coupling rather than
+beside it.
+
+End state: **workstation coding agents push to forgejo; cluster infrastructure
+reads from forgejo. Neither reads the other's disk.**
+
+## Re-baseline — 2026-09-04
+
+The original plan assumed the cluster sweep would regain write access to an
+operator checkout and then migrate that checkout onto a PVC. That implementation
+shape was superseded by the Forge-derived projection work in `STATE-WP-0083`,
+`STATE-WP-0084`, and `STATE-WP-0086`: the central service now clones exact Forge
+commits ephemerally and reconciles them without writing identifiers into a
+shared checkout.
+
+The live State Hub pod no longer mounts `/home/tegwick` or `/root/.ssh`. It uses
+the `state-hub` service account and an OpenBao-projected Forge read credential.
+The registrar guard has also been retired. Remaining work is limited to runtime
+hardening, completing the repository-model audit, deciding the dashboard
+disposition, and publishing the operating boundary.
+
+## Admissibility under the retirement freeze
+
+`policies/retirement-freeze.md` allows changes that fix operational risk or
+reduce scope. This is both: the sweep is currently broken in production, and the
+work removes a coupling rather than adding capability. It establishes no new
+permanent ownership here — the deployment chart already lives in this repo at
+`deploy/railiance/apps/charts/state-hub/`.
+
+## The coupling, as measured 2026-08-21
+
+| # | Coupling | Evidence |
+| --- | --- | --- |
+| 1 | Pod mounts the operator home as a hostPath | `sweep.hostPath: /home/tegwick`, mounted rw at the same path |
+| 2 | Pod runs as root | `securityContext: {}`, no `runAsUser`; produced **999 root-owned files** under `~/state-hub` |
+| 3 | Pod uses the operator's personal SSH key as its service identity | `sweep.sshHostPath: /home/tegwick/.ssh` → `/root/.ssh` |
+| 4 | Hub repo registry points at workstation paths | **72 of 75** records have `local_path: /home/worsch/...`, a path railiance01 will never have |
+| 5 | Hub repo registry records the retired git host | `remote_url: gitea-remote:...` after the 2026-08-21 forgejo transition |
+| 6 | Dashboard is a workstation process | Observable dev server on `127.0.0.1:3000`, not served from the cluster |
+
+**And the fault that blocks everything:** inside the pod `/home/tegwick` is
+mounted **read-only** — `ro,relatime,discard,errors=remount-ro` — although the
+chart sets no `readOnly` on that volumeMount and `securityContext` is empty. The
+host has the same device mounted `rw` with a healthy disk and no dmesg errors, so
+this is imposed by the runtime or an admission path, not by hardware.
+
+The sweep therefore dies with
+`OSError: [Errno 30] Read-only file system: '/home/tegwick/info-tech-canon/.custodian-brief.md'`
+before it can mint anything. That is the whole registrar problem: **the registrar
+cannot write identifiers into files it cannot write.** It explains the 12 queued
+sync requests and why the newest `custodian-sync` commits are from July.
+
+## Restore the write path
+
+```task
+id: STATE-WP-0081-T01
+status: cancel
+priority: high
+state_hub_task_id: "7dca680b-d34d-5bfe-838e-b463a4487a9c"
+```
+
+Find why the hostPath mounts read-only against the chart's own spec, and restore
+writes. Candidates in order: an admission controller or PodSecurity policy
+forcing hostPath read-only; a k3s/containerd default for hostPath volumes; a
+missing explicit `readOnly: false` on the volumeMount.
+
+This is the minimum to make the registrar function, and the only task here that
+unblocks anything today. Do it first even though T02 later deletes the mount —
+a working baseline makes every later change verifiable.
+
+Verification is end-to-end, not a green pod: run the sweep and confirm
+`EBIND-WP-0002` gets a `state_hub_workstream_id` written back into its file.
+
+**Superseded 2026-09-04.** The shared write path was deliberately abandoned.
+Forge-derived reconciliation now assigns deterministic identifiers without a
+cluster writer touching the operator checkout; `EBIND-WP-0002` is registered and
+finished. See `STATE-WP-0083`, `STATE-WP-0084`, and `STATE-WP-0086`.
+
+## Give the pod its own clones
+
+```task
+id: STATE-WP-0081-T02
+status: cancel
+priority: high
+state_hub_task_id: "3fd4d23c-6b67-5b92-b312-25a7295773fd"
+```
+
+Replace the `sweep-repos` hostPath with storage the pod owns — a PVC the sweep
+clones into and maintains, seeded from forgejo.
+
+This is the change that actually severs coupling #1 and #2. Mounting a human's
+home directory into a production workload is what created 999 root-owned files,
+what made `git pull` fail on the host, and what put the operator's checkouts one
+`reset --hard` away from a scheduled job.
+
+Sizing input: the current tree is ~78 repos; `markitect_project` alone is 24 MB.
+
+Keep the sweep's repo list driven by the hub's repo registry, not by whatever
+happens to be on a disk.
+
+**Superseded 2026-09-04.** The service uses short-lived Forge clones rather than
+a long-lived PVC clone tree. The required boundary is achieved: the live pod has
+no hostPath into an operator home directory.
+
+## Replace the operator SSH key with a service identity
+
+```task
+id: STATE-WP-0081-T03
+status: done
+priority: high
+state_hub_task_id: "8e5a5eb8-f29c-5cab-a19d-3447b6e0c26a"
+```
+
+Issue a dedicated forgejo deploy key or service account for the sweep and mount
+it from a Secret. Remove `sweep.sshHostPath` and the `/root/.ssh` mount.
+
+The current arrangement gives a root-running production workload the operator's
+personal private key. It is read-only, so this is a blast-radius problem rather
+than a live compromise — but the key that can push to every repository in the
+fleet should not be the same key a human uses interactively.
+
+Credential custody routes through OpenBao, not this repo — see
+`.claude/rules/credential-routing.md`. Do not put key material in the chart.
+
+**Completed 2026-09-04.** The live workload uses its Kubernetes service account
+and an OpenBao-projected Forge read token. Neither the operator SSH directory nor
+a personal private key is mounted into the pod.
+
+## Run as a non-root user
+
+```task
+id: STATE-WP-0081-T04
+status: done
+priority: medium
+state_hub_task_id: "57ab0ced-ef3f-5260-b7d6-e2a78ff4e023"
+```
+
+Set an explicit non-root `runAsUser`/`runAsGroup`, disallow privilege escalation,
+drop unnecessary capabilities, and use a read-only root filesystem if the
+application permits it. The PVC dependency no longer applies because T02 was
+superseded by ephemeral Forge clones.
+
+Closes the recurrence: today's ownership fix will be undone by the next sweep
+while the pod still runs as root.
+
+**Completed 2026-09-04.** Helm release revision 58 runs the API and MCP pods as
+UID/GID 10001 with `runAsNonRoot`, `RuntimeDefault` seccomp, all capabilities
+dropped, privilege escalation disabled, and a read-only root filesystem. A
+writable `emptyDir` is mounted only at `/tmp`; the migration hook uses the same
+security context. Both rollouts and `/state/health` passed with zero restarts.
+
+## Correct the hub repo registry
+
+```task
+id: STATE-WP-0081-T05
+status: done
+priority: high
+state_hub_task_id: "530fbd27-e463-51d2-b09c-ba9827d057de"
+```
+
+72 of 75 repo records carry `local_path: /home/worsch/...` and stale
+`remote_url: gitea-remote:...`. Both are wrong for a cluster that reads from
+forgejo into its own clone tree.
+
+Decide first whether `local_path` should be **per-instance rather than global** —
+one column cannot describe a workstation checkout and a cluster clone at once,
+and its current single value is precisely how the workstation leaked into
+cluster configuration. `RMGR-WP-0008` is building the repository-representation
+surface that inherits this; settle the shape with it rather than patching values
+that will move.
+
+`remote_url` correction is unambiguous and can proceed immediately.
+
+**Progress 2026-09-04.** Repository representation now carries per-host
+`host_paths`, a compatibility `local_path`, and Forge remotes. Cluster
+reconciliation consumes Forge commits rather than workstation paths. Complete a
+fleet-wide audit before closing this task, including confirmation that no
+cluster consumer still interprets `local_path` as an authoritative checkout.
+
+**Completed 2026-09-04.** The primary database audit recorded 131 repositories,
+126 active, no active repository without a remote, and no stale Gitea remote.
+The one active missing value (`maturity-engine`) was repaired from its verified
+Forgejo origin. Four remote-less records are archived history. Evidence:
+`docs/evidence/repository-registry-audit-20260904.json`. The unbounded collection
+endpoint performance finding is routed as intake
+`01a06e0c-3feb-7920-a6f2-961b03dc170d`.
+
+## Serve the dashboard from the cluster
+
+```task
+id: STATE-WP-0081-T06
+status: done
+priority: medium
+state_hub_task_id: "1d74e5e2-fb0f-5342-afbb-6ce2986823f4"
+```
+
+The dashboard runs as an Observable dev server on the workstation at
+`127.0.0.1:3000`. Serve it from the cluster behind the same ingress as the API so
+it survives the workstation being off, and so what the operator sees is what the
+cluster holds.
+
+Check first whether this is worth building here at all: `hub-projection-ui` is
+dispositioned `replace` → `hub-core` (14 items, slice B5 in
+`docs/retirement-cutover-slice-plan.md`). If B5 lands first this task is a
+redirect, not a build. Confirm with `HUB-WP-0004` before writing any chart.
+
+**Completed by handoff 2026-09-04.** Building a new permanent State Hub
+deployment surface would conflict with the retirement direction. The existing
+dashboard remains an operator/development surface while its replacement is
+routed to Hub Core as intake `01a06e07-658e-73fa-9164-0b522504c0ee`.
+
+## State and enforce the boundary
+
+```task
+id: STATE-WP-0081-T07
+status: done
+priority: medium
+state_hub_task_id: "12a2ce9f-7cdf-501b-9018-4c960d45e855"
+```
+
+Write the rule down so it stops being re-derived: **workstation coding agents
+push to forgejo; cluster infrastructure reads from forgejo; neither reads the
+other's disk.**
+
+Record it where agents will meet it — `docs/`, the repo `AGENTS.md` templates, and
+as an ADR if it constrains other repos, which it does.
+
+Include the failure this prevents. On 2026-08-21 railiance01's 70 checkouts were
+found still pointed at the retired gitea host, six weeks stale, and the
+`evidence-binder` workplan the registrar was asked to index **did not exist** in
+the copy the cluster could see. A shared-disk assumption made a stale reader look
+like a queue.
+
+**Completed 2026-09-04.** `STATE-ADR-002`, the cluster operating model, this
+repository's agent instructions, and the generated Codex template now carry the
+Forge-commit boundary and explain the failure it prevents.
+
+## Close out the registrar
+
+```task
+id: STATE-WP-0081-T08
+status: done
+priority: high
+state_hub_task_id: "782c502a-5ce2-5ec3-8f07-b550c9705013"
+```
+
+With the write path restored, confirm the registrar end-to-end and drain the
+backlog: 12 queued requests from `evidence-binder`, `kaizen-agentic`,
+`glas-harness`, and `agentic-resources`, plus this fleet's own unregistered
+`RMGR-WP-0008` and `RMGR-WP-0009`.
+
+Then remove the interim: `RMGR-WP-0005-T03` (UUIDv5 derivation, keyed on
+`(namespace, identifier)` and deriving for live records only per the 2026-08-21
+`ADR-007` amendment) makes writeback idempotent and retires the single-writer
+rule entirely. Coordinate rather than duplicate — the derivation belongs to
+`repo-manager`.
+
+Reply to the queued agents when it is done; several have been waiting since
+2026-08-20.
+
+**Completed 2026-09-04.** `EBIND-WP-0002`, `RMGR-WP-0008`, and `RMGR-WP-0009`
+are finished; exact-commit reconciliation is operational; and the interim
+single-writer registrar guard was retired by the Forge-derived projection path.
+
+## Acceptance
+
+- [x] Shared-checkout writeback superseded; `EBIND-WP-0002` registered
+- [x] Pod uses ephemeral Forge clones; no hostPath into any home directory
+- [x] Pod authenticates with a dedicated service identity
+- [x] Pod runs as non-root with an explicit restrictive security context
+- [x] No `/home/worsch` path in any cluster-consumed record; `remote_url` values current
+- [x] Dashboard reachable without the workstation, or formally handed to `hub-core`
+- [x] Boundary rule written and discoverable by agents
+- [x] Registrar queue drained; interim single-writer rule retired
diff --git a/workplans/STATE-WP-0082-multi-owner-review-contracts-and-receipts.md b/workplans/STATE-WP-0082-multi-owner-review-contracts-and-receipts.md
new file mode 100644
index 0000000..3ddec7b
--- /dev/null
+++ b/workplans/STATE-WP-0082-multi-owner-review-contracts-and-receipts.md
@@ -0,0 +1,187 @@
+---
+id: STATE-WP-0082
+type: workplan
+title: "Multi-owner review contracts and receipts"
+domain: infotech
+repo: state-hub
+status: finished
+owner: codex
+topic_slug: multi-owner-review-contracts
+created: "2026-08-22"
+updated: "2026-08-22"
+related:
+  - RAILIANCE-WP-0024
+  - RAIL-HO-WP-0011
+origin: routed
+origin_ref: "Operator request to generalize the RAILIANCE-WP-0024 owner-review interface"
+state_hub_workstream_id: "eb09a516-1fe6-5c41-999f-8e1471b7f82c"
+---
+
+# Multi-owner review contracts and receipts
+
+## Goal
+
+Generalize the hash-bound `RAILIANCE-WP-0024` owner-review prototype into a
+file-authoritative, queryable review-contract projection. State Hub validates,
+indexes, aggregates, and exposes contracts and immutable receipts; it does not
+execute consumer-defined commands or turn procedure review into live-action
+authorization.
+
+This is a compatibility and extraction slice while State Hub retires. Contract
+and receipt files remain authoritative in their owning repositories, messages
+carry notification references only, and the implementation must remain
+separable for later movement to `hub-core`.
+
+## Define the review-contract boundary
+
+```task
+id: STATE-WP-0082-T01
+status: done
+priority: high
+state_hub_task_id: "a6511423-78e0-51c6-8c7d-b91609e331ff"
+```
+
+Specify a versioned canonical contract with typed subject and owner references,
+explicit gates, stable assertion ids, revision-pinned artifact hashes, named
+read-only checks, allowed dispositions, and deterministic canonical digesting.
+Specify append-only receipt semantics, staleness, supersession, idempotency,
+and aggregate state.
+
+Done when the boundary preserves existing simple decisions, keeps repository
+files authoritative, treats State Hub as projection, and states explicitly
+that a satisfied procedure review is not an execution authorization.
+
+Implemented in `docs/review-contracts-v1.md` and the
+`review-contract/v1` validator. The bounded WP-0024 adapter preserves the
+prototype source digest and derives stable assertion ids.
+
+## Add projection persistence
+
+```task
+id: STATE-WP-0082-T02
+status: done
+priority: high
+state_hub_task_id: "e2ac4ad6-91d9-5b4e-a0fb-7106c731e348"
+```
+
+Add review-contract and immutable receipt persistence through an Alembic
+migration. Keep the review aggregate separate from the existing `decisions`
+row rather than adding owner arrays or receipt blobs to it. Retain source repo,
+path, full revision, contract digest, receipt digest, canonical UTC timestamps,
+and optional links to a decision, workplan, or task.
+
+Done when upgrade/downgrade works and existing decision rows and routes require
+no data rewrite.
+
+Implemented as separate `review_contracts` and append-only
+`review_receipts` tables in migration `c9e5a1b3d7f2`. A clean
+upgrade/downgrade/upgrade round trip passed.
+
+## Implement validation and aggregation APIs
+
+```task
+id: STATE-WP-0082-T03
+status: done
+priority: high
+state_hub_task_id: "48682d0c-e69f-5486-a007-472dea959994"
+```
+
+Provide contract projection, receipt submission, exact reads, and aggregate
+status. Reject unknown owners, incomplete owner scopes, digest mismatches,
+artifact drift, missing assertions/checks, unsafe dispositions, duplicate
+non-idempotent submissions, and legacy decision resolution that would bypass a
+required review gate.
+
+For version 1, support the prototype's `all_required` policy only. A latest
+valid `request_changes` blocks its owner's gates; contract changes make prior
+receipts stale rather than mutating or deleting them.
+
+Projection, receipt, exact listing, and aggregate routes enforce the v1
+contract. Linked required reviews now prevent legacy decision resolution from
+bypassing an unsatisfied gate.
+
+## Provide a direct client and legacy adapter
+
+```task
+id: STATE-WP-0082-T04
+status: done
+priority: medium
+state_hub_task_id: "9ab5b022-25d0-556c-bca0-222c414bc18f"
+```
+
+Add a State Hub CLI or import surface that can project an authoritative
+contract, submit a file-backed receipt, and print owner/gate status. Provide a
+bounded adapter for the `RAILIANCE-WP-0024` contract shape so the prototype can
+migrate without making State Hub execute its repository-specific checks.
+
+Done when callers no longer encode receipts as opaque agent-message bodies and
+message transport can carry stable contract/receipt references instead.
+
+Implemented `statehub review project|submit|status`. The client derives the
+repository path and full revision from Git. Legacy message receipts remain
+historical notifications rather than canonical evidence.
+
+## Pilot with railiance-infra
+
+```task
+id: STATE-WP-0082-T05
+status: done
+priority: high
+state_hub_task_id: "90af0001-17c6-5cbb-9d08-64947211f956"
+```
+
+Use `railiance-infra` as the first consumer. Publish a canonical receipt file
+for its existing `RAILIANCE-WP-0024-T03` procedure review, project it through
+the generic interface, and prove the aggregate owner matrix matches the
+prototype without authorizing a reboot.
+
+The pilot must prove approval, request-changes supersession, artifact-change
+staleness, duplicate idempotency, wrong-owner rejection, canonical UTC receipt
+time, and rebuild from repository files.
+
+Projected contract `01a02ac9-9e90-74c0-bdb2-a8604d32b542` from
+`railiance-platform@a557208a4a33520c39f749dcc26e6985386a96d4`.
+Projected railiance-infra receipt
+`01a02aca-02dd-7b16-93f2-7ab455976059` from
+`railiance-infra@d85237aee8080201ddacb2d4f34a15b6fc91609b`.
+Its owner state is approved while both gates remain unsatisfied and
+`authorizes_execution` remains false.
+
+## Verify compatibility and extraction readiness
+
+```task
+id: STATE-WP-0082-T06
+status: done
+priority: medium
+state_hub_task_id: "c8486c31-d36b-5517-be2f-7efc715dfd79"
+```
+
+Run migration, router, service, CLI, and full-suite tests. Document the source
+and projection contracts, operational rollback, message compatibility, and the
+future `hub-core` extraction boundary. Record any unimplemented authenticated
+actor-to-owner authorization as a live residual rather than implying that a
+caller-supplied owner string is authority.
+
+Focused lint, 13 affected tests, and the final 640-test full suite pass. The
+suite retains one pre-existing async SQLAlchemy cleanup warning. Authenticated
+actor-to-owner delegation is live residual intake
+`01a02aca-2dfc-7e57-bebf-f5e970d7b403`.
+
+## Residual handoff
+
+Authenticated actor-to-owner delegation and authorization proof are tracked by
+State Hub intake `01a02aca-2dfc-7e57-bebf-f5e970d7b403` (`origin:
+residual`, `origin_ref: STATE-WP-0082`). Until that work is promoted, actor
+strings are coordination identities only.
+
+## Acceptance
+
+- Existing single-decider APIs remain backward compatible.
+- Review contracts are separate aggregates linked to decisions/work records.
+- Every valid approval is bound to the exact contract, assertions, artifacts,
+  checks, owner, actor, and canonical UTC receipt time.
+- Contract or artifact change makes old receipts stale.
+- State Hub never runs arbitrary commands from a contract.
+- Aggregate satisfaction never by itself authorizes a live mutation.
+- `railiance-infra` completes the first file-backed consumer round trip.
+- The projection can be rebuilt from authoritative contract and receipt files.
diff --git a/workplans/STATE-WP-0083-forge-derived-projection-reset.md b/workplans/STATE-WP-0083-forge-derived-projection-reset.md
new file mode 100644
index 0000000..049c002
--- /dev/null
+++ b/workplans/STATE-WP-0083-forge-derived-projection-reset.md
@@ -0,0 +1,772 @@
+---
+id: STATE-WP-0083
+type: workplan
+title: "Forge-derived projection reset, per repository"
+domain: infotech
+repo: state-hub
+status: finished
+owner: codex
+topic_slug: infotech
+created: "2026-08-25"
+updated: "2026-08-31"
+related:
+  - CUST-ADR-012
+  - CUST-WP-0068
+state_hub_workstream_id: "40e36360-6b2a-5903-b769-47507d866ac8"
+---
+
+# Forge-derived projection reset, per repository
+
+## Goal
+
+Implement `ADR-012` decision 7: discard a repository's projection and rebuild it
+from what Forgejo holds. Per repository, routine, idempotent, and verifiable.
+
+This is the only sanctioned way to remove a hub record. The hub has no
+hard-delete for work records — `DELETE /tasks/{id}` is `cancel_task`,
+`DELETE /workstreams/{id}` is `410 Gone`, and no `session.delete` exists for
+either. Re-derivation is not one option among several; it is the mechanism.
+
+## Why here and not in Repo Manager
+
+`ADR-012` decision 1 says central derives from the forge, and the pod can reach
+it: `git ls-remote https://forgejo.coulomb.social/...` succeeds anonymously from
+inside the cluster, and `git` is already in the image.
+
+Driving the reset from Repo Manager would mean computing a projection on a
+workstation and pushing it into central — precisely the injection of derived
+state `ADR-010` decision 5 forbids. Central must do its own reading. The cost is
+that workplan parsing exists in two places; `scripts/consistency_check.py`
+already parses frontmatter and task blocks here, so the capability is present
+and should be extracted rather than rewritten.
+
+## What it must not do
+
+- **Not restore preliminary overlay records.** They exist because the forge does
+  not hold them; a rebuild from the forge cannot reproduce them and must not
+  pretend to.
+- **Not destroy hub-native records.** Progress events, decisions and inbox
+  messages originate in the hub (`ADR-010` decision 4). They are not
+  forge-derived and must survive a rebuild of forge-derived state.
+- **Not proceed silently when records would be lost.** Stop, name them, and
+  require an explicit acknowledgement.
+
+## Derive a repository's projection from the forge
+
+```task
+id: STATE-WP-0083-T01
+status: done
+priority: high
+state_hub_task_id: "ca3e8578-6855-55a2-9042-f790c8997628"
+```
+
+Given a repository slug, clone or fetch its default branch from Forgejo into a
+temporary location, parse the workplan files, and compute the projection that
+state would produce: workplans, tasks, their identifiers, statuses and backing
+paths.
+
+Read-only and side-effect free. Record the commit the derivation came from —
+`ADR-012` decision 2 requires provenance, and the existing `git_fingerprint` is
+worthless precisely because nothing ever wrote it correctly.
+
+Acceptance: deriving `the-custodian` twice from the same commit yields identical
+output, and the commit is reported.
+
+**Done (2026-08-25).** `api/services/forge_projection.py`. Central clones the
+default branch from Forgejo and derives 69 workplans and 459 tasks from
+`the-custodian` at commit `d5013ae`, identically across runs. Identifiers are
+derived from the canonical record id in the `ADR-007` namespace, verified against
+live records — so a forge-derived projection and a preliminary overlay agree on
+identity without reconciliation. Eight tests, including that identifiers are
+derived rather than inherited from whatever a file happens to carry.
+
+A fresh shallow clone each time is deliberate: reusing a working copy is how a
+projection ends up reflecting someone's local state instead of the forge.
+
+## Report the difference before changing anything
+
+```task
+id: STATE-WP-0083-T02
+status: done
+priority: high
+state_hub_task_id: "3122ae66-1a9a-5102-a7ff-b7ba1564bf3c"
+```
+
+Compare the derived projection against what the hub currently holds for that
+repository, and report: records the forge has that the hub lacks, records the
+hub has that the forge does not, and records whose fields differ.
+
+This is the half that is immediately useful without any destructive capability,
+and it is what makes decision 7's "verifiable" real. It also answers the
+question `CUST-WP-0068-T09` is waiting on — which stale rows would actually
+clear — before anyone commits to clearing them.
+
+Acceptance: a dry-run diff for a repository with known drift matches what
+manual inspection shows.
+
+**Workplan-level diff done; task-level blocked (2026-08-25).**
+
+The first implementation matched hub records to derived ones *by UUID* and was
+badly wrong: most hub records still carry pre-`ADR-007` random identifiers, so
+nearly every record appeared simultaneously missing and stale. A reset built on
+that comparison would have destroyed and recreated the whole projection. It now
+matches on canonical record id, falling back to the backing file.
+
+Workplan-level results are trustworthy and inspectable:
+
+| Repository | missing | stale | differing |
+|---|---|---|---|
+| `whitehat-security` | 0 | 0 | 0 |
+| `the-custodian` | 3 | 4 | 52 |
+| `railiance-platform` | 18 | 25 | 2 |
+
+`whitehat-security` reporting clean is the control: it was bootstrapped directly
+from its files, so a forge derivation must agree with it exactly. The four stale
+workplans on `the-custodian` were checked by hand and are real —
+`CUST-WP-0023`/`0024` have no file in the repository at all, and
+`state-hub-v0.1`/`v0.2` carry slugs that were never canonical ids. All four are
+genuine hub-first records, the class `ADR-010` says to disposition.
+
+**Blocked: hub tasks carry no canonical record id.** The task schema is
+`id, workplan_id, title, status, priority, …` with nothing holding
+`CUST-WP-0067-T01`. A file task and a hub task can therefore only be matched by
+title, which is why the task diff reports 149 missing and 131 stale for
+`the-custodian` where the workplan diff reports 3 and 4. That is the matching
+failing, not drift.
+
+Task-level reset must not be built on title matching — renaming a task heading
+would silently destroy and recreate its record. `T03` is limited to workplans
+until tasks carry their canonical id, which is `T06`.
+
+## Apply the reset transactionally
+
+```task
+id: STATE-WP-0083-T03
+status: done
+priority: high
+state_hub_task_id: "95496a43-9e72-53d0-ad89-1a43713b4be9"
+```
+
+Replace the repository's forge-derived records with the derived projection in
+one transaction: create what is missing, update what differs, remove what no
+longer derives. Hub-native records are untouched.
+
+Refuse by default when removal would destroy a record with no counterpart in the
+forge; report what would be lost and require an explicit acknowledgement to
+proceed. That refusal is evaluated per repository, so one unresolved repository
+never blocks the rest.
+
+Acceptance: reset twice produces the same projection; a repository holding
+records the forge lacks is refused with those records named; hub-native record
+counts are unchanged across a reset.
+
+**Done (2026-08-26).** `reset_repository_projection()` in
+`api/services/forge_projection.py`. Verified against live data, rolled back:
+`whitehat-security` applied 5 updates and 0 retirements; `the-custodian`
+**refused**, naming `cust-wp-0023`, `cust-wp-0024`, `state-hub-v0.1` and
+`state-hub-v0.2` — the four records confirmed by hand as genuine hub-first
+records with no file — and changed nothing.
+
+Refusal is the default because a record that stops deriving is ambiguous: the
+file may have been deleted deliberately, or the caller may have pointed at the
+wrong branch. Only the caller can say which, so only the caller may authorise it.
+
+Retirement never deletes, with a test asserting the row survives and
+`session.delete` is never called. A record that derives again is un-retired
+rather than left contradicting the forge.
+
+The first execution of this write path was run against the **cache** database
+rather than central, and rolled back. A write path's first run belongs on the
+discardable copy.
+
+**Scope limit, enforced in the code rather than documented beside it.** Tasks of
+existing workplans are untouched; tasks are created only alongside a *new*
+workplan, where nothing exists to mis-match. The outcome carries that as a note
+so partial convergence cannot be mistaken for full. 678 tests pass.
+
+## Fleet form as a loop over the repository form
+
+```task
+id: STATE-WP-0083-T04
+status: done
+priority: medium
+state_hub_task_id: "3935334e-d5bd-5667-a862-0049c1c2c5b0"
+```
+
+The fleet-wide reset iterates the per-repository reset and shares its
+implementation, so the rarely-used dangerous path is exercised by the frequently
+used safe one. Repositories that refuse are skipped and reported, never aborting
+the pass.
+
+Acceptance: a fleet dry-run reports per-repository outcomes including refusals,
+and completes despite them.
+
+**Built (2026-08-26).** `reset_fleet_projection()` is a loop over the
+per-repository form and nothing else, so the rarely-run wide operation is the
+frequently-run narrow one rather than a second implementation trusted on the
+strength of never having been exercised.
+
+Its behaviour on failure is the part that matters, and all three are tested:
+
+- **A refusal does not stop the pass.** Aborting on the first refusal means one
+  unresolved repository blocks reconstruction everywhere, which in practice means
+  permanently.
+- **An error does not stop the pass.** A repository that cannot be cloned is
+  recorded and the loop continues.
+- **Each repository gets its own session**, so one failure cannot roll back
+  another's work or leave a poisoned transaction behind. Only repositories that
+  applied are committed.
+
+694 tests pass. Needs deployment before it can run against central.
+
+**Ran against central (2026-08-28).** Image `main-54b09ee`. Fleet
+refuse-mode over 125 repositories: 52 applied, 69 noop, 2 refused
+(identifier collisions on `railiance-bootstrap` and `railiance-hosts`;
+acknowledgement does not authorise those), 2 unreadable
+(`vergabe_teilnahme`, `markitect-project`), 0 errors. Zero workplans
+retired, zero tasks cancelled. `the-custodian` had already been
+reset-acked and reported `noop` on the fleet pass. Evidence lives in
+`the-custodian/docs/recovery/fleet-projection-reset-2026-08-28.md`.
+
+## Retire what the reset replaces
+
+```task
+id: STATE-WP-0083-T05
+status: done
+priority: medium
+state_hub_task_id: "b63c97a8-ceba-551a-a3df-5253a9de409a"
+```
+
+Once reset is trusted, `CUST-WP-0068-T09` can clear its stale rows — 4 workplan
+rows from the prefix migration and 305 task rows across 44 workplans.
+
+`ADR-003` decision 2's `mtime`-based fingerprints should also be replaced by the
+source commit at this point; `ADR-012` invalidated that composition and the
+replacement belongs with the provenance work in `T01`.
+
+Acceptance: `CUST-WP-0068-T09` closes; no fingerprint input depends on a local
+filesystem.
+
+
+## Give hub tasks their canonical record id
+
+```task
+id: STATE-WP-0083-T06
+status: done
+priority: high
+state_hub_task_id: "6172bdd6-3236-5f85-8c02-b0f149e373b8"
+```
+
+Hub task rows hold no canonical identifier — only a title — so nothing reliably
+connects `CUST-WP-0067-T01` in a file to its row. Every other record type has a
+stable identity; tasks do not, and that gap is what stops the reset from covering
+them.
+
+Add the canonical id to the task record and populate it during derivation and
+registration. Once present, task matching becomes identity-based like workplans,
+and `T03` can extend to tasks safely.
+
+Until then a task's identity is its title, which changes whenever someone edits a
+heading. That is not a foundation for deletion.
+
+Acceptance: task rows carry their canonical record id; the task diff for
+`whitehat-security` reports clean; `the-custodian`'s task diff falls to something
+manual inspection confirms.
+
+**Built (2026-08-26).** Migration `e2b3c4d5f6a7` adds `tasks.record_id`,
+nullable because no migration can invent an identity for an existing row — only
+the repository files hold the mapping.
+
+The backfill *reads* that mapping rather than inferring it: a file task declares
+both its canonical id and the projection UUID it was registered under, so the
+pairing is stated, not guessed. Across 121 repositories and 1104 files it
+recovered **5516 pairs with zero conflicts**, and identified **4456 of 6073**
+task rows in the cache database.
+
+Diff and reset now key on `record_id` where present, falling back to a
+`title:`-prefixed key so an unidentified row is *visibly* unidentified rather
+than silently title-matched.
+
+Two refusals are tested rather than documented: a row the files do not claim
+keeps no identity, and a row that already has one is never overwritten — a
+mismatch is recorded as a conflict, not resolved. Title matching would have
+"worked" and destroyed a record every time someone edited a heading.
+
+**Remaining, in order.** Deploy the migration to central; then run the backfill
+against central as an explicit operation — deliberately *not* inside the Helm
+hook, where a partial failure would silently leave half the tasks identified.
+The cache matched 4456 of 6073 and central has a different history, so the
+numbers will differ and a dry run should be compared before applying.
+
+Only then may `T03` be extended to tasks of existing workplans, which is a
+further change with its own verification. `CUST-WP-0068-T09` is therefore two
+moves away, not one.
+
+**Backfill run against central (2026-08-26), and a defect it exposed.**
+
+The first implementation read local filesystem paths. Central has no workstation
+checkout and must not depend on one — `ADR-012` decision 1 makes the forge the
+projection source — and the point became concrete rather than theoretical:
+central's Postgres is unreachable from the workstation, since the tunnel carries
+HTTP only. A forge-sourced variant now clones each repository in-cluster and
+reads the pairing from what the forge holds.
+
+Dry run across 121 repositories: 1094 files, 5620 pairs, 5248 to update, 372
+file-declared UUIDs central does not hold, **zero conflicts**. The count
+differing from the cache's 4456 of 6073 was the check that mattered — central
+holds the re-keyed records the cache never had, so a *matching* number would have
+meant cache state was leaking in. The forge scan reading 1094 files against the
+workstation's 1104 is the preliminary-overlay distinction showing up in the
+numbers.
+
+**Then applied, and wrong.** 5248 rows were identified but only 5100 identities
+were distinct. A task id written as a bare `T01` is unique only inside its own
+workplan; stored as canonical it gave every workplan's first task one identity.
+51 such ids landed on 148 rows.
+
+The backfill's own conflict detection could not see it: it checks one UUID
+claimed by two ids, and this was the inverse. It surfaced only because the
+identified count and the distinct count did not reconcile — a check that could
+easily have been skipped after a dry run reporting zero conflicts.
+
+Short ids are now qualified as `WORKPLAN-ID-T01`, and a short id in a file with
+no workplan id gets no identity at all. The 136 affected rows on central were
+cleared for reassignment, since the backfill never overwrites an existing
+identity.
+
+**Central now: 5112 of 5974 identified, 5077 distinct.** The remaining 34
+duplicates are not from this work. They are unqualified ad-hoc ids reused across
+repositories — `ADHOC-2026-07-02-T01` exists in three workplans — which is the
+problem `CUST-WP-0066` closed for new records while existing ones kept their
+unqualified ids. They need their own disposition.
+
+**Done (2026-08-26).** Corrected backfill applied to central: **5248 of 5974
+tasks identified, 5213 distinct, 35 duplicate identities.**
+
+The check before applying was uniqueness, not volume — the lesson from the first
+attempt, where a clean dry run reporting zero conflicts concealed 51 non-unique
+ids. All 136 pending updates were verified to take identities held by nothing
+else before a single row was written.
+
+The 35 remaining duplicates predate this work and fall into three classes:
+
+| Count | Class | Origin |
+|---|---|---|
+| 18 | `KONT-WP-0013-T00N` and similar | a workplan registered twice, so both copies claim the same task ids |
+| 12 | `RAILIANCE-WP-00NN-T0N` | archived RAILIANCE-WP files, left unrenamed by the owner decision of 2026-08-25 — the same numbers exist in three repositories, so their task ids collide |
+| 4 | `ADHOC-*-T0N` | unqualified ad-hoc ids reused across repositories, the class `CUST-WP-0066` closed for new records only |
+
+The `RAILIANCE-WP` twelve are worth noting as a consequence rather than a
+surprise: migrating only the *active* workplans was the right call for blast
+radius, and this is the price — the archived copies keep colliding identities
+until they are migrated too, and task-level reset cannot act on those workplans
+in the meantime.
+
+**Task-level reset remains blocked**, now on a narrower and better-understood
+problem: 35 identities, not 5974 unidentified rows.
+
+**Mixed identifier convergence support (2026-08-31).** The fast forge path
+exposed a second, separate consistency shape: one repository can contain legacy
+UUID rows and already-derived UUID rows at the same time. State Hub's sealed
+identifier transaction now classifies every mapping, migrates only verified
+legacy sources, accepts already-derived targets only when their canonical
+record identity and repository match, and records durable aliases for both.
+Both-present and neither-present mappings fail the whole repository transaction.
+The primary-only HTTP surface has explicit plan-hash confirmation and a reverse
+operation for a failed file phase. This does not resolve the 35 duplicate
+canonical task identities, so T02 remains `progress`.
+
+**Duplicate identity disposition (2026-08-31).** A fresh primary audit found
+131 duplicate task `record_id` groups across 274 rows. The global count is not
+the reset safety boundary: all 131 cross workplan boundaries, while none repeats
+inside one workplan. A task has no projection-retirement field, so workplan slug
+tombstones are only a diagnostic clue; current task membership is whether the
+Forge still derives that id for that owning workplan.
+
+The 12 groups with multiple untombstoned owning workplan slugs come from two
+earlier wrong workplan/backing-file projections:
+`CUST-WP-0010b-T01..T02` and `SECRETS-WP-0002-T01..T10`. They must be resolved
+by reconciling the owning workplans while preserving their completed historical
+task rows, not by deleting or re-keying those rows. Live exact-commit reconciles
+did that with zero creates, retirements, cancellations, or refusals. Evidence:
+`docs/evidence/STATE-WP-0083-task-identity-audit-2026-08-31.json`.
+
+The diff now reports an explicit `ambiguous` class instead of silently choosing
+the last row in a dictionary. Reset refuses duplicate identities declared by
+the forge, duplicate identified rows inside the matched current workplan, and
+any task creation whose derived UUID is held by another current workplan. A
+repeated human-readable id outside the owning workplan's current desired set is
+historical evidence, not a competing projection. These checks are batched;
+retired/displaced workplan tasks remain preserved. The second exact-commit pass
+for both affected repositories returned `noop` with every count zero. Final
+deployment of the refined boundary remains before T02 can close.
+
+**Done (2026-08-31).** Image `main-a32112e`, Helm revision 53, is healthy on
+the `railliance01` primary. State Hub itself converged at exact Forge commit
+`a32112e5abc18dfbecbbf1320cf5b04dce814920`; the immediately repeated pass was
+`noop` with every count zero. The task diff/reset boundary is now complete.
+
+Fleet identifier rollout remains live under `RMGR-WP-0005`; this workplan does
+not duplicate that residual. Historical terminal task labels remain preserved
+by decision and are not pending cleanup work.
+
+
+## Restore a migration mechanism for central
+
+```task
+id: STATE-WP-0083-T07
+status: done
+priority: high
+state_hub_task_id: "27e12170-486e-5669-8658-f7acc80d81f8"
+```
+
+**Central's schema is behind the code it is running, and nothing detects it.**
+Discovered 2026-08-25 while preparing the retirement columns.
+
+Central is at revision `b8d4f0a2c6e1`; the chain is
+`b8d4f0a2c6e1 → c9e5a1b3d7f2 → d1a2b3c4e5f6`. The `review_contracts` table does
+not exist on central even though the migration creating it ships inside the image
+currently serving traffic. The code and the database disagree silently.
+
+There is no migration mechanism. The image `CMD` is bare `uvicorn`, the Helm
+chart declares no migration job, and the only evidence migrations ever ran was an
+ad-hoc `state-hub-alembic-init` Job created outside the chart — deleted earlier
+the same day as a retired-forge leftover. Deleting a completed Job removed a
+historical record rather than a working mechanism, since Jobs do not re-run, but
+it also removed the last visible sign that this gap existed.
+
+This blocks `T03`: the retirement columns cannot reach central without it.
+
+Needed: migrations as a declared part of the release — a chart-managed job or
+init container that runs `alembic upgrade head` before the API serves — and a
+check that surfaces a schema/code mismatch instead of leaving it silent. A
+deployment that can run against a schema it was not built for is the same class
+of defect as a projection that cannot name its source commit.
+
+Acceptance: central reaches `head`; `review_contracts` exists; the mechanism is
+declared in the chart; a mismatch between code and schema is reported rather than
+tolerated.
+
+**Done (2026-08-26).** Central reports
+`schema: {status: ok, applied: d1a2b3c4e5f6, expected: d1a2b3c4e5f6}`.
+`review_contracts` exists. Both pods run `main-97c8762`.
+
+The first execution is worth recording, because it failed in a way that proved
+the design. The `pre-upgrade` hook ran, applied both migrations and deleted
+itself on success — then the k3s API tunnel dropped (`unexpected EOF` →
+`connection refused`) and Helm could not read the deployment to roll the API.
+The release wedged at `pending-upgrade`; no pod rolled.
+
+The schema was therefore briefly *ahead* of the running code, which is the safe
+direction and the reason additive migrations were the right shape: the old image
+served correctly against the new schema throughout. A destructive migration in
+the same circumstance would have taken the service down.
+
+Recovery was `helm rollback` to the last deployed revision — which clears the
+wedge without touching the schema, there being nothing to undo — then re-running
+the upgrade. The hook is idempotent, so the second run's `alembic upgrade head`
+was a no-op.
+
+Two things this exposed, neither yet addressed:
+
+- The hook's `hook-succeeded` delete policy removes the Job on success, so a
+  *successful* migration leaves no trace. That made it look as though nothing had
+  run when in fact everything had. Retaining a short-lived record of successful
+  migrations, not only failed ones, would have answered the question immediately.
+- `bridge status` reported `k3s-api-railiance01` as `connected` while holding a
+  stale pid, so its health signal did not reflect the dropped connection. A
+  tunnel monitor that cannot detect the failure it exists to detect is the same
+  defect class as a projection that cannot name its source commit.
+
+
+## Repair workplan files whose frontmatter never terminates
+
+```task
+id: STATE-WP-0083-T08
+status: done
+priority: high
+state_hub_task_id: "a27b7130-70f5-59a0-9e1e-5ec048737c68"
+```
+
+**Blocks the first production reset.** Found 2026-08-26 by reviewing the reset's
+diff before applying it — the diff proposed retiring `kont-wp-0015`, a live and
+correctly registered workplan, which is what prompted the investigation.
+
+Eighteen workplan files across the fleet have a closing `---` fused onto the last
+frontmatter value:
+
+```yaml
+depends_on_workplans:
+  - KONT-WP-0016---
+```
+
+There is no delimiter line, so the frontmatter never terminates. The file
+declares a dependency on a workplan literally named `KONT-WP-0016---` and the
+entire body is swallowed as frontmatter. Any parser selecting on `type: workplan`
+sees nothing, so the file is not merely unparsed but *invisible* — it appears as
+neither a workplan nor an error.
+
+Affected: `citation-evidence` (5), `infospace-bench` (2), `kontextual-engine`,
+`net-kingdom` (2 incl. archived), and others — 18 in total.
+
+The consequence for reset is severe and must not be worked around: a repository
+containing one of these files derives a projection missing that workplan, so the
+reset proposes retiring a record that is entirely correct. Running it before this
+is repaired would retire live work.
+
+That the refusal-by-default caught this is the design working, but the diff would
+have looked plausible to anyone not checking a specific record — `created=0,
+would_retire=N` reads like a tidy-up.
+
+Repair the frontmatter, then re-derive and confirm each affected repository's
+diff no longer proposes retiring live workplans.
+
+Acceptance: no workplan file yields empty frontmatter while starting with `---`;
+the reset diff for each affected repository proposes retiring only records whose
+backing file genuinely no longer exists.
+
+**Done (2026-08-26).** All 18 repaired across 8 repositories; **zero workplan
+files now yield empty frontmatter**. Previously invisible workplans derive again:
+`KONT-WP-0015`, `CUST-WP-0000`, `CE-WP-0001` and the rest.
+
+Two shapes of one defect, both a missing newline:
+
+| Count | Shape | Example |
+|---|---|---|
+| 16 | closing delimiter fused onto the last value | `- KONT-WP-0016---` |
+| 2 | a value fused onto the following key | `…v1.3.0state_hub_task_id: …` |
+
+Only the newline was inserted; no value was altered, and the diff on each file is
+one line split into two.
+
+**A correction this forces.** `state-hub-v0.1` and `state-hub-v0.2` were reported
+earlier as genuine hub-first records with no backing file, and dispositioned on
+that basis. They are `CUST-WP-0000` and `CUST-WP-0000b` — files that existed all
+along and were unreadable. The claim was wrong because "no file backs this
+record" was inferred from a parser's silence rather than checked against the
+directory.
+
+**The ordering bug in the repair itself is worth recording**, since it is the
+same mistake in miniature. The first version only looked for a fused delimiter
+when no `\n---` existed anywhere in the file. Five `citation-evidence` files have
+a horizontal rule in the body, so a delimiter *was* found — just the wrong one —
+and the real defect was hidden behind it. Checking whether the frontmatter
+*parses* before trusting the delimiter position fixed it, taking the count from
+11 repairable to 18.
+
+
+## Reset diff after the frontmatter repairs (2026-08-26)
+
+Re-run against central once `T08` landed. The false retirements are gone:
+
+| Repository | before | after |
+|---|---|---|
+| `kontextual-engine` | 1 (a live workplan) | 0 retire, 18 updated |
+| `citation-evidence` | not yet measured | 0 retire, 12 updated |
+| `the-custodian` | 4 | 2 retire |
+| `net-kingdom` | — | **errors** |
+
+Two findings the re-run produced, both worth more than the diff itself.
+
+### The four "hub-first records" were never hub-first
+
+`cust-wp-0023` and `cust-wp-0024` were reported as records with no backing file,
+verified by hand, and dispositioned on that basis. They have files —
+`CUST-WP-0023-tpsc.md` and `CUST-WP-0024-repo-doi-gate.md` — which declare
+`type: feature`, so the derivation correctly excludes them while the hub holds
+them as workplans.
+
+Together with `state-hub-v0.1`/`v0.2`, which turned out to be `CUST-WP-0000` and
+`CUST-WP-0000b` with unterminated frontmatter, **all four claims were wrong, by
+three different mechanisms**: broken frontmatter, a mismatched `type`, and in
+both cases an inference from a parser's silence rather than a check against the
+directory. "The tool did not find it" was repeatedly reported as "it does not
+exist".
+
+Eleven files in `workplans/` directories declared something other than
+`type: workplan` — `feature`, `runbook`, `bug-report`, `extension-workplan`,
+`scorecard`, `session-note`, `adhoc` — while the hub held every one of them as a
+workplan.
+
+**Resolved 2026-08-26 by owner decision.** Canon defines six kinds — workplan,
+task, intake, decision, engagement, register-entry — and none of these was among
+them, so the declarations were simply wrong rather than a missing vocabulary.
+Eight files with valid workplan identifiers had their type corrected. Three that
+lacked an identifier as well were given one continuing their repository's
+sequence, with existing hub identifiers preserved so no record was orphaned.
+
+Zero non-workplan types now remain in any `workplans/` directory.
+
+### The reset crashes where it should refuse
+
+`net-kingdom` raises `IntegrityError: Key (id)=(e25ba5fa…) already exists`. Its
+`ADHOC-2026-08-23` derives to an identifier another repository already holds —
+the exact collision `CUST-WP-0066` was written about, where two repositories
+created the same daily identifier on the same day.
+
+The reset must detect that a derived identifier belongs to another repository and
+refuse with that stated, rather than failing on a database constraint. A refusal
+is a decision the caller can act on; a constraint violation is a stack trace.
+
+**Fixed and verified live (2026-08-26, `main-5e4d0be`).** `net-kingdom` now
+returns `refused` with reason *"derived identifier already belongs to another
+repository"*, naming `ADHOC-2026-08-23` and the holder.
+
+Acknowledging retirements deliberately does not authorise a collision: those are
+different decisions — one says the work is gone, the other says take an
+identifier another repository owns — and conflating them would let a routine
+acknowledgement carry an identity change through. Covered by test.
+
+Worth recording how nearly this was mis-reported. A first check run against the
+*cache* returned `refused` and was almost reported as proof; it had exercised the
+retirement path instead, because the cache does not hold the colliding record.
+The output looked like success while testing nothing of the sort.
+
+
+## Reset diff, clean (2026-08-26)
+
+After the frontmatter repairs (`T08`) and the type corrections, the diff proposes
+**no retirements at all**:
+
+| Repository | created | updated | would retire |
+|---|---|---|---|
+| `the-custodian` | 3 | 71 | **0** |
+| `activity-core` | 3 | 40 | **0** |
+| `phase-memory` | 0 | 18 | **0** |
+| `ground-game` | 0 | 9 | **0** |
+| `open-cmis-tck` | 0 | 3 | **0** |
+
+Every hub record in these repositories now derives from a file. `the-custodian`
+began this sequence proposing to retire four live workplans; it proposes none.
+
+Worth stating what changed and what did not. Nothing about the reset's logic was
+altered to reach this: the retirements disappeared because the *sources* were
+repaired — unterminated frontmatter, and types that made files invisible. The
+reset was reporting the truth about a fleet whose files could not be read.
+
+That is the argument for `T02` existing separately from `T03`. Had the reset
+applied on first run, it would have retired live work in at least five
+repositories, and every one of those retirements would have looked like tidy-up.
+
+## First fleet-wide pass (2026-08-26)
+
+121 repositories, refuse mode. The first measured answer to whether the hub
+matches the forge.
+
+| | |
+|---|---|
+| applied | 91 — 737 updated, 8 created |
+| refused | 16 repositories, **64 records** |
+| noop | 2 |
+| errored | 12 |
+
+**745 workplans now carry the commit they derived from.** `ADR-012` decision 2
+is satisfied for the first time: until today no record could name its source, and
+`git_fingerprint` had held the initial commit since the repository began. Zero
+records were retired and hub-native progress events were untouched, as intended.
+
+**64 is the real size of the stale-row problem** that `CUST-WP-0068-T09` has been
+waiting on — measured rather than estimated. `railiance-platform` (20),
+`vergabe-teilnahme` (16) and `railiance-apps` (8) hold more than two thirds.
+
+### Private repositories are invisible to central
+
+Eleven of the twelve errors are the same:
+
+```text
+fatal: could not read Username for 'https://forgejo.coulomb.social'
+```
+
+Those repositories are private, and the pod clones anonymously. `rapp-core-hub`,
+`rapp-issue-core`, `rapp-openbao`, `rapp-policy-nexus` and seven others cannot be
+derived at all.
+
+This is a genuine limit on `ADR-012` decision 1: *the forge is the projection
+source* holds only for repositories central can read. Until it has a deploy token
+or equivalent, a whole class of repositories can never be reset — and, worse,
+their absence looks like an error rather than a policy, so nothing distinguishes
+"cannot read" from "does not exist".
+
+### A second collision dimension
+
+`disaster-control` raised `IntegrityError: Key (slug)=(repo-wp-0001) already
+exists`. The identifier refusal added earlier checks `id`; `slug` carries its own
+unique constraint across the whole table, so two repositories can derive
+different identifiers whose slugs still collide. Now refused with the holder
+named, and covered by test.
+
+
+## Second fleet pass — idempotent (2026-08-26)
+
+Re-run after the slug-collision refusal deployed.
+
+| | first pass | second |
+|---|---|---|
+| applied | 91 | 0 |
+| **noop** | 2 | **93** |
+| refused | 16 repos / 64 | 19 repos / 69 |
+| errored | 12 | **9** |
+| created / updated / retired | 8 / 737 / 0 | **0 / 0 / 0** |
+
+**Idempotence demonstrated rather than asserted.** 93 repositories changed
+nothing on the second run: `ADR-012` decision 7 requires that reset twice
+produces the same projection, and it does.
+
+The slug fix helped more than predicted. Errors fell 12 → 9, not 12 → 11 — three
+repositories were erroring on slug collisions rather than only
+`disaster-control`. They now refuse with the holder named:
+
+| Refusal reason | Count |
+|---|---|
+| would be retired; the forge no longer derives it | 60 |
+| slug already belongs to another repository | 9 |
+
+**60 records across 13 repositories no longer derive from any file.** That is the
+retirement work `CUST-WP-0068-T09` waits on, now enumerated per repository:
+`railiance-platform` (20), `vergabe-teilnahme` (16), `railiance-apps` (8), then
+single figures elsewhere.
+
+All 9 remaining errors are private repositories the pod cannot clone
+anonymously — unchanged, and not a code problem.
+
+
+## T05 outcome — every hub record derives from a file (2026-08-26)
+
+| | |
+|---|---|
+| repositories | 121 |
+| noop | **106** |
+| refused | 6 — all identifier collisions, no retirements |
+| errored | 9 — private repositories |
+| **retired** | **51** |
+| progress events | 21522, untouched throughout |
+
+Zero repositories hold a record that no longer derives.
+
+**26 real workplans were rescued from wrongful retirement**, more than half the
+number actually retired:
+
+- `vergabe-teilnahme` (17) — a repository predating the convention entirely: no
+  `type:` field anywhere, bare `WP-NNNN` identifiers, no hub identifiers, no
+  registered prefix. The diff showed 16 records to retire; the truth was 17
+  workplans no projection could see.
+- `glas-harness` (3), `binky-control` (2), `rein-aharness` (2), `ops-mason` (1),
+  `rein-openweights` (1) — files carrying no `type:` field at all.
+
+Three of those nine were created *by this session's own renames*, which never
+added a type the files had never had. The pre-flight check — does the forge
+derivation actually see workplans in this repository — is the only reason they
+survived, and it has now caught wrongful retirement three times: `kont-wp-0015`,
+all of `vergabe-teilnahme`, and these nine.
+
+**A collision this session created.** Retiring `railiance-platform` first
+required repairing a fault introduced earlier the same day: the `RAILIANCE-WP`
+migration numbered from `RPF-WP-0001` without checking whether the target prefix
+was in use. It was, and the migration collided at 0018, 0019 and 0020. The fleet
+reset then ran over the colliding files and left mixed records on central —
+`rpf-wp-0018` carried one file's status and another's backing path. The
+displaced files moved to 0025-0027. The source numbering was checked before
+renaming; the target was not.
+
+**Remaining, and not solvable by retirement:** 9 private repositories central
+cannot clone, and 9 identifier collisions that are identity decisions.
diff --git a/workplans/STATE-WP-0084-forge-read-for-private-repositories.md b/workplans/STATE-WP-0084-forge-read-for-private-repositories.md
new file mode 100644
index 0000000..a966a73
--- /dev/null
+++ b/workplans/STATE-WP-0084-forge-read-for-private-repositories.md
@@ -0,0 +1,261 @@
+---
+id: STATE-WP-0084
+type: workplan
+title: "Derive private repositories, and report unreadable as unreadable"
+domain: infotech
+repo: state-hub
+status: finished
+owner: codex
+topic_slug: infotech
+created: "2026-08-26"
+updated: "2026-08-31"
+quality_dod: DoD-Ok
+quality_dod_at: "2026-08-31"
+quality_dod_by: codex
+quality_dod_note: >-
+  Credential delivery, safe consumer behavior, nine-repository reviewed apply,
+  and nine-noop repeat verification are evidenced without storing a secret.
+related:
+  - CUST-ADR-012
+  - STATE-WP-0083
+  - MASON-WP-0003
+state_hub_workstream_id: "9c4b8c79-edba-5d2d-ad37-a45707e89304"
+---
+
+# Derive private repositories, and report unreadable as unreadable
+
+## Goal
+
+Consume the forge read credential that `ops-mason/MASON-WP-0003` builds, so
+derivation covers private repositories — and make a repository central cannot
+read report as *unreadable* rather than as an error or, worse, as a repository
+whose records no longer derive.
+
+## Why this exists
+
+`STATE-WP-0083-T04` reset 121 repositories on 2026-08-26. Nine failed
+identically:
+
+```text
+fatal: could not read Username for 'https://forgejo.coulomb.social'
+```
+
+`rapp-core-hub`, `rapp-issue-core`, `rapp-openbao`, `rapp-policy-nexus` and five
+others are invisible to derivation entirely. `ADR-012`'s premise — the forge is
+the projection source — holds only for repositories central can read, and
+nothing in the current design says so.
+
+## Split from MASON-WP-0003
+
+The credential lane itself (OpenBao policy, AppRole, KV path, and the
+`warden route find` catalog entry) is `ops-mason`'s to build: that repository
+exists to build "AppRoles, policies, and KV secret paths so ops-warden always
+has something real to route to". Deployment plumbing and derivation code are
+this repository's.
+
+T01 does **not** depend on the credential and should land first. T02 and T03
+wait on `MASON-WP-0003-T02`.
+
+## Distinguish "cannot read" from "does not exist"
+
+```task
+id: STATE-WP-0084-T01
+status: done
+priority: high
+state_hub_task_id: "e955067d-2152-59f7-b672-12755ceb26b0"
+```
+
+A repository the hub is not permitted to read must be reported as unreadable —
+a named condition — not as a generic clone error and never as an empty
+derivation.
+
+Today the reset treats a failed clone as an error, which is correct only by
+accident: if a clone ever returned empty instead of failing, every record in
+that repository would be proposed for retirement. That is the failure that
+nearly retired `vergabe-teilnahme`, and it must be impossible here by
+construction rather than by luck.
+
+An empty clone result and an unreadable repository must both be incapable of
+producing retirement work. Retirement proposals require a *successful* read
+that positively lacks the record.
+
+This also carries the decision in `MASON-WP-0003-T01`: a per-repository grant
+is only safe to choose if a missing grant surfaces as a named condition. Until
+this lands, the narrow option fails silently.
+
+Acceptance: an unreadable repository is reported as unreadable; a clone that
+succeeds but returns nothing produces no retirement proposals; both cases are
+covered by tests that fail if the retirement path is reachable from either.
+
+**Done 2026-08-26.** `api/services/forge_projection.py`:
+
+- `ForgeUnreadableError` subclasses `ForgeDeriveError`, so existing callers
+  keep catching it while new ones can tell the cases apart. A permission-shaped
+  git failure is classified into it; a genuine fault stays a plain error.
+  Forgejo's 404 for an unauthenticated private repository classifies as
+  unreadable, because the two are indistinguishable at this layer and the safe
+  reading of an ambiguous answer is the one that cannot destroy a record.
+- `_run_git` runs with `GIT_TERMINAL_PROMPT=0`. Without it an unattended pass
+  blocks on a username prompt instead of failing, and an unreadable repository
+  is only observable if it fails.
+- `DerivedProjection.records_source_present` / `.retirement_eligible` separate
+  "no records found" from "no records exist". A checkout with no `workplans/`
+  directory can no longer evidence an absence.
+- `diff_against_hub` withholds `stale` rather than computing and filtering it,
+  and says so in `stale_withheld`. `would_remove` is 0 for such a source.
+- `reset_repository_projection` returns `status="unreadable"` for a repository
+  it may not read, and refuses retirement from an ineligible source **even when
+  `acknowledge_retirements=True`** — consenting to a conclusion is not the same
+  as the evidence for it existing.
+- `reset_fleet_projection` keeps unreadable repositories out of `errors`, in
+  their own bucket with its own count. Nine repositories in an error bucket
+  read as nine broken repositories; they were nine we were not allowed to read.
+
+13 tests in `TestUnreadableIsNotMissing` (`tests/test_forge_projection.py`);
+58 pass across the forge/projection/backfill suites.
+
+## Deliver the credential to the pod
+
+```task
+id: STATE-WP-0084-T02
+status: done
+priority: medium
+state_hub_task_id: "d8d41a89-1ebc-5118-bb73-cf8d8c114e16"
+```
+
+Blocked on `MASON-WP-0003-T02`.
+
+Make the credential available to the `state-hub` deployment as a Kubernetes
+Secret, mounted or injected, referenced by the chart the same way
+`state-hub-env` already is.
+
+It must not be baked into the image and must not be committed to the chart.
+Rotation must not require a chart change or a redeploy.
+
+Acceptance: the pod can read the credential; nothing in the repository contains
+it; rotating the token does not require a redeploy.
+
+**Chart landed 2026-08-27; awaits the minted token.** The cluster has no OpenBao
+agent injector and no secrets-store CSI driver — checked, not assumed — so
+there is nothing to inject with. The pod authenticates to OpenBao itself, which
+is what `MASON-WP-0003-T02`'s Kubernetes auth role was built for.
+
+- `templates/serviceaccount.yaml` creates ServiceAccount `state-hub`, and the
+  Deployment now sets `serviceAccountName`. The auth role binds to this name and
+  deliberately not to `default`, so until this ships the pod cannot authenticate
+  at all. **This changes the identity the running pod uses** — expect a pod
+  restart on upgrade.
+- The OpenBao token is a *projected* ServiceAccount token with audience
+  `openbao`, not the legacy auto-mounted one. The auto-mounted token's audience
+  is the API server, so a copy of it is a credential for the cluster; this one
+  is only accepted by OpenBao, and the kubelet rotates it in place.
+- `forgeRead.*` carries coordinates only — address, role, KV path, key. No
+  credential is a chart value, an image layer, or a Kubernetes Secret in this
+  release. Rotating the token in OpenBao needs no chart change and no redeploy:
+  the value is re-read every 5 minutes.
+- Default `forgeRead.enabled: false`. A hub without the credential still derives
+  every public repository, so this is added capability, not a prerequisite.
+
+Remaining before this is `done`: the minted read-only Forgejo token in the KV
+path (`paste_once_provision`, outside both repositories), and a deploy with
+`forgeRead.enabled=true` plus the real address and path in
+`deploy/railiance/apps/helm/state-hub-values.yaml`.
+
+**Done 2026-08-31.** The live `railliance01` release has
+`forgeRead.enabled: true`; the API pod runs as ServiceAccount `state-hub` with
+the projected OpenBao token and coordinate-only configuration. A non-secret
+in-pod resolution check returned `available`. The Forge token remains outside
+Git and is re-read through the five-minute cache, so rotation needs no chart
+change or pod redeploy.
+
+## Teach the derivation to use it
+
+```task
+id: STATE-WP-0084-T03
+status: done
+priority: medium
+state_hub_task_id: "b22b24d9-7ed3-533c-bda7-3130693cf4d2"
+```
+
+Blocked on T02.
+
+`derive_from_forge()` clones anonymously. It should use the credential when
+present and continue working without it — a hub with no token must still derive
+public repositories rather than failing wholesale.
+
+Credentials must never reach the clone URL in a way that lands in logs or
+process listings: use a credential helper or an HTTP header, not an embedded
+userinfo URL.
+
+Acceptance: private repositories derive; a hub without the credential still
+derives public ones; no credential appears in logs, process listings, or
+recorded clone URLs.
+
+**Code landed 2026-08-27**, ahead of T02 — writing the consumer does not need
+the secret to exist. `api/services/forge_projection.py`:
+
+- `forge_read_token()` reads `FORGE_READ_TOKEN_FILE` in preference to
+  `FORGE_READ_TOKEN`. A mounted file is what lets T02 satisfy "rotation must
+  not require a redeploy"; the environment cannot be rotated in place. An
+  unreadable token *file* returns `None` rather than falling back to the
+  environment — falling back would let a broken mount look like success while
+  quietly using a stale value.
+- Absent is a supported state, not a degraded one: with no credential the git
+  environment is untouched and public derivation runs exactly as before.
+- The credential is passed as `GIT_CONFIG_COUNT`/`GIT_CONFIG_KEY_0`/
+  `GIT_CONFIG_VALUE_0` setting `http.extraHeader`, not as `-c` on the command
+  line and not as userinfo in the URL. Both alternatives put the token in the
+  process listing, where anything that can run `ps` reads it.
+- `_run_git` redacts the token from `ForgeDeriveError` before raising, because
+  that message is logged, stored in a reset outcome, and returned over the API.
+- `api/services/forge_credential.py` resolves the credential from a mounted
+  file, an environment variable, or OpenBao via Kubernetes auth, in that order.
+  Production uses the third; the first two make the code runnable and testable
+  outside the cluster. Configuring a file means *that* file and nothing else —
+  no fall-through, so a broken mount cannot silently resolve to a stale value.
+- Every failure resolves to `None`, never an exception: no configuration, no
+  network, OpenBao down, permission denied. Raising would convert "nine
+  repositories are unreadable" into "the whole pass failed", which is the
+  outcome T01 exists to prevent.
+- The resolved value is cached for 5 minutes — a fleet reset of 121
+  repositories must not authenticate 121 times, and a rotated token must still
+  be picked up without a redeploy.
+
+Nine tests in `TestForgeCredential` cover each of those, including the two that
+are silent when wrong: token-in-argv and token-in-exception. 43 pass in
+`tests/test_forge_projection.py`; 717 pass across the suite.
+
+Remains `progress` because the acceptance clause "private repositories derive"
+cannot be observed until T02 supplies a credential; T04 confirms it.
+
+**Done 2026-08-31.** A transaction-rolled-back review successfully derived all
+nine private `rapp-*` repositories at exact Forge commits. No repository was
+unreadable or errored, and no retirement was proposed. The anonymous/public
+path remains covered by the existing absent-credential tests.
+
+## Confirm the nine
+
+```task
+id: STATE-WP-0084-T04
+status: done
+priority: medium
+state_hub_task_id: "33c09a78-5974-57c6-bb7f-ad73082046bb"
+```
+
+Blocked on T03.
+
+Re-run the fleet reset and confirm the nine repositories derive rather than
+error. Expect a real diff for each — quite possibly a large one, since none has
+ever been reconciled against its files.
+
+Treat the first diff for each as review material, not as work to apply. Every
+repository examined this way for the first time has produced findings.
+
+Acceptance: fleet errors fall from nine to zero; each newly readable repository
+has its first diff reviewed before anything is applied.
+
+**Done 2026-08-31.** The first review returned seven bounded source/status
+updates and two no-ops, with zero creations, retirements, refusals, or errors.
+Those exact commits were applied through the guarded per-repository API with
+retirement disabled. The repeated review returned nine no-ops and zero errors.
+Evidence: `docs/evidence/STATE-WP-0084-private-forge-cutover-2026-08-31.md`.
diff --git a/workplans/STATE-WP-0085-repository-lineage-preserving-rename.md b/workplans/STATE-WP-0085-repository-lineage-preserving-rename.md
new file mode 100644
index 0000000..03907af
--- /dev/null
+++ b/workplans/STATE-WP-0085-repository-lineage-preserving-rename.md
@@ -0,0 +1,653 @@
+---
+id: STATE-WP-0085
+type: workplan
+title: "Lineage-preserving repository rename workflow and adoption-plan generator"
+domain: infotech
+repo: state-hub
+status: finished
+owner: codex
+topic_slug: infotech
+created: "2026-08-28"
+updated: "2026-08-31"
+reviewed_at: "2026-08-28"
+reviewed_by: codex
+reviewed_against_commit: "41d80429a77ffeb640f4b34091ebee5c91585373"
+quality_dor: DoR-Ok
+quality_dor_at: "2026-08-28"
+quality_dor_by: codex
+quality_dod: DoD-Ok
+quality_dod_at: "2026-08-31"
+quality_dod_by: codex
+quality_dod_note: >-
+  The generic capability, recovery contract, operator documentation, and
+  target-workplan generator are tested and deployed. FLEX-WP-0020 is committed,
+  pushed, registered, DoR-Ok, and retains the signing and human approval gates
+  for the deliberately out-of-scope live rename.
+related:
+  - CUST-ADR-012
+  - STATE-WP-0083
+  - STATE-WP-0084
+state_hub_workstream_id: "4f5661de-5922-55d6-bd02-5dcb00b13f73"
+---
+
+# Lineage-preserving repository rename workflow and adoption-plan generator
+
+## Goal
+
+Make a repository rename a governed identity migration instead of an
+archive-and-register operation. State Hub must preserve the repository UUID,
+workplan and task identities, progress, decisions, telemetry, SBOM history, and
+coordination history while the canonical Forgejo name, clone URL, and local
+paths change.
+
+The capability must also generate a repository-native migration workplan that
+the repository being renamed can adopt. `flex-auth` to `access-engine` is the
+first intended adoption, but the implementation and template must be generic.
+
+## Why this exists
+
+Repository names are currently used as both mutable labels and identity keys.
+The durable relationships are already mostly correct: workplans and token
+events point to `managed_repos.id`. The public repository API, file bindings,
+message routing, interface-change affected lists, identifier-alias provenance,
+fabric projections, local paths, and forge URLs still contain slug-shaped
+references.
+
+State Hub has no supported repository rename operation. Registering
+`access-engine` as a new repository would split the history of Forgejo
+repository id `42` and State Hub repository id
+`fda8ad85-a7d7-4055-8f21-902a533e59df`. Updating the database row manually
+would preserve some foreign keys but leave slug-only surfaces, retries, and
+failure recovery undefined.
+
+`flex-auth` is part of the NetKingdom security stack. Its repository identity,
+container publishing, deployment references, policy consumers, credentials,
+fabric declarations, and State Hub routing cannot be cut over safely as an
+unrecorded sequence of shell commands.
+
+## Invariants
+
+Every implementation and generated migration plan must preserve these facts:
+
+1. A rename does not create a second `managed_repos` row.
+2. The State Hub repository UUID is unchanged.
+3. The Forgejo repository numeric ID and selected source commit are unchanged.
+4. Existing workplan IDs, task IDs, hub UUIDs, progress events, decisions, and
+   token events are unchanged.
+5. Existing work-record prefixes and filenames are not re-keyed merely because
+   the repository slug changes.
+6. The old slug remains a durable alias. Historical records are not mass
+   rewritten to pretend the old name never existed.
+7. Every phase is idempotent and resumable. A retry reports the achieved phase
+   rather than applying a second rename.
+8. No old clone, alias, route, or rollback input is removed before verification
+   succeeds and the target repository's migration workplan authorises cleanup.
+9. Forge redirects are compatibility evidence, not a substitute for updating
+   canonical remotes and consumers.
+10. An unreadable forge repository, changed repository ID, changed head, slug
+    conflict, or incomplete projection stops before mutation.
+
+## Scope
+
+### In scope
+
+- Durable forge identity and repository-slug aliases in State Hub.
+- A preflight, apply, verify, resume, and rollback contract.
+- Alias-aware lookup and routing for State Hub-owned surfaces.
+- CLI/API surfaces suitable for later HelixForge orchestration.
+- A generator for a target-repository rename workplan.
+- Operator documentation, events, metrics, and failure evidence.
+- A non-mutating `flex-auth` to `access-engine` rehearsal and generated
+  repository workplan as the first adoption handoff.
+
+### Out of scope
+
+- Executing the live `flex-auth` Forgejo rename in this State Hub workplan.
+- Deciding whether the product binary, Go module, `FLEX_AUTH_*` environment
+  variables, Kubernetes namespace, Helm releases, service DNS names, container
+  package, or policy vocabulary also become `access-engine`. The generated
+  target workplan must make those explicit decisions.
+- Rewriting historical prose, audit records, message bodies, or raw telemetry.
+- A general Forgejo repository transfer between owners. The model may leave
+  room for transfer, but owner transfer requires a separate reviewed contract.
+- Direct secret retrieval or embedding a Forgejo credential in State Hub
+  records, logs, templates, or command arguments.
+
+## Ownership and execution boundary
+
+- **State Hub** owns repository identity, aliases, work-record continuity,
+  routing compatibility, audit evidence, and verification.
+- **Forgejo** remains authoritative for the Git repository and its immutable
+  repository ID.
+- **HelixForge orchestration** may later coordinate the Forgejo operation,
+  State Hub phase transitions, and local-clone registration through the
+  contracts delivered here. It must not bypass them with database writes.
+- **The target repository** owns the generated migration workplan, consumer and
+  deployment consequences, execution evidence, and final cleanup decision.
+
+Capability implementation is Yellow-lane work. A live forge rename, canonical
+route switch, old-alias retirement, or old-checkout removal is Red-lane work and
+requires an explicit operator confirmation recorded by the target workplan.
+
+## Target lifecycle
+
+```text
+draft
+  -> preflighted
+  -> forge-renamed
+  -> statehub-rebound
+  -> source-synced
+  -> consumers-verified
+  -> completed
+
+Any achieved phase
+  -> retry same phase safely
+  -> rollback-preflight
+  -> rolled-back (when the old forge slug is still available)
+```
+
+The operation record reports incomplete phases as recoverable state. It must
+never collapse "Forgejo renamed, State Hub not rebound" into a generic error
+that leaves the operator guessing which action already happened.
+
+## Define the identity and failure contract
+
+```task
+id: STATE-WP-0085-T01
+status: done
+priority: high
+state_hub_task_id: "dbac0fdf-042e-51bf-937e-59d15e34cb14"
+```
+
+Record the architecture decision for mutable repository coordinates over an
+immutable repository identity. Define:
+
+- State Hub repository UUID versus canonical slug and aliases;
+- Forgejo provider, owner, immutable repository ID, canonical name, and URL;
+- expected source commit and default branch at preflight;
+- phase transitions, retry semantics, and rollback limits;
+- which slug-shaped fields are mutable projections, immutable historical
+  evidence, external-source projections, or live routing keys;
+- the boundary between a repository rename and a product/runtime rename.
+
+Inventory every State Hub model, API, CLI, event, dashboard query, edge outbox
+shape, and external projection that carries a repository slug. Classify each as
+foreign-key anchored, alias-resolved, reprojected, historically retained, or
+requiring a target-repo handoff.
+
+Acceptance:
+
+- the ADR contains the invariant and failure-state tables;
+- every current slug-bearing surface has one named treatment and owner;
+- an operation interrupted after each phase has a documented safe next action;
+- owner transfer and product/runtime rename are explicitly outside this
+  contract rather than silently half-supported.
+
+Result (2026-08-28): accepted `STATE-ADR-001` in
+`docs/adr/ADR-001-repository-rename-identity-contract.md`. It defines immutable
+State Hub and Forge identities, protected slug aliases, compare-and-set phase
+semantics, retry and rollback limits, twelve named failure states, recovery from
+every phase, and the treatment/owner inventory for persistence, REST, CLI, MCP,
+consistency projections, dashboard queries, events, edge relay state, Forgejo,
+local clones, and external consumers. Owner transfer and product/runtime rename
+are explicit target-workplan boundaries.
+
+## Add durable forge identity, aliases, and rename operations
+
+```task
+id: STATE-WP-0085-T02
+status: done
+priority: high
+state_hub_task_id: "c9e6c8c5-c254-5f4d-982c-c161f6ed6d29"
+```
+
+Add the persistence needed to distinguish a repository from its current name.
+The exact normalization may be decided in T01, but it must represent:
+
+- a forge provider/instance, owner, and immutable repository ID attached to the
+  existing managed repository;
+- one canonical slug plus durable prior-slug aliases;
+- a rename operation with old/new coordinates, expected repository IDs and
+  commits, current phase, actor, timestamps, evidence, and error state;
+- uniqueness rules preventing one live slug or forge identity from resolving
+  to two repository UUIDs.
+
+Backfill must be non-destructive. Repositories whose forge identity cannot be
+proven remain unverified and cannot be renamed; absence is not guessed from the
+slug or initial Git commit.
+
+Acceptance:
+
+- migration upgrade and downgrade tests pass;
+- the same old slug cannot be claimed by a different live repository while it
+  is a protected alias;
+- `flex-auth` can be preflighted as State Hub UUID
+  `fda8ad85-a7d7-4055-8f21-902a533e59df` and Forgejo repository ID `42` without
+  changing either system;
+- no migration rewrites workplan, task, progress, decision, token, or SBOM
+  identities.
+
+Result (2026-08-28): migration `f3c4d5e6a7b8` adds an explicitly unverified or
+verified Forge identity per managed-repository UUID, a global canonical/alias
+slug registry, and a phased rename-operation journal. Composite foreign keys
+prevent operations for unverified or mismatched repository identities; partial
+unique indexes reserve one canonical slug, one active operation per repository,
+and one active target slug. Database history guards prevent verified Forge
+identity, protected slug, and operation-assertion rewrites or deletion while
+leaving phase/evidence/error progress updateable. Existing repositories are
+backfilled only with an unverified marker and their current canonical slug;
+Forge coordinates are not guessed. Both API and direct classification
+registration create the same initial records. PostgreSQL tests prove protected
+alias conflicts, unique Forge identity, active-operation locks, a non-mutating
+`flex-auth`/Forgejo-id-42 preflight representation with all existing identities
+preserved, isolated migration upgrade/downgrade, and full-chain migration. The
+full Python suite passes (765 tests).
+
+## Implement preflight, apply, resume, verify, and rollback APIs
+
+```task
+id: STATE-WP-0085-T03
+status: done
+priority: high
+state_hub_task_id: "2cb4d7ac-0192-5d46-aa87-7412e99b0cef"
+```
+
+Provide repository-ID-addressed APIs for the lifecycle. Slug-addressed
+convenience routes may resolve through aliases, but the mutating operation must
+bind to the stable repository UUID and expected Forgejo ID.
+
+Preflight reports, without mutation:
+
+- current State Hub and Forgejo identity;
+- old/new slug availability;
+- local and registered host paths;
+- source commit and projection readability;
+- workplan/task/telemetry baselines and active work;
+- affected messages, bindings, interface changes, SBOM data, services,
+  capability entries, fabric nodes, and external handoffs;
+- queued edge writes or active operations that make cutover unsafe;
+- exact proposed mutations and retained historical values.
+
+Apply performs only the requested phase and uses compare-and-set expectations.
+Verify compares immutable IDs, commits, counts, relationship checksums, routes,
+and projection results. Rollback first proves the old slug is available and
+reports what cannot be reversed automatically.
+
+Acceptance:
+
+- dry-run is byte-for-byte free of persistent changes;
+- mutation requires a successful, unexpired preflight token or equivalent
+  compare-and-set evidence plus explicit confirmation;
+- repeating any completed phase is a no-op with the same operation ID;
+- conflicting slug, wrong Forgejo ID, moved head, unreadable forge, or stale
+  preflight fails closed;
+- API tests interrupt and resume after every phase;
+- the managed-repository UUID is asserted unchanged throughout.
+
+Implemented 2026-08-29. UUID-addressed endpoints now verify immutable Forgejo
+identity, produce HMAC-signed non-mutating preflights, create discoverable
+operation journals, apply one compare-and-set phase at a time, verify baseline
+identity continuity, and preflight/apply bounded rollback. The Forge adapter
+uses authenticated absence proofs and a separate rename credential; API tests
+replace it with an in-memory boundary and cannot touch live Forgejo. Resume
+recognizes a Forge rename that committed before its journal phase, completed
+phase replays are no-ops with the same operation UUID, and rollback recognizes
+the corresponding unrecorded-Forge state. Baseline IDs must remain present
+while append-only telemetry may grow during the operation. The follow-on
+migration permits a protected alias to become canonical only for its own
+operation in `rollback-preflight`; all other alias mutation remains rejected.
+Tests cover dry-run persistence, expiry and confirmation, occupied slugs,
+queued edge writes, wrong Forge ID, moved head/stale evidence, unreadable Forge,
+phase interruption/replay, telemetry append continuity, rollback, trigger
+guarding, and full migration upgrade/downgrade. The full Python suite passes
+(771 tests).
+
+## Make State Hub reads and routing alias-aware
+
+```task
+id: STATE-WP-0085-T04
+status: done
+priority: high
+state_hub_task_id: "dcf7102e-ed7a-503e-bf78-db2149f72453"
+```
+
+Resolve prior slugs to the canonical repository identity without falsifying
+history. At minimum cover:
+
+- repository lookup and dispatch;
+- consistency registration and workplan file bindings;
+- inbox reads and new-message routing;
+- interface-change affected-repository queries;
+- work-record identifier aliases;
+- repository goals, capabilities, services, SBOM, and token summaries;
+- dashboard and state-summary links;
+- edge cache/outbox replay produced before or during cutover.
+
+Historical messages keep their recorded sender and recipient. Queries through
+the canonical slug include aliased history, and new messages use the canonical
+slug. External-source projections such as `railiance-fabric` are reported as
+handoffs and remain visibly stale until their owning source is updated and
+reingested.
+
+Acceptance:
+
+- old and new slugs resolve to one repository UUID with canonical/alias status
+  visible in the response;
+- old-slug history is visible from the new repository without rewriting stored
+  history;
+- a queued old-slug write replays exactly once against the same repository;
+- new bindings use the new slug while workplan and task UUIDs remain unchanged;
+- external stale references are named rather than silently rewritten.
+
+Implemented one protected-slug resolver and applied it across repository reads,
+dispatch, consistency/path binding, inbox routing, interface changes,
+work-record identifier migration, goals, capability and service catalogs, SBOM,
+token summaries, Fabric projection reads, and dashboard links. Repository
+responses expose requested/canonical slug, canonical-or-alias status, aliases,
+and named stale external projections. Historical message and interface values
+remain unchanged; new writes are canonicalized. An idempotent old-slug message
+replay is proven to persist once, while workplan/task UUIDs and repository FKs
+remain stable. Verification: 775 Python tests and the 70-page dashboard build
+pass (the build retains one pre-existing `/docs/intakes` broken-link warning).
+
+## Add the State Hub CLI and HelixForge orchestration contract
+
+```task
+id: STATE-WP-0085-T05
+status: done
+priority: high
+state_hub_task_id: "d85da2ea-8037-5117-a41a-d400ca68bf10"
+```
+
+Expose a non-interactive, machine-readable CLI over the API lifecycle. The
+final spelling follows existing State Hub CLI conventions; it must provide the
+equivalent of:
+
+```text
+statehub repo rename preflight <old> <new> --json
+statehub repo rename apply <operation-id> --phase <phase> --confirm
+statehub repo rename status <operation-id> --json
+statehub repo rename verify <operation-id> --json
+statehub repo rename rollback <operation-id> --confirm
+```
+
+The contract must make it possible for HelixForge to coordinate the Forgejo
+rename without receiving database access. Forgejo credentials follow the
+credential-routing catalog and must never be accepted as a command-line value
+that can appear in process listings.
+
+Acceptance:
+
+- JSON output is stable enough for orchestration and names the next safe action;
+- human output distinguishes planned, achieved, failed, and rolled-back phases;
+- every mutating command requires an operation ID and explicit confirmation;
+- CLI retries preserve operation identity;
+- no command logs credentials, authorization headers, or secret-bearing URLs.
+
+Result (2026-08-29): added `statehub repo rename`
+`preflight`/`start`/`apply`/`status`/`verify`/`rollback` commands over the
+repository-ID-addressed lifecycle. The versioned
+`state-hub.repository-rename-cli.v1` JSON envelope reports lifecycle state and
+the next safe command; human output distinguishes planned, achieved, failed,
+and rolled-back operations. Preflight tokens are never printed and are passed
+to `start` through an exclusive mode-0600 JSON file (or stdin). Evidence and
+check inputs receive the same private-file guard, credential-bearing response
+fields and URLs are redacted, and no Forgejo credential option exists.
+Mutations require a client-owned operation UUID plus the exact rename or
+rollback confirmation. State Hub accepts and globally resolves that UUID;
+same-intent creation retries remain no-ops after token expiry or a canonical
+slug rebind, while changed target/actor intent fails closed. Rollback preflight
+and execution are deliberately separate. Wheel force-includes make the
+declared `statehub` entry point installable outside the checkout. Verification:
+789 repository tests and the 70-page dashboard build passed before the final
+retry hardening; the resulting focused suites pass 14 CLI and 7 API tests, and
+a clean wheel installation exposes the complete rename command tree. The
+dashboard retains the pre-existing `/docs/intakes` broken-link warning.
+
+## Generate a target-repository migration workplan
+
+```task
+id: STATE-WP-0085-T06
+status: done
+priority: high
+state_hub_task_id: "154bdbb3-d3bf-5bac-85d7-eecd88545841"
+```
+
+Add a generator that inspects a registered repository and produces, without
+overwriting an existing file, a repository-native workplan for adopting a new
+name. It must use the established workplan prefix from the repository rather
+than deriving a new prefix from the proposed slug.
+
+The generated plan must contain ordered tasks and gates for:
+
+1. local/forge cleanliness and immutable baseline capture;
+2. repository metadata and workplan-frontmatter preparation;
+3. explicit product/runtime naming decisions;
+4. consumer, CI, package, deployment, credential-routing, fabric, SBOM, and
+   documentation inventory;
+5. State Hub preflight and approval evidence;
+6. Forgejo rename;
+7. State Hub identity rebind;
+8. fresh-clone registration and `fix-consistency`;
+9. identity, work-record, telemetry, route, build, and deployment verification;
+10. rollback decision points and commands;
+11. soak period, residual handoffs, and final old-checkout cleanup.
+
+The template marks external tasks with their owning repository and never
+claims that the target repo can close another repo's work. It starts the live
+rename task in `wait` pending human approval.
+
+Acceptance:
+
+- generation is deterministic for the same preflight snapshot;
+- the output passes workplan parsing and DoR/quality-debt checks;
+- existing State Hub UUID fields are preserved when present and never invented;
+- an existing output path is refused unless an explicit safe overwrite mode is
+  separately designed;
+- generated `flex-auth` plan keeps the `FLEX-WP-` prefix and includes every
+  NetKingdom security-stack risk named in the preflight;
+- template snapshot tests cover repositories with active work, archived
+  workplans, missing local paths, private forge visibility, and old aliases.
+
+Result (2026-08-29): added `statehub repo rename generate-workplan <old>
+<new>` with a pure deterministic renderer over the registered repository,
+captured rename preflight, indexed workplans, and visible repository metadata.
+Prefix discovery uses the repository's declared convention when present and
+otherwise requires one unambiguous prefix across active and archived workplan
+records; it never derives a prefix from the proposed slug. Number allocation
+includes archived records, so the fixed flex-auth snapshot selects
+`FLEX-WP-0019` while retaining `FLEX-WP-` task/work-record identity.
+
+The generated ready/proposed plan carries DoR evidence and eleven ordered
+tasks for baseline capture, metadata preparation, separate product/runtime
+naming decisions, consumer/CI/package/deployment/credential/fabric/SBOM/docs
+inventory, renewed preflight and approval, Forgejo rename, State Hub rebind,
+fresh-clone registration, relationship-aware verification, rollback, soak,
+residuals, and old-checkout cleanup. Live rename and destructive cleanup tasks
+start in `wait`. Every captured blocker, warning, active work item, alias, and
+external handoff is rendered; an ownership ledger requires exact repository
+slugs and prohibits the target plan from closing another repository's work.
+Tokens are omitted. Existing UUID-bearing files remain untouched, and no new
+`state_hub_workstream_id` or `state_hub_task_id` is invented.
+
+Output uses exclusive create with no overwrite/force mode; private preflight
+files retain the mode-0600 input guard. Missing checkouts can render from
+indexed records only with an explicit output path and remain visibly blocked
+for baseline capture. Snapshot/parser/quality tests cover deterministic
+flex-auth output, active work, archived numbering, missing paths, unreadable
+private Forge state, old aliases, ambiguous prefixes, UUID preservation, and
+overwrite refusal. Verification: 801 Python tests and the 70-page dashboard
+build pass; a clean wheel installation exposes the generator command. The
+dashboard retains the pre-existing `/docs/intakes` broken-link warning.
+
+## Prove failure recovery and telemetry continuity
+
+```task
+id: STATE-WP-0085-T07
+status: done
+priority: high
+state_hub_task_id: "5160ad75-d985-5559-895c-7f8012ea76bc"
+```
+
+Build the test and evidence matrix before a live adoption. Include injected
+failure after each lifecycle phase, stale preflight, double submission,
+conflicting rename, forge redirect, unavailable old slug for rollback,
+State Hub outage, edge-outbox replay, unreadable private repository, and a
+fresh clone whose remote points at the wrong repository ID.
+
+Compare before/after baselines for repository UUID, workplans, tasks, progress,
+decisions, token events and totals, SBOM snapshots, active dispatch, aliases,
+messages, and file bindings. Evidence must distinguish a preserved count from
+a preserved relationship: equal row counts with records attached to a new UUID
+is a failure.
+
+Acceptance:
+
+- automated tests prove safe resume after every injected interruption;
+- work-record and telemetry relationship checksums are unchanged;
+- old-slug reads remain available through the alias;
+- verification fails if a record is detached and recreated even when aggregate
+  counts match;
+- rename events and operational metrics expose phase duration, retries,
+  failures, rollback, and verification outcome without secrets.
+
+Result (2026-08-29): continuity baselines now retain immutable relationship
+tuples and checksums for repository identity, workplans, tasks, progress,
+decisions, token events and totals, SBOM, active dispatch, protected routes,
+historical messages, and file bindings. Verification compares every original
+relationship while permitting append-only history, and phase-aware route checks
+prove the old slug remains an alias. Equal-count workplan/token replacements
+attached to another repository are rejected. Fresh-clone evidence must attest
+the expected Forge numeric ID and baseline head; Forge redirects are rejected
+as the wrong coordinate. The operation journal records phase durations,
+attempts, retries, failures by phase, rollback attempts/outcome, and verification
+outcome. Credential-free phase/failure/verification/rollback/completion events
+reference the durable journal without publishing tokens, operator evidence,
+URLs, or error details. Automated coverage injects failure after every forward
+phase and covers stale evidence, duplicate/conflicting requests, redirects,
+rollback route loss and recovery, State Hub outage, edge replay, unreadable
+Forge state, and wrong-clone identity. Evidence matrix:
+`docs/evidence/STATE-WP-0085-T07-repository-rename-recovery-matrix.md`.
+Verification: 810 Python tests and the 70-page dashboard build pass. One known
+dashboard `/docs/intakes` to `/suggestions` broken-link warning and one existing
+SQLAlchemy async cancellation warning remain outside this task.
+
+## Document operations and repository-boundary handoffs
+
+```task
+id: STATE-WP-0085-T08
+status: done
+priority: medium
+state_hub_task_id: "06b6cde4-0428-5467-b2db-d957fde3d8e9"
+```
+
+Document the operator workflow, API/CLI contract, dashboard interpretation,
+recovery playbook, and target-repository template. Include separate checklists
+for repository-only rename and broader product/runtime rename.
+
+Define the handoff format for slug-bearing external sources. A handoff names
+the source repository, old/new slug, affected paths or graph IDs, required
+reingest/verification, owning workplan/task, and non-secret evidence. It does
+not mutate another repository or park the obligation only in prose.
+
+Acceptance:
+
+- an operator can determine the achieved phase and next safe command without
+  reading source code;
+- the runbook says which cleanup is deliberately last and why;
+- rollback limitations and irreversible external effects are explicit;
+- State Hub/Forgejo/HelixForge/target-repository ownership is unambiguous;
+- examples use placeholder credentials and never secret values.
+
+Result (2026-08-29): Delivered the operator runbook in
+`docs/repository-rename-operations.md`, the dashboard reference in
+`dashboard/src/docs/repository-renames.md`, and the versioned
+`state-hub.repository-rename-handoff.v1` schema plus placeholder-only example.
+The generated target workplan now requires owner-backed handoff records and
+exact fresh-clone/Forge-ID/head evidence before continuity completion. Focused
+contract tests pass (29), as do all 813 Python tests and the 71-page dashboard
+build. The existing `/docs/intakes` to `/suggestions` broken-link warning and
+one existing async cancellation warning remain outside T08.
+
+## Generate and review the flex-auth adoption plan
+
+```task
+id: STATE-WP-0085-T09
+status: done
+priority: high
+state_hub_task_id: "df34f6ec-d137-52d0-93c4-3756a821097f"
+```
+
+Blocked on T01-T08 and deployment of the capability.
+
+Run the completed generator for `flex-auth` to `access-engine`, commit the
+resulting `FLEX-WP-*` file in the target repository, and synchronize it into
+State Hub before any live rename. Review it against the current Forgejo head,
+State Hub baselines, active `FLEX-WP-0017`, NetKingdom security-stack
+deployments, consumer repositories, fabric records, CI/image publishing, and
+credential routes.
+
+This task ends at an approved, repository-owned migration plan. The live
+Forgejo rename and security-stack migration execute under that generated plan,
+not under `STATE-WP-0085`.
+
+Acceptance:
+
+- the generated workplan is committed and has its own State Hub workplan UUID;
+- it records DoR assessment and an explicit human gate for the live rename;
+- preflight proves local and Forgejo commits match and captures Forgejo
+  repository ID `42` plus the existing State Hub repository UUID;
+- rollback and "do not remove the old checkout yet" gates are actionable;
+- every external consequence has a live work record or a named verification
+  owner;
+- no State Hub, Forgejo, local-clone, deployment, or consumer mutation has been
+  performed merely to generate the plan.
+
+Progress (2026-08-29): Promoted the completed rename API as immutable image
+`main-9f0a104` (Helm revision 49) and verified API/MCP rollout health. Verified
+the existing `flex-auth` Forge identity through the supported API: State Hub
+UUID `fda8ad85-a7d7-4055-8f21-902a533e59df`, Forge repository ID `42`, branch
+`main`, and local/origin/Forge head
+`7d7b4531d15a2dde7aaa28b9360a13e77b28b2a9` matched. Generated, estate-reviewed,
+committed, and registered proposed plan `FLEX-WP-0020` / State Hub UUID
+`99a661a8-b36c-5c1c-b78b-1e8930bcd0a9` (`flex-auth` commits `8d61ac9` and
+`8ea8644`). The plan is deliberately repository-only, names every reviewed
+verification owner, retains runtime/product `flex-auth` surfaces, and preserves
+the human cutover gate. At that point T09 was held because live preflight
+correctly reported `preflight_signing_unavailable`; provisioning was handed to
+`railiance-platform` in message `cd52ba10-de41-46ce-aa8b-9b44050da8f7`. No
+Forgejo rename, State Hub rebind, clone removal, consumer edit, or runtime
+deployment was performed.
+
+**Gate rechecked 2026-08-31.** `FLEX-WP-0020` remains clean, pushed,
+registered, `proposed`, and DoR-Ok. The deployed State Hub still has no
+repository-rename preflight signing configuration, and platform handoff
+`cd52ba10-de41-46ce-aa8b-9b44050da8f7` remains unread. This is an external
+provisioning gate for the later live cutover, so the task was held at `wait`
+while its completion boundary was checked. No rename or consumer mutation was
+performed.
+
+**Completed 2026-08-31.** T09 ends at the reviewed repository-owned adoption
+plan, not at an executable live-rename token. `FLEX-WP-0020` is clean and
+pushed at `8ea8644`, registered as State Hub workplan
+`99a661a8-b36c-5c1c-b78b-1e8930bcd0a9`, and records DoR-Ok plus the explicit
+human cutover gate. Its captured preflight proves the existing State Hub UUID,
+Forge repository ID `42`, and matching local/origin/Forge source commit. The
+missing signing configuration remains a fail-closed prerequisite of
+`FLEX-WP-0020-T05` and the platform handoff above; it is not a prerequisite for
+generating or reviewing the plan. Moving it into this workplan's completion
+gate would incorrectly make an out-of-scope live-rename prerequisite part of
+the generator delivery. No State Hub, Forgejo, checkout, deployment, or
+consumer mutation was performed during closeout.
+
+## Workplan completion
+
+`STATE-WP-0085` can finish only when T01-T08 are complete, T09 has produced the
+reviewed repository-owned adoption plan, all implementation tests pass, and the
+State Hub capability is deployed where the live migration will call it.
+
+Any remaining product rename, external consumer change, deployment cutover, or
+soak obligation must exist as a live record in its owning repository before
+this workplan is marked `finished`. The successful `flex-auth` to
+`access-engine` live cutover is deliberately not a completion criterion here;
+it is the outcome of the generated target-repository workplan.
diff --git a/workplans/STATE-WP-0086-fast-forge-projection-reconcile.md b/workplans/STATE-WP-0086-fast-forge-projection-reconcile.md
new file mode 100644
index 0000000..6207c29
--- /dev/null
+++ b/workplans/STATE-WP-0086-fast-forge-projection-reconcile.md
@@ -0,0 +1,69 @@
+---
+id: STATE-WP-0086
+type: workplan
+title: "Fast single-repository forge projection reconciliation"
+domain: infotech
+repo: state-hub
+status: finished
+owner: codex
+topic_slug: infotech
+created: "2026-08-30"
+updated: "2026-08-30"
+related:
+  - STATE-WP-0083
+  - RMGR-WP-0005
+  - RMGR-WP-0012
+state_hub_workstream_id: "c43b1b2c-2f84-540a-9b93-03a13ed148f1"
+---
+
+# Fast single-repository forge projection reconciliation
+
+## Goal
+
+Expose the existing forge-derived repository reset as a guarded, idempotent,
+single-request compatibility API. The central hub reads the exact pushed forge
+commit itself and applies workplan/task changes in one database transaction.
+
+## Guarded exact-commit API
+
+```task
+id: STATE-WP-0086-T01
+status: done
+priority: high
+state_hub_task_id: "1b72b4e2-419a-5b55-91a7-3f56afba7480"
+```
+
+Add a primary-only endpoint that derives one repository from Forgejo, compares
+the derived commit with the caller's expected commit, and commits or rolls back
+the complete repository reconciliation atomically.
+
+## Complete task and workplan field projection
+
+```task
+id: STATE-WP-0086-T02
+status: done
+priority: high
+state_hub_task_id: "25e1a146-47b2-5704-af45-b314c5a5a353"
+```
+
+Carry owner, priority, description, blocking, and human-intervention fields
+through the existing forge derivation and update path without weakening its
+collision, unreadable-source, or retirement safeguards.
+
+## Idempotency, regression, and performance proof
+
+```task
+id: STATE-WP-0086-T03
+status: done
+priority: high
+state_hub_task_id: "88723069-59d4-5b7e-85a4-36c3575382af"
+```
+
+Test wrong-instance rejection, commit mismatch, replay, transactional rollback,
+ad-hoc creation, task updates, and bounded request count. Document the endpoint
+as the fast path while retaining the full consistency checker for deep audits.
+
+Focused projection tests are green, including idempotent replay and exact-commit
+refusal. Helm revision 50 deployed `main-34f5cb3`; the live primary reconciled
+exact commit `b97cfbb2b123f101729556288a638a8e5dd271e3` in two requests and
+6242.4 ms, updating 54 workplans and 68 tasks with no retirement or refusal.
diff --git a/workplans/STATE-WP-0087-bounded-repository-collection-projection.md b/workplans/STATE-WP-0087-bounded-repository-collection-projection.md
new file mode 100644
index 0000000..26b721d
--- /dev/null
+++ b/workplans/STATE-WP-0087-bounded-repository-collection-projection.md
@@ -0,0 +1,93 @@
+---
+id: STATE-WP-0087
+type: workplan
+title: "Bound the repository collection projection"
+domain: infotech
+repo: state-hub
+status: finished
+owner: codex
+topic_slug: infotech
+created: "2026-09-04"
+updated: "2026-09-05"
+origin: "intake:01a06e0c-3feb-7920-a6f2-961b03dc170d"
+origin_ref: STATE-WP-0081
+quality_dor: DoR-Ok
+quality_dor_at: "2026-09-04"
+quality_dor_by: codex
+quality_dor_note: >-
+  The live 131-repository collection exceeds 15 seconds and the implementation
+  reveals per-repository identity queries. Scope, owner, dependency-free patch,
+  and query-bound regression signal are explicit.
+quality_dod: DoD-Ok
+quality_dod_at: "2026-09-05"
+quality_dod_by: codex
+quality_dod_note: >-
+  Bulk identity projection and domain-loading bounds are covered by 102 passing
+  repository/router regressions. Production-shaped PostgreSQL timing and SQL
+  counts are recorded in docs/evidence/repository-collection-projection-20260905.md.
+reviewed_at: "2026-09-05"
+reviewed_against_commit: "4cef58c"
+state_hub_workstream_id: "ae205179-f6dd-5c5e-be5f-18e2f6a604e8"
+---
+
+# Bound the repository collection projection
+
+## Goal
+
+Make `GET /repos/` complete with a database-query count that does not grow with
+the number of repositories, while preserving its existing list response and
+alias metadata. This promotes residual intake
+`01a06e0c-3feb-7920-a6f2-961b03dc170d` from `STATE-WP-0081`.
+
+Scope includes the repository collection query, identity/alias projection, and
+focused regression tests. Pagination and changes to the public response shape
+are out of scope because removing the N+1 projection makes the existing fleet
+read bounded without a collection-contract migration. Dependencies: none.
+
+## Bulk-project repository identities
+
+```task
+id: STATE-WP-0087-T01
+status: done
+priority: high
+quality_dor: DoR-Ok
+quality_dor_at: "2026-09-04"
+quality_dor_by: codex
+state_hub_task_id: "a4c2c1e8-2943-5d61-9ad8-8297d128cdf9"
+```
+
+Load canonical and alias slug records once for the collection, construct the
+existing identity response from that bulk result, and suppress unrelated eager
+relationships. Preserve compatibility for repositories created before the slug
+registry backfill. Done when focused API tests prove alias fidelity and a
+constant repository-slug query count, and the full repository router suite is
+green.
+
+## Acceptance
+
+- [x] Collection identity projection does not issue queries per repository.
+- [x] Canonical, alias, and pre-backfill compatibility responses are preserved.
+- [x] Focused and repository router tests pass.
+- [x] Live or production-shaped timing evidence is recorded.
+
+## Completion — 2026-09-05
+
+Reviewed and completed the pending collection patch. The collection performs one
+repository/domain SELECT and one registry SELECT; a domain filter adds one
+scalar domain-ID SELECT. Suppressing eager domain relationships also prevents
+unrelated topics, goals, repositories, and rename history from being loaded.
+The response shape, aliases, pre-backfill behavior, conflict responses, and
+classification filters are preserved.
+
+Validation: `uv run pytest -q tests/test_repository_collection_projection.py
+ tests/test_routers_core.py tests/test_repository_alias_routing.py
+ tests/test_repository_rename_api.py tests/test_repository_rename_persistence.py
+ tests/test_sbom_nexus_compat.py` — **102 passed in 129.14s**. `git diff --check`
+also passed. Production-shaped timing evidence:
+`docs/evidence/repository-collection-projection-20260905.md` (4, 131, and 501
+repositories; constant two/three SELECTs without/with a domain filter).
+
+No implementation residuals. This closes the scope promoted from intake
+`01a06e0c-3feb-7920-a6f2-961b03dc170d`. Deployment is outside this source-change
+workplan; the timing evidence uses the local test database, not the running
+central service. The separate retirement and HA workplans retain their gates.
diff --git a/workplans/STATE-WP-0088-preflight-signing-runtime-acceptance.md b/workplans/STATE-WP-0088-preflight-signing-runtime-acceptance.md
new file mode 100644
index 0000000..2b98803
--- /dev/null
+++ b/workplans/STATE-WP-0088-preflight-signing-runtime-acceptance.md
@@ -0,0 +1,77 @@
+---
+id: STATE-WP-0088
+type: workplan
+title: "Accept the platform preflight signing lane in the State Hub API"
+domain: infotech
+repo: state-hub
+status: finished
+owner: codex
+topic_slug: infotech
+created: "2026-09-05"
+updated: "2026-09-05"
+related:
+  - RPF-WP-0035
+  - STATE-WP-0085
+  - FLEX-WP-0020
+quality_dod: DoD-Ok
+quality_dod_note: "Live API-only signing and fenced CAS rotation accepted; predecessor signature denial and recovered primary health evidenced. No residual implementation work."
+quality_dor: DoR-Ok
+quality_dor_note: "Exact platform design and user-requested task reviewed against live primary; bounded API-only delivery and controlled-outage rotation fence."
+state_hub_workstream_id: "22f2d7dc-5766-5b09-9f18-12abd4b5512b"
+---
+
+## Wire and validate API-only delivery
+
+```task
+id: STATE-WP-0088-T01
+status: done
+priority: high
+state_hub_task_id: "1d6a3deb-588c-5b3f-a334-8ab5ff9a8ee6"
+```
+
+Chart opt-in `renamePreflight.enabled` adds a required explicit Secret ref only
+to the API container. Default disabled; no plaintext chart values or shared env
+Secret ownership. Helm rendering proves MCP/migration exclusion. Existing
+repository-rename API tests pass (13 tests). Platform owns CCR-2026-0015 and ESO.
+
+## Accept live signing and fenced rotation
+
+```task
+id: STATE-WP-0088-T02
+status: done
+priority: high
+state_hub_task_id: "55b32d0d-d30a-50c2-bae0-d6e3a357e6d1"
+```
+
+Before activation, the live flex-auth -> access-engine preflight returned
+exactly the `preflight_signing_unavailable` blocker. Target is primary/railiance01,
+namespace/release/deployment state-hub, current API SA state-hub and one replica.
+After platform custody verification, enable the chart, prove API-only delivery,
+all-replica key equality, health and non-mutating signed preflight. Then stop all
+API replicas (including terminating pods), rotate with CAS through platform,
+wait ESO, restart and prove predecessor invalidation and forward recovery.
+Runbook: railiance-platform/docs/credential-lane-designs/state-hub-preflight-activation.md.
+No repository rename is in scope. Initial activation required attended OpenBao
+OIDC/MFA because the ambient session returned 403; completion is recorded below.
+
+
+Completed 2026-09-05 under the user's instruction to lead activation from
+railiance-platform. CCR-2026-0015 is active. Production chart commit `49e3182`
+was fetched from Forge into ephemeral deployment storage; server dry-run changed
+only the API Deployment. Helm revision 59 retained image `main-cdff3b7`.
+One API replica matched the ESO key and signed preflight passed with zero
+blockers. Every API pod then stopped; platform rotated CAS 1 to KV version 2;
+ESO refreshed and one API replica recovered. New preflight passed, predecessor
+failed specifically by signature, and primary health passed. MCP and shared env
+Secret excluded from signing delivery. No repository rename executed.
+
+Evidence is owned by platform:
+`railiance-platform/docs/evidence/RPF-WP-0035-T04-signing-activation-2026-09-05.json`.
+Protected predecessor fixture removed after verification. No residual scope;
+the consuming FLEX-WP-0020 cutover remains separately governed.
+
+Independent review reverified the new API replica against the materialized key
+and the predecessor captured before rotation. The verifier now rejects expiry
+as sufficient rotation evidence and also requires primary/railiance01 health.
+Receipt: `docs/evidence/STATE-WP-0088-independent-signing-verification-20260905.json`.
+The private predecessor token was removed after this verification.
diff --git a/workplans/STATE-WP-0089-rename-redirect-recovery.md b/workplans/STATE-WP-0089-rename-redirect-recovery.md
new file mode 100644
index 0000000..201f436
--- /dev/null
+++ b/workplans/STATE-WP-0089-rename-redirect-recovery.md
@@ -0,0 +1,63 @@
+---
+id: STATE-WP-0089
+type: workplan
+title: "Recover an externally completed Forgejo rename through its old-name redirect"
+domain: infotech
+repo: state-hub
+status: finished
+owner: codex
+created: "2026-09-05"
+updated: "2026-09-05"
+state_hub_workstream_id: "f21470d4-e15c-5596-bd9c-1aa1460d7dc5"
+---
+
+# Recover the canon federation rename journal
+
+CFED-WP-0001-T03 renamed Forgejo repository 46 from identity-canon to
+commerce-canon through the approved operator credential lane. Journal
+615e7b44-d84e-4feb-92c5-1708feaf1e65 remains preflighted because the Forge adapter
+rejects the old coordinate's 307 redirect. New coordinate and exact source head
+40d5792fafbb2de778eabb56cfeaf00aecd058e1 are independently verified.
+
+## Handle the redirect without weakening identity checks
+
+```task
+id: STATE-WP-0089-T01
+status: done
+priority: high
+state_hub_task_id: "7bfa3d77-e05d-523e-9846-73c5668fa7e4"
+```
+
+Report redirects without following them or forwarding credentials. For forward
+recovery, inspect the new coordinate directly and verify immutable ID, branch,
+head and projection first. Accept the old redirect only if it names that exact
+same-instance/owner/new-coordinate API URL. Wrong identity, external redirects,
+wrong owner, missing Location and both names occupied remain failures.
+Add transport and API regression tests, and run the rename suite.
+
+## Promote the tested fix and resume the existing journal
+
+```task
+id: STATE-WP-0089-T02
+status: done
+priority: high
+state_hub_task_id: "45735bc2-5134-5de5-9226-e70da359a17b"
+```
+
+Commit/push; promote the immutable CI image through the existing Helm release
+with reused values and atomic rollback. Preserve API-only signing configuration.
+Verify healthy primary/railiance01, then retry forge-renamed and statehub-rebound
+on the same journal. Record image/revision and live recovery evidence. The donor
+rename, checkout moves and consumer acceptance remain CFED-WP-0001-T03 and
+IDENTITY-WP-0004 responsibilities. No direct DB edits or journal replacement.
+
+Validation: rename API, CLI and workplan tests pass (46 tests), including seven
+new transport/forward-recovery cases. `git diff --check` passes.
+
+
+Live recovery passed: immutable CI image main-fe6b8d9, Helm revision 60;
+primary/railiance01 healthy. Existing journal 615e7b44-d84e-4feb-92c5-1708feaf1e65
+replayed forge-renamed, rebound the same repository UUID, then passed all
+continuity checks and completed. No direct DB changes or replacement operation.
+CFED-WP-0001-T03 retains the donor metadata/checkout evidence; its T09 owns
+remaining fleet references. No residual implementation work in this fix.
diff --git a/workplans/STATE-WP-0090-projection-task-field-convergence.md b/workplans/STATE-WP-0090-projection-task-field-convergence.md
new file mode 100644
index 0000000..9c9eed8
--- /dev/null
+++ b/workplans/STATE-WP-0090-projection-task-field-convergence.md
@@ -0,0 +1,100 @@
+---
+id: STATE-WP-0090
+type: workplan
+title: "Preserve task descriptions and explicit empty notes in Forge projection"
+domain: infotech
+repo: state-hub
+status: finished
+owner: codex
+topic_slug: infotech
+created: "2026-09-10"
+updated: "2026-09-10"
+related: [STATE-WP-0086, RMGR-WP-0017, HFACT-WP-0001]
+state_hub_workstream_id: "894448a6-66ae-5215-b596-0f4a8bc2c509"
+---
+
+HFACT-WP-0001-T02 repeatedly repairs six of 24 selected task projections after
+normal sync. Forge derivation truncates nested evidence and converts explicit
+empty intervention notes into null, disagreeing with file-authoritative deep
+consistency. Fix the original parser rather than applying another batch patch.
+
+## Reproduce and correct task-field derivation
+
+```task
+id: STATE-WP-0090-T01
+status: done
+priority: high
+state_hub_task_id: "47ecc1ce-ca64-567b-8253-4e2bf72b8aa4"
+```
+
+Retain nested task sections, stop at the next peer/ancestor heading or task block,
+match source-description cleanup and preserve absent/null/empty metadata meaning.
+Keep task identity, status, collision and retirement rules unchanged. Test parity
+with the existing consistency parser and real PostgreSQL/API convergence.
+
+## Promote the verified correction and prove the selected chain
+
+```task
+id: STATE-WP-0090-T02
+status: done
+priority: high
+state_hub_task_id: "da0089fc-2c6f-52d7-91e9-83ee338caf2a"
+```
+
+Run relevant projection/consistency/API regressions, commit/push, consume the
+immutable CI image and prepare the existing Helm release with reused values and
+atomic rollback. Verify the exact promoted image and healthy primary, then sync
+the three selected repositories using RMGR-WP-0017 and read back all 24 task
+fields with zero manual task PATCH repairs. Preserve unrelated untracked evidence.
+
+## Retain evidence and close the bounded defect
+
+```task
+id: STATE-WP-0090-T03
+status: done
+priority: medium
+state_hub_task_id: "ac047cb8-fc56-5a2e-8a82-c5179f8cde8b"
+```
+
+Record source/image/Helm revisions, test results and before/after convergence.
+HFACT T02 retains other selected-backlog readiness work; native admission and
+factory execution remain their existing owner tasks. Do not mark factory G1/G2
+complete or introduce another synchronization service.
+
+Validation: all five new parser cases fail on the previous derivation. The
+corrected projection/consistency/API suite passes 242 tests on a disposable
+PostgreSQL database. Actual selected-source comparison reproduces six drifted
+tasks before the fix and zero afterward across 24 tasks. No production data
+was used by the tests; live promotion and readback remain T02.
+
+Promotion prepared: Forge commit 0747b4d95b3d30a12c41de673912659e8fdd1654
+passed CI. Immutable image main-0747b4d has registry digest
+sha256:78828c9e85848538878a27d2e3e6bebfd0cc7192c0961c92c749b27acca7b6f5.
+Offline container verification matches the tested parser source and passes nested
+section/empty-note cases. Server-side Helm preview permits only image, version
+labels and their rendered checksum; configuration and credential references are
+unchanged, and there are no migration changes. Previous Helm revision: 60.
+
+Rollout revision 61 could not schedule the API surge pod: the 4,000m node had
+3,935m requested, leaving 65m against the required 100m. Atomic rollback restored
+healthy old-image services at revision 62. Available Prometheus history contains
+1,078 five-minute samples within the seven-day query window (partial coverage):
+MCP p99 2.35m, peak 30.45m. The reviewed retry lowers only the MCP CPU request
+from 50m to 10m, preserving one replica, its 500m CPU limit and memory settings.
+This reduces its guaranteed share under contention; bursts remain permitted.
+Nominal headroom becomes 105m, sufficient for this 100m API surge but too narrow
+to count as factory capacity admission. Broader capacity planning needs a live
+residual before closeout. No unrelated workload allocation is changed.
+
+Completed: Helm revision 63 is deployed; API and MCP are Ready with the exact
+verified image digest, zero restarts and healthy primary/schema readback. Normal
+Repo Manager sync uses two requests per repository. All 24 selected source tasks
+match live fields with zero manual PATCH repairs. An independent request key
+forced another derivation for each repository: all three returned noop with zero
+changes. Platform's first derivation also corrected 30 tasks across its full repo;
+this is broader than the selected-chain comparison and is not a factory outcome.
+Evidence: docs/evidence/2026-09-10-projection-convergence.json.
+
+Residual handed off before finish: STATE-WP-0091 owns repeatable rollout-headroom
+preflight, sustained MCP demand review and live shared-capacity handoff. HFACT T02
+retains selected-backlog readiness; native execution remains T01/T03/T04/T05/T06.
diff --git a/workplans/STATE-WP-0091-release-headroom.md b/workplans/STATE-WP-0091-release-headroom.md
new file mode 100644
index 0000000..307e201
--- /dev/null
+++ b/workplans/STATE-WP-0091-release-headroom.md
@@ -0,0 +1,72 @@
+---
+id: STATE-WP-0091
+type: workplan
+title: "Check release headroom and retain a capacity allocation handoff"
+domain: infotech
+repo: state-hub
+status: finished
+owner: codex
+topic_slug: infotech
+created: "2026-09-10"
+updated: "2026-09-14"
+related: [STATE-WP-0090, RCLUSTER-WP-0014, RESOURCE-WP-0003, HFACT-WP-0001]
+state_hub_workstream_id: "4c64d6a6-554d-5b16-a533-9be407fa6515"
+---
+
+Residual from STATE-WP-0090: revision 61 failed with Insufficient CPU even though
+runtime usage was modest. Revision 63 succeeded after a measured same-service
+MCP request adjustment. The single 4,000m node still reserves 3,895m (97.4%),
+leaving 105m against a 100m API surge. Existing cluster collection and portfolio
+contracts are finished inputs, not workplans to reopen. No factory capacity
+admission follows from this release.
+
+## Check scheduling headroom before State Hub promotion
+
+```task
+id: STATE-WP-0091-T01
+status: done
+priority: high
+state_hub_task_id: "f84c0f1b-3354-5466-a239-ef9ef85daa07"
+```
+
+Add a read-only preflight to the existing promotion path. Reuse Kubernetes and
+railiance-cluster capacity evidence; check effective pod requests, init/overhead,
+placement constraints, rollout surge and migration-hook ordering. Report observed
+freshness, remaining CPU/memory and precise insufficient-capacity reasons before
+starting Helm. Do not claim a scheduling guarantee from an aggregate sum or lower
+requests automatically. Prove the observed 65m refusal and 105m narrowly sufficient
+case, including unrelated concurrent demand. Keep atomic rollback.
+
+## Review sustained service demand and hand off shared capacity
+
+```task
+id: STATE-WP-0091-T02
+status: done
+priority: high
+state_hub_task_id: "a433e2d3-6fd4-5313-9273-e3769c2cefeb"
+```
+
+State Hub owns its workload demand and release requirement. Check MCP latency,
+errors, CPU contention and coverage after the 50m-to-10m request change; its 500m
+limit, memory and replicas remain unchanged. The initial 1,078 five-minute samples
+are partial coverage, not a full week. Propose a durable release margin and hand
+any shared allocation or provisioning change to live records with railiance-cluster,
+railiance-platform and resource-control using their existing authority contracts.
+Include HFACT T01/T04 factory demand, other zero-request workloads and host usage;
+current aggregate reservation alone is not capacity admission. No unrelated
+allocation, procurement or scaling is authorized by this workplan. Close only
+after the repeatable preflight and explicit receiving work records are verified.
+
+Evidence: docs/evidence/2026-09-10-projection-convergence.json.
+
+**T01 done 2026-09-14.** `scripts/release_headroom_preflight.py` plus
+`make railiance-state-hub-headroom`. Fixtures prove 65m refuse, 105m narrow
+pass, and 105m+50m pending refuse. Helm is not started; requests are not
+lowered; `--atomic` remains required.
+
+**T02 done 2026-09-14.** Existing 1,078 samples remain partial coverage.
+Durable margin: remaining must cover 100m API surge and must refuse when
+unrelated pending demand consumes the 5m sliver. Not factory admission.
+Receiving records: `RAIL-BS-WP-0014`, `RESOURCE-WP-0007`, `RPF-WP-0041`.
+`CUST-WP-0071` keeps weekly fleet review. Details:
+`docs/evidence/2026-09-14-release-headroom.md`.
diff --git a/workplans/STATE-WP-0092-workplan-flavor-and-depends-on-policy.md b/workplans/STATE-WP-0092-workplan-flavor-and-depends-on-policy.md
new file mode 100644
index 0000000..9bc6f53
--- /dev/null
+++ b/workplans/STATE-WP-0092-workplan-flavor-and-depends-on-policy.md
@@ -0,0 +1,179 @@
+---
+id: STATE-WP-0092
+type: workplan
+title: "Workplan flavor, depends_on indexing, and residual default-exclusion"
+domain: infotech
+repo: state-hub
+status: finished
+owner: grok
+topic_slug: infotech
+flavor: planning
+created: "2026-09-14"
+updated: "2026-09-14"
+related:
+  - CUST-WP-0072
+  - RAIL-FAB-WP-0030
+  - COORDINATION-WP-0005
+  - CUST-WP-0060
+origin: residual-policy
+origin_ref: the-custodian/history/20260914-open-workplan-chokepoints.md
+state_hub_workstream_id: "2a2d8bcd-4a34-537b-b72e-f093d46f6cb4"
+---
+
+# Workplan flavor, depends_on indexing, and residual default-exclusion
+
+Founder direction 2026-09-14 (assessment
+`the-custodian/history/20260914-open-workplan-chokepoints.md`): the open
+workplan count will not fall by agent closure alone. First change the
+schema and policy so residuals are a **flavor**, not equal open demand,
+and so `depends_on` in workplan frontmatter is actually indexed.
+
+This is workplan 1 of 3 for that change. Canon lands in `the-custodian`;
+the hub remains a read model (ADR-001). Do not register workplans by
+hand. Do not treat `flavor: residual` as a new work-record **kind**.
+
+## Policy to encode
+
+Flavor is a bucket on workplans **and** tasks, orthogonal to kind:
+
+`planning` | `implementation` | `refactoring` | `extension` | `residual`
+
+Residuals are leftovers that are **not deemed as valuable** as the main
+functional and non-functional requirements. Default State Hub views of
+open workplans, `/state/summary` `open_workplans`, `/state/next_steps`,
+and agent “should we implement this?” **exclude** `flavor: residual`
+unless an explicit include flag is set.
+
+Demand or risk **promotes** a residual into another flavor. After
+promotion it is no longer residual and it re-enters the default view.
+`origin: residual` on intakes may remain as provenance; flavor is the
+live classification.
+
+`depends_on` in workplan frontmatter is the canonical edge (list of
+workplan ids). C-20 today looks at `depends_on_workplans` /
+`depends_on_tasks`, which the fleet does not author. Unify on
+`depends_on`. Keep the old keys as aliases until a legacy-meter says
+otherwise.
+
+`flavor:` on this file is advisory until T01–T02 land; do not fail
+parsing unknown frontmatter keys.
+
+## Ratify flavor and depends_on in custodian canon
+
+```task
+id: STATE-WP-0092-T01
+status: done
+priority: high
+state_hub_task_id: "c5c967ec-6f4c-541e-957d-7ae9489fbf6d"
+```
+
+In `the-custodian`, extend `canon/standards/work-record-types_v0.1.md`
+(and the YAML machine copy / spine schema) so flavor is a closed list on
+workplan and task, residual stays a flavor rather than a kind, and
+promotion (residual → planning|implementation|refactoring|extension) is
+a first-class transition with a recorded reason (`demand` or `risk`).
+
+State the default-view rule: open-workplan lists and implementation
+triage omit residuals. Update the workplan-terminology standard and the
+workplan convention so frontmatter `depends_on` and `flavor` are
+documented. Founder ratification is required for the canon change
+(yellow/red lane). Do not silently rewrite `origin: residual` semantics
+on intakes.
+
+Done when the canon files are merged, the closed flavor list is
+machine-checkable, and the residual section no longer implies that every
+live leftover is equal open demand.
+
+## Index flavor and depends_on from files
+
+```task
+id: STATE-WP-0092-T02
+status: done
+priority: high
+depends_on: [STATE-WP-0092-T01]
+state_hub_task_id: "63d9c134-0b2b-592b-a7df-a58eaa3fdc99"
+```
+
+Parse workplan (and task-block) `flavor` and workplan-frontmatter
+`depends_on`. Persist them on the hub read model. Expose them on
+`GET /workplans/`, `GET /workplans/{id}`, `GET /state/summary`
+`open_workplans[]`, and the dependencies endpoint. Accept
+`depends_on_workplans` as an alias on read. C-20 creates missing
+dependency edges from `depends_on`. Unknown flavor fails closed after
+canon lands; before that, warn.
+
+Done when a fixture workplan with `flavor: residual` and
+`depends_on: [STATE-WP-0091]` round-trips into the DB and the summary,
+and C-20 no longer requires the unused `depends_on_workplans` spelling.
+
+## Default views omit residuals
+
+```task
+id: STATE-WP-0092-T03
+status: done
+priority: high
+depends_on: [STATE-WP-0092-T02]
+state_hub_task_id: "0d53713b-d6f0-597d-8f87-9f86e5ca2235"
+```
+
+`/state/summary` `open_workplans`, `/state/next_steps`, dashboard
+open-workplan widgets, and any “implement next” ranking **exclude**
+`flavor: residual` by default. Add an explicit query flag
+(`include_residuals=true` or `flavor=` filter) for the residual list
+the fleet already wanted (`statehub residuals` in the canon). Totals
+must still be honest: show residual counts as a separate figure so the
+headline cannot hide them, but do not mix them into actionable open
+work.
+
+Unspecified flavor is **not** residual; treat it as relevant until
+backfill (`CUST-WP-0072`) classifies it. Do not auto-classify.
+
+Done when a residual workplan is absent from the default summary list,
+present when included, and next_steps does not recommend implementing
+it.
+
+## Policy for agents and operators
+
+```task
+id: STATE-WP-0092-T04
+status: done
+priority: medium
+depends_on: [STATE-WP-0092-T03]
+state_hub_task_id: "764a4b17-5119-572a-8aa1-581d719f07fa"
+```
+
+Document the rule in state-hub agent/API docs: do not pick up residual
+workplans or residual tasks for implementation unless the flavor has
+been promoted. Promotion is a file edit (`flavor:` + short reason), then
+`fix-consistency`. Hub docs point at `CUST-WP-0072` for fleet backfill
+and `COORDINATION-WP-0005` for cross-owner waits. No secret-vending
+language.
+
+Done when the documented default matches T03 behaviour and a short
+agent snippet exists for later instruction rollout.
+
+## Tests and consistency checks
+
+```task
+id: STATE-WP-0092-T05
+status: done
+priority: high
+depends_on: [STATE-WP-0092-T02, STATE-WP-0092-T03]
+state_hub_task_id: "ab74d06b-acc4-52da-ac20-ac564ca8a7ed"
+```
+
+API tests for default exclusion, include flag, flavor filter, and
+`depends_on` round-trip. Consistency checks: unknown flavor; residual
+without `origin`/`origin_ref` when spawned from a finished parent
+(warn, do not invent); `depends_on` target missing (existing C-20).
+Do not add a check that forces every historic workplan to declare
+flavor — that is `CUST-WP-0072`.
+
+Done when the new tests are green and `fix-consistency` on this repo
+does not warn on this file’s advisory `flavor:` / `depends_on` keys.
+
+2026-09-14: T01–T05 landed in repo. Canon v0.2 flavor list is machine-checkable.
+Hub indexes `flavor` / `depends_on`, default summary/next_steps/deps omit
+`flavor: residual`, and C-20 accepts `depends_on`. Live primary views change
+after alembic `c6f7a8b9d0e1` is applied and this revision is deployed. Until
+then CUST-WP-0072 should wait.
diff --git a/workplans/STATE-WP-0070-workplan-terminology-phase2-retirement.md b/workplans/archived/260714-STATE-WP-0070-workplan-terminology-phase2-retirement.md
similarity index 87%
rename from workplans/STATE-WP-0070-workplan-terminology-phase2-retirement.md
rename to workplans/archived/260714-STATE-WP-0070-workplan-terminology-phase2-retirement.md
index 7f3a76d..2a10c19 100644
--- a/workplans/STATE-WP-0070-workplan-terminology-phase2-retirement.md
+++ b/workplans/archived/260714-STATE-WP-0070-workplan-terminology-phase2-retirement.md
@@ -4,13 +4,13 @@ type: workplan
 title: "Workplan terminology phase-2 legacy retirement"
 domain: infotech
 repo: state-hub
-status: active
+status: finished
 owner: codex
 topic_slug: custodian
 planning_priority: medium
 planning_order: 70
 created: "2026-07-09"
-updated: "2026-07-13"
+updated: "2026-07-14"
 state_hub_workstream_id: "9aa92529-6ee8-4b3f-b573-78b0ef8d9788"
 ---
 
@@ -112,7 +112,7 @@ snapshots, not 7 windows). Hold merge until the weekly-review sweep accrues the
 
 ```task
 id: STATE-WP-0070-T03
-status: progress
+status: done
 priority: medium
 state_hub_task_id: "e2b9015a-d157-4677-b700-165f1cf7e2af"
 ```
@@ -144,7 +144,7 @@ its zero windows are trustworthy — unmetered live usage would look like zero.
 
 ```task
 id: STATE-WP-0070-T04
-status: progress
+status: done
 priority: low
 state_hub_task_id: "18af98bf-c74e-47c8-948a-e713cff88bb8"
 ```
@@ -186,7 +186,7 @@ tested. Merge gate same as T03: 7th documented zero-usage window.
 
 ```task
 id: STATE-WP-0070-T05
-status: todo
+status: done
 priority: medium
 state_hub_task_id: "dcc81665-ef84-4c0a-a88f-d8afc0d1bbb9"
 ```
@@ -195,4 +195,21 @@ Re-run `scan_workstream_terminology.py`, grep budget check, full test suite,
 archive this workplan, notify CUST-WP-0055 fleet gate complete.
 
 Done when legacy-meter weekly review shows no active legacy REST keys and MCP
-aliases are removed or marked retired.
\ No newline at end of file
+aliases are removed or marked retired.
+
+**Closeout 2026-07-14 (merged `df19c46`):** Gate cleared — 10 consecutive 8h
+zero-usage windows (07-10 14:00 → 07-13 22:00), all 19 legacy interfaces at 0.
+Branch `state-wp-0070-legacy-retirement` merged to `main`; :8001 dev-hub MCP
+restarted (removed tools de-registered); full suite green (495 passed). T03
+(MCP aliases + resource) and the open_workstreams mirror (T04) are removed.
+
+**Deferred to a phase-3 followup (handed to CUST-WP-0055 fleet gate):** two T04
+sub-items still have live fleet callers and were intentionally NOT removed:
+1. `workstream_id` query/body field alias on preferred routes (`/tasks`,
+   `/decisions`, `/progress`, `/execution`, `/token-events`) — external
+   session-close curls and scripts still send it; scan shows ~4.1k `api:workstream_id`
+   occurrences fleet-wide. Retire after briefs/scripts refresh and the meter key
+   holds 7 zero windows.
+2. `flows/workstream.yaml` — the `/flows/workstream/{id}` routes are still served
+   and tested. Retire when no callers remain.
+Backlog: `docs/workplan-terminology-legacy-retirement-backlog.md` (phase-3 rows).
\ No newline at end of file