@swarmvaultai/engine 1.0.1 → 1.2.0

package/dist/index.js

@@ -1,4 +1,5 @@
 import {
+  LocalWhisperProviderAdapter,
   PRIMARY_SCHEMA_FILENAME,
   appendJsonLine,
   assertProviderCapability,
@@ -23,7 +24,7 @@ import {
   uniqueBy,
   writeFileIfChanged,
   writeJsonFile
-} from "./chunk-4MSSM2GH.js";
+} from "./chunk-UQCF65BN.js";
 import {
   estimatePageTokens,
   estimateTokens,
@@ -7072,6 +7073,202 @@ function enrichGraph(graph, manifests, analyses, extraSimilarityEdges = [], opti
   };
 }
 
+// src/graph-share.ts
+function displayVaultName(value) {
+  const trimmed = value?.trim();
+  return trimmed ? trimmed : "this vault";
+}
+function sortedFallbackHubs(graph) {
+  return graph.nodes.filter((node) => node.type !== "source").sort(
+    (left, right) => (right.degree ?? 0) - (left.degree ?? 0) || (right.bridgeScore ?? 0) - (left.bridgeScore ?? 0) || left.label.localeCompare(right.label)
+  ).slice(0, 5);
+}
+function graphNodeMap(graph) {
+  return new Map(graph.nodes.map((node) => [node.id, node]));
+}
+function compactJoin(values, fallback) {
+  const filtered = values.filter(Boolean);
+  if (!filtered.length) {
+    return fallback;
+  }
+  if (filtered.length === 1) {
+    return filtered[0] ?? fallback;
+  }
+  if (filtered.length === 2) {
+    return `${filtered[0]} and ${filtered[1]}`;
+  }
+  return `${filtered.slice(0, -1).join(", ")}, and ${filtered[filtered.length - 1]}`;
+}
+function buildShortPost(input) {
+  const topHubLine = input.topHubs.length ? `Top hubs: ${compactJoin(
+    input.topHubs.slice(0, 3).map((node) => node.label),
+    "still emerging"
+  )}.` : "Top hubs are still emerging.";
+  const surprise = input.surprisingConnections[0];
+  const surpriseLine = surprise ? `Most surprising link: ${surprise.sourceLabel} ${surprise.relation} ${surprise.targetLabel}.` : "The graph is ready for its first surprising connection.";
+  return [
+    `I scanned ${input.vaultName} with SwarmVault: ${input.overview.sources} sources -> ${input.overview.pages} wiki pages, ${input.overview.nodes} graph nodes, ${input.overview.edges} edges.`,
+    topHubLine,
+    surpriseLine,
+    "Everything stays local. Try: npm install -g @swarmvaultai/cli && swarmvault scan ./your-repo"
+  ].join("\n");
+}
+function buildGraphShareArtifact(input) {
+  const { graph, report } = input;
+  const vaultName = displayVaultName(input.vaultName);
+  const nodesById = graphNodeMap(graph);
+  const fallbackHubs = sortedFallbackHubs(graph);
+  const reportHubs = report?.godNodes.map((node) => {
+    const graphNode = nodesById.get(node.nodeId);
+    return {
+      nodeId: node.nodeId,
+      label: node.label ?? graphNode?.label ?? node.nodeId,
+      degree: node.degree ?? graphNode?.degree
+    };
+  }) ?? [];
+  const fallbackHubHighlights = fallbackHubs.map((node) => ({
+    nodeId: node.id,
+    label: node.label,
+    degree: node.degree
+  }));
+  const topHubs = (reportHubs.length ? reportHubs : fallbackHubHighlights).slice(0, 5);
+  const reportBridgeNodes = report?.bridgeNodes.map((node) => {
+    const graphNode = nodesById.get(node.nodeId);
+    return {
+      nodeId: node.nodeId,
+      label: node.label ?? graphNode?.label ?? node.nodeId,
+      bridgeScore: node.bridgeScore ?? graphNode?.bridgeScore
+    };
+  }) ?? [];
+  const fallbackBridgeNodes = fallbackHubs.map((node) => ({
+    nodeId: node.id,
+    label: node.label,
+    bridgeScore: node.bridgeScore
+  }));
+  const bridgeNodes = (reportBridgeNodes.length ? reportBridgeNodes : fallbackBridgeNodes).slice(0, 3).filter((node) => node.label);
+  const surprisingConnections = (report?.surprisingConnections ?? []).slice(0, 3).map((connection) => {
+    const source = nodesById.get(connection.sourceNodeId);
+    const target = nodesById.get(connection.targetNodeId);
+    return {
+      sourceLabel: source?.label ?? connection.sourceNodeId,
+      targetLabel: target?.label ?? connection.targetNodeId,
+      relation: connection.relation,
+      why: truncate(connection.why || connection.explanation || "Cross-community connection", 180)
+    };
+  });
+  const overview = {
+    sources: graph.sources.length,
+    nodes: report?.overview.nodes ?? graph.nodes.length,
+    edges: report?.overview.edges ?? graph.edges.length,
+    pages: report?.overview.pages ?? graph.pages.length,
+    communities: report?.overview.communities ?? graph.communities?.length ?? 0
+  };
+  const firstPartyOverview = report?.firstPartyOverview ?? {
+    nodes: graph.nodes.filter((node) => node.sourceClass === "first_party").length,
+    edges: graph.edges.length,
+    pages: graph.pages.filter((page) => page.sourceClass === "first_party").length,
+    communities: graph.communities?.length ?? 0
+  };
+  const relatedNodeIds = uniqueBy([...topHubs.map((node) => node.nodeId), ...bridgeNodes.map((node) => node.nodeId)], (value) => value);
+  const relatedPageIds = uniqueBy(
+    relatedNodeIds.map((nodeId) => nodesById.get(nodeId)?.pageId).filter((pageId) => Boolean(pageId)),
+    (value) => value
+  );
+  const relatedSourceIds = uniqueBy(
+    [...graph.sources.map((source) => source.sourceId), ...relatedNodeIds.flatMap((nodeId) => nodesById.get(nodeId)?.sourceIds ?? [])],
+    (value) => value
+  );
+  const knowledgeGaps = report?.knowledgeGaps?.warnings?.length ? report.knowledgeGaps.warnings.slice(0, 3) : report?.warnings?.length ? report.warnings.slice(0, 3) : [];
+  const tagline = `A local-first map of ${vaultName}: ${overview.sources} sources compiled into ${overview.nodes} graph nodes and ${overview.pages} wiki pages.`;
+  const artifact = {
+    generatedAt: (/* @__PURE__ */ new Date()).toISOString(),
+    vaultName,
+    tagline,
+    overview,
+    firstPartyOverview,
+    highlights: {
+      topHubs,
+      bridgeNodes,
+      surprisingConnections,
+      suggestedQuestions: (report?.suggestedQuestions ?? []).slice(0, 5)
+    },
+    knowledgeGaps,
+    shortPost: "",
+    relatedNodeIds,
+    relatedPageIds,
+    relatedSourceIds
+  };
+  return {
+    ...artifact,
+    shortPost: buildShortPost({
+      vaultName,
+      overview,
+      topHubs,
+      surprisingConnections
+    })
+  };
+}
+function renderGraphShareMarkdown(artifact) {
+  const lines = [
+    "# SwarmVault Share Card",
+    "",
+    `> ${artifact.tagline}`,
+    "",
+    "## Snapshot",
+    "",
+    `- Sources: ${artifact.overview.sources}`,
+    `- Wiki pages: ${artifact.overview.pages}`,
+    `- Graph nodes: ${artifact.overview.nodes}`,
+    `- Graph edges: ${artifact.overview.edges}`,
+    `- Communities: ${artifact.overview.communities}`,
+    `- First-party focus: ${artifact.firstPartyOverview.nodes} nodes, ${artifact.firstPartyOverview.edges} edges, ${artifact.firstPartyOverview.pages} pages`,
+    "",
+    "## Highlights",
+    "",
+    artifact.highlights.topHubs.length ? `- Top hubs: ${compactJoin(
+      artifact.highlights.topHubs.slice(0, 5).map((node) => node.degree ? `${node.label} (${node.degree})` : node.label),
+      "none yet"
+    )}` : "- Top hubs: none yet",
+    artifact.highlights.bridgeNodes.length ? `- Bridge nodes: ${compactJoin(
+      artifact.highlights.bridgeNodes.slice(0, 3).map((node) => node.label),
+      "none yet"
+    )}` : "- Bridge nodes: none yet",
+    ...artifact.highlights.surprisingConnections.length ? artifact.highlights.surprisingConnections.map(
+      (connection) => `- Surprising link: ${connection.sourceLabel} ${connection.relation} ${connection.targetLabel}. ${connection.why}`
+    ) : ["- Surprising link: not enough cross-community evidence yet"],
+    "",
+    "## Ask Next",
+    "",
+    ...artifact.highlights.suggestedQuestions.length ? artifact.highlights.suggestedQuestions.map((question) => `- ${question}`) : ["- Add more sources, run `swarmvault compile`, then ask the graph what changed."],
+    "",
+    "## Share Post",
+    "",
+    "```text",
+    artifact.shortPost,
+    "```",
+    "",
+    "## Reproduce",
+    "",
+    "```bash",
+    "npm install -g @swarmvaultai/cli",
+    "swarmvault scan ./your-repo",
+    "swarmvault graph share --post",
+    "```",
+    ""
+  ];
+  if (artifact.knowledgeGaps.length) {
+    lines.splice(
+      lines.indexOf("## Ask Next"),
+      0,
+      "## Gaps To Strengthen",
+      "",
+      ...artifact.knowledgeGaps.map((warning) => `- ${warning}`),
+      ""
+    );
+  }
+  return `${lines.join("\n")}`;
+}
+
 // src/graph-query-core.ts
 var NODE_TYPE_PRIORITY = {
   concept: 6,
@@ -8379,15 +8576,15 @@ function sourceTypeForNode(node, pagesById) {
   return pagesById.get(node.pageId)?.sourceType;
 }
 function supportingPathDetails(graph, edge) {
-  const path32 = shortestGraphPath(graph, edge.source, edge.target);
+  const path33 = shortestGraphPath(graph, edge.source, edge.target);
   const edgesById = new Map(graph.edges.map((item) => [item.id, item]));
-  const pathEdges = path32.edgeIds.map((edgeId) => edgesById.get(edgeId)).filter((item) => Boolean(item));
+  const pathEdges = path33.edgeIds.map((edgeId) => edgesById.get(edgeId)).filter((item) => Boolean(item));
   return {
-    pathNodeIds: path32.nodeIds,
-    pathEdgeIds: path32.edgeIds,
+    pathNodeIds: path33.nodeIds,
+    pathEdgeIds: path33.edgeIds,
     pathRelations: pathEdges.map((item) => item.relation),
     pathEvidenceClasses: pathEdges.map((item) => item.evidenceClass),
-    pathSummary: path32.summary
+    pathSummary: path33.summary
   };
 }
 function surpriseScore(edge, graph, pagesById, hyperedgesByNodeId) {
@@ -8456,7 +8653,7 @@ function topSurprisingConnections(graph, pagesById) {
     }).map((edge) => {
       const source = nodesById.get(edge.source);
       const target = nodesById.get(edge.target);
-      const path32 = supportingPathDetails(graph, edge);
+      const path33 = supportingPathDetails(graph, edge);
       const scored = surpriseScore(edge, graph, pagesById, hyperedgesByNodeId);
       return {
         id: edge.id,
@@ -8467,11 +8664,11 @@ function topSurprisingConnections(graph, pagesById) {
         relation: edge.relation,
         evidenceClass: edge.evidenceClass,
         confidence: edge.confidence,
-        pathNodeIds: path32.pathNodeIds,
-        pathEdgeIds: path32.pathEdgeIds,
-        pathRelations: path32.pathRelations,
-        pathEvidenceClasses: path32.pathEvidenceClasses,
-        pathSummary: path32.pathSummary,
+        pathNodeIds: path33.pathNodeIds,
+        pathEdgeIds: path33.pathEdgeIds,
+        pathRelations: path33.pathRelations,
+        pathEvidenceClasses: path33.pathEvidenceClasses,
+        pathSummary: path33.pathSummary,
         why: scored.why,
         explanation: scored.explanation,
         surpriseScore: scored.score
@@ -8906,6 +9103,65 @@ function buildGraphReportPage(input) {
     content: matter2.stringify(body, frontmatter)
   };
 }
+function buildGraphSharePage(input) {
+  const pageId = "graph:share-card";
+  const pathValue = "graph/share-card.md";
+  const artifact = buildGraphShareArtifact({
+    graph: input.graph,
+    report: input.report,
+    vaultName: input.vaultName
+  });
+  const frontmatter = {
+    page_id: pageId,
+    kind: "graph_report",
+    cssclasses: cssclassesFor("graph_report"),
+    title: "Share Card",
+    tags: ["graph", "share"],
+    source_ids: artifact.relatedSourceIds,
+    project_ids: [],
+    node_ids: artifact.relatedNodeIds,
+    freshness: "fresh",
+    status: input.metadata.status,
+    confidence: input.metadata.confidence,
+    created_at: input.metadata.createdAt,
+    updated_at: input.metadata.updatedAt,
+    compiled_from: input.metadata.compiledFrom,
+    managed_by: input.metadata.managedBy,
+    backlinks: [],
+    schema_hash: input.schemaHash,
+    source_hashes: {},
+    source_semantic_hashes: {},
+    related_page_ids: artifact.relatedPageIds,
+    related_node_ids: artifact.relatedNodeIds,
+    related_source_ids: artifact.relatedSourceIds
+  };
+  return {
+    page: {
+      id: pageId,
+      path: pathValue,
+      title: "Share Card",
+      kind: "graph_report",
+      sourceIds: artifact.relatedSourceIds,
+      projectIds: [],
+      nodeIds: artifact.relatedNodeIds,
+      freshness: "fresh",
+      status: input.metadata.status,
+      confidence: input.metadata.confidence,
+      backlinks: [],
+      schemaHash: input.schemaHash,
+      sourceHashes: {},
+      sourceSemanticHashes: {},
+      relatedPageIds: artifact.relatedPageIds,
+      relatedNodeIds: artifact.relatedNodeIds,
+      relatedSourceIds: artifact.relatedSourceIds,
+      createdAt: input.metadata.createdAt,
+      updatedAt: input.metadata.updatedAt,
+      compiledFrom: input.metadata.compiledFrom,
+      managedBy: input.metadata.managedBy
+    },
+    content: matter2.stringify(renderGraphShareMarkdown(artifact), frontmatter)
+  };
+}
 function buildCommunitySummaryPage(input) {
   const pageId = `graph:${input.community.id}`;
   const pathValue = communityPagePath(input.community.id);
@@ -18310,7 +18566,8 @@ function isSupportedInboxKind(sourceKind) {
     "chat_export",
     "email",
     "calendar",
-    "image"
+    "image",
+    "audio"
   ].includes(sourceKind);
 }
 async function ingestInputDetailed(rootDir, input, options) {
@@ -20897,7 +21154,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-QAG2ZYH3.js");
+  const { createProvider: createProvider2 } = await import("./registry-GH4O3A7H.js");
   return createProvider2(preferredProviderId, providerConfig, rootDir);
 }
 async function generateOutputArtifacts(rootDir, input) {
@@ -22639,8 +22896,23 @@ async function buildGraphOrientationPages(graph, paths, schemaHash, previousComp
       report
     })
   );
+  const shareRecord = await buildManagedGraphPage(
+    path26.join(paths.wikiDir, "graph", "share-card.md"),
+    {
+      managedBy: "system",
+      compiledFrom: uniqueStrings4(graph.pages.flatMap((page) => page.sourceIds)),
+      confidence: 1
+    },
+    (metadata) => buildGraphSharePage({
+      graph,
+      schemaHash,
+      metadata,
+      report,
+      vaultName: path26.basename(paths.rootDir)
+    })
+  );
   return {
-    records: [reportRecord, ...communityRecords],
+    records: [reportRecord, shareRecord, ...communityRecords],
     report
   };
 }
@@ -26613,7 +26885,7 @@ async function getWatchStatus(rootDir) {
 }
 
 // src/mcp.ts
-var SERVER_VERSION = "1.0.1";
+var SERVER_VERSION = "1.2.0";
 async function createMcpServer(rootDir) {
   const server = new McpServer({
     name: "swarmvault",
@@ -27149,6 +27421,155 @@ function asTextResource(uri, text) {
   };
 }
 
+// src/providers/local-whisper-setup.ts
+import { createWriteStream, constants as fsConstants } from "fs";
+import fs25 from "fs/promises";
+import os3 from "os";
+import path29 from "path";
+import { Readable as Readable2 } from "stream";
+import { pipeline } from "stream/promises";
+var BINARY_CANDIDATES = ["whisper-cli", "whisper-cpp", "whisper"];
+var HUGGINGFACE_BASE = "https://huggingface.co/ggerganov/whisper.cpp/resolve/main";
+var LOCAL_WHISPER_MODEL_SIZES = Object.freeze({
+  "tiny.en": "78 MB",
+  tiny: "78 MB",
+  "base.en": "147 MB",
+  base: "147 MB",
+  "small.en": "488 MB",
+  small: "488 MB",
+  "medium.en": "1.5 GB",
+  medium: "1.5 GB",
+  "large-v3": "3.1 GB",
+  "large-v3-turbo": "1.6 GB"
+});
+async function discoverLocalWhisperBinary(options = {}) {
+  const env = options.env ?? process.env;
+  if (env.SWARMVAULT_WHISPER_BINARY) {
+    return {
+      binaryPath: env.SWARMVAULT_WHISPER_BINARY,
+      candidates: [env.SWARMVAULT_WHISPER_BINARY],
+      source: "env"
+    };
+  }
+  const pathValue = env.PATH ?? "";
+  const candidates = [];
+  for (const dir of pathValue.split(path29.delimiter)) {
+    if (!dir) continue;
+    for (const name of BINARY_CANDIDATES) {
+      const full = path29.join(dir, name);
+      candidates.push(full);
+      if (await isExecutable(full)) {
+        return { binaryPath: full, candidates, source: "path" };
+      }
+    }
+  }
+  return { binaryPath: null, candidates, source: "not-found" };
+}
+function expectedModelPath(modelName, homeDir) {
+  const home = homeDir ?? os3.homedir();
+  return path29.join(home, ".swarmvault", "models", `ggml-${modelName}.bin`);
+}
+function modelDownloadUrl(modelName) {
+  return `${HUGGINGFACE_BASE}/ggml-${modelName}.bin`;
+}
+async function downloadWhisperModel(options) {
+  const destPath = expectedModelPath(options.modelName, options.homeDir);
+  await ensureDir(path29.dirname(destPath));
+  const doFetch = options.fetchImpl ?? fetch;
+  const url = modelDownloadUrl(options.modelName);
+  const response = await doFetch(url);
+  if (!response.ok) {
+    throw new Error(`Failed to download ${url}: ${response.status} ${response.statusText}`);
+  }
+  if (!response.body) {
+    throw new Error(`Response body missing for ${url}`);
+  }
+  const totalHeader = response.headers.get("content-length");
+  const totalBytes = totalHeader ? Number.parseInt(totalHeader, 10) : void 0;
+  let downloadedBytes = 0;
+  const webStream = response.body;
+  const source = Readable2.fromWeb(webStream);
+  source.on("data", (chunk) => {
+    downloadedBytes += chunk.length;
+    options.onProgress?.({ downloadedBytes, totalBytes });
+  });
+  const tmpPath = `${destPath}.part`;
+  await pipeline(source, createWriteStream(tmpPath));
+  await fs25.rename(tmpPath, destPath);
+  const stat = await fs25.stat(destPath);
+  return { path: destPath, bytes: stat.size };
+}
+async function registerLocalWhisperProvider(options) {
+  const { config, paths } = await loadVaultConfig(options.rootDir);
+  const providerId = options.providerId ?? "local-whisper";
+  const desired = buildProviderEntry(options);
+  const existing = config.providers[providerId];
+  const providerWasAdded = !existing;
+  const providerWasUpdated = !providerWasAdded && !providerEntryMatches(existing, desired);
+  const previousAudioProvider = config.tasks.audioProvider;
+  const shouldSetAudio = options.setAsAudioProvider !== false && (options.setAsAudioProvider === true || !previousAudioProvider);
+  const next = {
+    ...config,
+    providers: {
+      ...config.providers,
+      [providerId]: desired
+    },
+    tasks: {
+      ...config.tasks,
+      audioProvider: shouldSetAudio ? providerId : previousAudioProvider
+    }
+  };
+  await writeJsonFile(paths.configPath, next);
+  return {
+    providerId,
+    configPath: paths.configPath,
+    providerWasAdded,
+    providerWasUpdated,
+    audioProviderSet: shouldSetAudio && previousAudioProvider !== providerId,
+    previousAudioProvider
+  };
+}
+function buildProviderEntry(options) {
+  const entry = {
+    type: "local-whisper",
+    model: options.model
+  };
+  if (options.binaryPath) entry.binaryPath = options.binaryPath;
+  if (options.modelPath) entry.modelPath = options.modelPath;
+  if (options.threads !== void 0) entry.threads = options.threads;
+  return entry;
+}
+function providerEntryMatches(existing, desired) {
+  return existing.type === desired.type && existing.model === desired.model && existing.binaryPath === desired.binaryPath && existing.modelPath === desired.modelPath && existing.threads === desired.threads;
+}
+async function summarizeLocalWhisperSetup(options) {
+  const discovery = await discoverLocalWhisperBinary({ env: options.env });
+  const modelPath = expectedModelPath(options.modelName, options.homeDir);
+  return {
+    binary: {
+      found: discovery.binaryPath !== null,
+      path: discovery.binaryPath,
+      source: discovery.source,
+      installHint: 'Install whisper.cpp \u2014 macOS: "brew install whisper-cpp"; Debian/Ubuntu: "sudo apt install whisper.cpp" (or build from https://github.com/ggerganov/whisper.cpp).'
+    },
+    model: {
+      name: options.modelName,
+      expectedPath: modelPath,
+      exists: await fileExists(modelPath),
+      downloadUrl: modelDownloadUrl(options.modelName),
+      approximateSize: LOCAL_WHISPER_MODEL_SIZES[options.modelName]
+    }
+  };
+}
+async function isExecutable(p) {
+  try {
+    await fs25.access(p, fsConstants.X_OK);
+    return true;
+  } catch {
+    return false;
+  }
+}
+
 // src/providers/openai-compatible-capabilities.ts
 var OPENAI_COMPATIBLE_CAPABILITY_MATRIX = Object.freeze({
   openai: {
@@ -27212,13 +27633,13 @@ async function withCapabilityFallback(provider, capability, run, fallback) {
 }
 
 // src/schedule.ts
-import fs25 from "fs/promises";
-import path29 from "path";
+import fs26 from "fs/promises";
+import path30 from "path";
 function scheduleStatePath(schedulesDir, jobId) {
-  return path29.join(schedulesDir, `${encodeURIComponent(jobId)}.json`);
+  return path30.join(schedulesDir, `${encodeURIComponent(jobId)}.json`);
 }
 function scheduleLockPath(schedulesDir, jobId) {
-  return path29.join(schedulesDir, `${encodeURIComponent(jobId)}.lock`);
+  return path30.join(schedulesDir, `${encodeURIComponent(jobId)}.lock`);
 }
 function parseEveryDuration(value) {
   const match = value.trim().match(/^(\d+)(m|h|d)$/i);
@@ -27321,13 +27742,13 @@ async function acquireJobLease(rootDir, jobId) {
   const { paths } = await loadVaultConfig(rootDir);
   const leasePath = scheduleLockPath(paths.schedulesDir, jobId);
   await ensureDir(paths.schedulesDir);
-  const handle = await fs25.open(leasePath, "wx");
+  const handle = await fs26.open(leasePath, "wx");
   await handle.writeFile(`${process.pid}
 ${(/* @__PURE__ */ new Date()).toISOString()}
 `);
   await handle.close();
   return async () => {
-    await fs25.rm(leasePath, { force: true });
+    await fs26.rm(leasePath, { force: true });
   };
 }
 async function listSchedules(rootDir) {
@@ -27486,8 +27907,8 @@ async function serveSchedules(rootDir, pollMs = 3e4) {
 
 // src/sources.ts
 import { spawn as spawn2 } from "child_process";
-import fs26 from "fs/promises";
-import path30 from "path";
+import fs27 from "fs/promises";
+import path31 from "path";
 import matter14 from "gray-matter";
 import { JSDOM as JSDOM3 } from "jsdom";
 var DEFAULT_CRAWL_MAX_PAGES = 12;
@@ -27533,24 +27954,24 @@ function emptyManagedSourceSyncCounts() {
   };
 }
 function withinRoot2(rootPath, targetPath) {
-  const relative = path30.relative(rootPath, targetPath);
-  return relative === "" || !relative.startsWith("..") && !path30.isAbsolute(relative);
+  const relative = path31.relative(rootPath, targetPath);
+  return relative === "" || !relative.startsWith("..") && !path31.isAbsolute(relative);
 }
 async function findNearestGitRoot3(startPath) {
-  let current = path30.resolve(startPath);
+  let current = path31.resolve(startPath);
   try {
-    const stat = await fs26.stat(current);
+    const stat = await fs27.stat(current);
     if (!stat.isDirectory()) {
-      current = path30.dirname(current);
+      current = path31.dirname(current);
     }
   } catch {
-    current = path30.dirname(current);
+    current = path31.dirname(current);
   }
   while (true) {
-    if (await fileExists(path30.join(current, ".git"))) {
+    if (await fileExists(path31.join(current, ".git"))) {
       return current;
     }
-    const parent = path30.dirname(current);
+    const parent = path31.dirname(current);
     if (parent === current) {
       return null;
     }
@@ -27624,7 +28045,7 @@ function isAllowedDocsCandidate(candidate, startUrl) {
   if (candidate.origin !== startUrl.origin) {
     return false;
   }
-  const extension = path30.extname(candidate.pathname).toLowerCase();
+  const extension = path31.extname(candidate.pathname).toLowerCase();
   if (extension && extension !== ".html" && extension !== ".htm" && extension !== ".md") {
     return false;
   }
@@ -27713,14 +28134,14 @@ function matchesManagedSourceSpec(existing, input) {
     return false;
   }
   if (input.kind === "directory" || input.kind === "file") {
-    return path30.resolve(existing.path ?? "") === path30.resolve(input.path);
+    return path31.resolve(existing.path ?? "") === path31.resolve(input.path);
   }
   return (existing.url ?? "") === input.url;
 }
 async function resolveManagedSourceInput(rootDir, input) {
-  const absoluteInput = path30.resolve(rootDir, input);
+  const absoluteInput = path31.resolve(rootDir, input);
   if (!(input.startsWith("http://") || input.startsWith("https://"))) {
-    const stat = await fs26.stat(absoluteInput).catch(() => null);
+    const stat = await fs27.stat(absoluteInput).catch(() => null);
     if (!stat) {
       throw new Error(`Source not found: ${input}`);
     }
@@ -27728,7 +28149,7 @@ async function resolveManagedSourceInput(rootDir, input) {
       return {
         kind: "file",
         path: absoluteInput,
-        title: path30.basename(absoluteInput, path30.extname(absoluteInput)) || absoluteInput
+        title: path31.basename(absoluteInput, path31.extname(absoluteInput)) || absoluteInput
       };
     }
     if (!stat.isDirectory()) {
@@ -27740,7 +28161,7 @@ async function resolveManagedSourceInput(rootDir, input) {
       kind: "directory",
       path: absoluteInput,
       repoRoot,
-      title: path30.basename(absoluteInput) || absoluteInput
+      title: path31.basename(absoluteInput) || absoluteInput
     };
   }
   const github = normalizeGitHubRepoRootUrl(input);
@@ -27763,16 +28184,16 @@ async function resolveManagedSourceInput(rootDir, input) {
   };
 }
 function directorySourceIdsFor(manifests, inputPath) {
-  return manifests.filter((manifest) => manifest.originalPath && withinRoot2(path30.resolve(inputPath), path30.resolve(manifest.originalPath))).map((manifest) => manifest.sourceId).sort((left, right) => left.localeCompare(right));
+  return manifests.filter((manifest) => manifest.originalPath && withinRoot2(path31.resolve(inputPath), path31.resolve(manifest.originalPath))).map((manifest) => manifest.sourceId).sort((left, right) => left.localeCompare(right));
 }
 function fileSourceIdsFor(manifests, inputPath) {
-  const absoluteInput = path30.resolve(inputPath);
-  return manifests.filter((manifest) => manifest.originalPath && path30.resolve(manifest.originalPath) === absoluteInput).map((manifest) => manifest.sourceId).sort((left, right) => left.localeCompare(right));
+  const absoluteInput = path31.resolve(inputPath);
+  return manifests.filter((manifest) => manifest.originalPath && path31.resolve(manifest.originalPath) === absoluteInput).map((manifest) => manifest.sourceId).sort((left, right) => left.localeCompare(right));
 }
 async function syncDirectorySource(rootDir, inputPath, repoRoot) {
   const manifestsBefore = await listManifests(rootDir);
   const previousInScope = manifestsBefore.filter(
-    (manifest) => manifest.originalPath && withinRoot2(path30.resolve(inputPath), path30.resolve(manifest.originalPath))
+    (manifest) => manifest.originalPath && withinRoot2(path31.resolve(inputPath), path31.resolve(manifest.originalPath))
   );
   const result = await ingestDirectory(rootDir, inputPath, { repoRoot });
   const removed = [];
@@ -27780,7 +28201,7 @@ async function syncDirectorySource(rootDir, inputPath, repoRoot) {
     if (!manifest.originalPath) {
       continue;
     }
-    if (await fileExists(path30.resolve(manifest.originalPath))) {
+    if (await fileExists(path31.resolve(manifest.originalPath))) {
       continue;
     }
     const removedManifest = await removeManifestBySourceId(rootDir, manifest.sourceId);
@@ -27790,7 +28211,7 @@ async function syncDirectorySource(rootDir, inputPath, repoRoot) {
   }
   const manifestsAfter = await listManifests(rootDir);
   return {
-    title: path30.basename(inputPath) || inputPath,
+    title: path31.basename(inputPath) || inputPath,
     sourceIds: directorySourceIdsFor(manifestsAfter, inputPath),
     counts: {
       scannedCount: result.scannedCount,
@@ -27806,7 +28227,7 @@ async function syncFileSource(rootDir, inputPath) {
   const result = await ingestInputDetailed(rootDir, inputPath);
   const manifestsAfter = await listManifests(rootDir);
   return {
-    title: path30.basename(inputPath, path30.extname(inputPath)) || inputPath,
+    title: path31.basename(inputPath, path31.extname(inputPath)) || inputPath,
     sourceIds: fileSourceIdsFor(manifestsAfter, inputPath),
     counts: {
       scannedCount: result.scannedCount,
@@ -27840,8 +28261,8 @@ async function runGitCommand(cwd, args) {
 }
 async function syncGitHubRepoSource(rootDir, entry) {
   const workingDir = await managedSourceWorkingDir(rootDir, entry.id);
-  const checkoutDir = path30.join(workingDir, "checkout");
-  await fs26.rm(checkoutDir, { recursive: true, force: true });
+  const checkoutDir = path31.join(workingDir, "checkout");
+  await fs27.rm(checkoutDir, { recursive: true, force: true });
   await ensureDir(workingDir);
   if (!entry.url) {
     throw new Error(`Managed source ${entry.id} is missing its repository URL.`);
@@ -27971,7 +28392,7 @@ function scopedNodeIds(graph, sourceIds) {
 async function loadSourceAnalyses(rootDir, sourceIds) {
   const { paths } = await loadVaultConfig(rootDir);
   const analyses = await Promise.all(
-    sourceIds.map(async (sourceId) => await readJsonFile(path30.join(paths.analysesDir, `${sourceId}.json`)))
+    sourceIds.map(async (sourceId) => await readJsonFile(path31.join(paths.analysesDir, `${sourceId}.json`)))
   );
   return analyses.filter((analysis) => Boolean(analysis?.sourceId));
 }
@@ -28132,9 +28553,9 @@ async function writeSourceBriefForScope(rootDir, source) {
       confidence: 0.82
     }
   });
-  const absolutePath = path30.join(paths.wikiDir, output.page.path);
-  await ensureDir(path30.dirname(absolutePath));
-  await fs26.writeFile(absolutePath, output.content, "utf8");
+  const absolutePath = path31.join(paths.wikiDir, output.page.path);
+  await ensureDir(path31.dirname(absolutePath));
+  await fs27.writeFile(absolutePath, output.content, "utf8");
   return absolutePath;
 }
 async function writeSourceBrief(rootDir, source) {
@@ -28422,7 +28843,7 @@ function selectGuidedTargetPages(scope, sourcePages, questions) {
   return (matchedTargets.length ? matchedTargets : canonicalPages).slice(0, 6);
 }
 function insightRelativePathForTarget(page, scope) {
-  const basename = path30.basename(page.path);
+  const basename = path31.basename(page.path);
   if (page.kind === "concept") {
     return `insights/concepts/${basename}`;
   }
@@ -28649,7 +29070,7 @@ async function stageSourceReviewForScope(rootDir, scope) {
   return {
     sourceId: scope.id,
     pageId: output.page.id,
-    reviewPath: path30.join(approval.approvalDir, "wiki", output.page.path),
+    reviewPath: path31.join(approval.approvalDir, "wiki", output.page.path),
     staged: true,
     approvalId: approval.approvalId,
     approvalDir: approval.approvalDir
@@ -28716,7 +29137,7 @@ async function buildSourceSessionSavedPage(rootDir, scope, session) {
   const evidenceState = contradictions.length > 0 ? "conflicting" : session.targetedPagePaths.some(
     (targetPath) => sourcePages.some((page) => page.path === targetPath && page.sourceIds.some((sourceId) => !scope.sourceIds.includes(sourceId)))
   ) ? "reinforcing" : session.targetedPagePaths.length ? "new" : "needs_judgment";
-  const relativeBriefPath = session.briefPath && path30.isAbsolute(session.briefPath) ? path30.relative(paths.wikiDir, session.briefPath) : session.briefPath;
+  const relativeBriefPath = session.briefPath && path31.isAbsolute(session.briefPath) ? path31.relative(paths.wikiDir, session.briefPath) : session.briefPath;
   const sessionMarkdown = [
     `# Guided Session: ${scope.title}`,
     "",
@@ -28799,9 +29220,9 @@ async function buildSourceSessionSavedPage(rootDir, scope, session) {
 async function persistSourceSessionPage(rootDir, scope, session) {
   const { paths } = await loadVaultConfig(rootDir);
   const output = await buildSourceSessionSavedPage(rootDir, scope, session);
-  const absolutePath = path30.join(paths.wikiDir, output.page.path);
-  await ensureDir(path30.dirname(absolutePath));
-  await fs26.writeFile(absolutePath, output.content, "utf8");
+  const absolutePath = path31.join(paths.wikiDir, output.page.path);
+  await ensureDir(path31.dirname(absolutePath));
+  await fs27.writeFile(absolutePath, output.content, "utf8");
   return { pageId: output.page.id, sessionPath: absolutePath };
 }
 async function buildGuidedUpdatePages(rootDir, scope, session) {
@@ -28829,8 +29250,8 @@ async function buildGuidedUpdatePages(rootDir, scope, session) {
     targetPages.map(async (targetPage) => {
       const evidenceState = classifyGuidedEvidenceState(scope, targetPage, contradictions);
       const relativePath = useCanonicalTargets && targetPage ? targetPage.path : targetPage ? insightRelativePathForTarget(targetPage, scope) : `insights/topics/${slugify(scope.title)}.md`;
-      const absolutePath = path30.join(paths.wikiDir, relativePath);
-      const existingContent = await fileExists(absolutePath) ? await fs26.readFile(absolutePath, "utf8") : "";
+      const absolutePath = path31.join(paths.wikiDir, relativePath);
+      const existingContent = await fileExists(absolutePath) ? await fs27.readFile(absolutePath, "utf8") : "";
       const parsed = existingContent ? matter14(existingContent) : { data: {}, content: "" };
       const existingData = parsed.data;
       const existingSourceIds = Array.isArray(existingData.source_ids) ? existingData.source_ids.filter((value) => typeof value === "string") : [];
@@ -29001,8 +29422,8 @@ async function stageSourceGuideForScope(rootDir, scope, options = {}) {
     }
   );
   session.status = "staged";
-  session.reviewPath = path30.join(approval.approvalDir, "wiki", reviewOutput.page.path);
-  session.guidePath = path30.join(approval.approvalDir, "wiki", guideOutput.page.path);
+  session.reviewPath = path31.join(approval.approvalDir, "wiki", reviewOutput.page.path);
+  session.guidePath = path31.join(approval.approvalDir, "wiki", guideOutput.page.path);
   session.approvalId = approval.approvalId;
   session.approvalDir = approval.approvalDir;
   const persisted = await persistSourceSessionPage(rootDir, scope, session);
@@ -29140,7 +29561,7 @@ async function addManagedSource(rootDir, input, options = {}) {
   const existing = sources.find((candidate) => matchesManagedSourceSpec(candidate, resolved));
   const now = (/* @__PURE__ */ new Date()).toISOString();
   const source = existing ?? {
-    id: resolved.kind === "directory" || resolved.kind === "file" ? stableManagedSourceId(resolved.kind, path30.resolve(resolved.path), resolved.title) : stableManagedSourceId(resolved.kind, resolved.url, resolved.title),
+    id: resolved.kind === "directory" || resolved.kind === "file" ? stableManagedSourceId(resolved.kind, path31.resolve(resolved.path), resolved.title) : stableManagedSourceId(resolved.kind, resolved.url, resolved.title),
     kind: resolved.kind,
     title: resolved.title,
     path: resolved.kind === "directory" || resolved.kind === "file" ? resolved.path : void 0,
@@ -29268,7 +29689,7 @@ async function deleteManagedSource(rootDir, id) {
     sources.filter((source) => source.id !== id)
   );
   const workingDir = await managedSourceWorkingDir(rootDir, id);
-  await fs26.rm(workingDir, { recursive: true, force: true });
+  await fs27.rm(workingDir, { recursive: true, force: true });
   return { removed: target };
 }
 
@@ -29276,9 +29697,9 @@ async function deleteManagedSource(rootDir, id) {
 import { execFile as execFile2 } from "child_process";
 import { randomUUID } from "crypto";
 import { EventEmitter } from "events";
-import fs27 from "fs/promises";
+import fs28 from "fs/promises";
 import http from "http";
-import path31 from "path";
+import path32 from "path";
 import { promisify as promisify2 } from "util";
 import matter15 from "gray-matter";
 import mime2 from "mime-types";
@@ -29432,7 +29853,7 @@ function toViewerLintFindings(findings) {
 var execFileAsync2 = promisify2(execFile2);
 async function isReadableFile(absolutePath) {
   try {
-    const stats = await fs27.stat(absolutePath);
+    const stats = await fs28.stat(absolutePath);
     return stats.isFile();
   } catch {
     return false;
@@ -29443,15 +29864,15 @@ async function readViewerPage(rootDir, relativePath) {
     return null;
   }
   const { paths } = await loadVaultConfig(rootDir);
-  const absolutePath = path31.resolve(paths.wikiDir, relativePath);
+  const absolutePath = path32.resolve(paths.wikiDir, relativePath);
   if (!isPathWithin(paths.wikiDir, absolutePath) || !await isReadableFile(absolutePath)) {
     return null;
   }
-  const raw = await fs27.readFile(absolutePath, "utf8");
+  const raw = await fs28.readFile(absolutePath, "utf8");
   const parsed = matter15(raw);
   return {
     path: relativePath,
-    title: typeof parsed.data.title === "string" ? parsed.data.title : path31.basename(relativePath, path31.extname(relativePath)),
+    title: typeof parsed.data.title === "string" ? parsed.data.title : path32.basename(relativePath, path32.extname(relativePath)),
     frontmatter: parsed.data,
     content: parsed.content,
     assets: normalizeOutputAssets(parsed.data.output_assets)
@@ -29462,12 +29883,12 @@ async function readViewerAsset(rootDir, relativePath) {
     return null;
   }
   const { paths } = await loadVaultConfig(rootDir);
-  const absolutePath = path31.resolve(paths.wikiDir, relativePath);
+  const absolutePath = path32.resolve(paths.wikiDir, relativePath);
   if (!isPathWithin(paths.wikiDir, absolutePath) || !await isReadableFile(absolutePath)) {
     return null;
   }
   return {
-    buffer: await fs27.readFile(absolutePath),
+    buffer: await fs28.readFile(absolutePath),
     mimeType: mime2.lookup(absolutePath) || "application/octet-stream"
   };
 }
@@ -29490,12 +29911,12 @@ async function readJsonBody(request) {
   return JSON.parse(raw);
 }
 async function ensureViewerDist(viewerDistDir) {
-  const indexPath = path31.join(viewerDistDir, "index.html");
+  const indexPath = path32.join(viewerDistDir, "index.html");
   if (await fileExists(indexPath)) {
     return;
   }
-  const viewerProjectDir = path31.dirname(viewerDistDir);
-  if (await fileExists(path31.join(viewerProjectDir, "package.json"))) {
+  const viewerProjectDir = path32.dirname(viewerDistDir);
+  if (await fileExists(path32.join(viewerProjectDir, "package.json"))) {
     await execFileAsync2("pnpm", ["build"], { cwd: viewerProjectDir });
   }
 }
@@ -29518,7 +29939,7 @@ async function startGraphServer(rootDir, port, options = {}) {
           response.end(JSON.stringify({ error: "Graph artifact not found. Run `swarmvault compile` first." }));
           return;
         }
-        const reportPath = path31.join(paths.wikiDir, "graph", "report.json");
+        const reportPath = path32.join(paths.wikiDir, "graph", "report.json");
         const report = await readJsonFile(reportPath) ?? null;
         response.writeHead(200, { "content-type": "application/json" });
         response.end(JSON.stringify(buildViewerGraphArtifact(graph, { report, full: options.full ?? false })));
@@ -29582,13 +30003,13 @@ async function startGraphServer(rootDir, port, options = {}) {
         return;
       }
       if (url.pathname === "/api/graph-report") {
-        const reportPath = path31.join(paths.wikiDir, "graph", "report.json");
+        const reportPath = path32.join(paths.wikiDir, "graph", "report.json");
         if (!await fileExists(reportPath)) {
           response.writeHead(404, { "content-type": "application/json" });
           response.end(JSON.stringify({ error: "Graph report artifact not found. Run `swarmvault compile` first." }));
           return;
         }
-        const body = await fs27.readFile(reportPath, "utf8");
+        const body = await fs28.readFile(reportPath, "utf8");
         response.writeHead(200, { "content-type": "application/json" });
         response.end(body);
         return;
@@ -29689,7 +30110,7 @@ async function startGraphServer(rootDir, port, options = {}) {
         return;
       }
       if (url.pathname === "/api/workspace") {
-        const reportPath = path31.join(paths.wikiDir, "graph", "report.json");
+        const reportPath = path32.join(paths.wikiDir, "graph", "report.json");
         const [graphRaw, reportRaw, approvalsRaw, candidatesRaw, watchStatusRaw, lintRaw] = await Promise.all([
           readJsonFile(paths.graphPath).catch(() => null),
           readJsonFile(reportPath).catch(() => null),
@@ -29785,15 +30206,15 @@ async function startGraphServer(rootDir, port, options = {}) {
         return;
       }
       const relativePath = url.pathname === "/" ? "index.html" : url.pathname.slice(1);
-      const target = path31.join(paths.viewerDistDir, relativePath);
-      const fallback = path31.join(paths.viewerDistDir, "index.html");
+      const target = path32.join(paths.viewerDistDir, relativePath);
+      const fallback = path32.join(paths.viewerDistDir, "index.html");
       const filePath = await fileExists(target) ? target : fallback;
       if (!await fileExists(filePath)) {
         response.writeHead(503, { "content-type": "text/plain" });
         response.end("Viewer build not found. Run `pnpm build` first.");
         return;
       }
-      const staticBody = await fs27.readFile(filePath);
+      const staticBody = await fs28.readFile(filePath);
       response.writeHead(200, { "content-type": mime2.lookup(filePath) || "text/plain" });
       response.end(staticBody);
     } catch (error) {
@@ -29833,7 +30254,7 @@ async function exportGraphHtml(rootDir, outputPath, options = {}) {
     throw new Error("Graph artifact not found. Run `swarmvault compile` first.");
   }
   await ensureViewerDist(paths.viewerDistDir);
-  const indexPath = path31.join(paths.viewerDistDir, "index.html");
+  const indexPath = path32.join(paths.viewerDistDir, "index.html");
   if (!await fileExists(indexPath)) {
     throw new Error("Viewer build not found. Run `pnpm build` first.");
   }
@@ -29859,17 +30280,17 @@ async function exportGraphHtml(rootDir, outputPath, options = {}) {
       } : null;
     })
   );
-  const rawHtml = await fs27.readFile(indexPath, "utf8");
+  const rawHtml = await fs28.readFile(indexPath, "utf8");
   const scriptMatch = rawHtml.match(/<script type="module" crossorigin src="([^"]+)"><\/script>/);
   const styleMatch = rawHtml.match(/<link rel="stylesheet" crossorigin href="([^"]+)">/);
-  const scriptPath = scriptMatch?.[1] ? path31.join(paths.viewerDistDir, scriptMatch[1].replace(/^\//, "")) : null;
-  const stylePath = styleMatch?.[1] ? path31.join(paths.viewerDistDir, styleMatch[1].replace(/^\//, "")) : null;
+  const scriptPath = scriptMatch?.[1] ? path32.join(paths.viewerDistDir, scriptMatch[1].replace(/^\//, "")) : null;
+  const stylePath = styleMatch?.[1] ? path32.join(paths.viewerDistDir, styleMatch[1].replace(/^\//, "")) : null;
   if (!scriptPath || !await fileExists(scriptPath)) {
     throw new Error("Viewer script bundle not found. Run `pnpm build` first.");
   }
-  const script = await fs27.readFile(scriptPath, "utf8");
-  const style = stylePath && await fileExists(stylePath) ? await fs27.readFile(stylePath, "utf8") : "";
-  const report = await readJsonFile(path31.join(paths.wikiDir, "graph", "report.json"));
+  const script = await fs28.readFile(scriptPath, "utf8");
+  const style = stylePath && await fileExists(stylePath) ? await fs28.readFile(stylePath, "utf8") : "";
+  const report = await readJsonFile(path32.join(paths.wikiDir, "graph", "report.json"));
   const embeddedData = JSON.stringify(
     { graph: buildViewerGraphArtifact(graph, { report, full: options.full ?? false }), pages: pages.filter(Boolean), report },
     null,
@@ -29892,9 +30313,9 @@ async function exportGraphHtml(rootDir, outputPath, options = {}) {
     "</html>",
     ""
   ].filter(Boolean).join("\n");
-  await fs27.mkdir(path31.dirname(outputPath), { recursive: true });
-  await fs27.writeFile(outputPath, html, "utf8");
-  return path31.resolve(outputPath);
+  await fs28.mkdir(path32.dirname(outputPath), { recursive: true });
+  await fs28.writeFile(outputPath, html, "utf8");
+  return path32.resolve(outputPath);
 }
 export {
   ALL_MIGRATIONS,
@@ -29905,6 +30326,8 @@ export {
   DEFAULT_REDACTION_PATTERNS,
   DEFAULT_STALE_THRESHOLD,
   LARGE_REPO_NODE_THRESHOLD,
+  LOCAL_WHISPER_MODEL_SIZES,
+  LocalWhisperProviderAdapter,
   OPENAI_COMPATIBLE_CAPABILITY_MATRIX,
   acceptApproval,
   addInput,
@@ -29919,6 +30342,7 @@ export {
   blastRadiusVault,
   bootstrapDemo,
   buildConfiguredRedactor,
+  buildGraphShareArtifact,
   buildRedactor,
   compileVault,
   computeDecayScore,
@@ -29931,9 +30355,12 @@ export {
   defaultVaultSchema,
   deleteManagedSource,
   detectVaultVersion,
+  discoverLocalWhisperBinary,
+  downloadWhisperModel,
   estimatePageTokens,
   estimateTokens,
   evaluateCandidateForPromotion,
+  expectedModelPath,
   explainGraphVault,
   exploreVault,
   exportGraphFormat,
@@ -29974,6 +30401,7 @@ export {
   loadVaultSchemas,
   lookupPresetCapabilities,
   markSuperseded,
+  modelDownloadUrl,
   pathGraphVault,
   persistDecayFrontmatter,
   planMigration,
@@ -29986,9 +30414,11 @@ export {
   readExtractedText,
   readGraphReport,
   readPage,
+  registerLocalWhisperProvider,
   rejectApproval,
   reloadManagedSources,
   removeWatchedRoot,
+  renderGraphShareMarkdown,
   resetDecay,
   resolveConsolidationConfig,
   resolveDecayConfig,
@@ -30010,6 +30440,7 @@ export {
   stageGeneratedOutputPages,
   startGraphServer,
   startMcpServer,
+  summarizeLocalWhisperSetup,
   syncTrackedRepos,
   syncTrackedReposForWatch,
   synthesizeHyperedgeHubs,