Skip to main content

Contract Governance

Documentation Map

Contract Governance

Tool / Contract Summary

This page defines the contract-governance boundary for jhf-bobbin. It exists to prevent local shadow truth when Bobbin consumes Fabric-, Dobby-, or runtime-owned semantics.

Business Value

  • keeps ownership boundaries explicit
  • helps deployment, QA, and downstream repos know which files are canonical here
  • reduces accidental redefinition of policy, lifecycle, or claims semantics

Bobbin-Owned Truth

Bobbin is the canonical owner for:

  • installer, reapply, rollback, and smoke tooling
  • stack/container/runtime contract files stored in this repo
  • package artifact metadata emitted by this repo
  • the machine-readable feature registry in MODULE_FEATURES.md (docs/MODULE_FEATURES.md)
  • repo-local metadata and status export scripts

Read-Only Consumed Truth

Bobbin must consume these as read-only:

  • Fabric governance families and accepted version truth
  • Fabric docs-standard truth
  • Fabric summary-export contract truth
  • Fabric runtime-claims and readiness truth
  • Fabric JARVIS adoption and readiness truth
  • Dobby artifact semantics outside Bobbin’s bounded enrichment contract

Explicit Non-Ownership

Bobbin must not become the source of truth for:

  • policy authority
  • proposal closure semantics
  • canonical actor/claims taxonomy
  • tenant/identity lifecycle truth
  • raw support-event recall truth

Canonical Local Files

  • ../fabric-manifest.json (fabric-manifest.json)
  • ../configs/stack-contract.json (configs/stack-contract.json)
  • MODULE_FEATURES.md (docs/MODULE_FEATURES.md)
  • API.md
  • STACK_CONTAINER_CONTRACT.md (docs/STACK_CONTAINER_CONTRACT.md)
  • Fabric Tool Profile (docs/FABRIC_TOOL_PROFILE.md)
  • Integrations
  • Memory Policy and Claims Consumption (docs/MEMORY_POLICY_AND_CLAIMS_CONSUMPTION.md)
  • Support Recall Contract (docs/SUPPORT_RECALL_CONTRACT.md)
  • Dobby Marked Provenance Contract (docs/DOBBY_MARKED_PROVENANCE_CONTRACT.md)

AGPLv3. See ../LICENSE (LICENSE).

Learn more at helpifyr.com.