Skip to content

v0.2.1

Choose a tag to compare

@fioenix fioenix released this 08 Nov 21:55
· 1241 commits to main since this release
00dee56

v0.2.1 - 2026-11-09

Highlights

This release adds a wrapper that serializes heavy local jobs run through it, lets the plugin run a time-boxed away mandate for your host agents (/fnl-brb), and tightens setup, delegation and review checks.

  • heavy_run.py runs one heavy command at a time per machine, with load and memory gates, a wait cap and a maximum run time.
  • fnl-autopilot (alias fnl-brb) starts and stops a time-boxed standing mandate; each action is classified by code and merges need your recorded Merge answer, reviews and green checks.
  • The parallel run limit is per repository (default 3); setup offers the Agent skills block in AGENTS.md and CLAUDE.md; Check reports plugin enablement per Claude home.

Not in this release: the opt-in heavy-job gate hook described in docs/specs/heavy-jobs.md (the heavy_run.py wrapper is in), the review residual notes and the smaller setup items; see the release record.

Added

  • /fnl-setup add autopilot asks each away-session setting separately, with an explicit Merge decision as standing authority. Its writer previews the canonical ## Autopilot section and applies only a confirmed, unexpired SHA-256 digest, preserving other host bytes with a backup and refusing links or changed files.
  • fnl-delegate/scripts/autopilot.py (first slice of autopilot, part 1): start, stop, check and log for a time-boxed lease read from ## Autopilot in the host config. check classifies a command's argv or a change's paths into Tier 1 or Tier 3 by code (unknown input is Tier 3), enforces lease expiry, the stop marker, setup-hash changes and run, runtime and hourly action limits, and denies merge unless setup says Merge: yes and the argv pins one full head SHA (that the SHA is the reviewed current head stays the caller's duty). State is private and local; nothing is executed or sent. merge_check.py --independent additionally refuses the merge when the families routing would pick for the reviews include the pull request author's own; which family posted each counted marker stays the caller's duty. The skill, the /fnl-brb alias and the setup section are available.
  • User-invoked fnl-autopilot starts and stops a time-boxed away mandate with action classification and an independent merge gate; fnl-brb (be right back) is its thin alias. Recorded setup is required; use /fnl-setup add autopilot to record it. The live loop, dashboard tab, scheduler, notice hook and host backstop remain deferred.
  • fnl-delegate/scripts/heavy_run.py runs one heavy command at a time on the machine: it holds a kernel lock in the fixed anchor folder, waits for the one-minute load and free memory, exits 75 after a wait cap, refuses detached Docker launches, starts the command with the allowlisted environment records who started the job (label, repository, dispatch id, program name, pids, times) so status can show it without guessing the holder, and stops a job past its maximum time (default 90 minutes). It replaces the mkdir recipe.
  • Record an optional coordinator session hash on dispatch starts from CLAUDE_CODE_SESSION_ID (never from a command-line option); keep only a short SHA-256 hash, or null when unknown.

Changed

  • The user-contract template in fnl-setup instructions now has a delegated-acceptance line: all tests of the package or test module holding the changed code and its traced consumers, chosen from the diff, never a repository-wide suite without the owner's request, unless a repository's owner instructions scope task-level proof more narrowly.
  • The parallel run limit and per-family caps are now set per project (repository) in ## Project settings (parallel, parallel-caps), default 3, and count only that repository's open dispatches; there is no machine-wide total, and family quota pools stay shared. fnl-setup add delegation asks for the limit inside the repository.
  • fnl-delegate's description, the fnl-ask map and the README now say plainly that it hands work to other agents and runs it; the skill name is unchanged.
  • Delegated runs must start in the host's own background mode, one runner per call. The dispatch step and the background rule now name ( … ) &, nohup and disown as the forms that hide a run from the host's task list; the handoff step and the after-compaction reminder name the first two. The hook script changed, so Codex asks to trust the hooks again.
  • After a compaction, the session-start hook prints one fixed delegation reminder (unless Delegation mode is manual), and the handover template carries a Delegation state line, because delegation to other agent families fell after compaction. The hook script changed, so Codex asks to trust the hooks again.
  • fnl-setup now offers the ## Agent skills block in every project context file the hosts read, AGENTS.md and CLAUDE.md, each with its own preview and yes, and skips a CLAUDE.md that only imports AGENTS.md.
  • /fnl-setup check reports, per Claude Code home, whether this plugin is enabled, disabled, absent or unverified in enabledPlugins, showing no other settings content. fnl-delegate and fnl-verification now document the Codex review and posting run without a sandbox, record a run stopped by a permission request as needs-permission rather than quota, and explain that ledger.py finish refuses --head and an unverified accepted for a review dispatch, which is accepted with --accept-unverified after reading the posted marker.

Deprecated

  • The ## Limits parallel lines in host.md are no longer read; check-config reports them as legacy_limits.

Fixed

  • Check shows the version a Claude Code folder marketplace declares beside the one the installation registry records, and stays unverified when they differ.
  • Check reads the Claude home and instruction file selected by an absolute CLAUDE_CONFIG_DIR, and lists other ~/.claude* homes that hold plugins with their recorded plugin version.