From 40d5792fafbb2de778eabb56cfeaf00aecd058e1 Mon Sep 17 00:00:00 2001 From: tegwick Date: Sat, 5 Sep 2026 18:30:51 +0200 Subject: [PATCH] Plan commerce canon rename and record cutover readiness Assistant: codex Assistant-Model: gpt-6-astra Assistant-Session: 01a070b5-4994-7271-bd8b-7c3dbcedec4b --- WORK-RECORDS.md | 33 ++++ workplans/IDENTITY-WP-0004-commerce-rename.md | 158 ++++++++++++++++++ 2 files changed, 191 insertions(+) create mode 100644 WORK-RECORDS.md create mode 100644 workplans/IDENTITY-WP-0004-commerce-rename.md diff --git a/WORK-RECORDS.md b/WORK-RECORDS.md new file mode 100644 index 0000000..b968344 --- /dev/null +++ b/WORK-RECORDS.md @@ -0,0 +1,33 @@ +# Work Records — identity-canon + +> 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 | IDENTITY-WP-0001 | finished | — | workplans/IDENTITY-WP-0001-statehub-bootstrap.md | +| workplan | IDENTITY-WP-0002 | finished | — | workplans/IDENTITY-WP-0002-research-proposal-follow-up.md | +| workplan | IDENTITY-WP-0003 | finished | — | workplans/IDENTITY-WP-0003-corpus-backfill-model-refinement.md | +| workplan | IDENTITY-WP-0004 | blocked | — | workplans/IDENTITY-WP-0004-commerce-rename.md | +| task | IDENTITY-WP-0001-T01 | done | — | workplans/IDENTITY-WP-0001-statehub-bootstrap.md | +| task | IDENTITY-WP-0001-T02 | done | — | workplans/IDENTITY-WP-0001-statehub-bootstrap.md | +| task | IDENTITY-WP-0001-T03 | done | — | workplans/IDENTITY-WP-0001-statehub-bootstrap.md | +| task | IDENTITY-WP-0002-T01 | done | — | workplans/IDENTITY-WP-0002-research-proposal-follow-up.md | +| task | IDENTITY-WP-0002-T02 | done | — | workplans/IDENTITY-WP-0002-research-proposal-follow-up.md | +| task | IDENTITY-WP-0002-T03 | done | — | workplans/IDENTITY-WP-0002-research-proposal-follow-up.md | +| task | IDENTITY-WP-0002-T04 | done | — | workplans/IDENTITY-WP-0002-research-proposal-follow-up.md | +| task | IDENTITY-WP-0002-T05 | done | — | workplans/IDENTITY-WP-0002-research-proposal-follow-up.md | +| task | IDENTITY-WP-0003-T01 | done | — | workplans/IDENTITY-WP-0003-corpus-backfill-model-refinement.md | +| task | IDENTITY-WP-0003-T02 | done | — | workplans/IDENTITY-WP-0003-corpus-backfill-model-refinement.md | +| task | IDENTITY-WP-0003-T03 | done | — | workplans/IDENTITY-WP-0003-corpus-backfill-model-refinement.md | +| task | IDENTITY-WP-0003-T04 | done | — | workplans/IDENTITY-WP-0003-corpus-backfill-model-refinement.md | +| task | IDENTITY-WP-0003-T05 | done | — | workplans/IDENTITY-WP-0003-corpus-backfill-model-refinement.md | +| task | IDENTITY-WP-0003-T06 | done | — | workplans/IDENTITY-WP-0003-corpus-backfill-model-refinement.md | +| task | IDENTITY-WP-0004-T01 | done | — | workplans/IDENTITY-WP-0004-commerce-rename.md | +| task | IDENTITY-WP-0004-T02 | progress | — | workplans/IDENTITY-WP-0004-commerce-rename.md | +| task | IDENTITY-WP-0004-T03 | wait | — | workplans/IDENTITY-WP-0004-commerce-rename.md | +| task | IDENTITY-WP-0004-T04 | wait | — | workplans/IDENTITY-WP-0004-commerce-rename.md | +| task | IDENTITY-WP-0004-T05 | wait | — | workplans/IDENTITY-WP-0004-commerce-rename.md | diff --git a/workplans/IDENTITY-WP-0004-commerce-rename.md b/workplans/IDENTITY-WP-0004-commerce-rename.md new file mode 100644 index 0000000..43494ea --- /dev/null +++ b/workplans/IDENTITY-WP-0004-commerce-rename.md @@ -0,0 +1,158 @@ +--- +id: IDENTITY-WP-0004 +type: workplan +title: "Rename identity-canon to commerce-canon with continuous history" +domain: infotech +repo: identity-canon +status: active +owner: codex +topic_slug: canon +created: "2026-09-05" +updated: "2026-09-05" +state_hub_workstream_id: "598275a1-8fbd-5607-8292-d992ead1487d" +--- + +# Repository rename to commerce-canon + +Implements `CFED-WP-0001-T03` under CUST-ADR-006 accepted-1. Project coordination +and the concept ledger live in `prj-canon-federation`; this plan owns the donor +repository's rename preparation and verification. + +The user authorized proceeding with the rename on 2026-09-05. The remaining +execution gate is technical, not a request to repeat that authorization. +No operation may bypass a failing State Hub preflight. + +## Capture the immutable repository baseline + +```task +id: IDENTITY-WP-0004-T01 +status: done +priority: high +state_hub_task_id: "c090a28b-bf82-5d2f-b1f6-670f1eaf1147" +``` + +Captured before adding this preparatory plan: + +- State Hub repository UUID: `8c82baea-bb40-435d-ac42-ec7a7c20dbb8`. +- Forgejo: `https://forgejo.coulomb.social/coulomb/identity-canon`, numeric ID 46. +- Branch `main`; local and verified Forge head both + `43c5c21a7a7e273241d9c7622db4e926ac9aadfa`; checkout clean. +- State Hub Forge identity verified through the supported API on 2026-09-05. +- Three finished IDENTITY-WP plans and 14 tasks retained on the same UUID. +- Registered paths: `bnt-lap001:/home/worsch/identity-canon` and + `239.62.205.92.host.secureserver.net:/home/tegwick/identity-canon`. + +Refresh the baseline after committing preparation and immediately before cutover. +The snapshot is evidence, not permission to rename a subsequently changed head. + +## Prepare metadata and coordinate external dependencies + +```task +id: IDENTITY-WP-0004-T02 +status: progress +priority: high +state_hub_task_id: "8606bbbb-716d-5011-950e-29dc9ea3c2d8" +``` + +Apply the reviewed metadata patch from +`prj-canon-federation/docs/evidence/2026-09-05-commerce-metadata.patch` only after +rebind. It updates README/INTENT/SCOPE, classification, and records the migration. +Regenerate AGENTS.md and CLAUDE.md after registering the canonical local path. + +Classification: financials primary, government and infotech secondary; retain +research category during migration. New post-rename plans use COMMERCE-WP-; +this existing rename plan and all finished IDENTITY-WP plans keep their IDs. +The generator infers the majority historical prefix, so append an explicit +COMMERCE-WP override under the preserved agent-extension marker after generation. + +The repository has no runtime app or package build. The existing CI smoke, +capability registry, and documentation links still require verification. +Identity capability identifiers are stable references; destination ownership +is resolved during model migration, not by blindly renaming capability IDs. + +Project tasks CFED-WP-0001-T08/T09 own cross-canon and fleet reference acceptance. +Inventory each affected owner before cutover, including the second registered +host, fabric/reuse-surface discovery and SBOM projection. Record owner evidence +before claiming these consumers verified; do not assert changes on the remote +host merely because its registered path is known. + +## Resolve signing and refresh the preflight + +```task +id: IDENTITY-WP-0004-T03 +status: done +priority: high +state_hub_task_id: "1cd684ba-046b-5ff3-bb25-5424f82ee4b5" +``` + +Current blocker: State Hub returns `preflight_signing_unavailable`. +`REPOSITORY_RENAME_PREFLIGHT_SECRET` must be supplied to the deployed API by +its platform credential/deployment owner. Existing platform handoff: +`cd52ba10-de41-46ce-aa8b-9b44050da8f7`, recorded by STATE-WP-0085-T09 and shared +with FLEX-WP-0020. Do not put secret material into this plan or State Hub. + +Use a fresh private mode-0600 preflight file. Require zero blockers, matching +Forge ID/head, an available target, coordinated active work, and resolved +external dependencies. The new plan itself is active work and must be explicitly +coordinated. No operation journal has been started. + +## Execute the rename and prove continuity + +```task +id: IDENTITY-WP-0004-T04 +status: progress +priority: high +state_hub_task_id: "2082388e-2096-5138-a7a6-40c9f71e1fb5" +``` + +Use `statehub repo rename` start/apply phases in order: forge-renamed, +statehub-rebound, source-synced, consumers-verified, completed. Follow +`state-hub/docs/repository-rename-operations.md`; use confirmation +`rename:8c82baea-bb40-435d-ac42-ec7a7c20dbb8:identity-canon:commerce-canon`. + +Preserve Forge ID 46 and the State Hub UUID. Obtain a fresh verification clone +at the new coordinate and prove its exact baseline commit before source-synced. +Rename the existing clean local checkout in place and update its remotes; +register the new local path. Keep the other host's mapping until its checkout +has actually moved. Verify the protected old-slug alias and historical work links. +Apply metadata, regenerate instructions, preserve finished workplans byte-for-byte, +and record actual cutover evidence. Run consistency and link checks. + +Rollback uses the journal's rollback-preflight and rollback phases only when +identity/head and old-name availability still permit it. Do not delete or steal +an occupied slug. Local path/remotes and metadata must be restored consistently; +retain verification evidence and do not delete repository history. + +## Close with evidence and live handoffs + +```task +id: IDENTITY-WP-0004-T05 +status: wait +priority: medium +state_hub_task_id: "c78ce770-3e0c-505d-8eff-538fd305da52" +``` + +Attach operation verification and immutable identity evidence to CFED-WP-0001-T03. +Confirm both registered-host dispositions, remotes, instructions, classification, +finished-plan hashes, and owner-backed consumer verification. Hand off actionable +residuals as live records before finishing. Canon layout/model/corpus migration +remains with CFED-WP-0001-T04 through T13, not this rename plan. + + +## Cutover coordination — 2026-09-05 + +RPF-WP-0035-T04 is done: signing version 2 delivered, State Hub Helm revision +59. Fresh read-only preflight passes with no blockers. The only active-work +warning is this plan's own four pending tasks; codex coordinates them in this +session and no concurrent donor-content migration is authorized during cutover. + +Known external source: reuse-surface registry/federation/sources.yaml and +local-repo-roster.yaml, plus generated federated index/cache. CFED-WP-0001-T09 +owns the fleet sweep and will collect that repository's source/refresh evidence. +Scans of ops-warden, railiance-fabric and sbom-nexus checked-in Markdown/YAML/JSON +found no literal old-slug references. Live projections still require verification. +The CI smoke uses dynamic GITHUB_REPOSITORY and has no hardcoded slug. + +The registered railiance01 checkout is inspected separately; its path will not +be rewritten in State Hub without proving its actual filesystem disposition. +The user renewed instruction to continue once signing was provisioned.