graphifyy 0.3.17 → 0.3.28

package/dist/index.js

@@ -14,6 +14,21 @@ var __export = (target, all) => {
     __defProp(target, name, { get: all[name], enumerable: true });
 };
 
+// src/types.ts
+var FileType;
+var init_types = __esm({
+  "src/types.ts"() {
+    FileType = /* @__PURE__ */ ((FileType2) => {
+      FileType2["CODE"] = "code";
+      FileType2["DOCUMENT"] = "document";
+      FileType2["PAPER"] = "paper";
+      FileType2["IMAGE"] = "image";
+      FileType2["VIDEO"] = "video";
+      return FileType2;
+    })(FileType || {});
+  }
+});
+
 // src/validate.ts
 function validateExtraction(data) {
   if (typeof data !== "object" || data === null || Array.isArray(data)) {
@@ -103,14 +118,80 @@ var init_validate = __esm({
   }
 });
 
+// src/graph.ts
+import Graph from "graphology";
+function createGraph(directed = false) {
+  return new Graph({ type: directed ? "directed" : "undirected", multi: false });
+}
+function isDirectedGraph(G) {
+  return G.type === "directed";
+}
+function loadGraphFromData(raw) {
+  const G = createGraph(raw.directed === true);
+  for (const [key, value] of Object.entries(raw.graph ?? {})) {
+    G.setAttribute(key, value);
+  }
+  for (const node of raw.nodes ?? []) {
+    const { id, ...attrs } = node;
+    G.mergeNode(id, attrs);
+  }
+  for (const link of raw.links ?? raw.edges ?? []) {
+    const { source, target, ...attrs } = link;
+    if (!G.hasNode(source) || !G.hasNode(target)) continue;
+    try {
+      G.mergeEdge(source, target, attrs);
+    } catch {
+    }
+  }
+  if (raw.hyperedges && raw.hyperedges.length > 0) {
+    G.setAttribute("hyperedges", raw.hyperedges);
+  }
+  return G;
+}
+function toUndirectedGraph(G) {
+  if (!isDirectedGraph(G)) return G.copy();
+  const copy = createGraph(false);
+  for (const [key, value] of Object.entries(G.getAttributes())) {
+    copy.setAttribute(key, value);
+  }
+  G.forEachNode((nodeId, attrs) => {
+    copy.mergeNode(nodeId, attrs);
+  });
+  G.forEachEdge((_edge, attrs, source, target) => {
+    if (!copy.hasNode(source) || !copy.hasNode(target)) return;
+    try {
+      copy.mergeEdge(source, target, attrs);
+    } catch {
+    }
+  });
+  return copy;
+}
+function forEachTraversalNeighbor(G, node, callback) {
+  if (isDirectedGraph(G)) {
+    G.forEachOutboundNeighbor(node, callback);
+    return;
+  }
+  G.forEachNeighbor(node, callback);
+}
+function traversalNeighbors(G, node) {
+  const neighbors = [];
+  forEachTraversalNeighbor(G, node, (neighbor) => {
+    neighbors.push(neighbor);
+  });
+  return neighbors;
+}
+var init_graph = __esm({
+  "src/graph.ts"() {
+  }
+});
+
 // src/build.ts
 var build_exports = {};
 __export(build_exports, {
   build: () => build,
   buildFromJson: () => buildFromJson
 });
-import Graph from "graphology";
-function buildFromJson(extraction) {
+function buildFromJson(extraction, options) {
   const errors = validateExtraction(extraction);
   const realErrors = errors.filter((e) => !e.includes("does not match any node id"));
   if (realErrors.length > 0) {
@@ -118,7 +199,7 @@ function buildFromJson(extraction) {
       `[graphify] Extraction warning (${realErrors.length} issues): ${realErrors[0]}`
     );
   }
-  const G = new Graph({ type: "undirected", multi: false });
+  const G = createGraph(options?.directed === true);
   for (const node of extraction.nodes ?? []) {
     const { id, ...attrs } = node;
     G.mergeNode(id, attrs);
@@ -140,7 +221,7 @@ function buildFromJson(extraction) {
   }
   return G;
 }
-function build(extractions) {
+function build(extractions, options) {
   const combined = {
     nodes: [],
     edges: [],
@@ -155,10 +236,11 @@ function build(extractions) {
     combined.input_tokens += ext.input_tokens ?? 0;
     combined.output_tokens += ext.output_tokens ?? 0;
   }
-  return buildFromJson(combined);
+  return buildFromJson(combined, options);
 }
 var init_build = __esm({
   "src/build.ts"() {
+    init_graph();
     init_validate();
   }
 });
@@ -199,7 +281,7 @@ __export(cluster_exports, {
 });
 import louvain from "graphology-communities-louvain";
 function partition(G) {
-  const result = louvain(G);
+  const result = louvain(G.type === "directed" ? toUndirectedGraph(G) : G);
   const map = /* @__PURE__ */ new Map();
   for (const [node, cid] of Object.entries(result)) {
     map.set(node, cid);
@@ -305,11 +387,378 @@ var MAX_COMMUNITY_FRACTION, MIN_SPLIT_SIZE;
 var init_cluster = __esm({
   "src/cluster.ts"() {
     init_collections();
+    init_graph();
     MAX_COMMUNITY_FRACTION = 0.25;
     MIN_SPLIT_SIZE = 10;
   }
 });
 
+// src/detect.ts
+import {
+  readdirSync,
+  readFileSync,
+  writeFileSync,
+  statSync,
+  existsSync,
+  mkdirSync,
+  lstatSync
+} from "fs";
+import { join, resolve, extname, basename, relative, sep, dirname } from "path";
+import { createHash } from "crypto";
+function isSensitive(filePath) {
+  const name = basename(filePath);
+  return SENSITIVE_PATTERNS.some((p) => p.test(name) || p.test(filePath));
+}
+function looksLikePaper(filePath) {
+  try {
+    const text = readFileSync(filePath, "utf-8").slice(0, 3e3);
+    const hits = PAPER_SIGNALS.filter((p) => p.test(text)).length;
+    return hits >= PAPER_SIGNAL_THRESHOLD;
+  } catch {
+    return false;
+  }
+}
+function classifyFile(filePath) {
+  const ext = extname(filePath).toLowerCase();
+  if (CODE_EXTENSIONS.has(ext)) return "code" /* CODE */;
+  if (PAPER_EXTENSIONS.has(ext)) {
+    const parts = filePath.split(sep);
+    if (parts.some((p) => [...ASSET_DIR_MARKERS].some((m) => p.endsWith(m)))) return null;
+    return "paper" /* PAPER */;
+  }
+  if (IMAGE_EXTENSIONS.has(ext)) return "image" /* IMAGE */;
+  if (VIDEO_EXTENSIONS.has(ext)) return "video" /* VIDEO */;
+  if (DOC_EXTENSIONS.has(ext)) {
+    if (looksLikePaper(filePath)) return "paper" /* PAPER */;
+    return "document" /* DOCUMENT */;
+  }
+  if (OFFICE_EXTENSIONS.has(ext)) return "document" /* DOCUMENT */;
+  return null;
+}
+function countWords(filePath) {
+  try {
+    const text = readFileSync(filePath, "utf-8");
+    return text.split(/\s+/).filter(Boolean).length;
+  } catch {
+    return 0;
+  }
+}
+function isNoiseDir(part) {
+  if (SKIP_DIRS.has(part)) return true;
+  if (part.endsWith("_venv") || part.endsWith("_env")) return true;
+  if (part.endsWith(".egg-info")) return true;
+  return false;
+}
+function loadGraphifyignore(root) {
+  const patterns = [];
+  let current = resolve(root);
+  while (true) {
+    const ignoreFile = join(current, ".graphifyignore");
+    if (existsSync(ignoreFile)) {
+      for (let line of readFileSync(ignoreFile, "utf-8").split("\n")) {
+        line = line.trim();
+        if (line && !line.startsWith("#")) {
+          patterns.push(line);
+        }
+      }
+    }
+    if (existsSync(join(current, ".git"))) {
+      break;
+    }
+    const parent = dirname(current);
+    if (parent === current) {
+      break;
+    }
+    current = parent;
+  }
+  return patterns;
+}
+function matchGlob(text, pattern) {
+  const regex = pattern.replace(/[.+^${}()|[\]\\]/g, "\\$&").replace(/\*/g, ".*").replace(/\?/g, ".");
+  return new RegExp(`^${regex}$`).test(text);
+}
+function isIgnored(filePath, root, patterns) {
+  if (patterns.length === 0) return false;
+  let rel;
+  try {
+    rel = relative(root, filePath).replace(/\\/g, "/");
+  } catch {
+    return false;
+  }
+  const parts = rel.split("/");
+  for (const pattern of patterns) {
+    const p = pattern.replace(/^\/+|\/+$/g, "");
+    if (!p) continue;
+    if (matchGlob(rel, p)) return true;
+    if (matchGlob(basename(filePath), p)) return true;
+    for (let i = 0; i < parts.length; i++) {
+      if (matchGlob(parts[i], p)) return true;
+      if (matchGlob(parts.slice(0, i + 1).join("/"), p)) return true;
+    }
+  }
+  return false;
+}
+function walkDir(dir, root, ignorePatterns, followSymlinks, skipPrune) {
+  const result = [];
+  let entries;
+  try {
+    entries = readdirSync(dir);
+  } catch {
+    return result;
+  }
+  for (const entry of entries) {
+    const full = join(dir, entry);
+    let stat;
+    try {
+      stat = followSymlinks ? statSync(full) : lstatSync(full);
+    } catch {
+      continue;
+    }
+    if (stat.isDirectory()) {
+      if (!skipPrune) {
+        if (entry.startsWith(".")) continue;
+        if (isNoiseDir(entry)) continue;
+        if (isIgnored(full, root, ignorePatterns)) continue;
+      }
+      result.push(...walkDir(full, root, ignorePatterns, followSymlinks, skipPrune));
+    } else if (stat.isFile()) {
+      result.push(full);
+    }
+  }
+  return result;
+}
+function detect(root, options) {
+  const followSymlinks = options?.followSymlinks ?? false;
+  const rootResolved = resolve(root);
+  const ignorePatterns = loadGraphifyignore(rootResolved);
+  const convertedDir = join(rootResolved, "graphify-out", "converted");
+  const memoryDir = join(rootResolved, "graphify-out", "memory");
+  const files = {
+    code: [],
+    document: [],
+    paper: [],
+    image: [],
+    video: []
+  };
+  let totalWords = 0;
+  const skippedSensitive = [];
+  const allFiles = walkDir(rootResolved, rootResolved, ignorePatterns, followSymlinks, false);
+  if (existsSync(memoryDir)) {
+    allFiles.push(...walkDir(memoryDir, rootResolved, ignorePatterns, followSymlinks, true));
+  }
+  const seen = /* @__PURE__ */ new Set();
+  for (const p of allFiles) {
+    if (seen.has(p)) continue;
+    seen.add(p);
+    const inMemory = existsSync(memoryDir) && p.startsWith(memoryDir);
+    if (!inMemory) {
+      if (basename(p).startsWith(".")) continue;
+      if (p.startsWith(convertedDir)) continue;
+    }
+    if (isIgnored(p, rootResolved, ignorePatterns)) continue;
+    if (isSensitive(p)) {
+      skippedSensitive.push(p);
+      continue;
+    }
+    const ftype = classifyFile(p);
+    if (!ftype) continue;
+    if (OFFICE_EXTENSIONS.has(extname(p).toLowerCase())) {
+      skippedSensitive.push(p + " [office conversion requires async - use pipeline]");
+      continue;
+    }
+    files[ftype].push(p);
+    if (ftype !== "video" /* VIDEO */) {
+      totalWords += countWords(p);
+    }
+  }
+  const totalFiles = Object.values(files).reduce((s, v) => s + v.length, 0);
+  const needsGraph = totalWords >= CORPUS_WARN_THRESHOLD;
+  let warning = null;
+  if (!needsGraph) {
+    warning = `Corpus is ~${totalWords.toLocaleString()} words - fits in a single context window. You may not need a graph.`;
+  } else if (totalWords >= CORPUS_UPPER_THRESHOLD || totalFiles >= FILE_COUNT_UPPER) {
+    warning = `Large corpus: ${totalFiles} files \xB7 ~${totalWords.toLocaleString()} words. Semantic extraction will be expensive (many Claude tokens). Consider running on a subfolder, or use --no-semantic to run AST-only.`;
+  }
+  return {
+    files,
+    total_files: totalFiles,
+    total_words: totalWords,
+    needs_graph: needsGraph,
+    warning,
+    skipped_sensitive: skippedSensitive,
+    graphifyignore_patterns: ignorePatterns.length
+  };
+}
+function loadManifest(manifestPath = MANIFEST_PATH) {
+  try {
+    return JSON.parse(readFileSync(manifestPath, "utf-8"));
+  } catch {
+    return {};
+  }
+}
+function saveManifest(files, manifestPath = MANIFEST_PATH) {
+  const manifest = {};
+  for (const fileList of Object.values(files)) {
+    for (const f of fileList) {
+      try {
+        manifest[f] = statSync(f).mtimeMs;
+      } catch {
+      }
+    }
+  }
+  const dir = join(manifestPath, "..");
+  mkdirSync(dir, { recursive: true });
+  writeFileSync(manifestPath, JSON.stringify(manifest, null, 2));
+}
+function detectIncremental(root, manifestPath = MANIFEST_PATH) {
+  const full = detect(root);
+  const manifest = loadManifest(manifestPath);
+  if (Object.keys(manifest).length === 0) {
+    return {
+      ...full,
+      incremental: true,
+      new_files: full.files,
+      unchanged_files: Object.fromEntries(Object.keys(full.files).map((k) => [k, []])),
+      new_total: full.total_files
+    };
+  }
+  const newFiles = {};
+  const unchangedFiles = {};
+  for (const k of Object.keys(full.files)) {
+    newFiles[k] = [];
+    unchangedFiles[k] = [];
+  }
+  for (const [ftype, fileList] of Object.entries(full.files)) {
+    for (const f of fileList) {
+      const storedMtime = manifest[f];
+      let currentMtime = 0;
+      try {
+        currentMtime = statSync(f).mtimeMs;
+      } catch {
+      }
+      if (storedMtime === void 0 || currentMtime > storedMtime) {
+        newFiles[ftype].push(f);
+      } else {
+        unchangedFiles[ftype].push(f);
+      }
+    }
+  }
+  const currentFiles = new Set(Object.values(full.files).flat());
+  const deletedFiles = Object.keys(manifest).filter((f) => !currentFiles.has(f));
+  const newTotal = Object.values(newFiles).reduce((s, v) => s + v.length, 0);
+  return {
+    ...full,
+    incremental: true,
+    new_files: newFiles,
+    unchanged_files: unchangedFiles,
+    new_total: newTotal,
+    deleted_files: deletedFiles
+  };
+}
+var MANIFEST_PATH, CODE_EXTENSIONS, DOC_EXTENSIONS, PAPER_EXTENSIONS, IMAGE_EXTENSIONS, OFFICE_EXTENSIONS, VIDEO_EXTENSIONS, CORPUS_WARN_THRESHOLD, CORPUS_UPPER_THRESHOLD, FILE_COUNT_UPPER, SENSITIVE_PATTERNS, PAPER_SIGNALS, PAPER_SIGNAL_THRESHOLD, ASSET_DIR_MARKERS, SKIP_DIRS;
+var init_detect = __esm({
+  "src/detect.ts"() {
+    init_types();
+    MANIFEST_PATH = "graphify-out/manifest.json";
+    CODE_EXTENSIONS = /* @__PURE__ */ new Set([
+      ".py",
+      ".ts",
+      ".js",
+      ".jsx",
+      ".tsx",
+      ".go",
+      ".rs",
+      ".java",
+      ".cpp",
+      ".cc",
+      ".cxx",
+      ".c",
+      ".h",
+      ".hpp",
+      ".rb",
+      ".swift",
+      ".kt",
+      ".kts",
+      ".cs",
+      ".scala",
+      ".php",
+      ".lua",
+      ".toc",
+      ".zig",
+      ".ps1",
+      ".ex",
+      ".exs",
+      ".m",
+      ".mm",
+      ".jl"
+    ]);
+    DOC_EXTENSIONS = /* @__PURE__ */ new Set([".md", ".txt", ".rst"]);
+    PAPER_EXTENSIONS = /* @__PURE__ */ new Set([".pdf"]);
+    IMAGE_EXTENSIONS = /* @__PURE__ */ new Set([".png", ".jpg", ".jpeg", ".gif", ".webp", ".svg"]);
+    OFFICE_EXTENSIONS = /* @__PURE__ */ new Set([".docx", ".xlsx"]);
+    VIDEO_EXTENSIONS = /* @__PURE__ */ new Set([
+      ".mp4",
+      ".mov",
+      ".webm",
+      ".mkv",
+      ".avi",
+      ".m4v",
+      ".mp3",
+      ".wav",
+      ".m4a",
+      ".ogg"
+    ]);
+    CORPUS_WARN_THRESHOLD = 5e4;
+    CORPUS_UPPER_THRESHOLD = 5e5;
+    FILE_COUNT_UPPER = 200;
+    SENSITIVE_PATTERNS = [
+      /(^|[\\/])\.(env|envrc)(\.|$)/i,
+      /\.(pem|key|p12|pfx|cert|crt|der|p8)$/i,
+      /(credential|secret|passwd|password|token|private_key)/i,
+      /(id_rsa|id_dsa|id_ecdsa|id_ed25519)(\.pub)?$/,
+      /(\.netrc|\.pgpass|\.htpasswd)$/i,
+      /(aws_credentials|gcloud_credentials|service.account)/i
+    ];
+    PAPER_SIGNALS = [
+      /\barxiv\b/i,
+      /\bdoi\s*:/i,
+      /\babstract\b/i,
+      /\bproceedings\b/i,
+      /\bjournal\b/i,
+      /\bpreprint\b/i,
+      /\\cite\{/,
+      /\[\d+\]/,
+      /\[\n\d+\n\]/,
+      /eq\.\s*\d+|equation\s+\d+/i,
+      /\d{4}\.\d{4,5}/,
+      /\bwe propose\b/i,
+      /\bliterature\b/i
+    ];
+    PAPER_SIGNAL_THRESHOLD = 3;
+    ASSET_DIR_MARKERS = /* @__PURE__ */ new Set([".imageset", ".xcassets", ".appiconset", ".colorset", ".launchimage"]);
+    SKIP_DIRS = /* @__PURE__ */ new Set([
+      "venv",
+      ".venv",
+      "env",
+      ".env",
+      "node_modules",
+      "__pycache__",
+      ".git",
+      "dist",
+      "build",
+      "target",
+      "out",
+      "site-packages",
+      "lib64",
+      ".pytest_cache",
+      ".mypy_cache",
+      ".ruff_cache",
+      ".tox",
+      ".eggs"
+    ]);
+  }
+});
+
 // src/analyze.ts
 var analyze_exports = {};
 __export(analyze_exports, {
@@ -351,10 +800,11 @@ function isConceptNode(G, nodeId) {
   return false;
 }
 function fileCategory(path) {
-  const ext = path.includes(".") ? path.split(".").pop()?.toLowerCase() ?? "" : "";
+  const ext = path.includes(".") ? `.${path.split(".").pop()?.toLowerCase() ?? ""}` : "";
   if (CODE_EXTENSIONS.has(ext)) return "code";
   if (PAPER_EXTENSIONS.has(ext)) return "paper";
   if (IMAGE_EXTENSIONS.has(ext)) return "image";
+  if (DOC_EXTENSIONS.has(ext)) return "doc";
   return "doc";
 }
 function topLevelDir(path) {
@@ -548,10 +998,10 @@ function suggestQuestions(G, communities, communityLabels, topN = 7) {
       const cid = nodeCommunity.get(nodeId);
       const commLabel = cid !== void 0 ? labelMap.get(cid) ?? `Community ${cid}` : "unknown";
       const neighborComms = /* @__PURE__ */ new Set();
-      G.forEachNeighbor(nodeId, (n) => {
+      for (const n of traversalNeighbors(G, nodeId)) {
         const nc = nodeCommunity.get(n);
         if (nc !== void 0 && nc !== cid) neighborComms.add(nc);
-      });
+      }
       if (neighborComms.size > 0) {
         const otherLabels = [...neighborComms].map((c) => labelMap.get(c) ?? `Community ${c}`);
         questions.push({
@@ -680,30 +1130,12 @@ function graphDiff(GOld, GNew) {
     summary: parts.length > 0 ? parts.join(", ") : "no changes"
   };
 }
-var CODE_EXTENSIONS, PAPER_EXTENSIONS, IMAGE_EXTENSIONS;
 var init_analyze = __esm({
   "src/analyze.ts"() {
     init_collections();
     init_cluster();
-    CODE_EXTENSIONS = /* @__PURE__ */ new Set([
-      "py",
-      "ts",
-      "tsx",
-      "js",
-      "go",
-      "rs",
-      "java",
-      "rb",
-      "cpp",
-      "c",
-      "h",
-      "cs",
-      "kt",
-      "scala",
-      "php"
-    ]);
-    PAPER_EXTENSIONS = /* @__PURE__ */ new Set(["pdf"]);
-    IMAGE_EXTENSIONS = /* @__PURE__ */ new Set(["png", "jpg", "jpeg", "webp", "gif", "svg"]);
+    init_graph();
+    init_detect();
   }
 });
 
@@ -873,7 +1305,7 @@ var init_report = __esm({
 
 // src/security.ts
 import { resolve as pathResolve } from "path";
-import { existsSync } from "fs";
+import { existsSync as existsSync2 } from "fs";
 import { URL as URL2 } from "url";
 import * as dns from "dns/promises";
 import * as net from "net";
@@ -973,7 +1405,7 @@ async function safeFetchText(url, maxBytes = MAX_TEXT_BYTES, timeout = 15e3) {
 }
 function validateGraphPath(filePath, base) {
   const resolvedBase = pathResolve(base ?? "graphify-out");
-  if (!existsSync(resolvedBase)) {
+  if (!existsSync2(resolvedBase)) {
     throw new Error(
       `Graph base directory does not exist: ${resolvedBase}. Run the graphify skill first to build the graph (for Codex: $graphify .).`
     );
@@ -984,7 +1416,7 @@ function validateGraphPath(filePath, base) {
       `Path '${filePath}' escapes the allowed directory ${resolvedBase}. Only paths inside graphify-out/ are permitted.`
     );
   }
-  if (!existsSync(resolved)) {
+  if (!existsSync2(resolved)) {
     throw new Error(`Graph file not found: ${resolved}`);
   }
   return resolved;
@@ -1022,7 +1454,7 @@ __export(export_exports, {
   toJson: () => toJson,
   toSvg: () => toSvg
 });
-import { writeFileSync } from "fs";
+import { writeFileSync as writeFileSync2 } from "fs";
 function nodeCommunityMap2(communities) {
   const communityMap = toNumericMap(communities);
   const result = /* @__PURE__ */ new Map();
@@ -1050,14 +1482,17 @@ function normalizeCommunityLabels(labelsOrOptions) {
   }
   return toNumericMap(labelsOrOptions.communityLabels);
 }
-function toJson(G, communities, outputPath) {
+function toJson(G, communities, outputPath, communityLabelsOrOptions) {
   const nodeComm = nodeCommunityMap2(communities);
+  const communityLabels = normalizeCommunityLabels(communityLabelsOrOptions);
   const nodes = [];
   G.forEachNode((nodeId, attrs) => {
+    const communityId = nodeComm.get(nodeId) ?? null;
     nodes.push({
       id: nodeId,
       ...attrs,
-      community: nodeComm.get(nodeId) ?? null
+      community: communityId,
+      community_name: communityId !== null ? sanitizeLabel(communityLabels?.get(communityId) ?? `Community ${communityId}`) : null
     });
   });
   const links = [];
@@ -1074,15 +1509,20 @@ function toJson(G, communities, outputPath) {
     links.push(link);
   });
   const hyperedges = G.getAttribute("hyperedges") ?? [];
+  const communityLabelsObject = communityLabels ? Object.fromEntries(
+    [...communityLabels.entries()].sort((a, b) => a[0] - b[0]).map(([cid, label]) => [String(cid), sanitizeLabel(label)])
+  ) : {};
   const output = {
-    directed: false,
+    directed: isDirectedGraph(G),
     multigraph: false,
-    graph: {},
+    graph: {
+      community_labels: communityLabelsObject
+    },
     nodes,
     links,
     hyperedges
   };
-  writeFileSync(outputPath, JSON.stringify(output, null, 2), "utf-8");
+  writeFileSync2(outputPath, JSON.stringify(output, null, 2), "utf-8");
 }
 function toCypher(G, outputPath) {
   const lines = ["// Neo4j Cypher import - generated by the graphify skill", ""];
@@ -1104,7 +1544,7 @@ function toCypher(G, outputPath) {
       `MATCH (a {id: '${uEsc}'}), (b {id: '${vEsc}'}) MERGE (a)-[:${rel} {confidence: '${conf}'}]->(b);`
     );
   });
-  writeFileSync(outputPath, lines.join("\n"), "utf-8");
+  writeFileSync2(outputPath, lines.join("\n"), "utf-8");
 }
 function neo4jLabel(label) {
   const sanitized = label.replace(/[^A-Za-z0-9_]/g, "");
@@ -1343,9 +1783,24 @@ function focusNode(nodeId) {
   showInfo(nodeId);
 }
 
+let hoveredNodeId = null;
+network.on('hoverNode', params => {
+  hoveredNodeId = params.node;
+  container.style.cursor = 'pointer';
+});
+network.on('blurNode', () => {
+  hoveredNodeId = null;
+  container.style.cursor = 'default';
+});
+container.addEventListener('click', () => {
+  if (hoveredNodeId !== null) {
+    showInfo(hoveredNodeId);
+    network.selectNodes([hoveredNodeId]);
+  }
+});
 network.on('click', params => {
   if (params.nodes.length > 0) showInfo(params.nodes[0]);
-  else document.getElementById('info-content').innerHTML = '<span class="empty">Click a node to inspect it</span>';
+  else if (hoveredNodeId === null) document.getElementById('info-content').innerHTML = '<span class="empty">Click a node to inspect it</span>';
 });
 
 const searchInput = document.getElementById('search');
@@ -1500,7 +1955,7 @@ ${htmlScript(nodesJson, edgesJson, legendJson)}
 ${hyperedgeScript(hyperedgesJson)}
 </body>
 </html>`;
-  writeFileSync(outputPath, html, "utf-8");
+  writeFileSync2(outputPath, html, "utf-8");
 }
 function toGraphml(G, communities, outputPath) {
   const nodeComm = nodeCommunityMap2(communities);
@@ -1516,7 +1971,7 @@ function toGraphml(G, communities, outputPath) {
   lines.push('  <key id="community" for="node" attr.name="community" attr.type="int"/>');
   lines.push('  <key id="relation" for="edge" attr.name="relation" attr.type="string"/>');
   lines.push('  <key id="confidence" for="edge" attr.name="confidence" attr.type="string"/>');
-  lines.push('  <graph id="G" edgedefault="undirected">');
+  lines.push(`  <graph id="G" edgedefault="${isDirectedGraph(G) ? "directed" : "undirected"}">`);
   G.forEachNode((nodeId, data) => {
     lines.push(`    <node id="${xmlEsc(nodeId)}">`);
     lines.push(`      <data key="label">${xmlEsc(data.label ?? nodeId)}</data>`);
@@ -1533,7 +1988,7 @@ function toGraphml(G, communities, outputPath) {
   });
   lines.push("  </graph>");
   lines.push("</graphml>");
-  writeFileSync(outputPath, lines.join("\n"), "utf-8");
+  writeFileSync2(outputPath, lines.join("\n"), "utf-8");
 }
 function toSvg(G, communities, outputPath, communityLabelsOrOptions, figsize = [20, 14]) {
   const communityMap = toNumericMap(communities);
@@ -1606,7 +2061,7 @@ function toSvg(G, communities, outputPath, communityLabelsOrOptions, figsize = [
     }
   }
   svgParts.push("</svg>");
-  writeFileSync(outputPath, svgParts.join("\n"), "utf-8");
+  writeFileSync2(outputPath, svgParts.join("\n"), "utf-8");
 }
 function toCanvas(G, communities, outputPath, communityLabelsOrOptions, nodeFilenames) {
   const communityMap = toNumericMap(communities);
@@ -1615,7 +2070,7 @@ function toCanvas(G, communities, outputPath, communityLabelsOrOptions, nodeFile
   const providedNodeFilenames = options?.nodeFilenames ?? nodeFilenames;
   const CANVAS_COLORS = ["1", "2", "3", "4", "5", "6"];
   function safeName(label) {
-    return label.replace(/[\\/*?:"<>|#^[\]]/g, "").trim() || "unnamed";
+    return label.replace(/\r\n/g, " ").replace(/\r/g, " ").replace(/\n/g, " ").replace(/[\\/*?:"<>|#^[\]]/g, "").trim() || "unnamed";
   }
   let filenameMap;
   if (!providedNodeFilenames) {
@@ -1694,13 +2149,13 @@ function toCanvas(G, communities, outputPath, communityLabelsOrOptions, nodeFile
   for (let idx = 0; idx < sortedCids.length; idx++) {
     const cid = sortedCids[idx];
     const members = communityMap.get(cid) ?? [];
-    const communityName = communityLabels?.get(cid) ?? `Community ${cid}`;
+    const communityName2 = communityLabels?.get(cid) ?? `Community ${cid}`;
     const [gx, gy, gw, gh] = groupLayout.get(cid) ?? [0, 0, 600, 400];
     const canvasColor = CANVAS_COLORS[idx % CANVAS_COLORS.length];
     canvasNodes.push({
       id: `g${cid}`,
       type: "group",
-      label: communityName,
+      label: communityName2,
       x: gx,
       y: gy,
       width: gw,
@@ -1750,12 +2205,13 @@ function toCanvas(G, communities, outputPath, communityLabelsOrOptions, nodeFile
     });
   }
   const canvasData = { nodes: canvasNodes, edges: canvasEdges };
-  writeFileSync(outputPath, JSON.stringify(canvasData, null, 2), "utf-8");
+  writeFileSync2(outputPath, JSON.stringify(canvasData, null, 2), "utf-8");
 }
 var COMMUNITY_COLORS, MAX_NODES_FOR_VIZ, CONFIDENCE_SCORE_DEFAULTS;
 var init_export = __esm({
   "src/export.ts"() {
     init_security();
+    init_graph();
     init_collections();
     COMMUNITY_COLORS = [
       "#4E79A7",
@@ -1781,9 +2237,21 @@ var init_export = __esm({
 // src/cache.ts
 import { createHash as createHash2 } from "crypto";
 import { readFileSync as readFileSync2, writeFileSync as writeFileSync4, mkdirSync as mkdirSync3, readdirSync as readdirSync2, unlinkSync, renameSync, existsSync as existsSync3 } from "fs";
-import { join as join3, resolve as resolve2 } from "path";
+import { extname as extname2, join as join3, resolve as resolve2 } from "path";
+function bodyContent(content) {
+  const text = content.toString("utf-8");
+  if (!text.startsWith("---")) {
+    return content;
+  }
+  const end = text.indexOf("\n---", 3);
+  if (end === -1) {
+    return content;
+  }
+  return Buffer.from(text.slice(end + 4), "utf-8");
+}
 function fileHash(filePath) {
-  const content = readFileSync2(filePath);
+  const raw = readFileSync2(filePath);
+  const content = extname2(filePath).toLowerCase() === ".md" ? bodyContent(raw) : raw;
   const resolved = resolve2(filePath);
   const h = createHash2("sha256");
   h.update(content);
@@ -1906,7 +2374,7 @@ __export(extract_exports, {
   extractZig: () => extractZig
 });
 import { readFileSync as readFileSync3, readdirSync as readdirSync3, lstatSync as lstatSync2, realpathSync, existsSync as existsSync4 } from "fs";
-import { resolve as resolve3, basename as basename2, extname as extname2, dirname, join as join4, sep as sep2 } from "path";
+import { resolve as resolve3, basename as basename2, extname as extname3, dirname as dirname2, join as join4, sep as sep2 } from "path";
 import { createRequire } from "module";
 import * as TreeSitter from "web-tree-sitter";
 function getModuleRequire() {
@@ -2362,7 +2830,7 @@ async function _extractGeneric(filePath, config) {
     return { nodes: [], edges: [], error: String(e) };
   }
   const root = tree.rootNode;
-  const stem = basename2(filePath, extname2(filePath));
+  const stem = basename2(filePath, extname3(filePath));
   const strPath = filePath;
   const nodes = [];
   const edges = [];
@@ -2731,10 +3199,10 @@ async function _extractGeneric(filePath, config) {
               source: callerNid,
               target: tgtNid,
               relation: "calls",
-              confidence: "INFERRED",
+              confidence: "EXTRACTED",
               source_file: strPath,
               source_location: `L${line}`,
-              weight: 0.8
+              weight: 1
             });
           }
         }
@@ -2770,7 +3238,7 @@ async function _extractPythonRationale(filePath, result) {
   } catch {
     return;
   }
-  const stem = basename2(filePath, extname2(filePath));
+  const stem = basename2(filePath, extname3(filePath));
   const strPath = filePath;
   const { nodes, edges } = result;
   const seenIds = new Set(nodes.map((n) => n.id));
@@ -2866,7 +3334,7 @@ async function extractPython(filePath) {
   return result;
 }
 async function extractJs(filePath) {
-  const ext = extname2(filePath);
+  const ext = extname3(filePath);
   const config = ext === ".ts" || ext === ".tsx" ? _TS_CONFIG : _JS_CONFIG;
   return _extractGeneric(filePath, config);
 }
@@ -2917,7 +3385,7 @@ async function extractJulia(filePath) {
     return { nodes: [], edges: [], error: String(e) };
   }
   const root = tree.rootNode;
-  const stem = basename2(filePath, extname2(filePath));
+  const stem = basename2(filePath, extname3(filePath));
   const strPath = filePath;
   const nodes = [];
   const edges = [];
@@ -3113,8 +3581,8 @@ async function extractGo(filePath) {
     return { nodes: [], edges: [], error: String(e) };
   }
   const root = tree.rootNode;
-  const stem = basename2(filePath, extname2(filePath));
-  const pkgScope = dirname(filePath).split(sep2).pop() || stem;
+  const stem = basename2(filePath, extname3(filePath));
+  const pkgScope = dirname2(filePath).split(sep2).pop() || stem;
   const strPath = filePath;
   const nodes = [];
   const edges = [];
@@ -3257,10 +3725,10 @@ async function extractGo(filePath) {
               source: callerNid,
               target: tgtNid,
               relation: "calls",
-              confidence: "INFERRED",
+              confidence: "EXTRACTED",
               source_file: strPath,
               source_location: `L${line}`,
-              weight: 0.8
+              weight: 1
             });
           }
         }
@@ -3295,7 +3763,7 @@ async function extractRust(filePath) {
     return { nodes: [], edges: [], error: String(e) };
   }
   const root = tree.rootNode;
-  const stem = basename2(filePath, extname2(filePath));
+  const stem = basename2(filePath, extname3(filePath));
   const strPath = filePath;
   const nodes = [];
   const edges = [];
@@ -3412,10 +3880,10 @@ async function extractRust(filePath) {
               source: callerNid,
               target: tgtNid,
               relation: "calls",
-              confidence: "INFERRED",
+              confidence: "EXTRACTED",
               source_file: strPath,
               source_location: `L${line}`,
-              weight: 0.8
+              weight: 1
             });
           }
         }
@@ -3450,7 +3918,7 @@ async function extractZig(filePath) {
     return { nodes: [], edges: [], error: String(e) };
   }
   const root = tree.rootNode;
-  const stem = basename2(filePath, extname2(filePath));
+  const stem = basename2(filePath, extname3(filePath));
   const strPath = filePath;
   const nodes = [];
   const edges = [];
@@ -3574,7 +4042,7 @@ async function extractZig(filePath) {
           const pair = `${callerNid}|${tgtNid}`;
           if (!seenCallPairs.has(pair)) {
             seenCallPairs.add(pair);
-            addEdge(callerNid, tgtNid, "calls", node.startPosition.row + 1, "INFERRED", 0.8);
+            addEdge(callerNid, tgtNid, "calls", node.startPosition.row + 1, "EXTRACTED", 1);
           }
         }
       }
@@ -3608,7 +4076,7 @@ async function extractPowershell(filePath) {
     return { nodes: [], edges: [], error: String(e) };
   }
   const root = tree.rootNode;
-  const stem = basename2(filePath, extname2(filePath));
+  const stem = basename2(filePath, extname3(filePath));
   const strPath = filePath;
   const nodes = [];
   const edges = [];
@@ -3757,7 +4225,7 @@ async function extractPowershell(filePath) {
             const pair = `${callerNid}|${tgtNid}`;
             if (!seenCallPairs.has(pair)) {
               seenCallPairs.add(pair);
-              addEdge(callerNid, tgtNid, "calls", node.startPosition.row + 1, "INFERRED", 0.8);
+              addEdge(callerNid, tgtNid, "calls", node.startPosition.row + 1, "EXTRACTED", 1);
             }
           }
         }
@@ -3792,7 +4260,7 @@ async function extractObjc(filePath) {
     return { nodes: [], edges: [], error: String(e) };
   }
   const root = tree.rootNode;
-  const stem = basename2(filePath, extname2(filePath));
+  const stem = basename2(filePath, extname3(filePath));
   const strPath = filePath;
   const nodes = [];
   const edges = [];
@@ -3963,7 +4431,7 @@ async function extractObjc(filePath) {
                 const pair = `${callerNid}|${candidate}`;
                 if (!seenCalls.has(pair) && callerNid !== candidate) {
                   seenCalls.add(pair);
-                  addEdge(callerNid, candidate, "calls", bodyNode.startPosition.row + 1, "INFERRED", 0.8);
+                  addEdge(callerNid, candidate, "calls", bodyNode.startPosition.row + 1, "EXTRACTED", 1);
                 }
               }
             }
@@ -3995,7 +4463,7 @@ async function extractElixir(filePath) {
     return { nodes: [], edges: [], error: String(e) };
   }
   const root = tree.rootNode;
-  const stem = basename2(filePath, extname2(filePath));
+  const stem = basename2(filePath, extname3(filePath));
   const strPath = filePath;
   const nodes = [];
   const edges = [];
@@ -4154,7 +4622,7 @@ async function extractElixir(filePath) {
         const pair = `${callerNid}|${tgtNid}`;
         if (!seenCallPairs.has(pair)) {
           seenCallPairs.add(pair);
-          addEdge(callerNid, tgtNid, "calls", node.startPosition.row + 1, "INFERRED", 0.8);
+          addEdge(callerNid, tgtNid, "calls", node.startPosition.row + 1, "EXTRACTED", 1);
         }
       }
     }
@@ -4181,7 +4649,7 @@ async function _resolveCrossFileImports(perFile, paths) {
     for (const node of fileResult.nodes ?? []) {
       const src = node.source_file ?? "";
       if (!src) continue;
-      const fileStem = basename2(src, extname2(src));
+      const fileStem = basename2(src, extname3(src));
       const label = node.label ?? "";
       const nid = node.id ?? "";
       if (label && !label.endsWith(")") && !label.endsWith(".py") && !label.startsWith("_")) {
@@ -4193,7 +4661,7 @@ async function _resolveCrossFileImports(perFile, paths) {
   const newEdges = [];
   const stemToPath = /* @__PURE__ */ new Map();
   for (const p of paths) {
-    stemToPath.set(basename2(p, extname2(p)), p);
+    stemToPath.set(basename2(p, extname3(p)), p);
   }
   for (let idx = 0; idx < perFile.length; idx++) {
     let walkImports = function(node) {
@@ -4257,7 +4725,7 @@ async function _resolveCrossFileImports(perFile, paths) {
     };
     const fileResult = perFile[idx];
     const filePath = paths[idx];
-    const fileStem = basename2(filePath, extname2(filePath));
+    const fileStem = basename2(filePath, extname3(filePath));
     const strPath = filePath;
     const localClasses = fileResult.nodes.filter(
       (n) => n.source_file === strPath && !n.label.endsWith(")") && !n.label.endsWith(".py") && n.id !== _makeId(fileStem)
@@ -4283,7 +4751,7 @@ async function extractWithDiagnostics(paths) {
     if (paths.length === 0) {
       root = ".";
     } else if (paths.length === 1) {
-      root = dirname(paths[0]);
+      root = dirname2(paths[0]);
     } else {
       const parts = paths.map((p) => p.split(sep2));
       const minLen = Math.min(...parts.map((p) => p.length));
@@ -4306,7 +4774,7 @@ async function extractWithDiagnostics(paths) {
 `);
     }
     const filePath = paths[i];
-    const ext = extname2(filePath);
+    const ext = extname3(filePath);
     const extractor = _DISPATCH[ext];
     if (!extractor) continue;
     const cached = loadCached(filePath, root);
@@ -4332,9 +4800,9 @@ async function extractWithDiagnostics(paths) {
     allNodes.push(...result.nodes ?? []);
     allEdges.push(...result.edges ?? []);
   }
-  const pyPaths = paths.filter((p) => extname2(p) === ".py");
+  const pyPaths = paths.filter((p) => extname3(p) === ".py");
   if (pyPaths.length > 0) {
-    const pyResults = perFile.filter((_r, i) => extname2(paths[i]) === ".py");
+    const pyResults = perFile.filter((_r, i) => extname3(paths[i]) === ".py");
     try {
       const crossFileEdges = await _resolveCrossFileImports(pyResults, pyPaths);
       allEdges.push(...crossFileEdges);
@@ -4388,7 +4856,7 @@ function collectFiles(target, options) {
             const real = realpathSync(fullPath);
             if (visited.has(real)) continue;
             visited.add(real);
-            const parentReal = realpathSync(dirname(fullPath));
+            const parentReal = realpathSync(dirname2(fullPath));
             if (parentReal === real || parentReal.startsWith(real + sep2)) continue;
           } catch {
             continue;
@@ -4398,7 +4866,7 @@ function collectFiles(target, options) {
         if (pathParts.some((part) => part.startsWith("."))) continue;
         walkDir2(fullPath, visited);
       } else if (stat.isFile()) {
-        const ext = extname2(entry);
+        const ext = extname3(entry);
         if (_EXTENSIONS.has(ext)) {
           results.push(fullPath);
         }
@@ -4673,16 +5141,8 @@ var init_extract = __esm({
   }
 });
 
-// src/types.ts
-var FileType = /* @__PURE__ */ ((FileType2) => {
-  FileType2["CODE"] = "code";
-  FileType2["DOCUMENT"] = "document";
-  FileType2["PAPER"] = "paper";
-  FileType2["IMAGE"] = "image";
-  return FileType2;
-})(FileType || {});
-
 // src/index.ts
+init_types();
 init_validate();
 init_build();
 init_cluster();
@@ -4692,22 +5152,23 @@ init_export();
 
 // src/wiki.ts
 init_collections();
-import { mkdirSync, writeFileSync as writeFileSync2 } from "fs";
-import { join } from "path";
+init_graph();
+import { mkdirSync as mkdirSync2, writeFileSync as writeFileSync3 } from "fs";
+import { join as join2 } from "path";
 function safeFilename(name) {
-  return name.replace(/\//g, "-").replace(/ /g, "_").replace(/:/g, "-");
+  return name.replace(/\r\n/g, " ").replace(/\r/g, " ").replace(/\n/g, " ").replace(/\//g, "-").replace(/ /g, "_").replace(/:/g, "-");
 }
 function crossCommunityLinks(G, nodes, ownCid, labels) {
   const labelMap = toNumericMap(labels);
   const counts = /* @__PURE__ */ new Map();
   for (const nid of nodes) {
-    G.forEachNeighbor(nid, (neighbor) => {
+    for (const neighbor of traversalNeighbors(G, nid)) {
       const ncid = G.getNodeAttribute(neighbor, "community");
       if (ncid !== void 0 && ncid !== ownCid) {
         const label = labelMap.get(ncid) ?? `Community ${ncid}`;
         counts.set(label, (counts.get(label) ?? 0) + 1);
       }
-    });
+    }
   }
   return [...counts.entries()].sort((a, b) => b[1] - a[1]);
 }
@@ -4771,15 +5232,15 @@ function godNodeArticle(G, nid, labels) {
   const nodeLabel = d.label ?? nid;
   const src = d.source_file ?? "";
   const cid = d.community;
-  const communityName = cid !== void 0 ? labels.get(cid) ?? `Community ${cid}` : void 0;
+  const communityName2 = cid !== void 0 ? labels.get(cid) ?? `Community ${cid}` : void 0;
   const lines = [];
   lines.push(`# ${nodeLabel}`, "");
   lines.push(`> God node \xB7 ${G.degree(nid)} connections \xB7 \`${src}\``, "");
-  if (communityName) {
-    lines.push(`**Community:** [[${communityName}]]`, "");
+  if (communityName2) {
+    lines.push(`**Community:** [[${communityName2}]]`, "");
   }
   const byRelation = /* @__PURE__ */ new Map();
-  const neighbors = [...G.neighbors(nid)].sort((a, b) => G.degree(b) - G.degree(a));
+  const neighbors = traversalNeighbors(G, nid).sort((a, b) => G.degree(b) - G.degree(a));
   for (const neighbor of neighbors) {
     const ed = G.getEdgeAttributes(G.edge(nid, neighbor));
     const rel = ed.relation ?? "related";
@@ -4787,421 +5248,90 @@ function godNodeArticle(G, nid, labels) {
     const conf = ed.confidence ?? "";
     const confStr = conf ? ` \`${conf}\`` : "";
     if (!byRelation.has(rel)) byRelation.set(rel, []);
-    byRelation.get(rel).push(`[[${neighborLabel}]]${confStr}`);
-  }
-  lines.push("## Connections by Relation", "");
-  for (const [rel, targets] of [...byRelation.entries()].sort()) {
-    lines.push(`### ${rel}`);
-    for (const t of targets.slice(0, 20)) {
-      lines.push(`- ${t}`);
-    }
-    lines.push("");
-  }
-  lines.push("---", "", "*Part of the graphify knowledge wiki. See [[index]] to navigate.*");
-  return lines.join("\n");
-}
-function indexMd(communities, labels, godNodesData, totalNodes, totalEdges) {
-  const lines = [
-    "# Knowledge Graph Index",
-    "",
-    "> Auto-generated by graphify. Start here \u2014 read community articles for context, then drill into god nodes for detail.",
-    "",
-    `**${totalNodes} nodes \xB7 ${totalEdges} edges \xB7 ${communities.size} communities**`,
-    "",
-    "---",
-    "",
-    "## Communities",
-    "(sorted by size, largest first)",
-    ""
-  ];
-  const sorted = [...communities.entries()].sort((a, b) => b[1].length - a[1].length);
-  for (const [cid, nodes] of sorted) {
-    const label = labels.get(cid) ?? `Community ${cid}`;
-    lines.push(`- [[${label}]] \u2014 ${nodes.length} nodes`);
-  }
-  lines.push("");
-  if (godNodesData.length > 0) {
-    lines.push("## God Nodes", "(most connected concepts \u2014 the load-bearing abstractions)", "");
-    for (const node of godNodesData) {
-      lines.push(`- [[${node.label}]] \u2014 ${node.edges} connections`);
-    }
-    lines.push("");
-  }
-  lines.push(
-    "---",
-    "",
-    "*Generated by [graphify](https://github.com/safishamsi/graphify)*"
-  );
-  return lines.join("\n");
-}
-function toWiki(G, communities, outputDir, options) {
-  const communityMap = toNumericMap(communities);
-  mkdirSync(outputDir, { recursive: true });
-  const labels = options?.communityLabels ? toNumericMap(options.communityLabels) : new Map([...communityMap.keys()].map((cid) => [cid, `Community ${cid}`]));
-  const cohesion = toNumericMap(options?.cohesion);
-  const godNodesData = options?.godNodesData ?? [];
-  let count = 0;
-  for (const [cid, nodes] of communityMap) {
-    const label = labels.get(cid) ?? `Community ${cid}`;
-    const article = communityArticle(G, cid, nodes, label, labels, cohesion.get(cid));
-    writeFileSync2(join(outputDir, `${safeFilename(label)}.md`), article);
-    count++;
-  }
-  for (const nodeData of godNodesData) {
-    const nid = nodeData.id;
-    if (nid && G.hasNode(nid)) {
-      const article = godNodeArticle(G, nid, labels);
-      writeFileSync2(join(outputDir, `${safeFilename(nodeData.label)}.md`), article);
-      count++;
-    }
-  }
-  writeFileSync2(
-    join(outputDir, "index.md"),
-    indexMd(communityMap, labels, godNodesData, G.order, G.size)
-  );
-  return count;
-}
-
-// src/detect.ts
-import {
-  readdirSync,
-  readFileSync,
-  writeFileSync as writeFileSync3,
-  statSync,
-  existsSync as existsSync2,
-  mkdirSync as mkdirSync2,
-  lstatSync
-} from "fs";
-import { join as join2, resolve, extname, basename, relative, sep } from "path";
-import { createHash } from "crypto";
-var MANIFEST_PATH = "graphify-out/manifest.json";
-var CODE_EXTENSIONS2 = /* @__PURE__ */ new Set([
-  ".py",
-  ".ts",
-  ".js",
-  ".jsx",
-  ".tsx",
-  ".go",
-  ".rs",
-  ".java",
-  ".cpp",
-  ".cc",
-  ".cxx",
-  ".c",
-  ".h",
-  ".hpp",
-  ".rb",
-  ".swift",
-  ".kt",
-  ".kts",
-  ".cs",
-  ".scala",
-  ".php",
-  ".lua",
-  ".toc",
-  ".zig",
-  ".ps1",
-  ".ex",
-  ".exs",
-  ".m",
-  ".mm",
-  ".jl"
-]);
-var DOC_EXTENSIONS = /* @__PURE__ */ new Set([".md", ".txt", ".rst"]);
-var PAPER_EXTENSIONS2 = /* @__PURE__ */ new Set([".pdf"]);
-var IMAGE_EXTENSIONS2 = /* @__PURE__ */ new Set([".png", ".jpg", ".jpeg", ".gif", ".webp", ".svg"]);
-var OFFICE_EXTENSIONS = /* @__PURE__ */ new Set([".docx", ".xlsx"]);
-var CORPUS_WARN_THRESHOLD = 5e4;
-var CORPUS_UPPER_THRESHOLD = 5e5;
-var FILE_COUNT_UPPER = 200;
-var SENSITIVE_PATTERNS = [
-  /(^|[\\/])\.(env|envrc)(\.|$)/i,
-  /\.(pem|key|p12|pfx|cert|crt|der|p8)$/i,
-  /(credential|secret|passwd|password|token|private_key)/i,
-  /(id_rsa|id_dsa|id_ecdsa|id_ed25519)(\.pub)?$/,
-  /(\.netrc|\.pgpass|\.htpasswd)$/i,
-  /(aws_credentials|gcloud_credentials|service.account)/i
-];
-var PAPER_SIGNALS = [
-  /\barxiv\b/i,
-  /\bdoi\s*:/i,
-  /\babstract\b/i,
-  /\bproceedings\b/i,
-  /\bjournal\b/i,
-  /\bpreprint\b/i,
-  /\\cite\{/,
-  /\[\d+\]/,
-  /\[\n\d+\n\]/,
-  /eq\.\s*\d+|equation\s+\d+/i,
-  /\d{4}\.\d{4,5}/,
-  /\bwe propose\b/i,
-  /\bliterature\b/i
-];
-var PAPER_SIGNAL_THRESHOLD = 3;
-function isSensitive(filePath) {
-  const name = basename(filePath);
-  return SENSITIVE_PATTERNS.some((p) => p.test(name) || p.test(filePath));
-}
-function looksLikePaper(filePath) {
-  try {
-    const text = readFileSync(filePath, "utf-8").slice(0, 3e3);
-    const hits = PAPER_SIGNALS.filter((p) => p.test(text)).length;
-    return hits >= PAPER_SIGNAL_THRESHOLD;
-  } catch {
-    return false;
-  }
-}
-var ASSET_DIR_MARKERS = /* @__PURE__ */ new Set([".imageset", ".xcassets", ".appiconset", ".colorset", ".launchimage"]);
-function classifyFile(filePath) {
-  const ext = extname(filePath).toLowerCase();
-  if (CODE_EXTENSIONS2.has(ext)) return "code" /* CODE */;
-  if (PAPER_EXTENSIONS2.has(ext)) {
-    const parts = filePath.split(sep);
-    if (parts.some((p) => [...ASSET_DIR_MARKERS].some((m) => p.endsWith(m)))) return null;
-    return "paper" /* PAPER */;
-  }
-  if (IMAGE_EXTENSIONS2.has(ext)) return "image" /* IMAGE */;
-  if (DOC_EXTENSIONS.has(ext)) {
-    if (looksLikePaper(filePath)) return "paper" /* PAPER */;
-    return "document" /* DOCUMENT */;
-  }
-  if (OFFICE_EXTENSIONS.has(ext)) return "document" /* DOCUMENT */;
-  return null;
-}
-function countWords(filePath) {
-  try {
-    const text = readFileSync(filePath, "utf-8");
-    return text.split(/\s+/).filter(Boolean).length;
-  } catch {
-    return 0;
-  }
-}
-var SKIP_DIRS = /* @__PURE__ */ new Set([
-  "venv",
-  ".venv",
-  "env",
-  ".env",
-  "node_modules",
-  "__pycache__",
-  ".git",
-  "dist",
-  "build",
-  "target",
-  "out",
-  "site-packages",
-  "lib64",
-  ".pytest_cache",
-  ".mypy_cache",
-  ".ruff_cache",
-  ".tox",
-  ".eggs"
-]);
-function isNoiseDir(part) {
-  if (SKIP_DIRS.has(part)) return true;
-  if (part.endsWith("_venv") || part.endsWith("_env")) return true;
-  if (part.endsWith(".egg-info")) return true;
-  return false;
-}
-function loadGraphifyignore(root) {
-  const ignoreFile = join2(root, ".graphifyignore");
-  if (!existsSync2(ignoreFile)) return [];
-  const patterns = [];
-  for (let line of readFileSync(ignoreFile, "utf-8").split("\n")) {
-    line = line.trim();
-    if (line && !line.startsWith("#")) {
-      patterns.push(line);
-    }
-  }
-  return patterns;
-}
-function matchGlob(text, pattern) {
-  const regex = pattern.replace(/[.+^${}()|[\]\\]/g, "\\$&").replace(/\*/g, ".*").replace(/\?/g, ".");
-  return new RegExp(`^${regex}$`).test(text);
-}
-function isIgnored(filePath, root, patterns) {
-  if (patterns.length === 0) return false;
-  let rel;
-  try {
-    rel = relative(root, filePath).replace(/\\/g, "/");
-  } catch {
-    return false;
-  }
-  const parts = rel.split("/");
-  for (const pattern of patterns) {
-    const p = pattern.replace(/^\/+|\/+$/g, "");
-    if (!p) continue;
-    if (matchGlob(rel, p)) return true;
-    if (matchGlob(basename(filePath), p)) return true;
-    for (let i = 0; i < parts.length; i++) {
-      if (matchGlob(parts[i], p)) return true;
-      if (matchGlob(parts.slice(0, i + 1).join("/"), p)) return true;
-    }
-  }
-  return false;
-}
-function walkDir(dir, root, ignorePatterns, followSymlinks, skipPrune) {
-  const result = [];
-  let entries;
-  try {
-    entries = readdirSync(dir);
-  } catch {
-    return result;
-  }
-  for (const entry of entries) {
-    const full = join2(dir, entry);
-    let stat;
-    try {
-      stat = followSymlinks ? statSync(full) : lstatSync(full);
-    } catch {
-      continue;
-    }
-    if (stat.isDirectory()) {
-      if (!skipPrune) {
-        if (entry.startsWith(".")) continue;
-        if (isNoiseDir(entry)) continue;
-        if (isIgnored(full, root, ignorePatterns)) continue;
-      }
-      result.push(...walkDir(full, root, ignorePatterns, followSymlinks, skipPrune));
-    } else if (stat.isFile()) {
-      result.push(full);
-    }
-  }
-  return result;
-}
-function detect(root, options) {
-  const followSymlinks = options?.followSymlinks ?? false;
-  const rootResolved = resolve(root);
-  const ignorePatterns = loadGraphifyignore(rootResolved);
-  const convertedDir = join2(rootResolved, "graphify-out", "converted");
-  const memoryDir = join2(rootResolved, "graphify-out", "memory");
-  const files = {
-    code: [],
-    document: [],
-    paper: [],
-    image: []
-  };
-  let totalWords = 0;
-  const skippedSensitive = [];
-  const allFiles = walkDir(rootResolved, rootResolved, ignorePatterns, followSymlinks, false);
-  if (existsSync2(memoryDir)) {
-    allFiles.push(...walkDir(memoryDir, rootResolved, ignorePatterns, followSymlinks, true));
-  }
-  const seen = /* @__PURE__ */ new Set();
-  for (const p of allFiles) {
-    if (seen.has(p)) continue;
-    seen.add(p);
-    const inMemory = existsSync2(memoryDir) && p.startsWith(memoryDir);
-    if (!inMemory) {
-      if (basename(p).startsWith(".")) continue;
-      if (p.startsWith(convertedDir)) continue;
-    }
-    if (isIgnored(p, rootResolved, ignorePatterns)) continue;
-    if (isSensitive(p)) {
-      skippedSensitive.push(p);
-      continue;
-    }
-    const ftype = classifyFile(p);
-    if (!ftype) continue;
-    if (OFFICE_EXTENSIONS.has(extname(p).toLowerCase())) {
-      skippedSensitive.push(p + " [office conversion requires async - use pipeline]");
-      continue;
-    }
-    files[ftype].push(p);
-    totalWords += countWords(p);
-  }
-  const totalFiles = Object.values(files).reduce((s, v) => s + v.length, 0);
-  const needsGraph = totalWords >= CORPUS_WARN_THRESHOLD;
-  let warning = null;
-  if (!needsGraph) {
-    warning = `Corpus is ~${totalWords.toLocaleString()} words - fits in a single context window. You may not need a graph.`;
-  } else if (totalWords >= CORPUS_UPPER_THRESHOLD || totalFiles >= FILE_COUNT_UPPER) {
-    warning = `Large corpus: ${totalFiles} files \xB7 ~${totalWords.toLocaleString()} words. Semantic extraction will be expensive (many Claude tokens). Consider running on a subfolder, or use --no-semantic to run AST-only.`;
+    byRelation.get(rel).push(`[[${neighborLabel}]]${confStr}`);
   }
-  return {
-    files,
-    total_files: totalFiles,
-    total_words: totalWords,
-    needs_graph: needsGraph,
-    warning,
-    skipped_sensitive: skippedSensitive,
-    graphifyignore_patterns: ignorePatterns.length
-  };
-}
-function loadManifest(manifestPath = MANIFEST_PATH) {
-  try {
-    return JSON.parse(readFileSync(manifestPath, "utf-8"));
-  } catch {
-    return {};
+  lines.push("## Connections by Relation", "");
+  for (const [rel, targets] of [...byRelation.entries()].sort()) {
+    lines.push(`### ${rel}`);
+    for (const t of targets.slice(0, 20)) {
+      lines.push(`- ${t}`);
+    }
+    lines.push("");
   }
+  lines.push("---", "", "*Part of the graphify knowledge wiki. See [[index]] to navigate.*");
+  return lines.join("\n");
 }
-function saveManifest(files, manifestPath = MANIFEST_PATH) {
-  const manifest = {};
-  for (const fileList of Object.values(files)) {
-    for (const f of fileList) {
-      try {
-        manifest[f] = statSync(f).mtimeMs;
-      } catch {
-      }
+function indexMd(communities, labels, godNodesData, totalNodes, totalEdges) {
+  const lines = [
+    "# Knowledge Graph Index",
+    "",
+    "> Auto-generated by graphify. Start here \u2014 read community articles for context, then drill into god nodes for detail.",
+    "",
+    `**${totalNodes} nodes \xB7 ${totalEdges} edges \xB7 ${communities.size} communities**`,
+    "",
+    "---",
+    "",
+    "## Communities",
+    "(sorted by size, largest first)",
+    ""
+  ];
+  const sorted = [...communities.entries()].sort((a, b) => b[1].length - a[1].length);
+  for (const [cid, nodes] of sorted) {
+    const label = labels.get(cid) ?? `Community ${cid}`;
+    lines.push(`- [[${label}]] \u2014 ${nodes.length} nodes`);
+  }
+  lines.push("");
+  if (godNodesData.length > 0) {
+    lines.push("## God Nodes", "(most connected concepts \u2014 the load-bearing abstractions)", "");
+    for (const node of godNodesData) {
+      lines.push(`- [[${node.label}]] \u2014 ${node.edges} connections`);
     }
+    lines.push("");
   }
-  const dir = join2(manifestPath, "..");
-  mkdirSync2(dir, { recursive: true });
-  writeFileSync3(manifestPath, JSON.stringify(manifest, null, 2));
+  lines.push(
+    "---",
+    "",
+    "*Generated by [graphify](https://github.com/safishamsi/graphify)*"
+  );
+  return lines.join("\n");
 }
-function detectIncremental(root, manifestPath = MANIFEST_PATH) {
-  const full = detect(root);
-  const manifest = loadManifest(manifestPath);
-  if (Object.keys(manifest).length === 0) {
-    return {
-      ...full,
-      incremental: true,
-      new_files: full.files,
-      unchanged_files: Object.fromEntries(Object.keys(full.files).map((k) => [k, []])),
-      new_total: full.total_files
-    };
-  }
-  const newFiles = {};
-  const unchangedFiles = {};
-  for (const k of Object.keys(full.files)) {
-    newFiles[k] = [];
-    unchangedFiles[k] = [];
+function toWiki(G, communities, outputDir, options) {
+  const communityMap = toNumericMap(communities);
+  mkdirSync2(outputDir, { recursive: true });
+  const labels = options?.communityLabels ? toNumericMap(options.communityLabels) : new Map([...communityMap.keys()].map((cid) => [cid, `Community ${cid}`]));
+  const cohesion = toNumericMap(options?.cohesion);
+  const godNodesData = options?.godNodesData ?? [];
+  let count = 0;
+  for (const [cid, nodes] of communityMap) {
+    const label = labels.get(cid) ?? `Community ${cid}`;
+    const article = communityArticle(G, cid, nodes, label, labels, cohesion.get(cid));
+    writeFileSync3(join2(outputDir, `${safeFilename(label)}.md`), article);
+    count++;
   }
-  for (const [ftype, fileList] of Object.entries(full.files)) {
-    for (const f of fileList) {
-      const storedMtime = manifest[f];
-      let currentMtime = 0;
-      try {
-        currentMtime = statSync(f).mtimeMs;
-      } catch {
-      }
-      if (storedMtime === void 0 || currentMtime > storedMtime) {
-        newFiles[ftype].push(f);
-      } else {
-        unchangedFiles[ftype].push(f);
-      }
+  for (const nodeData of godNodesData) {
+    const nid = nodeData.id;
+    if (nid && G.hasNode(nid)) {
+      const article = godNodeArticle(G, nid, labels);
+      writeFileSync3(join2(outputDir, `${safeFilename(nodeData.label)}.md`), article);
+      count++;
     }
   }
-  const currentFiles = new Set(Object.values(full.files).flat());
-  const deletedFiles = Object.keys(manifest).filter((f) => !currentFiles.has(f));
-  const newTotal = Object.values(newFiles).reduce((s, v) => s + v.length, 0);
-  return {
-    ...full,
-    incremental: true,
-    new_files: newFiles,
-    unchanged_files: unchangedFiles,
-    new_total: newTotal,
-    deleted_files: deletedFiles
-  };
+  writeFileSync3(
+    join2(outputDir, "index.md"),
+    indexMd(communityMap, labels, godNodesData, G.order, G.size)
+  );
+  return count;
 }
 
 // src/index.ts
+init_detect();
 init_extract();
 init_cache();
 init_security();
 
 // src/benchmark.ts
+init_graph();
 import { readFileSync as readFileSync4, existsSync as existsSync5 } from "fs";
-import Graph2 from "graphology";
 var CHARS_PER_TOKEN = 4;
 function estimateTokens(text) {
   return Math.max(1, Math.floor(text.length / CHARS_PER_TOKEN));
@@ -5223,7 +5353,7 @@ function querySubgraphTokens(G, question, depth = 3) {
   for (let d = 0; d < depth; d++) {
     const nextFrontier = /* @__PURE__ */ new Set();
     for (const n of frontier) {
-      G.forEachNeighbor(n, (neighbor) => {
+      forEachTraversalNeighbor(G, n, (neighbor) => {
         if (!visited.has(neighbor)) {
           nextFrontier.add(neighbor);
           edgesSeen.push([n, neighbor]);
@@ -5258,21 +5388,7 @@ var SAMPLE_QUESTIONS = [
 ];
 function loadGraph(graphPath) {
   const raw = JSON.parse(readFileSync4(graphPath, "utf-8"));
-  const G = new Graph2({ type: "undirected" });
-  for (const node of raw.nodes ?? []) {
-    const { id, ...attrs } = node;
-    G.mergeNode(id, attrs);
-  }
-  for (const link of raw.links ?? []) {
-    const { source, target, ...attrs } = link;
-    if (G.hasNode(source) && G.hasNode(target)) {
-      try {
-        G.mergeEdge(source, target, attrs);
-      } catch {
-      }
-    }
-  }
-  return G;
+  return loadGraphFromData(raw);
 }
 function runBenchmark(graphPath = "graphify-out/graph.json", corpusWordsOrOptions, questions) {
   const options = typeof corpusWordsOrOptions === "number" ? { corpusWords: corpusWordsOrOptions, questions } : corpusWordsOrOptions ?? {};
@@ -5336,8 +5452,404 @@ graphify token reduction benchmark`);
 
 // src/ingest.ts
 init_security();
-import { existsSync as existsSync6, mkdirSync as mkdirSync4, writeFileSync as writeFileSync5 } from "fs";
-import { resolve as pathResolve2, basename as basename3, extname as extname3 } from "path";
+import { existsSync as existsSync7, mkdirSync as mkdirSync5, writeFileSync as writeFileSync6 } from "fs";
+import { resolve as pathResolve2, basename as basename4, extname as extname5 } from "path";
+
+// src/transcribe.ts
+import * as childProcess from "child_process";
+import { createHash as createHash3 } from "crypto";
+import {
+  cpSync,
+  createWriteStream,
+  existsSync as existsSync6,
+  mkdirSync as mkdirSync4,
+  mkdtempSync,
+  readdirSync as readdirSync4,
+  renameSync as renameSync2,
+  rmSync,
+  writeFileSync as writeFileSync5
+} from "fs";
+import { homedir, platform, tmpdir } from "os";
+import { basename as basename3, dirname as dirname3, extname as extname4, join as join5, resolve as resolve5 } from "path";
+import { Readable } from "stream";
+import { pipeline } from "stream/promises";
+var URL_PREFIXES = ["http://", "https://", "www."];
+var CACHED_AUDIO_EXTENSIONS = [".m4a", ".opus", ".mp3", ".ogg", ".wav", ".webm"];
+var DEFAULT_MODEL = "base";
+var TRANSCRIPTS_DIR = "graphify-out/transcripts";
+var FALLBACK_PROMPT = "Use proper punctuation and paragraph breaks.";
+var SHERPA_RELEASE_BASE = "https://github.com/k2-fsa/sherpa-onnx/releases/download/asr-models";
+var AUDIO_SAMPLE_RATE = 16e3;
+var SUPPORTED_MODELS = /* @__PURE__ */ new Set([
+  "tiny",
+  "tiny.en",
+  "base",
+  "base.en",
+  "small",
+  "small.en",
+  "medium",
+  "medium.en",
+  "large-v1",
+  "large-v2",
+  "large-v3",
+  "turbo",
+  "distil-small.en",
+  "distil-medium.en",
+  "distil-large-v2",
+  "distil-large-v3",
+  "distil-large-v3.5"
+]);
+var MODEL_ALIASES = {
+  large: "large-v3"
+};
+var recognizerCache = /* @__PURE__ */ new Map();
+var sherpaModulePromise = null;
+function runCommand(command, args, options) {
+  const result = childProcess.spawnSync(command, args, {
+    encoding: "utf-8",
+    ...options
+  });
+  if (result.error) {
+    throw result.error;
+  }
+  if (result.status !== 0) {
+    throw new Error(result.stderr?.trim() || result.stdout?.trim() || `${command} failed`);
+  }
+  return result;
+}
+function defaultWhisperCacheDir() {
+  if (process.env.GRAPHIFY_WHISPER_CACHE_DIR) {
+    return resolve5(process.env.GRAPHIFY_WHISPER_CACHE_DIR);
+  }
+  if (platform() === "win32") {
+    return join5(
+      process.env.LOCALAPPDATA ?? join5(homedir(), "AppData", "Local"),
+      "graphify",
+      "whisper"
+    );
+  }
+  return join5(process.env.XDG_CACHE_HOME ?? join5(homedir(), ".cache"), "graphify", "whisper");
+}
+function ffmpegBinary() {
+  return process.env.GRAPHIFY_FFMPEG_BIN ?? "ffmpeg";
+}
+function tarBinary() {
+  return process.env.GRAPHIFY_TAR_BIN ?? "tar";
+}
+function resolveRequestedModel(modelName) {
+  const requested = modelName ?? process.env.GRAPHIFY_WHISPER_MODEL ?? DEFAULT_MODEL;
+  const resolved = MODEL_ALIASES[requested] ?? requested;
+  if (!SUPPORTED_MODELS.has(resolved)) {
+    throw new Error(
+      `Unsupported GRAPHIFY_WHISPER_MODEL "${requested}". Supported local TS models: ${[...SUPPORTED_MODELS].sort().join(", ")}`
+    );
+  }
+  return { requested, resolved };
+}
+function walkFiles(dir) {
+  if (!existsSync6(dir)) return [];
+  const files = [];
+  for (const entry of readdirSync4(dir, { withFileTypes: true })) {
+    const fullPath = join5(dir, entry.name);
+    if (entry.isDirectory()) {
+      files.push(...walkFiles(fullPath));
+    } else {
+      files.push(fullPath);
+    }
+  }
+  return files;
+}
+function findArtifactsIn(dir) {
+  const files = walkFiles(dir);
+  const encoderPath = files.find((path) => path.endsWith("-encoder.int8.onnx")) ?? files.find((path) => path.endsWith("-encoder.onnx"));
+  const decoderPath = files.find((path) => path.endsWith("-decoder.int8.onnx")) ?? files.find((path) => path.endsWith("-decoder.onnx"));
+  const tokensPath = files.find((path) => path.endsWith("-tokens.txt"));
+  if (!encoderPath || !decoderPath || !tokensPath) {
+    return null;
+  }
+  return {
+    modelDir: dir,
+    encoderPath,
+    decoderPath,
+    tokensPath
+  };
+}
+function normalizeModelError(detail) {
+  if (detail.includes("404")) {
+    return `${detail}. The local sherpa-onnx release asset was not found for this Whisper model name.`;
+  }
+  return detail;
+}
+async function writeResponseToFile(response, destination) {
+  if (!response.ok || !response.body) {
+    throw new Error(`HTTP ${response.status} while downloading ${response.url}`);
+  }
+  await pipeline(Readable.fromWeb(response.body), createWriteStream(destination));
+}
+async function ensureWhisperArtifacts(modelName) {
+  const { requested, resolved } = resolveRequestedModel(modelName);
+  const cacheRoot = defaultWhisperCacheDir();
+  mkdirSync4(cacheRoot, { recursive: true });
+  const modelDir = join5(cacheRoot, `sherpa-onnx-whisper-${resolved}`);
+  const cached = findArtifactsIn(modelDir);
+  if (cached) {
+    return { requestedModel: requested, resolvedModel: resolved, ...cached };
+  }
+  const tempDir = mkdtempSync(join5(tmpdir(), "graphify-whisper-model-"));
+  const extractDir = join5(tempDir, "extract");
+  const archiveName = `sherpa-onnx-whisper-${resolved}.tar.bz2`;
+  const archivePath = join5(tempDir, archiveName);
+  mkdirSync4(extractDir, { recursive: true });
+  try {
+    const url = `${SHERPA_RELEASE_BASE}/${archiveName}`;
+    console.log(`  downloading whisper model: ${resolved}`);
+    const response = await fetch(url);
+    await writeResponseToFile(response, archivePath);
+    runCommand(tarBinary(), ["-xjf", archivePath, "-C", extractDir]);
+    const extractedRoot = walkFiles(extractDir).map((path) => dirname3(path)).find((path) => findArtifactsIn(path) !== null);
+    const sourceDir = extractedRoot ?? readdirSync4(extractDir, { withFileTypes: true }).filter((entry) => entry.isDirectory()).map((entry) => join5(extractDir, entry.name)).find((path) => findArtifactsIn(path) !== null);
+    if (!sourceDir) {
+      throw new Error(`Downloaded archive for ${resolved} but could not locate Whisper model files`);
+    }
+    if (existsSync6(modelDir)) {
+      rmSync(modelDir, { recursive: true, force: true });
+    }
+    try {
+      renameSync2(sourceDir, modelDir);
+    } catch {
+      cpSync(sourceDir, modelDir, { recursive: true });
+    }
+    const artifacts = findArtifactsIn(modelDir);
+    if (!artifacts) {
+      throw new Error(`Model cache for ${resolved} is incomplete after extraction`);
+    }
+    return { requestedModel: requested, resolvedModel: resolved, ...artifacts };
+  } catch (error) {
+    const detail = error instanceof Error ? error.message : String(error);
+    throw new Error(normalizeModelError(detail));
+  } finally {
+    rmSync(tempDir, { recursive: true, force: true });
+  }
+}
+async function loadSherpaModule() {
+  if (!sherpaModulePromise) {
+    sherpaModulePromise = import("sherpa-onnx-node").then((imported) => Reflect.has(imported, "default") ? Reflect.get(imported, "default") : imported).catch((error) => {
+      sherpaModulePromise = null;
+      const detail = error instanceof Error ? error.message : String(error);
+      throw new Error(
+        `Video transcription requires the optional dependency sherpa-onnx-node. Install it locally, then retry. ${detail}`
+      );
+    });
+  }
+  return sherpaModulePromise;
+}
+async function getRecognizer(modelName, sherpa) {
+  const artifacts = await ensureWhisperArtifacts(modelName);
+  const cacheKey = artifacts.modelDir;
+  const existing = recognizerCache.get(cacheKey);
+  if (existing) {
+    return { recognizer: await existing, artifacts };
+  }
+  const createRecognizer = (async () => {
+    const runtime = sherpa ?? await loadSherpaModule();
+    return runtime.OfflineRecognizer.createAsync({
+      featConfig: {
+        sampleRate: AUDIO_SAMPLE_RATE,
+        featureDim: 80
+      },
+      modelConfig: {
+        whisper: {
+          encoder: artifacts.encoderPath,
+          decoder: artifacts.decoderPath,
+          task: "transcribe"
+        },
+        tokens: artifacts.tokensPath,
+        numThreads: 1,
+        provider: "cpu",
+        debug: 0
+      }
+    });
+  })();
+  recognizerCache.set(
+    cacheKey,
+    createRecognizer.catch((error) => {
+      recognizerCache.delete(cacheKey);
+      throw error;
+    })
+  );
+  return { recognizer: await recognizerCache.get(cacheKey), artifacts };
+}
+function normalizeToWave(audioPath, workingDir) {
+  const wavPath = join5(workingDir, `${basename3(audioPath, extname4(audioPath))}.wav`);
+  try {
+    runCommand(ffmpegBinary(), [
+      "-y",
+      "-i",
+      audioPath,
+      "-vn",
+      "-ac",
+      "1",
+      "-ar",
+      String(AUDIO_SAMPLE_RATE),
+      "-c:a",
+      "pcm_s16le",
+      wavPath
+    ]);
+  } catch (error) {
+    const detail = error instanceof Error ? error.message : String(error);
+    throw new Error(
+      `Video transcription requires ffmpeg in PATH. Install ffmpeg locally, then retry. ${detail}`
+    );
+  }
+  return wavPath;
+}
+function extractTranscriptText(result) {
+  return String(result.text ?? "").trim();
+}
+function isUrl(pathLike) {
+  return URL_PREFIXES.some((prefix) => pathLike.startsWith(prefix));
+}
+function downloadAudio(url, outputDir) {
+  mkdirSync4(outputDir, { recursive: true });
+  const urlHash = createHash3("sha1").update(url).digest("hex").slice(0, 12);
+  for (const ext of CACHED_AUDIO_EXTENSIONS) {
+    const candidate = join5(outputDir, `yt_${urlHash}${ext}`);
+    if (existsSync6(candidate)) {
+      console.log(`  cached audio: ${basename3(candidate)}`);
+      return candidate;
+    }
+  }
+  const outTemplate = join5(outputDir, `yt_${urlHash}.%(ext)s`);
+  try {
+    console.log(`  downloading audio: ${url.slice(0, 80)} ...`);
+    runCommand("yt-dlp", [
+      "-f",
+      "bestaudio[ext=m4a]/bestaudio/best",
+      "-o",
+      outTemplate,
+      "--quiet",
+      "--no-warnings",
+      "--no-playlist",
+      url
+    ]);
+  } catch (error) {
+    const detail = error instanceof Error ? error.message : String(error);
+    throw new Error(
+      `YouTube/URL download requires yt-dlp. Install yt-dlp to enable video ingestion. ${detail}`
+    );
+  }
+  for (const entry of readdirSync4(outputDir)) {
+    if (entry.startsWith(`yt_${urlHash}.`)) {
+      return join5(outputDir, entry);
+    }
+  }
+  throw new Error(`yt-dlp finished without producing an audio file for ${url}`);
+}
+function buildWhisperPrompt(godNodes2) {
+  const override = process.env.GRAPHIFY_WHISPER_PROMPT;
+  if (override) return override;
+  const labels = godNodes2.map((node) => node.label ?? "").filter((label) => Boolean(label)).slice(0, 5);
+  if (labels.length === 0) {
+    return FALLBACK_PROMPT;
+  }
+  return `Technical discussion about ${labels.join(", ")}. ${FALLBACK_PROMPT}`;
+}
+async function transcribe(videoPath, outputDir = TRANSCRIPTS_DIR, initialPrompt, force = false) {
+  const outDir = resolve5(outputDir);
+  mkdirSync4(outDir, { recursive: true });
+  const audioPath = isUrl(videoPath) ? downloadAudio(videoPath, join5(outDir, "downloads")) : resolve5(videoPath);
+  const transcriptPath = join5(outDir, `${basename3(audioPath, extname4(audioPath))}.txt`);
+  if (existsSync6(transcriptPath) && !force) {
+    return transcriptPath;
+  }
+  const prompt = initialPrompt ?? process.env.GRAPHIFY_WHISPER_PROMPT ?? FALLBACK_PROMPT;
+  const requestedModel = process.env.GRAPHIFY_WHISPER_MODEL ?? DEFAULT_MODEL;
+  const tempDir = mkdtempSync(join5(tmpdir(), "graphify-transcribe-"));
+  try {
+    console.log(`  transcribing ${basename3(audioPath)} (model=${requestedModel}) ...`);
+    const wavPath = normalizeToWave(audioPath, tempDir);
+    const sherpa = await loadSherpaModule();
+    const { recognizer, artifacts } = await getRecognizer(requestedModel, sherpa);
+    const wave = sherpa.readWave(wavPath);
+    const stream = recognizer.createStream();
+    if (prompt && typeof stream.setOption === "function") {
+      try {
+        stream.setOption("prompt", prompt);
+      } catch {
+      }
+    }
+    stream.acceptWaveform({ samples: wave.samples, sampleRate: wave.sampleRate });
+    const result = await recognizer.decodeAsync(stream);
+    const transcript = extractTranscriptText(result);
+    writeFileSync5(transcriptPath, transcript, "utf-8");
+    if (artifacts.requestedModel !== artifacts.resolvedModel) {
+      console.log(`  model alias: ${artifacts.requestedModel} -> ${artifacts.resolvedModel}`);
+    }
+  } catch (error) {
+    if (error instanceof Error && error.message.startsWith("Unsupported GRAPHIFY_WHISPER_MODEL")) {
+      throw error;
+    }
+    const detail = error instanceof Error ? error.message : String(error);
+    throw new Error(
+      `Video transcription requires the local TypeScript toolchain: sherpa-onnx-node + ffmpeg. Retry after installing them. ${detail}`
+    );
+  } finally {
+    rmSync(tempDir, { recursive: true, force: true });
+  }
+  return transcriptPath;
+}
+async function transcribeAll(videoFiles, outputDir, initialPrompt, force = false) {
+  if (videoFiles.length === 0) {
+    return [];
+  }
+  const transcriptPaths = [];
+  for (const videoFile of videoFiles) {
+    try {
+      transcriptPaths.push(await transcribe(videoFile, outputDir, initialPrompt, force));
+    } catch (error) {
+      const detail = error instanceof Error ? error.message : String(error);
+      console.log(`  warning: could not transcribe ${videoFile}: ${detail}`);
+    }
+  }
+  return transcriptPaths;
+}
+function cloneDetection(detection) {
+  return JSON.parse(JSON.stringify(detection));
+}
+async function augmentDetectionWithTranscripts(detection, options) {
+  const nextDetection = cloneDetection(detection);
+  const source = options?.incremental && nextDetection.new_files ? nextDetection.new_files : nextDetection.files;
+  const videoFiles = [...source.video ?? []];
+  const prompt = options?.initialPrompt ?? buildWhisperPrompt(options?.godNodes ?? []);
+  if (videoFiles.length === 0) {
+    return { detection: nextDetection, transcriptPaths: [], prompt };
+  }
+  const previousModel = process.env.GRAPHIFY_WHISPER_MODEL;
+  if (options?.whisperModel) {
+    process.env.GRAPHIFY_WHISPER_MODEL = options.whisperModel;
+  }
+  try {
+    const transcriptPaths = await transcribeAll(
+      videoFiles,
+      options?.outputDir,
+      prompt,
+      options?.incremental === true
+    );
+    const existingDocuments = source.document ?? [];
+    source.document = [...existingDocuments, ...transcriptPaths];
+    return { detection: nextDetection, transcriptPaths, prompt };
+  } finally {
+    if (options?.whisperModel) {
+      if (previousModel === void 0) {
+        delete process.env.GRAPHIFY_WHISPER_MODEL;
+      } else {
+        process.env.GRAPHIFY_WHISPER_MODEL = previousModel;
+      }
+    }
+  }
+}
+
+// src/ingest.ts
 function yamlStr(s) {
   return s.replace(/\\/g, "\\\\").replace(/"/g, '\\"').replace(/\n/g, " ").replace(/\r/g, " ");
 }
@@ -5505,7 +6017,7 @@ async function downloadBinary(url, suffix, targetDir) {
   const filename = safeFilename2(url, suffix);
   const outPath = pathResolve2(targetDir, filename);
   const data = await safeFetch(url);
-  writeFileSync5(outPath, data);
+  writeFileSync6(outPath, data);
   return outPath;
 }
 function normalizeIngestOptions(authorOrOptions, contributor) {
@@ -5521,7 +6033,7 @@ function normalizeIngestOptions(authorOrOptions, contributor) {
   };
 }
 async function ingest(url, targetDir, authorOrOptions = null, contributor = null) {
-  mkdirSync4(targetDir, { recursive: true });
+  mkdirSync5(targetDir, { recursive: true });
   const urlType = detectUrlType(url);
   const { author, contributor: normalizedContributor } = normalizeIngestOptions(
     authorOrOptions,
@@ -5532,7 +6044,7 @@ async function ingest(url, targetDir, authorOrOptions = null, contributor = null
   let filename;
   if (urlType === "pdf") {
     const out = await downloadBinary(url, ".pdf", targetDir);
-    console.log(`Downloaded PDF: ${basename3(out)}`);
+    console.log(`Downloaded PDF: ${basename4(out)}`);
     return out;
   }
   if (urlType === "image") {
@@ -5542,9 +6054,14 @@ async function ingest(url, targetDir, authorOrOptions = null, contributor = null
     } catch {
       throw new Error(`Invalid URL: ${url}`);
     }
-    const suffix = extname3(parsed.pathname) || ".jpg";
+    const suffix = extname5(parsed.pathname) || ".jpg";
     const out = await downloadBinary(url, suffix, targetDir);
-    console.log(`Downloaded image: ${basename3(out)}`);
+    console.log(`Downloaded image: ${basename4(out)}`);
+    return out;
+  }
+  if (urlType === "youtube") {
+    const out = downloadAudio(url, targetDir);
+    console.log(`Downloaded audio: ${basename4(out)}`);
     return out;
   }
   if (urlType === "tweet") {
@@ -5556,13 +6073,13 @@ async function ingest(url, targetDir, authorOrOptions = null, contributor = null
   }
   let outPath = pathResolve2(targetDir, filename);
   let counter = 1;
-  while (existsSync6(outPath)) {
+  while (existsSync7(outPath)) {
     const stem = filename.replace(/\.md$/, "");
     outPath = pathResolve2(targetDir, `${stem}_${counter}.md`);
     counter++;
   }
-  writeFileSync5(outPath, content, "utf-8");
-  console.log(`Saved ${urlType}: ${basename3(outPath)}`);
+  writeFileSync6(outPath, content, "utf-8");
+  console.log(`Saved ${urlType}: ${basename4(outPath)}`);
   return outPath;
 }
 function saveQueryResult(questionOrOptions, answer, memoryDir, queryType = "query", sourceNodes = null) {
@@ -5582,7 +6099,7 @@ function saveQueryResult(questionOrOptions, answer, memoryDir, queryType = "quer
   if (!payload.question) throw new Error("saveQueryResult requires a question");
   if (!payload.memoryDir) throw new Error("saveQueryResult requires a memoryDir");
   const effectiveAnswer = payload.answer ?? "";
-  mkdirSync4(payload.memoryDir, { recursive: true });
+  mkdirSync5(payload.memoryDir, { recursive: true });
   const now = /* @__PURE__ */ new Date();
   const slug = payload.question.toLowerCase().replace(/[^\w]/g, "_").slice(0, 50).replace(/_+$/, "");
   const ts = now.toISOString().replace(/[-:]/g, "").replace("T", "_").slice(0, 15);
@@ -5615,10 +6132,10 @@ function saveQueryResult(questionOrOptions, answer, memoryDir, queryType = "quer
   }
   const content = [...frontmatterLines, ...bodyLines].join("\n");
   const outPath = pathResolve2(payload.memoryDir, filename);
-  writeFileSync5(outPath, content, "utf-8");
+  writeFileSync6(outPath, content, "utf-8");
   return outPath;
 }
-var isDirectExecution = typeof process !== "undefined" && typeof process.argv[1] === "string" && /^ingest\.(?:js|mjs|cjs|ts)$/.test(basename3(process.argv[1]));
+var isDirectExecution = typeof process !== "undefined" && typeof process.argv[1] === "string" && /^ingest\.(?:js|mjs|cjs|ts)$/.test(basename4(process.argv[1]));
 if (isDirectExecution) {
   const url = process.argv[2];
   const targetDir = process.argv[3] ?? "./raw";
@@ -5634,16 +6151,16 @@ if (isDirectExecution) {
 }
 
 // src/serve.ts
+init_graph();
 init_security();
 init_analyze();
 import { readFileSync as readFileSync5 } from "fs";
-import Graph3 from "graphology";
 import { bidirectional } from "graphology-shortest-path/unweighted.js";
-import { basename as basename4 } from "path";
+import { basename as basename5, dirname as dirname4, resolve as resolve7 } from "path";
 function loadGraph2(graphPath) {
   let safePath;
   try {
-    safePath = validateGraphPath(graphPath);
+    safePath = validateGraphPath(graphPath, dirname4(resolve7(graphPath)));
   } catch (err) {
     console.error(`error: ${err instanceof Error ? err.message : err}`);
     process.exit(1);
@@ -5657,21 +6174,7 @@ function loadGraph2(graphPath) {
     );
     process.exit(1);
   }
-  const G = new Graph3({ type: "undirected", multi: false });
-  const nodes = data.nodes ?? [];
-  for (const node of nodes) {
-    const { id, ...attrs } = node;
-    G.mergeNode(id, attrs);
-  }
-  const links = data.links ?? data.edges ?? [];
-  for (const link of links) {
-    const { source, target, ...attrs } = link;
-    try {
-      G.mergeEdge(source, target, attrs);
-    } catch {
-    }
-  }
-  return G;
+  return loadGraphFromData(data);
 }
 function communitiesFromGraph(G) {
   const communities = /* @__PURE__ */ new Map();
@@ -5684,6 +6187,15 @@ function communitiesFromGraph(G) {
   });
   return communities;
 }
+function communityName(G, cid) {
+  if (cid === void 0 || cid === null) return null;
+  const labels = G.getAttribute("community_labels");
+  const fromGraph = labels?.[String(cid)];
+  if (typeof fromGraph === "string" && fromGraph.length > 0) {
+    return sanitizeLabel(fromGraph);
+  }
+  return null;
+}
 function scoreNodes(G, terms) {
   const scored = [];
   G.forEachNode((nid, data) => {
@@ -5702,7 +6214,7 @@ function bfs(G, startNodes, depth) {
   for (let i = 0; i < depth; i++) {
     const nextFrontier = /* @__PURE__ */ new Set();
     for (const n of frontier) {
-      G.forEachNeighbor(n, (neighbor) => {
+      forEachTraversalNeighbor(G, n, (neighbor) => {
         if (!visited.has(neighbor)) {
           nextFrontier.add(neighbor);
           edges.push([n, neighbor]);
@@ -5722,7 +6234,7 @@ function dfs(G, startNodes, depth) {
     const [node, d] = stack.pop();
     if (visited.has(node) || d > depth) continue;
     visited.add(node);
-    G.forEachNeighbor(node, (neighbor) => {
+    forEachTraversalNeighbor(G, node, (neighbor) => {
       if (!visited.has(neighbor)) {
         stack.push([neighbor, d + 1]);
         edges.push([node, neighbor]);
@@ -5801,7 +6313,7 @@ function toolGetNode(G, args) {
     `  ID: ${nid}`,
     `  Source: ${d.source_file ?? ""} ${d.source_location ?? ""}`,
     `  Type: ${d.file_type ?? ""}`,
-    `  Community: ${d.community ?? ""}`,
+    `  Community: ${d.community_name ? `${d.community ?? ""} (${d.community_name})` : communityName(G, d.community) ?? String(d.community ?? "")}`,
     `  Degree: ${G.degree(nid)}`
   ].join("\n");
 }
@@ -5812,7 +6324,7 @@ function toolGetNeighbors(G, args) {
   if (matches.length === 0) return `No node matching '${label}' found.`;
   const nid = matches[0];
   const lines = [`Neighbors of ${G.getNodeAttribute(nid, "label") ?? nid}:`];
-  G.forEachNeighbor(nid, (neighbor) => {
+  forEachTraversalNeighbor(G, nid, (neighbor) => {
     const edgeKey = G.edge(nid, neighbor);
     if (!edgeKey) return;
     const d = G.getEdgeAttributes(edgeKey);
@@ -5828,7 +6340,8 @@ function toolGetCommunity(communities, G, args) {
   const cid = Number(args.community_id);
   const nodes = communities.get(cid);
   if (!nodes || nodes.length === 0) return `Community ${cid} not found.`;
-  const lines = [`Community ${cid} (${nodes.length} nodes):`];
+  const label = communityName(G, cid);
+  const lines = [label ? `Community ${cid} - ${label} (${nodes.length} nodes):` : `Community ${cid} (${nodes.length} nodes):`];
   for (const n of nodes) {
     const d = G.getNodeAttributes(n);
     lines.push(`  ${d.label ?? n} [${d.source_file ?? ""}]`);
@@ -6050,8 +6563,13 @@ async function serve(graphPath = "graphify-out/graph.json", transport) {
     if (!handler) {
       return { content: [{ type: "text", text: `Unknown tool: ${name}` }] };
     }
-    const text = handler(args ?? {});
-    return { content: [{ type: "text", text }] };
+    try {
+      const text = handler(args ?? {});
+      return { content: [{ type: "text", text }] };
+    } catch (err) {
+      const message = err instanceof Error ? err.message : String(err);
+      return { content: [{ type: "text", text: `Error executing ${name}: ${message}` }] };
+    }
   });
   const serverTransport = transport ?? new StdioServerTransport();
   let keepAlive;
@@ -6059,14 +6577,14 @@ async function serve(graphPath = "graphify-out/graph.json", transport) {
     keepAlive = setInterval(() => void 0, 6e4);
     process.stdin?.resume();
   }
-  const closed = new Promise((resolve5) => {
+  const closed = new Promise((resolve8) => {
     const previousOnClose = server.onclose;
     server.onclose = () => {
       if (keepAlive) {
         clearInterval(keepAlive);
       }
       previousOnClose?.();
-      resolve5();
+      resolve8();
     };
   });
   await server.connect(serverTransport);
@@ -6074,7 +6592,7 @@ async function serve(graphPath = "graphify-out/graph.json", transport) {
     await closed;
   }
 }
-var isDirectExecution2 = typeof process !== "undefined" && typeof process.argv[1] === "string" && /^serve\.(?:js|mjs|cjs|ts)$/.test(basename4(process.argv[1]));
+var isDirectExecution2 = typeof process !== "undefined" && typeof process.argv[1] === "string" && /^serve\.(?:js|mjs|cjs|ts)$/.test(basename5(process.argv[1]));
 if (isDirectExecution2) {
   const graphPath = process.argv[2] ?? "graphify-out/graph.json";
   serve(graphPath).catch((err) => {
@@ -6084,59 +6602,14 @@ if (isDirectExecution2) {
 }
 
 // src/watch.ts
-import { existsSync as existsSync7, mkdirSync as mkdirSync5, writeFileSync as writeFileSync6, unlinkSync as unlinkSync2 } from "fs";
-import { resolve as pathResolve3, extname as extname4, basename as basename5 } from "path";
+init_detect();
+import { existsSync as existsSync8, mkdirSync as mkdirSync6, writeFileSync as writeFileSync7, unlinkSync as unlinkSync2 } from "fs";
+import { resolve as pathResolve3, extname as extname6, basename as basename6 } from "path";
 var WATCHED_EXTENSIONS = /* @__PURE__ */ new Set([
-  ".py",
-  ".ts",
-  ".js",
-  ".go",
-  ".rs",
-  ".java",
-  ".cpp",
-  ".c",
-  ".rb",
-  ".swift",
-  ".kt",
-  ".cs",
-  ".scala",
-  ".php",
-  ".cc",
-  ".cxx",
-  ".hpp",
-  ".h",
-  ".kts",
-  ".md",
-  ".txt",
-  ".rst",
-  ".pdf",
-  ".png",
-  ".jpg",
-  ".jpeg",
-  ".webp",
-  ".gif",
-  ".svg"
-]);
-var CODE_EXTENSIONS3 = /* @__PURE__ */ new Set([
-  ".py",
-  ".ts",
-  ".js",
-  ".go",
-  ".rs",
-  ".java",
-  ".cpp",
-  ".c",
-  ".rb",
-  ".swift",
-  ".kt",
-  ".cs",
-  ".scala",
-  ".php",
-  ".cc",
-  ".cxx",
-  ".hpp",
-  ".h",
-  ".kts"
+  ...CODE_EXTENSIONS,
+  ...DOC_EXTENSIONS,
+  ...PAPER_EXTENSIONS,
+  ...IMAGE_EXTENSIONS
 ]);
 async function rebuildCode(watchPath, followSymlinks = false) {
   try {
@@ -6189,7 +6662,7 @@ async function rebuildCode(watchPath, followSymlinks = false) {
     }
     const questions = suggestQuestions2(G, communities, labels);
     const outDir = pathResolve3(watchPath, "graphify-out");
-    mkdirSync5(outDir, { recursive: true });
+    mkdirSync6(outDir, { recursive: true });
     const report = generate2(
       G,
       communities,
@@ -6202,10 +6675,10 @@ async function rebuildCode(watchPath, followSymlinks = false) {
       watchPath,
       questions
     );
-    writeFileSync6(pathResolve3(outDir, "GRAPH_REPORT.md"), report, "utf-8");
-    toJson2(G, communities, pathResolve3(outDir, "graph.json"));
+    writeFileSync7(pathResolve3(outDir, "GRAPH_REPORT.md"), report, "utf-8");
+    toJson2(G, communities, pathResolve3(outDir, "graph.json"), { communityLabels: labels });
     const flagPath = pathResolve3(outDir, "needs_update");
-    if (existsSync7(flagPath)) {
+    if (existsSync8(flagPath)) {
       unlinkSync2(flagPath);
     }
     console.log(
@@ -6224,9 +6697,9 @@ async function rebuildCode(watchPath, followSymlinks = false) {
 }
 function notifyOnly(watchPath) {
   const outDir = pathResolve3(watchPath, "graphify-out");
-  mkdirSync5(outDir, { recursive: true });
+  mkdirSync6(outDir, { recursive: true });
   const flagPath = pathResolve3(outDir, "needs_update");
-  writeFileSync6(flagPath, "1", "utf-8");
+  writeFileSync7(flagPath, "1", "utf-8");
   console.log(`
 [graphify watch] New or changed files detected in ${watchPath}`);
   console.log(
@@ -6238,7 +6711,7 @@ function notifyOnly(watchPath) {
   console.log(`[graphify watch] Flag written to ${flagPath}`);
 }
 function hasNonCode(changedPaths) {
-  return changedPaths.some((p) => !CODE_EXTENSIONS3.has(extname4(p).toLowerCase()));
+  return changedPaths.some((p) => !CODE_EXTENSIONS.has(extname6(p).toLowerCase()));
 }
 async function watch(watchPath, debounce = 3) {
   let chokidar;
@@ -6262,7 +6735,7 @@ async function watch(watchPath, debounce = 3) {
     ]
   });
   watcher.on("all", (_event, filePath) => {
-    const ext = extname4(filePath).toLowerCase();
+    const ext = extname6(filePath).toLowerCase();
     if (!WATCHED_EXTENSIONS.has(ext)) return;
     const parts = filePath.split("/");
     if (parts.some((part) => part.startsWith(".") && part !== ".")) return;
@@ -6301,7 +6774,7 @@ async function watch(watchPath, debounce = 3) {
   process.on("SIGINT", cleanup);
   process.on("SIGTERM", cleanup);
 }
-var isDirectExecution3 = typeof process !== "undefined" && typeof process.argv[1] === "string" && /^watch\.(?:js|mjs|cjs|ts)$/.test(basename5(process.argv[1]));
+var isDirectExecution3 = typeof process !== "undefined" && typeof process.argv[1] === "string" && /^watch\.(?:js|mjs|cjs|ts)$/.test(basename6(process.argv[1]));
 if (isDirectExecution3) {
   const watchPath = process.argv[2] ?? ".";
   const debounce = process.argv[3] ? parseFloat(process.argv[3]) : 3;
@@ -6313,8 +6786,10 @@ if (isDirectExecution3) {
 export {
   FileType,
   assertValid,
+  augmentDetectionWithTranscripts,
   build,
   buildFromJson,
+  buildWhisperPrompt,
   checkSemanticCache,
   classifyFile,
   cluster,
@@ -6322,6 +6797,7 @@ export {
   collectFiles,
   detect,
   detectIncremental,
+  downloadAudio,
   extract,
   fileHash,
   generate as generateReport,
@@ -6351,6 +6827,8 @@ export {
   toJson,
   toSvg,
   toWiki,
+  transcribe,
+  transcribeAll,
   validateExtraction,
   validateGraphPath,
   validateUrl,