graphifyy 0.3.17 → 0.3.28

package/dist/index.cjs

@@ -29,6 +29,21 @@ var __toESM = (mod, isNodeMode, target) => (target = mod != null ? __create(__ge
 ));
 var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
 
+// 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)) {
@@ -118,13 +133,81 @@ var init_validate = __esm({
   }
 });
 
+// src/graph.ts
+function createGraph(directed = false) {
+  return new import_graphology.default({ 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 import_graphology;
+var init_graph = __esm({
+  "src/graph.ts"() {
+    import_graphology = __toESM(require("graphology"), 1);
+  }
+});
+
 // src/build.ts
 var build_exports = {};
 __export(build_exports, {
   build: () => build,
   buildFromJson: () => buildFromJson
 });
-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) {
@@ -132,7 +215,7 @@ function buildFromJson(extraction) {
       `[graphify] Extraction warning (${realErrors.length} issues): ${realErrors[0]}`
     );
   }
-  const G = new import_graphology.default({ type: "undirected", multi: false });
+  const G = createGraph(options?.directed === true);
   for (const node of extraction.nodes ?? []) {
     const { id, ...attrs } = node;
     G.mergeNode(id, attrs);
@@ -154,7 +237,7 @@ function buildFromJson(extraction) {
   }
   return G;
 }
-function build(extractions) {
+function build(extractions, options) {
   const combined = {
     nodes: [],
     edges: [],
@@ -169,12 +252,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 import_graphology;
 var init_build = __esm({
   "src/build.ts"() {
-    import_graphology = __toESM(require("graphology"), 1);
+    init_graph();
     init_validate();
   }
 });
@@ -214,7 +296,7 @@ __export(cluster_exports, {
   scoreAll: () => scoreAll
 });
 function partition(G) {
-  const result = (0, import_graphology_communities_louvain.default)(G);
+  const result = (0, import_graphology_communities_louvain.default)(G.type === "directed" ? toUndirectedGraph(G) : G);
   const map = /* @__PURE__ */ new Map();
   for (const [node, cid] of Object.entries(result)) {
     map.set(node, cid);
@@ -321,11 +403,370 @@ var init_cluster = __esm({
   "src/cluster.ts"() {
     import_graphology_communities_louvain = __toESM(require("graphology-communities-louvain"), 1);
     init_collections();
+    init_graph();
     MAX_COMMUNITY_FRACTION = 0.25;
     MIN_SPLIT_SIZE = 10;
   }
 });
 
+// src/detect.ts
+function isSensitive(filePath) {
+  const name = (0, import_node_path.basename)(filePath);
+  return SENSITIVE_PATTERNS.some((p) => p.test(name) || p.test(filePath));
+}
+function looksLikePaper(filePath) {
+  try {
+    const text = (0, import_node_fs.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 = (0, import_node_path.extname)(filePath).toLowerCase();
+  if (CODE_EXTENSIONS.has(ext)) return "code" /* CODE */;
+  if (PAPER_EXTENSIONS.has(ext)) {
+    const parts = filePath.split(import_node_path.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 = (0, import_node_fs.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 = (0, import_node_path.resolve)(root);
+  while (true) {
+    const ignoreFile = (0, import_node_path.join)(current, ".graphifyignore");
+    if ((0, import_node_fs.existsSync)(ignoreFile)) {
+      for (let line of (0, import_node_fs.readFileSync)(ignoreFile, "utf-8").split("\n")) {
+        line = line.trim();
+        if (line && !line.startsWith("#")) {
+          patterns.push(line);
+        }
+      }
+    }
+    if ((0, import_node_fs.existsSync)((0, import_node_path.join)(current, ".git"))) {
+      break;
+    }
+    const parent = (0, import_node_path.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 = (0, import_node_path.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((0, import_node_path.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 = (0, import_node_fs.readdirSync)(dir);
+  } catch {
+    return result;
+  }
+  for (const entry of entries) {
+    const full = (0, import_node_path.join)(dir, entry);
+    let stat;
+    try {
+      stat = followSymlinks ? (0, import_node_fs.statSync)(full) : (0, import_node_fs.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 = (0, import_node_path.resolve)(root);
+  const ignorePatterns = loadGraphifyignore(rootResolved);
+  const convertedDir = (0, import_node_path.join)(rootResolved, "graphify-out", "converted");
+  const memoryDir = (0, import_node_path.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 ((0, import_node_fs.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 = (0, import_node_fs.existsSync)(memoryDir) && p.startsWith(memoryDir);
+    if (!inMemory) {
+      if ((0, import_node_path.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((0, import_node_path.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((0, import_node_fs.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] = (0, import_node_fs.statSync)(f).mtimeMs;
+      } catch {
+      }
+    }
+  }
+  const dir = (0, import_node_path.join)(manifestPath, "..");
+  (0, import_node_fs.mkdirSync)(dir, { recursive: true });
+  (0, import_node_fs.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 = (0, import_node_fs.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 import_node_fs, import_node_path, import_node_crypto, 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"() {
+    import_node_fs = require("fs");
+    import_node_path = require("path");
+    import_node_crypto = require("crypto");
+    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, {
@@ -366,10 +807,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) {
@@ -563,10 +1005,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({
@@ -695,31 +1137,14 @@ function graphDiff(GOld, GNew) {
     summary: parts.length > 0 ? parts.join(", ") : "no changes"
   };
 }
-var import_betweenness, CODE_EXTENSIONS, PAPER_EXTENSIONS, IMAGE_EXTENSIONS;
+var import_betweenness;
 var init_analyze = __esm({
   "src/analyze.ts"() {
     import_betweenness = __toESM(require("graphology-metrics/centrality/betweenness.js"), 1);
     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();
   }
 });
 
@@ -983,19 +1408,19 @@ async function safeFetchText(url, maxBytes = MAX_TEXT_BYTES, timeout = 15e3) {
   return raw.toString("utf-8");
 }
 function validateGraphPath(filePath, base) {
-  const resolvedBase = (0, import_node_path.resolve)(base ?? "graphify-out");
-  if (!(0, import_node_fs.existsSync)(resolvedBase)) {
+  const resolvedBase = (0, import_node_path2.resolve)(base ?? "graphify-out");
+  if (!(0, import_node_fs2.existsSync)(resolvedBase)) {
     throw new Error(
       `Graph base directory does not exist: ${resolvedBase}. Run the graphify skill first to build the graph (for Codex: $graphify .).`
     );
   }
-  const resolved = (0, import_node_path.resolve)(filePath);
+  const resolved = (0, import_node_path2.resolve)(filePath);
   if (!resolved.startsWith(resolvedBase + "/") && resolved !== resolvedBase) {
     throw new Error(
       `Path '${filePath}' escapes the allowed directory ${resolvedBase}. Only paths inside graphify-out/ are permitted.`
     );
   }
-  if (!(0, import_node_fs.existsSync)(resolved)) {
+  if (!(0, import_node_fs2.existsSync)(resolved)) {
     throw new Error(`Graph file not found: ${resolved}`);
   }
   return resolved;
@@ -1010,11 +1435,11 @@ function sanitizeLabel(text) {
 function escapeHtml(text) {
   return text.replace(/&/g, "&amp;").replace(/</g, "&lt;").replace(/>/g, "&gt;").replace(/"/g, "&quot;").replace(/'/g, "&#39;");
 }
-var import_node_path, import_node_fs, import_node_url, dns, net, ALLOWED_SCHEMES, MAX_FETCH_BYTES, MAX_TEXT_BYTES, BLOCKED_HOSTS, CONTROL_CHAR_RE, MAX_LABEL_LEN;
+var import_node_path2, import_node_fs2, import_node_url, dns, net, ALLOWED_SCHEMES, MAX_FETCH_BYTES, MAX_TEXT_BYTES, BLOCKED_HOSTS, CONTROL_CHAR_RE, MAX_LABEL_LEN;
 var init_security = __esm({
   "src/security.ts"() {
-    import_node_path = require("path");
-    import_node_fs = require("fs");
+    import_node_path2 = require("path");
+    import_node_fs2 = require("fs");
     import_node_url = require("url");
     dns = __toESM(require("dns/promises"), 1);
     net = __toESM(require("net"), 1);
@@ -1065,14 +1490,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 = [];
@@ -1089,15 +1517,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
   };
-  (0, import_node_fs2.writeFileSync)(outputPath, JSON.stringify(output, null, 2), "utf-8");
+  (0, import_node_fs3.writeFileSync)(outputPath, JSON.stringify(output, null, 2), "utf-8");
 }
 function toCypher(G, outputPath) {
   const lines = ["// Neo4j Cypher import - generated by the graphify skill", ""];
@@ -1119,7 +1552,7 @@ function toCypher(G, outputPath) {
       `MATCH (a {id: '${uEsc}'}), (b {id: '${vEsc}'}) MERGE (a)-[:${rel} {confidence: '${conf}'}]->(b);`
     );
   });
-  (0, import_node_fs2.writeFileSync)(outputPath, lines.join("\n"), "utf-8");
+  (0, import_node_fs3.writeFileSync)(outputPath, lines.join("\n"), "utf-8");
 }
 function neo4jLabel(label) {
   const sanitized = label.replace(/[^A-Za-z0-9_]/g, "");
@@ -1358,9 +1791,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');
@@ -1515,7 +1963,7 @@ ${htmlScript(nodesJson, edgesJson, legendJson)}
 ${hyperedgeScript(hyperedgesJson)}
 </body>
 </html>`;
-  (0, import_node_fs2.writeFileSync)(outputPath, html, "utf-8");
+  (0, import_node_fs3.writeFileSync)(outputPath, html, "utf-8");
 }
 function toGraphml(G, communities, outputPath) {
   const nodeComm = nodeCommunityMap2(communities);
@@ -1531,7 +1979,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>`);
@@ -1548,7 +1996,7 @@ function toGraphml(G, communities, outputPath) {
   });
   lines.push("  </graph>");
   lines.push("</graphml>");
-  (0, import_node_fs2.writeFileSync)(outputPath, lines.join("\n"), "utf-8");
+  (0, import_node_fs3.writeFileSync)(outputPath, lines.join("\n"), "utf-8");
 }
 function toSvg(G, communities, outputPath, communityLabelsOrOptions, figsize = [20, 14]) {
   const communityMap = toNumericMap(communities);
@@ -1621,7 +2069,7 @@ function toSvg(G, communities, outputPath, communityLabelsOrOptions, figsize = [
     }
   }
   svgParts.push("</svg>");
-  (0, import_node_fs2.writeFileSync)(outputPath, svgParts.join("\n"), "utf-8");
+  (0, import_node_fs3.writeFileSync)(outputPath, svgParts.join("\n"), "utf-8");
 }
 function toCanvas(G, communities, outputPath, communityLabelsOrOptions, nodeFilenames) {
   const communityMap = toNumericMap(communities);
@@ -1630,7 +2078,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) {
@@ -1709,13 +2157,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,
@@ -1765,13 +2213,14 @@ function toCanvas(G, communities, outputPath, communityLabelsOrOptions, nodeFile
     });
   }
   const canvasData = { nodes: canvasNodes, edges: canvasEdges };
-  (0, import_node_fs2.writeFileSync)(outputPath, JSON.stringify(canvasData, null, 2), "utf-8");
+  (0, import_node_fs3.writeFileSync)(outputPath, JSON.stringify(canvasData, null, 2), "utf-8");
 }
-var import_node_fs2, COMMUNITY_COLORS, MAX_NODES_FOR_VIZ, CONFIDENCE_SCORE_DEFAULTS;
+var import_node_fs3, COMMUNITY_COLORS, MAX_NODES_FOR_VIZ, CONFIDENCE_SCORE_DEFAULTS;
 var init_export = __esm({
   "src/export.ts"() {
-    import_node_fs2 = require("fs");
+    import_node_fs3 = require("fs");
     init_security();
+    init_graph();
     init_collections();
     COMMUNITY_COLORS = [
       "#4E79A7",
@@ -1795,8 +2244,20 @@ var init_export = __esm({
 });
 
 // src/cache.ts
+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 = (0, import_node_fs5.readFileSync)(filePath);
+  const raw = (0, import_node_fs5.readFileSync)(filePath);
+  const content = (0, import_node_path4.extname)(filePath).toLowerCase() === ".md" ? bodyContent(raw) : raw;
   const resolved = (0, import_node_path4.resolve)(filePath);
   const h = (0, import_node_crypto2.createHash)("sha256");
   h.update(content);
@@ -2744,10 +3205,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
             });
           }
         }
@@ -3270,10 +3731,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
             });
           }
         }
@@ -3425,10 +3886,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
             });
           }
         }
@@ -3587,7 +4048,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);
           }
         }
       }
@@ -3770,7 +4231,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);
             }
           }
         }
@@ -3976,7 +4437,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);
                 }
               }
             }
@@ -4167,7 +4628,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);
         }
       }
     }
@@ -4696,8 +5157,10 @@ var src_exports = {};
 __export(src_exports, {
   FileType: () => FileType,
   assertValid: () => assertValid,
+  augmentDetectionWithTranscripts: () => augmentDetectionWithTranscripts,
   build: () => build,
   buildFromJson: () => buildFromJson,
+  buildWhisperPrompt: () => buildWhisperPrompt,
   checkSemanticCache: () => checkSemanticCache,
   classifyFile: () => classifyFile,
   cluster: () => cluster,
@@ -4705,6 +5168,7 @@ __export(src_exports, {
   collectFiles: () => collectFiles,
   detect: () => detect,
   detectIncremental: () => detectIncremental,
+  downloadAudio: () => downloadAudio,
   extract: () => extract,
   fileHash: () => fileHash,
   generateReport: () => generate,
@@ -4734,23 +5198,15 @@ __export(src_exports, {
   toJson: () => toJson,
   toSvg: () => toSvg,
   toWiki: () => toWiki,
+  transcribe: () => transcribe,
+  transcribeAll: () => transcribeAll,
   validateExtraction: () => validateExtraction,
   validateGraphPath: () => validateGraphPath,
   validateUrl: () => validateUrl,
   watch: () => watch
 });
 module.exports = __toCommonJS(src_exports);
-
-// 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();
@@ -4759,23 +5215,24 @@ init_report();
 init_export();
 
 // src/wiki.ts
-var import_node_fs3 = require("fs");
-var import_node_path2 = require("path");
+var import_node_fs4 = require("fs");
+var import_node_path3 = require("path");
 init_collections();
+init_graph();
 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]);
 }
@@ -4839,15 +5296,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";
@@ -4860,408 +5317,85 @@ function godNodeArticle(G, nid, labels) {
   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);
-  (0, import_node_fs3.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));
-    (0, import_node_fs3.writeFileSync)((0, import_node_path2.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);
-      (0, import_node_fs3.writeFileSync)((0, import_node_path2.join)(outputDir, `${safeFilename(nodeData.label)}.md`), article);
-      count++;
-    }
-  }
-  (0, import_node_fs3.writeFileSync)(
-    (0, import_node_path2.join)(outputDir, "index.md"),
-    indexMd(communityMap, labels, godNodesData, G.order, G.size)
-  );
-  return count;
-}
-
-// src/detect.ts
-var import_node_fs4 = require("fs");
-var import_node_path3 = require("path");
-var import_node_crypto = require("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 = (0, import_node_path3.basename)(filePath);
-  return SENSITIVE_PATTERNS.some((p) => p.test(name) || p.test(filePath));
-}
-function looksLikePaper(filePath) {
-  try {
-    const text = (0, import_node_fs4.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 = (0, import_node_path3.extname)(filePath).toLowerCase();
-  if (CODE_EXTENSIONS2.has(ext)) return "code" /* CODE */;
-  if (PAPER_EXTENSIONS2.has(ext)) {
-    const parts = filePath.split(import_node_path3.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 = (0, import_node_fs4.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 = (0, import_node_path3.join)(root, ".graphifyignore");
-  if (!(0, import_node_fs4.existsSync)(ignoreFile)) return [];
-  const patterns = [];
-  for (let line of (0, import_node_fs4.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 = (0, import_node_path3.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((0, import_node_path3.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 = (0, import_node_fs4.readdirSync)(dir);
-  } catch {
-    return result;
-  }
-  for (const entry of entries) {
-    const full = (0, import_node_path3.join)(dir, entry);
-    let stat;
-    try {
-      stat = followSymlinks ? (0, import_node_fs4.statSync)(full) : (0, import_node_fs4.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 = (0, import_node_path3.resolve)(root);
-  const ignorePatterns = loadGraphifyignore(rootResolved);
-  const convertedDir = (0, import_node_path3.join)(rootResolved, "graphify-out", "converted");
-  const memoryDir = (0, import_node_path3.join)(rootResolved, "graphify-out", "memory");
-  const files = {
-    code: [],
-    document: [],
-    paper: [],
-    image: []
-  };
-  let totalWords = 0;
-  const skippedSensitive = [];
-  const allFiles = walkDir(rootResolved, rootResolved, ignorePatterns, followSymlinks, false);
-  if ((0, import_node_fs4.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 = (0, import_node_fs4.existsSync)(memoryDir) && p.startsWith(memoryDir);
-    if (!inMemory) {
-      if ((0, import_node_path3.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((0, import_node_path3.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.`;
+    for (const t of targets.slice(0, 20)) {
+      lines.push(`- ${t}`);
+    }
+    lines.push("");
   }
-  return {
-    files,
-    total_files: totalFiles,
-    total_words: totalWords,
-    needs_graph: needsGraph,
-    warning,
-    skipped_sensitive: skippedSensitive,
-    graphifyignore_patterns: ignorePatterns.length
-  };
+  lines.push("---", "", "*Part of the graphify knowledge wiki. See [[index]] to navigate.*");
+  return lines.join("\n");
 }
-function loadManifest(manifestPath = MANIFEST_PATH) {
-  try {
-    return JSON.parse((0, import_node_fs4.readFileSync)(manifestPath, "utf-8"));
-  } catch {
-    return {};
+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`);
   }
-}
-function saveManifest(files, manifestPath = MANIFEST_PATH) {
-  const manifest = {};
-  for (const fileList of Object.values(files)) {
-    for (const f of fileList) {
-      try {
-        manifest[f] = (0, import_node_fs4.statSync)(f).mtimeMs;
-      } catch {
-      }
+  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 = (0, import_node_path3.join)(manifestPath, "..");
-  (0, import_node_fs4.mkdirSync)(dir, { recursive: true });
-  (0, import_node_fs4.writeFileSync)(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);
+  (0, import_node_fs4.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));
+    (0, import_node_fs4.writeFileSync)((0, import_node_path3.join)(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 = (0, import_node_fs4.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);
+      (0, import_node_fs4.writeFileSync)((0, import_node_path3.join)(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
-  };
+  (0, import_node_fs4.writeFileSync)(
+    (0, import_node_path3.join)(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
 var import_node_fs7 = require("fs");
-var import_graphology2 = __toESM(require("graphology"), 1);
+init_graph();
 var CHARS_PER_TOKEN = 4;
 function estimateTokens(text) {
   return Math.max(1, Math.floor(text.length / CHARS_PER_TOKEN));
@@ -5283,7 +5417,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]);
@@ -5318,21 +5452,7 @@ var SAMPLE_QUESTIONS = [
 ];
 function loadGraph(graphPath) {
   const raw = JSON.parse((0, import_node_fs7.readFileSync)(graphPath, "utf-8"));
-  const G = new import_graphology2.default({ 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 ?? {};
@@ -5395,9 +5515,395 @@ graphify token reduction benchmark`);
 }
 
 // src/ingest.ts
+var import_node_fs9 = require("fs");
+var import_node_path7 = require("path");
+init_security();
+
+// src/transcribe.ts
+var childProcess = __toESM(require("child_process"), 1);
+var import_node_crypto3 = require("crypto");
 var import_node_fs8 = require("fs");
+var import_node_os = require("os");
 var import_node_path6 = require("path");
-init_security();
+var import_node_stream = require("stream");
+var import_promises = require("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 (0, import_node_path6.resolve)(process.env.GRAPHIFY_WHISPER_CACHE_DIR);
+  }
+  if ((0, import_node_os.platform)() === "win32") {
+    return (0, import_node_path6.join)(
+      process.env.LOCALAPPDATA ?? (0, import_node_path6.join)((0, import_node_os.homedir)(), "AppData", "Local"),
+      "graphify",
+      "whisper"
+    );
+  }
+  return (0, import_node_path6.join)(process.env.XDG_CACHE_HOME ?? (0, import_node_path6.join)((0, import_node_os.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 (!(0, import_node_fs8.existsSync)(dir)) return [];
+  const files = [];
+  for (const entry of (0, import_node_fs8.readdirSync)(dir, { withFileTypes: true })) {
+    const fullPath = (0, import_node_path6.join)(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 (0, import_promises.pipeline)(import_node_stream.Readable.fromWeb(response.body), (0, import_node_fs8.createWriteStream)(destination));
+}
+async function ensureWhisperArtifacts(modelName) {
+  const { requested, resolved } = resolveRequestedModel(modelName);
+  const cacheRoot = defaultWhisperCacheDir();
+  (0, import_node_fs8.mkdirSync)(cacheRoot, { recursive: true });
+  const modelDir = (0, import_node_path6.join)(cacheRoot, `sherpa-onnx-whisper-${resolved}`);
+  const cached = findArtifactsIn(modelDir);
+  if (cached) {
+    return { requestedModel: requested, resolvedModel: resolved, ...cached };
+  }
+  const tempDir = (0, import_node_fs8.mkdtempSync)((0, import_node_path6.join)((0, import_node_os.tmpdir)(), "graphify-whisper-model-"));
+  const extractDir = (0, import_node_path6.join)(tempDir, "extract");
+  const archiveName = `sherpa-onnx-whisper-${resolved}.tar.bz2`;
+  const archivePath = (0, import_node_path6.join)(tempDir, archiveName);
+  (0, import_node_fs8.mkdirSync)(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) => (0, import_node_path6.dirname)(path)).find((path) => findArtifactsIn(path) !== null);
+    const sourceDir = extractedRoot ?? (0, import_node_fs8.readdirSync)(extractDir, { withFileTypes: true }).filter((entry) => entry.isDirectory()).map((entry) => (0, import_node_path6.join)(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 ((0, import_node_fs8.existsSync)(modelDir)) {
+      (0, import_node_fs8.rmSync)(modelDir, { recursive: true, force: true });
+    }
+    try {
+      (0, import_node_fs8.renameSync)(sourceDir, modelDir);
+    } catch {
+      (0, import_node_fs8.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 {
+    (0, import_node_fs8.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 = (0, import_node_path6.join)(workingDir, `${(0, import_node_path6.basename)(audioPath, (0, import_node_path6.extname)(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) {
+  (0, import_node_fs8.mkdirSync)(outputDir, { recursive: true });
+  const urlHash = (0, import_node_crypto3.createHash)("sha1").update(url).digest("hex").slice(0, 12);
+  for (const ext of CACHED_AUDIO_EXTENSIONS) {
+    const candidate = (0, import_node_path6.join)(outputDir, `yt_${urlHash}${ext}`);
+    if ((0, import_node_fs8.existsSync)(candidate)) {
+      console.log(`  cached audio: ${(0, import_node_path6.basename)(candidate)}`);
+      return candidate;
+    }
+  }
+  const outTemplate = (0, import_node_path6.join)(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 (0, import_node_fs8.readdirSync)(outputDir)) {
+    if (entry.startsWith(`yt_${urlHash}.`)) {
+      return (0, import_node_path6.join)(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 = (0, import_node_path6.resolve)(outputDir);
+  (0, import_node_fs8.mkdirSync)(outDir, { recursive: true });
+  const audioPath = isUrl(videoPath) ? downloadAudio(videoPath, (0, import_node_path6.join)(outDir, "downloads")) : (0, import_node_path6.resolve)(videoPath);
+  const transcriptPath = (0, import_node_path6.join)(outDir, `${(0, import_node_path6.basename)(audioPath, (0, import_node_path6.extname)(audioPath))}.txt`);
+  if ((0, import_node_fs8.existsSync)(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 = (0, import_node_fs8.mkdtempSync)((0, import_node_path6.join)((0, import_node_os.tmpdir)(), "graphify-transcribe-"));
+  try {
+    console.log(`  transcribing ${(0, import_node_path6.basename)(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);
+    (0, import_node_fs8.writeFileSync)(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 {
+    (0, import_node_fs8.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, " ");
 }
@@ -5563,9 +6069,9 @@ Source: ${url}
 }
 async function downloadBinary(url, suffix, targetDir) {
   const filename = safeFilename2(url, suffix);
-  const outPath = (0, import_node_path6.resolve)(targetDir, filename);
+  const outPath = (0, import_node_path7.resolve)(targetDir, filename);
   const data = await safeFetch(url);
-  (0, import_node_fs8.writeFileSync)(outPath, data);
+  (0, import_node_fs9.writeFileSync)(outPath, data);
   return outPath;
 }
 function normalizeIngestOptions(authorOrOptions, contributor) {
@@ -5581,7 +6087,7 @@ function normalizeIngestOptions(authorOrOptions, contributor) {
   };
 }
 async function ingest(url, targetDir, authorOrOptions = null, contributor = null) {
-  (0, import_node_fs8.mkdirSync)(targetDir, { recursive: true });
+  (0, import_node_fs9.mkdirSync)(targetDir, { recursive: true });
   const urlType = detectUrlType(url);
   const { author, contributor: normalizedContributor } = normalizeIngestOptions(
     authorOrOptions,
@@ -5592,7 +6098,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: ${(0, import_node_path6.basename)(out)}`);
+    console.log(`Downloaded PDF: ${(0, import_node_path7.basename)(out)}`);
     return out;
   }
   if (urlType === "image") {
@@ -5602,9 +6108,14 @@ async function ingest(url, targetDir, authorOrOptions = null, contributor = null
     } catch {
       throw new Error(`Invalid URL: ${url}`);
     }
-    const suffix = (0, import_node_path6.extname)(parsed.pathname) || ".jpg";
+    const suffix = (0, import_node_path7.extname)(parsed.pathname) || ".jpg";
     const out = await downloadBinary(url, suffix, targetDir);
-    console.log(`Downloaded image: ${(0, import_node_path6.basename)(out)}`);
+    console.log(`Downloaded image: ${(0, import_node_path7.basename)(out)}`);
+    return out;
+  }
+  if (urlType === "youtube") {
+    const out = downloadAudio(url, targetDir);
+    console.log(`Downloaded audio: ${(0, import_node_path7.basename)(out)}`);
     return out;
   }
   if (urlType === "tweet") {
@@ -5614,15 +6125,15 @@ async function ingest(url, targetDir, authorOrOptions = null, contributor = null
   } else {
     [content, filename] = await fetchWebpage(url, author, normalizedContributor);
   }
-  let outPath = (0, import_node_path6.resolve)(targetDir, filename);
+  let outPath = (0, import_node_path7.resolve)(targetDir, filename);
   let counter = 1;
-  while ((0, import_node_fs8.existsSync)(outPath)) {
+  while ((0, import_node_fs9.existsSync)(outPath)) {
     const stem = filename.replace(/\.md$/, "");
-    outPath = (0, import_node_path6.resolve)(targetDir, `${stem}_${counter}.md`);
+    outPath = (0, import_node_path7.resolve)(targetDir, `${stem}_${counter}.md`);
     counter++;
   }
-  (0, import_node_fs8.writeFileSync)(outPath, content, "utf-8");
-  console.log(`Saved ${urlType}: ${(0, import_node_path6.basename)(outPath)}`);
+  (0, import_node_fs9.writeFileSync)(outPath, content, "utf-8");
+  console.log(`Saved ${urlType}: ${(0, import_node_path7.basename)(outPath)}`);
   return outPath;
 }
 function saveQueryResult(questionOrOptions, answer, memoryDir, queryType = "query", sourceNodes = null) {
@@ -5642,7 +6153,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 ?? "";
-  (0, import_node_fs8.mkdirSync)(payload.memoryDir, { recursive: true });
+  (0, import_node_fs9.mkdirSync)(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);
@@ -5674,11 +6185,11 @@ function saveQueryResult(questionOrOptions, answer, memoryDir, queryType = "quer
     }
   }
   const content = [...frontmatterLines, ...bodyLines].join("\n");
-  const outPath = (0, import_node_path6.resolve)(payload.memoryDir, filename);
-  (0, import_node_fs8.writeFileSync)(outPath, content, "utf-8");
+  const outPath = (0, import_node_path7.resolve)(payload.memoryDir, filename);
+  (0, import_node_fs9.writeFileSync)(outPath, content, "utf-8");
   return outPath;
 }
-var isDirectExecution = typeof process !== "undefined" && typeof process.argv[1] === "string" && /^ingest\.(?:js|mjs|cjs|ts)$/.test((0, import_node_path6.basename)(process.argv[1]));
+var isDirectExecution = typeof process !== "undefined" && typeof process.argv[1] === "string" && /^ingest\.(?:js|mjs|cjs|ts)$/.test((0, import_node_path7.basename)(process.argv[1]));
 if (isDirectExecution) {
   const url = process.argv[2];
   const targetDir = process.argv[3] ?? "./raw";
@@ -5694,44 +6205,30 @@ if (isDirectExecution) {
 }
 
 // src/serve.ts
-var import_node_fs9 = require("fs");
-var import_graphology3 = __toESM(require("graphology"), 1);
+var import_node_fs10 = require("fs");
 var import_unweighted = require("graphology-shortest-path/unweighted.js");
-var import_node_path7 = require("path");
+var import_node_path8 = require("path");
+init_graph();
 init_security();
 init_analyze();
 function loadGraph2(graphPath) {
   let safePath;
   try {
-    safePath = validateGraphPath(graphPath);
+    safePath = validateGraphPath(graphPath, (0, import_node_path8.dirname)((0, import_node_path8.resolve)(graphPath)));
   } catch (err) {
     console.error(`error: ${err instanceof Error ? err.message : err}`);
     process.exit(1);
   }
   let data;
   try {
-    data = JSON.parse((0, import_node_fs9.readFileSync)(safePath, "utf-8"));
+    data = JSON.parse((0, import_node_fs10.readFileSync)(safePath, "utf-8"));
   } catch (err) {
     console.error(
       `error: graph.json is corrupted (${err instanceof Error ? err.message : err}). Re-run the graphify skill to rebuild it (for Codex: $graphify .).`
     );
     process.exit(1);
   }
-  const G = new import_graphology3.default({ 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();
@@ -5744,6 +6241,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) => {
@@ -5762,7 +6268,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]);
@@ -5782,7 +6288,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]);
@@ -5861,7 +6367,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");
 }
@@ -5872,7 +6378,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);
@@ -5888,7 +6394,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 ?? ""}]`);
@@ -6110,8 +6617,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;
@@ -6119,14 +6631,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);
@@ -6134,7 +6646,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((0, import_node_path7.basename)(process.argv[1]));
+var isDirectExecution2 = typeof process !== "undefined" && typeof process.argv[1] === "string" && /^serve\.(?:js|mjs|cjs|ts)$/.test((0, import_node_path8.basename)(process.argv[1]));
 if (isDirectExecution2) {
   const graphPath = process.argv[2] ?? "graphify-out/graph.json";
   serve(graphPath).catch((err) => {
@@ -6144,59 +6656,14 @@ if (isDirectExecution2) {
 }
 
 // src/watch.ts
-var import_node_fs10 = require("fs");
-var import_node_path8 = require("path");
+var import_node_fs11 = require("fs");
+var import_node_path9 = require("path");
+init_detect();
 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 {
@@ -6248,8 +6715,8 @@ async function rebuildCode(watchPath, followSymlinks = false) {
       labels.set(cid, `Community ${cid}`);
     }
     const questions = suggestQuestions2(G, communities, labels);
-    const outDir = (0, import_node_path8.resolve)(watchPath, "graphify-out");
-    (0, import_node_fs10.mkdirSync)(outDir, { recursive: true });
+    const outDir = (0, import_node_path9.resolve)(watchPath, "graphify-out");
+    (0, import_node_fs11.mkdirSync)(outDir, { recursive: true });
     const report = generate2(
       G,
       communities,
@@ -6262,11 +6729,11 @@ async function rebuildCode(watchPath, followSymlinks = false) {
       watchPath,
       questions
     );
-    (0, import_node_fs10.writeFileSync)((0, import_node_path8.resolve)(outDir, "GRAPH_REPORT.md"), report, "utf-8");
-    toJson2(G, communities, (0, import_node_path8.resolve)(outDir, "graph.json"));
-    const flagPath = (0, import_node_path8.resolve)(outDir, "needs_update");
-    if ((0, import_node_fs10.existsSync)(flagPath)) {
-      (0, import_node_fs10.unlinkSync)(flagPath);
+    (0, import_node_fs11.writeFileSync)((0, import_node_path9.resolve)(outDir, "GRAPH_REPORT.md"), report, "utf-8");
+    toJson2(G, communities, (0, import_node_path9.resolve)(outDir, "graph.json"), { communityLabels: labels });
+    const flagPath = (0, import_node_path9.resolve)(outDir, "needs_update");
+    if ((0, import_node_fs11.existsSync)(flagPath)) {
+      (0, import_node_fs11.unlinkSync)(flagPath);
     }
     console.log(
       `[graphify watch] Rebuilt: ${G.order} nodes, ${G.size} edges, ${communities.size} communities`
@@ -6283,10 +6750,10 @@ async function rebuildCode(watchPath, followSymlinks = false) {
   }
 }
 function notifyOnly(watchPath) {
-  const outDir = (0, import_node_path8.resolve)(watchPath, "graphify-out");
-  (0, import_node_fs10.mkdirSync)(outDir, { recursive: true });
-  const flagPath = (0, import_node_path8.resolve)(outDir, "needs_update");
-  (0, import_node_fs10.writeFileSync)(flagPath, "1", "utf-8");
+  const outDir = (0, import_node_path9.resolve)(watchPath, "graphify-out");
+  (0, import_node_fs11.mkdirSync)(outDir, { recursive: true });
+  const flagPath = (0, import_node_path9.resolve)(outDir, "needs_update");
+  (0, import_node_fs11.writeFileSync)(flagPath, "1", "utf-8");
   console.log(`
 [graphify watch] New or changed files detected in ${watchPath}`);
   console.log(
@@ -6298,7 +6765,7 @@ function notifyOnly(watchPath) {
   console.log(`[graphify watch] Flag written to ${flagPath}`);
 }
 function hasNonCode(changedPaths) {
-  return changedPaths.some((p) => !CODE_EXTENSIONS3.has((0, import_node_path8.extname)(p).toLowerCase()));
+  return changedPaths.some((p) => !CODE_EXTENSIONS.has((0, import_node_path9.extname)(p).toLowerCase()));
 }
 async function watch(watchPath, debounce = 3) {
   let chokidar;
@@ -6307,7 +6774,7 @@ async function watch(watchPath, debounce = 3) {
   } catch {
     throw new Error("chokidar not installed. Run: npm install chokidar");
   }
-  const resolvedPath = (0, import_node_path8.resolve)(watchPath);
+  const resolvedPath = (0, import_node_path9.resolve)(watchPath);
   let lastTrigger = 0;
   let pending = false;
   const changed = /* @__PURE__ */ new Set();
@@ -6322,7 +6789,7 @@ async function watch(watchPath, debounce = 3) {
     ]
   });
   watcher.on("all", (_event, filePath) => {
-    const ext = (0, import_node_path8.extname)(filePath).toLowerCase();
+    const ext = (0, import_node_path9.extname)(filePath).toLowerCase();
     if (!WATCHED_EXTENSIONS.has(ext)) return;
     const parts = filePath.split("/");
     if (parts.some((part) => part.startsWith(".") && part !== ".")) return;
@@ -6361,7 +6828,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((0, import_node_path8.basename)(process.argv[1]));
+var isDirectExecution3 = typeof process !== "undefined" && typeof process.argv[1] === "string" && /^watch\.(?:js|mjs|cjs|ts)$/.test((0, import_node_path9.basename)(process.argv[1]));
 if (isDirectExecution3) {
   const watchPath = process.argv[2] ?? ".";
   const debounce = process.argv[3] ? parseFloat(process.argv[3]) : 3;
@@ -6374,8 +6841,10 @@ if (isDirectExecution3) {
 0 && (module.exports = {
   FileType,
   assertValid,
+  augmentDetectionWithTranscripts,
   build,
   buildFromJson,
+  buildWhisperPrompt,
   checkSemanticCache,
   classifyFile,
   cluster,
@@ -6383,6 +6852,7 @@ if (isDirectExecution3) {
   collectFiles,
   detect,
   detectIncremental,
+  downloadAudio,
   extract,
   fileHash,
   generateReport,
@@ -6412,6 +6882,8 @@ if (isDirectExecution3) {
   toJson,
   toSvg,
   toWiki,
+  transcribe,
+  transcribeAll,
   validateExtraction,
   validateGraphPath,
   validateUrl,