nexus-agents 2.168.0 → 2.170.0

package/dist/{chunk-UGJRDFMN.js → chunk-UXXNNT5D.js}

@@ -3,7 +3,7 @@ import {
   MODEL_IDS,
   getTimeProvider,
   resolveModelIdentitySync
-} from "./chunk-OKAHIWG4.js";
+} from "./chunk-GVTXP6F6.js";
 
 // src/config/model-availability.ts
 var DEFAULT_TTL_MS = 6e4;
@@ -150,4 +150,4 @@ export {
   resetAvailabilityCache,
   filterAvailableModels
 };
-//# sourceMappingURL=chunk-UGJRDFMN.js.map
+//# sourceMappingURL=chunk-UXXNNT5D.js.map

package/dist/{chunk-TZK7VQAW.js → chunk-WKW5SEP7.js}

@@ -1,7 +1,7 @@
 import {
   GitHubProvider,
   ScmError
-} from "./chunk-F5JDQXHJ.js";
+} from "./chunk-C6IAXFNC.js";
 import {
   ROLE_DEFAULT_TRUST,
   ReputationCache,
@@ -11,17 +11,17 @@ import {
   gateWithReputation,
   resolveReputationGatingMode,
   sanitizeInput
-} from "./chunk-UN7PYUJB.js";
+} from "./chunk-DEE2UTYV.js";
 import {
   emitPolicyEvent
-} from "./chunk-RJHLNI37.js";
+} from "./chunk-OYBAKU7N.js";
 import {
   CLI_SUBPROCESS_TIMEOUTS,
   createLogger,
   err,
   getTimeProvider,
   ok
-} from "./chunk-OKAHIWG4.js";
+} from "./chunk-GVTXP6F6.js";
 
 // src/security/trust-classifier.ts
 function mapAuthorAssociation(association) {
@@ -1211,4 +1211,4 @@ export {
   IssueTriage,
   createIssueTriage
 };
-//# sourceMappingURL=chunk-TZK7VQAW.js.map
+//# sourceMappingURL=chunk-WKW5SEP7.js.map

package/dist/{chunk-AO4X3BMP.js → chunk-YF35FKKD.js}

@@ -261,6 +261,7 @@ export {
   extractSymbolIndex,
   DEFAULT_INDEX_MAX_DEPTH,
   MAX_INDEX_MAX_DEPTH,
+  findSourceFiles,
   CodebaseIndex
 };
-//# sourceMappingURL=chunk-AO4X3BMP.js.map
+//# sourceMappingURL=chunk-YF35FKKD.js.map

package/dist/chunk-YF35FKKD.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/indexer/codebase-search.ts","../src/indexer/symbol-extractor.ts"],"sourcesContent":["/**\n * Codebase search — keyword search across symbol indices.\n *\n * Builds an in-memory symbol index for a directory of TS/JS files,\n * then supports keyword search, file summaries, and symbol lookup.\n *\n * Inspired by Augment Code's Context Engine. Uses the existing\n * extractSymbols() function for AST parsing.\n *\n * @module indexer/codebase-search\n */\n\nimport { readdir } from 'node:fs/promises';\nimport { resolve, extname, relative } from 'node:path';\nimport {\n  extractSymbols,\n  type CodeSymbol,\n  type SymbolExtractionResult,\n} from './symbol-extractor.js';\n\n/** A symbol with its source file path. */\nexport interface IndexedSymbol extends CodeSymbol {\n  /** Relative file path from the indexed root. */\n  filePath: string;\n}\n\n/** Search result with relevance scoring. */\nexport interface SearchResult {\n  symbol: IndexedSymbol;\n  /** Relevance score (higher = better match). */\n  score: number;\n  /** How the query matched (exact, prefix, substring, word). */\n  matchType: 'exact' | 'prefix' | 'substring' | 'word';\n}\n\n/** File summary — compact overview of a source file. */\nexport interface FileSummary {\n  filePath: string;\n  totalLines: number;\n  exportedSymbols: number;\n  privateSymbols: number;\n  kinds: Record<string, number>;\n}\n\n/** Index statistics. */\nexport interface IndexStats {\n  totalFiles: number;\n  totalSymbols: number;\n  indexedAt: string;\n  /** Directories not descended into because `maxDepth` was exhausted (#4243). */\n  skippedDirs: number;\n}\n\n/** Default recursion depth for `CodebaseIndex.index()` (#4243 — was hardcoded 4). */\nexport const DEFAULT_INDEX_MAX_DEPTH = 24;\n/** Upper clamp for caller-supplied `maxDepth` to bound worst-case tree-walk cost. */\nexport const MAX_INDEX_MAX_DEPTH = 64;\n\n// Score weights for different match types\nconst SCORE_EXACT = 20;\nconst SCORE_PREFIX = 10;\nconst SCORE_WORD = 5;\nconst SCORE_SUBSTRING = 2;\nconst SCORE_EXPORTED_BONUS = 3;\n\nfunction isSourceFile(name: string): boolean {\n  const ext = extname(name).toLowerCase();\n  return (\n    ['.ts', '.tsx', '.js', '.jsx'].includes(ext) &&\n    !name.endsWith('.test.ts') &&\n    !name.endsWith('.test.tsx') &&\n    !name.endsWith('.d.ts')\n  );\n}\n\n/** Result of a recursive source-file walk: the files found plus a truncation signal. */\nexport interface FindSourceFilesResult {\n  files: string[];\n  /** Count of directories that were NOT descended into because maxDepth hit 0. */\n  skippedDirs: number;\n}\n\n/**\n * Recursively collect TS/JS source files under `dir`, bounded by `maxDepth`,\n * skipping `node_modules`/`dist` and test/declaration files. Exported so the\n * `search_usages` tool (#4265) reuses the exact same source-file set the symbol\n * index walks — keeping the two tools' scopes apples-to-apples (DRY).\n */\nexport async function findSourceFiles(\n  dir: string,\n  maxDepth: number\n): Promise<FindSourceFilesResult> {\n  if (maxDepth <= 0) return { files: [], skippedDirs: 1 };\n  const files: string[] = [];\n  let skippedDirs = 0;\n  const entries = await readdir(dir, { withFileTypes: true }).catch(() => []);\n  for (const entry of entries) {\n    const fullPath = resolve(dir, entry.name);\n    if (entry.isDirectory() && entry.name !== 'node_modules' && entry.name !== 'dist') {\n      const sub = await findSourceFiles(fullPath, maxDepth - 1);\n      files.push(...sub.files);\n      skippedDirs += sub.skippedDirs;\n    }\n    if (entry.isFile() && isSourceFile(entry.name)) {\n      files.push(fullPath);\n    }\n  }\n  return { files, skippedDirs };\n}\n\nfunction scoreMatch(symbolName: string, query: string): SearchResult['score'] | null {\n  const nameLower = symbolName.toLowerCase();\n  const queryLower = query.toLowerCase();\n\n  if (nameLower === queryLower) return SCORE_EXACT;\n  if (nameLower.startsWith(queryLower)) return SCORE_PREFIX;\n\n  // Word boundary match (camelCase splitting)\n  const words = symbolName\n    .replace(/([a-z])([A-Z])/g, '$1 $2')\n    .toLowerCase()\n    .split(/[\\s_-]+/);\n  if (words.some((w) => w === queryLower)) return SCORE_WORD;\n\n  if (nameLower.includes(queryLower)) return SCORE_SUBSTRING;\n\n  return null;\n}\n\nfunction getMatchType(score: number): SearchResult['matchType'] {\n  if (score >= SCORE_EXACT) return 'exact';\n  if (score >= SCORE_PREFIX) return 'prefix';\n  if (score >= SCORE_WORD) return 'word';\n  return 'substring';\n}\n\n/** In-memory codebase symbol index. */\nexport class CodebaseIndex {\n  private readonly symbols: IndexedSymbol[] = [];\n  private readonly fileResults = new Map<string, SymbolExtractionResult>();\n  private readonly rootDir: string;\n  private skippedDirs = 0;\n\n  constructor(rootDir: string) {\n    this.rootDir = rootDir;\n  }\n\n  /**\n   * Index all TS/JS source files in the directory.\n   *\n   * `maxDepth` is clamped to `[1, MAX_INDEX_MAX_DEPTH]` so a caller-supplied\n   * value can't force an unbounded tree-walk (#4243).\n   */\n  async index(maxDepth: number = DEFAULT_INDEX_MAX_DEPTH): Promise<IndexStats> {\n    const clampedDepth = Math.min(Math.max(maxDepth, 1), MAX_INDEX_MAX_DEPTH);\n    const { files, skippedDirs } = await findSourceFiles(this.rootDir, clampedDepth);\n    this.skippedDirs = skippedDirs;\n\n    for (const file of files) {\n      const result = await extractSymbols(file);\n      const relPath = relative(this.rootDir, file);\n      this.fileResults.set(relPath, result);\n\n      for (const symbol of result.symbols) {\n        this.symbols.push({ ...symbol, filePath: relPath });\n      }\n    }\n\n    return {\n      totalFiles: files.length,\n      totalSymbols: this.symbols.length,\n      indexedAt: new Date().toISOString(),\n      skippedDirs,\n    };\n  }\n\n  /** Search symbols by keyword. Returns top N results sorted by relevance. */\n  search(query: string, limit = 20): SearchResult[] {\n    const results: SearchResult[] = [];\n\n    for (const symbol of this.symbols) {\n      const baseScore = scoreMatch(symbol.name, query);\n      if (baseScore === null) continue;\n\n      const bonus = symbol.exported ? SCORE_EXPORTED_BONUS : 0;\n      results.push({\n        symbol,\n        score: baseScore + bonus,\n        matchType: getMatchType(baseScore),\n      });\n    }\n\n    return results.sort((a, b) => b.score - a.score).slice(0, limit);\n  }\n\n  /** Get a compact summary of a file's symbols. */\n  getFileSummary(filePath: string): FileSummary | undefined {\n    const result = this.fileResults.get(filePath);\n    if (result === undefined) return undefined;\n\n    const kinds: Record<string, number> = {};\n    let exported = 0;\n    let priv = 0;\n\n    for (const s of result.symbols) {\n      kinds[s.kind] = (kinds[s.kind] ?? 0) + 1;\n      if (s.exported) exported++;\n      else priv++;\n    }\n\n    return {\n      filePath,\n      totalLines: result.totalLines,\n      exportedSymbols: exported,\n      privateSymbols: priv,\n      kinds,\n    };\n  }\n\n  /** List all indexed files with symbol counts. */\n  listFiles(): Array<{ path: string; symbols: number; lines: number }> {\n    return [...this.fileResults.entries()].map(([path, result]) => ({\n      path,\n      symbols: result.symbols.length,\n      lines: result.totalLines,\n    }));\n  }\n\n  /** Get index statistics. */\n  get stats(): { files: number; symbols: number; skippedDirs: number } {\n    return {\n      files: this.fileResults.size,\n      symbols: this.symbols.length,\n      skippedDirs: this.skippedDirs,\n    };\n  }\n}\n","/**\n * AST symbol extraction for token-efficient code retrieval.\n *\n * Uses TypeScript's compiler API to extract function, class, method,\n * interface, and type definitions from source files.\n *\n * Token savings: ~80-99% vs reading full files.\n * No additional dependencies — uses TypeScript (already a project dep).\n *\n * @module indexer/symbol-extractor\n */\n\nimport { readFile } from 'node:fs/promises';\nimport { extname } from 'node:path';\nimport ts from 'typescript';\n\n/** A symbol extracted from source code. */\nexport interface CodeSymbol {\n  /** Symbol name */\n  name: string;\n  /** Symbol kind */\n  kind: 'function' | 'class' | 'method' | 'interface' | 'type' | 'variable' | 'enum';\n  /** Start line (1-based) */\n  startLine: number;\n  /** End line (1-based) */\n  endLine: number;\n  /** Full source text of the symbol */\n  text: string;\n  /** Whether the symbol is exported */\n  exported: boolean;\n}\n\n/** Result of extracting symbols from a file. */\nexport interface SymbolExtractionResult {\n  filePath: string;\n  symbols: CodeSymbol[];\n  totalLines: number;\n  totalChars: number;\n  symbolChars: number;\n  savingsPercent: number;\n}\n\nfunction getKind(node: ts.Node): CodeSymbol['kind'] | null {\n  if (ts.isFunctionDeclaration(node)) return 'function';\n  if (ts.isClassDeclaration(node)) return 'class';\n  if (ts.isInterfaceDeclaration(node)) return 'interface';\n  if (ts.isTypeAliasDeclaration(node)) return 'type';\n  if (ts.isEnumDeclaration(node)) return 'enum';\n  if (ts.isMethodDeclaration(node)) return 'method';\n  if (ts.isVariableStatement(node)) return 'variable';\n  return null;\n}\n\nfunction getName(node: ts.Node): string {\n  if (\n    ts.isFunctionDeclaration(node) ||\n    ts.isClassDeclaration(node) ||\n    ts.isInterfaceDeclaration(node) ||\n    ts.isTypeAliasDeclaration(node) ||\n    ts.isEnumDeclaration(node) ||\n    ts.isMethodDeclaration(node)\n  ) {\n    const nameNode = (node as ts.NamedDeclaration).name;\n    return nameNode ? nameNode.getText() : '<anonymous>';\n  }\n  if (ts.isVariableStatement(node)) {\n    const decls = node.declarationList.declarations;\n    const firstDecl = decls[0];\n    if (firstDecl !== undefined) {\n      return firstDecl.name.getText();\n    }\n  }\n  return '<anonymous>';\n}\n\nfunction isExported(node: ts.Node): boolean {\n  const modifiers = ts.canHaveModifiers(node) ? ts.getModifiers(node) : undefined;\n  if (modifiers) {\n    return modifiers.some((m) => m.kind === ts.SyntaxKind.ExportKeyword);\n  }\n  return false;\n}\n\nfunction visitNode(node: ts.Node, sourceFile: ts.SourceFile, symbols: CodeSymbol[]): void {\n  const kind = getKind(node);\n  if (kind !== null) {\n    const name = getName(node);\n    if (name !== '<anonymous>') {\n      const start = sourceFile.getLineAndCharacterOfPosition(node.getStart());\n      const end = sourceFile.getLineAndCharacterOfPosition(node.getEnd());\n      symbols.push({\n        name,\n        kind,\n        startLine: start.line + 1,\n        endLine: end.line + 1,\n        text: node.getText(sourceFile),\n        exported: isExported(node),\n      });\n    }\n  }\n  if (ts.isClassDeclaration(node)) {\n    visitClassMembers(node, sourceFile, symbols);\n    return;\n  }\n  ts.forEachChild(node, (child) => {\n    visitNode(child, sourceFile, symbols);\n  });\n}\n\nfunction visitClassMembers(\n  node: ts.ClassDeclaration,\n  sourceFile: ts.SourceFile,\n  symbols: CodeSymbol[]\n): void {\n  for (const member of node.members) {\n    if (ts.isMethodDeclaration(member) || ts.isPropertyDeclaration(member)) {\n      const memberName = member.name.getText();\n      if (memberName !== '<anonymous>') {\n        const start = sourceFile.getLineAndCharacterOfPosition(member.getStart());\n        const end = sourceFile.getLineAndCharacterOfPosition(member.getEnd());\n        symbols.push({\n          name: memberName,\n          kind: 'method',\n          startLine: start.line + 1,\n          endLine: end.line + 1,\n          text: member.getText(sourceFile),\n          exported: false,\n        });\n      }\n    }\n  }\n}\n\nfunction computeSavings(totalChars: number, symbolChars: number): number {\n  return totalChars > 0 ? Math.round(100 * (1 - symbolChars / totalChars) * 10) / 10 : 0;\n}\n\n/**\n * Extract symbols from a TypeScript/JavaScript file.\n */\nexport async function extractSymbols(filePath: string): Promise<SymbolExtractionResult> {\n  const ext = extname(filePath).toLowerCase();\n  if (!['.ts', '.tsx', '.js', '.jsx'].includes(ext)) {\n    return {\n      filePath,\n      symbols: [],\n      totalLines: 0,\n      totalChars: 0,\n      symbolChars: 0,\n      savingsPercent: 0,\n    };\n  }\n\n  const source = await readFile(filePath, 'utf-8');\n  const sourceFile = ts.createSourceFile(filePath, source, ts.ScriptTarget.Latest, true);\n  const symbols: CodeSymbol[] = [];\n\n  ts.forEachChild(sourceFile, (node) => {\n    visitNode(node, sourceFile, symbols);\n  });\n\n  const totalChars = source.length;\n  const symbolChars = symbols.reduce((sum, s) => sum + s.text.length, 0);\n\n  return {\n    filePath,\n    symbols,\n    totalLines: source.split('\\n').length,\n    totalChars,\n    symbolChars,\n    savingsPercent: computeSavings(totalChars, symbolChars),\n  };\n}\n\n/**\n * Extract a compact symbol index (names + locations only, no source text).\n * This is the minimal representation for LLM context — ~95%+ token savings.\n */\nexport async function extractSymbolIndex(filePath: string): Promise<string> {\n  const result = await extractSymbols(filePath);\n  if (result.symbols.length === 0) return '';\n\n  const lines = result.symbols.map((s) => {\n    const exp = s.exported ? 'export ' : '';\n    return `${exp}${s.kind} ${s.name} (L${String(s.startLine)}-${String(s.endLine)})`;\n  });\n\n  return `// ${filePath} — ${String(result.symbols.length)} symbols\\n${lines.join('\\n')}`;\n}\n"],"mappings":"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","names":["extname","extname"]}

package/dist/{chunk-RQNBJ7AS.js → chunk-Z4AWOPXA.js}

@@ -5,7 +5,7 @@ import {
   getErrorMessage,
   getTimeProvider,
   ok
-} from "./chunk-OKAHIWG4.js";
+} from "./chunk-GVTXP6F6.js";
 
 // src/cli-adapters/circuit-breaker-types.ts
 var CircuitErrorCode = {
@@ -375,4 +375,4 @@ export {
   mapCliErrorToCategory,
   mapModelErrorToCategory
 };
-//# sourceMappingURL=chunk-RQNBJ7AS.js.map
+//# sourceMappingURL=chunk-Z4AWOPXA.js.map

package/dist/{chunk-CJLMB7MO.js → chunk-ZW7544DX.js}

@@ -7,7 +7,7 @@ import {
   toolStructuredError,
   toolSuccessStructured,
   wrapToolWithTimeout
-} from "./chunk-G7NDNFIE.js";
+} from "./chunk-DDQXPARJ.js";
 import {
   JsonlStore,
   SECURITY_KEYWORDS,
@@ -19,7 +19,7 @@ import {
   getPipelineEventBus,
   getTimeProvider,
   isDeclaredNeverDeprecate
-} from "./chunk-OKAHIWG4.js";
+} from "./chunk-GVTXP6F6.js";
 import {
   getNexusDataDir,
   nexusDataPath
@@ -2132,4 +2132,4 @@ export {
   runImprovementReview,
   registerImprovementReviewTool
 };
-//# sourceMappingURL=chunk-CJLMB7MO.js.map
+//# sourceMappingURL=chunk-ZW7544DX.js.map

package/dist/{cli-circuit-breaker-JDGZ25MD.js → cli-circuit-breaker-4GJA2IXC.js}

@@ -1,9 +1,9 @@
 import {
   CliCircuitBreakerIntegration,
   createCliCircuitBreakerIntegration
-} from "./chunk-HZNOSJOO.js";
-import "./chunk-RQNBJ7AS.js";
-import "./chunk-OKAHIWG4.js";
+} from "./chunk-57RYP435.js";
+import "./chunk-Z4AWOPXA.js";
+import "./chunk-GVTXP6F6.js";
 import "./chunk-AXTD4TFK.js";
 import "./chunk-DHVMSIT5.js";
 import "./chunk-ZPWHCABL.js";
@@ -11,4 +11,4 @@ export {
   CliCircuitBreakerIntegration,
   createCliCircuitBreakerIntegration
 };
-//# sourceMappingURL=cli-circuit-breaker-JDGZ25MD.js.map
+//# sourceMappingURL=cli-circuit-breaker-4GJA2IXC.js.map

package/dist/cli.js

@@ -13,13 +13,13 @@ import {
   generateSummary,
   parseFindings,
   sumFindings
-} from "./chunk-EQLJYWLP.js";
-import "./chunk-CPS2HN4T.js";
+} from "./chunk-OFVUBY6Z.js";
+import "./chunk-LDZEYJP3.js";
 import {
   setupCommandAsync,
   verifyCommand
-} from "./chunk-I3LGUSZ3.js";
-import "./chunk-6ERIC5NJ.js";
+} from "./chunk-P4PLZZCR.js";
+import "./chunk-HTM32H2E.js";
 import {
   AuthHandler,
   DEFAULT_EXPERTS,
@@ -119,6 +119,7 @@ import {
   registerRunTool,
   registerRunWorkflowTool,
   registerSearchCodebaseTool,
+  registerSearchUsagesTool,
   registerSuggestResearchTasksTool,
   registerSupplyChainTradeoffPanelTool,
   registerSurveyOssLandscapeTool,
@@ -138,10 +139,10 @@ import {
   validateCommand,
   validateWorkflow,
   wrapInMarkdownFence
-} from "./chunk-52T2MJDS.js";
-import "./chunk-N56C2MWI.js";
+} from "./chunk-QMOJJ6A2.js";
+import "./chunk-JYDXHV4L.js";
 import "./chunk-HFOQKCD2.js";
-import "./chunk-AO4X3BMP.js";
+import "./chunk-YF35FKKD.js";
 import {
   CATEGORY_DISPLAY_NAMES,
   DEFAULT_PR_REVIEW_CONFIG
@@ -165,15 +166,15 @@ import {
   loadConfig,
   runDoctor,
   validateNexusEnv
-} from "./chunk-P7RBQUAG.js";
+} from "./chunk-BGV3IF3G.js";
 import {
   buildOpenAICompatAdapters,
   readOpenAICompatEnv
-} from "./chunk-OLCDGMEO.js";
-import "./chunk-HZNOSJOO.js";
+} from "./chunk-OIT75IRK.js";
+import "./chunk-57RYP435.js";
 import {
   shutdownExpertBridge
-} from "./chunk-GNCUZDQI.js";
+} from "./chunk-75AUSQL4.js";
 import {
   ConsensusVoteInputSchema,
   DEFAULT_VOTE_TIMEOUT_MS,
@@ -183,25 +184,25 @@ import {
   executeVoting,
   mapOutcomeToDecision,
   registerConsensusVoteTool
-} from "./chunk-ELWMGKVP.js";
+} from "./chunk-LOKT6EW7.js";
 import {
   loadUsageEvents,
   rollupByModel
-} from "./chunk-TORS5V2C.js";
+} from "./chunk-NXSY4G4Y.js";
 import {
   synthesizeResearch
-} from "./chunk-3KID7AIF.js";
+} from "./chunk-6TN2Z2AQ.js";
 import {
   classifyTrust,
   createFullGitHubProvider,
   evaluatePolicy,
   parsePRUrl
-} from "./chunk-TZK7VQAW.js";
-import "./chunk-F5JDQXHJ.js";
+} from "./chunk-WKW5SEP7.js";
+import "./chunk-C6IAXFNC.js";
 import {
   ReputationCache,
   sanitizeInput
-} from "./chunk-UN7PYUJB.js";
+} from "./chunk-DEE2UTYV.js";
 import {
   ImprovementReviewInputSchema,
   calculateFitnessScore,
@@ -215,11 +216,11 @@ import {
   registerImprovementReviewTool,
   runImprovementReview,
   scanForSecrets
-} from "./chunk-CJLMB7MO.js";
+} from "./chunk-ZW7544DX.js";
 import {
   createDefaultPolicyFirewall
-} from "./chunk-G7NDNFIE.js";
-import "./chunk-RJHLNI37.js";
+} from "./chunk-DDQXPARJ.js";
+import "./chunk-OYBAKU7N.js";
 import {
   CodebaseIndexSchema,
   PaperStatusSchema,
@@ -245,31 +246,31 @@ import {
   loadSourcesRegistry,
   rankDiscoveredItems,
   saveSourcesRegistry
-} from "./chunk-HJA3Z56H.js";
+} from "./chunk-URRNWRI4.js";
 import {
   resolveToken
-} from "./chunk-IAGLVGHN.js";
+} from "./chunk-5N5XURKV.js";
 import {
   loadPapersRegistry,
   loadTechniquesRegistry,
   savePapersRegistry
-} from "./chunk-5LPPJIZ4.js";
+} from "./chunk-RZJQZ5P3.js";
 import "./chunk-NUBSJGQZ.js";
 import {
   MemoryError,
   shutdownToolMemory
-} from "./chunk-2ANAH2UU.js";
+} from "./chunk-MG4JBADQ.js";
 import {
   capitalize,
   capitalizeKebab
 } from "./chunk-6T3EPABN.js";
-import "./chunk-MX3XD2ML.js";
+import "./chunk-PIODB4SW.js";
 import "./chunk-ZM4O442V.js";
 import "./chunk-PINS44XA.js";
 import "./chunk-KSQSWEFH.js";
 import {
   createUnifiedRegistry
-} from "./chunk-ETFCT2CH.js";
+} from "./chunk-RJDJMOX6.js";
 import {
   NEXUS_SUBPROCESS_DEPTH_ENV,
   createAllAdapters,
@@ -277,15 +278,15 @@ import {
   isRecord,
   probeAllClis,
   readSubprocessDepth
-} from "./chunk-7IUVW67T.js";
-import "./chunk-MSBYVBPX.js";
+} from "./chunk-SCHD7NZD.js";
+import "./chunk-JOYOOEPJ.js";
 import {
   DEFAULTS
-} from "./chunk-VQE3OSUW.js";
-import "./chunk-RQNBJ7AS.js";
-import "./chunk-UGJRDFMN.js";
+} from "./chunk-JLG5AUZB.js";
+import "./chunk-Z4AWOPXA.js";
+import "./chunk-UXXNNT5D.js";
 import "./chunk-QZUG667L.js";
-import "./chunk-2Z4QECP7.js";
+import "./chunk-DCXCVEZP.js";
 import {
   API_TIMEOUTS,
   AgentCapability,
@@ -359,7 +360,7 @@ import {
   validateTimeout,
   writeEmptyLine,
   writeLine
-} from "./chunk-OKAHIWG4.js";
+} from "./chunk-GVTXP6F6.js";
 import "./chunk-AXTD4TFK.js";
 import {
   applyPortableMode,
@@ -4037,7 +4038,7 @@ ${file.patch}
         violations: policyResult.violations
       });
     }
-    const { formatReviewComment: formatReviewComment2 } = await import("./pr-reviewer-helpers-HJRFRUZX.js");
+    const { formatReviewComment: formatReviewComment2 } = await import("./pr-reviewer-helpers-HDP24LGZ.js");
     const body = formatReviewComment2(result);
     const postResult = await provider.createReview(pr.prNumber, body, result.decision);
     if (!postResult.ok) {
@@ -17385,7 +17386,7 @@ function startImprovementReviewScheduler(options) {
   let running = false;
   const runOnce = async () => {
     try {
-      const { runImprovementReview: runImprovementReview2, ImprovementReviewInputSchema: ImprovementReviewInputSchema2 } = await import("./improvement-review-WYFGNEVP.js");
+      const { runImprovementReview: runImprovementReview2, ImprovementReviewInputSchema: ImprovementReviewInputSchema2 } = await import("./improvement-review-75OCZ5K7.js");
       const input = ImprovementReviewInputSchema2.parse({ fileIssues });
       const result = await runImprovementReview2(input, { logger: logger19 });
       logger19.info("Scheduled improvement_review complete", {
@@ -17962,6 +17963,7 @@ var HANDLER_TABLE = {
   verify_audit_chain: standardHandler("verify_audit_chain", registerVerifyAuditChainTool),
   extract_symbols: standardHandler("extract_symbols", registerExtractSymbolsTool),
   search_codebase: standardHandler("search_codebase", registerSearchCodebaseTool),
+  search_usages: standardHandler("search_usages", registerSearchUsagesTool),
   run_dev_pipeline: standardHandler("run_dev_pipeline", registerDevPipelineTool),
   run_pipeline: standardHandler("run_pipeline", registerPipelineTool),
   pr_review: (ctx) => {
@@ -19438,7 +19440,7 @@ function adaptConfigToLibrary(config) {
 }
 function createBeliefPromoter() {
   return async (event) => {
-    const { getToolMemory } = await import("./tool-memory-3W5NXR4P.js");
+    const { getToolMemory } = await import("./tool-memory-K6EYH3FQ.js");
     const tm = getToolMemory();
     await tm.recordBelief(
       `skill:${event.name}`,
@@ -20614,7 +20616,7 @@ async function handleResearchCommand(args) {
   }
 }
 async function handleRegistryCommand(args) {
-  const { registryCommand, isValidRegistrySubcommand, formatRegistryUsage } = await import("./registry-command-JCOZA7TM.js");
+  const { registryCommand, isValidRegistrySubcommand, formatRegistryUsage } = await import("./registry-command-PZY7HWKO.js");
   const subcommand = args.subcommand;
   if (!isValidRegistrySubcommand(subcommand)) {
     process.stdout.write(`${formatRegistryUsage()}
@@ -20662,7 +20664,7 @@ async function handleVerifyCommand(args) {
 async function handleDoctorCommand(args) {
   const exitCode = await doctorCommand({ fix: args.options.fix });
   if (args.options.deep) {
-    const { runDeepDiagnostics: runDeepDiagnostics2, formatDeepDiagnostics: formatDeepDiagnostics2 } = await import("./doctor-deep-QTBDR3VV.js");
+    const { runDeepDiagnostics: runDeepDiagnostics2, formatDeepDiagnostics: formatDeepDiagnostics2 } = await import("./doctor-deep-2N3F7EV6.js");
     const diag = runDeepDiagnostics2();
     process.stdout.write(formatDeepDiagnostics2(diag) + "\n");
   }
@@ -20712,7 +20714,7 @@ async function runInitPortableFlow(args) {
   return cliExit(result.success ? EXIT_CODES.SUCCESS : EXIT_CODES.SERVER_START_FAILED);
 }
 async function runInitOpencodeFlow(args) {
-  const { runInitOpencode } = await import("./init-opencode-CMGJ3TXZ.js");
+  const { runInitOpencode } = await import("./init-opencode-LDI5E5LW.js");
   const opencodePath = args.options.opencode;
   if (opencodePath === void 0 || opencodePath === "") {
     process.stderr.write("Error: --opencode requires a path argument.\n");
@@ -20738,7 +20740,7 @@ async function runInitOpencodeFlow(args) {
   return cliExit(EXIT_CODES.SUCCESS);
 }
 async function renderOpencodeValidate(opencodePath) {
-  const { runOpencodeValidate } = await import("./init-opencode-CMGJ3TXZ.js");
+  const { runOpencodeValidate } = await import("./init-opencode-LDI5E5LW.js");
   const result = await runOpencodeValidate(opencodePath);
   if (!result.ok) {
     process.stderr.write(`init --opencode --validate: ${result.reason ?? "failed"}
@@ -20777,7 +20779,7 @@ async function handleSetupCommandAsync(args) {
   return cliExitFromStatus(exitCode);
 }
 async function runCustomApiSetup(args) {
-  const { configureCustomApi } = await import("./setup-custom-api-MYN4EVT2.js");
+  const { configureCustomApi } = await import("./setup-custom-api-LMA445OB.js");
   const baseUrl = args.options.customApi;
   if (baseUrl === void 0) return EXIT_CODES.SERVER_START_FAILED;
   const input = {