Complete WP-0006 through WP-0009: registry expansion, catalog, graph, tests
Some checks failed
ci / validate-registry (push) Has been cancelled

Register six new capabilities (12 total), add searchable catalog UI and graph
explorer, introduce pytest suite with CI fail-on-warnings, and close gap
analysis priorities 13 and 16. WP-0010 remains backlog for network federation.
This commit is contained in:
2026-06-15 02:24:20 +02:00
parent 399690a5b6
commit e766f38e6f
30 changed files with 1632 additions and 80 deletions

View File

@@ -0,0 +1,78 @@
---
id: REUSE-WP-0006
type: workplan
title: "Registry hygiene and coverage expansion"
domain: helix_forge
repo: reuse-surface
status: finished
owner: codex
topic_slug: helix-forge
created: "2026-06-15"
updated: "2026-06-15"
state_hub_workstream_id: "d3d0b3ae-dedc-48bc-a6d2-16975e10acc3"
---
# Registry hygiene and coverage expansion
Close broken relation references, register missing adjacent capabilities, and
expand helix_forge registry coverage so `reuse-surface graph --check` and
`validate --relations` run clean.
## Register Missing Relation Targets
```task
id: REUSE-WP-0006-T01
status: done
priority: high
state_hub_task_id: "183b42ae-7773-484f-afe7-4966e26f1768"
```
Register three capabilities referenced by existing relations but not yet in the
index:
- `capability.registry.validate`
- `capability.feature-control.visibility`
- `capability.statehub.progress-log`
Each entry must pass validation and appear in the index.
## Expand helix_forge Coverage
```task
id: REUSE-WP-0006-T02
status: done
priority: high
state_hub_task_id: "3c6b4e4a-07c0-4a06-a64b-f152f8bdb35d"
```
Register at least three additional helix_forge capabilities from adjacent repos:
- `capability.authorization.policy-evaluate` (flex-auth)
- `capability.activity.event-coordinate` (activity-core)
- `capability.audit.event-retain` (audit-core)
Illustrate distinct vectors and link relations where appropriate.
## Regenerate Derived Artifacts
```task
id: REUSE-WP-0006-T03
status: done
priority: medium
state_hub_task_id: "417e7a0d-2bdd-43fd-8604-3d48cc1fc083"
```
Run and commit outputs from `federation compose`, `graph`, `catalog`, and
`export`. Confirm `validate --relations` reports no broken references.
## Update Documentation
```task
id: REUSE-WP-0006-T04
status: done
priority: medium
state_hub_task_id: "9e061f46-5de8-4cf7-a7f1-b0e886391b7d"
```
Update `SCOPE.md` capability inventory and `docs/IntentScopeGapAnalysis.md`
self-assessment after coverage growth.

View File

@@ -0,0 +1,54 @@
---
id: REUSE-WP-0007
type: workplan
title: "Interactive capability catalog"
domain: helix_forge
repo: reuse-surface
status: finished
owner: codex
topic_slug: helix-forge
created: "2026-06-15"
updated: "2026-06-15"
state_hub_workstream_id: "1afa1322-7d60-41aa-bf7e-3ef29bb4d3a5"
---
# Interactive capability catalog
Close gap analysis priority 13 (UC-RS-018 enhancement). Build a static,
searchable catalog UI over exported registry data.
## Add Catalog Site Generator
```task
id: REUSE-WP-0007-T01
status: done
priority: high
state_hub_task_id: "84c56268-2e0b-42e6-b20e-6fbf059dcc20"
```
Extend `reuse-surface catalog` (or add `catalog site`) to emit
`docs/catalog/registry.json` alongside existing MD/HTML outputs.
## Build Searchable Catalog UI
```task
id: REUSE-WP-0007-T02
status: done
priority: high
state_hub_task_id: "d587bc50-adb2-424a-a9d3-600a2ec5ba9b"
```
Create `docs/catalog/search.html` with client-side filter by name, summary, tags,
vector, and consumption mode. No backend required.
## Wire Catalog Into CI And Docs
```task
id: REUSE-WP-0007-T03
status: done
priority: medium
state_hub_task_id: "eca7438c-3c2f-4027-9b40-67df5f17aca7"
```
Update CI to regenerate catalog artifacts, document browsing in
`docs/CapabilityRegistryConcept.md` and `SCOPE.md`.

View File

@@ -0,0 +1,42 @@
---
id: REUSE-WP-0008
type: workplan
title: "Interactive relation graph explorer"
domain: helix_forge
repo: reuse-surface
status: finished
owner: codex
topic_slug: helix-forge
created: "2026-06-15"
updated: "2026-06-15"
state_hub_workstream_id: "63f8a2da-d179-4875-8cff-40a0fa2ca067"
---
# Interactive relation graph explorer
Close gap analysis priority 16. Provide a browsable HTML view of
`docs/graph/capability-graph.mmd` for architects (UC-RS-016).
## Add Graph Explorer Page
```task
id: REUSE-WP-0008-T01
status: done
priority: high
state_hub_task_id: "2d08de47-d3c0-484f-a945-9691da9688e4"
```
Create `docs/graph/index.html` that renders the Mermaid graph in-browser with
node labels and a legend for relation types.
## Integrate Graph Generation
```task
id: REUSE-WP-0008-T02
status: done
priority: medium
state_hub_task_id: "ada96492-88d0-438e-8d2b-ae0fdd8abb06"
```
Ensure `reuse-surface graph` documents and regenerates both `.mmd` and the
explorer page dependency. Update `registry/README.md` and `AGENTS.md`.

View File

@@ -0,0 +1,55 @@
---
id: REUSE-WP-0009
type: workplan
title: "CLI hardening and test suite"
domain: helix_forge
repo: reuse-surface
status: finished
owner: codex
topic_slug: helix-forge
created: "2026-06-15"
updated: "2026-06-15"
state_hub_workstream_id: "9121d16f-879f-4db3-9df6-06f7543481d8"
---
# CLI hardening and test suite
Raise registry tooling reliability toward R3 with automated tests and stricter
CI gates after WP-0006 relation hygiene.
## Add pytest Suite
```task
id: REUSE-WP-0009-T01
status: done
priority: high
state_hub_task_id: "57d0869a-38bb-409a-b5b1-b3c73ff31a96"
```
Add `tests/` covering validate, query, export, overlaps, federation compose,
graph, and catalog commands. Add `[dev]` optional deps and document
`.venv/bin/pytest` in `AGENTS.md`.
## Add Fail-On-Warnings Flags
```task
id: REUSE-WP-0009-T02
status: done
priority: high
state_hub_task_id: "d10fde06-e09b-4292-b6c8-ced5e5ef213c"
```
Add `--fail-on-warnings` to `validate` and `graph --check`. Use in CI once
WP-0006 relation hygiene is complete.
## Tighten CI Pipeline
```task
id: REUSE-WP-0009-T03
status: done
priority: medium
state_hub_task_id: "79c0fa70-7ec1-4762-9a7c-9783f0997016"
```
Update `.gitea/workflows/ci.yml` to run pytest and fail on relation warnings.
Record reliability evidence on `capability.registry.register`.

View File

@@ -0,0 +1,54 @@
---
id: REUSE-WP-0010
type: workplan
title: "Network federation for remote indexes"
domain: helix_forge
repo: reuse-surface
status: backlog
owner: codex
topic_slug: helix-forge
created: "2026-06-15"
updated: "2026-06-15"
state_hub_workstream_id: "da812165-d56e-47fa-9901-bb3747522ec4"
---
# Network federation for remote indexes
Close gap analysis priority 15. Extend federation beyond filesystem paths to
fetch capability indexes from HTTP URLs or git raw endpoints.
## Extend Federation Schema For URLs
```task
id: REUSE-WP-0010-T01
status: todo
priority: medium
state_hub_task_id: "6f181057-e0f7-4879-9eb9-928a527a01ee"
```
Extend `schemas/federation.schema.yaml` and manifest format to support `url`
sources alongside `index` file paths, with optional auth and TTL metadata.
## Implement Remote Index Fetch
```task
id: REUSE-WP-0010-T02
status: todo
priority: medium
state_hub_task_id: "a2fac7d5-9383-4a42-bd23-3e8dbc7d550b"
```
Add HTTP fetch to `federation compose` with local cache under
`registry/federation/cache/`. Clear errors when remote source unavailable.
## Document Federation Operations
```task
id: REUSE-WP-0010-T03
status: todo
priority: low
state_hub_task_id: "73996193-ecae-4fb4-84f7-fe84a5cd8898"
```
Update `docs/RegistryFederation.md` with remote source examples and agent
guidance for cross-repo discovery without local checkout.