@kage-core/kage-graph-mcp 1.1.37 → 1.1.38

package/dist/cli.js

@@ -47,6 +47,7 @@ Usage:
   kage supersede --project <dir> --packet <old-id> --replacement <new-id> [--reason <text>] [--json]
   kage contributors --project <dir> [--json]
   kage profile --project <dir> [--json]
+  kage xray --project <dir> [--json]
   kage capabilities --project <dir> [--json]
   kage decisions --project <dir> [--json]
   kage module-health --project <dir> [--json]
@@ -692,6 +693,27 @@ async function main() {
             console.log(`Warnings:\n${result.warnings.map((warning) => `  - ${warning}`).join("\n")}`);
         return;
     }
+    if (command === "xray" || command === "repo-xray") {
+        const result = (0, kernel_js_1.kageRepoXray)(projectArg(args));
+        if (args.includes("--json")) {
+            console.log(JSON.stringify(result, null, 2));
+            return;
+        }
+        console.log(`Kage Repo X-Ray: ${result.summary}`);
+        for (const line of result.first_use_script)
+            console.log(`- ${line}`);
+        for (const layer of result.layers) {
+            console.log(`\n${layer.title}: ${layer.summary}`);
+            for (const item of layer.items.slice(0, 5)) {
+                console.log(`- ${item.path}: ${item.evidence.slice(0, 2).join("; ")}`);
+            }
+        }
+        if (result.next_actions.length)
+            console.log(`\nNext: ${result.next_actions[0]}`);
+        if (result.warnings.length)
+            console.log(`Warnings:\n${result.warnings.map((warning) => `  - ${warning}`).join("\n")}`);
+        return;
+    }
     if (command === "decisions") {
         const result = (0, kernel_js_1.kageDecisionIntelligence)(projectArg(args));
         if (args.includes("--json")) {

package/dist/daemon.js

@@ -212,9 +212,22 @@ function daemonContextReport(projectDir, body) {
         sessionId: typeof body.session_id === "string" ? body.session_id : undefined,
         limit: 5,
     });
+    const teammateBrief = (0, kernel_js_1.kageTeammateBrief)(projectDir, {
+        query,
+        targets: explicitTargets,
+        changedFiles,
+        recallResult,
+        riskResult,
+        reconciliation,
+    });
+    const learningLedger = typeof body.session_id === "string" && body.session_id.trim()
+        ? (0, kernel_js_1.kageSessionLearningLedger)(projectDir, { sessionId: body.session_id, limit: 20 })
+        : null;
     const validationText = validation.ok ? "Memory healthy." : `Warnings: ${validation.warnings.join("; ")}`;
     const contextBlock = [
         recallResult.context_block,
+        teammateBrief.context_block,
+        learningLedger ? learningLedger.context_block : "",
         graphResult.context_block ? `\n## Graph Facts\n${graphResult.context_block}` : "",
         riskResult ? riskContextBlock(riskResult) : "",
         dependencyResult ? `\n## Dependency Path\n${dependencyResult.summary}${dependencyResult.path.length ? `\nPath: ${dependencyResult.path.join(" -> ")}` : ""}` : "",
@@ -225,6 +238,8 @@ function daemonContextReport(projectDir, body) {
         context_block: contextBlock,
         recall: recallResult,
         graph: graphResult,
+        teammate_brief: teammateBrief,
+        learning_ledger: learningLedger,
         risk: riskResult,
         dependency_path: dependencyResult,
         validation,
@@ -267,9 +282,11 @@ function daemonDoctor(projectDir) {
             `POST http://${DEFAULT_HOST}:${restPort}/kage/feedback`,
             `POST http://${DEFAULT_HOST}:${restPort}/kage/observe`,
             `POST http://${DEFAULT_HOST}:${restPort}/kage/distill`,
+            `GET http://${DEFAULT_HOST}:${restPort}/kage/learning-ledger`,
             `GET http://${DEFAULT_HOST}:${restPort}/kage/replay`,
             `GET http://${DEFAULT_HOST}:${restPort}/kage/setup-doctor`,
             `GET http://${DEFAULT_HOST}:${restPort}/kage/profile`,
+            `GET http://${DEFAULT_HOST}:${restPort}/kage/xray`,
             `GET http://${DEFAULT_HOST}:${restPort}/kage/capabilities`,
             `GET http://${DEFAULT_HOST}:${restPort}/kage/context-slots`,
             `POST http://${DEFAULT_HOST}:${restPort}/kage/context-slots`,
@@ -369,6 +386,10 @@ async function startDaemon(projectDir, options = {}) {
                 json(res, 200, (0, kernel_js_1.kageProjectProfile)(projectDir));
                 return;
             }
+            if (req.method === "GET" && url.pathname === "/kage/xray") {
+                json(res, 200, (0, kernel_js_1.kageRepoXray)(projectDir));
+                return;
+            }
             if (req.method === "GET" && url.pathname === "/kage/capabilities") {
                 json(res, 200, (0, kernel_js_1.kageCapabilityAudit)(projectDir));
                 return;
@@ -380,6 +401,13 @@ async function startDaemon(projectDir, options = {}) {
                 }));
                 return;
             }
+            if (req.method === "GET" && url.pathname === "/kage/learning-ledger") {
+                json(res, 200, (0, kernel_js_1.kageSessionLearningLedger)(projectDir, {
+                    sessionId: url.searchParams.get("session") ?? undefined,
+                    limit: Number(url.searchParams.get("limit") ?? 50),
+                }));
+                return;
+            }
             if (req.method === "GET" && url.pathname === "/kage/context-slots") {
                 json(res, 200, (0, kernel_js_1.kageContextSlots)(projectDir));
                 return;
@@ -528,6 +556,7 @@ async function startViewer(projectDir, options = {}) {
     const benchmarkPath = (0, node_path_1.join)(reportsDir, "benchmark.json");
     const contributorsPath = (0, node_path_1.join)(reportsDir, "contributors.json");
     const profilePath = (0, node_path_1.join)(reportsDir, "profile.json");
+    const xrayPath = (0, node_path_1.join)(reportsDir, "xray.json");
     const capabilitiesPath = (0, node_path_1.join)(reportsDir, "capabilities.json");
     const slotsPath = (0, node_path_1.join)(reportsDir, "context-slots.json");
     const decisionsPath = (0, node_path_1.join)(reportsDir, "decisions.json");
@@ -555,6 +584,7 @@ async function startViewer(projectDir, options = {}) {
         (0, node_fs_1.writeFileSync)(benchmarkPath, JSON.stringify(viewerBenchmarkReport(projectDir), null, 2));
         (0, node_fs_1.writeFileSync)(contributorsPath, JSON.stringify((0, kernel_js_1.kageContributors)(projectDir), null, 2));
         (0, node_fs_1.writeFileSync)(profilePath, JSON.stringify((0, kernel_js_1.kageProjectProfile)(projectDir), null, 2));
+        (0, node_fs_1.writeFileSync)(xrayPath, JSON.stringify((0, kernel_js_1.kageRepoXray)(projectDir), null, 2));
         (0, node_fs_1.writeFileSync)(capabilitiesPath, JSON.stringify((0, kernel_js_1.kageCapabilityAudit)(projectDir), null, 2));
         (0, node_fs_1.writeFileSync)(slotsPath, JSON.stringify((0, kernel_js_1.kageContextSlots)(projectDir), null, 2));
         (0, node_fs_1.writeFileSync)(decisionsPath, JSON.stringify((0, kernel_js_1.kageDecisionIntelligence)(projectDir), null, 2));
@@ -575,7 +605,7 @@ async function startViewer(projectDir, options = {}) {
     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)}&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)}&timeline=${encodeURIComponent(timelinePath)}&lineage=${encodeURIComponent(lineagePath)}&setup=${encodeURIComponent(setupPath)}&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

@@ -267,6 +267,17 @@ function listTools() {
                 required: ["project_dir"],
             },
         },
+        {
+            name: "kage_xray",
+            description: "Return a first-use Repo X-Ray: code structure layers for entry points, core files, risk, tests, memory overlay, and knowledge gaps.",
+            inputSchema: {
+                type: "object",
+                properties: {
+                    project_dir: { type: "string" },
+                },
+                required: ["project_dir"],
+            },
+        },
         {
             name: "kage_capabilities",
             description: "Return an evidence-backed Kage memory-system capability audit across repo memory, collaboration/session proof, benchmarks, and dashboard/viewer readiness.",
@@ -737,6 +748,19 @@ function listTools() {
                 required: ["project_dir"],
             },
         },
+        {
+            name: "kage_learning_ledger",
+            description: "Return an agent-facing ledger that classifies observed session events into save, ignore, needs-evidence, or already-distilled memory decisions.",
+            inputSchema: {
+                type: "object",
+                properties: {
+                    project_dir: { type: "string" },
+                    session_id: { type: "string" },
+                    limit: { type: "number" },
+                },
+                required: ["project_dir"],
+            },
+        },
         {
             name: "kage_session_replay",
             description: "Return a privacy-preserving replay digest for observed agent sessions: timeline, touched paths, commands, durable candidates, and distill actions without raw transcript text.",
@@ -1042,8 +1066,21 @@ async function callTool(name, args) {
             sessionId: typeof args?.session_id === "string" ? args.session_id : undefined,
             limit: 5,
         });
+        const teammateBrief = (0, kernel_js_1.kageTeammateBrief)(projectDir, {
+            query,
+            targets: explicitTargets,
+            changedFiles,
+            recallResult,
+            riskResult,
+            reconciliation,
+        });
+        const learningLedger = typeof args?.session_id === "string" && args.session_id.trim()
+            ? (0, kernel_js_1.kageSessionLearningLedger)(projectDir, { sessionId: args.session_id, limit: 20 })
+            : null;
         const sections = [
             recallResult.context_block,
+            teammateBrief.context_block,
+            learningLedger ? learningLedger.context_block : "",
             graphResult.context_block ? `\n## Graph Facts\n${graphResult.context_block}` : "",
             riskResult ? riskContextBlock(riskResult) : "",
             dependencyResult ? `\n## Dependency Path\n${dependencyResult.summary}${dependencyResult.path.length ? `\nPath: ${dependencyResult.path.join(" -> ")}` : ""}` : "",
@@ -1125,6 +1162,12 @@ async function callTool(name, args) {
             content: [{ type: "text", text: JSON.stringify(result, null, 2) }],
         };
     }
+    if (name === "kage_xray") {
+        const result = (0, kernel_js_1.kageRepoXray)(String(args?.project_dir ?? ""));
+        return {
+            content: [{ type: "text", text: JSON.stringify(result, null, 2) }],
+        };
+    }
     if (name === "kage_capabilities") {
         const result = (0, kernel_js_1.kageCapabilityAudit)(String(args?.project_dir ?? ""));
         return {
@@ -1420,6 +1463,16 @@ async function callTool(name, args) {
             isError: false,
         };
     }
+    if (name === "kage_learning_ledger") {
+        const result = (0, kernel_js_1.kageSessionLearningLedger)(String(args?.project_dir ?? ""), {
+            sessionId: args?.session_id ? String(args.session_id) : undefined,
+            limit: typeof args?.limit === "number" ? args.limit : undefined,
+        });
+        return {
+            content: [{ type: "text", text: JSON.stringify(result, null, 2) }],
+            isError: false,
+        };
+    }
     if (name === "kage_session_replay") {
         const result = (0, kernel_js_1.kageSessionReplay)(String(args?.project_dir ?? ""), {
             sessionId: args?.session_id ? String(args.session_id) : undefined,