opencode-swarm 7.126.0 → 7.126.1

package/dist/cli/{index-a1c9az5e.js → index-abw10n3f.js}

@@ -8,7 +8,7 @@ import {
   init_constants,
   init_schema,
   resolveExternalSkillsConfig
-} from "./index-r1gdkn2d.js";
+} from "./index-c8sqc3nh.js";
 import {
   advisoryWarn,
   init_warning_buffer
@@ -100,30 +100,35 @@ function migratePresetsConfig(raw) {
 }
 function sanitizeExternalSkillsConfig(raw) {
   if (!("external_skills" in raw) || raw.external_skills === undefined) {
-    return raw;
+    return { result: raw, strippedKeys: [] };
   }
   const esResult = ExternalSkillsConfigSchema.safeParse(raw.external_skills);
   if (esResult.success) {
     return {
-      ...raw,
-      external_skills: resolveExternalSkillsConfig(esResult.data)
+      result: {
+        ...raw,
+        external_skills: resolveExternalSkillsConfig(esResult.data)
+      },
+      strippedKeys: []
     };
   }
   advisoryWarn("[opencode-swarm] external_skills config validation failed:", formatZodIssues(esResult.error));
   advisoryWarn("[opencode-swarm] External skills curation disabled due to invalid config. Fix the external_skills section to enable it.");
   const cleaned = { ...raw };
   delete cleaned.external_skills;
-  return cleaned;
+  return { result: cleaned, strippedKeys: ["external_skills"] };
 }
 function sanitizeGatesConfig(raw) {
+  const strippedKeys = [];
   if (!("gates" in raw) || raw.gates === undefined) {
-    return raw;
+    return { result: raw, strippedKeys };
   }
   if (typeof raw.gates !== "object" || raw.gates === null || Array.isArray(raw.gates)) {
     advisoryWarn("[opencode-swarm] gates config validation failed: expected an object. Quality gates will use defaults; other config sections remain active.");
     const cleaned2 = { ...raw };
     delete cleaned2.gates;
-    return cleaned2;
+    strippedKeys.push("gates");
+    return { result: cleaned2, strippedKeys };
   }
   const gateSchemas = GateConfigSchema.shape;
   const cleanedGates = { ...raw.gates };
@@ -132,6 +137,7 @@ function sanitizeGatesConfig(raw) {
     if (!schema) {
       advisoryWarn(`[opencode-swarm] Unknown gates config section "gates.${key}" ignored. Other config sections remain active.`);
       delete cleanedGates[key];
+      strippedKeys.push(`gates.${key}`);
       continue;
     }
     const knownFields = GATE_CONFIG_KNOWN_SECTION_KEYS[key];
@@ -143,6 +149,7 @@ function sanitizeGatesConfig(raw) {
         if (!knownFieldSet.has(fieldName)) {
           advisoryWarn(`[opencode-swarm] Unknown gates config key "gates.${key}.${fieldName}" ignored. Other config sections remain active.`);
           delete cleanedSection[fieldName];
+          strippedKeys.push(`gates.${key}.${fieldName}`);
         }
       }
       sectionValue = cleanedSection;
@@ -152,22 +159,30 @@ function sanitizeGatesConfig(raw) {
     if (!sectionResult.success) {
       advisoryWarn(`[opencode-swarm] gates.${key} config validation failed; that gate section will use defaults and other config sections remain active:`, formatZodIssues(sectionResult.error));
       delete cleanedGates[key];
+      if (!strippedKeys.includes(`gates.${key}`)) {
+        strippedKeys.push(`gates.${key}`);
+      }
     }
   }
   const gatesResult = GateConfigSchema.safeParse(cleanedGates);
   if (gatesResult.success) {
     return {
-      ...raw,
-      gates: gatesResult.data
+      result: { ...raw, gates: gatesResult.data },
+      strippedKeys
     };
   }
   advisoryWarn("[opencode-swarm] gates config validation failed after section cleanup; quality gates will use defaults and other config sections remain active:", formatZodIssues(gatesResult.error));
   const cleaned = { ...raw };
   delete cleaned.gates;
-  return cleaned;
+  if (!strippedKeys.includes("gates")) {
+    strippedKeys.push("gates");
+  }
+  return { result: cleaned, strippedKeys };
 }
 function sanitizeSectionConfigs(raw) {
-  return sanitizeGatesConfig(sanitizeExternalSkillsConfig(raw));
+  const { result: afterExternal, strippedKeys: externalStripped } = sanitizeExternalSkillsConfig(raw);
+  const { result, strippedKeys: gatesStripped } = sanitizeGatesConfig(afterExternal);
+  return { result, strippedKeys: [...externalStripped, ...gatesStripped] };
 }
 function formatZodIssues(error) {
   if (error.issues.length === 0)
@@ -205,168 +220,142 @@ function stripUnrecognizedKeys(raw, error) {
   }
   return { cleaned, removed };
 }
-function parseConfigWithFallback(mergedRaw, rawUserConfig, failedResult, loadedFromFile, configHadErrors) {
-  const result = failedResult;
-  const secure = (config) => loadedFromFile && configHadErrors ? PluginConfigSchema.parse({
-    ...config,
+function warningForRemovedKeys(removedKeys) {
+  return `Ignored ${removedKeys.length} invalid or unrecognized config key(s): ${removedKeys.join(", ")}. The rest of your configuration was preserved. Fix or remove these keys.`;
+}
+function rawFullAutoLocked(raw) {
+  if (!raw || typeof raw !== "object")
+    return false;
+  const fullAuto = raw.full_auto;
+  if (!fullAuto || typeof fullAuto !== "object" || Array.isArray(fullAuto)) {
+    return false;
+  }
+  return fullAuto.locked === true;
+}
+function buildConfigWithMeta(rawUserConfig, rawProjectConfig, loadedFromFile, configHadErrors) {
+  let mergedRaw = rawUserConfig ?? {};
+  if (rawProjectConfig) {
+    mergedRaw = deepMerge(mergedRaw, rawProjectConfig);
+  }
+  if (rawFullAutoLocked(rawUserConfig) || rawFullAutoLocked(rawProjectConfig)) {
+    const fa = mergedRaw.full_auto && typeof mergedRaw.full_auto === "object" && !Array.isArray(mergedRaw.full_auto) ? mergedRaw.full_auto : {};
+    mergedRaw = { ...mergedRaw, full_auto: { ...fa, locked: true } };
+  }
+  mergedRaw = migratePresetsConfig(mergedRaw);
+  const { result: sanitized, strippedKeys: gatesStripped } = sanitizeSectionConfigs(mergedRaw);
+  mergedRaw = sanitized;
+  const sanitizedWarning = gatesStripped.length > 0 ? warningForRemovedKeys(gatesStripped) : undefined;
+  const secure = (cfg) => loadedFromFile && configHadErrors ? PluginConfigSchema.parse({
+    ...cfg,
     guardrails: { enabled: true }
-  }) : config;
-  const { cleaned, removed } = stripUnrecognizedKeys(mergedRaw, result.error);
+  }) : cfg;
+  const firstResult = PluginConfigSchema.safeParse(mergedRaw);
+  if (firstResult.success) {
+    const config = secure(firstResult.data);
+    if (loadedFromFile && configHadErrors) {
+      const securityWarning = "\u26A0\uFE0F SECURITY: Falling back to conservative defaults with guardrails ENABLED. Fix the config file to restore custom configuration.";
+      advisoryWarn(`[opencode-swarm] ${securityWarning}`);
+      return {
+        config,
+        recovery: "guardrails_defaults",
+        removedKeys: [...gatesStripped],
+        warnings: [
+          ...sanitizedWarning ? [sanitizedWarning] : [],
+          securityWarning
+        ]
+      };
+    }
+    if (sanitizedWarning)
+      advisoryWarn(`[opencode-swarm] ${sanitizedWarning}`);
+    return {
+      config,
+      recovery: gatesStripped.length > 0 ? "stripped_keys" : "none",
+      removedKeys: [...gatesStripped],
+      warnings: sanitizedWarning ? [sanitizedWarning] : []
+    };
+  }
+  const { cleaned, removed } = stripUnrecognizedKeys(mergedRaw, firstResult.error);
   if (removed.length > 0) {
     const recovered = PluginConfigSchema.safeParse(cleaned);
     if (recovered.success) {
-      const warning = `Ignored ${removed.length} unrecognized config key(s): ${removed.join(", ")}. The rest of your configuration was preserved. Fix or remove these keys.`;
+      const removedKeys = [...gatesStripped, ...removed];
+      const warning = warningForRemovedKeys(removedKeys);
       advisoryWarn(`[opencode-swarm] ${warning}`);
       return {
         config: secure(recovered.data),
         recovery: "stripped_keys",
-        removedKeys: removed,
+        removedKeys,
         warnings: [warning]
       };
     }
   }
   if (rawUserConfig) {
-    const userSanitized = sanitizeSectionConfigs(rawUserConfig ?? {});
+    const { result: userSanitized, strippedKeys: userGatesStripped } = sanitizeSectionConfigs(rawUserConfig);
     const userParseResult = PluginConfigSchema.safeParse(userSanitized);
     if (userParseResult.success) {
-      const warning = "Project config ignored due to validation errors. Using user config.";
-      advisoryWarn(`[opencode-swarm] ${warning}`);
+      advisoryWarn("[opencode-swarm] Project config ignored due to validation errors. Using user config.");
       return {
         config: secure(userParseResult.data),
         recovery: "user_only",
-        removedKeys: [],
-        warnings: [warning]
+        removedKeys: [...gatesStripped, ...userGatesStripped],
+        warnings: [
+          "Project config ignored due to validation errors; using user config."
+        ]
       };
     }
     const userStripped = stripUnrecognizedKeys(userSanitized, userParseResult.error);
     if (userStripped.removed.length > 0) {
       const userRecovered = PluginConfigSchema.safeParse(userStripped.cleaned);
       if (userRecovered.success) {
-        const warning = `Project config ignored; also ignored ${userStripped.removed.length} unrecognized user-config key(s): ${userStripped.removed.join(", ")}.`;
-        advisoryWarn(`[opencode-swarm] ${warning}`);
+        advisoryWarn(`[opencode-swarm] Project config ignored; also ignored ${userStripped.removed.length} unrecognized user-config key(s): ${userStripped.removed.join(", ")}.`);
         return {
           config: secure(userRecovered.data),
           recovery: "user_only",
-          removedKeys: userStripped.removed,
-          warnings: [warning]
+          removedKeys: [
+            ...gatesStripped,
+            ...userGatesStripped,
+            ...userStripped.removed
+          ],
+          warnings: [
+            "Project config ignored due to validation errors; using user config."
+          ]
         };
       }
     }
   }
-  const offending = stripUnrecognizedKeys(mergedRaw, result.error).removed;
-  const warnings = [];
+  const offending = stripUnrecognizedKeys(mergedRaw, firstResult.error).removed;
   if (offending.length > 0) {
-    const warning = `Merged config validation failed. Unrecognized key(s): ${offending.join(", ")}.`;
-    advisoryWarn(`[opencode-swarm] ${warning}`);
-    warnings.push(warning);
+    advisoryWarn(`[opencode-swarm] Merged config validation failed. Unrecognized key(s): ${offending.join(", ")}.`);
   } else {
-    advisoryWarn("[opencode-swarm] Merged config validation failed:", formatZodIssues(result.error));
-    warnings.push("Merged config validation failed.");
+    advisoryWarn("[opencode-swarm] Merged config validation failed:", formatZodIssues(firstResult.error));
   }
-  const securityWarning = "\u26A0\uFE0F SECURITY: Falling back to conservative defaults with guardrails ENABLED. Fix the config file to restore custom configuration.";
-  advisoryWarn(`[opencode-swarm] ${securityWarning}`);
-  warnings.push(securityWarning);
+  advisoryWarn("[opencode-swarm] \u26A0\uFE0F SECURITY: Falling back to conservative defaults with guardrails ENABLED. Fix the config file to restore custom configuration.");
   return {
     config: PluginConfigSchema.parse({ guardrails: { enabled: true } }),
     recovery: "guardrails_defaults",
-    removedKeys: offending,
-    warnings
+    removedKeys: [...gatesStripped],
+    warnings: [
+      "Config failed validation; using safe defaults with guardrails enabled."
+    ]
   };
 }
-function rawFullAutoLocked(raw) {
-  if (!raw || typeof raw !== "object")
-    return false;
-  const fullAuto = raw.full_auto;
-  if (!fullAuto || typeof fullAuto !== "object" || Array.isArray(fullAuto)) {
-    return false;
-  }
-  return fullAuto.locked === true;
-}
 function loadPluginConfig(directory) {
   const userConfigPath = path.join(getUserConfigDir(), "opencode", CONFIG_FILENAME);
   const projectConfigPath = path.join(directory, ".opencode", CONFIG_FILENAME);
   const userResult = loadRawConfigFromPath(userConfigPath);
   const projectResult = loadRawConfigFromPath(projectConfigPath);
-  const rawUserConfig = userResult.config;
-  const rawProjectConfig = projectResult.config;
   const loadedFromFile = userResult.fileExisted || projectResult.fileExisted;
   const configHadErrors = userResult.hadError || projectResult.hadError;
-  let mergedRaw = rawUserConfig ?? {};
-  if (rawProjectConfig) {
-    mergedRaw = deepMerge(mergedRaw, rawProjectConfig);
-  }
-  if (rawFullAutoLocked(rawUserConfig) || rawFullAutoLocked(rawProjectConfig)) {
-    const fullAutoRaw = mergedRaw.full_auto && typeof mergedRaw.full_auto === "object" && !Array.isArray(mergedRaw.full_auto) ? mergedRaw.full_auto : {};
-    mergedRaw = {
-      ...mergedRaw,
-      full_auto: { ...fullAutoRaw, locked: true }
-    };
-  }
-  mergedRaw = migratePresetsConfig(mergedRaw);
-  mergedRaw = sanitizeSectionConfigs(mergedRaw);
-  const result = PluginConfigSchema.safeParse(mergedRaw);
-  if (result.success) {
-    if (loadedFromFile && configHadErrors) {
-      return PluginConfigSchema.parse({
-        ...mergedRaw,
-        guardrails: { enabled: true }
-      });
-    }
-    return result.data;
-  }
-  const { config } = parseConfigWithFallback(mergedRaw, rawUserConfig, result, loadedFromFile, configHadErrors);
-  return config;
+  return buildConfigWithMeta(userResult.config, projectResult.config, loadedFromFile, configHadErrors).config;
 }
 function loadPluginConfigWithMeta(directory) {
   const userConfigPath = path.join(getUserConfigDir(), "opencode", CONFIG_FILENAME);
   const projectConfigPath = path.join(directory, ".opencode", CONFIG_FILENAME);
   const userResult = loadRawConfigFromPath(userConfigPath);
   const projectResult = loadRawConfigFromPath(projectConfigPath);
-  const rawUserConfig = userResult.config;
-  const rawProjectConfig = projectResult.config;
   const loadedFromFile = userResult.fileExisted || projectResult.fileExisted;
   const configHadErrors = userResult.hadError || projectResult.hadError;
-  let mergedRaw = rawUserConfig ?? {};
-  if (rawProjectConfig) {
-    mergedRaw = deepMerge(mergedRaw, rawProjectConfig);
-  }
-  if (rawFullAutoLocked(rawUserConfig) || rawFullAutoLocked(rawProjectConfig)) {
-    const fullAutoRaw = mergedRaw.full_auto && typeof mergedRaw.full_auto === "object" && !Array.isArray(mergedRaw.full_auto) ? mergedRaw.full_auto : {};
-    mergedRaw = {
-      ...mergedRaw,
-      full_auto: { ...fullAutoRaw, locked: true }
-    };
-  }
-  mergedRaw = migratePresetsConfig(mergedRaw);
-  mergedRaw = sanitizeSectionConfigs(mergedRaw);
-  const result = PluginConfigSchema.safeParse(mergedRaw);
-  if (result.success) {
-    if (loadedFromFile && configHadErrors) {
-      const config2 = PluginConfigSchema.parse({
-        ...mergedRaw,
-        guardrails: { enabled: true }
-      });
-      return {
-        config: config2,
-        loadedFromFile,
-        configHadErrors,
-        recovery: "guardrails_defaults",
-        removedKeys: [],
-        warnings: [
-          "\u26A0\uFE0F SECURITY: Falling back to conservative defaults with guardrails ENABLED. Fix the config file to restore custom configuration."
-        ]
-      };
-    }
-    return {
-      config: result.data,
-      loadedFromFile,
-      configHadErrors,
-      recovery: "none",
-      removedKeys: [],
-      warnings: []
-    };
-  }
-  const { config, recovery, removedKeys, warnings } = parseConfigWithFallback(mergedRaw, rawUserConfig, result, loadedFromFile, configHadErrors);
+  const { config, recovery, removedKeys, warnings } = buildConfigWithMeta(userResult.config, projectResult.config, loadedFromFile, configHadErrors);
   return {
     config,
     loadedFromFile,
@@ -414,37 +403,6 @@ async function loadRawConfigFromPathAsync(configPath) {
     return { config: null, fileExisted: true, hadError: true };
   }
 }
-function reduceParsedConfig(rawUserConfig, rawProjectConfig, loadedFromFile, configHadErrors) {
-  let mergedRaw = rawUserConfig ?? {};
-  if (rawProjectConfig) {
-    mergedRaw = deepMerge(mergedRaw, rawProjectConfig);
-  }
-  mergedRaw = migratePresetsConfig(mergedRaw);
-  mergedRaw = sanitizeSectionConfigs(mergedRaw);
-  const result = PluginConfigSchema.safeParse(mergedRaw);
-  if (result.success) {
-    if (loadedFromFile && configHadErrors) {
-      return {
-        config: PluginConfigSchema.parse({
-          ...mergedRaw,
-          guardrails: { enabled: true }
-        }),
-        recovery: "guardrails_defaults",
-        removedKeys: [],
-        warnings: [
-          "\u26A0\uFE0F SECURITY: Falling back to conservative defaults with guardrails ENABLED. Fix the config file to restore custom configuration."
-        ]
-      };
-    }
-    return {
-      config: result.data,
-      recovery: "none",
-      removedKeys: [],
-      warnings: []
-    };
-  }
-  return parseConfigWithFallback(mergedRaw, rawUserConfig, result, loadedFromFile, configHadErrors);
-}
 async function loadPluginConfigWithMetaAsync(directory) {
   const userConfigPath = path.join(getUserConfigDir(), "opencode", CONFIG_FILENAME);
   const projectConfigPath = path.join(directory, ".opencode", CONFIG_FILENAME);
@@ -454,7 +412,7 @@ async function loadPluginConfigWithMetaAsync(directory) {
   ]);
   const loadedFromFile = userResult.fileExisted || projectResult.fileExisted;
   const configHadErrors = userResult.hadError || projectResult.hadError;
-  const { config, recovery, removedKeys, warnings } = reduceParsedConfig(userResult.config, projectResult.config, loadedFromFile, configHadErrors);
+  const { config, recovery, removedKeys, warnings } = buildConfigWithMeta(userResult.config, projectResult.config, loadedFromFile, configHadErrors);
   return {
     config,
     loadedFromFile,

package/dist/cli/{index-r1gdkn2d.js → index-c8sqc3nh.js}

@@ -60,19 +60,35 @@ var init_tool_metadata = __esm(() => {
         "critic_oversight",
         "coder",
         "test_engineer"
-      ]
+      ],
+      prWorkflow: {
+        modes: ["PR_REVIEW", "PR_FEEDBACK"],
+        capability: "observe"
+      }
     },
     diff_summary: {
       description: "filter classified AST changes by category, risk level, or file for reviewer drill-down",
-      agents: ["architect", "reviewer", "critic_oversight"]
+      agents: ["architect", "reviewer", "critic_oversight"],
+      prWorkflow: {
+        modes: ["PR_REVIEW", "PR_FEEDBACK"],
+        capability: "observe"
+      }
     },
     syntax_check: {
       description: "check syntax of source files using tree-sitter parsers across multiple languages, returning per-file errors",
-      agents: ["architect", "coder", "test_engineer"]
+      agents: ["architect", "coder", "test_engineer"],
+      prWorkflow: {
+        modes: ["PR_REVIEW"],
+        capability: "validate"
+      }
     },
     placeholder_scan: {
       description: "todo and FIXME comment detection",
-      agents: ["architect", "reviewer"]
+      agents: ["architect", "reviewer"],
+      prWorkflow: {
+        modes: ["PR_REVIEW", "PR_FEEDBACK"],
+        capability: "observe"
+      }
     },
     imports: {
       description: "find all consumers that import from a given file \u2014 use before refactoring shared modules to avoid breaking unseen dependents",
@@ -89,19 +105,35 @@ var init_tool_metadata = __esm(() => {
         "critic",
         "coder",
         "test_engineer"
-      ]
+      ],
+      prWorkflow: {
+        modes: ["PR_REVIEW", "PR_FEEDBACK"],
+        capability: "observe"
+      }
     },
     lint: {
       description: "run project linter in check or fix mode; supports biome, eslint, ruff, clippy, and more, returns structured results",
-      agents: ["architect", "reviewer", "coder"]
+      agents: ["architect", "reviewer", "coder"],
+      prWorkflow: {
+        modes: ["PR_REVIEW"],
+        capability: "validate"
+      }
     },
     secretscan: {
       description: "scan for secrets (API keys, tokens, passwords) via regex and entropy; returns redacted previews, excludes common dirs",
-      agents: ["architect", "reviewer", "critic_oversight"]
+      agents: ["architect", "reviewer", "critic_oversight"],
+      prWorkflow: {
+        modes: ["PR_REVIEW"],
+        capability: "validate"
+      }
     },
     sast_scan: {
       description: "static analysis security scan",
-      agents: ["architect", "reviewer", "critic_oversight"]
+      agents: ["architect", "reviewer", "critic_oversight"],
+      prWorkflow: {
+        modes: ["PR_REVIEW"],
+        capability: "validate"
+      }
     },
     build_check: {
       description: "discover and run build, typecheck, and test commands for various project ecosystems in the working directory",
@@ -113,7 +145,11 @@ var init_tool_metadata = __esm(() => {
     },
     quality_budget: {
       description: "code quality budget check",
-      agents: ["architect"]
+      agents: ["architect"],
+      prWorkflow: {
+        modes: ["PR_REVIEW"],
+        capability: "validate"
+      }
     },
     symbols: {
       description: "extract exported symbols (functions, classes, interfaces, types) from source files; supports TypeScript, JavaScript, and Python",
@@ -152,11 +188,19 @@ var init_tool_metadata = __esm(() => {
     },
     schema_drift: {
       description: "OpenAPI spec vs route drift",
-      agents: ["architect", "sme", "researcher", "docs", "explorer"]
+      agents: ["architect", "sme", "researcher", "docs", "explorer"],
+      prWorkflow: {
+        modes: ["PR_REVIEW", "PR_FEEDBACK"],
+        capability: "observe"
+      }
     },
     todo_extract: {
       description: "structured TODO/FIXME extraction",
-      agents: ["architect", "researcher", "docs", "explorer"]
+      agents: ["architect", "researcher", "docs", "explorer"],
+      prWorkflow: {
+        modes: ["PR_REVIEW", "PR_FEEDBACK"],
+        capability: "observe"
+      }
     },
     evidence_check: {
       description: "verify task evidence completeness",
@@ -210,7 +254,11 @@ var init_tool_metadata = __esm(() => {
         "reviewer",
         "critic_oversight",
         "test_engineer"
-      ]
+      ],
+      prWorkflow: {
+        modes: ["PR_REVIEW"],
+        capability: "validate"
+      }
     },
     parse_lane_candidates: {
       description: "Parse [CANDIDATE] rows from a dispatch_lanes or collect_lane_results artifact (by output_ref), produce structured records with provenance, optionally persist to a per-batch sidecar JSONL. Pure-parser variant exists as internal module.",
@@ -220,13 +268,29 @@ var init_tool_metadata = __esm(() => {
       description: "persist the complete PR-review trigger evaluation with exact-set validation, dispatch provenance, and live merge-base verification",
       agents: ["architect"]
     },
+    write_pr_review_artifact: {
+      description: "persist schema-validated PR-review findings checkpoints and exact actionable feedback handoffs under the active run",
+      agents: ["architect"]
+    },
+    prepare_pr_feedback_scope: {
+      description: "prepare an exact file scope for one PR-feedback coder Task after immutable feedback verification settles",
+      agents: ["architect"]
+    },
     test_runner: {
       description: "auto-detect and run tests",
-      agents: ["architect", "reviewer", "test_engineer"]
+      agents: ["architect", "reviewer", "test_engineer"],
+      prWorkflow: {
+        modes: ["PR_REVIEW"],
+        capability: "validate"
+      }
     },
     test_impact: {
       description: "identify test files impacted by changed source files via import analysis",
-      agents: ["architect", "reviewer", "critic_oversight", "test_engineer"]
+      agents: ["architect", "reviewer", "critic_oversight", "test_engineer"],
+      prWorkflow: {
+        modes: ["PR_REVIEW", "PR_FEEDBACK"],
+        capability: "observe"
+      }
     },
     mutation_test: {
       description: "executes pre-generated mutation patches against tests, evaluates kill rate against quality gate thresholds",
@@ -253,11 +317,19 @@ var init_tool_metadata = __esm(() => {
     },
     git_blame: {
       description: "per-line git blame metadata: sha, author, date, summary for each line in a file",
-      agents: ["reviewer", "explorer", "architect"]
+      agents: ["reviewer", "explorer", "architect"],
+      prWorkflow: {
+        modes: ["PR_REVIEW", "PR_FEEDBACK"],
+        capability: "observe"
+      }
     },
     gitingest: {
       description: "fetch a GitHub repository full content via gitingest.com",
-      agents: ["architect", "docs", "explorer"]
+      agents: ["architect", "docs", "explorer"],
+      prWorkflow: {
+        modes: ["PR_REVIEW", "PR_FEEDBACK"],
+        capability: "observe"
+      }
     },
     retrieve_summary: {
       description: "retrieve the full content of a stored tool output summary",
@@ -280,7 +352,11 @@ var init_tool_metadata = __esm(() => {
     },
     retrieve_lane_output: {
       description: "retrieve paged full dispatch lane output by output_ref; use before consuming truncated lane previews or routing candidates from lane results",
-      agents: ["architect"]
+      agents: ["architect"],
+      prWorkflow: {
+        modes: ["PR_REVIEW", "PR_FEEDBACK"],
+        capability: "observe"
+      }
     },
     extract_code_blocks: {
       description: "extract code blocks from text content and save them to files",
@@ -427,15 +503,27 @@ var init_tool_metadata = __esm(() => {
     },
     actionlint_scan: {
       description: "Run actionlint against GitHub Actions workflow YAML files with structured findings. Resolves actionlint lazily and does not modify files.",
-      agents: ["architect", "test_engineer"]
+      agents: ["architect", "test_engineer"],
+      prWorkflow: {
+        modes: ["PR_REVIEW"],
+        capability: "validate"
+      }
     },
     osv_scan: {
       description: "Run OSV-Scanner against a workspace path and return structured dependency vulnerability findings. Resolves osv-scanner lazily and does not modify files.",
-      agents: ["architect", "test_engineer"]
+      agents: ["architect", "test_engineer"],
+      prWorkflow: {
+        modes: ["PR_REVIEW"],
+        capability: "validate"
+      }
     },
     gh_evidence: {
       description: "Fetch bounded GitHub pull request or issue metadata through gh for review and CI evidence. Resolves gh lazily and is read-only.",
-      agents: ["architect", "researcher"]
+      agents: ["architect", "researcher"],
+      prWorkflow: {
+        modes: ["PR_REVIEW", "PR_FEEDBACK"],
+        capability: "observe"
+      }
     },
     batch_symbols: {
       description: "Batched symbol extraction across multiple files. Returns per-file symbol summaries with isolated error handling.",
@@ -479,7 +567,11 @@ var init_tool_metadata = __esm(() => {
         "critic_oversight",
         "explorer",
         "coder"
-      ]
+      ],
+      prWorkflow: {
+        modes: ["PR_REVIEW", "PR_FEEDBACK"],
+        capability: "observe"
+      }
     },
     get_qa_gate_profile: {
       description: "retrieve the QA gate profile for the current plan: gates (reviewer, test_engineer, sme_enabled, critic_pre_plan, sast_enabled, council_mode, hallucination_guard, mutation_test, phase_council, drift_check, final_council), lock state, and profile hash. Read-only.",

package/dist/cli/{index-2bnfwmk3.js → index-cnhp6c0k.js}

@@ -608,7 +608,7 @@ async function applyKnowledgeVerdictFeedback(directory, options) {
       deltas.push({ id, delta });
     }
     if (deltas.length > 0) {
-      const { bumpKnowledgeConfidenceBatch } = await import("./knowledge-store-06k0p1gs.js");
+      const { bumpKnowledgeConfidenceBatch } = await import("./knowledge-store-1d4byc7y.js");
       await bumpKnowledgeConfidenceBatch(directory, deltas, options?.floorOptions);
     }
     return {

package/dist/cli/{index-dezgmvtw.js → index-echdpdhy.js}

@@ -3,7 +3,7 @@ import {
   init_constants,
   init_schema,
   stripKnownSwarmPrefix
-} from "./index-r1gdkn2d.js";
+} from "./index-c8sqc3nh.js";
 import {
   init_logger,
   warn

package/dist/cli/{index-yfzn5r9s.js → index-k5xh81c9.js}

@@ -2,18 +2,18 @@
 import {
   ALLOWED_SKILL_PATH_PREFIXES,
   validateSkillPath
-} from "./index-kwnsatzq.js";
+} from "./index-6j9p0c40.js";
 import {
   computeOutcomeSignal,
   readKnowledge,
   resolveHiveKnowledgePath,
   resolveSwarmKnowledgePath,
   transactKnowledge
-} from "./index-2yd75hms.js";
+} from "./index-nmyg9b7v.js";
 import {
   effectiveRetrievalOutcomes,
   readKnowledgeCounterRollups
-} from "./index-2bnfwmk3.js";
+} from "./index-cnhp6c0k.js";
 import {
   init_knowledge_types,
   isActiveStatus