generated from coulomb/repo-seed
Complete WP-0006 through WP-0009: registry expansion, catalog, graph, tests
Some checks failed
ci / validate-registry (push) Has been cancelled
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:
78
workplans/REUSE-WP-0006-registry-hygiene-and-coverage.md
Normal file
78
workplans/REUSE-WP-0006-registry-hygiene-and-coverage.md
Normal 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.
|
||||
54
workplans/REUSE-WP-0007-interactive-catalog.md
Normal file
54
workplans/REUSE-WP-0007-interactive-catalog.md
Normal 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`.
|
||||
42
workplans/REUSE-WP-0008-graph-explorer.md
Normal file
42
workplans/REUSE-WP-0008-graph-explorer.md
Normal 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`.
|
||||
55
workplans/REUSE-WP-0009-cli-hardening.md
Normal file
55
workplans/REUSE-WP-0009-cli-hardening.md
Normal 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`.
|
||||
54
workplans/REUSE-WP-0010-network-federation.md
Normal file
54
workplans/REUSE-WP-0010-network-federation.md
Normal 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.
|
||||
Reference in New Issue
Block a user