vh
9703eb2b6b
Worldtree Conversation API debug TUI. Multi-pane observability dashboard: chat transcript + persona/Vili affect log + tool events + admin events + Bifrost state + tool inventory + (opt-in) raw server log. Design locked at docs/design-brief.md (originated as brokkr-smithy/docs/ratatoskr-design-brief.md). Operator-locked decisions: - Textual application-shell framework (multi-pane dashboard, not REPL). - Separate repo + separate dev team (no Worldtree-source imports). - httpx-sse for SSE consumption (reference Python SSE-resume impl). - Triple version-skew mitigation: spec-pin in pyproject.toml + recorded SSE snapshot tests + conformance smoke. Initial pin: Worldtree v0.19.0 at 55101e909abcd2219833266b6f905c5bc956e0f0. - Persona pane: label-don't-refuse PII posture. - Server-log pane: opt-in via --server-log <path>. - Two-stage Ctrl-C (cancel then exit). - Markdown rendering default-on; --raw opt-out. In the box: - docs/design-brief.md — the locked design with full rationale. - docs/SPEC-PIN.md — Worldtree spec pin + bump procedure. - docs/conversation-api-spec.md + docs/conversation_api.contract.md — vendored Worldtree spec snapshots at the pinned SHA. - pyproject.toml — Python 3.12, hatchling, uv-managed, deps locked. - src/ratatoskr/ — stub package (cli.py raises NotImplementedError). - tests/test_no_worldtree_imports.py — boundary smoke test PASSING. - tests/snapshots/README.md — recording convention for SSE snapshot tests. Not in the box yet: - Gitea remote (operator/infra-ops to register at vh/ratatoskr). - Implementation — the dev team owns this; design brief is the spec. Origin: althing thread 01KS3R34XD3N6HMK91VXESHGW7 (worldtree-dev → brokkr-smithy-dev, 2026-05-20). Volva consulted via thread 01KS3VF6W33N3V5FNMGQ91YNVD.
92 lines
3.6 KiB
TOML
92 lines
3.6 KiB
TOML
# 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"
|