prj-state-hub-retirement/workplans/SHR-WP-0001-foundation.md

id	type	title	domain	repo	status	owner	topic_slug	created	updated	state_hub_workstream_id
SHR-WP-0001	workplan	Project foundation and architecture baseline	infotech	prj-state-hub-retirement	finished	codex	state-hub-retirement	2026-08-09	2026-08-09	8498db77-cbe1-48ff-b7f0-03b933f0aa8a

Project foundation and architecture baseline

Goal

Establish the durable project conventions, evidence inventories, architecture decisions, and child-repository workplan map required before implementation migration begins.

Confirm the project-repository convention

id: SHR-WP-0001-T01
status: done
priority: high
state_hub_task_id: "528ed9c9-57a6-4f44-b1cf-9d2c1a5cbca4"

Define the prj- repository flavor, lifecycle, required files, authority boundary, and archive procedure in the Custodian canon. Confirm that project repositories use GOAL.md rather than durable-product INTENT.md.

Result (2026-08-09): Fleet standard published at the-custodian/canon/standards/project-repository-flavor_v0.1.md. ADR-005 naming section points at the standard; classification standard §5.3 cross-links it; CUST-WP-0050 open question D1a marked resolved. Reference instance: this repository (prj-state-hub-retirement, GOAL.md only — no durable INTENT.md). Residual tooling gap: statehub register still scaffolds INTENT.md for ordinary repos — capture under a state-hub child workplan when T05 maps implementation streams (do not invent INTENT.md on prj- repos).

Inventory State Hub

id: SHR-WP-0001-T02
status: done
priority: high
state_hub_task_id: "f19351e4-c922-417c-bcc7-746a2cd7fe52"

Produce machine-readable inventories of State Hub routes, models, migrations, jobs, MCP tools, dashboard views, datasets, callers, and operational dependencies. Give every item an initial owner and keep/move/replace/retire disposition.

Result (2026-08-09): Initial inventory SHR-INV-0001 under inventory/ (425 items). Master file inventory/state-hub-disposition.yaml; rollup inventory/capabilities.yaml (51 capabilities); split views for routes, datasets, MCP tools, dashboard, jobs/callers/ops. Dispositions initial and revisable via T03/T04/T05. Baseline orientation counts from live summary (topics 14, workplans 868, tasks 5138, decisions 89). Open review points in inventory/README.md.

Define the information architecture

id: SHR-WP-0001-T03
status: done
priority: high
state_hub_task_id: "65e522c7-2550-4187-a308-a23a2bae7615"

Define canonical entities and relations plus the distinct semantics of events, signals, messages, conversations, requests, work, decisions, knowledge, and telemetry. Specify correlation, authority, provenance, sensitivity, retention, cost attribution, and transformation rules.

Result (2026-08-09): Draft-reviewable model SHR-ARCH-IA-0001 at architecture/information-model_v0.1.md + YAML companion. Eleven information kinds; entity/relation catalog with authority vs projection; cross-cutting rules; map from SHR-INV-0001 capabilities. Residual: human review before fleet canon/hub-core promotion; open questions listed for T04.

Define the hub and extension architecture

id: SHR-WP-0001-T04
status: done
priority: high
state_hub_task_id: "90e8350a-8a1c-4f46-a545-69c9cf00e6d1"

Revise the Orthogonal Architecture material into an implementable hub-core and domain-extension contract. Define domain hubs, functional components, authoritative services, projections, adapters, and conformance requirements.

Result (2026-08-09): Draft-reviewable SHR-ARCH-HUB-0001 at architecture/hub-extension-architecture_v0.1.md + contract outline hub-extension-contract_v0.1.yaml (helixforge.hub-extension v0.1). Taxonomy, ports, extension package, OA binding, conformance tiers 0–4, migration stack map, suggested T05 child streams. Residual: automated suite + human review before fleet-normative; Tier 1 artefacts in hub-core child WP.

Establish the child-workplan map

id: SHR-WP-0001-T05
status: done
priority: high
state_hub_task_id: "1fc9da32-14ed-46b6-a965-b2477414df78"

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-0003 (created proposed), gates G-ARCH…G-RETIRE. No child task lists copied here.

Baseline migration and retirement acceptance

id: SHR-WP-0001-T06
status: done
priority: medium
state_hub_task_id: "d793f242-999c-47ad-86f2-6d972cc20b84"

Record baseline row counts, callers, availability expectations, recovery paths, and historical-evidence requirements. Turn the success and retirement clauses in GOAL.md into executable or evidence-backed gates.

Result (2026-08-09): Baseline evidence/baseline-2026-08-09.yaml (SHR-EVID-BASELINE-0001): topics 14, workplans 887, tasks 5222, decisions 89, domains 14, repos 105. Gates architecture/retirement-gates_v0.1.md (SHR-ARCH-GATES-0001) map GOAL.md success + project retirement (P1–P6) to owners/evidence. G-IA and G-DISP met at foundation level; remaining gates open on child streams.

Acceptance

• The prj- flavor has a durable canonical definition.
• State Hub has a complete disposition inventory.
• The information and extension architectures are reviewable.
  • Information architecture (T03) draft-reviewable
  • Hub/extension architecture (T04) draft-reviewable
• Each implementation stream has one local owner and workplan.
• Migration and retirement gates have measurable evidence requirements.