Skip to content

finolabs-vibecode v0.1.7

Choose a tag to compare

@fioenix fioenix released this 04 Nov 18:18
· 1864 commits to main since this release
6eabe50

Added

  • fnl-scan-agents refreshes the local agent inventory and user-confirmed allowed models; fnl-delegate routes only among recorded present families and warns once per session when the section is older than 30 days. The scan runs only three fixed --version calls, reads host.md, uses no network and stores nothing outside host.md; a clear yes is required for its atomic section-only write.

  • fnl-set-mode shows effective Delegation mode and Routing with their sources and environment overrides, previews changes and writes only those settings after a clear yes. Setup uses the scan, Check reports missing/stale inventory and retired context pointers, and the README includes light/dark skill architecture diagrams.

  • New behavior evals for the router in a Spec Kit repository, a repository with mattpocock/skills, and one with no workflow pack.

  • fnl-delegate "Keep or hand off": a coordinator holding two or more independent tasks with clear acceptance tests dispatches them or records why it kept them, before starting the first; under suggest (the default), it asks first. The coding router points to it. record.py keep prints one line with a count, a fixed reason and who settled it, and with usage metrics on the hook stores it as a new kept event, under the same consent, retention and purge as other events; existing consents cover it. The fnl-status delegation pane shows the tasks kept beside the implementation runs handed off.

  • Add user-chosen Delegation mode (manual, suggest or auto) and Routing (on/off), with a read-only settings reader, setup choices and honest Check reporting. Claude Code and Codex session-start reminders honor Routing; Antigravity’s static rule cannot, and safety gates remain unchanged.

  • Add a default-on, cached release check and synchronous startup notice, verified on Claude Code and unverified on Codex and Antigravity (Codex ships a hook; Antigravity has none), with FNL_UPDATE_CHECK=off and the user-invoked fnl-update skill for explicit update approval, skip and never-ask choices; the detached GET sends nothing about the user and works independently of metrics consent.

  • fnl-setup has a Check mode: a read-only local check reports setup evidence and runtime limits per host, with a small optional smoke task. fnl-ask routes setup checks to it.

  • The fnl-status dashboard updates itself while its tab is open: the page reloads data.js every 5 seconds while visible and redraws when the numbers changed, and the hooks rebuild the file at most once per 10 seconds during a session and at each stop and session start (Claude Code and Codex; on Antigravity the page follows rebuilds made elsewhere). Checked in Chrome; Safari and Firefox are unverified. It stays local: no server and no listener.

  • Plain-language guidance in fnl-ask and fnl-setup: lead with the result, use everyday words and ask only the user's decisions. Both skills carry an identical reference so each works alone; CI checks the copies match.

  • fnl-handoff has a Resume mode: it writes a handover for a later session or another agent without dispatching anything. The handover is a note in the knowledge base the user's instructions name (tagged handoff, with a pointer line at the top of the project's state entry), or a brief file without one, and the agent's native memory holds at most a pointer. The agent that continues reads the latest handover, trusts the repository where they disagree, does the first unfinished step, asks before a merge, a deploy or a deletion, and updates the same note as it goes. The brief template gains two optional headings, "Waiting on" and "Linked runs or sessions".

  • fnl-setup now suggests the diagram-design skill set (MIT, cathrynlavery/diagram-design) for users who draw architecture or flow diagrams, with install commands. Our skills work without it.

Fixed

  • fnl-delegate: under suggest the coordinator no longer asks the user to approve a session of its own kind (for example a Codex session in its own worktree started from Codex, or one a repository's rules require); that is the coordinator doing the work, and an offer names an agent of another family.
  • The three usage-metrics hook commands on Claude Code now end with ; exit 0, as the Codex and update hooks already did, so a missing or broken script can never return a blocking exit code. A test pins the guard on every shipped hook command.
  • The update-check tests no longer depend on the manifest version, so a version bump cannot break them.

Changed

  • Consolidate 20 skill folders into 17: fnl-committee → fnl-advisor (references/committee.md), fnl-coordinator-sessions → fnl-delegate (references/coordinator-sessions.md), and fnl-knowledge → fnl-session-hygiene (references/knowledge.md). Use the surviving skill names; committee and knowledge procedures load only when needed, and session hygiene owns saved handovers.

  • Clarify six own-kind delegation follow-ups: use sessions or headless runs, limit offer-free starts under manual to project requirements or context pressure with a one-line reason, define own kind by the recorded coordinator family, else the host family, retain delegate authority limits, respect project session rules, and reject Codex hand-off offers in the keep-own-kind eval.

  • The README explains the bricks idea (small skills plus a guideline, inspired by the LEGO Group's turnaround under Jørgen Vig Knudstorp; independent of and not endorsed by the LEGO Group), says what you hand over and what stays with you, and gains a Check step in the three-minute start. The repository social preview shows a robot built from bricks.

  • fnl-coding-router now works in any repository. Depth, the review and security gates, proof, "Proportion" and the stop-before-a-third-fix checkpoint are the core; the workflow is a short first step that reads one adapter under references/workflows/: speckit.md (every Spec Kit rule and the Spec Kit depth gate, unchanged in meaning), mattpocock.md, superpowers.md, or none.md, a self-contained procedure (bounded clarification, a genuine red, the smallest change, proof, review) for repositories with no workflow pack. The description is workflow-neutral, and the fallback table that pointed to skills a user might not have is gone.

  • fnl-session-hygiene marks the 60% compaction rule advisory unless enforced by the host or a hook, with enforcement unverified until verified. The README and fnl-ask contents also list session wrap-up as a trigger for fnl-handoff.

  • fnl-setup-instructions offers user, project or both scopes, with repository context sourced from AGENTS.md, a Claude include and private local context kept out of git. Its user contract asks for delegation and compaction preferences and distinguishes advisory rules from verified enforcement.

  • fnl-ask routes Start, Contents, Explain and Route questions to references, reads the target before answering and still invokes nothing; all modes share the beginner definition and register, with one question first for a bare invocation. The onboarding order is /fnl-ask, Quick setup, a first task, user instructions (immediately after setup on Codex), and the dashboard later.

  • The README opens in plain words, with a three-minute start and a glossary, and teaches the same onboarding order to users and agents.

  • fnl-setup offers a beginner path before the mode choice and uses it only for users who say they are new to coding or accept the offer. Its closing handover lists user instructions (immediately on Codex, after the first result elsewhere), matching companion suggestions and the skipped sections to revisit later.

What to do

  • Update the plugin through your host's plugin update (the new update check, on by default, will tell you from now on; type /fnl-update, $fnl-update on Codex), or on Antigravity reinstall with agy plugin install https://github.com/finolabs/finolabs-vibecode. Claude Code needs a restart; Codex hooks need your trust again.
  • Delegation mode defaults to suggest (the agent names who could take a task and waits for your yes). Use /fnl-set-mode ($fnl-set-mode on Codex) to see or change it and Routing, and /fnl-scan-agents to refresh present families and confirmed models.
  • The update check makes one GitHub request every 24 hours. Set FNL_UPDATE_CHECK=off to stop it; see PRIVACY.md.
  • Run /fnl-setup and choose Check to see what runs on its own on your host and what is unverified.