Files

tegwick 0dbef6d1a3 Complete REUSE-WP-0003: registry CLI, docs alignment, and coverage

Align INTENT.md with delivered layout, add CapabilityRegistryConcept guide,
extend schema with promotion_history, ship reuse-surface validate/query/export
CLI, register three more helix_forge capabilities, and refresh SCOPE and gap
analysis to reflect A3 tooling and D5/A3/C4/R2 self-assessment.

2026-06-15 01:12:09 +02:00

1.6 KiB

Raw Blame History

Registry Tools

CLI tooling for the capability registry, implemented in reuse_surface/.

Install

python3 -m venv .venv
.venv/bin/pip install -e .

Commands

validate

Validate one entry or the full registry against schemas/capability.schema.yaml and warn on index drift.

reuse-surface validate
reuse-surface validate registry/capabilities/capability.registry.register.md

query

Filter the capability index by maturity, tags, domain, consumption mode, or keyword.

reuse-surface query --discovery-min D4
reuse-surface query --availability-min A3
reuse-surface query --tag identity
reuse-surface query --consumption-mode cli
reuse-surface query --keyword rollout

export

Export a machine-readable bundle combining index rows and parsed entry front matter.

reuse-surface export
reuse-surface export --format json

Export format

The export bundle includes:

version, domain, updated from the index
capabilities[] with { index, entry } pairs

Stable IDs and maturity fields are preserved for agent consumption (UC-RS-019).

Workflows

Workflow	Command
Add capability	template + index update + `reuse-surface validate`
Discover capabilities	`reuse-surface query` or read the index
Validate entry shape	`reuse-surface validate`
Export for agents	`reuse-surface export --format json`

UC-RS-013 — Use registry metadata in agentic coding
UC-RS-019 — Publish a machine-readable registry export
UC-RS-023 — Validate registry entries against schema

1.6 KiB Raw Blame History