Skip to content

registry: document and validate hybrid registry discovery posture#107

Merged
mdheller merged 3 commits into
mainfrom
work/registry-discovery-posture-v0
May 22, 2026
Merged

registry: document and validate hybrid registry discovery posture#107
mdheller merged 3 commits into
mainfrom
work/registry-discovery-posture-v0

Conversation

@mdheller
Copy link
Copy Markdown
Member

Summary

Implements the #93 registry-posture decision as an explicit hybrid discovery model instead of leaving supplemental registries as ambiguous transitional artifacts.

Adds

  • docs/registry-discovery-posture.md

    • states that catalog/registry.ttl remains the primary registry
    • states that supplemental registry files under catalog/ are first-class discovery inputs for now
    • defines consumer discovery rule for registry.ttl, *registry*.ttl, and *.registry.ttl
    • states release guidance: consumers must read primary plus supplemental registries until normalization is complete
  • scripts/validate_registry_discovery.py

    • discovers registry-like Turtle files under catalog/
    • parses them
    • finds og:Module records
    • fails if no module records are found
    • fails if a discovered module record lacks og:path
  • Makefile

    • adds validate-registry-discovery
    • wires it into make validate

Registry posture

This PR does not force a central-only registry migration. It codifies the current state as:

hybrid-discovery-now, normalization-decision-later

A future normalization PR can still fold supplemental registry entries into catalog/registry.ttl or permanently adopt hybrid discovery.

Validation policy

Let CI run. If the new validator exposes malformed registry records, remediate them instead of weakening discovery semantics.

Related

Closes #93 after merge if validation passes.

@mdheller mdheller merged commit baf9496 into main May 22, 2026
8 checks passed
mdheller added a commit that referenced this pull request May 22, 2026
Updates the v0.2.0 release note for current main and #92.

Changes:
- records current base commit baf9496
- records merged scope through #107
- records #93 / #107 registry posture resolution
- points consumers to docs/registry-discovery-posture.md
- lists remaining non-release-blocking follow-ups

Validation before merge:
- CI: success
- validate: success
- semantic-import-contract: success
- no-raster-images: success
- RDF parse: success
- SHACL gates: success
- JSON-LD roundtrip: success
- dist + ledger verify: success
- SPDX SBOM: success

Updates #92.
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

Normalize supplemental registry tranches after v0.2.0 validation

1 participant