@botbuddy/cli 1.40.5 → 1.40.6

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@botbuddy/cli",
-  "version": "1.40.5",
+  "version": "1.40.6",
   "description": "BotBuddy — Swarm coordination CLI for multi-agent workflows",
   "type": "module",
   "bin": {

package/src/stack.mjs

@@ -88,6 +88,8 @@ ${bold("up OPTIONS")}
   --idle-ttl <seconds>   Idle seconds before the reaper STOPS an unused stack (default 1800).
   --timeout <seconds>    Max seconds to park for capacity before giving up (default ${DEFAULT_TIMEOUT_SEC}).
   --no-wait              If the host is full, print the queue position and exit (don't park).
+  --claim-only           LOCAL-EXEC only: wait for and hold a provisioning lease without starting
+                         Supabase. Resume with the identical \`stack up --local-exec\` command.
   --wait-capacity <dur>  Opt-in (BOT-2024): on a TRANSIENT HOST_CAPACITY_SOURCE_STALE refusal, park
                          on the server's \`bb wait 'capacity:…'\` up to <dur> (90s, 10m, 1h) and
                          re-attempt admission once when it matches. Sustained refusals, the
@@ -189,7 +191,7 @@ export function parseStackArgs(argv) {
     slot: null, host: null, repo: null, ticket: null, ticketUrl: null,
     prId: null, prUrl: null, purpose: null, idleTtl: null, stackPath: ".", stackPathExplicit: false,
     timeout: DEFAULT_TIMEOUT_SEC, provisionTimeout: null, reapTimeout: 300, hardTtl: null,
-    connectionFile: null, noWait: false, localExec: false, waitCapacity: null,
+    connectionFile: null, noWait: false, claimOnly: false, localExec: false, waitCapacity: null,
     dockerContext: null, dockerEndpoint: null,
     disposition: "destroy", json: false, receiptMaxBytes: DEFAULT_RECEIPT_MAX_BYTES,
   };
@@ -271,6 +273,7 @@ export function parseStackArgs(argv) {
         break;
       }
       case "--no-wait": opts.noWait = true; break;
+      case "--claim-only": opts.claimOnly = true; break;
       case "--local-exec": opts.localExec = true; break;
       case "--docker-context": if (need(a, rest[i + 1])) opts.dockerContext = rest[++i]; break;
       case "--docker-endpoint": if (need(a, rest[i + 1])) opts.dockerEndpoint = rest[++i]; break;
@@ -305,6 +308,9 @@ export function parseStackArgs(argv) {
   if (opts.waitCapacity != null && !["up", "run"].includes(command)) {
     errors.push("--wait-capacity is valid only with `stack up` or `stack run`");
   }
+  if (opts.claimOnly && (command !== "up" || !opts.localExec)) {
+    errors.push("--claim-only is valid only with `stack up --local-exec`");
+  }
   if ((opts.dockerContext || opts.dockerEndpoint) && !(["up", "done"].includes(command) && opts.localExec)) {
     errors.push("--docker-context and --docker-endpoint are valid only with `stack up --local-exec` or `stack done --local-exec`");
   }
@@ -1696,6 +1702,23 @@ export async function cmdUp(opts, {
   }
   reportLaneStatus({ phase: "testing", reason: "provisioning" });
 
+  // BOT-2089: an expensive hermetic preparation (template restore) must not lose
+  // an admission slot after the queue grants it. Keep this deliberately narrow:
+  // only a local-exec caller may hold an unreserved provisioning lease, and it
+  // must resume through the normal `stack up` path that reserves before start.
+  if (opts.claimOnly) {
+    if (state !== "provisioning") {
+      return emitResult(buildReceipt({
+        command: "up", outcome: "error", lease_id: leaseId, state, slot,
+        error: `claim-only lease is ${state}, not provisioning`,
+      }), opts, EXIT.LEASE_FAILED);
+    }
+    return emitResult(buildReceipt({
+      command: "up", outcome: "claimed", lease_id: leaseId, state, host_key: d.host_key, slot,
+      idle_ttl_secs: d.idle_ttl_secs, resource_name: d.resource_name,
+    }), opts, EXIT.OK);
+  }
+
   // Reach `active`: local-exec provisions itself; otherwise wait for the Helper.
   if (state !== "active") {
     if (opts.localExec) {