Skip to content

Artifact Contracts

Artifacts from bijux-canon-ingest become contracts when another reader, tool, or package depends on their names, layout, or semantics. Visible output alone is not enough; the stable artifact story has to be explicit.

What To Check

  • name the durable artifacts behind prepared records, chunk collections, and ingest artifacts
  • separate reviewable artifacts from local debug residue or incidental output
  • treat path, naming, or semantic drift as compatibility pressure when downstream readers rely on it

First Proof Check

  • src and boundary-facing modules for the owning implementation surface
  • apis/bijux-canon-ingest/v1/schema.yaml or tracked examples for the documented contract surface
  • tests for executable confirmation that the contract still holds

Bottom Line

If callers depend on bijux-canon-ingest for prepared ingest behavior, the contract needs to be named as clearly as the implementation.