@swarmvaultai/engine 3.5.0 → 3.6.0

package/dist/index.js

@@ -23,6 +23,7 @@ import {
   buildOutputPage,
   buildRedactor,
   buildSchemaPrompt,
+  checkTrackedRepoChanges,
   compileVault,
   composeVaultSchema,
   computeDecayScore,
@@ -91,6 +92,7 @@ import {
   readWatchStatusArtifact,
   rebuildRetrievalIndex,
   recordSession,
+  refreshGraphClusters,
   refreshVaultAfterOutputSave,
   rejectApproval,
   removeManifestBySourceId,
@@ -123,9 +125,10 @@ import {
   writeGuidedSourceSession,
   writeRetrievalManifest,
   writeWatchStatusArtifact
-} from "./chunk-HKU2T5JX.js";
+} from "./chunk-5GEPTIZE.js";
 import {
   LocalWhisperProviderAdapter,
+  SWARMVAULT_OUT_ENV,
   appendJsonLine,
   assertProviderCapability,
   createProvider,
@@ -140,6 +143,7 @@ import {
   loadVaultConfig,
   normalizeWhitespace,
   readJsonFile,
+  resolveArtifactRootDir,
   resolvePaths,
   sha256,
   slugify,
@@ -147,7 +151,7 @@ import {
   truncate,
   uniqueBy,
   writeJsonFile
-} from "./chunk-7QHDATCQ.js";
+} from "./chunk-7O2HJSWQ.js";
 import {
   estimatePageTokens,
   estimateTokens,
@@ -3920,27 +3924,78 @@ async function pushGraphNeo4j(rootDir, options = {}) {
   }
 }
 
+// src/graph-status.ts
+import path6 from "path";
+function recommendedCommand(input) {
+  if (!input.graphExists || !input.reportExists) {
+    return "swarmvault compile";
+  }
+  if (input.semanticChangeCount > 0 || input.pendingSemanticRefreshCount > 0) {
+    return "swarmvault compile";
+  }
+  if (input.codeChangeCount > 0) {
+    return "swarmvault graph update";
+  }
+  return null;
+}
+async function getGraphStatus(rootDir, options = {}) {
+  const { paths } = await loadVaultConfig(rootDir);
+  const graphPath = paths.graphPath;
+  const reportPath = path6.join(paths.wikiDir, "graph", "report.md");
+  const resolvedOverrideRoots = options.repoRoots?.map((repoRoot) => path6.resolve(rootDir, repoRoot));
+  const [graphExists, reportExists, trackedRepoRoots, changes, pendingSemanticRefresh] = await Promise.all([
+    fileExists(graphPath),
+    fileExists(reportPath),
+    resolvedOverrideRoots ? Promise.resolve([...new Set(resolvedOverrideRoots)].sort((left, right) => left.localeCompare(right))) : listTrackedRepoRoots(rootDir),
+    checkTrackedRepoChanges(rootDir, resolvedOverrideRoots),
+    readJsonFile(paths.pendingSemanticRefreshPath).then((entries) => Array.isArray(entries) ? entries : [])
+  ]);
+  const codeChangeCount = changes.filter((change) => change.refreshType === "code").length;
+  const semanticChangeCount = changes.filter((change) => change.refreshType === "semantic").length;
+  const command = recommendedCommand({
+    graphExists,
+    reportExists,
+    codeChangeCount,
+    semanticChangeCount,
+    pendingSemanticRefreshCount: pendingSemanticRefresh.length
+  });
+  return {
+    generatedAt: (/* @__PURE__ */ new Date()).toISOString(),
+    graphExists,
+    graphPath,
+    reportExists,
+    reportPath,
+    trackedRepoRoots,
+    codeChangeCount,
+    semanticChangeCount,
+    pendingSemanticRefresh,
+    stale: Boolean(command),
+    recommendedCommand: command,
+    changes
+  };
+}
+
 // src/hooks.ts
 import fs6 from "fs/promises";
-import path6 from "path";
+import path7 from "path";
 import process3 from "process";
 var hookStart = "# >>> swarmvault hook >>>";
 var hookEnd = "# <<< swarmvault hook <<<";
 async function findNearestGitRoot(startPath) {
-  let current = path6.resolve(startPath);
+  let current = path7.resolve(startPath);
   try {
     const stat = await fs6.stat(current);
     if (!stat.isDirectory()) {
-      current = path6.dirname(current);
+      current = path7.dirname(current);
     }
   } catch {
-    current = path6.dirname(current);
+    current = path7.dirname(current);
   }
   while (true) {
-    if (await fileExists(path6.join(current, ".git"))) {
+    if (await fileExists(path7.join(current, ".git"))) {
       return current;
     }
-    const parent = path6.dirname(current);
+    const parent = path7.dirname(current);
     if (parent === current) {
       return null;
     }
@@ -3952,8 +4007,8 @@ function shellQuote(value) {
 }
 function resolveSwarmvaultExecutableCandidate() {
   const argvPath = process3.argv[1];
-  if (typeof argvPath === "string" && argvPath.trim() && (argvPath.includes(`${path6.sep}@swarmvaultai${path6.sep}cli${path6.sep}`) || argvPath.includes(`${path6.sep}packages${path6.sep}cli${path6.sep}`))) {
-    return path6.resolve(argvPath);
+  if (typeof argvPath === "string" && argvPath.trim() && (argvPath.includes(`${path7.sep}@swarmvaultai${path7.sep}cli${path7.sep}`) || argvPath.includes(`${path7.sep}packages${path7.sep}cli${path7.sep}`))) {
+    return path7.resolve(argvPath);
   }
   return "swarmvault";
 }
@@ -3972,7 +4027,7 @@ function managedHookBlock(vaultRoot) {
   ].join("\n");
 }
 function hookPath(repoRoot, hookName) {
-  return path6.join(repoRoot, ".git", "hooks", hookName);
+  return path7.join(repoRoot, ".git", "hooks", hookName);
 }
 async function readHookStatus(filePath) {
   if (!await fileExists(filePath)) {
@@ -3996,7 +4051,7 @@ ${block}`.trimEnd();
     next = `#!/bin/sh
 ${block}`.trimEnd();
   }
-  await ensureDir(path6.dirname(filePath));
+  await ensureDir(path7.dirname(filePath));
   await fs6.writeFile(filePath, `${next}
 `, { mode: 493, encoding: "utf8" });
   await fs6.chmod(filePath, 493);
@@ -4039,7 +4094,7 @@ async function installGitHooks(rootDir) {
   if (!repoRoot) {
     throw new Error("No git repository found above the current vault.");
   }
-  const block = managedHookBlock(path6.resolve(rootDir));
+  const block = managedHookBlock(path7.resolve(rootDir));
   await upsertHookFile(hookPath(repoRoot, "post-commit"), block);
   await upsertHookFile(hookPath(repoRoot, "post-checkout"), block);
   return getGitHookStatus(rootDir);
@@ -4060,11 +4115,11 @@ async function uninstallGitHooks(rootDir) {
 
 // src/mcp.ts
 import fs7 from "fs/promises";
-import path7 from "path";
+import path8 from "path";
 import { McpServer, ResourceTemplate } from "@modelcontextprotocol/sdk/server/mcp.js";
 import { StdioServerTransport } from "@modelcontextprotocol/sdk/server/stdio.js";
 import { z } from "zod";
-var SERVER_VERSION = "3.5.0";
+var SERVER_VERSION = "3.6.0";
 async function createMcpServer(rootDir) {
   const server = new McpServer({
     name: "swarmvault",
@@ -4202,6 +4257,18 @@ async function createMcpServer(rootDir) {
       return asToolText(await graphStatsVault(rootDir));
     })
   );
+  server.registerTool(
+    "cluster_graph",
+    {
+      description: "Recompute graph communities, node degrees, god-node flags, and graph report artifacts from the existing compiled graph.",
+      inputSchema: {
+        resolution: z.number().positive().optional().describe("Optional Louvain community resolution override")
+      }
+    },
+    safeHandler(async ({ resolution }) => {
+      return asToolText(await refreshGraphClusters(rootDir, { resolution }));
+    })
+  );
   server.registerTool(
     "get_node",
     {
@@ -4760,7 +4827,7 @@ async function createMcpServer(rootDir) {
     },
     async () => {
       const { paths } = await loadVaultConfig(rootDir);
-      const files = (await listFilesRecursive(paths.sessionsDir)).filter((filePath) => filePath.endsWith(".md")).map((filePath) => toPosix(path7.relative(paths.sessionsDir, filePath))).sort();
+      const files = (await listFilesRecursive(paths.sessionsDir)).filter((filePath) => filePath.endsWith(".md")).map((filePath) => toPosix(path8.relative(paths.sessionsDir, filePath))).sort();
       return asTextResource("swarmvault://sessions", JSON.stringify(files, null, 2));
     }
   );
@@ -4829,7 +4896,7 @@ async function createMcpServer(rootDir) {
         return asTextResource(`swarmvault://pages/${encodedPath}`, `Page not found: ${relativePath}`);
       }
       const { paths } = await loadVaultConfig(rootDir);
-      const absolutePath = path7.resolve(paths.wikiDir, relativePath);
+      const absolutePath = path8.resolve(paths.wikiDir, relativePath);
       return asTextResource(`swarmvault://pages/${encodedPath}`, await fs7.readFile(absolutePath, "utf8"));
     }
   );
@@ -4838,11 +4905,11 @@ async function createMcpServer(rootDir) {
     new ResourceTemplate("swarmvault://sessions/{path}", {
       list: async () => {
         const { paths } = await loadVaultConfig(rootDir);
-        const files = (await listFilesRecursive(paths.sessionsDir)).filter((filePath) => filePath.endsWith(".md")).map((filePath) => toPosix(path7.relative(paths.sessionsDir, filePath))).sort();
+        const files = (await listFilesRecursive(paths.sessionsDir)).filter((filePath) => filePath.endsWith(".md")).map((filePath) => toPosix(path8.relative(paths.sessionsDir, filePath))).sort();
         return {
           resources: files.map((relativePath) => ({
             uri: `swarmvault://sessions/${encodeURIComponent(relativePath)}`,
-            name: path7.basename(relativePath, ".md"),
+            name: path8.basename(relativePath, ".md"),
             title: relativePath,
             description: "SwarmVault session artifact",
             mimeType: "text/markdown"
@@ -4859,7 +4926,7 @@ async function createMcpServer(rootDir) {
       const { paths } = await loadVaultConfig(rootDir);
       const encodedPath = typeof variables.path === "string" ? variables.path : "";
       const relativePath = decodeURIComponent(encodedPath);
-      const absolutePath = path7.resolve(paths.sessionsDir, relativePath);
+      const absolutePath = path8.resolve(paths.sessionsDir, relativePath);
       if (!isPathWithin(paths.sessionsDir, absolutePath) || !await fileExists(absolutePath)) {
         return asTextResource(`swarmvault://sessions/${encodedPath}`, `Session not found: ${relativePath}`);
       }
@@ -4925,7 +4992,7 @@ function asTextResource(uri, text) {
 import { createWriteStream, constants as fsConstants } from "fs";
 import fs8 from "fs/promises";
 import os from "os";
-import path8 from "path";
+import path9 from "path";
 import { Readable } from "stream";
 import { pipeline } from "stream/promises";
 var BINARY_CANDIDATES = ["whisper-cli", "whisper-cpp", "whisper"];
@@ -4953,10 +5020,10 @@ async function discoverLocalWhisperBinary(options = {}) {
   }
   const pathValue = env.PATH ?? "";
   const candidates = [];
-  for (const dir of pathValue.split(path8.delimiter)) {
+  for (const dir of pathValue.split(path9.delimiter)) {
     if (!dir) continue;
     for (const name of BINARY_CANDIDATES) {
-      const full = path8.join(dir, name);
+      const full = path9.join(dir, name);
       candidates.push(full);
       if (await isExecutable(full)) {
         return { binaryPath: full, candidates, source: "path" };
@@ -4967,14 +5034,14 @@ async function discoverLocalWhisperBinary(options = {}) {
 }
 function expectedModelPath(modelName, homeDir) {
   const home = homeDir ?? os.homedir();
-  return path8.join(home, ".swarmvault", "models", `ggml-${modelName}.bin`);
+  return path9.join(home, ".swarmvault", "models", `ggml-${modelName}.bin`);
 }
 function modelDownloadUrl(modelName) {
   return `${HUGGINGFACE_BASE}/ggml-${modelName}.bin`;
 }
 async function downloadWhisperModel(options) {
   const destPath = expectedModelPath(options.modelName, options.homeDir);
-  await ensureDir(path8.dirname(destPath));
+  await ensureDir(path9.dirname(destPath));
   const doFetch = options.fetchImpl ?? fetch;
   const url = modelDownloadUrl(options.modelName);
   const response = await doFetch(url);
@@ -5134,12 +5201,12 @@ async function withCapabilityFallback(provider, capability, run, fallback) {
 
 // src/schedule.ts
 import fs9 from "fs/promises";
-import path9 from "path";
+import path10 from "path";
 function scheduleStatePath(schedulesDir, jobId) {
-  return path9.join(schedulesDir, `${encodeURIComponent(jobId)}.json`);
+  return path10.join(schedulesDir, `${encodeURIComponent(jobId)}.json`);
 }
 function scheduleLockPath(schedulesDir, jobId) {
-  return path9.join(schedulesDir, `${encodeURIComponent(jobId)}.lock`);
+  return path10.join(schedulesDir, `${encodeURIComponent(jobId)}.lock`);
 }
 function parseEveryDuration(value) {
   const match = value.trim().match(/^(\d+)(m|h|d)$/i);
@@ -5408,7 +5475,7 @@ async function serveSchedules(rootDir, pollMs = 3e4) {
 // src/sources.ts
 import { spawn } from "child_process";
 import fs10 from "fs/promises";
-import path10 from "path";
+import path11 from "path";
 import matter3 from "gray-matter";
 import { JSDOM } from "jsdom";
 var DEFAULT_CRAWL_MAX_PAGES = 12;
@@ -5454,24 +5521,24 @@ function emptyManagedSourceSyncCounts() {
   };
 }
 function withinRoot(rootPath, targetPath) {
-  const relative = path10.relative(rootPath, targetPath);
-  return relative === "" || !relative.startsWith("..") && !path10.isAbsolute(relative);
+  const relative = path11.relative(rootPath, targetPath);
+  return relative === "" || !relative.startsWith("..") && !path11.isAbsolute(relative);
 }
 async function findNearestGitRoot2(startPath) {
-  let current = path10.resolve(startPath);
+  let current = path11.resolve(startPath);
   try {
     const stat = await fs10.stat(current);
     if (!stat.isDirectory()) {
-      current = path10.dirname(current);
+      current = path11.dirname(current);
     }
   } catch {
-    current = path10.dirname(current);
+    current = path11.dirname(current);
   }
   while (true) {
-    if (await fileExists(path10.join(current, ".git"))) {
+    if (await fileExists(path11.join(current, ".git"))) {
       return current;
     }
-    const parent = path10.dirname(current);
+    const parent = path11.dirname(current);
     if (parent === current) {
       return null;
     }
@@ -5545,7 +5612,7 @@ function isAllowedDocsCandidate(candidate, startUrl) {
   if (candidate.origin !== startUrl.origin) {
     return false;
   }
-  const extension = path10.extname(candidate.pathname).toLowerCase();
+  const extension = path11.extname(candidate.pathname).toLowerCase();
   if (extension && extension !== ".html" && extension !== ".htm" && extension !== ".md") {
     return false;
   }
@@ -5634,12 +5701,12 @@ function matchesManagedSourceSpec(existing, input) {
     return false;
   }
   if (input.kind === "directory" || input.kind === "file") {
-    return path10.resolve(existing.path ?? "") === path10.resolve(input.path);
+    return path11.resolve(existing.path ?? "") === path11.resolve(input.path);
   }
   return (existing.url ?? "") === input.url;
 }
 async function resolveManagedSourceInput(rootDir, input) {
-  const absoluteInput = path10.resolve(rootDir, input);
+  const absoluteInput = path11.resolve(rootDir, input);
   if (!(input.startsWith("http://") || input.startsWith("https://"))) {
     const stat = await fs10.stat(absoluteInput).catch(() => null);
     if (!stat) {
@@ -5649,7 +5716,7 @@ async function resolveManagedSourceInput(rootDir, input) {
       return {
         kind: "file",
         path: absoluteInput,
-        title: path10.basename(absoluteInput, path10.extname(absoluteInput)) || absoluteInput
+        title: path11.basename(absoluteInput, path11.extname(absoluteInput)) || absoluteInput
       };
     }
     if (!stat.isDirectory()) {
@@ -5661,7 +5728,7 @@ async function resolveManagedSourceInput(rootDir, input) {
       kind: "directory",
       path: absoluteInput,
       repoRoot,
-      title: path10.basename(absoluteInput) || absoluteInput
+      title: path11.basename(absoluteInput) || absoluteInput
     };
   }
   const github = normalizeGitHubRepoRootUrl(input);
@@ -5684,16 +5751,16 @@ async function resolveManagedSourceInput(rootDir, input) {
   };
 }
 function directorySourceIdsFor(manifests, inputPath) {
-  return manifests.filter((manifest) => manifest.originalPath && withinRoot(path10.resolve(inputPath), path10.resolve(manifest.originalPath))).map((manifest) => manifest.sourceId).sort((left, right) => left.localeCompare(right));
+  return manifests.filter((manifest) => manifest.originalPath && withinRoot(path11.resolve(inputPath), path11.resolve(manifest.originalPath))).map((manifest) => manifest.sourceId).sort((left, right) => left.localeCompare(right));
 }
 function fileSourceIdsFor(manifests, inputPath) {
-  const absoluteInput = path10.resolve(inputPath);
-  return manifests.filter((manifest) => manifest.originalPath && path10.resolve(manifest.originalPath) === absoluteInput).map((manifest) => manifest.sourceId).sort((left, right) => left.localeCompare(right));
+  const absoluteInput = path11.resolve(inputPath);
+  return manifests.filter((manifest) => manifest.originalPath && path11.resolve(manifest.originalPath) === absoluteInput).map((manifest) => manifest.sourceId).sort((left, right) => left.localeCompare(right));
 }
 async function syncDirectorySource(rootDir, inputPath, repoRoot) {
   const manifestsBefore = await listManifests(rootDir);
   const previousInScope = manifestsBefore.filter(
-    (manifest) => manifest.originalPath && withinRoot(path10.resolve(inputPath), path10.resolve(manifest.originalPath))
+    (manifest) => manifest.originalPath && withinRoot(path11.resolve(inputPath), path11.resolve(manifest.originalPath))
   );
   const result = await ingestDirectory(rootDir, inputPath, { repoRoot });
   const removed = [];
@@ -5701,7 +5768,7 @@ async function syncDirectorySource(rootDir, inputPath, repoRoot) {
     if (!manifest.originalPath) {
       continue;
     }
-    if (await fileExists(path10.resolve(manifest.originalPath))) {
+    if (await fileExists(path11.resolve(manifest.originalPath))) {
       continue;
     }
     const removedManifest = await removeManifestBySourceId(rootDir, manifest.sourceId);
@@ -5711,7 +5778,7 @@ async function syncDirectorySource(rootDir, inputPath, repoRoot) {
   }
   const manifestsAfter = await listManifests(rootDir);
   return {
-    title: path10.basename(inputPath) || inputPath,
+    title: path11.basename(inputPath) || inputPath,
     sourceIds: directorySourceIdsFor(manifestsAfter, inputPath),
     counts: {
       scannedCount: result.scannedCount,
@@ -5727,7 +5794,7 @@ async function syncFileSource(rootDir, inputPath) {
   const result = await ingestInputDetailed(rootDir, inputPath);
   const manifestsAfter = await listManifests(rootDir);
   return {
-    title: path10.basename(inputPath, path10.extname(inputPath)) || inputPath,
+    title: path11.basename(inputPath, path11.extname(inputPath)) || inputPath,
     sourceIds: fileSourceIdsFor(manifestsAfter, inputPath),
     counts: {
       scannedCount: result.scannedCount,
@@ -5761,7 +5828,7 @@ async function runGitCommand(cwd, args) {
 }
 async function syncGitHubRepoSource(rootDir, entry) {
   const workingDir = await managedSourceWorkingDir(rootDir, entry.id);
-  const checkoutDir = path10.join(workingDir, "checkout");
+  const checkoutDir = path11.join(workingDir, "checkout");
   await fs10.rm(checkoutDir, { recursive: true, force: true });
   await ensureDir(workingDir);
   if (!entry.url) {
@@ -5892,7 +5959,7 @@ function scopedNodeIds(graph, sourceIds) {
 async function loadSourceAnalyses(rootDir, sourceIds) {
   const { paths } = await loadVaultConfig(rootDir);
   const analyses = await Promise.all(
-    sourceIds.map(async (sourceId) => await readJsonFile(path10.join(paths.analysesDir, `${sourceId}.json`)))
+    sourceIds.map(async (sourceId) => await readJsonFile(path11.join(paths.analysesDir, `${sourceId}.json`)))
   );
   return analyses.filter((analysis) => Boolean(analysis?.sourceId));
 }
@@ -6053,8 +6120,8 @@ async function writeSourceBriefForScope(rootDir, source) {
       confidence: 0.82
     }
   });
-  const absolutePath = path10.join(paths.wikiDir, output.page.path);
-  await ensureDir(path10.dirname(absolutePath));
+  const absolutePath = path11.join(paths.wikiDir, output.page.path);
+  await ensureDir(path11.dirname(absolutePath));
   await fs10.writeFile(absolutePath, output.content, "utf8");
   return absolutePath;
 }
@@ -6343,7 +6410,7 @@ function selectGuidedTargetPages(scope, sourcePages, questions) {
   return (matchedTargets.length ? matchedTargets : canonicalPages).slice(0, 6);
 }
 function insightRelativePathForTarget(page, scope) {
-  const basename = path10.basename(page.path);
+  const basename = path11.basename(page.path);
   if (page.kind === "concept") {
     return `insights/concepts/${basename}`;
   }
@@ -6570,7 +6637,7 @@ async function stageSourceReviewForScope(rootDir, scope) {
   return {
     sourceId: scope.id,
     pageId: output.page.id,
-    reviewPath: path10.join(approval.approvalDir, "wiki", output.page.path),
+    reviewPath: path11.join(approval.approvalDir, "wiki", output.page.path),
     staged: true,
     approvalId: approval.approvalId,
     approvalDir: approval.approvalDir
@@ -6637,7 +6704,7 @@ async function buildSourceSessionSavedPage(rootDir, scope, session) {
   const evidenceState = contradictions.length > 0 ? "conflicting" : session.targetedPagePaths.some(
     (targetPath) => sourcePages.some((page) => page.path === targetPath && page.sourceIds.some((sourceId) => !scope.sourceIds.includes(sourceId)))
   ) ? "reinforcing" : session.targetedPagePaths.length ? "new" : "needs_judgment";
-  const relativeBriefPath = session.briefPath && path10.isAbsolute(session.briefPath) ? path10.relative(paths.wikiDir, session.briefPath) : session.briefPath;
+  const relativeBriefPath = session.briefPath && path11.isAbsolute(session.briefPath) ? path11.relative(paths.wikiDir, session.briefPath) : session.briefPath;
   const sessionMarkdown = [
     `# Guided Session: ${scope.title}`,
     "",
@@ -6720,8 +6787,8 @@ async function buildSourceSessionSavedPage(rootDir, scope, session) {
 async function persistSourceSessionPage(rootDir, scope, session) {
   const { paths } = await loadVaultConfig(rootDir);
   const output = await buildSourceSessionSavedPage(rootDir, scope, session);
-  const absolutePath = path10.join(paths.wikiDir, output.page.path);
-  await ensureDir(path10.dirname(absolutePath));
+  const absolutePath = path11.join(paths.wikiDir, output.page.path);
+  await ensureDir(path11.dirname(absolutePath));
   await fs10.writeFile(absolutePath, output.content, "utf8");
   return { pageId: output.page.id, sessionPath: absolutePath };
 }
@@ -6750,7 +6817,7 @@ async function buildGuidedUpdatePages(rootDir, scope, session) {
     targetPages.map(async (targetPage) => {
       const evidenceState = classifyGuidedEvidenceState(scope, targetPage, contradictions);
       const relativePath = useCanonicalTargets && targetPage ? targetPage.path : targetPage ? insightRelativePathForTarget(targetPage, scope) : `insights/topics/${slugify(scope.title)}.md`;
-      const absolutePath = path10.join(paths.wikiDir, relativePath);
+      const absolutePath = path11.join(paths.wikiDir, relativePath);
       const existingContent = await fileExists(absolutePath) ? await fs10.readFile(absolutePath, "utf8") : "";
       const parsed = existingContent ? matter3(existingContent) : { data: {}, content: "" };
       const existingData = parsed.data;
@@ -6922,8 +6989,8 @@ async function stageSourceGuideForScope(rootDir, scope, options = {}) {
     }
   );
   session.status = "staged";
-  session.reviewPath = path10.join(approval.approvalDir, "wiki", reviewOutput.page.path);
-  session.guidePath = path10.join(approval.approvalDir, "wiki", guideOutput.page.path);
+  session.reviewPath = path11.join(approval.approvalDir, "wiki", reviewOutput.page.path);
+  session.guidePath = path11.join(approval.approvalDir, "wiki", guideOutput.page.path);
   session.approvalId = approval.approvalId;
   session.approvalDir = approval.approvalDir;
   const persisted = await persistSourceSessionPage(rootDir, scope, session);
@@ -7061,7 +7128,7 @@ async function addManagedSource(rootDir, input, options = {}) {
   const existing = sources.find((candidate) => matchesManagedSourceSpec(candidate, resolved));
   const now = (/* @__PURE__ */ new Date()).toISOString();
   const source = existing ?? {
-    id: resolved.kind === "directory" || resolved.kind === "file" ? stableManagedSourceId(resolved.kind, path10.resolve(resolved.path), resolved.title) : stableManagedSourceId(resolved.kind, resolved.url, resolved.title),
+    id: resolved.kind === "directory" || resolved.kind === "file" ? stableManagedSourceId(resolved.kind, path11.resolve(resolved.path), resolved.title) : stableManagedSourceId(resolved.kind, resolved.url, resolved.title),
     kind: resolved.kind,
     title: resolved.title,
     path: resolved.kind === "directory" || resolved.kind === "file" ? resolved.path : void 0,
@@ -7199,7 +7266,7 @@ import { randomUUID } from "crypto";
 import { EventEmitter } from "events";
 import fs11 from "fs/promises";
 import http from "http";
-import path11 from "path";
+import path12 from "path";
 import { promisify as promisify2 } from "util";
 import matter4 from "gray-matter";
 import mime from "mime-types";
@@ -7364,7 +7431,7 @@ async function readViewerPage(rootDir, relativePath) {
     return null;
   }
   const { paths } = await loadVaultConfig(rootDir);
-  const absolutePath = path11.resolve(paths.wikiDir, relativePath);
+  const absolutePath = path12.resolve(paths.wikiDir, relativePath);
   if (!isPathWithin(paths.wikiDir, absolutePath) || !await isReadableFile(absolutePath)) {
     return null;
   }
@@ -7372,7 +7439,7 @@ async function readViewerPage(rootDir, relativePath) {
   const parsed = matter4(raw);
   return {
     path: relativePath,
-    title: typeof parsed.data.title === "string" ? parsed.data.title : path11.basename(relativePath, path11.extname(relativePath)),
+    title: typeof parsed.data.title === "string" ? parsed.data.title : path12.basename(relativePath, path12.extname(relativePath)),
     frontmatter: parsed.data,
     content: parsed.content,
     assets: normalizeOutputAssets(parsed.data.output_assets)
@@ -7383,7 +7450,7 @@ async function readViewerAsset(rootDir, relativePath) {
     return null;
   }
   const { paths } = await loadVaultConfig(rootDir);
-  const absolutePath = path11.resolve(paths.wikiDir, relativePath);
+  const absolutePath = path12.resolve(paths.wikiDir, relativePath);
   if (!isPathWithin(paths.wikiDir, absolutePath) || !await isReadableFile(absolutePath)) {
     return null;
   }
@@ -7424,7 +7491,7 @@ async function writeInboxClip(rootDir, body) {
   const tags = Array.isArray(body.tags) ? body.tags.filter((tag) => typeof tag === "string" && tag.trim().length > 0) : [];
   const now = (/* @__PURE__ */ new Date()).toISOString();
   const fileName = `${now.replace(/[:.]/g, "-")}-${slugForClip(title)}.md`;
-  const inboxPath = path11.join(paths.inboxDir, fileName);
+  const inboxPath = path12.join(paths.inboxDir, fileName);
   await fs11.mkdir(paths.inboxDir, { recursive: true });
   const lines = [
     "---",
@@ -7447,12 +7514,12 @@ async function writeInboxClip(rootDir, body) {
   return { mode: "inbox", inboxPath, result };
 }
 async function ensureViewerDist(viewerDistDir) {
-  const indexPath = path11.join(viewerDistDir, "index.html");
+  const indexPath = path12.join(viewerDistDir, "index.html");
   if (await fileExists(indexPath)) {
     return;
   }
-  const viewerProjectDir = path11.dirname(viewerDistDir);
-  if (await fileExists(path11.join(viewerProjectDir, "package.json"))) {
+  const viewerProjectDir = path12.dirname(viewerDistDir);
+  if (await fileExists(path12.join(viewerProjectDir, "package.json"))) {
     await execFileAsync2("pnpm", ["build"], { cwd: viewerProjectDir });
   }
 }
@@ -7475,7 +7542,7 @@ async function startGraphServer(rootDir, port, options = {}) {
           response.end(JSON.stringify({ error: "Graph artifact not found. Run `swarmvault compile` first." }));
           return;
         }
-        const reportPath = path11.join(paths.wikiDir, "graph", "report.json");
+        const reportPath = path12.join(paths.wikiDir, "graph", "report.json");
         const report = await readJsonFile(reportPath) ?? null;
         response.writeHead(200, { "content-type": "application/json" });
         response.end(JSON.stringify(buildViewerGraphArtifact(graph, { report, full: options.full ?? false })));
@@ -7539,7 +7606,7 @@ async function startGraphServer(rootDir, port, options = {}) {
         return;
       }
       if (url.pathname === "/api/graph-report") {
-        const reportPath = path11.join(paths.wikiDir, "graph", "report.json");
+        const reportPath = path12.join(paths.wikiDir, "graph", "report.json");
         if (!await fileExists(reportPath)) {
           response.writeHead(404, { "content-type": "application/json" });
           response.end(JSON.stringify({ error: "Graph report artifact not found. Run `swarmvault compile` first." }));
@@ -7783,7 +7850,7 @@ async function startGraphServer(rootDir, port, options = {}) {
         return;
       }
       if (url.pathname === "/api/workspace") {
-        const reportPath = path11.join(paths.wikiDir, "graph", "report.json");
+        const reportPath = path12.join(paths.wikiDir, "graph", "report.json");
         const [graphRaw, reportRaw, approvalsRaw, candidatesRaw, memoryTasksRaw, watchStatusRaw, lintRaw, doctorRaw] = await Promise.all([
           readJsonFile(paths.graphPath).catch(() => null),
           readJsonFile(reportPath).catch(() => null),
@@ -7908,8 +7975,8 @@ async function startGraphServer(rootDir, port, options = {}) {
         return;
       }
       const relativePath = url.pathname === "/" ? "index.html" : url.pathname.slice(1);
-      const target = path11.join(paths.viewerDistDir, relativePath);
-      const fallback = path11.join(paths.viewerDistDir, "index.html");
+      const target = path12.join(paths.viewerDistDir, relativePath);
+      const fallback = path12.join(paths.viewerDistDir, "index.html");
       const filePath = await fileExists(target) ? target : fallback;
       if (!await fileExists(filePath)) {
         response.writeHead(503, { "content-type": "text/plain" });
@@ -7956,7 +8023,7 @@ async function exportGraphHtml(rootDir, outputPath, options = {}) {
     throw new Error("Graph artifact not found. Run `swarmvault compile` first.");
   }
   await ensureViewerDist(paths.viewerDistDir);
-  const indexPath = path11.join(paths.viewerDistDir, "index.html");
+  const indexPath = path12.join(paths.viewerDistDir, "index.html");
   if (!await fileExists(indexPath)) {
     throw new Error("Viewer build not found. Run `pnpm build` first.");
   }
@@ -7985,14 +8052,14 @@ async function exportGraphHtml(rootDir, outputPath, options = {}) {
   const rawHtml = await fs11.readFile(indexPath, "utf8");
   const scriptMatch = rawHtml.match(/<script type="module" crossorigin src="([^"]+)"><\/script>/);
   const styleMatch = rawHtml.match(/<link rel="stylesheet" crossorigin href="([^"]+)">/);
-  const scriptPath = scriptMatch?.[1] ? path11.join(paths.viewerDistDir, scriptMatch[1].replace(/^\//, "")) : null;
-  const stylePath = styleMatch?.[1] ? path11.join(paths.viewerDistDir, styleMatch[1].replace(/^\//, "")) : null;
+  const scriptPath = scriptMatch?.[1] ? path12.join(paths.viewerDistDir, scriptMatch[1].replace(/^\//, "")) : null;
+  const stylePath = styleMatch?.[1] ? path12.join(paths.viewerDistDir, styleMatch[1].replace(/^\//, "")) : null;
   if (!scriptPath || !await fileExists(scriptPath)) {
     throw new Error("Viewer script bundle not found. Run `pnpm build` first.");
   }
   const script = await fs11.readFile(scriptPath, "utf8");
   const style = stylePath && await fileExists(stylePath) ? await fs11.readFile(stylePath, "utf8") : "";
-  const report = await readJsonFile(path11.join(paths.wikiDir, "graph", "report.json"));
+  const report = await readJsonFile(path12.join(paths.wikiDir, "graph", "report.json"));
   const embeddedData = JSON.stringify(
     { graph: buildViewerGraphArtifact(graph, { report, full: options.full ?? false }), pages: pages.filter(Boolean), report },
     null,
@@ -8015,9 +8082,9 @@ async function exportGraphHtml(rootDir, outputPath, options = {}) {
     "</html>",
     ""
   ].filter(Boolean).join("\n");
-  await fs11.mkdir(path11.dirname(outputPath), { recursive: true });
+  await fs11.mkdir(path12.dirname(outputPath), { recursive: true });
   await fs11.writeFile(outputPath, html, "utf8");
-  return path11.resolve(outputPath);
+  return path12.resolve(outputPath);
 }
 export {
   ALL_MIGRATIONS,
@@ -8031,6 +8098,7 @@ export {
   LOCAL_WHISPER_MODEL_SIZES,
   LocalWhisperProviderAdapter,
   OPENAI_COMPATIBLE_CAPABILITY_MATRIX,
+  SWARMVAULT_OUT_ENV,
   acceptApproval,
   addInput,
   addManagedSource,
@@ -8048,6 +8116,7 @@ export {
   buildGraphShareArtifact,
   buildMemoryGraphElements,
   buildRedactor,
+  checkTrackedRepoChanges,
   compileVault,
   computeDecayScore,
   consolidateVault,
@@ -8079,6 +8148,7 @@ export {
   finishMemoryTask,
   getGitHookStatus,
   getGraphCommunityVault,
+  getGraphStatus,
   getProviderForTask,
   getRetrievalStatus,
   getWatchStatus,
@@ -8133,6 +8203,7 @@ export {
   readMemoryTask,
   readPage,
   rebuildRetrievalIndex,
+  refreshGraphClusters,
   registerLocalWhisperProvider,
   rejectApproval,
   reloadManagedSources,
@@ -8145,6 +8216,7 @@ export {
   renderGraphShareSvg,
   renderMemoryTaskMarkdown,
   resetDecay,
+  resolveArtifactRootDir,
   resolveConsolidationConfig,
   resolveDecayConfig,
   resolveLargeRepoDefaults,