Skip to content

v0.15.0

Choose a tag to compare

@edseabolt edseabolt released this 14 Nov 01:51
· 57 commits to dev since this release
8645498

turnstile v0.15.0

This release adds scoped provenance verification with per-row inclusion proofs and confines the planner's write surface to the configured plans directory. Scoped verify answers "was this session's evidence committed and untampered?" for a single session instead of the whole journal, reporting a Merkle proof per row; the planner write confinement turns an over-broad child sandbox into an explicit, configurable boundary. Synthetic verdict attribution and the plan-gate arm on permission evaluations picked up fixes, and the documentation set was restructured — architecture, usage, and journal each split into per-section files with a full plain-language pass.

New: prov scoped verify with per-row inclusion proofs (#330)

  • prov --verify --session <id> reports per-row inclusion facts: each row is anchored (with its Merkle proof), unanchored (open epoch window), or pruned (window committed out of retention), with the committed epoch count — exit 0 with the facts either way.
  • A mutated prov row localizes the tamper to the row and its epoch in both JSON and human output.
  • The unscoped prov --verify contract is tightened alongside: pruned-window rows report null proofs and the committed epoch count rather than failing the check.

New: planner write confinement (#331)

  • Planner child write/edit is confined to the configured plansDir: writes inside the plans dir (including the plans-dir path itself and scratch targets) are allowed; writes outside are blocked with the configured dir named.
  • Honors custom relative and absolute plansDir values; executor and other pipeline children stay exempt; the planner identified via the emitter-agent fallback is confined too.

Fixed

  • Subagent verdicts are credited from synthetic inbox completions; synthetic verdicts dedupe per child and refusedApprove suppression is covered at replay and credit time (#342, #336).
  • The plan-gate arm on permission evaluations routes on both task and subagent actions, so executor dispatches through either shape hit the gate (#344).
  • The marker-retry prompt tells the child its output was received and parsed, instead of implying it was lost (#348).
  • The differential harness default ref is re-pointed at the requirements-phase commit (#333).
  • The hermetic git test env points at an empty temp file instead of /dev/null (#328).

Docs

  • docs/architecture.md and docs/usage.md split into per-section files under docs/architecture/ and docs/usage/; docs/journal.md split under docs/journal/ with config examples for every anchor sink and the plugin-sink contract (#334, #338, #332).
  • Plain-language (ISO 24495-1) pass across the split docs, README trim, and diagram prose synced with code (#337, #335, #334).
  • The journal audit-path description is corrected: the tree is Bitcoin-style, not RFC 6962/9162 (#340).
  • All 17 findings from the 2026-11-13 deep documentation audit are fixed (#346); turnstile-config quotes the actual config-warning wording (#347).
  • README compatibility matrix updated to turnstile 0.15.x with OpenCode 2.3.0 added to the tested list.

Tests

  • Tamper matrix characterizes wrong-epoch-root commit detection (#326); the plugin anchor-sink seam is pinned through the real prov --verify CLI (#327); the absent-anchored arm of prov --verify is pinned at the CLI spawn level (#325); scoped verify gains a 455-line CLI-level test suite (#330); planner write confinement gains a dedicated guard suite (#331).

Install

npx opencode-turnstile@0.15.0 init