svamp-cli 0.2.342 → 0.2.346

package/dist/{commands-DDuGBSsz.mjs → commands-D1pZq3d4.mjs}

@@ -2,24 +2,19 @@ import { existsSync, readFileSync, writeFileSync } from 'node:fs';
 import { execSync, execFileSync } from 'node:child_process';
 import { basename, resolve, join, isAbsolute } from 'node:path';
 import os from 'node:os';
-import { a5 as formatHandle, a6 as normalizeAllowedUser, a7 as loadSecurityContextConfig, a8 as resolveSecurityContext, a9 as buildSecurityContextFromFlags, aa as mergeSecurityContexts, c as connectToHypha, ab as buildSessionShareUrl, ac as computeOutboundHop, e as shortId, ad as registerAwaitingReply, ae as buildMachineShareUrl, af as parseHandle, ag as handleMatchesMetadata } from './run-CF4kAVPW.mjs';
-import 'os';
-import 'fs/promises';
+import { c as connectToHypha } from './hyphaClient-ybivOjZo.mjs';
+import { f as formatHandle, c as computeOutboundHop, s as shortId, r as registerAwaitingReply, p as parseHandle, h as handleMatchesMetadata } from './friendlyName-1UZcyDhu.mjs';
+import { n as normalizeAllowedUser } from './types-57J3Re0n.mjs';
+import { loadSecurityContextConfig, resolveSecurityContext, buildSecurityContextFromFlags, mergeSecurityContexts } from './securityContext-Cm5UTCuD.mjs';
+import { b as buildSessionShareUrl, U as UNBOUNDED_LOOP_ITERATIONS, a as buildMachineShareUrl } from './loopVerify-B47sSjxe.mjs';
+import { f as flushStdout } from './flushExit-C-i6SGjj.mjs';
+import 'node:crypto';
+import './instance-CeHz5C8v.mjs';
 import 'fs';
 import 'path';
-import 'url';
-import 'child_process';
-import 'crypto';
-import 'node:crypto';
-import 'util';
-import 'http';
-import 'net';
-import 'node:events';
-import '@agentclientprotocol/sdk';
-import 'node:util';
-import 'node:readline';
-import 'node:fs/promises';
-import 'yaml';
+import 'os';
+import './store-Bn0ByYev.mjs';
+import './fileLock-BMPwCrB6.mjs';
 
 function formatTime(ts) {
   if (!ts) return "-";
@@ -88,6 +83,30 @@ function formatJson(data) {
   return JSON.stringify(data, null, 2);
 }
 
+function machineLabelOf(machine, index) {
+  return String(
+    machine?.metadata?.displayName || machine?.metadata?.host || machine?.machineId || machine?.id || `machine #${index}`
+  );
+}
+function describeRejection(reason) {
+  if (reason instanceof Error) return reason.message || String(reason);
+  if (typeof reason === "string") return reason;
+  try {
+    const json = JSON.stringify(reason);
+    return typeof json === "string" ? json : String(reason);
+  } catch {
+    return String(reason);
+  }
+}
+function warnUnreachableMachines(unreachable, total) {
+  if (unreachable.length === 0) return false;
+  const detail = unreachable.map((u) => `${u.machine}: ${u.error}`).join("; ");
+  console.error(
+    `warning: ${unreachable.length} of ${total} machine(s) did not respond \u2014 this list is INCOMPLETE (${detail})`
+  );
+  return true;
+}
+
 const SESSION_RPC_PARAMS = {
   getMessages: ["afterSeq", "limit"],
   getMessageCount: [],
@@ -395,13 +414,19 @@ async function connectAndGetAllMachines() {
     process.exit(1);
   }
   const machines = [];
+  const unreachableMachines = [];
   try {
     const services = await server.listServices({ query: { type: "svamp-machine" }, include_unlisted: true, _rkwargs: true });
     const results = await Promise.allSettled(
       services.map((svc) => server.getService(svc.id || svc.name))
     );
-    for (const r of results) {
+    for (let i = 0; i < results.length; i++) {
+      const r = results[i];
       if (r.status === "fulfilled") machines.push(r.value);
+      else unreachableMachines.push({
+        machine: String(services[i]?.id || services[i]?.name || `#${i}`),
+        error: describeRejection(r.reason)
+      });
     }
   } catch (err) {
     restoreConsole();
@@ -415,7 +440,7 @@ async function connectAndGetAllMachines() {
     await server.disconnect();
     process.exit(1);
   }
-  return { server, machines };
+  return { server, machines, unreachable: unreachableMachines };
 }
 async function sessionMachines() {
   loadDotEnv();
@@ -817,9 +842,9 @@ async function sessionList(machineId, opts) {
       await server.disconnect();
     }
   } else {
-    const { server, machines } = await connectAndGetAllMachines();
+    const { server, machines, unreachable: discoveryUnreachable } = await connectAndGetAllMachines();
     try {
-      await listSessionsFromMachines(server, machines, opts);
+      await listSessionsFromMachines(server, machines, opts, discoveryUnreachable);
     } finally {
       await server.disconnect();
     }
@@ -837,7 +862,7 @@ function formatPeerLine(s) {
 }
 async function sessionWhoami(opts) {
   const currentSessionId = process.env.SVAMP_SESSION_ID;
-  const { server, machines } = await connectAndGetAllMachines();
+  const { server, machines, unreachable } = await connectAndGetAllMachines();
   try {
     const perMachine = await Promise.allSettled(
       machines.map(async (machine) => {
@@ -849,6 +874,17 @@ async function sessionWhoami(opts) {
       })
     );
     const gathered = perMachine.filter((r) => r.status === "fulfilled").map((r) => r.value);
+    const whoamiUnreachable = [...unreachable];
+    for (let i = 0; i < perMachine.length; i++) {
+      const r = perMachine[i];
+      if (r.status === "rejected") {
+        whoamiUnreachable.push({
+          machine: machineLabelOf(machines[i], i),
+          error: describeRejection(r.reason)
+        });
+      }
+    }
+    warnUnreachableMachines(whoamiUnreachable, machines.length + unreachable.length);
     const machineLabel = (info) => info?.metadata?.displayName || info?.metadata?.host || info?.metadata?.hostname || info?.machineId || "unknown";
     let current = null;
     let currentSession = null;
@@ -951,7 +987,7 @@ async function sessionWhoami(opts) {
     await server.disconnect();
   }
 }
-async function listSessionsFromMachines(_server, machines, opts) {
+async function listSessionsFromMachines(_server, machines, opts, discoveryUnreachable = []) {
   const allSessions = [];
   const machineResults = await Promise.allSettled(
     machines.map(async (machine) => {
@@ -966,11 +1002,18 @@ async function listSessionsFromMachines(_server, machines, opts) {
       return sessions;
     })
   );
-  for (const r of machineResults) {
+  const unreachable = [...discoveryUnreachable];
+  for (let i = 0; i < machineResults.length; i++) {
+    const r = machineResults[i];
     if (r.status === "fulfilled") allSessions.push(...r.value);
+    else unreachable.push({
+      machine: machineLabelOf(machines[i], i),
+      error: describeRejection(r.reason)
+    });
   }
   const filtered = opts?.active ? allSessions.filter((s) => s.active) : allSessions;
   if (filtered.length === 0) {
+    warnUnreachableMachines(unreachable, machines.length + discoveryUnreachable.length);
     if (opts?.json) {
       console.log(formatJson([]));
     } else {
@@ -989,6 +1032,7 @@ async function listSessionsFromMachines(_server, machines, opts) {
       host: m.host || s.machineHost || ""
     };
   });
+  warnUnreachableMachines(unreachable, machines.length + discoveryUnreachable.length);
   if (opts?.json) {
     console.log(formatJson(enriched.map((s) => ({
       sessionId: s.sessionId,
@@ -1724,11 +1768,13 @@ async function sendCore(machine, fullId, message, opts) {
   }
   if (opts?.asIssue) {
     const issue = await machine.sessionRPC(fullId, "issue", {
-      op: "add",
-      body: message,
-      session: fullId,
-      rekick: true,
-      ...opts.issueTitle ? { title: opts.issueTitle } : {}
+      params: {
+        op: "add",
+        body: message,
+        session: fullId,
+        rekick: true,
+        ...opts.issueTitle ? { title: opts.issueTitle } : {}
+      }
     });
     return {
       sessionId: fullId,
@@ -1744,9 +1790,11 @@ async function sendCore(machine, fullId, message, opts) {
   const shouldWait = !!opts?.wait || wantResponse;
   if (opts?.plain) {
     const { randomUUID: ruuid } = await import('node:crypto');
+    let plainBypassEnsured = false;
     if (shouldWait && !opts?.requireApproval) {
       try {
         await machine.sessionRPC(fullId, "switchMode", { mode: "bypassPermissions" });
+        plainBypassEnsured = true;
       } catch {
       }
     }
@@ -1757,7 +1805,7 @@ async function sendCore(machine, fullId, message, opts) {
     let pWait;
     if (shouldWait) pWait = await waitForBusyThenIdle(machine, fullId, (opts?.timeout || 300) * 1e3);
     if (pWait?.pendingPermissions?.length) {
-      return { sessionId: fullId, mode: "send", sent: true, messageId: sendRes?.id, waited: true, status: "permission-pending", pendingPermissions: pWait.pendingPermissions };
+      return { sessionId: fullId, mode: "send", sent: true, messageId: sendRes?.id, waited: true, status: "permission-pending", pendingPermissions: pWait.pendingPermissions, ...plainBypassEnsured ? { bypassEnsured: true } : {} };
     }
     let pResp;
     if (wantResponse) pResp = await collectAssistantResponse(machine, fullId, preSeq2);
@@ -1768,14 +1816,17 @@ async function sendCore(machine, fullId, message, opts) {
       messageId: sendRes?.id,
       waited: !!shouldWait,
       status: shouldWait ? "idle" : "sent",
-      ...wantResponse && pResp ? { response: pResp.text, responseSeqs: pResp.messageSeqs } : {}
+      ...wantResponse && pResp ? { response: pResp.text, responseSeqs: pResp.messageSeqs } : {},
+      ...plainBypassEnsured ? { bypassEnsured: true } : {}
     };
   }
   if (opts?.model) {
     const { randomUUID: ruuid } = await import('node:crypto');
+    let modelBypassEnsured = false;
     if (shouldWait && !opts?.requireApproval) {
       try {
         await machine.sessionRPC(fullId, "switchMode", { mode: "bypassPermissions" });
+        modelBypassEnsured = true;
       } catch {
       }
     }
@@ -1803,7 +1854,8 @@ async function sendCore(machine, fullId, message, opts) {
         messageId: sendRes?.id,
         waited: true,
         status: "permission-pending",
-        pendingPermissions: mWait.pendingPermissions
+        pendingPermissions: mWait.pendingPermissions,
+        ...modelBypassEnsured ? { bypassEnsured: true } : {}
       };
     }
     let mResponse;
@@ -1817,7 +1869,8 @@ async function sendCore(machine, fullId, message, opts) {
       messageId: sendRes?.id,
       waited: shouldWait,
       status: shouldWait ? "idle" : "sent",
-      ...wantResponse && mResponse ? { response: mResponse.text, responseSeqs: mResponse.messageSeqs } : {}
+      ...wantResponse && mResponse ? { response: mResponse.text, responseSeqs: mResponse.messageSeqs } : {},
+      ...modelBypassEnsured ? { bypassEnsured: true } : {}
     };
   }
   let bypassEnsured = false;
@@ -2392,6 +2445,7 @@ async function wiseAskCli(machineId, message, sessionId, opts) {
     const res = await machine.wiseAsk({ message, sessionId });
     if (opts?.json) {
       console.log(JSON.stringify(res, null, 2));
+      await flushStdout();
       process.exit(res?.success ? 0 : 1);
     }
     if (res?.error) {
@@ -2419,6 +2473,7 @@ async function wiseJoinMeetingCli(machineId, url, sessionId, opts) {
     const res = await machine.wiseJoinMeeting({ meetingUrl: url, sessionId, mode, mission: opts?.mission });
     if (opts?.json) {
       console.log(JSON.stringify(res, null, 2));
+      await flushStdout();
       process.exit(res?.success ? 0 : 1);
     }
     if (res?.error) {
@@ -2437,6 +2492,7 @@ async function wiseLeaveMeetingCli(machineId, sessionId, opts) {
     const res = await machine.wiseLeaveMeeting({ sessionId });
     if (opts?.json) {
       console.log(JSON.stringify(res, null, 2));
+      await flushStdout();
       process.exit(res?.success ? 0 : 1);
     }
     if (res?.error) {
@@ -2459,6 +2515,7 @@ async function wiseAnnounceCli(machineId, text, sessionId, opts) {
     const res = await machine.wiseAnnounce({ text, sessionId });
     if (opts?.json) {
       console.log(JSON.stringify(res, null, 2));
+      await flushStdout();
       process.exit(res?.success ? 0 : 1);
     }
     if (res?.error) {
@@ -2477,6 +2534,7 @@ async function wiseMeetingsCli(machineId, opts) {
     const res = await machine.wiseMeetingStatus({});
     if (opts?.json) {
       console.log(JSON.stringify(res, null, 2));
+      await flushStdout();
       process.exit(0);
     }
     const ms = res?.meetings || [];
@@ -2536,8 +2594,7 @@ async function sessionLoopStart(sessionIdPartial, task, machineId, opts) {
     const svc = getSessionProxy(machine, fullId);
     const until = opts?.until || opts?.criteria;
     const isStart = !!(task || until);
-    const maxIterations = opts?.maxIterations ?? (isStart ? 1e4 : void 0);
-    const evaluator = opts?.agent ? true : opts?.evaluator !== false;
+    const maxIterations = opts?.maxIterations ?? (isStart ? UNBOUNDED_LOOP_ITERATIONS : void 0);
     const budget = opts?.maxTokensPerHour || opts?.maxRuntimeSec ? {
       ...opts?.maxTokensPerHour ? { max_tokens_per_hour: opts.maxTokensPerHour } : {},
       ...opts?.maxRuntimeSec ? { max_runtime_sec: opts.maxRuntimeSec } : {}
@@ -2547,11 +2604,15 @@ async function sessionLoopStart(sessionIdPartial, task, machineId, opts) {
         ...task ? { task } : {},
         ...until ? { until } : {},
         ...opts?.oracle ? { oracle: opts.oracle } : {},
-        ...opts?.parent ? { parent: opts.parent } : {},
         ...maxIterations != null ? { max_iterations: maxIterations } : {},
-        ...budget ? { budget } : {},
-        ...opts?.engine ? { engine: opts.engine } : {},
-        evaluator
+        ...budget ? { budget } : {}
+        // #1499: `parent`, `engine` and `evaluator` are no longer sent. The /goal kickoff in
+        // daemon/run.ts reads only task/until/oracle/max_iterations/budget/durable, so these
+        // three travelled the whole RPC and were dropped — while the CLI echoed them back as
+        // if applied. Sending a field nobody reads is how a flag becomes documented as a
+        // control (#1415 was the same shape one command over). The legacy `supervisor` key's
+        // normalizer still accepts `parent`/`evaluator` for back-compat; that path is
+        // untouched.
       }
     });
     if (!isStart) {
@@ -2561,9 +2622,10 @@ async function sessionLoopStart(sessionIdPartial, task, machineId, opts) {
       if (task) console.log(`  Task: ${task.slice(0, 100)}${task.length > 100 ? "..." : ""}`);
       if (until) console.log(`  Until: ${until.slice(0, 100)}${until.length > 100 ? "..." : ""}`);
       console.log(`  Oracle: ${opts?.oracle || "(none)"}`);
-      console.log(`  Evaluator: ${evaluator ? "on" : "off"}`);
-      if (opts?.parent) console.log(`  Parent review: ${opts.parent.slice(0, 8)}`);
-      if (maxIterations != null) console.log(`  Max iterations: ${maxIterations}`);
+      console.log(`  Evaluator: on`);
+      if (maxIterations != null) {
+        console.log(maxIterations >= UNBOUNDED_LOOP_ITERATIONS ? `  Max iterations: unbounded (no iteration cap \u2014 cost/runtime ceilings only)` : `  Max iterations: ${maxIterations}`);
+      }
       if (!task) console.log(`  (hot-plug \u2014 gating the session's current work)`);
     }
   } finally {

package/dist/{commands-BKb1g8Gq.mjs → commands-D69mnkYu.mjs}

@@ -1,27 +1,13 @@
-import { spawnSync } from 'node:child_process';
-import { f as resolveProjectRoot, L as workflowSteps, y as setWorkflowEnabled, F as isWorkflowEnabled, z as removeWorkflow, w as getWorkflow, E as listWorkflows, A as validateCronExpr, C as saveWorkflow, D as rawWorkflow, M as describeNextFire } from './run-CF4kAVPW.mjs';
-import { w as wantsHelp } from './cli-B24CmIli.mjs';
-import 'os';
-import 'fs/promises';
-import 'fs';
-import 'path';
-import 'url';
-import 'child_process';
-import 'crypto';
+import { r as resolveProjectRoot } from './store-Bn0ByYev.mjs';
+import { w as wantsHelp } from './wantsHelp-6bMOeNUz.mjs';
+import { s as setWorkflowEnabled, i as isWorkflowEnabled, r as removeWorkflow, g as getWorkflow, l as listWorkflows, c as workflowSteps, a as saveWorkflow, b as rawWorkflow } from './store-fi0f-ff1.mjs';
+import { v as validateCronExpr, d as describeNextFire } from './cron-hHGdb5kU.mjs';
 import 'node:fs';
 import 'node:path';
 import 'node:crypto';
-import 'util';
-import 'http';
-import 'net';
-import 'node:os';
-import 'node:events';
-import '@agentclientprotocol/sdk';
-import 'node:util';
-import 'node:readline';
-import 'node:fs/promises';
+import 'node:child_process';
+import './fileLock-BMPwCrB6.mjs';
 import 'yaml';
-import './serviceManager-hlOVxkhW.mjs';
 
 function flag(args, name) {
   const i = args.indexOf(name);
@@ -161,16 +147,20 @@ async function workflowCommand(args) {
         console.error(`Workflow not found: ${name}`);
         process.exit(1);
       }
-      const steps = workflowSteps(wf);
-      console.log(`\u25B6 running workflow "${wf.name}" (${steps.length} step${steps.length === 1 ? "" : "s"})`);
-      for (let i = 0; i < steps.length; i++) {
-        const step = steps[i];
-        console.log(`  [${i + 1}/${steps.length}] $ ${step.run}`);
-        const r = spawnSync("sh", ["-c", step.run], { cwd: root, stdio: "inherit" });
-        if (r.status !== 0) {
-          console.error(`  \u2717 step ${i + 1} failed (exit ${r.status ?? "signal"}). Stopping.`);
-          process.exit(r.status ?? 1);
-        }
+      const { runWorkflow } = await import('./run-DkjwF-zA.mjs').then(function (n) { return n.e; });
+      const run = await runWorkflow(root, wf, { trigger: "manual", actor: process.env.SVAMP_SESSION_ID || null });
+      console.log(`\u25B6 ran workflow "${wf.name}" (${run.steps.length} step${run.steps.length === 1 ? "" : "s"}) \u2192 ${run.status}`);
+      for (const st of run.steps) {
+        console.log(`  [${st.index + 1}] $ ${st.cmd}`);
+        if (st.stdout) console.log(st.stdout.trimEnd());
+        if (st.stderr) console.error(st.stderr.trimEnd());
+        if (st.timedOut) console.error(`  \u2717 step ${st.index + 1} timed out.`);
+        else if (st.exitCode !== 0) console.error(`  \u2717 step ${st.index + 1} failed (exit ${st.exitCode ?? "signal"}).`);
+      }
+      if (run.escalatedIssue) console.log(`  \u21B3 escalated to issue #${run.escalatedIssue} (agent will correct the workflow).`);
+      if (run.status !== "success") {
+        console.error(`\u2717 workflow "${wf.name}" failed.`);
+        process.exit(1);
       }
       console.log(`\u2713 workflow "${wf.name}" completed.`);
       break;

package/dist/{commands-BsKgZ5sQ.mjs → commands-DW5RnHZw.mjs}

@@ -1,25 +1,8 @@
 import os from 'os';
 import fs__default from 'fs';
 import { resolve, join, relative } from 'path';
-import { W as parseFrontmatter, X as getSkillsServer, Y as getSkillsWorkspaceName, Z as getSkillsCollectionName, _ as fetchWithTimeout, $ as searchSkills, a0 as SKILLS_DIR, a1 as getSkillInfo, a2 as downloadSkillFile, a3 as listSkillFiles } from './run-CF4kAVPW.mjs';
-import 'fs/promises';
-import 'url';
-import 'child_process';
-import 'crypto';
-import 'node:fs';
-import 'node:path';
-import 'node:crypto';
-import 'node:child_process';
-import 'util';
-import 'http';
-import 'net';
-import 'node:os';
-import 'node:events';
-import '@agentclientprotocol/sdk';
-import 'node:util';
-import 'node:readline';
-import 'node:fs/promises';
-import 'yaml';
+import { parseFrontmatter, getSkillsServer, getSkillsWorkspaceName, getSkillsCollectionName, fetchWithTimeout, searchSkills, SKILLS_DIR, getSkillInfo, downloadSkillFile, listSkillFiles } from './api-BHjyC0Ph.mjs';
+import './instance-CeHz5C8v.mjs';
 
 const SVAMP_HOME = process.env.SVAMP_HOME || join(os.homedir(), ".svamp");
 const ENV_FILE = join(SVAMP_HOME, ".env");

package/dist/{commands-DXLOKJOj.mjs → commands-H4PsTGn8.mjs}

@@ -1,27 +1,10 @@
 import { existsSync, readFileSync } from 'node:fs';
 import { join } from 'node:path';
-import { f as flushAndExit } from './cli-B24CmIli.mjs';
-import { f as resolveProjectRoot, o as searchIssues, m as listIssues, n as isPendingIssue, j as resumeIssue, p as pauseIssue, k as addComment, u as updateIssue, h as getIssue, J as checkVerifyCommand, q as isVisibleTo, K as summarize, l as addIssue } from './run-CF4kAVPW.mjs';
-import './serviceManager-hlOVxkhW.mjs';
-import 'os';
-import 'fs/promises';
-import 'fs';
-import 'path';
-import 'url';
-import 'child_process';
-import 'crypto';
+import { a as flushAndExit } from './flushExit-C-i6SGjj.mjs';
+import { r as resolveProjectRoot, s as searchIssues, l as listIssues, i as isPendingIssue, d as resumeIssue, e as pauseIssue, f as addComment, u as updateIssue, p as parseScopeArg, I as ISSUE_SCOPES, a as parseStatusArg, b as ISSUE_STATUSES, g as getIssue, k as checkVerifyCommand, j as isVisibleTo, m as summarize, h as addIssue } from './store-Bn0ByYev.mjs';
 import 'node:crypto';
 import 'node:child_process';
-import 'util';
-import 'http';
-import 'net';
-import 'node:os';
-import 'node:events';
-import '@agentclientprotocol/sdk';
-import 'node:util';
-import 'node:readline';
-import 'node:fs/promises';
-import 'yaml';
+import './fileLock-BMPwCrB6.mjs';
 
 const STATUS_GLYPH = {
   ready: "\u25C9",
@@ -64,12 +47,27 @@ function loopActiveForCwd(cwd = process.cwd(), sid = process.env.SVAMP_SESSION_I
   }
   return false;
 }
+const VALUE_FLAGS = /* @__PURE__ */ new Set([
+  "--answer",
+  "--blocked",
+  "--body",
+  "--branch",
+  "--label",
+  "--option",
+  "--question",
+  "--scope",
+  "--session",
+  "--status",
+  "--title",
+  "--verify",
+  "--verify-cmd"
+]);
 function positional(args) {
   const out = [];
   for (let i = 0; i < args.length; i++) {
     const a = args[i];
     if (a.startsWith("--")) {
-      if (a !== "--json" && a !== "--ready") i++;
+      if (!a.includes("=") && VALUE_FLAGS.has(a)) i++;
       continue;
     }
     out.push(a);
@@ -272,11 +270,44 @@ ${res.output || ""}
       if (labels.length) patch.labels = labels;
       const v = buildVerify(rest);
       if (v || has(rest, "--no-verify")) patch.verify = has(rest, "--no-verify") ? null : v;
-      if (flag(rest, "--scope")) patch.scope = flag(rest, "--scope");
+      if (flag(rest, "--scope")) {
+        const nextScope = parseScopeArg(flag(rest, "--scope"));
+        if (!nextScope) {
+          console.error(`Invalid --scope "${flag(rest, "--scope")}". Must be one of: ${ISSUE_SCOPES.join(", ")}.`);
+          process.exit(1);
+        }
+        patch.scope = nextScope;
+      }
       if (has(rest, "--unclaim")) patch.session = null;
       else if (flag(rest, "--session")) patch.session = flag(rest, "--session");
       if (flag(rest, "--body")) patch.body = flag(rest, "--body");
-      if (flag(rest, "--status")) patch.status = flag(rest, "--status");
+      if (flag(rest, "--status")) {
+        const nextStatus = parseStatusArg(flag(rest, "--status"));
+        if (!nextStatus) {
+          console.error(`Invalid --status "${flag(rest, "--status")}". Must be one of: ${ISSUE_STATUSES.join(", ")}.`);
+          console.error(`(To close an issue, use \`svamp issue close ${id}\` \u2014 it runs the verify-cmd.)`);
+          process.exit(1);
+        }
+        if (nextStatus === "archived") {
+          const current = getIssue(root, id);
+          const vc = current?.verify?.type === "command" ? current.verify.text?.trim() : "";
+          if (vc && current?.status !== "archived") {
+            if (has(rest, "--force")) {
+              console.error(`\u26A0 #${id}: archiving WITHOUT running verify-cmd (--force): \`${vc}\``);
+            } else {
+              const res = checkVerifyCommand(root, current);
+              if (!res.ok) {
+                console.error(`Refusing to archive #${id} via edit: its verify-cmd failed \u2014 the fix is not verified.
+  $ ${res.cmd}
+${res.output || ""}
+(Use \`svamp issue archive\` for an obsolete/duplicate item, or pass --force to override.)`);
+                process.exit(1);
+              }
+            }
+          }
+        }
+        patch.status = nextStatus;
+      }
       if (has(rest, "--crew")) patch.disposition = "crew";
       else if (has(rest, "--inline")) patch.disposition = "inline";
       if (has(rest, "--triaged")) patch.triaged = true;
@@ -291,7 +322,7 @@ ${res.output || ""}
     case "triage": {
       const id = positional(rest)[0];
       if (!id) {
-        console.error('usage: svamp issue triage <id> [--title "\u2026"] [--label x \u2026] [--crew|--inline] [--verify-cmd "cmd" | --verify "criterion" | --manual] [--body "rewritten"] [--backlog]');
+        console.error('usage: svamp issue triage <id> [--title "\u2026"] [--label x \u2026] [--crew|--inline] [--verify-cmd "cmd" | --verify "criterion" | --manual] [--body "rewritten"]');
         process.exit(1);
       }
       const patch = { triaged: true };
@@ -497,7 +528,8 @@ the user explicitly reserved): re-run with \`--blocked "<the specific blocker>"\
         "          # A paused issue drops out of `pending`, so a loop converges cleanly instead",
         '          # of spinning on it. NOT for "please check my work" \u2014 close finished work.',
         '  resume <id> [--answer "\u2026"]   # un-pause (the user answering a --question resumes it automatically)',
-        "  pending [--session <id>] [--mine]   # exit 0 if no actionable (ready/in_progress) issues \u2014 the loop oracle",
+        "  pending [--session <id>] [--mine]   # exit 0 when NO issue is open \u2014 i.e. every issue is",
+        "          # archived or paused. Counted by EXCLUSION, not an allow-list (#107). The loop oracle.",
         '  search "<query>" [--json]',
         "  guide <triage|work>   # the triage / work-loop procedure (so triggers can stay short)"
       ].join("\n"));
@@ -508,4 +540,4 @@ the user explicitly reserved): re-run with \`--blocked "<the specific blocker>"\
   }
 }
 
-export { issueCommand, loopActiveForCwd };
+export { VALUE_FLAGS, issueCommand, loopActiveForCwd, positional };