@kage-core/kage-graph-mcp 1.1.29 → 1.1.30

package/README.md

@@ -38,6 +38,8 @@ Restart your agent once after setup so MCP tools reload.
   and code explanations
 - a code graph for files, symbols, imports, calls, routes, tests, and packages,
   including generic call/test signals and mixed-language framework routes
+- conservative cleanup candidates for unreferenced files, unused exports, and
+  internal-looking unused symbols
 - memory-code links so project knowledge points at the code it affects
 - decision intelligence for why-memory coverage, stale/weak packets, and
   important files that still lack linked repo knowledge

package/dist/index.js

@@ -221,7 +221,7 @@ function listTools() {
         },
         {
             name: "kage_cleanup_candidates",
-            description: "Find conservative cleanup candidates from Kage's code graph. Reports unreferenced source files with confidence and reasons; never auto-deletes.",
+            description: "Find conservative cleanup candidates from Kage's code graph. Reports unreferenced source files, unused exports, and internal-looking unused symbols with confidence and reasons; never auto-deletes.",
             inputSchema: {
                 type: "object",
                 properties: {

package/dist/kernel.js

@@ -5501,6 +5501,26 @@ function hasRuntimePathReference(projectDir, graph, target) {
     }
     return false;
 }
+function cleanupSymbolKind(symbol) {
+    return ["function", "method", "class", "constant"].includes(symbol.kind);
+}
+function symbolCleanupCandidate(symbol, kind, reasons, score, coveredByTests, git) {
+    return {
+        path: symbol.path,
+        kind,
+        symbol_id: symbol.id,
+        symbol_name: symbol.name,
+        line: symbol.line,
+        confidence: cleanupConfidence(score),
+        score,
+        reasons,
+        inbound_imports: 0,
+        source_inbound_imports: 0,
+        outbound_imports: 0,
+        covered_by_tests: coveredByTests,
+        last_commit_at: git?.last_commit_at ?? null,
+    };
+}
 function kageCleanupCandidates(projectDir) {
     const graph = readCurrentCodeGraph(projectDir) ?? buildCodeGraph(projectDir);
     const fileByPath = new Map(graph.files.map((file) => [file.path, file]));
@@ -5525,6 +5545,7 @@ function kageCleanupCandidates(projectDir) {
         warnings.push("Git history is unavailable, so cleanup confidence does not use recency.");
     const candidates = [];
     const skippedRuntimeReferences = [];
+    const wholeFileCandidates = new Set();
     for (const file of graph.files) {
         if (file.kind !== "source")
             continue;
@@ -5577,6 +5598,60 @@ function kageCleanupCandidates(projectDir) {
             covered_by_tests: coveredByTests,
             last_commit_at: git?.last_commit_at ?? null,
         });
+        wholeFileCandidates.add(file.path);
+    }
+    const calledSymbols = new Set(graph.calls.map((call) => call.to_symbol));
+    const routeHandlers = new Set(graph.routes.map((route) => route.handler_symbol).filter((value) => Boolean(value)));
+    const coveredSymbolNames = new Set(graph.tests.map((test) => test.covers_symbol?.toLowerCase()).filter((value) => Boolean(value)));
+    const symbolsByPath = new Map();
+    for (const symbol of graph.symbols.filter(cleanupSymbolKind)) {
+        const list = symbolsByPath.get(symbol.path) ?? [];
+        list.push(symbol);
+        symbolsByPath.set(symbol.path, list);
+    }
+    const importedNamesByPath = new Map();
+    for (const edge of graph.imports) {
+        if (!edge.to_path || !edge.imported.length)
+            continue;
+        const names = importedNamesByPath.get(edge.to_path) ?? new Set();
+        for (const name of edge.imported)
+            names.add(name);
+        importedNamesByPath.set(edge.to_path, names);
+    }
+    for (const file of graph.files) {
+        if (file.kind !== "source" || wholeFileCandidates.has(file.path))
+            continue;
+        if (isEntrypointLike(file.path) || routeFiles.has(file.path))
+            continue;
+        const fileSymbols = symbolsByPath.get(file.path) ?? [];
+        if (!fileSymbols.length)
+            continue;
+        const git = hasGit ? gitFileSignal(projectDir, file.path, graphPaths) : null;
+        const coveredByTests = hasTestCoverage(file.path, graph);
+        const importedNames = importedNamesByPath.get(file.path) ?? new Set();
+        const exportedSymbols = fileSymbols.filter((symbol) => symbol.export);
+        const hasMatchedNamedExport = exportedSymbols.some((symbol) => importedNames.has(symbol.name));
+        for (const symbol of fileSymbols) {
+            const symbolReferenced = calledSymbols.has(symbol.id) || routeHandlers.has(symbol.id) || coveredSymbolNames.has(symbol.name.toLowerCase());
+            if (symbolReferenced)
+                continue;
+            if (symbol.export) {
+                if (!hasMatchedNamedExport || importedNames.has(symbol.name))
+                    continue;
+                candidates.push(symbolCleanupCandidate(symbol, "unused_export", [
+                    `export "${symbol.name}" is not imported by current named import edges`,
+                    "symbol is not a known call target, route handler, or covered test target",
+                    "file has at least one other exported symbol imported by name",
+                ], 0.62, coveredByTests, git));
+            }
+            else if (/^_[A-Za-z0-9_]+/.test(symbol.name)) {
+                candidates.push(symbolCleanupCandidate(symbol, "unused_internal_symbol", [
+                    `internal-looking symbol "${symbol.name}" has no known call edge`,
+                    "symbol is not a route handler or covered test target",
+                    "candidate is review input only; dynamic references may exist",
+                ], 0.5, coveredByTests, git));
+            }
+        }
     }
     candidates.sort((a, b) => b.score - a.score || a.path.localeCompare(b.path));
     return {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@kage-core/kage-graph-mcp",
-  "version": "1.1.29",
+  "version": "1.1.30",
   "description": "Local-first repo memory, code graph, and recall MCP server for coding agents",
   "main": "dist/index.js",
   "files": [