Repository navigation
v0.2.3
v0.2.3 - 2026-11-10
Highlights
This release lets your agents keep deciding while you are away, gives you one table for who does what, and adds a safe way to stop before restarting the machine.
- Away decisions. During an
/fnl-afklease, a question the agent would ask you goes up a ladder instead: a recorded rule, Jev, an advisor of another model family, then the agent's own choice by the project's goal. Production, live environments, real users and customer data always wait for you, and setup lets you choose which other categories stop or are decided. Every attempt is recorded in the ledger, and on return you mark each decision kept or reversed. On Claude Code a hook stops the question tool during a lease. - Assignment matrix.
/fnl-setup add delegationwrites one## Assignment matrixwith each agent's levels, kinds of work, model and roles.route_pick.pyanswers which agent should take a task, and the ledger records when a dispatch goes off that order. - Pause.
/fnl-pause(short name/fnl-gtg) drains running work before a restart or shutdown, writes handovers and reports what recorded work remains.heavy_run.pyrefuses new jobs while paused. - Names and help.
/fnl-afkis the main short name for the away mandate (/fnl-brbstill works),/fnl-helpreplaces/fnl-ask(kept as an alias), and every background run gets a name fromledger.py start. - Fixed:
judge.pynow accepts the judge service's real reply; before this, calls fell back to the host model.
Two sequence diagrams show one delegated task and one away decision step by step.
Not yet proven on an installed host: the question-tool hook and the typed-skill event. The attempt to cut log-scan false positives was dropped after security review; only a clearer folder message ships.
Added
- With metrics consent on Claude Code, a skill typed as
/fnl-namerecords the existingskillevent (name only, never prompt text), and the first file edit of a session with no router receipt prints one advisory reminder to invokefnl-coding-router; Codex and Antigravity stay unmeasured and advisory. select_tests.py [--base <ref>]infnl-verificationlists thetests.test_*modules that name a file changed since the base (defaultorigin/main, copies of a shared file included), reports changed files no module names, and groups the modules two per command; it runs onlygit diff --name-onlyand no test.fnl-afk(away from keyboard) is the main short name for the away mandate;fnl-brbremains an older alias, and both loadfnl-autopilot.- User-invoked
fnl-pause(short namefnl-gtg) drains work before a restart or shutdown:pause.pywrites a pause marker, reports the recorded work that remains and resumes afterwards, andheavy_run.py runrefuses new commands (exit 77) while a valid marker exists. matrix_setup.py(validate, preview, apply, show, migrate, candidates) and the sharedassignments.pyparser write and read the## Assignment matrixsection (levels, types of work, model and roles per helper, plus the judge) with a digest-checked, backed-up, section-only write; the readers still use the old## Agent rolesand## Agent levelssections until a later release.route_pick.py pick --type <type> --level <1-5> [--author <family>]answers the routing query from## Assignment matrixand local state in at most five lines, andledger.py starttakes--install,--work-typeand--level, recordspick_rankand warns when a dispatch is off the preferred order, with the shares per agent inledger.py summary; a preference never refuses a dispatch.- Away decisions, scripts part:
autopilot.py log --kind decisionrecords each ladder attempt against a closed schema in the ledger (no question or option text) andautopilot.py reviewmarks it kept or reversed;ledger.py summaryadds an away section per lease;autopilot.py checkreads the stop-or-decide categories andNon-production targets, opening tags, releases, publishing and listed deploys only when chosen, and knows the judge and advisor calls of the ladder (the advisor only through the family's executable recorded for the quota probe, with a literal--or-pbefore a screened brief);judge.pygains theaway-decisionchoice site;autopilot.py packet-checkcaps and screens the precedent packet; on Claude Code the opt-in question gate (away_gate_hook.py,FNL_AWAY_GATE=off) denies the question tool during a live lease, and session start prints a fixed line while one is active. - Away decisions, skills part:
fnl-autopilot"Decide" (references/decide.md) runs the ladder (a recorded rule, Jev, the advisor, the host) with two checks against "Where it must stop", the precedent packet and one record per attempt, and on stop lists the lease's decisions forkeptorreversed;fnl-advisorgains a choose mode that returns exactly one option ornoneduring a lease;/fnl-setup add autopilotasks the stop-or-decide categories (two fixed at stop), optionalNon-production targetsand a separate excerpt consent, off by default;fnl-statusshows the away decisions per lease. ledger.py stalepreviews the open ledger records past their budget with what their run log shows (exists, last-write age, exit line), andledger.py stale --close --digest <prefix>closes exactly those asstalled,errororcancelledwith a closed-late note within 60 minutes of the preview; it never marks a recordaccepted.- Two sequence diagrams in
docs/diagrams/(one delegated task from dispatch to merge, and one decision during an away lease) and an updated architecture diagram;fnl-versioningnow asks for diagrams, README, docs and in-product help to be reviewed against what ships before a release is proposed, andfnl-open-source-reviewchecks that they match (both advisory).
Changed
- Review routing, the judge setting,
checkup.pyand the session-start summary read roles and judge from## Assignment matrixwhen it exists: a valid matrix with its own yes consent alone decides (a role no line names is unassigned), an invalid matrix or one without consent leaves roles and judge unset, and without a matrix the old## Agent rolessection applies until 0.3.0; the matrix gains the optional roleadvisor, and session start addsAssignments: <n> agents setwhen the matrix is valid. - The plugin help skill is now
fnl-help(fnl-askstays as a thin alias); its map lists every shipped script and setup feature and answers which agent takes which work, a test fails when either drifts, and one test computes the skill count from the folders, which only the manifests and README now state. ledger.py startprints a ready-made run name on stderr (label: codex sol: demo PR 7 code review) for the host's name field, because only 8% of 1,555 background runs measured on one machine used the documented form;--tasknow holds only scope and activity.fnl-review-gatefits the 10,000-byte skill limit (17,999 to 9,925 bytes): engines, packet contents and the impact set move toreferences/reviewers.md, the manual merge check, batching and the low-risk lane toreferences/merge-check.md, relay and posting setup toreferences/relay-and-posting-setup.md; no rule changes meaning and every cited section keeps its name.
Fixed
judge.pyaccepts the reply the judge service actually documents (modelandusagebesideanswers,typebeside the answer); it refused every real reply and fell back to the host model.- A too-open run-log folder is refused with one fixed message that says to run
chmod 700.
Full changelog: v0.2.2...v0.2.3