Repository navigation
v0.2.5
Added
-
ZCode, Z.ai's coding agent (Apache-2.0), as a fourth delegate family (contributed by nta-jeremy): it can be recorded in the host config's inventory, the environment allowlist and the assignment matrix, and the coordinator dispatches it for code tasks in
--mode edit(no shell; the coordinator runs the tests) and for advice in--mode plan, neveryolo,guardedorbuild, with facts taken from ZCode's own CLI documentation on 12/11/2026 and a permission check on a machine's first dispatch (delegatereferences/agents.md"ZCode"). Review routing skips it, the away lease denies it, and a host config without a ZCode row still passessetup check. -
A repository can set its own away choices (owner decisions, 2026-11-11 and 2026-11-12):
/setup add afk, inside a repository, asks Task choice, Push and pull requests, Merge, Trusted authors and a newRootslist (top-level code folders such aspackages), each with "Use my user setting" as the default, previews the object and, after a yes, saves it asautopilotin the repository's approvedsettings.json(project_progress.py settings --set autopilot=<JSON>,--dry-runto preview,--clear autopilotto undo). A set project value wins over## afkinhost.mdfor that repository; hosts, lease hours, limits, the quota floor and the categories stay user scope only. An unapproved or branch-supplied file sets nothing, and an approved file that is now broken turns those five keys off, never wider.afk.py checkre-reads them on every call, and the lease hash covers the user section only, so a project change does not end a live lease. -
afk.py checkaccepts a path under a project root with the built-in roots' rules, a top-levelREADME.md,CHANGELOG.mdorCONTRIBUTING.md, andgit merge [--no-ff] [--no-edit]of an existing local branch (refs/heads/<branch>, or an unambiguous bare name) into a work branch when Merge is yes for the repository; into the default branch it stays Tier 3. Delegatedclaude -pandcodex execruns outside the read-onlydelegate_env.pyadvisor form, including write-capable dispatches and shell-function commands, stay Tier 3. -
afk.py checkbinds away permissions to one repository identity, one approval and one target. A single resolver (project_store.identity, on the reciprocal-worktree rules ofgit_metadata) feeds the settings, branch and remote reads; a repository it cannot identify, including a linked worktree with a missing, mismatched or unsafe back-pointer, gets the strict values (Task choice listed, push and merge no, no extra roots), and so does an approved object whose recorded origin no longer matches. Both override directions stay. Breaking for away commands:gh pr merge,createandeditare Tier 1 only with one explicit--repo github.com/OWNER/NAMEequal to that origin, creation also needs--head <branch>, and a push qualifies only when origin's push destination (pushurlincluded) is that repository.afk.py effectiveprints the valuescheckapplies, read-only. A current branch that is a symbolic ref to the default branch counts as the default branch, and a bare merge name of 4 to 64 hexadecimal digits in any case is ambiguous. Each settings approval record now also holds the full SHA-256 of its main checkout root and is checked against the resolved identity, so a checkout whose eight-character code collides with another's never uses that checkout's approval (it reads as broken), and anautopilotobject approved before this binding is strict until it is approved again. Path operands are read from the working directory and judged by their path relative to the repository root, so from a subfolder a root never widens to the same name below it and a protected folder above it still counts; without an identified repository no path is a known path. -
/setup add afkin a repository now replaces the wholeautopilotobject, or clears it when every answer is "Use my user setting" (other project settings stay). Its preview shows the repository, the action, the effective values and a token;project_progress.py settings --set autopilot=<JSON>and--clear autopilotwrite only with--expect <token>, and refuse when the repository, its settings or its origin changed since the preview. -
commit-messages'worktree_sweep.py list(copy inreview-gate) helps clean up worktrees after a pull request merges, so they no longer use up storage (owner decision, 2026-11-12). It is read-only and deletes nothing: git does the removal with its own checks. For each linked worktree it prints the path as git lists it, branch, size on disk, clean or dirty, unpushed commits, merged (an ancestor of the localorigin/<default>, or, whenghis present, a merged pull request whose head commit is the branch's current head; otherwise unknown) and acandidateflag, set only when the worktree is merged, clean, has nothing unpushed, is not locked or detached, is not the working folder or a parent of it, and neither holds nor lies inside another registered worktree (compared as written, resolved and case-folded). Under each candidate it prints the two commands to run:git worktree remove <path>, never--force, andgit branch -d <branch>.commit-messages"Branches", thereview-gatemerge step and theafkmerge gate now run it right after a merge and run those two commands only for the worktree of the pull request just merged, when it is a candidate this agent or its runs created; git refuses a dirty worktree and-dan unmerged branch, andgit worktree removealso deletes the files git ignores inside that worktree. Under afk both commands go through check and run only on Tier 1. The rest of the list goes to the user with sizes (advisory). -
On Claude Code, a hook prints one fixed line after a successful
gh pr mergethat is the whole command or the last command of a line joined only by;or&&: "fnl: a pull request merged; run worktree_sweep.py list and, for its worktree when a candidate, the two git commands it prints (advisory)." Other compound commands print nothing, because the payload's outcome is not the merge's own; nor does a quoted excluded flag such as'--auto', which the shell passes on as--auto, or a quote glued to other text. It stores, logs and sends nothing, never blocks and always exits 0. Codex and Antigravity get no hook, because their hook output is not verified here. -
context_snapshot.py probe --host claude|codex --session <id>reads the current session's context size on request, as the context probe exception inCLAUDE.mdallows: Claude Code's/contexton a forked, unsaved copy of the session, or Codex's app-server resuming an idle or unloaded thread with no goal. It runs only the program confirmed in/setup add quota, with that probe's environment, private working folder, 30-second limit and output cap, stores the existing snapshot fields (Codex as hostcodex) and prints thereadJSON; any failure exits 3.FNL_CONTEXT_PROBE=offturns it off; no hook runs it.tidyuses it when no fresh status-line snapshot exists. Live delivery on a real host is unverified, including whether Claude Code resumes a session from the probe's neutral working folder. -
shape, a model-invoked interview for brainstorming, discussing, ideating on or stress-testing an idea, plan or design, or for unclear requirements before building, in any language: it maps the decisions as a tree, asks in rounds only the questions whose prerequisites are settled, each as one question of the host's native question tool with two to four options and the recommended one first, never as a text list (rounds split at four questions per call on Claude Code), looks facts up itself, records settled decisions with their date in the work record or plan, keeps undecided ones open with an owner, never invents answers in a delegated or headless run, and acts on nothing until the user confirms the result.shaperuns first and installedgrilling(/grill-me,/grill-with-docs) runs whenshapeis missing or the user asks for it; superpowersbrainstormingonly for many divergent design ideas. Learned from Matt Pocock'sgrilling(MIT); no text copied. It has nofnl-alias. New trigger evalstrigger-shapeandtrigger-shape-vietnamese. -
The session-start reminder adds one fixed line: the user-only skills (
help,ask,setup,status,afk,brb,pause,gtg,update,restore-point,session-hygiene,verificationand everyfnl-alias) are for the user to type and never called with the Skill tool; questions about the plugin are answered fromhelp's references, coding work goes throughcoding-router(left out when Routing is off) and second opinions throughadvisor, and when a user-only skill is needed the agent tells the user the command to type. A test keeps the list equal to the skills markeddisable-model-invocation: true. -
The compaction nudge (eighth scoped exception in
CLAUDE.md,docs/specs/compaction-nudge.md): on Claude Code aUserPromptSubmithook in its own group, on by default, reads only the integerusagecounts of the latest assistant entry in the last 256 KiB of the session's transcript (a regular file, not a symlink, inside the config folder'sprojects) and the compaction settings, and at 80% and again at 90% of the threshold prints one fixed line asking the agent to runtidynow: save the handover, write back decisions and lessons, note background runs and open pull requests, then offer to compact or start a fresh session. It stores only the last band per session under a hash of the session id, prints again after a compaction lowers the band, and prints nothing when auto-compaction is off, no window is set (the host default is not recorded yet), the mark cannot be written or anything fails.FNL_COMPACT_NUDGE=offturns it off. Codex and Antigravity are not covered. Live delivery of its line into the model context is unverified. -
The session-start hook prints one
Session id: <id>line when the host's id is a lowercase UUID, on every source, so the agent can probe its own session. -
Setup and update onboarding fixes (owner decision, 2026-11-12):
/updateupgrade notes now cover 0.2.0 to 0.2.3 (Codex hook trust, the## Limitsparallel lines, away setup and decisions, agent levels, the matrix migration,fnl-asktohelp, the question-gate hook) and the missing 0.2.5 steps (Codex hook trust, quota re-pin after a Claude Code or Codex update, the context probe's need for/setup add quota, and information on worktree cleanup,/afk start's goal and loop, the main checkout and the full/finolabs-vibecode:helpand:statusnames). Items show[done]from read-only checks in the newsetupscriptupgrade_state.py, which readshost.md(and, for one item, the current repository's approved check list); a note can beinfo, and"where": "repository"runs a check in the user's current folder.update_check.py onboard firstmarks the installed release seen only on a fresh data root (nohost.md, noonboard.json); setup runs it before its first write, so a new user is no longer sent through every earlier version's notes./setup checklists every oldfnl-<skill>name in instruction files with its new name (rowold skill namesand I14), reports a host config with no delegation section asdelegation not set upinstead of failing, adds onelegacy host settingsrow for## Checks,## Project settings,## Project labels, the globalLedger project:/Task file:lines and the## Limitsparallel lines, names each quota family whose recorded program is gone, moved or unconfirmed (path checks only, nothing runs), and adds acompaction settingsrow when a window is set while auto-compaction is off in user, project, local or managed Claude Code settings orDISABLE_AUTO_COMPACTorCLAUDE_CODE_AUTO_COMPACT_WINDOWis set (key, scope and variable names only). The compaction preview warns about the same settings.
-
Delegated runs record that they ended, and the coordinator is reminded of runs with no outcome (owner decision, 2026-11-12;
docs/specs/ledger-closure.md). After its child exits,delegate_env.pyappends oneendedledger line (dispatch id fromFNL_DISPATCH_ID, time, exit code, negative for a signal) when the id is valid and the ledger exists; it never records command text and a failed write never changes its exit status.openshowsended exit=<n>,staletreats an ended record as due after 24 hours without waiting for twice its budget and proposeserrorfor a nonzero exit orcancelledfor exit 0, andsummaryignores the line. On Claude Code a newUserPromptSubmithook, in its own group, prints one fixed line at most every 30 minutes per session with the count and up to five ids of runs that session started that have no finish line and ended or passed their budget; it only prints, keeps one integer mark per session, records no metrics event, sends nothing and is off withFNL_DISPATCH_NUDGE=off. Codex and Antigravity get no hook.
Changed
-
Session titles start with one emoji for the kind of work (owner, 13/11/2026):
<emoji> <project> <scope>: <activity>, from a fixed set of 25 intidyreferences/titles.md(🐛 fix, ✨ feature, 🔍 review, 🔒 security, 🚀 release, 🎨 design, ⚡ performance and others), changed when the activity changes kind; ledger labels and log file names stay plain text. -
Two skills are renamed (owner decisions, 12/11/2026 and 13/11/2026).
session-hygieneis nowtidy;session-hygieneand itsfnl-name stay as user-only aliases that loadtidy, and the hooks' printed text namestidy.autopilotis nowafk, which holds the away skill itself: theautopilotname and itsfnl-alias are dropped with no alias,brband thefnl-names ofafkandbrbloadafk,autopilot.pybecomesafk.py,autopilot_setup.pybecomesafk_setup.py, andsetup add autopilotis gone (use/setup add afk). Breaking: the away settings now live in## afkofhost.mdand an old## Autopilotsection is no longer read, so a lease does not start until you run/setup add afkagain; then delete## Autopilotby hand (the/updatenote0.2.5/afk-sectionshows[done]once only## afkis left). A repository'sautopilotsettings object and the lease's private state keep their names, so stored data still reads./setup checklistssession-hygiene -> tidyandautopilot -> afkin instruction files, and the usage metrics count events stored under the old names astidyandafk. -
open-source-reviewkeeps its steps in the skill and moves the repository settings, community files and plugin package checklists intoreferences/, so the skill fits the size limits; every item there is still marked.plugin-packagingmoves the Anthropic directory facts intoreferences/directory-anthropic.md. A test now holds both skills and these references to the size limits, and the prepare-only eval fails an answer that asks for approval and then goes on with a portal step anyway. -
Record the owner decision for a compaction nudge (eighth scoped exception in
CLAUDE.md,docs/specs/compaction-nudge.md,PRIVACY.md): on Claude Code aUserPromptSubmithook will read only the token counts of the session's latest turn and the compaction settings, and at 80% and 90% of the threshold tell the agent to save a handover and write back decisions before the host compacts; the code is under Added. -
Record the owner decision for a context probe (seventh scoped exception in
CLAUDE.md,docs/specs/context-probe.md,PRIVACY.md): on request it reads the current session's context size from Claude Code's local/contextor Codex's app-server, sotidygets real numbers where no status line runs; the code is under Added. -
fnl-checks'checks.py run --dispatch <ledger id>writes the verification receipt thatfnl-delegate'sledger.py finish --outcome acceptedrequires, for the task checkout and its head, after a whole-list pass on a clean tree whose head and list did not move, whatever the local-receipt mode; each such run first removes the dispatch's earlier receipt. Until nowchecks.py runwrote only the merge gate's local receipt, which the ledger never reads, so most acceptances used--accept-unverified.fnl-delegate's accept steps now use it where a check list is approved,verify_claim.pyover the brief's tests where none is, and keep--accept-unverifiedfor work with nothing to check. -
The main checkout stays on the default branch:
commit-messages"Branches" now cuts every branch, a coordinator's own small fix included, in a worktree of its own (git worktree add -b <name> <path> origin/<base>) and never runsgit switchorgit checkout <branch>in the main checkout (advisory), andcoding-routerrepeats it. The session start prints one fixed line when the repository's main checkout is not on its default branch (fromrefs/remotes/origin/HEAD; silent when that is unknown or on any error), read from local Git metadata without running Git and without printing a branch name or path. -
coding-routerfires when the user wants to brainstorm, discuss, ideate or shape an idea or design for code, and the none workflow's step 1 now has two paths: missing criteria keep the bounded three questions; an open intent or design, or a request to brainstorm or discuss, runs an interview through the native question tool,shapefirst, installedgrilling(/grill-me,/grill-with-docs) whenshapeis missing or the user asks for it, and superpowersbrainstormingonly for many divergent design ideas. The mattpocock and superpowers Clarify rows nameshapeas the fallback, and in Spec Kitshapeworks inside a phase and yields to Spec Kit's own clarify step. New trigger evaltrigger-coding-router-brainstorm. -
ledger.py stale --older-than-hours <n>(1 to 8760) sets the stale threshold for one preview; a record inside its budget is still never listed.fnl-statusnow says when to preview and close stale records. -
Documentation matches 0.2.5: the README describes the release, the context probe, the compaction nudge, the merge notice and the dispatch nudge, embeds the new diagrams and lists ZCode under "Supported agents";
docs/how-it-compares.md, the help map and the away and session diagrams say that/afk startprints a/goalline and starts/loop; the worktree sweep's docs say it escapes paths and quotes its commands; and/updategains 0.2.5 notes for the repository's own afk choices, the compaction nudge's window,shape, ZCode, the ledger closure and the dispatch nudge. -
heavy_run.pynow also waits on macOS until the kernel's memory pressure has read normal at every poll for a whole window (default 60 seconds) and swap-outs over that window average at most a limit (default 5 MB/s); an unreadable pressure or swap-out reading waits and never counts as a pass, and other platforms skip these two gates. The memory minimum default rises from 3 to 4 GB. New## Heavy jobskeys:Memory window seconds(1 to 900) andSwap-out limit MB per second; readings are stamped when they complete, one sample is never a rate, and a swap-out count that goes backwards restarts the window.statusprints apressure:line. Light targeted tests skip the lock and the load gate but still wait while pressure is critical. -
plugin-packagingcovers directory submissions: a newreferences/directories.mdholds what Anthropic's and OpenAI's plugin directories ask (who submits, the tracked branch or tag, field limits, the desktop-only path for plugins that run a local program) and the portal holds no local validator shows, and a new "Directory editions" part describes building a per-directory edition from the same sources with a test that fails while a committed edition is stale. Every portal step (upload, draft, repository access, portal validation, submitting) waits for the owner's approval, a new prepare-only eval checks that the skill stops before it, and the form's answers and attestations stay the owner's. It also records, as observed and reported rather than published, that Anthropic's directory refuses after submitting local code (command hooks, local MCP servers, mods, scripts, broadallowed-tools) from organizations that are not Verified, keeps the design-only exception to the image-generation restriction, and that hooks shared with Codex stay in shell form because Codex hooks take noargs. -
open-source-reviewscans withgitleaks gitandgitleaks dir, runs the plugin validators on a fresh clone so untracked files such as.DS_Storedo not show, and walks the target directory's own pre-submission list against the submitted folder or ZIP. -
/afk startnow keeps the session working while you are away: it prints a goal you can type in the host's/goalcommand before you leave (the lease only bounds actions and never starts a turn), and starts a self-paced/loopon Claude Code when work waits on CI, reviews or a delegated run, stopping it when the lease ends. Neither widens what the lease allows. -
ledger.py staleis more conservative by default: an open record is stale only past twice its budget and at least 24 hours (before: past its budget), and a record with no usable budget becomes stale after 24 hours (before: never). Each preview line now shows the record's label, andstale --closerechecks each record against the threshold its preview used. -
A second
/afk startwhile a lease is live now reports when that lease ends and tells the session to work under it, instead of a generic refusal that led a second session to work outside the lease. The lease covers every session on the machine; nothing is extended or reset. -
The assignment matrix is the one setup path for levels, roles and the judge:
add rolesdefers to it when it exists, and its Jev choice asks the same separate TypeSafe consent question asadd roles. The Agent skills block now names help as/finolabs-vibecode:help(Codex$help). -
The away-session setup is now
/setup add afk; its choices move to## afkinhost.md(see the rename ofautopilottoafkabove). -
Breaking: skill names drop the
fnl-prefix so they are short and easy to remember (owner decision, 2026-11-11):fnl-setupis nowsetup,fnl-coding-routeriscoding-router, and so on for every skill, the short aliases included (afk,brb,ask,verification,gtg). Every old name stays as a user-only alias (skills/fnl-<name>/) that loads the renamed skill with the same arguments, so/fnl-setuptyped by you keeps working; the model does not see the aliases, so an instruction file that tells it to invoke an old name must use the new one (/setup checklists them).
On Claude Code, type/finolabs-vibecode:helpand/finolabs-vibecode:statusin full, because/helpand/statusare the host's own commands. Usage metrics record the current name and count an old name, typed or stored, as the same skill. The agents (fnl-reviewer,fnl-security-reviewer,fnl-navigator) and thefnl-reviewandfnl-routermarkers keep their names, and a repository whose## Agent skillsblock namesfnl-review-gatestill counts as adopting the review gate. -
A repository's settings (
ledger,tasks,parallel,parallel-caps) and its dashboard label now live in its own folder,<main checkout>/.finolabs/vibecode/settings.json(linked worktrees share it), instead of## Project settingsand## Project labelsin the sharedhost.md(owner decision, 2026-11-11). Every setter records the SHA-256 of the file in<data root>/state/settings-approved/; a file with no approval record (such as a branch-supplied one) reads as unset, and an approved file that is now missing, unreadable, unsafe, invalid or edited makes capacity and the ledger join unknown, turns the task file and label off and says the settings need setup again, so a repository cannot raiseparallel, relax an approved limit or redirecttasks.
The setters keep their consent rule, lock and validation, add.finolabs/to.git/info/excludewhen missing (never to.gitignore) and leavehost.mdbyte-identical. While the settings are broken every setter refuses with a message namingproject_progress.py settings --reset, which discards every project setting (the file and its approval record) after the user's yes and returns the repository to never configured; Check reports broken settings as needing setup again. The dashboard shows a label only for the repository it runs in; other repositories show their registered folder name. -
Breaking:
## Project settings,## Project labelsand the globalLedger project:andTask file:lines ofhost.mdare no longer read, with no fallback and no migration command (owner decision, 2026-11-11). Unset means the defaults:parallel3 with no caps, the folder name as ledger name, no task file, the registered folder name as label. Set them again per repository with/setup add projector/setup add delegation, then delete the old lines by hand. Check no longer reports invalid or deprecated host settings. -
Repository identity is validated: a
.gitfile counts as a linked worktree only in the canonical layout<main>/.git/worktrees/<name>, with itscommondirresolving to that.git, itsgitdirpointing back and every metadata file and folder owned and not group- or world-writable, as the review gate already required; anything else resolves to the checkout's own root, so a checkout cannot borrow another repository's code, check list, settings or exclude file. Codes of real repositories and real linked worktrees are unchanged. -
Sessions get named more often: the session-start rules now tell the agent to invoke
tidyat the first task, on a task change and after every compaction, and name the rename mechanism per host; after a compaction the hook adds one fixed line to check the title. The skill's description leads with naming and lists plain requests such as rename, wrap up, save progress and hand over. Local usage data from November 2026 showed no model-initiated call of the skill in 691 transcripts and a rename in 42 of 312 long sessions. -
The router and verification fire more often.
coding-routerstep 1 now tells the agent to invoketidyto name the session once the task is known and again at each phase change (planning, implementation, review); its gate line and the session-start rules tell the agent to invokechecksbefore reporting work as done, fixed or passing and before accepting a delegated run. Thechecksdescription leads with the questions users type ("is it done?", "did the tests pass?", "is it ready to merge?"), with a new trigger eval. Local usage data from November 2026 showed no call of theverificationalias, which hosts never offer to the model. The first-edit router reminder stays on Claude Code only: Codex'sPostToolUseoutput contract and Antigravity's hook output are not verified in this repository. -
A repository's check list now lives in its own folder,
<main checkout>/.finolabs/vibecode/checks.json(linked worktrees share it), instead of## Checksin the sharedhost.md(owner decision, 2026-11-11). Apply records the SHA-256 of the approved file in<data root>/state/checks-approved/; a file edited, committed or checked out on a branch, or without approval, runs nothing and turns the local receipt off until/setup add checksruns again.
checks_setup.pyadds.finolabs/to the repository's.git/info/excludeonce (never to.gitignore), keeps a replaced file aschecks.json.bak-<date>, and never openshost.md. Undo ischecks_setup.py removefor this repository; a stale remove preview changes nothing. -
afk.py checksplits its protected set so an away session can change the plugin's own source (owner decision, 13/11/2026). On a non-default work branch, with Push and pull requests or Merge yes for the repository, the plugin's own source (skills/**includingSKILL.mdand the skill scripts,scripts/**, top-levelCLAUDE.mdandAGENTS.md,.<host>-plugin/*.jsonhook and plugin manifests) is a known path for edits and for the merge gate's changed-path check, run in the pull request's worktree. Everything that changes live behavior or reaches outside the repository stays Tier 3: paths outside the repository (user and host config, the data root,host.md, lease and setup state),.git/and git hooks,.github/, the repository's.claude/settings and hooks, secret-looking names, every source path on the default branch, and the running install's own checkout on every branch (matched by its validated checkout, so its linked worktrees under.claude/worktreesstay editable; this also closes an older gap where the install's top-levelscripts/*.pywere Tier 1). Pull request and commit text carrying a review gate marker (<!--, optional whitespace,fnl-) isforbidden, so reviews post only throughpost_review.py. Breaking for scripts that rely on exit 0:checknow exits 3 on Tier 3 (see Fixed). -
Breaking for lists saved with 0.2.4: the
## Checkssection ofhost.mdis no longer read, with no fallback and no migration command (owner decision, 2026-11-11). Until you run/setup add checksagain in each repository, it has no checks and its local receipt is off; then delete the old section fromhost.mdby hand. The 0.2.5 upgrade note in/updatesays so.
Fixed
afk.py checkno longer stops the own-branch release work an away mandate authorizes (owner report, 13/11/2026). A path inside a linked worktree of the repository (validated byproject_store.identity, never a lexical.claude/worktreesallow) is judged by its path relative to that worktree, as from inside it, andgit -C <worktree>as the same command run there; any other folder under.claude/stays Tier 3.gh pr createandgh pr editaccept--body-file, andgit commitaccepts-F <file>: a regular file of at most 64 KiB inside the check's own checkout (for example its git-ignored.finolabs/), outside the data root, with no link from that checkout root down, whose text is screened for controls, secrets and machine paths (elseunsafe), so Markdown and shell examples go there. Inline title, body and message values may hold newlines, tabs and a leading-, but a backtick,$(or$before a letter,_or{isunknown.gh pr comment <number> --repo github.com/OWNER/NAMEfollows theRepository commentscategory. Clarified: as before, only a Tier 1 answer reserves an action or a run. Breaking:checkexits 3 on Tier 3 (0 only on Tier 1, same JSON), socheck ... && commandno longer runs a denied command. With Merge yes, the merge gate's cleanup is Tier 1:git worktree remove [--] <path>of a linked worktree whose HEAD is the full SHA alog --kind merge --head <sha>entry of the current lease recorded (new optional--headon the merge kind; never forced, the main or the current checkout, or a worktree holding this install) andgit branch -d [--] <branch>(never-D, the current or a default branch);git rm [-r] [-q] [--] <paths>on a work branch classifies each path like a change. Agit commit -mmessage is data the same way (-qallowed), so a message that names hooks, settings orSKILL.md, or spans lines, no longer makes the commit Tier 3. A git command that changes a work tree (merge, commit, add, pull and the like) stays Tier 3 when it would run in the running install's own checkout, directly or throughgit -C, andlog --kind merge --headneeds its--pr.- Delegate ledger records no longer stay open or get closed from the wrong checkout (owner decision, 2026-11-12;
docs/specs/ledger-closure.md).ledger.py stale(preview and--close) now considers only records whose project is this repository's ledger project, resolved asstatusresolves it (the approvedledgersetting, else the checkout folder name), and refuses when none resolves;--all-projectswidens the preview with a warning, and the preview's digest binds that scope, so a close must come from the same project or repeat--all-projects. A review dispatch (--kind review) is accepted on its posted review:finish --outcome acceptedneeds no verify receipt and no--accept-unverified, takes--head(recorded asreviewed_head, which never binds authorship) and an optional--review-urlto a pull request comment, checked by pattern only and recorded asreview_posted.--reasonmay go with any outcome, kept only as a digest. Other kinds keep the receipt rule. coding-router's Spec Kit adapter follows a corespeckit-*skill markeddisable-model-invocation: true(Spec Kit 1.4's--no-model-invocationintegration option) by reading itsSKILL.md, instead of calling the skill tool that refuses it or reporting an integration gap.afkno longer treats the plugin's own wrapper commands (ledger.py,record.py,heavy_run.py,judge.py,delegate_env.py,merge_check.py) as protected when the plugin is installed under a.claudeor.codexfolder, as Claude Code and Codex install it. Only that one exact script path is spared the protected-name check; every other token, including a nested command's, is still checked.- An alias whose skill is user-only (
fnl-help,ask,brb,gtgand the older names ofafk,pause,restore-point,setup,statusandupdate) no longer tells the agent to load that skill, which made it call the Skill tool and get refused: it now says the skill is user-only and to read itsSKILL.mdin the plugin's skills folder and follow it, never through the Skill tool. Older names of short names load the final skill directly (fnl-ask→help,fnl-verification→checks,fnl-afkandfnl-brb→afk,fnl-gtg→pause); a test andcheck-references.pyhold both rules for every alias. precompact.pyno longer asks for a handover it cannot get: PreCompact runs after compaction has started and Claude Code uses its output as summary instructions, so it now tells the summarizer what the summary must keep (goal and acceptance criteria, settled decisions with dates, work in progress, open background runs and pull requests, the next action, and whether a handover was saved). The handover is now prompted earlier by the compaction nudge.- After a Claude Code or Codex update moves the program confirmed in
/setup add quota(a new versioned folder, for example),quota_probe.py read,context_snapshot.py probeand/setup checknow say ": program changed since setup", with the old and new version folder names when both paths differ only there and never a path, and name the fix/setup add quotato re-confirm the new path. Before, the quota probe recorded an execution error and the context probe gave only its generic refusal. The changed program still never runs and the new path is never accepted on its own.