opencode-swarm 7.125.4 → 7.125.5

package/dist/cli/{index-7xg876np.js → index-s6hskqg6.js}

@@ -4,7 +4,7 @@ import {
   readDoctorArtifact,
   removeStraySwarmDir,
   runConfigDoctor
-} from "./index-pk099nqv.js";
+} from "./index-jt7hnr7q.js";
 import {
   EvaluationTaskV1Schema,
   GateAuditManifestV1Schema,
@@ -94,15 +94,15 @@ import {
   retireSkill,
   selectCandidateEntries,
   syncBundledProjectSkillsIfMissingAsync
-} from "./index-01n43w2p.js";
+} from "./index-gd5w3ef8.js";
 import {
   readRecentEscalations
-} from "./index-vdfewvn5.js";
+} from "./index-0f45t7xy.js";
 import {
   alreadyCuratedThisGeneration,
   claimNextScanBatch,
   resolveCohortId
-} from "./index-8tjbq2ej.js";
+} from "./index-e315gwc9.js";
 import {
   CURATOR_INIT_PROMPT,
   CURATOR_PHASE_PROMPT,
@@ -135,11 +135,11 @@ import {
   validateActionability,
   validateActionableFields,
   validateLesson
-} from "./index-sa3dgpmc.js";
+} from "./index-yq4s3q43.js";
 import {
   authorizeCuration,
   buildConfigFingerprintInput
-} from "./index-rp5msv7n.js";
+} from "./index-1htanqp1.js";
 import {
   cohortConfigFingerprint
 } from "./index-rtry5xyf.js";
@@ -169,7 +169,7 @@ import {
   transactFile,
   transactKnowledge,
   wordBigrams
-} from "./index-45mvd5q7.js";
+} from "./index-1012f47p.js";
 import {
   MAX_EVENT_LOG_ENTRIES,
   _internals,
@@ -179,7 +179,7 @@ import {
   recordHiveKnowledgeEvent,
   recordKnowledgeEvent,
   resolveKnowledgeEventsPath
-} from "./index-fm4zfxnr.js";
+} from "./index-gbnpz7rh.js";
 import {
   resolveHiveDataDir,
   resolveHiveEventsPath,
@@ -201,7 +201,7 @@ import {
   init_loader,
   loadPluginConfig,
   loadPluginConfigWithMeta
-} from "./index-ambnwnmt.js";
+} from "./index-74xejn4v.js";
 import {
   RetrospectiveEvidenceSchema
 } from "./index-k5jrywpr.js";
@@ -220,7 +220,7 @@ import {
   init_schema,
   init_tool_metadata,
   stripKnownSwarmPrefix
-} from "./index-414r47r7.js";
+} from "./index-r1gdkn2d.js";
 import {
   KNOWLEDGE_SCHEMA_VERSION,
   OUTCOME_BLOCK_THRESHOLD,
@@ -251,6 +251,9 @@ import {
   getDeferredWarnings,
   init_warning_buffer
 } from "./index-4rhhvd1a.js";
+import {
+  readDelegations
+} from "./index-0cz1ws47.js";
 import {
   readSwarmFileAsync,
   safeHook,
@@ -5449,6 +5452,60 @@ async function readPrWorkflowGateState(directory, sessionID) {
   }
   return state;
 }
+async function clearPrWorkflowGateState(directory, sessionID, expectedRevision) {
+  const normalizedSessionID = normalizeSessionID(sessionID);
+  await withSessionStateMutation(directory, normalizedSessionID, async () => {
+    const current = await readPrWorkflowGateStateFromDisk(directory, normalizedSessionID);
+    if (expectedRevision !== undefined && (!current || current.revision !== expectedRevision)) {
+      throw new Error("BLOCKED: PR workflow gate state changed during terminal completion; revalidate the current session state before retrying");
+    }
+    try {
+      await fsp.rm(workflowGateStatePath(directory, normalizedSessionID), {
+        force: true
+      });
+    } catch (error2) {
+      if (error2.code !== "ENOENT") {
+        throw error2;
+      }
+    }
+    trackedStatesByProjectSession.delete(stateCacheKey(directory, normalizedSessionID));
+  });
+}
+async function abortPrWorkflow(directory, sessionID, options = {}) {
+  const state = await requireAnyActiveState(directory, sessionID);
+  if (options.expectedMode && state.mode !== options.expectedMode) {
+    throw wrongModeError(state, options.expectedMode);
+  }
+  if (state.prFeedbackReadyToPublish) {
+    throw new Error(`BLOCKED: ${state.mode} is armed for publication; abort is blocked. Complete the workflow with complete_pr_workflow (or push the bound commit first) before aborting.`);
+  }
+  const openLanes = readDelegations(directory).filter((record) => record.parentSessionId === state.sessionID && record.mode?.startsWith("swarm-pr-") && (record.status === "pending" || record.status === "running"));
+  if (openLanes.length > 0) {
+    const laneIds = openLanes.map((record) => record.laneId ?? record.subagentSessionId ?? "unknown").filter(Boolean).slice(0, 10).join(", ");
+    throw new Error(`BLOCKED: ${state.mode} abort refused while ${openLanes.length} PR workflow lane(s) are still in flight (lane ids: ${laneIds}). Collect their results or let them settle before aborting.`);
+  }
+  const sanitizedReason = typeof options.reason === "string" ? options.reason.trim().slice(0, 500) : undefined;
+  const abortEvent = {
+    type: "pr_workflow_aborted",
+    timestamp: isoNow(),
+    sessionID: state.sessionID,
+    mode: state.mode,
+    ...state.prHeadSha ? { prHeadSha: state.prHeadSha } : {},
+    openLanes: openLanes.length,
+    ...sanitizedReason ? { reason: sanitizedReason } : {}
+  };
+  try {
+    const eventsPath = validateSwarmPath(directory, "events.jsonl");
+    await fsp.appendFile(eventsPath, `${JSON.stringify(abortEvent)}
+`, "utf-8");
+  } catch {}
+  await clearPrWorkflowGateState(directory, sessionID, state.revision);
+  return {
+    mode: state.mode,
+    ...state.prHeadSha ? { prHeadSha: state.prHeadSha } : {},
+    openLanes: openLanes.length
+  };
+}
 async function bindPrWorkflowHead(directory, sessionID, prHeadSha) {
   const state = await requireAnyActiveState(directory, sessionID);
   const normalizedHead = normalizePrHeadSha(prHeadSha);
@@ -5513,7 +5570,11 @@ async function requireAnyActiveState(directory, sessionID) {
   }
   return state;
 }
+function wrongModeError(state, expectedMode) {
+  return new Error(`BLOCKED: session "${state.sessionID}" is active in ${state.mode}, not ${expectedMode}`);
+}
 var PR_WORKFLOW_CONTROLLER_TOOLS = new Set([
+  "abort_pr_workflow",
   "collect_lane_results",
   "complete_pr_workflow",
   "dispatch_lanes_async",
@@ -5856,6 +5917,55 @@ function delay(ms) {
 // src/commands/registry.ts
 init_logger();
 
+// src/commands/abort-pr-workflow.ts
+var USAGE = [
+  "Usage: /swarm abort-pr-workflow [PR_REVIEW|PR_FEEDBACK] [reason...]",
+  "",
+  "Clear an active PR_REVIEW or PR_FEEDBACK mechanical gate for the current session",
+  "and stop the auto-resume loop. Use when a PR review or feedback workflow is stuck",
+  "(e.g. the working tree cannot reach the PR head, a compound shell command was",
+  "rejected, or the wake budget is suspended).",
+  "",
+  "Arguments:",
+  "  mode    Optional: PR_REVIEW or PR_FEEDBACK. If omitted, aborts whichever is active.",
+  "  reason  Optional free-text reason (recorded to .swarm/events.jsonl).",
+  "",
+  "Refuses while the workflow is armed for publication (call complete_pr_workflow",
+  "instead) or while PR workflow lanes are still in flight (collect their results first)."
+].join(`
+`);
+var KNOWN_MODES = new Set(["PR_REVIEW", "PR_FEEDBACK"]);
+async function handleAbortPrWorkflowCommand(directory, args, sessionID) {
+  const tokens = (args ?? []).filter((token) => token.trim().length > 0);
+  const modeToken = tokens[0]?.toUpperCase();
+  const knownMode = modeToken && KNOWN_MODES.has(modeToken) ? modeToken : undefined;
+  const reasonStartIndex = knownMode ? 1 : 0;
+  const reason = tokens.slice(reasonStartIndex).join(" ").trim().slice(0, 500) || undefined;
+  if (modeToken && !knownMode) {
+    return `Error: Unknown mode "${modeToken}". Expected PR_REVIEW or PR_FEEDBACK.
+
+${USAGE}`;
+  }
+  if (!sessionID?.trim()) {
+    return `Error: abort-pr-workflow requires an active sessionID.
+
+${USAGE}`;
+  }
+  try {
+    const summary = await abortPrWorkflow(directory, sessionID, {
+      ...knownMode ? { expectedMode: knownMode } : {},
+      ...reason ? { reason } : {}
+    });
+    const headLine = summary.prHeadSha ? ` (was bound to PR head ${summary.prHeadSha})` : " (was not bound to a PR head)";
+    return `Aborted active ${summary.mode} mechanical gate for session ${sessionID}${headLine}. The durable gate state has been cleared and the auto-resume loop will stop. An audit event was appended to .swarm/events.jsonl.`;
+  } catch (error2) {
+    const message = error2 instanceof Error ? error2.message : String(error2);
+    return `Error: ${message}
+
+${USAGE}`;
+  }
+}
+
 // src/commands/acknowledge-spec-drift.ts
 import { promises as fsPromises } from "fs";
 import * as path10 from "path";
@@ -7916,7 +8026,7 @@ function resolvePrCommandInput(rest, cwd) {
 }
 
 // src/commands/ci-monitor.ts
-var USAGE = [
+var USAGE2 = [
   "Usage: /swarm ci-monitor <pr-url|owner/repo#N|N>",
   "",
   "Drive an already human-reviewed, approved pull request to green and",
@@ -7933,17 +8043,17 @@ function handleCiMonitorCommand(directory, args) {
   const rest = args.filter((token) => token.trim().length > 0);
   const resolved = resolvePrCommandInput(rest, directory);
   if (resolved === null) {
-    return USAGE;
+    return USAGE2;
   }
   if ("error" in resolved) {
     return `Error: ${resolved.error}
 
-${USAGE}`;
+${USAGE2}`;
   }
   if (resolved.instructions) {
     return `Error: /swarm ci-monitor takes only a PR reference \u2014 no trailing instructions. Got: "${resolved.instructions}"
 
-${USAGE}`;
+${USAGE2}`;
   }
   return `[MODE: CI_MONITOR pr="${resolved.prUrl}"]`;
 }
@@ -10815,7 +10925,7 @@ async function runCuratorPhase(directory, phase, agentsDispatched, config, knowl
     }
     if (config.skill_generation_enabled === true && skillCandidates.length > 0) {
       try {
-        const skillModule = await import("./skill-generator-ffc1agyw.js");
+        const skillModule = await import("./skill-generator-a7xfyddq.js");
         for (const cand of skillCandidates) {
           if (cand.confidence < (config.min_skill_confidence ?? DEFAULT_SKILL_MIN_CONFIDENCE)) {
             continue;
@@ -11152,7 +11262,7 @@ async function applyCuratorKnowledgeUpdates(directory, recommendations, knowledg
     } catch {}
   }
   if (contradictedEntries.length > 0 && knowledgeConfig.contradiction_threshold_action === "quarantine") {
-    const { maybeQuarantineOnContradiction } = await import("./knowledge-escalator-gr8qd7kz.js");
+    const { maybeQuarantineOnContradiction } = await import("./knowledge-escalator-h3hg7ek7.js");
     for (const { id } of contradictedEntries) {
       try {
         await maybeQuarantineOnContradiction(directory, id, knowledgeConfig.contradiction_quarantine_threshold, knowledgeConfig.contradiction_quarantine_window_days);
@@ -11951,7 +12061,7 @@ async function runCuratorPostMortem(directory, options = {}) {
       warnings.push("Failed to collect knowledge summary.");
     }
     try {
-      const { getScanStatus } = await import("./scan-cursor-fa5sy36q.js");
+      const { getScanStatus } = await import("./scan-cursor-r0w2p5gz.js");
       const scanStatus = await getScanStatus(directory);
       if (scanStatus.remaining_estimate > 0) {
         warnings.push(`Fair scan: reviewed ${knowledgeSummary.length} entries this sweep (generation ${scanStatus.generation}); ${scanStatus.remaining_estimate} more eligible entries will be visited in future curation sweeps.`);
@@ -12123,9 +12233,9 @@ var _internals15 = {
   verifyPostMortemKnowledgeActions,
   repairPostMortemActions,
   loadDefaultKnowledgeConfig: async (directory) => {
-    const { KnowledgeConfigSchema: KnowledgeConfigSchema2 } = await import("./schema-bw68my66.js");
+    const { KnowledgeConfigSchema: KnowledgeConfigSchema2 } = await import("./schema-69z8w1ka.js");
     try {
-      const { loadPluginConfigWithMeta: loadPluginConfigWithMeta2 } = await import("./index-emzes7sj.js");
+      const { loadPluginConfigWithMeta: loadPluginConfigWithMeta2 } = await import("./index-4b1e5m0d.js");
       const loaded = loadPluginConfigWithMeta2(directory);
       return KnowledgeConfigSchema2.parse(loaded.config.knowledge ?? {});
     } catch {
@@ -12133,11 +12243,11 @@ var _internals15 = {
     }
   },
   applyCuratorKnowledgeUpdates: async (directory, recommendations, knowledgeConfig, generation) => {
-    const { applyCuratorKnowledgeUpdates: applyCuratorKnowledgeUpdates2 } = await import("./curator-n6whbm4r.js");
+    const { applyCuratorKnowledgeUpdates: applyCuratorKnowledgeUpdates2 } = await import("./curator-mhhvx2pw.js");
     return applyCuratorKnowledgeUpdates2(directory, recommendations, knowledgeConfig, generation);
   },
   checkHivePromotions: async (entries, knowledgeConfig, directory) => {
-    const { checkHivePromotions } = await import("./hive-promoter-mpjq0fw9.js");
+    const { checkHivePromotions } = await import("./hive-promoter-6mhnhrbx.js");
     return checkHivePromotions(entries, knowledgeConfig, directory);
   },
   applyProposalTriage: async (directory, triage) => {
@@ -12146,7 +12256,7 @@ var _internals15 = {
       activateProposal,
       listSkills: listSkills2,
       sanitizeSlug
-    } = await import("./skill-generator-ffc1agyw.js");
+    } = await import("./skill-generator-a7xfyddq.js");
     const result = {
       approved: [],
       rejected: [],
@@ -12279,7 +12389,7 @@ function failedGateNames(decision) {
 
 // src/hooks/hive-transaction.ts
 var import_proper_lockfile2 = __toESM(require_proper_lockfile(), 1);
-import { appendFile as appendFile2, mkdir as mkdir7 } from "fs/promises";
+import { appendFile as appendFile3, mkdir as mkdir7 } from "fs/promises";
 import * as path22 from "path";
 init_logger();
 var HIVE_LOCK_STALE_MS = 5000;
@@ -12340,13 +12450,13 @@ async function transactHiveStore(mutate) {
       const rejectBlock = `${outcome.rejects.map((r) => JSON.stringify(r)).join(`
 `)}
 `;
-      await appendFile2(rejectedPath, rejectBlock, "utf-8");
+      await appendFile3(rejectedPath, rejectBlock, "utf-8");
     }
     if (outcome.audit && outcome.audit.length > 0) {
       const auditBlock = `${outcome.audit.map((a) => a.line).join(`
 `)}
 `;
-      await appendFile2(eventsPath, auditBlock, "utf-8");
+      await appendFile3(eventsPath, auditBlock, "utf-8");
       try {
         await trimHiveEventsUnderLock(eventsPath);
       } catch (err) {
@@ -12394,7 +12504,7 @@ init_knowledge_types();
 
 // src/hooks/promotion-evidence-store.ts
 import {
-  appendFile as appendFile3,
+  appendFile as appendFile4,
   mkdir as mkdir8,
   readFile as readFile7,
   rename as rename5,
@@ -13102,7 +13212,7 @@ async function promoteFromSwarm(directory, lessonId, options, config) {
 import { createHash as createHash7 } from "crypto";
 import { existsSync as existsSync15 } from "fs";
 import {
-  appendFile as appendFile4,
+  appendFile as appendFile5,
   mkdir as mkdir10,
   readFile as readFile10,
   realpath,
@@ -14671,9 +14781,9 @@ function hashContent(content) {
   return createHash7("sha1").update(content).digest("hex");
 }
 async function loadConfigForPolicyCurator(directory) {
-  const { KnowledgeConfigSchema: KnowledgeConfigSchema2 } = await import("./schema-bw68my66.js");
+  const { KnowledgeConfigSchema: KnowledgeConfigSchema2 } = await import("./schema-69z8w1ka.js");
   try {
-    const { loadPluginConfigWithMeta: loadPluginConfigWithMeta2 } = await import("./index-emzes7sj.js");
+    const { loadPluginConfigWithMeta: loadPluginConfigWithMeta2 } = await import("./index-4b1e5m0d.js");
     const { config: loadedConfig } = loadPluginConfigWithMeta2(directory);
     return KnowledgeConfigSchema2.parse(loadedConfig.knowledge ?? {});
   } catch {
@@ -15153,7 +15263,7 @@ async function appendCuratorSkippedEvent(directory, record) {
   try {
     const filePath = path28.join(directory, ".swarm", "events.jsonl");
     await mkdir10(path28.dirname(filePath), { recursive: true });
-    await appendFile4(filePath, `${JSON.stringify({
+    await appendFile5(filePath, `${JSON.stringify({
       timestamp: new Date().toISOString(),
       event: "curator_skipped",
       entry_id: record.entry_id,
@@ -17834,7 +17944,7 @@ async function runFinalizeStage(ctx) {
     }
   }
   try {
-    const { CuratorConfigSchema: CCS } = await import("./schema-bw68my66.js");
+    const { CuratorConfigSchema: CCS } = await import("./schema-69z8w1ka.js");
     const { config: pmLoadedConfig } = _internals24.loadPluginConfigWithMeta(ctx.directory);
     const curatorCfg = CCS.parse(pmLoadedConfig.curator ?? {});
     if (curatorCfg.enabled && curatorCfg.postmortem_enabled) {
@@ -18674,7 +18784,7 @@ var MODES = new Set(CODEBASE_REVIEW_MODES);
 var DEFAULT_MODE = "phase0";
 var DEFAULT_SCOPE = "repository root";
 var FLAG_VALUE_MISSING = (token) => `Flag "${token}" requires a value`;
-var USAGE2 = `Usage: /swarm codebase-review [scope] [--mode phase0|complete|defect|security|correctness|testing|ui|performance|ai-slop|enhancements|custom] [--tracks <list>] [--continue <run-id>] [--json] [--skip-update] [--allow-dirty]
+var USAGE3 = `Usage: /swarm codebase-review [scope] [--mode phase0|complete|defect|security|correctness|testing|ui|performance|ai-slop|enhancements|custom] [--tracks <list>] [--continue <run-id>] [--json] [--skip-update] [--allow-dirty]
 
 Run the codebase-review-swarm workflow in the current repository.
 
@@ -18767,12 +18877,12 @@ function parseArgs(args) {
 async function handleCodebaseReviewCommand(_directory, args) {
   const parsed = parseArgs(args);
   if (parsed.help) {
-    return USAGE2;
+    return USAGE3;
   }
   if (parsed.error) {
     return `Error: ${parsed.error}
 
-${USAGE2}`;
+${USAGE3}`;
   }
   const scope = sanitizeText(parsed.rest.join(" "), MAX_SCOPE_LEN) || DEFAULT_SCOPE;
   return [
@@ -19190,7 +19300,7 @@ function parseArgs2(args) {
   }
   return out;
 }
-var USAGE3 = [
+var USAGE4 = [
   "Usage: /swarm council <question> [--spec-review]",
   "",
   "  question         The question to put to the council",
@@ -19203,7 +19313,7 @@ async function handleCouncilCommand(_directory, args) {
   const parsed = parseArgs2(args);
   const question = sanitizeQuestion(parsed.rest.join(" "));
   if (!question) {
-    return USAGE3;
+    return USAGE4;
   }
   const tokens = ["MODE: COUNCIL"];
   if (parsed.preset) {
@@ -20003,9 +20113,9 @@ var _internals28 = {
   readSwarmFileAsync,
   loadCuratorDeps: async () => {
     const [{ CuratorConfigSchema }, curator, { createCuratorLLMDelegate: createCuratorLLMDelegate2 }] = await Promise.all([
-      import("./schema-bw68my66.js"),
-      import("./curator-n6whbm4r.js"),
-      import("./curator-llm-factory-0hncnz9t.js")
+      import("./schema-69z8w1ka.js"),
+      import("./curator-mhhvx2pw.js"),
+      import("./curator-llm-factory-av2tcfy9.js")
     ]);
     return { CuratorConfigSchema, curator, createCuratorLLMDelegate: createCuratorLLMDelegate2 };
   }
@@ -20161,7 +20271,7 @@ var PROFILES = new Set([
 var DEFAULT_PROFILE = "standard";
 var DEFAULT_MAX_EXPLORERS = 6;
 var FULL_PROFILE_DEFAULT_MAX_EXPLORERS = 8;
-var USAGE4 = `Usage: /swarm deep-dive <scope> [--profile standard|security|ux|architecture|full] [--max-explorers N] [--json] [--skip-update] [--allow-dirty]
+var USAGE5 = `Usage: /swarm deep-dive <scope> [--profile standard|security|ux|architecture|full] [--max-explorers N] [--json] [--skip-update] [--allow-dirty]
 
 Run a bounded, evidence-backed deep dive on an application section.
 
@@ -20250,11 +20360,11 @@ async function handleDeepDiveCommand(_directory, args) {
   if (parsed.error) {
     return `Error: ${parsed.error}
 
-${USAGE4}`;
+${USAGE5}`;
   }
   const scope = sanitizeScope(parsed.rest.join(" "));
   if (!scope) {
-    return USAGE4;
+    return USAGE5;
   }
   if (parsed.profile === "full" && !parsed.maxExplorersExplicit) {
     parsed.maxExplorers = FULL_PROFILE_DEFAULT_MAX_EXPLORERS;
@@ -20271,7 +20381,7 @@ var DEFAULT_MAX_RESEARCHERS = 3;
 var EXHAUSTIVE_DEFAULT_MAX_RESEARCHERS = 5;
 var DEFAULT_ROUNDS = 2;
 var EXHAUSTIVE_DEFAULT_ROUNDS = 3;
-var USAGE5 = `Usage: /swarm deep-research <question> [--depth standard|exhaustive] [--max-researchers 1..6] [--rounds 1..4] [--brief]
+var USAGE6 = `Usage: /swarm deep-research <question> [--depth standard|exhaustive] [--max-researchers 1..6] [--rounds 1..4] [--brief]
 
 Run a multi-source, fact-checked deep research pass and synthesize a cited report.
 
@@ -20365,11 +20475,11 @@ async function handleDeepResearchCommand(_directory, args) {
   if (parsed.error) {
     return `Error: ${parsed.error}
 
-${USAGE5}`;
+${USAGE6}`;
   }
   const question = sanitizeQuestion2(parsed.rest.join(" "));
   if (!question) {
-    return USAGE5;
+    return USAGE6;
   }
   if (parsed.depth === "exhaustive") {
     if (!parsed.maxResearchersExplicit)
@@ -20384,7 +20494,7 @@ ${USAGE5}`;
 init_warning_buffer();
 var MAX_DESC_LEN = 2000;
 var _internals29 = { loadPluginConfigWithMeta };
-var USAGE6 = `Usage: /swarm design-docs <description> [--out <dir>] [--lang <name>] [--update]
+var USAGE7 = `Usage: /swarm design-docs <description> [--out <dir>] [--lang <name>] [--update]
 
 Generate or sync language-agnostic design docs for the project under build:
   <out>/domain.md, <out>/technical-spec.md, <out>/behavior-spec.md,
@@ -20476,21 +20586,21 @@ async function handleDesignDocsCommand(directory, args) {
   if (parsed.error) {
     return `Error: ${parsed.error}
 
-${USAGE6}`;
+${USAGE7}`;
   }
   try {
     const { config } = _internals29.loadPluginConfigWithMeta(directory);
     if (config.design_docs?.enabled !== true) {
       return "Error: design docs are disabled. Set `design_docs.enabled: true` in " + `opencode-swarm.json to enable the docs_design agent and this command.
 
-` + USAGE6;
+` + USAGE7;
     }
   } catch (configErr) {
     advisoryWarn(`[design-docs] Could not read opencode-swarm.json (${String(configErr)}). ` + "Falling through \u2014 the architect will abort if docs_design is not registered.");
   }
   const description = sanitizeDescription(parsed.rest.join(" "));
   if (!description && !parsed.update) {
-    return USAGE6;
+    return USAGE7;
   }
   const header = `[MODE: DESIGN_DOCS out=${parsed.out} lang=${parsed.lang} update=${parsed.update}] ${description}`;
   return header.trimEnd();
@@ -20504,7 +20614,7 @@ import { fileURLToPath } from "url";
 // package.json
 var package_default = {
   name: "opencode-swarm",
-  version: "7.125.4",
+  version: "7.125.5",
   description: "Architect-centric agentic swarm plugin for OpenCode - hub-and-spoke orchestration with SME consultation, code generation, and QA review",
   main: "dist/index.js",
   types: "dist/index.d.ts",
@@ -21025,7 +21135,7 @@ async function computeCurationDiagnostics(directory, entries) {
   let scanCompleted = false;
   let scanRemaining = 0;
   try {
-    const { getScanStatus } = await import("./scan-cursor-fa5sy36q.js");
+    const { getScanStatus } = await import("./scan-cursor-r0w2p5gz.js");
     const status = await getScanStatus(directory);
     scanGeneration = status.generation;
     scanCompleted = status.completed;
@@ -21035,17 +21145,17 @@ async function computeCurationDiagnostics(directory, entries) {
   try {
     const { isLinked: isLinked2 } = await import("./knowledge-link-4yd2z8ev.js");
     if (isLinked2(directory)) {
-      const { KnowledgeConfigSchema: KnowledgeConfigSchema2 } = await import("./schema-bw68my66.js");
+      const { KnowledgeConfigSchema: KnowledgeConfigSchema2 } = await import("./schema-69z8w1ka.js");
       let config;
       try {
-        const { loadPluginConfigWithMeta: loadPluginConfigWithMeta2 } = await import("./index-emzes7sj.js");
+        const { loadPluginConfigWithMeta: loadPluginConfigWithMeta2 } = await import("./index-4b1e5m0d.js");
         const loaded = loadPluginConfigWithMeta2(directory);
         config = KnowledgeConfigSchema2.parse(loaded.config.knowledge ?? {});
       } catch {
         config = KnowledgeConfigSchema2.parse({});
       }
       const { cohortConfigFingerprint: cohortConfigFingerprint2 } = await import("./config-fingerprint-v22xh5a2.js");
-      const { buildConfigFingerprintInput: buildConfigFingerprintInput2, readCohortConfigFingerprint } = await import("./curation-policy-7pgdjt5w.js");
+      const { buildConfigFingerprintInput: buildConfigFingerprintInput2, readCohortConfigFingerprint } = await import("./curation-policy-62w2pwfz.js");
       const currentFp = cohortConfigFingerprint2(buildConfigFingerprintInput2(config));
       const cohortFp = await readCohortConfigFingerprint(directory);
       configMatch = cohortFp === null ? null : currentFp === cohortFp;
@@ -22233,7 +22343,7 @@ async function handleDoctorCommand(directory, args) {
   const result = runConfigDoctor(config, directory);
   let output;
   if (enableAutoFix && result.hasAutoFixableIssues) {
-    const { runConfigDoctorWithFixes } = await import("./config-doctor-rm1m07gz.js");
+    const { runConfigDoctorWithFixes } = await import("./config-doctor-akxywx0c.js");
     const fixResult = await runConfigDoctorWithFixes(directory, config, true, {
       applyLossy: true
     });
@@ -28827,7 +28937,7 @@ async function handleHistoryCommand(directory, _args) {
 // src/commands/issue.ts
 import * as fs24 from "fs";
 import * as path56 from "path";
-var USAGE7 = [
+var USAGE8 = [
   "Usage: /swarm issue <url|owner/repo#N|N> [--plan] [--trace] [--no-repro]",
   "",
   "Ingest a GitHub issue into the swarm workflow.",
@@ -28944,21 +29054,21 @@ function handleIssueCommand(directory, args) {
   const parsed = parseArgs8(args);
   const rawInput = parsed.rest.join(" ").trim();
   if (!rawInput) {
-    return USAGE7;
+    return USAGE8;
   }
   const isFullUrl = /^https?:\/\//i.test(rawInput);
   const issueInfo = parseIssueRef(isFullUrl ? sanitizeUrl(rawInput) : rawInput, directory);
   if (!issueInfo) {
     return `Error: Could not parse issue reference from "${sanitizeErrorEcho(rawInput)}"
 
-${USAGE7}`;
+${USAGE8}`;
   }
   const issueUrl = `https://github.com/${issueInfo.owner}/${issueInfo.repo}/issues/${issueInfo.number}`;
   const result = validateAndSanitizeUrl2(issueUrl);
   if ("error" in result) {
     return `Error: ${result.error}
 
-${USAGE7}`;
+${USAGE8}`;
   }
   const swarmDir = path56.join(directory, ".swarm");
   const issueReference = {
@@ -29009,7 +29119,7 @@ ${USAGE7}`;
     const errMsg = e instanceof Error ? e.message : String(e);
     return `Error: Failed to persist issue reference durably: ${errMsg}
 
-${USAGE7}`;
+${USAGE8}`;
   }
   const flags = [];
   if (parsed.plan)
@@ -30534,7 +30644,7 @@ async function readLatestLoopState(directory) {
 var _internals45 = {
   readLatestLoopState
 };
-var USAGE8 = `Usage: /swarm loop <objective> [--max-cycles 1..5] [--autonomy checkpoint|auto] [--depth standard|exhaustive] [--resume]
+var USAGE9 = `Usage: /swarm loop <objective> [--max-cycles 1..5] [--autonomy checkpoint|auto] [--depth standard|exhaustive] [--resume]
 
 Run a compound-engineering loop: brainstorm \u2192 plan \u2192 build \u2192 review \u2192 improve,
 iterating until the objective is met or a budget stop condition fires.
@@ -30636,11 +30746,11 @@ async function handleLoopCommand(_directory, args) {
   if (parsed.error) {
     return `Error: ${parsed.error}
 
-${USAGE8}`;
+${USAGE9}`;
   }
   const objective = sanitizeObjective(parsed.rest.join(" "));
   if (!objective && !parsed.resume) {
-    return USAGE8;
+    return USAGE9;
   }
   let autonomy = parsed.autonomy;
   if (parsed.resume && !parsed.autonomyExplicit) {
@@ -31022,7 +31132,7 @@ var CuratorOutputMemoryDecisionSchema = exports_external.object({
 // src/memory/injector.ts
 init_schema();
 // src/memory/consolidation-log.ts
-import { appendFile as appendFile5, mkdir as mkdir17, readFile as readFile17 } from "fs/promises";
+import { appendFile as appendFile6, mkdir as mkdir17, readFile as readFile17 } from "fs/promises";
 import * as path61 from "path";
 var LOG_RELATIVE_PATH = path61.join("memory", "consolidation-log.jsonl");
 var LOG_BASENAME = "consolidation-log.jsonl";
@@ -32502,7 +32612,7 @@ async function handlePrMonitorStatusCommand(directory, _args, sessionID, source)
 }
 
 // src/commands/pr-review.ts
-var USAGE9 = [
+var USAGE10 = [
   "Usage: /swarm pr-review <url|owner/repo#N|N> [--council] [instructions...]",
   "",
   "Run a full swarm PR review on a GitHub pull request.",
@@ -32540,16 +32650,16 @@ function handlePrReviewCommand(directory, args) {
   if (parsed.unknownFlag) {
     return `Error: Unknown flag "${parsed.unknownFlag}"
 
-${USAGE9}`;
+${USAGE10}`;
   }
   const resolved = resolvePrCommandInput(parsed.rest, directory);
   if (resolved === null) {
-    return USAGE9;
+    return USAGE10;
   }
   if ("error" in resolved) {
     return `Error: ${resolved.error}
 
-${USAGE9}`;
+${USAGE10}`;
   }
   const councilFlag = parsed.council ? "council=true" : "council=false";
   const signal = `[MODE: PR_REVIEW pr="${resolved.prUrl}" ${councilFlag}]`;
@@ -39334,7 +39444,7 @@ var _internals59 = {
   writeProjectedSpecSync
 };
 var SWARM_SPEC_REL = path79.join(".swarm", "spec.md");
-var USAGE10 = `Usage:
+var USAGE11 = `Usage:
   /swarm sdd status [--json] [--source <provider>]
   /swarm sdd validate [--json] [--change <id>] [--source <provider>] [--feature <id>]
   /swarm sdd project [--dry-run] [--overwrite] [--json] [--change <id>] [--source <provider>] [--feature <id>]
@@ -39447,11 +39557,11 @@ async function handleSddStatusCommand(directory, args) {
   if (parsed.error)
     return `Error: ${parsed.error}
 
-${USAGE10}`;
+${USAGE11}`;
   if (parsed.feature && parsed.source && parsed.source !== "speckit") {
     return `Error: --feature is only valid with --source speckit
 
-${USAGE10}`;
+${USAGE11}`;
   }
   const speckitDetection = detectSpeckit(directory);
   const speckitPresent = speckitDetection.features.length > 0;
@@ -39518,11 +39628,11 @@ async function handleSddValidateCommand(directory, args) {
   if (parsed.error)
     return `Error: ${parsed.error}
 
-${USAGE10}`;
+${USAGE11}`;
   if (parsed.feature && parsed.source && parsed.source !== "speckit") {
     return `Error: --feature is only valid with --source speckit
 
-${USAGE10}`;
+${USAGE11}`;
   }
   let useSpeckit = false;
   const nativeSpecExists = fs39.existsSync(path79.join(directory, SWARM_SPEC_REL));
@@ -39551,7 +39661,7 @@ ${USAGE10}`;
         const resolution = resolveSpeckitProjection(directory);
         return parsed.json ? JSON.stringify({ valid: false, error: formatSpeckitError(resolution) }, null, 2) : `Error: ${formatSpeckitError(resolution)}
 
-${USAGE10}`;
+${USAGE11}`;
       }
     }
   }
@@ -39562,7 +39672,7 @@ ${USAGE10}`;
     if (resolution.kind !== "ok" && resolution.kind !== "zero_requirements") {
       return parsed.json ? JSON.stringify({ valid: false, error: formatSpeckitError(resolution) }, null, 2) : `Error: ${formatSpeckitError(resolution)}
 
-${USAGE10}`;
+${USAGE11}`;
     }
     const spec = resolution.kind === "ok" ? resolution.spec : null;
     const result2 = {
@@ -39667,16 +39777,16 @@ async function handleSddProjectCommand(directory, args) {
   if (parsed.error)
     return `Error: ${parsed.error}
 
-${USAGE10}`;
+${USAGE11}`;
   if (parsed.feature && parsed.source && parsed.source !== "speckit") {
     return `Error: --feature is only valid with --source speckit
 
-${USAGE10}`;
+${USAGE11}`;
   }
   if (parsed.source === "swarm") {
     return `Error: --source swarm selects the native .swarm/spec.md and does not generate a projection. Use --source openspec or --source speckit.
 
-${USAGE10}`;
+${USAGE11}`;
   }
   if (!parsed.dryRun) {
     const nativeSpecPath = path79.join(directory, SWARM_SPEC_REL);
@@ -39686,7 +39796,7 @@ ${USAGE10}`;
           "Error: .swarm/spec.md already exists.",
           "Pass --overwrite to replace it.",
           "",
-          USAGE10
+          USAGE11
         ].join(`
 `);
       }
@@ -39713,7 +39823,7 @@ ${USAGE10}`;
         const resolution = resolveSpeckitProjection(directory);
         return `Error: ${formatSpeckitError(resolution)}
 
-${USAGE10}`;
+${USAGE11}`;
       }
     }
   }
@@ -39724,7 +39834,7 @@ ${USAGE10}`;
     if (resolution.kind !== "ok") {
       return `Error: ${formatSpeckitError(resolution)}
 
-${USAGE10}`;
+${USAGE11}`;
     }
     const result2 = _internals59.writeProjectedSpecSync(directory, {
       source: "speckit",
@@ -39743,7 +39853,7 @@ ${USAGE10}`;
       }
       return `Error: ${result2.error}
 
-${USAGE10}`;
+${USAGE11}`;
     }
     if (!result2.projection) {
       if (parsed.json) {
@@ -39757,7 +39867,7 @@ ${USAGE10}`;
       return [
         "SDD projection failed: no valid Spec-Kit projection could be built.",
         "",
-        USAGE10
+        USAGE11
       ].join(`
 `);
     }
@@ -39800,7 +39910,7 @@ ${formatList(result2.projection.warnings)}` : ""
     }
     return `Error: ${result.error}
 
-${USAGE10}`;
+${USAGE11}`;
   }
   if (!result.projection) {
     if (parsed.json) {
@@ -39814,7 +39924,7 @@ ${USAGE10}`;
     return [
       "SDD projection failed: no valid OpenSpec-compatible projection could be built.",
       "",
-      USAGE10
+      USAGE11
     ].join(`
 `);
   }
@@ -39842,7 +39952,7 @@ ${formatList(result.projection.warnings)}` : ""
 `);
 }
 async function handleSddCommand(_directory, _args) {
-  return USAGE10;
+  return USAGE11;
 }
 
 // src/commands/simulate.ts
@@ -41016,7 +41126,7 @@ function buildDetailedHelp(commandName, entry) {
 async function handleHelpCommand(ctx) {
   const targetCommand = ctx.args.join(" ");
   if (!targetCommand) {
-    const { buildHelpText } = await import("./index-hr2kzcem.js");
+    const { buildHelpText } = await import("./index-0cdq55k0.js");
     return buildHelpText();
   }
   const tokens = targetCommand.split(/\s+/);
@@ -41025,7 +41135,7 @@ async function handleHelpCommand(ctx) {
     return _internals62.buildDetailedHelp(resolved.key, resolved.entry);
   }
   const similar = _internals62.findSimilarCommands(targetCommand);
-  const { buildHelpText: fullHelp } = await import("./index-hr2kzcem.js");
+  const { buildHelpText: fullHelp } = await import("./index-0cdq55k0.js");
   if (similar.length > 0) {
     return `Command '/swarm ${targetCommand}' not found.
 
@@ -41164,7 +41274,7 @@ var COMMAND_REGISTRY = {
   },
   "guardrail explain": {
     handler: async (ctx) => {
-      const { handleGuardrailExplain } = await import("./guardrail-explain-8gknrsbb.js");
+      const { handleGuardrailExplain } = await import("./guardrail-explain-kqx2bczn.js");
       return handleGuardrailExplain(ctx.directory, ctx.args);
     },
     description: "Dry-run: show what the guardrails would do to a command or write target (executes nothing)",
@@ -41174,7 +41284,7 @@ var COMMAND_REGISTRY = {
   },
   "guardrail-explain": {
     handler: async (ctx) => {
-      const { handleGuardrailExplain } = await import("./guardrail-explain-8gknrsbb.js");
+      const { handleGuardrailExplain } = await import("./guardrail-explain-kqx2bczn.js");
       return handleGuardrailExplain(ctx.directory, ctx.args);
     },
     description: "Dry-run: show what the guardrails would do to a command or write target (executes nothing)",
@@ -41184,7 +41294,7 @@ var COMMAND_REGISTRY = {
   },
   "guardrail-log": {
     handler: async (ctx) => {
-      const { handleGuardrailLog } = await import("./guardrail-log-6a2zxvtx.js");
+      const { handleGuardrailLog } = await import("./guardrail-log-222xyxfp.js");
       return handleGuardrailLog(ctx.directory, ctx.args);
     },
     description: "Read the guardrail decision log (use --blocks-only for blocks)",
@@ -41537,6 +41647,14 @@ Subcommands:
     category: "agent",
     toolPolicy: "none"
   },
+  "abort-pr-workflow": {
+    handler: (ctx) => handleAbortPrWorkflowCommand(ctx.directory, ctx.args, ctx.sessionID),
+    description: "Clear a stuck PR_REVIEW/PR_FEEDBACK mechanical gate and stop the auto-resume loop [mode] [reason]",
+    args: "[PR_REVIEW|PR_FEEDBACK] [reason...]",
+    details: "Human-only escape hatch for an unrecoverable PR_REVIEW or PR_FEEDBACK mechanical gate. When the architect cannot reach complete_pr_workflow \u2014 for example a compound `git fetch && git checkout` was rejected as read-only shell syntax, the PR head cannot be fetched, or the working tree is on the wrong branch \u2014 running this clears the durable gate state for the current session and stops the auto-resume loop without depending on the trapped model. The agent itself cannot run this command; it must call the abort_pr_workflow tool (or ask you to run this command). Both paths funnel into the same fail-closed abortPrWorkflow hook, which refuses while the workflow is armed for publication or while PR workflow lanes are still in flight. An audit event is appended to .swarm/events.jsonl.",
+    category: "utility",
+    toolPolicy: "restricted"
+  },
   "pr-review": {
     handler: (ctx) => handleModeCommandWithBundledSkills(ctx, handlePrReviewCommand, "PR_REVIEW"),
     description: "Launch deep PR review with multi-lane analysis [url] [--council]",
@@ -42960,6 +43078,7 @@ HARD CONSTRAINTS (apply regardless of skill load success):
 - RUN ALL MICRO-LANES: after the base explorer lanes settle, focus every repository-agnostic row from the exact diff/context pack and launch all 11 micro-lanes with \`mode: "swarm-pr-review:micro"\`, the complete all-\`MATCHED\` \`trigger_evaluation\`, and each trigger ID as \`workflow_lane\`. Keyword or path heuristics cannot waive a row. Missing any micro-lane is a BLOCKED coverage gap, not a speed optimization; split the lanes across bounded \`dispatch_lanes_async\` batches and use the same non-idling incremental collection pattern.
 - RUN HEAD-BOUND VALIDATION: dispatch independent reviewers with \`mode: "swarm-pr-review:reviewer"\` and critics with \`mode: "swarm-pr-review:critic"\`, unique \`workflow_lane\` obligations, role-correct agents, and the same exact \`pr_head_sha\`. Critic dispatch is blocked until all declared reviewer obligations have successful artifacts.
 - COMPLETE EXPLICITLY: after final artifacts and synthesis, call \`complete_pr_workflow\` with \`mode: "PR_REVIEW"\` and the bound \`pr_head_sha\`; never leave the session trapped in a stale workflow gate.
+- ABORT IF UNRECOVERABLE: if the PR head cannot be fetched/checked out (the working tree stays on the wrong branch), a compound \`git fetch && git checkout\` keeps being rejected as read-only shell syntax (run them as TWO separate standalone commands first), or the merge-base bind is unreachable for any reason, call \`abort_pr_workflow\` with \`mode: "PR_REVIEW"\` and a one-line \`reason\` instead of looping. The tool refuses while PR workflow lanes are in flight (collect their results first). Aborting clears the durable gate and stops the auto-resume loop; the user can also run \`/swarm abort-pr-workflow\`. Do NOT abort as a shortcut to avoid coverage obligations \u2014 only when the bind/checkout path is genuinely unreachable.
 - Honor any free-text instructions that follow the closing bracket of the signal as additional reviewer focus, without weakening the validation ladder above.
 
 ### MODE: PR_FEEDBACK
@@ -42980,6 +43099,7 @@ HARD CONSTRAINTS (apply regardless of skill load success):
 - DO NOT PUBLISH EARLY: commits, pushes, PR comments/updates, review-thread mutations, and other remote writes remain blocked until every ordered feedback gate settles positively on the same revision digest.
 - After every local gate passes, create the reviewed commit with one standalone \`git commit\`, then call \`complete_pr_workflow\` once. It requires a clean index/worktree and a non-merge direct child whose sole parent is the immutable intake head before binding that post-commit HEAD and arming publication. Push only with \`git push <bound-remote> <bound-commit>:refs/heads/<bound-branch>\`; the literal bound commit and exact bound branch are required, and force flags, wrappers, aliases, fetch-based local-ref forgery, extra refspecs, \`git -C\`, and other remote writes fail closed. Perform read-only remote checks, then call \`complete_pr_workflow\` a second time with the same immutable verification \`pr_head_sha\`; the second call clears only after both the actual remote ref and its local tracking ref resolve to the exact bound commit. Only then perform any explicitly authorized PR comment/body/thread writes.
 - Patch only confirmed items plus the tests/docs they require; report closure status for every ledger item including disproved ones.
+- ABORT IF UNRECOVERABLE (pre-armed only): if the PR head cannot be fetched/checked out or the verification bind is unreachable for any reason, call \`abort_pr_workflow\` with \`mode: "PR_FEEDBACK"\` and a one-line \`reason\` instead of looping. The tool refuses while PR workflow lanes are in flight (collect their results first) AND refuses once \`prFeedbackReadyToPublish\` is armed \u2014 after arming, you MUST complete the workflow with \`complete_pr_workflow\` (or push the bound commit first); aborting an armed gate would drop the immutable-commit binding and leave a half-published commit. Do NOT abort as a shortcut to skip the mechanical gates \u2014 only when the bind/verification path is genuinely unreachable.
 - Do NOT resolve or mark GitHub review threads resolved unless the user explicitly instructs it.
 - Honor any free-text instructions that follow the closing bracket of the signal as additional scope, without dropping any ledger item.
 - Quality is the only metric \u2014 there is no speed, efficiency, or time exception; time, tokens, and agent dispatches are irrelevant to correctness