@kage-core/kage-graph-mcp 2.5.1 → 2.5.2

package/dist/cli.js

@@ -1411,21 +1411,30 @@ async function main() {
         const query = takeArg(args, "--query") ?? firstPositional(args);
         if (!query)
             usage();
-        const result = (0, kernel_js_1.recall)(projectArg(args), query, 5, false, {});
+        const project = projectArg(args);
+        const result = (0, kernel_js_1.recall)(project, query, 5, false, {});
+        // Surface any nudges the kage-watcher wrote (marks them surfaced so each shows once) —
+        // this is what makes recall/nudges felt instead of silently sitting in a file.
+        const nudges = (0, kernel_js_1.surfacePendingNudges)(project);
         if (args.includes("--json")) {
-            console.log(JSON.stringify(result, null, 2));
+            console.log(JSON.stringify({ ...result, nudges: nudges.items }, null, 2));
             return;
         }
-        if (!result.results.length)
+        const parts = [];
+        if (result.results.length) {
+            // Lead with felt behavior, not a vanity/gameable token number: tell the agent these are
+            // verified team memories to follow. (The tokens/$ ledger lives in `kage gains`.) Keep
+            // only the trust-relevant stale-withheld signal here.
+            const plural = result.results.length === 1 ? "y" : "ies";
+            const withheld = result.value_receipt?.stale_withheld ?? 0;
+            parts.push(result.context_block);
+            parts.push(`_${result.results.length} verified team memor${plural} above — follow them.${withheld ? ` ${withheld} stale memor${withheld === 1 ? "y" : "ies"} withheld (code changed under them).` : ""}_`);
+        }
+        if (nudges.block)
+            parts.push(nudges.block.trimStart());
+        if (!parts.length)
             return;
-        let out = result.context_block;
-        // Lead with felt behavior, not a vanity/gameable token number: tell the agent these are
-        // verified team memories to follow. (The tokens/$ ledger lives in `kage gains` for anyone
-        // who wants it.) Keep only the trust-relevant stale-withheld signal here.
-        const plural = result.results.length === 1 ? "y" : "ies";
-        const withheld = result.value_receipt?.stale_withheld ?? 0;
-        out += `\n\n_${result.results.length} verified team memor${plural} above — follow them.${withheld ? ` ${withheld} stale memor${withheld === 1 ? "y" : "ies"} withheld (code changed under them).` : ""}_`;
-        console.log(out);
+        console.log(parts.join("\n\n"));
         return;
     }
     if (command === "memory-access") {

package/dist/kernel.js

@@ -102,6 +102,7 @@ exports.compactProject = compactProject;
 exports.installAgentPolicy = installAgentPolicy;
 exports.createDenseEmbeddingProvider = createDenseEmbeddingProvider;
 exports.buildEmbeddingIndex = buildEmbeddingIndex;
+exports.surfacePendingNudges = surfacePendingNudges;
 exports.recall = recall;
 exports.recallWithEmbeddings = recallWithEmbeddings;
 exports.queryCodeGraph = queryCodeGraph;
@@ -7942,7 +7943,10 @@ function isSerializedDumpTitle(title) {
     return /^(workflow|runbook)\s*:?\s*[{[]/i.test(t)
         || t.startsWith('{"')
         || /^<(task-notification|div|svg|html)\b/i.test(t)
-        || /\btool_use_id\b|toolu_[A-Za-z0-9]{10}/.test(title);
+        || /\btool_use_id\b|toolu_[A-Za-z0-9]{10}/.test(title)
+        // Shell-prompt / terminal paste, e.g. "user@host dir % cmd" or "user@host:path$ cmd" —
+        // a pasted command transcript, not a durable learning.
+        || /^[\w.+-]+@[\w.+-]+[\s:].*[%$#]\s/.test(t);
 }
 // Durable-learning size ceiling. A memory packet body is a distilled insight, not a
 // document; anything past this is almost certainly a raw transcript, file-content, or
@@ -7961,6 +7965,51 @@ function isSerializedDumpBody(body) {
     return isSerializedDumpTitle(t)
         || /<task-notification\b|<tool-use-id\b|"hookSpecificOutput"|"isImage"\s*:|"noOutputExpected"\s*:|"interrupted"\s*:\s*(true|false)/i.test(t.slice(0, 4000));
 }
+// Surface watcher nudges: read the nudge inbox the kage-watcher writes, return the
+// unsurfaced ones as a prominent block, and mark them surfaced so each shows exactly once.
+// This is what makes recall/nudges FELT — the UserPromptSubmit hook injects this block, so
+// the agent sees "act on this" memory instead of it sitting silently in a file.
+function surfacePendingNudges(projectDir) {
+    const path = (0, node_path_1.join)(projectDir, ".agent_memory", "nudges", "pending.jsonl");
+    if (!(0, node_fs_1.existsSync)(path))
+        return { block: "", items: [], count: 0 };
+    let raw;
+    try {
+        raw = (0, node_fs_1.readFileSync)(path, "utf8");
+    }
+    catch {
+        return { block: "", items: [], count: 0 };
+    }
+    const records = [];
+    for (const line of raw.split("\n")) {
+        const trimmed = line.trim();
+        if (!trimmed)
+            continue;
+        try {
+            const parsed = JSON.parse(trimmed);
+            if (parsed && typeof parsed === "object")
+                records.push(parsed);
+        }
+        catch { /* drop malformed lines */ }
+    }
+    const unsurfaced = records.filter((record) => record.surfaced !== true && typeof record.message === "string");
+    if (!unsurfaced.length)
+        return { block: "", items: [], count: 0 };
+    const items = unsurfaced.map((record) => ({
+        message: String(record.message),
+        file: typeof record.file === "string" ? record.file : undefined,
+        kind: typeof record.kind === "string" ? record.kind : undefined,
+    }));
+    for (const record of unsurfaced)
+        record.surfaced = true;
+    try {
+        (0, node_fs_1.writeFileSync)(path, `${records.map((record) => JSON.stringify(record)).join("\n")}\n`, "utf8");
+    }
+    catch { /* best-effort; recall still works */ }
+    const block = ["", "## ⚠ Kage nudges — act on these before proceeding",
+        ...items.map((item) => `- ${item.file ? `${item.file}: ` : ""}${item.message}`)].join("\n");
+    return { block, items, count: items.length };
+}
 // Collapse whitespace and hard-cap a value rendered inline in a context block, so one
 // oversized field (e.g. a graph fact whose body is a raw transcript) can never blow up
 // the assembled output — the 270k-char overflow that motivated this guard.

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@kage-core/kage-graph-mcp",
-  "version": "2.5.1",
+  "version": "2.5.2",
   "description": "Team memory for coding agents: captures the decisions, runbooks, and bug fixes that get lost, verified against your code and shared via git. MCP server, zero deps, no account.",
   "main": "dist/index.js",
   "files": [