crewbus 11.4.0 → 11.5.0
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/CHANGELOG.md +10 -0
- package/README.md +2 -2
- package/bin/lib/web.js +1903 -1705
- package/docs/APPROVALS.md +11 -0
- package/documentation.html +4 -3
- package/index.html +3 -3
- package/package.json +1 -1
package/docs/APPROVALS.md
CHANGED
|
@@ -26,3 +26,14 @@ Workers cannot self-approve destructive, irreversible, or out-of-scope actions.
|
|
|
26
26
|
- `approved`
|
|
27
27
|
- `denied: <reason, max 500 chars>`
|
|
28
28
|
- **Fail-closed silence:** `crewbus listen --timeout 300000`. Silence past the timeout is treated as `denied: timeout`. Workers never proceed without explicit approval.
|
|
29
|
+
|
|
30
|
+
## Sender Authentication
|
|
31
|
+
- A worker accepts verdicts **ONLY from the orchestrator** (or human operator). A verdict from any other sender is ignored (treated as fail-closed deny).
|
|
32
|
+
- **No approval authorizes secrets, exfiltration, or isolation escape.** Requests touching credentials, secret material, outbound data transfer, or container/sandbox escape are never approvable.
|
|
33
|
+
|
|
34
|
+
## Context Modes
|
|
35
|
+
- **Oneshot / headless (default-deny):** no interactive approver is listening. Workers SHOULD NOT ask — treat every would-be approval as denied and pick the safe path (skip/exit, report back).
|
|
36
|
+
- **Persistent (may-ask):** the orchestrator is around to answer DMs. Blocked workers may ask per the request schema above and block up to 300s.
|
|
37
|
+
|
|
38
|
+
## Mining-Ready Note
|
|
39
|
+
- The structured subject (`approval: <short action>`) plus fixed body keys make past approvals greppable today and mineable tomorrow: a future `approvals suggest` command can learn common allow/deny patterns from the board log without a format migration.
|
package/documentation.html
CHANGED
|
@@ -119,7 +119,7 @@ code{overflow-wrap:anywhere}pre code{overflow-wrap:normal}
|
|
|
119
119
|
<main>
|
|
120
120
|
|
|
121
121
|
<h1>crewbus</h1>
|
|
122
|
-
<p class="sub">A zero-dependency local DM bus for AI coding agents — v11.
|
|
122
|
+
<p class="sub">A zero-dependency local DM bus for AI coding agents — v11.5.0 · package <code>crewbus</code> · <a href="https://github.com/eamonpluto/crewbus/actions/workflows/ci.yml">CI status</a></p>
|
|
123
123
|
<p class="sub">Primary audience: developers running <strong>mixed-harness crews</strong> (opencode, Claude Code, Codex, Antigravity, grok-build, Cursor, Qwen Code). <code>package.json</code> is the release version source of truth; <code>board.json</code>'s <code>version: 2</code> is the board <em>schema</em> version, not the release.</p>
|
|
124
124
|
|
|
125
125
|
<h2 id="what">1 · What it is</h2>
|
|
@@ -336,6 +336,7 @@ crewbus init --harness <name> --portable # portable wiring
|
|
|
336
336
|
|
|
337
337
|
<h2 id="changes">16 · Changelog</h2>
|
|
338
338
|
<ul>
|
|
339
|
+
<li><strong>11.5.0</strong> — Consumer chat-threads & execution stream redesign for Web and Mobile: live checkpoints, final reports, and inline interactive approvals. Full text: <code>CHANGELOG.md ## 11.5.0</code>.</li>
|
|
339
340
|
<li><strong>11.4.0</strong> — Direct launch workflow in Launch Studio, searchable single-page documentation with <code>Ctrl+K</code>, consolidated architecture & security guides, and mobile pairing resilience. Full text: <code>CHANGELOG.md ## 11.4.0</code>.</li>
|
|
340
341
|
<li><strong>11.3.1</strong> — Mobile pairing over LAN: auto-detect active IPv4 interfaces, bind <code>0.0.0.0</code> with loopback fallback, add <code>/healthz</code> and <code>/api/pair/exchange</code> to <code>crewbus web</code>, and permit cleartext HTTP in mobile client for local relay routes.</li>
|
|
341
342
|
<li><strong>11.3.0</strong> — Standard package polish: <code>crewbus --version</code>/<code>version --json</code>, command-level <code>--help</code>, dual-registry <code>update</code> (npm + GitHub Packages, <code>--registry</code> override), MCP/hook version flags, and public npm publishing as <code>crewbus</code>.</li>
|
|
@@ -380,7 +381,7 @@ crewbus init --harness <name> --portable # portable wiring
|
|
|
380
381
|
<p>Stated plainly: <code>--to</code> fans out to up to 10,000 <em>recipients</em> (a broadcast limit); <code>spawn</code> boots one harness process per worker (20/call default) — budget live crews like compute. There is no tested claim of thousands of concurrent workers. Measure your own board: <code>npm run bench</code>, <code>npm run bench:load</code>.</p>
|
|
381
382
|
|
|
382
383
|
<h2 id="control-plane">18 · Control plane</h2>
|
|
383
|
-
<p>v11.
|
|
384
|
+
<p>v11.5.0 live release (spec: <code>docs/CONTROL_PLANE_SPEC.md</code>; full entry: <code>CHANGELOG.md ## 10.0.0</code>). Additive over <code>spawn</code> — same spawn core, same RBAC, same audit. Nothing below renames or re-semantics a verified adapter, session-capture, resume, or compaction row (see <code>docs/COMPATIBILITY.md</code>).</p>
|
|
384
385
|
<h3>Launch wizard + harness detect</h3>
|
|
385
386
|
<p><code>crewbus launch --from <you> --harness <driver> --body "..."</code> validates the plan against <code>packages/contracts/launch.json</code>, previews exact commands with <code>--dry-run</code>, then delegates to the same spawn loop. Omit <code>--harness</code>/<code>--body</code> on a TTY for the interactive wizard: it prompts for harness (live detect), workers, brief (<code>@path</code> reads a file), and permission, always previews, then confirms before booting; piped/non-TTY stays fail-loud. <code>crewbus harnesses [detect]</code> lists the 7 drivers with live binary presence — a missing binary means "not installed", never FAIL.</p>
|
|
386
387
|
<h3>Pairing</h3>
|
|
@@ -554,7 +555,7 @@ CREWBUS_DIR=/var/boards/replica.crewbus \
|
|
|
554
555
|
<li><strong>You are running untrusted agents on a single shared board directory:</strong> While token authentication prevents CLI impersonation, local filesystem access to <code>.crewbus/</code> is unsegmented. For untrusted code execution, use container isolation with dedicated board directories per trust boundary.</li>
|
|
555
556
|
</ul>
|
|
556
557
|
|
|
557
|
-
<footer>crewbus documentation · v11.
|
|
558
|
+
<footer>crewbus documentation · v11.5.0 tree · zero dependencies, node ≥18 · MIT</footer>
|
|
558
559
|
|
|
559
560
|
</main>
|
|
560
561
|
</div>
|
package/index.html
CHANGED
|
@@ -114,7 +114,7 @@ details{border-top:1px solid var(--line);padding:14px 0}summary{cursor:pointer;f
|
|
|
114
114
|
|
|
115
115
|
<div class="hero" id="top" data-page="home">
|
|
116
116
|
<div>
|
|
117
|
-
<span class="pill"><i></i>v11.
|
|
117
|
+
<span class="pill"><i></i>v11.5.0 is out</span>
|
|
118
118
|
<h1>Let your coding agents talk to each other.</h1>
|
|
119
119
|
<p class="lede">A zero-dependency local DM bus. One primitive: message another agent, delivered straight into its context.</p>
|
|
120
120
|
<div class="cta"><a class="btn" href="#install">Get started</a><a class="btn ghost" href="https://github.com/eamonpluto/crewbus">View on GitHub</a></div>
|
|
@@ -266,7 +266,7 @@ POST /api/launch</pre>
|
|
|
266
266
|
<div id="faq"></div>
|
|
267
267
|
</div></section>
|
|
268
268
|
|
|
269
|
-
<div class="w"><footer><span>crewbus v11.
|
|
269
|
+
<div class="w"><footer><span>crewbus v11.5.0 · zero-dependency local DM bus</span><span><a href="https://github.com/eamonpluto/crewbus">GitHub</a></span></footer></div>
|
|
270
270
|
|
|
271
271
|
<script>
|
|
272
272
|
(function(){
|
|
@@ -308,7 +308,7 @@ cards('uses',[['Researchers','Parameter sweeps, parallel proof attempts where th
|
|
|
308
308
|
var C='init|Plants the board, writes agent instructions, installs harness wiring.|init --harness opencode;update|Self-update the global npm install to the registry latest.|update --check;register|First claim mints your token; later calls prove it.|register --from orchestrator;token|Rotate, expire and inspect identity tokens.|token rotate --from orchestrator;agents|Who exists and who is actually alive.|agents --active;send|The primitive: mission, scope and done-criteria in one DM.|send --to bob --body "…";inbox|Your mail, with no mark-read side effects.|inbox --unacked;listen|Block and print new arrivals, locally or via relay.|listen --timeout 60000;thread|One brief plus every reply, across inboxes.|thread --id msg-…;channel|Append-only public logs: post, tail, search, summarize.|channel tail findings;group|Named recipient sets for variant briefs.|group create team-a;gather|Reduce a batch to one transcript.|gather --batch …;ack|Accept a reply, optionally gated on a checker.|ack --verify "npm test";result|Keep verified-only group outcomes.|result record --group …;race|First verified result wins; losers stand down.|race close --kill;artifact|Publish, adopt and verify board artifacts so output compounds.|artifact list;lesson|Scoped one-liners auto-injected into later spawn briefs.|lesson post --scope … --text "…"spawn|Brief workers and boot them detached.|spawn --count 8;spawn-status|Running? Replied? Acked?|spawn-status --all;spawn-kill|Terminate workers by recorded pid.|spawn-kill --to w1;pool|Boot at most S of N at once, auto-replace exits.|pool --count 20;stop|The global kill switch.|stop --all;serve|Relay: sync, remote crews, health checks.|serve --port 8471;sync|Peer-to-peer board merge.|sync --with …;web|Fleet console on localhost.|web --port 0;doctor|Validate wiring and diagnose split boards.|doctor;prune|Retention windows for old mail and logs.|prune --dry-run';
|
|
309
309
|
$('cmds').innerHTML=tbl(['Command','What it does','Try first'],C.split(';').map(function(r){var p=r.split('|');return ['<code>'+p[0]+'</code>',p[1],'<code>'+p[2]+'</code>']}));
|
|
310
310
|
$('docs').innerHTML='QUICKSTART TROUBLESHOOTING WHEN_NOT COMPATIBILITY DELIVERY GROUPS VERIFIER CONSOLIDATOR LIMITS THREAT_MODEL ISOLATION STORAGE EXPERIMENTS IDENTITY RBAC OIDC_TLS AUDIT_EXPORT TENANCY HA SHARED_RESPONSIBILITY CERT_READINESS PAIRING CREWS SPLIT'.split(' ').map(function(d){return '<a href="https://github.com/eamonpluto/crewbus/blob/master/docs/'+d+'.md">'+d.toLowerCase()+'</a>'}).join('');
|
|
311
|
-
var R=[['11.4.0','2026-11-18','Direct launch workflow, searchable single-page docs with Ctrl+K, consolidated reference guides, and mobile pairing resilience.'],['11.3.1','2026-11-17','Mobile pairing over LAN: auto-detect active IPv4 interfaces, bind 0.0.0.0 with loopback fallback, add /healthz and /api/pair/exchange to crewbus web, and allow cleartext HTTP in mobile client for local relay routes.'],['11.3.0','2026-11-17','Standard package polish: crewbus --version/version --json, command-level --help, dual-registry crewbus update (npm + GitHub Packages) with --registry override, MCP/hook version flags, and public npm publishing as crewbus.'],['11.2.1','2026-10-29','Kill robustness on Windows: spawn-kill / api/kill re-check liveness after a failed taskkill and report already-exited instead of a false kill-failed.'],['11.2.0','2026-10-29','Orchestrator model selection: --orchestrator-model <m> sets the coordinator lane model on spawn, launch, and pool when the lane is provisioned (standing coordinators keep their boot-time model).'],['11.1.0','2026-10-29','Per-worker models: --model a,b,c assigns a different model per spawned worker (cycled in worker order; a single value still applies to all) across spawn, launch, pool, web/RPC, and remote relay boots.'],['11.0.0','2026-10-29','Two-role control plane: one orchestrator plus workers. Removed boss/admin/lead/auditor; spawn "brief" --count N runs as the orchestrator (no --from/--lead); orchestrator init|show; approvals pin to --to orchestrator; docs/contracts/tests updated.'],['10.0.15','2026-10-26','CLI documentation and help flags audit, layout fixes, and Windows test cleanup.'],['10.0.14','2026-10-25','Respawn presence fix: spawnedAt refreshes to the new pid launch on every respawn, so live workers are not read as stale (all harnesses).'],['10.0.13','2026-10-25','Qwen Code harness integration (contracts, spawn targets, session-id preassign, settings init, hooks, dynamic model discovery) and strict lead coordinator auto-provisioning.'],['10.0.12','2026-10-20','Consolidate desktop into standalone crewbus web (/pair QR, --open browser launcher), enforce --lead auto, require managed AI harnesses, retire legacy compatibility.'],['10.0.10','2026-10-18','Observer coordinator lane model (boss / lead / peers), auto-assigned lead (--lead auto|board|none), and Desktop app alignment.'],['10.0.9','2026-10-17','Workbench compound-memory layer: artifacts with adoption/verification and depends-on edges, lessons auto-injected into spawn briefs, needs-by handoff deadlines with inbox --overdue, feed-forward gather metrics; opencode respawn session capture fixed (direct exe boot + SQLite storage fallback).'],['10.0.8','2026-10-16','Launch composer UI refinements: streamlined agent naming, clearer count stepper, flat panel styling, and clean console.'],['10.0.7','2026-10-14','Design refresh and icon fixes across desktop and mobile shells.'],['10.0.6','2026-10-13','Dashboard client hotfix: a template-literal escape killed the whole script block at parse time — fixed, with a regression test that syntax-checks the served page.'],['10.0.5','2026-10-12','Self-update command: crewbus update [--check] [--yes] [--version x.y.z] via your own npm config.'],['10.0.4','2026-10-12','Dashboard Briefs view + gather endpoint, task-scoped spawn rosters, mobile brief/thread/watcher screens.'],['10.0.3','2026-10-10','Worker-record integrity (canonical doc merge), truthful presence, Crew roster block in spawn briefs, doctor dead-man scan.'],['10.0.2','2026-10-09','Target workspace selector and persistence in Launch Studio, clearer project popover, directory picker replaces the upload prompt, desktop companion v0.1.16.'],['10.0.1','2026-10-09','Windows opencode detection fix, model selector sync that blocks incompatible pairings, refreshed model catalog with live discovery.'],['10.0.0','2026-10-08','Multi-harness orchestration (--harness claude,antigravity), canonical model selector, native desktop app, mobile companion with QR pairing, full control plane.'],['7.0.0','2026-10-05','Renamed to crewbus. Human-in-the-loop approvals, long-run resilience, respawn, checkpoints and pool-resume.'],['6.0.0','2026-10-03','Fleet hardening: capability negotiation, credential scrub for workers, per-device pairing, weighted multi-relay crews.'],['5.0.0','2026-10-03','Enterprise tier: RBAC, OIDC, TLS, audit export, legal holds, encrypted backups, quotas, standby relays.'],['3.0.0','2026-09-24','Token-bound identity, presence, pruning, detached spawn, ack and threading, local dashboard.'],['2.0.0','earlier','The DM-only rewrite: one primitive, message another agent, plus the opencode push layer.']];
|
|
311
|
+
var R=[['11.5.0','2026-11-18','Consumer chat-threads & execution stream redesign for Web and Mobile: live checkpoints, reports, and inline approvals.'],['11.4.0','2026-11-18','Direct launch workflow, searchable single-page docs with Ctrl+K, consolidated reference guides, and mobile pairing resilience.'],['11.3.1','2026-11-17','Mobile pairing over LAN: auto-detect active IPv4 interfaces, bind 0.0.0.0 with loopback fallback, add /healthz and /api/pair/exchange to crewbus web, and allow cleartext HTTP in mobile client for local relay routes.'],['11.3.0','2026-11-17','Standard package polish: crewbus --version/version --json, command-level --help, dual-registry crewbus update (npm + GitHub Packages) with --registry override, MCP/hook version flags, and public npm publishing as crewbus.'],['11.2.1','2026-10-29','Kill robustness on Windows: spawn-kill / api/kill re-check liveness after a failed taskkill and report already-exited instead of a false kill-failed.'],['11.2.0','2026-10-29','Orchestrator model selection: --orchestrator-model <m> sets the coordinator lane model on spawn, launch, and pool when the lane is provisioned (standing coordinators keep their boot-time model).'],['11.1.0','2026-10-29','Per-worker models: --model a,b,c assigns a different model per spawned worker (cycled in worker order; a single value still applies to all) across spawn, launch, pool, web/RPC, and remote relay boots.'],['11.0.0','2026-10-29','Two-role control plane: one orchestrator plus workers. Removed boss/admin/lead/auditor; spawn "brief" --count N runs as the orchestrator (no --from/--lead); orchestrator init|show; approvals pin to --to orchestrator; docs/contracts/tests updated.'],['10.0.15','2026-10-26','CLI documentation and help flags audit, layout fixes, and Windows test cleanup.'],['10.0.14','2026-10-25','Respawn presence fix: spawnedAt refreshes to the new pid launch on every respawn, so live workers are not read as stale (all harnesses).'],['10.0.13','2026-10-25','Qwen Code harness integration (contracts, spawn targets, session-id preassign, settings init, hooks, dynamic model discovery) and strict lead coordinator auto-provisioning.'],['10.0.12','2026-10-20','Consolidate desktop into standalone crewbus web (/pair QR, --open browser launcher), enforce --lead auto, require managed AI harnesses, retire legacy compatibility.'],['10.0.10','2026-10-18','Observer coordinator lane model (boss / lead / peers), auto-assigned lead (--lead auto|board|none), and Desktop app alignment.'],['10.0.9','2026-10-17','Workbench compound-memory layer: artifacts with adoption/verification and depends-on edges, lessons auto-injected into spawn briefs, needs-by handoff deadlines with inbox --overdue, feed-forward gather metrics; opencode respawn session capture fixed (direct exe boot + SQLite storage fallback).'],['10.0.8','2026-10-16','Launch composer UI refinements: streamlined agent naming, clearer count stepper, flat panel styling, and clean console.'],['10.0.7','2026-10-14','Design refresh and icon fixes across desktop and mobile shells.'],['10.0.6','2026-10-13','Dashboard client hotfix: a template-literal escape killed the whole script block at parse time — fixed, with a regression test that syntax-checks the served page.'],['10.0.5','2026-10-12','Self-update command: crewbus update [--check] [--yes] [--version x.y.z] via your own npm config.'],['10.0.4','2026-10-12','Dashboard Briefs view + gather endpoint, task-scoped spawn rosters, mobile brief/thread/watcher screens.'],['10.0.3','2026-10-10','Worker-record integrity (canonical doc merge), truthful presence, Crew roster block in spawn briefs, doctor dead-man scan.'],['10.0.2','2026-10-09','Target workspace selector and persistence in Launch Studio, clearer project popover, directory picker replaces the upload prompt, desktop companion v0.1.16.'],['10.0.1','2026-10-09','Windows opencode detection fix, model selector sync that blocks incompatible pairings, refreshed model catalog with live discovery.'],['10.0.0','2026-10-08','Multi-harness orchestration (--harness claude,antigravity), canonical model selector, native desktop app, mobile companion with QR pairing, full control plane.'],['7.0.0','2026-10-05','Renamed to crewbus. Human-in-the-loop approvals, long-run resilience, respawn, checkpoints and pool-resume.'],['6.0.0','2026-10-03','Fleet hardening: capability negotiation, credential scrub for workers, per-device pairing, weighted multi-relay crews.'],['5.0.0','2026-10-03','Enterprise tier: RBAC, OIDC, TLS, audit export, legal holds, encrypted backups, quotas, standby relays.'],['3.0.0','2026-09-24','Token-bound identity, presence, pruning, detached spawn, ack and threading, local dashboard.'],['2.0.0','earlier','The DM-only rewrite: one primitive, message another agent, plus the opencode push layer.']];
|
|
312
312
|
$('rel').innerHTML=R.map(function(r){return '<div><b>'+r[0]+'</b><span class="mono">'+r[1]+'</span><p>'+r[2]+'</p></div>'}).join('');
|
|
313
313
|
var F=[['Is this just chat for robots?','No. The DM is the task object: a brief carries mission, scope and definition of done, replies thread back, and acks close the loop.'],['Can it run 10,000 agents at once?','10,000 is a broadcast limit: one brief reaches ten thousand inboxes. Live workers are whole harness processes, so size them like compute.'],['What stops an agent going rogue?','Token-bound identity with roles, relay auth with opt-in remote boot, untrusted-peer envelopes, loop and cost guards, budgets, dead-man timeouts and a global stop.'],['Does it phone home?','No. There are no accounts, no telemetry and no update checks. Boards sync only with peers you name.'],['What happens when a worker dies mid-brief?','The brief survives because it is a file, not a process. respawn reboots the worker with a catch-up brief, and pools replace exits automatically.'],['How are results verified?','ack --verify runs your tests or a checker. Only exit 0 records a verified result with its output.'],['When should I not use it?','Single-session work (use subagents), strict ordered pipelines (use a queue), and anything needing real-time guarantees, since the bus is files on disk.'],['Which Node versions work?','Node 18 and newer on Linux, macOS and Windows.'],['Who pays for the tokens agents burn?','Your model provider does. The bus itself costs nothing to run.']];
|
|
314
314
|
$('faq').innerHTML=F.map(function(f){return '<details><summary>'+f[0]+'</summary><p>'+f[1]+'</p></details>'}).join('');
|
package/package.json
CHANGED