Skip to content

v0.2.3

Choose a tag to compare

@fioenix fioenix released this 10 Nov 06:11
· 1042 commits to main since this release
30d6616

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-afk lease, 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 delegation writes one ## Assignment matrix with each agent's levels, kinds of work, model and roles. route_pick.py answers 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.py refuses new jobs while paused.
  • Names and help. /fnl-afk is the main short name for the away mandate (/fnl-brb still works), /fnl-help replaces /fnl-ask (kept as an alias), and every background run gets a name from ledger.py start.
  • Fixed: judge.py now 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-name records the existing skill event (name only, never prompt text), and the first file edit of a session with no router receipt prints one advisory reminder to invoke fnl-coding-router; Codex and Antigravity stay unmeasured and advisory.
  • select_tests.py [--base <ref>] in fnl-verification lists the tests.test_* modules that name a file changed since the base (default origin/main, copies of a shared file included), reports changed files no module names, and groups the modules two per command; it runs only git diff --name-only and no test.
  • fnl-afk (away from keyboard) is the main short name for the away mandate; fnl-brb remains an older alias, and both load fnl-autopilot.
  • User-invoked fnl-pause (short name fnl-gtg) drains work before a restart or shutdown: pause.py writes a pause marker, reports the recorded work that remains and resumes afterwards, and heavy_run.py run refuses new commands (exit 77) while a valid marker exists.
  • matrix_setup.py (validate, preview, apply, show, migrate, candidates) and the shared assignments.py parser write and read the ## Assignment matrix section (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 roles and ## Agent levels sections until a later release.
  • route_pick.py pick --type <type> --level <1-5> [--author <family>] answers the routing query from ## Assignment matrix and local state in at most five lines, and ledger.py start takes --install, --work-type and --level, records pick_rank and warns when a dispatch is off the preferred order, with the shares per agent in ledger.py summary; a preference never refuses a dispatch.
  • Away decisions, scripts part: autopilot.py log --kind decision records each ladder attempt against a closed schema in the ledger (no question or option text) and autopilot.py review marks it kept or reversed; ledger.py summary adds an away section per lease; autopilot.py check reads the stop-or-decide categories and Non-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 -p before a screened brief); judge.py gains the away-decision choice site; autopilot.py packet-check caps 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 for kept or reversed; fnl-advisor gains a choose mode that returns exactly one option or none during a lease; /fnl-setup add autopilot asks the stop-or-decide categories (two fixed at stop), optional Non-production targets and a separate excerpt consent, off by default; fnl-status shows the away decisions per lease.
  • ledger.py stale previews the open ledger records past their budget with what their run log shows (exists, last-write age, exit line), and ledger.py stale --close --digest <prefix> closes exactly those as stalled, error or cancelled with a closed-late note within 60 minutes of the preview; it never marks a record accepted.
  • 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-versioning now asks for diagrams, README, docs and in-product help to be reviewed against what ships before a release is proposed, and fnl-open-source-review checks that they match (both advisory).

Changed

  • Review routing, the judge setting, checkup.py and the session-start summary read roles and judge from ## Assignment matrix when 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 roles section applies until 0.3.0; the matrix gains the optional role advisor, and session start adds Assignments: <n> agents set when the matrix is valid.
  • The plugin help skill is now fnl-help (fnl-ask stays 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 start prints 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; --task now holds only scope and activity.
  • fnl-review-gate fits the 10,000-byte skill limit (17,999 to 9,925 bytes): engines, packet contents and the impact set move to references/reviewers.md, the manual merge check, batching and the low-risk lane to references/merge-check.md, relay and posting setup to references/relay-and-posting-setup.md; no rule changes meaning and every cited section keeps its name.

Fixed

  • judge.py accepts the reply the judge service actually documents (model and usage beside answers, type beside 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