@kage-core/kage-graph-mcp 1.1.32 → 1.1.34

package/README.md

@@ -45,8 +45,8 @@ Restart your agent once after setup so MCP tools reload.
 - decision intelligence for why-memory coverage, stale/weak packets, and
   important files that still lack linked repo knowledge
 - lightweight workspace recall across sibling repos, including package,
-  route-contract, and topic/event contract links when existing code graphs
-  expose them
+  route-contract, topic/event contract, and git co-change links when existing
+  local evidence exposes them
 - local git intelligence for risk, reviewers, contributor profiles, co-change
   warnings, ownership silos, and module health
 - `AGENTS.md` bootstrap instructions so agents recall context automatically
@@ -165,8 +165,10 @@ kage viewer --project .
 
 The local viewer loads graph artifacts plus `.agent_memory/reports/*.json` and
 shows a repo-intelligence cockpit for memory-code links, decision memory, risk,
-contributors, module health, graph insights, workspace coverage, quality, and
-benchmark proof.
+contributors, module health, graph insights, workspace coverage, workspace
+link maps, quality, and benchmark proof. Workspace Map rows expose package
+dependencies, route contracts, topic/event links, and cross-repo co-change
+pairs from local workspace reports.
 
 Hosted demo:
 

package/dist/cli.js

@@ -855,6 +855,12 @@ async function main() {
                 console.log(`- ${contract.producer_repo} ${contract.topic} -> ${contract.consumer_repo}/${contract.consumer_file}`);
             }
         }
+        if (result.co_changes.length) {
+            console.log("Cross-repo co-changes:");
+            for (const link of result.co_changes.slice(0, 10)) {
+                console.log(`- ${link.source_repo}/${link.source_file} <-> ${link.target_repo}/${link.target_file} (${link.frequency}x, strength ${link.strength})`);
+            }
+        }
         if (result.warnings.length)
             console.log(`Warnings:\n${result.warnings.map((warning) => `  - ${warning}`).join("\n")}`);
         return;

package/dist/index.js

@@ -322,7 +322,7 @@ function listTools() {
         },
         {
             name: "kage_workspace",
-            description: "Summarize a local multi-repo workspace: discovered git repos, Kage memory coverage, code graph counts, package dependencies, route contracts, and topic/event contracts between repos. Use when a task spans multiple sibling repos.",
+            description: "Summarize a local multi-repo workspace: discovered git repos, Kage memory coverage, code graph counts, package dependencies, route contracts, topic/event contracts, and cross-repo co-change links between repos. Use when a task spans multiple sibling repos.",
             inputSchema: {
                 type: "object",
                 properties: {

package/dist/kernel.js

@@ -6577,6 +6577,117 @@ function workspaceTopicContracts(workspaceDir, repos) {
         .sort((a, b) => a.topic.localeCompare(b.topic) || a.producer_repo.localeCompare(b.producer_repo) || a.consumer_repo.localeCompare(b.consumer_repo))
         .slice(0, 50);
 }
+function workspaceGitCommits(repo, repoRoot, limit = 250) {
+    const graph = readCurrentCodeGraph(repoRoot);
+    const graphPaths = new Set(graph?.files.map((file) => file.path) ?? []);
+    if (!graphPaths.size)
+        return [];
+    const raw = readGit(repoRoot, ["log", `-${limit}`, "--format=__KAGE_COMMIT__%x1f%an <%ae>%x1f%ct%x1f%cI", "--name-only", "--no-renames"]) ?? "";
+    const records = [];
+    let current = null;
+    for (const rawLine of raw.split(/\r?\n/)) {
+        const line = rawLine.trim();
+        if (!line)
+            continue;
+        if (line.startsWith("__KAGE_COMMIT__")) {
+            if (current?.files.length)
+                records.push(current);
+            const [, author = "", timestamp = "0", iso = ""] = line.split("\x1f");
+            current = {
+                repo: repo.alias,
+                author: author.trim(),
+                timestamp: Number(timestamp) || 0,
+                iso: iso.trim() || null,
+                files: [],
+            };
+            continue;
+        }
+        if (current && graphPaths.has(line) && !isNoisePath(line))
+            current.files.push(line);
+    }
+    if (current?.files.length)
+        records.push(current);
+    return records;
+}
+function workspaceCoChanges(workspaceDir, repos) {
+    const recordsByAuthor = new Map();
+    for (const repo of repos) {
+        const repoRoot = repo.path === "." ? workspaceDir : (0, node_path_1.join)(workspaceDir, repo.path);
+        for (const record of workspaceGitCommits(repo, repoRoot)) {
+            if (!record.author || !record.timestamp || !record.files.length)
+                continue;
+            const list = recordsByAuthor.get(record.author) ?? [];
+            list.push(record);
+            recordsByAuthor.set(record.author, list);
+        }
+    }
+    const windowSeconds = 24 * 60 * 60;
+    const nowSeconds = Math.floor(Date.now() / 1000);
+    const pairs = new Map();
+    const pairKey = (left, leftFile, right, rightFile) => {
+        const a = { repo: left.repo, file: leftFile };
+        const b = { repo: right.repo, file: rightFile };
+        if (`${a.repo}/${a.file}` <= `${b.repo}/${b.file}`)
+            return { key: `${a.repo}\0${a.file}\0${b.repo}\0${b.file}`, source: a, target: b };
+        return { key: `${b.repo}\0${b.file}\0${a.repo}\0${a.file}`, source: b, target: a };
+    };
+    for (const [author, records] of recordsByAuthor.entries()) {
+        const ordered = records.slice().sort((a, b) => a.timestamp - b.timestamp);
+        for (let i = 0; i < ordered.length; i += 1) {
+            const left = ordered[i];
+            for (let j = i + 1; j < ordered.length; j += 1) {
+                const right = ordered[j];
+                const delta = right.timestamp - left.timestamp;
+                if (delta > windowSeconds)
+                    break;
+                if (left.repo === right.repo)
+                    continue;
+                const ageDays = Math.max(0, (nowSeconds - Math.max(left.timestamp, right.timestamp)) / 86400);
+                const weight = Number((1 / (1 + ageDays / 180)).toFixed(3));
+                for (const leftFile of unique(left.files).slice(0, 20)) {
+                    for (const rightFile of unique(right.files).slice(0, 20)) {
+                        const { key, source, target } = pairKey(left, leftFile, right, rightFile);
+                        const existing = pairs.get(key) ?? {
+                            source_repo: source.repo,
+                            source_file: source.file,
+                            target_repo: target.repo,
+                            target_file: target.file,
+                            frequency: 0,
+                            strength: 0,
+                            last_seen_at: null,
+                            last_timestamp: 0,
+                            authors: new Set(),
+                        };
+                        existing.frequency += 1;
+                        existing.strength = Number((existing.strength + weight).toFixed(3));
+                        existing.authors.add(author);
+                        const seenAt = Math.max(left.timestamp, right.timestamp);
+                        if (seenAt > existing.last_timestamp) {
+                            existing.last_timestamp = seenAt;
+                            existing.last_seen_at = right.timestamp >= left.timestamp ? right.iso : left.iso;
+                        }
+                        pairs.set(key, existing);
+                    }
+                }
+            }
+        }
+    }
+    return [...pairs.values()]
+        .map((pair) => ({
+        source_repo: pair.source_repo,
+        source_file: pair.source_file,
+        target_repo: pair.target_repo,
+        target_file: pair.target_file,
+        frequency: pair.frequency,
+        strength: Number(pair.strength.toFixed(3)),
+        last_seen_at: pair.last_seen_at,
+        authors: [...pair.authors].sort(),
+        evidence: `${pair.source_repo}/${pair.source_file} and ${pair.target_repo}/${pair.target_file} changed near each other ${pair.frequency} time(s) by ${pair.authors.size} author(s).`,
+    }))
+        .filter((pair) => pair.frequency > 0)
+        .sort((a, b) => b.strength - a.strength || b.frequency - a.frequency || a.source_repo.localeCompare(b.source_repo) || a.source_file.localeCompare(b.source_file))
+        .slice(0, 50);
+}
 function kageWorkspace(projectDir) {
     const root = (0, node_path_1.resolve)(projectDir);
     const warnings = [];
@@ -6603,6 +6714,7 @@ function kageWorkspace(projectDir) {
     });
     const routeContracts = workspaceRouteContracts(root, repos);
     const topicContracts = workspaceTopicContracts(root, repos);
+    const coChanges = workspaceCoChanges(root, repos);
     if (repos.length && repos.every((repo) => !repo.indexed))
         warnings.push("Workspace repos were found, but none has .agent_memory yet. Run kage init or kage refresh in each repo you want searchable.");
     return {
@@ -6613,8 +6725,9 @@ function kageWorkspace(projectDir) {
         package_dependencies: packageDependencies.sort((a, b) => a.from.localeCompare(b.from) || a.to.localeCompare(b.to)),
         route_contracts: routeContracts,
         topic_contracts: topicContracts,
+        co_changes: coChanges,
         warnings,
-        summary: `${repos.length} repo(s), ${repos.filter((repo) => repo.indexed).length} with Kage memory, ${packageDependencies.length} workspace package dependenc${packageDependencies.length === 1 ? "y" : "ies"}, ${routeContracts.length} route contract link(s), ${topicContracts.length} topic contract link(s).`,
+        summary: `${repos.length} repo(s), ${repos.filter((repo) => repo.indexed).length} with Kage memory, ${packageDependencies.length} workspace package dependenc${packageDependencies.length === 1 ? "y" : "ies"}, ${routeContracts.length} route contract link(s), ${topicContracts.length} topic contract link(s), ${coChanges.length} cross-repo co-change link(s).`,
     };
 }
 function kageWorkspaceRecall(projectDir, query, limit = 8) {

package/package.json

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

package/viewer/app.js

@@ -2321,6 +2321,7 @@
     var decisions = reports.decisions;
     var health = reports.moduleHealth;
     var insights = reports.graphInsights;
+    var workspace = reports.workspace;
 
     if (contributors || risk) {
       var profiles = contributors && Array.isArray(contributors.contributors) ? contributors.contributors : [];
@@ -2449,6 +2450,57 @@
       });
     }
 
+    if (workspace) {
+      var deps = Array.isArray(workspace.package_dependencies) ? workspace.package_dependencies : [];
+      var routeContracts = Array.isArray(workspace.route_contracts) ? workspace.route_contracts : [];
+      var topicContracts = Array.isArray(workspace.topic_contracts) ? workspace.topic_contracts : [];
+      var coChanges = Array.isArray(workspace.co_changes) ? workspace.co_changes : [];
+      var workspaceRows = deps.slice(0, 6).map(function (dep) {
+        return {
+          label: dep.from + " -> " + dep.to,
+          value: dep.package_name || "package",
+          meta: "workspace package dependency",
+          score: 72,
+          status: "ok",
+        };
+      }).concat(routeContracts.slice(0, 6).map(function (contract) {
+        return {
+          label: contract.provider_repo + " -> " + contract.consumer_repo,
+          value: [contract.method, contract.path].filter(Boolean).join(" "),
+          meta: [contract.provider_file, contract.consumer_file].filter(Boolean).join(" -> "),
+          score: contract.confidence === "high" ? 92 : 76,
+          status: "ok",
+        };
+      })).concat(topicContracts.slice(0, 6).map(function (contract) {
+        return {
+          label: contract.producer_repo + " -> " + contract.consumer_repo,
+          value: contract.topic,
+          meta: [contract.producer_file, contract.consumer_file].filter(Boolean).join(" -> "),
+          score: contract.confidence === "high" ? 88 : 72,
+          status: "ok",
+        };
+      })).concat(coChanges.slice(0, 8).map(function (link) {
+        var score = Math.min(100, Number(link.strength || 0) * 22 + Number(link.frequency || 0) * 12);
+        return {
+          label: link.source_repo + " <-> " + link.target_repo,
+          value: (link.frequency || 0) + "x co-change",
+          meta: [link.source_file, link.target_file].filter(Boolean).join(" <-> "),
+          score: Math.max(20, score),
+          status: "warn",
+        };
+      }));
+      if (workspaceRows.length) {
+        sections.push({
+          title: "Workspace Map",
+          kicker: "deps / contracts / co-changes",
+          stat: workspaceRows.length + " links",
+          summary: "Workspace links show how sibling repos relate through package dependencies, source-evidence contracts, topic/event links, and local git co-change history.",
+          rows: workspaceRows,
+          limit: 14,
+        });
+      }
+    }
+
     if (risk) {
       var targets = Array.isArray(risk.targets) ? risk.targets : Object.keys(risk.targets || {}).map(function (key) { return risk.targets[key]; });
       var hotspots = Array.isArray(risk.global_hotspots) ? risk.global_hotspots : [];
@@ -2620,6 +2672,7 @@
       var deps = Array.isArray(workspace.package_dependencies) ? workspace.package_dependencies : [];
       var contracts = Array.isArray(workspace.route_contracts) ? workspace.route_contracts : [];
       var topics = Array.isArray(workspace.topic_contracts) ? workspace.topic_contracts : [];
+      var coChanges = Array.isArray(workspace.co_changes) ? workspace.co_changes : [];
       cards.push({
         title: "Workspace",
         kicker: "multi-repo memory",
@@ -2629,7 +2682,8 @@
           ["Indexed", String(repos.filter(function (repo) { return repo.indexed; }).length)],
           ["Package deps", String(deps.length)],
           ["Route links", String(contracts.length)],
-          ["Topic links", String(topics.length)]
+          ["Topic links", String(topics.length)],
+          ["Co-changes", String(coChanges.length)]
         ].concat(repos.slice(0, 2).map(function (repo) { return [repo.alias, repo.approved_packets + " packets, " + repo.code_files + " files"]; }))
       });
     }