diff --git a/architecture/README.md b/architecture/README.md index 13665f8..5e4b602 100644 --- a/architecture/README.md +++ b/architecture/README.md @@ -9,5 +9,6 @@ in child repos; durable promotion targets are noted in each document. | [information-model_v0.1.yaml](information-model_v0.1.yaml) | SHR-WP-0001-T03 | companion | | [hub-extension-architecture_v0.1.md](hub-extension-architecture_v0.1.md) | SHR-WP-0001-T04 | draft-reviewable | | [hub-extension-contract_v0.1.yaml](hub-extension-contract_v0.1.yaml) | SHR-WP-0001-T04 | companion | +| [child-workplan-map_v0.1.md](child-workplan-map_v0.1.md) | SHR-WP-0001-T05 | active | Related: [`../inventory/`](../inventory/) disposition inventory, [`../GOAL.md`](../GOAL.md). diff --git a/architecture/child-workplan-map_v0.1.md b/architecture/child-workplan-map_v0.1.md new file mode 100644 index 0000000..8f6592b --- /dev/null +++ b/architecture/child-workplan-map_v0.1.md @@ -0,0 +1,196 @@ +--- +id: SHR-ARCH-MAP-0001 +type: architecture +title: "Child workplan map — State Hub retirement" +status: active +version: "0.1" +created: "2026-08-09" +updated: "2026-08-09" +workplan_task: SHR-WP-0001-T05 +parent_workplan: SHR-WP-0001 +related: + - architecture/information-model_v0.1.md + - architecture/hub-extension-architecture_v0.1.md + - inventory/state-hub-disposition.yaml + - GOAL.md +--- + +# Child workplan map v0.1 + +## Purpose + +Record **one local implementation owner and workplan per stream** for State Hub +retirement, with dependencies and project gates. Task lists stay in child +repos; this project only links stable IDs (SCOPE work-record rule). + +Parent foundation: **SHR-WP-0001**. Architecture freeze inputs: **SHR-ARCH-IA-0001**, +**SHR-ARCH-HUB-0001**, **SHR-INV-0001**. + +--- + +## Stream overview + +| Stream | Repo | Workplan | Status | Role | +| --- | --- | --- | --- | --- | +| S1 Repo Manager foundation | `repo-manager` | **RMGR-WP-0001** | proposed | Extract repo registry, consistency, work-record index | +| S2 hub-core runtime + contract | `hub-core` | **HUB-WP-0004** | proposed | Consolidate runtime, ship extension contract Tier 1 | +| S3 core-hub absorption | `core-hub` | **CORE-WP-0010** | proposed | Absorb `/api/v2` into hub-core; archive core-hub | +| S4 State Hub strangler | `state-hub` | **STATE-WP-0079** | proposed | Compatibility adapters; disposition execution; freeze growth | +| S5 activity-core ports | `activity-core` | **ACTIVITY-WP-0029** | proposed | Schedule/sink alignment to hub ports | +| S6 ops-hub extension | `ops-hub` | **OPS-WP-0003** | proposed | Manifest + extension contract conformance | +| S7 fin-hub fabric boundary | `fin-hub` | **FIN-WP-0002** | proposed | Fabric authority; optional hub projection | +| S8 Project gates (evidence) | `prj-state-hub-retirement` | **SHR-WP-0001-T06** | todo | Baseline counts + retirement gates | + +Secondary / support (no new WP required yet): + +| Concern | Repo | Existing / note | +| --- | --- | --- | +| Work-record canon | `the-custodian` | `work-record-types_v0.1.md`; project-repo flavor done | +| Issue projection boundary | `issue-core` | **ISSUE-WP-0004** finished — monitor only | +| Connectivity | `ops-bridge` | Transport only; retarget at cutover (no WP) | + +--- + +## Dependency graph + +```text +SHR-WP-0001 (T01–T04 done; T05 map; T06 gates) + │ + ├─► RMGR-WP-0001 ─────────────────────────────┐ + │ │ │ + │ ▼ │ + ├─► HUB-WP-0004 ──► CORE-WP-0010 ─────────────┤ + │ │ │ │ + │ ├─► OPS-WP-0003 │ │ + │ ├─► ACTIVITY-WP-0029 │ + │ └─► FIN-WP-0002 │ + │ │ │ + └─► STATE-WP-0079 ◄┘ (strangler consumes │ + │ owners' ports) │ + ▼ │ + SHR-WP-0001-T06 gates ◄──────────────────┘ + │ + ▼ + Project retirement (GOAL.md) +``` + +**Parallelism:** RMGR-WP-0001 and HUB-WP-0004 may start in parallel after this +map. CORE-WP-0010 waits on HUB-WP-0004 contract artefacts (Tier 1). STATE-WP-0079 +starts after map; cutover slices wait on owner APIs. Domain hub WPs wait on +HUB-WP-0004 port/schema freeze. + +--- + +## Stream detail (links only — no task copies) + +### S1 — RMGR-WP-0001 (repo-manager) + +- **Path:** `repo-manager/workplans/RMGR-WP-0001-foundation.md` +- **Outcome:** Repository representation + observation/command contracts + first + vertical slice; State Hub extraction dispositions for repo/consistency/work index. +- **Depends on:** SHR-ARCH-IA-0001, SHR-INV-0001 (repo-* capabilities) +- **Unblocks:** STATE-WP-0079 move of repo/work surfaces; hub-core `port.repo` / + `port.work` implementations +- **Predecessors:** none local (new repo) + +### S2 — HUB-WP-0004 (hub-core) + +- **Path:** `hub-core/workplans/HUB-WP-0004-runtime-and-extension-contract.md` +- **Outcome:** hub-core as surviving runtime+SDK; `helixforge.hub-extension` Tier 1 + schemas; ports; absorb core-hub runtime path planning +- **Depends on:** SHR-ARCH-HUB-0001, finished HUB-WP-0003 (library lane) +- **Unblocks:** CORE-WP-0010, OPS-WP-0003, ACTIVITY-WP-0029, FIN-WP-0002, adapters +- **Predecessors:** HUB-WP-0002 finished, HUB-WP-0003 finished + +### S3 — CORE-WP-0010 (core-hub) + +- **Path:** `core-hub/workplans/CORE-WP-0010-runtime-absorption-and-archive.md` +- **Outcome:** Production traffic on consolidated hub-core; core-hub archived + read-only +- **Depends on:** HUB-WP-0004; finished CORE-WP-0004/0008/0009 +- **Unblocks:** T06 core-hub archive gate; ops-hub consumer re-smoke on new host + +### S4 — STATE-WP-0079 (state-hub) + +- **Path:** `state-hub/workplans/STATE-WP-0079-retirement-strangler.md` +- **Outcome:** Per-capability strangler using inventory dispositions; register CLI + GOAL.md support; no new permanent authorities; eventual freeze window +- **Depends on:** SHR-INV-0001; progressive deps on RMGR/HUB cutovers +- **Unblocks:** T06 stabilization window +- **Predecessors:** STATE-WP-0074 finished (boundary docs); legacy meter WPs finished + +### S5 — ACTIVITY-WP-0029 (activity-core) + +- **Path:** `activity-core/workplans/ACTIVITY-WP-0029-hub-port-alignment.md` +- **Outcome:** Sweeps, sinks, execution aligned to hub-core / repo-manager ports +- **Depends on:** HUB-WP-0004 ports; partial STATE/RMGR availability +- **Predecessors:** ACTIVITY-WP-0015, ACTIVITY-WP-0017 finished + +### S6 — OPS-WP-0003 (ops-hub) + +- **Path:** `ops-hub/workplans/OPS-WP-0003-extension-contract-alignment.md` +- **Outcome:** Domain/aspect hub package conforming to extension contract +- **Depends on:** HUB-WP-0004 Tier 1; CORE-WP-0010 dual-run as needed +- **Predecessors:** OPS-WP-0001/0002 archived (bootstrap history) + +### S7 — FIN-WP-0002 (fin-hub) + +- **Path:** `fin-hub/workplans/FIN-WP-0002-fabric-authority-boundary.md` +- **Outcome:** Fabric graph authority retained; hub projection optional; State Hub + fabric routes disposition executed with owner +- **Depends on:** SHR-INV fabric-graph; HUB-WP-0004 if projection via hub +- **Predecessors:** FIN-WP-0001 finished + +### S8 — SHR-WP-0001-T06 (this project) + +- Baseline counts, callers, recovery, executable gates from GOAL.md +- Depends on streams having measurable handoff evidence + +--- + +## Project gates (owned here; evidence from children) + +| Gate ID | Statement | Evidence owners | +| --- | --- | --- | +| G-ARCH | IA + extension architectures reviewable | SHR-WP-0001 T03/T04 (done) | +| G-MAP | Each stream has a local WP | this map + child files (T05) | +| G-RMGR | Repo Manager vertical slice | RMGR-WP-0001 | +| G-HUB | Extension contract Tier 1 + runtime path | HUB-WP-0004 | +| G-CORE | core-hub traffic on hub-core; repo archived | CORE-WP-0010 | +| G-DISP | Inventory move/replace items on new owners | STATE-WP-0079 + owners | +| G-COMPAT | Consumer smokes (ops-hub, activity-core, agents) | CORE/HUB/ACTIVITY/OPS | +| G-FREEZE | Zero normal State Hub traffic window | STATE-WP-0079 + T06 | +| G-RETIRE | Backup/restore/history accepted; SH stopped | T06 + STATE-WP-0079 | + +Detailed measurable criteria: **SHR-WP-0001-T06**. + +--- + +## Predecessor / historical (do not re-open) + +| ID | Repo | Note | +| --- | --- | --- | +| CUST-WP-0057 | the-custodian | Three-repo ecosystem consolidation parent (historical) | +| HUB-WP-0003 | hub-core | Library lane — finished | +| CORE-WP-0009 | core-hub | hub-core adoption — finished | +| STATE-WP-0074 | state-hub | Boundary alignment — finished | +| ISSUE-WP-0004 | issue-core | Work-record alignment — finished | + +--- + +## How to use this map + +1. Implement only inside the child workplan’s repo. +2. Link progress back with `origin_ref: SHR-WP-0001` or progress events naming + the child WP id. +3. Do not duplicate child tasks into this project. +4. When a child WP finishes, hand residuals as live records; update this map’s + status column in a small follow-up edit. +5. New streams require a row here **and** a file in the owning repo. + +## Acceptance (T05) + +- [x] Every T04-suggested stream has a local workplan id and path +- [x] Dependencies and gates recorded without copying task lists +- [x] Predecessors identified +- [x] Child files created or confirmed present diff --git a/workplans/SHR-WP-0001-foundation.md b/workplans/SHR-WP-0001-foundation.md index c3b19c7..74d5c05 100644 --- a/workplans/SHR-WP-0001-foundation.md +++ b/workplans/SHR-WP-0001-foundation.md @@ -108,7 +108,7 @@ before fleet-normative; Tier 1 artefacts in hub-core child WP. ```task id: SHR-WP-0001-T05 -status: todo +status: done priority: high state_hub_task_id: "1fc9da32-14ed-46b6-a965-b2477414df78" ``` @@ -117,6 +117,11 @@ Create or identify local implementation workplans in `repo-manager`, `hub-core`, `core-hub`, `state-hub`, and other affected repositories. Record dependencies and project gates without duplicating their tasks here. +**Result (2026-08-09):** Map `architecture/child-workplan-map_v0.1.md` +(SHR-ARCH-MAP-0001). Streams: RMGR-WP-0001 (existing), HUB-WP-0004, +CORE-WP-0010, STATE-WP-0079, ACTIVITY-WP-0029, OPS-WP-0003, FIN-WP-0002 +(created proposed), gates G-ARCH…G-RETIRE. No child task lists copied here. + ## Baseline migration and retirement acceptance ```task @@ -137,5 +142,5 @@ in `GOAL.md` into executable or evidence-backed gates. - [x] The information and extension architectures are reviewable. - [x] Information architecture (T03) draft-reviewable - [x] Hub/extension architecture (T04) draft-reviewable -- [ ] Each implementation stream has one local owner and workplan. +- [x] Each implementation stream has one local owner and workplan. - [ ] Migration and retirement gates have measurable evidence requirements.