theplenkov/bro
v0.3.0MIT
Agent's sidekick — deterministic lifecycle closure (task → agent → PR → gate → debt). Wedge: review gate + debt ledger with existing agents, task store, and PR/CI. Orchestration (fleet/convoy) is optional and progressive — not a replacement runtime.
Changelog
0.3.0 (2026-10-30)
🚀 Features
- add husky + biome for auto-formatting on commit (#687)
- acp: bro acp proxy — cascading ACP edge (bro-bhyo1) (#655)
- act: blocked act-wait settle surfaces as a finding (bro-q4iq0) (#380)
- act: merge queue for every PR + opt-in external queue connectors (bro-huy5o.6) (#388)
- act: act wait --detach — a watcher that outlives the session (#450)
- act: requireApproval — human sign-off gate before auto-merge (#561)
- act: requireApproval binds to the current head, latest review per reviewer (bro-3vy93) (#636)
- act: the reopened-thread cycle-guard becomes a gate condition (#668)
- act: resolve the current PR when no number is given (#680)
- agents: agents.devin.maxWorkers — split the spawn-plane quota (#410)
- agents: docker container isolation backend (bro-huy5o.10) (#438)
- agents: copilot agent-task connector — first cloud backend (bro-huy5o.12) (#447)
- agents: bro agents log [--follow] — live tail of a managed agent's log (bro-j1kk2.1) (#536)
- agents: devin session plane rides a read-mostly connector (bro-ggjdy) (#568)
- agents: bro agents run — ad-hoc spawn surface, phantom steps spawn unclaimed (bro-fqen0) (#583)
- agents: render devin session transcripts in agents log (bro-nt503) (#580)
- agents: run --for claim dedup + same-repo similarity warn (bro-7dila) (#598)
- beads: .beads store on a managed dolt sql-server (bro-n59xn) (#405)
- build: session-attributed build stamp — who last wrote dist is recorded (bro-fatja) (#402)
- bus: 'agent' topic — in-turn activity at the pumpTurn chokepoint (bro-0ppt0) (#577)
- bus: worker/worktree lifecycle events on bus topics (bro-294hf) (#781)
- cap: the host-wide session cap, per kind, through the plane facade (#627)
- claude: install the plugin from the repo root (#395)
- cli: command groups — bro
<group><member>dispatch (bro-b5v2t) (#396) - cli: land cli spec + migrate docs to grouped spelling (bro-vlmrb.1/.2) (#459)
- cli: optional OTLP export of the session trace journal (bro-huy5o.11) (#439)
- cli: flatDeprecated — per-name flat-spelling retirement knob (bro-vlmrb.3) (#557)
- cli: help to stdout, usage errors to stderr, shared exit-code taxonomy (bro-1znlu) (#613)
- codescene: the CodeScene gates as code — ladder, CI delta gate, wave 1 (#599)
- codex: native plugin hooks and prompt-visible skills (#369)
- conductor: image content blocks ride the acp wire (bro-7izjx) (#558)
- conductor: retain one acp session per client conversation (bro-whn25) (#569)
- conductor: narrate agent tool_call lifecycle as SSE text (bro-h8mvo) (#586)
- conductor: anthropic surface gaps — tool_choice, stop_sequences, error taxonomy, keepalive (bro-bvipw.1) (#588)
- config: three-layer config — global + project + local (#328)
- config: bro.config JSON Schema generated from the section registry (bro-d9dmx) (#637)
- contract: bro contract dump --json — machine-readable CLI surface (bro-k9ces) (#644)
- contract: JSON Schemas for --json outputs of agent-facing read commands (#779)
- convoy: convoy wait + bounded watch --for (#331)
- daemon: bro daemon — the project-scoped process owner (bro-ybrja) (#424)
- debt: sonarcloud source — issues + hotspots on new code (bro-huy5o.4) (#400)
- debt: codacy + codescene debt sources (bro-huy5o.5) (#483)
- doctor: warn when dev-checkout bro on PATH predates checkout HEAD (bro-s7vgd) (#419)
- doctor: warn when a client classifier rides the acp conductor (bro-9ww2q) (#523)
- doctor: warn when the running daemon's binary isn't the repo build (#688)
- dogfood: scenario-driven e2e self-test — bro self dogfood (#497)
- dogfood: claude-plugin scenario + .files provisioning (bro-0ysuu) (#571)
- dogfood: npx-bro-only runbooks — bro task + bro serve ensure (bro-hc1oy) (#576)
- dogfood: codex provider — config.toml + env_key token path (bro-bvipw.2) (#590)
- dogfood: e2e scenario tree — claude+codex + matrix index (bro-bvipw.3) (#591)
- drive: ci-fail and sast blockers spawn per-class fixers (bro-atb2g) (#462)
- drive: bro drive install — armed want-marker, checkpoint rearm (bro-y5zon) (#468)
- drive: the bus says when a foreign push lands on your branch (bro-cqjd0) (#611)
- events: github webhook ingest → github:* bus topics (bro-huy5o.7) (#389)
- fleet: routing M2 — class resolution + provider walls (bro-6y6w6) (#333)
- fleet: judge router classifies unclassed mol steps (bro-9kqvy) (#364)
- fleet: bro fleet resume — the post-restart runbook as one pass (#496)
- fleet: bro fleet delegate — agent A activates agent B (bro-z8tng) (#652)
- fleet: add explicit credential scope for workers (#789)
- goal: session-scoped completion goals — bro goal + hook reminders (bro-6vcll) (#365)
- herdr: pull-only bro.fleet plugin — reconcile workspaces + log-mirror panes (bro-762eh) (#758)
- herdr: acp:watch — readonly ACP session pane (bro-5vjpg) (#774)
- herdr: plugin v2 — status labels, event renderer, reaper on bus events (bro-8dbyb) (#785)
- herdr: daemon-owned fleet status projector (bro-u19mq) (#797)
- herdr: native pane LED via pane report-agent from the fleet projector (bro-awqde) (#805)
- hooks: shell fast-path in run.sh for no-op post-tool/prompt-submit (#646)
- hooks: versioned host capability matrix + native payload conformance (bro-l8c4f.8) (#661)
- jira: tasks connector over the atlassian CLI (bro-huy5o.3) (#435)
- lane: pace the devin lane — a shared rate gate, and the wall pauses every worker (#685)
- loop: route agent spawns through the provider registry (bro-c3no8) (#370)
- loop: task-stack round-robin — service gate updates instead of idling (bro-zsmwq) (#384)
- loop: batch claims — N same-affinity beads, one worker, one PR (#397, #42)
- loop: spawn workers through the agents registry — the tick never awaits a worker (bro-zpa93) (#399)
- loop: disk floor admission — pushes hold when free disk < N×worktreeMb (bro-2spp7) (#407)
- loop: beads materialize as tracker issues at PR-armed time (bro-z2z7f) (#411)
- loop: PR ownership marking — bro-managed label + body trailer (bro-c650l) (#457)
- mesh: bro request — same-machine delivery into the target's store (bro-5nnj.1) (#565)
- mesh: bro wait external:
<ref>— bounded dep-plane watcher (bro-5nnj.2) (#604) - mesh: cross-repo REMOTE planes — github-issue + wasteland transports (bro-5nnj.3) (#608)
- notify: webhook sinks — slack, telegram, generic (bro-huy5o.8) (#436)
- omp: bro as an omp plugin — the adapter framework and the mode bridges (#651)
- otel: hook-first telemetry — emitHook facade + bro otel command (bro-xgejl) (#669)
- pi: surface bead PR/issue links on panel + pi plugin spec doc (#693)
- pi: autocomplete for /bro subcommands (#694)
- planes: bro mcp — stdio MCP server over read planes (bro-9rls.2) (#387)
- provider: host-level listener + url/token/env helpers — one settings.json wire for every claude (bro-om6m8.1) (#500)
- provider: self-starting host gateway — one acp listener per machine (bro-dluwn) (#595)
- providers: acp onUpdate seam — streaming surface for chat/call (#555)
- pulse: bro pulse — the session-owned metronome (bro-ijffz) (#474)
- rig: bro rig — the rig's own checkout keeps itself current (bro-te73m) (#403)
- serve: real /fleet dashboard — agents+queue+PRs+ticks+mailbox (bro-w4a45) (#421)
- serve: /v1/* Messages-API provider plane — bro as a Claude Code provider (#495)
- serve: GET /api/v1/agents/
<ref>/log — token-gated tail + SSE follow (bro-j1kk2.3) (#541) - serve: REST surface over the plane catalog (bro-9rls.3) (#562)
- serve: /ui — index-driven plane-catalog dashboard (bro-9rls.4) (#563)
- serve: SSE /api/v1/events/stream + AsyncAPI + notify dual-write (bro-9rls.5) (#564)
- serve: openai dialects — /v1/responses + /v1/chat/completions (bro-zkpju) (#589)
- serve: conductor acp terminal surface — /api/v1/terminals/
<id>/output (bro-eua0d) (#584) - serve: conductor forwards agent tool activity as tool_activity SSE events (bro-btccj) (#614)
- serve: native ACP transport — brokered sessions (merge main + check fixes) (#677)
- sessions: the batch lane gets its own share of the worker budget (bro-9h86l) (#607)
- setup: bro setup --lock materialises the skills bro does not own (#679)
- site: What's New — human-readable 0.3.0 release notes (bro-j1kk2.14) (#575)
- skill: the branch goes with the PR — cleanup is part of the formula (#631)
- skills: bro skills — config-declared agent-skill deps (bro-448ze) (#788)
- stack: connector facade for platform stack ops — bro stack merge (bro-r6vge) (#378)
- stack: register member PRs as the host stack via gh stack link (bro-z76f2) (#406)
- status: worktree plane on the live board (bro-0vj14) (#504)
- status: surface stale-checkout drift — behind-upstream sync row (bro-6k3f4) (#560)
- supervisors: one drive/loop per repo — heartbeated singleton hold (bro-2duu9) (#414)
- tasks: github-issues tasks connector — zero-install task store (bro-huy5o.1) (#371)
- tasks: linear connector — TaskStore + queries facade (bro-huy5o.2) (#383)
- tasks: batch serial bd-show — TaskStore getMany bulk read + degrade helpers (bro-hcx5p) (#458)
- tasks: declare claim() capability — exclusive lease vs best-effort assignment (bro-l8c4f.12) (#665)
- telemetry: command-level timing + bro telemetry report (bro-537yo) (#367)
- telemetry: rig lifecycle journal — one ordered JSONL the planes read (bro-ub91h) (#408)
- telemetry: the devin lane's account rate and live counts (bro-g0izo) (#624)
- watch: durable heartbeat file — overnight state is a read (bro-dxoa5) (#415)
- watch: session pulse replaces OS timers — armed marker + lock + rearm nudge (bro-killn) (#420)
- watch: postTool checkpoint rearms the pulse — zero-cost, no LLM (bro-killn) (#422)
- webui: per-agent live log pane — EventSource tail on /log?follow (bro-wwo7e) (#582)
🩹 Fixes
- hermetic git fixtures + fractional poll cadence for e2e (bro-52ek1) (#642)
- acp: shell-wrap args-empty terminal commands (bro-hg4om) (#592)
- acp-worker: buffer agent_message_chunk deltas into single log lines (bro-dojl5) (#572)
- act: merge stacked PRs through the async endpoint (bro-h07vx) (#338)
- act: rearm sees real wait markers; loop gate waits arm them (bro-z0k2u) (#372)
- act: carry loop-claimed bead through rearmed watch markers (bro-q6ppv) (#391)
- act: shared gate-state feed — one fetch per PR per TTL (bro-0tcrl) (#470)
- act: the no-target error names what to do instead (#678)
- agents: split worker stderr into
<agentId>.stderr (bro-e2ec0) (#620) - agents: owner-only prompt/log/exit/env artifacts (bro-l8c4f.4) (#659)
- agents: stop chasing the moving rate-limit deadline (bro-9eeld) (#749)
- bd: unambiguous BD_NOT_FOUND id token (CodeQL js/polynomial-redos) (#456)
- beads: validate + escape PATH-resolved doltBin in systemd ExecStart (#491)
- check: COLLECTION_FAILED is a marked evaluation failure, never a respawned pass (bro-l8c4f.13) (#663)
- cli: absolutize the self-respawn entry at module load (bro-meqjk) (#455)
- cli: discharge re-reads a prefetched
closedrow before skipping (bro-cmr5h) (#489) - cli: bound lock-holder liveness by the steal rule (bro-8o9f8) (#494)
- cli: merge-path occupancy TTL for green PRs (bro-ihnlv) (#467)
- cli: setup writes the gitignored local layer docs claim (bro-l8c4f.18) (#673)
- codescene: the App is the gate — drop the CI workflow, keep the local check (#605)
- conductor: strip claude [1m] context suffix from model pins (bro-0g2l3) (#574)
- conductor: strip [1m] context suffix from model ids before pin resolution (bro-0g2l3) (#579)
- convoy: mark runner spawns BRO_BATCH — ride the fleet lane (bro-gy1ez) (#757)
- core: bound bd calls with timeout supervisor + janitor orphan sweep (bro-8845g) (#404)
- core: bridge dolt git remotes through a managed local mirror (bro-wxgt3) (#461)
- core: bound batched task reads under the OS argv cap (bro-n9dot) (#493)
- core: janitor tail-caps serve-turns.jsonl — the conductor's otel journal is bounded (bro-g6bj7) (#602)
- core: spec coverage scans linked worktrees' specs/ (bro-3rhzs) (#603)
- daemon: scope the supervisor down-sweep to this repo (bro-cx1s6) (#522)
- deps: override @modelcontextprotocol/sdk to ^1.31.0 — GHSA-6qxp-vccf-f47h (#327)
- deps: move the bundled check executor off deprecated @sverka/cli (bro-u2dp5) (#332)
- deps: bump zod to ^4.6.6 in @broject/providers (#692)
- deps: bump body-parser to 2.4.0 (GHSA-27r3-jxmh-p828) (bro-9b5c6) (#702)
- deps: force zod ^4.6.6 via overrides — Dependabot alert #46 (bro-tx044) (#703, #46)
- deps: override toml to ^5.0.1 — Dependabot alert #45 (#704, #45)
- deps: bump zod to 4.6.7 in site lockfile — Dependabot alert #52 (bro-a2frz) (#711, #52)
- deps: bump fast-uri to 3.1.9 to address CVE-2026-110180 (GHSA-wjr9-j795-jxcr) (#697)
- deps: add fast-uri override for GHSA-w74x-v6f9-j3xg (#784)
- devin: verify session pid cmdline — reap pid-reuse phantoms (bro-0d7on) (#587)
- docs: npm onboarding names commands npm latest cannot dispatch (bro-l8c4f.17) (#671)
- doctor: format derived RigRef in mesh row — was printing [object Object] (bro-jkwm2) (#448)
- dogfood: arm sdd.mode=gate in the scratch repo config (bro-g48r4) (#516)
- dogfood: claude headless model pin + apiKeyHelper backend env (#578)
- dogfood: create the bead before claude-basics claims it (#600)
- dolt: detect remote stores whose manifest names missing table files (bro-orcdv) (#621)
- drive: spawn a rebase fixer on conflicted orphan PRs (bro-glkes) (#412)
- drive: count failed branch listings as incomplete enumeration (bro-izrgw) (#428)
- drive: skip PRs a live supervisor marker already owns (bro-0aa87) (#373)
- drive: enumerate remote-only fleet branches as PR candidates (#559)
- drive: use store for rig-next ready check (#755)
- filelock: lock is a directory — kill capture/restore ownership race (bro-l8c4f.2) (#657)
- fleet: down tells stopped only when the worker is dead (bro-l8c4f.3) (#634)
- fleet: durable spawn handshake — close the spawn/handle crash window (bro-l8c4f.5) (#691)
- fleet: spawn native workers in their own systemd scope (bro-ybo8z) (#742)
- github: bound the check-annotations fan-out (bro-2l7r9) (#413)
- github: heal stale external_ref on re-publish — stop duplicate issues (#446)
- goal: silence paused goals in the stop hook; resolve CLAUDE_CODE_SESSION_ID (#635)
- guard: record-path throw must never discard decided lines (bro-oahg) (#512)
- homebrew: require a full vX.Y.Z dispatch tag (bro-tkuse) (#423)
- homebrew: order semver prereleases below finals in downgrade check (#425)
- hooks: reference-transaction ref guard — fence non-ff branch moves (#326)
- hooks: post-merge installs the dep graph before build (bro-sovl3) (#385)
- hooks: claimed-beads stop nudge only reaches task-armed sessions (bro-hpb35) (#506)
- hooks: subtract spawn-pinned claims from the parallel-work nudge (bro-qteky) (#519)
- hooks: suppress own-agent claims in parallel-work nudges (#534)
- hooks: hard wall-clock deadline — Node timer + run.sh watchdog (bro-36sx7.13) (#723)
- loop: strict flag parse — unquoted --agent tail spawned interactive devin TUIs (#366)
- loop: close-out reaps its own loop/* worktree litter (bro-co9nj) (#379)
- loop: work-order checkpoints commit+push before deep verification (bro-d6k4v) (#392)
- loop: never exit silently mid-run — heartbeat + death audit (bro-snga4) (#376)
- loop: no wall-clock agent kill — stall is an advisory read at check-in (bro-9lpn3) (#377)
- loop: trim worker cold-start noise — disable dead config importers (bro-5lfp1) (#401)
- loop: clamp silentMs at 0 — sub-ms mtime vs floored Date.now() read negative (bro-zigwt) (#416)
- loop: exit audit survives a failing bro sync — throws, never exits (bro-qjbwq) (#441)
- loop: release orphaned claims + bound parked worktrees (bro-ho09d) (#398)
- loop: parked beads snooze the claim instead of holding it forever (#472)
- loop: surface live registry-path loop workers in watch/status (bro-wg896) (#476)
- loop: resolve fleet.routing class per bead (bro-zmned) (#393)
- loop: post-sync claim read degrades on 15s bd timeout instead of killing the supervisor (bro-etimout) (#800)
- mesh: drop verdicted threads from inbox (bro-2o3cw) (#359)
- notify: anonymous keyed publishes coalesce nothing (bro-f5ym) (#346)
- otel: bound dead-endpoint emissions — no in-process OTLP sockets (bro-uwoss) (#719)
- output: every user-facing PR reference renders as a link (#681)
- proc: monitors don't occupy the worktree (bro-dkw3e) (#556)
- providers: cli provider passes the prompt file via $1, not the line (#675)
- release: derive publish.yml package set, mark bundled internals private (#345)
- release: prerelease dist-tag — a preview must not take over npm latest (#799)
- release: let nx rewrite internal dep ranges on cross-minor bumps (#811)
- retro: make the learn-capture persist step explicit (bro-l2sm) (#452)
- rig: absolutize the rig-pulse respawn entry via SELF_ENTRY (bro-meqjk) (#515)
- rig: pin rig pulse spawn record against pid reuse (bro-t2jc1) (#514)
- scripts: %-escape dolt binary path in dolt-server unit ExecStart (bro-9v45) (#511)
- serve: hold serve.json.lock heartbeated via holdFileLock (bro-5lngt) (#445)
- serve: keepalive watchdog + main-worktree anchor (bro-ofbw4) (#596)
- serve: openai-dialect debt sweep — loud input failures, chat stop, shared mappings (bro-4c8pz) (#609)
- serve: a wire-trimmed reply retires the divergent session (bro-vfbyc) (#610)
- serve: recorded reply reads emitted blocks — mid-tag narration corrupts a re-parse (bro-cfwc1) (#612)
- serve: drain request body before 413 — kill RST/ECONNRESET race (bro-df1xf) (#617)
- serve: conductor surfaces cancelled + non-enum acp stop reasons honestly (bro-6fk80) (#623)
- serve: reject unknown previous_response_id with 400 (bro-d63hu) (#676)
- site: bump @tanstack/start to patched versions (GHSA-qx66-fv34-fjm8) (#593)
- spec: exempt molecule issue_type from spec check (bro-6z124) (#360)
- status: route worktree test through testGit — merge race broke main (#532)
- sync: tolerate absent refs/bro/data on pull — empty restore is not an error (bro-e1e3p) (#485)
- tasks: bro trailer counts only as the body's last element (bro-awwzc) (#444)
- tasks: reopen releases claims — bd reopen no-ops on in_progress (bro-aqjji) (#544)
- watch: pin pulse spawn record against pid reuse (bro-t2jc1) (#454)
- watch: bound the pulse-spawn trust window both directions (bro-zplip) (#487)
- watch: gates discovers open PRs via fleet branches, not the registry (bro-hn7kx) (#501)
- watch: bound persisted pulse cadences by the shared interval floor (bro-sg6e) (#510)
- work: refuse worktree removal while processes are rooted in it (#554)
🔥 Performance
- core: memoize gitCommonDir per process (bro-36sx7.8) (#706)
- guard: sweep probes and defs in parallel (bro-nfl5s) (#390)
- hooks: overlap probe stages + memoize session context — stop 6.4s→3.6s (bro-wc0i6) (#368)
- hooks: never wait on locks or hung git in the hook path (bro-36sx7.1, bro-36sx7.2) (#701)
- hooks: drop bro-hooks probe and npx fallback from hook launchers (bro-36sx7.6) (#707)
- hooks: plugin run.sh defers to a project-local Devin hook chain (bro-36sx7.5) (#708)
- hooks: bound remaining git lookups on the hook path (bro-36sx7.14) (#713)
- hooks: hard wall-clock deadline for every hook (bro-36sx7.13) (#714)
- hooks: async git twins — probe paths fully off spawnSync (bro-36sx7.2) (#717)
- hooks: drop duplicate .devin hook chain + doctor hooks-wiring check (bro-36sx7.5) (#740)
- hooks: cached gate verdict, judge off the hot path (bro-36sx7.4) (#747)
- hooks: residual lock removals on top of #701 (bro-36sx7.1) (#716, #701)
- hooks: bound remaining unbounded git probes on the hook path (bro-36sx7.14) (#726)
- kilo: async hook spawn so bro never freezes Kilo (bro-36sx7.3) (#709)
- learn: batch capture's bd reads — O(1) calls, not O(rows) (bro-rcs07) (#443)
❤️ Thank You
- Devin @devin-ai-integration[bot]
- Devin AI @devin-ai-integration[bot]
- Letta Code
- Petr Plenkov @ThePlenkov
0.2.5 (2026-10-07)
🚀 Features
- act: blocked act-wait settle surfaces as a finding (bro-q4iq0) (#380)
- act: merge queue for every PR + opt-in external queue connectors (bro-huy5o.6) (#388)
- act: act wait --detach — a watcher that outlives the session (#450)
- agents: agents.devin.maxWorkers — split the spawn-plane quota (#410)
- agents: docker container isolation backend (bro-huy5o.10) (#438)
- agents: copilot agent-task connector — first cloud backend (bro-huy5o.12) (#447)
- beads: .beads store on a managed dolt sql-server (bro-n59xn) (#405)
- build: session-attributed build stamp — who last wrote dist is recorded (bro-fatja) (#402)
- claude: install the plugin from the repo root (#395)
- cli: command groups — bro dispatch (bro-b5v2t) (#396)
- cli: land cli spec + migrate docs to grouped spelling (bro-vlmrb.1/.2) (#459)
- cli: optional OTLP export of the session trace journal (bro-huy5o.11) (#439)
- codex: native plugin hooks and prompt-visible skills (#369)
- daemon: bro daemon — the project-scoped process owner (bro-ybrja) (#424)
- debt: sonarcloud source — issues + hotspots on new code (bro-huy5o.4) (#400)
- debt: codacy + codescene debt sources (bro-huy5o.5) (#483)
- doctor: warn when dev-checkout bro on PATH predates checkout HEAD (bro-s7vgd) (#419)
- doctor: warn when a client classifier rides the acp conductor (bro-9ww2q) (#523)
- dogfood: scenario-driven e2e self-test — bro self dogfood (#497)
- drive: ci-fail and sast blockers spawn per-class fixers (bro-atb2g) (#462)
- drive: bro drive install — armed want-marker, checkpoint rearm (bro-y5zon) (#468)
- events: github webhook ingest → github:* bus topics (bro-huy5o.7) (#389)
- fleet: judge router classifies unclassed mol steps (bro-9kqvy) (#364)
- fleet: bro fleet resume — the post-restart runbook as one pass (#496)
- goal: session-scoped completion goals — bro goal + hook reminders (bro-6vcll) (#365)
- jira: tasks connector over the atlassian CLI (bro-huy5o.3) (#435)
- loop: route agent spawns through the provider registry (bro-c3no8) (#370)
- loop: task-stack round-robin — service gate updates instead of idling (bro-zsmwq) (#384)
- loop: batch claims — N same-affinity beads, one worker, one PR (#397, #42)
- loop: spawn workers through the agents registry — the tick never awaits a worker (bro-zpa93) (#399)
- loop: disk floor admission — pushes hold when free disk < N×worktreeMb (bro-2spp7) (#407)
- loop: beads materialize as tracker issues at PR-armed time (bro-z2z7f) (#411)
- loop: PR ownership marking — bro-managed label + body trailer (bro-c650l) (#457)
- notify: webhook sinks — slack, telegram, generic (bro-huy5o.8) (#436)
- planes: bro mcp — stdio MCP server over read planes (bro-9rls.2) (#387)
- provider: host-level listener + url/token/env helpers — one settings.json wire for every claude (bro-om6m8.1) (#500)
- pulse: bro pulse — the session-owned metronome (bro-ijffz) (#474)
- rig: bro rig — the rig's own checkout keeps itself current (bro-te73m) (#403)
- serve: real /fleet dashboard — agents+queue+PRs+ticks+mailbox (bro-w4a45) (#421)
- serve: /v1/* Messages-API provider plane — bro as a Claude Code provider (#495)
- stack: connector facade for platform stack ops — bro stack merge (bro-r6vge) (#378)
- stack: register member PRs as the host stack via gh stack link (bro-z76f2) (#406)
- status: worktree plane on the live board (bro-0vj14) (#504)
- supervisors: one drive/loop per repo — heartbeated singleton hold (bro-2duu9) (#414)
- tasks: github-issues tasks connector — zero-install task store (bro-huy5o.1) (#371)
- tasks: linear connector — TaskStore + queries facade (bro-huy5o.2) (#383)
- tasks: batch serial bd-show — TaskStore getMany bulk read + degrade helpers (bro-hcx5p) (#458)
- telemetry: command-level timing + bro telemetry report (bro-537yo) (#367)
- telemetry: rig lifecycle journal — one ordered JSONL the planes read (bro-ub91h) (#408)
- watch: durable heartbeat file — overnight state is a read (bro-dxoa5) (#415)
- watch: session pulse replaces OS timers — armed marker + lock + rearm nudge (bro-killn) (#420)
- watch: postTool checkpoint rearms the pulse — zero-cost, no LLM (bro-killn) (#422)
🩹 Fixes
- act: rearm sees real wait markers; loop gate waits arm them (bro-z0k2u) (#372)
- act: carry loop-claimed bead through rearmed watch markers (bro-q6ppv) (#391)
- act: shared gate-state feed — one fetch per PR per TTL (bro-0tcrl) (#470)
- bd: unambiguous BD_NOT_FOUND id token (CodeQL js/polynomial-redos) (#456)
- beads: validate + escape PATH-resolved doltBin in systemd ExecStart (#491)
- cli: absolutize the self-respawn entry at module load (bro-meqjk) (#455)
- cli: discharge re-reads a prefetched
closedrow before skipping (bro-cmr5h) (#489) - cli: bound lock-holder liveness by the steal rule (bro-8o9f8) (#494)
- cli: merge-path occupancy TTL for green PRs (bro-ihnlv) (#467)
- core: bound bd calls with timeout supervisor + janitor orphan sweep (bro-8845g) (#404)
- core: bridge dolt git remotes through a managed local mirror (bro-wxgt3) (#461)
- core: bound batched task reads under the OS argv cap (bro-n9dot) (#493)
- daemon: scope the supervisor down-sweep to this repo (bro-cx1s6) (#522)
- doctor: format derived RigRef in mesh row — was printing [object Object] (bro-jkwm2) (#448)
- dogfood: arm sdd.mode=gate in the scratch repo config (bro-g48r4) (#516)
- drive: spawn a rebase fixer on conflicted orphan PRs (bro-glkes) (#412)
- drive: count failed branch listings as incomplete enumeration (bro-izrgw) (#428)
- drive: skip PRs a live supervisor marker already owns (bro-0aa87) (#373)
- github: bound the check-annotations fan-out (bro-2l7r9) (#413)
- github: heal stale external_ref on re-publish — stop duplicate issues (#446)
- guard: record-path throw must never discard decided lines (bro-oahg) (#512)
- homebrew: require a full vX.Y.Z dispatch tag (bro-tkuse) (#423)
- homebrew: order semver prereleases below finals in downgrade check (#425)
- hooks: post-merge installs the dep graph before build (bro-sovl3) (#385)
- hooks: claimed-beads stop nudge only reaches task-armed sessions (bro-hpb35) (#506)
- hooks: subtract spawn-pinned claims from the parallel-work nudge (bro-qteky) (#519)
- loop: strict flag parse — unquoted --agent tail spawned interactive devin TUIs (#366)
- loop: close-out reaps its own loop/* worktree litter (bro-co9nj) (#379)
- loop: work-order checkpoints commit+push before deep verification (bro-d6k4v) (#392)
- loop: never exit silently mid-run — heartbeat + death audit (bro-snga4) (#376)
- loop: no wall-clock agent kill — stall is an advisory read at check-in (bro-9lpn3) (#377)
- loop: trim worker cold-start noise — disable dead config importers (bro-5lfp1) (#401)
- loop: clamp silentMs at 0 — sub-ms mtime vs floored Date.now() read negative (bro-zigwt) (#416)
- loop: exit audit survives a failing bro sync — throws, never exits (bro-qjbwq) (#441)
- loop: release orphaned claims + bound parked worktrees (bro-ho09d) (#398)
- loop: parked beads snooze the claim instead of holding it forever (#472)
- loop: surface live registry-path loop workers in watch/status (bro-wg896) (#476)
- loop: resolve fleet.routing class per bead (bro-zmned) (#393)
- mesh: drop verdicted threads from inbox (bro-2o3cw) (#359)
- release: derive publish.yml package set, mark bundled internals private (#345)
- retro: make the learn-capture persist step explicit (bro-l2sm) (#452)
- rig: absolutize the rig-pulse respawn entry via SELF_ENTRY (bro-meqjk) (#515)
- rig: pin rig pulse spawn record against pid reuse (bro-t2jc1) (#514)
- scripts: %-escape dolt binary path in dolt-server unit ExecStart (bro-9v45) (#511)
- serve: hold serve.json.lock heartbeated via holdFileLock (bro-5lngt) (#445)
- spec: exempt molecule issue_type from spec check (bro-6z124) (#360)
- status: route worktree test through testGit — merge race broke main (#532)
- sync: tolerate absent refs/bro/data on pull — empty restore is not an error (bro-e1e3p) (#485)
- tasks: bro trailer counts only as the body's last element (bro-awwzc) (#444)
- watch: pin pulse spawn record against pid reuse (bro-t2jc1) (#454)
- watch: bound the pulse-spawn trust window both directions (bro-zplip) (#487)
- watch: gates discovers open PRs via fleet branches, not the registry (bro-hn7kx) (#501)
- watch: bound persisted pulse cadences by the shared interval floor (bro-sg6e) (#510)
🔥 Performance
- guard: sweep probes and defs in parallel (bro-nfl5s) (#390)
- hooks: overlap probe stages + memoize session context — stop 6.4s→3.6s (bro-wc0i6) (#368)
- learn: batch capture's bd reads — O(1) calls, not O(rows) (bro-rcs07) (#443)
❤️ Thank You
- Devin @devin-ai-integration[bot]
- Petr Plenkov @ThePlenkov
0.2.4 (2026-09-30)
🚀 Features
- cli: bro doctor — environment diagnostics command (bro-2vt) (#148)
- core: bd compat check + graceful jsonl degrade (bro-y1b) (#151)
- core: 0.x contract stability — changelog + deprecation seams (bro-7ix) (#153)
- debt: announce stealth .beads init — beads stays a default store (bro-0fc) (#152)
- debt: bro debt trend — burn-down over time (bro-55t) (#157)
- gitlab: second connector — ReviewFacade over glab (bro-00t) (#149)
- next,loop: declared label scope — loops can't bleed across the queue (bro-idk7) (#167)
- plans: versioned plan schemas + bro plan validate (bro-2u5) (#150)
- setup: @broject/bro-pack — capabilities ship as an npm pack (#165)
- site: /debt — bro's own debt dashboard, live from refs/bro/data (#166)
- site: /debt shows harvested findings, not only the status overlay (#168)
🩹 Fixes
- debt batch — bd diagnostics, merge semantics, doc-dispatch namespace (#102)
- ci,cli: release-tag fallback searches ancestry; cleanup degrade-path tests (bro-p1sm, bro-ara7) (#160)
- cli: cleanup treats review-host auth as a warning, not a gate (bro-owg) (#130)
- cli: own-keys check for reserved doc nouns (bro-ff6) (#154)
- cli: memoize filtered doc types — one collision warning per process (bro-zpf) (#155)
- cli: reserve plugin command names in the doc-type guard (bro-e8o) (#156)
- cli: debt watch syncs the ledger to gitref per tick (bro-mtwa) (#162)
- cli: debt watch — fail-fast auth at startup, throw per tick (#161)
- cli: read-only debt commands no longer publish the ledger (#163)
- cli: flag() recognizes --name=value — a missed label scope was fail-open (#171)
- cli: drop argv.includes gates — --label=v never reached flag() (#172)
- debt: sweep security + review findings — axios override, ci permissions, --label repeat (#170)
❤️ Thank You
- Devin @devin-ai-integration[bot]
- Petr Plenkov @ThePlenkov
0.2.3 (2026-09-30)
🚀 Features
- site: one template — minimal landing + docs on TanStack Start + Fumadocs (#119)
🩹 Fixes
- ci: release-tag falls back to second-parent subject on merge commits (bro-zra) (#127)
- cli: gate gh auth before repo resolution in debt commands (bro-5yu) (#131)
- cli: align engines floor with prepack's .ts execution (bro-5ce) (#143)
- core: verify assignee before a .task marker counts as own claim (bro-4xl) (#129)
- core: name the plugin when auth probe breaks the sync contract (bro-5yh) (#132)
- core: memoize connector auto-detect — ambiguity warning prints once (bro-2i8) (#133)
- core: claim ownership follows the serving task store's actor (bro-cwgv) (#144)
- github: throw on MERGED PR with null mergedAt (bro-olj) (#136)
- github: surface batch-wide explicitMergedPrs failures (bro-dv4) (#137)
- github: bound matchRemote to the github.com edge (bro-8l8) (#138)
- github: dedupe explicit mergedPrs ids at the facade (bro-tmk) (#140)
- github: type ThreadPage.line as number | null (bro-o08) (#141)
- loop: pin agent BEADS_DIR to the shared store; honor bd close as a verdict (#128)
- release: match only open PRs before skipping release-PR creation (#126)
🔥 Performance
- core: memoize bdActor probe per dir (bro-l7b9) (#145)
❤️ Thank You
- Devin @devin-ai-integration[bot]
- Devin AI @devin-ai-integration[bot]
- Petr Plenkov @ThePlenkov
0.2.2 (2026-09-29)
Changes in this release predate conventional-commit discipline, so the generator saw no typed commits. Shipped:
- debt: multi-source collectors — dependabot, code-scanning, secret-scanning, stale-prs, failed-ci (#112)
- nx: @nx-devkit/prepare-for-release plugin — npm bootstrap + OIDC trust (#114)
- cli: drop @broject/* devDeps from the published manifest (#115)
- cli: resolve conflict markers committed into package.json (#116)
0.2.1 (2026-09-29)
🚀 Features
- bro drill — scoped descent over beads + agent plugin (#18)
- gitref store backend — artifact sync on refs/bro/data (#45)
- act: bro act merge — gate-enforced merge (#29)
- act: act.ignoreChecks — advisory checks exit the gate (#47)
- act: bound the act loop — act.maxRounds caps inline fix rounds (#54)
- act: plan schema — batch thread verdicts via bro run (#68)
- act: bro act wait — the gate-watcher as a primitive (#72)
- act: merge-slot — serialize merges via bd (#67)
- act: wait auto-updates BEHIND branches — the update-branch button as code (#81)
- cli: bro cleanup — post-merge branch hygiene as mechanics (#33)
- cli: plugin registry — every command as a BroPlugin (#48)
- cli: external plugins via config plugins — bro is a host now (#51)
- cli: bare commands act on context (#57)
- cli: @theplenkov/bro/plugin — typed API for external plugins (#59)
- cli: bro work — parallel-friendly worktree lifecycle (#60)
- cli: bro loop — the autonomous backlog runner as a command (#75)
- cli: clickable PR links — bare #N is dead text (#97)
- config: linked worktrees inherit the main checkout's bro.config (#74)
- convoy: agent-internal molecule execution — bro convoy (#28)
- convoy: plan schema — pour plans for molecule execution (#78)
- core: bro.config.ts support (#44)
- core: plugin-owned config sections via configSchema (#49)
- core: unified plans — kind envelope + bro run (#53)
- debt: beads store on by default — auto bd init, ledger git-excluded (#26)
- debt: plan schema — batch triage via bro run (#66)
- drill: plan schema — declared descent trees via bro run (#70)
- gen-plugins: validate plugin.json shape + sync version with cli (#27)
- hooks: devin lifecycle bridge — rehydrate, stop-gate, self-approve (#21)
- next: bro next — the autonomous backlog scheduler (#61)
- next: plan schema — selection/execution plans via bro run (#79)
- retro: bro wtf + bro retrospect — self-correction over beads (#19)
- site: docs + landing on GitHub Pages (#55)
- sync: orchestrate bd sync — beads state rides along (#73)
- work: submodule lifecycle + bead claim on enter (#80)
🩹 Fixes
- npm 11 for OIDC trusted publishing (#14)
- strip placeholder _authToken so OIDC publishing engages (#15)
- publish dispatch decouples run-ref from publish-ref (#17)
- stale-status gate on non-OPEN PRs + non-object config roots (#30)
- debt batch — push-accurate fixRounds, defer-aware hook, setup .ts guard (#58)
- act: normalize mergeState casing at the fetch boundary (#39)
- act: guard reply comment + finish defer title message (#71)
- act,wtf: policy at the point of use — silent-resolve guardrail + sink escalation (#82)
- config: see through --separate-git-dir for worktree inheritance (#76)
- drill: retry-safe drillUp — idempotent prevention creation (#31)
- drill: fail loud on wrong-shaped bd dep list rows (#35)
- drill: normalize prevention-title dedupe — trim + case-fold (#36)
- drill: keep the original error through drillUp's compensation (#38)
- gen-plugins: slug regex must anchor end on alphanumeric (#40)
- gen-plugins: batch reviewer findings — validation + fs safety (#42)
- hooks: never assume $DEVIN_PLUGIN_ROOT — guard + fallback chain (#22)
- hooks: session-scoped stop gate — ambient state is context, not a block (#34)
- next: scope the queue to issue_prefix — foreign beads never claimed (#87)
🔥 Performance
- drill: batch parent-child edges via bd dep list (#50)
❤️ Thank You
- Devin @devin-ai-integration[bot]
- Petr Plenkov @ThePlenkov
0.2.0 (2026-09-15)
🚀 Features
🩹 Fixes
- harvested review findings — SAST unknown gate, personality validation, atomicWrite perms (#9)
❤️ Thank You
- Devin @devin-ai-integration[bot]
- Petr Plenkov @ThePlenkov
0.1.0 (2026-09-15)
🚀 Features
🩹 Fixes
- ci: build vendored nx plugins before nx targets (422e7fa)
- ci: route build/test through npm scripts for skills-* exclusion (ac00b43)
- cli: drop ./ prefix from bin path (#6)
- debt: review findings from skills#309 (#1, #309)
- debt: never remove debt:skipped from collect path (#2)
- debt: rescan labeled PRs with post-scan activity (#5)
❤️ Thank You
- Devin @devin-ai-integration[bot]
- Petr Plenkov @ThePlenkov