109 lines
3.2 KiB
Markdown
109 lines
3.2 KiB
Markdown
---
|
|
id: SHR-WP-0001
|
|
type: workplan
|
|
title: "Project foundation and architecture baseline"
|
|
domain: infotech
|
|
repo: prj-state-hub-retirement
|
|
status: proposed
|
|
owner: codex
|
|
topic_slug: state-hub-retirement
|
|
created: "2026-08-09"
|
|
updated: "2026-08-09"
|
|
state_hub_workstream_id: "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
|
|
|
|
```task
|
|
id: SHR-WP-0001-T01
|
|
status: todo
|
|
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`.
|
|
|
|
## Inventory State Hub
|
|
|
|
```task
|
|
id: SHR-WP-0001-T02
|
|
status: todo
|
|
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.
|
|
|
|
## Define the information architecture
|
|
|
|
```task
|
|
id: SHR-WP-0001-T03
|
|
status: todo
|
|
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.
|
|
|
|
## Define the hub and extension architecture
|
|
|
|
```task
|
|
id: SHR-WP-0001-T04
|
|
status: todo
|
|
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.
|
|
|
|
## Establish the child-workplan map
|
|
|
|
```task
|
|
id: SHR-WP-0001-T05
|
|
status: todo
|
|
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.
|
|
|
|
## Baseline migration and retirement acceptance
|
|
|
|
```task
|
|
id: SHR-WP-0001-T06
|
|
status: todo
|
|
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.
|
|
|
|
## Acceptance
|
|
|
|
- [ ] The `prj-` flavor has a durable canonical definition.
|
|
- [ ] State Hub has a complete disposition inventory.
|
|
- [ ] The information and extension architectures are reviewable.
|
|
- [ ] Each implementation stream has one local owner and workplan.
|
|
- [ ] Migration and retirement gates have measurable evidence requirements.
|