opencode-swarm 7.8.0 → 7.9.0

package/dist/cli/index.js

@@ -34,7 +34,7 @@ var package_default;
 var init_package = __esm(() => {
   package_default = {
     name: "opencode-swarm",
-    version: "7.8.0",
+    version: "7.9.0",
     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",
@@ -19738,7 +19738,13 @@ async function handleArchiveCommand(directory, args) {
     const wouldArchiveAge = [];
     const remainingBundles = [];
     for (const taskId of beforeTaskIds) {
-      const result = await loadEvidence(directory, taskId);
+      let result;
+      try {
+        result = await loadEvidence(directory, taskId);
+      } catch (_evidenceErr) {
+        warn("archive: skipping corrupt or unreadable evidence for task", taskId);
+        continue;
+      }
       if (result.status !== "found") {
         continue;
       }
@@ -19793,6 +19799,7 @@ async function handleArchiveCommand(directory, args) {
 var init_archive = __esm(() => {
   init_loader();
   init_manager2();
+  init_utils();
 });
 
 // src/db/project-db.ts
@@ -20799,7 +20806,13 @@ async function handleBenchmarkCommand(directory, args) {
     let totalTestToCodeRatio = 0;
     let qualityEvidenceCount = 0;
     for (const tid of await listEvidenceTaskIds(directory)) {
-      const result = await loadEvidence(directory, tid);
+      let result;
+      try {
+        result = await loadEvidence(directory, tid);
+      } catch (_evidenceErr) {
+        warn("benchmark: skipping corrupt or unreadable evidence for task", tid);
+        continue;
+      }
       if (result.status !== "found")
         continue;
       for (const e of result.bundle.entries) {
@@ -37201,7 +37214,17 @@ async function handleDarkMatterCommand(directory, args) {
       i++;
     }
   }
-  const pairs = await detectDarkMatter(directory, options);
+  let pairs;
+  try {
+    pairs = await _internals10.detectDarkMatter(directory, options);
+  } catch (err) {
+    const errMsg = err instanceof Error ? err.message : String(err);
+    return `## Dark Matter Analysis Failed
+
+Error analyzing git history: ${errMsg}
+
+Ensure this is a git repository with commit history.`;
+  }
   const output = formatDarkMatterOutput(pairs);
   if (pairs.length > 0) {
     try {
@@ -41607,22 +41630,37 @@ var init_handoff_service = __esm(() => {
 
 // src/commands/handoff.ts
 import crypto4 from "crypto";
-import { renameSync as renameSync7 } from "fs";
+import { renameSync as renameSync7, unlinkSync as unlinkSync4 } from "fs";
 async function handleHandoffCommand(directory, _args) {
   const handoffData = await getHandoffData(directory);
   const markdown = formatHandoffMarkdown(handoffData);
-  const resolvedPath = validateSwarmPath(directory, "handoff.md");
-  const tempPath = `${resolvedPath}.tmp.${crypto4.randomUUID()}`;
-  await bunWrite(tempPath, markdown);
-  renameSync7(tempPath, resolvedPath);
-  const continuationPrompt = formatContinuationPrompt(handoffData);
-  const promptPath = validateSwarmPath(directory, "handoff-prompt.md");
-  const promptTempPath = `${promptPath}.tmp.${crypto4.randomUUID()}`;
-  await bunWrite(promptTempPath, continuationPrompt);
-  renameSync7(promptTempPath, promptPath);
-  await writeSnapshot(directory, swarmState);
-  await flushPendingSnapshot(directory);
-  return `## Handoff Brief Written
+  try {
+    const resolvedPath = validateSwarmPath(directory, "handoff.md");
+    const tempPath = `${resolvedPath}.tmp.${crypto4.randomUUID()}`;
+    await bunWrite(tempPath, markdown);
+    try {
+      renameSync7(tempPath, resolvedPath);
+    } catch (renameErr) {
+      try {
+        unlinkSync4(tempPath);
+      } catch {}
+      throw renameErr;
+    }
+    const continuationPrompt = formatContinuationPrompt(handoffData);
+    const promptPath = validateSwarmPath(directory, "handoff-prompt.md");
+    const promptTempPath = `${promptPath}.tmp.${crypto4.randomUUID()}`;
+    await bunWrite(promptTempPath, continuationPrompt);
+    try {
+      renameSync7(promptTempPath, promptPath);
+    } catch (renameErr) {
+      try {
+        unlinkSync4(promptTempPath);
+      } catch {}
+      throw renameErr;
+    }
+    await writeSnapshot(directory, swarmState);
+    await flushPendingSnapshot(directory);
+    return `## Handoff Brief Written
 
 Brief written to \`.swarm/handoff.md\`.
 Continuation prompt written to \`.swarm/handoff-prompt.md\`.
@@ -41636,6 +41674,16 @@ ${markdown}
 Copy and paste the block below into your next session to resume cleanly:
 
 ${continuationPrompt}`;
+  } catch (err) {
+    const errMsg = err instanceof Error ? err.message : String(err);
+    return `## Handoff Generated (file write failed)
+
+Handoff data was generated but could not be written to disk: ${errMsg}
+
+The handoff content is included below for manual copy:
+
+${markdown}`;
+  }
 }
 var init_handoff = __esm(() => {
   init_utils2();
@@ -47722,7 +47770,19 @@ async function handleSimulateCommand(directory, args) {
       options.minCommits = val;
     }
   }
-  const darkMatterPairs = await detectDarkMatter(directory, options);
+  let darkMatterPairs;
+  try {
+    darkMatterPairs = await _internals10.detectDarkMatter(directory, options);
+  } catch (err) {
+    const errMsg = err instanceof Error ? err.message : String(err);
+    return `## Simulate Report
+
+### Error
+
+Error analyzing git history: ${errMsg}
+
+Ensure this is a git repository with commit history.`;
+  }
   const reportLines = [
     "# Simulate Report",
     "",
@@ -47740,15 +47800,21 @@ async function handleSimulateCommand(directory, args) {
   ];
   const report = reportLines.filter(Boolean).join(`
 `);
-  const fs22 = await import("fs/promises");
-  const path37 = await import("path");
-  const reportPath = path37.join(directory, ".swarm", "simulate-report.md");
-  await fs22.mkdir(path37.dirname(reportPath), { recursive: true });
-  await fs22.writeFile(reportPath, report, "utf-8");
+  try {
+    const fs22 = await import("fs/promises");
+    const path37 = await import("path");
+    const reportPath = path37.join(directory, ".swarm", "simulate-report.md");
+    await fs22.mkdir(path37.dirname(reportPath), { recursive: true });
+    await fs22.writeFile(reportPath, report, "utf-8");
+  } catch (err) {
+    const writeErr = err instanceof Error ? err.message : String(err);
+    warn(`simulate: failed to write report to ${directory}/.swarm/simulate-report.md`, writeErr);
+  }
   return `${darkMatterPairs.length} hidden coupling pairs detected`;
 }
 var init_simulate = __esm(() => {
   init_co_change_analyzer();
+  init_utils();
 });
 
 // src/commands/specify.ts
@@ -48195,12 +48261,6 @@ function buildHelpText() {
   return lines.join(`
 `);
 }
-function getHelpText() {
-  if (!_helpText) {
-    _helpText = buildHelpText();
-  }
-  return _helpText;
-}
 function createSwarmCommandHandler(directory, agents) {
   return async (input, output) => {
     if (input.command !== "swarm" && !input.command.startsWith("swarm-")) {
@@ -48226,7 +48286,22 @@ function createSwarmCommandHandler(directory, agents) {
     let text;
     const resolved = resolveCommand(tokens);
     if (!resolved) {
-      text = getHelpText();
+      if (tokens.length === 0) {
+        text = buildHelpText();
+      } else {
+        const attemptedCommand = tokens[0] || "";
+        const MAX_DISPLAY = 100;
+        const displayCommand = attemptedCommand.length > MAX_DISPLAY ? `${attemptedCommand.slice(0, MAX_DISPLAY)}...` : attemptedCommand;
+        const similar = _internals19.findSimilarCommands(attemptedCommand);
+        const header = `Command \`/swarm ${displayCommand}\` not found.`;
+        const suggestions = similar.length > 0 ? `Did you mean:
+${similar.map((cmd) => `  \u2022 /swarm ${cmd}`).join(`
+`)}` : "";
+        const footer = "Run `/swarm help` for all commands.";
+        text = [header, suggestions, footer].filter(Boolean).join(`
+
+`);
+      }
     } else {
       try {
         text = await resolved.entry.handler({
@@ -48258,7 +48333,6 @@ ${text}`;
     ];
   };
 }
-var _helpText;
 var init_commands = __esm(() => {
   init_registry();
   init_acknowledge_spec_drift();
@@ -48318,14 +48392,38 @@ function levenshteinDistance(a, b) {
 }
 function findSimilarCommands(query) {
   const q = query.toLowerCase();
-  const scored = VALID_COMMANDS.filter((cmd) => {
-    if (cmd.includes(" ") || cmd.includes("-"))
-      return false;
-    return cmd.toLowerCase().includes(q) || q.includes(cmd.toLowerCase());
-  }).map((cmd) => ({
-    cmd,
-    score: cmd.length < q.length ? q.length - cmd.length : _internals19.levenshteinDistance(q, cmd)
-  }));
+  if (q.length > 500) {
+    return [];
+  }
+  const scored = VALID_COMMANDS.map((cmd) => {
+    const cmdLower = cmd.toLowerCase();
+    const fullScore = _internals19.levenshteinDistance(q, cmdLower);
+    let tokenScore = Infinity;
+    if (cmd.includes(" ") || cmd.includes("-")) {
+      const qTokens = q.split(/[\s-]+/);
+      const cmdTokens = cmdLower.split(/[\s-]+/);
+      let totalTokenDist = 0;
+      for (const qt of qTokens) {
+        if (qt.length === 0)
+          continue;
+        let minDist = Infinity;
+        for (const ct of cmdTokens) {
+          if (ct.length === 0)
+            continue;
+          const dist = _internals19.levenshteinDistance(qt, ct);
+          if (dist < minDist)
+            minDist = dist;
+        }
+        totalTokenDist += minDist;
+      }
+      tokenScore = totalTokenDist;
+    }
+    const dashStrippedQ = q.replace(/-/g, "");
+    const dashStrippedCmd = cmdLower.replace(/-/g, "");
+    const dashScore = _internals19.levenshteinDistance(dashStrippedQ, dashStrippedCmd);
+    const score = Math.min(fullScore, tokenScore, dashScore);
+    return { cmd, score };
+  });
   scored.sort((a, b) => a.score - b.score);
   return scored.slice(0, 3).map((s) => s.cmd);
 }

package/dist/commands/archive.error-handling.test.d.ts

@@ -0,0 +1,9 @@
+/**
+ * Tests for archive.ts graceful handling of corrupt evidence files (Task 1.6)
+ *
+ * Verifies that the try/catch in handleArchiveCommand's dry-run loop
+ * catches exceptions from loadEvidence and skips corrupt/unreadable files.
+ *
+ * Uses real filesystem operations like existing archive tests.
+ */
+export {};

package/dist/commands/benchmark.error-handling.test.d.ts

@@ -0,0 +1,7 @@
+/**
+ * Tests for benchmark.ts graceful handling of corrupt evidence files.
+ *
+ * Verifies that the try/catch in handleBenchmarkCommand's cumulative loop
+ * catches exceptions from loadEvidence and skips corrupt/unreadable files.
+ */
+export {};

package/dist/commands/dark-matter.error-handling.test.d.ts

@@ -0,0 +1 @@
+export {};

package/dist/commands/handoff.error-handling.adversarial.test.d.ts

@@ -0,0 +1 @@
+export {};

package/dist/commands/handoff.error-handling.test.d.ts

@@ -0,0 +1 @@
+export {};

package/dist/commands/index.not-found.adversarial.test.d.ts

@@ -0,0 +1,12 @@
+/**
+ * Adversarial security tests for command-not-found UX in createSwarmCommandHandler.
+ *
+ * Attack vectors covered:
+ * 1. Very long command name (10000+ chars) — does it hang or crash?
+ * 2. Command with special characters (script injection, shell injection, template literals)
+ * 3. Command with newlines/embedded control chars — does it break output format?
+ * 4. Command with unicode/emoji — handled gracefully?
+ * 5. Extremely deep tokens array (1000 elements) — does findSimilarCommands handle it?
+ * 6. Null bytes in command name
+ */
+export {};

package/dist/commands/index.not-found.test.d.ts

@@ -0,0 +1,11 @@
+/**
+ * Tests for command-not-found UX improvement in createSwarmCommandHandler.
+ *
+ * Covers:
+ * - Unknown single-word command shows "Command not found" + suggestions + footer
+ * - Unknown compound command shows header with command name
+ * - Empty tokens (empty array) → returns buildHelpText() output
+ * - Command with no similar matches → shows header + footer only (no "Did you mean" section)
+ * - Multiple similar commands returned → all shown with bullet format
+ */
+export {};

package/dist/commands/registration-parity.test.d.ts

@@ -0,0 +1 @@
+export {};

package/dist/commands/registry.find-similar.adversarial.test.d.ts

@@ -0,0 +1 @@
+export {};

package/dist/commands/registry.find-similar.test.d.ts

@@ -0,0 +1 @@
+export {};

package/dist/commands/simulate.report-write.adversarial.test.d.ts

@@ -0,0 +1 @@
+export {};

package/dist/commands/simulate.report-write.test.d.ts

@@ -0,0 +1 @@
+export {};

package/dist/index.js

@@ -33,7 +33,7 @@ var package_default;
 var init_package = __esm(() => {
   package_default = {
     name: "opencode-swarm",
-    version: "7.8.0",
+    version: "7.9.0",
     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",
@@ -20405,7 +20405,13 @@ async function handleArchiveCommand(directory, args2) {
     const wouldArchiveAge = [];
     const remainingBundles = [];
     for (const taskId of beforeTaskIds) {
-      const result = await loadEvidence(directory, taskId);
+      let result;
+      try {
+        result = await loadEvidence(directory, taskId);
+      } catch (_evidenceErr) {
+        warn("archive: skipping corrupt or unreadable evidence for task", taskId);
+        continue;
+      }
       if (result.status !== "found") {
         continue;
       }
@@ -20460,6 +20466,7 @@ async function handleArchiveCommand(directory, args2) {
 var init_archive = __esm(() => {
   init_loader();
   init_manager2();
+  init_utils();
 });
 
 // src/db/project-db.ts
@@ -27228,7 +27235,13 @@ async function handleBenchmarkCommand(directory, args2) {
     let totalTestToCodeRatio = 0;
     let qualityEvidenceCount = 0;
     for (const tid of await listEvidenceTaskIds(directory)) {
-      const result = await loadEvidence(directory, tid);
+      let result;
+      try {
+        result = await loadEvidence(directory, tid);
+      } catch (_evidenceErr) {
+        warn("benchmark: skipping corrupt or unreadable evidence for task", tid);
+        continue;
+      }
       if (result.status !== "found")
         continue;
       for (const e of result.bundle.entries) {
@@ -43835,8 +43848,10 @@ async function runCuratorInit(directory, config3, llmDelegate) {
         const timer = setTimeout(() => ac.abort(), timeoutMs);
         let llmOutput;
         try {
+          const delegatePromise = llmDelegate(systemPrompt, userInput, ac.signal);
+          delegatePromise.catch(() => {});
           llmOutput = await Promise.race([
-            llmDelegate(systemPrompt, userInput, ac.signal),
+            delegatePromise,
             new Promise((_, reject) => {
               ac.signal.addEventListener("abort", () => reject(new Error("CURATOR_LLM_TIMEOUT")));
             })
@@ -43963,8 +43978,10 @@ async function runCuratorPhase(directory, phase, agentsDispatched, config3, _kno
         const timer = setTimeout(() => ac.abort(), timeoutMs);
         let llmOutput;
         try {
+          const delegatePromise = llmDelegate(systemPrompt, userInput, ac.signal);
+          delegatePromise.catch(() => {});
           llmOutput = await Promise.race([
-            llmDelegate(systemPrompt, userInput, ac.signal),
+            delegatePromise,
             new Promise((_, reject) => {
               ac.signal.addEventListener("abort", () => reject(new Error("CURATOR_LLM_TIMEOUT")));
             })
@@ -44900,7 +44917,17 @@ async function handleDarkMatterCommand(directory, args2) {
       i2++;
     }
   }
-  const pairs = await detectDarkMatter(directory, options);
+  let pairs;
+  try {
+    pairs = await _internals15.detectDarkMatter(directory, options);
+  } catch (err2) {
+    const errMsg = err2 instanceof Error ? err2.message : String(err2);
+    return `## Dark Matter Analysis Failed
+
+Error analyzing git history: ${errMsg}
+
+Ensure this is a git repository with commit history.`;
+  }
   const output = formatDarkMatterOutput(pairs);
   if (pairs.length > 0) {
     try {
@@ -49483,22 +49510,37 @@ var init_handoff_service = __esm(() => {
 
 // src/commands/handoff.ts
 import crypto4 from "node:crypto";
-import { renameSync as renameSync10 } from "node:fs";
+import { renameSync as renameSync10, unlinkSync as unlinkSync5 } from "node:fs";
 async function handleHandoffCommand(directory, _args) {
   const handoffData = await getHandoffData(directory);
   const markdown = formatHandoffMarkdown(handoffData);
-  const resolvedPath = validateSwarmPath(directory, "handoff.md");
-  const tempPath = `${resolvedPath}.tmp.${crypto4.randomUUID()}`;
-  await bunWrite(tempPath, markdown);
-  renameSync10(tempPath, resolvedPath);
-  const continuationPrompt = formatContinuationPrompt(handoffData);
-  const promptPath = validateSwarmPath(directory, "handoff-prompt.md");
-  const promptTempPath = `${promptPath}.tmp.${crypto4.randomUUID()}`;
-  await bunWrite(promptTempPath, continuationPrompt);
-  renameSync10(promptTempPath, promptPath);
-  await writeSnapshot(directory, swarmState);
-  await flushPendingSnapshot(directory);
-  return `## Handoff Brief Written
+  try {
+    const resolvedPath = validateSwarmPath(directory, "handoff.md");
+    const tempPath = `${resolvedPath}.tmp.${crypto4.randomUUID()}`;
+    await bunWrite(tempPath, markdown);
+    try {
+      renameSync10(tempPath, resolvedPath);
+    } catch (renameErr) {
+      try {
+        unlinkSync5(tempPath);
+      } catch {}
+      throw renameErr;
+    }
+    const continuationPrompt = formatContinuationPrompt(handoffData);
+    const promptPath = validateSwarmPath(directory, "handoff-prompt.md");
+    const promptTempPath = `${promptPath}.tmp.${crypto4.randomUUID()}`;
+    await bunWrite(promptTempPath, continuationPrompt);
+    try {
+      renameSync10(promptTempPath, promptPath);
+    } catch (renameErr) {
+      try {
+        unlinkSync5(promptTempPath);
+      } catch {}
+      throw renameErr;
+    }
+    await writeSnapshot(directory, swarmState);
+    await flushPendingSnapshot(directory);
+    return `## Handoff Brief Written
 
 Brief written to \`.swarm/handoff.md\`.
 Continuation prompt written to \`.swarm/handoff-prompt.md\`.
@@ -49512,6 +49554,16 @@ ${markdown}
 Copy and paste the block below into your next session to resume cleanly:
 
 ${continuationPrompt}`;
+  } catch (err2) {
+    const errMsg = err2 instanceof Error ? err2.message : String(err2);
+    return `## Handoff Generated (file write failed)
+
+Handoff data was generated but could not be written to disk: ${errMsg}
+
+The handoff content is included below for manual copy:
+
+${markdown}`;
+  }
 }
 var init_handoff = __esm(() => {
   init_utils2();
@@ -55708,7 +55760,19 @@ async function handleSimulateCommand(directory, args2) {
       options.minCommits = val;
     }
   }
-  const darkMatterPairs = await detectDarkMatter(directory, options);
+  let darkMatterPairs;
+  try {
+    darkMatterPairs = await _internals15.detectDarkMatter(directory, options);
+  } catch (err2) {
+    const errMsg = err2 instanceof Error ? err2.message : String(err2);
+    return `## Simulate Report
+
+### Error
+
+Error analyzing git history: ${errMsg}
+
+Ensure this is a git repository with commit history.`;
+  }
   const reportLines = [
     "# Simulate Report",
     "",
@@ -55726,15 +55790,21 @@ async function handleSimulateCommand(directory, args2) {
   ];
   const report = reportLines.filter(Boolean).join(`
 `);
-  const fs29 = await import("node:fs/promises");
-  const path44 = await import("node:path");
-  const reportPath = path44.join(directory, ".swarm", "simulate-report.md");
-  await fs29.mkdir(path44.dirname(reportPath), { recursive: true });
-  await fs29.writeFile(reportPath, report, "utf-8");
+  try {
+    const fs29 = await import("node:fs/promises");
+    const path44 = await import("node:path");
+    const reportPath = path44.join(directory, ".swarm", "simulate-report.md");
+    await fs29.mkdir(path44.dirname(reportPath), { recursive: true });
+    await fs29.writeFile(reportPath, report, "utf-8");
+  } catch (err2) {
+    const writeErr = err2 instanceof Error ? err2.message : String(err2);
+    warn(`simulate: failed to write report to ${directory}/.swarm/simulate-report.md`, writeErr);
+  }
   return `${darkMatterPairs.length} hidden coupling pairs detected`;
 }
 var init_simulate = __esm(() => {
   init_co_change_analyzer();
+  init_utils();
 });
 
 // src/commands/specify.ts
@@ -56396,12 +56466,6 @@ function buildHelpText() {
   return lines.join(`
 `);
 }
-function getHelpText() {
-  if (!_helpText) {
-    _helpText = buildHelpText();
-  }
-  return _helpText;
-}
 function createSwarmCommandHandler(directory, agents) {
   return async (input, output) => {
     if (input.command !== "swarm" && !input.command.startsWith("swarm-")) {
@@ -56427,7 +56491,22 @@ function createSwarmCommandHandler(directory, agents) {
     let text;
     const resolved = resolveCommand(tokens);
     if (!resolved) {
-      text = getHelpText();
+      if (tokens.length === 0) {
+        text = buildHelpText();
+      } else {
+        const attemptedCommand = tokens[0] || "";
+        const MAX_DISPLAY = 100;
+        const displayCommand = attemptedCommand.length > MAX_DISPLAY ? `${attemptedCommand.slice(0, MAX_DISPLAY)}...` : attemptedCommand;
+        const similar = _internals24.findSimilarCommands(attemptedCommand);
+        const header = `Command \`/swarm ${displayCommand}\` not found.`;
+        const suggestions = similar.length > 0 ? `Did you mean:
+${similar.map((cmd) => `  • /swarm ${cmd}`).join(`
+`)}` : "";
+        const footer = "Run `/swarm help` for all commands.";
+        text = [header, suggestions, footer].filter(Boolean).join(`
+
+`);
+      }
     } else {
       try {
         text = await resolved.entry.handler({
@@ -56459,7 +56538,6 @@ ${text}`;
     ];
   };
 }
-var _helpText;
 var init_commands = __esm(() => {
   init_registry();
   init_acknowledge_spec_drift();
@@ -56519,14 +56597,38 @@ function levenshteinDistance(a, b) {
 }
 function findSimilarCommands(query) {
   const q = query.toLowerCase();
-  const scored = VALID_COMMANDS.filter((cmd) => {
-    if (cmd.includes(" ") || cmd.includes("-"))
-      return false;
-    return cmd.toLowerCase().includes(q) || q.includes(cmd.toLowerCase());
-  }).map((cmd) => ({
-    cmd,
-    score: cmd.length < q.length ? q.length - cmd.length : _internals24.levenshteinDistance(q, cmd)
-  }));
+  if (q.length > 500) {
+    return [];
+  }
+  const scored = VALID_COMMANDS.map((cmd) => {
+    const cmdLower = cmd.toLowerCase();
+    const fullScore = _internals24.levenshteinDistance(q, cmdLower);
+    let tokenScore = Infinity;
+    if (cmd.includes(" ") || cmd.includes("-")) {
+      const qTokens = q.split(/[\s-]+/);
+      const cmdTokens = cmdLower.split(/[\s-]+/);
+      let totalTokenDist = 0;
+      for (const qt of qTokens) {
+        if (qt.length === 0)
+          continue;
+        let minDist = Infinity;
+        for (const ct of cmdTokens) {
+          if (ct.length === 0)
+            continue;
+          const dist = _internals24.levenshteinDistance(qt, ct);
+          if (dist < minDist)
+            minDist = dist;
+        }
+        totalTokenDist += minDist;
+      }
+      tokenScore = totalTokenDist;
+    }
+    const dashStrippedQ = q.replace(/-/g, "");
+    const dashStrippedCmd = cmdLower.replace(/-/g, "");
+    const dashScore = _internals24.levenshteinDistance(dashStrippedQ, dashStrippedCmd);
+    const score = Math.min(fullScore, tokenScore, dashScore);
+    return { cmd, score };
+  });
   scored.sort((a, b) => a.score - b.score);
   return scored.slice(0, 3).map((s) => s.cmd);
 }
@@ -65345,27 +65447,32 @@ __export(exports_runtime, {
   isGrammarAvailable: () => isGrammarAvailable,
   getSupportedLanguages: () => getSupportedLanguages,
   getInitializedLanguages: () => getInitializedLanguages,
-  clearParserCache: () => clearParserCache
+  clearParserCache: () => clearParserCache,
+  _internals: () => _internals25
 });
 import * as path67 from "node:path";
 import { fileURLToPath as fileURLToPath2 } from "node:url";
 async function initTreeSitter() {
-  if (treeSitterInitialized) {
-    return;
-  }
-  const thisDir = path67.dirname(fileURLToPath2(import.meta.url));
-  const isSource = thisDir.replace(/\\/g, "/").endsWith("/src/lang");
-  if (isSource) {
-    await Parser.init();
-  } else {
-    const grammarsDir = getGrammarsDirAbsolute();
-    await Parser.init({
-      locateFile(scriptName) {
-        return path67.join(grammarsDir, scriptName);
+  if (!treeSitterInitPromise) {
+    treeSitterInitPromise = (async () => {
+      const thisDir = path67.dirname(fileURLToPath2(import.meta.url));
+      const isSource = thisDir.replace(/\\/g, "/").endsWith("/src/lang");
+      if (isSource) {
+        await _internals25.parserInit();
+      } else {
+        const grammarsDir = getGrammarsDirAbsolute();
+        await _internals25.parserInit({
+          locateFile(scriptName) {
+            return path67.join(grammarsDir, scriptName);
+          }
+        });
       }
+    })().catch((err2) => {
+      treeSitterInitPromise = null;
+      throw err2;
     });
   }
-  treeSitterInitialized = true;
+  return treeSitterInitPromise;
 }
 function sanitizeLanguageId(languageId) {
   const normalized = languageId.toLowerCase();
@@ -65448,7 +65555,7 @@ async function isGrammarAvailable(languageId) {
 function clearParserCache() {
   parserCache.clear();
   initializedLanguages.clear();
-  treeSitterInitialized = false;
+  treeSitterInitPromise = null;
 }
 function getInitializedLanguages() {
   return Array.from(initializedLanguages);
@@ -65456,11 +65563,14 @@ function getInitializedLanguages() {
 function getSupportedLanguages() {
   return Object.keys(LANGUAGE_WASM_MAP);
 }
-var parserCache, initializedLanguages, treeSitterInitialized = false, LANGUAGE_WASM_MAP;
+var parserCache, initializedLanguages, treeSitterInitPromise = null, _internals25, LANGUAGE_WASM_MAP;
 var init_runtime = __esm(() => {
   init_tree_sitter();
   parserCache = new Map;
   initializedLanguages = new Set;
+  _internals25 = {
+    parserInit: Parser.init
+  };
   LANGUAGE_WASM_MAP = {
     javascript: "tree-sitter-javascript.wasm",
     typescript: "tree-sitter-typescript.wasm",
@@ -65878,9 +65988,9 @@ var init_doc_scan = __esm(() => {
 var exports_knowledge_recall = {};
 __export(exports_knowledge_recall, {
   knowledge_recall: () => knowledge_recall,
-  _internals: () => _internals25
+  _internals: () => _internals26
 });
-var knowledge_recall, _internals25;
+var knowledge_recall, _internals26;
 var init_knowledge_recall = __esm(() => {
   init_zod();
   init_knowledge_store();
@@ -65966,7 +66076,7 @@ var init_knowledge_recall = __esm(() => {
       return JSON.stringify(result);
     }
   });
-  _internals25 = {
+  _internals26 = {
     knowledge_recall
   };
 });
@@ -66021,7 +66131,7 @@ __export(exports_curator_drift, {
   runDeterministicDriftCheck: () => runDeterministicDriftCheck,
   readPriorDriftReports: () => readPriorDriftReports,
   buildDriftInjectionText: () => buildDriftInjectionText,
-  _internals: () => _internals27
+  _internals: () => _internals28
 });
 import * as fs54 from "node:fs";
 import * as path73 from "node:path";
@@ -66066,7 +66176,7 @@ async function runDeterministicDriftCheck(directory, phase, curatorResult, confi
   try {
     const planMd = await readSwarmFileAsync(directory, "plan.md");
     const specMd = await readSwarmFileAsync(directory, "spec.md");
-    const priorReports = await _internals27.readPriorDriftReports(directory);
+    const priorReports = await _internals28.readPriorDriftReports(directory);
     const complianceCount = curatorResult.compliance.length;
     const warningCompliance = curatorResult.compliance.filter((obs) => obs.severity === "warning");
     let alignment = "ALIGNED";
@@ -66115,7 +66225,7 @@ async function runDeterministicDriftCheck(directory, phase, curatorResult, confi
       scope_additions: [],
       injection_summary: injectionSummary
     };
-    const reportPath = await _internals27.writeDriftReport(directory, report);
+    const reportPath = await _internals28.writeDriftReport(directory, report);
     getGlobalEventBus().publish("curator.drift.completed", {
       phase,
       alignment,
@@ -66178,12 +66288,12 @@ function buildDriftInjectionText(report, maxChars) {
   }
   return text.slice(0, maxChars);
 }
-var DRIFT_REPORT_PREFIX = "drift-report-phase-", _internals27;
+var DRIFT_REPORT_PREFIX = "drift-report-phase-", _internals28;
 var init_curator_drift = __esm(() => {
   init_event_bus();
   init_logger();
   init_utils2();
-  _internals27 = {
+  _internals28 = {
     readPriorDriftReports,
     writeDriftReport,
     runDeterministicDriftCheck,
@@ -67078,7 +67188,7 @@ init_state();
 init_utils();
 init_bun_compat();
 init_utils2();
-import { renameSync as renameSync12, unlinkSync as unlinkSync8 } from "node:fs";
+import { renameSync as renameSync12, unlinkSync as unlinkSync9 } from "node:fs";
 import * as nodePath2 from "node:path";
 function createAgentActivityHooks(config3, directory) {
   if (config3.hooks?.agent_activity === false) {
@@ -67156,7 +67266,7 @@ async function doFlush(directory) {
       renameSync12(tempPath, path52);
     } catch (writeError) {
       try {
-        unlinkSync8(tempPath);
+        unlinkSync9(tempPath);
       } catch {}
       throw writeError;
     }
@@ -67903,14 +68013,22 @@ function createCuratorLLMDelegate(directory, mode = "init", sessionId) {
         throw new Error("CURATOR_LLM_TIMEOUT");
       }
       const agentName = resolveCuratorAgentName(mode, sessionId);
-      const promptResult = await client.session.prompt({
-        path: { id: ephemeralSessionId },
-        body: {
-          agent: agentName,
-          tools: { write: false, edit: false, patch: false },
-          parts: [{ type: "text", text: userInput }]
+      let promptResult;
+      try {
+        promptResult = await client.session.prompt({
+          path: { id: ephemeralSessionId },
+          body: {
+            agent: agentName,
+            tools: { write: false, edit: false, patch: false },
+            parts: [{ type: "text", text: userInput }]
+          }
+        });
+      } catch (promptErr) {
+        if (signal?.aborted) {
+          throw new Error("CURATOR_LLM_TIMEOUT");
         }
-      });
+        throw promptErr;
+      }
       if (!promptResult.data) {
         throw new Error(`Curator LLM prompt failed: ${JSON.stringify(promptResult.error)}`);
       }
@@ -76307,10 +76425,10 @@ async function getRunMemorySummary(directory) {
   if (entries.length === 0) {
     return null;
   }
-  const groups = _internals26.groupByTaskId(entries);
+  const groups = _internals27.groupByTaskId(entries);
   const summaries = [];
   for (const [taskId, taskEntries] of groups) {
-    const summary = _internals26.summarizeTask(taskId, taskEntries);
+    const summary = _internals27.summarizeTask(taskId, taskEntries);
     if (summary) {
       summaries.push(summary);
     }
@@ -76343,7 +76461,7 @@ Use this data to avoid repeating known failure patterns.`;
   }
   return prefix + summaryText + suffix;
 }
-var _internals26 = {
+var _internals27 = {
   generateTaskFingerprint,
   recordOutcome,
   getTaskHistory,
@@ -86442,11 +86560,11 @@ var quality_budget = createSwarmTool({
     }).optional().describe("Quality budget thresholds")
   },
   async execute(args2, directory) {
-    const result = await _internals28.qualityBudget(args2, directory);
+    const result = await _internals29.qualityBudget(args2, directory);
     return JSON.stringify(result);
   }
 });
-var _internals28 = {
+var _internals29 = {
   qualityBudget
 };
 
@@ -87175,7 +87293,7 @@ import * as path97 from "node:path";
 var semgrepAvailableCache = null;
 var DEFAULT_RULES_DIR = ".swarm/semgrep-rules";
 var DEFAULT_TIMEOUT_MS3 = 30000;
-var _internals29 = {
+var _internals30 = {
   isSemgrepAvailable,
   checkSemgrepAvailable,
   resetSemgrepCache,
@@ -87200,7 +87318,7 @@ function isSemgrepAvailable() {
   }
 }
 async function checkSemgrepAvailable() {
-  return _internals29.isSemgrepAvailable();
+  return _internals30.isSemgrepAvailable();
 }
 function resetSemgrepCache() {
   semgrepAvailableCache = null;
@@ -87297,12 +87415,12 @@ async function runSemgrep(options) {
   const timeoutMs = options.timeoutMs || DEFAULT_TIMEOUT_MS3;
   if (files.length === 0) {
     return {
-      available: _internals29.isSemgrepAvailable(),
+      available: _internals30.isSemgrepAvailable(),
       findings: [],
       engine: "tier_a"
     };
   }
-  if (!_internals29.isSemgrepAvailable()) {
+  if (!_internals30.isSemgrepAvailable()) {
     return {
       available: false,
       findings: [],
@@ -87461,7 +87579,7 @@ function assignOccurrenceIndices(findings, directory) {
     }
     const occIdx = countMap.get(baseKey) ?? 0;
     countMap.set(baseKey, occIdx + 1);
-    const fp = _internals30.fingerprintFinding(finding, directory, occIdx);
+    const fp = _internals31.fingerprintFinding(finding, directory, occIdx);
     return {
       finding,
       index: occIdx,
@@ -87530,7 +87648,7 @@ async function captureOrMergeBaseline(directory, phase, findings, engine, scanne
       }
     } catch {}
     const scannedRelFiles = new Set(scannedFiles.map((f) => normalizeFindingPath(directory, f)));
-    const indexed = _internals30.assignOccurrenceIndices(findings, directory);
+    const indexed = _internals31.assignOccurrenceIndices(findings, directory);
     if (existing && !opts?.force) {
       const prunedFingerprints = existing.fingerprints.filter((fp) => {
         const relFile = fp.slice(0, fp.indexOf("|"));
@@ -87670,7 +87788,7 @@ function loadBaseline(directory, phase) {
     };
   }
 }
-var _internals30 = {
+var _internals31 = {
   fingerprintFinding,
   assignOccurrenceIndices,
   captureOrMergeBaseline,
@@ -88080,11 +88198,11 @@ var sast_scan = createSwarmTool({
       capture_baseline: safeArgs.capture_baseline,
       phase: safeArgs.phase
     };
-    const result = await _internals31.sastScan(input, directory);
+    const result = await _internals32.sastScan(input, directory);
     return JSON.stringify(result, null, 2);
   }
 });
-var _internals31 = {
+var _internals32 = {
   sastScan,
   sast_scan
 };
@@ -92438,7 +92556,7 @@ import * as path110 from "node:path";
 
 // src/mutation/engine.ts
 import { spawnSync as spawnSync3 } from "node:child_process";
-import { unlinkSync as unlinkSync13, writeFileSync as writeFileSync22 } from "node:fs";
+import { unlinkSync as unlinkSync14, writeFileSync as writeFileSync22 } from "node:fs";
 import * as path109 from "node:path";
 
 // src/mutation/equivalence.ts
@@ -92511,7 +92629,7 @@ function isStaticallyEquivalent(originalCode, mutatedCode) {
   const strippedMutated = stripCode(mutatedCode);
   return strippedOriginal === strippedMutated;
 }
-var _internals32 = {
+var _internals33 = {
   isStaticallyEquivalent,
   checkEquivalence,
   batchCheckEquivalence
@@ -92551,7 +92669,7 @@ async function batchCheckEquivalence(patches, llmJudge) {
   const results = [];
   for (const { patch, originalCode, mutatedCode } of patches) {
     try {
-      const result = await _internals32.checkEquivalence(patch, originalCode, mutatedCode, llmJudge);
+      const result = await _internals33.checkEquivalence(patch, originalCode, mutatedCode, llmJudge);
       results.push(result);
     } catch (err3) {
       results.push({
@@ -92677,7 +92795,7 @@ async function executeMutation(patch, testCommand, _testFiles, workingDir) {
         revertError = new Error(`Failed to revert mutation ${patch.id}: ${revertErr}. Working tree may be dirty.`);
       }
       try {
-        unlinkSync13(patchFile);
+        unlinkSync14(patchFile);
       } catch (_unlinkErr) {}
     }
   }
@@ -92851,7 +92969,7 @@ async function executeMutationSuite(patches, testCommand, testFiles, workingDir,
 }
 
 // src/mutation/gate.ts
-var _internals33 = {
+var _internals34 = {
   evaluateMutationGate,
   buildTestImprovementPrompt,
   buildMessage
@@ -92872,8 +92990,8 @@ function evaluateMutationGate(report, passThreshold = PASS_THRESHOLD, warnThresh
   } else {
     verdict = "fail";
   }
-  const testImprovementPrompt = _internals33.buildTestImprovementPrompt(report, passThreshold, verdict);
-  const message = _internals33.buildMessage(verdict, adjustedKillRate, report.killed, report.totalMutants, report.equivalent, warnThreshold);
+  const testImprovementPrompt = _internals34.buildTestImprovementPrompt(report, passThreshold, verdict);
+  const message = _internals34.buildMessage(verdict, adjustedKillRate, report.killed, report.totalMutants, report.equivalent, warnThreshold);
   return {
     verdict,
     killRate: report.killRate,
@@ -93490,7 +93608,7 @@ import * as path114 from "node:path";
 init_bun_compat();
 import * as fs92 from "node:fs";
 import * as path113 from "node:path";
-var _internals34 = { bunSpawn };
+var _internals35 = { bunSpawn };
 var _swarmGitExcludedChecked = false;
 function fileCoversSwarm(content) {
   for (const rawLine of content.split(`
@@ -93523,7 +93641,7 @@ async function ensureSwarmGitExcluded(directory, options = {}) {
       checkIgnoreExitCode
     ] = await Promise.all([
       (async () => {
-        const proc = _internals34.bunSpawn(["git", "-C", directory, "rev-parse", "--show-toplevel"], GIT_SPAWN_OPTIONS);
+        const proc = _internals35.bunSpawn(["git", "-C", directory, "rev-parse", "--show-toplevel"], GIT_SPAWN_OPTIONS);
         try {
           return await Promise.all([proc.exited, proc.stdout.text()]);
         } finally {
@@ -93533,7 +93651,7 @@ async function ensureSwarmGitExcluded(directory, options = {}) {
         }
       })(),
       (async () => {
-        const proc = _internals34.bunSpawn(["git", "-C", directory, "rev-parse", "--git-path", "info/exclude"], GIT_SPAWN_OPTIONS);
+        const proc = _internals35.bunSpawn(["git", "-C", directory, "rev-parse", "--git-path", "info/exclude"], GIT_SPAWN_OPTIONS);
         try {
           return await Promise.all([proc.exited, proc.stdout.text()]);
         } finally {
@@ -93543,7 +93661,7 @@ async function ensureSwarmGitExcluded(directory, options = {}) {
         }
       })(),
       (async () => {
-        const proc = _internals34.bunSpawn(["git", "-C", directory, "check-ignore", "-q", ".swarm/.gitkeep"], GIT_SPAWN_OPTIONS);
+        const proc = _internals35.bunSpawn(["git", "-C", directory, "check-ignore", "-q", ".swarm/.gitkeep"], GIT_SPAWN_OPTIONS);
         try {
           return await proc.exited;
         } finally {
@@ -93582,7 +93700,7 @@ async function ensureSwarmGitExcluded(directory, options = {}) {
         }
       } catch {}
     }
-    const trackedProc = _internals34.bunSpawn(["git", "-C", directory, "ls-files", "--", ".swarm"], GIT_SPAWN_OPTIONS);
+    const trackedProc = _internals35.bunSpawn(["git", "-C", directory, "ls-files", "--", ".swarm"], GIT_SPAWN_OPTIONS);
     let trackedExitCode;
     let trackedOutput;
     try {
@@ -93607,7 +93725,7 @@ async function ensureSwarmGitExcluded(directory, options = {}) {
 }
 
 // src/hooks/diff-scope.ts
-var _internals35 = { bunSpawn };
+var _internals36 = { bunSpawn };
 function getDeclaredScope(taskId, directory) {
   try {
     const planPath = path114.join(directory, ".swarm", "plan.json");
@@ -93642,7 +93760,7 @@ var GIT_DIFF_SPAWN_OPTIONS = {
 };
 async function getChangedFiles(directory) {
   try {
-    const proc = _internals35.bunSpawn(["git", "diff", "--name-only", "HEAD~1"], {
+    const proc = _internals36.bunSpawn(["git", "diff", "--name-only", "HEAD~1"], {
       cwd: directory,
       ...GIT_DIFF_SPAWN_OPTIONS
     });
@@ -93659,7 +93777,7 @@ async function getChangedFiles(directory) {
       return stdout.trim().split(`
 `).map((f) => f.trim()).filter((f) => f.length > 0);
     }
-    const proc2 = _internals35.bunSpawn(["git", "diff", "--name-only", "HEAD"], {
+    const proc2 = _internals36.bunSpawn(["git", "diff", "--name-only", "HEAD"], {
       cwd: directory,
       ...GIT_DIFF_SPAWN_OPTIONS
     });
@@ -95346,7 +95464,7 @@ async function initializeOpenCodeSwarm(ctx) {
         ...opencodeConfig.command || {},
         swarm: {
           template: "/swarm $ARGUMENTS",
-          description: "Swarm management commands: /swarm [status|plan|agents|history|config|evidence|handoff|archive|diagnose|diagnosis|preflight|sync-plan|benchmark|export|reset|rollback|retrieve|clarify|analyze|specify|brainstorm|council|qa-gates|dark-matter|knowledge|curate|turbo|full-auto|write-retro|reset-session|simulate|promote|checkpoint|acknowledge-spec-drift|doctor-tools|close]"
+          description: "Swarm management commands: /swarm [status|plan|agents|history|config|evidence|handoff|archive|diagnose|diagnosis|preflight|sync-plan|benchmark|export|reset|rollback|retrieve|clarify|analyze|specify|brainstorm|council|pr-review|issue|qa-gates|dark-matter|knowledge|curate|turbo|full-auto|write-retro|reset-session|simulate|promote|checkpoint|acknowledge-spec-drift|doctor-tools|close]"
         },
         "swarm-status": {
           template: "/swarm status",
@@ -95436,6 +95554,14 @@ async function initializeOpenCodeSwarm(ctx) {
           template: "/swarm council $ARGUMENTS",
           description: "Use /swarm council <question> to convene a multi-model General Council deliberation (generalist / skeptic / domain expert) [--spec-review]"
         },
+        "swarm-pr-review": {
+          template: "/swarm pr-review $ARGUMENTS",
+          description: "Use /swarm pr-review to launch deep PR review with multi-lane analysis"
+        },
+        "swarm-issue": {
+          template: "/swarm issue $ARGUMENTS",
+          description: "Use /swarm issue to ingest a GitHub issue into the swarm workflow"
+        },
         "swarm-qa-gates": {
           template: "/swarm qa-gates $ARGUMENTS",
           description: "Use /swarm qa-gates to view or modify QA gate profile for the current plan"
@@ -95457,7 +95583,7 @@ async function initializeOpenCodeSwarm(ctx) {
           description: "Use /swarm turbo to enable turbo mode for faster execution"
         },
         "swarm-full-auto": {
-          template: "/swarm-full-auto $ARGUMENTS",
+          template: "/swarm full-auto $ARGUMENTS",
           description: "Toggle Full-Auto Mode for the active session [on|off]"
         },
         "swarm-write-retro": {

package/dist/lang/runtime.d.ts

@@ -4,6 +4,16 @@ export type Parser = ParserType;
  * Parser cache to avoid reloading grammars multiple times per session
  */
 export declare const parserCache: Map<string, ParserType>;
+/**
+ * DI seam for testing — overridable reference to TreeSitterParser.init.
+ * Tests can replace this with a spy/mock to observe init calls without
+ * mock.module leakage. Restore the original reference in afterEach.
+ */
+export declare const _internals: {
+    parserInit: (opts?: {
+        locateFile: (scriptName: string) => string;
+    }) => Promise<void>;
+};
 /**
  * Initialize a parser for the given language
  * Loads WASM from dist/lang/grammars/ (copied during build)

package/package.json

@@ -1,6 +1,6 @@
 {
 	"name": "opencode-swarm",
-	"version": "7.8.0",
+	"version": "7.9.0",
 	"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",