Resolve #58: Add ADR-0017 and migrate to namespace extensions map

Merged
MI
3mo ago
+92-34

Summary

This PR formally resolves Issue #58 (Proposal for JSON-LD @context Namespaces) by implementing the consensus reached during the July 2 and July 9 Working Group meetings and also comments on that issue.

To preserve the AI-Catalog's minimalist parser and avoid the complexity of JSON-LD graph resolution, the TSC agreed to reject the @context proposal. Instead, we are adopting a loosely coupled architecture with the Agentic Resource Discovery (ARD) specification and replacing the legacy metadata property with a strict extensions array.

Changes Included

  1. Added ADR-0017: Documents the decision to loosely couple ARD and AI-Catalog, preserving AI-Catalog as a strictly-typed "publishing format" while allowing ARD to evolve independently as a rich "discovery format."
  2. Updated ai-catalog.md:
    • Removed the legacy metadata property from the Catalog Entry, Trust Manifest, and root schemas.
    • Introduced the extensions array mechanism.
    • Rewrote the Extensibility section to enforce reverse-DNS/URL keys for extension boundaries.

Motivation

This architecture allows AI-Catalog to remain a lightweight, fast "thin pointer," while freeing downstream aggregators (like ARD) to build the complex semantic envelopes they need for federated discovery without forcing those requirements into the base protocol.

Closes #58