---
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.