sdlc-agent-4-enterprise-server 1.0.0

package/dist/engine/tools/call-graph-tools.js

@@ -0,0 +1,95 @@
+/**
+ * KSA-154: MCP Tool Registration for code_callers and code_callees.
+ */
+import { GraphRepository } from '../database/graph-repository.js';
+import { SymbolResolver } from '../graph/symbol-resolver.js';
+import { CallGraphService } from '../graph/call-graph-service.js';
+export const CALL_GRAPH_TOOL_DEFINITIONS = [
+    {
+        name: 'code_callers',
+        description: 'Find all callers of a function/method with transitive depth control. Supports qualified names (Class.method) and file:symbol format.',
+        inputSchema: {
+            type: 'object',
+            properties: {
+                symbol: { type: 'string', description: 'Symbol name to find callers for (e.g. "processData", "MyClass.method", "src/utils:helper")' },
+                depth: { type: 'number', description: 'Transitive depth (1-5, default 1)' },
+                limit: { type: 'number', description: 'Max results (default 20)' },
+                file_filter: { type: 'string', description: 'Filter results by file path pattern (glob)' },
+                kind_filter: { type: 'string', description: 'Relationship kind filter (default: calls)' },
+            },
+            required: ['symbol'],
+        },
+    },
+    {
+        name: 'code_callees',
+        description: 'Find all functions/methods called by a given symbol with transitive depth.',
+        inputSchema: {
+            type: 'object',
+            properties: {
+                symbol: { type: 'string', description: 'Symbol name to find callees for' },
+                depth: { type: 'number', description: 'Transitive depth (1-5, default 1)' },
+                limit: { type: 'number', description: 'Max results (default 20)' },
+                file_filter: { type: 'string', description: 'Filter results by file path pattern (glob)' },
+                include_external: { type: 'boolean', description: 'Include external/unresolved callees (default true)' },
+            },
+            required: ['symbol'],
+        },
+    },
+];
+export function handleCodeCallers(args, db) {
+    const symbol = args.symbol;
+    if (!symbol)
+        return JSON.stringify({ error: 'Parameter "symbol" is required' });
+    const depth = args.depth ?? 1;
+    const limit = args.limit ?? 20;
+    const fileFilter = args.file_filter;
+    const kindFilter = args.kind_filter ?? 'calls';
+    const graphRepo = new GraphRepository(db);
+    const resolver = new SymbolResolver(db);
+    const service = new CallGraphService(graphRepo, resolver);
+    const result = service.findCallers(symbol, depth, limit, fileFilter, kindFilter);
+    return formatCallGraphResult(result, 'callers');
+}
+export function handleCodeCallees(args, db) {
+    const symbol = args.symbol;
+    if (!symbol)
+        return JSON.stringify({ error: 'Parameter "symbol" is required' });
+    const depth = args.depth ?? 1;
+    const limit = args.limit ?? 20;
+    const fileFilter = args.file_filter;
+    const includeExternal = args.include_external ?? true;
+    const graphRepo = new GraphRepository(db);
+    const resolver = new SymbolResolver(db);
+    const service = new CallGraphService(graphRepo, resolver);
+    const result = service.findCallees(symbol, depth, limit, fileFilter, includeExternal);
+    return formatCallGraphResult(result, 'callees');
+}
+function formatCallGraphResult(result, direction) {
+    if (result.results.length === 0 && result.resolvedTo.length === 0) {
+        const suggestions = result.suggestions;
+        if (suggestions && suggestions.length > 0) {
+            return `Symbol "${result.symbol}" not found. Did you mean: ${suggestions.join(', ')}?`;
+        }
+        return `Symbol "${result.symbol}" not found in index.`;
+    }
+    if (result.results.length === 0) {
+        return `No ${direction} found for "${result.symbol}" (resolved to ${result.resolvedTo.length} definition(s))`;
+    }
+    const lines = [];
+    lines.push(`${direction === 'callers' ? 'Callers' : 'Callees'} of "${result.symbol}" (depth ${result.metadata.depthSearched}):\n`);
+    if (result.resolvedTo.length > 0) {
+        lines.push(`Resolved to:`);
+        for (const r of result.resolvedTo) {
+            lines.push(`  [${r.kind}] ${r.file}:${r.line}`);
+        }
+        lines.push('');
+    }
+    for (const item of result.results) {
+        const prefix = '  '.repeat(item.depthLevel);
+        lines.push(`${prefix}[${item.kind}] ${item.qualifiedName}`);
+        lines.push(`${prefix}  ${item.filePath}:${item.callSiteLine} (def: L${item.definitionLine})`);
+    }
+    lines.push(`\n--- ${result.metadata.totalCount} results | ${result.metadata.queryTimeMs}ms${result.metadata.truncated ? ' | TRUNCATED' : ''}`);
+    return lines.join('\n');
+}
+//# sourceMappingURL=call-graph-tools.js.map

package/dist/engine/tools/call-graph-tools.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"call-graph-tools.js","sourceRoot":"","sources":["../../../src/engine/tools/call-graph-tools.ts"],"names":[],"mappings":"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"}

package/dist/engine/tools/code-context.d.ts

@@ -0,0 +1,7 @@
+/**
+ * code_context tool — Get surrounding context for a symbol or file region.
+ * Reads actual source code lines around a symbol definition.
+ */
+import { McpServer } from '@modelcontextprotocol/sdk/server/mcp.js';
+import { QueryLayer } from '../query/query-layer.js';
+export declare function registerCodeContext(server: McpServer, queryLayer: QueryLayer, workspace: string): void;

package/dist/engine/tools/code-context.js

@@ -0,0 +1,48 @@
+/**
+ * code_context tool — Get surrounding context for a symbol or file region.
+ * Reads actual source code lines around a symbol definition.
+ */
+import * as fs from 'fs';
+import * as path from 'path';
+import { z } from 'zod';
+export function registerCodeContext(server, queryLayer, workspace) {
+    server.tool('code_context', 'Get source code context around a symbol or line range. Returns actual code lines from the file.', {
+        file: z.string().describe('Relative file path'),
+        symbol: z.string().optional().describe('Symbol name to find in file'),
+        startLine: z.number().optional().describe('Start line (1-based)'),
+        endLine: z.number().optional().describe('End line (1-based)'),
+        contextLines: z.number().optional().default(5).describe('Extra lines above/below'),
+    }, async ({ file, symbol, startLine, endLine, contextLines }) => {
+        const text = getContext(workspace, file, symbol, startLine, endLine, contextLines, queryLayer);
+        return { content: [{ type: 'text', text }] };
+    });
+}
+function getContext(workspace, file, symbol, startLine, endLine, contextLines, queryLayer) {
+    const fullPath = path.resolve(workspace, file);
+    if (!fs.existsSync(fullPath))
+        return `File not found: ${file}`;
+    const content = fs.readFileSync(fullPath, 'utf-8');
+    const lines = content.split('\n');
+    if (symbol) {
+        return getSymbolContext(file, symbol, lines, contextLines, queryLayer);
+    }
+    const start = Math.max(0, (startLine ?? 1) - 1 - contextLines);
+    const end = Math.min(lines.length, (endLine ?? startLine ?? lines.length) + contextLines);
+    return formatLines(lines, start, end, file);
+}
+function getSymbolContext(file, symbol, lines, contextLines, queryLayer) {
+    const symbols = queryLayer.getFileSymbols(file);
+    const match = symbols.find(s => s.name === symbol);
+    if (!match)
+        return `Symbol "${symbol}" not found in ${file}`;
+    const start = Math.max(0, match.startLine - 1 - contextLines);
+    const end = Math.min(lines.length, match.endLine + contextLines);
+    return formatLines(lines, start, end, file);
+}
+function formatLines(lines, start, end, file) {
+    const numbered = lines
+        .slice(start, end)
+        .map((line, i) => `${String(start + i + 1).padStart(4)} | ${line}`);
+    return `// ${file} [${start + 1}-${end}]\n${numbered.join('\n')}`;
+}
+//# sourceMappingURL=code-context.js.map

package/dist/engine/tools/code-context.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"code-context.js","sourceRoot":"","sources":["../../../src/engine/tools/code-context.ts"],"names":[],"mappings":"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"}

package/dist/engine/tools/code-index-status.d.ts

@@ -0,0 +1,8 @@
+/**
+ * code_index_status tool — Show indexing statistics and health.
+ * KSA-191: Enhanced with SFDX stats section when Salesforce project detected.
+ */
+import { McpServer } from '@modelcontextprotocol/sdk/server/mcp.js';
+import { QueryLayer } from '../query/query-layer.js';
+import { IndexingEngine } from '../indexer/indexing-engine.js';
+export declare function registerCodeIndexStatus(server: McpServer, queryLayer: QueryLayer, indexer: IndexingEngine): void;

package/dist/engine/tools/code-index-status.js

@@ -0,0 +1,63 @@
+/**
+ * code_index_status tool — Show indexing statistics and health.
+ * KSA-191: Enhanced with SFDX stats section when Salesforce project detected.
+ */
+import { z } from 'zod';
+export function registerCodeIndexStatus(server, queryLayer, indexer) {
+    server.tool('code_index_status', 'Get current indexing status: file count, symbol count, languages, last indexed time, indexer state, and SFDX stats (if Salesforce project detected).', {
+        reindex: z.boolean().optional().default(false).describe('Trigger a full re-index'),
+    }, async ({ reindex }) => {
+        if (reindex) {
+            await indexer.runFullIndex();
+        }
+        const status = queryLayer.getIndexStatus();
+        const sfdxStats = indexer.getSfdxStats();
+        const tsStats = indexer.getTreeSitterStats();
+        const text = formatStatus(status, indexer.isRunning(), sfdxStats, tsStats);
+        return { content: [{ type: 'text', text }] };
+    });
+}
+function formatStatus(status, isRunning, sfdxStats, tsStats) {
+    const lines = [
+        '\u{1F4CA} Code Intelligence Index Status\n',
+        `State: ${isRunning ? '\u{1F504} Indexing...' : '\u{2705} Idle'}`,
+        `Files: ${status.totalFiles}`,
+        `Symbols: ${status.totalSymbols}`,
+        `Modules: ${status.totalModules}`,
+        `Last indexed: ${status.lastIndexed ?? 'Never'}`,
+        '',
+        'Languages:',
+    ];
+    for (const [lang, count] of Object.entries(status.languages)) {
+        lines.push(`  ${lang}: ${count} files`);
+    }
+    // KSA-191: SFDX stats section
+    if (sfdxStats) {
+        lines.push('');
+        lines.push('\u{26A1} Salesforce (SFDX):');
+        lines.push(`  Detected: ${sfdxStats.detected}`);
+        lines.push(`  Package directories: ${sfdxStats.packageDirectories.join(', ')}`);
+        lines.push(`  Apex classes: ${sfdxStats.stats.apex_classes}`);
+        lines.push(`  Apex triggers: ${sfdxStats.stats.apex_triggers}`);
+        lines.push(`  Flows: ${sfdxStats.stats.flows}`);
+        lines.push(`  Objects: ${sfdxStats.stats.objects}`);
+        lines.push(`  LWC components: ${sfdxStats.stats.lwc_components}`);
+        if (sfdxStats.lastIndexed) {
+            lines.push(`  Last indexed: ${sfdxStats.lastIndexed}`);
+        }
+        const relEntries = Object.entries(sfdxStats.relationships);
+        if (relEntries.length > 0) {
+            lines.push('  Relationships:');
+            for (const [kind, count] of relEntries) {
+                lines.push(`    ${kind}: ${count}`);
+            }
+        }
+    }
+    // KSA-209: Unavailable grammars warning
+    if (tsStats.unavailableGrammars.length > 0) {
+        lines.push('');
+        lines.push(`\u{26A0}\u{FE0F} Unavailable grammars (WASM missing \u{2014} using regex fallback): ${tsStats.unavailableGrammars.join(', ')}`);
+    }
+    return lines.join('\n');
+}
+//# sourceMappingURL=code-index-status.js.map

package/dist/engine/tools/code-index-status.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"code-index-status.js","sourceRoot":"","sources":["../../../src/engine/tools/code-index-status.ts"],"names":[],"mappings":"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"}

package/dist/engine/tools/code-kb-export.d.ts

@@ -0,0 +1,7 @@
+/**
+ * code_kb_export tool — Export code intelligence data as KB payloads.
+ * Returns structured data ready for kb_ingest consumption.
+ */
+import { McpServer } from '@modelcontextprotocol/sdk/server/mcp.js';
+import { QueryLayer } from '../query/query-layer.js';
+export declare function registerCodeKbExport(server: McpServer, queryLayer: QueryLayer, workspace: string): void;

package/dist/engine/tools/code-kb-export.js

@@ -0,0 +1,67 @@
+/**
+ * code_kb_export tool — Export code intelligence data as KB payloads.
+ * Returns structured data ready for kb_ingest consumption.
+ */
+import { z } from 'zod';
+export function registerCodeKbExport(server, queryLayer, workspace) {
+    server.tool('code_kb_export', 'Export code intelligence data as Knowledge Base payloads for ingestion. Returns structured data ready for kb_ingest.', {
+        module: z.string().optional().describe('Filter by module name (optional, exports all if omitted)'),
+        format: z.string().optional().describe('Output format: json (default) or text'),
+    }, async ({ module, format }) => {
+        const modules = queryLayer.listModulesWithPatterns(module ?? null);
+        const projectName = extractProjectName(workspace);
+        const outputFormat = format ?? 'json';
+        const text = outputFormat === 'text'
+            ? formatAsText(modules, projectName)
+            : formatAsJson(modules, projectName);
+        return { content: [{ type: 'text', text }] };
+    });
+}
+function extractProjectName(workspace) {
+    const parts = workspace.replace(/\\/g, '/').split('/');
+    return parts[parts.length - 1] || 'unknown';
+}
+function buildPayload(m, projectName) {
+    const contentLines = [
+        `Module: ${m.name}`,
+        `Language: ${m.language ?? 'unknown'}`,
+        `Purpose: ${m.purpose ?? 'unknown'}`,
+        `Files: ${m.fileCount}`,
+        `Symbols: ${m.symbolCount}`,
+        '',
+        'Patterns:',
+        `  DI Style: ${m.diStyle ?? 'unknown'}`,
+        `  Error Handling: ${m.errorHandling ?? 'unknown'}`,
+        `  Naming: ${m.namingConvention ?? 'unknown'}`,
+        `  Logging: ${m.loggingFramework ?? 'unknown'}`,
+        `  Testing: ${m.testingFramework ?? 'unknown'}`,
+    ];
+    const tags = ['code-index', m.name, m.language ?? 'unknown'].join(', ');
+    return {
+        title: `Code Index — ${m.name}`,
+        content: contentLines.join('\n'),
+        tags,
+        project: projectName,
+    };
+}
+function formatAsJson(modules, projectName) {
+    if (modules.length === 0)
+        return '[]';
+    const payloads = modules.map(m => buildPayload(m, projectName));
+    return JSON.stringify(payloads, null, 2);
+}
+function formatAsText(modules, projectName) {
+    if (modules.length === 0)
+        return 'No modules indexed yet. Run indexing first.';
+    const payloads = modules.map(m => buildPayload(m, projectName));
+    const lines = [];
+    for (const p of payloads) {
+        lines.push(`--- ${p.title} ---`);
+        lines.push(p.content);
+        lines.push(`Tags: ${p.tags}`);
+        lines.push(`Project: ${p.project}`);
+        lines.push('');
+    }
+    return lines.join('\n');
+}
+//# sourceMappingURL=code-kb-export.js.map

package/dist/engine/tools/code-kb-export.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"code-kb-export.js","sourceRoot":"","sources":["../../../src/engine/tools/code-kb-export.ts"],"names":[],"mappings":"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"}

package/dist/engine/tools/code-modules.d.ts

@@ -0,0 +1,6 @@
+/**
+ * code_modules tool — List discovered modules with file/symbol counts.
+ */
+import { McpServer } from '@modelcontextprotocol/sdk/server/mcp.js';
+import { QueryLayer } from '../query/query-layer.js';
+export declare function registerCodeModules(server: McpServer, queryLayer: QueryLayer): void;

package/dist/engine/tools/code-modules.js

@@ -0,0 +1,52 @@
+/**
+ * code_modules tool — List discovered modules with file/symbol counts.
+ */
+import { z } from 'zod';
+export function registerCodeModules(server, queryLayer) {
+    server.tool('code_modules', 'List all discovered code modules in the workspace with file counts, languages, and descriptions.', {
+        name: z.string().optional().describe('Filter by module name (prefix match)'),
+    }, async ({ name }) => {
+        const modules = queryLayer.listModules();
+        const filtered = name
+            ? modules.filter(m => m.name.toLowerCase().startsWith(name.toLowerCase()))
+            : modules;
+        const text = formatModules(filtered);
+        return { content: [{ type: 'text', text }] };
+    });
+}
+function formatModules(modules) {
+    if (modules.length === 0)
+        return 'No modules indexed yet. Run indexing first.';
+    const lines = [`Modules (${modules.length}):\n`];
+    for (const m of modules) {
+        lines.push(`📦 ${m.name}`);
+        lines.push(`   Path: ${m.rootPath}`);
+        if (m.language)
+            lines.push(`   Lang: ${m.language}`);
+        lines.push(`   Files: ${m.fileCount} | Symbols: ${m.symbolCount}`);
+        const patterns = formatPatterns(m);
+        if (patterns)
+            lines.push(`   Patterns: ${patterns}`);
+        if (m.purpose)
+            lines.push(`   Purpose: ${m.purpose}`);
+        if (m.description)
+            lines.push(`   ${m.description}`);
+        lines.push('');
+    }
+    return lines.join('\n');
+}
+function formatPatterns(m) {
+    const parts = [];
+    if (m.diStyle)
+        parts.push(`DI=${m.diStyle}`);
+    if (m.errorHandling)
+        parts.push(`Errors=${m.errorHandling}`);
+    if (m.namingConvention)
+        parts.push(`Naming=${m.namingConvention}`);
+    if (m.loggingFramework)
+        parts.push(`Logging=${m.loggingFramework}`);
+    if (m.testingFramework)
+        parts.push(`Testing=${m.testingFramework}`);
+    return parts.join(' | ');
+}
+//# sourceMappingURL=code-modules.js.map

package/dist/engine/tools/code-modules.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"code-modules.js","sourceRoot":"","sources":["../../../src/engine/tools/code-modules.ts"],"names":[],"mappings":"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"}

package/dist/engine/tools/code-search.d.ts

@@ -0,0 +1,6 @@
+/**
+ * code_search tool — Full-text search across indexed codebase using FTS5.
+ */
+import { McpServer } from '@modelcontextprotocol/sdk/server/mcp.js';
+import { QueryLayer } from '../query/query-layer.js';
+export declare function registerCodeSearch(server: McpServer, queryLayer: QueryLayer): void;

package/dist/engine/tools/code-search.js

@@ -0,0 +1,31 @@
+/**
+ * code_search tool — Full-text search across indexed codebase using FTS5.
+ */
+import { z } from 'zod';
+export function registerCodeSearch(server, queryLayer) {
+    server.tool('code_search', 'Full-text search across indexed code symbols (functions, classes, interfaces). Uses SQLite FTS5 with porter stemming.', {
+        query: z.string().describe('Search query (supports FTS5 syntax: AND, OR, NOT, prefix*)'),
+        limit: z.number().optional().default(20).describe('Max results (default 20)'),
+    }, async ({ query, limit }) => {
+        const results = queryLayer.searchCode(query, limit);
+        const text = formatSearchResults(results, query);
+        return { content: [{ type: 'text', text }] };
+    });
+}
+function formatSearchResults(results, query) {
+    if (results.length === 0) {
+        return `No results found for "${query}"`;
+    }
+    const lines = [`Found ${results.length} results for "${query}":\n`];
+    for (const r of results) {
+        lines.push(`[${r.kind}] ${r.name}`);
+        lines.push(`  File: ${r.filePath}:${r.startLine}`);
+        if (r.signature)
+            lines.push(`  Sig: ${r.signature.slice(0, 120)}`);
+        if (r.docComment)
+            lines.push(`  Doc: ${r.docComment.slice(0, 100)}`);
+        lines.push('');
+    }
+    return lines.join('\n');
+}
+//# sourceMappingURL=code-search.js.map

package/dist/engine/tools/code-search.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"code-search.js","sourceRoot":"","sources":["../../../src/engine/tools/code-search.ts"],"names":[],"mappings":"AAAA;;GAEG;AAGH,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAGxB,MAAM,UAAU,kBAAkB,CAAC,MAAiB,EAAE,UAAsB;IAC1E,MAAM,CAAC,IAAI,CACT,aAAa,EACb,uHAAuH,EACvH;QACE,KAAK,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,4DAA4D,CAAC;QACxF,KAAK,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE,CAAC,OAAO,CAAC,EAAE,CAAC,CAAC,QAAQ,CAAC,0BAA0B,CAAC;KAC9E,EACD,KAAK,EAAE,EAAE,KAAK,EAAE,KAAK,EAAE,EAAE,EAAE;QACzB,MAAM,OAAO,GAAG,UAAU,CAAC,UAAU,CAAC,KAAK,EAAE,KAAK,CAAC,CAAC;QACpD,MAAM,IAAI,GAAG,mBAAmB,CAAC,OAAO,EAAE,KAAK,CAAC,CAAC;QACjD,OAAO,EAAE,OAAO,EAAE,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,CAAC,EAAE,CAAC;IAC/C,CAAC,CACF,CAAC;AACJ,CAAC;AAED,SAAS,mBAAmB,CAAC,OAAc,EAAE,KAAa;IACxD,IAAI,OAAO,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QACzB,OAAO,yBAAyB,KAAK,GAAG,CAAC;IAC3C,CAAC;IAED,MAAM,KAAK,GAAG,CAAC,SAAS,OAAO,CAAC,MAAM,iBAAiB,KAAK,MAAM,CAAC,CAAC;IACpE,KAAK,MAAM,CAAC,IAAI,OAAO,EAAE,CAAC;QACxB,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,IAAI,KAAK,CAAC,CAAC,IAAI,EAAE,CAAC,CAAC;QACpC,KAAK,CAAC,IAAI,CAAC,WAAW,CAAC,CAAC,QAAQ,IAAI,CAAC,CAAC,SAAS,EAAE,CAAC,CAAC;QACnD,IAAI,CAAC,CAAC,SAAS;YAAE,KAAK,CAAC,IAAI,CAAC,UAAU,CAAC,CAAC,SAAS,CAAC,KAAK,CAAC,CAAC,EAAE,GAAG,CAAC,EAAE,CAAC,CAAC;QACnE,IAAI,CAAC,CAAC,UAAU;YAAE,KAAK,CAAC,IAAI,CAAC,UAAU,CAAC,CAAC,UAAU,CAAC,KAAK,CAAC,CAAC,EAAE,GAAG,CAAC,EAAE,CAAC,CAAC;QACrE,KAAK,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;IACjB,CAAC;IACD,OAAO,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;AAC1B,CAAC"}

package/dist/engine/tools/code-symbols.d.ts

@@ -0,0 +1,6 @@
+/**
+ * code_symbols tool — Lookup symbols by name, kind, or file path.
+ */
+import { McpServer } from '@modelcontextprotocol/sdk/server/mcp.js';
+import { QueryLayer } from '../query/query-layer.js';
+export declare function registerCodeSymbols(server: McpServer, queryLayer: QueryLayer): void;

package/dist/engine/tools/code-symbols.js

@@ -0,0 +1,48 @@
+/**
+ * code_symbols tool — Lookup symbols by name, kind, or file path.
+ */
+import { z } from 'zod';
+export function registerCodeSymbols(server, queryLayer) {
+    server.tool('code_symbols', 'Find code symbols by name prefix or list symbols in a file. Filter by kind (function, class, interface, etc).', {
+        name: z.string().optional().describe('Symbol name or prefix to search'),
+        file: z.string().optional().describe('File path to list symbols from'),
+        kind: z.string().optional().describe('Filter by kind: function, class, interface, enum, type, method'),
+        limit: z.number().optional().default(50).describe('Max results'),
+    }, async ({ name, file, kind, limit }) => {
+        let text;
+        if (file) {
+            const symbols = queryLayer.getFileSymbols(file);
+            text = formatFileSymbols(file, symbols);
+        }
+        else if (name) {
+            const symbols = queryLayer.findSymbols(name, kind, limit);
+            text = formatSymbolList(symbols, name);
+        }
+        else {
+            text = 'Provide either "name" or "file" parameter';
+        }
+        return { content: [{ type: 'text', text }] };
+    });
+}
+function formatFileSymbols(file, symbols) {
+    if (symbols.length === 0)
+        return `No symbols found in ${file}`;
+    const lines = [`Symbols in ${file} (${symbols.length}):\n`];
+    for (const s of symbols) {
+        const vis = s.visibility ? `[${s.visibility}] ` : '';
+        lines.push(`  L${s.startLine} ${vis}${s.kind} ${s.name}`);
+    }
+    return lines.join('\n');
+}
+function formatSymbolList(symbols, query) {
+    if (symbols.length === 0)
+        return `No symbols matching "${query}"`;
+    const lines = [`Found ${symbols.length} symbols matching "${query}":\n`];
+    for (const s of symbols) {
+        lines.push(`[${s.kind}] ${s.name} — ${s.filePath}:${s.startLine}`);
+        if (s.signature)
+            lines.push(`  ${s.signature.slice(0, 120)}`);
+    }
+    return lines.join('\n');
+}
+//# sourceMappingURL=code-symbols.js.map

package/dist/engine/tools/code-symbols.js.map

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

package/dist/engine/tools/code-traverse.d.ts

@@ -0,0 +1,54 @@
+/**
+ * KSA-157: MCP Tool Registration for code_traverse.
+ */
+import Database from 'better-sqlite3';
+export declare const TRAVERSE_TOOL_DEFINITIONS: {
+    name: string;
+    description: string;
+    inputSchema: {
+        type: string;
+        properties: {
+            start: {
+                type: string;
+                description: string;
+            };
+            edge_types: {
+                type: string;
+                items: {
+                    type: string;
+                };
+                description: string;
+            };
+            node_types: {
+                type: string;
+                items: {
+                    type: string;
+                };
+                description: string;
+            };
+            direction: {
+                type: string;
+                enum: string[];
+                description: string;
+            };
+            max_depth: {
+                type: string;
+                description: string;
+            };
+            max_results: {
+                type: string;
+                description: string;
+            };
+            include_source: {
+                type: string;
+                description: string;
+            };
+            source_lines: {
+                type: string;
+                description: string;
+            };
+        };
+        required: string[];
+    };
+}[];
+export declare function handleCodeTraverse(args: Record<string, unknown>, db: Database.Database, workspace: string): string;

package/dist/engine/tools/code-traverse.js

@@ -0,0 +1,66 @@
+/**
+ * KSA-157: MCP Tool Registration for code_traverse.
+ */
+import { SymbolResolver } from '../graph/symbol-resolver.js';
+import { GraphTraverser } from '../graph/traverser.js';
+export const TRAVERSE_TOOL_DEFINITIONS = [
+    {
+        name: 'code_traverse',
+        description: 'Generic graph traversal with custom edge/node type filters. Traverse the code relationship graph from any symbol with fine-grained control.',
+        inputSchema: {
+            type: 'object',
+            properties: {
+                start: { type: 'string', description: 'Start symbol (e.g. "MyClass", "MyClass.method", "file.ts:func")' },
+                edge_types: {
+                    type: 'array',
+                    items: { type: 'string' },
+                    description: 'Filter by edge types: calls, imports, inherits, implements, uses, decorates (default: all)',
+                },
+                node_types: {
+                    type: 'array',
+                    items: { type: 'string' },
+                    description: 'Filter by node types: function, class, interface, method, variable (default: all)',
+                },
+                direction: { type: 'string', enum: ['outgoing', 'incoming', 'both'], description: 'Traversal direction (default: outgoing)' },
+                max_depth: { type: 'number', description: 'Maximum traversal depth 1-10 (default: 3)' },
+                max_results: { type: 'number', description: 'Maximum results (default: 50)' },
+                include_source: { type: 'boolean', description: 'Include source code snippets (default: false)' },
+                source_lines: { type: 'number', description: 'Lines of source to include (default: 5)' },
+            },
+            required: ['start'],
+        },
+    },
+];
+export function handleCodeTraverse(args, db, workspace) {
+    const start = args.start;
+    if (!start)
+        return JSON.stringify({ error: 'Parameter "start" is required' });
+    const edgeTypes = args.edge_types ?? [];
+    const nodeTypes = args.node_types ?? [];
+    const direction = args.direction ?? 'outgoing';
+    const maxDepth = Math.min(Math.max(args.max_depth ?? 3, 1), 10);
+    const maxResults = Math.min(args.max_results ?? 50, 200);
+    const includeSource = args.include_source ?? false;
+    const sourceLines = args.source_lines ?? 5;
+    const resolver = new SymbolResolver(db);
+    const traverser = new GraphTraverser(db, resolver, workspace);
+    // Resolve start node
+    const startNode = traverser.resolveNode(start);
+    if (!startNode) {
+        const suggestions = resolver.suggest(start);
+        if (suggestions.length > 0) {
+            return `Symbol "${start}" not found. Did you mean: ${suggestions.join(', ')}?`;
+        }
+        return `Symbol "${start}" not found in index.`;
+    }
+    const config = { edgeTypes, nodeTypes, direction, maxDepth, maxResults };
+    const startTime = Date.now();
+    const results = traverser.traverse(startNode, config);
+    const executionTimeMs = Date.now() - startTime;
+    if (results.length === 0) {
+        return `No connected nodes found from "${start}" with the given filters (direction: ${direction}, edge_types: ${edgeTypes.length > 0 ? edgeTypes.join(',') : 'all'}, node_types: ${nodeTypes.length > 0 ? nodeTypes.join(',') : 'all'})`;
+    }
+    const response = traverser.formatResponse(startNode, results, includeSource, sourceLines, executionTimeMs);
+    return JSON.stringify(response, null, 2);
+}
+//# sourceMappingURL=code-traverse.js.map