hub-core/workplans/HUB-WP-0006-repository-classification-navigation.md
repo-manager f49e59bb01
Some checks failed
CI Smoke / host-smoke (push) Successful in 0s
CI Smoke / pytest-smoke (push) Failing after 2s
chore(registrar): assign State Hub identifiers
Assistant: codex
Assistant-Model: gpt-5.6-sol
Assistant-Session: 01a0230c-b06c-7641-808a-e191b6d1da49
2026-08-22 00:15:09 +02:00

3.9 KiB

id type title domain repo status owner topic_slug created updated parent_project parent_workplan related state_hub_workstream_id
HUB-WP-0006 workplan Repository classification aggregation and navigation infotech hub-core active codex custodian 2026-08-22 2026-08-22 prj-state-hub-retirement STATE-WP-0079
HUB-WP-0004
HUB-WP-0005
RMGR-WP-0008
RMGR-CONTRACT-CLASSIFICATION-0001
c5abf6a3-0ea9-43b8-8757-179829dd8a9c

Repository classification aggregation and navigation

Goal

Consume Repo Manager's validated repository-classification projections and provide rebuildable cross-domain aggregation/navigation without creating a second classification authority. Supply the hub-core receiving surface needed for State Hub retirement slices A5 and the repository-facing part of A4/B5.

Accept the classification projection boundary

id: HUB-WP-0006-T01
status: done
priority: high
state_hub_task_id: "b1e2fe24-8a38-4672-a7a7-4a45f90355fb"

Review RMGR-CONTRACT-CLASSIFICATION-0001 version 1.0 and record the hub-core authority, validation, versioning, provenance, failure, and A5 routing boundary.

Completed 2026-08-22. docs/adr/ADR-0002-repository-classification-projections.md accepts the contract without a schema gap. Repository files remain authority; Repo Manager validates and publishes; hub-core derives navigation only; and STATE-WP-0079 retains the consumer-route switch and rollback flag.

Freeze the hub-side projection contract

id: HUB-WP-0006-T02
status: todo
priority: high
state_hub_task_id: "47d7d168-217f-45c6-b4d7-ab9cf4dd5329"

Define the input envelope, supported contract versions, stable repository identity, cursor/snapshot semantics, provenance, diagnostics, and the derived domain/category/tag/stake/mechanic views. Define legacy topic aliases as temporary compatibility metadata, not mutable topic authority.

Implement Repo Manager ingestion and rebuild

id: HUB-WP-0006-T03
status: todo
priority: high
state_hub_task_id: "2884eb0f-046f-4122-a422-8a06c7c32298"

Add an injected port.repo client, deterministic full rebuild plus incremental upsert/delete behavior, durable PostgreSQL projection tables, content hashes, and dependency-aware readiness. Reject invalid or unsupported projection versions without coercion.

Expose projection query and MCP navigation

id: HUB-WP-0006-T04
status: todo
priority: high
state_hub_task_id: "a1d85610-c3ea-4718-b394-ba4abcecf177"

Expose cross-repository query routes and MCP tools for domain, secondary domain, category, capability tag, business stake, and business mechanic. Responses carry source revision and rebuild provenance. No endpoint writes classification authority.

Prove conformance and failure behavior

id: HUB-WP-0006-T05
status: todo
priority: medium
state_hub_task_id: "a3c0efba-9913-4617-b167-8853b34de36e"

Add contract fixtures and checks for full rebuild, incremental changes, deletion, duplicate delivery, unsupported versions, Repo Manager outage, stable ordering/cursors, provenance, and absence of classification writes or foreign database access.

Hand A5/A4 navigation to State Hub retirement

id: HUB-WP-0006-T06
status: wait
priority: high
state_hub_task_id: "5c6f3006-b1c7-422b-ad38-8727ae4dc7c2"

With STATE-WP-0079, compare legacy topic/navigation consumers with the new projection, retain explicit aliases where required, run owned consumer smokes, switch A5 through RM_SLICE_TOPICSPINE, and record rollback plus residual expiry. Wait on T02-T05 and the State Hub cutover window.

Acceptance

  • Repo Manager v1.0 authority and projection contract accepted
  • Hub-side projection and compatibility alias contract versioned
  • Rebuildable durable ingestion passes provenance and failure checks
  • HTTP/MCP navigation reads only the derived projection
  • A5/A4 consumer comparison and rollback evidence recorded