Skip to content

v0.27.0 — portable contracts + ARD publish path

Choose a tag to compare

View all tags
@flyersworder flyersworder released this 28 Jun 19:22
· 54 commits to main since this release
v0.27.0
3781c5e

Portable, self-contained contracts + Agentic Resource Discovery (ARD) publish path

Added

  • DataContract.freeze_semantic_source() — snapshots a contract's semantic source inline (metrics, relationships, metric-impacts, table column-schemas) so a serialized contract enforces identically on any machine with no filesystem access to the original dbt/Cube/YAML source. Freezing clears the machine-specific path and normalizes type, so the content address is reproducible across machines and leaks no local paths. New YamlSource.from_raw() ↔ dump_semantic_source() inverse pair — frozen snapshots are source-type-agnostic (dbt/Cube normalize to the canonical YAML-source shape).
  • New agentic_data_contracts.ard module — build_catalog_entry() / build_ai_catalog() emit a spec-valid Agentic Resource Discovery ai-catalog.json entry for a contract-governed MCP server, with the frozen contract pinned as a digest-addressed data-contract attestation in the trust manifest. contract_canonical_bytes() / contract_digest() produce the content-addressable artifact a consumer independently recomputes — so the publish→verify loop closes with no trust in the publisher's assertion.

Breaking (fail-loud)

  • A declared-but-unavailable semantic source now raises SemanticSourceUnavailableError (a new top-level export, deliberately not a FileNotFoundError subclass) instead of a bare FileNotFoundError — covering missing file, a directory path, a permission error, malformed YAML, and malformed dbt JSON — so enforcement never silently degrades off the authoring box. Migration: code that caught FileNotFoundError around contract/tool construction should catch SemanticSourceUnavailableError.
  • The SemanticSource protocol gains get_table_schemas() (affects only third-party custom sources that are frozen). SemanticSource.path is now optional, gated by a validator requiring path-or-inline.
  • Existing contracts and the common path (source present, or letting errors propagate) are unaffected.

Built TDD red-first and hardened by two independent code-review passes. 688 tests green; ruff + ty clean. Full details in CHANGELOG.md.

Assets 2
Loading