# 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: <artifact-slug>-v<major>. 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 = "f1fdfdb6914c7b20"
pinned_at = "2026-05-17T05:30:00+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"