bullswarm 0.10.8 → 0.10.9

package/AGENTS.md

@@ -37,7 +37,7 @@ content. Published as `bullswarm` on npm.
 ## Development
 
 ```bash
-npm test            # 261 tests, no network needed (meters read from cache)
+npm test            # full suite, no network needed (meters read from cache)
 node bin/bullswarm.js doctor --json   # readiness report
 node bin/bullswarm.js workflow list   # discover workflows
 node bin/bullswarm.js workflow runs   # ongoing workflow instances

package/CHANGELOG.md

@@ -1,5 +1,27 @@
 # bullswarm changelog
 
+## 0.10.9 — planner self-correction and honest silence
+
+- An invalid or non-JSON orchestrator decision no longer fails the run. The
+  runtime feeds the exact validator issues, the rejected proposal, and a
+  response excerpt back to the same orchestrator thread for bounded corrective
+  turns (`settings.maxPlannerCorrections`, default 2, emits
+  `decision.correction_requested`), then benches that pool as orchestrator for
+  the rest of the run and escalates to one other eligible pool
+  (`decision.orchestrator_escalated`), and only then settles on a qualified
+  `completed_with_concerns`/`blocked` outcome. The decide action's ledger status
+  now agrees with that outcome (`failed_retryable` while correcting,
+  `failed_terminal` on exhaustion) instead of reporting `succeeded`.
+- The planner prompt now shows complete `run`, `fanout` (`items` +
+  `stepTemplate.prompt` with `{{item}}`), and `verify` (`review`) skeletons, so
+  the first proposal can match what `decision.js` validates.
+- `workflow watch` separates two silences: `quiet` counts durable workflow
+  events, and a new `agent output … ago` figure (JSONL `transportQuietForSec`)
+  counts raw output from live agents, so a thinking agent and a dead one look
+  different on the same heartbeat line.
+- Removed the dead thin-leaf help renderer left over from the help unification
+  and stopped hard-coding the test count in AGENTS.md.
+
 ## 0.10.8 — quieter monitoring and resilient orchestration
 
 - Made `workflow watch` aggregate low-level activity into compact interval

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "bullswarm",
-  "version": "0.10.8",
+  "version": "0.10.9",
   "description": "Route work across coding-agent CLI subscriptions — paced by live quota meters, verified by content, never trusting exit codes.",
   "type": "module",
   "bin": {

package/skill/SKILL.md

@@ -335,6 +335,14 @@ execute -> observe -> decide -> validate proposal -> append -> execute -> observ
 Allowed planner decisions are `proceed`, `complete`, `needs_more_work`,
 `retry`, `escalate`, `wait_for_approval`, and `stop`. Expansion decisions must
 contain bounded actions; malformed or over-budget output executes nothing.
+A malformed or non-JSON decision does not fail the run: the runtime returns
+the exact validator issues to the same orchestrator thread for up to
+`settings.maxPlannerCorrections` (default 2) corrective turns
+(`decision.correction_requested` events), then benches that pool as
+orchestrator for the rest of the run and tries one other eligible pool
+(`decision.orchestrator_escalated`), and only then settles on a qualified
+`completed_with_concerns`/`blocked` outcome. Safety bounds (`maxActions`,
+`maxItemsPerExpansion`) still terminate immediately with a qualified outcome.
 `complete` still requires successful delivery and verification. `stop` returns
 `completed_with_concerns` with a ready best-effort artifact when useful work
 exists, or `blocked` when it does not; neither hides failed verification.

package/src/cli.js

@@ -17,7 +17,7 @@ import { release } from './lib/release.js';
 import { cmdWorkflow } from './workflow/cli.js';
 import { cmdStrategy, maybeRefreshStrategy } from './strategy-cli.js';
 import { cmdIntegrate, installIntegration } from './integrate.js';
-import { helpForArgs } from './help.js';
+import { helpForArgs, usageLine } from './help.js';
 import { resolveDispatchModel } from './lib/strategy.js';
 
 export function getBullswarmDir() {
@@ -474,9 +474,7 @@ export async function main(argv) {
     case 'release':
       return cmdRelease(opts);
     default:
-      console.error(
-        `unknown verb "${verb}". try: setup | integrate | run | health | pools | strategy | doctor | workflow | runs | version | release`,
-      );
+      console.error(`unknown verb "${verb}". Run "bullswarm --help" for the list of commands.`);
       return 2;
   }
 }
@@ -486,7 +484,7 @@ export async function main(argv) {
 function cmdRelease(opts) {
   const kind = opts.rest[0];
   if (!['patch', 'minor', 'major'].includes(kind)) {
-    console.error('usage: bullswarm release patch|minor|major [--dry-run]');
+    console.error(`usage: ${usageLine(['release'])}`);
     return 2;
   }
   try {