# Self-pin manifest for the corviduo-project-template repository. # # This template is the canonical home for cross-cutting Corviduo specs and # tooling. The pins below declare which artifacts this repository owns as # canonical (consumer_path == canonical_path; canonical_source == this repo). # # Operational effect: # - `python scripts/canonical_sync.py` here is a no-op (every pin's # pinned_sha256_16 == sha256_16(canonical), so nothing to write). # - `python scripts/canonical_drift.py` here passes if every named # canonical exists and is byte-identical to its pinned hash. Useful as a # CI gate to catch accidental rewrites of a canonical artifact without a # companion pin-bump in this manifest. # # Operators bootstrapping a new consumer can copy this file as a starting # template, then adjust each pin's `consumer_path` to wherever they keep # their downstream copy (often the same path). # # Pin-id naming convention: -v. Bump major when the # canonical's shape changes in a way that requires consumer adaptation # (not on every pin-bump). The pinned_sha256_16 + pinned_at fields track # point-in-time identity within a major version. # --------------------------------------------------------------------------- # Specifications (cross-language; all consumers should pin) # --------------------------------------------------------------------------- [[pins]] id = "contract-format-v2" canonical_source = "corviduo-project-template" canonical_path = "docs/contracts/CONTRACT-FORMAT.md" consumer_path = "docs/contracts/CONTRACT-FORMAT.md" pinned_sha256_16 = "f2f2f37072ebbc6b" pinned_at = "2026-05-15T22:00:00+00:00" [[pins]] id = "principles-v1" canonical_source = "corviduo-project-template" canonical_path = "PRINCIPLES.md" consumer_path = "PRINCIPLES.md" pinned_sha256_16 = "c5bd891601438635" pinned_at = "2026-05-15T22:00:00+00:00" [[pins]] id = "methodology-v1" canonical_source = "corviduo-project-template" canonical_path = "docs/methodology.md" consumer_path = "docs/methodology.md" pinned_sha256_16 = "acb7d7cfb390be20" pinned_at = "2026-05-17T14:52:08+00:00" # --------------------------------------------------------------------------- # Canonical-sync tooling (the meta-recursion: these pin themselves) # --------------------------------------------------------------------------- [[pins]] id = "canonical-sync-v1" canonical_source = "corviduo-project-template" canonical_path = "scripts/canonical_sync.py" consumer_path = "scripts/canonical_sync.py" pinned_sha256_16 = "d2b2c27b2750c6d5" pinned_at = "2026-05-17T05:30:00+00:00" [[pins]] id = "canonical-drift-v1" canonical_source = "corviduo-project-template" canonical_path = "scripts/canonical_drift.py" consumer_path = "scripts/canonical_drift.py" pinned_sha256_16 = "71281ac8dad7d6c0" pinned_at = "2026-05-17T05:30:00+00:00" # --------------------------------------------------------------------------- # Contract meta-tooling (Python ≥3.11, stdlib-only; invoke via uv run in # non-Python projects) # --------------------------------------------------------------------------- [[pins]] id = "contract-parser-v2" canonical_source = "corviduo-project-template" canonical_path = "docs/contracts/contract_parser.py" consumer_path = "docs/contracts/contract_parser.py" pinned_sha256_16 = "e10a4460ba9fd560" pinned_at = "2026-06-15T08:53:22+00:00" [[pins]] id = "contract-drift-check-v1" canonical_source = "corviduo-project-template" canonical_path = "scripts/contract_drift_check.py" consumer_path = "scripts/contract_drift_check.py" pinned_sha256_16 = "23271287ac488da4" pinned_at = "2026-05-17T05:30:00+00:00" # --------------------------------------------------------------------------- # Worldtree Conversation-API surface (vendored from ~/development/Worldtree). # The v1 wire is FROZEN (Worldtree #326 / v1-schema-freeze-manifest.md). The # machine-readable OpenAPI + SSE schema are the authoritative drift GATES; the # prose markdown is the human reference and is allowed to lag (tolerate_drift). # These are what ratatoskr's v1 coverage map (docs/coverage-map.md) audits # against. Pin target: Worldtree 5810a26 (v1.0.0b2). # --------------------------------------------------------------------------- [[pins]] id = "worldtree-conversation-api-openapi-v2" canonical_source = "Worldtree" canonical_path = "docs/conversation-api-openapi.json" consumer_path = "docs/conversation-api-openapi.json" pinned_sha256_16 = "dbdf4e24c8b06c92" pinned_at = "2026-06-30T22:25:56+00:00" [[pins]] id = "worldtree-conversation-api-sse-events-v1" canonical_source = "Worldtree" canonical_path = "docs/conversation-api-sse-events.schema.json" consumer_path = "docs/conversation-api-sse-events.schema.json" pinned_sha256_16 = "9deeebf404d72f9a" pinned_at = "2026-06-30T22:25:56+00:00" [[pins]] id = "worldtree-conversation-api-spec-v1" canonical_source = "Worldtree" canonical_path = "docs/conversation-api-spec.md" consumer_path = "docs/conversation-api-spec.md" pinned_sha256_16 = "2d111a3b8322b7d1" pinned_at = "2026-06-30T22:25:56+00:00" tolerate_drift = true # prose reference; OpenAPI+SSE are the gates # Worldtree persona render canons (d2) — the deterministic affect->NL the agent is # context-injected. The web persona pane renders mood + relationship-directive BYTE-EXACT # from these (via the flat src/ratatoskr/web/static/persona_render_canon.json, regenerated # by scripts/build_persona_canon.py). Drift here => rerun that regen with Worldtree's venv. [[pins]] id = "worldtree-persona-mood-render-canon-v1" canonical_source = "Worldtree" canonical_path = "core/persona/canon/d2-mood-render-canon-v1.json" consumer_path = "docs/vendor/worldtree-persona-canon/d2-mood-render-canon-v1.json" pinned_sha256_16 = "e2f124fed3ee8d42" pinned_at = "2026-07-01T21:00:00+00:00" [[pins]] id = "worldtree-persona-d2-render-canon-v1" canonical_source = "Worldtree" canonical_path = "core/persona/canon/d2-render-canon-v1.json" consumer_path = "docs/vendor/worldtree-persona-canon/d2-render-canon-v1.json" pinned_sha256_16 = "606bba5fdcc60b6b" pinned_at = "2026-07-01T21:00:00+00:00"