diffwiki-core 0.5.0-rc.202607230329.fb70592 → 0.5.0

package/dist/index.cjs

@@ -40,7 +40,7 @@ var init_types = __esm({
 });
 
 // src/errors.ts
-var DiffwikiError, CollectionExistsError, CollectionNotFoundError, NoDefaultCollectionError, ArticleNotFoundError, InvalidTargetError, PluginError, WorktreeNotAllowedError, CollectionAlreadyAddedError;
+var DiffwikiError, CollectionExistsError, CollectionNotFoundError, NoDefaultCollectionError, ArticleNotFoundError, InvalidTargetError, PluginError;
 var init_errors = __esm({
   "src/errors.ts"() {
     "use strict";
@@ -77,16 +77,6 @@ var init_errors = __esm({
     };
     PluginError = class extends DiffwikiError {
     };
-    WorktreeNotAllowedError = class extends DiffwikiError {
-      constructor(root) {
-        super(`refusing to add a linked worktree \u2014 add the source repository instead (${root})`);
-      }
-    };
-    CollectionAlreadyAddedError = class extends DiffwikiError {
-      constructor(name) {
-        super(`this repository is already added as collection "${name}"`);
-      }
-    };
   }
 });
 
@@ -514,9 +504,6 @@ async function listCollections() {
 async function findCollection(name) {
   return (await readRegistry()).collections.find((c) => c.name === name);
 }
-async function findCollectionById(id) {
-  return (await readRegistry()).collections.find((c) => c.id === id);
-}
 async function createCollection(name) {
   if (await findCollection(name)) throw new CollectionExistsError(name);
   const dir = collectionDir(name);
@@ -556,7 +543,6 @@ var init_collections = __esm({
 var index_exports = {};
 __export(index_exports, {
   ArticleNotFoundError: () => ArticleNotFoundError,
-  CollectionAlreadyAddedError: () => CollectionAlreadyAddedError,
   CollectionExistsError: () => CollectionExistsError,
   CollectionNotFoundError: () => CollectionNotFoundError,
   DiffwikiError: () => DiffwikiError,
@@ -565,35 +551,24 @@ __export(index_exports, {
   NoDefaultCollectionError: () => NoDefaultCollectionError,
   PluginError: () => PluginError,
   REPO_CONFIG_FILE: () => REPO_CONFIG_FILE,
-  WorktreeNotAllowedError: () => WorktreeNotAllowedError,
-  addExternalCollection: () => addExternalCollection,
   addTags: () => addTags,
   buildArticleTree: () => buildArticleTree,
-  buildCollections: () => buildCollections,
-  buildNavTree: () => buildNavTree,
-  buildSearchIndex: () => buildSearchIndex,
   collectionDir: () => collectionDir,
-  collectionGitStatus: () => collectionGitStatus,
   collectionsDir: () => collectionsDir,
   configPath: () => configPath,
   createArticle: () => createArticle,
   createCollection: () => createCollection,
-  currentBranch: () => currentBranch,
   deregisterPlugin: () => deregisterPlugin,
   doctor: () => doctor,
   emitPluginEvent: () => emitPluginEvent,
-  ensureGitRepo: () => ensureGitRepo,
   ensurePluginRoot: () => ensurePluginRoot,
   findCollection: () => findCollection,
-  findCollectionById: () => findCollectionById,
   findEnabledPlugin: () => findEnabledPlugin,
   findPluginRecord: () => findPluginRecord,
   getConfigValue: () => getConfigValue,
   getLogger: () => getLogger,
-  gitToplevel: () => gitToplevel,
   initRepoWiki: () => initRepoWiki,
   installPlugin: () => installPlugin,
-  isLinkedWorktree: () => isLinkedWorktree,
   listArticleTree: () => listArticleTree,
   listAvailablePlugins: () => listAvailablePlugins,
   listCollections: () => listCollections,
@@ -608,7 +583,6 @@ __export(index_exports, {
   pluginsDir: () => pluginsDir,
   pluginsRegistryPath: () => pluginsRegistryPath,
   query: () => query,
-  rankDocs: () => rankDocs,
   readArticle: () => readArticle,
   readConfig: () => readConfig,
   readPluginRegistry: () => readPluginRegistry,
@@ -622,24 +596,17 @@ __export(index_exports, {
   removePlugin: () => removePlugin,
   removeTags: () => removeTags,
   renderArticle: () => renderArticle,
-  repoId: () => repoId,
-  repoRemoteName: () => repoRemoteName,
-  resolveCwdCollection: () => resolveCwdCollection,
   resolveDefaultSearchMode: () => resolveDefaultSearchMode,
   resolveHome: () => resolveHome,
   resolveLogLevel: () => resolveLogLevel,
-  resolvePage: () => resolvePage,
   search: () => search,
   serializeArticle: () => serializeArticle,
   setConfigValue: () => setConfigValue,
   setTags: () => setTags,
   slugify: () => slugify,
-  toTreeNodes: () => toTreeNodes,
-  tokenize: () => tokenize,
   unregisterCollection: () => unregisterCollection,
   updateArticleBody: () => updateArticleBody,
   upsertPlugin: () => upsertPlugin,
-  upstreamStatus: () => upstreamStatus,
   writeConfig: () => writeConfig,
   writePluginRegistry: () => writePluginRegistry,
   writeRegistry: () => writeRegistry
@@ -881,89 +848,29 @@ async function removeArticle(target) {
 
 // src/repo.ts
 var import_promises6 = __toESM(require("fs/promises"), 1);
-var import_node_path5 = __toESM(require("path"), 1);
-var import_node_child_process3 = require("child_process");
-var import_node_util2 = require("util");
-var import_yaml2 = require("yaml");
-init_collections();
-init_registry();
-
-// src/git.ts
 var import_node_path4 = __toESM(require("path"), 1);
 var import_node_child_process2 = require("child_process");
 var import_node_util = require("util");
+var import_yaml2 = require("yaml");
+init_collections();
+init_registry();
 var execFileAsync = (0, import_node_util.promisify)(import_node_child_process2.execFile);
-async function git(cwd, args) {
-  try {
-    const { stdout } = await execFileAsync("git", args, { cwd });
-    return stdout.trim();
-  } catch {
-    return void 0;
-  }
-}
-async function gitToplevel(cwd) {
-  return git(cwd, ["rev-parse", "--show-toplevel"]);
-}
-async function isLinkedWorktree(cwd) {
-  const gitDir = await git(cwd, ["rev-parse", "--absolute-git-dir"]);
-  const commonDir = await git(cwd, ["rev-parse", "--git-common-dir"]);
-  if (!gitDir || !commonDir) return false;
-  const commonAbs = import_node_path4.default.isAbsolute(commonDir) ? commonDir : import_node_path4.default.resolve(cwd, commonDir);
-  return import_node_path4.default.resolve(gitDir) !== import_node_path4.default.resolve(commonAbs);
-}
-async function repoRemoteName(cwd) {
-  const url = await git(cwd, ["remote", "get-url", "origin"]);
-  if (!url) return void 0;
-  const base = url.replace(/\/+$/, "").split(/[/:]/).pop() ?? "";
-  const name = base.replace(/\.git$/, "");
-  return name.length > 0 ? name : void 0;
-}
-async function repoId(cwd) {
-  const roots = await git(cwd, ["rev-list", "--max-parents=0", "HEAD"]);
-  if (roots) return `commit:${roots.split("\n")[0]}`;
-  const url = await git(cwd, ["remote", "get-url", "origin"]);
-  if (url) return `remote:${url.replace(/\.git$/, "").replace(/\/+$/, "")}`;
-  return void 0;
-}
-async function currentBranch(cwd) {
-  const name = await git(cwd, ["rev-parse", "--abbrev-ref", "HEAD"]);
-  return name && name !== "HEAD" ? name : void 0;
-}
-async function upstreamStatus(cwd) {
-  const branch = await currentBranch(cwd);
-  const counts = await git(cwd, ["rev-list", "--left-right", "--count", "@{upstream}...HEAD"]);
-  if (!counts) return { branch, ahead: 0, behind: 0, hasUpstream: false };
-  const [behind, ahead] = counts.split(/\s+/).map((n) => Number.parseInt(n, 10) || 0);
-  return { branch, ahead, behind, hasUpstream: true };
-}
-async function ensureGitRepo(cwd) {
-  const top = await gitToplevel(cwd);
-  if (top) return top;
-  await execFileAsync("git", ["init"], { cwd });
-  const after = await gitToplevel(cwd);
-  if (!after) throw new Error("git init did not produce a repository");
-  return after;
-}
-
-// src/repo.ts
-init_errors();
-var execFileAsync2 = (0, import_node_util2.promisify)(import_node_child_process3.execFile);
 var REPO_CONFIG_FILE = "diffwiki.yaml";
 async function detectRepoName(cwd) {
   try {
-    const { stdout } = await execFileAsync2("git", ["rev-parse", "--show-toplevel"], { cwd });
-    return import_node_path5.default.basename(stdout.trim());
+    const { stdout } = await execFileAsync("git", ["rev-parse", "--show-toplevel"], { cwd });
+    return import_node_path4.default.basename(stdout.trim());
   } catch {
-    return import_node_path5.default.basename(import_node_path5.default.resolve(cwd));
+    return import_node_path4.default.basename(import_node_path4.default.resolve(cwd));
   }
 }
 async function readRepoConfig(cwd) {
   try {
-    const raw = await import_promises6.default.readFile(import_node_path5.default.join(cwd, REPO_CONFIG_FILE), "utf8");
+    const raw = await import_promises6.default.readFile(import_node_path4.default.join(cwd, REPO_CONFIG_FILE), "utf8");
     const parsed = (0, import_yaml2.parse)(raw) ?? {};
     if (!parsed.path) return void 0;
     return {
-      collection: parsed.collection ?? import_node_path5.default.basename(import_node_path5.default.resolve(cwd)),
+      collection: parsed.collection ?? import_node_path4.default.basename(import_node_path4.default.resolve(cwd)),
       path: parsed.path
     };
   } catch (err) {
@@ -972,9 +879,9 @@ async function readRepoConfig(cwd) {
   }
 }
 async function initRepoWiki(opts) {
-  const cwd = import_node_path5.default.resolve(opts.cwd);
+  const cwd = import_node_path4.default.resolve(opts.cwd);
   const wikiPath = opts.wikiPath ?? "wiki";
-  const absWiki = import_node_path5.default.join(cwd, wikiPath);
+  const absWiki = import_node_path4.default.join(cwd, wikiPath);
   let name = opts.collection ?? await detectRepoName(cwd);
   const existing = await findCollection(name);
   if (existing && existing.path !== absWiki) {
@@ -991,7 +898,7 @@ async function initRepoWiki(opts) {
   }
   await import_promises6.default.mkdir(absWiki, { recursive: true });
   const config = { collection: name, path: wikiPath };
-  await import_promises6.default.writeFile(import_node_path5.default.join(cwd, REPO_CONFIG_FILE), (0, import_yaml2.stringify)(config), "utf8");
+  await import_promises6.default.writeFile(import_node_path4.default.join(cwd, REPO_CONFIG_FILE), (0, import_yaml2.stringify)(config), "utf8");
   const entry = {
     name,
     type: "repo",
@@ -1001,497 +908,152 @@ async function initRepoWiki(opts) {
   await registerCollection(entry);
   return entry;
 }
-async function addExternalCollection(opts) {
-  const cwd = import_node_path5.default.resolve(opts.cwd);
-  const root = await ensureGitRepo(cwd);
-  if (await isLinkedWorktree(cwd)) throw new WorktreeNotAllowedError(root);
-  const id = await repoId(root) ?? `path:${root}`;
-  const already = await findCollectionById(id);
-  if (already) throw new CollectionAlreadyAddedError(already.name);
-  const docsRel = opts.docsDir ?? "docs";
-  const contentDir = import_node_path5.default.join(root, docsRel);
-  let name = await repoRemoteName(root) ?? import_node_path5.default.basename(root);
-  if (await findCollection(name)) {
-    let n = 2;
-    while (await findCollection(`${name}-${n}`)) n += 1;
-    name = `${name}-${n}`;
-  }
-  const entry = {
-    name,
-    type: "external",
-    path: contentDir,
-    createdAt: (/* @__PURE__ */ new Date()).toISOString(),
-    id,
-    repoRoot: root,
-    docsDir: docsRel
-  };
-  await registerCollection(entry);
-  return entry;
-}
-async function resolveCwdCollection(cwd) {
-  const abs = import_node_path5.default.resolve(cwd);
-  const root = await gitToplevel(abs);
-  if (root) {
-    const id = await repoId(root) ?? `path:${root}`;
-    const byId = await findCollectionById(id);
-    if (byId) return byId;
-  }
-  const within = (base) => abs === base || abs.startsWith(base + import_node_path5.default.sep);
-  const all = await listCollections();
-  return all.find((c) => within(c.path) || c.repoRoot !== void 0 && within(c.repoRoot));
-}
-async function collectionGitStatus(entry) {
-  if (entry.type !== "external" || !entry.repoRoot) return void 0;
-  const top = await gitToplevel(entry.repoRoot);
-  if (!top) return void 0;
-  const s = await upstreamStatus(entry.repoRoot);
-  return { branch: s.branch, ahead: s.ahead, behind: s.behind, hasUpstream: s.hasUpstream };
-}
-
-// src/site.ts
-init_collections();
 
-// src/browse.ts
+// src/query.ts
 var import_promises7 = __toESM(require("fs/promises"), 1);
-var import_node_path6 = __toESM(require("path"), 1);
+var import_node_path5 = __toESM(require("path"), 1);
 init_collections();
 init_errors();
-var INDEX_RE = /^(index|readme)\.mdx?$/i;
-function buildArticleTree(relPaths) {
-  const root = {};
-  for (const raw of relPaths) {
-    const rel = raw.replace(/\\/g, "/").replace(/^\/+/, "");
-    if (!rel) continue;
-    const segs = rel.split("/");
-    let cur = root;
-    segs.forEach((seg, i) => {
-      if (i === segs.length - 1) {
-        if (!(seg in cur)) cur[seg] = null;
-      } else {
-        if (cur[seg] === null || !(seg in cur)) cur[seg] = {};
-        cur = cur[seg];
-      }
-    });
-  }
-  const stripExt = (f) => f.replace(/\.(mdx?)$/, "");
-  const walk = (trie, parents) => {
-    const entries = Object.entries(trie);
-    const branches = entries.filter(([, v]) => v !== null);
-    const leaves = entries.filter(([, v]) => v === null).map(([k]) => k).filter((f) => !INDEX_RE.test(f));
-    branches.sort(([a], [b]) => a.toLowerCase().localeCompare(b.toLowerCase()));
-    leaves.sort((a, b) => a.toLowerCase().localeCompare(b.toLowerCase()));
-    const branchNodes = branches.map(([seg, sub]) => ({
-      name: seg,
-      title: seg,
-      // Folders are navigable to their index page (an authored index.md/README,
-      // else a generated listing).
-      slug: [...parents, seg].join("/"),
-      children: walk(sub, [...parents, seg])
-    }));
-    const leafNodes = leaves.map((file) => {
-      const nameNoExt = stripExt(file);
-      return { name: nameNoExt, title: nameNoExt, slug: [...parents, nameNoExt].join("/") };
-    });
-    return [...branchNodes, ...leafNodes];
-  };
-  return walk(root, []);
-}
-async function collectRelPaths(dir, rel = "") {
-  let dirents;
+init_logger();
+init_host();
+init_registry2();
+init_types();
+var log = getLogger("query");
+async function collectMarkdownFiles(dir) {
+  let entries;
   try {
-    dirents = await import_promises7.default.readdir(dir, { withFileTypes: true });
+    entries = await import_promises7.default.readdir(dir, { withFileTypes: true });
   } catch {
     return [];
   }
-  const out = [];
-  for (const d of dirents) {
-    if (d.name.startsWith(".")) continue;
-    const childRel = rel ? `${rel}/${d.name}` : d.name;
-    if (d.isDirectory()) {
-      out.push(...await collectRelPaths(import_node_path6.default.join(dir, d.name), childRel));
-    } else if (/\.(mdx?)$/.test(d.name)) {
-      out.push(childRel);
+  const files = [];
+  for (const entry of entries) {
+    const full = import_node_path5.default.join(dir, entry.name);
+    if (entry.isDirectory()) {
+      files.push(...await collectMarkdownFiles(full));
+    } else if (entry.isFile() && /\.mdx?$/.test(entry.name)) {
+      files.push(full);
     }
   }
-  return out;
+  return files;
 }
-async function readdirSafe(dir) {
-  try {
-    return await import_promises7.default.readdir(dir);
-  } catch {
-    return [];
-  }
+var K1 = 1.5;
+var B = 0.75;
+var FIELD_WEIGHTS = { title: 3, tags: 2, collection: 1.5, body: 1 };
+function tokenize(text) {
+  return text.toLowerCase().split(/[^a-z0-9]+/).filter((t) => t.length > 0);
 }
-function pickIndexFile(names) {
-  const rank = (n) => {
-    const lower = n.toLowerCase();
-    const base = lower.startsWith("index") ? 0 : 1;
-    const ext = lower.endsWith(".mdx") ? 0 : 1;
-    return base * 2 + ext;
-  };
-  return names.filter((n) => INDEX_RE.test(n)).sort((a, b) => rank(a) - rank(b))[0];
+function termFreqs(tokens) {
+  const freqs = /* @__PURE__ */ new Map();
+  for (const t of tokens) {
+    freqs.set(t, (freqs.get(t) ?? 0) + 1);
+  }
+  return freqs;
 }
-async function cheapTitle(absPath) {
-  let handle;
-  try {
-    handle = await import_promises7.default.open(absPath, "r");
-    const buf = Buffer.alloc(512);
-    const { bytesRead } = await handle.read(buf, 0, 512, 0);
-    const snippet = buf.subarray(0, bytesRead).toString("utf8");
-    const m = snippet.match(/^---[\s\S]*?^title:\s*(.+)$/m);
-    if (m) return m[1].trim().replace(/^["']|["']$/g, "");
-  } catch {
-  } finally {
-    await handle?.close();
+function bm25FieldScore(queryTerms, fieldTokens, avgFieldLen, idf) {
+  const tf = termFreqs(fieldTokens);
+  const dl = fieldTokens.length;
+  const avgDl = avgFieldLen || 1;
+  let score = 0;
+  for (const term of queryTerms) {
+    const freq = tf.get(term) ?? 0;
+    if (freq === 0) continue;
+    const termIdf = idf.get(term) ?? 0;
+    const numerator = freq * (K1 + 1);
+    const denominator = freq + K1 * (1 - B + B * (dl / avgDl));
+    score += termIdf * (numerator / denominator);
   }
-  return void 0;
+  return score;
 }
-async function enrichTitles(nodes, collDir) {
-  return Promise.all(
-    nodes.map(async (node) => {
-      if (node.children) {
-        const children = await enrichTitles(node.children, collDir);
-        let title = node.title;
-        if (node.slug) {
-          const dir = import_node_path6.default.join(collDir, node.slug);
-          const idx = pickIndexFile(await readdirSafe(dir));
-          if (idx) title = await cheapTitle(import_node_path6.default.join(dir, idx)) ?? title;
-        }
-        return { ...node, title, children };
-      }
-      for (const ext of [".mdx", ".md"]) {
-        const title = await cheapTitle(import_node_path6.default.join(collDir, `${node.slug}${ext}`));
-        if (title) return { ...node, title };
+async function nativeSearch(term, collections, collection) {
+  let targets = collections;
+  if (collection) {
+    const one = collections.find((c) => c.name === collection);
+    if (!one) throw new CollectionNotFoundError(collection);
+    targets = [one];
+  }
+  const docs = [];
+  for (const entry of targets) {
+    for (const full of await collectMarkdownFiles(entry.path)) {
+      const fallbackTitle = import_node_path5.default.basename(full).replace(/\.mdx?$/, "");
+      let title = fallbackTitle;
+      let tags = [];
+      let body = "";
+      try {
+        const parsed = parseArticle(await import_promises7.default.readFile(full, "utf8"));
+        if (parsed.title) title = parsed.title;
+        tags = parsed.tags;
+        body = parsed.body;
+      } catch {
       }
-      return node;
-    })
-  );
-}
-async function listArticleTree(coll) {
-  const entry = await findCollection(coll);
-  if (!entry) throw new CollectionNotFoundError(coll);
-  const rels = await collectRelPaths(entry.path);
-  return enrichTitles(buildArticleTree(rels), import_node_path6.default.resolve(entry.path));
-}
-async function readArticle(coll, slug) {
-  const entry = await findCollection(coll);
-  if (!entry) throw new CollectionNotFoundError(coll);
-  const collDir = import_node_path6.default.resolve(entry.path);
-  const normalized = slug.replace(/\\/g, "/");
-  if (normalized.split("/").some((s) => s === "..")) {
-    throw new InvalidTargetError(slug, "path traversal detected");
+      docs.push({
+        collectionName: entry.name,
+        filePath: full,
+        title,
+        tags,
+        fields: {
+          title: tokenize(title),
+          tags: tokenize(tags.join(" ")),
+          collection: tokenize(entry.name),
+          body: tokenize(body)
+        }
+      });
+    }
   }
-  const safeSlug = normalized.split("/").filter((s) => s !== "" && s !== ".").join("/");
-  const inJail = (p) => p === collDir || p.startsWith(collDir + import_node_path6.default.sep);
-  let abs;
-  for (const rel of safeSlug ? [`${safeSlug}.mdx`, `${safeSlug}.md`] : []) {
-    const candidate = import_node_path6.default.resolve(collDir, rel);
-    if (!inJail(candidate)) throw new InvalidTargetError(slug, "path traversal detected");
-    try {
-      await import_promises7.default.access(candidate);
-      abs = candidate;
-      break;
-    } catch {
+  if (!term.trim()) {
+    return docs.map((d) => ({
+      collection: d.collectionName,
+      path: d.filePath,
+      title: d.title,
+      tags: d.tags
+    }));
+  }
+  const queryTerms = tokenize(term);
+  if (queryTerms.length === 0) {
+    return docs.map((d) => ({
+      collection: d.collectionName,
+      path: d.filePath,
+      title: d.title,
+      tags: d.tags
+    }));
+  }
+  const docTokenSets = docs.map(
+    (doc) => /* @__PURE__ */ new Set([...doc.fields.title, ...doc.fields.tags, ...doc.fields.collection, ...doc.fields.body])
+  );
+  const N = docs.length;
+  const idf = /* @__PURE__ */ new Map();
+  for (const qt of queryTerms) {
+    let docFreq = 0;
+    for (const tokenSet of docTokenSets) {
+      if (tokenSet.has(qt)) docFreq++;
     }
+    idf.set(qt, Math.log((N - docFreq + 0.5) / (docFreq + 0.5) + 1));
   }
-  if (!abs) {
-    const dir = import_node_path6.default.resolve(collDir, safeSlug);
-    if (inJail(dir)) {
-      const idx = pickIndexFile(await readdirSafe(dir));
-      if (idx) abs = import_node_path6.default.join(dir, idx);
+  const avgLens = {
+    title: docs.reduce((sum, d) => sum + d.fields.title.length, 0) / (N || 1),
+    tags: docs.reduce((sum, d) => sum + d.fields.tags.length, 0) / (N || 1),
+    collection: docs.reduce((sum, d) => sum + d.fields.collection.length, 0) / (N || 1),
+    body: docs.reduce((sum, d) => sum + d.fields.body.length, 0) / (N || 1)
+  };
+  const scored = [];
+  for (const doc of docs) {
+    const titleScore = bm25FieldScore(queryTerms, doc.fields.title, avgLens.title, idf) * FIELD_WEIGHTS.title;
+    const tagsScore = bm25FieldScore(queryTerms, doc.fields.tags, avgLens.tags, idf) * FIELD_WEIGHTS.tags;
+    const collScore = bm25FieldScore(queryTerms, doc.fields.collection, avgLens.collection, idf) * FIELD_WEIGHTS.collection;
+    const bodyScore = bm25FieldScore(queryTerms, doc.fields.body, avgLens.body, idf) * FIELD_WEIGHTS.body;
+    const total = titleScore + tagsScore + collScore + bodyScore;
+    if (total > 0) {
+      scored.push({ doc, score: total });
     }
   }
-  if (!abs) throw new ArticleNotFoundError(`${coll}/${safeSlug}`);
-  const parsed = parseArticle(await import_promises7.default.readFile(abs, "utf8"));
-  const title = parsed.title?.trim() || (safeSlug ? safeSlug.split("/").pop() ?? safeSlug : coll);
-  return { coll, slug: safeSlug, title, tags: parsed.tags, body: parsed.body, path: abs };
-}
-
-// src/render.ts
-var import_unified = require("unified");
-var import_remark_parse = __toESM(require("remark-parse"), 1);
-var import_remark_gfm = __toESM(require("remark-gfm"), 1);
-var import_remark_rehype = __toESM(require("remark-rehype"), 1);
-var import_rehype_slug = __toESM(require("rehype-slug"), 1);
-var import_rehype = __toESM(require("@shikijs/rehype"), 1);
-var import_rehype_stringify = __toESM(require("rehype-stringify"), 1);
-var import_unist_util_visit = require("unist-util-visit");
-var import_hast_util_to_string = require("hast-util-to-string");
-var LANG_ALIASES = {
-  "c#": "csharp",
-  cs: "csharp",
-  "c++": "cpp",
-  cxx: "cpp",
-  hs: "haskell",
-  ex: "elixir"
-};
-function rehypeCollectToc(toc) {
-  return (tree) => {
-    (0, import_unist_util_visit.visit)(tree, "element", (node) => {
-      if (node.tagName !== "h2" && node.tagName !== "h3") return;
-      const id = node.properties?.id;
-      if (!id) return;
-      toc.push({ slug: String(id), text: (0, import_hast_util_to_string.toString)(node), depth: node.tagName === "h2" ? 2 : 3 });
-    });
-  };
-}
-function rehypeStripLeadingH1() {
-  return (tree) => {
-    let removed = false;
-    (0, import_unist_util_visit.visit)(tree, "element", (node, index, parent) => {
-      if (!removed && node.tagName === "h1" && parent && index != null) {
-        parent.children.splice(index, 1);
-        removed = true;
-        return [import_unist_util_visit.SKIP, index];
-      }
-    });
-  };
-}
-function rehypeMarkMermaid() {
-  return (tree) => {
-    (0, import_unist_util_visit.visit)(tree, "element", (node) => {
-      if (node.tagName !== "pre") return;
-      const code = node.children.find((c) => c.type === "element" && c.tagName === "code");
-      const cls = code?.properties?.className ?? [];
-      if (!code || !cls.includes("language-mermaid")) return;
-      const source = (0, import_hast_util_to_string.toString)(code);
-      node.properties = { className: ["mermaid"] };
-      node.children = [{ type: "text", value: source }];
-    });
-  };
-}
-async function renderArticle(body) {
-  const toc = [];
-  const file = await (0, import_unified.unified)().use(import_remark_parse.default).use(import_remark_gfm.default).use(import_remark_rehype.default).use(import_rehype_slug.default).use(rehypeCollectToc, toc).use(rehypeStripLeadingH1).use(rehypeMarkMermaid).use(import_rehype.default, {
-    themes: { light: "github-light", dark: "github-dark" },
-    defaultColor: false,
-    langAlias: LANG_ALIASES,
-    fallbackLanguage: "plaintext"
-  }).use(import_rehype_stringify.default).process(body);
-  return { html: String(file), toc };
-}
-
-// src/site.ts
-init_errors();
-var isStatic = () => process.env.DIFFWIKI_STATIC === "1";
-function toTreeNodes(coll, nodes) {
-  return nodes.map(
-    (n) => n.children ? {
-      name: n.name,
-      title: n.title ?? n.name,
-      path: n.slug ? `/${coll}/${n.slug}` : void 0,
-      children: toTreeNodes(coll, n.children)
-    } : { name: n.name, title: n.title ?? n.name, path: `/${coll}/${n.slug}` }
-  );
-}
-async function gitInfo(e) {
-  if (isStatic()) {
-    if (e.type === "external") console.warn(`[diffwiki] static build: omitting branch info for "${e.name}"`);
-    return {};
-  }
-  const s = await collectionGitStatus(e);
-  return s ? { branch: s.branch, behind: s.hasUpstream ? s.behind : void 0 } : {};
-}
-async function buildCollections() {
-  const entries = await listCollections();
-  return Promise.all(
-    entries.map(async (e) => ({
-      name: e.name,
-      type: e.type,
-      path: e.path,
-      ...await gitInfo(e)
-    }))
-  );
-}
-async function buildNavTree() {
-  const entries = await listCollections();
-  return Promise.all(
-    entries.map(async (e) => ({
-      collection: { name: e.name, type: e.type, path: e.path, ...await gitInfo(e) },
-      nodes: toTreeNodes(e.name, await listArticleTree(e.name))
-    }))
-  );
-}
-function findNode(nodes, slug) {
-  for (const n of nodes) {
-    if (n.slug === slug) return n;
-    if (n.children) {
-      const found = findNode(n.children, slug);
-      if (found) return found;
-    }
-  }
-  return void 0;
-}
-async function resolvePage(coll, slug) {
-  try {
-    const art = await readArticle(coll, slug);
-    const { html, toc } = await renderArticle(art.body);
-    return {
-      kind: "doc",
-      coll: art.coll,
-      slug: art.slug,
-      title: art.title,
-      tags: art.tags,
-      html,
-      toc,
-      path: `/${art.coll}/${art.slug}`
-    };
-  } catch (err) {
-    if (err instanceof CollectionNotFoundError) return null;
-    if (!(err instanceof ArticleNotFoundError)) throw err;
-    let nodes;
-    try {
-      nodes = await listArticleTree(coll);
-    } catch (e) {
-      if (e instanceof CollectionNotFoundError) return null;
-      throw e;
-    }
-    const folder = slug ? findNode(nodes, slug) : { title: void 0, children: nodes };
-    if (!folder?.children) return null;
-    const entries = folder.children.map((n) => ({
-      name: n.name,
-      title: n.title ?? n.name,
-      path: `/${coll}/${n.slug ?? n.name}`,
-      isDir: Array.isArray(n.children)
-    }));
-    return {
-      kind: "listing",
-      coll,
-      slug,
-      title: folder.title ?? (slug ? slug.split("/").pop() ?? slug : coll),
-      entries
-    };
-  }
-}
-
-// src/query.ts
-var import_promises8 = __toESM(require("fs/promises"), 1);
-var import_node_path7 = __toESM(require("path"), 1);
-init_collections();
-init_errors();
-init_logger();
-init_host();
-init_registry2();
-init_types();
-
-// src/bm25.ts
-var K1 = 1.5;
-var B = 0.75;
-var FIELD_WEIGHTS = { title: 3, tags: 2, collection: 1.5, body: 1 };
-function tokenize(text) {
-  return text.toLowerCase().split(/[^a-z0-9]+/).filter((t) => t.length > 0);
-}
-function termFreqs(tokens) {
-  const freqs = /* @__PURE__ */ new Map();
-  for (const t of tokens) freqs.set(t, (freqs.get(t) ?? 0) + 1);
-  return freqs;
-}
-function bm25FieldScore(queryTerms, fieldTokens, avgFieldLen, idf) {
-  const tf = termFreqs(fieldTokens);
-  const dl = fieldTokens.length;
-  const avgDl = avgFieldLen || 1;
-  let score = 0;
-  for (const term of queryTerms) {
-    const freq = tf.get(term) ?? 0;
-    if (freq === 0) continue;
-    const termIdf = idf.get(term) ?? 0;
-    const numerator = freq * (K1 + 1);
-    const denominator = freq + K1 * (1 - B + B * (dl / avgDl));
-    score += termIdf * (numerator / denominator);
-  }
-  return score;
-}
-function rankDocs(term, docs) {
-  const queryTerms = tokenize(term);
-  if (queryTerms.length === 0) return docs.map((d) => ({ ...d }));
-  const N = docs.length;
-  const docTokenSets = docs.map(
-    (d) => /* @__PURE__ */ new Set([...d.fields.title, ...d.fields.tags, ...d.fields.collection, ...d.fields.body])
-  );
-  const idf = /* @__PURE__ */ new Map();
-  for (const qt of queryTerms) {
-    let docFreq = 0;
-    for (const set of docTokenSets) if (set.has(qt)) docFreq++;
-    idf.set(qt, Math.log((N - docFreq + 0.5) / (docFreq + 0.5) + 1));
-  }
-  const avg = (sel) => docs.reduce((s, d) => s + sel(d), 0) / (N || 1);
-  const avgLens = {
-    title: avg((d) => d.fields.title.length),
-    tags: avg((d) => d.fields.tags.length),
-    collection: avg((d) => d.fields.collection.length),
-    body: avg((d) => d.fields.body.length)
-  };
-  const scored = [];
-  for (const d of docs) {
-    const total = bm25FieldScore(queryTerms, d.fields.title, avgLens.title, idf) * FIELD_WEIGHTS.title + bm25FieldScore(queryTerms, d.fields.tags, avgLens.tags, idf) * FIELD_WEIGHTS.tags + bm25FieldScore(queryTerms, d.fields.collection, avgLens.collection, idf) * FIELD_WEIGHTS.collection + bm25FieldScore(queryTerms, d.fields.body, avgLens.body, idf) * FIELD_WEIGHTS.body;
-    if (total > 0) scored.push({ ...d, score: total });
-  }
-  scored.sort((a, b) => (b.score ?? 0) - (a.score ?? 0));
-  return scored;
-}
-
-// src/query.ts
-var log = getLogger("query");
-async function collectMarkdownFiles(dir) {
-  let entries;
-  try {
-    entries = await import_promises8.default.readdir(dir, { withFileTypes: true });
-  } catch {
-    return [];
-  }
-  const files = [];
-  for (const entry of entries) {
-    const full = import_node_path7.default.join(dir, entry.name);
-    if (entry.isDirectory()) {
-      files.push(...await collectMarkdownFiles(full));
-    } else if (entry.isFile() && /\.mdx?$/.test(entry.name)) {
-      files.push(full);
-    }
-  }
-  return files;
-}
-async function nativeSearch(term, collections, collection) {
-  let targets = collections;
-  if (collection) {
-    const one = collections.find((c) => c.name === collection);
-    if (!one) throw new CollectionNotFoundError(collection);
-    targets = [one];
-  }
-  const docs = [];
-  for (const entry of targets) {
-    for (const full of await collectMarkdownFiles(entry.path)) {
-      const fallbackTitle = import_node_path7.default.basename(full).replace(/\.mdx?$/, "");
-      let title = fallbackTitle;
-      let tags = [];
-      let body = "";
-      try {
-        const parsed = parseArticle(await import_promises8.default.readFile(full, "utf8"));
-        if (parsed.title) title = parsed.title;
-        tags = parsed.tags;
-        body = parsed.body;
-      } catch {
-      }
-      docs.push({
-        collectionName: entry.name,
-        filePath: full,
-        title,
-        tags,
-        fields: {
-          title: tokenize(title),
-          tags: tokenize(tags.join(" ")),
-          collection: tokenize(entry.name),
-          body: tokenize(body)
-        }
-      });
-    }
-  }
-  return rankDocs(term, docs).map((d) => ({
-    collection: d.collectionName,
-    path: d.filePath,
-    title: d.title,
-    tags: d.tags,
-    ...d.score === void 0 ? {} : { score: d.score }
-  }));
+  scored.sort((a, b) => b.score - a.score);
+  return scored.map((s) => ({
+    collection: s.doc.collectionName,
+    path: s.doc.filePath,
+    title: s.doc.title,
+    tags: s.doc.tags,
+    score: s.score
+  }));
 }
 async function resolveDefaultEngine() {
   const config = await readConfig();
@@ -1547,64 +1109,15 @@ async function query(term, opts) {
   return (await search(term, opts)).hits;
 }
 
-// src/search.ts
-var import_promises9 = __toESM(require("fs/promises"), 1);
-var import_node_path8 = __toESM(require("path"), 1);
-init_collections();
-async function readArticleParts(collDir, slug) {
-  for (const ext of [".mdx", ".md"]) {
-    try {
-      const parsed = parseArticle(await import_promises9.default.readFile(import_node_path8.default.join(collDir, `${slug}${ext}`), "utf8"));
-      return { tags: parsed.tags, body: parsed.body };
-    } catch {
-    }
-  }
-  return { tags: [], body: "" };
-}
-async function flatten(coll, collDir, nodes, out) {
-  for (const n of nodes) {
-    if (n.slug && !n.children) {
-      const title = n.title ?? n.name;
-      const { tags, body } = await readArticleParts(collDir, n.slug);
-      out.push({
-        collection: coll,
-        slug: n.slug,
-        title,
-        tags,
-        fields: {
-          title: tokenize(title),
-          tags: tokenize(tags.join(" ")),
-          collection: tokenize(coll),
-          body: tokenize(body)
-        }
-      });
-    }
-    if (n.children) await flatten(coll, collDir, n.children, out);
-  }
-}
-async function buildSearchIndex(collection) {
-  const entries = collection ? (await listCollections()).filter((c) => c.name === collection) : await listCollections();
-  const out = [];
-  for (const e of entries) {
-    try {
-      const collEntry = await findCollection(e.name);
-      const collDir = import_node_path8.default.resolve(collEntry?.path ?? e.path);
-      await flatten(e.name, collDir, await listArticleTree(e.name), out);
-    } catch {
-    }
-  }
-  return out;
-}
-
 // src/doctor.ts
-var import_promises11 = __toESM(require("fs/promises"), 1);
+var import_promises9 = __toESM(require("fs/promises"), 1);
 init_paths();
 init_registry();
 init_collections();
 
 // src/plugins/manager.ts
-var import_promises10 = __toESM(require("fs/promises"), 1);
-var import_node_path10 = __toESM(require("path"), 1);
+var import_promises8 = __toESM(require("fs/promises"), 1);
+var import_node_path7 = __toESM(require("path"), 1);
 init_paths();
 init_errors();
 init_collections();
@@ -1612,14 +1125,14 @@ init_registry2();
 init_host();
 
 // src/plugins/sdk.ts
-var import_node_child_process4 = require("child_process");
-var import_node_util3 = require("util");
+var import_node_child_process3 = require("child_process");
+var import_node_util2 = require("util");
 var import_node_fs = require("fs");
-var import_node_path9 = require("path");
+var import_node_path6 = require("path");
 var import_node_url = require("url");
-var execFileAsync3 = (0, import_node_util3.promisify)(import_node_child_process4.execFile);
+var execFileAsync2 = (0, import_node_util2.promisify)(import_node_child_process3.execFile);
 async function runProcess(file, args, opts) {
-  const { stdout, stderr } = await execFileAsync3(file, args, {
+  const { stdout, stderr } = await execFileAsync2(file, args, {
     env: opts?.env,
     timeout: opts?.timeout,
     // Large: qmd emits multi-MB JSON search payloads that overflow the default 1 MB.
@@ -1631,7 +1144,7 @@ async function runProcess(file, args, opts) {
 // src/plugins/manager.ts
 async function readPackageJson(file) {
   try {
-    return JSON.parse(await import_promises10.default.readFile(file, "utf8"));
+    return JSON.parse(await import_promises8.default.readFile(file, "utf8"));
   } catch {
     return null;
   }
@@ -1647,7 +1160,7 @@ function binOf(manifest) {
 async function pluginManifestDirs(nodeModules) {
   let entries;
   try {
-    entries = await import_promises10.default.readdir(nodeModules);
+    entries = await import_promises8.default.readdir(nodeModules);
   } catch {
     return [];
   }
@@ -1657,39 +1170,39 @@ async function pluginManifestDirs(nodeModules) {
     if (entry.startsWith("@")) {
       let scoped;
       try {
-        scoped = await import_promises10.default.readdir(import_node_path10.default.join(nodeModules, entry));
+        scoped = await import_promises8.default.readdir(import_node_path7.default.join(nodeModules, entry));
       } catch {
         continue;
       }
       for (const pkg of scoped) {
         if (pkg.startsWith(".")) continue;
-        dirs.push(import_node_path10.default.join(nodeModules, entry, pkg));
+        dirs.push(import_node_path7.default.join(nodeModules, entry, pkg));
       }
     } else {
-      dirs.push(import_node_path10.default.join(nodeModules, entry));
+      dirs.push(import_node_path7.default.join(nodeModules, entry));
     }
   }
   return dirs;
 }
 async function ensurePluginRoot() {
   const dir = pluginsDir();
-  await import_promises10.default.mkdir(dir, { recursive: true });
-  const pkgPath = import_node_path10.default.join(dir, "package.json");
+  await import_promises8.default.mkdir(dir, { recursive: true });
+  const pkgPath = import_node_path7.default.join(dir, "package.json");
   if (await readPackageJson(pkgPath) === null) {
     const pkg = { name: "diffwiki-plugins", private: true, version: "0.0.0" };
-    await import_promises10.default.writeFile(pkgPath, `${JSON.stringify(pkg, null, 2)}
+    await import_promises8.default.writeFile(pkgPath, `${JSON.stringify(pkg, null, 2)}
 `, "utf8");
   }
   return dir;
 }
 async function discoverSearchPackage(dir) {
-  const nodeModules = import_node_path10.default.join(dir, "node_modules");
+  const nodeModules = import_node_path7.default.join(dir, "node_modules");
   for (const pkgDir of await pluginManifestDirs(nodeModules)) {
-    const manifest = await readPackageJson(import_node_path10.default.join(pkgDir, "package.json"));
+    const manifest = await readPackageJson(import_node_path7.default.join(pkgDir, "package.json"));
     if (!manifest?.name || manifest.diffwiki?.kind !== "search") continue;
     const bin = binOf(manifest);
     if (!bin) continue;
-    return { name: manifest.name, version: manifest.version, binAbs: import_node_path10.default.resolve(pkgDir, bin) };
+    return { name: manifest.name, version: manifest.version, binAbs: import_node_path7.default.resolve(pkgDir, bin) };
   }
   return null;
 }
@@ -1812,7 +1325,7 @@ init_host();
 init_types();
 async function exists(target) {
   try {
-    await import_promises11.default.access(target);
+    await import_promises9.default.access(target);
     return true;
   } catch {
     return false;
@@ -1920,6 +1433,226 @@ async function appendPluginDiagnostics(out, config) {
 // src/index.ts
 init_logger();
 
+// src/browse.ts
+var import_promises10 = __toESM(require("fs/promises"), 1);
+var import_node_path8 = __toESM(require("path"), 1);
+init_collections();
+init_errors();
+var INDEX_RE = /^(index|readme)\.mdx?$/i;
+function buildArticleTree(relPaths) {
+  const root = {};
+  for (const raw of relPaths) {
+    const rel = raw.replace(/\\/g, "/").replace(/^\/+/, "");
+    if (!rel) continue;
+    const segs = rel.split("/");
+    let cur = root;
+    segs.forEach((seg, i) => {
+      if (i === segs.length - 1) {
+        if (!(seg in cur)) cur[seg] = null;
+      } else {
+        if (cur[seg] === null || !(seg in cur)) cur[seg] = {};
+        cur = cur[seg];
+      }
+    });
+  }
+  const stripExt = (f) => f.replace(/\.(mdx?)$/, "");
+  const walk = (trie, parents) => {
+    const entries = Object.entries(trie);
+    const branches = entries.filter(([, v]) => v !== null);
+    const leaves = entries.filter(([, v]) => v === null).map(([k]) => k).filter((f) => !INDEX_RE.test(f));
+    branches.sort(([a], [b]) => a.toLowerCase().localeCompare(b.toLowerCase()));
+    leaves.sort((a, b) => a.toLowerCase().localeCompare(b.toLowerCase()));
+    const branchNodes = branches.map(([seg, sub]) => ({
+      name: seg,
+      title: seg,
+      // Folders are navigable to their index page (an authored index.md/README,
+      // else a generated listing).
+      slug: [...parents, seg].join("/"),
+      children: walk(sub, [...parents, seg])
+    }));
+    const leafNodes = leaves.map((file) => {
+      const nameNoExt = stripExt(file);
+      return { name: nameNoExt, title: nameNoExt, slug: [...parents, nameNoExt].join("/") };
+    });
+    return [...branchNodes, ...leafNodes];
+  };
+  return walk(root, []);
+}
+async function collectRelPaths(dir, rel = "") {
+  let dirents;
+  try {
+    dirents = await import_promises10.default.readdir(dir, { withFileTypes: true });
+  } catch {
+    return [];
+  }
+  const out = [];
+  for (const d of dirents) {
+    if (d.name.startsWith(".")) continue;
+    const childRel = rel ? `${rel}/${d.name}` : d.name;
+    if (d.isDirectory()) {
+      out.push(...await collectRelPaths(import_node_path8.default.join(dir, d.name), childRel));
+    } else if (/\.(mdx?)$/.test(d.name)) {
+      out.push(childRel);
+    }
+  }
+  return out;
+}
+async function readdirSafe(dir) {
+  try {
+    return await import_promises10.default.readdir(dir);
+  } catch {
+    return [];
+  }
+}
+function pickIndexFile(names) {
+  const rank = (n) => {
+    const lower = n.toLowerCase();
+    const base = lower.startsWith("index") ? 0 : 1;
+    const ext = lower.endsWith(".mdx") ? 0 : 1;
+    return base * 2 + ext;
+  };
+  return names.filter((n) => INDEX_RE.test(n)).sort((a, b) => rank(a) - rank(b))[0];
+}
+async function cheapTitle(absPath) {
+  let handle;
+  try {
+    handle = await import_promises10.default.open(absPath, "r");
+    const buf = Buffer.alloc(512);
+    const { bytesRead } = await handle.read(buf, 0, 512, 0);
+    const snippet = buf.subarray(0, bytesRead).toString("utf8");
+    const m = snippet.match(/^---[\s\S]*?^title:\s*(.+)$/m);
+    if (m) return m[1].trim().replace(/^["']|["']$/g, "");
+  } catch {
+  } finally {
+    await handle?.close();
+  }
+  return void 0;
+}
+async function enrichTitles(nodes, collDir) {
+  return Promise.all(
+    nodes.map(async (node) => {
+      if (node.children) {
+        const children = await enrichTitles(node.children, collDir);
+        let title = node.title;
+        if (node.slug) {
+          const dir = import_node_path8.default.join(collDir, node.slug);
+          const idx = pickIndexFile(await readdirSafe(dir));
+          if (idx) title = await cheapTitle(import_node_path8.default.join(dir, idx)) ?? title;
+        }
+        return { ...node, title, children };
+      }
+      for (const ext of [".mdx", ".md"]) {
+        const title = await cheapTitle(import_node_path8.default.join(collDir, `${node.slug}${ext}`));
+        if (title) return { ...node, title };
+      }
+      return node;
+    })
+  );
+}
+async function listArticleTree(coll) {
+  const entry = await findCollection(coll);
+  if (!entry) throw new CollectionNotFoundError(coll);
+  const rels = await collectRelPaths(entry.path);
+  return enrichTitles(buildArticleTree(rels), import_node_path8.default.resolve(entry.path));
+}
+async function readArticle(coll, slug) {
+  const entry = await findCollection(coll);
+  if (!entry) throw new CollectionNotFoundError(coll);
+  const collDir = import_node_path8.default.resolve(entry.path);
+  const normalized = slug.replace(/\\/g, "/");
+  if (normalized.split("/").some((s) => s === "..")) {
+    throw new InvalidTargetError(slug, "path traversal detected");
+  }
+  const safeSlug = normalized.split("/").filter((s) => s !== "" && s !== ".").join("/");
+  const inJail = (p) => p === collDir || p.startsWith(collDir + import_node_path8.default.sep);
+  let abs;
+  for (const rel of safeSlug ? [`${safeSlug}.mdx`, `${safeSlug}.md`] : []) {
+    const candidate = import_node_path8.default.resolve(collDir, rel);
+    if (!inJail(candidate)) throw new InvalidTargetError(slug, "path traversal detected");
+    try {
+      await import_promises10.default.access(candidate);
+      abs = candidate;
+      break;
+    } catch {
+    }
+  }
+  if (!abs) {
+    const dir = import_node_path8.default.resolve(collDir, safeSlug);
+    if (inJail(dir)) {
+      const idx = pickIndexFile(await readdirSafe(dir));
+      if (idx) abs = import_node_path8.default.join(dir, idx);
+    }
+  }
+  if (!abs) throw new ArticleNotFoundError(`${coll}/${safeSlug}`);
+  const parsed = parseArticle(await import_promises10.default.readFile(abs, "utf8"));
+  const title = parsed.title?.trim() || (safeSlug ? safeSlug.split("/").pop() ?? safeSlug : coll);
+  return { coll, slug: safeSlug, title, tags: parsed.tags, body: parsed.body, path: abs };
+}
+
+// src/render.ts
+var import_unified = require("unified");
+var import_remark_parse = __toESM(require("remark-parse"), 1);
+var import_remark_gfm = __toESM(require("remark-gfm"), 1);
+var import_remark_rehype = __toESM(require("remark-rehype"), 1);
+var import_rehype_slug = __toESM(require("rehype-slug"), 1);
+var import_rehype = __toESM(require("@shikijs/rehype"), 1);
+var import_rehype_stringify = __toESM(require("rehype-stringify"), 1);
+var import_unist_util_visit = require("unist-util-visit");
+var import_hast_util_to_string = require("hast-util-to-string");
+var LANG_ALIASES = {
+  "c#": "csharp",
+  cs: "csharp",
+  "c++": "cpp",
+  cxx: "cpp",
+  hs: "haskell",
+  ex: "elixir"
+};
+function rehypeCollectToc(toc) {
+  return (tree) => {
+    (0, import_unist_util_visit.visit)(tree, "element", (node) => {
+      if (node.tagName !== "h2" && node.tagName !== "h3") return;
+      const id = node.properties?.id;
+      if (!id) return;
+      toc.push({ slug: String(id), text: (0, import_hast_util_to_string.toString)(node), depth: node.tagName === "h2" ? 2 : 3 });
+    });
+  };
+}
+function rehypeStripLeadingH1() {
+  return (tree) => {
+    let removed = false;
+    (0, import_unist_util_visit.visit)(tree, "element", (node, index, parent) => {
+      if (!removed && node.tagName === "h1" && parent && index != null) {
+        parent.children.splice(index, 1);
+        removed = true;
+        return [import_unist_util_visit.SKIP, index];
+      }
+    });
+  };
+}
+function rehypeMarkMermaid() {
+  return (tree) => {
+    (0, import_unist_util_visit.visit)(tree, "element", (node) => {
+      if (node.tagName !== "pre") return;
+      const code = node.children.find((c) => c.type === "element" && c.tagName === "code");
+      const cls = code?.properties?.className ?? [];
+      if (!code || !cls.includes("language-mermaid")) return;
+      const source = (0, import_hast_util_to_string.toString)(code);
+      node.properties = { className: ["mermaid"] };
+      node.children = [{ type: "text", value: source }];
+    });
+  };
+}
+async function renderArticle(body) {
+  const toc = [];
+  const file = await (0, import_unified.unified)().use(import_remark_parse.default).use(import_remark_gfm.default).use(import_remark_rehype.default).use(import_rehype_slug.default).use(rehypeCollectToc, toc).use(rehypeStripLeadingH1).use(rehypeMarkMermaid).use(import_rehype.default, {
+    themes: { light: "github-light", dark: "github-dark" },
+    defaultColor: false,
+    langAlias: LANG_ALIASES,
+    fallbackLanguage: "plaintext"
+  }).use(import_rehype_stringify.default).process(body);
+  return { html: String(file), toc };
+}
+
 // src/plugins/index.ts
 init_host();
 init_events();
@@ -1950,7 +1683,6 @@ init_registry2();
 // Annotate the CommonJS export names for ESM import in node:
 0 && (module.exports = {
   ArticleNotFoundError,
-  CollectionAlreadyAddedError,
   CollectionExistsError,
   CollectionNotFoundError,
   DiffwikiError,
@@ -1959,35 +1691,24 @@ init_registry2();
   NoDefaultCollectionError,
   PluginError,
   REPO_CONFIG_FILE,
-  WorktreeNotAllowedError,
-  addExternalCollection,
   addTags,
   buildArticleTree,
-  buildCollections,
-  buildNavTree,
-  buildSearchIndex,
   collectionDir,
-  collectionGitStatus,
   collectionsDir,
   configPath,
   createArticle,
   createCollection,
-  currentBranch,
   deregisterPlugin,
   doctor,
   emitPluginEvent,
-  ensureGitRepo,
   ensurePluginRoot,
   findCollection,
-  findCollectionById,
   findEnabledPlugin,
   findPluginRecord,
   getConfigValue,
   getLogger,
-  gitToplevel,
   initRepoWiki,
   installPlugin,
-  isLinkedWorktree,
   listArticleTree,
   listAvailablePlugins,
   listCollections,
@@ -2002,7 +1723,6 @@ init_registry2();
   pluginsDir,
   pluginsRegistryPath,
   query,
-  rankDocs,
   readArticle,
   readConfig,
   readPluginRegistry,
@@ -2016,24 +1736,17 @@ init_registry2();
   removePlugin,
   removeTags,
   renderArticle,
-  repoId,
-  repoRemoteName,
-  resolveCwdCollection,
   resolveDefaultSearchMode,
   resolveHome,
   resolveLogLevel,
-  resolvePage,
   search,
   serializeArticle,
   setConfigValue,
   setTags,
   slugify,
-  toTreeNodes,
-  tokenize,
   unregisterCollection,
   updateArticleBody,
   upsertPlugin,
-  upstreamStatus,
   writeConfig,
   writePluginRegistry,
   writeRegistry