Skip to content

feat(contracts): 🧠 stabilize Mindgarden v1 model - #24

Merged
szmyty merged 1 commit into
mainfrom
agent/v1-contracts
Aug 28, 2026
Merged

szmyty merged 1 commit into
mainfrom
agent/v1-contracts

Conversation

@szmyty

@szmyty szmyty commented Aug 28, 2026

Copy link
Copy Markdown
Contributor

Summary

  • add an additive contracts/v1/ registry with nine JSON Schema 2020-12 contracts covering common semantics, gardens, sources, knowledge, claims, typed synapses, ordered provenance, projections, and migration history
  • establish stable {garden, id} references with optional immutable Git/SHA-256/version revisions and reject mutable branch revisions
  • keep lifecycle, epistemic state, confidence, authorship, human review, classification, visibility, and publication authority independent
  • make raw sources, agent proposals, and unknown material private/unpublished/unreviewed by default while requiring approved allowlisted public projections
  • align ONTOLOGY.md, EPISTEMOLOGY.md, architecture, system inventory, and three new ADRs with the canonical v1 vocabulary
  • define non-destructive v0 → v1 compatibility and migration behavior without implementing issue Add deterministic garden initialization and migration #7's migrator or issue Harden validation and private-by-default publication gates #10's hardened validator
  • add 10 synthetic golden instances and 16 focused adversarial mutation cases covering privacy, provenance, identity, dates, relationships, extensions, review authority, routing references, migration history, and publication policy
  • package the v1 registry in wheel/sdist artifacts while retaining zero runtime dependencies and unchanged v0 CLI behavior

Verification

  • python -m unittest discover --start-directory tests --verbose — 40 passed
  • all nine schemas pass Draft202012Validator.check_schema
  • all golden instances validate through the complete local schema registry
  • all 16 adversarial cases fail for their expected JSON Schema keyword
  • wheel and source distributions build successfully
  • clean offline wheel installation includes share/mindgarden/contracts/v1/ and preserves the working v0 CLI
  • unpacked sdist suite passes (38 passed; two distribution-only checks skip because built artifacts are intentionally external)

Compatibility boundary

This PR stabilizes the v1 contract but does not claim v1 runtime support. Root v0 schemas and the 0.1 CLI remain unchanged until #7 implements deterministic init/migration and #10 implements complete v1 validation and privacy diagnostics.

Closes #9

Roadmap-Step: MIG-Q03

Define additive JSON Schema 2020-12 contracts for garden identity, sources, knowledge, claims, synapses, provenance, projections, and migration history. Align the ontology and architectural decisions, preserve v0 compatibility, and add executable golden and adversarial conformance fixtures.

Closes #9

Roadmap-Step: MIG-Q03
@szmyty
szmyty merged commit 07eda68 into main Aug 28, 2026
2 checks passed
@szmyty
szmyty deleted the agent/v1-contracts branch August 28, 2026 05:23
@devactivity-app

Copy link
Copy Markdown

Pull Request Summary by devActivity

Metrics

Achievements

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

Stabilize the Mindgarden v1 knowledge and provenance contracts

1 participant