Repository navigation
v0.2.0
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 checkafter updating ($fnl-setup checkon Codex); it reports configured, missing and unverified features without changing them. - Use
/fnl-setup add delegationto review the new## Limitslines:- Parallel dispatches: at most 6 at one time.and optional- Parallel per family: claude=2, codex=3are examples, not prescribed values; missing or invalid totals use 5, and older parenthetical wording needs replacement. - Use
/fnl-setup add rolesto 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
StopFailureentry records rate-limit markers only when the quota probe is on). - On Codex, open
/hooksand 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
StopFailureevent 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:andTask 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-verifieragent is replaced byfnl-verification; run itsverify_claim.py, read the evidence and decide acceptance as coordinator. - Session hygiene: The
fnl-stewardagent is replaced by the Context pressure procedure and threshold script infnl-session-hygiene. - Setup: The
fnl-scan-agentsskill is replaced by/fnl-setup scanfor inventory refresh. - Setup: The
fnl-set-modeskill is replaced by/fnl-setup modefor Delegation mode and Routing. - Setup: The
fnl-setup-instructionsskill is replaced by/fnl-setup instructionsin the same setup session.
Fixed
- Review gate: The posting wrapper accepts standard macOS Homebrew
ghwhile 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/compactavailability remain unverified; the fixed stop message still names/compact, with/newor/forkdocumented 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=offdisables 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