Skip to content

v0.2.0

Choose a tag to compare

@fioenix fioenix released this 08 Nov 04:20
· 1332 commits to main since this release
8dba36b

v0.2.0 - 2026-11-08

Highlights

This release makes delegated work easier to direct, review and check, with a shorter setup and clearer evidence of what each host can actually do.

  • Assign code and security review roles, prefer a family other than the author’s and post through one guarded path.
  • Check project direction with the navigator and use one judge interface, with a small host model by default and optional Jev.
  • Require verification receipts for delegated ledger acceptance, bound to the checkout and current commit.
  • Start headless runs with environment allowlists and inspect finished logs through local scanning and redaction.
  • Track repository outcomes, one-file work records and delivery progress alongside Spec Kit.
  • Choose Quick or Advanced setup, with plain-language approvals and optional features loaded when needed.
  • Record opt-in context snapshots from Claude Code and Antigravity status lines for compaction decisions.
  • Run parallel agent pools within advisory total/family limits and see capacity, quota pools and readable times on the status board.
  • Read corrected host contracts that distinguish documented support, local checks and unverified live delivery.

Upgrade notes

  • Run /fnl-setup check after updating ($fnl-setup check on Codex); it reports configured, missing and unverified features without changing them.
  • Use /fnl-setup add delegation to review the new ## Limits lines: - Parallel dispatches: at most 6 at one time. and optional - Parallel per family: claude=2, codex=3 are examples, not prescribed values; missing or invalid totals use 5, and older parenthetical wording needs replacement.
  • Use /fnl-setup add roles to choose review families and the judge; assignments grant no posting rights, and each posting grant needs its own approval and observed check.
  • Claude Code may ask you to trust the changed plugin hooks after updating (a new StopFailure entry records rate-limit markers only when the quota probe is on).
  • On Codex, open /hooks and check trust again: changed bundle contents can require renewed trust even when hook declarations are unchanged.
  • Context recording needs a status-line command in your own host settings; setup previews a new command or gives a recipe to compose with an existing one, which it leaves untouched.
  • Follow the replacements under Removed; data-root location and existing consent remain unchanged, and new opt-ins still need separate approval.

Added

  • Review gate: User-assigned review roles and deterministic routing prefer a family other than the author’s and disclose same-family fallbacks.
  • Review posting: A guarded wrapper binds review comments to the checkout repository and checked drafts, while posting status needs an observed author and marker.
  • Navigator: Bounded course checks compare confirmed outcome anchors with repository evidence and suggest up to three ways to address drift.
  • Verification: Current-head receipts record targeted tests and criterion judgments before delegated ledger work can be accepted, with a reason-digested exception counted separately.
  • Judge: One interface supports a small host model by default and optional Jev, with explicit fallback and judgments that grant neither authority nor acceptance.
  • Context: Opt-in Claude Code and Antigravity status-line recorders supply fresh token counts to the compaction steward without reading conversation content.
  • Delegation: A task-routing helper applies the grade matrix, and a read-only Claude Code/Codex startup summary shows roles, posting state, cached quota and open dispatch counts.
  • Quota: An advisory Claude Code rate-limit marker (family and time only, recorded from the StopFailure event while the quota probe is on) steers routing away from a limited family for at most five hours; a newer reading or your own statement overrides it.
  • Capacity: Advisory parallel-slot checks expose a user-selected total from 1 to 32 and optional per-family caps in setup, session start and the dashboard.
  • Work tracking: Per-repository settings, dated outcome anchors and bounded one-file work records complement Spec Kit artifacts.

Changed

  • Setup: A short core uses user/project scopes, Quick/Advanced modes and on-demand features, with plain-language approvals explaining the effects of yes, no and undo.
  • Setup: Companion questions show checked install commands without installing anything, and explicitly declined features stay declined until requested again.
  • Delegation: Agent families act as pools of concurrent runs, with family/model labels and the coordinator retaining model selection, quota and permission decisions.
  • Quota: Opt-in readings happen on demand before routing, at least 15 minutes apart, replacing hook-started periodic workers and adding advisory Claude Code rate-limit markers.
  • Review gate: Adopted repositories require exactly one valid router marker in the pull request body at merge time, in addition to current-head code and security review comments.
  • Session hygiene: Compaction decisions and the safe-boundary procedure move into the session-hygiene skill, informed by the configured judge when needed.
  • Dashboard: Repository pipelines, task/package states, ledger mismatches, quota pool models and local readable times appear on a page that scrolls with the browser.
  • Dashboard: Repository-scoped status replies retain cross-repository detail on the board, with bounded review chains, detailed tables and five retained repository snapshots.
  • Docs: Host contracts and architecture/lifecycle illustrations distinguish advisory instructions from enforcement and documented contracts from live proof.

Deprecated

  • Work tracking: Global Ledger project: and Task file: lines remain readable in 0.2.0 and 0.2.1; move them to per-repository settings before their planned removal in 0.3.0.

Removed

  • Verification: The fnl-verifier agent is replaced by fnl-verification; run its verify_claim.py, read the evidence and decide acceptance as coordinator.
  • Session hygiene: The fnl-steward agent is replaced by the Context pressure procedure and threshold script in fnl-session-hygiene.
  • Setup: The fnl-scan-agents skill is replaced by /fnl-setup scan for inventory refresh.
  • Setup: The fnl-set-mode skill is replaced by /fnl-setup mode for Delegation mode and Routing.
  • Setup: The fnl-setup-instructions skill is replaced by /fnl-setup instructions in the same setup session.

Fixed

  • Review gate: The posting wrapper accepts standard macOS Homebrew gh while retaining narrow prefix, ownership and nested-repository checks.
  • Setup: Correct starter commands and retired-pointer checks support custom Codex instruction folders and Antigravity global rules through the guarded writer.
  • Run hygiene: Benign log pairs no longer consume the secret-hit cap, and environment-dump detection requires ten distinct environment-style names.

Security

  • Judge: Canonical opt-in, capped closed payloads, secret/path screening, verified transport and a 24-attempt process cap bound external judgments, with explicit host fallback.
  • Run hygiene: Brief lint, child-environment controls, bounded raw/normalized log scans and digest-bound redaction reduce exposure while checking file identity and recent writes.
  • Setup: Malformed declined-feature records, nonregular instruction targets and environment-selected custom Codex targets are refused before writing.

Known limits

  • Local fixtures and vendor documentation do not prove live hook, setup, review-posting or status-line delivery on each host; navigator/judge validation remains limited and not independently established.
  • Codex has no external status-line command for this recorder; Claude desktop Code-tab delivery and composition with user-owned status lines remain unverified, and latest-snapshot selection can be ambiguous across parallel sessions.
  • Antigravity invocationNum == 0, interactive stop delivery and /compact availability remain unverified; the fixed stop message still names /compact, with /new or /fork documented as alternatives.
  • Relay receipts and dashboard relay counters are not built; temporary relays are uncounted and still subject to existing approval rules.
  • Run hygiene covers allowlisted headless command forms; reachable HOME credential files, interactive/app sessions and in-session subagents remain outside that protection, and a private HOME is not implemented.
  • Parallel-slot checks are snapshots, not reservations or ledger enforcement; live scheduling, provider quota reads and the Claude Code StopFailure payload remain unverified.
  • The update check remains on by default, independently of metrics consent, and contacts the fixed public GitHub endpoint; FNL_UPDATE_CHECK=off disables it, while Codex check/notice delivery and Codex/Antigravity update procedures remain unverified.
  • Optional Jev calls send bounded English evidence to TypeSafe only when invoked with opt-in and authorized key/budget; live network behavior is not established by this release's local checks, and unavailable calls require host fallback.
  • Autopilot, the merge permission guard and the goal skill are deferred to 0.2.1; multi-account agent routing, relay accounting, private HOME and the Antigravity stop-message/Codex PreCompact decisions also remain deferred.

Full changelog: v0.1.10...v0.2.0