@kage-core/kage-graph-mcp 2.2.2 → 2.2.4

package/dist/cli.js

@@ -14,8 +14,8 @@ const CORE_USAGE = `Kage — code-grounded memory for coding agents
 
 Core commands:
   kage install [--project <dir>]             one-shot: init + index + auto-wire detected agents
-  kage demo                                  30-second trust demo (temp dir)
   kage scan --project <dir>                  60-second truth report on any repo (zero setup)
+  kage demo                                  watch the reject/withhold loop run in a sandbox
   kage init --project <dir>                  create repo memory (.agent_memory only)
   kage index --project <dir> [--full]        build/refresh code graph + indexes
   kage recall "<query>" --project <dir>      grounded recall from repo memory
@@ -294,7 +294,14 @@ async function main() {
         return;
     }
     if (command === "scan") {
-        const result = (0, kernel_js_1.truthReport)(projectArg(args));
+        const scanTarget = (0, node_path_1.resolve)(projectArg(args));
+        if (scanTarget === (0, node_os_1.homedir)()) {
+            console.log("That's your home directory, not a repo — scanning it would crawl everything you own.");
+            console.log("cd into a project and rerun, or point at one:");
+            console.log("  npx -y kage-graph-mcp scan --project /path/to/repo");
+            process.exit(2);
+        }
+        const result = (0, kernel_js_1.truthReport)(scanTarget);
         if (args.includes("--json")) {
             console.log(JSON.stringify(result, null, 2));
             return;

package/dist/kernel.js

@@ -1947,9 +1947,24 @@ function walkFiles(root, predicate) {
     if (!(0, node_fs_1.existsSync)(root))
         return [];
     const out = [];
-    for (const entry of (0, node_fs_1.readdirSync)(root)) {
+    // Unreadable entries (macOS ~/.Trash, permission-locked dirs) are skipped,
+    // never fatal — a scan of an imperfect tree should report, not crash.
+    let entries = [];
+    try {
+        entries = (0, node_fs_1.readdirSync)(root);
+    }
+    catch {
+        return out;
+    }
+    for (const entry of entries) {
         const path = (0, node_path_1.join)(root, entry);
-        const stats = (0, node_fs_1.statSync)(path);
+        let stats;
+        try {
+            stats = (0, node_fs_1.statSync)(path);
+        }
+        catch {
+            continue;
+        }
         if (stats.isDirectory())
             out.push(...walkFiles(path, predicate));
         else if (predicate(path))
@@ -3291,7 +3306,15 @@ function scanStructuralFiles(projectDir) {
     const visit = (dir) => {
         if (!(0, node_fs_1.existsSync)(dir))
             return;
-        for (const entry of (0, node_fs_1.readdirSync)(dir)) {
+        let dirEntries = [];
+        try {
+            dirEntries = (0, node_fs_1.readdirSync)(dir);
+        }
+        catch {
+            ignore("unreadable_dir");
+            return;
+        }
+        for (const entry of dirEntries) {
             const absolutePath = (0, node_path_1.join)(dir, entry);
             const rel = (0, node_path_1.relative)(projectDir, absolutePath).replace(/\\/g, "/");
             if (shouldSkipCodePath(rel)) {
@@ -8887,9 +8910,9 @@ function truthReport(projectDir) {
         findings,
         warnings,
         next_actions: [
-            "kage init --project <dir>     create repo memory so this knowledge stops living in one head",
-            "kage learn --project <dir> --learning \"...\" --paths <file>     capture what only your team knows",
-            "kage viewer --project <dir>     watch the void close",
+            "npx -y @kage-core/kage-graph-mcp install      one command: creates repo memory + wires your agents (Claude Code, Codex, Cursor, ...)",
+            "then just work — agents capture learnings and recall them, verified against this code",
+            "kage gains --project .      the receipt: what the memory loop saved you this week",
         ],
     };
 }
@@ -15522,14 +15545,18 @@ function repairProject(projectDir, options = {}) {
 // Map a CLI failure to ONE copy-pasteable next command. Pure on purpose:
 // remediation must be unit-testable without throwing real errors.
 function remediationFor(error) {
+    const msg0 = String(error?.message ?? error ?? "");
+    if (/EPERM|EACCES|scandir/i.test(msg0)) {
+        return "point --project at a code repository (a permission-locked folder was hit; system folders like ~/.Trash can't be read)";
+    }
     const text = error instanceof Error ? error.message : String(error);
     if (/ENOENT/i.test(text) && /\.agent_memory/.test(text))
-        return "kage init --project .";
+        return "npx -y kage-graph-mcp init --project .";
     if (/Unexpected token|Unexpected end of JSON|is not valid JSON|JSON\.parse|in JSON at position/i.test(text))
-        return "kage repair --project .";
+        return "npx -y kage-graph-mcp repair --project .";
     if (/\bindex(es)?\b|\bgraph\b/i.test(text))
-        return "kage index --project .";
-    return "kage doctor --project .";
+        return "npx -y kage-graph-mcp index --project .";
+    return "npx -y kage-graph-mcp doctor --project .";
 }
 function approvePending(projectDir, id) {
     const pendingFiles = walkFiles(pendingDir(projectDir), (path) => path.endsWith(".json"));

package/package.json

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