Repository navigation
v0.15.0
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 --verifycontract 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
plansDirvalues; 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
refusedApprovesuppression is covered at replay and credit time (#342, #336). - The plan-gate arm on permission evaluations routes on both
taskandsubagentactions, 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.mdanddocs/usage.mdsplit into per-section files underdocs/architecture/anddocs/usage/;docs/journal.mdsplit underdocs/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-configquotes 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 --verifyCLI (#327); the absent-anchored arm ofprov --verifyis 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