Clarify catalog projection terminology - #4
Merged
jonathanhefner merged 1 commit intoAug 28, 2026
Conversation
Frame identifier selection as catalog projection performed by a catalog operator, rather than only as registry behavior, and distinguish source Catalog Entries from source-system records. Name the `urn:air` identifier format explicitly and scope the ordered selection rules to first incorporation so later source changes remain governed by identifier stability rather than implicit artifact-equivalence assumptions.
jonathanhefner
marked this pull request as ready for review
August 28, 2026 15:59
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
Add this suggestion to a batch that can be applied as a single commit.This suggestion is invalid because no changes were made to the code.Suggestions cannot be applied while the pull request is closed.Suggestions cannot be applied while viewing a subset of changes.Only one suggestion per line can be applied in a batch.Add this suggestion to a batch that can be applied as a single commit.Applying suggestions on deleted lines is not supported.You must change the existing code in this line in order to create a valid suggestion.Outdated suggestions cannot be applied.This suggestion has been applied or marked resolved.Suggestions cannot be applied from pending reviews.Suggestions cannot be applied on multi-line comments.Suggestions cannot be applied while the pull request is queued to merge.Suggestion cannot be applied right now. Please check back later.
Summary
hostfieldurn:airIdentifier FormatMotivation
This responds to terminology and lifecycle questions raised during review of Agent-Card/ai-catalog#105.
The previous wording framed projection as registry-specific and embedded a stateful rule that presupposed the catalog could determine whether an arbitrary upstream identifier change still represented the same artifact. The revised wording describes the source and destination objects directly, applies the decision tree only when an entry is first incorporated, and leaves later changes governed by the existing identifier-stability requirement.
Scope
This PR does not introduce an official federation-origin extension. That proposal requires separate semantics for origin claims, trust, and chain traversal.
Review focus
hostValidation
/Users/jonathanhefner/Projects/ai-catalog/.venv/bin/mkdocs build --strict --site-dir /tmp/ai-catalog-issue-102-catalog-projection-site/Users/jonathanhefner/Projects/ai-catalog/.venv/bin/python tools/build_spec.py specification/ai-catalog.md /tmp/ai-catalog-issue-102-catalog-projection-spec.htmlgit diff --check