@swarmvaultai/engine 0.7.22 → 0.7.23

package/dist/index.d.ts

@@ -767,6 +767,7 @@ interface WatchOptions {
     lint?: boolean;
     debounceMs?: number;
     repo?: boolean;
+    codeOnly?: boolean;
 }
 interface PendingSemanticRefreshEntry {
     id: string;

package/dist/index.js

@@ -2263,7 +2263,7 @@ function managedHookBlock(vaultRoot) {
     `swarmvault_bin=${shellQuote(resolvedExecutable)}`,
     '[ ! -x "$swarmvault_bin" ] && swarmvault_bin=$(command -v swarmvault 2>/dev/null || true)',
     'if [ -n "$swarmvault_bin" ] && [ -x "$swarmvault_bin" ]; then',
-    `  "$swarmvault_bin" watch --repo --once >/dev/null 2>&1 || printf '[swarmvault hook] refresh failed\\n' >&2`,
+    `  "$swarmvault_bin" watch --repo --once --code-only >/dev/null 2>&1 || printf '[swarmvault hook] refresh failed\\n' >&2`,
     "fi",
     hookEnd,
     ""
@@ -12748,6 +12748,8 @@ function buildSchemaPrompt(schema, instruction) {
 // src/vault.ts
 import fs19 from "fs/promises";
 import path23 from "path";
+import Graph from "graphology";
+import louvain from "graphology-communities-louvain";
 import matter9 from "gray-matter";
 import { z as z7 } from "zod";
 
@@ -18026,26 +18028,32 @@ function deriveGraphMetrics(nodes, edges) {
   }
   const communityMap = /* @__PURE__ */ new Map();
   const communities = [];
-  const visited = /* @__PURE__ */ new Set();
+  const nonSourceIdSet = new Set(nonSourceNodes.map((node) => node.id));
+  const louvainGraph = new Graph({ type: "undirected" });
   for (const node of nonSourceNodes) {
-    if (visited.has(node.id)) {
-      continue;
-    }
-    const queue = [node.id];
-    const memberIds = [];
-    visited.add(node.id);
-    while (queue.length) {
-      const current = queue.shift();
-      memberIds.push(current);
-      for (const neighbor of adjacency.get(current) ?? []) {
-        if (!visited.has(neighbor) && nodes.find((candidate) => candidate.id === neighbor)?.type !== "source") {
-          visited.add(neighbor);
-          queue.push(neighbor);
-        }
+    louvainGraph.addNode(node.id);
+  }
+  for (const node of nonSourceNodes) {
+    for (const neighbor of adjacency.get(node.id) ?? []) {
+      if (nonSourceIdSet.has(neighbor) && !louvainGraph.hasEdge(node.id, neighbor)) {
+        louvainGraph.addEdge(node.id, neighbor);
       }
     }
-    const labelSeed = nodes.find((candidate) => candidate.id === memberIds[0])?.label ?? `cluster-${communities.length + 1}`;
-    const communityId = buildCommunityId(labelSeed, communities.length);
+  }
+  const louvainMapping = louvainGraph.size > 0 ? louvain(louvainGraph, { resolution: 1 }) : {};
+  const groupByCommunity = /* @__PURE__ */ new Map();
+  let nextIsolated = -1;
+  for (const node of nonSourceNodes) {
+    const communityNumber = louvainMapping[node.id] ?? nextIsolated--;
+    if (!groupByCommunity.has(communityNumber)) {
+      groupByCommunity.set(communityNumber, []);
+    }
+    groupByCommunity.get(communityNumber).push(node.id);
+  }
+  let communityIndex = 0;
+  for (const memberIds of groupByCommunity.values()) {
+    const labelSeed = nodes.find((candidate) => candidate.id === memberIds[0])?.label ?? `cluster-${communityIndex + 1}`;
+    const communityId = buildCommunityId(labelSeed, communityIndex);
     communities.push({
       id: communityId,
       label: labelSeed,
@@ -18054,6 +18062,7 @@ function deriveGraphMetrics(nodes, edges) {
     for (const memberId of memberIds) {
       communityMap.set(memberId, communityId);
     }
+    communityIndex++;
   }
   const degreeMap = /* @__PURE__ */ new Map();
   for (const node of nodes) {
@@ -21243,7 +21252,7 @@ async function bootstrapDemo(rootDir, input) {
 }
 
 // src/mcp.ts
-var SERVER_VERSION = "0.7.22";
+var SERVER_VERSION = "0.7.23";
 async function createMcpServer(rootDir) {
   const server = new McpServer({
     name: "swarmvault",
@@ -23875,16 +23884,38 @@ var CODE_EXTENSIONS = /* @__PURE__ */ new Set([
   ".r",
   ".R"
 ]);
+var FILE_CHANGE_RE = /^(?:add|change|unlink):(.+)$/;
 function isCodeOnlyChange(reasons) {
   for (const reason of reasons) {
-    const match = reason.match(/^(?:add|change|unlink):(.+)$/);
-    if (!match) continue;
-    const filePath = match[1];
-    const ext = path27.extname(filePath).toLowerCase();
+    const match = reason.match(FILE_CHANGE_RE);
+    if (!match) return false;
+    const ext = path27.extname(match[1]).toLowerCase();
     if (!ext || !CODE_EXTENSIONS.has(ext)) return false;
   }
   return reasons.size > 0;
 }
+function hasNonCodeChanges(reasons) {
+  for (const reason of reasons) {
+    const match = reason.match(FILE_CHANGE_RE);
+    if (!match) return true;
+    const ext = path27.extname(match[1]).toLowerCase();
+    if (!ext || !CODE_EXTENSIONS.has(ext)) return true;
+  }
+  return false;
+}
+function collectNonCodePaths(reasons) {
+  const result = [];
+  for (const reason of reasons) {
+    const match = reason.match(FILE_CHANGE_RE);
+    if (!match) {
+      result.push(reason);
+      continue;
+    }
+    const ext = path27.extname(match[1]).toLowerCase();
+    if (!ext || !CODE_EXTENSIONS.has(ext)) result.push(match[1]);
+  }
+  return result;
+}
 function hasIgnoredRepoSegment(baseDir, targetPath) {
   const relativePath = path27.relative(baseDir, targetPath);
   if (!relativePath || relativePath.startsWith("..")) {
@@ -23957,7 +23988,7 @@ async function runWatchCycle(rootDir, options = {}) {
     changedPages: []
   };
   try {
-    result = await performWatchCycle(rootDir, paths, options);
+    result = await performWatchCycle(rootDir, paths, options, options.codeOnly ?? false);
     return result;
   } catch (caught) {
     success = false;
@@ -24107,10 +24138,18 @@ async function watchVault(rootDir, options = {}) {
     pending = false;
     running = true;
     const startedAt = /* @__PURE__ */ new Date();
-    const codeOnlyChange = isCodeOnlyChange(reasons);
+    const detectedCodeOnly = isCodeOnlyChange(reasons);
+    const hasDeferredNonCode = !detectedCodeOnly && hasNonCodeChanges(reasons);
+    const codeOnlyChange = options.codeOnly || detectedCodeOnly || hasDeferredNonCode;
     const runReasons = [...reasons];
     reasons.clear();
-    if (codeOnlyChange) {
+    if (hasDeferredNonCode) {
+      const nonCodePaths = collectNonCodePaths(new Set(runReasons));
+      process3.stderr.write(
+        `[swarmvault watch] Non-code changes detected (${nonCodePaths.length} file(s)) \u2014 run \`swarmvault compile\` to include LLM re-analysis.
+`
+      );
+    } else if (codeOnlyChange) {
       process3.stderr.write("[swarmvault watch] Code-only changes detected \u2014 skipping LLM re-analysis.\n");
     }
     let importedCount = 0;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@swarmvaultai/engine",
-  "version": "0.7.22",
+  "version": "0.7.23",
   "description": "Core engine for SwarmVault: ingest, compile, query, lint, and provider abstractions.",
   "type": "module",
   "main": "dist/index.js",
@@ -50,6 +50,8 @@
     "csv-parse": "^6.2.1",
     "fast-xml-parser": "^5.5.11",
     "fflate": "^0.8.2",
+    "graphology": "^0.26.0",
+    "graphology-communities-louvain": "^2.0.2",
     "gray-matter": "^4.0.3",
     "ignore": "^7.0.5",
     "ini": "^6.0.0",
@@ -81,6 +83,7 @@
     "@types/mime-types": "^3.0.1",
     "@types/node": "^24.6.0",
     "@types/turndown": "^5.0.5",
+    "graphology-types": "^0.24.8",
     "tsup": "^8.5.0",
     "vitest": "^3.2.4"
   },