@swarmvaultai/engine 0.7.22 → 0.7.24

package/dist/index.d.ts

@@ -57,7 +57,7 @@ type PageStatus = "draft" | "candidate" | "active" | "archived";
 type PageManager = "system" | "human";
 type ApprovalEntryStatus = "pending" | "accepted" | "rejected";
 type ApprovalChangeType = "create" | "update" | "delete" | "promote";
-type ApprovalBundleType = "compile" | "generated_output" | "source_review" | "guided_source" | "guided_session";
+type ApprovalBundleType = "compile" | "generated-output" | "source-review" | "guided-source" | "guided-session";
 type ApprovalEntryLabel = "source-brief" | "source-review" | "source-guide" | "guided-update";
 type GuidedSourceSessionStatus = "awaiting_input" | "ready_to_stage" | "staged" | "accepted" | "rejected";
 type VaultProfilePreset = "reader" | "timeline" | "diligence" | "thesis";
@@ -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";
 
@@ -17483,8 +17485,8 @@ async function buildDashboardRecords(config, paths, graph, schemaHash, report) {
   ).slice(0, 20);
   const sourceSessions = await listGuidedSourceSessions(paths.rootDir);
   const stagedGuideBundles = (await Promise.all(
-    (await fs19.readdir(paths.approvalsDir, { withFileTypes: true }).catch(() => [])).filter((entry) => entry.isDirectory()).map(async (entry) => await readJsonFile(approvalManifestPath(paths, entry.name)))
-  )).filter((manifest) => Boolean(manifest)).filter((manifest) => manifest.bundleType === "guided_source" || manifest.bundleType === "guided_session").sort((left, right) => right.createdAt.localeCompare(left.createdAt)).slice(0, 12);
+    (await fs19.readdir(paths.approvalsDir, { withFileTypes: true }).catch(() => [])).filter((entry) => entry.isDirectory()).map(async (entry) => await readApprovalManifest(paths, entry.name).catch(() => null))
+  )).filter((manifest) => Boolean(manifest)).filter((manifest) => manifest.bundleType === "guided-source" || manifest.bundleType === "guided-session").sort((left, right) => right.createdAt.localeCompare(left.createdAt)).slice(0, 12);
   const readerFocusPages = uniqueBy([...guidePages, ...briefPages, ...conceptPages, ...entityPages], (page) => page.id).slice(0, 8);
   const diligenceSessions = sourceSessions.filter((session) => session.status === "staged" || session.status === "awaiting_input").slice(0, 8);
   const dashboards = [
@@ -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) {
@@ -18704,11 +18713,22 @@ function approvalManifestPath(paths, approvalId) {
 function approvalGraphPath(paths, approvalId) {
   return path23.join(paths.approvalsDir, approvalId, "state", "graph.json");
 }
+function normalizeApprovalBundleType(raw) {
+  if (!raw) return void 0;
+  const legacy = {
+    generated_output: "generated-output",
+    source_review: "source-review",
+    guided_source: "guided-source",
+    guided_session: "guided-session"
+  };
+  return legacy[raw] ?? raw;
+}
 async function readApprovalManifest(paths, approvalId) {
   const manifest = await readJsonFile(approvalManifestPath(paths, approvalId));
   if (!manifest) {
     throw new Error(`Approval bundle not found: ${approvalId}`);
   }
+  manifest.bundleType = normalizeApprovalBundleType(manifest.bundleType);
   return manifest;
 }
 async function writeApprovalManifest(paths, manifest) {
@@ -19551,7 +19571,7 @@ async function stageOutputApprovalBundle(rootDir, stagedPages, options = {}) {
   await writeApprovalManifest(paths, {
     approvalId,
     createdAt: (/* @__PURE__ */ new Date()).toISOString(),
-    bundleType: options.bundleType ?? "generated_output",
+    bundleType: options.bundleType ?? "generated-output",
     title: options.title,
     sourceSessionId: options.sourceSessionId,
     entries: await buildApprovalEntries(
@@ -21243,7 +21263,7 @@ async function bootstrapDemo(rootDir, input) {
 }
 
 // src/mcp.ts
-var SERVER_VERSION = "0.7.22";
+var SERVER_VERSION = "0.7.24";
 async function createMcpServer(rootDir) {
   const server = new McpServer({
     name: "swarmvault",
@@ -23069,7 +23089,7 @@ async function buildSourceGuideStagedPage(rootDir, scope) {
 async function stageSourceReviewForScope(rootDir, scope) {
   const output = await buildSourceReviewStagedPage(rootDir, scope);
   const approval = await stageGeneratedOutputPages(rootDir, [{ page: output.page, content: output.content, label: "source-review" }], {
-    bundleType: "source_review",
+    bundleType: "source-review",
     title: `Source Review: ${scope.title}`
   });
   return {
@@ -23421,7 +23441,7 @@ async function stageSourceGuideForScope(rootDir, scope, options = {}) {
       ...guidedUpdates
     ],
     {
-      bundleType: "guided_session",
+      bundleType: "guided-session",
       title: `Guided Session: ${scope.title}`,
       sourceSessionId: session.sessionId
     }
@@ -23875,16 +23895,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 +23999,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 +24149,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.24",
   "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"
   },