@kage-core/kage-graph-mcp 1.1.7 → 1.1.8

package/README.md

@@ -137,6 +137,11 @@ meaningful file changes. Refresh rebuilds indexes, code graph, memory graph,
 metrics, and stale-memory metadata. Memory is marked stale when status or
 feedback says it is stale, its TTL expires, or grounded paths disappear.
 
+Use `kage gc --project <repo> --dry-run` to preview stale packet cleanup.
+`kage gc --project <repo>` marks stale repo packets deprecated, rebuilds
+indexes/graphs/metrics, and keeps helpful-voted memories unless `--force` is
+used.
+
 Use `kage pr summarize --project <repo>` / `kage_pr_summarize` before handoff to
 write branch review metadata and repo-local change memory from the git diff.
 Use `kage pr check --project <repo>` / `kage_pr_check` before merge to verify

package/dist/cli.js

@@ -24,6 +24,7 @@ Usage:
   kage daemon doctor --project <dir> [--json]
   kage viewer --project <dir> [--port 3113]
   kage refresh --project <dir> [--json]
+  kage gc --project <dir> [--dry-run] [--force] [--json]
   kage pr summarize --project <dir> [--json]
   kage pr check --project <dir> [--json]
   kage upgrade [--dry-run]
@@ -302,6 +303,32 @@ async function main() {
         await (0, daemon_js_1.startViewer)(projectArg(args), { port: numberArg(args, "--port", 3113) });
         return;
     }
+    if (command === "gc") {
+        const project = projectArg(args);
+        const dryRun = args.includes("--dry-run");
+        const force = args.includes("--force");
+        const result = (0, kernel_js_1.gcProject)(project, { dryRun, force });
+        if (args.includes("--json")) {
+            console.log(JSON.stringify(result, null, 2));
+            return;
+        }
+        const label = dryRun ? " [dry-run]" : "";
+        console.log(`Kage GC${label} — scanned ${result.total_scanned} packets`);
+        if (result.deprecated.length) {
+            console.log(`\nDeprecated (${result.deprecated.length}):`);
+            for (const p of result.deprecated)
+                console.log(`  ✗ ${p.title} — ${p.reason}`);
+        }
+        if (result.deleted.length) {
+            console.log(`\nDeleted (${result.deleted.length}):`);
+            for (const p of result.deleted)
+                console.log(`  🗑  ${p.title}`);
+        }
+        if (!result.deprecated.length && !result.deleted.length) {
+            console.log("No stale packets found — memory is clean.");
+        }
+        return;
+    }
     if (command === "refresh") {
         const result = (0, kernel_js_1.refreshProject)(projectArg(args));
         if (args.includes("--json")) {

package/dist/kernel.js

@@ -67,6 +67,7 @@ exports.buildKnowledgeGraph = buildKnowledgeGraph;
 exports.buildIndexes = buildIndexes;
 exports.indexProject = indexProject;
 exports.refreshProject = refreshProject;
+exports.gcProject = gcProject;
 exports.installAgentPolicy = installAgentPolicy;
 exports.recall = recall;
 exports.queryCodeGraph = queryCodeGraph;
@@ -2516,6 +2517,57 @@ function refreshProject(projectDir) {
         next_actions: nextActions,
     };
 }
+function gcProject(projectDir, options = {}) {
+    ensureMemoryDirs(projectDir);
+    const packetEntries = loadPacketEntriesFromDir(packetsDir(projectDir));
+    const deprecated = [];
+    const deleted = [];
+    const skipped = [];
+    for (const { path, packet } of packetEntries) {
+        if (packet.status === "deprecated") {
+            skipped.push({ id: packet.id, title: packet.title, reason: "already deprecated" });
+            continue;
+        }
+        const reasons = staleMemoryReasons(projectDir, packet);
+        if (!reasons.length) {
+            skipped.push({ id: packet.id, title: packet.title, reason: "healthy" });
+            continue;
+        }
+        const quality = packet.quality;
+        const hasHelpfulVotes = Number(quality?.votes_up ?? 0) > 0;
+        if (hasHelpfulVotes && !options.force) {
+            skipped.push({ id: packet.id, title: packet.title, reason: `stale but has helpful votes (use --force to override)` });
+            continue;
+        }
+        // Mark as deprecated (or hard-delete if --force)
+        if (options.force && !hasHelpfulVotes) {
+            if (!options.dryRun) {
+                (0, node_fs_1.unlinkSync)(path);
+            }
+            deleted.push({ id: packet.id, title: packet.title });
+        }
+        else {
+            if (!options.dryRun) {
+                const updated = { ...packet, status: "deprecated", updated_at: nowIso() };
+                writeJson(path, updated);
+            }
+            deprecated.push({ id: packet.id, title: packet.title, reason: reasons[0] });
+        }
+    }
+    if (!options.dryRun && (deprecated.length || deleted.length)) {
+        buildIndexes(projectDir);
+        buildKnowledgeGraph(projectDir);
+        writeJson((0, node_path_1.join)(memoryRoot(projectDir), "metrics.json"), kageMetrics(projectDir));
+    }
+    return {
+        ok: true,
+        project_dir: projectDir,
+        deprecated,
+        deleted,
+        skipped,
+        total_scanned: packetEntries.length,
+    };
+}
 function installAgentPolicy(projectDir) {
     const agentsPath = (0, node_path_1.join)(projectDir, "AGENTS.md");
     const claudePath = (0, node_path_1.join)(projectDir, "CLAUDE.md");

package/package.json

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