@botbuddy/cli 1.63.0 → 1.63.1

package/daemon-release/darwin-arm64.json

@@ -1,7 +1,7 @@
 {
-  "release_version": "1.63.0",
-  "source_commit": "cfcfef9b5adb90a7a7dfb2fd8cfad0206464149a",
-  "source_sha256": "9f30dd9147ad173965dfc2a5f1c8b209c32d760a82c3edd6cbf560108e95a5f0",
+  "release_version": "1.63.1",
+  "source_commit": "7f42fb391734dbc962548fddd42d4ccf84e63039",
+  "source_sha256": "7e21669993256b7566102111fe48ea9a2f7f5a309c962a99b82b4a2d27016d3d",
   "target": "darwin-arm64",
-  "sha256": "5d57767abb24be43ba64e17b57d9aa396c4149f4b89101e6a0346da57ec5ea41"
+  "sha256": "a3d98f8e3d76fc7d30266fd5e261880615b5e8377e1211cf87fe3927dfb9f156"
 }

package/daemon-release/linux-x64.json

@@ -1,7 +1,7 @@
 {
-  "release_version": "1.63.0",
-  "source_commit": "cfcfef9b5adb90a7a7dfb2fd8cfad0206464149a",
-  "source_sha256": "9f30dd9147ad173965dfc2a5f1c8b209c32d760a82c3edd6cbf560108e95a5f0",
+  "release_version": "1.63.1",
+  "source_commit": "7f42fb391734dbc962548fddd42d4ccf84e63039",
+  "source_sha256": "7e21669993256b7566102111fe48ea9a2f7f5a309c962a99b82b4a2d27016d3d",
   "target": "linux-x64",
-  "sha256": "33e0e6ba075a7486a02e4a3638bce10e1df41ddfe8315685e285cf144a149ea7"
+  "sha256": "1edca9db4f9e8e8d72b9112acf63ec6ba4ca09423cee8ef0afe4bae0abb78bc2"
 }

package/daemon-release/manifest.json

@@ -1,21 +1,21 @@
 {
   "schema_version": 1,
-  "release_version": "1.63.0",
-  "source_commit": "cfcfef9b5adb90a7a7dfb2fd8cfad0206464149a",
-  "source_sha256": "9f30dd9147ad173965dfc2a5f1c8b209c32d760a82c3edd6cbf560108e95a5f0",
+  "release_version": "1.63.1",
+  "source_commit": "7f42fb391734dbc962548fddd42d4ccf84e63039",
+  "source_sha256": "7e21669993256b7566102111fe48ea9a2f7f5a309c962a99b82b4a2d27016d3d",
   "targets": {
     "darwin-arm64": {
       "goos": "darwin",
       "goarch": "arm64",
       "binary": "daemon/bin/darwin-arm64/botbuddy-daemon",
-      "sha256": "5d57767abb24be43ba64e17b57d9aa396c4149f4b89101e6a0346da57ec5ea41",
+      "sha256": "a3d98f8e3d76fc7d30266fd5e261880615b5e8377e1211cf87fe3927dfb9f156",
       "mode": "0755"
     },
     "linux-x64": {
       "goos": "linux",
       "goarch": "amd64",
       "binary": "daemon/bin/linux-x64/botbuddy-daemon",
-      "sha256": "33e0e6ba075a7486a02e4a3638bce10e1df41ddfe8315685e285cf144a149ea7",
+      "sha256": "1edca9db4f9e8e8d72b9112acf63ec6ba4ca09423cee8ef0afe4bae0abb78bc2",
       "mode": "0755"
     }
   }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@botbuddy/cli",
-  "version": "1.63.0",
+  "version": "1.63.1",
   "description": "BotBuddy \u2014 Swarm coordination CLI for multi-agent workflows",
   "type": "module",
   "bin": {

package/src/wait-result.mjs

@@ -10,6 +10,7 @@ import { WaitCheckpointError } from "./wait-checkpoint.mjs";
 const MAX_ARTIFACT_BYTES = 256 * 1024;
 const MAX_RECEIPT_BYTES = 64 * 1024;
 const UUID = /^[0-9a-f]{8}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{12}$/i;
+const COMMAND_STATUSES = new Set(["success", "failure", "cancelled", "timed_out", "owner_lost"]);
 const TERMINAL_OUTCOMES = new Set(["matched", "timeout", "error", "superseded", "lease_lost", "abandoned", "cancelled"]);
 
 // Persisted != delivered. Await the stream callback before exiting, including
@@ -73,16 +74,37 @@ async function receiptFromArtifact(path) {
     const buffer = Buffer.alloc(MAX_ARTIFACT_BYTES + 1);
     const { bytesRead } = await handle.read(buffer, 0, buffer.length, 0);
     if (bytesRead > MAX_ARTIFACT_BYTES) throw new Error("unbounded artifact");
-    const receipts = [];
-    for (const line of buffer.subarray(0, bytesRead).toString("utf8").split(/\r?\n/)) {
-      if (!line.trimStart().startsWith("{")) continue;
-      let value;
-      try { value = JSON.parse(line); } catch { continue; }
-      if (value?.schema_version === 1 && typeof value.outcome === "string") receipts.push(value);
+    const content = buffer.subarray(0, bytesRead).toString("utf8");
+    let values;
+    try { values = [JSON.parse(content)]; }
+    catch {
+      values = [];
+      for (const line of content.split(/\r?\n/)) {
+        if (!line.trimStart().startsWith("{")) continue;
+        // A partial JSON document alongside a receipt is ambiguous. In
+        // particular, never ignore a pretty command receipt and accept a later
+        // wait line from the same artifact.
+        values.push(JSON.parse(line));
+      }
     }
+    const receipts = values.filter((value) => value?.schema_version === 1 &&
+      (typeof value.outcome === "string" || (typeof value.run_id === "string" && typeof value.status === "string")));
     if (receipts.length !== 1) throw new Error("expected exactly one receipt");
-    return receipts[0];
-  } catch {
+    const [receipt] = receipts;
+    if (!receipt.outcome && UUID.test(receipt.run_id) && COMMAND_STATUSES.has(receipt.status)) {
+      // A diagnostic, never evidence that this caller owns the command or that
+      // its workload passed. Only a validated UUID may enter recovery argv;
+      // never echo command text, logs, paths, or recovery_command from the file.
+      const recovery = `Run bb run inspect ${receipt.run_id} from the owning checkout; preserve the command receipt and read its bounded_log for the workload verdict. Do not rerun unchanged validation.`;
+      const error = new WaitCheckpointError("wait_result_wrong_artifact", `This is a command-run receipt, not a bb wait receipt. ${recovery}`);
+      error.recoveryArgv = ["run", "inspect", receipt.run_id];
+      error.recovery = recovery;
+      throw error;
+    }
+    if (typeof receipt.outcome !== "string") throw new Error("not a wait receipt");
+    return receipt;
+  } catch (error) {
+    if (error instanceof WaitCheckpointError) throw error;
     // Never echo arbitrary artifact contents (which may include credentials).
     throw new WaitCheckpointError("wait_observation_gap", "completion artifact must contain exactly one bounded terminal receipt");
   } finally { await handle?.close(); }

package/src/wait.mjs

@@ -241,7 +241,8 @@ SUBCOMMANDS  (saved waits live in this worktree's .botbuddy/waits/)
   bb wait result [<local_wait_id>] [--from-file <path> --exit-code <n>]
                                read a terminal receipt without re-arming or acknowledging;
                                --from-file validates redirected output AFTER the original
-                               command exits (see EXAMPLES)
+                               wait command exits (see EXAMPLES). Command-run .receipt.json files
+                               belong to bb run inspect <run_id>, not bb wait result.
   bb wait resume <local_wait_id>       recover one explicitly named saved wait
   bb wait cancel <local_wait_id>       explicitly stop one saved wait
   bb wait acknowledge <local_wait_id>  mark one saved terminal receipt read (after acting on it)