codesift-mcp 0.9.0 → 0.9.10

package/dist/register-tool-groups/core/symbols.js

@@ -0,0 +1,338 @@
+import { z, zBool, zNum, lazySchema, OutputSchemas, checkTextStubHint } from "../shared.js";
+import { getSymbol, getSymbols, findAndShow, getContextBundle, formatRefsCompact, formatSymbolCompact, formatSymbolsCompact, formatBundleCompact, findReferences, findReferencesBatch, traceCallChain, impactAnalysis, traceRoute, goToDefinition, getTypeInfo, renameSymbol, getCallHierarchy, dispatchFormatter } from "../deps.js";
+import { zJsonArray } from "./schema.js";
+// Token diet (2026-07-10 tool-runtime-opt plan, Task 4): find_references' default
+// result cap. Telemetry showed find_references as the #2 token sink (605 calls /
+// 909K tok), most of it unbounded result sets on common symbol names. An explicit
+// higher max_refs opts out.
+const DEFAULT_MAX_REFS = 50;
+/**
+ * Sanitize a client-supplied `max_refs` into a usable slice length. zNum() only
+ * guarantees a finite number, so -1 or 2.5 reach the handler as-is: `slice(0, -1)`
+ * silently DROPS the last reference (and reports a nonsense `+${len+1} more`),
+ * and a fractional cap prints `+7.5 more`. Clamp to a whole number ≥ 0.
+ */
+function normalizeMaxRefs(raw) {
+    if (typeof raw !== "number" || !Number.isFinite(raw))
+        return DEFAULT_MAX_REFS;
+    return Math.max(0, Math.floor(raw));
+}
+export const CORE_SYMBOL_TOOL_ENTRIES = [
+    // --- Symbol retrieval ---
+    { order: 1454, definition: {
+            name: "get_symbol",
+            category: "symbols",
+            searchHint: "get retrieve single symbol source code by ID",
+            outputSchema: OutputSchemas.symbol,
+            description: "Get symbol by ID with source. Auto-prefetches children for classes. For batch: get_symbols. For context: get_context_bundle.",
+            schema: lazySchema(() => ({
+                repo: z.string().optional().describe("Repository identifier (default: auto-detected from CWD)"),
+                symbol_id: z.string().describe("Unique symbol identifier"),
+                include_related: zBool().describe("Include children/related symbols (default: true)"),
+            })),
+            handler: async (args) => {
+                const opts = {};
+                if (args.include_related != null)
+                    opts.include_related = args.include_related;
+                const symbolId = args.symbol_id;
+                const result = await getSymbol(args.repo, symbolId, opts);
+                if (!result) {
+                    // Telemetry: 24% of get_symbol calls return null (hallucinated IDs).
+                    // Suggest closest matches by name so the agent doesn't burn turns guessing.
+                    const { findSimilarSymbols } = await import("../../tools/symbol-tools.js");
+                    const similar = await findSimilarSymbols(args.repo, symbolId, 3);
+                    if (similar.length > 0) {
+                        const suggestions = similar.map((s) => `  ${s.id}  (${s.kind} ${s.name} @ ${s.file}:${s.start_line})`).join("\n");
+                        return `Symbol "${symbolId}" not found. Did you mean:\n${suggestions}`;
+                    }
+                    const hint = await checkTextStubHint(args.repo, "get_symbol", true);
+                    return hint ?? `Symbol "${symbolId}" not found. Use search_symbols(query=...) to discover available IDs.`;
+                }
+                let text = await formatSymbolCompact(result.symbol);
+                if (result.related && result.related.length > 0) {
+                    text += "\n\n--- children ---\n" + result.related.map((s) => `${s.kind} ${s.name}${s.signature ? s.signature : ""} [${s.file}:${s.start_line}]`).join("\n");
+                }
+                return text;
+            },
+        } },
+    { order: 1489, definition: {
+            name: "get_symbols",
+            category: "symbols",
+            searchHint: "batch get multiple symbols by IDs",
+            description: "Retrieve multiple symbols by ID in a single batch call",
+            schema: lazySchema(() => ({
+                repo: z.string().optional().describe("Repository identifier (default: auto-detected from CWD)"),
+                symbol_ids: z.union([
+                    z.array(z.string().trim().min(1)),
+                    zJsonArray(z.string().trim().min(1)),
+                ]).describe("Array of symbol identifiers. Can be passed as JSON string."),
+            })),
+            handler: async (args) => {
+                const ids = args.symbol_ids;
+                const syms = await getSymbols(args.repo, ids);
+                const output = await formatSymbolsCompact(syms);
+                // Surface fuzzy suggestions for missing IDs (telemetry: 26% zero rate).
+                let suggestions = "";
+                if (syms.length < ids.length) {
+                    const foundIds = new Set(syms.map((s) => s.id));
+                    const missing = ids.filter((id) => !foundIds.has(id));
+                    if (missing.length > 0) {
+                        const { findSimilarSymbols } = await import("../../tools/symbol-tools.js");
+                        const lines = [];
+                        for (const m of missing.slice(0, 5)) {
+                            const sims = await findSimilarSymbols(args.repo, m, 2);
+                            if (sims.length > 0) {
+                                lines.push(`  ${m} → ${sims.map((s) => s.id).join(", ")}`);
+                            }
+                            else {
+                                lines.push(`  ${m} → no similar symbols`);
+                            }
+                        }
+                        suggestions = `\n\n--- not found (${missing.length}) — suggestions ---\n${lines.join("\n")}`;
+                    }
+                }
+                const hint = await checkTextStubHint(args.repo, "get_symbols", syms.length === 0);
+                return (hint ? hint + output : output) + suggestions;
+            },
+        } },
+    { order: 1528, definition: {
+            name: "find_and_show",
+            category: "symbols",
+            searchHint: "find symbol by name show source code references",
+            description: "Find a symbol by name and show its source, optionally including references",
+            schema: lazySchema(() => ({
+                repo: z.string().optional().describe("Repository identifier (default: auto-detected from CWD)"),
+                query: z.string().describe("Symbol name or query to search for"),
+                include_refs: zBool().describe("Include locations that reference this symbol"),
+            })),
+            handler: async (args) => {
+                const result = await findAndShow(args.repo, args.query, args.include_refs);
+                if (!result)
+                    return null;
+                let text = await formatSymbolCompact(result.symbol);
+                if (result.references) {
+                    text += `\n\n--- references ---\n${await formatRefsCompact(result.references)}`;
+                }
+                return text;
+            },
+        } },
+    { order: 1548, definition: {
+            name: "get_context_bundle",
+            category: "symbols",
+            searchHint: "context bundle symbol imports siblings callers one call",
+            description: "Symbol + imports + siblings in one call. Saves 2-3 round-trips.",
+            schema: lazySchema(() => ({
+                repo: z.string().optional().describe("Repository identifier (default: auto-detected from CWD)"),
+                symbol_name: z.string().describe("Symbol name to find"),
+            })),
+            handler: async (args) => {
+                const bundle = await getContextBundle(args.repo, args.symbol_name);
+                if (!bundle)
+                    return null;
+                return formatBundleCompact(bundle);
+            },
+        } },
+    // --- References & call graph ---
+    { order: 1565, definition: {
+            name: "find_references",
+            category: "graph",
+            searchHint: "find references usages callers who uses symbol",
+            outputSchema: OutputSchemas.references,
+            description: "Find all references to a symbol. Pass symbol_names array for batch search. Capped at max_refs (default 50) — per symbol in batch mode; pass a higher value to see more.",
+            schema: lazySchema(() => ({
+                repo: z.string().optional().describe("Repository identifier (default: auto-detected from CWD)"),
+                symbol_name: z.string().trim().min(1).optional().describe("Name of the symbol to find references for"),
+                symbol_names: z.union([
+                    z.array(z.string().trim().min(1)),
+                    zJsonArray(z.string().trim().min(1)),
+                ]).optional()
+                    .describe("Array of symbol names for batch search (reads each file once). Can be JSON string."),
+                file_pattern: z.string().optional().describe("Glob pattern to filter files"),
+                max_refs: zNum().describe("Maximum number of references to return, per symbol (default 50). Negative/fractional values are clamped to a whole number ≥ 0."),
+            })),
+            handler: async (args) => {
+                const maxRefs = normalizeMaxRefs(args.max_refs);
+                const names = args.symbol_names;
+                if (names && names.length > 0) {
+                    // The batch path fans out over MANY symbols — it is the one that most
+                    // needs the cap, so apply it per symbol (return shape unchanged).
+                    const batch = await findReferencesBatch(args.repo, names, args.file_pattern);
+                    for (const name of Object.keys(batch)) {
+                        const refs = batch[name];
+                        if (refs && refs.length > maxRefs)
+                            batch[name] = refs.slice(0, maxRefs);
+                    }
+                    return batch;
+                }
+                if (typeof args.symbol_name !== "string" || args.symbol_name.trim().length === 0) {
+                    throw new Error("symbol_name or symbol_names is required");
+                }
+                const refs = await findReferences(args.repo, args.symbol_name, args.file_pattern);
+                const truncated = refs.length > maxRefs;
+                const shown = truncated ? refs.slice(0, maxRefs) : refs;
+                const output = await formatRefsCompact(shown);
+                const overflow = truncated ? `\n… +${refs.length - maxRefs} more (pass max_refs to see more)` : "";
+                const hint = await checkTextStubHint(args.repo, "find_references", refs.length === 0);
+                return (hint ? hint + output : output) + overflow;
+            },
+        } },
+    { order: 1589, definition: {
+            name: "trace_call_chain",
+            category: "graph",
+            searchHint: "trace call chain callers callees dependency graph mermaid react hooks",
+            outputSchema: OutputSchemas.callTree,
+            description: "Trace call chain: callers or callees. output_format='mermaid' for diagram. filter_react_hooks=true skips useState/useEffect etc. for cleaner React graphs.",
+            schema: lazySchema(() => ({
+                repo: z.string().optional().describe("Repository identifier (default: auto-detected from CWD)"),
+                symbol_name: z.string().describe("Name of the symbol to trace"),
+                direction: z.enum(["callers", "callees"]).describe("Trace direction"),
+                depth: zNum().describe("Maximum depth to traverse the call graph (default: 1)"),
+                include_source: zBool().describe("Include full source code of each symbol (default: false)"),
+                include_tests: zBool().describe("Include test files in trace results (default: false)"),
+                output_format: z.enum(["json", "mermaid"]).optional().describe("Output format: 'json' (default) or 'mermaid' (flowchart diagram)"),
+                filter_react_hooks: zBool().describe("Skip edges to React stdlib hooks (useState, useEffect, etc.) to reduce call graph noise in React codebases (default: false)"),
+            })),
+            handler: async (args) => {
+                const result = await traceCallChain(args.repo, args.symbol_name, args.direction, {
+                    depth: args.depth,
+                    include_source: args.include_source,
+                    include_tests: args.include_tests,
+                    output_format: args.output_format,
+                    filter_react_hooks: args.filter_react_hooks,
+                });
+                const output = dispatchFormatter("trace_call_chain", result);
+                const isEmpty = typeof result === "object" && result != null && "children" in result && Array.isArray(result.children) && result.children.length === 0;
+                const hint = await checkTextStubHint(args.repo, "trace_call_chain", isEmpty);
+                return hint ? hint + output : output;
+            },
+        } },
+    { order: 1619, definition: {
+            name: "impact_analysis",
+            category: "graph",
+            searchHint: "impact analysis blast radius git changes affected symbols",
+            outputSchema: OutputSchemas.impactAnalysis,
+            description: "Blast radius of git changes — affected symbols and files.",
+            schema: lazySchema(() => ({
+                repo: z.string().optional().describe("Repository identifier (default: auto-detected from CWD)"),
+                since: z.string().describe("Git ref to compare from (e.g. HEAD~3, commit SHA, branch)"),
+                depth: zNum().describe("Depth of dependency traversal"),
+                until: z.string().optional().describe("Git ref to compare to (defaults to HEAD)"),
+                include_source: zBool().describe("Include full source code of affected symbols (default: false)"),
+            })),
+            handler: async (args) => {
+                const result = await impactAnalysis(args.repo, args.since, {
+                    depth: args.depth,
+                    until: args.until,
+                    include_source: args.include_source,
+                });
+                return dispatchFormatter("impact_analysis", result);
+            },
+        } },
+    { order: 1761, definition: {
+            name: "trace_route",
+            category: "graph",
+            searchHint: "trace HTTP route handler API endpoint service database NestJS Express Next.js",
+            description: "Trace HTTP route → handler → service → DB. NestJS, Next.js, Express.",
+            schema: lazySchema(() => ({
+                repo: z.string().optional().describe("Repository identifier (default: auto-detected from CWD)"),
+                path: z.string().describe("URL path to trace (e.g. '/api/users', '/api/projects/:id')"),
+                output_format: z.enum(["json", "mermaid"]).optional().describe("Output format: 'json' (default) or 'mermaid' (sequence diagram)"),
+            })),
+            handler: async (args) => {
+                const result = await traceRoute(args.repo, args.path, args.output_format);
+                return dispatchFormatter("trace_route", result);
+            },
+        } },
+    { order: 1777, definition: {
+            name: "go_to_definition",
+            category: "lsp",
+            searchHint: "go to definition jump navigate LSP language server",
+            outputSchema: OutputSchemas.definition,
+            description: "Go to the definition of a symbol. Uses LSP when available for type-safe precision, falls back to index search.",
+            schema: lazySchema(() => ({
+                repo: z.string().optional().describe("Repository identifier (default: auto-detected from CWD)"),
+                symbol_name: z.string().describe("Symbol name to find definition of"),
+                file_path: z.string().optional().describe("File containing the symbol reference (for LSP precision)"),
+                line: zNum().describe("0-based line number of the reference"),
+                character: zNum().describe("0-based column of the reference"),
+            })),
+            handler: async (args) => {
+                const result = await goToDefinition(args.repo, args.symbol_name, args.file_path, args.line, args.character);
+                if (!result)
+                    return null;
+                const preview = result.preview ? `\n${result.preview}` : "";
+                return `${result.file}:${result.line + 1} (via ${result.via})${preview}`;
+            },
+        } },
+    { order: 1804, definition: {
+            name: "get_type_info",
+            category: "lsp",
+            searchHint: "type information hover documentation return type parameters LSP",
+            outputSchema: OutputSchemas.typeInfo,
+            description: "Get type info via LSP hover (return type, params, docs). Hint if LSP unavailable.",
+            schema: lazySchema(() => ({
+                repo: z.string().optional().describe("Repository identifier (default: auto-detected from CWD)"),
+                symbol_name: z.string().describe("Symbol name to get type info for"),
+                file_path: z.string().optional().describe("File containing the symbol"),
+                line: zNum().describe("0-based line number"),
+                character: zNum().describe("0-based column"),
+            })),
+            handler: (args) => getTypeInfo(args.repo, args.symbol_name, args.file_path, args.line, args.character),
+        } },
+    { order: 1826, definition: {
+            name: "rename_symbol",
+            category: "lsp",
+            searchHint: "rename symbol refactor LSP type-safe all files",
+            outputSchema: OutputSchemas.renameResult,
+            description: "Rename symbol across all files via LSP. Type-safe, updates imports/refs.",
+            schema: lazySchema(() => ({
+                repo: z.string().optional().describe("Repository identifier (default: auto-detected from CWD)"),
+                symbol_name: z.string().describe("Current name of the symbol to rename"),
+                new_name: z.string().describe("New name for the symbol"),
+                file_path: z.string().optional().describe("File containing the symbol"),
+                line: zNum().describe("0-based line number"),
+                character: zNum().describe("0-based column"),
+            })),
+            handler: (args) => renameSymbol(args.repo, args.symbol_name, args.new_name, args.file_path, args.line, args.character),
+        } },
+    { order: 1850, definition: {
+            name: "get_call_hierarchy",
+            category: "lsp",
+            searchHint: "call hierarchy incoming outgoing calls who calls what calls LSP callers callees",
+            outputSchema: OutputSchemas.callHierarchy,
+            description: "LSP call hierarchy: incoming + outgoing calls. Complements trace_call_chain.",
+            schema: lazySchema(() => ({
+                repo: z.string().optional().describe("Repository identifier (default: auto-detected from CWD)"),
+                symbol_name: z.string().describe("Symbol name to get call hierarchy for"),
+                file_path: z.string().optional().describe("File containing the symbol (for LSP precision)"),
+                line: zNum().describe("0-based line number"),
+                character: zNum().describe("0-based column"),
+            })),
+            handler: async (args) => {
+                const result = await getCallHierarchy(args.repo, args.symbol_name, args.file_path, args.line, args.character);
+                if (result.via === "unavailable") {
+                    return { ...result };
+                }
+                // Compact text format
+                const lines = [];
+                lines.push(`${result.symbol.kind} ${result.symbol.name} (${result.symbol.file}:${result.symbol.line})`);
+                if (result.incoming.length > 0) {
+                    lines.push(`\n--- incoming calls (${result.incoming.length}) ---`);
+                    for (const c of result.incoming) {
+                        lines.push(`  ${c.kind} ${c.name} (${c.file}:${c.line})`);
+                    }
+                }
+                if (result.outgoing.length > 0) {
+                    lines.push(`\n--- outgoing calls (${result.outgoing.length}) ---`);
+                    for (const c of result.outgoing) {
+                        lines.push(`  ${c.kind} ${c.name} (${c.file}:${c.line})`);
+                    }
+                }
+                if (result.incoming.length === 0 && result.outgoing.length === 0) {
+                    lines.push("\nNo incoming or outgoing calls found.");
+                }
+                return lines.join("\n");
+            },
+        } },
+];
+//# sourceMappingURL=symbols.js.map

package/dist/register-tool-groups/core/symbols.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"symbols.js","sourceRoot":"","sources":["../../../src/register-tool-groups/core/symbols.ts"],"names":[],"mappings":"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"}

package/dist/register-tool-groups/core.d.ts

@@ -0,0 +1,3 @@
+import type { ToolDefinitionEntry } from "./shared.js";
+export declare const CORE_TOOL_ENTRIES: ToolDefinitionEntry[];
+//# sourceMappingURL=core.d.ts.map

package/dist/register-tool-groups/core.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"core.d.ts","sourceRoot":"","sources":["../../src/register-tool-groups/core.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,aAAa,CAAC;AAEvD,eAAO,MAAM,iBAAiB,EAAE,mBAAmB,EAMlD,CAAC"}

package/dist/register-tool-groups/core.js

@@ -0,0 +1,12 @@
+import { CORE_INDEX_TOOL_ENTRIES } from "./core/index.js";
+import { CORE_BATCH_SEARCH_TOOL_ENTRIES, CORE_SEARCH_TOOL_ENTRIES } from "./core/search.js";
+import { CORE_SYMBOL_TOOL_ENTRIES } from "./core/symbols.js";
+import { CORE_META_TOOL_ENTRIES } from "./core/meta.js";
+export const CORE_TOOL_ENTRIES = [
+    ...CORE_INDEX_TOOL_ENTRIES,
+    ...CORE_SEARCH_TOOL_ENTRIES,
+    ...CORE_SYMBOL_TOOL_ENTRIES,
+    ...CORE_META_TOOL_ENTRIES,
+    ...CORE_BATCH_SEARCH_TOOL_ENTRIES,
+];
+//# sourceMappingURL=core.js.map

package/dist/register-tool-groups/core.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"core.js","sourceRoot":"","sources":["../../src/register-tool-groups/core.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,uBAAuB,EAAE,MAAM,iBAAiB,CAAC;AAC1D,OAAO,EAAE,8BAA8B,EAAE,wBAAwB,EAAE,MAAM,kBAAkB,CAAC;AAC5F,OAAO,EAAE,wBAAwB,EAAE,MAAM,mBAAmB,CAAC;AAC7D,OAAO,EAAE,sBAAsB,EAAE,MAAM,gBAAgB,CAAC;AAGxD,MAAM,CAAC,MAAM,iBAAiB,GAA0B;IACtD,GAAG,uBAAuB;IAC1B,GAAG,wBAAwB;IAC3B,GAAG,wBAAwB;IAC3B,GAAG,sBAAsB;IACzB,GAAG,8BAA8B;CAClC,CAAC"}

package/dist/register-tool-groups/deps.d.ts

@@ -0,0 +1,10 @@
+export { indexFolder, indexFile, indexRepo, listAllRepos, invalidateCache, getCodeIndex, searchSymbols, searchText, semanticSearch, getFileTree, getFileOutline, getRepoOutline, suggestQueries, getSymbol, getSymbols, findAndShow, findReferences, findReferencesBatch, findDeadCode, getContextBundle, formatRefsCompact, formatSymbolCompact, formatSymbolsCompact, formatBundleCompact, traceCallChain, traceComponentTree, analyzeHooks, analyzeRenders, buildContextGraph, auditCompilerReadiness, reactQuickstart, impactAnalysis, traceRoute, detectCommunities, assembleContext, getKnowledgeMap, diffOutline, changedSymbols, generateClaudeMd, codebaseRetrieval, analyzeComplexity, findClones, analyzeHotspots, crossRepoSearchSymbols, crossRepoFindReferences, searchPatterns, listPatterns, generateReport, goToDefinition, getTypeInfo, renameSymbol, getCallHierarchy, indexConversations, searchConversations, searchAllConversations, findConversationsForSymbol, scanSecrets, resolvePhpNamespace, tracePhpEvent, findPhpViews, resolvePhpService, phpSecurityScan, phpProjectAudit, yii3MigrationAudit, php8CompatCheck, analyzeYiiModules, analyzeYiiMigrations, analyzeYiiRbac, findPhp8MigrationCandidates, analyzePhpStanBaseline, analyzeYiiConsoleCommands, findYii3AttributeCandidates, consolidateMemories, readMemory, usageHotspots, usageTraceSession, retrosList, retrosAnalyze, memoryCandidateExtract, optimizationCandidates, popeInsightsPushCandidates, createAnalysisPlan, writeScratchpad, readScratchpad, listScratchpad, updateStepStatus, getPlan, listPlans, frequencyAnalysis, findExtensionFunctions, analyzeSealedHierarchy, traceSuspendChain, analyzeKmpDeclarations, traceFlowChain, traceHiltGraph, traceComposeTree, analyzeComposeRecomposition, traceRoomSchema, extractKotlinSerializationContract, astroAnalyzeIslands, astroHydrationAudit, astroRouteMap, astroActionsAudit, astroAudit, nextjsRouteMap, nextjsMetadataAudit, frameworkAudit, astroConfigAnalyze, astroContentCollections, astroMiddlewareAudit, astroSessionsAudit, astroDbAudit, astroEnvValidator, astroImageAudit, astroSvgComponents, analyzeProject, getExtractorVersions, getModelGraph, getTestFixtures, findFrameworkWiring, runRuff, parsePyproject, resolveConstantValue, effectiveDjangoViewSecurity, findPythonCallers, taintTrace, analyzeDjangoSettings, runMypy, runPyright, analyzePythonDeps, pythonAudit, traceFastAPIDepends, analyzeAsyncCorrectness, getPydanticModels, reviewDiff, auditScan, indexStatus, auditAgentConfig, testImpactAnalysis, dependencyAudit, migrationLint, planTurn, formatPlanTurnResult, astroMigrationCheck, analyzePrismaSchema, findPerfHotspots, fanInFanOut, coChangeAnalysis, architectureSummary, nestAudit, explainQuery, generateWiki, } from "../register-tool-loaders.js";
+export { getUsageStats, formatUsageReport } from "../storage/usage-stats.js";
+export { formatSnapshot, getContext, getSessionState } from "../storage/session-state.js";
+export { formatSearchSymbols, formatFileTree, formatFileOutline, formatSearchPatterns, formatDeadCode, formatComplexity, formatClones, formatHotspots, formatRepoOutline, formatSuggestQueries, formatSecrets, formatConversations, formatRoles, formatAssembleContext, formatCommunities, formatCallTree, formatTraceRoute, formatKnowledgeMap, formatImpactAnalysis, formatDiffOutline, formatChangedSymbols, formatReviewDiff, formatPerfHotspots, formatFanInFanOut, formatCoChange, formatArchitectureSummary, formatNextjsRouteMap, formatNextjsMetadataAudit, formatFrameworkAudit, } from "../formatters.js";
+export type { AuditDimension } from "../tools/nextjs-framework-audit-tools.js";
+export type { AuditScanOptions, AuditScanResult } from "../tools/audit-tools.js";
+export type { SecretSeverity } from "../tools/secret-tools.js";
+export type { SymbolKind, Direction } from "../types.js";
+export { dispatchFormatter } from "../formatter-dispatch.js";
+//# sourceMappingURL=deps.d.ts.map

package/dist/register-tool-groups/deps.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"deps.d.ts","sourceRoot":"","sources":["../../src/register-tool-groups/deps.ts"],"names":[],"mappings":"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"}

package/dist/register-tool-groups/deps.js

@@ -0,0 +1,6 @@
+export { indexFolder, indexFile, indexRepo, listAllRepos, invalidateCache, getCodeIndex, searchSymbols, searchText, semanticSearch, getFileTree, getFileOutline, getRepoOutline, suggestQueries, getSymbol, getSymbols, findAndShow, findReferences, findReferencesBatch, findDeadCode, getContextBundle, formatRefsCompact, formatSymbolCompact, formatSymbolsCompact, formatBundleCompact, traceCallChain, traceComponentTree, analyzeHooks, analyzeRenders, buildContextGraph, auditCompilerReadiness, reactQuickstart, impactAnalysis, traceRoute, detectCommunities, assembleContext, getKnowledgeMap, diffOutline, changedSymbols, generateClaudeMd, codebaseRetrieval, analyzeComplexity, findClones, analyzeHotspots, crossRepoSearchSymbols, crossRepoFindReferences, searchPatterns, listPatterns, generateReport, goToDefinition, getTypeInfo, renameSymbol, getCallHierarchy, indexConversations, searchConversations, searchAllConversations, findConversationsForSymbol, scanSecrets, resolvePhpNamespace, tracePhpEvent, findPhpViews, resolvePhpService, phpSecurityScan, phpProjectAudit, yii3MigrationAudit, php8CompatCheck, analyzeYiiModules, analyzeYiiMigrations, analyzeYiiRbac, findPhp8MigrationCandidates, analyzePhpStanBaseline, analyzeYiiConsoleCommands, findYii3AttributeCandidates, consolidateMemories, readMemory, usageHotspots, usageTraceSession, retrosList, retrosAnalyze, memoryCandidateExtract, optimizationCandidates, popeInsightsPushCandidates, createAnalysisPlan, writeScratchpad, readScratchpad, listScratchpad, updateStepStatus, getPlan, listPlans, frequencyAnalysis, findExtensionFunctions, analyzeSealedHierarchy, traceSuspendChain, analyzeKmpDeclarations, traceFlowChain, traceHiltGraph, traceComposeTree, analyzeComposeRecomposition, traceRoomSchema, extractKotlinSerializationContract, astroAnalyzeIslands, astroHydrationAudit, astroRouteMap, astroActionsAudit, astroAudit, nextjsRouteMap, nextjsMetadataAudit, frameworkAudit, astroConfigAnalyze, astroContentCollections, astroMiddlewareAudit, astroSessionsAudit, astroDbAudit, astroEnvValidator, astroImageAudit, astroSvgComponents, analyzeProject, getExtractorVersions, getModelGraph, getTestFixtures, findFrameworkWiring, runRuff, parsePyproject, resolveConstantValue, effectiveDjangoViewSecurity, findPythonCallers, taintTrace, analyzeDjangoSettings, runMypy, runPyright, analyzePythonDeps, pythonAudit, traceFastAPIDepends, analyzeAsyncCorrectness, getPydanticModels, reviewDiff, auditScan, indexStatus, auditAgentConfig, testImpactAnalysis, dependencyAudit, migrationLint, planTurn, formatPlanTurnResult, astroMigrationCheck, analyzePrismaSchema, findPerfHotspots, fanInFanOut, coChangeAnalysis, architectureSummary, nestAudit, explainQuery, generateWiki, } from "../register-tool-loaders.js";
+export { getUsageStats, formatUsageReport } from "../storage/usage-stats.js";
+export { formatSnapshot, getContext, getSessionState } from "../storage/session-state.js";
+export { formatSearchSymbols, formatFileTree, formatFileOutline, formatSearchPatterns, formatDeadCode, formatComplexity, formatClones, formatHotspots, formatRepoOutline, formatSuggestQueries, formatSecrets, formatConversations, formatRoles, formatAssembleContext, formatCommunities, formatCallTree, formatTraceRoute, formatKnowledgeMap, formatImpactAnalysis, formatDiffOutline, formatChangedSymbols, formatReviewDiff, formatPerfHotspots, formatFanInFanOut, formatCoChange, formatArchitectureSummary, formatNextjsRouteMap, formatNextjsMetadataAudit, formatFrameworkAudit, } from "../formatters.js";
+export { dispatchFormatter } from "../formatter-dispatch.js";
+//# sourceMappingURL=deps.js.map

package/dist/register-tool-groups/deps.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"deps.js","sourceRoot":"","sources":["../../src/register-tool-groups/deps.ts"],"names":[],"mappings":"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"}

package/dist/register-tool-groups/handler-wrappers.d.ts

@@ -0,0 +1,63 @@
+/**
+ * Reusable, server-agnostic wrappers for MCP tool handlers. Pure module (no
+ * server/registration imports) so it composes around any async handler and is
+ * unit-testable in isolation.
+ */
+type AnyArgs = readonly unknown[];
+/** Sentinel returned when a wrapped handler exceeds its time budget. */
+export interface TimeoutResult {
+    status: "timed_out";
+    tool?: string;
+}
+/**
+ * Resolve to a `TimeoutResult` if `handler` runs longer than `ms`; otherwise
+ * pass its value/rejection straight through. A slow handler that settles after
+ * the timeout is swallowed (no unhandled rejection); the timer is cleared on settle.
+ */
+export declare function withTimeout<A extends AnyArgs, R>(handler: (...args: A) => Promise<R>, ms: number, toolName?: string): (...args: A) => Promise<R | TimeoutResult>;
+/**
+ * A memoizing handler plus the two controls its caller needs to keep the cache
+ * honest: `has` (was this call served from cache?) and `evict` (drop the entry
+ * for these args).
+ */
+export interface CachedHandler<A extends AnyArgs, R> {
+    (...args: A): Promise<R>;
+    /**
+     * True iff a call with these args would be served WITHOUT invoking the
+     * handler (a completed entry, or an in-flight promise it would join). Lets a
+     * caller emit cache-hit telemetry / markers the handler itself can no longer
+     * emit (it never runs on a hit). Always false when `keyFn` returns null.
+     */
+    has: (...args: A) => boolean;
+    /**
+     * Drop the entry for these args. Needed because an entry is inserted BEFORE
+     * the handler settles: a handler that never settles would otherwise pin its
+     * pending promise forever, and every later identical call would join it and
+     * hang. The caller (which owns the timeout) evicts on timeout so the next call
+     * re-invokes. No-op when `keyFn` returns null or nothing is cached.
+     */
+    evict: (...args: A) => void;
+}
+/**
+ * Bounded LRU cache keyed by `keyFn(...args)`. A HIT invokes the handler zero
+ * extra times; concurrent same-key calls share ONE in-flight promise (single
+ * execution); rejections are NOT cached (entry removed on failure) so failures
+ * are retryable, not sticky.
+ *
+ * `keyFn` may return **null** to mean "this call is not cacheable" — the handler
+ * is invoked directly and the result is never memoized. Used when the caller
+ * cannot compute a trustworthy version component for the key: memoizing under a
+ * key that can never change would pin the entry for the life of the process.
+ *
+ * `shouldCache` (optional) additionally evicts *resolved* results that must not
+ * be memoized — e.g. an error response that a handler RESOLVES rather than
+ * rejects (`{ isError: true }`). Without it such a transient failure would stick
+ * in the cache until the key changes. In-flight coalescing is preserved:
+ * concurrent same-key calls still share the one promise; eviction only runs
+ * after it settles.
+ */
+export declare function withCache<A extends AnyArgs, R>(handler: (...args: A) => Promise<R>, keyFn: (...args: A) => string | null, maxEntries?: number, shouldCache?: (result: R) => boolean): CachedHandler<A, R>;
+/** Deterministic JSON with recursively sorted object keys (for stable cache keys). */
+export declare function stableStringify(value: unknown): string;
+export {};
+//# sourceMappingURL=handler-wrappers.d.ts.map

package/dist/register-tool-groups/handler-wrappers.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"handler-wrappers.d.ts","sourceRoot":"","sources":["../../src/register-tool-groups/handler-wrappers.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,KAAK,OAAO,GAAG,SAAS,OAAO,EAAE,CAAC;AAElC,wEAAwE;AACxE,MAAM,WAAW,aAAa;IAC5B,MAAM,EAAE,WAAW,CAAC;IACpB,IAAI,CAAC,EAAE,MAAM,CAAC;CACf;AAED;;;;GAIG;AACH,wBAAgB,WAAW,CAAC,CAAC,SAAS,OAAO,EAAE,CAAC,EAC9C,OAAO,EAAE,CAAC,GAAG,IAAI,EAAE,CAAC,KAAK,OAAO,CAAC,CAAC,CAAC,EACnC,EAAE,EAAE,MAAM,EACV,QAAQ,CAAC,EAAE,MAAM,GAChB,CAAC,GAAG,IAAI,EAAE,CAAC,KAAK,OAAO,CAAC,CAAC,GAAG,aAAa,CAAC,CA2B5C;AAED;;;;GAIG;AACH,MAAM,WAAW,aAAa,CAAC,CAAC,SAAS,OAAO,EAAE,CAAC;IACjD,CAAC,GAAG,IAAI,EAAE,CAAC,GAAG,OAAO,CAAC,CAAC,CAAC,CAAC;IACzB;;;;;OAKG;IACH,GAAG,EAAE,CAAC,GAAG,IAAI,EAAE,CAAC,KAAK,OAAO,CAAC;IAC7B;;;;;;OAMG;IACH,KAAK,EAAE,CAAC,GAAG,IAAI,EAAE,CAAC,KAAK,IAAI,CAAC;CAC7B;AAED;;;;;;;;;;;;;;;;;GAiBG;AACH,wBAAgB,SAAS,CAAC,CAAC,SAAS,OAAO,EAAE,CAAC,EAC5C,OAAO,EAAE,CAAC,GAAG,IAAI,EAAE,CAAC,KAAK,OAAO,CAAC,CAAC,CAAC,EACnC,KAAK,EAAE,CAAC,GAAG,IAAI,EAAE,CAAC,KAAK,MAAM,GAAG,IAAI,EACpC,UAAU,SAAM,EAChB,WAAW,CAAC,EAAE,CAAC,MAAM,EAAE,CAAC,KAAK,OAAO,GACnC,aAAa,CAAC,CAAC,EAAE,CAAC,CAAC,CA8CrB;AAED,sFAAsF;AACtF,wBAAgB,eAAe,CAAC,KAAK,EAAE,OAAO,GAAG,MAAM,CAUtD"}

package/dist/register-tool-groups/handler-wrappers.js

@@ -0,0 +1,106 @@
+/**
+ * Reusable, server-agnostic wrappers for MCP tool handlers. Pure module (no
+ * server/registration imports) so it composes around any async handler and is
+ * unit-testable in isolation.
+ */
+/**
+ * Resolve to a `TimeoutResult` if `handler` runs longer than `ms`; otherwise
+ * pass its value/rejection straight through. A slow handler that settles after
+ * the timeout is swallowed (no unhandled rejection); the timer is cleared on settle.
+ */
+export function withTimeout(handler, ms, toolName) {
+    return (...args) => new Promise((resolve, reject) => {
+        let settled = false;
+        const timer = setTimeout(() => {
+            if (settled)
+                return;
+            settled = true;
+            resolve(toolName !== undefined ? { status: "timed_out", tool: toolName } : { status: "timed_out" });
+        }, ms);
+        // Attach an onRejected handler so a late rejection after timeout is swallowed (never unhandled).
+        handler(...args).then((value) => {
+            if (settled)
+                return;
+            settled = true;
+            clearTimeout(timer);
+            resolve(value);
+        }, (err) => {
+            if (settled)
+                return; // abandoned after timeout — swallow.
+            settled = true;
+            clearTimeout(timer);
+            reject(err instanceof Error ? err : new Error(String(err)));
+        });
+    });
+}
+/**
+ * Bounded LRU cache keyed by `keyFn(...args)`. A HIT invokes the handler zero
+ * extra times; concurrent same-key calls share ONE in-flight promise (single
+ * execution); rejections are NOT cached (entry removed on failure) so failures
+ * are retryable, not sticky.
+ *
+ * `keyFn` may return **null** to mean "this call is not cacheable" — the handler
+ * is invoked directly and the result is never memoized. Used when the caller
+ * cannot compute a trustworthy version component for the key: memoizing under a
+ * key that can never change would pin the entry for the life of the process.
+ *
+ * `shouldCache` (optional) additionally evicts *resolved* results that must not
+ * be memoized — e.g. an error response that a handler RESOLVES rather than
+ * rejects (`{ isError: true }`). Without it such a transient failure would stick
+ * in the cache until the key changes. In-flight coalescing is preserved:
+ * concurrent same-key calls still share the one promise; eviction only runs
+ * after it settles.
+ */
+export function withCache(handler, keyFn, maxEntries = 256, shouldCache) {
+    const cache = new Map();
+    const call = (...args) => {
+        const key = keyFn(...args);
+        if (key === null)
+            return handler(...args); // uncacheable call — never memoized
+        const hit = cache.get(key);
+        if (hit !== undefined) {
+            // Refresh recency (LRU): re-insert at the end of Map order.
+            cache.delete(key);
+            cache.set(key, hit);
+            return hit;
+        }
+        const pending = handler(...args);
+        cache.set(key, pending);
+        // Drop failed entries on rejection, AND drop resolved-but-uncacheable
+        // results (shouldCache=false). The awaiter still sees the outcome via the
+        // returned `pending`; this side chain only manages retention.
+        pending.then((value) => {
+            if (shouldCache && !shouldCache(value) && cache.get(key) === pending) {
+                cache.delete(key);
+            }
+        }, () => {
+            if (cache.get(key) === pending)
+                cache.delete(key);
+        });
+        while (cache.size > maxEntries) {
+            const oldest = cache.keys().next().value; // evict oldest beyond cap
+            if (oldest === undefined)
+                break;
+            cache.delete(oldest);
+        }
+        return pending;
+    };
+    return Object.assign(call, {
+        has: (...args) => {
+            const key = keyFn(...args);
+            return key !== null && cache.has(key);
+        },
+        evict: (...args) => {
+            const key = keyFn(...args);
+            if (key !== null)
+                cache.delete(key);
+        },
+    });
+}
+/** Deterministic JSON with recursively sorted object keys (for stable cache keys). */
+export function stableStringify(value) {
+    return JSON.stringify(value, (_key, val) => val && typeof val === "object" && !Array.isArray(val)
+        ? Object.fromEntries(Object.entries(val).sort(([a], [b]) => a < b ? -1 : a > b ? 1 : 0))
+        : val);
+}
+//# sourceMappingURL=handler-wrappers.js.map

package/dist/register-tool-groups/handler-wrappers.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"handler-wrappers.js","sourceRoot":"","sources":["../../src/register-tool-groups/handler-wrappers.ts"],"names":[],"mappings":"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"}