npm - @swarmvaultai/engine - Versions diffs - 0.7.25 → 0.7.27 - Mend

@swarmvaultai/engine 0.7.25 → 0.7.27

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.

Files changed (11) hide show

package/LICENSE +21 -0
package/dist/chunk-N56FAH4N.js +1404 -0
package/dist/chunk-ZQ5T64AR.js +1365 -0
package/dist/hooks/claude.js +0 -0
package/dist/hooks/copilot.js +0 -0
package/dist/hooks/gemini.js +0 -0
package/dist/index.d.ts +20 -3
package/dist/index.js +591 -131
package/dist/registry-FKEREVDO.js +12 -0
package/dist/registry-SYCRRA65.js +12 -0
package/package.json +10 -9

package/dist/index.js CHANGED Viewed

@@ -22,7 +22,7 @@ import {
   uniqueBy,
   writeFileIfChanged,
   writeJsonFile
-} from "./chunk-MB7HPUTR.js";
+} from "./chunk-N56FAH4N.js";
 import {
   estimatePageTokens,
   estimateTokens,
@@ -493,8 +493,11 @@ async function autoCommitWikiChanges(rootDir, operation, detail, options) {
 }
 // src/graph-export.ts
+import { readFileSync } from "fs";
 import fs2 from "fs/promises";
+import { createRequire } from "module";
 import path2 from "path";
+import matter from "gray-matter";
 // src/graph-interchange.ts
 function exportHyperedgeNodeId(hyperedge) {
@@ -940,6 +943,15 @@ document.getElementById("page-filter").addEventListener("input", function(e) {
 }
 // src/graph-export.ts
+var _visNetworkJs;
+function loadVisNetworkJs() {
+  if (!_visNetworkJs) {
+    const require3 = createRequire(import.meta.url);
+    const pkgDir = path2.dirname(require3.resolve("vis-network/package.json"));
+    _visNetworkJs = readFileSync(path2.join(pkgDir, "standalone/umd/vis-network.min.js"), "utf8");
+  }
+  return _visNetworkJs;
+}
 var NODE_COLORS = {
   source: "#f59e0b",
   module: "#fb7185",
@@ -1340,7 +1352,7 @@ function renderHtmlStandalone(graph) {
 <head>
   <meta charset="utf-8">
   <title>SwarmVault Graph</title>
-  <script src="https://unpkg.com/vis-network@9/standalone/umd/vis-network.min.js"></script>
+  <script>${loadVisNetworkJs()}</script>
   <style>
     * { margin: 0; padding: 0; box-sizing: border-box; }
     body { font-family: system-ui, sans-serif; display: flex; height: 100vh; background: #0f172a; color: #e2e8f0; }
@@ -1593,14 +1605,27 @@ function deduplicateFileName(baseName, used) {
   used.add(name);
   return name;
 }
-async function exportObsidianVault(rootDir, outputDir) {
-  const graph = await loadGraph(rootDir);
-  const resolvedOutputDir = path2.resolve(outputDir);
-  await ensureDir(resolvedOutputDir);
-  const nodesById = graphNodeById(graph);
-  const communities = sortedCommunities(graph);
+function typePluralDir(nodeType) {
+  const map = {
+    source: "sources",
+    module: "modules",
+    symbol: "symbols",
+    concept: "concepts",
+    entity: "entities",
+    rationale: "rationales"
+  };
+  return map[nodeType] ?? "other";
+}
+function obsidianNodeSlug(node, pageById2) {
+  if (node.pageId) {
+    const page = pageById2.get(node.pageId);
+    if (page) return path2.basename(page.path, ".md");
+  }
+  return slugify(node.label);
+}
+function buildAdjacency(edges) {
   const adjacency = /* @__PURE__ */ new Map();
-  for (const edge of graph.edges) {
+  for (const edge of edges) {
     if (!adjacency.has(edge.source)) adjacency.set(edge.source, []);
     if (!adjacency.has(edge.target)) adjacency.set(edge.target, []);
     adjacency.get(edge.source).push({
@@ -1618,44 +1643,164 @@ async function exportObsidianVault(rootDir, outputDir) {
       direction: "in"
     });
   }
-  const usedFileNames = /* @__PURE__ */ new Set();
-  const nodeFileName = /* @__PURE__ */ new Map();
-  for (const node of [...graph.nodes].sort((a, b) => a.label.localeCompare(b.label) || a.id.localeCompare(b.id))) {
-    const name = deduplicateFileName(safeFileName(node.label), usedFileNames);
-    nodeFileName.set(node.id, name);
+  return adjacency;
+}
+async function listFilesRecursive2(dir, base = "") {
+  const results = [];
+  let entries;
+  try {
+    entries = await fs2.readdir(dir, { withFileTypes: true });
+  } catch {
+    return results;
   }
-  let fileCount = 0;
+  for (const entry of entries) {
+    const rel = base ? `${base}/${entry.name}` : entry.name;
+    if (entry.isDirectory()) {
+      results.push(...await listFilesRecursive2(path2.join(dir, entry.name), rel));
+    } else {
+      results.push(rel);
+    }
+  }
+  return results;
+}
+function connectionsSection(nodeIds, adjacency, nodesById, wikilinkTarget) {
+  const seen = /* @__PURE__ */ new Set();
+  const lines = [];
+  for (const nodeId of nodeIds) {
+    for (const entry of adjacency.get(nodeId) ?? []) {
+      const key = `${entry.neighborId}:${entry.relation}`;
+      if (seen.has(key)) continue;
+      seen.add(key);
+      const neighbor = nodesById.get(entry.neighborId);
+      if (!neighbor) continue;
+      const target = wikilinkTarget.get(entry.neighborId);
+      if (!target) continue;
+      lines.push(`- [[${target}|${neighbor.label}]] \u2014 ${entry.relation} (${entry.evidenceClass}, ${entry.confidence.toFixed(2)})`);
+    }
+  }
+  return lines;
+}
+async function exportObsidianVault(rootDir, outputDir) {
+  const graph = await loadGraph(rootDir);
+  const { paths } = await loadVaultConfig(rootDir);
+  const resolvedOutputDir = path2.resolve(outputDir);
+  await ensureDir(resolvedOutputDir);
+  const nodesById = graphNodeById(graph);
+  const pageById2 = graphPageById(graph);
+  const communities = sortedCommunities(graph);
+  const adjacency = buildAdjacency(graph.edges);
+  const nodesByPageId = /* @__PURE__ */ new Map();
   for (const node of graph.nodes) {
-    const fileName = nodeFileName.get(node.id);
-    const lines = [
-      "---",
-      `id: ${JSON.stringify(node.id)}`,
-      `type: ${JSON.stringify(node.type)}`,
-      `community: ${JSON.stringify(node.communityId ?? null)}`,
-      `confidence: ${node.confidence ?? null}`,
-      `source_class: ${JSON.stringify(node.sourceClass ?? null)}`,
-      `tags: ${JSON.stringify(node.tags ?? [])}`,
-      "---",
-      "",
-      `# ${node.label}`,
-      ""
-    ];
-    const neighbors = adjacency.get(node.id) ?? [];
-    if (neighbors.length > 0) {
-      lines.push("## Connections", "");
-      for (const neighbor of neighbors) {
-        const neighborNode = nodesById.get(neighbor.neighborId);
-        if (!neighborNode) continue;
-        const neighborFile = nodeFileName.get(neighbor.neighborId) ?? safeFileName(neighborNode.label);
-        lines.push(`- [[${neighborFile}]] \u2014 ${neighbor.relation} (${neighbor.evidenceClass}, ${neighbor.confidence.toFixed(2)})`);
+    if (node.pageId && pageById2.has(node.pageId)) {
+      const list = nodesByPageId.get(node.pageId) ?? [];
+      list.push(node);
+      nodesByPageId.set(node.pageId, list);
+    }
+  }
+  const orphanNodes = graph.nodes.filter((node) => !node.pageId || !pageById2.has(node.pageId));
+  const usedOrphanSlugs = /* @__PURE__ */ new Set();
+  const orphanFilePath = /* @__PURE__ */ new Map();
+  for (const node of [...orphanNodes].sort((a, b) => a.label.localeCompare(b.label) || a.id.localeCompare(b.id))) {
+    const slug = deduplicateFileName(obsidianNodeSlug(node, pageById2), usedOrphanSlugs);
+    orphanFilePath.set(node.id, `graph/nodes/${typePluralDir(node.type)}/${slug}.md`);
+  }
+  const wikilinkTarget = /* @__PURE__ */ new Map();
+  for (const node of graph.nodes) {
+    if (node.pageId) {
+      const page = pageById2.get(node.pageId);
+      if (page) {
+        wikilinkTarget.set(node.id, page.path.replace(/\.md$/, ""));
+        continue;
       }
-      lines.push("");
     }
-    await fs2.writeFile(path2.join(resolvedOutputDir, `${fileName}.md`), lines.join("\n"), "utf8");
+    const orphanPath = orphanFilePath.get(node.id);
+    if (orphanPath) {
+      wikilinkTarget.set(node.id, orphanPath.replace(/\.md$/, ""));
+    }
+  }
+  let fileCount = 0;
+  const wikiFiles = await listFilesRecursive2(paths.wikiDir);
+  const pageByPath = new Map(graph.pages.map((p) => [p.path, p]));
+  for (const relPath of wikiFiles) {
+    if (!relPath.endsWith(".md")) continue;
+    const srcFile = path2.join(paths.wikiDir, relPath);
+    const destFile = path2.join(resolvedOutputDir, relPath);
+    await ensureDir(path2.dirname(destFile));
+    let rawContent;
+    try {
+      rawContent = await fs2.readFile(srcFile, "utf8");
+    } catch {
+      continue;
+    }
+    const matchingPage = pageByPath.get(relPath);
+    const pageNodes = matchingPage ? nodesByPageId.get(matchingPage.id) ?? [] : [];
+    const parsed = matter(rawContent);
+    const data = parsed.data;
+    if (pageNodes.length > 0) {
+      const primaryNode = pageNodes[0];
+      if (primaryNode.communityId) {
+        data.graph_community = primaryNode.communityId;
+      }
+      const title = data.title ?? "";
+      const nodeAliases = pageNodes.map((n) => n.label).filter((label) => label.toLowerCase() !== title.toLowerCase());
+      const existingAliases = Array.isArray(data.aliases) ? data.aliases : [];
+      const mergedAliases = [.../* @__PURE__ */ new Set([...existingAliases, ...nodeAliases])];
+      if (mergedAliases.length > 0) {
+        data.aliases = mergedAliases;
+      }
+    }
+    let outputContent = matter.stringify(parsed.content, data);
+    if (pageNodes.length > 0) {
+      const connLines = connectionsSection(
+        pageNodes.map((n) => n.id),
+        adjacency,
+        nodesById,
+        wikilinkTarget
+      );
+      if (connLines.length > 0) {
+        outputContent = `${outputContent.trimEnd()}
+## Graph Connections
+${connLines.join("\n")}
+`;
+      }
+    }
+    await fs2.writeFile(destFile, outputContent, "utf8");
+    fileCount++;
+  }
+  for (const node of orphanNodes) {
+    const relPath = orphanFilePath.get(node.id);
+    const destFile = path2.join(resolvedOutputDir, relPath);
+    await ensureDir(path2.dirname(destFile));
+    const slug = path2.basename(relPath, ".md");
+    const aliases = node.label !== slug ? [node.label] : [];
+    const frontmatter = {
+      id: node.id,
+      type: node.type,
+      community: node.communityId ?? null,
+      confidence: node.confidence ?? null,
+      source_class: node.sourceClass ?? null,
+      tags: node.tags ?? []
+    };
+    if (aliases.length > 0) {
+      frontmatter.aliases = aliases;
+    }
+    const lines = [`# ${node.label}`, ""];
+    const connLines = connectionsSection([node.id], adjacency, nodesById, wikilinkTarget);
+    if (connLines.length > 0) {
+      lines.push("## Connections", "", ...connLines, "");
+    }
+    const content = matter.stringify(lines.join("\n"), frontmatter);
+    await fs2.writeFile(destFile, content, "utf8");
     fileCount++;
   }
   const usedCommunityFileNames = /* @__PURE__ */ new Set();
   for (const community of communities) {
+    const wikiCommunityPage = graph.pages.find(
+      (p) => p.kind === "community_summary" && p.nodeIds.some((nid) => community.nodeIds.includes(nid))
+    );
+    if (wikiCommunityPage) continue;
     const memberNodes = community.nodeIds.map((id) => nodesById.get(id)).filter((n2) => Boolean(n2));
     const memberIdSet = new Set(community.nodeIds);
     let internalEdges = 0;
@@ -1674,35 +1819,102 @@ async function exportObsidianVault(rootDir, outputDir) {
         return nbNode && nbNode.communityId !== community.id;
       });
     });
-    const communityFileName = deduplicateFileName(`_Community_${safeFileName(community.label)}`, usedCommunityFileNames);
-    const lines = [
-      "---",
-      `id: ${JSON.stringify(community.id)}`,
-      `node_count: ${memberNodes.length}`,
-      `cohesion: ${cohesion.toFixed(4)}`,
-      "---",
-      "",
-      `# ${community.label}`,
-      "",
-      "## Members",
-      ""
-    ];
+    const communitySlug = deduplicateFileName(safeFileName(community.label), usedCommunityFileNames);
+    const destFile = path2.join(resolvedOutputDir, "graph", "communities", `${communitySlug}.md`);
+    await ensureDir(path2.dirname(destFile));
+    const lines = [`# ${community.label}`, "", "## Members", ""];
     for (const member of memberNodes) {
-      const memberFile = nodeFileName.get(member.id) ?? safeFileName(member.label);
-      lines.push(`- [[${memberFile}]]`);
+      const target = wikilinkTarget.get(member.id);
+      if (target) {
+        lines.push(`- [[${target}|${member.label}]]`);
+      } else {
+        lines.push(`- ${member.label}`);
+      }
     }
     lines.push("");
     if (bridgeNodes.length > 0) {
       lines.push("## Bridge Nodes", "");
       for (const bridge of bridgeNodes) {
-        const bridgeFile = nodeFileName.get(bridge.id) ?? safeFileName(bridge.label);
-        lines.push(`- [[${bridgeFile}]]`);
+        const target = wikilinkTarget.get(bridge.id);
+        if (target) {
+          lines.push(`- [[${target}|${bridge.label}]]`);
+        } else {
+          lines.push(`- ${bridge.label}`);
+        }
       }
       lines.push("");
     }
-    await fs2.writeFile(path2.join(resolvedOutputDir, `${communityFileName}.md`), lines.join("\n"), "utf8");
+    const frontmatter = {
+      id: community.id,
+      node_count: memberNodes.length,
+      cohesion: Number(cohesion.toFixed(4))
+    };
+    const content = matter.stringify(lines.join("\n"), frontmatter);
+    await fs2.writeFile(destFile, content, "utf8");
     fileCount++;
   }
+  const outputsAssetsDir = path2.join(paths.wikiDir, "outputs", "assets");
+  try {
+    const assetFiles = await listFilesRecursive2(outputsAssetsDir);
+    for (const relAsset of assetFiles) {
+      const src = path2.join(outputsAssetsDir, relAsset);
+      const dest = path2.join(resolvedOutputDir, "outputs", "assets", relAsset);
+      await ensureDir(path2.dirname(dest));
+      await fs2.copyFile(src, dest);
+      fileCount++;
+    }
+  } catch {
+  }
+  try {
+    const rawAssetFiles = await listFilesRecursive2(paths.rawAssetsDir);
+    for (const relAsset of rawAssetFiles) {
+      const src = path2.join(paths.rawAssetsDir, relAsset);
+      const dest = path2.join(resolvedOutputDir, "raw", "assets", relAsset);
+      await ensureDir(path2.dirname(dest));
+      await fs2.copyFile(src, dest);
+      fileCount++;
+    }
+  } catch {
+  }
+  const obsidianDir = path2.join(resolvedOutputDir, ".obsidian");
+  await ensureDir(obsidianDir);
+  const projectIds = Object.keys(
+    graph.pages.reduce(
+      (acc, page) => {
+        for (const pid of page.projectIds) acc[pid] = true;
+        return acc;
+      },
+      {}
+    )
+  );
+  const colorGroups = projectIds.map((pid, index) => ({
+    query: `tag:#project/${pid}`,
+    color: ["#0ea5e9", "#22c55e", "#f59e0b", "#8b5cf6", "#fb7185", "#14b8a6"][index % 6]
+  }));
+  await fs2.writeFile(
+    path2.join(obsidianDir, "app.json"),
+    JSON.stringify(
+      { newFileLocation: "folder", newFileFolderPath: "outputs", attachmentFolderPath: "raw/assets", useMarkdownLinks: false },
+      null,
+      2
+    ),
+    "utf8"
+  );
+  await fs2.writeFile(
+    path2.join(obsidianDir, "core-plugins.json"),
+    JSON.stringify(["file-explorer", "global-search", "graph", "backlink", "tag-pane", "page-preview", "outline"], null, 2),
+    "utf8"
+  );
+  await fs2.writeFile(
+    path2.join(obsidianDir, "graph.json"),
+    JSON.stringify(
+      { colorGroups, "collapse-filter": false, search: "", showTags: true, showAttachments: false, showOrphans: true },
+      null,
+      2
+    ),
+    "utf8"
+  );
+  fileCount += 3;
   return { format: "obsidian", outputPath: resolvedOutputDir, fileCount };
 }
 async function exportObsidianCanvas(rootDir, outputPath) {
@@ -2782,7 +2994,7 @@ import fs11 from "fs/promises";
 import path12 from "path";
 import { pathToFileURL } from "url";
 import { Readability } from "@mozilla/readability";
-import matter3 from "gray-matter";
+import matter4 from "gray-matter";
 import ignore from "ignore";
 import { isText } from "istextorbinary";
 import { JSDOM as JSDOM2 } from "jsdom";
@@ -2797,9 +3009,9 @@ import YAML2 from "yaml";
 // src/code-tree-sitter.ts
 import fs5 from "fs/promises";
-import { createRequire } from "module";
+import { createRequire as createRequire2 } from "module";
 import path5 from "path";
-var require2 = createRequire(import.meta.url);
+var require2 = createRequire2(import.meta.url);
 var TREE_SITTER_RUNTIME_PACKAGE = "@vscode/tree-sitter-wasm";
 var TREE_SITTER_EXTRA_GRAMMARS_PACKAGE = "tree-sitter-wasms";
 var SWIFT_TREE_SITTER_OPT_IN_ENV = "SWARMVAULT_ENABLE_SWIFT_TREE_SITTER";
@@ -2926,8 +3138,8 @@ function singleLineSignature(value) {
     180
   );
 }
-function makeSymbolId(sourceId, name, seen) {
-  const base = slugify(name);
+function makeSymbolId(sourceId, name, kind, seen) {
+  const base = `${slugify(name)}.${kind}`;
   const count = (seen.get(base) ?? 0) + 1;
   seen.set(base, count);
   return `symbol:${sourceId}:${count === 1 ? base : `${base}-${count}`}`;
@@ -3009,7 +3221,7 @@ function finalizeCodeAnalysis(manifest, language, imports, draftSymbols, exportL
   }
   const seenSymbolIds = /* @__PURE__ */ new Map();
   const symbols = draftSymbols.map((symbol) => ({
-    id: makeSymbolId(manifest.sourceId, symbol.name, seenSymbolIds),
+    id: makeSymbolId(manifest.sourceId, symbol.name, symbol.kind, seenSymbolIds),
     name: symbol.name,
     kind: symbol.kind,
     signature: symbol.signature,
@@ -6272,7 +6484,7 @@ function htmlCodeAnalysis(manifest, rootNode, diagnostics) {
       }
       continue;
     }
-    if (tagName && tagName.includes("-")) {
+    if (tagName?.includes("-")) {
       if (!seenSymbolNames.has(tagName)) {
         seenSymbolNames.add(tagName);
         draftSymbols.push({
@@ -6818,8 +7030,8 @@ function isNodeExported(node) {
     )
   );
 }
-function makeSymbolId2(scope, name, seen) {
-  const base = slugify(name);
+function makeSymbolId2(scope, name, kind, seen) {
+  const base = `${slugify(name)}.${kind}`;
   const count = (seen.get(base) ?? 0) + 1;
   seen.set(base, count);
   return `symbol:${scope}:${count === 1 ? base : `${base}-${count}`}`;
@@ -6986,7 +7198,7 @@ function finalizeCodeAnalysis2(manifest, language, imports, draftSymbols, export
   const seenSymbolIds = /* @__PURE__ */ new Map();
   const symbolScope = metadata?.namespace ? `ns:${slugify(metadata.namespace)}` : manifest.sourceId;
   const symbols = draftSymbols.map((symbol) => ({
-    id: makeSymbolId2(symbolScope, symbol.name, seenSymbolIds),
+    id: makeSymbolId2(symbolScope, symbol.name, symbol.kind, seenSymbolIds),
     name: symbol.name,
     kind: symbol.kind,
     signature: symbol.signature,
@@ -7400,6 +7612,81 @@ function manifestBasenameWithoutExtension(manifest) {
   const target = manifest.repoRelativePath ?? manifest.originalPath ?? manifest.storedPath;
   return path6.posix.basename(stripCodeExtension2(normalizeAlias(target)));
 }
+async function readNearestTsconfigPaths(startPath, cache) {
+  let current = path6.resolve(startPath);
+  try {
+    const stat = await fs6.stat(current);
+    if (!stat.isDirectory()) {
+      current = path6.dirname(current);
+    }
+  } catch {
+    current = path6.dirname(current);
+  }
+  while (true) {
+    if (cache.has(current)) {
+      const cached = cache.get(current);
+      return cached === null ? void 0 : cached;
+    }
+    const tsconfigPath = path6.join(current, "tsconfig.json");
+    const exists = await fs6.access(tsconfigPath).then(() => true).catch(() => false);
+    if (exists) {
+      const configFile = ts.readConfigFile(tsconfigPath, (p) => ts.sys.readFile(p));
+      if (!configFile.error && configFile.config) {
+        const parsed = ts.parseJsonConfigFileContent(configFile.config, ts.sys, current);
+        const rawPaths = parsed.options.paths;
+        if (rawPaths && Object.keys(rawPaths).length > 0) {
+          const baseUrl = parsed.options.baseUrl ? toPosix(path6.relative(current, parsed.options.baseUrl)) : ".";
+          const config = { baseUrl, paths: rawPaths };
+          cache.set(current, config);
+          return config;
+        }
+      }
+      cache.set(current, null);
+      return void 0;
+    }
+    const parent = path6.dirname(current);
+    if (parent === current) {
+      cache.set(current, null);
+      return void 0;
+    }
+    current = parent;
+  }
+}
+function tsconfigPathAliasesForFile(repoRelativePath, config) {
+  const aliases = [];
+  const stripped = stripCodeExtension2(normalizeAlias(repoRelativePath));
+  const indexStripped = stripped.endsWith("/index") ? stripped.slice(0, -"/index".length) : void 0;
+  for (const [pattern, targets] of Object.entries(config.paths)) {
+    for (const target of targets) {
+      if (pattern.includes("*") && target.includes("*")) {
+        const targetPrefix = normalizeAlias(
+          config.baseUrl === "." ? target.replace("*", "") : path6.posix.join(config.baseUrl, target.replace("*", ""))
+        );
+        const patternBase = pattern.replace("*", "");
+        for (const candidate of [stripped, indexStripped]) {
+          if (candidate && candidate.startsWith(targetPrefix)) {
+            aliases.push(patternBase + candidate.slice(targetPrefix.length));
+          }
+        }
+      } else if (!pattern.includes("*") && !target.includes("*")) {
+        const targetNorm = normalizeAlias(config.baseUrl === "." ? target : path6.posix.join(config.baseUrl, target));
+        if (stripped === stripCodeExtension2(targetNorm) || indexStripped === stripCodeExtension2(targetNorm)) {
+          aliases.push(pattern);
+        }
+      }
+    }
+  }
+  if (config.baseUrl !== ".") {
+    const basePrefix = normalizeAlias(config.baseUrl) + "/";
+    if (stripped.startsWith(basePrefix)) {
+      aliases.push(stripped.slice(basePrefix.length));
+    }
+    if (indexStripped && indexStripped.startsWith(basePrefix)) {
+      aliases.push(indexStripped.slice(basePrefix.length));
+    }
+  }
+  return aliases;
+}
 async function readNearestDartPackageInfo(startPath, cache) {
   let current = path6.resolve(startPath);
   try {
@@ -7562,6 +7849,7 @@ async function buildCodeIndex(rootDir, manifests, analyses) {
   const analysesBySourceId = new Map(analyses.map((analysis) => [analysis.sourceId, analysis]));
   const goModuleCache = /* @__PURE__ */ new Map();
   const dartPackageCache = /* @__PURE__ */ new Map();
+  const tsconfigCache = /* @__PURE__ */ new Map();
   const entries = [];
   for (const manifest of manifests) {
     const analysis = analysesBySourceId.get(manifest.sourceId);
@@ -7583,6 +7871,20 @@ async function buildCodeIndex(rootDir, manifests, analyses) {
     recordAlias(aliases, normalizedModuleName);
     recordAlias(aliases, normalizedNamespace);
     switch (analysis.code.language) {
+      case "javascript":
+      case "jsx":
+      case "typescript":
+      case "tsx": {
+        if (repoRelativePath && manifest.originalPath) {
+          const tsconfigPaths = await readNearestTsconfigPaths(manifest.originalPath, tsconfigCache);
+          if (tsconfigPaths) {
+            for (const alias of tsconfigPathAliasesForFile(repoRelativePath, tsconfigPaths)) {
+              recordAlias(aliases, alias);
+            }
+          }
+        }
+        break;
+      }
       case "python":
         recordAlias(aliases, normalizedModuleName?.replace(/\//g, "."));
         break;
@@ -8039,6 +8341,7 @@ import { parse as parseCsvSync } from "csv-parse/sync";
 import { strFromU8, unzipSync } from "fflate";
 import { JSDOM } from "jsdom";
 import TurndownService from "turndown";
+import { fetchTranscript } from "youtube-transcript-plus";
 import { z } from "zod";
 // src/markdown-ast.ts
@@ -8237,6 +8540,107 @@ async function extractImageWithVision(rootDir, input) {
     await attachment.cleanup();
   }
 }
+async function extractAudioTranscription(rootDir, input) {
+  let provider;
+  try {
+    provider = await getProviderForTask(rootDir, "audioProvider");
+  } catch (error) {
+    return {
+      artifact: {
+        ...extractionMetadata("audio", input.mimeType, "audio_transcription"),
+        warnings: [`Audio transcription unavailable: ${error instanceof Error ? error.message : "provider not configured"}`]
+      }
+    };
+  }
+  if (!provider.capabilities.has("audio") || !provider.transcribeAudio) {
+    return {
+      artifact: {
+        ...extractionMetadata("audio", input.mimeType, "audio_transcription"),
+        warnings: [`Audio transcription unavailable for provider ${provider.id}. Configure a provider with audio capability.`]
+      }
+    };
+  }
+  try {
+    const result = await provider.transcribeAudio({
+      mimeType: input.mimeType,
+      bytes: input.bytes,
+      fileName: input.fileName
+    });
+    const metadata = {};
+    if (result.duration !== void 0) {
+      metadata.duration = String(result.duration);
+    }
+    if (result.language) {
+      metadata.language = result.language;
+    }
+    return {
+      extractedText: result.text || void 0,
+      artifact: {
+        ...extractionMetadata("audio", input.mimeType, "audio_transcription"),
+        providerId: provider.id,
+        providerModel: provider.model,
+        metadata: Object.keys(metadata).length ? metadata : void 0
+      }
+    };
+  } catch (error) {
+    return {
+      artifact: {
+        ...extractionMetadata("audio", input.mimeType, "audio_transcription"),
+        providerId: provider.id,
+        providerModel: provider.model,
+        warnings: [`Audio transcription failed: ${error instanceof Error ? truncate(error.message, 240) : "unknown error"}`]
+      }
+    };
+  }
+}
+async function extractYoutubeTranscript(input) {
+  try {
+    const result = await fetchTranscript(input.videoId, { videoDetails: true });
+    const details = result.videoDetails;
+    const title = details?.title ?? `YouTube ${input.videoId}`;
+    const transcriptText = result.segments?.map((part) => part.text).join(" ") ?? "";
+    const sections = [`# ${title}`];
+    const metaLines = [];
+    if (details?.author) metaLines.push(`**Author:** ${details.author}`);
+    if (details?.lengthSeconds) {
+      const seconds = details.lengthSeconds;
+      const minutes = Math.floor(seconds / 60);
+      const secs = seconds % 60;
+      metaLines.push(`**Duration:** ${minutes}:${String(secs).padStart(2, "0")}`);
+    }
+    if (details?.viewCount) metaLines.push(`**Views:** ${Number(details.viewCount).toLocaleString()}`);
+    metaLines.push(`**URL:** ${input.url}`);
+    if (metaLines.length) {
+      sections.push(metaLines.join("\n"));
+    }
+    if (transcriptText.trim()) {
+      sections.push(`## Transcript
+${transcriptText.trim()}`);
+    }
+    const extractedText = sections.join("\n\n");
+    const metadata = {};
+    if (details?.title) metadata.title = details.title;
+    if (details?.author) metadata.author = details.author;
+    if (details?.lengthSeconds) metadata.duration = String(details.lengthSeconds);
+    if (details?.viewCount) metadata.viewCount = String(details.viewCount);
+    return {
+      title,
+      extractedText: extractedText || void 0,
+      artifact: {
+        ...extractionMetadata("youtube", "text/html", "youtube_transcript"),
+        metadata: Object.keys(metadata).length ? metadata : void 0
+      }
+    };
+  } catch (error) {
+    return {
+      artifact: {
+        ...extractionMetadata("youtube", "text/html", "youtube_transcript"),
+        warnings: [`YouTube transcript extraction failed: ${error instanceof Error ? truncate(error.message, 240) : "unknown error"}`]
+      }
+    };
+  }
+}
 function normalizePdfMetadata(raw) {
   if (!raw || typeof raw !== "object") {
     return void 0;
@@ -10034,7 +10438,7 @@ async function extractSlackExportDirectory(directoryPath) {
 // src/logs.ts
 import fs8 from "fs/promises";
 import path8 from "path";
-import matter from "gray-matter";
+import matter2 from "gray-matter";
 async function resolveUniqueSessionPath(rootDir, operation, title, startedAt) {
   const { paths } = await initWorkspace(rootDir);
   await ensureDir(paths.sessionsDir);
@@ -10087,7 +10491,7 @@ async function recordSession(rootDir, input) {
       token_usage: input.tokenUsage
     }).filter(([, value]) => value !== void 0)
   );
-  const content = matter.stringify(
+  const content = matter2.stringify(
     [
       `# ${input.operation[0]?.toUpperCase() ?? ""}${input.operation.slice(1)} Session`,
       "",
@@ -10308,7 +10712,7 @@ async function managedSourceWorkingDir(rootDir, sourceId) {
 // src/watch-state.ts
 import fs10 from "fs/promises";
 import path11 from "path";
-import matter2 from "gray-matter";
+import matter3 from "gray-matter";
 function pendingEntryKey(entry) {
   return entry.path;
 }
@@ -10420,13 +10824,13 @@ async function markPagesStaleForSources(rootDir, sourceIds) {
       continue;
     }
     const raw = await fs10.readFile(absolutePath, "utf8");
-    const parsed = matter2(raw);
+    const parsed = matter3(raw);
     if (parsed.data.freshness === "stale") {
       continue;
     }
     parsed.data.freshness = "stale";
     parsed.data.updated_at = now;
-    await writeFileIfChanged(absolutePath, matter2.stringify(parsed.content, parsed.data));
+    await writeFileIfChanged(absolutePath, matter3.stringify(parsed.content, parsed.data));
   }
   return affectedPagePaths;
 }
@@ -10522,6 +10926,9 @@ function inferKind(mimeType, filePath, detectionOptions = {}) {
   if (mimeType === "application/vnd.openxmlformats-officedocument.presentationml.presentation" || mimeType === "application/vnd.ms-powerpoint.presentation.macroenabled.12" || mimeType === "application/vnd.ms-powerpoint.template.macroenabled.12" || mimeType === "application/vnd.openxmlformats-officedocument.presentationml.template" || filePath.toLowerCase().endsWith(".pptx") || filePath.toLowerCase().endsWith(".pptm") || filePath.toLowerCase().endsWith(".potx") || filePath.toLowerCase().endsWith(".potm")) {
     return "pptx";
   }
+  if (mimeType.startsWith("audio/") || /\.(mp3|wav|m4a|ogg|flac|webm|aac|wma)$/i.test(filePath)) {
+    return "audio";
+  }
   if (mimeType.startsWith("image/") || isImagePath(filePath)) {
     return "image";
   }
@@ -10546,6 +10953,10 @@ var IMAGE_EXTENSIONS = /* @__PURE__ */ new Set([
 function isImagePath(filePath) {
   return IMAGE_EXTENSIONS.has(path12.extname(filePath).toLowerCase());
 }
+var YOUTUBE_URL_PATTERN = /(?:youtube\.com\/watch\?.*v=|youtu\.be\/|youtube\.com\/embed\/|youtube\.com\/shorts\/)([\w-]{11})/i;
+function parseYoutubeVideoId(url) {
+  return url.match(YOUTUBE_URL_PATTERN)?.[1];
+}
 function isStructuredTextMime(mimeType) {
   switch (mimeType) {
     case "application/json":
@@ -10813,7 +11224,7 @@ function normalizeSemanticMarkdownList(value) {
   return items.length ? items : void 0;
 }
 function semanticMarkdownTitle(fallback, content, filePath) {
-  const parsed = matter3(content);
+  const parsed = matter4(content);
   const frontmatterTitle = normalizeSemanticMarkdownScalar(parsed.data.title);
   if (frontmatterTitle) {
     return frontmatterTitle;
@@ -10821,7 +11232,7 @@ function semanticMarkdownTitle(fallback, content, filePath) {
   return titleFromText(fallback, parsed.content, filePath);
 }
 function semanticMarkdownContent(content) {
-  const parsed = matter3(content);
+  const parsed = matter4(content);
   const body = parsed.content.replace(/\r\n?/g, "\n").trim();
   const semanticFrontmatter = Object.fromEntries(
     MARKDOWN_SEMANTIC_FRONTMATTER_KEYS.flatMap((key) => {
@@ -11025,7 +11436,7 @@ function markdownFrontmatter(value) {
       ([, rawValue]) => Array.isArray(rawValue) ? rawValue.length > 0 : Boolean(typeof rawValue === "string" ? rawValue.trim() : rawValue)
     )
   );
-  return matter3.stringify("", normalized).trimEnd().split("\n").concat([""]);
+  return matter4.stringify("", normalized).trimEnd().split("\n").concat([""]);
 }
 function prepareCapturedMarkdownInput(input) {
   return finalizePreparedInput({
@@ -11843,7 +12254,7 @@ function preparedMatchesManifest(manifest, prepared, contentHash) {
   return manifest.contentHash === contentHash && manifest.extractionHash === (prepared.extractionHash ?? buildExtractionHash(prepared.extractedText, prepared.extractionArtifact)) && manifest.semanticHash === (prepared.semanticHash ?? contentHash) && manifest.title === prepared.title && manifest.sourceKind === prepared.sourceKind && manifest.sourceType === prepared.sourceType && manifest.sourceClass === prepared.sourceClass && manifest.language === prepared.language && manifest.mimeType === prepared.mimeType && manifest.repoRelativePath === prepared.repoRelativePath && manifest.sourceGroupId === prepared.sourceGroupId && manifest.sourceGroupTitle === prepared.sourceGroupTitle && manifest.sourcePartKey === prepared.sourcePartKey && manifest.partIndex === prepared.partIndex && manifest.partCount === prepared.partCount && manifest.partTitle === prepared.partTitle && JSON.stringify(manifest.details ?? {}) === JSON.stringify(prepared.details ?? {});
 }
 function shouldDeferWatchSemanticRefresh(sourceKind) {
-  return sourceKind === "markdown" || sourceKind === "text" || sourceKind === "html" || sourceKind === "pdf" || sourceKind === "docx" || sourceKind === "epub" || sourceKind === "csv" || sourceKind === "xlsx" || sourceKind === "pptx" || sourceKind === "transcript" || sourceKind === "chat_export" || sourceKind === "email" || sourceKind === "calendar" || sourceKind === "image";
+  return sourceKind === "markdown" || sourceKind === "text" || sourceKind === "html" || sourceKind === "pdf" || sourceKind === "docx" || sourceKind === "epub" || sourceKind === "csv" || sourceKind === "xlsx" || sourceKind === "pptx" || sourceKind === "transcript" || sourceKind === "chat_export" || sourceKind === "email" || sourceKind === "calendar" || sourceKind === "image" || sourceKind === "audio";
 }
 function pendingSemanticRefreshId(changeType, repoRoot, relativePath) {
   return `pending:${changeType}:${sha256(`${toPosix(repoRoot)}:${relativePath}`).slice(0, 12)}`;
@@ -12334,6 +12745,15 @@ async function prepareFileInputs(rootDir, absoluteInput, repoRoot, sourceClass)
     title = extracted.title?.trim() || title;
     extractedText = extracted.extractedText;
     extractionArtifact = extracted.artifact;
+  } else if (sourceKind === "audio") {
+    title = path12.basename(absoluteInput, path12.extname(absoluteInput));
+    const extracted = await extractAudioTranscription(rootDir, {
+      mimeType,
+      bytes: payloadBytes,
+      fileName: absoluteInput
+    });
+    extractedText = extracted.extractedText;
+    extractionArtifact = extracted.artifact;
   } else {
     title = path12.basename(absoluteInput, path12.extname(absoluteInput));
   }
@@ -12365,6 +12785,28 @@ async function prepareFileInput(rootDir, absoluteInput, repoRoot, sourceClass) {
 }
 async function prepareUrlInputs(rootDir, input, options) {
   await validateUrlSafety(input);
+  const youtubeVideoId = parseYoutubeVideoId(input);
+  if (youtubeVideoId) {
+    const extracted = await extractYoutubeTranscript({ videoId: youtubeVideoId, url: input });
+    const title2 = extracted.title ?? `YouTube ${youtubeVideoId}`;
+    const extractedText2 = extracted.extractedText;
+    const payloadBytes2 = Buffer.from(extractedText2 ?? "", "utf8");
+    return [
+      finalizePreparedInput({
+        title: title2,
+        originType: "url",
+        sourceKind: "youtube",
+        url: normalizeOriginUrl(input),
+        mimeType: "text/html",
+        storedExtension: ".md",
+        payloadBytes: payloadBytes2,
+        extractedText: extractedText2,
+        extractionArtifact: extracted.artifact,
+        extractionHash: buildExtractionHash(extractedText2, extracted.artifact),
+        details: extracted.artifact.metadata
+      })
+    ];
+  }
   const response = await fetch(input);
   if (!response.ok) {
     throw new Error(`Failed to fetch ${input}: ${response.status} ${response.statusText}`);
@@ -12584,6 +13026,14 @@ async function prepareUrlInputs(rootDir, input, options) {
       title = extracted.title?.trim() || title;
       extractedText = extracted.extractedText;
       extractionArtifact = extracted.artifact;
+    } else if (sourceKind === "audio") {
+      const extracted = await extractAudioTranscription(rootDir, {
+        mimeType,
+        bytes: payloadBytes,
+        fileName: inputUrl.pathname
+      });
+      extractedText = extracted.extractedText;
+      extractionArtifact = extracted.artifact;
     }
   }
   return [
@@ -13171,7 +13621,7 @@ 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 matter10 from "gray-matter";
 import { z as z7 } from "zod";
 // src/analysis.ts
@@ -13607,7 +14057,7 @@ function conflictConfidence(claimA, claimB) {
 // src/deep-lint.ts
 import fs13 from "fs/promises";
 import path17 from "path";
-import matter4 from "gray-matter";
+import matter5 from "gray-matter";
 import { z as z5 } from "zod";
 // src/findings.ts
@@ -13981,7 +14431,7 @@ async function loadContextPages(rootDir, graph) {
     contextPages.slice(0, 18).map(async (page) => {
       const absolutePath = path17.join(paths.wikiDir, page.path);
       const raw = await fs13.readFile(absolutePath, "utf8").catch(() => "");
-      const parsed = matter4(raw);
+      const parsed = matter5(raw);
       return {
         id: page.id,
         title: page.title,
@@ -14917,7 +15367,7 @@ function enrichGraph(graph, manifests, analyses, extraSimilarityEdges = []) {
 }
 // src/markdown.ts
-import matter5 from "gray-matter";
+import matter6 from "gray-matter";
 function uniqueStrings2(values) {
   return uniqueBy(values.filter(Boolean), (value) => value);
 }
@@ -15172,7 +15622,7 @@ function buildSourcePage(manifest, analysis, schemaHash, metadata, relatedOutput
       compiledFrom: metadata.compiledFrom,
       managedBy: metadata.managedBy
     },
-    content: matter5.stringify(body, safeFrontmatter(frontmatter))
+    content: matter6.stringify(body, safeFrontmatter(frontmatter))
   };
 }
 function buildModulePage(input) {
@@ -15322,7 +15772,7 @@ function buildModulePage(input) {
       compiledFrom: metadata.compiledFrom,
       managedBy: metadata.managedBy
     },
-    content: matter5.stringify(body, frontmatter)
+    content: matter6.stringify(body, frontmatter)
   };
 }
 function buildAggregatePage(kind, name, descriptions, sourceAnalyses, sourceHashes, sourceSemanticHashes, schemaHash, metadata, relativePath, relatedOutputs = [], decorations, existingContent) {
@@ -15399,7 +15849,7 @@ function buildAggregatePage(kind, name, descriptions, sourceAnalyses, sourceHash
       compiledFrom: metadata.compiledFrom,
       managedBy: metadata.managedBy
     },
-    content: matter5.stringify(body, frontmatter)
+    content: matter6.stringify(body, frontmatter)
   };
 }
 function buildIndexPage(pages, schemaHash, metadata, projectPages = []) {
@@ -15483,7 +15933,7 @@ function buildIndexPage(pages, schemaHash, metadata, projectPages = []) {
 }
 function buildSectionIndex(kind, pages, schemaHash, metadata, projectIds = []) {
   const title = kind.charAt(0).toUpperCase() + kind.slice(1);
-  return matter5.stringify(
+  return matter6.stringify(
     [`# ${title}`, "", ...pages.map((page) => `- [[${page.path.replace(/\.md$/, "")}|${page.title}]]`), ""].join("\n"),
     {
       page_id: `${kind}:index`,
@@ -15995,7 +16445,7 @@ function buildGraphReportPage(input) {
       compiledFrom: input.metadata.compiledFrom,
       managedBy: input.metadata.managedBy
     },
-    content: matter5.stringify(body, frontmatter)
+    content: matter6.stringify(body, frontmatter)
   };
 }
 function buildCommunitySummaryPage(input) {
@@ -16079,11 +16529,11 @@ function buildCommunitySummaryPage(input) {
       compiledFrom: input.metadata.compiledFrom,
       managedBy: input.metadata.managedBy
     },
-    content: matter5.stringify(body, frontmatter)
+    content: matter6.stringify(body, frontmatter)
   };
 }
 function buildProjectsIndex(projectPages, schemaHash, metadata) {
-  return matter5.stringify(
+  return matter6.stringify(
     [
       "# Projects",
       "",
@@ -16114,7 +16564,7 @@ function buildProjectsIndex(projectPages, schemaHash, metadata) {
 }
 function buildProjectIndex(input) {
   const title = `Project: ${input.projectId}`;
-  return matter5.stringify(
+  return matter6.stringify(
     [
       `# ${title}`,
       "",
@@ -16231,7 +16681,7 @@ function buildOutputPage(input) {
       outputFormat: input.outputFormat,
       outputAssets
     },
-    content: matter5.stringify(
+    content: matter6.stringify(
       (input.outputFormat === "slides" ? [
         input.answer,
         "",
@@ -16359,7 +16809,7 @@ function buildExploreHubPage(input) {
       outputFormat: input.outputFormat,
       outputAssets
     },
-    content: matter5.stringify(
+    content: matter6.stringify(
       (input.outputFormat === "slides" ? [
         `# ${title}`,
         "",
@@ -16625,12 +17075,12 @@ function buildOutputAssetManifest(input) {
 // src/outputs.ts
 import fs16 from "fs/promises";
 import path20 from "path";
-import matter7 from "gray-matter";
+import matter8 from "gray-matter";
 // src/pages.ts
 import fs15 from "fs/promises";
 import path19 from "path";
-import matter6 from "gray-matter";
+import matter7 from "gray-matter";
 function normalizeStringArray(value) {
   return Array.isArray(value) ? value.filter((item) => typeof item === "string") : [];
 }
@@ -16711,7 +17161,7 @@ async function loadExistingManagedPageState(absolutePath, defaults = {}) {
     };
   }
   const content = await fs15.readFile(absolutePath, "utf8");
-  const parsed = matter6(content);
+  const parsed = matter7(content);
   return {
     status: normalizePageStatus(parsed.data.status, defaults.status ?? "active"),
     managedBy: normalizePageManager(parsed.data.managed_by, defaults.managedBy ?? "system"),
@@ -16745,7 +17195,7 @@ function inferPageKind(relativePath, explicitKind = void 0) {
   return "index";
 }
 function parseStoredPage(relativePath, content, defaults = {}) {
-  const parsed = matter6(content);
+  const parsed = matter7(content);
   const now = (/* @__PURE__ */ new Date()).toISOString();
   const fallbackCreatedAt = defaults.createdAt ?? now;
   const fallbackUpdatedAt = defaults.updatedAt ?? fallbackCreatedAt;
@@ -16800,7 +17250,7 @@ async function loadInsightPages(wikiDir) {
   for (const absolutePath of files) {
     const relativePath = toPosix(path19.relative(wikiDir, absolutePath));
     const content = await fs15.readFile(absolutePath, "utf8");
-    const parsed = matter6(content);
+    const parsed = matter7(content);
     const stats = await fs15.stat(absolutePath);
     const title = typeof parsed.data.title === "string" ? parsed.data.title : path19.basename(absolutePath, ".md");
     const sourceIds = normalizeStringArray(parsed.data.source_ids);
@@ -16901,7 +17351,7 @@ async function loadSavedOutputPages(wikiDir) {
       const relativePath = path20.posix.join(current.relativeDir, entry.name);
       const absolutePath = path20.join(current.absoluteDir, entry.name);
       const content = await fs16.readFile(absolutePath, "utf8");
-      const parsed = matter7(content);
+      const parsed = matter8(content);
       const slug = relativePath.replace(/^outputs\//, "").replace(/\.md$/, "");
       const title = typeof parsed.data.title === "string" ? parsed.data.title : path20.basename(slug);
       const pageId = typeof parsed.data.page_id === "string" ? parsed.data.page_id : `output:${slug}`;
@@ -16955,7 +17405,7 @@ async function loadSavedOutputPages(wikiDir) {
 // src/search.ts
 import fs17 from "fs/promises";
 import path21 from "path";
-import matter8 from "gray-matter";
+import matter9 from "gray-matter";
 function warningMessage(warning) {
   return warning instanceof Error ? warning.message : String(warning);
 }
@@ -17043,7 +17493,7 @@ async function rebuildSearchIndex(dbPath, pages, wikiDir) {
   for (const page of pages) {
     const absolutePath = path21.join(wikiDir, page.path);
     const content = await fs17.readFile(absolutePath, "utf8");
-    const parsed = matter8(content);
+    const parsed = matter9(content);
     let body = parsed.content;
     const primarySourceId = Array.isArray(parsed.data.source_ids) && typeof parsed.data.source_ids[0] === "string" ? parsed.data.source_ids[0] : page.sourceIds[0];
     if ((page.kind === "source" || page.kind === "module") && primarySourceId) {
@@ -17454,7 +17904,7 @@ async function resolveImageGenerationProvider(rootDir) {
   if (!providerConfig) {
     throw new Error(`No provider configured with id "${preferredProviderId}" for task "imageProvider".`);
   }
-  const { createProvider: createProvider2 } = await import("./registry-UA42LQUQ.js");
+  const { createProvider: createProvider2 } = await import("./registry-SYCRRA65.js");
   return createProvider2(preferredProviderId, providerConfig, rootDir);
 }
 async function generateOutputArtifacts(rootDir, input) {
@@ -17973,7 +18423,7 @@ async function buildDashboardRecords(config, paths, graph, schemaHash, report) {
     {
       relativePath: "dashboards/index.md",
       title: "Dashboards",
-      content: (metadata) => matter9.stringify(
+      content: (metadata) => matter10.stringify(
         [
           "# Dashboards",
           "",
@@ -18025,7 +18475,7 @@ async function buildDashboardRecords(config, paths, graph, schemaHash, report) {
     {
       relativePath: "dashboards/recent-sources.md",
       title: "Recent Sources",
-      content: (metadata) => matter9.stringify(
+      content: (metadata) => matter10.stringify(
         [
           "# Recent Sources",
           "",
@@ -18068,7 +18518,7 @@ async function buildDashboardRecords(config, paths, graph, schemaHash, report) {
     {
       relativePath: "dashboards/reading-log.md",
       title: "Reading Log",
-      content: (metadata) => matter9.stringify(
+      content: (metadata) => matter10.stringify(
         [
           "# Reading Log",
           "",
@@ -18128,7 +18578,7 @@ async function buildDashboardRecords(config, paths, graph, schemaHash, report) {
     {
       relativePath: "dashboards/timeline.md",
       title: "Timeline",
-      content: (metadata) => matter9.stringify(
+      content: (metadata) => matter10.stringify(
         [
           "# Timeline",
           "",
@@ -18174,7 +18624,7 @@ async function buildDashboardRecords(config, paths, graph, schemaHash, report) {
     {
       relativePath: "dashboards/source-sessions.md",
       title: "Source Sessions",
-      content: (metadata) => matter9.stringify(
+      content: (metadata) => matter10.stringify(
         [
           "# Source Sessions",
           "",
@@ -18231,7 +18681,7 @@ async function buildDashboardRecords(config, paths, graph, schemaHash, report) {
     {
       relativePath: "dashboards/source-guides.md",
       title: "Source Guides",
-      content: (metadata) => matter9.stringify(
+      content: (metadata) => matter10.stringify(
         [
           "# Source Guides",
           "",
@@ -18284,7 +18734,7 @@ async function buildDashboardRecords(config, paths, graph, schemaHash, report) {
     {
       relativePath: "dashboards/research-map.md",
       title: "Research Map",
-      content: (metadata) => matter9.stringify(
+      content: (metadata) => matter10.stringify(
         [
           "# Research Map",
           "",
@@ -18348,7 +18798,7 @@ async function buildDashboardRecords(config, paths, graph, schemaHash, report) {
     {
       relativePath: "dashboards/contradictions.md",
       title: "Contradictions",
-      content: (metadata) => matter9.stringify(
+      content: (metadata) => matter10.stringify(
         [
           "# Contradictions",
           "",
@@ -18407,7 +18857,7 @@ async function buildDashboardRecords(config, paths, graph, schemaHash, report) {
     {
       relativePath: "dashboards/open-questions.md",
       title: "Open Questions",
-      content: (metadata) => matter9.stringify(
+      content: (metadata) => matter10.stringify(
         [
           "# Open Questions",
           "",
@@ -18483,7 +18933,12 @@ async function buildDashboardRecords(config, paths, graph, schemaHash, report) {
 function indexCompiledFrom(pages) {
   return uniqueStrings3(pages.flatMap((page) => page.sourceIds));
 }
-function deriveGraphMetrics(nodes, edges) {
+function autoResolution(nodeCount, edgeCount) {
+  if (nodeCount <= 20) return 0.5;
+  if (edgeCount / Math.max(1, nodeCount) < 2) return 0.8;
+  return 1;
+}
+function deriveGraphMetrics(nodes, edges, options) {
   const adjacency = /* @__PURE__ */ new Map();
   const connect = (left, right) => {
     if (!adjacency.has(left)) {
@@ -18520,7 +18975,8 @@ function deriveGraphMetrics(nodes, edges) {
       }
     }
   }
-  const louvainMapping = louvainGraph.size > 0 ? louvain(louvainGraph, { resolution: 1 }) : {};
+  const effectiveResolution = options?.resolution ?? autoResolution(louvainGraph.order, louvainGraph.size);
+  const louvainMapping = louvainGraph.size > 0 ? louvain(louvainGraph, { resolution: effectiveResolution }) : {};
   const groupByCommunity = /* @__PURE__ */ new Map();
   let nextIsolated = -1;
   for (const node of nonSourceNodes) {
@@ -18666,7 +19122,7 @@ function detectContradictions(analyses) {
   }
   return contradictions;
 }
-function buildGraph(manifests, analyses, pages, sourceProjects, _codeIndex) {
+function buildGraph(manifests, analyses, pages, sourceProjects, _codeIndex, options) {
   const manifestsById = new Map(manifests.map((manifest) => [manifest.sourceId, manifest]));
   const goPackageSymbolLookups = buildGoPackageSymbolLookups(analyses, manifestsById);
   const analysesBySourceId = new Map(analyses.map((analysis) => [analysis.sourceId, analysis]));
@@ -19026,7 +19482,7 @@ function buildGraph(manifests, analyses, pages, sourceProjects, _codeIndex) {
     manifests,
     analyses
   );
-  const metrics = deriveGraphMetrics(graphNodes, enriched.edges);
+  const metrics = deriveGraphMetrics(graphNodes, enriched.edges, { resolution: options?.communityResolution });
   return {
     generatedAt: (/* @__PURE__ */ new Date()).toISOString(),
     nodes: metrics.nodes,
@@ -19493,7 +19949,9 @@ async function syncVaultArtifacts(rootDir, input) {
   }
   const compiledPages = records.map((record) => record.page);
   const basePages = [...compiledPages, ...input.outputPages, ...input.insightPages];
-  const structuralGraph = buildGraph(input.manifests, input.analyses, basePages, input.sourceProjects, input.codeIndex);
+  const structuralGraph = buildGraph(input.manifests, input.analyses, basePages, input.sourceProjects, input.codeIndex, {
+    communityResolution: config.graph?.communityResolution
+  });
   const contradictions = detectContradictions(input.analyses);
   for (const contradiction of contradictions) {
     const edgeId = `contradiction:${contradiction.sourceIdA}->${contradiction.sourceIdB}`;
@@ -19515,7 +19973,9 @@ async function syncVaultArtifacts(rootDir, input) {
     const edges = uniqueBy([...structuralGraph.edges, ...embeddingEdges], (edge) => edge.id).sort(
       (left, right) => left.id.localeCompare(right.id)
     );
-    const metrics = deriveGraphMetrics(resetGraphNodeMetrics(structuralGraph.nodes), edges);
+    const metrics = deriveGraphMetrics(resetGraphNodeMetrics(structuralGraph.nodes), edges, {
+      resolution: config.graph?.communityResolution
+    });
     return {
       ...structuralGraph,
       nodes: metrics.nodes,
@@ -20086,7 +20546,7 @@ async function executeQuery(rootDir, question, format) {
       const absolutePath = path23.join(paths.wikiDir, result.path);
       try {
         const content = await fs19.readFile(absolutePath, "utf8");
-        const parsed = matter9(content);
+        const parsed = matter10(content);
         return `# ${result.title}
 ${truncate(normalizeWhitespace(parsed.content), 1200)}`;
       } catch {
@@ -20299,8 +20759,8 @@ function computeChangeSummary(current, staged, changeType) {
   if (changeType === "delete") return "Removed page";
   if (changeType === "promote") return "Promoted from candidate";
   if (!current || !staged) return "Updated page";
-  const currentParsed = matter9(current);
-  const stagedParsed = matter9(staged);
+  const currentParsed = matter10(current);
+  const stagedParsed = matter10(staged);
   const changes = [];
   const currentTags = currentParsed.data.tags ?? [];
   const stagedTags = stagedParsed.data.tags ?? [];
@@ -20501,9 +20961,9 @@ async function promoteCandidate(rootDir, target) {
   const graph = await readJsonFile(paths.graphPath);
   const candidate = resolveCandidateTarget(graph?.pages ?? [], target);
   const raw = await fs19.readFile(path23.join(paths.wikiDir, candidate.path), "utf8");
-  const parsed = matter9(raw);
+  const parsed = matter10(raw);
   const nextUpdatedAt = (/* @__PURE__ */ new Date()).toISOString();
-  const nextContent = matter9.stringify(parsed.content, {
+  const nextContent = matter10.stringify(parsed.content, {
     ...parsed.data,
     status: "active",
     updated_at: nextUpdatedAt,
@@ -20654,7 +21114,7 @@ async function initVault(rootDir, options = {}) {
   const now = (/* @__PURE__ */ new Date()).toISOString();
   await writeFileIfChanged(
     insightsIndexPath,
-    matter9.stringify(
+    matter10.stringify(
       (isResearchProfile ? [
         "# Insights",
         "",
@@ -20701,7 +21161,7 @@ async function initVault(rootDir, options = {}) {
   );
   await writeFileIfChanged(
     path23.join(paths.wikiDir, "projects", "index.md"),
-    matter9.stringify(["# Projects", "", "- Run `swarmvault compile` to build project rollups.", ""].join("\n"), {
+    matter10.stringify(["# Projects", "", "- Run `swarmvault compile` to build project rollups.", ""].join("\n"), {
       page_id: "projects:index",
       kind: "index",
       title: "Projects",
@@ -20724,7 +21184,7 @@ async function initVault(rootDir, options = {}) {
   );
   await writeFileIfChanged(
     path23.join(paths.wikiDir, "candidates", "index.md"),
-    matter9.stringify(["# Candidates", "", "- Run `swarmvault compile` to stage candidate pages.", ""].join("\n"), {
+    matter10.stringify(["# Candidates", "", "- Run `swarmvault compile` to stage candidate pages.", ""].join("\n"), {
       page_id: "candidates:index",
       kind: "index",
       title: "Candidates",
@@ -20751,7 +21211,7 @@ async function initVault(rootDir, options = {}) {
   if (isResearchProfile) {
     await writeFileIfChanged(
       path23.join(paths.wikiDir, "insights", "research-playbook.md"),
-      matter9.stringify(
+      matter10.stringify(
         [
           `# ${requestedProfile === "personal-research" ? "Personal Research Playbook" : "Research Playbook"}`,
           "",
@@ -21536,7 +21996,7 @@ async function benchmarkVault(rootDir, options = {}) {
     if (!await fileExists(absolutePath)) {
       continue;
     }
-    const parsed = matter9(await fs19.readFile(absolutePath, "utf8"));
+    const parsed = matter10(await fs19.readFile(absolutePath, "utf8"));
     pageContentsById.set(page.id, parsed.content);
   }
   const configuredQuestions = (config.benchmark?.questions ?? []).map((question) => normalizeWhitespace(question)).filter(Boolean);
@@ -21620,7 +22080,7 @@ async function readPage(rootDir, relativePath) {
     return null;
   }
   const raw = await fs19.readFile(absolutePath, "utf8");
-  const parsed = matter9(raw);
+  const parsed = matter10(raw);
   return {
     path: relativePath,
     title: typeof parsed.data.title === "string" ? parsed.data.title : path23.basename(relativePath, path23.extname(relativePath)),
@@ -21835,7 +22295,7 @@ async function bootstrapDemo(rootDir, input) {
 }
 // src/mcp.ts
-var SERVER_VERSION = "0.7.25";
+var SERVER_VERSION = "0.7.27";
 async function createMcpServer(rootDir) {
   const server = new McpServer({
     name: "swarmvault",
@@ -22520,7 +22980,7 @@ async function serveSchedules(rootDir, pollMs = 3e4) {
 import { spawn as spawn2 } from "child_process";
 import fs22 from "fs/promises";
 import path26 from "path";
-import matter10 from "gray-matter";
+import matter11 from "gray-matter";
 import { JSDOM as JSDOM3 } from "jsdom";
 var DEFAULT_CRAWL_MAX_PAGES = 12;
 var DEFAULT_CRAWL_MAX_DEPTH = 2;
@@ -23863,7 +24323,7 @@ async function buildGuidedUpdatePages(rootDir, scope, session) {
       const relativePath = useCanonicalTargets && targetPage ? targetPage.path : targetPage ? insightRelativePathForTarget(targetPage, scope) : `insights/topics/${slugify(scope.title)}.md`;
       const absolutePath = path26.join(paths.wikiDir, relativePath);
       const existingContent = await fileExists(absolutePath) ? await fs22.readFile(absolutePath, "utf8") : "";
-      const parsed = existingContent ? matter10(existingContent) : { data: {}, content: "" };
+      const parsed = existingContent ? matter11(existingContent) : { data: {}, content: "" };
       const existingData = parsed.data;
       const existingSourceIds = Array.isArray(existingData.source_ids) ? existingData.source_ids.filter((value) => typeof value === "string") : [];
       const existingProjectIds = Array.isArray(existingData.project_ids) ? existingData.project_ids.filter((value) => typeof value === "string") : [];
@@ -23924,7 +24384,7 @@ async function buildGuidedUpdatePages(rootDir, scope, session) {
         ""
       ].join("\n");
       const nextBody = replaceMarkedSection(baseBody, scope.id, updateBlock);
-      const content = matter10.stringify(
+      const content = matter11.stringify(
         `${nextBody.trimEnd()}
 `,
         JSON.parse(
@@ -24310,7 +24770,7 @@ import fs23 from "fs/promises";
 import http from "http";
 import path28 from "path";
 import { promisify as promisify2 } from "util";
-import matter11 from "gray-matter";
+import matter12 from "gray-matter";
 import mime2 from "mime-types";
 // src/graph-presentation.ts
@@ -24942,7 +25402,7 @@ async function readViewerPage(rootDir, relativePath) {
     return null;
   }
   const raw = await fs23.readFile(absolutePath, "utf8");
-  const parsed = matter11(raw);
+  const parsed = matter12(raw);
   return {
     path: relativePath,
     title: typeof parsed.data.title === "string" ? parsed.data.title : path28.basename(relativePath, path28.extname(relativePath)),