@kage-core/kage-graph-mcp 1.1.24 → 1.1.25

package/dist/kernel.js

@@ -460,6 +460,12 @@ function estimateTokens(text) {
 function packetText(packet) {
     return `${packet.title}\n${packet.summary}\n${packet.body}\n${packet.type}\n${packet.tags.join(" ")}\n${packet.paths.join(" ")}`;
 }
+function isGeneratedChangeMemory(packet) {
+    return packet.type === "workflow"
+        && packet.tags.includes("change-memory")
+        && packet.tags.includes("diff-proposal")
+        && packet.source_refs.some((ref) => ref.kind === "git_diff");
+}
 function tokenSet(text) {
     return new Set(tokenize(text).filter((term) => term.length > 2));
 }
@@ -476,6 +482,7 @@ function duplicateCandidates(projectDir, packet, threshold = 0.58) {
     const current = tokenSet(packetText(packet));
     return [...loadApprovedPackets(projectDir), ...loadPendingPackets(projectDir)]
         .filter((candidate) => candidate.id !== packet.id)
+        .filter((candidate) => !(isGeneratedChangeMemory(packet) && isGeneratedChangeMemory(candidate)))
         .map((candidate) => ({ packet: candidate, score: jaccard(current, tokenSet(packetText(candidate))) }))
         .filter((entry) => entry.score >= threshold)
         .sort((a, b) => b.score - a.score || a.packet.title.localeCompare(b.packet.title))
@@ -888,6 +895,30 @@ function readGit(projectDir, args) {
         return null;
     }
 }
+function safeStat(path) {
+    try {
+        return (0, node_fs_1.statSync)(path);
+    }
+    catch {
+        return null;
+    }
+}
+function safeLstat(path) {
+    try {
+        return (0, node_fs_1.lstatSync)(path);
+    }
+    catch {
+        return null;
+    }
+}
+function safeReadText(path) {
+    try {
+        return (0, node_fs_1.readFileSync)(path, "utf8");
+    }
+    catch {
+        return null;
+    }
+}
 function gitBranch(projectDir) {
     return readGit(projectDir, ["branch", "--show-current"]) || readGit(projectDir, ["rev-parse", "--short", "HEAD"]);
 }
@@ -901,6 +932,12 @@ function gitMergeBase(projectDir) {
     return readGit(projectDir, ["merge-base", "HEAD", "origin/main"])
         || readGit(projectDir, ["merge-base", "HEAD", "origin/master"]);
 }
+function gitProjectPrefix(projectDir) {
+    const prefix = readGit(projectDir, ["rev-parse", "--show-prefix"]);
+    if (prefix === null)
+        return null;
+    return prefix.replace(/\\/g, "/").replace(/\/+$/, "");
+}
 // Directories that are never meaningful in change-memory packets.
 // These are typically generated, vendored, or ephemeral — any project can
 // accumulate thousands of files here that bury real signal.
@@ -934,12 +971,26 @@ function isNoisePath(filePath) {
         return false;
     return NOISE_PATH_PREFIXES.some((prefix) => filePath.startsWith(prefix));
 }
-function parsePorcelainStatus(status) {
+function gitPathToProjectRelative(projectDir, path) {
+    const normalized = path.replace(/\\/g, "/").replace(/^\/+/, "");
+    const projectPrefix = gitProjectPrefix(projectDir);
+    if (projectPrefix === null || projectPrefix === "")
+        return normalized;
+    if (normalized === projectPrefix)
+        return "";
+    const prefix = `${projectPrefix}/`;
+    if (!normalized.startsWith(prefix)) {
+        return (0, node_fs_1.existsSync)((0, node_path_1.join)(projectDir, normalized)) ? normalized : null;
+    }
+    return normalized.slice(prefix.length);
+}
+function parsePorcelainStatus(projectDir, status) {
     return unique(status
         .split(/\r?\n/)
         .map(parsePorcelainPath)
         .map((path) => path.replace(/^.* -> /, ""))
-        .filter(Boolean)
+        .map((path) => gitPathToProjectRelative(projectDir, path))
+        .filter((path) => Boolean(path))
         .filter((path) => !shouldSkipRepoMemoryPath(path))).sort();
 }
 function parsePorcelainPath(line) {
@@ -948,13 +999,14 @@ function parsePorcelainPath(line) {
 }
 function branchDiffStat(projectDir, changedFiles) {
     const diffStats = [
-        readGit(projectDir, ["diff", "--stat"]),
-        readGit(projectDir, ["diff", "--cached", "--stat"]),
+        readGit(projectDir, ["diff", "--stat", "--relative"]),
+        readGit(projectDir, ["diff", "--cached", "--stat", "--relative"]),
     ].filter(Boolean).join("\n").trim();
     const untracked = new Set((readGit(projectDir, ["ls-files", "--others", "--exclude-standard"]) ?? "")
         .split(/\r?\n/)
         .map((path) => path.trim())
-        .filter(Boolean)
+        .map((path) => gitPathToProjectRelative(projectDir, path))
+        .filter((path) => Boolean(path))
         .filter((path) => changedFiles.includes(path)));
     const untrackedStats = [...untracked]
         .filter((file) => !diffStats.includes(file))
@@ -1016,8 +1068,9 @@ function createRepoOverviewPacket(projectDir) {
         if (deps.stripe)
             tags.push("stripe");
     }
-    if ((0, node_fs_1.existsSync)(readmePath)) {
-        const readme = (0, node_fs_1.readFileSync)(readmePath, "utf8").slice(0, 1000);
+    const readmeText = (0, node_fs_1.existsSync)(readmePath) ? safeReadText(readmePath) : null;
+    if (readmeText) {
+        const readme = readmeText.slice(0, 1000);
         bodyParts.push(`README excerpt:\n${readme}`);
     }
     const createdAt = nowIso();
@@ -1038,7 +1091,7 @@ function createRepoOverviewPacket(projectDir) {
         stack,
         source_refs: [
             ...((0, node_fs_1.existsSync)(packagePath) ? [{ kind: "file", path: "package.json" }] : []),
-            ...((0, node_fs_1.existsSync)(readmePath) ? [{ kind: "file", path: "README.md" }] : []),
+            ...(readmeText ? [{ kind: "file", path: "README.md" }] : []),
         ],
         context: {
             fact: "Generated repo overview summarizes package metadata and the README as a navigation aid for agent startup.",
@@ -1748,7 +1801,20 @@ function scanStructuralFiles(projectDir) {
                 ignore("kageignore");
                 continue;
             }
-            const stats = (0, node_fs_1.statSync)(absolutePath);
+            const linkStats = safeLstat(absolutePath);
+            if (!linkStats) {
+                ignore("unreadable_path");
+                continue;
+            }
+            if (linkStats.isSymbolicLink()) {
+                ignore("symlink");
+                continue;
+            }
+            const stats = safeStat(absolutePath);
+            if (!stats) {
+                ignore("unreadable_path");
+                continue;
+            }
             if (stats.isDirectory()) {
                 visit(absolutePath);
                 continue;
@@ -5282,10 +5348,14 @@ function baselineDiscoveryFiles(projectDir, task) {
         const absolute = (0, node_path_1.join)(projectDir, path);
         if (!(0, node_fs_1.existsSync)(absolute))
             return null;
-        const stats = (0, node_fs_1.statSync)(absolute);
+        const stats = safeStat(absolute);
+        if (!stats)
+            return null;
         if (!stats.isFile() || stats.size > 240_000)
             return null;
-        const text = (0, node_fs_1.readFileSync)(absolute, "utf8");
+        const text = safeReadText(absolute);
+        if (text === null)
+            return null;
         const score = scoreText(terms, `${path}\n${text.slice(0, 8000)}`, [path]);
         const alwaysUseful = ["README.md", "AGENTS.md", "CLAUDE.md", "package.json"].includes(path);
         if (score <= 0 && !alwaysUseful)
@@ -6421,7 +6491,7 @@ function proposeFromDiff(projectDir) {
     const status = readGit(projectDir, ["status", "--porcelain", "-uall"]);
     if (status === null)
         return { ok: false, changedFiles: [], errors: ["Not a git repository or git is unavailable."] };
-    const changedFiles = parsePorcelainStatus(status);
+    const changedFiles = parsePorcelainStatus(projectDir, status);
     if (changedFiles.length === 0)
         return { ok: false, changedFiles: [], errors: ["No changed files found."] };
     const stat = branchDiffStat(projectDir, changedFiles);
@@ -6470,7 +6540,7 @@ function buildBranchOverlay(projectDir) {
         branch: gitBranch(projectDir),
         head: gitHead(projectDir),
         merge_base: gitMergeBase(projectDir),
-        changed_files: parsePorcelainStatus(status),
+        changed_files: parsePorcelainStatus(projectDir, status),
         pending_packet_ids: loadPendingPackets(projectDir).map((packet) => packet.id).sort(),
         generated_at: nowIso(),
     };

package/package.json

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

package/viewer/index.html

@@ -4,7 +4,7 @@
     <meta charset="utf-8">
     <meta name="viewport" content="width=device-width, initial-scale=1">
     <title>Kage Memory Terminal</title>
-    <link rel="stylesheet" href="./styles.css?v=17">
+    <link rel="stylesheet" href="./styles.css?v=19">
   </head>
   <body>
     <header class="app-header">
@@ -13,6 +13,12 @@
         <h1>Memory Terminal</h1>
         <p id="graphSummary">Load memory, code, and metrics graphs to inspect what agents know and why.</p>
       </div>
+      <nav class="site-links" aria-label="Kage site links">
+        <a href="../">Home</a>
+        <a href="../guide.html">Docs</a>
+        <a href="../releases.html">Releases</a>
+        <a href="https://github.com/kage-core/Kage">GitHub</a>
+      </nav>
       <div id="statusStrip" class="status-strip" aria-label="Graph health"></div>
       <div id="autoLoadStatus" class="autoload-status">auto-load: waiting</div>
       <label class="file-picker">
@@ -157,6 +163,6 @@
       </section>
     </main>
 
-    <script src="./app.js?v=17"></script>
+    <script src="./app.js?v=19"></script>
   </body>
 </html>

package/viewer/styles.css

@@ -40,7 +40,10 @@ h2 { color: var(--terminal); font-size: 13px; letter-spacing: 0.04em; text-trans
 
 .app-header {
   display: grid;
-  grid-template-columns: minmax(0, 1fr) auto auto auto;
+  grid-template-columns: minmax(360px, 1fr) auto auto;
+  grid-template-areas:
+    "brand links picker"
+    "status status autoload";
   gap: 16px;
   align-items: center;
   padding: 14px 18px;
@@ -52,7 +55,11 @@ h2 { color: var(--terminal); font-size: 13px; letter-spacing: 0.04em; text-trans
   z-index: 10;
 }
 
-.brand-block { min-width: 0; }
+.brand-block {
+  grid-area: brand;
+  min-width: 280px;
+  max-width: 620px;
+}
 .eyebrow {
   display: inline-flex;
   margin-bottom: 5px;
@@ -72,14 +79,42 @@ h2 { color: var(--terminal); font-size: 13px; letter-spacing: 0.04em; text-trans
   overflow-wrap: anywhere;
 }
 
+.site-links {
+  grid-area: links;
+  display: flex;
+  flex-wrap: wrap;
+  gap: 10px;
+  justify-content: flex-end;
+}
+.site-links a {
+  display: inline-flex;
+  align-items: center;
+  min-height: 28px;
+  padding: 4px 9px;
+  border: 1px solid var(--line);
+  border-radius: 4px;
+  background: rgba(13, 25, 19, 0.86);
+  color: var(--terminal-dim);
+  font-size: 11px;
+  font-weight: 780;
+  text-decoration: none;
+  white-space: nowrap;
+}
+.site-links a:hover {
+  border-color: var(--line-strong);
+  color: var(--terminal-strong);
+}
+
 .status-strip {
+  grid-area: status;
   display: flex;
   flex-wrap: wrap;
   gap: 8px;
-  justify-content: flex-end;
+  justify-content: flex-start;
 }
 
 .autoload-status {
+  grid-area: autoload;
   display: inline-flex;
   align-items: center;
   min-height: 28px;
@@ -131,6 +166,7 @@ h2 { color: var(--terminal); font-size: 13px; letter-spacing: 0.04em; text-trans
   font-weight: 780;
   box-shadow: inset 0 0 0 1px rgba(65, 255, 143, 0.10);
 }
+.file-picker { grid-area: picker; }
 .file-picker:hover, button:hover { background: #0d1f15; }
 .file-picker input {
   position: absolute;
@@ -702,6 +738,12 @@ input:focus, select:focus, button:focus, .file-picker:focus-within {
 @media (max-width: 1120px) {
   .app-header {
     grid-template-columns: 1fr;
+    grid-template-areas:
+      "brand"
+      "links"
+      "status"
+      "autoload"
+      "picker";
     align-items: stretch;
     padding: 12px 14px;
   }