opencode-swarm 7.99.5 → 7.99.6

package/dist/cli/{guardrail-explain-2q5q86jv.js → guardrail-explain-s4c2h8mv.js}

@@ -1,8 +1,8 @@
 // @bun
 import {
   handleGuardrailExplain
-} from "./index-tn5exv94.js";
-import"./index-gjyrjr08.js";
+} from "./index-ksc4ftms.js";
+import"./index-1kcp4q4y.js";
 import"./index-xsswhy6k.js";
 import"./index-ydgy7vg5.js";
 import"./index-vwyjkzgs.js";

package/dist/cli/{index-gjyrjr08.js → index-1kcp4q4y.js}

@@ -909,7 +909,7 @@ var init_executor = __esm(() => {
 // package.json
 var package_default = {
   name: "opencode-swarm",
-  version: "7.99.5",
+  version: "7.99.6",
   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",
@@ -1562,6 +1562,9 @@ async function syncBundledProjectSkillsIfMissingAsync(projectDirectory, packageR
   }
 }
 
+// src/commands/registry.ts
+init_logger();
+
 // src/state.ts
 import * as fs6 from "fs/promises";
 import * as path11 from "path";
@@ -32275,6 +32278,13 @@ function findSimilarCommands(query) {
   scored.sort((a, b) => a.score - b.score);
   return scored.slice(0, 3).map((s) => s.cmd);
 }
+function emitValidationWarnings(prefix, warnings) {
+  if (warnings.length === 0)
+    return;
+  warn(`${prefix}:
+${warnings.join(`
+`)}`);
+}
 function buildDetailedHelp(commandName, entry) {
   const lines = [];
   lines.push(`## /swarm ${commandName}`, "");
@@ -32296,7 +32306,7 @@ function buildDetailedHelp(commandName, entry) {
 async function handleHelpCommand(ctx) {
   const targetCommand = ctx.args.join(" ");
   if (!targetCommand) {
-    const { buildHelpText } = await import("./index-s0nsx5v6.js");
+    const { buildHelpText } = await import("./index-etssqrff.js");
     return buildHelpText();
   }
   const tokens = targetCommand.split(/\s+/);
@@ -32305,7 +32315,7 @@ async function handleHelpCommand(ctx) {
     return _internals46.buildDetailedHelp(resolved.key, resolved.entry);
   }
   const similar = _internals46.findSimilarCommands(targetCommand);
-  const { buildHelpText: fullHelp } = await import("./index-s0nsx5v6.js");
+  const { buildHelpText: fullHelp } = await import("./index-etssqrff.js");
   if (similar.length > 0) {
     return `Command '/swarm ${targetCommand}' not found.
 
@@ -32438,7 +32448,7 @@ var COMMAND_REGISTRY = {
   },
   "guardrail explain": {
     handler: async (ctx) => {
-      const { handleGuardrailExplain } = await import("./guardrail-explain-2q5q86jv.js");
+      const { handleGuardrailExplain } = await import("./guardrail-explain-s4c2h8mv.js");
       return handleGuardrailExplain(ctx.directory, ctx.args);
     },
     description: "Dry-run: show what the guardrails would do to a command or write target (executes nothing)",
@@ -33251,6 +33261,7 @@ var _internals46 = {
   handleHelpCommand,
   validateAliases,
   validateToolPolicy,
+  emitValidationWarnings,
   resolveCommand,
   levenshteinDistance,
   findSimilarCommands,
@@ -33262,20 +33273,12 @@ if (!validation.valid) {
 ${validation.errors.join(`
 `)}`);
 }
-if (validation.warnings.length > 0) {
-  console.warn(`COMMAND_REGISTRY alias warnings:
-${validation.warnings.join(`
-`)}`);
-}
+_internals46.emitValidationWarnings("COMMAND_REGISTRY alias warnings", validation.warnings);
 try {
   const toolPolicyValidation = _internals46.validateToolPolicy();
-  if (toolPolicyValidation.warnings.length > 0) {
-    console.warn(`COMMAND_REGISTRY toolPolicy warnings:
-${toolPolicyValidation.warnings.join(`
-`)}`);
-  }
+  _internals46.emitValidationWarnings("COMMAND_REGISTRY toolPolicy warnings", toolPolicyValidation.warnings);
 } catch (e) {
-  console.warn(`COMMAND_REGISTRY toolPolicy validation failed (non-fatal): ${e.message}`);
+  warn(`COMMAND_REGISTRY toolPolicy validation failed (non-fatal): ${e.message}`);
 }
 function resolveCommand(tokens) {
   if (tokens.length === 0)

package/dist/cli/{index-s0nsx5v6.js → index-etssqrff.js}

@@ -1,7 +1,7 @@
 // @bun
 import {
   handleGuardrailExplain
-} from "./index-tn5exv94.js";
+} from "./index-ksc4ftms.js";
 import {
   handleGuardrailLog
 } from "./index-h9ptj4b1.js";
@@ -79,7 +79,7 @@ import {
   handleWriteRetroCommand,
   normalizeSwarmCommandInput,
   resolveCommand
-} from "./index-gjyrjr08.js";
+} from "./index-1kcp4q4y.js";
 import"./index-xsswhy6k.js";
 import"./index-ydgy7vg5.js";
 import"./index-vwyjkzgs.js";

package/dist/cli/{index-tn5exv94.js → index-ksc4ftms.js}

@@ -12,7 +12,7 @@ import {
   detectPosixWrites,
   detectWindowsWrites,
   resolveWriteTargets
-} from "./index-gjyrjr08.js";
+} from "./index-1kcp4q4y.js";
 import {
   checkFileAuthority,
   classifyFile,

package/dist/cli/index.js

@@ -7,7 +7,7 @@ import {
   getPluginLockFilePaths,
   package_default,
   resolveCommand
-} from "./index-gjyrjr08.js";
+} from "./index-1kcp4q4y.js";
 import"./index-xsswhy6k.js";
 import"./index-ydgy7vg5.js";
 import"./index-vwyjkzgs.js";

package/dist/commands/registry.d.ts

@@ -1,6 +1,7 @@
 import type { AgentDefinition } from '../agents/index.js';
 declare function levenshteinDistance(a: string, b: string): number;
 declare function findSimilarCommands(query: string): string[];
+declare function emitValidationWarnings(prefix: string, warnings: readonly string[]): void;
 declare function buildDetailedHelp(commandName: string, entry: CommandEntry): string;
 export declare function handleHelpCommand(ctx: CommandContext): Promise<string>;
 export type CommandContext = {
@@ -924,6 +925,7 @@ export declare const _internals: {
     handleHelpCommand: typeof handleHelpCommand;
     validateAliases: typeof validateAliases;
     validateToolPolicy: typeof validateToolPolicy;
+    emitValidationWarnings: typeof emitValidationWarnings;
     resolveCommand: typeof resolveCommand;
     levenshteinDistance: typeof levenshteinDistance;
     findSimilarCommands: typeof findSimilarCommands;

package/dist/index.js

@@ -69,7 +69,7 @@ var package_default;
 var init_package = __esm(() => {
   package_default = {
     name: "opencode-swarm",
-    version: "7.99.5",
+    version: "7.99.6",
     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",
@@ -17516,21 +17516,6 @@ var init_bundled_skills = __esm(() => {
   syncedProjectSkillTargets = new Set;
 });
 
-// src/utils/errors.ts
-var SwarmError;
-var init_errors3 = __esm(() => {
-  SwarmError = class SwarmError extends Error {
-    code;
-    guidance;
-    constructor(message, code, guidance) {
-      super(message);
-      this.name = "SwarmError";
-      this.code = code;
-      this.guidance = guidance;
-    }
-  };
-});
-
 // src/utils/logger.ts
 function isDebug() {
   return process.env.OPENCODE_SWARM_DEBUG === "1";
@@ -17573,6 +17558,21 @@ function error48(message, data) {
 }
 var init_logger = () => {};
 
+// src/utils/errors.ts
+var SwarmError;
+var init_errors3 = __esm(() => {
+  SwarmError = class SwarmError extends Error {
+    code;
+    guidance;
+    constructor(message, code, guidance) {
+      super(message);
+      this.name = "SwarmError";
+      this.code = code;
+      this.guidance = guidance;
+    }
+  };
+});
+
 // src/utils/regex.ts
 function escapeRegex2(s) {
   return s.replace(/[.*+?^${}()|[\]\\]/g, "\\$&");
@@ -101085,6 +101085,13 @@ function findSimilarCommands(query) {
   scored.sort((a, b) => a.score - b.score);
   return scored.slice(0, 3).map((s) => s.cmd);
 }
+function emitValidationWarnings(prefix, warnings) {
+  if (warnings.length === 0)
+    return;
+  warn(`${prefix}:
+${warnings.join(`
+`)}`);
+}
 function buildDetailedHelp(commandName, entry) {
   const lines = [];
   lines.push(`## /swarm ${commandName}`, "");
@@ -101219,6 +101226,7 @@ function resolveCommand(tokens) {
 var COMMAND_REGISTRY, VALID_COMMANDS, _internals15, validation;
 var init_registry = __esm(() => {
   init_bundled_skills();
+  init_logger();
   init_acknowledge_spec_drift();
   init_agents();
   init_archive();
@@ -102147,6 +102155,7 @@ Subcommands:
     handleHelpCommand,
     validateAliases,
     validateToolPolicy,
+    emitValidationWarnings,
     resolveCommand,
     levenshteinDistance: levenshteinDistance2,
     findSimilarCommands,
@@ -102158,20 +102167,12 @@ Subcommands:
 ${validation.errors.join(`
 `)}`);
   }
-  if (validation.warnings.length > 0) {
-    console.warn(`COMMAND_REGISTRY alias warnings:
-${validation.warnings.join(`
-`)}`);
-  }
+  _internals15.emitValidationWarnings("COMMAND_REGISTRY alias warnings", validation.warnings);
   try {
     const toolPolicyValidation = _internals15.validateToolPolicy();
-    if (toolPolicyValidation.warnings.length > 0) {
-      console.warn(`COMMAND_REGISTRY toolPolicy warnings:
-${toolPolicyValidation.warnings.join(`
-`)}`);
-    }
+    _internals15.emitValidationWarnings("COMMAND_REGISTRY toolPolicy warnings", toolPolicyValidation.warnings);
   } catch (e) {
-    console.warn(`COMMAND_REGISTRY toolPolicy validation failed (non-fatal): ${e.message}`);
+    warn(`COMMAND_REGISTRY toolPolicy validation failed (non-fatal): ${e.message}`);
   }
 });
 
@@ -116575,6 +116576,7 @@ var SUPPORTED_EXTENSIONS = new Set(LANGUAGE_REGISTRY.getAll().filter((p) => !p.p
 var DEFAULT_WALK_FILE_CAP = 1e4;
 var DEFAULT_WALK_BUDGET_MS = 5000;
 var ASYNC_WALK_YIELD_INTERVAL = 200;
+var MAX_DIAGNOSTIC_ENTRIES = 200;
 var EXTENSION_TO_LANGUAGE = {};
 for (const profile of LANGUAGE_REGISTRY.getAll()) {
   if (profile.parserOnly)
@@ -116705,6 +116707,64 @@ function isRefusedWorkspaceRoot(target) {
   }
   return refused.has(resolved);
 }
+function createEmptyDiagnostics() {
+  return {
+    extractionFailures: [],
+    unresolvedImports: [],
+    oversizedFiles: [],
+    unsupportedFiles: [],
+    binaryFiles: [],
+    unreadableFiles: [],
+    lowConfidenceEdgeCount: 0
+  };
+}
+function diagnosticsHaveEntries(diagnostics) {
+  return (diagnostics.extractionFailures?.length ?? 0) > 0 || (diagnostics.unresolvedImports?.length ?? 0) > 0 || (diagnostics.oversizedFiles?.length ?? 0) > 0 || (diagnostics.unsupportedFiles?.length ?? 0) > 0 || (diagnostics.binaryFiles?.length ?? 0) > 0 || (diagnostics.unreadableFiles?.length ?? 0) > 0 || (diagnostics.lowConfidenceEdgeCount ?? 0) > 0;
+}
+function pushCapped(target, value) {
+  if (target.length < MAX_DIAGNOSTIC_ENTRIES) {
+    target.push(value);
+  }
+}
+function mergeDiagnostics(target, source) {
+  if (!source)
+    return;
+  for (const entry of source.extractionFailures ?? []) {
+    pushCapped(target.extractionFailures, entry);
+  }
+  for (const entry of source.unresolvedImports ?? []) {
+    pushCapped(target.unresolvedImports, entry);
+  }
+  for (const entry of source.oversizedFiles ?? []) {
+    pushCapped(target.oversizedFiles, entry);
+  }
+  for (const entry of source.unsupportedFiles ?? []) {
+    pushCapped(target.unsupportedFiles, entry);
+  }
+  for (const entry of source.binaryFiles ?? []) {
+    pushCapped(target.binaryFiles, entry);
+  }
+  for (const entry of source.unreadableFiles ?? []) {
+    pushCapped(target.unreadableFiles, entry);
+  }
+  target.lowConfidenceEdgeCount += source.lowConfidenceEdgeCount ?? 0;
+}
+function isRelativeImportSpecifier(specifier) {
+  return specifier === "." || specifier === ".." || specifier.startsWith("./") || specifier.startsWith("../");
+}
+function unresolvedRelativeImportsFor(parsedImports, filePath, absoluteRoot) {
+  const unresolved = [];
+  const moduleName = toModuleName(filePath, absoluteRoot);
+  for (const parsed of parsedImports) {
+    if (!isRelativeImportSpecifier(parsed.specifier))
+      continue;
+    const resolvedTarget = resolveModuleSpecifier(absoluteRoot, filePath, parsed.specifier);
+    if (resolvedTarget === null) {
+      unresolved.push({ file: moduleName, specifier: parsed.specifier });
+    }
+  }
+  return unresolved;
+}
 var REGEX_ALLOWED_AFTER = new Set("(,=:[!&|?{};*+-~^<>%".split(""));
 function stripComments2(content) {
   let out = "";
@@ -116897,6 +116957,28 @@ function computeUsedSymbols(strippedContent, bindings) {
   }
   return [...used].sort((a, b) => a.localeCompare(b));
 }
+function usedSymbolsForImport(parsed, strippedContent) {
+  if (parsed.importType === "namespace" || parsed.importType === "sideeffect" || parsed.importType === "require") {
+    return;
+  }
+  if (parsed.reExport) {
+    return [...new Set(parsed.bindings.map((b) => b.imported))].sort((a, b) => a.localeCompare(b));
+  }
+  return computeUsedSymbols(strippedContent, parsed.bindings);
+}
+function collectExports(symbols2) {
+  const exported = symbols2.filter((s) => s.exported);
+  const exports = exported.map((s) => s.signature === `default ${s.name}` ? "default" : s.name);
+  const exportLines = {};
+  for (let i = 0;i < exported.length; i++) {
+    const s = exported[i];
+    const name = exports[i];
+    if (typeof s.line === "number" && Number.isFinite(s.line) && exportLines[name] === undefined) {
+      exportLines[name] = s.line;
+    }
+  }
+  return { exports, exportLines };
+}
 function parseImportedSymbols(matchedString, importType) {
   if (importType === "namespace")
     return ["*"];
@@ -117023,44 +117105,126 @@ function isBinaryContent(content) {
   }
   return false;
 }
+function scanFile(filePath, absoluteRoot, maxFileSize) {
+  let content;
+  let fileStats;
+  try {
+    fileStats = fsSync8.statSync(filePath);
+    if (fileStats.size > maxFileSize) {
+      return { node: null, edges: [] };
+    }
+    content = fsSync8.readFileSync(filePath, "utf-8");
+  } catch {
+    return { node: null, edges: [] };
+  }
+  if (isBinaryContent(content)) {
+    return { node: null, edges: [] };
+  }
+  const ext = path134.extname(filePath).toLowerCase();
+  let exports = [];
+  let exportLines = {};
+  try {
+    if ([".ts", ".tsx", ".js", ".jsx", ".mjs", ".cjs"].includes(ext)) {
+      const relativePath = path134.relative(absoluteRoot, filePath);
+      ({ exports, exportLines } = collectExports(_internals82.extractTSSymbols(relativePath, absoluteRoot)));
+    } else if (ext === ".py") {
+      const relativePath = path134.relative(absoluteRoot, filePath);
+      ({ exports, exportLines } = collectExports(_internals82.extractPythonSymbols(relativePath, absoluteRoot)));
+    }
+    const parsedImports = _internals82.parseFileImports(content);
+    const strippedForUsage = parsedImports.length > 0 ? _internals82.stripComments(content) : "";
+    const moduleName = toModuleName(filePath, absoluteRoot);
+    const node = {
+      filePath,
+      moduleName,
+      exports,
+      ...Object.keys(exportLines).length > 0 ? { exportLines } : {},
+      imports: parsedImports.map((p) => p.specifier),
+      language: getLanguage(filePath),
+      mtime: fileStats.mtime.toISOString(),
+      ontology: _internals82.extractFileOntology({
+        moduleName,
+        filePath,
+        content,
+        language: getLanguage(filePath),
+        exports,
+        imports: parsedImports.map((p) => p.specifier)
+      })
+    };
+    const edges = [];
+    const sortedImports = [...parsedImports].sort((a, b) => a.specifier.localeCompare(b.specifier));
+    for (const parsed of sortedImports) {
+      const resolvedTarget = resolveModuleSpecifier(absoluteRoot, filePath, parsed.specifier);
+      if (resolvedTarget !== null) {
+        const usedSymbols = usedSymbolsForImport(parsed, strippedForUsage);
+        edges.push({
+          source: filePath,
+          target: resolvedTarget,
+          importSpecifier: parsed.specifier,
+          importType: parsed.importType,
+          importedSymbols: parsed.importedSymbols,
+          ...usedSymbols !== undefined ? { usedSymbols } : {}
+        });
+      }
+    }
+    return { node, edges };
+  } catch {
+    return { node: null, edges: [] };
+  }
+}
 async function scanFileAsync(filePath, absoluteRoot, maxFileSize) {
   let content;
   let fileStats;
   try {
     fileStats = fsSync8.statSync(filePath);
     if (fileStats.size > maxFileSize) {
-      return { node: null, edges: [], symbolEdges: [] };
+      return {
+        node: null,
+        edges: [],
+        symbolEdges: [],
+        diagnostics: { oversizedFiles: [toModuleName(filePath, absoluteRoot)] }
+      };
     }
     content = fsSync8.readFileSync(filePath, "utf-8");
   } catch {
-    return { node: null, edges: [], symbolEdges: [] };
+    return {
+      node: null,
+      edges: [],
+      symbolEdges: [],
+      diagnostics: { unreadableFiles: [toModuleName(filePath, absoluteRoot)] }
+    };
   }
   if (isBinaryContent(content)) {
-    return { node: null, edges: [], symbolEdges: [] };
+    return {
+      node: null,
+      edges: [],
+      symbolEdges: [],
+      diagnostics: { binaryFiles: [toModuleName(filePath, absoluteRoot)] }
+    };
   }
   const grammarId = getLanguage(filePath);
   const facts = await _internals82.extractFileSymbols(grammarId, content);
   if (facts === null) {
-    const moduleName2 = toModuleName(filePath, absoluteRoot);
+    const fallback = scanFile(filePath, absoluteRoot, maxFileSize);
+    let parsedImports = [];
+    try {
+      parsedImports = _internals82.parseFileImports(content);
+    } catch {
+      parsedImports = [];
+    }
     return {
-      node: {
-        filePath,
-        moduleName: moduleName2,
-        exports: [],
-        imports: [],
-        language: grammarId,
-        mtime: fileStats.mtime.toISOString(),
-        ontology: _internals82.extractFileOntology({
-          moduleName: moduleName2,
-          filePath,
-          content,
-          language: grammarId,
-          exports: [],
-          imports: []
-        })
-      },
-      edges: [],
-      symbolEdges: []
+      ...fallback,
+      symbolEdges: [],
+      diagnostics: {
+        extractionFailures: [
+          {
+            file: toModuleName(filePath, absoluteRoot),
+            language: grammarId,
+            reason: "symbol_extraction_failed"
+          }
+        ],
+        unresolvedImports: unresolvedRelativeImportsFor(parsedImports, filePath, absoluteRoot)
+      }
     };
   }
   const exportedDefs = facts.defs.filter((d) => d.exported);
@@ -117111,6 +117275,10 @@ async function scanFileAsync(filePath, absoluteRoot, maxFileSize) {
       });
     }
   }
+  const unresolvedImports = sortedImports.filter((imp) => isRelativeImportSpecifier(imp.specifier)).filter((imp) => resolveModuleSpecifier(absoluteRoot, filePath, imp.specifier) === null).map((imp) => ({
+    file: moduleName,
+    specifier: imp.specifier
+  }));
   const symbolEdges = [];
   const localToImported = new Map;
   for (const imp of facts.imports) {
@@ -117141,7 +117309,12 @@ async function scanFileAsync(filePath, absoluteRoot, maxFileSize) {
       toSymbol: mapping.imported
     });
   }
-  return { node, edges, symbolEdges };
+  return {
+    node,
+    edges,
+    symbolEdges,
+    diagnostics: unresolvedImports.length > 0 ? { unresolvedImports } : undefined
+  };
 }
 async function buildWorkspaceGraphAsync(workspaceRoot, options) {
   validateWorkspace(workspaceRoot);
@@ -117163,6 +117336,7 @@ async function buildWorkspaceGraphAsync(workspaceRoot, options) {
     skippedFiles: 0,
     truncated: false
   };
+  const diagnostics = createEmptyDiagnostics();
   const sourceFiles = await findSourceFilesAsync(absoluteRoot, stats2, {
     walkBudgetMs,
     maxFiles,
@@ -117183,6 +117357,7 @@ async function buildWorkspaceGraphAsync(workspaceRoot, options) {
   let processedSinceYield = 0;
   for (const filePath of sourceFiles) {
     const result = await scanFileAsync(filePath, absoluteRoot, maxFileSize);
+    mergeDiagnostics(diagnostics, result.diagnostics);
     if (result.node) {
       let appended = false;
       try {
@@ -117223,6 +117398,7 @@ async function buildWorkspaceGraphAsync(workspaceRoot, options) {
   if (allSymbolEdges.length > 0) {
     graph.symbolEdges = allSymbolEdges;
   }
+  graph.diagnostics = diagnosticsHaveEntries(diagnostics) ? diagnostics : createEmptyDiagnostics();
   if (stats2.skippedFiles > 0 || stats2.skippedDirs > 0 || stats2.truncated) {
     log(`[repo-graph] Scan stats: ${stats2.filesScanned} files scanned, ` + `${stats2.skippedFiles} files skipped, ${stats2.skippedDirs} dirs skipped` + (stats2.truncated ? ", TRUNCATED" : ""));
   }
@@ -117264,7 +117440,11 @@ import * as fsPromises7 from "node:fs/promises";
 import * as path138 from "node:path";
 
 // src/tools/repo-graph/query.ts
+init_path_security();
+import * as fsSync9 from "node:fs";
 import * as path136 from "node:path";
+var GRAPH_HEALTH_OUTPUT_LIMIT = 50;
+var MAX_HEALTH_PATH_LENGTH = 500;
 var cachedReverseIndex = null;
 function normalizeLookupPath(input) {
   return normalizeGraphPath(input).replace(/^(?:\.\/)+/, "");
@@ -117363,6 +117543,139 @@ function isGraphFresh(graph, maxAgeMs = 5 * 60 * 1000) {
     return false;
   return Date.now() - built <= maxAgeMs;
 }
+function isSafeHealthPath(value) {
+  if (typeof value !== "string")
+    return false;
+  if (value.length === 0 || value.length > MAX_HEALTH_PATH_LENGTH)
+    return false;
+  if (containsControlChars(value) || containsPathTraversal(value))
+    return false;
+  if (path136.isAbsolute(value) || /^[A-Za-z]:[\\/]/.test(value))
+    return false;
+  return true;
+}
+function isSafeHealthText(value) {
+  if (typeof value !== "string")
+    return false;
+  if (value.length === 0 || value.length > MAX_HEALTH_PATH_LENGTH)
+    return false;
+  if (containsControlChars(value))
+    return false;
+  return true;
+}
+function cap(entries) {
+  return entries.slice(0, GRAPH_HEALTH_OUTPUT_LIMIT);
+}
+function sanitizeExtractionFailures(value) {
+  if (!Array.isArray(value))
+    return [];
+  const entries = [];
+  for (const raw of value) {
+    if (!raw || typeof raw !== "object")
+      continue;
+    const entry = raw;
+    if (isSafeHealthPath(entry.file) && isSafeHealthText(entry.language) && isSafeHealthText(entry.reason)) {
+      entries.push({
+        file: entry.file,
+        language: entry.language,
+        reason: entry.reason
+      });
+    }
+  }
+  return cap(entries);
+}
+function sanitizeUnresolvedImports(value) {
+  if (!Array.isArray(value))
+    return [];
+  const entries = [];
+  for (const raw of value) {
+    if (!raw || typeof raw !== "object")
+      continue;
+    const entry = raw;
+    if (isSafeHealthPath(entry.file) && isSafeHealthText(entry.specifier)) {
+      entries.push({ file: entry.file, specifier: entry.specifier });
+    }
+  }
+  return cap(entries);
+}
+function sanitizePathList(value) {
+  if (!Array.isArray(value))
+    return [];
+  return cap(value.filter(isSafeHealthPath));
+}
+function getStaleFiles(graph, workspaceRoot) {
+  const built = Date.parse(graph.metadata.generatedAt);
+  if (!Number.isFinite(built))
+    return [];
+  const root = workspaceRoot ?? graph.workspaceRoot;
+  const stale = [];
+  for (const node of Object.values(graph.nodes)) {
+    const moduleName = normalizeGraphPath(node.moduleName);
+    if (!isSafeHealthPath(moduleName))
+      continue;
+    const filePath = path136.join(root, moduleName);
+    try {
+      if (fsSync9.statSync(filePath).mtimeMs > built) {
+        stale.push(moduleName);
+        if (stale.length >= GRAPH_HEALTH_OUTPUT_LIMIT)
+          break;
+      }
+    } catch {}
+  }
+  return stale;
+}
+function getGraphHealth(graph, workspaceRoot) {
+  if (!graph) {
+    return {
+      schemaVersion: null,
+      fresh: false,
+      staleFiles: [],
+      extractionFailures: [],
+      unresolvedImports: [],
+      oversizedFiles: [],
+      unsupportedFiles: [],
+      binaryFiles: [],
+      unreadableFiles: [],
+      lowConfidenceEdgeCount: 0,
+      notes: [
+        'No repo graph found at .swarm/repo-graph.json. Run repo_map with action="build" first.'
+      ]
+    };
+  }
+  const diagnostics = graph.diagnostics;
+  const fresh = isGraphFresh(graph);
+  const staleFiles = getStaleFiles(graph, workspaceRoot);
+  const notes = [];
+  if (!fresh || staleFiles.length > 0) {
+    notes.push('Graph is stale. Run repo_map with action="build" to refresh.');
+  }
+  if (!diagnostics) {
+    notes.push('Graph has no recorded diagnostics. Rebuild with repo_map action="build" to collect health details.');
+  }
+  const binaryFiles = sanitizePathList(diagnostics?.binaryFiles);
+  const binaryCount = binaryFiles.length;
+  if (binaryCount > 0) {
+    notes.push(`${binaryCount} binary files skipped during last build.`);
+  }
+  const unreadableFiles = sanitizePathList(diagnostics?.unreadableFiles);
+  const unreadableCount = unreadableFiles.length;
+  if (unreadableCount > 0) {
+    notes.push(`${unreadableCount} unreadable files skipped during last build.`);
+  }
+  return {
+    schemaVersion: graph.schema_version,
+    fresh,
+    staleFiles,
+    extractionFailures: sanitizeExtractionFailures(diagnostics?.extractionFailures),
+    unresolvedImports: sanitizeUnresolvedImports(diagnostics?.unresolvedImports),
+    oversizedFiles: sanitizePathList(diagnostics?.oversizedFiles),
+    unsupportedFiles: sanitizePathList(diagnostics?.unsupportedFiles),
+    binaryFiles,
+    unreadableFiles,
+    lowConfidenceEdgeCount: typeof diagnostics?.lowConfidenceEdgeCount === "number" && Number.isFinite(diagnostics.lowConfidenceEdgeCount) && diagnostics.lowConfidenceEdgeCount > 0 ? Math.floor(diagnostics.lowConfidenceEdgeCount) : 0,
+    notes
+  };
+}
 function getImporters(graph, filePath) {
   const node = getGraphNode(graph, filePath);
   if (!node)
@@ -117951,7 +118264,7 @@ function buildOntologyPreflightPacket(graph, filePaths = [], options = {}) {
 init_utils2();
 init_logger();
 init_path_security();
-import { constants as constants5, existsSync as existsSync77, readFileSync as readFileSync53, statSync as statSync27 } from "node:fs";
+import { constants as constants5, existsSync as existsSync77, readFileSync as readFileSync53, statSync as statSync28 } from "node:fs";
 import * as fsPromises6 from "node:fs/promises";
 import * as path137 from "node:path";
 var WINDOWS_RENAME_MAX_RETRIES2 = 5;
@@ -118076,7 +118389,7 @@ function loadGraphSync(workspace) {
     const graphPath = getGraphPath(workspace);
     if (!existsSync77(graphPath))
       return null;
-    const stats2 = statSync27(graphPath);
+    const stats2 = statSync28(graphPath);
     const content = readFileSync53(graphPath, "utf-8");
     if (content.includes("\x00") || content.includes("�")) {
       throw Object.assign(new Error("repo-graph.json contains null bytes or invalid encoding"), { code: "CORRUPTION" });
@@ -123102,9 +123415,9 @@ function parseDelegateDirectiveBlock(text) {
 }
 async function injectForDelegate(params) {
   const { directory, agent, taskTitle, sessionId, config: config3 } = params;
-  const cap = config3.delegate_max_inject_count ?? 8;
+  const cap2 = config3.delegate_max_inject_count ?? 8;
   const expectedTools = params.expectedTools && params.expectedTools.length > 0 ? params.expectedTools : defaultExpectedToolsForAgent(agent);
-  if (cap <= 0)
+  if (cap2 <= 0)
     return { entries: [], trace_id: "" };
   const role = stripKnownSwarmPrefix(agent).toLowerCase();
   const firstTool = expectedTools.length > 0 ? expectedTools[0] : undefined;
@@ -123128,11 +123441,11 @@ async function injectForDelegate(params) {
       tier: "all",
       applyScopeFilter: true,
       applyRoleScope: false,
-      maxResults: Math.max(40, cap * 4),
+      maxResults: Math.max(40, cap2 * 4),
       emitEvent: false
     });
     const scoped = search.results.filter((e) => matchesDelegateScope(e, role, expectedTools));
-    const capped = scoped.slice(0, cap);
+    const capped = scoped.slice(0, cap2);
     if (capped.length > 0) {
       const ranks = {};
       const scores = {};
@@ -129968,7 +130281,7 @@ ${body}`);
 init_zod();
 init_task_file();
 import { appendFileSync as appendFileSync18, existsSync as existsSync95, mkdirSync as mkdirSync42, readFileSync as readFileSync64 } from "node:fs";
-import { join as join131 } from "node:path";
+import { join as join132 } from "node:path";
 var EVIDENCE_DIR2 = ".swarm/evidence";
 var VALID_TASK_ID = /^\d+\.\d+(\.\d+)*$/;
 var COUNCIL_GATE_NAME = "council";
@@ -130006,7 +130319,7 @@ async function writeCouncilEvidence(workingDir, synthesis) {
   if (!VALID_TASK_ID.test(synthesis.taskId)) {
     throw new Error(`writeCouncilEvidence: invalid taskId "${synthesis.taskId}" — must match N.M or N.M.P format`);
   }
-  const dir = join131(workingDir, EVIDENCE_DIR2);
+  const dir = join132(workingDir, EVIDENCE_DIR2);
   mkdirSync42(dir, { recursive: true });
   const filePath = taskEvidencePath(workingDir, synthesis.taskId);
   await _internals96.withTaskEvidenceLock(workingDir, synthesis.taskId, COUNCIL_AGENT_ID, async () => {
@@ -130042,7 +130355,7 @@ async function writeCouncilEvidence(workingDir, synthesis) {
     await atomicWriteFile(filePath, JSON.stringify(updated, null, 2));
   });
   try {
-    const councilDir = join131(workingDir, ".swarm", "council");
+    const councilDir = join132(workingDir, ".swarm", "council");
     mkdirSync42(councilDir, { recursive: true });
     const auditLine = JSON.stringify({
       round: synthesis.roundNumber,
@@ -130050,7 +130363,7 @@ async function writeCouncilEvidence(workingDir, synthesis) {
       timestamp: synthesis.timestamp,
       vetoedBy: synthesis.vetoedBy
     });
-    appendFileSync18(join131(councilDir, `${synthesis.taskId}.rounds.jsonl`), `${auditLine}
+    appendFileSync18(join132(councilDir, `${synthesis.taskId}.rounds.jsonl`), `${auditLine}
 `);
   } catch (auditError) {
     console.warn(`writeCouncilEvidence: failed to append round-history audit log: ${auditError instanceof Error ? auditError.message : String(auditError)}`);
@@ -130407,7 +130720,7 @@ function buildFinalCouncilFeedback(projectSummary, verdict, vetoedBy, requiredFi
 init_zod();
 init_task_file();
 import { existsSync as existsSync96, mkdirSync as mkdirSync43, readFileSync as readFileSync65 } from "node:fs";
-import { join as join132 } from "node:path";
+import { join as join133 } from "node:path";
 var COUNCIL_DIR = ".swarm/council";
 var CouncilCriteriaSchema = exports_external.object({
   taskId: exports_external.string(),
@@ -130419,17 +130732,17 @@ var CouncilCriteriaSchema = exports_external.object({
   declaredAt: exports_external.string()
 });
 async function writeCriteria(workingDir, taskId, criteria) {
-  const dir = join132(workingDir, COUNCIL_DIR);
+  const dir = join133(workingDir, COUNCIL_DIR);
   mkdirSync43(dir, { recursive: true });
   const payload = {
     taskId,
     criteria,
     declaredAt: new Date().toISOString()
   };
-  await atomicWriteFile(join132(dir, `${safeId(taskId)}.json`), JSON.stringify(payload, null, 2));
+  await atomicWriteFile(join133(dir, `${safeId(taskId)}.json`), JSON.stringify(payload, null, 2));
 }
 function readCriteria(workingDir, taskId) {
-  const filePath = join132(workingDir, COUNCIL_DIR, `${safeId(taskId)}.json`);
+  const filePath = join133(workingDir, COUNCIL_DIR, `${safeId(taskId)}.json`);
   if (!existsSync96(filePath))
     return null;
   try {
@@ -149644,7 +149957,8 @@ var VALID_ACTIONS = [
   "preflight_packet",
   "callers",
   "dead_exports",
-  "context_pack"
+  "context_pack",
+  "graph_health"
 ];
 var MAX_FILE_PATH_LENGTH3 = 500;
 var MAX_SYMBOL_LENGTH2 = 256;
@@ -149708,7 +150022,7 @@ async function loadOrError(directory, action) {
   }
 }
 var repo_map = createSwarmTool({
-  description: "Query the repository code graph for structural awareness before editing. " + 'Actions: "build" (build/refresh .swarm/repo-graph.json), "importers" (who imports a file), ' + '"dependencies" (what a file imports), "blast_radius" (transitive dependents + risk), ' + '"localization" (compact context block for a target file), "key_files" (top-N most-imported files), ' + '"ontology" (file roles/routes/data/security/findings), "package_boundaries" (inferred package/layer boundaries), ' + '"preflight_packet" (bounded ontology packet for planning), ' + '"callers" (files that reference an exported symbol, call-site granularity; needs file+symbol), ' + '"dead_exports" (advisory: exported symbols with no detected in-repo reference; results are review candidates, not delete directives), ' + '"context_pack" (token-budgeted slice of source spans for a target symbol — definition + transitive callers/callees; advisory/conservative; needs file+symbol; uses max_depth for traversal depth, top_n for span cap). ' + "Use this before refactoring shared modules to avoid breaking unseen consumers. " + 'Note: "callers"/"dead_exports"/"context_pack" use conservative regex analysis (TS/JS/Python) and cannot see ' + 'dynamic dispatch or namespace/barrel re-export usage; "dead_exports" results are review candidates, not delete directives.',
+  description: "Query the repository code graph for structural awareness before editing. " + 'Actions: "build" (build/refresh .swarm/repo-graph.json), "importers" (who imports a file), ' + '"dependencies" (what a file imports), "blast_radius" (transitive dependents + risk), ' + '"localization" (compact context block for a target file), "key_files" (top-N most-imported files), ' + '"ontology" (file roles/routes/data/security/findings), "package_boundaries" (inferred package/layer boundaries), ' + '"preflight_packet" (bounded ontology packet for planning), ' + '"callers" (files that reference an exported symbol, call-site granularity; needs file+symbol), ' + '"dead_exports" (advisory: exported symbols with no detected in-repo reference; results are review candidates, not delete directives), ' + '"context_pack" (token-budgeted slice of source spans for a target symbol — definition + transitive callers/callees; advisory/conservative; needs file+symbol; uses max_depth for traversal depth, top_n for span cap), ' + '"graph_health" (freshness and bounded extraction diagnostics; no file required). ' + "Use this before refactoring shared modules to avoid breaking unseen consumers. " + 'Note: "callers"/"dead_exports"/"context_pack" use conservative regex analysis (TS/JS/Python) and cannot see ' + 'dynamic dispatch or namespace/barrel re-export usage; "dead_exports" results are review candidates, not delete directives.',
   args: {
     action: exports_external.enum([
       "build",
@@ -149722,8 +150036,9 @@ var repo_map = createSwarmTool({
       "preflight_packet",
       "callers",
       "dead_exports",
-      "context_pack"
-    ]).describe('Query action: "build" | "importers" | "dependencies" | "blast_radius" | "localization" | "key_files" | "ontology" | "package_boundaries" | "preflight_packet" | "callers" | "dead_exports" | "context_pack"'),
+      "context_pack",
+      "graph_health"
+    ]).describe('Query action: "build" | "importers" | "dependencies" | "blast_radius" | "localization" | "key_files" | "ontology" | "package_boundaries" | "preflight_packet" | "callers" | "dead_exports" | "context_pack" | "graph_health"'),
     file: exports_external.string().optional().describe("Target file (workspace-relative or absolute). Required for importers/dependencies/localization/ontology. Optional for preflight_packet."),
     files: exports_external.array(exports_external.string()).optional().describe("Multiple target files for blast_radius/preflight_packet. If omitted, falls back to `file`."),
     symbol: exports_external.string().optional().describe('Exported symbol name. Restricts consumers on action="importers"; required for action="callers"/"context_pack".'),
@@ -149758,6 +150073,15 @@ var repo_map = createSwarmTool({
         return err(action, `build failed: ${message}`);
       }
     }
+    if (action === "graph_health") {
+      try {
+        const graph2 = await loadGraph(directory);
+        return ok(action, { ...getGraphHealth(graph2, directory) });
+      } catch (e) {
+        const message = e instanceof Error ? e.message : String(e);
+        return err(action, `failed to load repo graph: ${message}`);
+      }
+    }
     const loaded = await loadOrError(directory, action);
     if (!loaded.ok)
       return loaded.response;
@@ -153111,7 +153435,7 @@ init_skill_generator();
 init_create_tool();
 import { existsSync as existsSync119 } from "node:fs";
 import { readdir as readdir12, readFile as readFile33 } from "node:fs/promises";
-import { join as join166 } from "node:path";
+import { join as join167 } from "node:path";
 var run_stale_reconciliation = createSwarmTool({
   description: "Reconcile skills against the knowledge store. clear=false: mark skills stale when source knowledge is archived or deleted. clear=true: clear stale.marker on affected active skills (proposal files under .swarm/skills/proposals are scanned but not modified — they are drafts, not yet active skills).",
   args: {
@@ -153138,8 +153462,8 @@ var run_stale_reconciliation = createSwarmTool({
     } catch {}
     const skillEntries = [];
     for (const dir of [
-      join166(directory, ".opencode", "skills", "generated"),
-      join166(directory, ".swarm", "skills", "proposals")
+      join167(directory, ".opencode", "skills", "generated"),
+      join167(directory, ".swarm", "skills", "proposals")
     ]) {
       if (!_internals125.existsSync(dir))
         continue;
@@ -153148,14 +153472,14 @@ var run_stale_reconciliation = createSwarmTool({
         if (entry.isDirectory()) {
           skillEntries.push({
             slug: entry.name,
-            path: join166(dir, entry.name),
+            path: join167(dir, entry.name),
             isProposal: false
           });
         } else if (entry.name.endsWith(".md")) {
           const slug = entry.name.replace(/\.md$/, "");
           skillEntries.push({
             slug,
-            path: join166(dir, entry.name),
+            path: join167(dir, entry.name),
             isProposal: true
           });
         }
@@ -153163,7 +153487,7 @@ var run_stale_reconciliation = createSwarmTool({
     }
     const results = [];
     for (const { slug, path: path210, isProposal } of skillEntries) {
-      const skillMdPath = isProposal ? path210 : join166(path210, "SKILL.md");
+      const skillMdPath = isProposal ? path210 : join167(path210, "SKILL.md");
       if (!_internals125.existsSync(skillMdPath))
         continue;
       const content = await _internals125.readFile(skillMdPath, "utf-8");
@@ -153176,7 +153500,7 @@ var run_stale_reconciliation = createSwarmTool({
         continue;
       if (args2.clear) {
         if (!isProposal) {
-          const markerPath = join166(path210, "stale.marker");
+          const markerPath = join167(path210, "stale.marker");
           if (_internals125.existsSync(markerPath)) {
             try {
               await _internals125.clearSkillStale(path210);
@@ -158389,14 +158713,6 @@ async function initializeOpenCodeSwarm(ctx) {
     prEventCleanup?.();
   };
   process.on("exit", cleanupAutomation);
-  process.once("SIGINT", () => {
-    cleanupAutomation();
-    process.exit(130);
-  });
-  process.once("SIGTERM", () => {
-    cleanupAutomation();
-    process.exit(143);
-  });
   if (shouldRunOnStartup(automationConfig)) {
     const enableAutofix = automationConfig.capabilities?.config_doctor_autofix === true;
     Promise.resolve().then(() => (init_config_doctor(), exports_config_doctor)).then(({ runConfigDoctorWithFixes: runConfigDoctorWithFixes2 }) => {
@@ -158412,9 +158728,19 @@ async function initializeOpenCodeSwarm(ctx) {
           try {
             const autoFixableCount = doctorResult.result.findings.filter((f) => f.autoFixable).length;
             if (!enableAutofix && autoFixableCount > 0) {
-              console.warn(`[opencode-swarm] Config Doctor found ${autoFixableCount} auto-fixable issue(s). Run /swarm config doctor --fix to apply.`);
+              const msg = `[opencode-swarm] Config Doctor found ${autoFixableCount} auto-fixable issue(s). Run /swarm config doctor --fix to apply.`;
+              if (!config3.quiet) {
+                console.warn(msg);
+              } else {
+                addDeferredWarning(msg);
+              }
             } else if (enableAutofix && doctorResult.appliedFixes.length > 0) {
-              console.warn(`[opencode-swarm] Config Doctor applied ${doctorResult.appliedFixes.length} fix(es) automatically.`);
+              const msg = `[opencode-swarm] Config Doctor applied ${doctorResult.appliedFixes.length} fix(es) automatically.`;
+              if (!config3.quiet) {
+                console.warn(msg);
+              } else {
+                addDeferredWarning(msg);
+              }
             }
           } catch {}
         }
@@ -158957,7 +159283,9 @@ async function initializeOpenCodeSwarm(ctx) {
                 argsRecord.prompt = `SKILLS: none
 
 ${promptRaw}`;
-                console.warn("[skill-propagation-gate] No skills above threshold 0.5 — injected SKILLS: none");
+                if (!config3.quiet) {
+                  console.warn("[skill-propagation-gate] No skills above threshold 0.5 — injected SKILLS: none");
+                }
               } else {
                 const topSkills = qualified.slice(0, 5);
                 const skillPaths = topSkills.map((s) => {
@@ -158975,7 +159303,9 @@ ${promptRaw}`;
 ${promptRaw}`;
                 argsRecord.prompt = newPrompt;
                 const skillNames = topSkills.map((s) => `${path225.basename(s.skillPath)} (score: ${s.score.toFixed(2)})`).join(", ");
-                console.warn(`[skill-propagation-gate] Injected skills: ${skillNames}`);
+                if (!config3.quiet) {
+                  console.warn(`[skill-propagation-gate] Injected skills: ${skillNames}`);
+                }
                 for (const skill of topSkills) {
                   try {
                     appendSkillUsageEntry(ctx.directory, {

package/dist/tools/repo-graph/builder.d.ts

@@ -14,7 +14,7 @@ import { extractFileSymbols } from '../../lang/symbol-graph';
 import { extractPythonSymbols, extractTSSymbols } from '../symbols';
 import { extractFileOntology } from './ontology';
 import { safeRealpathSync } from './safe-realpath';
-import type { BuildWorkspaceGraphOptions, GraphEdge, GraphNode, RepoGraph, SymbolEdge } from './types';
+import type { BuildWorkspaceGraphOptions, GraphEdge, GraphNode, RepoGraph, RepoGraphDiagnostics, SymbolEdge } from './types';
 /**
  * _internals DI seam for safeRealpathSync.
  * Defaults to the real implementation. Tests can override this to inject
@@ -141,6 +141,8 @@ export interface AsyncScanResult {
     edges: GraphEdge[];
     /** Symbol-to-symbol reference edges (schema >= 1.2.0). */
     symbolEdges: SymbolEdge[];
+    /** Optional file-level diagnostics collected during async scanning. */
+    diagnostics?: RepoGraphDiagnostics;
 }
 /**
  * Scan a single file and extract its graph node and edges.
@@ -157,11 +159,11 @@ export declare function scanFile(filePath: string, absoluteRoot: string, maxFile
  * (extractFileSymbols) to populate exportRanges and symbolEdges.
  *
  * Fail-open: if extractFileSymbols returns null (grammar unavailable,
- * timeout, parse error), falls back to a minimal file-level node with
- * empty exports/imports/symbolEdges — never throws.
+ * timeout, parse error), falls back to the file-level scanner so imports,
+ * exports, and dependency edges are preserved.
  *
- * Oversized, binary, or unreadable files return { node: null, edges: [], symbolEdges: [] }
- * matching the sync scanFile contract.
+ * Oversized, binary, or unreadable files return
+ * { node: null, edges: [], symbolEdges: [] } with bounded diagnostics.
  *
  * @param filePath - Absolute path to the file to scan
  * @param absoluteRoot - Absolute path to workspace root

package/dist/tools/repo-graph/query.d.ts

@@ -1,7 +1,8 @@
-import type { BlastRadiusResult, CallerReference, ContextPackResult, DeadExportsResult, FileOntology, FileReference, GraphNode, LocalizationBlock, PackageBoundarySummary, RepoGraph, SymbolReference } from './types';
+import type { BlastRadiusResult, CallerReference, ContextPackResult, DeadExportsResult, FileOntology, FileReference, GraphHealthResult, GraphNode, LocalizationBlock, PackageBoundarySummary, RepoGraph, SymbolReference } from './types';
 export declare function getGraphNode(graph: RepoGraph, input: string): GraphNode | undefined;
 export declare function resetQueryCache(): void;
 export declare function isGraphFresh(graph: RepoGraph | null, maxAgeMs?: number): boolean;
+export declare function getGraphHealth(graph: RepoGraph | null, workspaceRoot?: string): GraphHealthResult;
 export declare function getImporters(graph: RepoGraph, filePath: string): FileReference[];
 export declare function getDependencies(graph: RepoGraph, filePath: string): FileReference[];
 export declare function getSymbolConsumers(graph: RepoGraph, filePath: string, symbolName: string): SymbolReference[];

package/dist/tools/repo-graph/types.d.ts

@@ -22,6 +22,10 @@ export declare const REPO_GRAPH_FILENAME = "repo-graph.json";
  * symbol reference edges). Both fields are optional, so 1.0.0 and 1.1.0 graphs
  * still load without corruption. New queries may use these fields to provide
  * more precise context-packing and symbol-level navigation.
+ *
+ * Diagnostics are additive and optional on all schema versions. Old graphs
+ * without diagnostics remain readable; graph-health queries surface empty
+ * diagnostics with an explicit rebuild note.
  */
 export declare const GRAPH_SCHEMA_VERSION = "1.2.0";
 /**
@@ -248,6 +252,37 @@ export interface DeadExportsResult {
     /** Human-readable note describing scope and limitations of the result. */
     note: string;
 }
+export interface GraphExtractionFailure {
+    file: string;
+    language: string;
+    reason: string;
+}
+export interface GraphUnresolvedImport {
+    file: string;
+    specifier: string;
+}
+export interface RepoGraphDiagnostics {
+    extractionFailures?: GraphExtractionFailure[];
+    unresolvedImports?: GraphUnresolvedImport[];
+    oversizedFiles?: string[];
+    unsupportedFiles?: string[];
+    binaryFiles?: string[];
+    unreadableFiles?: string[];
+    lowConfidenceEdgeCount?: number;
+}
+export interface GraphHealthResult {
+    schemaVersion: string | null;
+    fresh: boolean;
+    staleFiles: string[];
+    extractionFailures: GraphExtractionFailure[];
+    unresolvedImports: GraphUnresolvedImport[];
+    oversizedFiles: string[];
+    unsupportedFiles: string[];
+    binaryFiles: string[];
+    unreadableFiles: string[];
+    lowConfidenceEdgeCount: number;
+    notes: string[];
+}
 export interface BlastRadiusResult {
     target: string[];
     directDependents: string[];
@@ -299,6 +334,8 @@ export interface RepoGraph {
     };
     /** Symbol-level reference edges (schema >= 1.2.0; absent on older graphs). */
     symbolEdges?: SymbolEdge[];
+    /** Optional bounded diagnostics from the last graph build. */
+    diagnostics?: RepoGraphDiagnostics;
 }
 /**
  * Options for building a workspace graph.

package/dist/tools/repo-graph.d.ts

@@ -21,8 +21,8 @@ export { updateGraphForFiles } from './repo-graph/incremental';
 export type { ExtractFileOntologyInput } from './repo-graph/ontology';
 export { extractFileOntology } from './repo-graph/ontology';
 export type { DeadExportsOptions } from './repo-graph/query';
-export { buildOntologyPreflightPacket, getBlastRadius, getCallers, getContextPack, getDeadExports, getDependencies, getFileOntology, getGraphNode, getImporters, getKeyFiles, getLocalizationContext, getPackageBoundaries, getSymbolConsumers, isGraphFresh, resetQueryCache, } from './repo-graph/query';
+export { buildOntologyPreflightPacket, getBlastRadius, getCallers, getContextPack, getDeadExports, getDependencies, getFileOntology, getGraphHealth, getGraphNode, getImporters, getKeyFiles, getLocalizationContext, getPackageBoundaries, getSymbolConsumers, isGraphFresh, resetQueryCache, } from './repo-graph/query';
 export { getGraphPath, loadGraph, loadGraphSync, loadOrCreateGraph, saveGraph, saveIfDirty, } from './repo-graph/storage';
-export type { BlastRadiusResult, BuildWorkspaceGraphOptions, CallerReference, ContextPackResult, ContextPackSpan, ConventionFact, DataOperationFact, DeadExportCandidate, DeadExportsResult, FileOntology, FileReference, FileRole, GraphEdge, GraphNode, LocalizationBlock, OntologyFinding, PackageBoundarySummary, RepoGraph, RouteFact, RouteMethod, SecurityFact, SymbolEdge, SymbolReference, } from './repo-graph/types';
+export type { BlastRadiusResult, BuildWorkspaceGraphOptions, CallerReference, ContextPackResult, ContextPackSpan, ConventionFact, DataOperationFact, DeadExportCandidate, DeadExportsResult, FileOntology, FileReference, FileRole, GraphEdge, GraphExtractionFailure, GraphHealthResult, GraphNode, GraphUnresolvedImport, LocalizationBlock, OntologyFinding, PackageBoundarySummary, RepoGraph, RepoGraphDiagnostics, RouteFact, RouteMethod, SecurityFact, SymbolEdge, SymbolReference, } from './repo-graph/types';
 export { createEmptyGraph, GRAPH_SCHEMA_VERSION, isSchemaVersionAtLeast, normalizeGraphPath, REPO_GRAPH_FILENAME, updateGraphMetadata, } from './repo-graph/types';
 export { validateGraphEdge, validateGraphNode, validateWorkspace, } from './repo-graph/validation';

package/package.json

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