@kage-core/kage-graph-mcp 1.2.0 → 1.4.0

package/dist/cli.js

@@ -12,6 +12,7 @@ function usage() {
 
 Usage:
   kage index --project <dir>
+  kage demo [--project <dir>]
   kage init --project <dir>
   kage policy --project <dir>
   kage doctor --project <dir>
@@ -31,12 +32,14 @@ Usage:
   kage gc --project <dir> [--dry-run] [--force] [--json]
   kage compact --project <dir> [--dry-run] [--json]
   kage verify --project <dir> [--id <packet-id>] [--json]
+  kage suppressed --project <dir> [--json]
   kage pr summarize --project <dir> [--json]
   kage pr check --project <dir> [--json]
   kage upgrade [--dry-run]
   kage branch --project <dir> [--json]
   kage metrics --project <dir> [--json]
   kage memory-access --project <dir> [--json]
+  kage activity --project <dir> [--json]
   kage memory-audit --project <dir> [--limit <n>] [--json]
   kage slots --project <dir> [--json]
   kage slots set --project <dir> --label <label> --content <text> [--description <text>] [--paths a,b] [--tags a,b] [--size-limit <n>] [--unpinned] [--json]
@@ -60,6 +63,7 @@ Usage:
   kage inbox --project <dir> [--json]
   kage quality --project <dir> [--json]
   kage benchmark --project <dir> [--json]
+  kage benchmark --trust --project <dir> [--json]
   kage benchmark --memory-quality [--json]
   kage benchmark --scale [--sizes 240,1000,5000] [--json]
   kage benchmark --project <dir> --compare --task <task> [--json]
@@ -176,6 +180,30 @@ async function main() {
         console.log(`Indexes:\n${result.indexes.map((path) => `  - ${path}`).join("\n")}`);
         return;
     }
+    if (command === "demo") {
+        const demoDir = takeArg(args, "--project") ?? `${process.cwd()}/kage-demo`;
+        const result = (0, kernel_js_1.runDemo)(demoDir);
+        if (args.includes("--json")) {
+            console.log(JSON.stringify(result, null, 2));
+            return;
+        }
+        console.log("Kage demo — can you trust your agent's memory?\n");
+        console.log(`Seeded ${result.captured.length} grounded memories in ${result.project_dir}\n`);
+        console.log("1. Hallucinated citation — REJECTED on write:");
+        if (result.rejected_hallucination) {
+            console.log(`   ✗ "${result.rejected_hallucination.title}"`);
+            console.log(`     ${result.rejected_hallucination.error}\n`);
+        }
+        console.log("2. Stale memory (cited file deleted) — WITHHELD from recall:");
+        for (const w of result.withheld)
+            console.log(`   ⊘ ${w.title}\n     ${w.reason}`);
+        console.log("\n3. Recall returns only grounded, current memory:");
+        for (const t of result.recalled)
+            console.log(`   ✓ ${t}`);
+        console.log(`\nTrust score: ${result.trust_score}/100`);
+        console.log(`\nSee it in the viewer:  ${result.viewer_command}`);
+        return;
+    }
     if (command === "init") {
         const result = (0, kernel_js_1.initProject)(projectArg(args));
         console.log(`Initialized Kage memory for ${result.index.projectDir}`);
@@ -465,6 +493,21 @@ async function main() {
         }
         return;
     }
+    if (command === "suppressed") {
+        const result = (0, kernel_js_1.kageSuppressedMemory)(projectArg(args));
+        if (args.includes("--json")) {
+            console.log(JSON.stringify(result, null, 2));
+            return;
+        }
+        console.log(`Kage suppressed memory — ${result.count} packet(s) currently withheld from recall`);
+        for (const item of result.items) {
+            console.log(`  ⊘ ${item.title}`);
+            console.log(`      ${item.reason}`);
+        }
+        if (!result.count)
+            console.log("  (none — all recallable memory is grounded and current)");
+        return;
+    }
     if (command === "refresh") {
         const result = (0, kernel_js_1.refreshProject)(projectArg(args), { full: args.includes("--full") });
         if (args.includes("--json")) {
@@ -941,6 +984,19 @@ async function main() {
         }
         return;
     }
+    if (command === "activity") {
+        const result = (0, kernel_js_1.kageActivity)(projectArg(args));
+        if (args.includes("--json")) {
+            console.log(JSON.stringify(result, null, 2));
+            return;
+        }
+        console.log(`Kage activity: ${result.totals.events} events (${result.totals.recalls} recalls, ${result.totals.captures} captures); ${result.totals.recalls_7d} recalls in 7 days`);
+        console.log("\nRecent:");
+        for (const event of result.events.slice(0, 15)) {
+            console.log(`- ${event.at.slice(0, 16).replace("T", " ")}  ${event.kind.padEnd(9)} ${event.title}`);
+        }
+        return;
+    }
     if (command === "lifecycle" || command === "memory-lifecycle") {
         const result = (0, kernel_js_1.kageMemoryLifecycle)(projectArg(args));
         if (args.includes("--json")) {
@@ -1319,6 +1375,24 @@ async function main() {
         return;
     }
     if (command === "benchmark") {
+        if (args.includes("--trust")) {
+            const result = (0, kernel_js_1.benchmarkTrust)(projectArg(args));
+            if (args.includes("--json")) {
+                console.log(JSON.stringify(result, null, 2));
+                if (!result.ok)
+                    process.exitCode = 1;
+                return;
+            }
+            console.log("Kage Trust Benchmark — can this memory be trusted?");
+            console.log(`Trust score: ${result.trust_score}/100  (${result.ok ? "PASS" : "REVIEW"})`);
+            console.log(`  Hallucinated-citation rejection: ${result.metrics.hallucinated_citation_rejection_rate}%  (${result.detail.hallucination.rejected}/${result.detail.hallucination.attempted})`);
+            console.log(`  Stale-memory exclusion:          ${result.metrics.stale_memory_exclusion_rate}%  (${result.detail.staleness.excluded_after}/${result.detail.staleness.recallable_before})`);
+            console.log(`  Live grounding rate:             ${result.metrics.live_grounding_rate}%  (${result.detail.live_memory.grounded}/${result.detail.live_memory.checked} packets)`);
+            console.log(`  Wrong-advice prevented:          ${result.metrics.wrong_advice_prevented_rate}%`);
+            if (!result.ok)
+                process.exitCode = 1;
+            return;
+        }
         if (args.includes("--memory-quality")) {
             const result = (0, kernel_js_1.benchmarkCodingMemoryQuality)({
                 topK: Number(takeArg(args, "--top-k") ?? 10),

package/dist/daemon.js

@@ -570,9 +570,12 @@ async function startViewer(projectDir, options = {}) {
     const memoryAuditPath = (0, node_path_1.join)(reportsDir, "memory-audit.json");
     const handoffPath = (0, node_path_1.join)(reportsDir, "handoff.json");
     const lifecyclePath = (0, node_path_1.join)(reportsDir, "lifecycle.json");
+    const activityPath = (0, node_path_1.join)(reportsDir, "activity.json");
     const timelinePath = (0, node_path_1.join)(reportsDir, "timeline.json");
     const lineagePath = (0, node_path_1.join)(reportsDir, "lineage.json");
     const setupPath = (0, node_path_1.join)(reportsDir, "setup.json");
+    const trustPath = (0, node_path_1.join)(reportsDir, "trust.json");
+    const suppressedPath = (0, node_path_1.join)(reportsDir, "suppressed.json");
     // Pre-generate lightweight JSON reports so the viewer can load them directly.
     try {
         (0, node_fs_1.mkdirSync)(reportsDir, { recursive: true });
@@ -598,14 +601,17 @@ async function startViewer(projectDir, options = {}) {
         (0, node_fs_1.writeFileSync)(memoryAuditPath, JSON.stringify((0, kernel_js_1.kageMemoryAudit)(projectDir), null, 2));
         (0, node_fs_1.writeFileSync)(handoffPath, JSON.stringify((0, kernel_js_1.kageMemoryHandoff)(projectDir), null, 2));
         (0, node_fs_1.writeFileSync)(lifecyclePath, JSON.stringify((0, kernel_js_1.kageMemoryLifecycle)(projectDir), null, 2));
+        (0, node_fs_1.writeFileSync)(activityPath, JSON.stringify((0, kernel_js_1.kageActivity)(projectDir), null, 2));
         (0, node_fs_1.writeFileSync)(timelinePath, JSON.stringify((0, kernel_js_1.kageMemoryTimeline)(projectDir), null, 2));
         (0, node_fs_1.writeFileSync)(lineagePath, JSON.stringify((0, kernel_js_1.kageMemoryLineage)(projectDir), null, 2));
         (0, node_fs_1.writeFileSync)(setupPath, JSON.stringify((0, kernel_js_1.setupDoctor)(projectDir), null, 2));
+        (0, node_fs_1.writeFileSync)(trustPath, JSON.stringify((0, kernel_js_1.benchmarkTrust)(projectDir), null, 2));
+        (0, node_fs_1.writeFileSync)(suppressedPath, JSON.stringify((0, kernel_js_1.kageSuppressedMemory)(projectDir), null, 2));
     }
     catch {
         // non-fatal: viewer will show 404 for reports if generation fails
     }
-    const url = `http://${host}:${port}/viewer/index.html?graph=${encodeURIComponent(graphPath)}&code=${encodeURIComponent(codePath)}&metrics=${encodeURIComponent(metricsPath)}&inbox=${encodeURIComponent(inboxPath)}&review=${encodeURIComponent(reviewPath)}&pending=${encodeURIComponent(pendingDir)}&quality=${encodeURIComponent(qualityPath)}&benchmark=${encodeURIComponent(benchmarkPath)}&contributors=${encodeURIComponent(contributorsPath)}&profile=${encodeURIComponent(profilePath)}&xray=${encodeURIComponent(xrayPath)}&capabilities=${encodeURIComponent(capabilitiesPath)}&slots=${encodeURIComponent(slotsPath)}&decisions=${encodeURIComponent(decisionsPath)}&risk=${encodeURIComponent(riskPath)}&moduleHealth=${encodeURIComponent(moduleHealthPath)}&graphInsights=${encodeURIComponent(graphInsightsPath)}&workspace=${encodeURIComponent(workspacePath)}&sessions=${encodeURIComponent(sessionsPath)}&replay=${encodeURIComponent(replayPath)}&memoryAccess=${encodeURIComponent(memoryAccessPath)}&memoryAudit=${encodeURIComponent(memoryAuditPath)}&handoff=${encodeURIComponent(handoffPath)}&lifecycle=${encodeURIComponent(lifecyclePath)}&timeline=${encodeURIComponent(timelinePath)}&lineage=${encodeURIComponent(lineagePath)}&setup=${encodeURIComponent(setupPath)}&view=code`;
+    const url = `http://${host}:${port}/viewer/index.html?graph=${encodeURIComponent(graphPath)}&code=${encodeURIComponent(codePath)}&metrics=${encodeURIComponent(metricsPath)}&inbox=${encodeURIComponent(inboxPath)}&review=${encodeURIComponent(reviewPath)}&pending=${encodeURIComponent(pendingDir)}&quality=${encodeURIComponent(qualityPath)}&benchmark=${encodeURIComponent(benchmarkPath)}&contributors=${encodeURIComponent(contributorsPath)}&profile=${encodeURIComponent(profilePath)}&xray=${encodeURIComponent(xrayPath)}&capabilities=${encodeURIComponent(capabilitiesPath)}&slots=${encodeURIComponent(slotsPath)}&decisions=${encodeURIComponent(decisionsPath)}&risk=${encodeURIComponent(riskPath)}&moduleHealth=${encodeURIComponent(moduleHealthPath)}&graphInsights=${encodeURIComponent(graphInsightsPath)}&workspace=${encodeURIComponent(workspacePath)}&sessions=${encodeURIComponent(sessionsPath)}&replay=${encodeURIComponent(replayPath)}&memoryAccess=${encodeURIComponent(memoryAccessPath)}&memoryAudit=${encodeURIComponent(memoryAuditPath)}&handoff=${encodeURIComponent(handoffPath)}&lifecycle=${encodeURIComponent(lifecyclePath)}&activity=${encodeURIComponent(activityPath)}&timeline=${encodeURIComponent(timelinePath)}&lineage=${encodeURIComponent(lineagePath)}&setup=${encodeURIComponent(setupPath)}&trust=${encodeURIComponent(trustPath)}&suppressed=${encodeURIComponent(suppressedPath)}&view=code`;
     const server = (0, node_http_1.createServer)((req, res) => {
         const requestUrl = new URL(req.url ?? "/", `http://${host}:${port}`);
         let filePath = null;

package/dist/index.js

@@ -590,7 +590,7 @@ function listTools() {
                 type: "object",
                 properties: {
                     project_dir: { type: "string" },
-                    mode: { type: "string", enum: ["project", "memory_quality", "memory_scale"] },
+                    mode: { type: "string", enum: ["project", "trust", "memory_quality", "memory_scale"] },
                     sizes: { type: "array", items: { type: "number" } },
                     top_k: { type: "number" },
                 },
@@ -1376,14 +1376,16 @@ async function callTool(name, args) {
     }
     if (name === "kage_benchmark") {
         const mode = String(args?.mode ?? "project");
-        const result = mode === "memory_quality"
-            ? (0, kernel_js_1.benchmarkCodingMemoryQuality)({ topK: Number(args?.top_k ?? 10) })
-            : mode === "memory_scale"
-                ? (0, kernel_js_1.benchmarkMemoryScale)({
-                    sizes: Array.isArray(args?.sizes) ? args.sizes.map(Number) : undefined,
-                    topK: Number(args?.top_k ?? 10),
-                })
-                : (0, kernel_js_1.benchmarkProject)(String(args?.project_dir ?? ""));
+        const result = mode === "trust"
+            ? (0, kernel_js_1.benchmarkTrust)(String(args?.project_dir ?? ""))
+            : mode === "memory_quality"
+                ? (0, kernel_js_1.benchmarkCodingMemoryQuality)({ topK: Number(args?.top_k ?? 10) })
+                : mode === "memory_scale"
+                    ? (0, kernel_js_1.benchmarkMemoryScale)({
+                        sizes: Array.isArray(args?.sizes) ? args.sizes.map(Number) : undefined,
+                        topK: Number(args?.top_k ?? 10),
+                    })
+                    : (0, kernel_js_1.benchmarkProject)(String(args?.project_dir ?? ""));
         return {
             content: [{ type: "text", text: JSON.stringify(result, null, 2) }],
         };
@@ -1692,5 +1694,16 @@ async function main() {
     await server.connect(transport);
 }
 if (require.main === module) {
+    const firstArg = process.argv[2];
+    if (firstArg && !firstArg.startsWith("-")) {
+        // A positional subcommand (demo, init, recall, ...) means the user wants the
+        // kage CLI, not the MCP stdio server. Delegate so a single
+        // `npx @kage-core/kage-graph-mcp <command>` works like the `kage` binary.
+        // MCP clients launch with no args (or flags), which falls through to the server.
+        const { spawnSync } = require("node:child_process");
+        const { join } = require("node:path");
+        const result = spawnSync(process.execPath, [join(__dirname, "cli.js"), ...process.argv.slice(2)], { stdio: "inherit" });
+        process.exit(result.status ?? 0);
+    }
     main().catch(console.error);
 }