Repository navigation
SAKO 0.7.0
Agents change rows through a command instead of by hand, sessions see each other's progress, a pass in one worktree proves identical content in another, and named checks sit beside the gate's check. A stop that the gate cleared by mistake when the clock stepped back now blocks. The runtime may grow to 4,000 lines and wraps at 100 columns. Task records from 0.6.0 still parse. SAKO remains alpha software.
From your project's Git repository, install with uvx sako@0.7.0 init, or update an existing installation with uvx sako@0.7.0 init --update.
To update from 0.6.0, follow these steps:
- Update between working sessions, in the main checkout. The hook command is the same as in 0.6.0, so Codex keeps its trust in SAKO's hooks.
- End any session left open across the update, then start it again with the same ID, which keeps its claims and takes a new start record, or start a new one.
- Run
verifywhen a check is configured. The new version makes every recorded pass stale.
Added
edit T-nchanges a row under the ledger lock: its scope (--scopereplaces,--widenadds), its prerequisites (--after, where-clears them), its done-when, or its state (--park REASON,--open). A claimed row is edited only by its holder, a path new to its scope faces claim's overlap rule, and the edited row passes the row checks or nothing is written. Task and Pri stay hand edits, and a done row stays as history.- Named checks.
config.jsontakeschecks, a map of names to argument arrays over the sameverify_paths.verify NAMEruns one and keeps its own stamp and logs,statusshows each as fresh, stale or none, and a close addsNAME pass TIMEfor each fresh one. A named check is evidence, never one of the gate's rules. - A pass recorded in another worktree or in the main checkout counts when its content and command match this checkout's, and
status,startand the receipt say where it ran. - Start, resume and compact contexts list the session's own rows with their handoff state and scope, and the header names the start revision. Each live peer's line shows its commits since its start and its uncommitted paths in its own checkout, read within 2 seconds. In the repo footprint,
statuslists the records committed since you started.
Changed
- Refusals and findings that sent an agent to hand-edit
.sako/work/TASKS.mdprint aneditcommand instead: claim's overlap and missing-scope refusals, the parked refusal, the stale-claim finding and the gate's own overlap finding. - A closed task's file rewritten after its close, as by a stash, a Git hook, a formatter or an editor save, is listed under Recorded with the task that closed it, and the fix says to commit it under that task's title when the content is still its work.
- The Proven rule counts only the gate's own check pass in a receipt, never a named check's. A close whose receipt shows that pass stays proven while only others moved checked content since the session started.
- The note for a path claimed by a peer in another worktree says its work counts here once merged, and
removenames a linked worktree's tracked Codex settings file in full. statussays "landed in the code since you started".- The runtime cap is 4,000 lines, and no line of
sako.pyruns past 100 columns.
Fixed
- The gate dropped a commit made just after the session started when the wall clock stepped back, as WSL's can by a second or two, and could clear a stop it should have blocked. It now lists the session's commits from a minute before its start, still bounded by its start revision. The records line in
statuslooks back 5 seconds. verifytimed its run by the wall clock, so a clock stepping back could print a negative time such asPASS in -1s. It uses a monotonic clock.
Known issues
- A live peer in the same checkout can claim a scope that covers this session's closed files. This session's edits and commits there then count as the peer's under Recorded and Proven for as long as the peer is live. The peer's own close still needs a fresh check.
- Two ended sessions holding overlapping claims still need a hand edit of the ledger, since neither claim can be taken over while they overlap.
- One test of the start context fails on native Windows, where the header's middle dot reads back in the code page. The runtime is not affected, and 0.7.1 fixes the test.
Validation
- Both suites pass on Python 3.10 and 3.12 locally, with 275 tests and 22 scenarios; these counts overlap.