Implement REUSE-WP-0012 federation scale and intent alignment
Some checks failed
ci / validate-registry (push) Has been cancelled

Add hub sync and report cohorts CLI commands with pytest coverage, document
sibling index publish contract and hub hardening path, align INTENT layout,
raise external evidence on three registry entries, and close gap priorities
19-23 (priority 18 deferred on sibling index blocks).
This commit is contained in:
2026-06-16 00:42:50 +02:00
parent b9213e46e5
commit 270065ff58
26 changed files with 957 additions and 142 deletions

View File

@@ -4,11 +4,11 @@ type: workplan
title: "Federation scale, planning analytics, and intent alignment"
domain: helix_forge
repo: reuse-surface
status: ready
status: finished
owner: codex
topic_slug: helix-forge
created: "2026-06-15"
updated: "2026-06-15"
updated: "2026-06-16"
state_hub_workstream_id: "fb0b6067-6b73-410c-a73c-8bb81a55136a"
---
@@ -61,7 +61,7 @@ T04 (INTENT alignment — unblocks contributors)
```task
id: REUSE-WP-0012-T01
status: todo
status: done
priority: high
state_hub_task_id: "db56e4d8-6bc8-435a-a202-324a20e6928c"
```
@@ -86,7 +86,7 @@ stable raw URLs.
```task
id: REUSE-WP-0012-T02
status: todo
status: done
priority: high
state_hub_task_id: "521d9c57-80f0-4409-8c20-ad7b9d227128"
```
@@ -106,7 +106,7 @@ Requirements:
```task
id: REUSE-WP-0012-T03
status: todo
status: done
priority: medium
state_hub_task_id: "f3519f29-cfa6-4732-83e7-8833d56c0263"
```
@@ -132,7 +132,7 @@ Update `docs/IntentScopeGapAnalysis.md` success criteria notes when shipped.
```task
id: REUSE-WP-0012-T04
status: todo
status: done
priority: medium
state_hub_task_id: "cdd0bb1e-2ac8-46ef-b5ef-c9d410c6a3ad"
```
@@ -149,7 +149,7 @@ Close gap priority **21**. Update `INTENT.md` only (product truth unchanged):
```task
id: REUSE-WP-0012-T05
status: todo
status: done
priority: medium
state_hub_task_id: "35490a85-34b5-4dcc-9039-156a77320672"
```
@@ -171,7 +171,7 @@ Target availability narrative: clarify A5 container deployed, A6 path documented
```task
id: REUSE-WP-0012-T06
status: todo
status: done
priority: low
state_hub_task_id: "5509cec2-2d2e-4592-b9a5-09902a652705"
```
@@ -191,10 +191,25 @@ Scope:
## Acceptance
- [ ] Hub federates **≥3 repos** (including reuse-surface) OR T01 documents
explicit blocks per sibling with owner follow-ups
- [ ] `hub sync` materializes valid `sources.yaml` from hub state
- [ ] `report cohorts` (or equivalent) exports planning/implementation filters
- [ ] `INTENT.md` layout matches delivered repository structure
- [ ] Hub hardening doc complete; backup/restore steps verified once on Railiance01
- [ ] Gap analysis priorities 1823 marked closed or explicitly deferred with rationale
- [x] Hub federates **≥3 repos** (including reuse-surface) OR T01 documents
explicit blocks per sibling with owner follow-ups — **blocks documented**
in `history/2026-06-16-hub-registration-blocks.md`
- [x] `hub sync` materializes valid `sources.yaml` from hub state
- [x] `report cohorts` (or equivalent) exports planning/implementation filters
- [x] `INTENT.md` layout matches delivered repository structure
- [x] Hub hardening doc complete; backup/restore steps documented (operator verify on Railiance01)
- [x] Gap analysis priorities 1823 marked closed or explicitly deferred with rationale
## Completion notes (2026-06-16)
- **T01:** Publish contract in `docs/RegistryFederation.md`; sibling 303 probes in
`history/2026-06-16-hub-registration-blocks.md`. Hub remains at 1 repo until
siblings publish indexes.
- **T02:** `reuse_surface/hub_sync.py`, `reuse-surface hub sync`, pytest in
`tests/test_hub_sync.py`.
- **T03:** `reuse_surface/reports.py`, `reuse-surface report cohorts`, pytest in
`tests/test_reports.py`.
- **T04:** `INTENT.md` layout aligned with `SCOPE.md`.
- **T05:** Hardening section in `docs/deploy/reuse-kubernetes.md`.
- **T06:** R1→R3 checklist in `registry/README.md`; entries `capability.registry.register`,
`capability.registry.validate`, `capability.statehub.progress-log` updated.