npm - @swarmvaultai/engine - Versions diffs - 0.7.24 → 0.7.26 - Mend

@swarmvaultai/engine 0.7.24 → 0.7.26

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/dist/chunk-MB7HPUTR.js +1364 -0
package/dist/chunk-N56FAH4N.js +1404 -0
package/dist/chunk-NAIERP4C.js +65 -0
package/dist/chunk-ZQ5T64AR.js +1365 -0
package/dist/index.d.ts +98 -5
package/dist/index.js +1124 -134
package/dist/registry-FKEREVDO.js +12 -0
package/dist/registry-SYCRRA65.js +12 -0
package/dist/registry-UA42LQUQ.js +12 -0
package/dist/token-estimation-TTONKT4O.js +10 -0
package/package.json +2 -1

package/dist/index.js CHANGED Viewed

@@ -22,7 +22,12 @@ import {
   uniqueBy,
   writeFileIfChanged,
   writeJsonFile
-} from "./chunk-2CH2WWS4.js";
+} from "./chunk-N56FAH4N.js";
+import {
+  estimatePageTokens,
+  estimateTokens,
+  trimToTokenBudget
+} from "./chunk-NAIERP4C.js";
 // src/agents.ts
 import crypto from "crypto";
@@ -450,9 +455,47 @@ async function installConfiguredAgents(rootDir) {
   );
 }
+// src/auto-commit.ts
+import { execFile } from "child_process";
+import { promisify } from "util";
+var execFileAsync = promisify(execFile);
+async function git(rootDir, ...args) {
+  const { stdout } = await execFileAsync("git", args, { cwd: rootDir });
+  return stdout.trim();
+}
+async function isGitRepo(rootDir) {
+  try {
+    await git(rootDir, "rev-parse", "--is-inside-work-tree");
+    return true;
+  } catch {
+    return false;
+  }
+}
+async function autoCommitWikiChanges(rootDir, operation, detail, options) {
+  const { config, paths } = await loadVaultConfig(rootDir);
+  if (!options?.force && !config.autoCommit) {
+    return null;
+  }
+  if (!await isGitRepo(rootDir)) {
+    return null;
+  }
+  const wikiRelative = paths.wikiDir.replace(`${rootDir}/`, "");
+  const stateRelative = paths.stateDir.replace(`${rootDir}/`, "");
+  await git(rootDir, "add", wikiRelative, stateRelative).catch(() => {
+  });
+  const status = await git(rootDir, "diff", "--cached", "--stat");
+  if (!status) {
+    return null;
+  }
+  const message = detail ? `vault ${operation}: ${detail}` : `vault ${operation}`;
+  await git(rootDir, "commit", "-m", message);
+  return message;
+}
 // src/graph-export.ts
 import fs2 from "fs/promises";
 import path2 from "path";
+import matter from "gray-matter";
 // src/graph-interchange.ts
 function exportHyperedgeNodeId(hyperedge) {
@@ -587,6 +630,316 @@ function graphCounts(graph) {
   };
 }
+// src/graph-report-html.ts
+function htmlEscape(text) {
+  return text.replace(/&/g, "&amp;").replace(/</g, "&lt;").replace(/>/g, "&gt;").replace(/"/g, "&quot;");
+}
+function nodeTypeColor(type) {
+  const colors = {
+    source: "#f59e0b",
+    module: "#fb7185",
+    symbol: "#8b5cf6",
+    rationale: "#14b8a6",
+    concept: "#0ea5e9",
+    entity: "#22c55e"
+  };
+  return colors[type] ?? "#94a3b8";
+}
+function renderGraphReportHtml(graph, report) {
+  const nodesByType = /* @__PURE__ */ new Map();
+  for (const node of graph.nodes) {
+    nodesByType.set(node.type, (nodesByType.get(node.type) ?? 0) + 1);
+  }
+  const edgesByRelation = /* @__PURE__ */ new Map();
+  for (const edge of graph.edges) {
+    edgesByRelation.set(edge.relation, (edgesByRelation.get(edge.relation) ?? 0) + 1);
+  }
+  const pagesByKind = /* @__PURE__ */ new Map();
+  for (const page of graph.pages) {
+    const list = pagesByKind.get(page.kind) ?? [];
+    list.push(page);
+    pagesByKind.set(page.kind, list);
+  }
+  const godNodes = (report?.godNodes ?? []).slice(0, 15);
+  const bridgeNodes = (report?.bridgeNodes ?? []).slice(0, 10);
+  const communities = graph.communities ?? [];
+  const warnings = report?.warnings ?? [];
+  const overview = report?.overview ?? {
+    nodes: graph.nodes.length,
+    edges: graph.edges.length,
+    pages: graph.pages.length,
+    communities: communities.length
+  };
+  const sortedEdgeRelations = [...edgesByRelation.entries()].sort((a, b) => b[1] - a[1]);
+  const sortedNodeTypes = [...nodesByType.entries()].sort((a, b) => b[1] - a[1]);
+  const sortedCommunities2 = [...communities].sort((a, b) => b.nodeIds.length - a.nodeIds.length).slice(0, 20);
+  return `<!DOCTYPE html>
+<html lang="en">
+<head>
+<meta charset="UTF-8">
+<meta name="viewport" content="width=device-width, initial-scale=1.0">
+<title>SwarmVault Graph Report</title>
+<style>
+:root {
+  --bg: #0f172a;
+  --surface: #1e293b;
+  --surface2: #334155;
+  --text: #e2e8f0;
+  --muted: #94a3b8;
+  --accent: #0ea5e9;
+  --accent2: #8b5cf6;
+  --border: #475569;
+  --success: #22c55e;
+  --warning: #f59e0b;
+  --danger: #ef4444;
+}
+* { box-sizing: border-box; margin: 0; padding: 0; }
+body {
+  font-family: -apple-system, BlinkMacSystemFont, "Segoe UI", system-ui, sans-serif;
+  background: var(--bg);
+  color: var(--text);
+  line-height: 1.6;
+  padding: 2rem;
+  max-width: 1200px;
+  margin: 0 auto;
+}
+h1 {
+  font-size: 1.75rem;
+  background: linear-gradient(135deg, var(--accent), var(--accent2));
+  -webkit-background-clip: text;
+  -webkit-text-fill-color: transparent;
+  margin-bottom: 0.25rem;
+}
+.subtitle { color: var(--muted); font-size: 0.85rem; margin-bottom: 2rem; }
+h2 {
+  font-size: 1.15rem;
+  color: var(--text);
+  border-bottom: 1px solid var(--border);
+  padding-bottom: 0.5rem;
+  margin: 2rem 0 1rem;
+}
+.stats-grid {
+  display: grid;
+  grid-template-columns: repeat(auto-fit, minmax(140px, 1fr));
+  gap: 1rem;
+  margin-bottom: 1.5rem;
+}
+.stat-card {
+  background: var(--surface);
+  border: 1px solid var(--border);
+  border-radius: 8px;
+  padding: 1rem;
+  text-align: center;
+}
+.stat-card .value {
+  font-size: 1.75rem;
+  font-weight: 700;
+  color: var(--accent);
+}
+.stat-card .label {
+  font-size: 0.8rem;
+  color: var(--muted);
+  text-transform: uppercase;
+  letter-spacing: 0.05em;
+}
+.badge {
+  display: inline-block;
+  padding: 0.15rem 0.5rem;
+  border-radius: 9999px;
+  font-size: 0.7rem;
+  font-weight: 600;
+  color: #fff;
+}
+table {
+  width: 100%;
+  border-collapse: collapse;
+  margin-bottom: 1rem;
+}
+th, td {
+  text-align: left;
+  padding: 0.5rem 0.75rem;
+  border-bottom: 1px solid var(--border);
+  font-size: 0.85rem;
+}
+th {
+  color: var(--muted);
+  font-weight: 600;
+  font-size: 0.75rem;
+  text-transform: uppercase;
+  letter-spacing: 0.05em;
+}
+tr:hover { background: var(--surface); }
+.bar-container {
+  display: flex;
+  align-items: center;
+  gap: 0.5rem;
+}
+.bar {
+  height: 8px;
+  border-radius: 4px;
+  background: var(--accent);
+  min-width: 2px;
+}
+.warning-list {
+  list-style: none;
+  padding: 0;
+}
+.warning-list li {
+  padding: 0.5rem 0.75rem;
+  margin-bottom: 0.5rem;
+  background: var(--surface);
+  border-left: 3px solid var(--warning);
+  border-radius: 0 4px 4px 0;
+  font-size: 0.85rem;
+}
+.page-group { margin-bottom: 1.5rem; }
+.page-group-title {
+  font-size: 0.85rem;
+  font-weight: 600;
+  color: var(--accent);
+  text-transform: capitalize;
+  margin-bottom: 0.5rem;
+}
+.page-list {
+  display: grid;
+  grid-template-columns: repeat(auto-fill, minmax(280px, 1fr));
+  gap: 0.5rem;
+}
+.page-item {
+  background: var(--surface);
+  border: 1px solid var(--border);
+  border-radius: 6px;
+  padding: 0.5rem 0.75rem;
+  font-size: 0.8rem;
+  overflow: hidden;
+  text-overflow: ellipsis;
+  white-space: nowrap;
+}
+.page-item .path { color: var(--muted); font-size: 0.7rem; }
+.empty { color: var(--muted); font-style: italic; font-size: 0.85rem; }
+input[type="text"] {
+  width: 100%;
+  padding: 0.5rem 0.75rem;
+  background: var(--surface);
+  border: 1px solid var(--border);
+  border-radius: 6px;
+  color: var(--text);
+  font-size: 0.85rem;
+  margin-bottom: 1rem;
+  outline: none;
+}
+input[type="text"]:focus { border-color: var(--accent); }
+.section { margin-bottom: 1rem; }
+footer { margin-top: 3rem; padding-top: 1rem; border-top: 1px solid var(--border); color: var(--muted); font-size: 0.75rem; text-align: center; }
+</style>
+</head>
+<body>
+<h1>SwarmVault Graph Report</h1>
+<p class="subtitle">Generated ${htmlEscape(report?.generatedAt ?? graph.generatedAt ?? (/* @__PURE__ */ new Date()).toISOString())}</p>
+<div class="stats-grid">
+  <div class="stat-card"><div class="value">${overview.nodes}</div><div class="label">Nodes</div></div>
+  <div class="stat-card"><div class="value">${overview.edges}</div><div class="label">Edges</div></div>
+  <div class="stat-card"><div class="value">${overview.pages}</div><div class="label">Pages</div></div>
+  <div class="stat-card"><div class="value">${overview.communities}</div><div class="label">Communities</div></div>
+  <div class="stat-card"><div class="value">${graph.sources.length}</div><div class="label">Sources</div></div>
+  <div class="stat-card"><div class="value">${(graph.hyperedges ?? []).length}</div><div class="label">Hyperedges</div></div>
+</div>
+<h2>Node Types</h2>
+<table>
+<thead><tr><th>Type</th><th>Count</th><th></th></tr></thead>
+<tbody>
+${sortedNodeTypes.map(([type, count]) => {
+    const maxCount = sortedNodeTypes[0]?.[1] ?? 1;
+    const pct = Math.round(count / maxCount * 100);
+    return `<tr><td><span class="badge" style="background:${nodeTypeColor(type)}">${htmlEscape(type)}</span></td><td>${count}</td><td><div class="bar-container"><div class="bar" style="width:${pct}%;background:${nodeTypeColor(type)}"></div></div></td></tr>`;
+  }).join("\n")}
+</tbody>
+</table>
+<h2>Edge Relations</h2>
+<table>
+<thead><tr><th>Relation</th><th>Count</th><th></th></tr></thead>
+<tbody>
+${sortedEdgeRelations.map(([relation, count]) => {
+    const maxCount = sortedEdgeRelations[0]?.[1] ?? 1;
+    const pct = Math.round(count / maxCount * 100);
+    return `<tr><td>${htmlEscape(relation)}</td><td>${count}</td><td><div class="bar-container"><div class="bar" style="width:${pct}%"></div></div></td></tr>`;
+  }).join("\n")}
+</tbody>
+</table>
+${godNodes.length ? `<h2>God Nodes (Highest Connectivity)</h2>
+<table>
+<thead><tr><th>Label</th><th>Degree</th><th>Bridge Score</th><th></th></tr></thead>
+<tbody>
+${godNodes.map((node) => {
+    const maxDegree = godNodes[0]?.degree ?? 1;
+    const pct = Math.round((node.degree ?? 0) / maxDegree * 100);
+    return `<tr><td>${htmlEscape(node.label)}</td><td>${node.degree ?? 0}</td><td>${(node.bridgeScore ?? 0).toFixed(2)}</td><td><div class="bar-container"><div class="bar" style="width:${pct}%;background:var(--accent2)"></div></div></td></tr>`;
+  }).join("\n")}
+</tbody>
+</table>` : ""}
+${bridgeNodes.length ? `<h2>Bridge Nodes</h2>
+<table>
+<thead><tr><th>Label</th><th>Degree</th><th>Bridge Score</th></tr></thead>
+<tbody>
+${bridgeNodes.map((node) => `<tr><td>${htmlEscape(node.label)}</td><td>${node.degree ?? 0}</td><td>${(node.bridgeScore ?? 0).toFixed(2)}</td></tr>`).join("\n")}
+</tbody>
+</table>` : ""}
+${sortedCommunities2.length ? `<h2>Communities</h2>
+<table>
+<thead><tr><th>Label</th><th>Nodes</th><th></th></tr></thead>
+<tbody>
+${sortedCommunities2.map((c) => {
+    const maxSize = sortedCommunities2[0]?.nodeIds.length ?? 1;
+    const pct = Math.round(c.nodeIds.length / maxSize * 100);
+    return `<tr><td>${htmlEscape(c.label)}</td><td>${c.nodeIds.length}</td><td><div class="bar-container"><div class="bar" style="width:${pct}%;background:var(--success)"></div></div></td></tr>`;
+  }).join("\n")}
+</tbody>
+</table>` : ""}
+${warnings.length ? `<h2>Warnings</h2>
+<ul class="warning-list">
+${warnings.map((w) => `<li>${htmlEscape(w)}</li>`).join("\n")}
+</ul>` : ""}
+<h2>Pages</h2>
+<input type="text" id="page-filter" placeholder="Filter pages..." />
+<div id="pages-container">
+${[...pagesByKind.entries()].sort((a, b) => a[0].localeCompare(b[0])).map(
+    ([kind, pages]) => `<div class="page-group" data-kind="${htmlEscape(kind)}">
+  <div class="page-group-title">${htmlEscape(kind)} (${pages.length})</div>
+  <div class="page-list">
+    ${pages.sort((a, b) => a.title.localeCompare(b.title)).map(
+      (p) => `<div class="page-item" data-title="${htmlEscape(p.title.toLowerCase())}"><strong>${htmlEscape(p.title)}</strong><div class="path">${htmlEscape(p.path)}</div></div>`
+    ).join("\n    ")}
+  </div>
+</div>`
+  ).join("\n")}
+</div>
+<footer>Generated by SwarmVault &middot; ${graph.nodes.length} nodes &middot; ${graph.edges.length} edges &middot; ${graph.pages.length} pages</footer>
+<script>
+document.getElementById("page-filter").addEventListener("input", function(e) {
+  var query = e.target.value.toLowerCase();
+  document.querySelectorAll(".page-item").forEach(function(el) {
+    el.style.display = el.getAttribute("data-title").includes(query) ? "" : "none";
+  });
+  document.querySelectorAll(".page-group").forEach(function(group) {
+    var visible = group.querySelectorAll('.page-item[style=""], .page-item:not([style])').length;
+    group.style.display = visible > 0 || !query ? "" : "none";
+  });
+});
+</script>
+</body>
+</html>`;
+}
 // src/graph-export.ts
 var NODE_COLORS = {
   source: "#f59e0b",
@@ -1220,6 +1573,14 @@ async function exportGraphFormat(rootDir, format, outputPath) {
   const resolvedPath = await writeGraphExport(outputPath, rendered);
   return { format, outputPath: resolvedPath };
 }
+async function exportGraphReportHtml(rootDir, outputPath) {
+  const { paths } = await loadVaultConfig(rootDir);
+  const graph = await loadGraph(rootDir);
+  const report = await readJsonFile(path2.join(paths.wikiDir, "graph", "report.json"));
+  const html = renderGraphReportHtml(graph, report);
+  const resolvedPath = await writeGraphExport(outputPath, html);
+  return { format: "report", outputPath: resolvedPath };
+}
 function safeFileName(label) {
   return label.replace(/[\\/*?:"<>|#^[\]]/g, "").replace(/\s+/g, " ").trim().slice(0, 200) || "unnamed";
 }
@@ -1233,14 +1594,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({
@@ -1258,44 +1632,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;
@@ -1314,35 +1808,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) {
@@ -1463,7 +2024,7 @@ function nodeMap(graph) {
 function pageMap(graph) {
   return new Map(graph.pages.map((page) => [page.id, page]));
 }
-function estimateTokens(text) {
+function estimateTokens2(text) {
   return Math.max(1, Math.ceil(text.length / CHARS_PER_TOKEN));
 }
 function estimateCorpusWords(texts) {
@@ -1500,7 +2061,7 @@ function benchmarkQueryTokens(graph, queryResult, pageContentsById) {
     const target = nodesById.get(edge.target)?.label ?? edge.target;
     lines.push(`EDGE ${source} --${edge.relation}/${edge.evidenceClass}/${edge.confidence.toFixed(2)}--> ${target}`);
   }
-  const queryTokens = estimateTokens(lines.join("\n"));
+  const queryTokens = estimateTokens2(lines.join("\n"));
   return {
     question: queryResult.question,
     queryTokens,
@@ -2217,6 +2778,67 @@ function graphDiff(oldGraph, newGraph) {
   const summary = parts.length ? parts.join("; ") : "No changes";
   return { addedNodes, removedNodes, addedEdges, removedEdges, addedPages, removedPages, summary };
 }
+function blastRadius(graph, target, options) {
+  const maxDepth = Math.max(1, Math.min(options?.maxDepth ?? 3, 10));
+  const resolved = resolveNode(graph, target);
+  const moduleNode = resolved?.type === "module" ? resolved : resolved?.moduleId ? graph.nodes.find((n) => n.id === resolved.moduleId) : void 0;
+  if (!moduleNode) {
+    const normalizedTarget = normalizeTarget(target);
+    const candidate = graph.nodes.filter((n) => n.type === "module").find((n) => normalizeTarget(n.label).includes(normalizedTarget) || normalizeTarget(n.id).includes(normalizedTarget));
+    if (!candidate) {
+      return {
+        target,
+        totalAffected: 0,
+        maxDepth,
+        affectedModules: [],
+        summary: `No module found matching "${target}".`
+      };
+    }
+    return blastRadius(graph, candidate.id, options);
+  }
+  const reverseImports = /* @__PURE__ */ new Map();
+  for (const edge of graph.edges) {
+    if (edge.relation === "imports") {
+      const dependents = reverseImports.get(edge.target) ?? [];
+      dependents.push(edge.source);
+      reverseImports.set(edge.target, dependents);
+    }
+  }
+  const affected = [];
+  const seen = /* @__PURE__ */ new Set([moduleNode.id]);
+  const frontier = [{ id: moduleNode.id, depth: 0 }];
+  const nodes = nodeById(graph);
+  while (frontier.length > 0) {
+    const current = frontier.shift();
+    if (current.depth >= maxDepth) {
+      continue;
+    }
+    for (const dependentId of reverseImports.get(current.id) ?? []) {
+      if (seen.has(dependentId)) {
+        continue;
+      }
+      seen.add(dependentId);
+      const dependentNode = nodes.get(dependentId);
+      const nextDepth = current.depth + 1;
+      affected.push({
+        moduleId: dependentId,
+        label: dependentNode?.label ?? dependentId,
+        depth: nextDepth
+      });
+      frontier.push({ id: dependentId, depth: nextDepth });
+    }
+  }
+  affected.sort((a, b) => a.depth - b.depth || a.label.localeCompare(b.label));
+  const summary = affected.length ? `Changing "${moduleNode.label}" affects ${affected.length} module${affected.length === 1 ? "" : "s"} (max depth ${maxDepth}).` : `No modules depend on "${moduleNode.label}".`;
+  return {
+    target,
+    resolvedModuleId: moduleNode.id,
+    affectedModules: affected,
+    totalAffected: affected.length,
+    maxDepth,
+    summary
+  };
+}
 // src/hooks.ts
 import fs4 from "fs/promises";
@@ -2361,7 +2983,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";
@@ -5851,7 +6473,7 @@ function htmlCodeAnalysis(manifest, rootNode, diagnostics) {
       }
       continue;
     }
-    if (tagName && tagName.includes("-")) {
+    if (tagName?.includes("-")) {
       if (!seenSymbolNames.has(tagName)) {
         seenSymbolNames.add(tagName);
         draftSymbols.push({
@@ -7618,6 +8240,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
@@ -7816,6 +8439,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;
@@ -9613,7 +10337,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);
@@ -9666,7 +10390,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`,
       "",
@@ -9887,7 +10611,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;
 }
@@ -9999,13 +10723,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;
 }
@@ -10101,6 +10825,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";
   }
@@ -10125,6 +10852,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":
@@ -10392,7 +11123,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;
@@ -10400,7 +11131,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) => {
@@ -10604,7 +11335,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({
@@ -11422,7 +12153,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)}`;
@@ -11913,6 +12644,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));
   }
@@ -11944,6 +12684,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}`);
@@ -12163,6 +12925,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 [
@@ -12750,7 +13520,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
@@ -13186,7 +13956,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
@@ -13560,7 +14330,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,
@@ -14024,6 +14794,33 @@ async function semanticGraphMatches(rootDir, graph, question, limit = 12) {
     score: Math.max(0, Number((cosineSimilarity(queryVector, vectors.get(`${item.kind}:${item.id}`) ?? []) * 100).toFixed(2)))
   })).filter((match) => match.score >= 18).sort((left, right) => right.score - left.score || left.label.localeCompare(right.label)).slice(0, limit);
 }
+async function semanticPageSearch(rootDir, graph, query, limit = 10) {
+  const items = await buildEmbeddableItems(rootDir, graph);
+  const pageItems = items.filter((item) => item.kind === "page");
+  if (!pageItems.length) {
+    return [];
+  }
+  const { provider, vectors } = await resolveVectorsForItems(rootDir, graph.generatedAt, items);
+  if (!provider) {
+    return [];
+  }
+  const [queryVector] = await provider.embedTexts([query]);
+  if (!Array.isArray(queryVector) || queryVector.length === 0) {
+    return [];
+  }
+  const pageMap2 = new Map(graph.pages.map((page) => [page.id, page]));
+  return pageItems.map((item) => {
+    const page = pageMap2.get(item.id);
+    return {
+      pageId: item.id,
+      path: page?.path ?? "",
+      title: item.label,
+      kind: page?.kind ?? "",
+      status: page?.status ?? "",
+      score: cosineSimilarity(queryVector, vectors.get(`page:${item.id}`) ?? [])
+    };
+  }).filter((result) => result.score >= 0.25 && result.path).sort((left, right) => right.score - left.score).slice(0, limit);
+}
 function distinctScope(left, right) {
   const leftSources = new Set(left.sourceIds);
   const rightSources = new Set(right.sourceIds);
@@ -14469,7 +15266,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);
 }
@@ -14724,7 +15521,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) {
@@ -14874,7 +15671,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) {
@@ -14951,7 +15748,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 = []) {
@@ -15035,7 +15832,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`,
@@ -15547,7 +16344,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) {
@@ -15631,11 +16428,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",
       "",
@@ -15666,7 +16463,7 @@ function buildProjectsIndex(projectPages, schemaHash, metadata) {
 }
 function buildProjectIndex(input) {
   const title = `Project: ${input.projectId}`;
-  return matter5.stringify(
+  return matter6.stringify(
     [
       `# ${title}`,
       "",
@@ -15783,7 +16580,7 @@ function buildOutputPage(input) {
       outputFormat: input.outputFormat,
       outputAssets
     },
-    content: matter5.stringify(
+    content: matter6.stringify(
       (input.outputFormat === "slides" ? [
         input.answer,
         "",
@@ -15911,7 +16708,7 @@ function buildExploreHubPage(input) {
       outputFormat: input.outputFormat,
       outputAssets
     },
-    content: matter5.stringify(
+    content: matter6.stringify(
       (input.outputFormat === "slides" ? [
         `# ${title}`,
         "",
@@ -16177,12 +16974,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") : [];
 }
@@ -16263,7 +17060,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"),
@@ -16297,7 +17094,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;
@@ -16352,7 +17149,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);
@@ -16453,7 +17250,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}`;
@@ -16507,7 +17304,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);
 }
@@ -16595,7 +17392,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) {
@@ -16633,6 +17430,38 @@ ${excerpt.trim()}`.trim();
   db.exec("INSERT INTO page_search (rowid, title, body) SELECT rowid, title, body FROM pages;");
   db.close();
 }
+function mergeSearchResults(ftsResults, semanticHits, limit) {
+  const k = 60;
+  const scores = /* @__PURE__ */ new Map();
+  const resultMap = /* @__PURE__ */ new Map();
+  for (let i = 0; i < ftsResults.length; i++) {
+    const r = ftsResults[i];
+    scores.set(r.pageId, (scores.get(r.pageId) ?? 0) + 1 / (k + i + 1));
+    resultMap.set(r.pageId, r);
+  }
+  for (let i = 0; i < semanticHits.length; i++) {
+    const hit = semanticHits[i];
+    scores.set(hit.pageId, (scores.get(hit.pageId) ?? 0) + 1 / (k + i + 1));
+    if (!resultMap.has(hit.pageId)) {
+      resultMap.set(hit.pageId, {
+        pageId: hit.pageId,
+        path: hit.path,
+        title: hit.title,
+        snippet: "",
+        rank: -hit.score,
+        kind: hit.kind,
+        status: hit.status,
+        projectIds: [],
+        sourceType: void 0,
+        sourceClass: void 0
+      });
+    }
+  }
+  return [...scores.entries()].sort(([, a], [, b]) => b - a).slice(0, limit).map(([pageId, rrfScore]) => {
+    const result = resultMap.get(pageId);
+    return { ...result, rank: -rrfScore };
+  });
+}
 function searchPages(dbPath, query, limitOrOptions = 5) {
   const options = typeof limitOrOptions === "number" ? { limit: limitOrOptions } : limitOrOptions;
   const ftsQuery = toFtsQuery(query);
@@ -16974,7 +17803,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-MYJX6AEE.js");
+  const { createProvider: createProvider2 } = await import("./registry-SYCRRA65.js");
   return createProvider2(preferredProviderId, providerConfig, rootDir);
 }
 async function generateOutputArtifacts(rootDir, input) {
@@ -17493,7 +18322,7 @@ async function buildDashboardRecords(config, paths, graph, schemaHash, report) {
     {
       relativePath: "dashboards/index.md",
       title: "Dashboards",
-      content: (metadata) => matter9.stringify(
+      content: (metadata) => matter10.stringify(
         [
           "# Dashboards",
           "",
@@ -17545,7 +18374,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",
           "",
@@ -17588,7 +18417,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",
           "",
@@ -17648,7 +18477,7 @@ async function buildDashboardRecords(config, paths, graph, schemaHash, report) {
     {
       relativePath: "dashboards/timeline.md",
       title: "Timeline",
-      content: (metadata) => matter9.stringify(
+      content: (metadata) => matter10.stringify(
         [
           "# Timeline",
           "",
@@ -17694,7 +18523,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",
           "",
@@ -17751,7 +18580,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",
           "",
@@ -17804,7 +18633,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",
           "",
@@ -17868,7 +18697,7 @@ async function buildDashboardRecords(config, paths, graph, schemaHash, report) {
     {
       relativePath: "dashboards/contradictions.md",
       title: "Contradictions",
-      content: (metadata) => matter9.stringify(
+      content: (metadata) => matter10.stringify(
         [
           "# Contradictions",
           "",
@@ -17927,7 +18756,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",
           "",
@@ -18003,7 +18832,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)) {
@@ -18040,7 +18874,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) {
@@ -18186,7 +19021,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]));
@@ -18546,7 +19381,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,
@@ -19013,7 +19848,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}`;
@@ -19035,7 +19872,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,
@@ -19606,7 +20445,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 {
@@ -19819,8 +20658,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 ?? [];
@@ -20021,9 +20860,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,
@@ -20174,7 +21013,7 @@ async function initVault(rootDir, options = {}) {
   const now = (/* @__PURE__ */ new Date()).toISOString();
   await writeFileIfChanged(
     insightsIndexPath,
-    matter9.stringify(
+    matter10.stringify(
       (isResearchProfile ? [
         "# Insights",
         "",
@@ -20221,7 +21060,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",
@@ -20244,7 +21083,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",
@@ -20271,7 +21110,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"}`,
           "",
@@ -20553,6 +21392,45 @@ async function compileVault(rootDir, options = {}) {
       `benchmark=${benchmark.ok ? "ok" : `error:${benchmark.error}`}`
     ]
   });
+  let tokenStats;
+  if (options.maxTokens && options.maxTokens > 0) {
+    const { estimatePageTokens: estimatePageTokens2, trimToTokenBudget: trimToTokenBudget2 } = await import("./token-estimation-TTONKT4O.js");
+    const nodeDegreeLookup = /* @__PURE__ */ new Map();
+    const graph = await readJsonFile(paths.graphPath);
+    if (graph) {
+      for (const node of graph.nodes) {
+        if (node.pageId && node.degree) {
+          const existing = nodeDegreeLookup.get(node.pageId) ?? 0;
+          nodeDegreeLookup.set(node.pageId, Math.max(existing, node.degree));
+        }
+      }
+    }
+    const estimates = await Promise.all(
+      sync.allPages.map(async (page) => {
+        const fullPath = path23.join(paths.wikiDir, page.path);
+        let content = "";
+        try {
+          content = await fs19.readFile(fullPath, "utf8");
+        } catch {
+        }
+        return estimatePageTokens2(page.id, page.path, page.kind, content, nodeDegreeLookup.get(page.id), page.confidence);
+      })
+    );
+    const budgetResult = trimToTokenBudget2(estimates, options.maxTokens);
+    for (const dropped of budgetResult.dropped) {
+      const fullPath = path23.join(paths.wikiDir, dropped.path);
+      try {
+        await fs19.unlink(fullPath);
+      } catch {
+      }
+    }
+    tokenStats = {
+      estimatedTokens: budgetResult.totalTokens,
+      maxTokens: options.maxTokens,
+      pagesKept: budgetResult.kept.length,
+      pagesDropped: budgetResult.dropped.length
+    };
+  }
   return {
     graphPath: paths.graphPath,
     pageCount: sync.allPages.length,
@@ -20564,7 +21442,8 @@ async function compileVault(rootDir, options = {}) {
     postPassApprovalId,
     postPassApprovalDir,
     promotedPageIds: sync.promotedPageIds,
-    candidatePageCount: sync.candidatePageCount
+    candidatePageCount: sync.candidatePageCount,
+    tokenStats
   };
 }
 async function queryVault(rootDir, options) {
@@ -20921,11 +21800,59 @@ ${orchestrationNotes.join("\n")}
   };
 }
 async function searchVault(rootDir, query, limit = 5) {
-  const { paths } = await loadVaultConfig(rootDir);
+  const { paths, config } = await loadVaultConfig(rootDir);
   if (!await fileExists(paths.searchDbPath)) {
     await compileVault(rootDir, {});
   }
-  return searchPages(paths.searchDbPath, query, limit);
+  const hybrid = config.search?.hybrid !== false;
+  const ftsResults = searchPages(paths.searchDbPath, query, hybrid ? limit * 3 : limit);
+  if (!hybrid || !await fileExists(paths.graphPath)) {
+    return ftsResults.slice(0, limit);
+  }
+  const graph = await readJsonFile(paths.graphPath);
+  if (!graph) {
+    return ftsResults.slice(0, limit);
+  }
+  const semanticHits = await semanticPageSearch(rootDir, graph, query, limit * 3).catch(() => []);
+  if (!semanticHits.length) {
+    return ftsResults.slice(0, limit);
+  }
+  const merged = mergeSearchResults(ftsResults, semanticHits, limit);
+  if (config.search?.rerank && merged.length > 1) {
+    return rerankSearchResults(rootDir, query, merged, limit);
+  }
+  return merged;
+}
+async function rerankSearchResults(rootDir, query, results, limit) {
+  const provider = await getProviderForTask(rootDir, "queryProvider");
+  const candidates = results.slice(0, Math.min(results.length, 20)).map((r, i) => `[${i}] ${r.title} \u2014 ${r.snippet || r.path}`).join("\n");
+  const prompt = `Given the search query: "${query}"
+Rank these results by relevance (most relevant first).
+${candidates}`;
+  try {
+    const indices = await provider.generateStructured(
+      { prompt, system: "You are a search result ranker." },
+      z7.array(z7.number().int().nonnegative())
+    );
+    const reranked = [];
+    const seen = /* @__PURE__ */ new Set();
+    for (const idx of indices) {
+      if (idx >= 0 && idx < results.length && !seen.has(idx)) {
+        seen.add(idx);
+        reranked.push(results[idx]);
+      }
+    }
+    for (let i = 0; i < results.length && reranked.length < limit; i++) {
+      if (!seen.has(i)) {
+        reranked.push(results[i]);
+      }
+    }
+    return reranked.slice(0, limit);
+  } catch {
+    return results.slice(0, limit);
+  }
 }
 async function ensureCompiledGraph(rootDir) {
   const { paths } = await loadVaultConfig(rootDir);
@@ -20968,7 +21895,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);
@@ -21029,6 +21956,10 @@ async function listGodNodes(rootDir, limit = 10) {
   const graph = await ensureCompiledGraph(rootDir);
   return topGodNodes(graph, limit);
 }
+async function blastRadiusVault(rootDir, target, options) {
+  const graph = await ensureCompiledGraph(rootDir);
+  return blastRadius(graph, target, options);
+}
 async function listPages(rootDir) {
   const { paths } = await loadVaultConfig(rootDir);
   const graph = await readJsonFile(paths.graphPath);
@@ -21048,7 +21979,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)),
@@ -21263,7 +22194,7 @@ async function bootstrapDemo(rootDir, input) {
 }
 // src/mcp.ts
-var SERVER_VERSION = "0.7.24";
+var SERVER_VERSION = "0.7.26";
 async function createMcpServer(rootDir) {
   const server = new McpServer({
     name: "swarmvault",
@@ -21413,6 +22344,19 @@ async function createMcpServer(rootDir) {
       return asToolText(await listGodNodes(rootDir, limit ?? 10));
     })
   );
+  server.registerTool(
+    "blast_radius",
+    {
+      description: "Analyze the impact of changing a file or module by tracing reverse import edges.",
+      inputSchema: {
+        target: z8.string().min(1).describe("File path, module label, or module id"),
+        maxDepth: z8.number().int().min(1).max(10).optional().describe("Maximum traversal depth (default 3)")
+      }
+    },
+    safeHandler(async ({ target, maxDepth }) => {
+      return asToolText(await blastRadiusVault(rootDir, target, { maxDepth: maxDepth ?? 3 }));
+    })
+  );
   server.registerTool(
     "query_vault",
     {
@@ -21450,11 +22394,12 @@ async function createMcpServer(rootDir) {
     {
       description: "Compile source manifests into wiki pages, graph data, and search index.",
       inputSchema: {
-        approve: z8.boolean().optional().describe("Stage a review bundle without applying active page changes")
+        approve: z8.boolean().optional().describe("Stage a review bundle without applying active page changes"),
+        maxTokens: z8.number().int().min(1e3).optional().describe("Maximum token budget for wiki output")
       }
     },
-    safeHandler(async ({ approve }) => {
-      const result = await compileVault(rootDir, { approve: approve ?? false });
+    safeHandler(async ({ approve, maxTokens }) => {
+      const result = await compileVault(rootDir, { approve: approve ?? false, maxTokens });
       return asToolText(result);
     })
   );
@@ -21934,7 +22879,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;
@@ -23277,7 +24222,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") : [];
@@ -23338,7 +24283,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(
@@ -23719,12 +24664,12 @@ async function deleteManagedSource(rootDir, id) {
 }
 // src/viewer.ts
-import { execFile } from "child_process";
+import { execFile as execFile2 } from "child_process";
 import fs23 from "fs/promises";
 import http from "http";
 import path28 from "path";
-import { promisify } from "util";
-import matter11 from "gray-matter";
+import { promisify as promisify2 } from "util";
+import matter12 from "gray-matter";
 import mime2 from "mime-types";
 // src/graph-presentation.ts
@@ -24337,7 +25282,7 @@ async function getWatchStatus(rootDir) {
 }
 // src/viewer.ts
-var execFileAsync = promisify(execFile);
+var execFileAsync2 = promisify2(execFile2);
 async function isReadableFile(absolutePath) {
   try {
     const stats = await fs23.stat(absolutePath);
@@ -24356,7 +25301,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)),
@@ -24404,7 +25349,7 @@ async function ensureViewerDist(viewerDistDir) {
   }
   const viewerProjectDir = path28.dirname(viewerDistDir);
   if (await fileExists(path28.join(viewerProjectDir, "package.json"))) {
-    await execFileAsync("pnpm", ["build"], { cwd: viewerProjectDir });
+    await execFileAsync2("pnpm", ["build"], { cwd: viewerProjectDir });
   }
 }
 async function startGraphServer(rootDir, port, options = {}) {
@@ -24584,6 +25529,44 @@ async function startGraphServer(rootDir, port, options = {}) {
         response.end(JSON.stringify(result));
         return;
       }
+      if (url.pathname === "/api/clip" && request.method === "POST") {
+        const body = await readJsonBody(request);
+        const clipUrl = typeof body.url === "string" ? body.url.trim() : "";
+        if (!clipUrl) {
+          response.writeHead(400, { "content-type": "application/json" });
+          response.end(JSON.stringify({ error: "Missing url field." }));
+          return;
+        }
+        const manifest = await ingestInput(rootDir, clipUrl);
+        response.writeHead(200, { "content-type": "application/json", "access-control-allow-origin": "*" });
+        response.end(JSON.stringify({ ok: true, sourceId: manifest.sourceId, title: manifest.title }));
+        return;
+      }
+      if (url.pathname === "/api/clip" && request.method === "OPTIONS") {
+        response.writeHead(204, {
+          "access-control-allow-origin": "*",
+          "access-control-allow-methods": "POST, OPTIONS",
+          "access-control-allow-headers": "content-type"
+        });
+        response.end();
+        return;
+      }
+      if (url.pathname === "/api/bookmarklet") {
+        const script = `javascript:void(fetch('http://localhost:${effectivePort}/api/clip',{method:'POST',headers:{'Content-Type':'application/json'},body:JSON.stringify({url:location.href})}).then(r=>r.json()).then(d=>alert('Clipped: '+(d.title||d.sourceId))).catch(e=>alert('Clip failed: '+e.message)))`;
+        response.writeHead(200, { "content-type": "text/html" });
+        response.end(
+          [
+            "<!doctype html><html><head><title>SwarmVault Clipper</title></head><body>",
+            "<h1>SwarmVault Clipper</h1>",
+            `<p>Drag this link to your bookmarks bar:</p>`,
+            `<p style="font-size:1.5em"><a href="${script.replace(/&/g, "&amp;").replace(/"/g, "&quot;")}">Clip to SwarmVault</a></p>`,
+            `<p>When clicked on any page, it sends the URL to your running SwarmVault instance for ingestion.</p>`,
+            `<p>Server: <code>http://localhost:${effectivePort}</code></p>`,
+            "</body></html>"
+          ].join("\n")
+        );
+        return;
+      }
       const relativePath = url.pathname === "/" ? "index.html" : url.pathname.slice(1);
       const target = path28.join(paths.viewerDistDir, relativePath);
       const fallback = path28.join(paths.viewerDistDir, "index.html");
@@ -24702,7 +25685,10 @@ export {
   addManagedSource,
   archiveCandidate,
   assertProviderCapability,
+  autoCommitWikiChanges,
   benchmarkVault,
+  blastRadius,
+  blastRadiusVault,
   bootstrapDemo,
   compileVault,
   createMcpServer,
@@ -24711,10 +25697,13 @@ export {
   defaultVaultConfig,
   defaultVaultSchema,
   deleteManagedSource,
+  estimatePageTokens,
+  estimateTokens,
   explainGraphVault,
   exploreVault,
   exportGraphFormat,
   exportGraphHtml,
+  exportGraphReportHtml,
   exportObsidianCanvas,
   exportObsidianVault,
   getGitHookStatus,
@@ -24771,6 +25760,7 @@ export {
   startMcpServer,
   syncTrackedRepos,
   syncTrackedReposForWatch,
+  trimToTokenBudget,
   uninstallGitHooks,
   watchVault
 };