sbom-nexus/workplans/SBOM-WP-0001-bootstrap-and-state-hub-extraction.md

id	type	title	domain	repo	status	owner	topic_slug	created	updated	parent_workplan	related
SBOM-WP-0001	workplan	Bootstrap SBOM Nexus and extract the State Hub SBOM product	infotech	sbom-nexus	active	codex	infotech	2026-08-22	2026-08-22	CUST-WP-0062	CUST-WP-0062 ACTIVITY-WP-0030 STATE-WP-0079 RMGR-WP-0008

Bootstrap SBOM Nexus and extract the State Hub SBOM product

Goal

Establish SBOM Nexus as a properly defined repository and deliver the first working vertical slice of the State Hub extraction: source scanning, immutable snapshot persistence, compatible queries and licence report, and bounded oldest-stale catch-up behavior.

Establish repository intent and conventions

id: SBOM-WP-0001-T01
status: done
priority: high

Write the repository identity, intent, scope, classification, development commands, and agent instructions; register and synchronize the repository.

Define product requirements

id: SBOM-WP-0001-T02
status: done
priority: high

Write an evidence-grounded PRD covering State Hub compatibility, snapshot authority, bounded catch-up, skip semantics, migration, and production gates.

Inventory and disposition the existing SBOM surface

id: SBOM-WP-0001-T03
status: done
priority: high

Review State Hub, Repo Manager, Activity Core, dashboard, MCP, scripts, models, and operational callers. Assign move, strangle, or retarget dispositions.

Extract the first service slice

id: SBOM-WP-0001-T04
status: done
priority: high

Implement the scanner, persistence, HTTP API, legacy compatibility routes, licence report, catch-up selection, and terminal skip behavior with tests.

Prepare cutover and historical migration

id: SBOM-WP-0001-T05
status: todo
priority: high

Add PostgreSQL migrations and the idempotent historical import/reconciliation runbook. Open and coordinate State Hub/Repo Manager/Activity Core child changes before any production authority switch.