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

package/dist/index.js

@@ -74,7 +74,7 @@ function riskContextBlock(result) {
     });
     return `\n## Risk Signals\n${lines.join("\n")}`;
 }
-const server = new index_js_1.Server({ name: "kage-graph", version: "1.1.7" }, { capabilities: { tools: {} } });
+const server = new index_js_1.Server({ name: "kage-graph", version: "2.0.0" }, { capabilities: { tools: {} } });
 function listTools() {
     return [
         {
@@ -479,7 +479,7 @@ function listTools() {
         },
         {
             name: "kage_pr_check",
-            description: "Check whether repo memory, code graph, memory graph, and stale-memory state are ready for merge.",
+            description: "Check whether repo memory, code graph, memory graph, and stale-memory state are ready for merge. Leads with a human summary of team memories invalidated by the current change — relay it to the developer.",
             inputSchema: {
                 type: "object",
                 properties: {
@@ -850,107 +850,6 @@ function listTools() {
                 required: ["project_dir"],
             },
         },
-        {
-            name: "kage_marketplace",
-            description: "Build a local marketplace manifest for recommended docs, skills, and MCP packs. This never installs anything automatically.",
-            inputSchema: {
-                type: "object",
-                properties: {
-                    project_dir: { type: "string" },
-                },
-                required: ["project_dir"],
-            },
-        },
-        {
-            name: "kage_org_status",
-            description: "Inspect the local org-memory inbox, approved packets, rejected packets, audit count, and registry path.",
-            inputSchema: {
-                type: "object",
-                properties: {
-                    project_dir: { type: "string" },
-                    org: { type: "string" },
-                },
-                required: ["project_dir", "org"],
-            },
-        },
-        {
-            name: "kage_org_upload_candidate",
-            description: "Upload an approved repo packet into the local org review inbox. This creates a candidate only; it does not approve org memory.",
-            inputSchema: {
-                type: "object",
-                properties: {
-                    project_dir: { type: "string" },
-                    org: { type: "string" },
-                    packet_id: { type: "string" },
-                },
-                required: ["project_dir", "org", "packet_id"],
-            },
-        },
-        {
-            name: "kage_org_recall",
-            description: "Recall approved local org memory. Repo-local recall should still take priority when results conflict.",
-            inputSchema: {
-                type: "object",
-                properties: {
-                    project_dir: { type: "string" },
-                    org: { type: "string" },
-                    query: { type: "string" },
-                    limit: { type: "number" },
-                    json: { type: "boolean" },
-                },
-                required: ["project_dir", "org", "query"],
-            },
-        },
-        {
-            name: "kage_layered_recall",
-            description: "Recall with Kage's priority order: branch > repo local > org > global. Org/global are included only when explicitly requested.",
-            inputSchema: {
-                type: "object",
-                properties: {
-                    project_dir: { type: "string" },
-                    query: { type: "string" },
-                    org: { type: "string" },
-                    include_global: { type: "boolean" },
-                    json: { type: "boolean" },
-                },
-                required: ["project_dir", "query"],
-            },
-        },
-        {
-            name: "kage_global_build",
-            description: "Build a local static global/CDN bundle from human-promoted public candidates and the marketplace manifest. This does not upload anywhere.",
-            inputSchema: {
-                type: "object",
-                properties: {
-                    project_dir: { type: "string" },
-                    org: { type: "string" },
-                },
-                required: ["project_dir"],
-            },
-        },
-        {
-            name: "kage_promote_public_candidate",
-            description: "Create a sanitized local public-review candidate from an approved repo memory packet. This does not publish to the global graph.",
-            inputSchema: {
-                type: "object",
-                properties: {
-                    project_dir: { type: "string" },
-                    packet_id: { type: "string" },
-                },
-                required: ["project_dir", "packet_id"],
-            },
-        },
-        {
-            name: "kage_export_public_bundle",
-            description: "Export local public-review candidates as a static public bundle catalog. This still does not publish anywhere.",
-            inputSchema: {
-                type: "object",
-                properties: {
-                    project_dir: { type: "string" },
-                },
-                required: ["project_dir"],
-            },
-        },
         {
             name: "kage_review_artifact",
             description: "Create a Markdown review artifact summarizing pending memory packets for PR or human review.",
@@ -979,6 +878,7 @@ server.setRequestHandler(types_js_1.ListToolsRequestSchema, async () => ({
     tools: listTools(),
 }));
 async function callTool(name, args) {
+    await (0, kernel_js_1.ensureTreeSitterLanguages)();
     if (name === "kage_list_domains") {
         const catalog = await fetchJSON(`${BASE_URL}/catalog.json`);
         const lines = Object.entries(catalog.domains)
@@ -1116,6 +1016,11 @@ async function callTool(name, args) {
             dependencyResult ? `\n## Dependency Path\n${dependencyResult.summary}${dependencyResult.path.length ? `\nPath: ${dependencyResult.path.join(" -> ")}` : ""}` : "",
             reconciliation.unresolved_count ? `\n## Memory Reconciliation\n${reconciliation.agent_instruction}` : "",
             `\n_${validationText}_`,
+            // Visible receipt: surface what the harness saved today so agents relay it.
+            (() => {
+                const gains = (0, kernel_js_1.valueSummary)(projectDir).today;
+                return `\n\nGains: ~${(0, kernel_js_1.formatTokenCount)(gains.tokens_saved)} tokens saved this session · stale memories withheld: ${gains.stale_withheld}`;
+            })(),
         ].filter(Boolean).join("");
         return {
             content: [{ type: "text", text: sections }],
@@ -1352,9 +1257,13 @@ async function callTool(name, args) {
         };
     }
     if (name === "kage_pr_check") {
-        const result = (0, kernel_js_1.prCheck)(String(args?.project_dir ?? ""));
+        const projectDir = String(args?.project_dir ?? "");
+        // Lead with the stale-catch moment so agents relay "your changes
+        // invalidated team memory" to the developer instead of burying it in JSON.
+        const guard = (0, kernel_js_1.formatStaleCatch)((0, kernel_js_1.staleCatch)(projectDir)).join("\n");
+        const result = (0, kernel_js_1.prCheck)(projectDir);
         return {
-            content: [{ type: "text", text: JSON.stringify(result, null, 2) }],
+            content: [{ type: "text", text: `${guard}\n\n${JSON.stringify(result, null, 2)}` }],
             isError: !result.ok,
         };
     }
@@ -1586,83 +1495,6 @@ async function callTool(name, args) {
             content: [{ type: "text", text: JSON.stringify(result, null, 2) }],
         };
     }
-    if (name === "kage_marketplace") {
-        const result = (0, kernel_js_1.buildMarketplace)(String(args?.project_dir ?? ""));
-        return {
-            content: [{ type: "text", text: JSON.stringify(result, null, 2) }],
-            isError: !result.ok,
-        };
-    }
-    if (name === "kage_org_status") {
-        const result = (0, kernel_js_1.orgStatus)(String(args?.project_dir ?? ""), String(args?.org ?? "local"));
-        return {
-            content: [{ type: "text", text: JSON.stringify(result, null, 2) }],
-        };
-    }
-    if (name === "kage_org_upload_candidate") {
-        const result = (0, kernel_js_1.orgUploadPacket)(String(args?.project_dir ?? ""), String(args?.org ?? "local"), String(args?.packet_id ?? ""));
-        return {
-            content: [
-                {
-                    type: "text",
-                    text: result.ok
-                        ? `Created org review candidate: ${result.path}\nApprove explicitly with: kage org review --approve`
-                        : `Org upload blocked:\n${result.errors.map((error) => `- ${error}`).join("\n")}`,
-                },
-            ],
-            isError: !result.ok,
-        };
-    }
-    if (name === "kage_org_recall") {
-        const result = (0, kernel_js_1.orgRecall)(String(args?.project_dir ?? ""), String(args?.org ?? "local"), String(args?.query ?? ""), Number(args?.limit ?? 5));
-        return {
-            content: [{ type: "text", text: args?.json ? JSON.stringify(result, null, 2) : result.context_block }],
-        };
-    }
-    if (name === "kage_layered_recall") {
-        const result = (0, kernel_js_1.layeredRecall)(String(args?.project_dir ?? ""), String(args?.query ?? ""), {
-            org: args?.org ? String(args.org) : undefined,
-            includeGlobal: Boolean(args?.include_global),
-        });
-        return {
-            content: [{ type: "text", text: args?.json ? JSON.stringify(result, null, 2) : result.context_block }],
-        };
-    }
-    if (name === "kage_global_build") {
-        const result = (0, kernel_js_1.buildGlobalCdnBundle)(String(args?.project_dir ?? ""), String(args?.org ?? "local"));
-        return {
-            content: [{ type: "text", text: JSON.stringify(result, null, 2) }],
-            isError: !result.ok,
-        };
-    }
-    if (name === "kage_promote_public_candidate") {
-        const result = (0, kernel_js_1.createPublicCandidate)(String(args?.project_dir ?? ""), String(args?.packet_id ?? ""));
-        return {
-            content: [
-                {
-                    type: "text",
-                    text: result.ok
-                        ? `Created local public-review candidate: ${result.path}\nThis does not publish until a human submits it.`
-                        : `Promotion blocked:\n${result.errors.map((error) => `- ${error}`).join("\n")}`,
-                },
-            ],
-            isError: !result.ok,
-        };
-    }
-    if (name === "kage_export_public_bundle") {
-        const result = (0, kernel_js_1.exportPublicBundle)(String(args?.project_dir ?? ""));
-        return {
-            content: [
-                {
-                    type: "text",
-                    text: result.ok
-                        ? `Exported public bundle: ${result.path}\nPackets: ${result.packetCount}`
-                        : `Public bundle blocked:\n${result.errors.map((error) => `- ${error}`).join("\n")}`,
-                },
-            ],
-            isError: !result.ok,
-        };
-    }
     if (name === "kage_review_artifact") {
         const result = (0, kernel_js_1.createReviewArtifact)(String(args?.project_dir ?? ""));
         return {
@@ -1705,5 +1537,15 @@ if (require.main === module) {
         const result = spawnSync(process.execPath, [join(__dirname, "cli.js"), ...process.argv.slice(2)], { stdio: "inherit" });
         process.exit(result.status ?? 0);
     }
+    if (process.stdin.isTTY && process.stdout.isTTY) {
+        // A human in a terminal, not an MCP client: blocking silently on stdio here
+        // reads as "the tool printed nothing and hung". Run the 30-second demo instead.
+        const { spawnSync } = require("node:child_process");
+        const { join } = require("node:path");
+        console.log("Kage MCP server — normally launched by an MCP client (Claude Code, Codex, Cursor, ...).");
+        console.log("You're in a terminal, so here's the 30-second demo instead:\n");
+        const result = spawnSync(process.execPath, [join(__dirname, "cli.js"), "demo"], { stdio: "inherit" });
+        process.exit(result.status ?? 0);
+    }
     main().catch(console.error);
 }