diffwiki-core 0.6.0 → 0.6.1

package/dist/index.cjs

@@ -591,6 +591,7 @@ __export(index_exports, {
   emitPluginEvent: () => emitPluginEvent,
   ensureGitRepo: () => ensureGitRepo,
   ensurePluginRoot: () => ensurePluginRoot,
+  fileTimestamps: () => fileTimestamps,
   findCollection: () => findCollection,
   findCollectionById: () => findCollectionById,
   findEnabledPlugin: () => findEnabledPlugin,
@@ -755,8 +756,6 @@ function parseArticle(raw) {
 }
 function serializeArticle(article) {
   const front = { title: article.title, tags: article.tags };
-  if (article.created) front.created = article.created;
-  if (article.updated) front.updated = article.updated;
   return import_gray_matter.default.stringify(article.body, front, MATTER_OPTS);
 }
 
@@ -816,11 +815,10 @@ async function createArticle(opts) {
   const { collection, title } = parseAddTarget(opts.target);
   const { name, dir } = await resolveCollectionDir(collection);
   const filePath = import_node_path3.default.join(dir, `${slugify(title)}.md`);
-  const now = (/* @__PURE__ */ new Date()).toISOString();
   const body = opts.body ?? `# ${title}
 `;
   await import_promises5.default.mkdir(dir, { recursive: true });
-  await import_promises5.default.writeFile(filePath, serializeArticle({ title, tags: opts.tags, created: now, updated: now, body }), "utf8");
+  await import_promises5.default.writeFile(filePath, serializeArticle({ title, tags: opts.tags, body }), "utf8");
   void fireHook2("article-created", name, import_node_path3.default.relative(dir, filePath));
   return { title, tags: opts.tags, path: filePath, collection: name };
 }
@@ -838,17 +836,7 @@ async function loadArticle(target) {
 async function updateArticleBody(target, body) {
   const { filePath, dir, raw, collection } = await loadArticle(target);
   const parsed = parseArticle(raw);
-  await import_promises5.default.writeFile(
-    filePath,
-    serializeArticle({
-      title: parsed.title,
-      tags: parsed.tags,
-      created: parsed.created,
-      updated: (/* @__PURE__ */ new Date()).toISOString(),
-      body
-    }),
-    "utf8"
-  );
+  await import_promises5.default.writeFile(filePath, serializeArticle({ title: parsed.title, tags: parsed.tags, body }), "utf8");
   void fireHook2("article-updated", collection, import_node_path3.default.relative(dir, filePath));
   return { title: parsed.title, tags: parsed.tags, path: filePath, collection };
 }
@@ -856,17 +844,7 @@ async function mutateTags(target, fn) {
   const { filePath, dir, raw, collection } = await loadArticle(target);
   const parsed = parseArticle(raw);
   const tags = fn(parsed.tags);
-  await import_promises5.default.writeFile(
-    filePath,
-    serializeArticle({
-      title: parsed.title,
-      tags,
-      created: parsed.created,
-      updated: (/* @__PURE__ */ new Date()).toISOString(),
-      body: parsed.body
-    }),
-    "utf8"
-  );
+  await import_promises5.default.writeFile(filePath, serializeArticle({ title: parsed.title, tags, body: parsed.body }), "utf8");
   void fireHook2("article-updated", collection, import_node_path3.default.relative(dir, filePath));
   return { title: parsed.title, tags, path: filePath, collection };
 }
@@ -888,7 +866,7 @@ async function removeArticle(target) {
 }
 
 // src/repo.ts
-var import_promises6 = __toESM(require("fs/promises"), 1);
+var import_promises7 = __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");
@@ -897,6 +875,7 @@ init_collections();
 init_registry();
 
 // src/git.ts
+var import_promises6 = __toESM(require("fs/promises"), 1);
 var import_node_path4 = __toESM(require("path"), 1);
 var import_node_child_process2 = require("child_process");
 var import_node_util = require("util");
@@ -959,6 +938,35 @@ async function ensureGitRepo(cwd) {
   if (!after) throw new Error("git init did not produce a repository");
   return after;
 }
+function isEpochish(d) {
+  return !Number.isFinite(d.getTime()) || d.getTime() <= 0;
+}
+var timestampCache = /* @__PURE__ */ new Map();
+async function fileTimestamps(absPath) {
+  const cached = timestampCache.get(absPath);
+  if (cached) return cached;
+  const dir = import_node_path4.default.dirname(absPath);
+  const base = import_node_path4.default.basename(absPath);
+  const [addLog, lastLog] = await Promise.all([
+    git(dir, ["log", "--follow", "--diff-filter=A", "--format=%aI", "--", base]),
+    git(dir, ["log", "-1", "--format=%aI", "--", base])
+  ]);
+  const gitCreated = addLog ? addLog.split("\n").filter(Boolean).pop() : void 0;
+  const gitUpdated = lastLog || void 0;
+  let created = gitCreated;
+  let updated = gitUpdated;
+  if (!created || !updated) {
+    try {
+      const st = await import_promises6.default.stat(absPath);
+      if (!updated) updated = st.mtime.toISOString();
+      if (!created) created = isEpochish(st.birthtime) ? st.mtime.toISOString() : st.birthtime.toISOString();
+    } catch {
+    }
+  }
+  const result = { created, updated };
+  timestampCache.set(absPath, result);
+  return result;
+}
 
 // src/repo.ts
 init_errors();
@@ -974,7 +982,7 @@ async function detectRepoName(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_promises7.default.readFile(import_node_path5.default.join(cwd, REPO_CONFIG_FILE), "utf8");
     const parsed = (0, import_yaml2.parse)(raw) ?? {};
     if (!parsed.path) return void 0;
     return {
@@ -1004,9 +1012,9 @@ async function initRepoWiki(opts) {
       n += 1;
     }
   }
-  await import_promises6.default.mkdir(absWiki, { recursive: true });
+  await import_promises7.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_promises7.default.writeFile(import_node_path5.default.join(cwd, REPO_CONFIG_FILE), (0, import_yaml2.stringify)(config), "utf8");
   const entry = {
     name,
     type: "repo",
@@ -1078,7 +1086,7 @@ async function collectionGitStatus(entry) {
 init_collections();
 
 // src/browse.ts
-var import_promises7 = __toESM(require("fs/promises"), 1);
+var import_promises8 = __toESM(require("fs/promises"), 1);
 var import_node_path6 = __toESM(require("path"), 1);
 init_collections();
 init_errors();
@@ -1125,7 +1133,7 @@ function buildArticleTree(relPaths) {
 async function collectRelPaths(dir, rel = "") {
   let dirents;
   try {
-    dirents = await import_promises7.default.readdir(dir, { withFileTypes: true });
+    dirents = await import_promises8.default.readdir(dir, { withFileTypes: true });
   } catch {
     return [];
   }
@@ -1143,7 +1151,7 @@ async function collectRelPaths(dir, rel = "") {
 }
 async function readdirSafe(dir) {
   try {
-    return await import_promises7.default.readdir(dir);
+    return await import_promises8.default.readdir(dir);
   } catch {
     return [];
   }
@@ -1160,7 +1168,7 @@ function pickIndexFile(names) {
 async function cheapTitle(absPath) {
   let handle;
   try {
-    handle = await import_promises7.default.open(absPath, "r");
+    handle = await import_promises8.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");
@@ -1210,11 +1218,12 @@ async function readArticle(coll, slug) {
   const safeSlug = normalized.split("/").filter((s) => s !== "" && s !== ".").join("/");
   const inJail = (p) => p === collDir || p.startsWith(collDir + import_node_path6.default.sep);
   let abs;
+  let isIndex = false;
   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);
+      await import_promises8.default.access(candidate);
       abs = candidate;
       break;
     } catch {
@@ -1224,16 +1233,20 @@ async function readArticle(coll, slug) {
     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);
+      if (idx) {
+        abs = import_node_path6.default.join(dir, idx);
+        isIndex = true;
+      }
     }
   }
   if (!abs) throw new ArticleNotFoundError(`${coll}/${safeSlug}`);
-  const parsed = parseArticle(await import_promises7.default.readFile(abs, "utf8"));
+  const parsed = parseArticle(await import_promises8.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 };
+  return { coll, slug: safeSlug, title, tags: parsed.tags, body: parsed.body, path: abs, isIndex };
 }
 
 // src/render.ts
+var import_node_path7 = __toESM(require("path"), 1);
 var import_unified = require("unified");
 var import_remark_parse = __toESM(require("remark-parse"), 1);
 var import_remark_gfm = __toESM(require("remark-gfm"), 1);
@@ -1243,6 +1256,36 @@ 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");
+function isNonRelativeHref(href) {
+  if (href === "") return true;
+  if (href.startsWith("/") || href.startsWith("#") || href.startsWith("?")) return true;
+  if (href.startsWith("//")) return true;
+  return /^[a-z][a-z0-9+.-]*:/i.test(href);
+}
+function rehypeRewriteLinks(ctx) {
+  const slugDir = ctx.isIndex ? ctx.slug || "." : import_node_path7.default.posix.dirname(ctx.slug || ".");
+  return (tree) => {
+    (0, import_unist_util_visit.visit)(tree, "element", (node) => {
+      if (node.tagName !== "a") return;
+      const raw = node.properties?.href;
+      if (typeof raw !== "string" || isNonRelativeHref(raw)) return;
+      const suffixMatch = /[#?].*$/.exec(raw);
+      const suffix = suffixMatch ? suffixMatch[0] : "";
+      const pathPart = suffix ? raw.slice(0, raw.length - suffix.length) : raw;
+      if (pathPart === "") return;
+      const joined = import_node_path7.default.posix.join(slugDir === "." ? "" : slugDir, pathPart);
+      const normalized = import_node_path7.default.posix.normalize(joined);
+      if (normalized.startsWith("..")) return;
+      let resolved = normalized.replace(/\.(mdx?)$/i, "");
+      resolved = resolved.replace(/(^|\/)(index|readme)$/i, "$1");
+      resolved = resolved.replace(/\/+$/, "").replace(/^\/+/, "");
+      node.properties = {
+        ...node.properties,
+        href: `/${ctx.coll}${resolved ? `/${resolved}` : ""}${suffix}`
+      };
+    });
+  };
+}
 var LANG_ALIASES = {
   "c#": "csharp",
   cs: "csharp",
@@ -1286,9 +1329,9 @@ function rehypeMarkMermaid() {
     });
   };
 }
-async function renderArticle(body) {
+async function renderArticle(body, ctx) {
   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, {
+  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(rehypeRewriteLinks, ctx).use(import_rehype.default, {
     themes: { light: "github-light", dark: "github-dark" },
     defaultColor: false,
     langAlias: LANG_ALIASES,
@@ -1351,7 +1394,12 @@ function findNode(nodes, slug) {
 async function resolvePage(coll, slug) {
   try {
     const art = await readArticle(coll, slug);
-    const { html, toc } = await renderArticle(art.body);
+    const { html, toc } = await renderArticle(art.body, {
+      coll: art.coll,
+      slug: art.slug,
+      isIndex: art.isIndex
+    });
+    const { created, updated } = await fileTimestamps(art.path);
     return {
       kind: "doc",
       coll: art.coll,
@@ -1360,7 +1408,9 @@ async function resolvePage(coll, slug) {
       tags: art.tags,
       html,
       toc,
-      path: `/${art.coll}/${art.slug}`
+      path: `/${art.coll}/${art.slug}`,
+      created,
+      updated
     };
   } catch (err) {
     if (err instanceof CollectionNotFoundError) return null;
@@ -1418,8 +1468,8 @@ function resolveCollectionSelection(all, sel = {}) {
 }
 
 // src/query.ts
-var import_promises8 = __toESM(require("fs/promises"), 1);
-var import_node_path7 = __toESM(require("path"), 1);
+var import_promises9 = __toESM(require("fs/promises"), 1);
+var import_node_path8 = __toESM(require("path"), 1);
 init_collections();
 init_errors();
 init_logger();
@@ -1488,13 +1538,13 @@ var log2 = getLogger("query");
 async function collectMarkdownFiles(dir) {
   let entries;
   try {
-    entries = await import_promises8.default.readdir(dir, { withFileTypes: true });
+    entries = await import_promises9.default.readdir(dir, { withFileTypes: true });
   } catch {
     return [];
   }
   const files = [];
   for (const entry of entries) {
-    const full = import_node_path7.default.join(dir, entry.name);
+    const full = import_node_path8.default.join(dir, entry.name);
     if (entry.isDirectory()) {
       files.push(...await collectMarkdownFiles(full));
     } else if (entry.isFile() && /\.mdx?$/.test(entry.name)) {
@@ -1513,12 +1563,12 @@ async function nativeSearch(term, collections, collection) {
   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?$/, "");
+      const fallbackTitle = import_node_path8.default.basename(full).replace(/\.mdx?$/, "");
       let title = fallbackTitle;
       let tags = [];
       let body = "";
       try {
-        const parsed = parseArticle(await import_promises8.default.readFile(full, "utf8"));
+        const parsed = parseArticle(await import_promises9.default.readFile(full, "utf8"));
         if (parsed.title) title = parsed.title;
         tags = parsed.tags;
         body = parsed.body;
@@ -1601,13 +1651,13 @@ async function query(term, opts) {
 }
 
 // src/search.ts
-var import_promises9 = __toESM(require("fs/promises"), 1);
-var import_node_path8 = __toESM(require("path"), 1);
+var import_promises10 = __toESM(require("fs/promises"), 1);
+var import_node_path9 = __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"));
+      const parsed = parseArticle(await import_promises10.default.readFile(import_node_path9.default.join(collDir, `${slug}${ext}`), "utf8"));
       return { tags: parsed.tags, body: parsed.body };
     } catch {
     }
@@ -1641,7 +1691,7 @@ async function buildSearchIndex(collection) {
   for (const e of entries) {
     try {
       const collEntry = await findCollection(e.name);
-      const collDir = import_node_path8.default.resolve(collEntry?.path ?? e.path);
+      const collDir = import_node_path9.default.resolve(collEntry?.path ?? e.path);
       await flatten(e.name, collDir, await listArticleTree(e.name), out);
     } catch {
     }
@@ -1650,15 +1700,15 @@ async function buildSearchIndex(collection) {
 }
 
 // src/doctor.ts
-var import_promises11 = __toESM(require("fs/promises"), 1);
+var import_promises12 = __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_promises11 = __toESM(require("fs/promises"), 1);
 var import_node_os2 = __toESM(require("os"), 1);
-var import_node_path10 = __toESM(require("path"), 1);
+var import_node_path11 = __toESM(require("path"), 1);
 init_paths();
 init_errors();
 init_collections();
@@ -1669,7 +1719,7 @@ init_host();
 var import_node_child_process4 = require("child_process");
 var import_node_util3 = require("util");
 var import_node_fs = require("fs");
-var import_node_path9 = require("path");
+var import_node_path10 = require("path");
 var import_node_url = require("url");
 var execFileAsync3 = (0, import_node_util3.promisify)(import_node_child_process4.execFile);
 async function runProcess(file, args, opts) {
@@ -1685,7 +1735,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_promises11.default.readFile(file, "utf8"));
   } catch {
     return null;
   }
@@ -1701,7 +1751,7 @@ function binOf(manifest) {
 async function pluginManifestDirs(nodeModules) {
   let entries;
   try {
-    entries = await import_promises10.default.readdir(nodeModules);
+    entries = await import_promises11.default.readdir(nodeModules);
   } catch {
     return [];
   }
@@ -1711,44 +1761,44 @@ 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_promises11.default.readdir(import_node_path11.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_path11.default.join(nodeModules, entry, pkg));
       }
     } else {
-      dirs.push(import_node_path10.default.join(nodeModules, entry));
+      dirs.push(import_node_path11.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_promises11.default.mkdir(dir, { recursive: true });
+  const pkgPath = import_node_path11.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_promises11.default.writeFile(pkgPath, `${JSON.stringify(pkg, null, 2)}
 `, "utf8");
   }
   return dir;
 }
 async function asSearchPackage(pkgDir) {
-  const manifest = await readPackageJson(import_node_path10.default.join(pkgDir, "package.json"));
+  const manifest = await readPackageJson(import_node_path11.default.join(pkgDir, "package.json"));
   if (!manifest?.name || manifest.diffwiki?.kind !== "search") return null;
   const bin = binOf(manifest);
   if (!bin) return null;
-  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_path11.default.resolve(pkgDir, bin) };
 }
 async function packageNameFromSpec(spec) {
   const looksLikePath = spec.startsWith(".") || spec.startsWith("/") || spec.startsWith("~") || spec.startsWith("file:");
   if (looksLikePath) {
     const raw = spec.startsWith("file:") ? spec.slice("file:".length) : spec;
-    const abs = import_node_path10.default.resolve(raw.replace(/^~(?=$|\/)/, import_node_os2.default.homedir()));
-    return (await readPackageJson(import_node_path10.default.join(abs, "package.json")))?.name ?? null;
+    const abs = import_node_path11.default.resolve(raw.replace(/^~(?=$|\/)/, import_node_os2.default.homedir()));
+    return (await readPackageJson(import_node_path11.default.join(abs, "package.json")))?.name ?? null;
   }
   if (/^(git\+|git:|https?:|ssh:)/.test(spec)) return null;
   if (spec.startsWith("@")) {
@@ -1759,10 +1809,10 @@ async function packageNameFromSpec(spec) {
   return at <= 0 ? spec : spec.slice(0, at);
 }
 async function resolveSearchPackage(dir, name) {
-  return asSearchPackage(import_node_path10.default.join(dir, "node_modules", ...name.split("/")));
+  return asSearchPackage(import_node_path11.default.join(dir, "node_modules", ...name.split("/")));
 }
 async function discoverSearchPackage(dir) {
-  const nodeModules = import_node_path10.default.join(dir, "node_modules");
+  const nodeModules = import_node_path11.default.join(dir, "node_modules");
   for (const pkgDir of await pluginManifestDirs(nodeModules)) {
     const found = await asSearchPackage(pkgDir);
     if (found) return found;
@@ -1894,7 +1944,7 @@ init_host();
 init_types();
 async function exists(target) {
   try {
-    await import_promises11.default.access(target);
+    await import_promises12.default.access(target);
     return true;
   } catch {
     return false;
@@ -2061,6 +2111,7 @@ init_registry2();
   emitPluginEvent,
   ensureGitRepo,
   ensurePluginRoot,
+  fileTimestamps,
   findCollection,
   findCollectionById,
   findEnabledPlugin,

package/dist/index.d.cts

@@ -60,6 +60,13 @@ interface ArticleContent {
     body: string;
     /** Absolute path to the file on disk. */
     path: string;
+    /**
+     * True when the resolved file is a folder-index page (`<slug>/index.md` or
+     * `<slug>/README.md`) rather than a leaf `<slug>.md`. The route slug is the
+     * same for both, so this flag is needed to resolve folder-local relative
+     * links against the article's own folder.
+     */
+    isIndex: boolean;
 }
 type PluginKind = 'search';
 declare const NATIVE_ENGINE = "native";
@@ -181,6 +188,10 @@ interface DocData {
     html: string;
     toc: TocItem[];
     path: string;
+    /** ISO-8601 creation date, sourced from git history / filesystem (not frontmatter). */
+    created?: string;
+    /** ISO-8601 last-update date, sourced from git history / filesystem (not frontmatter). */
+    updated?: string;
 }
 interface ListingEntry {
     name: string;
@@ -261,8 +272,6 @@ interface ParsedArticle {
 interface SerializableArticle {
     title: string;
     tags: string[];
-    created?: string;
-    updated?: string;
     body: string;
 }
 declare function parseArticle(raw: string): ParsedArticle;
@@ -369,6 +378,23 @@ interface UpstreamStatus {
 declare function upstreamStatus(cwd: string): Promise<UpstreamStatus>;
 /** Ensure `cwd` is inside a git repo, running `git init` if not. Returns the toplevel. */
 declare function ensureGitRepo(cwd: string): Promise<string>;
+interface FileTimestamps {
+    /** ISO-8601 creation date — git first-add commit, else filesystem birthtime. */
+    created?: string;
+    /** ISO-8601 update date — git last commit, else filesystem mtime. */
+    updated?: string;
+}
+/**
+ * Creation/update timestamps for a file, preferring git history (stable across
+ * clones and worktrees) and falling back to filesystem stat. Git created date is
+ * the earliest add-commit (`--follow` tracks renames); updated is the latest
+ * commit touching the file. When git yields nothing (untracked / no repo), uses
+ * birthtime/mtime. Never throws — returns `{}` if even stat fails.
+ *
+ * Results are memoised per absolute path (process-scoped) and the two git
+ * `log` execs run concurrently, since this runs in the render request path.
+ */
+declare function fileTimestamps(absPath: string): Promise<FileTimestamps>;
 
 /** Map core article nodes to UI nav nodes, assigning each its route path. */
 declare function toTreeNodes(coll: string, nodes: ArticleNode[]): TreeNode[];
@@ -577,6 +603,19 @@ declare function listArticleTree(coll: string): Promise<ArticleNode[]>;
  */
 declare function readArticle(coll: string, slug: string): Promise<ArticleContent>;
 
+/** Route context for an article being rendered — used to resolve relative links. */
+interface RenderContext {
+    /** Collection name (first route segment). */
+    coll: string;
+    /** Article route slug (path within the collection, no extension), e.g. "a/b/deep". */
+    slug: string;
+    /**
+     * True when the source file is a folder-index page (`<slug>/index.md`). Such a
+     * page shares its route slug with the folder, so relative links must resolve
+     * against the folder itself, not its parent. Defaults to false (leaf page).
+     */
+    isIndex?: boolean;
+}
 /** The result of rendering an article body to HTML. */
 interface RenderedArticle {
     /** Fully-rendered, Shiki-highlighted HTML — mounted directly on the client (no eval). */
@@ -586,12 +625,13 @@ interface RenderedArticle {
 }
 /**
  * Render an article body (markdown) to Shiki-highlighted HTML plus its table of
- * contents. Runs entirely server-side; the client mounts the HTML directly with
+ * contents, rewriting relative links to in-app routes via `ctx`.
+ * Runs entirely server-side; the client mounts the HTML directly with
  * no `eval`/`new Function`, so it works under a strict CSP. Code is highlighted
  * here (dual github-light/github-dark via CSS variables); mermaid fences are
  * marked for client rendering.
  */
-declare function renderArticle(body: string): Promise<RenderedArticle>;
+declare function renderArticle(body: string, ctx: RenderContext): Promise<RenderedArticle>;
 
 /**
  * Host-side plugin invocation and search-provider loading.
@@ -762,4 +802,4 @@ declare function findEnabledPlugin(kind: PluginKind, name?: string): Promise<Plu
 /** Find a plugin record by name (regardless of enabled state). */
 declare function findPluginRecord(name: string): Promise<PluginRecord | undefined>;
 
-export { type AddExternalOptions, type Article, type ArticleContent, type ArticleNode, ArticleNotFoundError, CollectionAlreadyAddedError, type CollectionEntry, CollectionExistsError, type CollectionGitStatus, type CollectionInfo, CollectionNotFoundError, type CollectionSelection, type CollectionSelectionResult, type CollectionTree, type CollectionType, type Config, type Diagnostic, type DiagnosticLevel, DiffwikiError, type DiffwikiLogLevel, type DocData, type InitOptions, type InstallOutcome, InvalidExportSelectionError, InvalidTargetError, type KnownPlugin, type ListingEntry, NATIVE_ENGINE, NoDefaultCollectionError, type NodeMeta, type PageData, type ParsedArticle, type PluginCapabilities, PluginError, type PluginEvent, type PluginHealth, type PluginKind, type PluginReadiness, type PluginRecord, type PluginRegistryFile, type QueryHit, type QueryOptions, REPO_CONFIG_FILE, type Registry, type RenderedArticle, type RepoConfig, SearchDoc, type SearchMode, type SearchOutcome, type SearchProvider, type SerializableArticle, type SetupOutcome, type SetupStep, type TocItem, type TreeNode, type UpstreamStatus, 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, listEnabledPlugins, listPlugins, listSearchModes, loadSearchProvider, nativeSearch, parseAddTarget, parseArticle, parsePathTarget, pluginsDir, pluginsRegistryPath, query, readArticle, readConfig, readPluginRegistry, readRegistry, readRepoConfig, registerCollection, registerPlugin, registryPath, removeArticle, removeCollection, removePlugin, removeTags, renderArticle, repoId, repoRemoteName, resolveCollectionSelection, resolveCwdCollection, resolveDefaultSearchMode, resolveHome, resolveLogLevel, resolvePage, search, serializeArticle, setConfigValue, setTags, slugify, toTreeNodes, unregisterCollection, updateArticleBody, upsertPlugin, upstreamStatus, writeConfig, writePluginRegistry, writeRegistry };
+export { type AddExternalOptions, type Article, type ArticleContent, type ArticleNode, ArticleNotFoundError, CollectionAlreadyAddedError, type CollectionEntry, CollectionExistsError, type CollectionGitStatus, type CollectionInfo, CollectionNotFoundError, type CollectionSelection, type CollectionSelectionResult, type CollectionTree, type CollectionType, type Config, type Diagnostic, type DiagnosticLevel, DiffwikiError, type DiffwikiLogLevel, type DocData, type FileTimestamps, type InitOptions, type InstallOutcome, InvalidExportSelectionError, InvalidTargetError, type KnownPlugin, type ListingEntry, NATIVE_ENGINE, NoDefaultCollectionError, type NodeMeta, type PageData, type ParsedArticle, type PluginCapabilities, PluginError, type PluginEvent, type PluginHealth, type PluginKind, type PluginReadiness, type PluginRecord, type PluginRegistryFile, type QueryHit, type QueryOptions, REPO_CONFIG_FILE, type Registry, type RenderContext, type RenderedArticle, type RepoConfig, SearchDoc, type SearchMode, type SearchOutcome, type SearchProvider, type SerializableArticle, type SetupOutcome, type SetupStep, type TocItem, type TreeNode, type UpstreamStatus, WorktreeNotAllowedError, addExternalCollection, addTags, buildArticleTree, buildCollections, buildNavTree, buildSearchIndex, collectionDir, collectionGitStatus, collectionsDir, configPath, createArticle, createCollection, currentBranch, deregisterPlugin, doctor, emitPluginEvent, ensureGitRepo, ensurePluginRoot, fileTimestamps, findCollection, findCollectionById, findEnabledPlugin, findPluginRecord, getConfigValue, getLogger, gitToplevel, initRepoWiki, installPlugin, isLinkedWorktree, listArticleTree, listAvailablePlugins, listCollections, listEnabledPlugins, listPlugins, listSearchModes, loadSearchProvider, nativeSearch, parseAddTarget, parseArticle, parsePathTarget, pluginsDir, pluginsRegistryPath, query, readArticle, readConfig, readPluginRegistry, readRegistry, readRepoConfig, registerCollection, registerPlugin, registryPath, removeArticle, removeCollection, removePlugin, removeTags, renderArticle, repoId, repoRemoteName, resolveCollectionSelection, resolveCwdCollection, resolveDefaultSearchMode, resolveHome, resolveLogLevel, resolvePage, search, serializeArticle, setConfigValue, setTags, slugify, toTreeNodes, unregisterCollection, updateArticleBody, upsertPlugin, upstreamStatus, writeConfig, writePluginRegistry, writeRegistry };

package/dist/index.d.ts

@@ -60,6 +60,13 @@ interface ArticleContent {
     body: string;
     /** Absolute path to the file on disk. */
     path: string;
+    /**
+     * True when the resolved file is a folder-index page (`<slug>/index.md` or
+     * `<slug>/README.md`) rather than a leaf `<slug>.md`. The route slug is the
+     * same for both, so this flag is needed to resolve folder-local relative
+     * links against the article's own folder.
+     */
+    isIndex: boolean;
 }
 type PluginKind = 'search';
 declare const NATIVE_ENGINE = "native";
@@ -181,6 +188,10 @@ interface DocData {
     html: string;
     toc: TocItem[];
     path: string;
+    /** ISO-8601 creation date, sourced from git history / filesystem (not frontmatter). */
+    created?: string;
+    /** ISO-8601 last-update date, sourced from git history / filesystem (not frontmatter). */
+    updated?: string;
 }
 interface ListingEntry {
     name: string;
@@ -261,8 +272,6 @@ interface ParsedArticle {
 interface SerializableArticle {
     title: string;
     tags: string[];
-    created?: string;
-    updated?: string;
     body: string;
 }
 declare function parseArticle(raw: string): ParsedArticle;
@@ -369,6 +378,23 @@ interface UpstreamStatus {
 declare function upstreamStatus(cwd: string): Promise<UpstreamStatus>;
 /** Ensure `cwd` is inside a git repo, running `git init` if not. Returns the toplevel. */
 declare function ensureGitRepo(cwd: string): Promise<string>;
+interface FileTimestamps {
+    /** ISO-8601 creation date — git first-add commit, else filesystem birthtime. */
+    created?: string;
+    /** ISO-8601 update date — git last commit, else filesystem mtime. */
+    updated?: string;
+}
+/**
+ * Creation/update timestamps for a file, preferring git history (stable across
+ * clones and worktrees) and falling back to filesystem stat. Git created date is
+ * the earliest add-commit (`--follow` tracks renames); updated is the latest
+ * commit touching the file. When git yields nothing (untracked / no repo), uses
+ * birthtime/mtime. Never throws — returns `{}` if even stat fails.
+ *
+ * Results are memoised per absolute path (process-scoped) and the two git
+ * `log` execs run concurrently, since this runs in the render request path.
+ */
+declare function fileTimestamps(absPath: string): Promise<FileTimestamps>;
 
 /** Map core article nodes to UI nav nodes, assigning each its route path. */
 declare function toTreeNodes(coll: string, nodes: ArticleNode[]): TreeNode[];
@@ -577,6 +603,19 @@ declare function listArticleTree(coll: string): Promise<ArticleNode[]>;
  */
 declare function readArticle(coll: string, slug: string): Promise<ArticleContent>;
 
+/** Route context for an article being rendered — used to resolve relative links. */
+interface RenderContext {
+    /** Collection name (first route segment). */
+    coll: string;
+    /** Article route slug (path within the collection, no extension), e.g. "a/b/deep". */
+    slug: string;
+    /**
+     * True when the source file is a folder-index page (`<slug>/index.md`). Such a
+     * page shares its route slug with the folder, so relative links must resolve
+     * against the folder itself, not its parent. Defaults to false (leaf page).
+     */
+    isIndex?: boolean;
+}
 /** The result of rendering an article body to HTML. */
 interface RenderedArticle {
     /** Fully-rendered, Shiki-highlighted HTML — mounted directly on the client (no eval). */
@@ -586,12 +625,13 @@ interface RenderedArticle {
 }
 /**
  * Render an article body (markdown) to Shiki-highlighted HTML plus its table of
- * contents. Runs entirely server-side; the client mounts the HTML directly with
+ * contents, rewriting relative links to in-app routes via `ctx`.
+ * Runs entirely server-side; the client mounts the HTML directly with
  * no `eval`/`new Function`, so it works under a strict CSP. Code is highlighted
  * here (dual github-light/github-dark via CSS variables); mermaid fences are
  * marked for client rendering.
  */
-declare function renderArticle(body: string): Promise<RenderedArticle>;
+declare function renderArticle(body: string, ctx: RenderContext): Promise<RenderedArticle>;
 
 /**
  * Host-side plugin invocation and search-provider loading.
@@ -762,4 +802,4 @@ declare function findEnabledPlugin(kind: PluginKind, name?: string): Promise<Plu
 /** Find a plugin record by name (regardless of enabled state). */
 declare function findPluginRecord(name: string): Promise<PluginRecord | undefined>;
 
-export { type AddExternalOptions, type Article, type ArticleContent, type ArticleNode, ArticleNotFoundError, CollectionAlreadyAddedError, type CollectionEntry, CollectionExistsError, type CollectionGitStatus, type CollectionInfo, CollectionNotFoundError, type CollectionSelection, type CollectionSelectionResult, type CollectionTree, type CollectionType, type Config, type Diagnostic, type DiagnosticLevel, DiffwikiError, type DiffwikiLogLevel, type DocData, type InitOptions, type InstallOutcome, InvalidExportSelectionError, InvalidTargetError, type KnownPlugin, type ListingEntry, NATIVE_ENGINE, NoDefaultCollectionError, type NodeMeta, type PageData, type ParsedArticle, type PluginCapabilities, PluginError, type PluginEvent, type PluginHealth, type PluginKind, type PluginReadiness, type PluginRecord, type PluginRegistryFile, type QueryHit, type QueryOptions, REPO_CONFIG_FILE, type Registry, type RenderedArticle, type RepoConfig, SearchDoc, type SearchMode, type SearchOutcome, type SearchProvider, type SerializableArticle, type SetupOutcome, type SetupStep, type TocItem, type TreeNode, type UpstreamStatus, 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, listEnabledPlugins, listPlugins, listSearchModes, loadSearchProvider, nativeSearch, parseAddTarget, parseArticle, parsePathTarget, pluginsDir, pluginsRegistryPath, query, readArticle, readConfig, readPluginRegistry, readRegistry, readRepoConfig, registerCollection, registerPlugin, registryPath, removeArticle, removeCollection, removePlugin, removeTags, renderArticle, repoId, repoRemoteName, resolveCollectionSelection, resolveCwdCollection, resolveDefaultSearchMode, resolveHome, resolveLogLevel, resolvePage, search, serializeArticle, setConfigValue, setTags, slugify, toTreeNodes, unregisterCollection, updateArticleBody, upsertPlugin, upstreamStatus, writeConfig, writePluginRegistry, writeRegistry };
+export { type AddExternalOptions, type Article, type ArticleContent, type ArticleNode, ArticleNotFoundError, CollectionAlreadyAddedError, type CollectionEntry, CollectionExistsError, type CollectionGitStatus, type CollectionInfo, CollectionNotFoundError, type CollectionSelection, type CollectionSelectionResult, type CollectionTree, type CollectionType, type Config, type Diagnostic, type DiagnosticLevel, DiffwikiError, type DiffwikiLogLevel, type DocData, type FileTimestamps, type InitOptions, type InstallOutcome, InvalidExportSelectionError, InvalidTargetError, type KnownPlugin, type ListingEntry, NATIVE_ENGINE, NoDefaultCollectionError, type NodeMeta, type PageData, type ParsedArticle, type PluginCapabilities, PluginError, type PluginEvent, type PluginHealth, type PluginKind, type PluginReadiness, type PluginRecord, type PluginRegistryFile, type QueryHit, type QueryOptions, REPO_CONFIG_FILE, type Registry, type RenderContext, type RenderedArticle, type RepoConfig, SearchDoc, type SearchMode, type SearchOutcome, type SearchProvider, type SerializableArticle, type SetupOutcome, type SetupStep, type TocItem, type TreeNode, type UpstreamStatus, WorktreeNotAllowedError, addExternalCollection, addTags, buildArticleTree, buildCollections, buildNavTree, buildSearchIndex, collectionDir, collectionGitStatus, collectionsDir, configPath, createArticle, createCollection, currentBranch, deregisterPlugin, doctor, emitPluginEvent, ensureGitRepo, ensurePluginRoot, fileTimestamps, findCollection, findCollectionById, findEnabledPlugin, findPluginRecord, getConfigValue, getLogger, gitToplevel, initRepoWiki, installPlugin, isLinkedWorktree, listArticleTree, listAvailablePlugins, listCollections, listEnabledPlugins, listPlugins, listSearchModes, loadSearchProvider, nativeSearch, parseAddTarget, parseArticle, parsePathTarget, pluginsDir, pluginsRegistryPath, query, readArticle, readConfig, readPluginRegistry, readRegistry, readRepoConfig, registerCollection, registerPlugin, registryPath, removeArticle, removeCollection, removePlugin, removeTags, renderArticle, repoId, repoRemoteName, resolveCollectionSelection, resolveCwdCollection, resolveDefaultSearchMode, resolveHome, resolveLogLevel, resolvePage, search, serializeArticle, setConfigValue, setTags, slugify, toTreeNodes, unregisterCollection, updateArticleBody, upsertPlugin, upstreamStatus, writeConfig, writePluginRegistry, writeRegistry };

package/dist/index.js

@@ -139,8 +139,6 @@ function parseArticle(raw) {
 }
 function serializeArticle(article) {
   const front = { title: article.title, tags: article.tags };
-  if (article.created) front.created = article.created;
-  if (article.updated) front.updated = article.updated;
   return matter.stringify(article.body, front, MATTER_OPTS);
 }
 
@@ -195,11 +193,10 @@ async function createArticle(opts) {
   const { collection, title } = parseAddTarget(opts.target);
   const { name, dir } = await resolveCollectionDir(collection);
   const filePath = path.join(dir, `${slugify(title)}.md`);
-  const now = (/* @__PURE__ */ new Date()).toISOString();
   const body = opts.body ?? `# ${title}
 `;
   await fs2.mkdir(dir, { recursive: true });
-  await fs2.writeFile(filePath, serializeArticle({ title, tags: opts.tags, created: now, updated: now, body }), "utf8");
+  await fs2.writeFile(filePath, serializeArticle({ title, tags: opts.tags, body }), "utf8");
   void fireHook("article-created", name, path.relative(dir, filePath));
   return { title, tags: opts.tags, path: filePath, collection: name };
 }
@@ -217,17 +214,7 @@ async function loadArticle(target) {
 async function updateArticleBody(target, body) {
   const { filePath, dir, raw, collection } = await loadArticle(target);
   const parsed = parseArticle(raw);
-  await fs2.writeFile(
-    filePath,
-    serializeArticle({
-      title: parsed.title,
-      tags: parsed.tags,
-      created: parsed.created,
-      updated: (/* @__PURE__ */ new Date()).toISOString(),
-      body
-    }),
-    "utf8"
-  );
+  await fs2.writeFile(filePath, serializeArticle({ title: parsed.title, tags: parsed.tags, body }), "utf8");
   void fireHook("article-updated", collection, path.relative(dir, filePath));
   return { title: parsed.title, tags: parsed.tags, path: filePath, collection };
 }
@@ -235,17 +222,7 @@ async function mutateTags(target, fn) {
   const { filePath, dir, raw, collection } = await loadArticle(target);
   const parsed = parseArticle(raw);
   const tags = fn(parsed.tags);
-  await fs2.writeFile(
-    filePath,
-    serializeArticle({
-      title: parsed.title,
-      tags,
-      created: parsed.created,
-      updated: (/* @__PURE__ */ new Date()).toISOString(),
-      body: parsed.body
-    }),
-    "utf8"
-  );
+  await fs2.writeFile(filePath, serializeArticle({ title: parsed.title, tags, body: parsed.body }), "utf8");
   void fireHook("article-updated", collection, path.relative(dir, filePath));
   return { title: parsed.title, tags, path: filePath, collection };
 }
@@ -267,13 +244,14 @@ async function removeArticle(target) {
 }
 
 // src/repo.ts
-import fs3 from "fs/promises";
+import fs4 from "fs/promises";
 import path3 from "path";
 import { execFile as execFile2 } from "child_process";
 import { promisify as promisify2 } from "util";
 import { parse as parseYaml2, stringify as stringifyYaml2 } from "yaml";
 
 // src/git.ts
+import fs3 from "fs/promises";
 import path2 from "path";
 import { execFile } from "child_process";
 import { promisify } from "util";
@@ -335,6 +313,35 @@ async function ensureGitRepo(cwd) {
   if (!after) throw new Error("git init did not produce a repository");
   return after;
 }
+function isEpochish(d) {
+  return !Number.isFinite(d.getTime()) || d.getTime() <= 0;
+}
+var timestampCache = /* @__PURE__ */ new Map();
+async function fileTimestamps(absPath) {
+  const cached = timestampCache.get(absPath);
+  if (cached) return cached;
+  const dir = path2.dirname(absPath);
+  const base = path2.basename(absPath);
+  const [addLog, lastLog] = await Promise.all([
+    git(dir, ["log", "--follow", "--diff-filter=A", "--format=%aI", "--", base]),
+    git(dir, ["log", "-1", "--format=%aI", "--", base])
+  ]);
+  const gitCreated = addLog ? addLog.split("\n").filter(Boolean).pop() : void 0;
+  const gitUpdated = lastLog || void 0;
+  let created = gitCreated;
+  let updated = gitUpdated;
+  if (!created || !updated) {
+    try {
+      const st = await fs3.stat(absPath);
+      if (!updated) updated = st.mtime.toISOString();
+      if (!created) created = isEpochish(st.birthtime) ? st.mtime.toISOString() : st.birthtime.toISOString();
+    } catch {
+    }
+  }
+  const result = { created, updated };
+  timestampCache.set(absPath, result);
+  return result;
+}
 
 // src/repo.ts
 var execFileAsync2 = promisify2(execFile2);
@@ -349,7 +356,7 @@ async function detectRepoName(cwd) {
 }
 async function readRepoConfig(cwd) {
   try {
-    const raw = await fs3.readFile(path3.join(cwd, REPO_CONFIG_FILE), "utf8");
+    const raw = await fs4.readFile(path3.join(cwd, REPO_CONFIG_FILE), "utf8");
     const parsed = parseYaml2(raw) ?? {};
     if (!parsed.path) return void 0;
     return {
@@ -379,9 +386,9 @@ async function initRepoWiki(opts) {
       n += 1;
     }
   }
-  await fs3.mkdir(absWiki, { recursive: true });
+  await fs4.mkdir(absWiki, { recursive: true });
   const config = { collection: name, path: wikiPath };
-  await fs3.writeFile(path3.join(cwd, REPO_CONFIG_FILE), stringifyYaml2(config), "utf8");
+  await fs4.writeFile(path3.join(cwd, REPO_CONFIG_FILE), stringifyYaml2(config), "utf8");
   const entry = {
     name,
     type: "repo",
@@ -450,7 +457,7 @@ async function collectionGitStatus(entry) {
 }
 
 // src/browse.ts
-import fs4 from "fs/promises";
+import fs5 from "fs/promises";
 import path4 from "path";
 var INDEX_RE = /^(index|readme)\.mdx?$/i;
 function buildArticleTree(relPaths) {
@@ -495,7 +502,7 @@ function buildArticleTree(relPaths) {
 async function collectRelPaths(dir, rel = "") {
   let dirents;
   try {
-    dirents = await fs4.readdir(dir, { withFileTypes: true });
+    dirents = await fs5.readdir(dir, { withFileTypes: true });
   } catch {
     return [];
   }
@@ -513,7 +520,7 @@ async function collectRelPaths(dir, rel = "") {
 }
 async function readdirSafe(dir) {
   try {
-    return await fs4.readdir(dir);
+    return await fs5.readdir(dir);
   } catch {
     return [];
   }
@@ -530,7 +537,7 @@ function pickIndexFile(names) {
 async function cheapTitle(absPath) {
   let handle;
   try {
-    handle = await fs4.open(absPath, "r");
+    handle = await fs5.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");
@@ -580,11 +587,12 @@ async function readArticle(coll, slug) {
   const safeSlug = normalized.split("/").filter((s) => s !== "" && s !== ".").join("/");
   const inJail = (p) => p === collDir || p.startsWith(collDir + path4.sep);
   let abs;
+  let isIndex = false;
   for (const rel of safeSlug ? [`${safeSlug}.mdx`, `${safeSlug}.md`] : []) {
     const candidate = path4.resolve(collDir, rel);
     if (!inJail(candidate)) throw new InvalidTargetError(slug, "path traversal detected");
     try {
-      await fs4.access(candidate);
+      await fs5.access(candidate);
       abs = candidate;
       break;
     } catch {
@@ -594,16 +602,20 @@ async function readArticle(coll, slug) {
     const dir = path4.resolve(collDir, safeSlug);
     if (inJail(dir)) {
       const idx = pickIndexFile(await readdirSafe(dir));
-      if (idx) abs = path4.join(dir, idx);
+      if (idx) {
+        abs = path4.join(dir, idx);
+        isIndex = true;
+      }
     }
   }
   if (!abs) throw new ArticleNotFoundError(`${coll}/${safeSlug}`);
-  const parsed = parseArticle(await fs4.readFile(abs, "utf8"));
+  const parsed = parseArticle(await fs5.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 };
+  return { coll, slug: safeSlug, title, tags: parsed.tags, body: parsed.body, path: abs, isIndex };
 }
 
 // src/render.ts
+import path5 from "path";
 import { unified } from "unified";
 import remarkParse from "remark-parse";
 import remarkGfm from "remark-gfm";
@@ -613,6 +625,36 @@ import rehypeShiki from "@shikijs/rehype";
 import rehypeStringify from "rehype-stringify";
 import { visit, SKIP } from "unist-util-visit";
 import { toString as hastToString } from "hast-util-to-string";
+function isNonRelativeHref(href) {
+  if (href === "") return true;
+  if (href.startsWith("/") || href.startsWith("#") || href.startsWith("?")) return true;
+  if (href.startsWith("//")) return true;
+  return /^[a-z][a-z0-9+.-]*:/i.test(href);
+}
+function rehypeRewriteLinks(ctx) {
+  const slugDir = ctx.isIndex ? ctx.slug || "." : path5.posix.dirname(ctx.slug || ".");
+  return (tree) => {
+    visit(tree, "element", (node) => {
+      if (node.tagName !== "a") return;
+      const raw = node.properties?.href;
+      if (typeof raw !== "string" || isNonRelativeHref(raw)) return;
+      const suffixMatch = /[#?].*$/.exec(raw);
+      const suffix = suffixMatch ? suffixMatch[0] : "";
+      const pathPart = suffix ? raw.slice(0, raw.length - suffix.length) : raw;
+      if (pathPart === "") return;
+      const joined = path5.posix.join(slugDir === "." ? "" : slugDir, pathPart);
+      const normalized = path5.posix.normalize(joined);
+      if (normalized.startsWith("..")) return;
+      let resolved = normalized.replace(/\.(mdx?)$/i, "");
+      resolved = resolved.replace(/(^|\/)(index|readme)$/i, "$1");
+      resolved = resolved.replace(/\/+$/, "").replace(/^\/+/, "");
+      node.properties = {
+        ...node.properties,
+        href: `/${ctx.coll}${resolved ? `/${resolved}` : ""}${suffix}`
+      };
+    });
+  };
+}
 var LANG_ALIASES = {
   "c#": "csharp",
   cs: "csharp",
@@ -656,9 +698,9 @@ function rehypeMarkMermaid() {
     });
   };
 }
-async function renderArticle(body) {
+async function renderArticle(body, ctx) {
   const toc = [];
-  const file = await unified().use(remarkParse).use(remarkGfm).use(remarkRehype).use(rehypeSlug).use(rehypeCollectToc, toc).use(rehypeStripLeadingH1).use(rehypeMarkMermaid).use(rehypeShiki, {
+  const file = await unified().use(remarkParse).use(remarkGfm).use(remarkRehype).use(rehypeSlug).use(rehypeCollectToc, toc).use(rehypeStripLeadingH1).use(rehypeMarkMermaid).use(rehypeRewriteLinks, ctx).use(rehypeShiki, {
     themes: { light: "github-light", dark: "github-dark" },
     defaultColor: false,
     langAlias: LANG_ALIASES,
@@ -720,7 +762,12 @@ function findNode(nodes, slug) {
 async function resolvePage(coll, slug) {
   try {
     const art = await readArticle(coll, slug);
-    const { html, toc } = await renderArticle(art.body);
+    const { html, toc } = await renderArticle(art.body, {
+      coll: art.coll,
+      slug: art.slug,
+      isIndex: art.isIndex
+    });
+    const { created, updated } = await fileTimestamps(art.path);
     return {
       kind: "doc",
       coll: art.coll,
@@ -729,7 +776,9 @@ async function resolvePage(coll, slug) {
       tags: art.tags,
       html,
       toc,
-      path: `/${art.coll}/${art.slug}`
+      path: `/${art.coll}/${art.slug}`,
+      created,
+      updated
     };
   } catch (err) {
     if (err instanceof CollectionNotFoundError) return null;
@@ -787,19 +836,19 @@ function resolveCollectionSelection(all, sel = {}) {
 }
 
 // src/query.ts
-import fs5 from "fs/promises";
-import path5 from "path";
+import fs6 from "fs/promises";
+import path6 from "path";
 var log2 = getLogger("query");
 async function collectMarkdownFiles(dir) {
   let entries;
   try {
-    entries = await fs5.readdir(dir, { withFileTypes: true });
+    entries = await fs6.readdir(dir, { withFileTypes: true });
   } catch {
     return [];
   }
   const files = [];
   for (const entry of entries) {
-    const full = path5.join(dir, entry.name);
+    const full = path6.join(dir, entry.name);
     if (entry.isDirectory()) {
       files.push(...await collectMarkdownFiles(full));
     } else if (entry.isFile() && /\.mdx?$/.test(entry.name)) {
@@ -818,12 +867,12 @@ async function nativeSearch(term, collections, collection) {
   const docs = [];
   for (const entry of targets) {
     for (const full of await collectMarkdownFiles(entry.path)) {
-      const fallbackTitle = path5.basename(full).replace(/\.mdx?$/, "");
+      const fallbackTitle = path6.basename(full).replace(/\.mdx?$/, "");
       let title = fallbackTitle;
       let tags = [];
       let body = "";
       try {
-        const parsed = parseArticle(await fs5.readFile(full, "utf8"));
+        const parsed = parseArticle(await fs6.readFile(full, "utf8"));
         if (parsed.title) title = parsed.title;
         tags = parsed.tags;
         body = parsed.body;
@@ -906,12 +955,12 @@ async function query(term, opts) {
 }
 
 // src/search.ts
-import fs6 from "fs/promises";
-import path6 from "path";
+import fs7 from "fs/promises";
+import path7 from "path";
 async function readArticleParts(collDir, slug) {
   for (const ext of [".mdx", ".md"]) {
     try {
-      const parsed = parseArticle(await fs6.readFile(path6.join(collDir, `${slug}${ext}`), "utf8"));
+      const parsed = parseArticle(await fs7.readFile(path7.join(collDir, `${slug}${ext}`), "utf8"));
       return { tags: parsed.tags, body: parsed.body };
     } catch {
     }
@@ -945,7 +994,7 @@ async function buildSearchIndex(collection) {
   for (const e of entries) {
     try {
       const collEntry = await findCollection(e.name);
-      const collDir = path6.resolve(collEntry?.path ?? e.path);
+      const collDir = path7.resolve(collEntry?.path ?? e.path);
       await flatten(e.name, collDir, await listArticleTree(e.name), out);
     } catch {
     }
@@ -954,15 +1003,15 @@ async function buildSearchIndex(collection) {
 }
 
 // src/doctor.ts
-import fs8 from "fs/promises";
+import fs9 from "fs/promises";
 
 // src/plugins/manager.ts
-import fs7 from "fs/promises";
+import fs8 from "fs/promises";
 import os from "os";
-import path7 from "path";
+import path8 from "path";
 async function readPackageJson(file) {
   try {
-    return JSON.parse(await fs7.readFile(file, "utf8"));
+    return JSON.parse(await fs8.readFile(file, "utf8"));
   } catch {
     return null;
   }
@@ -978,7 +1027,7 @@ function binOf(manifest) {
 async function pluginManifestDirs(nodeModules) {
   let entries;
   try {
-    entries = await fs7.readdir(nodeModules);
+    entries = await fs8.readdir(nodeModules);
   } catch {
     return [];
   }
@@ -988,44 +1037,44 @@ async function pluginManifestDirs(nodeModules) {
     if (entry.startsWith("@")) {
       let scoped;
       try {
-        scoped = await fs7.readdir(path7.join(nodeModules, entry));
+        scoped = await fs8.readdir(path8.join(nodeModules, entry));
       } catch {
         continue;
       }
       for (const pkg of scoped) {
         if (pkg.startsWith(".")) continue;
-        dirs.push(path7.join(nodeModules, entry, pkg));
+        dirs.push(path8.join(nodeModules, entry, pkg));
       }
     } else {
-      dirs.push(path7.join(nodeModules, entry));
+      dirs.push(path8.join(nodeModules, entry));
     }
   }
   return dirs;
 }
 async function ensurePluginRoot() {
   const dir = pluginsDir();
-  await fs7.mkdir(dir, { recursive: true });
-  const pkgPath = path7.join(dir, "package.json");
+  await fs8.mkdir(dir, { recursive: true });
+  const pkgPath = path8.join(dir, "package.json");
   if (await readPackageJson(pkgPath) === null) {
     const pkg = { name: "diffwiki-plugins", private: true, version: "0.0.0" };
-    await fs7.writeFile(pkgPath, `${JSON.stringify(pkg, null, 2)}
+    await fs8.writeFile(pkgPath, `${JSON.stringify(pkg, null, 2)}
 `, "utf8");
   }
   return dir;
 }
 async function asSearchPackage(pkgDir) {
-  const manifest = await readPackageJson(path7.join(pkgDir, "package.json"));
+  const manifest = await readPackageJson(path8.join(pkgDir, "package.json"));
   if (!manifest?.name || manifest.diffwiki?.kind !== "search") return null;
   const bin = binOf(manifest);
   if (!bin) return null;
-  return { name: manifest.name, version: manifest.version, binAbs: path7.resolve(pkgDir, bin) };
+  return { name: manifest.name, version: manifest.version, binAbs: path8.resolve(pkgDir, bin) };
 }
 async function packageNameFromSpec(spec) {
   const looksLikePath = spec.startsWith(".") || spec.startsWith("/") || spec.startsWith("~") || spec.startsWith("file:");
   if (looksLikePath) {
     const raw = spec.startsWith("file:") ? spec.slice("file:".length) : spec;
-    const abs = path7.resolve(raw.replace(/^~(?=$|\/)/, os.homedir()));
-    return (await readPackageJson(path7.join(abs, "package.json")))?.name ?? null;
+    const abs = path8.resolve(raw.replace(/^~(?=$|\/)/, os.homedir()));
+    return (await readPackageJson(path8.join(abs, "package.json")))?.name ?? null;
   }
   if (/^(git\+|git:|https?:|ssh:)/.test(spec)) return null;
   if (spec.startsWith("@")) {
@@ -1036,10 +1085,10 @@ async function packageNameFromSpec(spec) {
   return at <= 0 ? spec : spec.slice(0, at);
 }
 async function resolveSearchPackage(dir, name) {
-  return asSearchPackage(path7.join(dir, "node_modules", ...name.split("/")));
+  return asSearchPackage(path8.join(dir, "node_modules", ...name.split("/")));
 }
 async function discoverSearchPackage(dir) {
-  const nodeModules = path7.join(dir, "node_modules");
+  const nodeModules = path8.join(dir, "node_modules");
   for (const pkgDir of await pluginManifestDirs(nodeModules)) {
     const found = await asSearchPackage(pkgDir);
     if (found) return found;
@@ -1169,7 +1218,7 @@ async function listPlugins() {
 // src/doctor.ts
 async function exists(target) {
   try {
-    await fs8.access(target);
+    await fs9.access(target);
     return true;
   } catch {
     return false;
@@ -1325,6 +1374,7 @@ export {
   emitPluginEvent,
   ensureGitRepo,
   ensurePluginRoot,
+  fileTimestamps,
   findCollection,
   findCollectionById,
   findEnabledPlugin,

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "diffwiki-core",
-  "version": "0.6.0",
+  "version": "0.6.1",
   "description": "Core configuration, registry, and article management for diffwiki",
   "license": "MIT",
   "type": "module",