opencode-swarm 7.174.0 → 7.175.0

package/dist/cli/{index-jd2f7thw.js → index-ar3ve24w.js}

@@ -16,7 +16,7 @@ import {
   resolveExecutableFromPath,
   runEvaluation,
   runExternalTool
-} from "./index-nwew2anc.js";
+} from "./index-jn3m9s61.js";
 import {
   finalizeShellAuditForClose,
   isPolicyProtectedPath,
@@ -26,7 +26,7 @@ import {
   protectedRoots,
   redactDecisionLineForArchive,
   stableCanonicalStringify
-} from "./index-bf6w27sb.js";
+} from "./index-4rm5saxs.js";
 import {
   canonicalProjectKey,
   closeGroupCommitWriter,
@@ -39,7 +39,7 @@ import {
   readDoctorArtifact,
   removeStraySwarmDir,
   runConfigDoctor
-} from "./index-mmnk7nt1.js";
+} from "./index-hqmr21qx.js";
 import {
   MAX_TRANSIENT_RETRIES,
   archiveEvidence,
@@ -81,7 +81,7 @@ import {
   updateTaskStatus,
   validateProjectRoot,
   withPlanLifecycleLock
-} from "./index-v8ykb3hq.js";
+} from "./index-fzvh6trw.js";
 import {
   EvaluationTaskV1Schema,
   GateAuditManifestV1Schema,
@@ -98,7 +98,7 @@ import {
   saveGateAuditResult,
   savePromotionDecision,
   saveTaskSetSnapshot
-} from "./index-3yw5h3bt.js";
+} from "./index-98r0bh1c.js";
 import {
   canonicalHash,
   canonicalJson,
@@ -146,15 +146,15 @@ import {
   retireSkill,
   selectCandidateEntries,
   syncBundledProjectSkillsIfMissingAsync
-} from "./index-qc4nvg0m.js";
+} from "./index-m6bsy0jb.js";
 import {
   readRecentEscalations
-} from "./index-fagcasf8.js";
+} from "./index-9gpe25nr.js";
 import {
   alreadyCuratedThisGeneration,
   claimNextScanBatch,
   resolveCohortId
-} from "./index-dfey3jpn.js";
+} from "./index-6yqszgky.js";
 import {
   CURATOR_CONSOLIDATION_PROMPT,
   CURATOR_INIT_PROMPT,
@@ -174,7 +174,7 @@ import {
   sweepStale,
   unsubscribe,
   updateSnapshot
-} from "./index-vwjfm0s6.js";
+} from "./index-tr9jz898.js";
 import {
   clearWorktreeMergeStatus,
   getAllWorktreeMergeFailures,
@@ -186,7 +186,7 @@ import {
   listCoderSettlementWalStates,
   recoverCoderSettlement,
   recoverStaleCoderSettlements
-} from "./index-2qawngxn.js";
+} from "./index-vt9a5rbg.js";
 import {
   parsePorcelainV2Snapshot,
   resolveCommitCountSince,
@@ -257,7 +257,7 @@ import {
   transitionTaskWorkflowEvidence,
   withTaskEvidenceTransaction,
   writeWorkflowWalFile
-} from "./index-snd34n1y.js";
+} from "./index-gtej1br8.js";
 import {
   isPathUnderSwarmWorktreeBase,
   listLiveLaneOwners,
@@ -266,7 +266,7 @@ import {
   recordLiveLaneOwner,
   removeWorktree,
   resolveWorktreeBaseDir
-} from "./index-e4g3487s.js";
+} from "./index-zpygn1tn.js";
 import {
   DEFAULT_STALE_DELEGATION_TIMEOUT_MS,
   DELEGATION_COMPACTION_HIGH_WATER_BYTES,
@@ -300,7 +300,7 @@ import {
   scanBackgroundCoderReservationsForAdmission,
   scanDelegationsForRecovery,
   sweepStaleDelegations
-} from "./index-saw0ambb.js";
+} from "./index-yk3es7m2.js";
 import {
   MAX_EVENT_LOG_ENTRIES,
   _internals,
@@ -316,7 +316,7 @@ import {
   recordKnowledgeEvent,
   recordPhaseCloseIntent,
   resolveKnowledgeEventsPath
-} from "./index-9gpf4tt4.js";
+} from "./index-8bbhh3kx.js";
 import {
   estimateTokens,
   readSwarmFileAsync,
@@ -342,18 +342,18 @@ import {
   validateActionableFields,
   validateLesson,
   validateSkillPath
-} from "./index-s6wb6sjk.js";
+} from "./index-ddvva9fn.js";
 import {
   MAX_CURATION_PROPOSALS,
   authorizeCuration,
   buildConfigFingerprintInput
-} from "./index-cw1nbtvh.js";
+} from "./index-2dv07mw2.js";
 import {
   cohortConfigFingerprint
 } from "./index-rtry5xyf.js";
 import {
   resolveWorktreeIsolationConfig
-} from "./index-0c7y177k.js";
+} from "./index-zz40vfbz.js";
 import {
   RetrospectiveEvidenceSchema
 } from "./index-frcemc0b.js";
@@ -364,7 +364,7 @@ import {
   clearScopeBindingFromDisk,
   clearScopeBindings,
   readScopeFromDisk
-} from "./index-nxnmy2da.js";
+} from "./index-bmk77mpq.js";
 import {
   clearPlanLedgerForReset,
   computePlanStructureHash,
@@ -380,7 +380,7 @@ import {
   replayFromLedgerWithStatus,
   resolvePlanningProfile,
   takeSnapshotEvent
-} from "./index-hkx8tqa4.js";
+} from "./index-j1yd2gbz.js";
 import {
   CORE_EVENT_LOCKED,
   appendCoreEventSync,
@@ -390,7 +390,7 @@ import {
   hasSpecDriftAuditEvent,
   hasTaskRepairAuditEvent,
   readCoreEvents
-} from "./index-rjjtn1w5.js";
+} from "./index-96hz14wr.js";
 import {
   DEFAULT_QA_GATES,
   computeProfileHash,
@@ -433,7 +433,7 @@ import {
   observeCuratorCompliance,
   observeStoreHealth,
   readLearningHealth
-} from "./index-mjtja1wq.js";
+} from "./index-cpgh76bk.js";
 import {
   appendKnowledge,
   appendRejectedLesson,
@@ -463,7 +463,7 @@ import {
   transactFile,
   transactKnowledge,
   wordBigrams
-} from "./index-py58gern.js";
+} from "./index-d0wq7paf.js";
 import {
   readTailJsonl,
   readTailJsonlDetailed,
@@ -484,7 +484,7 @@ import {
   resolveLinkDir,
   sanitizeLinkId,
   writeLinkPointer
-} from "./index-6v1cz898.js";
+} from "./index-vqjkr1kd.js";
 import {
   assertProjectRoot,
   atomicWriteFile,
@@ -493,7 +493,7 @@ import {
   listActiveLocks,
   tryAcquireLock,
   withEvidenceLock
-} from "./index-vsvdh976.js";
+} from "./index-jgkva4r4.js";
 import {
   require_proper_lockfile
 } from "./index-7g4c7s5r.js";
@@ -507,7 +507,7 @@ import {
   pseudonymousRef,
   resolveLineageSalt,
   telemetry
-} from "./index-5prgmf00.js";
+} from "./index-qz6ee73z.js";
 import {
   atomicWriteSwarmFile,
   atomicWriteSwarmFileSync,
@@ -532,7 +532,7 @@ import {
   loadGateOverrides,
   loadPluginConfig,
   loadPluginConfigWithMeta
-} from "./index-ddz0a0ew.js";
+} from "./index-20q20gpd.js";
 import {
   init_git_executable,
   resolveGitExecutable,
@@ -561,7 +561,7 @@ import {
   resolveAutoReviewConfig,
   resolveGeneratedAgentRole,
   stripKnownSwarmPrefix
-} from "./index-kyakvkpk.js";
+} from "./index-mat5rawf.js";
 import {
   AGENT_TOOL_MAP,
   ALL_AGENT_NAMES,
@@ -3175,7 +3175,7 @@ async function importLegacyPrWorkflowGateStateIfNeeded(directory, sessionID, all
       return null;
     throw error2;
   }
-  const legacy = allowSalvagedImport ? (await (await import("./pr-workflow-gate-sc4c4cmk.js")).readPrWorkflowGateStateForRecovery(directory, sessionID))?.state ?? null : await readPrWorkflowGateStateFileFromDisk(filePath, sessionID);
+  const legacy = allowSalvagedImport ? (await (await import("./pr-workflow-gate-kb3e709n.js")).readPrWorkflowGateStateForRecovery(directory, sessionID))?.state ?? null : await readPrWorkflowGateStateFileFromDisk(filePath, sessionID);
   if (!legacy)
     return null;
   const namespace = workflowGateStateCoordinationNamespace(sessionID);
@@ -3245,7 +3245,7 @@ async function deleteStateWhileLocked(directory, sessionID, options = {}) {
   let recoveryState = null;
   if (!currentAuthoritative) {
     if (options.allowSalvagedRead) {
-      const { readPrWorkflowGateStateForRecovery } = await import("./pr-workflow-gate-sc4c4cmk.js");
+      const { readPrWorkflowGateStateForRecovery } = await import("./pr-workflow-gate-kb3e709n.js");
       recoveryState = (await readPrWorkflowGateStateForRecovery(directory, normalizedSessionID))?.state ?? null;
     }
     if (!recoveryState) {
@@ -14210,7 +14210,7 @@ function isLaneOwnedByCurrentSession(branchName, expectedSessionId) {
   return extracted === expectedSessionId;
 }
 async function inspectStandardWorktreeCollisionOwnership(identity) {
-  const collisionOwnership = await import("./worktree-collision-ownership-cfx1tsaf.js");
+  const collisionOwnership = await import("./worktree-collision-ownership-ajagwzh8.js");
   return collisionOwnership.inspectStandardWorktreeCollisionOwnership(identity);
 }
 async function runRecoveryGit(directory, args, timeoutMs = 15000) {
@@ -14636,7 +14636,7 @@ async function precreateStandardWorktreeSession(args) {
   const laneProfile = computeLaneRuntimeProfile(worktreeConfig.runtime_isolation, laneIndex, handle.worktreePath);
   if (laneProfile) {
     try {
-      const { writeLaneProfileToDiskReal } = await import("./core-421gbna2.js");
+      const { writeLaneProfileToDiskReal } = await import("./core-jar8cmzf.js");
       await writeLaneProfileToDiskReal(handle.worktreePath, laneProfile.laneIndex, laneProfile.envOverrides);
     } catch {}
   }
@@ -15615,7 +15615,7 @@ async function finishStandardWorktreeDispatch(directory, dispatch, config, callI
       }
       clearWorktreeMergeStatus(statusKey);
       try {
-        const { removeLaneProfileFromDiskReal } = await import("./core-421gbna2.js");
+        const { removeLaneProfileFromDiskReal } = await import("./core-jar8cmzf.js");
         await removeLaneProfileFromDiskReal(dispatch.handle.worktreePath, dispatch.laneIndex);
       } catch {}
       const state = serializationStateBySessionID.get(dispatch.parentSessionID);
@@ -22232,7 +22232,7 @@ function getDisplayFinalPromptPressure() {
 async function rehydratePrSubscriptions(sessionID, directory) {
   const map = new Map;
   try {
-    const { listActive: listActive2 } = await import("./pr-subscriptions-yceed093.js");
+    const { listActive: listActive2 } = await import("./pr-subscriptions-8g6w41vz.js");
     const records = await listActive2(directory);
     for (const record of records) {
       if (record.sessionID !== sessionID)
@@ -22772,6 +22772,12 @@ async function readPrWorkflowGateState(directory, sessionID) {
   }
   return state;
 }
+function isLivenessTerminalLaneRecord(record) {
+  if (record.status !== "cancelled" && record.status !== "stale" && record.status !== "error") {
+    return false;
+  }
+  return record.terminalResult?.result.workflowLaneFailureClass === "liveness" || record.result?.workflowLaneFailureClass === "liveness";
+}
 async function submitPrReviewResult(directory, childSessionId, input) {
   const child = childSessionId.trim();
   const parsedResult = PrReviewLaneResultEnvelopeSchema.safeParse(input.result);
@@ -22789,14 +22795,26 @@ async function submitPrReviewResult(directory, childSessionId, input) {
     };
   }
   const preliminary = childRead.records.filter((record2) => record2.subagentSessionId === child && record2.correlationId === child && (record2.mode === "swarm-pr-review:base" || record2.mode === "swarm-pr-review:micro"));
+  let repairRecord = null;
   if (preliminary.length !== 1) {
-    return {
-      status: "rejected",
-      reason: `expected one exact child delegation, found ${preliminary.length}`
-    };
+    const repairCandidates = childRead.records.filter((candidate) => candidate.parentSessionId === child && (candidate.mode === "swarm-pr-review:base" || candidate.mode === "swarm-pr-review:micro") && (input.batchId === undefined || input.batchId === candidate.batchId) && (input.laneId === undefined || input.laneId === candidate.laneId) && isLivenessTerminalLaneRecord(candidate));
+    if (repairCandidates.length !== 1) {
+      return {
+        status: "rejected",
+        reason: `expected one exact child delegation, found ${preliminary.length}`
+      };
+    }
+    repairRecord = repairCandidates[0];
+    if (parsedResult.data.outcome !== "INCOMPLETE") {
+      return {
+        status: "rejected",
+        reason: "architect-parent repair may only record an unresolved-terminal (INCOMPLETE) outcome"
+      };
+    }
   }
-  const parentSessionId = preliminary[0].parentSessionId;
-  const record = preliminary[0];
+  const parentSessionId = (repairRecord ?? preliminary[0]).parentSessionId;
+  const record = repairRecord ?? preliminary[0];
+  const childOfRecord = record.subagentSessionId;
   if (!record.batchId || !record.laneId) {
     return {
       status: "rejected",
@@ -22834,6 +22852,12 @@ async function submitPrReviewResult(directory, childSessionId, input) {
     if (dispatchWorkflowInstanceId !== state.workflowInstanceId) {
       return { status: "rejected", reason: "stale workflow instance binding" };
     }
+    if (repairRecord && dispatchWorkflowRevision !== state.revision) {
+      return {
+        status: "rejected",
+        reason: `superseded workflow generation binding (delegation generation ${dispatchWorkflowRevision}, active generation ${state.revision})`
+      };
+    }
     if (record.mode !== "swarm-pr-review:base" && record.mode !== "swarm-pr-review:micro" || !sameProjectRoot(record.workspace?.directory ?? "", directory)) {
       return {
         status: "rejected",
@@ -22853,7 +22877,8 @@ async function submitPrReviewResult(directory, childSessionId, input) {
       generation: state.revision,
       semanticEnvelopeDigest,
       outcome: parsedResult.data.outcome,
-      ...existingReceiptDigest !== undefined ? { existingReceiptDigest } : {}
+      ...existingReceiptDigest !== undefined ? { existingReceiptDigest } : {},
+      ...repairRecord ? { submittedBy: "workflow_parent" } : {}
     });
     if (submission.status === "rejected") {
       return {
@@ -22863,12 +22888,13 @@ async function submitPrReviewResult(directory, childSessionId, input) {
     }
     const published = await publishPrReviewResultReceipt(directory, {
       parentSessionId,
-      childSessionId: child,
+      childSessionId: childOfRecord,
       batchId,
       laneId,
       expectedWorkflowInstanceId: state.workflowInstanceId,
       expectedWorkflowRevision: dispatchWorkflowRevision,
       expectedBaseSha: state.prReviewBaseSha,
+      ...repairRecord ? { parentRepair: true } : {},
       receipt: {
         schemaVersion: 1,
         mode: record.mode,
@@ -22881,10 +22907,15 @@ async function submitPrReviewResult(directory, childSessionId, input) {
         baseSha: state.prReviewBaseSha,
         headSha: state.prHeadSha,
         dispatchRevisionDigest: input.revisionDigest,
-        childSessionId: child,
+        childSessionId: childOfRecord,
         generation: record.generation ?? 1,
         semanticEnvelopeDigest,
-        envelope: parsedResult.data
+        envelope: parsedResult.data,
+        ...repairRecord ? {
+          submittedBy: "workflow_parent",
+          submittedByParentSessionId: parentSessionId,
+          laneTerminalStateAtSubmission: record.status
+        } : {}
       }
     });
     if (published.status === "recorded" || published.status === "duplicate") {
@@ -39076,9 +39107,9 @@ function hashContent(content) {
   return createHash24("sha1").update(content).digest("hex");
 }
 async function loadConfigForPolicyCurator(directory) {
-  const { KnowledgeConfigSchema: KnowledgeConfigSchema2 } = await import("./schema-x2nb18fg.js");
+  const { KnowledgeConfigSchema: KnowledgeConfigSchema2 } = await import("./schema-kts10txe.js");
   try {
-    const { loadPluginConfigWithMeta: loadPluginConfigWithMeta2 } = await import("./index-m8c44754.js");
+    const { loadPluginConfigWithMeta: loadPluginConfigWithMeta2 } = await import("./index-nr96hbpy.js");
     const { config: loadedConfig } = loadPluginConfigWithMeta2(directory);
     return KnowledgeConfigSchema2.parse(loadedConfig.knowledge ?? {});
   } catch {
@@ -42136,7 +42167,7 @@ async function resolveCuratorLLMDelegate(directory, mode, sessionId) {
   const seam = _internals36.createCuratorLLMDelegate;
   if (seam)
     return seam(directory, mode, sessionId);
-  const { createCuratorLLMDelegate } = await import("./curator-llm-factory-4e73613g.js");
+  const { createCuratorLLMDelegate } = await import("./curator-llm-factory-rc7cqtx8.js");
   return createCuratorLLMDelegate(directory, mode, sessionId);
 }
 async function reconcileCloseTerminalStateForPlan(directory, targetPlan, options) {
@@ -42531,7 +42562,7 @@ async function runFinalizeStage(ctx) {
     }
   }
   try {
-    const { CuratorConfigSchema: CCS } = await import("./schema-x2nb18fg.js");
+    const { CuratorConfigSchema: CCS } = await import("./schema-kts10txe.js");
     const { config: pmLoadedConfig } = _internals36.loadPluginConfigWithMeta(ctx.directory);
     const curatorCfg = CCS.parse(pmLoadedConfig.curator ?? {});
     if (curatorCfg.enabled && curatorCfg.postmortem_enabled) {
@@ -44375,7 +44406,7 @@ function serializeAgentSession(s) {
 }
 async function writeSnapshot(directory, state) {
   try {
-    const { ensureSnapshotCoordinationReady } = await import("./snapshot-coordination-init-8x5n1q8c.js");
+    const { ensureSnapshotCoordinationReady } = await import("./snapshot-coordination-init-bw9mn21x.js");
     await ensureSnapshotCoordinationReady(directory);
     const snapshot = {
       version: 3,
@@ -47301,7 +47332,7 @@ function planMerges(active, threshold, maxComparisons, maxMerges) {
   };
 }
 async function sweepActiveNearDuplicates(directory, options = {}) {
-  const { loadPluginConfigWithMeta: loadPluginConfigWithMeta2 } = await import("./index-m8c44754.js");
+  const { loadPluginConfigWithMeta: loadPluginConfigWithMeta2 } = await import("./index-nr96hbpy.js");
   const { config } = loadPluginConfigWithMeta2(directory);
   const sweepConfig = config.learning?.dedup_sweep;
   if (sweepConfig?.enabled === false)
@@ -48425,7 +48456,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-vz5vtgk6.js");
+        const skillModule = await import("./skill-generator-7q75h2kr.js");
         for (const cand of skillCandidates) {
           if (cand.confidence < (config.min_skill_confidence ?? DEFAULT_SKILL_MIN_CONFIDENCE)) {
             continue;
@@ -48897,7 +48928,7 @@ async function applyCuratorKnowledgeUpdates(directory, recommendations, knowledg
     } catch {}
   }
   if (contradictedEntries.length > 0 && knowledgeConfig.contradiction_threshold_action === "quarantine") {
-    const { maybeQuarantineOnContradiction } = await import("./knowledge-escalator-bra0fkfm.js");
+    const { maybeQuarantineOnContradiction } = await import("./knowledge-escalator-2zjpwg0q.js");
     for (const { id } of contradictedEntries) {
       try {
         await maybeQuarantineOnContradiction(directory, id, knowledgeConfig.contradiction_quarantine_threshold, knowledgeConfig.contradiction_quarantine_window_days);
@@ -49729,7 +49760,7 @@ async function runCuratorPostMortem(directory, options = {}) {
       warnings.push("Failed to collect knowledge summary.");
     }
     try {
-      const { getScanStatus } = await import("./scan-cursor-mtja4626.js");
+      const { getScanStatus } = await import("./scan-cursor-erm49azh.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.`);
@@ -49901,9 +49932,9 @@ var _internals53 = {
   verifyPostMortemKnowledgeActions,
   repairPostMortemActions,
   loadDefaultKnowledgeConfig: async (directory) => {
-    const { KnowledgeConfigSchema: KnowledgeConfigSchema2 } = await import("./schema-x2nb18fg.js");
+    const { KnowledgeConfigSchema: KnowledgeConfigSchema2 } = await import("./schema-kts10txe.js");
     try {
-      const { loadPluginConfigWithMeta: loadPluginConfigWithMeta2 } = await import("./index-m8c44754.js");
+      const { loadPluginConfigWithMeta: loadPluginConfigWithMeta2 } = await import("./index-nr96hbpy.js");
       const loaded = loadPluginConfigWithMeta2(directory);
       return KnowledgeConfigSchema2.parse(loaded.config.knowledge ?? {});
     } catch {
@@ -49911,11 +49942,11 @@ var _internals53 = {
     }
   },
   applyCuratorKnowledgeUpdates: async (directory, recommendations, knowledgeConfig, generation) => {
-    const { applyCuratorKnowledgeUpdates: applyCuratorKnowledgeUpdates2 } = await import("./curator-yrhc4epa.js");
+    const { applyCuratorKnowledgeUpdates: applyCuratorKnowledgeUpdates2 } = await import("./curator-3xfz7wdp.js");
     return applyCuratorKnowledgeUpdates2(directory, recommendations, knowledgeConfig, generation);
   },
   checkHivePromotions: async (entries2, knowledgeConfig, directory) => {
-    const { checkHivePromotions } = await import("./hive-promoter-6s6xbq5x.js");
+    const { checkHivePromotions } = await import("./hive-promoter-xfbabpnm.js");
     return checkHivePromotions(entries2, knowledgeConfig, directory);
   },
   applyProposalTriage: async (directory, triage) => {
@@ -49924,7 +49955,7 @@ var _internals53 = {
       activateProposal,
       listSkills: listSkills2,
       sanitizeSlug
-    } = await import("./skill-generator-vz5vtgk6.js");
+    } = await import("./skill-generator-7q75h2kr.js");
     const result = {
       approved: [],
       rejected: [],
@@ -58410,7 +58441,7 @@ function wireCloseInternals() {
     archiveEvidence,
     endAgentSession,
     flushAndDrainTelemetry: async () => {
-      const { flushAndDrainTelemetry } = await import("./telemetry-m580862y.js");
+      const { flushAndDrainTelemetry } = await import("./telemetry-7bk8ps5p.js");
       return flushAndDrainTelemetry();
     },
     finalizeContextTelemetry,
@@ -59762,9 +59793,9 @@ var _internals63 = {
   loadPluginConfigWithMeta,
   loadCuratorDeps: async () => {
     const [{ CuratorConfigSchema }, curator, { createCuratorLLMDelegate }] = await Promise.all([
-      import("./schema-x2nb18fg.js"),
-      import("./curator-yrhc4epa.js"),
-      import("./curator-llm-factory-4e73613g.js")
+      import("./schema-kts10txe.js"),
+      import("./curator-3xfz7wdp.js"),
+      import("./curator-llm-factory-rc7cqtx8.js")
     ]);
     return { CuratorConfigSchema, curator, createCuratorLLMDelegate };
   }
@@ -61321,6 +61352,349 @@ init_executor();
 init_path_identity();
 init_git_executable();
 
+// src/workflow/recovery-invocation.ts
+var RECOVERY_RUNBOOK_DOC_PATH = "docs/troubleshooting/recovery-runbook.md";
+var RECOVERY_INVOCATIONS = [
+  {
+    surface: "host",
+    invocation: "/swarm recover <task_id>",
+    note: "Host command path \u2014 type it verbatim in the OpenCode TUI/GUI command line."
+  },
+  {
+    surface: "powershell",
+    invocation: "opencode run --dir <project-dir> '/swarm recover <task_id>'",
+    note: "PowerShell headless \u2014 single quotes keep the /swarm message argument literal."
+  },
+  {
+    surface: "git-bash",
+    invocation: 'opencode run --dir <project-dir> "//swarm recover <task_id>"',
+    note: "Git Bash (MSYS) headless \u2014 the leading slash is doubled because MSYS rewrites a single leading-slash argument to C:/Program Files/Git/swarm \u2026; do NOT set MSYS_NO_PATHCONV=1 globally (it breaks --dir /c/... conversion)."
+  },
+  {
+    surface: "cli",
+    invocation: "bunx opencode-swarm run recover <task_id> [--force]",
+    note: "Shell-neutral CLI \u2014 same command in every shell; --force is an operator assertion that no dispatch is genuinely in flight."
+  }
+];
+function renderRecoveryInvocationQuickForms(docPath = RECOVERY_RUNBOOK_DOC_PATH) {
+  const labels = {
+    host: "host command path",
+    powershell: "PowerShell headless",
+    "git-bash": "Git Bash (MSYS) headless",
+    cli: "shell-neutral CLI"
+  };
+  const notes = {
+    host: "",
+    powershell: "",
+    "git-bash": " (leading slash doubled \u2014 MSYS rewrites a single leading slash; never set MSYS_NO_PATHCONV=1 for the whole invocation)",
+    cli: ""
+  };
+  return [
+    `Shell-correct invocations (see ${docPath}):`,
+    ...RECOVERY_INVOCATIONS.map((form) => `- ${labels[form.surface]}: ${form.invocation}${notes[form.surface]}`)
+  ].join(`
+`);
+}
+
+// src/workflow/stage-a-repair.ts
+import { readdir as readdir5 } from "fs/promises";
+init_path_identity();
+init_logger();
+
+// src/workflow/task-recovery-status.ts
+init_path_identity();
+function identitySuffix(status) {
+  const parts = [];
+  if (status.transitionId)
+    parts.push(`transition ${sanitizeDiagnosticText(status.transitionId)}`);
+  if (typeof status.generation === "number")
+    parts.push(`generation ${status.generation}`);
+  return parts.length > 0 ? ` (${parts.join(", ")})` : "";
+}
+function classifySettlementWalState(entry, workflow) {
+  const base = {
+    taskId: entry.taskId,
+    transitionId: entry.transitionId,
+    generation: entry.expectedGeneration ?? (workflow && workflow.authoritative ? workflow.generation : undefined)
+  };
+  if (entry.state === "unreadable") {
+    return {
+      ...base,
+      category: "corrupt",
+      repairAllowed: false,
+      uncertainExternalEffect: true,
+      explanation: "settlement WAL is corrupt (unreadable bytes) \u2014 recovery refuses corrupt facts instead of rewriting them; the task stays blocked until a human reconciles the file",
+      suggestedNextCommand: "inspect .swarm/coder-settlements/" + entry.taskId + ".json and consult docs/troubleshooting/recovery-runbook.md \u2014 do not delete or hand-edit the file"
+    };
+  }
+  if (entry.ownedByLiveForeignPid) {
+    return {
+      ...base,
+      category: "ambiguous",
+      repairAllowed: false,
+      uncertainExternalEffect: true,
+      explanation: `owned by live foreign process pid ${entry.processId ?? "?"} (another OpenCode instance) \u2014 the dispatch may genuinely be in flight, so this host never interrupts it and the external effect stays uncertain`,
+      suggestedNextCommand: `close that instance (or run /swarm recover ${entry.taskId} there), then re-run diagnose here`
+    };
+  }
+  if (entry.ownedInProcess) {
+    return {
+      ...base,
+      category: "ambiguous",
+      repairAllowed: false,
+      uncertainExternalEffect: true,
+      explanation: "in flight, in this process \u2014 the dispatch may still complete on its own; releasing it is an operator assertion, not a status claim",
+      suggestedNextCommand: `wait for the dispatch to settle, or re-run /swarm recover ${entry.taskId} --force only if no coder is genuinely running`
+    };
+  }
+  if (entry.state === "DISPATCHED" || entry.state === "PREPARED") {
+    const generationConflict = typeof entry.expectedGeneration === "number" && workflow !== null && workflow.authoritative && workflow.generation !== entry.expectedGeneration;
+    return {
+      ...base,
+      category: "stale",
+      repairAllowed: true,
+      uncertainExternalEffect: false,
+      explanation: `${entry.state.toLowerCase()} settlement whose owning process is gone${generationConflict ? ` \u2014 the WAL's generation fence (${entry.expectedGeneration}) no longer matches the workflow generation (${workflow?.generation}), so the stale receipt cannot be consumed by a normal settle and recovery is the only deterministic path` : ""} \u2014 blocks dispatches with CODER_DISPATCH_IN_PROGRESS`,
+      suggestedNextCommand: `/swarm recover ${entry.taskId}`
+    };
+  }
+  return {
+    ...base,
+    category: "healthy",
+    repairAllowed: false,
+    uncertainExternalEffect: false,
+    explanation: `settlement ${entry.state.toLowerCase()}`,
+    suggestedNextCommand: ""
+  };
+}
+function classifyEvidenceRecoveryTask(taskId, evidence2, greenPreCheck) {
+  const snapshot = evidence2?.workflow !== undefined && evidence2.workflow !== null ? { ...evidence2.workflow, authoritative: true } : null;
+  if (snapshot === null) {
+    return {
+      taskId,
+      category: "missing",
+      repairAllowed: false,
+      uncertainExternalEffect: false,
+      explanation: "no durable receipt exists for this task (no settlement WAL, no evidence workflow) \u2014 nothing to repair",
+      suggestedNextCommand: "dispatch the task normally, then re-run diagnose; if it was dispatched, see docs/troubleshooting/recovery-runbook.md"
+    };
+  }
+  const base = {
+    taskId,
+    transitionId: snapshot.lastTransitionId ?? undefined,
+    generation: snapshot.generation
+  };
+  if (snapshot.state === "coder_delegated") {
+    const hasPreCheckProof = evidence2?.gates?.pre_check !== undefined;
+    if (!hasPreCheckProof) {
+      return {
+        ...base,
+        category: "live_wedge",
+        repairAllowed: greenPreCheck === true,
+        uncertainExternalEffect: false,
+        explanation: `live-shaped task wedge \u2014 workflow at coder_delegated with no pre_check gate proof${greenPreCheck === true ? " and green post-settlement pre-check bundles: the missing Stage A receipt is deterministically repairable without re-running the coder or editing evidence" : greenPreCheck === false ? " but pre-check proof is missing or not green: run pre_check_batch first \u2014 the repair refuses to mark Stage A passed without proof" : ""}`,
+        suggestedNextCommand: `/swarm recover ${taskId}`
+      };
+    }
+  }
+  return {
+    ...base,
+    category: "healthy",
+    repairAllowed: false,
+    uncertainExternalEffect: false,
+    explanation: `workflow ${snapshot.state}`,
+    suggestedNextCommand: ""
+  };
+}
+function renderTaskRecoveryLine(status) {
+  if (status.category === "healthy")
+    return "";
+  const suffix = identitySuffix(status);
+  const command = status.suggestedNextCommand ? ` \u2014 ${status.suggestedNextCommand}` : "";
+  return `task ${status.taskId} [${status.category}] ${status.explanation}${suffix}${command}`;
+}
+
+// src/workflow/stage-a-repair.ts
+var MAX_STAGE_A_REPAIR_SCAN = 200;
+async function appendStageARepairEvent(directory, payload) {
+  try {
+    appendCoreEventSync(directory, {
+      type: "stage_a_repair",
+      timestamp: new Date().toISOString(),
+      ...payload
+    });
+  } catch (error2) {
+    criticalWarn(`[stage-a-repair] audit event write failed: ${error2 instanceof Error ? error2.message : String(error2)}`);
+  }
+}
+async function hasGreenPostSettlementPreCheck(directory, settledAfterMs) {
+  let sawSecretscanGreen = false;
+  let sawSastGreen = false;
+  for (const evidenceType of ["secretscan", "sast_scan"]) {
+    let result;
+    try {
+      result = await loadEvidence(directory, evidenceType, { migrate: false });
+    } catch {
+      continue;
+    }
+    if (result.status !== "found")
+      continue;
+    const entryTypeTag = evidenceType === "sast_scan" ? "sast" : evidenceType;
+    const typed = result.bundle.entries.filter((entry) => entry.type === entryTypeTag);
+    if (typed.length === 0)
+      continue;
+    const last = typed[typed.length - 1];
+    const ts = Date.parse(String(last.timestamp ?? ""));
+    if (settledAfterMs !== null && Number.isFinite(ts) && ts < settledAfterMs) {
+      return { green: false, reason: "pre_check_failed_or_stale" };
+    }
+    if (evidenceType === "secretscan") {
+      if ((last.verdict === "pass" || last.verdict === "approved" || last.verdict === "info") && isSecretscanEvidence(last) && (last.incomplete_files ?? 0) === 0 && (last.files_scanned ?? 0) > 0 && (last.findings_count ?? 0) === 0) {
+        sawSecretscanGreen = true;
+        continue;
+      }
+    } else if (last.verdict === "pass" || last.verdict === "approved" || last.verdict === "info") {
+      sawSastGreen = true;
+      continue;
+    }
+    if (last.verdict === "fail" || last.verdict === "rejected") {
+      return { green: false, reason: "pre_check_failed_or_stale" };
+    }
+  }
+  if (!sawSecretscanGreen || !sawSastGreen) {
+    return { green: false, reason: "no_pre_check_bundles" };
+  }
+  return { green: true };
+}
+async function enumerateStageACandidates(directory, requested) {
+  let entries2;
+  try {
+    const evidenceDir = validateSwarmPath(directory, "evidence");
+    entries2 = await readdir5(evidenceDir);
+  } catch {
+    return { selected: [], truncated: false };
+  }
+  const candidates = entries2.filter((entry) => entry.endsWith(".json") && isStrictTaskId(entry.slice(0, -".json".length)));
+  const selected = requested?.length ? candidates.filter((entry) => requested.includes(entry.slice(0, -".json".length))) : candidates;
+  const truncated = !requested?.length && candidates.length > MAX_STAGE_A_REPAIR_SCAN;
+  return {
+    selected: selected.sort().slice(0, MAX_STAGE_A_REPAIR_SCAN).map((entry) => entry.slice(0, -".json".length)),
+    truncated
+  };
+}
+async function scanStageATask(directory, taskId, walStates) {
+  const evidence2 = await readTaskEvidence(directory, taskId);
+  const workflow = getTaskWorkflowSnapshot(evidence2);
+  if (workflow.state !== "coder_delegated") {
+    return { kind: "not_wedged", state: workflow.state, evidence: evidence2 };
+  }
+  if (evidence2?.gates?.pre_check) {
+    return { kind: "not_wedged", state: workflow.state, evidence: evidence2 };
+  }
+  let settledAfterMs = null;
+  for (const state of walStates) {
+    if (state.taskId !== taskId)
+      continue;
+    if (state.state !== "COMMITTED")
+      continue;
+    if (state.recordedAt === undefined)
+      continue;
+    const parsed = Date.parse(state.recordedAt);
+    if (!Number.isFinite(parsed))
+      continue;
+    settledAfterMs = settledAfterMs === null ? parsed : Math.max(settledAfterMs, parsed);
+  }
+  if (settledAfterMs === null) {
+    const fallbackTs = Date.parse(workflow.updatedAt);
+    if (Number.isFinite(fallbackTs))
+      settledAfterMs = fallbackTs;
+  }
+  const greenness = await hasGreenPostSettlementPreCheck(directory, settledAfterMs);
+  if (!greenness.green) {
+    return { kind: "not_green", reason: greenness.reason, evidence: evidence2 };
+  }
+  return {
+    kind: "repairable",
+    generation: workflow.generation,
+    green: true,
+    predecessorTransitionId: workflow.lastTransitionId ?? null,
+    evidence: evidence2
+  };
+}
+async function scanWedgedStageA(directory, options) {
+  const { selected, truncated } = await enumerateStageACandidates(directory, options?.taskIds);
+  const { states: walStates } = await listCoderSettlementWalStates(directory);
+  const results = [];
+  for (const taskId of selected) {
+    try {
+      const verdict = await scanStageATask(directory, taskId, walStates);
+      if (verdict.kind === "repairable") {
+        results.push(classifyEvidenceRecoveryTask(taskId, verdict.evidence, verdict.green));
+      } else if (verdict.kind === "not_green") {
+        results.push(classifyEvidenceRecoveryTask(taskId, verdict.evidence, false));
+      } else {
+        results.push(classifyEvidenceRecoveryTask(taskId, verdict.evidence, null));
+      }
+    } catch {}
+  }
+  return { results, truncated };
+}
+async function repairWedgedStageA(directory, options) {
+  const requested = options?.taskIds;
+  const { selected, truncated } = await enumerateStageACandidates(directory, requested);
+  const { states: walStates } = await listCoderSettlementWalStates(directory);
+  const results = [];
+  for (const taskId of selected) {
+    try {
+      const scan = await scanStageATask(directory, taskId, walStates);
+      if (scan.kind === "not_wedged") {
+        results.push({
+          taskId,
+          outcome: "skipped_not_wedged",
+          state: scan.state
+        });
+        continue;
+      }
+      if (scan.kind === "not_green") {
+        results.push({
+          taskId,
+          outcome: "skipped_not_green",
+          reason: scan.reason
+        });
+        continue;
+      }
+      const transitionId = `stage-a-repair:${taskId}:${scan.generation}`;
+      await transitionTaskWorkflowEvidence(directory, taskId, {
+        type: "stage_a_passed",
+        expectedGeneration: scan.generation,
+        transitionId
+      });
+      await appendStageARepairEvent(directory, {
+        action: "repaired",
+        taskId,
+        transitionId,
+        generation: scan.generation,
+        predecessorTransitionId: scan.predecessorTransitionId
+      });
+      results.push({
+        taskId,
+        outcome: "repaired",
+        generation: scan.generation,
+        transitionId
+      });
+    } catch (error2) {
+      const message = error2 instanceof Error ? error2.message : String(error2);
+      await appendStageARepairEvent(directory, {
+        action: "repair-failed",
+        taskId,
+        message: sanitizeDiagnosticText(message, 512)
+      });
+      results.push({ taskId, outcome: "error", message });
+    }
+  }
+  return { results, truncated };
+}
+
 // src/services/knowledge-diagnostics.ts
 init_package();
 import { existsSync as existsSync44, readFileSync as readFileSync34 } from "fs";
@@ -61673,7 +62047,7 @@ async function computeCurationDiagnostics(directory, entries2) {
   let scanCompleted = false;
   let scanRemaining = 0;
   try {
-    const { getScanStatus } = await import("./scan-cursor-mtja4626.js");
+    const { getScanStatus } = await import("./scan-cursor-erm49azh.js");
     const status = await getScanStatus(directory);
     scanGeneration = status.generation;
     scanCompleted = status.completed;
@@ -61681,19 +62055,19 @@ async function computeCurationDiagnostics(directory, entries2) {
   } catch {}
   let configMatch = null;
   try {
-    const { isLinked: isLinked2 } = await import("./knowledge-link-dw12x2ns.js");
+    const { isLinked: isLinked2 } = await import("./knowledge-link-s77cyqxk.js");
     if (isLinked2(directory)) {
-      const { KnowledgeConfigSchema: KnowledgeConfigSchema2 } = await import("./schema-x2nb18fg.js");
+      const { KnowledgeConfigSchema: KnowledgeConfigSchema2 } = await import("./schema-kts10txe.js");
       let config;
       try {
-        const { loadPluginConfigWithMeta: loadPluginConfigWithMeta2 } = await import("./index-m8c44754.js");
+        const { loadPluginConfigWithMeta: loadPluginConfigWithMeta2 } = await import("./index-nr96hbpy.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-dw25zm05.js");
+      const { buildConfigFingerprintInput: buildConfigFingerprintInput2, readCohortConfigFingerprint } = await import("./curation-policy-e5p147bb.js");
       const currentFp = cohortConfigFingerprint2(buildConfigFingerprintInput2(config));
       const cohortFp = await readCohortConfigFingerprint(directory);
       configMatch = cohortFp === null ? null : currentFp === cohortFp;
@@ -62668,34 +63042,59 @@ async function getDiagnoseData(directory, sessionID) {
   try {
     const { states: settlementStates, truncated } = await listCoderSettlementWalStates(directory);
     const truncationNote = truncated ? " MORE settlement WALs exist than the scan cap (200) \u2014 older ones are not shown." : "";
-    if (settlementStates.length === 0) {
+    const settlementStatuses = [];
+    for (const entry of settlementStates) {
+      let workflow = null;
+      try {
+        workflow = getTaskWorkflowSnapshot(await readTaskEvidence(directory, entry.taskId));
+      } catch {
+        workflow = null;
+      }
+      settlementStatuses.push(classifySettlementWalState(entry, workflow));
+    }
+    const wedgeScan = await scanWedgedStageA(directory);
+    const wedgeStatuses = wedgeScan.results.filter((status) => status.category === "live_wedge");
+    const knownTaskIds = new Set([
+      ...settlementStates.map((entry) => entry.taskId),
+      ...wedgeScan.results.map((status) => status.taskId)
+    ]);
+    const missingStatuses = [];
+    if (!truncated && !wedgeScan.truncated) {
+      const planTaskIds = (plan?.phases ?? []).flatMap((phase) => phase.tasks.map((task) => task.id)).slice(0, 200);
+      for (const taskId of planTaskIds) {
+        if (knownTaskIds.has(taskId))
+          continue;
+        missingStatuses.push(classifyEvidenceRecoveryTask(taskId, null, null));
+      }
+    }
+    const nonHealthy = [
+      ...settlementStatuses.filter((s) => s.category !== "healthy"),
+      ...wedgeStatuses
+    ];
+    const missingLines = missingStatuses.map(renderTaskRecoveryLine).filter(Boolean);
+    const healthyCount = settlementStatuses.filter((s) => s.category === "healthy").length;
+    if (nonHealthy.length === 0 && !truncated) {
       checks.push({
         name: "Coder Settlements",
-        status: truncated ? "\u26A0\uFE0F" : "\u2705",
-        detail: truncated ? `Settlement WAL scan truncated at 200 \u2014 additional settlements exist but are not shown.${truncationNote}` : "No coder settlement WALs"
+        status: "\u2705",
+        detail: `${missingLines.length > 0 ? `${missingLines.join("; ")}. ` : ""}${settlementStates.length === 0 ? "No coder settlement WALs" : `${settlementStates.length} settlement(s) all in terminal state`}`
+      });
+    } else if (nonHealthy.length === 0 && truncated) {
+      checks.push({
+        name: "Coder Settlements",
+        status: "\u26A0\uFE0F",
+        detail: `All shown settlements are terminal, but the scan was truncated.${truncationNote} ${renderRecoveryInvocationQuickForms()}`
       });
     } else {
-      const nonTerminal = settlementStates.filter((entry) => entry.state === "DISPATCHED" || entry.state === "PREPARED" || entry.state === "unreadable");
-      if (nonTerminal.length === 0 && !truncated) {
-        checks.push({
-          name: "Coder Settlements",
-          status: "\u2705",
-          detail: `${settlementStates.length} settlement(s) all in terminal state`
-        });
-      } else {
-        const details = nonTerminal.map((entry) => {
-          if (entry.state === "unreadable") {
-            return `task ${entry.taskId}: WAL unreadable`;
-          }
-          const owner = entry.ownedInProcess || entry.ownedByLiveForeignPid ? `owner pid ${entry.processId ?? "?"} still alive \u2014 in flight or wedged` : "owner process is gone \u2014 stale";
-          return `task ${entry.taskId} (${entry.state}, ${owner})`;
-        });
-        checks.push({
-          name: "Coder Settlements",
-          status: "\u26A0\uFE0F",
-          detail: `${nonTerminal.length > 0 ? `${nonTerminal.length} non-terminal settlement(s): ${details.join("; ")}.` : "All shown settlements are terminal, but the scan was truncated."} Stale settlements block dispatches with CODER_DISPATCH_IN_PROGRESS \u2014 run /swarm recover [task_id] (--force if no dispatch is genuinely running) or /swarm reset-session.${truncationNote}`
-        });
-      }
+      const lines = [
+        ...nonHealthy.map(renderTaskRecoveryLine).filter(Boolean),
+        ...missingLines
+      ];
+      checks.push({
+        name: "Coder Settlements",
+        status: "\u26A0\uFE0F",
+        detail: `${lines.join("; ")}${healthyCount > 0 ? `; ${healthyCount} healthy settlement(s)` : ""}. Categories: missing/stale/ambiguous/corrupt/live_wedge \u2014 stale settlements block dispatches with CODER_DISPATCH_IN_PROGRESS. ${renderRecoveryInvocationQuickForms()}${truncationNote}`
+      });
     }
   } catch (error2) {
     checks.push({
@@ -63084,7 +63483,7 @@ async function handleDoctorCommand(directory, args) {
   const result = runConfigDoctor(config, directory);
   let output;
   if (enableAutoFix && result.hasAutoFixableIssues) {
-    const { runConfigDoctorWithFixes } = await import("./config-doctor-tnta65bf.js");
+    const { runConfigDoctorWithFixes } = await import("./config-doctor-zcyz614n.js");
     const fixResult = await runConfigDoctorWithFixes(directory, config, true, {
       applyLossy: true
     });
@@ -64038,7 +64437,7 @@ async function handleEvidenceCommand(directory, args) {
   return formatTaskEvidenceMarkdown(evidenceData);
 }
 async function handleEvidenceSummaryCommand(directory) {
-  const { buildEvidenceSummary } = await import("./evidence-summary-service-f4vem356.js");
+  const { buildEvidenceSummary } = await import("./evidence-summary-service-bpe04ngj.js");
   const artifact = await buildEvidenceSummary(directory);
   if (!artifact) {
     return "No plan found. Run `/swarm plan` to check plan status.";
@@ -74027,7 +74426,7 @@ import {
   chmod,
   copyFile as copyFile2,
   mkdir as mkdir16,
-  readdir as readdir5,
+  readdir as readdir6,
   readFile as readFile21,
   realpath as realpath5,
   rm as rm6,
@@ -74828,7 +75227,7 @@ var _internals79 = {
   copyFile: copyFile2,
   mkdir: mkdir16,
   stat: stat8,
-  readdir: readdir5,
+  readdir: readdir6,
   resolveHiveDataDir,
   resolveHiveKnowledgePath,
   transactHiveStore,
@@ -84086,7 +84485,7 @@ function createCuratorLLMDelegate(directory, mode = "init", sessionId) {
     }
     const sdkOpts = signal ? { signal } : {};
     try {
-      const { getSwarmAgents: getSwarmAgents2, resolveFallbackModel: resolveFallbackModel2 } = await import("./index-23fwhwrb.js");
+      const { getSwarmAgents: getSwarmAgents2, resolveFallbackModel: resolveFallbackModel2 } = await import("./index-hej0z0sm.js");
       const createResult = await client.session.create({
         ...sessionId ? {
           body: {
@@ -91960,158 +92359,6 @@ async function handleQaGatesCommand(directory, args, sessionID) {
 
 // src/commands/recover.ts
 init_path_identity();
-
-// src/workflow/stage-a-repair.ts
-import { readdir as readdir8 } from "fs/promises";
-init_path_identity();
-init_logger();
-var MAX_STAGE_A_REPAIR_SCAN = 200;
-async function appendStageARepairEvent(directory, payload) {
-  try {
-    appendCoreEventSync(directory, {
-      type: "stage_a_repair",
-      timestamp: new Date().toISOString(),
-      ...payload
-    });
-  } catch (error2) {
-    criticalWarn(`[stage-a-repair] audit event write failed: ${error2 instanceof Error ? error2.message : String(error2)}`);
-  }
-}
-async function hasGreenPostSettlementPreCheck(directory, settledAfterMs) {
-  let sawSecretscanGreen = false;
-  let sawSastGreen = false;
-  for (const evidenceType of ["secretscan", "sast_scan"]) {
-    let result;
-    try {
-      result = await loadEvidence(directory, evidenceType, { migrate: false });
-    } catch {
-      continue;
-    }
-    if (result.status !== "found")
-      continue;
-    const entryTypeTag = evidenceType === "sast_scan" ? "sast" : evidenceType;
-    const typed = result.bundle.entries.filter((entry) => entry.type === entryTypeTag);
-    if (typed.length === 0)
-      continue;
-    const last = typed[typed.length - 1];
-    const ts = Date.parse(String(last.timestamp ?? ""));
-    if (settledAfterMs !== null && Number.isFinite(ts) && ts < settledAfterMs) {
-      return { green: false, reason: "pre_check_failed_or_stale" };
-    }
-    if (evidenceType === "secretscan") {
-      if ((last.verdict === "pass" || last.verdict === "approved" || last.verdict === "info") && isSecretscanEvidence(last) && (last.incomplete_files ?? 0) === 0 && (last.files_scanned ?? 0) > 0 && (last.findings_count ?? 0) === 0) {
-        sawSecretscanGreen = true;
-        continue;
-      }
-    } else if (last.verdict === "pass" || last.verdict === "approved" || last.verdict === "info") {
-      sawSastGreen = true;
-      continue;
-    }
-    if (last.verdict === "fail" || last.verdict === "rejected") {
-      return { green: false, reason: "pre_check_failed_or_stale" };
-    }
-  }
-  if (!sawSecretscanGreen || !sawSastGreen) {
-    return { green: false, reason: "no_pre_check_bundles" };
-  }
-  return { green: true };
-}
-async function repairWedgedStageA(directory, options) {
-  const requested = options?.taskIds;
-  let entries2;
-  try {
-    const evidenceDir = validateSwarmPath(directory, "evidence");
-    entries2 = await readdir8(evidenceDir);
-  } catch {
-    return { results: [], truncated: false };
-  }
-  const candidates = entries2.filter((entry) => entry.endsWith(".json") && isStrictTaskId(entry.slice(0, -".json".length)));
-  const selected = requested?.length ? candidates.filter((entry) => requested.includes(entry.slice(0, -".json".length))) : candidates;
-  const truncated = !requested?.length && candidates.length > MAX_STAGE_A_REPAIR_SCAN;
-  const results = [];
-  for (const entry of selected.sort().slice(0, MAX_STAGE_A_REPAIR_SCAN)) {
-    const taskId = entry.slice(0, -".json".length);
-    try {
-      const evidence2 = await readTaskEvidence(directory, taskId);
-      const workflow = getTaskWorkflowSnapshot(evidence2);
-      if (workflow.state !== "coder_delegated") {
-        results.push({
-          taskId,
-          outcome: "skipped_not_wedged",
-          state: workflow.state
-        });
-        continue;
-      }
-      if (evidence2?.gates?.pre_check) {
-        results.push({
-          taskId,
-          outcome: "skipped_not_wedged",
-          state: workflow.state
-        });
-        continue;
-      }
-      let settledAfterMs = null;
-      try {
-        const { states } = await listCoderSettlementWalStates(directory);
-        for (const state of states) {
-          if (state.taskId !== taskId)
-            continue;
-          if (state.state !== "COMMITTED")
-            continue;
-          if (state.recordedAt === undefined)
-            continue;
-          const parsed = Date.parse(state.recordedAt);
-          if (!Number.isFinite(parsed))
-            continue;
-          settledAfterMs = settledAfterMs === null ? parsed : Math.max(settledAfterMs, parsed);
-        }
-      } catch {}
-      if (settledAfterMs === null) {
-        const fallbackTs = Date.parse(workflow.updatedAt);
-        if (Number.isFinite(fallbackTs))
-          settledAfterMs = fallbackTs;
-      }
-      const greenness = await hasGreenPostSettlementPreCheck(directory, settledAfterMs);
-      if (!greenness.green) {
-        results.push({
-          taskId,
-          outcome: "skipped_not_green",
-          reason: greenness.reason
-        });
-        continue;
-      }
-      const transitionId = `stage-a-repair:${taskId}:${workflow.generation}`;
-      await transitionTaskWorkflowEvidence(directory, taskId, {
-        type: "stage_a_passed",
-        expectedGeneration: workflow.generation,
-        transitionId
-      });
-      await appendStageARepairEvent(directory, {
-        action: "repaired",
-        taskId,
-        transitionId,
-        generation: workflow.generation
-      });
-      results.push({
-        taskId,
-        outcome: "repaired",
-        generation: workflow.generation,
-        transitionId
-      });
-    } catch (error2) {
-      const message = error2 instanceof Error ? error2.message : String(error2);
-      await appendStageARepairEvent(directory, {
-        action: "repair-failed",
-        taskId,
-        message: sanitizeDiagnosticText(message, 512)
-      });
-      results.push({ taskId, outcome: "error", message });
-    }
-  }
-  return { results, truncated };
-}
-
-// src/commands/recover.ts
 function renderOutcome(outcome) {
   switch (outcome.outcome) {
     case "recovered":
@@ -92123,7 +92370,7 @@ function renderOutcome(outcome) {
     case "owned_by_live_foreign_pid":
       return `\u2139\uFE0F Task ${outcome.taskId}: owned by live process pid ${outcome.processId} (another OpenCode instance). Close that instance or run /swarm recover there; this command never interrupts another live process's dispatch.`;
     case "unreadable_wal":
-      return `\u26A0\uFE0F Task ${outcome.taskId}: settlement WAL is unreadable \u2014 inspect .swarm/coder-settlements/${outcome.taskId}.json`;
+      return `\u26A0\uFE0F Task ${outcome.taskId}: settlement WAL is unreadable (corrupt) \u2014 this command refuses corrupt WALs; inspect .swarm/coder-settlements/${outcome.taskId}.json and consult docs/troubleshooting/recovery-runbook.md; do not delete or hand-edit the file`;
     case "error":
       return `\u274C Task ${outcome.taskId}: recovery failed \u2014 ${sanitizeDiagnosticText(outcome.message, 512)}`;
     default:
@@ -92213,6 +92460,7 @@ async function handleRecoverCommand(directory, args) {
   } catch (err) {
     report.push("", `\u26A0\uFE0F Wedged Stage A repair failed (settlement recovery above is unaffected): ${sanitizeDiagnosticText(err instanceof Error ? err.message : String(err), 512)}`);
   }
+  report.push("", renderRecoveryInvocationQuickForms());
   return report.join(`
 `);
 }
@@ -98155,7 +98403,7 @@ async function runValidationWithTransientRetry(input, candidateContent, baseline
       if (!input.dispatcher) {
         throw new Error("no evaluation dispatcher available (cannot run validation)");
       }
-      const { createModelEvaluationExecutor: createModelEvaluationExecutor2 } = await import("./runner-k1pmc3z8.js");
+      const { createModelEvaluationExecutor: createModelEvaluationExecutor2 } = await import("./runner-nzppg2ky.js");
       const executor = createModelEvaluationExecutor2(input.dispatcher, input.sessionId);
       const result = await withProtectedSetIntegrity([evalInputRoot, ...protectedRoots(input.directory)], () => _internals118.evaluateCandidateV1({
         projectRoot: input.directory,
@@ -100784,7 +101032,7 @@ function buildDetailedHelp(commandName, entry) {
 async function handleHelpCommand(ctx) {
   const targetCommand = ctx.args.join(" ");
   if (!targetCommand) {
-    const { buildHelpText } = await import("./index-dfd6d64k.js");
+    const { buildHelpText } = await import("./index-hdwdapp6.js");
     return buildHelpText();
   }
   const tokens = targetCommand.split(/\s+/);
@@ -100798,7 +101046,7 @@ async function handleHelpCommand(ctx) {
 > Note: \`/swarm ${resolved.key}\` is a deprecated alias for \`/swarm ${aliasTarget}\`.` : detailed;
   }
   const similar = _internals24.findSimilarCommands(targetCommand);
-  const { buildHelpText: fullHelp } = await import("./index-dfd6d64k.js");
+  const { buildHelpText: fullHelp } = await import("./index-hdwdapp6.js");
   if (similar.length > 0) {
     return `Command '/swarm ${targetCommand}' not found.
 
@@ -101113,7 +101361,7 @@ var COMMAND_REGISTRY = {
   },
   "guardrail explain": {
     handler: async (ctx) => {
-      const { handleGuardrailExplain } = await import("./guardrail-explain-hf5gawe2.js");
+      const { handleGuardrailExplain } = await import("./guardrail-explain-ncrw7k8h.js");
       return handleGuardrailExplain(ctx.directory, ctx.args);
     },
     description: "Dry-run: show what the guardrails would do to a command or write target (executes nothing)",
@@ -101123,7 +101371,7 @@ var COMMAND_REGISTRY = {
   },
   "guardrail reset": {
     handler: async (ctx) => {
-      const { handleGuardrailReset } = await import("./guardrail-reset-26bxnh2e.js");
+      const { handleGuardrailReset } = await import("./guardrail-reset-3c3c7e5e.js");
       return handleGuardrailReset(ctx.args, ctx.sessionID);
     },
     description: "Reset one exact active invocation/action circuit after repair",
@@ -101144,7 +101392,7 @@ var COMMAND_REGISTRY = {
   },
   "guardrail-log": {
     handler: async (ctx) => {
-      const { handleGuardrailLog } = await import("./guardrail-log-9dkyvdbw.js");
+      const { handleGuardrailLog } = await import("./guardrail-log-nn2t8xyd.js");
       return handleGuardrailLog(ctx.directory, ctx.args);
     },
     description: "Read the guardrail decision log (use --blocks-only for blocks)",
@@ -101840,7 +102088,7 @@ Subcommands:
   recover: {
     handler: (ctx) => handleRecoverCommand(ctx.directory, ctx.args),
     description: "Recover wedged coder settlements [task_id] [--force]",
-    details: "Settles stale coder-settlement WALs in .swarm/coder-settlements/ \u2014 the CODER_DISPATCH_IN_PROGRESS wedge where a dispatch's completion never fired (issue #2268). Safe mode recovers settlements whose owner process is gone. --force also releases ownership keys held by this process: use only when no dispatch is genuinely running (a late completion then reports CODER_SETTLEMENT_IDEMPOTENCY_CONFLICT, safe to ignore). Never interrupts another live OpenCode process. Also repairs tasks wedged at coder_delegated with unattributed green pre_check evidence \u2014 the post-reset TASK_WORKFLOW_STAGE_A_REQUIRED wedge \u2014 by writing the missing stage_a_passed transition directly (audit events land in .swarm/events.jsonl); pass [task_id] to scope both phases to one task. Human-only.",
+    details: "Settles stale coder-settlement WALs in .swarm/coder-settlements/ \u2014 the CODER_DISPATCH_IN_PROGRESS wedge where a dispatch's completion never fired (issue #2268). Safe mode recovers settlements whose owner process is gone. --force also releases ownership keys held by this process: use only when no dispatch is genuinely running (a late completion then reports CODER_SETTLEMENT_IDEMPOTENCY_CONFLICT, safe to ignore). Never interrupts another live OpenCode process. Also repairs tasks wedged at coder_delegated with unattributed green pre_check evidence \u2014 the post-reset TASK_WORKFLOW_STAGE_A_REQUIRED wedge \u2014 by writing the missing stage_a_passed transition directly (audit events land in .swarm/events.jsonl); pass [task_id] to scope both phases to one task. Diagnose and repair emit per-category status explanations (missing/stale/ambiguous/corrupt/live_wedge) with shell-correct invocation guidance per host \u2014 see docs/troubleshooting/recovery-runbook.md (#2665). Human-only.",
     args: "[task_id] [--force]",
     category: "utility",
     toolPolicy: "human-only"