code-graph-context 2.0.0 → 2.2.0

package/dist/mcp/services/job-manager.js

@@ -3,6 +3,7 @@
  * Tracks background parsing jobs for async mode
  */
 import { randomBytes } from 'crypto';
+import { JOBS } from '../constants.js';
 const generateJobId = () => {
     return `job_${randomBytes(8).toString('hex')}`;
 };
@@ -15,10 +16,6 @@ const createInitialProgress = () => ({
     currentChunk: 0,
     totalChunks: 0,
 });
-// Cleanup interval: 5 minutes
-const CLEANUP_INTERVAL_MS = 5 * 60 * 1000;
-// Maximum concurrent jobs to prevent memory exhaustion
-const MAX_JOBS = 100;
 class JobManager {
     jobs = new Map();
     cleanupInterval = null;
@@ -38,7 +35,7 @@ class JobManager {
             if (cleaned > 0) {
                 console.log(`[JobManager] Cleaned up ${cleaned} old jobs`);
             }
-        }, CLEANUP_INTERVAL_MS);
+        }, JOBS.cleanupIntervalMs);
         // Don't prevent Node.js from exiting if this is the only timer
         this.cleanupInterval.unref();
     }
@@ -57,11 +54,11 @@ class JobManager {
      */
     createJob(projectPath, projectId) {
         // SECURITY: Enforce maximum job limit to prevent memory exhaustion
-        if (this.jobs.size >= MAX_JOBS) {
+        if (this.jobs.size >= JOBS.maxJobs) {
             // Try to cleanup old jobs first
             const cleaned = this.cleanupOldJobs(0); // Remove all completed/failed jobs
-            if (this.jobs.size >= MAX_JOBS) {
-                throw new Error(`Maximum job limit (${MAX_JOBS}) reached. ` +
+            if (this.jobs.size >= JOBS.maxJobs) {
+                throw new Error(`Maximum job limit (${JOBS.maxJobs}) reached. ` +
                     `${this.listJobs('running').length} jobs are currently running. ` +
                     `Please wait for jobs to complete or cancel existing jobs.`);
             }

package/dist/mcp/services/watch-manager.js

@@ -4,19 +4,8 @@
  * Uses @parcel/watcher for high-performance file watching
  */
 import * as watcher from '@parcel/watcher';
+import { WATCH } from '../constants.js';
 import { debugLog } from '../utils.js';
-const DEFAULT_EXCLUDE_PATTERNS = [
-    '**/node_modules/**',
-    '**/dist/**',
-    '**/build/**',
-    '**/.git/**',
-    '**/*.d.ts',
-    '**/*.js.map',
-    '**/*.js',
-];
-const DEFAULT_DEBOUNCE_MS = 1000;
-const MAX_WATCHERS = 10;
-const MAX_PENDING_EVENTS = 1000;
 class WatchManager {
     watchers = new Map();
     mcpServer = null;
@@ -62,15 +51,15 @@ class WatchManager {
             return this.getWatcherInfoFromState(existing);
         }
         // Enforce maximum watcher limit
-        if (this.watchers.size >= MAX_WATCHERS) {
-            throw new Error(`Maximum watcher limit (${MAX_WATCHERS}) reached. ` + `Stop an existing watcher before starting a new one.`);
+        if (this.watchers.size >= WATCH.maxWatchers) {
+            throw new Error(`Maximum watcher limit (${WATCH.maxWatchers}) reached. ` + `Stop an existing watcher before starting a new one.`);
         }
         const fullConfig = {
             projectPath: config.projectPath,
             projectId: config.projectId,
             tsconfigPath: config.tsconfigPath,
-            debounceMs: config.debounceMs ?? DEFAULT_DEBOUNCE_MS,
-            excludePatterns: config.excludePatterns ?? DEFAULT_EXCLUDE_PATTERNS,
+            debounceMs: config.debounceMs ?? WATCH.defaultDebounceMs,
+            excludePatterns: config.excludePatterns ?? [...WATCH.excludePatterns],
         };
         await debugLog('Creating @parcel/watcher subscription', {
             watchPath: fullConfig.projectPath,
@@ -154,9 +143,9 @@ class WatchManager {
             timestamp: Date.now(),
         };
         // Prevent unbounded event accumulation - drop oldest events if buffer is full
-        if (state.pendingEvents.length >= MAX_PENDING_EVENTS) {
+        if (state.pendingEvents.length >= WATCH.maxPendingEvents) {
             debugLog('Event buffer full, dropping oldest events', { projectId: state.projectId });
-            state.pendingEvents = state.pendingEvents.slice(-Math.floor(MAX_PENDING_EVENTS / 2));
+            state.pendingEvents = state.pendingEvents.slice(-Math.floor(WATCH.maxPendingEvents / 2));
         }
         state.pendingEvents.push(event);
         debugLog('Event added to pending', { pendingCount: state.pendingEvents.length });

package/dist/mcp/tools/detect-dead-code.tool.js

@@ -0,0 +1,413 @@
+/**
+ * Detect Dead Code Tool
+ * Identifies potentially unused code in the codebase
+ */
+import { z } from 'zod';
+import { toNumber, isUIComponent, isPackageExport, isExcludedByPattern, getShortPath, } from '../../core/utils/shared-utils.js';
+import { Neo4jService, QUERIES } from '../../storage/neo4j/neo4j.service.js';
+import { TOOL_NAMES, TOOL_METADATA } from '../constants.js';
+import { createErrorResponse, createSuccessResponse, debugLog, resolveProjectIdOrError } from '../utils.js';
+// Default file patterns to exclude
+const DEFAULT_ENTRY_POINT_FILE_PATTERNS = [
+    // Common entry points
+    'main.ts',
+    'app.ts',
+    'index.ts',
+    // NestJS
+    '*.module.ts',
+    '*.controller.ts',
+    // Fastify / Express
+    '*.routes.ts',
+    '*.router.ts',
+    '*.handler.ts',
+    'server.ts',
+    // Next.js / React frameworks (file-based routing)
+    'page.tsx',
+    'page.ts',
+    'layout.tsx',
+    'layout.ts',
+    'route.tsx',
+    'route.ts',
+    'loading.tsx',
+    'error.tsx',
+    'not-found.tsx',
+    'template.tsx',
+    'default.tsx',
+    // Remix
+    'root.tsx',
+    // Astro
+    '*.astro',
+];
+/**
+ * Determine confidence level based on code characteristics.
+ * Returns both the level and a human-readable explanation.
+ */
+const determineConfidence = (item) => {
+    // HIGH: Exported but definitively never imported
+    if (item.isExported && item.reason.includes('never imported')) {
+        return { level: 'HIGH', reason: 'Exported but never imported anywhere' };
+    }
+    // MEDIUM: Private with no internal calls
+    if (item.visibility === 'private') {
+        return { level: 'MEDIUM', reason: 'Private method with no internal callers' };
+    }
+    // LOW: Could be used dynamically
+    return { level: 'LOW', reason: 'Could be used via dynamic references' };
+};
+/**
+ * Calculate risk level based on dead code count.
+ */
+const getRiskLevel = (totalCount, highCount) => {
+    if (highCount >= 20 || totalCount >= 50)
+        return 'CRITICAL';
+    if (highCount >= 10 || totalCount >= 25)
+        return 'HIGH';
+    if (highCount >= 5 || totalCount >= 10)
+        return 'MEDIUM';
+    return 'LOW';
+};
+/**
+ * Check if confidence meets minimum threshold.
+ */
+const shouldInclude = (confidence, minConfidence) => {
+    const levels = ['LOW', 'MEDIUM', 'HIGH'];
+    return levels.indexOf(confidence) >= levels.indexOf(minConfidence);
+};
+/**
+ * Check if semantic type is excluded.
+ */
+const isExcludedBySemanticType = (semanticType, excludeTypes) => {
+    return semanticType != null && excludeTypes.includes(semanticType);
+};
+/**
+ * Determine category of dead code item based on file path.
+ */
+const determineCategory = (filePath) => {
+    if (isUIComponent(filePath))
+        return 'ui-component';
+    if (isPackageExport(filePath))
+        return 'library-export';
+    return 'internal-unused';
+};
+export const createDetectDeadCodeTool = (server) => {
+    server.registerTool(TOOL_NAMES.detectDeadCode, {
+        title: TOOL_METADATA[TOOL_NAMES.detectDeadCode].title,
+        description: TOOL_METADATA[TOOL_NAMES.detectDeadCode].description,
+        inputSchema: {
+            projectId: z.string().describe('Project ID, name, or path (e.g., "backend" or "proj_a1b2c3d4e5f6")'),
+            excludePatterns: z
+                .array(z.string())
+                .optional()
+                .describe('Additional file patterns to exclude as entry points (e.g., ["*.config.ts", "*.seed.ts"])'),
+            excludeSemanticTypes: z
+                .array(z.string())
+                .optional()
+                .describe('Additional semantic types to exclude (e.g., ["EntityClass", "DTOClass"])'),
+            includeEntryPoints: z
+                .boolean()
+                .optional()
+                .describe('Include excluded entry points in a separate audit section for review (default: true). ' +
+                'Entry points are always excluded from main results.')
+                .default(true),
+            minConfidence: z
+                .enum(['LOW', 'MEDIUM', 'HIGH'])
+                .optional()
+                .describe('Minimum confidence level to include in results (default: LOW)')
+                .default('LOW'),
+            summaryOnly: z
+                .boolean()
+                .optional()
+                .describe('Return only summary statistics without full dead code list (default: false)')
+                .default(false),
+            limit: z
+                .number()
+                .int()
+                .min(1)
+                .max(500)
+                .optional()
+                .describe('Maximum number of dead code items to return per page (default: 100)')
+                .default(100),
+            offset: z
+                .number()
+                .int()
+                .min(0)
+                .optional()
+                .describe('Number of items to skip for pagination (default: 0)')
+                .default(0),
+            filterCategory: z
+                .enum(['library-export', 'ui-component', 'internal-unused', 'all'])
+                .optional()
+                .describe('Filter by category: library-export, ui-component, internal-unused, or all (default: all)')
+                .default('all'),
+            excludeLibraryExports: z
+                .boolean()
+                .optional()
+                .describe('Exclude all items from packages/* directories (default: false)')
+                .default(false),
+            excludeCoreTypes: z
+                .array(z.string())
+                .optional()
+                .describe('Exclude specific core types from results (e.g., ["InterfaceDeclaration", "TypeAliasDeclaration"] to skip type definitions)')
+                .default([]),
+        },
+    }, async ({ projectId, excludePatterns = [], excludeSemanticTypes = [], includeEntryPoints = true, minConfidence = 'LOW', summaryOnly = false, limit = 100, offset = 0, filterCategory = 'all', excludeLibraryExports = false, excludeCoreTypes = [], }) => {
+        const neo4jService = new Neo4jService();
+        try {
+            // Resolve project ID
+            const projectResult = await resolveProjectIdOrError(projectId, neo4jService);
+            if (!projectResult.success)
+                return projectResult.error;
+            const resolvedProjectId = projectResult.projectId;
+            await debugLog('Dead code detection started', {
+                projectId: resolvedProjectId,
+                excludePatterns,
+                excludeSemanticTypes,
+                minConfidence,
+            });
+            // Query project's actual semantic types (data-driven, per-project detection)
+            const semanticTypesResult = (await neo4jService.run(QUERIES.GET_PROJECT_SEMANTIC_TYPES, {
+                projectId: resolvedProjectId,
+            }));
+            const projectSemanticTypes = semanticTypesResult.map((r) => r.semanticType);
+            // Combine project semantic types with user-provided exclusions
+            const allExcludeSemanticTypes = [...projectSemanticTypes, ...excludeSemanticTypes];
+            const allExcludePatterns = [...DEFAULT_ENTRY_POINT_FILE_PATTERNS, ...excludePatterns];
+            // Run all queries in parallel for better performance
+            const [unreferencedExports, uncalledPrivateMethods, unreferencedInterfaces, entryPointsResult] = await Promise.all([
+                // 1. Find unreferenced exports
+                neo4jService.run(QUERIES.FIND_UNREFERENCED_EXPORTS, {
+                    projectId: resolvedProjectId,
+                }),
+                // 2. Find uncalled private methods
+                neo4jService.run(QUERIES.FIND_UNCALLED_PRIVATE_METHODS, {
+                    projectId: resolvedProjectId,
+                }),
+                // 3. Find unreferenced interfaces
+                neo4jService.run(QUERIES.FIND_UNREFERENCED_INTERFACES, {
+                    projectId: resolvedProjectId,
+                }),
+                // 4. Get framework entry points for exclusion/audit (using project's semantic types)
+                neo4jService.run(QUERIES.GET_FRAMEWORK_ENTRY_POINTS, {
+                    projectId: resolvedProjectId,
+                    semanticTypes: allExcludeSemanticTypes,
+                }),
+            ]);
+            // Create set of entry point IDs for filtering
+            const entryPointIds = new Set(entryPointsResult.map((r) => r.nodeId));
+            // Process and filter results
+            const deadCodeItems = [];
+            // Process unreferenced exports
+            for (const item of unreferencedExports) {
+                if (entryPointIds.has(item.nodeId))
+                    continue;
+                if (isExcludedByPattern(item.filePath, allExcludePatterns))
+                    continue;
+                if (isExcludedBySemanticType(item.semanticType, allExcludeSemanticTypes))
+                    continue;
+                const confidence = determineConfidence({
+                    isExported: true,
+                    coreType: item.coreType,
+                    reason: item.reason,
+                });
+                if (shouldInclude(confidence.level, minConfidence)) {
+                    const category = determineCategory(item.filePath);
+                    deadCodeItems.push({
+                        nodeId: item.nodeId,
+                        name: item.name,
+                        type: item.coreType,
+                        coreType: item.coreType,
+                        semanticType: item.semanticType ?? null,
+                        filePath: item.filePath,
+                        lineNumber: toNumber(item.lineNumber),
+                        confidence: confidence.level,
+                        confidenceReason: confidence.reason,
+                        category,
+                        reason: item.reason,
+                    });
+                }
+            }
+            // Process uncalled private methods
+            for (const item of uncalledPrivateMethods) {
+                // Apply same exclusion checks as other dead code types
+                if (entryPointIds.has(item.nodeId))
+                    continue;
+                if (isExcludedByPattern(item.filePath, allExcludePatterns))
+                    continue;
+                if (isExcludedBySemanticType(item.semanticType, allExcludeSemanticTypes))
+                    continue;
+                const confidence = determineConfidence({
+                    isExported: false,
+                    visibility: 'private',
+                    coreType: item.coreType,
+                    reason: item.reason,
+                });
+                if (shouldInclude(confidence.level, minConfidence)) {
+                    const category = determineCategory(item.filePath);
+                    deadCodeItems.push({
+                        nodeId: item.nodeId,
+                        name: item.name,
+                        type: item.coreType,
+                        coreType: item.coreType,
+                        semanticType: item.semanticType ?? null,
+                        filePath: item.filePath,
+                        lineNumber: toNumber(item.lineNumber),
+                        confidence: confidence.level,
+                        confidenceReason: confidence.reason,
+                        category,
+                        reason: item.reason,
+                    });
+                }
+            }
+            // Process unreferenced interfaces
+            for (const item of unreferencedInterfaces) {
+                if (entryPointIds.has(item.nodeId))
+                    continue;
+                if (isExcludedByPattern(item.filePath, allExcludePatterns))
+                    continue;
+                const confidence = determineConfidence({
+                    isExported: true,
+                    coreType: item.coreType,
+                    reason: item.reason,
+                });
+                if (shouldInclude(confidence.level, minConfidence)) {
+                    const category = determineCategory(item.filePath);
+                    deadCodeItems.push({
+                        nodeId: item.nodeId,
+                        name: item.name,
+                        type: item.coreType,
+                        coreType: item.coreType,
+                        semanticType: item.semanticType ?? null,
+                        filePath: item.filePath,
+                        lineNumber: toNumber(item.lineNumber),
+                        confidence: confidence.level,
+                        confidenceReason: confidence.reason,
+                        category,
+                        reason: item.reason,
+                    });
+                }
+            }
+            // Apply exclusion filters
+            let filteredItems = deadCodeItems;
+            // Exclude library exports if requested
+            if (excludeLibraryExports) {
+                filteredItems = filteredItems.filter((i) => i.category !== 'library-export');
+            }
+            // Exclude specific core types if requested
+            if (excludeCoreTypes.length > 0) {
+                filteredItems = filteredItems.filter((i) => !excludeCoreTypes.includes(i.coreType));
+            }
+            // Apply category filter if specified
+            if (filterCategory !== 'all') {
+                filteredItems = filteredItems.filter((i) => i.category === filterCategory);
+            }
+            // Calculate statistics on ALL items (before filtering)
+            const byConfidence = {
+                HIGH: deadCodeItems.filter((i) => i.confidence === 'HIGH').length,
+                MEDIUM: deadCodeItems.filter((i) => i.confidence === 'MEDIUM').length,
+                LOW: deadCodeItems.filter((i) => i.confidence === 'LOW').length,
+            };
+            const byCategory = {
+                'library-export': deadCodeItems.filter((i) => i.category === 'library-export').length,
+                'ui-component': deadCodeItems.filter((i) => i.category === 'ui-component').length,
+                'internal-unused': deadCodeItems.filter((i) => i.category === 'internal-unused').length,
+            };
+            const byType = {};
+            for (const item of deadCodeItems) {
+                byType[item.type] = (byType[item.type] ?? 0) + 1;
+            }
+            // Use filtered items for affected files and output
+            const affectedFiles = [...new Set(filteredItems.map((i) => i.filePath))].sort();
+            const riskLevel = getRiskLevel(filteredItems.length, byConfidence.HIGH);
+            // Build entry points list for audit
+            const excludedEntryPoints = includeEntryPoints
+                ? entryPointsResult.map((r) => ({
+                    nodeId: r.nodeId,
+                    name: r.name,
+                    type: r.coreType ?? 'Unknown',
+                    semanticType: r.semanticType ?? null,
+                    filePath: r.filePath,
+                }))
+                : [];
+            // Build summary based on filter
+            const filterSuffix = filterCategory !== 'all' ? ` (filtered to ${filterCategory})` : '';
+            const summary = filteredItems.length === 0
+                ? 'No potentially dead code found' + filterSuffix
+                : `Found ${filteredItems.length} potentially dead code items across ${affectedFiles.length} files` +
+                    filterSuffix;
+            // Count entry points (always available)
+            const excludedEntryPointsCount = entryPointsResult.length;
+            // Compute top files by dead code count (used in both modes)
+            const fileDeadCodeCounts = {};
+            for (const item of filteredItems) {
+                const shortPath = getShortPath(item.filePath);
+                fileDeadCodeCounts[shortPath] = (fileDeadCodeCounts[shortPath] ?? 0) + 1;
+            }
+            const topFilesByDeadCode = Object.entries(fileDeadCodeCounts)
+                .sort((a, b) => b[1] - a[1])
+                .slice(0, 20)
+                .map(([file, count]) => ({ file, count }));
+            // Build result based on summaryOnly flag
+            let result;
+            if (summaryOnly) {
+                // Summary mode: statistics only, no full arrays
+                result = {
+                    summary,
+                    riskLevel,
+                    totalCount: filteredItems.length,
+                    totalBeforeFilter: deadCodeItems.length,
+                    byConfidence,
+                    byCategory,
+                    byType,
+                    affectedFiles,
+                    topFilesByDeadCode,
+                    excludedEntryPointsCount,
+                };
+            }
+            else {
+                // Paginated mode: apply limit/offset
+                const paginatedItems = filteredItems.slice(offset, offset + limit);
+                const hasMore = offset + limit < filteredItems.length;
+                result = {
+                    summary,
+                    riskLevel,
+                    totalCount: filteredItems.length,
+                    totalBeforeFilter: deadCodeItems.length,
+                    byConfidence,
+                    byCategory,
+                    byType,
+                    topFilesByDeadCode,
+                    deadCode: paginatedItems,
+                    pagination: {
+                        offset,
+                        limit,
+                        returned: paginatedItems.length,
+                        hasMore,
+                    },
+                    excludedEntryPointsCount,
+                    // Only include full entry points array on first page
+                    ...(offset === 0 && includeEntryPoints ? { excludedEntryPoints } : {}),
+                    affectedFiles,
+                };
+            }
+            await debugLog('Dead code detection complete', {
+                projectId: resolvedProjectId,
+                totalCount: deadCodeItems.length,
+                filteredCount: filteredItems.length,
+                filterCategory,
+                riskLevel,
+                summaryOnly,
+                offset,
+                limit,
+            });
+            return createSuccessResponse(JSON.stringify(result, null, 2));
+        }
+        catch (error) {
+            console.error('Dead code detection error:', error);
+            await debugLog('Dead code detection error', { projectId, error });
+            return createErrorResponse(error);
+        }
+        finally {
+            await neo4jService.close();
+        }
+    });
+};