opencode-swarm 7.52.3 → 7.54.0

package/dist/index.js

@@ -69,7 +69,7 @@ var package_default;
 var init_package = __esm(() => {
   package_default = {
     name: "opencode-swarm",
-    version: "7.52.3",
+    version: "7.54.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",
@@ -566,11 +566,11 @@ var init_tool_metadata = __esm(() => {
       agents: ["architect"]
     },
     web_search: {
-      description: "External web search (Tavily or Brave) for architect-driven council research. Returns titled results with snippets and URLs. Config-gated on council.general.enabled; requires a search API key. Used by the architect in MODE: COUNCIL to gather a RESEARCH CONTEXT before dispatching council agents.",
+      description: "External web search (Tavily or Brave) for architect-driven council research. Returns titled results with snippets, URLs, normalized query metadata, temporal intent, freshness, and removed stale years. Config-gated on council.general.enabled in the resolved config: global ~/.config/opencode/opencode-swarm.json, then project .opencode/opencode-swarm.json overrides. Requires a search API key. Used by the architect in MODE: COUNCIL to gather a RESEARCH CONTEXT before dispatching council agents.",
       agents: ["architect", "skill_improver"]
     },
     convene_general_council: {
-      description: "Synthesize responses from a multi-model General Council. Accepts parallel member responses (Round 1, optionally Round 2), detects disagreements, and returns consensus points, persisting disagreements, and a structured synthesis. Architect-only. Config-gated on council.general.enabled.",
+      description: "Synthesize responses from a multi-model General Council. Accepts parallel member responses (Round 1, optionally Round 2), detects disagreements, and returns consensus points, persisting disagreements, and a structured synthesis. Architect-only. Config-gated on council.general.enabled in the resolved config: global ~/.config/opencode/opencode-swarm.json, then project .opencode/opencode-swarm.json overrides.",
       agents: ["architect"]
     },
     write_final_council_evidence: {
@@ -40596,6 +40596,18 @@ import * as path19 from "node:path";
 function clearPendingCoderScope() {
   pendingCoderScopeByTaskId.clear();
 }
+function isBackgroundTrue(value) {
+  return value === true || value === "true";
+}
+function outputLooksLikeBackgroundRunning(output) {
+  if (typeof output !== "object" || output === null)
+    return false;
+  const o = output;
+  if (o.state === "running")
+    return true;
+  const metadata2 = o.metadata;
+  return typeof metadata2 === "object" && metadata2 !== null && metadata2.background === true;
+}
 function extractTaskLine(text) {
   const match = text.match(/TASK:\s*(.+?)(?:\n|$)/i);
   return match ? match[1].trim() : null;
@@ -40874,6 +40886,9 @@ function createDelegationGateHook(config2, directory) {
     if (typeof subagentType !== "string")
       return;
     const targetAgent = stripKnownSwarmPrefix(subagentType);
+    if (isBackgroundTrue(args2.background) && isKnownCanonicalRole(targetAgent)) {
+      throw new Error(SWARM_BACKGROUND_TASK_BLOCKED_MESSAGE);
+    }
     if (targetAgent === "reviewer") {
       try {
         const reviewSession = swarmState.agentSessions.get(input.sessionID);
@@ -40974,6 +40989,11 @@ function createDelegationGateHook(config2, directory) {
       const directArgs = input.args;
       const storedArgs = getStoredInputArgs(input.callID);
       const subagentType = directArgs?.subagent_type ?? storedArgs?.subagent_type;
+      if (typeof subagentType === "string" && isKnownCanonicalRole(stripKnownSwarmPrefix(subagentType)) && (isBackgroundTrue(directArgs?.background) || isBackgroundTrue(storedArgs?.background) || outputLooksLikeBackgroundRunning(_output))) {
+        if (storedArgs !== undefined)
+          deleteStoredInputArgs(input.callID);
+        return;
+      }
       let hasReviewer = false;
       let hasTestEngineer = false;
       if (typeof subagentType === "string") {
@@ -41451,7 +41471,7 @@ ${warningLines.join(`
     toolAfter
   };
 }
-var EvidenceTaskIdPlanSchema, pendingCoderScopeByTaskId, ACTIVE_PARALLEL_TASK_STATES;
+var EvidenceTaskIdPlanSchema, pendingCoderScopeByTaskId, SWARM_BACKGROUND_TASK_BLOCKED_MESSAGE, ACTIVE_PARALLEL_TASK_STATES;
 var init_delegation_gate = __esm(() => {
   init_zod();
   init_schema();
@@ -41472,6 +41492,7 @@ var init_delegation_gate = __esm(() => {
     }).passthrough()).optional()
   }).passthrough();
   pendingCoderScopeByTaskId = new Map;
+  SWARM_BACKGROUND_TASK_BLOCKED_MESSAGE = "SWARM_BACKGROUND_TASK_BLOCKED: OpenCode background subagents (Task with background=true, " + "requires OPENCODE_EXPERIMENTAL_BACKGROUND_SUBAGENTS=true) are recognized upstream, but swarm " + "cannot yet safely consume their deferred completion events — the Task returns a running " + "placeholder now and completes later via synthetic injection, which would advance swarm gates " + "before any review/test output exists. Omit `background` (or set background=false) for swarm " + "delegations until the completion-ingestion PR lands.";
   ACTIVE_PARALLEL_TASK_STATES = new Set([
     "coder_delegated",
     "pre_check_passed",
@@ -62057,7 +62078,7 @@ var init_council = __esm(() => {
     "  --preset <name>  Use a named member preset from council.general.presets",
     "  --spec-review    Use spec_review mode (single advisory pass on a draft spec)",
     "",
-    "Requires council.general.enabled: true and a configured search API key in opencode-swarm.json."
+    "Requires council.general.enabled: true and a configured search API key in the resolved config: global ~/.config/opencode/opencode-swarm.json, then project .opencode/opencode-swarm.json overrides."
   ].join(`
 `);
 });
@@ -73213,7 +73234,7 @@ var init_plan = __esm(() => {
   init_plan_service();
 });
 
-// src/commands/pr-review.ts
+// src/commands/pr-ref.ts
 import { execSync as execSync3 } from "node:child_process";
 function sanitizeUrl2(raw) {
   let urlStr = raw.trim();
@@ -73232,6 +73253,22 @@ function sanitizeUrl2(raw) {
   }
   return urlStr.trim();
 }
+function sanitizeInstructions(raw) {
+  const collapsed = raw.replace(/\s+/g, " ").trim();
+  const stripped = collapsed.replace(/\[\s*MODE\s*:[^\]]*\]/gi, "");
+  const normalized = stripped.replace(/\s+/g, " ").trim();
+  if (normalized.length <= MAX_INSTRUCTIONS_LEN)
+    return normalized;
+  return `${normalized.slice(0, MAX_INSTRUCTIONS_LEN)}…`;
+}
+function hasNonAsciiHostname(hostname5) {
+  for (const ch of hostname5) {
+    const cp = ch.codePointAt(0);
+    if (cp !== undefined && cp > 127)
+      return true;
+  }
+  return false;
+}
 function isPrivateHost2(url3) {
   const host = url3.hostname.toLowerCase();
   if (host === "localhost" || host === "127.0.0.1" || host === "::1" || host === "0.0.0.0") {
@@ -73266,8 +73303,7 @@ function validateAndSanitizeUrl2(rawUrl) {
   }
   try {
     const url3 = new URL(sanitized);
-    const hostname5 = url3.hostname;
-    if (/[\u0080-\u{10FFFF}]/u.test(hostname5)) {
+    if (hasNonAsciiHostname(url3.hostname)) {
       return { error: "Non-ASCII hostnames are not allowed" };
     }
     if (isPrivateHost2(url3)) {
@@ -73284,18 +73320,7 @@ function validateAndSanitizeUrl2(rawUrl) {
     return { error: "Invalid URL format" };
   }
 }
-function parseArgs5(args2) {
-  const out2 = { council: false, rest: [] };
-  for (const token of args2) {
-    if (token === "--council") {
-      out2.council = true;
-      continue;
-    }
-    out2.rest.push(token);
-  }
-  return out2;
-}
-function parsePrRef(input) {
+function parsePrRef(input, cwd) {
   const urlMatch = input.match(/^https:\/\/github\.com\/([^/]+)\/([^/]+)\/pull\/(\d+)\/?$/i);
   if (urlMatch) {
     return {
@@ -73315,7 +73340,7 @@ function parsePrRef(input) {
   const bareMatch = input.match(/^(\d+)$/);
   if (bareMatch) {
     const prNumber = parseInt(bareMatch[1], 10);
-    const remoteUrl = detectGitRemote2();
+    const remoteUrl = detectGitRemote2(cwd);
     if (!remoteUrl) {
       return null;
     }
@@ -73331,12 +73356,13 @@ function parsePrRef(input) {
   }
   return null;
 }
-function detectGitRemote2() {
+function detectGitRemote2(cwd) {
   try {
-    const remoteUrl = execSync3("git remote get-url origin", {
+    const remoteUrl = _internals31.execSync("git remote get-url origin", {
       encoding: "utf-8",
       stdio: ["pipe", "pipe", "pipe"],
-      timeout: 5000
+      timeout: 5000,
+      ...cwd ? { cwd } : {}
     }).trim();
     return remoteUrl || null;
   } catch {
@@ -73367,41 +73393,115 @@ function parseGitRemoteUrl2(remoteUrl) {
   }
   return null;
 }
-function handlePrReviewCommand(_directory, args2) {
-  const parsed = parseArgs5(args2);
-  const rawInput = parsed.rest.join(" ").trim();
-  if (!rawInput) {
-    return USAGE5;
+function looksLikePrRef(token) {
+  return /^https?:\/\//i.test(token) || /^[^/]+\/[^#]+#\d+$/.test(token) || /^\d+$/.test(token);
+}
+function resolvePrCommandInput(rest, cwd) {
+  if (rest.length === 0) {
+    return null;
   }
-  const isFullUrl = /^https?:\/\//i.test(rawInput);
-  const prInfo = parsePrRef(isFullUrl ? sanitizeUrl2(rawInput) : rawInput);
+  const refToken = rest[0];
+  const instructions = sanitizeInstructions(rest.slice(1).join(" "));
+  const isFullUrl = /^https?:\/\//i.test(refToken);
+  const prInfo = parsePrRef(isFullUrl ? sanitizeUrl2(refToken) : refToken, cwd);
   if (!prInfo) {
-    return `Error: Could not parse PR reference from "${rawInput}"
-
-${USAGE5}`;
+    return { error: `Could not parse PR reference from "${refToken}"` };
   }
   const prUrl = `https://github.com/${prInfo.owner}/${prInfo.repo}/pull/${prInfo.number}`;
   const result = validateAndSanitizeUrl2(prUrl);
   if ("error" in result) {
-    return `Error: ${result.error}
+    return { error: result.error };
+  }
+  return { prUrl: result.sanitized, instructions };
+}
+var _internals31, MAX_URL_LEN2 = 2048, MAX_INSTRUCTIONS_LEN = 1000;
+var init_pr_ref = __esm(() => {
+  _internals31 = { execSync: execSync3 };
+});
+
+// src/commands/pr-feedback.ts
+function handlePrFeedbackCommand(directory, args2) {
+  const rest = args2.filter((t) => t.trim().length > 0);
+  if (rest.length === 0) {
+    return "[MODE: PR_FEEDBACK]";
+  }
+  const resolved = resolvePrCommandInput(rest, directory);
+  if (resolved && "prUrl" in resolved) {
+    const signal = `[MODE: PR_FEEDBACK pr="${resolved.prUrl}"]`;
+    return resolved.instructions ? `${signal} ${resolved.instructions}` : signal;
+  }
+  if (resolved && "error" in resolved && looksLikePrRef(rest[0])) {
+    return [
+      `Error: ${resolved.error}`,
+      "",
+      "That looked like a PR reference but could not be resolved. Pass a full",
+      "URL or `owner/repo#N`, or omit the reference to start a no-PR feedback",
+      "session (e.g. `/swarm pr-feedback address the review notes`)."
+    ].join(`
+`);
+  }
+  const instructions = sanitizeInstructions(rest.join(" "));
+  return instructions ? `[MODE: PR_FEEDBACK] ${instructions}` : "[MODE: PR_FEEDBACK]";
+}
+var init_pr_feedback = __esm(() => {
+  init_pr_ref();
+});
+
+// src/commands/pr-review.ts
+function parseArgs5(args2) {
+  const out2 = { council: false, rest: [] };
+  for (const token of args2) {
+    if (token === "--council") {
+      out2.council = true;
+      continue;
+    }
+    if (token.startsWith("--")) {
+      if (out2.unknownFlag === undefined)
+        out2.unknownFlag = token;
+      continue;
+    }
+    if (token.trim().length === 0)
+      continue;
+    out2.rest.push(token);
+  }
+  return out2;
+}
+function handlePrReviewCommand(directory, args2) {
+  const parsed = parseArgs5(args2);
+  if (parsed.unknownFlag) {
+    return `Error: Unknown flag "${parsed.unknownFlag}"
+
+${USAGE5}`;
+  }
+  const resolved = resolvePrCommandInput(parsed.rest, directory);
+  if (resolved === null) {
+    return USAGE5;
+  }
+  if ("error" in resolved) {
+    return `Error: ${resolved.error}
 
 ${USAGE5}`;
   }
   const councilFlag = parsed.council ? "council=true" : "council=false";
-  return `[MODE: PR_REVIEW pr="${result.sanitized}" ${councilFlag}]`;
+  const signal = `[MODE: PR_REVIEW pr="${resolved.prUrl}" ${councilFlag}]`;
+  return resolved.instructions ? `${signal} ${resolved.instructions}` : signal;
 }
-var MAX_URL_LEN2 = 2048, USAGE5;
+var USAGE5;
 var init_pr_review = __esm(() => {
+  init_pr_ref();
   USAGE5 = [
-    "Usage: /swarm pr-review <url|owner/repo#N|N> [--council]",
+    "Usage: /swarm pr-review <url|owner/repo#N|N> [--council] [instructions...]",
     "",
     "Run a full swarm PR review on a GitHub pull request.",
     "  /swarm pr-review https://github.com/owner/repo/pull/42",
     "  /swarm pr-review owner/repo#42",
     "  /swarm pr-review 42 --council",
+    "  /swarm pr-review 42 focus on the auth refactor and the new retry logic",
     "",
     "Flags:",
-    "  --council     Run adversarial council variant (all lanes assume work is wrong)"
+    "  --council     Run adversarial council variant (all lanes assume work is wrong)",
+    "",
+    "Any text after the PR reference is forwarded to the reviewer as extra instructions."
   ].join(`
 `);
 });
@@ -73843,7 +73943,7 @@ async function runAdditionalLint(linter, mode, cwd) {
     };
   }
 }
-var MAX_OUTPUT_BYTES = 512000, MAX_COMMAND_LENGTH = 500, lint, _internals31;
+var MAX_OUTPUT_BYTES = 512000, MAX_COMMAND_LENGTH = 500, lint, _internals32;
 var init_lint = __esm(() => {
   init_zod();
   init_discovery();
@@ -73875,15 +73975,15 @@ var init_lint = __esm(() => {
       }
       const { mode } = args2;
       const cwd = directory;
-      const linter = await _internals31.detectAvailableLinter(directory);
+      const linter = await _internals32.detectAvailableLinter(directory);
       if (linter) {
-        const result = await _internals31.runLint(linter, mode, directory);
+        const result = await _internals32.runLint(linter, mode, directory);
         return JSON.stringify(result, null, 2);
       }
-      const additionalLinter = _internals31.detectAdditionalLinter(cwd);
+      const additionalLinter = _internals32.detectAdditionalLinter(cwd);
       if (additionalLinter) {
         warn(`[lint] Using ${additionalLinter} linter for this project`);
-        const result = await _internals31.runAdditionalLint(additionalLinter, mode, cwd);
+        const result = await _internals32.runAdditionalLint(additionalLinter, mode, cwd);
         return JSON.stringify(result, null, 2);
       }
       const errorResult = {
@@ -73897,7 +73997,7 @@ For Rust: rustup component add clippy`
       return JSON.stringify(errorResult, null, 2);
     }
   });
-  _internals31 = {
+  _internals32 = {
     detectAvailableLinter,
     runLint,
     detectAdditionalLinter,
@@ -74211,7 +74311,7 @@ function findScannableFiles(dir, excludeExact, excludeGlobs, scanDir, visited, s
 }
 async function runSecretscan(directory) {
   try {
-    const result = await _internals32.secretscan.execute({ directory }, {});
+    const result = await _internals33.secretscan.execute({ directory }, {});
     const jsonStr = typeof result === "string" ? result : result.output;
     return JSON.parse(jsonStr);
   } catch (e) {
@@ -74226,7 +74326,7 @@ async function runSecretscan(directory) {
     return errorResult;
   }
 }
-var MAX_FILE_PATH_LENGTH = 500, MAX_FILE_SIZE_BYTES, MAX_FILES_SCANNED = 1000, MAX_FINDINGS = 100, MAX_OUTPUT_BYTES2 = 512000, MAX_LINE_LENGTH = 1e4, MAX_CONTENT_BYTES, BINARY_SIGNATURES, BINARY_PREFIX_BYTES = 4, BINARY_NULL_CHECK_BYTES = 8192, BINARY_NULL_THRESHOLD = 0.1, DEFAULT_EXCLUDE_DIRS, DEFAULT_EXCLUDE_EXTENSIONS, SECRET_PATTERNS2, O_NOFOLLOW, secretscan, _internals32;
+var MAX_FILE_PATH_LENGTH = 500, MAX_FILE_SIZE_BYTES, MAX_FILES_SCANNED = 1000, MAX_FINDINGS = 100, MAX_OUTPUT_BYTES2 = 512000, MAX_LINE_LENGTH = 1e4, MAX_CONTENT_BYTES, BINARY_SIGNATURES, BINARY_PREFIX_BYTES = 4, BINARY_NULL_CHECK_BYTES = 8192, BINARY_NULL_THRESHOLD = 0.1, DEFAULT_EXCLUDE_DIRS, DEFAULT_EXCLUDE_EXTENSIONS, SECRET_PATTERNS2, O_NOFOLLOW, secretscan, _internals33;
 var init_secretscan = __esm(() => {
   init_zod();
   init_path_security();
@@ -74598,7 +74698,7 @@ var init_secretscan = __esm(() => {
       }
     }
   });
-  _internals32 = {
+  _internals33 = {
     secretscan,
     runSecretscan
   };
@@ -75190,14 +75290,14 @@ function buildGoBackend() {
     selectEntryPoints
   };
 }
-var PROFILE_ID = "go", IMPORT_REGEX_SINGLE, IMPORT_REGEX_GROUP, IMPORT_REGEX_GROUP_LINE, _internals33;
+var PROFILE_ID = "go", IMPORT_REGEX_SINGLE, IMPORT_REGEX_GROUP, IMPORT_REGEX_GROUP_LINE, _internals34;
 var init_go = __esm(() => {
   init_default_backend();
   init_profiles();
   IMPORT_REGEX_SINGLE = /^\s*import\s+(?:[a-zA-Z_.][a-zA-Z0-9_]*\s+)?"([^"]+)"/gm;
   IMPORT_REGEX_GROUP = /^\s*import\s*\(([\s\S]*?)\)/gm;
   IMPORT_REGEX_GROUP_LINE = /(?:[a-zA-Z_.][a-zA-Z0-9_]*\s+)?"([^"]+)"/g;
-  _internals33 = { extractImports };
+  _internals34 = { extractImports };
 });
 
 // src/lang/backends/python.ts
@@ -75309,13 +75409,13 @@ function buildPythonBackend() {
     selectEntryPoints: selectEntryPoints2
   };
 }
-var PROFILE_ID2 = "python", IMPORT_REGEX_FROM_WITH_TARGETS, IMPORT_REGEX_IMPORT, _internals34;
+var PROFILE_ID2 = "python", IMPORT_REGEX_FROM_WITH_TARGETS, IMPORT_REGEX_IMPORT, _internals35;
 var init_python = __esm(() => {
   init_default_backend();
   init_profiles();
   IMPORT_REGEX_FROM_WITH_TARGETS = /^\s*from\s+(\.*[\w.]*)\s+import\s+(\([^)]*\)|[^\n#]+)/gm;
   IMPORT_REGEX_IMPORT = /^\s*import\s+([^\n#]+)/gm;
-  _internals34 = { extractImports: extractImports2 };
+  _internals35 = { extractImports: extractImports2 };
 });
 
 // src/test-impact/analyzer.ts
@@ -75539,7 +75639,7 @@ function addImpactEdgesForTestFile(testFile, content, impactMap) {
     return;
   }
   if (PYTHON_EXTENSIONS.has(ext)) {
-    const modules = _internals34.extractImports(testFile, content);
+    const modules = _internals35.extractImports(testFile, content);
     for (const mod of modules) {
       const resolved = resolvePythonImport(testDir, mod);
       if (resolved !== null)
@@ -75548,7 +75648,7 @@ function addImpactEdgesForTestFile(testFile, content, impactMap) {
     return;
   }
   if (GO_EXTENSIONS.has(ext)) {
-    const imports = _internals33.extractImports(testFile, content);
+    const imports = _internals34.extractImports(testFile, content);
     for (const importPath of imports) {
       const sourceFiles = resolveGoImport(testDir, importPath);
       for (const source of sourceFiles)
@@ -75575,8 +75675,8 @@ async function buildImpactMapInternal(cwd) {
   return impactMap;
 }
 async function buildImpactMap(cwd) {
-  const impactMap = await _internals35.buildImpactMapInternal(cwd);
-  await _internals35.saveImpactMap(cwd, impactMap);
+  const impactMap = await _internals36.buildImpactMapInternal(cwd);
+  await _internals36.saveImpactMap(cwd, impactMap);
   return impactMap;
 }
 async function loadImpactMap(cwd, options) {
@@ -75590,7 +75690,7 @@ async function loadImpactMap(cwd, options) {
         const hasValidValues = Object.values(map3).every((v) => Array.isArray(v) && v.every((item) => typeof item === "string"));
         if (hasValidValues) {
           const generatedAt = new Date(data.generatedAt).getTime();
-          if (!_internals35.isCacheStale(map3, generatedAt)) {
+          if (!_internals36.isCacheStale(map3, generatedAt)) {
             return map3;
           }
           if (options?.skipRebuild) {
@@ -75610,13 +75710,13 @@ async function loadImpactMap(cwd, options) {
   if (options?.skipRebuild) {
     return {};
   }
-  return _internals35.buildImpactMap(cwd);
+  return _internals36.buildImpactMap(cwd);
 }
 async function saveImpactMap(cwd, impactMap) {
   if (!path55.isAbsolute(cwd)) {
     throw new Error(`saveImpactMap requires an absolute project root path, got: "${cwd}"`);
   }
-  _internals35.validateProjectRoot(cwd);
+  _internals36.validateProjectRoot(cwd);
   const cacheDir2 = path55.join(cwd, ".swarm", "cache");
   const cachePath = path55.join(cacheDir2, "impact-map.json");
   if (!fs28.existsSync(cacheDir2)) {
@@ -75640,7 +75740,7 @@ async function analyzeImpact(changedFiles, cwd, budget) {
     };
   }
   const validFiles = changedFiles.filter((f) => typeof f === "string" && f.length > 0 && !f.includes("\x00"));
-  const impactMap = await _internals35.loadImpactMap(cwd);
+  const impactMap = await _internals36.loadImpactMap(cwd);
   const impactedTestsSet = new Set;
   const untestedFiles = [];
   let visitedCount = 0;
@@ -75725,7 +75825,7 @@ async function analyzeImpact(changedFiles, cwd, budget) {
     budgetExceeded
   };
 }
-var IMPORT_REGEX_ES, IMPORT_REGEX_REQUIRE, IMPORT_REGEX_REEXPORT, TS_EXTENSIONS, PYTHON_EXTENSIONS, GO_EXTENSIONS, EXTENSIONS_TO_TRY, goModuleCache, _internals35;
+var IMPORT_REGEX_ES, IMPORT_REGEX_REQUIRE, IMPORT_REGEX_REEXPORT, TS_EXTENSIONS, PYTHON_EXTENSIONS, GO_EXTENSIONS, EXTENSIONS_TO_TRY, goModuleCache, _internals36;
 var init_analyzer = __esm(() => {
   init_manager2();
   init_go();
@@ -75738,7 +75838,7 @@ var init_analyzer = __esm(() => {
   GO_EXTENSIONS = new Set([".go"]);
   EXTENSIONS_TO_TRY = [".ts", ".tsx", ".js", ".jsx", ".mjs", ".cjs"];
   goModuleCache = new Map;
-  _internals35 = {
+  _internals36 = {
     validateProjectRoot,
     normalizePath,
     isCacheStale,
@@ -76074,7 +76174,7 @@ function batchAppendTestRuns(records, workingDir) {
   }
   const historyPath = getHistoryPath(workingDir);
   const historyDir = path56.dirname(historyPath);
-  _internals36.validateProjectRoot(workingDir);
+  _internals37.validateProjectRoot(workingDir);
   if (!fs29.existsSync(historyDir)) {
     fs29.mkdirSync(historyDir, { recursive: true });
   }
@@ -76197,7 +76297,7 @@ function getAllHistory(workingDir) {
   records.sort((a, b) => new Date(a.timestamp).getTime() - new Date(b.timestamp).getTime());
   return records;
 }
-var MAX_HISTORY_PER_TEST = 20, MAX_ERROR_LENGTH = 500, MAX_STACK_LENGTH = 200, MAX_CHANGED_FILES = 50, HISTORY_WRITE_LOCK_TIMEOUT_MS = 5000, HISTORY_WRITE_LOCK_STALE_MS = 60000, HISTORY_WRITE_LOCK_BACKOFF_MS = 10, DANGEROUS_PROPERTY_NAMES, _internals36;
+var MAX_HISTORY_PER_TEST = 20, MAX_ERROR_LENGTH = 500, MAX_STACK_LENGTH = 200, MAX_CHANGED_FILES = 50, HISTORY_WRITE_LOCK_TIMEOUT_MS = 5000, HISTORY_WRITE_LOCK_STALE_MS = 60000, HISTORY_WRITE_LOCK_BACKOFF_MS = 10, DANGEROUS_PROPERTY_NAMES, _internals37;
 var init_history_store = __esm(() => {
   init_manager2();
   DANGEROUS_PROPERTY_NAMES = new Set([
@@ -76205,7 +76305,7 @@ var init_history_store = __esm(() => {
     "constructor",
     "prototype"
   ]);
-  _internals36 = {
+  _internals37 = {
     validateProjectRoot
   };
 });
@@ -76331,7 +76431,7 @@ function readPackageJsonRaw(dir) {
   }
 }
 function readPackageJson(dir) {
-  return _internals37.readPackageJsonRaw(dir);
+  return _internals38.readPackageJsonRaw(dir);
 }
 function readPackageJsonTestScript(dir) {
   return readPackageJson(dir)?.scripts?.test ?? null;
@@ -76501,7 +76601,7 @@ function buildTypescriptBackend() {
     selectEntryPoints: selectEntryPoints3
   };
 }
-var PROFILE_ID3 = "typescript", IMPORT_REGEX_ES2, IMPORT_REGEX_BARE, IMPORT_REGEX_REQUIRE2, IMPORT_REGEX_DYNAMIC, IMPORT_REGEX_REEXPORT2, _internals37;
+var PROFILE_ID3 = "typescript", IMPORT_REGEX_ES2, IMPORT_REGEX_BARE, IMPORT_REGEX_REQUIRE2, IMPORT_REGEX_DYNAMIC, IMPORT_REGEX_REEXPORT2, _internals38;
 var init_typescript = __esm(() => {
   init_default_backend();
   init_profiles();
@@ -76510,7 +76610,7 @@ var init_typescript = __esm(() => {
   IMPORT_REGEX_REQUIRE2 = /require\s*\(\s*['"]([^'"]+)['"]\s*\)/g;
   IMPORT_REGEX_DYNAMIC = /import\s*\(\s*['"]([^'"]+)['"]\s*\)/g;
   IMPORT_REGEX_REEXPORT2 = /export\s+(?:\{[^}]*\}|\*)\s+from\s+['"]([^'"]+)['"]/g;
-  _internals37 = {
+  _internals38 = {
     readPackageJsonRaw,
     readPackageJsonTestScript,
     frameworkFromScriptsTest
@@ -76541,7 +76641,7 @@ __export(exports_dispatch, {
   pickedProfiles: () => pickedProfiles,
   pickBackend: () => pickBackend,
   clearDispatchCache: () => clearDispatchCache,
-  _internals: () => _internals38
+  _internals: () => _internals39
 });
 import * as fs32 from "node:fs";
 import * as path59 from "node:path";
@@ -76596,7 +76696,7 @@ function findManifestRoot(start2) {
   return start2;
 }
 function evictIfNeeded() {
-  if (cache.size <= _internals38.cacheCapacity)
+  if (cache.size <= _internals39.cacheCapacity)
     return;
   let oldestKey;
   let oldestOrder = Infinity;
@@ -76627,7 +76727,7 @@ async function pickBackend(dir) {
     evictIfNeeded();
     return null;
   }
-  const profiles = await _internals38.detectProjectLanguages(root);
+  const profiles = await _internals39.detectProjectLanguages(root);
   if (profiles.length === 0) {
     cache.set(cacheKey, {
       hash: hash3,
@@ -76659,12 +76759,12 @@ function clearDispatchCache() {
   manifestRootCache.clear();
   insertCounter = 0;
 }
-var _internals38, cache, insertCounter = 0, MANIFEST_FILES, _MANIFEST_SET, manifestRootCache;
+var _internals39, cache, insertCounter = 0, MANIFEST_FILES, _MANIFEST_SET, manifestRootCache;
 var init_dispatch = __esm(() => {
   init_backends();
   init_detector();
   init_registry_backend();
-  _internals38 = {
+  _internals39 = {
     detectProjectLanguages,
     cacheCapacity: 64
   };
@@ -78521,9 +78621,9 @@ function getVersionFileVersion(dir) {
 async function runVersionCheck2(dir, _timeoutMs) {
   const startTime = Date.now();
   try {
-    const packageVersion = _internals39.getPackageVersion(dir);
-    const changelogVersion = _internals39.getChangelogVersion(dir);
-    const versionFileVersion = _internals39.getVersionFileVersion(dir);
+    const packageVersion = _internals40.getPackageVersion(dir);
+    const changelogVersion = _internals40.getChangelogVersion(dir);
+    const versionFileVersion = _internals40.getVersionFileVersion(dir);
     const versions3 = [];
     if (packageVersion)
       versions3.push(`package.json: ${packageVersion}`);
@@ -78888,7 +78988,7 @@ async function runPreflight(dir, phase, config3) {
   const reportId = `preflight-${Date.now()}-${Math.random().toString(36).slice(2, 8)}`;
   let validatedDir;
   try {
-    validatedDir = _internals39.validateDirectoryPath(dir);
+    validatedDir = _internals40.validateDirectoryPath(dir);
   } catch (error93) {
     return {
       id: reportId,
@@ -78908,7 +79008,7 @@ async function runPreflight(dir, phase, config3) {
   }
   let validatedTimeout;
   try {
-    validatedTimeout = _internals39.validateTimeout(config3?.checkTimeoutMs, DEFAULT_CONFIG.checkTimeoutMs);
+    validatedTimeout = _internals40.validateTimeout(config3?.checkTimeoutMs, DEFAULT_CONFIG.checkTimeoutMs);
   } catch (error93) {
     return {
       id: reportId,
@@ -78949,12 +79049,12 @@ async function runPreflight(dir, phase, config3) {
   });
   const checks5 = [];
   log("[Preflight] Running lint check...");
-  const lintResult = await _internals39.runLintCheck(validatedDir, cfg.linter, cfg.checkTimeoutMs);
+  const lintResult = await _internals40.runLintCheck(validatedDir, cfg.linter, cfg.checkTimeoutMs);
   checks5.push(lintResult);
   log(`[Preflight] Lint check: ${lintResult.status} ${lintResult.message}`);
   if (!cfg.skipTests) {
     log("[Preflight] Running tests check...");
-    const testsResult = await _internals39.runTestsCheck(validatedDir, cfg.testScope, cfg.checkTimeoutMs);
+    const testsResult = await _internals40.runTestsCheck(validatedDir, cfg.testScope, cfg.checkTimeoutMs);
     checks5.push(testsResult);
     log(`[Preflight] Tests check: ${testsResult.status} ${testsResult.message}`);
   } else {
@@ -78966,7 +79066,7 @@ async function runPreflight(dir, phase, config3) {
   }
   if (!cfg.skipSecrets) {
     log("[Preflight] Running secrets check...");
-    const secretsResult = await _internals39.runSecretsCheck(validatedDir, cfg.checkTimeoutMs);
+    const secretsResult = await _internals40.runSecretsCheck(validatedDir, cfg.checkTimeoutMs);
     checks5.push(secretsResult);
     log(`[Preflight] Secrets check: ${secretsResult.status} ${secretsResult.message}`);
   } else {
@@ -78978,7 +79078,7 @@ async function runPreflight(dir, phase, config3) {
   }
   if (!cfg.skipEvidence) {
     log("[Preflight] Running evidence check...");
-    const evidenceResult = await _internals39.runEvidenceCheck(validatedDir);
+    const evidenceResult = await _internals40.runEvidenceCheck(validatedDir);
     checks5.push(evidenceResult);
     log(`[Preflight] Evidence check: ${evidenceResult.status} ${evidenceResult.message}`);
   } else {
@@ -78989,12 +79089,12 @@ async function runPreflight(dir, phase, config3) {
     });
   }
   log("[Preflight] Running requirement coverage check...");
-  const reqCoverageResult = await _internals39.runRequirementCoverageCheck(validatedDir, phase);
+  const reqCoverageResult = await _internals40.runRequirementCoverageCheck(validatedDir, phase);
   checks5.push(reqCoverageResult);
   log(`[Preflight] Requirement coverage check: ${reqCoverageResult.status} ${reqCoverageResult.message}`);
   if (!cfg.skipVersion) {
     log("[Preflight] Running version check...");
-    const versionResult = await _internals39.runVersionCheck(validatedDir, cfg.checkTimeoutMs);
+    const versionResult = await _internals40.runVersionCheck(validatedDir, cfg.checkTimeoutMs);
     checks5.push(versionResult);
     log(`[Preflight] Version check: ${versionResult.status} ${versionResult.message}`);
   } else {
@@ -79057,10 +79157,10 @@ function formatPreflightMarkdown(report) {
 async function handlePreflightCommand(directory, _args) {
   const plan = await loadPlan(directory);
   const phase = plan?.current_phase ?? 1;
-  const report = await _internals39.runPreflight(directory, phase);
-  return _internals39.formatPreflightMarkdown(report);
+  const report = await _internals40.runPreflight(directory, phase);
+  return _internals40.formatPreflightMarkdown(report);
 }
-var MIN_CHECK_TIMEOUT_MS = 5000, MAX_CHECK_TIMEOUT_MS = 300000, DEFAULT_CONFIG, _internals39;
+var MIN_CHECK_TIMEOUT_MS = 5000, MAX_CHECK_TIMEOUT_MS = 300000, DEFAULT_CONFIG, _internals40;
 var init_preflight_service = __esm(() => {
   init_gate_bridge();
   init_manager2();
@@ -79078,7 +79178,7 @@ var init_preflight_service = __esm(() => {
     testScope: "convention",
     linter: "biome"
   };
-  _internals39 = {
+  _internals40 = {
     runPreflight,
     formatPreflightMarkdown,
     handlePreflightCommand,
@@ -80973,7 +81073,7 @@ async function getStatusData(directory, agents) {
 }
 function enrichWithLeanTurbo(status, directory) {
   const turboMode = hasActiveTurboMode();
-  const leanActive = _internals40.hasActiveLeanTurbo();
+  const leanActive = _internals41.hasActiveLeanTurbo();
   let turboStrategy = "off";
   if (leanActive) {
     turboStrategy = "lean";
@@ -80992,7 +81092,7 @@ function enrichWithLeanTurbo(status, directory) {
     }
   }
   if (leanSessionID) {
-    const runState = _internals40.loadLeanTurboRunState(directory, leanSessionID);
+    const runState = _internals41.loadLeanTurboRunState(directory, leanSessionID);
     if (runState) {
       status.leanTurboPhase = runState.phase;
       status.leanMaxParallelCoders = runState.maxParallelCoders;
@@ -81024,7 +81124,7 @@ function enrichWithLeanTurbo(status, directory) {
       }
     }
   }
-  status.fullAutoActive = _internals40.hasActiveFullAuto();
+  status.fullAutoActive = _internals41.hasActiveFullAuto();
   return status;
 }
 function formatStatusMarkdown(status) {
@@ -81106,7 +81206,7 @@ async function handleStatusCommand(directory, agents) {
   }
   return formatStatusMarkdown(statusData);
 }
-var _internals40;
+var _internals41;
 var init_status_service = __esm(() => {
   init_extractors();
   init_utils2();
@@ -81115,7 +81215,7 @@ var init_status_service = __esm(() => {
   init_state3();
   init_compaction_service();
   init_context_budget_service();
-  _internals40 = {
+  _internals41 = {
     loadLeanTurboRunState,
     hasActiveLeanTurbo,
     hasActiveFullAuto
@@ -81206,7 +81306,7 @@ async function handleTurboCommand(directory, args2, sessionID) {
   if (arg0 === "on") {
     let strategy = "standard";
     try {
-      const { config: config3 } = _internals41.loadPluginConfigWithMeta(directory);
+      const { config: config3 } = _internals42.loadPluginConfigWithMeta(directory);
       if (config3.turbo?.strategy === "lean") {
         strategy = "lean";
       }
@@ -81261,7 +81361,7 @@ function enableLeanTurbo(session, directory, sessionID) {
   let maxParallelCoders = 4;
   let conflictPolicy = "serialize";
   try {
-    const { config: config3 } = _internals41.loadPluginConfigWithMeta(directory);
+    const { config: config3 } = _internals42.loadPluginConfigWithMeta(directory);
     const leanConfig = config3.turbo?.lean;
     if (leanConfig) {
       maxParallelCoders = leanConfig.max_parallel_coders ?? 4;
@@ -81331,13 +81431,13 @@ function buildStatusMessage2(session, directory, sessionID) {
   ].join(`
 `);
 }
-var _internals41;
+var _internals42;
 var init_turbo = __esm(() => {
   init_config();
   init_state();
   init_state3();
   init_logger();
-  _internals41 = {
+  _internals42 = {
     loadPluginConfigWithMeta
   };
 });
@@ -81430,7 +81530,7 @@ function formatCommandNotFound(tokens) {
   const attemptedCommand = tokens[0] || "";
   const MAX_DISPLAY = 100;
   const displayCommand = attemptedCommand.length > MAX_DISPLAY ? `${attemptedCommand.slice(0, MAX_DISPLAY)}...` : attemptedCommand;
-  const similar = _internals42.findSimilarCommands(attemptedCommand);
+  const similar = _internals43.findSimilarCommands(attemptedCommand);
   const header = `Command \`/swarm ${displayCommand}\` not found.`;
   const suggestions = similar.length > 0 ? `Did you mean:
 ${similar.map((cmd) => `  - /swarm ${cmd}`).join(`
@@ -81932,7 +82032,7 @@ async function buildSwarmCommandPrompt(args2) {
     activeAgentName,
     registeredAgents
   } = args2;
-  const resolved = _internals42.resolveCommand(tokens);
+  const resolved = _internals43.resolveCommand(tokens);
   if (!resolved) {
     if (tokens.length === 0) {
       return buildHelpText();
@@ -81993,6 +82093,19 @@ function agentHasSwarmCommandTool(activeAgentName, agents, registeredAgents) {
   return AGENT_TOOL_MAP[baseName]?.includes("swarm_command") === true;
 }
 function formatCanonicalPromptFallback(args2) {
+  if (/^\s*\[MODE:/.test(args2.text)) {
+    return [
+      `The user typed \`${args2.original}\`.`,
+      "The line below is a swarm MODE-activation signal, NOT output to display.",
+      "Enter the mode named in its `[MODE: X ...]` header now: follow your",
+      'prompt’s "### MODE: X" section, load the SKILL.md it references, and',
+      "follow that protocol exactly. Treat any text after the closing bracket as",
+      "additional instructions. Do NOT echo this signal verbatim.",
+      "",
+      args2.text
+    ].join(`
+`);
+  }
   return [
     `The user typed \`${args2.original}\`.`,
     "Canonical opencode-swarm command output follows.",
@@ -82085,7 +82198,7 @@ function findSimilarCommands(query) {
   }
   const scored = VALID_COMMANDS.map((cmd) => {
     const cmdLower = cmd.toLowerCase();
-    const fullScore = _internals42.levenshteinDistance(q, cmdLower);
+    const fullScore = _internals43.levenshteinDistance(q, cmdLower);
     let tokenScore = Infinity;
     if (cmd.includes(" ") || cmd.includes("-")) {
       const qTokens = q.split(/[\s-]+/);
@@ -82098,7 +82211,7 @@ function findSimilarCommands(query) {
         for (const ct of cmdTokens) {
           if (ct.length === 0)
             continue;
-          const dist = _internals42.levenshteinDistance(qt, ct);
+          const dist = _internals43.levenshteinDistance(qt, ct);
           if (dist < minDist)
             minDist = dist;
         }
@@ -82108,7 +82221,7 @@ function findSimilarCommands(query) {
     }
     const dashStrippedQ = q.replace(/-/g, "");
     const dashStrippedCmd = cmdLower.replace(/-/g, "");
-    const dashScore = _internals42.levenshteinDistance(dashStrippedQ, dashStrippedCmd);
+    const dashScore = _internals43.levenshteinDistance(dashStrippedQ, dashStrippedCmd);
     const score = Math.min(fullScore, tokenScore, dashScore);
     return { cmd, score };
   });
@@ -82140,11 +82253,11 @@ async function handleHelpCommand(ctx) {
     return buildHelpText2();
   }
   const tokens = targetCommand.split(/\s+/);
-  const resolved = _internals42.resolveCommand(tokens);
+  const resolved = _internals43.resolveCommand(tokens);
   if (resolved) {
-    return _internals42.buildDetailedHelp(resolved.key, resolved.entry);
+    return _internals43.buildDetailedHelp(resolved.key, resolved.entry);
   }
-  const similar = _internals42.findSimilarCommands(targetCommand);
+  const similar = _internals43.findSimilarCommands(targetCommand);
   const { buildHelpText: fullHelp } = await Promise.resolve().then(() => (init_commands(), exports_commands));
   if (similar.length > 0) {
     return `Command '/swarm ${targetCommand}' not found.
@@ -82238,7 +82351,7 @@ function resolveCommand(tokens) {
   }
   return null;
 }
-var COMMAND_REGISTRY, VALID_COMMANDS, _internals42, validation;
+var COMMAND_REGISTRY, VALID_COMMANDS, _internals43, validation;
 var init_registry = __esm(() => {
   init_acknowledge_spec_drift();
   init_agents();
@@ -82264,6 +82377,7 @@ var init_registry = __esm(() => {
   init_knowledge();
   init_memory2();
   init_plan();
+  init_pr_feedback();
   init_pr_review();
   init_preflight();
   init_promote();
@@ -82311,7 +82425,7 @@ var init_registry = __esm(() => {
       clashesWithNativeCcCommand: "/agents"
     },
     help: {
-      handler: (ctx) => _internals42.handleHelpCommand(ctx),
+      handler: (ctx) => _internals43.handleHelpCommand(ctx),
       description: "Show help for swarm commands",
       category: "core",
       args: "[command]",
@@ -82544,7 +82658,7 @@ Subcommands:
       handler: (ctx) => handleCouncilCommand(ctx.directory, ctx.args),
       description: "Enter architect MODE: COUNCIL — multi-model deliberation [question] [--preset <name>] [--spec-review]",
       args: "<question> [--preset <name>] [--spec-review]",
-      details: "Triggers the architect to convene a three-agent General Council: Generalist (reviewer model), Skeptic (critic model), and Domain Expert (SME model). Use --preset <name> to choose a named member preset from council.general.presets. " + "The architect first runs 1–3 targeted web searches and passes a compiled RESEARCH CONTEXT " + "to all three agents before dispatching them in parallel. Agents deliberate using the NSED peer-review protocol (Round 1 independent analysis, Round 2 MAINTAIN/CONCEDE/NUANCE for disagreements). The architect synthesizes the final answer directly from convene_general_council output. --spec-review switches to single-pass advisory mode for spec review. Requires council.general.enabled: true and a search API key in opencode-swarm.json.",
+      details: "Triggers the architect to convene a three-agent General Council: Generalist (reviewer model), Skeptic (critic model), and Domain Expert (SME model). Use --preset <name> to choose a named member preset from council.general.presets. " + "The architect first runs 1–3 targeted web searches and passes a compiled RESEARCH CONTEXT " + "to all three agents before dispatching them in parallel. Agents deliberate using the NSED peer-review protocol (Round 1 independent analysis, Round 2 MAINTAIN/CONCEDE/NUANCE for disagreements). The architect synthesizes the final answer directly from convene_general_council output. --spec-review switches to single-pass advisory mode for spec review. Requires council.general.enabled: true and a search API key in the resolved config: global ~/.config/opencode/opencode-swarm.json, then project .opencode/opencode-swarm.json overrides.",
       category: "agent"
     },
     "pr-review": {
@@ -82554,6 +82668,13 @@ Subcommands:
       details: "Launches a structured PR review: reconstructs PR intent via obligation extraction cascade, runs 6 parallel explorer lanes (correctness, security, dependencies, docs-intent-vs-actual, tests, performance-architecture), validates findings through independent reviewer confirmation, applies critic challenge to HIGH/CRITICAL findings, synthesizes structured report. --council variant fires adversarial multi-model review. Supports full GitHub URL, owner/repo#N shorthand, or bare PR number (resolves against origin remote).",
       category: "agent"
     },
+    "pr-feedback": {
+      handler: async (ctx) => handlePrFeedbackCommand(ctx.directory, ctx.args),
+      description: "Ingest and close known PR feedback (review comments, CI failures, conflicts) [pr] [instructions]",
+      args: "[url|owner/repo#N|N] [instructions...]",
+      details: "Triggers MODE: PR_FEEDBACK — ingests existing pull-request feedback (review threads, requested changes, CI/check failures, merge conflicts, stale branch state, pasted notes), verifies every claim against source, clusters related problems, fixes confirmed items, validates the branch, and reports closure status for every ledger item. Distinct from /swarm pr-review, which discovers new findings. The PR reference is optional: with none, the architect builds the ledger from the current PR/branch; text after the reference is forwarded as extra instructions. Supports full GitHub URL, owner/repo#N shorthand, or bare PR number (resolved against origin).",
+      category: "agent"
+    },
     "deep-dive": {
       handler: async (ctx) => handleDeepDiveCommand(ctx.directory, ctx.args),
       description: "Launch deep codebase audit with parallel explorer waves, dual reviewers, and critic challenge [scope]",
@@ -82782,7 +82903,7 @@ Subcommands:
     }
   };
   VALID_COMMANDS = Object.keys(COMMAND_REGISTRY);
-  _internals42 = {
+  _internals43 = {
     handleHelpCommand,
     validateAliases,
     resolveCommand,
@@ -82790,7 +82911,7 @@ Subcommands:
     findSimilarCommands,
     buildDetailedHelp
   };
-  validation = _internals42.validateAliases();
+  validation = _internals43.validateAliases();
   if (!validation.valid) {
     throw new Error(`COMMAND_REGISTRY alias validation failed:
 ${validation.errors.join(`
@@ -82965,7 +83086,7 @@ Present the eleven gates with their defaults (DEFAULT_QA_GATES) as a single user
 - council_mode (default: OFF) — multi-member council gate (recommended for high-impact architecture, public APIs, schema/data mutation, security-sensitive code)
 - hallucination_guard (default: OFF) — when enabled, mandatory per-phase API/signature/claim/citation verification via critic_hallucination_verifier at PHASE-WRAP; phase_complete will REJECT phase completion unless .swarm/evidence/{phase}/hallucination-guard.json exists with an APPROVED verdict (recommended for claim-heavy or research-heavy work)
 - mutation_test (default: OFF) — when enabled, runs mutation testing on source files touched this phase via generate_mutants + mutation_test + write_mutation_evidence at PHASE-WRAP; FAIL verdict blocks phase_complete; WARN is non-blocking (recommended for projects with coverage gaps or safety-critical code)
-- council_general_review (default: OFF) — when enabled, MODE: SPECIFY runs convene_general_council on the draft spec before the critic-gate; the architect runs a curated web_search pass, dispatches council_generalist / council_skeptic / council_domain_expert in parallel with a shared RESEARCH CONTEXT block, deliberates on disagreements, and synthesizes the result directly into the spec (recommended for novel architecture, unclear best practices, or high-risk design decisions). Requires council.general.enabled: true and a configured search API key.
+- council_general_review (default: OFF) — when enabled, MODE: SPECIFY runs convene_general_council on the draft spec before the critic-gate; the architect runs a curated web_search pass, dispatches council_generalist / council_skeptic / council_domain_expert in parallel with a shared RESEARCH CONTEXT block, deliberates on disagreements, and synthesizes the result directly into the spec (recommended for novel architecture, unclear best practices, or high-risk design decisions). Requires council.general.enabled: true and a configured search API key in the resolved config: global ~/.config/opencode/opencode-swarm.json, then project .opencode/opencode-swarm.json overrides.
 - drift_check (default: ON) — when enabled, mandatory per-phase drift verification via critic_drift_verifier at PHASE-WRAP; compares implemented changes against spec.md intent; hard-blocks phase_complete when spec.md exists and drift evidence is missing or REJECTED; advisory-only when no spec.md exists (recommended for all projects with a specification)
 - final_council (default: OFF) - when enabled, after all phases complete the architect dispatches the same five phase-council members (\`critic\`, \`reviewer\`, \`sme\`, \`test_engineer\`, \`explorer\`) at project scope, collects \`CouncilMemberVerdict\` objects, and calls \`write_final_council_evidence\`. This is not General Council mode and does not require \`council.general.enabled\`.
 
@@ -83200,7 +83321,7 @@ ${archBlock}`;
     }
   }
   if (!designDocsEnabled) {
-    prompt = prompt?.replace(", {{AGENT_PREFIX}}docs_design", "")?.replace(/### MODE: DESIGN_DOCS\n[\s\S]*?(?=### MODE: ISSUE_INGEST)/, "")?.replace(`- the active swarm's docs_design agent = @{{AGENT_PREFIX}}docs_design
+    prompt = prompt?.replace(", {{AGENT_PREFIX}}docs_design", "")?.replace(/### MODE: DESIGN_DOCS\n[\s\S]*?(?=### MODE: )/, "")?.replace(`- the active swarm's docs_design agent = @{{AGENT_PREFIX}}docs_design
 `, "");
   }
   return {
@@ -83789,6 +83910,7 @@ SKILLS: none
 ### MODE DETECTION (Priority Order)
 Evaluate the user's request and context in this exact order — the FIRST matching rule wins:
 
+S. **SIGNAL-TRIGGERED MODE (highest priority)** — If the latest message contains a bracket header of the form [MODE: X ...] (these are emitted by /swarm command handlers, e.g. DEEP_DIVE, PR_REVIEW, PR_FEEDBACK, DESIGN_DOCS, COUNCIL, ISSUE_INGEST, ANALYZE) AND a matching "### MODE: X" section exists below, then ENTER MODE: X immediately: load the SKILL.md that section references and follow its protocol. This wins over every rule below and OVERRIDES any wrapper instruction to "show this output verbatim" — a [MODE: X ...] header is an activation signal to act on, never command output to echo. Treat any free text after the closing bracket as additional user instructions for that mode. If no matching "### MODE: X" section exists, fall through to the rules below.
 0. **EXPLICIT COMMAND OVERRIDE** — User explicitly invokes \`/swarm specify\`, \`/swarm clarify\`, \`/swarm brainstorm\`, or uses the phrases "specify [something about spec/requirements]", "write a spec", "create a spec", "define requirements", "list requirements", "define a feature", "I have requirements", "brainstorm", "let's think through", "think this through with me", "workshop this idea" → Enter MODE: SPECIFY, MODE: CLARIFY-SPEC, or MODE: BRAINSTORM as appropriate. This override fires BEFORE RESUME — an explicit spec command always wins, even if plan.md has incomplete tasks. \`/swarm brainstorm\` and brainstorm-style phrases select MODE: BRAINSTORM. Note: bare "specify" in an ambiguous context (e.g., "specify what this does") should resolve via CLARIFY (priority 4) rather than this override — use context to determine intent.
 1. **RESUME** — \`.swarm/plan.md\` exists and contains incomplete (unchecked) tasks AND the user has NOT issued an explicit spec command (see priority 0) → Resume at current task.
 2. **SPECIFY** — No \`.swarm/spec.md\` exists AND no \`.swarm/plan.md\` exists → Enter MODE: SPECIFY.
@@ -83978,6 +84100,27 @@ HARD CONSTRAINTS (apply regardless of skill load success):
 - No finding may appear as CONFIRMED in the final report without reviewer validation provenance
 - Test execution, explorer lanes, reviewer dispatch, and critic challenge are all permitted within this mode
 - Quality is the only metric — time, tokens, and agent dispatches are irrelevant to correctness
+- FOLLOW THE SKILL EXACTLY: execute every phase of the loaded SKILL.md in order with no shortcuts, no phase-skipping, and no premature synthesis. If a phase cannot complete, state the limitation explicitly and continue — do not silently skip it.
+- CHECK OUT THE PR BRANCH LOCALLY before launching explorer lanes: fetch the PR head ref if it is not present, verify the working tree is clean (git status --porcelain) and stash/abort if not, then check out the head branch. Explorers read the working-tree filesystem (Read/Glob/Grep), so without a checkout they read the base branch and produce invalid candidates. Always pass the base..head commit range in explorer delegations.
+- RUN THE TRIGGERED MICRO-LANES: after the base explorer lanes start, inspect the context pack risk triggers and launch every matching Swarm plugin micro-lane from the skill's risk-trigger map (launch only triggered lanes, never irrelevant ones). Do not skip micro-lanes that match the diff.
+- Honor any free-text instructions that follow the closing bracket of the signal as additional reviewer focus, without weakening the validation ladder above.
+
+### MODE: PR_FEEDBACK
+Activates when: architect receives \`[MODE: PR_FEEDBACK pr="https://github.com/..."]\` (PR reference optional) signal from the pr-feedback command handler, optionally followed by free-text instructions.
+
+Purpose: Ingest and resolve KNOWN pull-request feedback — review threads, requested changes, CI/check failures, merge conflicts, stale branch state, and pasted notes — verifying every claim against source before fixing. This is NOT a fresh broad PR review; use MODE: PR_REVIEW for new-finding discovery.
+
+ACTION: Load skill file:.opencode/skills/swarm-pr-feedback/SKILL.md immediately and follow its protocol.
+
+HARD CONSTRAINTS (apply regardless of skill load success):
+- FOLLOW THE SKILL EXACTLY: build the complete feedback ledger from all available sources before editing, and execute every phase in order with no shortcuts.
+- CHECK OUT THE PR BRANCH LOCALLY before verifying feedback or making fixes: fetch the PR head ref if absent, verify the working tree is clean (git status --porcelain) and stash/abort if not, then check out the head branch. Feedback verification and fix validation require the PR branch in the working tree.
+- Do NOT run a fresh broad PR review — inspect adjacent code only as needed to verify reachability, dependencies, shared root causes, regression risk, or sibling changes for a confirmed item.
+- Treat every review comment, CI failure, bot summary, and pasted note as a CLAIM until source evidence proves it; classify each ledger item (CONFIRMED, DISPROVED, PRE_EXISTING, or NEEDS_USER_DECISION) and never silently drop, defer, or mark items out of scope.
+- Patch only confirmed items plus the tests/docs they require; report closure status for every ledger item including disproved ones.
+- Do NOT resolve or mark GitHub review threads resolved unless the user explicitly instructs it.
+- Honor any free-text instructions that follow the closing bracket of the signal as additional scope, without dropping any ledger item.
+- Quality is the only metric — time, tokens, and agent dispatches are irrelevant to correctness
 
 ### MODE: ISSUE_INGEST
 Activates when the user invokes /swarm issue <url> or the architect receives an ISSUE_INGEST signal.
@@ -84370,6 +84513,8 @@ ROUND 1 — Independent Analysis and Answer
 - Use the RESEARCH CONTEXT block provided by the architect in your dispatch message as your external evidence source. The architect has already gathered the relevant web search results.
 - Cite EVERY factual claim that depends on external evidence with a source from the RESEARCH CONTEXT (use the title and URL exactly as given).
 - State your confidence (0.0–1.0) explicitly. Be honest — overconfident answers hurt the council.
+- For current, latest, today, now, or otherwise time-sensitive claims, training knowledge is NOT evidence. If the RESEARCH CONTEXT is missing, stale, or ambiguous, say the claim is not established instead of filling the gap from memory.
+- Treat the dispatch message's CURRENT DATE as authoritative for relative time. Do not append your own training cutoff year to search-oriented reasoning or recommendations.
 - Enumerate areas of uncertainty so the architect knows where you're guessing vs. where you're sure.
 - Do NOT coordinate with other members. You will not see their responses until Round 2.
 - Do NOT pad. Be concise. Substance over volume.
@@ -84412,7 +84557,8 @@ Notes:
 - For Round 1: leave \`disagreementTopics\` as []. For Round 2: list the specific disagreement topics this response addresses.`, HARD_RULES = `================================================================
 HARD RULES
 ================================================================
-- You have no tools. Reason from the provided RESEARCH CONTEXT and your training knowledge.
+- You have no tools. Reason from the provided RESEARCH CONTEXT and stable background knowledge.
+- Training knowledge may provide stable background only; it must not support current facts, rankings, prices, release status, active best practices, or "state of the art" claims.
 - Never invent sources. If the RESEARCH CONTEXT does not cover a needed claim, say so in \`areasOfUncertainty\`.
 - Never echo other members' responses verbatim. Paraphrase or quote with attribution.
 - Stay within your role and persona. The architect chose you for a specific perspective.`, GENERALIST_COUNCIL_PROMPT, SKEPTIC_COUNCIL_PROMPT, DOMAIN_EXPERT_COUNCIL_PROMPT;
@@ -91190,7 +91336,7 @@ __export(exports_runtime, {
   getSupportedLanguages: () => getSupportedLanguages,
   getInitializedLanguages: () => getInitializedLanguages,
   clearParserCache: () => clearParserCache,
-  _internals: () => _internals51
+  _internals: () => _internals52
 });
 import * as path99 from "node:path";
 import { fileURLToPath as fileURLToPath4 } from "node:url";
@@ -91200,10 +91346,10 @@ async function initTreeSitter() {
       const thisDir = path99.dirname(fileURLToPath4(import.meta.url));
       const isSource = thisDir.replace(/\\/g, "/").endsWith("/src/lang");
       if (isSource) {
-        await _internals51.parserInit();
+        await _internals52.parserInit();
       } else {
         const grammarsDir = getGrammarsDirAbsolute();
-        await _internals51.parserInit({
+        await _internals52.parserInit({
           locateFile(scriptName) {
             return path99.join(grammarsDir, scriptName);
           }
@@ -91308,12 +91454,12 @@ function getInitializedLanguages() {
 function getSupportedLanguages() {
   return Object.keys(LANGUAGE_WASM_MAP);
 }
-var parserCache, initializedLanguages, treeSitterInitPromise = null, _internals51, LANGUAGE_WASM_MAP;
+var parserCache, initializedLanguages, treeSitterInitPromise = null, _internals52, LANGUAGE_WASM_MAP;
 var init_runtime = __esm(() => {
   init_tree_sitter();
   parserCache = new Map;
   initializedLanguages = new Set;
-  _internals51 = {
+  _internals52 = {
     parserInit: Parser.init
   };
   LANGUAGE_WASM_MAP = {
@@ -92216,9 +92362,9 @@ var init_search_knowledge = __esm(() => {
 var exports_knowledge_recall = {};
 __export(exports_knowledge_recall, {
   knowledge_recall: () => knowledge_recall,
-  _internals: () => _internals52
+  _internals: () => _internals53
 });
-var knowledge_recall, _internals52;
+var knowledge_recall, _internals53;
 var init_knowledge_recall = __esm(() => {
   init_zod();
   init_config();
@@ -92299,7 +92445,7 @@ var init_knowledge_recall = __esm(() => {
       return JSON.stringify(result);
     }
   });
-  _internals52 = {
+  _internals53 = {
     knowledge_recall
   };
 });
@@ -92354,7 +92500,7 @@ __export(exports_curator_drift, {
   runDeterministicDriftCheck: () => runDeterministicDriftCheck,
   readPriorDriftReports: () => readPriorDriftReports,
   buildDriftInjectionText: () => buildDriftInjectionText,
-  _internals: () => _internals55
+  _internals: () => _internals56
 });
 import * as fs71 from "node:fs";
 import * as path108 from "node:path";
@@ -92403,7 +92549,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 _internals55.readPriorDriftReports(directory);
+    const priorReports = await _internals56.readPriorDriftReports(directory);
     const complianceCount = curatorResult.compliance.length;
     const warningCompliance = curatorResult.compliance.filter((obs) => obs.severity === "warning");
     let alignment = "ALIGNED";
@@ -92466,7 +92612,7 @@ async function runDeterministicDriftCheck(directory, phase, curatorResult, confi
       scope_additions: [],
       injection_summary: injectionSummary
     };
-    const reportPath = await _internals55.writeDriftReport(directory, report);
+    const reportPath = await _internals56.writeDriftReport(directory, report);
     getGlobalEventBus().publish("curator.drift.completed", {
       phase,
       alignment,
@@ -92529,12 +92675,12 @@ function buildDriftInjectionText(report, maxChars) {
   }
   return text.slice(0, maxChars);
 }
-var DRIFT_REPORT_PREFIX = "drift-report-phase-", _internals55;
+var DRIFT_REPORT_PREFIX = "drift-report-phase-", _internals56;
 var init_curator_drift = __esm(() => {
   init_event_bus();
   init_logger();
   init_utils2();
-  _internals55 = {
+  _internals56 = {
     readPriorDriftReports,
     writeDriftReport,
     runDeterministicDriftCheck,
@@ -92546,7 +92692,7 @@ var init_curator_drift = __esm(() => {
 var exports_design_doc_drift = {};
 __export(exports_design_doc_drift, {
   runDesignDocDriftCheck: () => runDesignDocDriftCheck,
-  _internals: () => _internals66
+  _internals: () => _internals67
 });
 import * as fs106 from "node:fs";
 import * as path145 from "node:path";
@@ -92678,7 +92824,7 @@ async function runDesignDocDriftCheck(directory, phase, outDir) {
     return null;
   }
 }
-var DOC_DRIFT_REPORT_PREFIX = "doc-drift-phase-", MAX_TRACEABILITY_BYTES, DESIGN_DOC_FILES, TRACEABILITY_REL, _internals66;
+var DOC_DRIFT_REPORT_PREFIX = "doc-drift-phase-", MAX_TRACEABILITY_BYTES, DESIGN_DOC_FILES, TRACEABILITY_REL, _internals67;
 var init_design_doc_drift = __esm(() => {
   init_event_bus();
   init_logger();
@@ -92692,7 +92838,7 @@ var init_design_doc_drift = __esm(() => {
     "idiom-notes": path145.join("reference", "idiom-notes.md")
   };
   TRACEABILITY_REL = path145.join("reference", "traceability.json");
-  _internals66 = {
+  _internals67 = {
     mtimeMsOrNull,
     resolveAnchorWithin,
     DESIGN_DOC_FILES
@@ -92703,7 +92849,7 @@ var init_design_doc_drift = __esm(() => {
 var exports_project_context = {};
 __export(exports_project_context, {
   buildProjectContext: () => buildProjectContext,
-  _internals: () => _internals77,
+  _internals: () => _internals78,
   LANG_BACKEND_DETECTION_TIMEOUT_MS: () => LANG_BACKEND_DETECTION_TIMEOUT_MS
 });
 import * as fs130 from "node:fs";
@@ -92787,7 +92933,7 @@ function selectLintCommand(backend, directory) {
   return null;
 }
 async function buildProjectContext(directory) {
-  const backend = await _internals77.pickBackend(directory);
+  const backend = await _internals78.pickBackend(directory);
   if (!backend)
     return null;
   const ctx = emptyProjectContext();
@@ -92818,16 +92964,16 @@ async function buildProjectContext(directory) {
   if (backend.prompts.reviewerChecklist.length > 0) {
     ctx.REVIEWER_CHECKLIST = bulletList(backend.prompts.reviewerChecklist);
   }
-  const profiles = _internals77.pickedProfiles(directory);
+  const profiles = _internals78.pickedProfiles(directory);
   if (profiles.length > 1) {
     ctx.PROJECT_CONTEXT_SECONDARY_LANGUAGES = profiles.slice(1).map((p) => p.id).join(", ");
   }
   return ctx;
 }
-var LANG_BACKEND_DETECTION_TIMEOUT_MS = 300, _internals77;
+var LANG_BACKEND_DETECTION_TIMEOUT_MS = 300, _internals78;
 var init_project_context = __esm(() => {
   init_dispatch();
-  _internals77 = {
+  _internals78 = {
     pickBackend,
     pickedProfiles
   };
@@ -93208,7 +93354,7 @@ import * as path76 from "node:path";
 import * as crypto7 from "node:crypto";
 import * as fs44 from "node:fs";
 import * as path75 from "node:path";
-var _internals43 = {
+var _internals44 = {
   readFileSync: fs44.readFileSync,
   writeFileSync: fs44.writeFileSync,
   mkdirSync: fs44.mkdirSync,
@@ -93218,7 +93364,7 @@ var _internals43 = {
   createHash: crypto7.createHash.bind(crypto7)
 };
 function computeContentHash(content) {
-  return _internals43.createHash("sha256").update(content, "utf-8").digest("hex");
+  return _internals44.createHash("sha256").update(content, "utf-8").digest("hex");
 }
 function createEmptyContextMap() {
   return {
@@ -93233,10 +93379,10 @@ function createEmptyContextMap() {
 function loadContextMap(directory) {
   const filePath = path75.join(directory, ".swarm", "context-map.json");
   try {
-    if (!_internals43.existsSync(filePath)) {
+    if (!_internals44.existsSync(filePath)) {
       return null;
     }
-    const raw = _internals43.readFileSync(filePath, "utf-8");
+    const raw = _internals44.readFileSync(filePath, "utf-8");
     const parsed = JSON.parse(raw);
     if (typeof parsed !== "object" || parsed === null || parsed.schema_version !== 1) {
       return null;
@@ -93250,14 +93396,14 @@ function saveContextMap(map3, directory) {
   const swarmDir = path75.join(directory, ".swarm");
   const tmpPath = path75.join(swarmDir, "context-map.tmp");
   const finalPath = path75.join(swarmDir, "context-map.json");
-  _internals43.mkdirSync(swarmDir, { recursive: true });
+  _internals44.mkdirSync(swarmDir, { recursive: true });
   const updated = {
     ...map3,
     generated_at: new Date().toISOString()
   };
   const json3 = JSON.stringify(updated, null, 2);
-  _internals43.writeFileSync(tmpPath, json3, "utf-8");
-  _internals43.renameSync(tmpPath, finalPath);
+  _internals44.writeFileSync(tmpPath, json3, "utf-8");
+  _internals44.renameSync(tmpPath, finalPath);
 }
 function appendTaskHistory(map3, summary) {
   return {
@@ -93423,10 +93569,10 @@ function deriveFinalStatus(params) {
 }
 function readFileContent(absolutePath) {
   try {
-    if (!_internals44.existsSync(absolutePath)) {
+    if (!_internals45.existsSync(absolutePath)) {
       return null;
     }
-    return _internals44.readFileSync(absolutePath, "utf-8");
+    return _internals45.readFileSync(absolutePath, "utf-8");
   } catch {
     return null;
   }
@@ -93436,9 +93582,9 @@ function refreshFileEntry(relativePath, absolutePath, existingEntry) {
   if (content === null) {
     return null;
   }
-  return _internals44.extractFileSummary(relativePath, content, absolutePath, existingEntry);
+  return _internals45.extractFileSummary(relativePath, content, absolutePath, existingEntry);
 }
-var _internals44 = {
+var _internals45 = {
   loadContextMap,
   saveContextMap,
   createEmptyContextMap,
@@ -93457,10 +93603,10 @@ function extractEvidenceFindings(taskId, directory) {
   };
   try {
     const evidenceDir = path77.join(directory, ".swarm", "evidence", taskId);
-    if (!_internals44.existsSync(evidenceDir)) {
+    if (!_internals45.existsSync(evidenceDir)) {
       return result;
     }
-    const evidenceFiles = _internals44.readdirSync(evidenceDir);
+    const evidenceFiles = _internals45.readdirSync(evidenceDir);
     const targetFiles = [
       "evidence.json",
       "reviewer.json",
@@ -93552,20 +93698,20 @@ function extractEvidenceFindings(taskId, directory) {
 }
 function updateContextMapAfterAgent(params) {
   try {
-    let map3 = _internals44.loadContextMap(params.directory);
+    let map3 = _internals45.loadContextMap(params.directory);
     if (map3 === null) {
-      map3 = _internals44.createEmptyContextMap();
+      map3 = _internals45.createEmptyContextMap();
     }
     const root = path77.resolve(params.directory);
     const updatedFiles = {
       ...map3.files
     };
     const validFiles = [];
-    const realRoot = _internals44.realpathSync(root);
+    const realRoot = _internals45.realpathSync(root);
     for (const filePath of params.files_touched) {
       try {
         const resolved = path77.resolve(root, filePath);
-        const realResolved = _internals44.realpathSync(resolved);
+        const realResolved = _internals45.realpathSync(resolved);
         const relative12 = path77.relative(realRoot, realResolved);
         if (relative12.startsWith("..") || path77.isAbsolute(relative12)) {
           continue;
@@ -93603,7 +93749,7 @@ function updateContextMapAfterAgent(params) {
       reviewer_findings: reviewerFindings.length > 0 ? reviewerFindings : undefined,
       final_status: mergedRejectionReasons.length > 0 ? "rejected" : deriveFinalStatus(params)
     };
-    map3 = _internals44.appendTaskHistory(map3, taskSummary);
+    map3 = _internals45.appendTaskHistory(map3, taskSummary);
     if (params.decisions) {
       for (const entry of params.decisions) {
         const decision = {
@@ -93613,17 +93759,17 @@ function updateContextMapAfterAgent(params) {
           timestamp: new Date().toISOString(),
           task_id: params.task_id
         };
-        map3 = _internals44.appendDecision(map3, decision);
+        map3 = _internals45.appendDecision(map3, decision);
       }
     }
-    _internals44.saveContextMap(map3, params.directory);
+    _internals45.saveContextMap(map3, params.directory);
     return map3;
   } catch {
     try {
-      const fallback = _internals44.loadContextMap(params.directory) ?? _internals44.createEmptyContextMap();
+      const fallback = _internals45.loadContextMap(params.directory) ?? _internals45.createEmptyContextMap();
       return fallback;
     } catch {
-      return _internals44.createEmptyContextMap();
+      return _internals45.createEmptyContextMap();
     }
   }
 }
@@ -94930,7 +95076,7 @@ import * as path79 from "node:path";
 function estimateTokens3(content) {
   return Math.max(1, estimateTokens2(content));
 }
-var _internals45 = {
+var _internals46 = {
   loadContextMap,
   createEmptyContextMap,
   computeContentHash,
@@ -94998,14 +95144,14 @@ function buildReadPolicy(files, map3, directory, invalidateOnHashChange = true,
     const absolutePath = path79.join(directory, filePath);
     let currentContent;
     try {
-      if (_internals45.existsSync(absolutePath)) {
-        currentContent = _internals45.readFileSync(absolutePath, "utf-8");
+      if (_internals46.existsSync(absolutePath)) {
+        currentContent = _internals46.readFileSync(absolutePath, "utf-8");
       }
     } catch {}
     if (contentCache !== undefined) {
       contentCache.set(filePath, currentContent);
     }
-    if (currentContent === undefined || invalidateOnHashChange && _internals45.isFileStale(entry, currentContent)) {
+    if (currentContent === undefined || invalidateOnHashChange && _internals46.isFileStale(entry, currentContent)) {
       policy.push({
         file_path: filePath,
         trust_summary: false,
@@ -95080,7 +95226,7 @@ function pruneCapsuleContent(sections, tokenEstimate, maxTokens, estimateFn) {
 function buildCapsule(params) {
   const { task_id, agent_role, delegation_reason, directory } = params;
   const generatedAt = new Date().toISOString();
-  const map3 = _internals45.loadContextMap(directory) ?? _internals45.createEmptyContextMap();
+  const map3 = _internals46.loadContextMap(directory) ?? _internals46.createEmptyContextMap();
   let profile = DEFAULT_ROLE_PROFILES[agent_role];
   if (params.mode === "conservative") {
     profile = { ...profile, max_files: Math.ceil(profile.max_files * 1.5) };
@@ -95109,7 +95255,7 @@ function buildCapsule(params) {
       const shouldCheckStaleness = params.invalidate_on_hash_change !== false;
       if (shouldCheckStaleness) {
         const currentContent = contentCache.get(filePath);
-        if (currentContent === undefined || _internals45.isFileStale(entry, currentContent)) {
+        if (currentContent === undefined || _internals46.isFileStale(entry, currentContent)) {
           staleEntries++;
           fileSummaries.push(`- ${filePath} — ${entry.purpose || "No summary available"} (stale)`);
         } else {
@@ -95151,11 +95297,11 @@ function buildCapsule(params) {
   }
   const content = sections.join(`
 `);
-  let tokenEstimate = _internals45.estimateTokens(content);
+  let tokenEstimate = _internals46.estimateTokens(content);
   const maxCapsuleTokens = params.max_capsule_tokens ?? 2000;
   let prunedContent = content;
   if (tokenEstimate > maxCapsuleTokens) {
-    const { prunedSections, prunedTokenEstimate } = pruneCapsuleContent(sections, tokenEstimate, maxCapsuleTokens, _internals45.estimateTokens);
+    const { prunedSections, prunedTokenEstimate } = pruneCapsuleContent(sections, tokenEstimate, maxCapsuleTokens, _internals46.estimateTokens);
     prunedContent = prunedSections.join(`
 `);
     tokenEstimate = prunedTokenEstimate;
@@ -95191,7 +95337,7 @@ function buildCapsule(params) {
 // src/context-map/capsule-persistence.ts
 import * as fs50 from "node:fs";
 import * as path80 from "node:path";
-var _internals46 = {
+var _internals47 = {
   writeFileSync: fs50.writeFileSync,
   readFileSync: fs50.readFileSync,
   existsSync: fs50.existsSync,
@@ -95227,10 +95373,10 @@ function saveCapsule(capsule, directory) {
     const capsulesDir = path80.join(directory, ".swarm", "capsules");
     const finalPath = capsulePath(capsule.task_id, directory);
     const tmpPath = path80.join(capsulesDir, `capsule-${capsule.task_id}.tmp`);
-    _internals46.mkdirSync(capsulesDir, { recursive: true });
+    _internals47.mkdirSync(capsulesDir, { recursive: true });
     const json3 = JSON.stringify(capsule, null, 2);
-    _internals46.writeFileSync(tmpPath, json3, "utf-8");
-    _internals46.renameSync(tmpPath, finalPath);
+    _internals47.writeFileSync(tmpPath, json3, "utf-8");
+    _internals47.renameSync(tmpPath, finalPath);
     return {
       success: true,
       capsule_path: finalPath,
@@ -95258,7 +95404,7 @@ function saveCapsule(capsule, directory) {
 // src/context-map/telemetry.ts
 import * as fs51 from "node:fs";
 import * as path81 from "node:path";
-var _internals47 = {
+var _internals48 = {
   appendFileSync: fs51.appendFileSync,
   readFileSync: fs51.readFileSync,
   existsSync: fs51.existsSync,
@@ -95271,10 +95417,10 @@ function recordTelemetry(entry, directory) {
   const filePath = telemetryFilePath(directory);
   const swarmDir = path81.join(directory, ".swarm");
   try {
-    _internals47.mkdirSync(swarmDir, { recursive: true });
+    _internals48.mkdirSync(swarmDir, { recursive: true });
     const line = `${JSON.stringify(entry)}
 `;
-    _internals47.appendFileSync(filePath, line, "utf-8");
+    _internals48.appendFileSync(filePath, line, "utf-8");
     return true;
   } catch {
     return false;
@@ -95316,7 +95462,7 @@ function extractTaskGoal(taskId, directory) {
     return "";
   }
 }
-var _internals48 = {
+var _internals49 = {
   buildCapsule,
   recordTelemetry,
   saveCapsule,
@@ -95384,21 +95530,21 @@ async function injectCapsule(input, output, config3, directory) {
   const sessionID = input.sessionID;
   if (!sessionID)
     return;
-  const agentName = _internals48.getActiveAgent(sessionID);
+  const agentName = _internals49.getActiveAgent(sessionID);
   if (!agentName)
     return;
   const role = extractCapsuleRole(agentName);
   if (!role)
     return;
-  const taskId = _internals48.getCurrentTaskId(sessionID);
+  const taskId = _internals49.getCurrentTaskId(sessionID);
   const effectiveTaskId = taskId ?? "unknown";
-  const files = _internals48.readScopeFile(effectiveTaskId, directory);
+  const files = _internals49.readScopeFile(effectiveTaskId, directory);
   if (files.length === 0)
     return;
   const maxTokens = config3.context_map?.max_capsule_tokens;
-  const delegationReason = _internals48.resolveCapsuleDelegationReason(_internals48.getSession(sessionID), role, effectiveTaskId);
-  const taskGoal = _internals48.extractTaskGoal(effectiveTaskId, directory);
-  const { capsule, metadata: metadata2 } = _internals48.buildCapsule({
+  const delegationReason = _internals49.resolveCapsuleDelegationReason(_internals49.getSession(sessionID), role, effectiveTaskId);
+  const taskGoal = _internals49.extractTaskGoal(effectiveTaskId, directory);
+  const { capsule, metadata: metadata2 } = _internals49.buildCapsule({
     task_id: effectiveTaskId,
     agent_role: role,
     delegation_reason: delegationReason,
@@ -95414,7 +95560,7 @@ async function injectCapsule(input, output, config3, directory) {
     return;
   output.system.push(capsule.content);
   try {
-    _internals48.saveCapsule(capsule, directory);
+    _internals49.saveCapsule(capsule, directory);
   } catch {}
   const telemetryEntry = {
     timestamp: new Date().toISOString(),
@@ -95430,7 +95576,7 @@ async function injectCapsule(input, output, config3, directory) {
     success: metadata2.success
   };
   try {
-    _internals48.recordTelemetry(telemetryEntry, directory);
+    _internals49.recordTelemetry(telemetryEntry, directory);
   } catch {}
 }
 // src/hooks/curator-llm-factory.ts
@@ -97140,7 +97286,7 @@ function validateGraphEdge(edge) {
 }
 
 // src/tools/repo-graph/builder.ts
-var _internals49 = {
+var _internals50 = {
   safeRealpathSync,
   extractTSSymbols,
   extractPythonSymbols,
@@ -97227,12 +97373,12 @@ function resolveModuleSpecifier(workspaceRoot, sourceFile, specifier) {
     if (specifier.startsWith(".")) {
       const sourceDir = path88.dirname(sourceFile);
       let resolved = path88.resolve(sourceDir, specifier);
-      const initialRealResolved = _internals49.safeRealpathSync(resolved, resolved);
+      const initialRealResolved = _internals50.safeRealpathSync(resolved, resolved);
       if (initialRealResolved === null) {
         return null;
       }
       let realResolved = initialRealResolved;
-      const realRoot = _internals49.safeRealpathSync(workspaceRoot, path88.normalize(workspaceRoot));
+      const realRoot = _internals50.safeRealpathSync(workspaceRoot, path88.normalize(workspaceRoot));
       if (realRoot === null) {
         return null;
       }
@@ -97256,7 +97402,7 @@ function resolveModuleSpecifier(workspaceRoot, sourceFile, specifier) {
           }
         }
         if (found) {
-          const foundRealPath = _internals49.safeRealpathSync(found, found);
+          const foundRealPath = _internals50.safeRealpathSync(found, found);
           if (foundRealPath === null) {
             return null;
           }
@@ -97456,14 +97602,14 @@ function scanFile(filePath, absoluteRoot, maxFileSize) {
   try {
     if ([".ts", ".tsx", ".js", ".jsx", ".mjs", ".cjs"].includes(ext)) {
       const relativePath = path88.relative(absoluteRoot, filePath);
-      const symbols2 = _internals49.extractTSSymbols(relativePath, absoluteRoot);
+      const symbols2 = _internals50.extractTSSymbols(relativePath, absoluteRoot);
       exports = symbols2.filter((s) => s.exported).map((s) => s.name);
     } else if (ext === ".py") {
       const relativePath = path88.relative(absoluteRoot, filePath);
-      const symbols2 = _internals49.extractPythonSymbols(relativePath, absoluteRoot);
+      const symbols2 = _internals50.extractPythonSymbols(relativePath, absoluteRoot);
       exports = symbols2.filter((s) => s.exported).map((s) => s.name);
     }
-    const parsedImports = _internals49.parseFileImports(content);
+    const parsedImports = _internals50.parseFileImports(content);
     const node = {
       filePath,
       moduleName: toModuleName(filePath, absoluteRoot),
@@ -97593,7 +97739,7 @@ init_path_security();
 import { constants as constants4, existsSync as existsSync54 } from "node:fs";
 import * as fsPromises6 from "node:fs/promises";
 import * as path90 from "node:path";
-var _internals50 = {
+var _internals51 = {
   safeRealpathSync
 };
 var WINDOWS_RENAME_MAX_RETRIES2 = 3;
@@ -97701,12 +97847,12 @@ async function saveGraph(workspace, graph, options) {
     throw new Error("Graph must have edges array");
   }
   const normalizedWorkspace = path90.normalize(workspace);
-  const realWorkspace = _internals50.safeRealpathSync(workspace, normalizedWorkspace);
+  const realWorkspace = _internals51.safeRealpathSync(workspace, normalizedWorkspace);
   if (realWorkspace === null) {
     throw new Error(`Workspace realpath security check failed (non-ENOENT): ${workspace}`);
   }
   const normalizedGraphRoot = path90.normalize(graph.workspaceRoot);
-  const realGraphRoot = _internals50.safeRealpathSync(graph.workspaceRoot, normalizedGraphRoot);
+  const realGraphRoot = _internals51.safeRealpathSync(graph.workspaceRoot, normalizedGraphRoot);
   if (realGraphRoot === null) {
     throw new Error(`Graph workspaceRoot realpath security check failed (non-ENOENT): ${graph.workspaceRoot}`);
   }
@@ -104181,7 +104327,7 @@ async function knowledgeApplicationGateBefore(directory, input, config3) {
     if (config3.mode === "enforce") {
       throw new Error("KNOWLEDGE_ENFORCE_GATE_DENY: missing sessionID on tool.execute.before; refusing to evaluate critical-directive ack state");
     }
-    _internals53.writeWarnEvent(directory, {
+    _internals54.writeWarnEvent(directory, {
       timestamp: new Date().toISOString(),
       event: "knowledge_application_gate_warn",
       tool: toolName,
@@ -104264,7 +104410,7 @@ async function knowledgeApplicationTransformScan(directory, output, sessionID) {
     }
   }
 }
-var _internals53 = {
+var _internals54 = {
   knowledgeApplicationGateBefore,
   knowledgeApplicationTransformScan,
   HIGH_RISK_TOOLS,
@@ -104400,10 +104546,10 @@ async function getRunMemorySummary(directory) {
   if (entries.length === 0) {
     return null;
   }
-  const groups = _internals54.groupByTaskId(entries);
+  const groups = _internals55.groupByTaskId(entries);
   const summaries = [];
   for (const [taskId, taskEntries] of groups) {
-    const summary = _internals54.summarizeTask(taskId, taskEntries);
+    const summary = _internals55.summarizeTask(taskId, taskEntries);
     if (summary) {
       summaries.push(summary);
     }
@@ -104436,7 +104582,7 @@ Use this data to avoid repeating known failure patterns.`;
   }
   return prefix + summaryText + suffix;
 }
-var _internals54 = {
+var _internals55 = {
   generateTaskFingerprint,
   recordOutcome,
   getTaskHistory,
@@ -104629,7 +104775,7 @@ function createKnowledgeInjectorHook(directory, config3) {
       projectName,
       currentPhase: phaseDescription
     };
-    const searchFn = _internals56.searchKnowledge === defaultSearchKnowledge ? searchKnowledge : _internals56.searchKnowledge;
+    const searchFn = _internals57.searchKnowledge === defaultSearchKnowledge ? searchKnowledge : _internals57.searchKnowledge;
     const search = await searchFn({
       directory,
       config: config3,
@@ -104738,7 +104884,7 @@ ${freshPreamble}` : `<curator_briefing>${truncatedBriefing}</curator_briefing>`;
         ranks[id] = idx + 1;
         scores[id] = scoreById.get(id) ?? 0;
       });
-      await _internals56.recordKnowledgeEvent(directory, {
+      await _internals57.recordKnowledgeEvent(directory, {
         type: "retrieved",
         trace_id: search.trace_id,
         session_id: systemMsg?.info?.sessionID ?? "unknown",
@@ -104751,7 +104897,7 @@ ${freshPreamble}` : `<curator_briefing>${truncatedBriefing}</curator_briefing>`;
         ranks,
         scores
       });
-      _internals56.recordKnowledgeShown(directory, cachedShownIds, {
+      _internals57.recordKnowledgeShown(directory, cachedShownIds, {
         phase: phaseLabel,
         tool: retrievalCtx.currentTool,
         action: retrievalCtx.currentAction,
@@ -104761,7 +104907,7 @@ ${freshPreamble}` : `<curator_briefing>${truncatedBriefing}</curator_briefing>`;
     }
   });
 }
-var _internals56 = {
+var _internals57 = {
   searchKnowledge,
   recordKnowledgeEvent,
   recordKnowledgeShown
@@ -104946,7 +105092,7 @@ var TASK_DIVERSITY_WEIGHT = 0.05;
 var CONTEXT_WEIGHT = 0.2;
 var RECENCY_DECAY_MS = 30 * 24 * 60 * 60 * 1000;
 var SKILL_FRONTMATTER_READ_BYTES = 16 * 1024;
-var _internals57 = {
+var _internals58 = {
   computeSkillRelevanceScore: null,
   rankSkillsForContext: null,
   getSkillStats: null,
@@ -105165,7 +105311,7 @@ function formatSkillIndexWithContext(skills, directory) {
   } catch {}
   if (!hasHistory) {
     return skills.map((sp) => {
-      const meta3 = _internals57.readSkillMetadata(sp, directory);
+      const meta3 = _internals58.readSkillMetadata(sp, directory);
       return `  - file:${meta3.path} - ${meta3.name}: ${meta3.description}`;
     }).join(`
 `);
@@ -105173,7 +105319,7 @@ function formatSkillIndexWithContext(skills, directory) {
   const lines = [];
   for (const skillPath of skills) {
     const stats = getSkillStats(skillPath, directory);
-    const meta3 = _internals57.readSkillMetadata(skillPath, directory);
+    const meta3 = _internals58.readSkillMetadata(skillPath, directory);
     const compliancePct = Math.round(stats.complianceRate * 100);
     const topAgentNames = stats.topAgents.slice(0, 3).map((a) => a.agent).join(", ");
     lines.push(`  - file:${meta3.path} - ${meta3.name}: ${meta3.description} (used: ${stats.totalUsage}, compliance: ${compliancePct}%)` + (stats.topAgents.length > 0 ? ` → ${topAgentNames}` : ""));
@@ -105181,15 +105327,15 @@ function formatSkillIndexWithContext(skills, directory) {
   return lines.join(`
 `);
 }
-_internals57.computeSkillRelevanceScore = computeSkillRelevanceScore;
-_internals57.rankSkillsForContext = rankSkillsForContext;
-_internals57.getSkillStats = getSkillStats;
-_internals57.formatSkillIndexWithContext = formatSkillIndexWithContext;
-_internals57.parseSkillFrontmatter = parseSkillFrontmatter;
-_internals57.readSkillMetadata = readSkillMetadata;
-_internals57.extractSkillName = extractSkillName;
-_internals57.computeRecencyScore = computeRecencyScore;
-_internals57.computeContextMatchScore = computeContextMatchScore;
+_internals58.computeSkillRelevanceScore = computeSkillRelevanceScore;
+_internals58.rankSkillsForContext = rankSkillsForContext;
+_internals58.getSkillStats = getSkillStats;
+_internals58.formatSkillIndexWithContext = formatSkillIndexWithContext;
+_internals58.parseSkillFrontmatter = parseSkillFrontmatter;
+_internals58.readSkillMetadata = readSkillMetadata;
+_internals58.extractSkillName = extractSkillName;
+_internals58.computeRecencyScore = computeRecencyScore;
+_internals58.computeContextMatchScore = computeContextMatchScore;
 
 // src/hooks/skill-propagation-gate.ts
 init_skill_usage_log();
@@ -105292,10 +105438,10 @@ function parseYamlValue(value) {
 }
 function loadRoutingSkills(directory, targetAgent) {
   const routingPath = path111.join(directory, ".opencode", "skill-routing.yaml");
-  if (!_internals58.existsSync(routingPath))
+  if (!_internals59.existsSync(routingPath))
     return [];
   try {
-    const content = _internals58.readFileSync(routingPath, "utf-8");
+    const content = _internals59.readFileSync(routingPath, "utf-8");
     const config3 = parseSimpleYaml(content);
     if (!config3?.routing)
       return [];
@@ -105322,7 +105468,7 @@ var SKILL_SEARCH_ROOTS = [
   ".claude/skills"
 ];
 var MAX_SCORING_SESSION_ENTRIES = 500;
-var _internals58 = {
+var _internals59 = {
   readdirSync: fs73.readdirSync.bind(fs73),
   existsSync: fs73.existsSync.bind(fs73),
   statSync: fs73.statSync.bind(fs73),
@@ -105351,11 +105497,11 @@ function discoverAvailableSkills(directory) {
   const results = [];
   for (const root of SKILL_SEARCH_ROOTS) {
     const rootPath = path111.join(directory, root);
-    if (!_internals58.existsSync(rootPath))
+    if (!_internals59.existsSync(rootPath))
       continue;
     let entries;
     try {
-      entries = _internals58.readdirSync(rootPath);
+      entries = _internals59.readdirSync(rootPath);
     } catch {
       continue;
     }
@@ -105363,11 +105509,11 @@ function discoverAvailableSkills(directory) {
       if (entry.startsWith("."))
         continue;
       const skillDir = path111.join(rootPath, entry);
-      if (_internals58.existsSync(path111.join(skillDir, "retired.marker")))
+      if (_internals59.existsSync(path111.join(skillDir, "retired.marker")))
         continue;
       const skillFile = path111.join(skillDir, "SKILL.md");
       try {
-        if (_internals58.statSync(skillDir).isDirectory() && _internals58.existsSync(skillFile)) {
+        if (_internals59.statSync(skillDir).isDirectory() && _internals59.existsSync(skillFile)) {
           results.push(path111.join(root, entry, "SKILL.md").replace(/\\/g, "/"));
         }
       } catch (err2) {
@@ -105399,7 +105545,7 @@ function parseDelegationArgs(args2) {
   }
   if (!targetAgent)
     return null;
-  const skillsField = prompt ? _internals58.extractSkillsFieldFromPrompt(prompt) : "";
+  const skillsField = prompt ? _internals59.extractSkillsFieldFromPrompt(prompt) : "";
   return { targetAgent, skillsField };
 }
 function extractSkillsFieldFromPrompt(prompt) {
@@ -105440,10 +105586,10 @@ function writeWarnEvent2(directory, record3) {
   const filePath = path111.join(directory, ".swarm", "events.jsonl");
   try {
     const dir = path111.dirname(filePath);
-    if (!_internals58.existsSync(dir)) {
-      _internals58.mkdirSync(dir, { recursive: true });
+    if (!_internals59.existsSync(dir)) {
+      _internals59.mkdirSync(dir, { recursive: true });
     }
-    _internals58.appendFileSync(filePath, `${JSON.stringify(record3)}
+    _internals59.appendFileSync(filePath, `${JSON.stringify(record3)}
 `, "utf-8");
   } catch (err2) {
     warn(`[skill-propagation-gate] failed to write warning event: ${err2 instanceof Error ? err2.message : String(err2)}`);
@@ -105494,19 +105640,19 @@ async function skillPropagationGateBefore(directory, input, config3) {
   const baseAgent = stripKnownSwarmPrefix(agentRaw);
   if (baseAgent !== "architect")
     return { blocked: false, reason: null, recommendedSkills: undefined };
-  const parsed = _internals58.parseDelegationArgs(input.args);
+  const parsed = _internals59.parseDelegationArgs(input.args);
   if (!parsed)
     return { blocked: false, reason: null, recommendedSkills: undefined };
   const targetBase = stripKnownSwarmPrefix(parsed.targetAgent);
-  if (!_internals58.SKILL_CAPABLE_AGENTS.has(targetBase))
+  if (!_internals59.SKILL_CAPABLE_AGENTS.has(targetBase))
     return { blocked: false, reason: null, recommendedSkills: undefined };
   const sessionID = typeof input.sessionID === "string" ? input.sessionID : "unknown";
-  const availableSkills = _internals58.discoverAvailableSkills(directory);
+  const availableSkills = _internals59.discoverAvailableSkills(directory);
   const skillsValue = parsed.skillsField.trim();
   if (skillsValue && skillsValue.toLowerCase() !== "none") {
     const prompt = typeof input.args?.prompt === "string" ? String(input.args.prompt) : "";
-    const taskId = _internals58.extractTaskIdFromPrompt(prompt);
-    const skillPaths = _internals58.parseSkillPaths(skillsValue);
+    const taskId = _internals59.extractTaskIdFromPrompt(prompt);
+    const skillPaths = _internals59.parseSkillPaths(skillsValue);
     let coderSkillPaths = [];
     if (prompt) {
       for (const line of prompt.split(`
@@ -105514,7 +105660,7 @@ async function skillPropagationGateBefore(directory, input, config3) {
         const trimmed = line.trim();
         if (trimmed.startsWith("SKILLS_USED_BY_CODER:")) {
           const fieldVal = trimmed.slice("SKILLS_USED_BY_CODER:".length).trim();
-          coderSkillPaths = _internals58.parseSkillPaths(fieldVal);
+          coderSkillPaths = _internals59.parseSkillPaths(fieldVal);
           break;
         }
       }
@@ -105522,7 +105668,7 @@ async function skillPropagationGateBefore(directory, input, config3) {
     const allPaths = [...new Set([...skillPaths, ...coderSkillPaths])];
     for (const skillPath of allPaths) {
       try {
-        _internals58.appendSkillUsageEntry(directory, {
+        _internals59.appendSkillUsageEntry(directory, {
           skillPath,
           agentName: targetBase,
           taskID: taskId,
@@ -105539,17 +105685,17 @@ async function skillPropagationGateBefore(directory, input, config3) {
   let scored = [];
   if (skillsValue && skillsValue.toLowerCase() !== "none" && availableSkills.length > 0) {
     try {
-      const sessionEntries = _internals58.readSkillUsageEntriesTail(directory, {
+      const sessionEntries = _internals59.readSkillUsageEntriesTail(directory, {
         sessionID
       });
-      if (sessionEntries.length > _internals58.MAX_SCORING_SESSION_ENTRIES) {
+      if (sessionEntries.length > _internals59.MAX_SCORING_SESSION_ENTRIES) {
         scoringSkipped = true;
-        warn(`[skill-propagation-gate] skipping scoring — tail window has ${sessionEntries.length} session entries (limit: ${_internals58.MAX_SCORING_SESSION_ENTRIES})`);
+        warn(`[skill-propagation-gate] skipping scoring — tail window has ${sessionEntries.length} session entries (limit: ${_internals59.MAX_SCORING_SESSION_ENTRIES})`);
       } else {
         const prompt = typeof input.args?.prompt === "string" ? String(input.args.prompt) : "";
         scored = availableSkills.map((skillPath) => {
           const skillEntries = sessionEntries.filter((e) => e.skillPath === skillPath);
-          const score = _internals58.computeSkillRelevanceScore(skillPath, prompt, skillEntries);
+          const score = _internals59.computeSkillRelevanceScore(skillPath, prompt, skillEntries);
           return { skillPath, score, usageCount: skillEntries.length };
         }).sort((a, b) => b.score - a.score || b.usageCount - a.usageCount);
         if (scored.length > 0) {
@@ -105563,12 +105709,12 @@ async function skillPropagationGateBefore(directory, input, config3) {
     }
   }
   try {
-    const routingPaths = _internals58.loadRoutingSkills(directory, targetBase);
+    const routingPaths = _internals59.loadRoutingSkills(directory, targetBase);
     if (routingPaths.length > 0) {
       const existingPaths = new Set(scored.map((s) => s.skillPath));
       for (const routingPath of routingPaths) {
         const routedSkillDir = path111.dirname(path111.join(directory, routingPath));
-        if (_internals58.existsSync(path111.join(routedSkillDir, "retired.marker")))
+        if (_internals59.existsSync(path111.join(routedSkillDir, "retired.marker")))
           continue;
         if (!existingPaths.has(routingPath)) {
           scored.push({
@@ -105594,12 +105740,12 @@ async function skillPropagationGateBefore(directory, input, config3) {
       } else if (typeof scored !== "undefined" && scored.length > 0) {
         skillsForIndex = scored.map((r) => r.skillPath);
       }
-      const formattedIndex = _internals58.formatSkillIndexWithContext(skillsForIndex, directory);
+      const formattedIndex = _internals59.formatSkillIndexWithContext(skillsForIndex, directory);
       if (formattedIndex.length > 0) {
         const contextPath = path111.join(directory, ".swarm", "context.md");
         let existingContent = "";
-        if (_internals58.existsSync(contextPath)) {
-          existingContent = _internals58.readFileSync(contextPath, "utf-8");
+        if (_internals59.existsSync(contextPath)) {
+          existingContent = _internals59.readFileSync(contextPath, "utf-8");
         }
         const sectionHeader = "## Available Skills";
         const newSection = `${sectionHeader}
@@ -105619,10 +105765,10 @@ ${newSection}`;
           }
         }
         const swarmDir = path111.dirname(contextPath);
-        if (!_internals58.existsSync(swarmDir)) {
-          _internals58.mkdirSync(swarmDir, { recursive: true });
+        if (!_internals59.existsSync(swarmDir)) {
+          _internals59.mkdirSync(swarmDir, { recursive: true });
         }
-        _internals58.writeFileSync(contextPath, updatedContent, "utf-8");
+        _internals59.writeFileSync(contextPath, updatedContent, "utf-8");
       }
     } catch (err2) {
       warn(`[skill-propagation-gate] failed to write skill index to context.md: ${err2 instanceof Error ? err2.message : String(err2)}`);
@@ -105648,7 +105794,7 @@ ${newSection}`;
   });
   const warningMsg = `Skill propagation warning: Delegating to ${targetBase} without SKILLS field. ` + `Available skills: ${skillNames.join(", ")}`;
   try {
-    _internals58.writeWarnEvent(directory, {
+    _internals59.writeWarnEvent(directory, {
       type: "skill_propagation_warn",
       timestamp: new Date().toISOString(),
       tool: toolName,
@@ -105677,7 +105823,7 @@ async function skillPropagationTransformScan(directory, output, sessionID) {
   let dedupKeys = new Set;
   let existingEntries = [];
   try {
-    existingEntries = _internals58.readSkillUsageEntriesTail(directory, {
+    existingEntries = _internals59.readSkillUsageEntriesTail(directory, {
       sessionID
     });
     dedupKeys = new Set(existingEntries.map((e, i2) => {
@@ -105709,7 +105855,7 @@ async function skillPropagationTransformScan(directory, output, sessionID) {
 `)) {
       const coderMatch = line.trim().match(CODER_SKILLS_PATTERN);
       if (coderMatch) {
-        const parsed = _internals58.parseSkillPaths(coderMatch[1]);
+        const parsed = _internals59.parseSkillPaths(coderMatch[1]);
         skillPaths.push(...parsed);
       }
     }
@@ -105740,7 +105886,7 @@ async function skillPropagationTransformScan(directory, output, sessionID) {
         if (isDuplicate(skillPath, "reviewer", resolvedTaskID))
           continue;
         try {
-          _internals58.appendSkillUsageEntry(directory, {
+          _internals59.appendSkillUsageEntry(directory, {
             skillPath,
             agentName: "reviewer",
             taskID: resolvedTaskID,
@@ -105784,15 +105930,15 @@ async function skillPropagationTransformScan(directory, output, sessionID) {
         skillsField = trimmed.slice("SKILLS:".length).trim();
       }
       if (currentTargetAgent && skillsField && skillsField.toLowerCase() !== "none") {
-        const skillPaths = _internals58.parseSkillPaths(skillsField);
-        const taskId = _internals58.extractTaskIdFromPrompt(text);
+        const skillPaths = _internals59.parseSkillPaths(skillsField);
+        const taskId = _internals59.extractTaskIdFromPrompt(text);
         for (const skillPath of skillPaths) {
           if (hadRecordingError)
             break;
           if (isDuplicate(skillPath, currentTargetAgent, taskId))
             continue;
           try {
-            _internals58.appendSkillUsageEntry(directory, {
+            _internals59.appendSkillUsageEntry(directory, {
               skillPath,
               agentName: currentTargetAgent,
               taskID: taskId,
@@ -105812,16 +105958,16 @@ async function skillPropagationTransformScan(directory, output, sessionID) {
     break;
   }
 }
-_internals58.skillPropagationGateBefore = skillPropagationGateBefore;
-_internals58.skillPropagationTransformScan = skillPropagationTransformScan;
-_internals58.writeWarnEvent = writeWarnEvent2;
-_internals58.discoverAvailableSkills = discoverAvailableSkills;
-_internals58.parseDelegationArgs = parseDelegationArgs;
-_internals58.parseSkillPaths = parseSkillPaths;
-_internals58.extractTaskIdFromPrompt = extractTaskIdFromPrompt;
-_internals58.extractSkillsFieldFromPrompt = extractSkillsFieldFromPrompt;
-_internals58.formatSkillIndexWithContext = formatSkillIndexWithContext;
-_internals58.loadRoutingSkills = loadRoutingSkills;
+_internals59.skillPropagationGateBefore = skillPropagationGateBefore;
+_internals59.skillPropagationTransformScan = skillPropagationTransformScan;
+_internals59.writeWarnEvent = writeWarnEvent2;
+_internals59.discoverAvailableSkills = discoverAvailableSkills;
+_internals59.parseDelegationArgs = parseDelegationArgs;
+_internals59.parseSkillPaths = parseSkillPaths;
+_internals59.extractTaskIdFromPrompt = extractTaskIdFromPrompt;
+_internals59.extractSkillsFieldFromPrompt = extractSkillsFieldFromPrompt;
+_internals59.formatSkillIndexWithContext = formatSkillIndexWithContext;
+_internals59.loadRoutingSkills = loadRoutingSkills;
 
 // src/index.ts
 init_skill_usage_log();
@@ -109936,7 +110082,7 @@ var VALID_TASK_ID = /^\d+\.\d+(\.\d+)*$/;
 var COUNCIL_GATE_NAME = "council";
 var COUNCIL_AGENT_ID = "architect";
 var EvidenceFileSchema = exports_external.record(exports_external.string(), exports_external.unknown());
-var _internals59 = {
+var _internals60 = {
   withTaskEvidenceLock
 };
 var FORBIDDEN_KEYS = new Set(["__proto__", "constructor", "prototype"]);
@@ -109971,7 +110117,7 @@ async function writeCouncilEvidence(workingDir, synthesis) {
   const dir = join102(workingDir, EVIDENCE_DIR2);
   mkdirSync32(dir, { recursive: true });
   const filePath = taskEvidencePath(workingDir, synthesis.taskId);
-  await _internals59.withTaskEvidenceLock(workingDir, synthesis.taskId, COUNCIL_AGENT_ID, async () => {
+  await _internals60.withTaskEvidenceLock(workingDir, synthesis.taskId, COUNCIL_AGENT_ID, async () => {
     const existingRoot = Object.create(null);
     if (existsSync69(filePath)) {
       try {
@@ -110892,7 +111038,7 @@ var ArgsSchema2 = exports_external.object({
   working_directory: exports_external.string().optional()
 });
 var convene_general_council = createSwarmTool({
-  description: "Synthesize responses from a multi-model General Council. Accepts parallel member " + "responses (Round 1, optionally Round 2), detects disagreements, and returns " + "consensus points, persisting disagreements, and a structured synthesis. " + "Architect-only. Config-gated on council.general.enabled.",
+  description: "Synthesize responses from a multi-model General Council. Accepts parallel member " + "responses (Round 1, optionally Round 2), detects disagreements, and returns " + "consensus points, persisting disagreements, and a structured synthesis. " + "Architect-only. Config-gated on council.general.enabled in the resolved config: global ~/.config/opencode/opencode-swarm.json, then project .opencode/opencode-swarm.json overrides.",
   args: {
     question: exports_external.string().min(1).max(8000).describe("The question put to the council, or the spec text to review."),
     mode: exports_external.enum(["general", "spec_review"]).optional().describe('"general" for /swarm council; "spec_review" for SPECIFY-COUNCIL-REVIEW gate.'),
@@ -110971,7 +111117,7 @@ var convene_general_council = createSwarmTool({
       const fail = {
         success: false,
         reason: "council_general_disabled",
-        message: "convene_general_council requires council.general.enabled: true in opencode-swarm.json."
+        message: "convene_general_council requires council.general.enabled: true in the resolved config: global ~/.config/opencode/opencode-swarm.json or project .opencode/opencode-swarm.json."
       };
       return JSON.stringify(fail, null, 2);
     }
@@ -115092,7 +115238,7 @@ function resolveDefaultReviewerAgent(generatedAgentNames) {
 }
 async function compileReviewPackage(directory, phase, sessionID, requireDiffSummary) {
   const lanes = await listLaneEvidence(directory, phase);
-  const persisted = _internals60.readPersisted?.(directory) ?? null;
+  const persisted = _internals61.readPersisted?.(directory) ?? null;
   if (persisted) {
     let matchingRunState = null;
     for (const sessionState of Object.values(persisted.sessions)) {
@@ -115284,7 +115430,7 @@ Be specific and evidence-based. Do not approve a phase with unresolved degraded
     client.session.delete({ path: { id: sessionId } }).catch(() => {});
   }
 }
-var _internals60 = {
+var _internals61 = {
   compileReviewPackage,
   parseReviewerVerdict,
   writeReviewerEvidence,
@@ -115301,28 +115447,28 @@ async function dispatchPhaseReviewer(directory, phase, sessionID, config3) {
   };
   const generatedAgentNames = swarmState.generatedAgentNames;
   const agentName = mergedConfig.reviewerAgent || resolveDefaultReviewerAgent(generatedAgentNames);
-  const pkg = await _internals60.compileReviewPackage(directory, phase, sessionID, mergedConfig.requireDiffSummary);
+  const pkg = await _internals61.compileReviewPackage(directory, phase, sessionID, mergedConfig.requireDiffSummary);
   let responseText;
   try {
-    responseText = await _internals60.dispatchReviewerAgent(directory, pkg, agentName, mergedConfig.timeoutMs);
+    responseText = await _internals61.dispatchReviewerAgent(directory, pkg, agentName, mergedConfig.timeoutMs);
   } catch (error93) {
-    const evidencePath2 = await _internals60.writeReviewerEvidence(directory, phase, "REJECTED", error93 instanceof Error ? error93.message : String(error93));
+    const evidencePath2 = await _internals61.writeReviewerEvidence(directory, phase, "REJECTED", error93 instanceof Error ? error93.message : String(error93));
     return {
       verdict: "REJECTED",
       reason: `Reviewer dispatch failed: ${error93 instanceof Error ? error93.message : String(error93)}`,
       evidencePath: evidencePath2
     };
   }
-  const parsed = _internals60.parseReviewerVerdict(responseText);
+  const parsed = _internals61.parseReviewerVerdict(responseText);
   if (!parsed) {
-    const evidencePath2 = await _internals60.writeReviewerEvidence(directory, phase, "REJECTED", "Reviewer response could not be parsed");
+    const evidencePath2 = await _internals61.writeReviewerEvidence(directory, phase, "REJECTED", "Reviewer response could not be parsed");
     return {
       verdict: "REJECTED",
       reason: "Reviewer response could not be parsed",
       evidencePath: evidencePath2
     };
   }
-  const evidencePath = await _internals60.writeReviewerEvidence(directory, phase, parsed.verdict, parsed.reason);
+  const evidencePath = await _internals61.writeReviewerEvidence(directory, phase, parsed.verdict, parsed.reason);
   return {
     verdict: parsed.verdict,
     reason: parsed.reason,
@@ -115829,7 +115975,7 @@ ${fileList}
 
 // src/tools/lean-turbo-run-phase.ts
 init_create_tool();
-var _internals61 = {
+var _internals62 = {
   LeanTurboRunner,
   loadPluginConfigWithMeta
 };
@@ -115839,9 +115985,9 @@ async function executeLeanTurboRunPhase(args2) {
   let runError = null;
   let runner = null;
   try {
-    const { config: config3 } = _internals61.loadPluginConfigWithMeta(directory);
+    const { config: config3 } = _internals62.loadPluginConfigWithMeta(directory);
     const leanConfig = config3.turbo?.strategy === "lean" ? config3.turbo.lean : undefined;
-    runner = new _internals61.LeanTurboRunner({
+    runner = new _internals62.LeanTurboRunner({
       directory,
       sessionID,
       opencodeClient: swarmState.opencodeClient ?? null,
@@ -116202,7 +116348,7 @@ function isStaticallyEquivalent(originalCode, mutatedCode) {
   const strippedMutated = stripCode(mutatedCode);
   return strippedOriginal === strippedMutated;
 }
-var _internals62 = {
+var _internals63 = {
   isStaticallyEquivalent,
   checkEquivalence,
   batchCheckEquivalence
@@ -116242,7 +116388,7 @@ async function batchCheckEquivalence(patches, llmJudge) {
   const results = [];
   for (const { patch, originalCode, mutatedCode } of patches) {
     try {
-      const result = await _internals62.checkEquivalence(patch, originalCode, mutatedCode, llmJudge);
+      const result = await _internals63.checkEquivalence(patch, originalCode, mutatedCode, llmJudge);
       results.push(result);
     } catch (err2) {
       results.push({
@@ -116261,7 +116407,7 @@ async function batchCheckEquivalence(patches, llmJudge) {
 var MUTATION_TIMEOUT_MS = 30000;
 var TOTAL_BUDGET_MS = 300000;
 var GIT_APPLY_TIMEOUT_MS = 5000;
-var _internals63 = {
+var _internals64 = {
   executeMutation,
   computeReport,
   executeMutationSuite,
@@ -116293,7 +116439,7 @@ async function executeMutation(patch, testCommand, _testFiles, workingDir) {
       };
     }
     try {
-      const applyResult = _internals63.spawnSync("git", ["apply", "--", patchFile], {
+      const applyResult = _internals64.spawnSync("git", ["apply", "--", patchFile], {
         cwd: workingDir,
         timeout: GIT_APPLY_TIMEOUT_MS,
         stdio: "pipe"
@@ -116322,7 +116468,7 @@ async function executeMutation(patch, testCommand, _testFiles, workingDir) {
     }
     let testPassed = false;
     try {
-      const spawnResult = _internals63.spawnSync(testCommand[0], testCommand.slice(1), {
+      const spawnResult = _internals64.spawnSync(testCommand[0], testCommand.slice(1), {
         cwd: workingDir,
         timeout: MUTATION_TIMEOUT_MS,
         stdio: "pipe"
@@ -116355,7 +116501,7 @@ async function executeMutation(patch, testCommand, _testFiles, workingDir) {
   } finally {
     if (patchFile) {
       try {
-        const revertResult = _internals63.spawnSync("git", ["apply", "-R", "--", patchFile], {
+        const revertResult = _internals64.spawnSync("git", ["apply", "-R", "--", patchFile], {
           cwd: workingDir,
           timeout: GIT_APPLY_TIMEOUT_MS,
           stdio: "pipe"
@@ -116548,7 +116694,7 @@ async function executeMutationSuite(patches, testCommand, testFiles, workingDir,
 }
 
 // src/mutation/gate.ts
-var _internals64 = {
+var _internals65 = {
   evaluateMutationGate,
   buildTestImprovementPrompt,
   buildMessage
@@ -116569,8 +116715,8 @@ function evaluateMutationGate(report, passThreshold = PASS_THRESHOLD, warnThresh
   } else {
     verdict = "fail";
   }
-  const testImprovementPrompt = _internals64.buildTestImprovementPrompt(report, passThreshold, verdict);
-  const message = _internals64.buildMessage(verdict, adjustedKillRate, report.killed, report.totalMutants, report.equivalent, warnThreshold);
+  const testImprovementPrompt = _internals65.buildTestImprovementPrompt(report, passThreshold, verdict);
+  const message = _internals65.buildMessage(verdict, adjustedKillRate, report.killed, report.totalMutants, report.equivalent, warnThreshold);
   return {
     verdict,
     killRate: report.killRate,
@@ -116965,7 +117111,7 @@ function listLaneEvidenceSync(directory, phase) {
   }
   return laneIds;
 }
-var _internals65 = {
+var _internals66 = {
   listActiveLocks,
   readPersisted: readPersisted2,
   readPlanJson: defaultReadPlanJson,
@@ -117026,7 +117172,7 @@ function verifyLeanTurboPhaseReady(directory, phase, sessionIDOrConfig, config3)
       reason: "Lean Turbo state unreadable or missing"
     };
   }
-  const persisted = _internals65.readPersisted(directory);
+  const persisted = _internals66.readPersisted(directory);
   if (!persisted) {
     return {
       ok: false,
@@ -117090,7 +117236,7 @@ function verifyLeanTurboPhaseReady(directory, phase, sessionIDOrConfig, config3)
     }
   }
   if (runState.lanes.length > 0) {
-    const evidenceLaneIds = new Set(_internals65.listLaneEvidenceSync(directory, phase));
+    const evidenceLaneIds = new Set(_internals66.listLaneEvidenceSync(directory, phase));
     for (const lane of runState.lanes) {
       if ((lane.status === "completed" || lane.status === "failed") && !evidenceLaneIds.has(lane.laneId)) {
         return {
@@ -117100,7 +117246,7 @@ function verifyLeanTurboPhaseReady(directory, phase, sessionIDOrConfig, config3)
       }
     }
   }
-  const activeLocks = _internals65.listActiveLocks(directory);
+  const activeLocks = _internals66.listActiveLocks(directory);
   const phaseLaneIds = new Set(laneIds);
   for (const lock of activeLocks) {
     if (lock.laneId && phaseLaneIds.has(lock.laneId)) {
@@ -117120,7 +117266,7 @@ function verifyLeanTurboPhaseReady(directory, phase, sessionIDOrConfig, config3)
   }
   const serialDegradedTasks = runState.degradedTasks.filter((dt) => !laneTaskIds.has(dt.taskId));
   if (serialDegradedTasks.length > 0) {
-    const plan = _internals65.readPlanJson(directory);
+    const plan = _internals66.readPlanJson(directory);
     if (!plan) {
       return {
         ok: false,
@@ -117164,7 +117310,7 @@ function verifyLeanTurboPhaseReady(directory, phase, sessionIDOrConfig, config3)
   }
   const serializedTasks = runState.serializedTasks;
   if (Array.isArray(serializedTasks) && serializedTasks.length > 0) {
-    const plan = _internals65.readPlanJson(directory);
+    const plan = _internals66.readPlanJson(directory);
     if (!plan) {
       return {
         ok: false,
@@ -117223,7 +117369,7 @@ function verifyLeanTurboPhaseReady(directory, phase, sessionIDOrConfig, config3)
   }
   let reviewerVerdict = runState.lastReviewerVerdict;
   if (!reviewerVerdict) {
-    const evidence = _internals65.readReviewerEvidence(directory, phase);
+    const evidence = _internals66.readReviewerEvidence(directory, phase);
     reviewerVerdict = evidence?.verdict ?? undefined;
   }
   if (mergedConfig.phase_reviewer) {
@@ -117236,7 +117382,7 @@ function verifyLeanTurboPhaseReady(directory, phase, sessionIDOrConfig, config3)
   }
   let criticVerdict = runState.lastCriticVerdict;
   if (!criticVerdict) {
-    const evidence = _internals65.readCriticEvidence(directory, phase);
+    const evidence = _internals66.readCriticEvidence(directory, phase);
     criticVerdict = evidence?.verdict ?? undefined;
   }
   if (mergedConfig.phase_critic) {
@@ -118336,7 +118482,7 @@ async function executePhaseComplete(args2, workingDirectory, directory) {
       phase_critic: leanConfig.phase_critic,
       integrated_diff_required: leanConfig.integrated_diff_required
     } : undefined;
-    const leanCheck = _internals65.verifyLeanTurboPhaseReady(dir, phase, sessionID, leanPhaseReadyConfig);
+    const leanCheck = _internals66.verifyLeanTurboPhaseReady(dir, phase, sessionID, leanPhaseReadyConfig);
     if (!leanCheck.ok) {
       return JSON.stringify({
         success: false,
@@ -120599,11 +120745,11 @@ var quality_budget = createSwarmTool({
     }).optional().describe("Quality budget thresholds")
   },
   async execute(args2, directory) {
-    const result = await _internals67.qualityBudget(args2, directory);
+    const result = await _internals68.qualityBudget(args2, directory);
     return JSON.stringify(result);
   }
 });
-var _internals67 = {
+var _internals68 = {
   qualityBudget
 };
 
@@ -121332,7 +121478,7 @@ import * as path149 from "node:path";
 var semgrepAvailableCache = null;
 var DEFAULT_RULES_DIR = ".swarm/semgrep-rules";
 var DEFAULT_TIMEOUT_MS3 = 30000;
-var _internals68 = {
+var _internals69 = {
   isSemgrepAvailable,
   checkSemgrepAvailable,
   resetSemgrepCache,
@@ -121357,7 +121503,7 @@ function isSemgrepAvailable() {
   }
 }
 async function checkSemgrepAvailable() {
-  return _internals68.isSemgrepAvailable();
+  return _internals69.isSemgrepAvailable();
 }
 function resetSemgrepCache() {
   semgrepAvailableCache = null;
@@ -121454,12 +121600,12 @@ async function runSemgrep(options) {
   const timeoutMs = options.timeoutMs || DEFAULT_TIMEOUT_MS3;
   if (files.length === 0) {
     return {
-      available: _internals68.isSemgrepAvailable(),
+      available: _internals69.isSemgrepAvailable(),
       findings: [],
       engine: "tier_a"
     };
   }
-  if (!_internals68.isSemgrepAvailable()) {
+  if (!_internals69.isSemgrepAvailable()) {
     return {
       available: false,
       findings: [],
@@ -121618,7 +121764,7 @@ function assignOccurrenceIndices(findings, directory) {
     }
     const occIdx = countMap.get(baseKey) ?? 0;
     countMap.set(baseKey, occIdx + 1);
-    const fp = _internals69.fingerprintFinding(finding, directory, occIdx);
+    const fp = _internals70.fingerprintFinding(finding, directory, occIdx);
     return {
       finding,
       index: occIdx,
@@ -121687,7 +121833,7 @@ async function captureOrMergeBaseline(directory, phase, findings, engine, scanne
       }
     } catch {}
     const scannedRelFiles = new Set(scannedFiles.map((f) => normalizeFindingPath(directory, f)));
-    const indexed = _internals69.assignOccurrenceIndices(findings, directory);
+    const indexed = _internals70.assignOccurrenceIndices(findings, directory);
     if (existing && !opts?.force) {
       const prunedFingerprints = existing.fingerprints.filter((fp) => {
         const relFile = fp.slice(0, fp.indexOf("|"));
@@ -121827,7 +121973,7 @@ function loadBaseline(directory, phase) {
     };
   }
 }
-var _internals69 = {
+var _internals70 = {
   fingerprintFinding,
   assignOccurrenceIndices,
   captureOrMergeBaseline,
@@ -122237,11 +122383,11 @@ var sast_scan = createSwarmTool({
       capture_baseline: safeArgs.capture_baseline,
       phase: safeArgs.phase
     };
-    const result = await _internals70.sastScan(input, directory);
+    const result = await _internals71.sastScan(input, directory);
     return JSON.stringify(result, null, 2);
   }
 });
-var _internals70 = {
+var _internals71 = {
   sastScan,
   sast_scan
 };
@@ -126008,7 +126154,7 @@ var set_qa_gates = createSwarmTool({
     hallucination_guard: exports_external.boolean().optional().describe("Enable hallucination_guard checks on plan and implementation claims."),
     sast_enabled: exports_external.boolean().optional().describe("Enable SAST scanning as a required QA gate."),
     mutation_test: exports_external.boolean().optional().describe("Enable the mutation-testing gate (default: off). Requires mutation " + "tests to achieve a passing kill rate before phase completion; " + "WARN verdict allows advancement, FAIL blocks."),
-    council_general_review: exports_external.boolean().optional().describe("Enable the council_general_review gate (default: off). When on, " + "MODE: SPECIFY runs convene_general_council on the draft spec " + "before the critic-gate, folding multi-model deliberation into " + "the spec. Requires council.general.enabled and a search API key."),
+    council_general_review: exports_external.boolean().optional().describe("Enable the council_general_review gate (default: off). When on, " + "MODE: SPECIFY runs convene_general_council on the draft spec " + "before the critic-gate, folding multi-model deliberation into " + "the spec. Requires council.general.enabled and a search API key " + "in the resolved config: global ~/.config/opencode/opencode-swarm.json, " + "then project .opencode/opencode-swarm.json overrides."),
     drift_check: exports_external.boolean().optional().describe("Enable drift verification gate (default: on). Blocks phase_complete " + "until drift-verifier.json has an approved verdict. When disabled, " + "drift verification is skipped entirely."),
     final_council: exports_external.boolean().optional().describe("Enable the final_council gate (default: off). When on, " + "after all phases complete the architect dispatches critic, reviewer, " + "sme, test_engineer, and explorer with project-scoped context, " + "collects their CouncilMemberVerdict objects, and calls " + "write_final_council_evidence. This is not General Council mode " + "and does not require council.general.enabled."),
     project_type: exports_external.string().optional().describe('Project type label (e.g. "ts", "python"). Only applied when the profile is being created for the first time.')
@@ -127187,7 +127333,7 @@ var swarm_memory_propose = createSwarmTool({
     evidenceRefs: exports_external.array(exports_external.string().min(1).max(500)).max(20).optional().describe("Evidence refs such as files, commits, test outputs, or URLs")
   },
   execute: async (args2, directory, ctx) => {
-    const { config: config3 } = _internals71.loadPluginConfigWithMeta(directory);
+    const { config: config3 } = _internals72.loadPluginConfigWithMeta(directory);
     if (config3.memory?.enabled !== true) {
       return JSON.stringify({
         success: false,
@@ -127203,7 +127349,7 @@ var swarm_memory_propose = createSwarmTool({
       });
     }
     const agent = getContextAgent2(ctx);
-    const gateway = _internals71.createMemoryGateway({
+    const gateway = _internals72.createMemoryGateway({
       directory,
       sessionID: ctx?.sessionID,
       agentRole: agent,
@@ -127228,7 +127374,7 @@ var swarm_memory_propose = createSwarmTool({
     }
   }
 });
-var _internals71 = {
+var _internals72 = {
   loadPluginConfigWithMeta,
   createMemoryGateway
 };
@@ -127266,7 +127412,7 @@ var swarm_memory_recall = createSwarmTool({
     maxItems: exports_external.number().int().min(1).max(20).optional().describe("Maximum memories to return")
   },
   execute: async (args2, directory, ctx) => {
-    const { config: config3 } = _internals72.loadPluginConfigWithMeta(directory);
+    const { config: config3 } = _internals73.loadPluginConfigWithMeta(directory);
     if (config3.memory?.enabled !== true) {
       return JSON.stringify({
         success: false,
@@ -127282,7 +127428,7 @@ var swarm_memory_recall = createSwarmTool({
       });
     }
     const agent = getContextAgent3(ctx);
-    const gateway = _internals72.createMemoryGateway({
+    const gateway = _internals73.createMemoryGateway({
       directory,
       sessionID: ctx?.sessionID,
       agentRole: agent,
@@ -127315,7 +127461,7 @@ var RecallArgsSchema = exports_external.object({
   kinds: exports_external.array(exports_external.enum(MEMORY_KINDS2)).optional(),
   maxItems: exports_external.number().int().min(1).max(20).optional()
 });
-var _internals72 = {
+var _internals73 = {
   loadPluginConfigWithMeta,
   createMemoryGateway
 };
@@ -127830,7 +127976,7 @@ import * as path165 from "node:path";
 init_bun_compat();
 import * as fs122 from "node:fs";
 import * as path164 from "node:path";
-var _internals73 = { bunSpawn };
+var _internals74 = { bunSpawn };
 var _swarmGitExcludedChecked = false;
 function fileCoversSwarm(content) {
   for (const rawLine of content.split(`
@@ -127863,7 +128009,7 @@ async function ensureSwarmGitExcluded(directory, options = {}) {
       checkIgnoreExitCode
     ] = await Promise.all([
       (async () => {
-        const proc = _internals73.bunSpawn(["git", "-C", directory, "rev-parse", "--show-toplevel"], GIT_SPAWN_OPTIONS);
+        const proc = _internals74.bunSpawn(["git", "-C", directory, "rev-parse", "--show-toplevel"], GIT_SPAWN_OPTIONS);
         try {
           return await Promise.all([proc.exited, proc.stdout.text()]);
         } finally {
@@ -127873,7 +128019,7 @@ async function ensureSwarmGitExcluded(directory, options = {}) {
         }
       })(),
       (async () => {
-        const proc = _internals73.bunSpawn(["git", "-C", directory, "rev-parse", "--git-path", "info/exclude"], GIT_SPAWN_OPTIONS);
+        const proc = _internals74.bunSpawn(["git", "-C", directory, "rev-parse", "--git-path", "info/exclude"], GIT_SPAWN_OPTIONS);
         try {
           return await Promise.all([proc.exited, proc.stdout.text()]);
         } finally {
@@ -127883,7 +128029,7 @@ async function ensureSwarmGitExcluded(directory, options = {}) {
         }
       })(),
       (async () => {
-        const proc = _internals73.bunSpawn(["git", "-C", directory, "check-ignore", "-q", ".swarm/.gitkeep"], GIT_SPAWN_OPTIONS);
+        const proc = _internals74.bunSpawn(["git", "-C", directory, "check-ignore", "-q", ".swarm/.gitkeep"], GIT_SPAWN_OPTIONS);
         try {
           return await proc.exited;
         } finally {
@@ -127922,7 +128068,7 @@ async function ensureSwarmGitExcluded(directory, options = {}) {
         }
       } catch {}
     }
-    const trackedProc = _internals73.bunSpawn(["git", "-C", directory, "ls-files", "--", ".swarm"], GIT_SPAWN_OPTIONS);
+    const trackedProc = _internals74.bunSpawn(["git", "-C", directory, "ls-files", "--", ".swarm"], GIT_SPAWN_OPTIONS);
     let trackedExitCode;
     let trackedOutput;
     try {
@@ -127947,7 +128093,7 @@ async function ensureSwarmGitExcluded(directory, options = {}) {
 }
 
 // src/hooks/diff-scope.ts
-var _internals74 = { bunSpawn };
+var _internals75 = { bunSpawn };
 function getDeclaredScope(taskId, directory) {
   try {
     const planPath = path165.join(directory, ".swarm", "plan.json");
@@ -127982,7 +128128,7 @@ var GIT_DIFF_SPAWN_OPTIONS = {
 };
 async function getChangedFiles(directory) {
   try {
-    const proc = _internals74.bunSpawn(["git", "diff", "--name-only", "HEAD~1"], {
+    const proc = _internals75.bunSpawn(["git", "diff", "--name-only", "HEAD~1"], {
       cwd: directory,
       ...GIT_DIFF_SPAWN_OPTIONS
     });
@@ -127999,7 +128145,7 @@ async function getChangedFiles(directory) {
       return stdout.trim().split(`
 `).map((f) => f.trim()).filter((f) => f.length > 0);
     }
-    const proc2 = _internals74.bunSpawn(["git", "diff", "--name-only", "HEAD"], {
+    const proc2 = _internals75.bunSpawn(["git", "diff", "--name-only", "HEAD"], {
       cwd: directory,
       ...GIT_DIFF_SPAWN_OPTIONS
     });
@@ -128057,7 +128203,7 @@ init_telemetry();
 init_file_locks();
 import * as fs124 from "node:fs";
 import * as path166 from "node:path";
-var _internals75 = {
+var _internals76 = {
   listActiveLocks,
   verifyLeanTurboTaskCompletion
 };
@@ -128199,7 +128345,7 @@ function verifyLeanTurboTaskCompletion(directory, taskId, sessionID) {
       }
     };
   }
-  const activeLocks = _internals75.listActiveLocks(directory);
+  const activeLocks = _internals76.listActiveLocks(directory);
   const laneLocks = activeLocks.filter((lock) => lock.laneId === lane.laneId);
   if (laneLocks.length > 0) {
     return {
@@ -128806,6 +128952,52 @@ var update_task_status = createSwarmTool({
 init_zod();
 init_loader();
 
+// src/council/search-query-policy.ts
+var CURRENT_INTENT_RE = /\b(?:latest|current|currently|today|now|newest|recent|recently|up\s*-?\s*to\s*-?\s*date|this\s+(?:week|month|year)|as\s+of\s+(?:today|now))\b/i;
+var HISTORICAL_INTENT_RE = /\b(?:history|historical|archive|archived|in\s+20\d{2}|during\s+20\d{2}|from\s+20\d{2}|for\s+20\d{2}|as\s+of\s+20\d{2})\b/i;
+function applySearchQueryPolicy(rawQuery, now = new Date) {
+  const originalQuery = rawQuery;
+  let query = rawQuery.trim().replace(/\s+/g, " ");
+  const currentYear = now.getUTCFullYear();
+  const temporalIntent = detectTemporalIntent(query);
+  const removedStaleYears = [];
+  if (temporalIntent === "current") {
+    query = removeTrailingStaleCutoffYears(query, currentYear, removedStaleYears);
+  }
+  return {
+    originalQuery,
+    query,
+    temporalIntent,
+    freshness: temporalIntent === "current" ? chooseFreshness(query) : undefined,
+    removedStaleYears
+  };
+}
+function detectTemporalIntent(query) {
+  if (CURRENT_INTENT_RE.test(query))
+    return "current";
+  if (HISTORICAL_INTENT_RE.test(query))
+    return "historical";
+  return "unspecified";
+}
+function chooseFreshness(query) {
+  if (/\b(?:today|now|as\s+of\s+(?:today|now))\b/i.test(query))
+    return "day";
+  if (/\bthis\s+week\b/i.test(query))
+    return "week";
+  if (/\b(?:recent|recently|this\s+month)\b/i.test(query))
+    return "month";
+  return "year";
+}
+function removeTrailingStaleCutoffYears(query, currentYear, removed) {
+  return query.replace(/\s+(?:as\s+of\s+)?(20\d{2})\s*$/i, (match, year) => {
+    const numericYear = Number(year);
+    if (numericYear >= currentYear)
+      return match;
+    removed.push(year);
+    return "";
+  }).replace(/\s+/g, " ").trim();
+}
+
 // src/council/web-search-provider.ts
 class WebSearchError extends Error {
   cause;
@@ -128828,18 +129020,22 @@ class TavilyProvider {
   constructor(apiKey) {
     this.apiKey = apiKey;
   }
-  async search(query, maxResults) {
+  async search(query, maxResults, options = {}) {
+    const requestBody = {
+      api_key: this.apiKey,
+      query,
+      max_results: maxResults,
+      search_depth: "advanced"
+    };
+    if (options.freshness) {
+      requestBody.time_range = options.freshness;
+    }
     let response;
     try {
       response = await fetch("https://api.tavily.com/search", {
         method: "POST",
         headers: { "Content-Type": "application/json" },
-        body: JSON.stringify({
-          api_key: this.apiKey,
-          query,
-          max_results: maxResults,
-          search_depth: "advanced"
-        })
+        body: JSON.stringify(requestBody)
       });
     } catch (err3) {
       throw new WebSearchError(`Tavily network error for query "${query}"`, err3);
@@ -128871,10 +129067,14 @@ class BraveProvider {
   constructor(apiKey) {
     this.apiKey = apiKey;
   }
-  async search(query, maxResults) {
+  async search(query, maxResults, options = {}) {
     const url3 = new URL("https://api.search.brave.com/res/v1/web/search");
     url3.searchParams.set("q", query);
     url3.searchParams.set("count", String(maxResults));
+    const freshness = toBraveFreshness(options.freshness);
+    if (freshness) {
+      url3.searchParams.set("freshness", freshness);
+    }
     let response;
     try {
       response = await fetch(url3.toString(), {
@@ -128908,6 +129108,20 @@ class BraveProvider {
     }));
   }
 }
+function toBraveFreshness(freshness) {
+  switch (freshness) {
+    case "day":
+      return "pd";
+    case "week":
+      return "pw";
+    case "month":
+      return "pm";
+    case "year":
+      return "py";
+    default:
+      return;
+  }
+}
 function resolveApiKey(provider, configKey) {
   if (configKey && configKey.length > 0) {
     return configKey;
@@ -128920,7 +129134,7 @@ function createWebSearchProvider(config3) {
   const apiKey = resolveApiKey(config3.searchProvider, config3.searchApiKey);
   if (!apiKey) {
     const envName = config3.searchProvider === "tavily" ? "TAVILY_API_KEY" : "BRAVE_SEARCH_API_KEY";
-    throw new WebSearchConfigError(`No API key for search provider "${config3.searchProvider}". Set ` + `council.general.searchApiKey in opencode-swarm.json or export ${envName}.`);
+    throw new WebSearchConfigError(`No API key for search provider "${config3.searchProvider}". Set ` + `council.general.searchApiKey in the resolved config (global ~/.config/opencode/opencode-swarm.json, project .opencode/opencode-swarm.json override) or export ${envName}.`);
   }
   switch (config3.searchProvider) {
     case "tavily":
@@ -129014,12 +129228,14 @@ var MAX_RESULTS_HARD_CAP = 10;
 var ArgsSchema6 = exports_external.object({
   query: exports_external.string().min(1).max(500),
   max_results: exports_external.number().int().min(1).max(20).optional(),
+  freshness: exports_external.enum(["auto", "none", "day", "week", "month", "year"]).default("auto"),
   working_directory: exports_external.string().optional()
 });
 var web_search = createSwarmTool({
-  description: "External web search for architect-driven council research. Returns titled results with snippets and URLs. " + "Used by the architect in MODE: COUNCIL to gather a RESEARCH CONTEXT before dispatching council agents. " + "Requires council.general.enabled and a configured search API key (Tavily or Brave). max_results is capped at 10 with default from council.general.maxSourcesPerMember.",
+  description: "External web search for architect-driven council research. Returns titled results with snippets and URLs. " + "Used by the architect in MODE: COUNCIL to gather a RESEARCH CONTEXT before dispatching council agents. " + "Normalizes current-intent queries, strips trailing stale cutoff years, and applies provider freshness filters by default. " + "Requires council.general.enabled and a configured search API key (Tavily or Brave) in the resolved config: global ~/.config/opencode/opencode-swarm.json, then project .opencode/opencode-swarm.json overrides. max_results is capped at 10 with default from council.general.maxSourcesPerMember.",
   args: {
     query: exports_external.string().min(1).max(500).describe("Search query string (1–500 characters)."),
+    freshness: exports_external.enum(["auto", "none", "day", "week", "month", "year"]).optional().describe('Optional freshness filter. Query normalization always runs; "auto" infers provider freshness from current/recency terms, while "none" disables provider freshness filtering.'),
     max_results: exports_external.number().int().min(1).max(20).optional().describe(`Number of results to request (1–20). Hard-capped at ${MAX_RESULTS_HARD_CAP}. Defaults to council.general.maxSourcesPerMember.`),
     working_directory: exports_external.string().optional().describe("Project root for config resolution. Optional.")
   },
@@ -129048,12 +129264,15 @@ var web_search = createSwarmTool({
       const fail = {
         success: false,
         reason: "council_general_disabled",
-        message: "web_search is disabled — set council.general.enabled: true in opencode-swarm.json."
+        message: "web_search is disabled - set council.general.enabled: true in the resolved config: global ~/.config/opencode/opencode-swarm.json or project .opencode/opencode-swarm.json."
       };
       return JSON.stringify(fail, null, 2);
     }
     const requested = parsed.data.max_results ?? generalConfig.maxSourcesPerMember;
     const maxResults = Math.min(requested, MAX_RESULTS_HARD_CAP);
+    const policy = applySearchQueryPolicy(parsed.data.query);
+    const requestedFreshness = parsed.data.freshness ?? "auto";
+    const freshness = requestedFreshness === "auto" ? policy.freshness : requestedFreshness === "none" ? undefined : requestedFreshness;
     let provider;
     try {
       provider = createWebSearchProvider(generalConfig);
@@ -129066,11 +129285,17 @@ var web_search = createSwarmTool({
       return JSON.stringify(fail, null, 2);
     }
     try {
-      const results = await provider.search(parsed.data.query, maxResults);
-      const evidence = await captureSearchEvidence(dirResult.directory, parsed.data.query, results);
+      const results = await provider.search(policy.query, maxResults, {
+        freshness
+      });
+      const evidence = await captureSearchEvidence(dirResult.directory, policy.query, results);
       const ok2 = {
         success: true,
-        query: parsed.data.query,
+        query: policy.query,
+        originalQuery: policy.originalQuery,
+        temporalIntent: policy.temporalIntent,
+        freshness,
+        removedStaleYears: policy.removedStaleYears,
         totalResults: results.length,
         results: results.map(({ title, url: url3, snippet }) => ({
           title,
@@ -129098,7 +129323,7 @@ var web_search = createSwarmTool({
 });
 async function captureSearchEvidence(directory, query, results) {
   try {
-    const written = await _internals76.writeEvidenceDocuments(directory, results.map((result) => ({
+    const written = await _internals77.writeEvidenceDocuments(directory, results.map((result) => ({
       sourceType: "web_search",
       query,
       title: result.title,
@@ -129126,7 +129351,7 @@ async function captureSearchEvidence(directory, query, results) {
     };
   }
 }
-var _internals76 = {
+var _internals77 = {
   writeEvidenceDocuments
 };
 
@@ -130376,7 +130601,7 @@ async function initializeOpenCodeSwarm(ctx) {
         ...opencodeConfig.command || {},
         swarm: {
           template: "/swarm $ARGUMENTS",
-          description: "Swarm management commands: /swarm [status|show-plan|plan|agents|history|config|help|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|memory|curate|concurrency|turbo|full-auto|write-retro|reset-session|simulate|promote|checkpoint|acknowledge-spec-drift|doctor tools|finalize|close]"
+          description: "Swarm management commands: /swarm [status|show-plan|plan|agents|history|config|help|evidence|handoff|archive|diagnose|diagnosis|preflight|sync-plan|benchmark|export|reset|rollback|retrieve|clarify|analyze|specify|brainstorm|council|pr-review|pr-feedback|deep-dive|design-docs|issue|qa-gates|dark-matter|knowledge|memory|curate|concurrency|turbo|full-auto|write-retro|reset-session|simulate|promote|checkpoint|acknowledge-spec-drift|doctor tools|finalize|close]"
         },
         "swarm-status": {
           template: "/swarm status",
@@ -130474,10 +130699,18 @@ async function initializeOpenCodeSwarm(ctx) {
           template: "/swarm pr-review $ARGUMENTS",
           description: "Use /swarm pr-review to launch deep PR review with multi-lane analysis"
         },
+        "swarm-pr-feedback": {
+          template: "/swarm pr-feedback $ARGUMENTS",
+          description: "Use /swarm pr-feedback to ingest and close known PR feedback (review comments, CI failures, conflicts) without a fresh broad review"
+        },
         "swarm-deep-dive": {
           template: "/swarm deep-dive $ARGUMENTS",
           description: "Use /swarm deep-dive to launch a read-only deep audit with parallel explorer waves, dual reviewers, and critic challenge"
         },
+        "swarm-design-docs": {
+          template: "/swarm design-docs $ARGUMENTS",
+          description: "Use /swarm design-docs to generate or sync language-agnostic design docs for the project under build"
+        },
         "swarm-issue": {
           template: "/swarm issue $ARGUMENTS",
           description: "Use /swarm issue to ingest a GitHub issue into the swarm workflow"