generated from coulomb/repo-seed
tegwick
270065ff58
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).
107 lines
2.9 KiB
Markdown
107 lines
2.9 KiB
Markdown
---
|
|
id: capability.registry.validate
|
|
name: Registry Entry Validation
|
|
summary: Validate capability registry entries against schema, index consistency, and relation integrity.
|
|
owner: reuse-surface
|
|
status: draft
|
|
domain: helix_forge
|
|
tags: [registry, validation, cli]
|
|
|
|
maturity:
|
|
discovery:
|
|
current: D4
|
|
target: D5
|
|
confidence: medium
|
|
rationale: UC-RS-023 is implemented via reuse-surface validate with schema and drift checks.
|
|
availability:
|
|
current: A3
|
|
target: A3
|
|
confidence: high
|
|
rationale: Available as reuse-surface validate CLI command.
|
|
|
|
external_evidence:
|
|
completeness:
|
|
level: C3
|
|
name: Functional Core
|
|
confidence: medium
|
|
basis: scope_vs_intent_and_consumer_expectations
|
|
satisfied_expectations:
|
|
- schema validation for entry front matter
|
|
- index drift detection
|
|
- optional relation integrity checks
|
|
broken_expectations: []
|
|
out_of_scope_expectations:
|
|
- runtime validation of registered capability implementations
|
|
reliability:
|
|
level: R3
|
|
name: Usable
|
|
confidence: medium
|
|
basis: consumer_quality_signals
|
|
known_reliability_risks:
|
|
- requires local venv install
|
|
- relation warnings require explicit --relations flag
|
|
evidence:
|
|
satisfied_signals:
|
|
- validate --relations --fail-on-warnings in CI
|
|
- tests/test_registry.py schema and drift coverage
|
|
|
|
discovery:
|
|
intent: Keep registry data structurally sound so agents and humans can trust discovery metadata.
|
|
includes:
|
|
- JSON Schema validation
|
|
- index drift warnings
|
|
- relation reference checks
|
|
excludes:
|
|
- validating implementation code in other repos
|
|
use_cases:
|
|
- UC-RS-023
|
|
research_memos:
|
|
- specs/UseCaseCatalog.md
|
|
|
|
availability:
|
|
current_level: A3
|
|
target_level: A3
|
|
current_artifacts:
|
|
- reuse_surface/cli.py
|
|
- schemas/capability.schema.yaml
|
|
consumption_modes:
|
|
- cli
|
|
|
|
relations:
|
|
depends_on:
|
|
- capability.registry.register
|
|
supports: []
|
|
related_to:
|
|
- capability.registry.register
|
|
|
|
evidence:
|
|
documentation:
|
|
- tools/README.md
|
|
- .gitea/workflows/ci.yml
|
|
tests:
|
|
- tests/test_registry.py
|
|
consumer_feedback:
|
|
- >
|
|
reuse-surface CI: registry changes fail when schema validation or relation
|
|
checks warn with --fail-on-warnings, giving agents a dependable pre-merge gate.
|
|
|
|
consumer_guidance:
|
|
recommended_for:
|
|
- pre-commit and CI validation of registry changes
|
|
not_recommended_for:
|
|
- certifying business correctness of capability claims
|
|
known_limitations:
|
|
- warnings do not fail CI unless --fail-on-warnings is set
|
|
|
|
promotion_history:
|
|
- date: "2026-06-16"
|
|
dimension: reliability
|
|
from: R2
|
|
to: R3
|
|
rationale: CI fail-on-warnings and pytest registry coverage support dependable validation.
|
|
author: reuse-surface
|
|
---
|
|
|
|
# Registry Entry Validation
|
|
|
|
Validates registry shape and consistency through the reuse-surface CLI. |