@mulmoclaude/core 0.4.0 → 0.5.1

package/dist/wiki/server/index.cjs

@@ -1,30 +1,250 @@
 Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
 const require_rolldown_runtime = require("../../rolldown-runtime-D6vf50IK.cjs");
+const require_graph = require("../../graph-2R4HbQAg.cjs");
 const require_slug = require("../../slug-DbwORN9z.cjs");
+const require_wiki_paths = require("../paths.cjs");
 let node_path = require("node:path");
 node_path = require_rolldown_runtime.__toESM(node_path, 1);
-//#region src/wiki/server/paths.ts
-/** Given an absolute path and the absolute `pagesDir`, return the
-*  slug if `absPath` is a direct `.md` child of `pagesDir`, else
-*  null. Pure path-string math — no fs IO, no symlink resolution.
-*
-*  Caller responsibility: pass already-realpath'd values for both
-*  arguments. Mixing a realpath'd `absPath` with a symlinked
-*  `pagesDir` (or vice versa) silently mismatches because
-*  `path.relative` is plain string arithmetic. The trap caused
-*  #883 review-iter-1 — a symlinked workspace silently routed
-*  wiki writes through the generic writer. */
-function wikiSlugFromAbsPath(absPath, pagesDir) {
-	const rel = node_path.default.relative(pagesDir, absPath);
-	if (rel.length === 0) return null;
-	if (node_path.default.isAbsolute(rel)) return null;
-	if (rel.includes(node_path.default.sep)) return null;
-	if (!rel.endsWith(".md")) return null;
-	const slug = rel.slice(0, -3);
-	if (!require_slug.isSafeSlug(slug)) return null;
-	return slug;
+let node_fs = require("node:fs");
+let node_fs_promises = require("node:fs/promises");
+let js_yaml = require("js-yaml");
+//#region src/wiki/server/fs.ts
+async function readTextSafe(absPath) {
+	try {
+		return await (0, node_fs_promises.readFile)(absPath, "utf-8");
+	} catch {
+		return null;
+	}
+}
+function readTextSafeSync(absPath) {
+	try {
+		return (0, node_fs.readFileSync)(absPath, "utf-8");
+	} catch {
+		return null;
+	}
+}
+async function statSafeAsync(absPath) {
+	try {
+		return await (0, node_fs_promises.stat)(absPath);
+	} catch {
+		return null;
+	}
+}
+async function readDirSafeAsync(absPath) {
+	try {
+		return await (0, node_fs_promises.readdir)(absPath, { withFileTypes: true });
+	} catch {
+		return [];
+	}
+}
+//#endregion
+//#region src/wiki/server/pageIndex.ts
+var cache = /* @__PURE__ */ new Map();
+/**
+* Get the page index for `pagesDir`. Returns a cached value as long as
+* THAT directory's mtime hasn't advanced; otherwise rebuilds. Safe to
+* call concurrently — racing builds produce the same result.
+*/
+async function getPageIndex(pagesDir) {
+	const stat = await statSafeAsync(pagesDir);
+	if (!stat) return {
+		mtimeMs: 0,
+		slugs: /* @__PURE__ */ new Map()
+	};
+	const cached = cache.get(pagesDir);
+	if (cached && cached.mtimeMs >= stat.mtimeMs) return cached;
+	const entries = await readDirSafeAsync(pagesDir);
+	const slugs = /* @__PURE__ */ new Map();
+	for (const entry of entries) {
+		if (!entry.isFile()) continue;
+		const { name } = entry;
+		if (!name.endsWith(".md")) continue;
+		slugs.set(name.slice(0, -3), name);
+	}
+	const built = {
+		mtimeMs: stat.mtimeMs,
+		slugs
+	};
+	cache.set(pagesDir, built);
+	return built;
+}
+/** Test-only: drop the module-level cache (all directories). */
+function __resetPageIndexCache() {
+	cache.clear();
+}
+//#endregion
+//#region src/wiki/server/frontmatter.ts
+var FRONTMATTER_OPEN = /^---\r?\n/;
+var FRONTMATTER_CLOSE = /(?:^|\r?\n)---\s*(?:\r?\n|$)/;
+/** Parse `---\n…\n---\n` frontmatter. Never throws; malformed YAML in a
+*  well-formed envelope yields `{ meta: {}, hasHeader: false }`. */
+function parseFrontmatter(raw) {
+	if (!FRONTMATTER_OPEN.test(raw)) return {
+		meta: {},
+		hasHeader: false
+	};
+	const afterOpen = raw.replace(FRONTMATTER_OPEN, "");
+	const closeMatch = FRONTMATTER_CLOSE.exec(afterOpen);
+	if (!closeMatch || closeMatch.index === void 0) return {
+		meta: {},
+		hasHeader: false
+	};
+	const meta = safeYamlLoad(afterOpen.slice(0, closeMatch.index));
+	if (meta === null) return {
+		meta: {},
+		hasHeader: false
+	};
+	return {
+		meta,
+		hasHeader: true
+	};
+}
+function safeYamlLoad(text) {
+	if (text.trim() === "") return {};
+	try {
+		const loaded = (0, js_yaml.load)(text, { schema: js_yaml.FAILSAFE_SCHEMA });
+		if (loaded === null || loaded === void 0) return {};
+		if (typeof loaded !== "object" || Array.isArray(loaded)) return null;
+		return loaded;
+	} catch {
+		return null;
+	}
+}
+function cleanTagToken(token) {
+	return token.trim().replace(/^['"]|['"]$/g, "").replace(/^#/, "").toLowerCase();
+}
+/** Narrow `tags:` reader. Handles flow (`tags: [a, b]`) and block-list
+*  style; anything unparseable returns `[]` (best-effort, never throws). */
+function parseFrontmatterTags(content) {
+	const parsed = parseFrontmatter(content);
+	if (!parsed.hasHeader) return [];
+	const tagsValue = parsed.meta.tags;
+	if (!Array.isArray(tagsValue)) return [];
+	return tagsValue.filter((item) => typeof item === "string").map(cleanTagToken).filter((token) => token.length > 0);
+}
+//#endregion
+//#region src/wiki/server/engine.ts
+var MIN_FUZZY_SLUG_LEN = 6;
+function readFileOrEmpty(absPath) {
+	return readTextSafeSync(absPath) ?? "";
+}
+/** Walk every indexed slug for an `includes`-style match. Returns the
+*  single best candidate, or null when the slug is too short OR several
+*  candidates tie at the top score (ambiguous → defer to the caller's
+*  title-match fallback). Score = min/max length, decoupled from Map
+*  iteration order so resolution is deterministic across hosts. */
+function pickFuzzyMatch(slug, slugs) {
+	if (slug.length < MIN_FUZZY_SLUG_LEN) return null;
+	let bestFile = null;
+	let bestScore = 0;
+	let bestIsTied = false;
+	for (const [key, file] of slugs) {
+		if (!slug.includes(key) && !key.includes(slug)) continue;
+		const score = Math.min(slug.length, key.length) / Math.max(slug.length, key.length);
+		if (score > bestScore) {
+			bestScore = score;
+			bestFile = file;
+			bestIsTied = false;
+		} else if (score === bestScore) bestIsTied = true;
+	}
+	return bestIsTied ? null : bestFile;
+}
+/** Resolve a page name to an absolute `.md` path: exact slug → fuzzy →
+*  index-title fallback (for non-ASCII names that slugify to empty).
+*  `pageName` may carry the `[[target|display]]` form; `parseWikiLink`
+*  strips the display half so the lookup uses just the target. */
+async function resolvePagePath(workspace, pageName) {
+	const { pagesDir, indexFile } = require_wiki_paths.wikiDirs(workspace);
+	const { slugs } = await getPageIndex(pagesDir);
+	if (slugs.size === 0) return null;
+	const { target } = require_graph.parseWikiLink(pageName);
+	const slug = require_slug.wikiSlugify(target);
+	if (slug.length > 0) {
+		const exact = slugs.get(slug);
+		if (exact) return node_path.default.join(pagesDir, exact);
+		const fuzzy = pickFuzzyMatch(slug, slugs);
+		if (fuzzy) return node_path.default.join(pagesDir, fuzzy);
+	}
+	const titleMatch = require_graph.parseIndexEntries(readFileOrEmpty(indexFile)).find((entry) => entry.title === target);
+	if (titleMatch) {
+		const file = slugs.get(titleMatch.slug);
+		if (file) return node_path.default.join(pagesDir, file);
+	}
+	return null;
+}
+/** Raw `index.md` content + its parsed entries. */
+function readWikiIndex(workspace) {
+	const content = readFileOrEmpty(require_wiki_paths.wikiDirs(workspace).indexFile);
+	return {
+		content,
+		entries: require_graph.parseIndexEntries(content)
+	};
+}
+/** Raw `log.md` content (empty string if absent). */
+function readWikiLog(workspace) {
+	return readFileOrEmpty(require_wiki_paths.wikiDirs(workspace).logFile);
+}
+/** Resolve + read a page. Distinguishes missing (`exists: false`) from
+*  empty-but-present (`exists: true`, `content: ""`). */
+async function readWikiPage(workspace, pageName) {
+	const filePath = await resolvePagePath(workspace, pageName);
+	const content = filePath ? readFileOrEmpty(filePath) : "";
+	const resolvedTitle = filePath ? node_path.default.basename(filePath, ".md") : pageName;
+	return {
+		filePath,
+		content,
+		exists: Boolean(filePath),
+		resolvedTitle
+	};
+}
+/** Read every page + the index and build the page→page link graph.
+*  No cache: the graph is requested explicitly and a content edit does
+*  not advance the pagesDir mtime the page index caches on. */
+async function loadWikiGraph(workspace) {
+	const { pagesDir, indexFile } = require_wiki_paths.wikiDirs(workspace);
+	const { slugs } = await getPageIndex(pagesDir);
+	const fileEntries = [...slugs.entries()];
+	const contents = await Promise.all(fileEntries.map(async ([, fileName]) => await readTextSafe(node_path.default.join(pagesDir, fileName)) ?? ""));
+	return require_graph.buildWikiGraph(fileEntries.map(([slug], i) => ({
+		slug,
+		content: contents[i]
+	})), require_graph.parseIndexEntries(readFileOrEmpty(indexFile)));
+}
+/** Run every lint rule over the on-disk wiki, returning issue strings. */
+async function collectLintIssues(workspace) {
+	const { pagesDir, indexFile } = require_wiki_paths.wikiDirs(workspace);
+	const { slugs } = await getPageIndex(pagesDir);
+	if (slugs.size === 0) return ["- Wiki `pages/` directory does not exist yet. Start ingesting sources."];
+	const pageEntries = require_graph.parseIndexEntries(readFileOrEmpty(indexFile));
+	const indexedSlugs = new Set(pageEntries.map((entry) => entry.slug));
+	const pageFiles = [...slugs.values()];
+	const fileSlugs = new Set(slugs.keys());
+	const issues = [];
+	issues.push(...require_graph.findOrphanPages(fileSlugs, indexedSlugs));
+	issues.push(...require_graph.findMissingFiles(pageEntries, fileSlugs));
+	const contents = await Promise.all(pageFiles.map(async (fileName) => await readTextSafe(node_path.default.join(pagesDir, fileName)) ?? ""));
+	const frontmatterTagsBySlug = /* @__PURE__ */ new Map();
+	for (let i = 0; i < pageFiles.length; i++) {
+		issues.push(...require_graph.findBrokenLinksInPage(pageFiles[i], contents[i], fileSlugs));
+		const slug = pageFiles[i].replace(/\.md$/i, "").toLowerCase();
+		frontmatterTagsBySlug.set(slug, parseFrontmatterTags(contents[i]));
+	}
+	issues.push(...require_graph.findTagDrift(pageEntries, frontmatterTagsBySlug));
+	return issues;
 }
 //#endregion
-exports.wikiSlugFromAbsPath = wikiSlugFromAbsPath;
+exports.__resetPageIndexCache = __resetPageIndexCache;
+exports.collectLintIssues = collectLintIssues;
+exports.getPageIndex = getPageIndex;
+exports.loadWikiGraph = loadWikiGraph;
+exports.parseFrontmatter = parseFrontmatter;
+exports.parseFrontmatterTags = parseFrontmatterTags;
+exports.pickFuzzyMatch = pickFuzzyMatch;
+exports.readWikiIndex = readWikiIndex;
+exports.readWikiLog = readWikiLog;
+exports.readWikiPage = readWikiPage;
+exports.resolvePagePath = resolvePagePath;
+exports.wikiDirs = require_wiki_paths.wikiDirs;
+exports.wikiSlugFromAbsPath = require_wiki_paths.wikiSlugFromAbsPath;
 
 //# sourceMappingURL=index.cjs.map

package/dist/wiki/server/index.cjs.map

@@ -1 +1 @@
-{"version":3,"file":"index.cjs","names":[],"sources":["../../../src/wiki/server/paths.ts"],"sourcesContent":["// Node-only wiki-page helpers — anything that needs `node:path`\n// lives here so the rest of `@mulmoclaude/core/wiki` stays pure\n// (string-only, importable from both browser and Node bundles).\n// Frontend code MUST NOT import this file directly; use the pure\n// `@mulmoclaude/core/wiki` modules instead.\n\nimport path from \"node:path\";\nimport { isSafeSlug } from \"../slug.js\";\n\n/** Given an absolute path and the absolute `pagesDir`, return the\n *  slug if `absPath` is a direct `.md` child of `pagesDir`, else\n *  null. Pure path-string math — no fs IO, no symlink resolution.\n *\n *  Caller responsibility: pass already-realpath'd values for both\n *  arguments. Mixing a realpath'd `absPath` with a symlinked\n *  `pagesDir` (or vice versa) silently mismatches because\n *  `path.relative` is plain string arithmetic. The trap caused\n *  #883 review-iter-1 — a symlinked workspace silently routed\n *  wiki writes through the generic writer. */\nexport function wikiSlugFromAbsPath(absPath: string, pagesDir: string): string | null {\n  const rel = path.relative(pagesDir, absPath);\n  if (rel.length === 0) return null;\n  if (path.isAbsolute(rel)) return null;\n  // Direct child only — no nested layout today. Any separator\n  // means the path either escapes (`../secret.md`) or descends\n  // (`subdir/foo.md`). A literal page name like `..foo.md` is a\n  // single segment without a separator and is allowed (codex\n  // iter-3 #883 — the prior `startsWith(\"..\")` rule wrongly\n  // rejected it).\n  if (rel.includes(path.sep)) return null;\n  if (!rel.endsWith(\".md\")) return null;\n  const slug = rel.slice(0, -\".md\".length);\n  if (!isSafeSlug(slug)) return null;\n  return slug;\n}\n"],"mappings":";;;;;;;;;;;;;;;;AAmBA,SAAgB,oBAAoB,SAAiB,UAAiC;CACpF,MAAM,MAAM,UAAA,QAAK,SAAS,UAAU,OAAO;CAC3C,IAAI,IAAI,WAAW,GAAG,OAAO;CAC7B,IAAI,UAAA,QAAK,WAAW,GAAG,GAAG,OAAO;CAOjC,IAAI,IAAI,SAAS,UAAA,QAAK,GAAG,GAAG,OAAO;CACnC,IAAI,CAAC,IAAI,SAAS,KAAK,GAAG,OAAO;CACjC,MAAM,OAAO,IAAI,MAAM,GAAG,EAAa;CACvC,IAAI,CAAC,aAAA,WAAW,IAAI,GAAG,OAAO;CAC9B,OAAO;AACT"}
+{"version":3,"file":"index.cjs","names":[],"sources":["../../../src/wiki/server/fs.ts","../../../src/wiki/server/pageIndex.ts","../../../src/wiki/server/frontmatter.ts","../../../src/wiki/server/engine.ts"],"sourcesContent":["// Minimal ENOENT-swallowing fs wrappers for the wiki read-engine.\n// Self-contained (core can't reach the host's `server/utils/files/safe.ts`);\n// only the handful of helpers the wiki engine needs. Same \"return\n// null / [] on any error\" contract so callers branch on the value\n// instead of try/catch.\n\nimport type { Dirent, Stats } from \"node:fs\";\nimport { readFileSync } from \"node:fs\";\nimport { readFile, readdir, stat } from \"node:fs/promises\";\n\nexport async function readTextSafe(absPath: string): Promise<string | null> {\n  try {\n    return await readFile(absPath, \"utf-8\");\n  } catch {\n    return null;\n  }\n}\n\nexport function readTextSafeSync(absPath: string): string | null {\n  try {\n    return readFileSync(absPath, \"utf-8\");\n  } catch {\n    return null;\n  }\n}\n\nexport async function statSafeAsync(absPath: string): Promise<Stats | null> {\n  try {\n    return await stat(absPath);\n  } catch {\n    return null;\n  }\n}\n\nexport async function readDirSafeAsync(absPath: string): Promise<Dirent[]> {\n  try {\n    return await readdir(absPath, { withFileTypes: true });\n  } catch {\n    return [];\n  }\n}\n","// In-memory index of `<pagesDir>/*.md` keyed by slug (= filename\n// without the `.md` extension). Kept fresh via `pagesDir` mtime —\n// adding, removing, or renaming a file under `pagesDir` advances the\n// directory's mtime on every major filesystem we target (macOS APFS,\n// Linux ext4, Windows NTFS), so one cheap `stat()` per request is\n// enough to decide whether to rebuild.\n\nimport { readDirSafeAsync, statSafeAsync } from \"./fs.js\";\n\nexport interface PageIndex {\n  mtimeMs: number;\n  /** slug → filename (e.g. \"sakura-internet\" → \"sakura-internet.md\"). */\n  slugs: Map<string, string>;\n}\n\n// Keyed by `pagesDir`: the engine is workspace-injected and may be\n// called with more than one pages directory in a single process. A\n// single global slot would let one workspace's slug map be returned\n// for another whenever their mtimes happen to tie (Codex P2 on #1876).\nconst cache = new Map<string, PageIndex>();\n\n/**\n * Get the page index for `pagesDir`. Returns a cached value as long as\n * THAT directory's mtime hasn't advanced; otherwise rebuilds. Safe to\n * call concurrently — racing builds produce the same result.\n */\nexport async function getPageIndex(pagesDir: string): Promise<PageIndex> {\n  const stat = await statSafeAsync(pagesDir);\n  if (!stat) {\n    // Dir doesn't exist yet (never ingested). Return empty but don't\n    // cache a stale-forever value — the next call re-stats.\n    return { mtimeMs: 0, slugs: new Map() };\n  }\n  const cached = cache.get(pagesDir);\n  if (cached && cached.mtimeMs >= stat.mtimeMs) return cached;\n  const entries = await readDirSafeAsync(pagesDir);\n  const slugs = new Map<string, string>();\n  for (const entry of entries) {\n    if (!entry.isFile()) continue;\n    const { name } = entry;\n    if (!name.endsWith(\".md\")) continue;\n    slugs.set(name.slice(0, -\".md\".length), name);\n  }\n  const built: PageIndex = { mtimeMs: stat.mtimeMs, slugs };\n  cache.set(pagesDir, built);\n  return built;\n}\n\n/** Test-only: drop the module-level cache (all directories). */\nexport function __resetPageIndexCache(): void {\n  cache.clear();\n}\n","// Read-side YAML frontmatter parsing for the wiki engine. Mirrors the\n// host's `server/utils/markdown/frontmatter.ts` parser (value-preserving\n// FAILSAFE_SCHEMA) so MulmoClaude and MulmoTerminal read `tags:` (and\n// any other field) identically. Only the READ path lives here — the\n// serialize/merge write side stays host-side until a host needs it.\n\nimport { FAILSAFE_SCHEMA, load as yamlLoad } from \"js-yaml\";\n\nconst FRONTMATTER_OPEN = /^---\\r?\\n/;\n// `(?:^|\\r?\\n)` lets the closing fence sit at the very start of\n// `afterOpen` — needed for the empty-envelope case `---\\n---\\n`.\nconst FRONTMATTER_CLOSE = /(?:^|\\r?\\n)---\\s*(?:\\r?\\n|$)/;\n\n/** Parse `---\\n…\\n---\\n` frontmatter. Never throws; malformed YAML in a\n *  well-formed envelope yields `{ meta: {}, hasHeader: false }`. */\nexport function parseFrontmatter(raw: string): { meta: Record<string, unknown>; hasHeader: boolean } {\n  if (!FRONTMATTER_OPEN.test(raw)) return { meta: {}, hasHeader: false };\n  const afterOpen = raw.replace(FRONTMATTER_OPEN, \"\");\n  const closeMatch = FRONTMATTER_CLOSE.exec(afterOpen);\n  if (!closeMatch || closeMatch.index === undefined) return { meta: {}, hasHeader: false };\n  const meta = safeYamlLoad(afterOpen.slice(0, closeMatch.index));\n  if (meta === null) return { meta: {}, hasHeader: false };\n  return { meta, hasHeader: true };\n}\n\nfunction safeYamlLoad(text: string): Record<string, unknown> | null {\n  // js-yaml throws on empty/whitespace-only input; an empty header\n  // (`---\\n---\\n`) means \"no metadata\", not \"malformed\".\n  if (text.trim() === \"\") return {};\n  try {\n    // FAILSAFE_SCHEMA keeps every scalar a string (no YAML-1.1 date\n    // coercion, no numeric-string truncation) — matches the host.\n    const loaded = yamlLoad(text, { schema: FAILSAFE_SCHEMA });\n    if (loaded === null || loaded === undefined) return {};\n    if (typeof loaded !== \"object\" || Array.isArray(loaded)) return null;\n    return loaded as Record<string, unknown>;\n  } catch {\n    return null;\n  }\n}\n\nfunction cleanTagToken(token: string): string {\n  return token\n    .trim()\n    .replace(/^['\"]|['\"]$/g, \"\")\n    .replace(/^#/, \"\")\n    .toLowerCase();\n}\n\n/** Narrow `tags:` reader. Handles flow (`tags: [a, b]`) and block-list\n *  style; anything unparseable returns `[]` (best-effort, never throws). */\nexport function parseFrontmatterTags(content: string): string[] {\n  const parsed = parseFrontmatter(content);\n  if (!parsed.hasHeader) return [];\n  const tagsValue = parsed.meta.tags;\n  if (!Array.isArray(tagsValue)) return [];\n  return tagsValue\n    .filter((item): item is string => typeof item === \"string\")\n    .map(cleanTagToken)\n    .filter((token) => token.length > 0);\n}\n","// Workspace-injected wiki read-engine — the filesystem layer that feeds\n// the pure helpers in `@mulmoclaude/core/wiki`. Shared by every host so\n// the two apps reading the same `data/wiki/` can't disagree on slug\n// resolution, graph edges, or lint findings. Mirrors the bodies that\n// previously lived in MulmoClaude's `server/api/routes/wiki.ts`; the\n// hosts keep only their HTTP response shaping on top.\n//\n// The read/write WRITE side (writeWikiPage / snapshots) stays host-side\n// until a host needs it shared.\n\nimport path from \"node:path\";\nimport { parseWikiLink } from \"../link.js\";\nimport { wikiSlugify } from \"../slug.js\";\nimport { type WikiPageEntry, parseIndexEntries } from \"../index-parse.js\";\nimport { findBrokenLinksInPage, findMissingFiles, findOrphanPages, findTagDrift } from \"../lint.js\";\nimport { type WikiGraph, buildWikiGraph } from \"../graph.js\";\nimport { readTextSafe, readTextSafeSync } from \"./fs.js\";\nimport { getPageIndex } from \"./pageIndex.js\";\nimport { parseFrontmatterTags } from \"./frontmatter.js\";\nimport { wikiDirs } from \"./paths.js\";\n\n// Below this length the fuzzy `includes` step is skipped — CJK /\n// emoji-only / very-short page names slugify down to a short noise\n// tail that partial-matches almost anything; the index.md title-match\n// fallback still handles the legitimate non-ASCII case (#1194).\nconst MIN_FUZZY_SLUG_LEN = 6;\n\nfunction readFileOrEmpty(absPath: string): string {\n  return readTextSafeSync(absPath) ?? \"\";\n}\n\n/** Walk every indexed slug for an `includes`-style match. Returns the\n *  single best candidate, or null when the slug is too short OR several\n *  candidates tie at the top score (ambiguous → defer to the caller's\n *  title-match fallback). Score = min/max length, decoupled from Map\n *  iteration order so resolution is deterministic across hosts. */\nexport function pickFuzzyMatch(slug: string, slugs: ReadonlyMap<string, string>): string | null {\n  if (slug.length < MIN_FUZZY_SLUG_LEN) return null;\n  let bestFile: string | null = null;\n  let bestScore = 0;\n  let bestIsTied = false;\n  for (const [key, file] of slugs) {\n    if (!slug.includes(key) && !key.includes(slug)) continue;\n    const shorter = Math.min(slug.length, key.length);\n    const longer = Math.max(slug.length, key.length);\n    const score = shorter / longer;\n    if (score > bestScore) {\n      bestScore = score;\n      bestFile = file;\n      bestIsTied = false;\n    } else if (score === bestScore) {\n      bestIsTied = true;\n    }\n  }\n  return bestIsTied ? null : bestFile;\n}\n\n/** Resolve a page name to an absolute `.md` path: exact slug → fuzzy →\n *  index-title fallback (for non-ASCII names that slugify to empty).\n *  `pageName` may carry the `[[target|display]]` form; `parseWikiLink`\n *  strips the display half so the lookup uses just the target. */\nexport async function resolvePagePath(workspace: string, pageName: string): Promise<string | null> {\n  const { pagesDir, indexFile } = wikiDirs(workspace);\n  const { slugs } = await getPageIndex(pagesDir);\n  if (slugs.size === 0) return null;\n\n  const { target } = parseWikiLink(pageName);\n  const slug = wikiSlugify(target);\n\n  if (slug.length > 0) {\n    const exact = slugs.get(slug);\n    if (exact) return path.join(pagesDir, exact);\n    const fuzzy = pickFuzzyMatch(slug, slugs);\n    if (fuzzy) return path.join(pagesDir, fuzzy);\n  }\n\n  const entries = parseIndexEntries(readFileOrEmpty(indexFile));\n  const titleMatch = entries.find((entry) => entry.title === target);\n  if (titleMatch) {\n    const file = slugs.get(titleMatch.slug);\n    if (file) return path.join(pagesDir, file);\n  }\n  return null;\n}\n\n/** Raw `index.md` content + its parsed entries. */\nexport function readWikiIndex(workspace: string): { content: string; entries: WikiPageEntry[] } {\n  const content = readFileOrEmpty(wikiDirs(workspace).indexFile);\n  return { content, entries: parseIndexEntries(content) };\n}\n\n/** Raw `log.md` content (empty string if absent). */\nexport function readWikiLog(workspace: string): string {\n  return readFileOrEmpty(wikiDirs(workspace).logFile);\n}\n\nexport interface WikiPageRead {\n  /** Absolute path of the resolved file, or null when nothing matched. */\n  filePath: string | null;\n  /** File body (empty when missing OR when the file is an empty placeholder). */\n  content: string;\n  /** True iff a page file resolved (distinct from empty content). */\n  exists: boolean;\n  /** Title to display — the resolved filename stem, or the raw pageName. */\n  resolvedTitle: string;\n}\n\n/** Resolve + read a page. Distinguishes missing (`exists: false`) from\n *  empty-but-present (`exists: true`, `content: \"\"`). */\nexport async function readWikiPage(workspace: string, pageName: string): Promise<WikiPageRead> {\n  const filePath = await resolvePagePath(workspace, pageName);\n  const content = filePath ? readFileOrEmpty(filePath) : \"\";\n  const resolvedTitle = filePath ? path.basename(filePath, \".md\") : pageName;\n  return { filePath, content, exists: Boolean(filePath), resolvedTitle };\n}\n\n/** Read every page + the index and build the page→page link graph.\n *  No cache: the graph is requested explicitly and a content edit does\n *  not advance the pagesDir mtime the page index caches on. */\nexport async function loadWikiGraph(workspace: string): Promise<WikiGraph> {\n  const { pagesDir, indexFile } = wikiDirs(workspace);\n  const { slugs } = await getPageIndex(pagesDir);\n  const fileEntries = [...slugs.entries()];\n  const contents = await Promise.all(fileEntries.map(async ([, fileName]) => (await readTextSafe(path.join(pagesDir, fileName))) ?? \"\"));\n  const pages = fileEntries.map(([slug], i) => ({ slug, content: contents[i] }));\n  const indexEntries = parseIndexEntries(readFileOrEmpty(indexFile));\n  return buildWikiGraph(pages, indexEntries);\n}\n\n/** Run every lint rule over the on-disk wiki, returning issue strings. */\nexport async function collectLintIssues(workspace: string): Promise<string[]> {\n  const { pagesDir, indexFile } = wikiDirs(workspace);\n  const { slugs } = await getPageIndex(pagesDir);\n  if (slugs.size === 0) {\n    return [\"- Wiki `pages/` directory does not exist yet. Start ingesting sources.\"];\n  }\n  const pageEntries = parseIndexEntries(readFileOrEmpty(indexFile));\n  const indexedSlugs = new Set(pageEntries.map((entry) => entry.slug));\n  const pageFiles = [...slugs.values()];\n  const fileSlugs = new Set(slugs.keys());\n\n  const issues: string[] = [];\n  issues.push(...findOrphanPages(fileSlugs, indexedSlugs));\n  issues.push(...findMissingFiles(pageEntries, fileSlugs));\n  const contents = await Promise.all(pageFiles.map(async (fileName) => (await readTextSafe(path.join(pagesDir, fileName))) ?? \"\"));\n  const frontmatterTagsBySlug = new Map<string, string[]>();\n  for (let i = 0; i < pageFiles.length; i++) {\n    issues.push(...findBrokenLinksInPage(pageFiles[i], contents[i], fileSlugs));\n    // Lowercase the key so a `MyPage.md` filename matches an\n    // `entry.slug` of `mypage`; `findTagDrift` lowercases the lookup.\n    const slug = pageFiles[i].replace(/\\.md$/i, \"\").toLowerCase();\n    frontmatterTagsBySlug.set(slug, parseFrontmatterTags(contents[i]));\n  }\n  issues.push(...findTagDrift(pageEntries, frontmatterTagsBySlug));\n  return issues;\n}\n"],"mappings":";;;;;;;;;;;AAUA,eAAsB,aAAa,SAAyC;CAC1E,IAAI;EACF,OAAO,OAAA,GAAA,iBAAA,SAAA,CAAe,SAAS,OAAO;CACxC,QAAQ;EACN,OAAO;CACT;AACF;AAEA,SAAgB,iBAAiB,SAAgC;CAC/D,IAAI;EACF,QAAA,GAAA,QAAA,aAAA,CAAoB,SAAS,OAAO;CACtC,QAAQ;EACN,OAAO;CACT;AACF;AAEA,eAAsB,cAAc,SAAwC;CAC1E,IAAI;EACF,OAAO,OAAA,GAAA,iBAAA,KAAA,CAAW,OAAO;CAC3B,QAAQ;EACN,OAAO;CACT;AACF;AAEA,eAAsB,iBAAiB,SAAoC;CACzE,IAAI;EACF,OAAO,OAAA,GAAA,iBAAA,QAAA,CAAc,SAAS,EAAE,eAAe,KAAK,CAAC;CACvD,QAAQ;EACN,OAAO,CAAC;CACV;AACF;;;ACrBA,IAAM,wBAAQ,IAAI,IAAuB;;;;;;AAOzC,eAAsB,aAAa,UAAsC;CACvE,MAAM,OAAO,MAAM,cAAc,QAAQ;CACzC,IAAI,CAAC,MAGH,OAAO;EAAE,SAAS;EAAG,uBAAO,IAAI,IAAI;CAAE;CAExC,MAAM,SAAS,MAAM,IAAI,QAAQ;CACjC,IAAI,UAAU,OAAO,WAAW,KAAK,SAAS,OAAO;CACrD,MAAM,UAAU,MAAM,iBAAiB,QAAQ;CAC/C,MAAM,wBAAQ,IAAI,IAAoB;CACtC,KAAK,MAAM,SAAS,SAAS;EAC3B,IAAI,CAAC,MAAM,OAAO,GAAG;EACrB,MAAM,EAAE,SAAS;EACjB,IAAI,CAAC,KAAK,SAAS,KAAK,GAAG;EAC3B,MAAM,IAAI,KAAK,MAAM,GAAG,EAAa,GAAG,IAAI;CAC9C;CACA,MAAM,QAAmB;EAAE,SAAS,KAAK;EAAS;CAAM;CACxD,MAAM,IAAI,UAAU,KAAK;CACzB,OAAO;AACT;;AAGA,SAAgB,wBAA8B;CAC5C,MAAM,MAAM;AACd;;;AC3CA,IAAM,mBAAmB;AAGzB,IAAM,oBAAoB;;;AAI1B,SAAgB,iBAAiB,KAAoE;CACnG,IAAI,CAAC,iBAAiB,KAAK,GAAG,GAAG,OAAO;EAAE,MAAM,CAAC;EAAG,WAAW;CAAM;CACrE,MAAM,YAAY,IAAI,QAAQ,kBAAkB,EAAE;CAClD,MAAM,aAAa,kBAAkB,KAAK,SAAS;CACnD,IAAI,CAAC,cAAc,WAAW,UAAU,KAAA,GAAW,OAAO;EAAE,MAAM,CAAC;EAAG,WAAW;CAAM;CACvF,MAAM,OAAO,aAAa,UAAU,MAAM,GAAG,WAAW,KAAK,CAAC;CAC9D,IAAI,SAAS,MAAM,OAAO;EAAE,MAAM,CAAC;EAAG,WAAW;CAAM;CACvD,OAAO;EAAE;EAAM,WAAW;CAAK;AACjC;AAEA,SAAS,aAAa,MAA8C;CAGlE,IAAI,KAAK,KAAK,MAAM,IAAI,OAAO,CAAC;CAChC,IAAI;EAGF,MAAM,UAAA,GAAA,QAAA,KAAA,CAAkB,MAAM,EAAE,QAAQ,QAAA,gBAAgB,CAAC;EACzD,IAAI,WAAW,QAAQ,WAAW,KAAA,GAAW,OAAO,CAAC;EACrD,IAAI,OAAO,WAAW,YAAY,MAAM,QAAQ,MAAM,GAAG,OAAO;EAChE,OAAO;CACT,QAAQ;EACN,OAAO;CACT;AACF;AAEA,SAAS,cAAc,OAAuB;CAC5C,OAAO,MACJ,KAAK,CAAC,CACN,QAAQ,gBAAgB,EAAE,CAAC,CAC3B,QAAQ,MAAM,EAAE,CAAC,CACjB,YAAY;AACjB;;;AAIA,SAAgB,qBAAqB,SAA2B;CAC9D,MAAM,SAAS,iBAAiB,OAAO;CACvC,IAAI,CAAC,OAAO,WAAW,OAAO,CAAC;CAC/B,MAAM,YAAY,OAAO,KAAK;CAC9B,IAAI,CAAC,MAAM,QAAQ,SAAS,GAAG,OAAO,CAAC;CACvC,OAAO,UACJ,QAAQ,SAAyB,OAAO,SAAS,QAAQ,CAAC,CAC1D,IAAI,aAAa,CAAC,CAClB,QAAQ,UAAU,MAAM,SAAS,CAAC;AACvC;;;ACnCA,IAAM,qBAAqB;AAE3B,SAAS,gBAAgB,SAAyB;CAChD,OAAO,iBAAiB,OAAO,KAAK;AACtC;;;;;;AAOA,SAAgB,eAAe,MAAc,OAAmD;CAC9F,IAAI,KAAK,SAAS,oBAAoB,OAAO;CAC7C,IAAI,WAA0B;CAC9B,IAAI,YAAY;CAChB,IAAI,aAAa;CACjB,KAAK,MAAM,CAAC,KAAK,SAAS,OAAO;EAC/B,IAAI,CAAC,KAAK,SAAS,GAAG,KAAK,CAAC,IAAI,SAAS,IAAI,GAAG;EAGhD,MAAM,QAFU,KAAK,IAAI,KAAK,QAAQ,IAAI,MAE5B,IADC,KAAK,IAAI,KAAK,QAAQ,IAAI,MACjB;EACxB,IAAI,QAAQ,WAAW;GACrB,YAAY;GACZ,WAAW;GACX,aAAa;EACf,OAAO,IAAI,UAAU,WACnB,aAAa;CAEjB;CACA,OAAO,aAAa,OAAO;AAC7B;;;;;AAMA,eAAsB,gBAAgB,WAAmB,UAA0C;CACjG,MAAM,EAAE,UAAU,cAAc,mBAAA,SAAS,SAAS;CAClD,MAAM,EAAE,UAAU,MAAM,aAAa,QAAQ;CAC7C,IAAI,MAAM,SAAS,GAAG,OAAO;CAE7B,MAAM,EAAE,WAAW,cAAA,cAAc,QAAQ;CACzC,MAAM,OAAO,aAAA,YAAY,MAAM;CAE/B,IAAI,KAAK,SAAS,GAAG;EACnB,MAAM,QAAQ,MAAM,IAAI,IAAI;EAC5B,IAAI,OAAO,OAAO,UAAA,QAAK,KAAK,UAAU,KAAK;EAC3C,MAAM,QAAQ,eAAe,MAAM,KAAK;EACxC,IAAI,OAAO,OAAO,UAAA,QAAK,KAAK,UAAU,KAAK;CAC7C;CAGA,MAAM,aADU,cAAA,kBAAkB,gBAAgB,SAAS,CACxC,CAAA,CAAQ,MAAM,UAAU,MAAM,UAAU,MAAM;CACjE,IAAI,YAAY;EACd,MAAM,OAAO,MAAM,IAAI,WAAW,IAAI;EACtC,IAAI,MAAM,OAAO,UAAA,QAAK,KAAK,UAAU,IAAI;CAC3C;CACA,OAAO;AACT;;AAGA,SAAgB,cAAc,WAAkE;CAC9F,MAAM,UAAU,gBAAgB,mBAAA,SAAS,SAAS,CAAC,CAAC,SAAS;CAC7D,OAAO;EAAE;EAAS,SAAS,cAAA,kBAAkB,OAAO;CAAE;AACxD;;AAGA,SAAgB,YAAY,WAA2B;CACrD,OAAO,gBAAgB,mBAAA,SAAS,SAAS,CAAC,CAAC,OAAO;AACpD;;;AAeA,eAAsB,aAAa,WAAmB,UAAyC;CAC7F,MAAM,WAAW,MAAM,gBAAgB,WAAW,QAAQ;CAC1D,MAAM,UAAU,WAAW,gBAAgB,QAAQ,IAAI;CACvD,MAAM,gBAAgB,WAAW,UAAA,QAAK,SAAS,UAAU,KAAK,IAAI;CAClE,OAAO;EAAE;EAAU;EAAS,QAAQ,QAAQ,QAAQ;EAAG;CAAc;AACvE;;;;AAKA,eAAsB,cAAc,WAAuC;CACzE,MAAM,EAAE,UAAU,cAAc,mBAAA,SAAS,SAAS;CAClD,MAAM,EAAE,UAAU,MAAM,aAAa,QAAQ;CAC7C,MAAM,cAAc,CAAC,GAAG,MAAM,QAAQ,CAAC;CACvC,MAAM,WAAW,MAAM,QAAQ,IAAI,YAAY,IAAI,OAAO,GAAG,cAAe,MAAM,aAAa,UAAA,QAAK,KAAK,UAAU,QAAQ,CAAC,KAAM,EAAE,CAAC;CAGrI,OAAO,cAAA,eAFO,YAAY,KAAK,CAAC,OAAO,OAAO;EAAE;EAAM,SAAS,SAAS;CAAG,EAErD,GADD,cAAA,kBAAkB,gBAAgB,SAAS,CACnC,CAAY;AAC3C;;AAGA,eAAsB,kBAAkB,WAAsC;CAC5E,MAAM,EAAE,UAAU,cAAc,mBAAA,SAAS,SAAS;CAClD,MAAM,EAAE,UAAU,MAAM,aAAa,QAAQ;CAC7C,IAAI,MAAM,SAAS,GACjB,OAAO,CAAC,wEAAwE;CAElF,MAAM,cAAc,cAAA,kBAAkB,gBAAgB,SAAS,CAAC;CAChE,MAAM,eAAe,IAAI,IAAI,YAAY,KAAK,UAAU,MAAM,IAAI,CAAC;CACnE,MAAM,YAAY,CAAC,GAAG,MAAM,OAAO,CAAC;CACpC,MAAM,YAAY,IAAI,IAAI,MAAM,KAAK,CAAC;CAEtC,MAAM,SAAmB,CAAC;CAC1B,OAAO,KAAK,GAAG,cAAA,gBAAgB,WAAW,YAAY,CAAC;CACvD,OAAO,KAAK,GAAG,cAAA,iBAAiB,aAAa,SAAS,CAAC;CACvD,MAAM,WAAW,MAAM,QAAQ,IAAI,UAAU,IAAI,OAAO,aAAc,MAAM,aAAa,UAAA,QAAK,KAAK,UAAU,QAAQ,CAAC,KAAM,EAAE,CAAC;CAC/H,MAAM,wCAAwB,IAAI,IAAsB;CACxD,KAAK,IAAI,IAAI,GAAG,IAAI,UAAU,QAAQ,KAAK;EACzC,OAAO,KAAK,GAAG,cAAA,sBAAsB,UAAU,IAAI,SAAS,IAAI,SAAS,CAAC;EAG1E,MAAM,OAAO,UAAU,EAAE,CAAC,QAAQ,UAAU,EAAE,CAAC,CAAC,YAAY;EAC5D,sBAAsB,IAAI,MAAM,qBAAqB,SAAS,EAAE,CAAC;CACnE;CACA,OAAO,KAAK,GAAG,cAAA,aAAa,aAAa,qBAAqB,CAAC;CAC/D,OAAO;AACT"}

package/dist/wiki/server/index.d.ts

@@ -1 +1,4 @@
-export { wikiSlugFromAbsPath } from './paths.js';
+export { wikiSlugFromAbsPath, wikiDirs } from './paths.js';
+export { getPageIndex, __resetPageIndexCache, type PageIndex } from './pageIndex.js';
+export { parseFrontmatter, parseFrontmatterTags } from './frontmatter.js';
+export { pickFuzzyMatch, resolvePagePath, readWikiIndex, readWikiLog, readWikiPage, loadWikiGraph, collectLintIssues, type WikiPageRead } from './engine.js';

package/dist/wiki/server/index.js

@@ -1,27 +1,235 @@
-import { t as isSafeSlug } from "../../slug-CdN-pQX1.js";
+import { a as findBrokenLinksInPage, c as findTagDrift, h as parseIndexEntries, o as findMissingFiles, s as findOrphanPages, t as buildWikiGraph, v as parseWikiLink } from "../../graph-o5FZZbXf.js";
+import { n as wikiSlugify } from "../../slug-CdN-pQX1.js";
+import { wikiDirs, wikiSlugFromAbsPath } from "../paths.js";
 import path from "node:path";
-//#region src/wiki/server/paths.ts
-/** Given an absolute path and the absolute `pagesDir`, return the
-*  slug if `absPath` is a direct `.md` child of `pagesDir`, else
-*  null. Pure path-string math — no fs IO, no symlink resolution.
-*
-*  Caller responsibility: pass already-realpath'd values for both
-*  arguments. Mixing a realpath'd `absPath` with a symlinked
-*  `pagesDir` (or vice versa) silently mismatches because
-*  `path.relative` is plain string arithmetic. The trap caused
-*  #883 review-iter-1 — a symlinked workspace silently routed
-*  wiki writes through the generic writer. */
-function wikiSlugFromAbsPath(absPath, pagesDir) {
-	const rel = path.relative(pagesDir, absPath);
-	if (rel.length === 0) return null;
-	if (path.isAbsolute(rel)) return null;
-	if (rel.includes(path.sep)) return null;
-	if (!rel.endsWith(".md")) return null;
-	const slug = rel.slice(0, -3);
-	if (!isSafeSlug(slug)) return null;
-	return slug;
+import { readFileSync } from "node:fs";
+import { readFile, readdir, stat } from "node:fs/promises";
+import { FAILSAFE_SCHEMA, load } from "js-yaml";
+//#region src/wiki/server/fs.ts
+async function readTextSafe(absPath) {
+	try {
+		return await readFile(absPath, "utf-8");
+	} catch {
+		return null;
+	}
+}
+function readTextSafeSync(absPath) {
+	try {
+		return readFileSync(absPath, "utf-8");
+	} catch {
+		return null;
+	}
+}
+async function statSafeAsync(absPath) {
+	try {
+		return await stat(absPath);
+	} catch {
+		return null;
+	}
+}
+async function readDirSafeAsync(absPath) {
+	try {
+		return await readdir(absPath, { withFileTypes: true });
+	} catch {
+		return [];
+	}
+}
+//#endregion
+//#region src/wiki/server/pageIndex.ts
+var cache = /* @__PURE__ */ new Map();
+/**
+* Get the page index for `pagesDir`. Returns a cached value as long as
+* THAT directory's mtime hasn't advanced; otherwise rebuilds. Safe to
+* call concurrently — racing builds produce the same result.
+*/
+async function getPageIndex(pagesDir) {
+	const stat = await statSafeAsync(pagesDir);
+	if (!stat) return {
+		mtimeMs: 0,
+		slugs: /* @__PURE__ */ new Map()
+	};
+	const cached = cache.get(pagesDir);
+	if (cached && cached.mtimeMs >= stat.mtimeMs) return cached;
+	const entries = await readDirSafeAsync(pagesDir);
+	const slugs = /* @__PURE__ */ new Map();
+	for (const entry of entries) {
+		if (!entry.isFile()) continue;
+		const { name } = entry;
+		if (!name.endsWith(".md")) continue;
+		slugs.set(name.slice(0, -3), name);
+	}
+	const built = {
+		mtimeMs: stat.mtimeMs,
+		slugs
+	};
+	cache.set(pagesDir, built);
+	return built;
+}
+/** Test-only: drop the module-level cache (all directories). */
+function __resetPageIndexCache() {
+	cache.clear();
+}
+//#endregion
+//#region src/wiki/server/frontmatter.ts
+var FRONTMATTER_OPEN = /^---\r?\n/;
+var FRONTMATTER_CLOSE = /(?:^|\r?\n)---\s*(?:\r?\n|$)/;
+/** Parse `---\n…\n---\n` frontmatter. Never throws; malformed YAML in a
+*  well-formed envelope yields `{ meta: {}, hasHeader: false }`. */
+function parseFrontmatter(raw) {
+	if (!FRONTMATTER_OPEN.test(raw)) return {
+		meta: {},
+		hasHeader: false
+	};
+	const afterOpen = raw.replace(FRONTMATTER_OPEN, "");
+	const closeMatch = FRONTMATTER_CLOSE.exec(afterOpen);
+	if (!closeMatch || closeMatch.index === void 0) return {
+		meta: {},
+		hasHeader: false
+	};
+	const meta = safeYamlLoad(afterOpen.slice(0, closeMatch.index));
+	if (meta === null) return {
+		meta: {},
+		hasHeader: false
+	};
+	return {
+		meta,
+		hasHeader: true
+	};
+}
+function safeYamlLoad(text) {
+	if (text.trim() === "") return {};
+	try {
+		const loaded = load(text, { schema: FAILSAFE_SCHEMA });
+		if (loaded === null || loaded === void 0) return {};
+		if (typeof loaded !== "object" || Array.isArray(loaded)) return null;
+		return loaded;
+	} catch {
+		return null;
+	}
+}
+function cleanTagToken(token) {
+	return token.trim().replace(/^['"]|['"]$/g, "").replace(/^#/, "").toLowerCase();
+}
+/** Narrow `tags:` reader. Handles flow (`tags: [a, b]`) and block-list
+*  style; anything unparseable returns `[]` (best-effort, never throws). */
+function parseFrontmatterTags(content) {
+	const parsed = parseFrontmatter(content);
+	if (!parsed.hasHeader) return [];
+	const tagsValue = parsed.meta.tags;
+	if (!Array.isArray(tagsValue)) return [];
+	return tagsValue.filter((item) => typeof item === "string").map(cleanTagToken).filter((token) => token.length > 0);
+}
+//#endregion
+//#region src/wiki/server/engine.ts
+var MIN_FUZZY_SLUG_LEN = 6;
+function readFileOrEmpty(absPath) {
+	return readTextSafeSync(absPath) ?? "";
+}
+/** Walk every indexed slug for an `includes`-style match. Returns the
+*  single best candidate, or null when the slug is too short OR several
+*  candidates tie at the top score (ambiguous → defer to the caller's
+*  title-match fallback). Score = min/max length, decoupled from Map
+*  iteration order so resolution is deterministic across hosts. */
+function pickFuzzyMatch(slug, slugs) {
+	if (slug.length < MIN_FUZZY_SLUG_LEN) return null;
+	let bestFile = null;
+	let bestScore = 0;
+	let bestIsTied = false;
+	for (const [key, file] of slugs) {
+		if (!slug.includes(key) && !key.includes(slug)) continue;
+		const score = Math.min(slug.length, key.length) / Math.max(slug.length, key.length);
+		if (score > bestScore) {
+			bestScore = score;
+			bestFile = file;
+			bestIsTied = false;
+		} else if (score === bestScore) bestIsTied = true;
+	}
+	return bestIsTied ? null : bestFile;
+}
+/** Resolve a page name to an absolute `.md` path: exact slug → fuzzy →
+*  index-title fallback (for non-ASCII names that slugify to empty).
+*  `pageName` may carry the `[[target|display]]` form; `parseWikiLink`
+*  strips the display half so the lookup uses just the target. */
+async function resolvePagePath(workspace, pageName) {
+	const { pagesDir, indexFile } = wikiDirs(workspace);
+	const { slugs } = await getPageIndex(pagesDir);
+	if (slugs.size === 0) return null;
+	const { target } = parseWikiLink(pageName);
+	const slug = wikiSlugify(target);
+	if (slug.length > 0) {
+		const exact = slugs.get(slug);
+		if (exact) return path.join(pagesDir, exact);
+		const fuzzy = pickFuzzyMatch(slug, slugs);
+		if (fuzzy) return path.join(pagesDir, fuzzy);
+	}
+	const titleMatch = parseIndexEntries(readFileOrEmpty(indexFile)).find((entry) => entry.title === target);
+	if (titleMatch) {
+		const file = slugs.get(titleMatch.slug);
+		if (file) return path.join(pagesDir, file);
+	}
+	return null;
+}
+/** Raw `index.md` content + its parsed entries. */
+function readWikiIndex(workspace) {
+	const content = readFileOrEmpty(wikiDirs(workspace).indexFile);
+	return {
+		content,
+		entries: parseIndexEntries(content)
+	};
+}
+/** Raw `log.md` content (empty string if absent). */
+function readWikiLog(workspace) {
+	return readFileOrEmpty(wikiDirs(workspace).logFile);
+}
+/** Resolve + read a page. Distinguishes missing (`exists: false`) from
+*  empty-but-present (`exists: true`, `content: ""`). */
+async function readWikiPage(workspace, pageName) {
+	const filePath = await resolvePagePath(workspace, pageName);
+	const content = filePath ? readFileOrEmpty(filePath) : "";
+	const resolvedTitle = filePath ? path.basename(filePath, ".md") : pageName;
+	return {
+		filePath,
+		content,
+		exists: Boolean(filePath),
+		resolvedTitle
+	};
+}
+/** Read every page + the index and build the page→page link graph.
+*  No cache: the graph is requested explicitly and a content edit does
+*  not advance the pagesDir mtime the page index caches on. */
+async function loadWikiGraph(workspace) {
+	const { pagesDir, indexFile } = wikiDirs(workspace);
+	const { slugs } = await getPageIndex(pagesDir);
+	const fileEntries = [...slugs.entries()];
+	const contents = await Promise.all(fileEntries.map(async ([, fileName]) => await readTextSafe(path.join(pagesDir, fileName)) ?? ""));
+	return buildWikiGraph(fileEntries.map(([slug], i) => ({
+		slug,
+		content: contents[i]
+	})), parseIndexEntries(readFileOrEmpty(indexFile)));
+}
+/** Run every lint rule over the on-disk wiki, returning issue strings. */
+async function collectLintIssues(workspace) {
+	const { pagesDir, indexFile } = wikiDirs(workspace);
+	const { slugs } = await getPageIndex(pagesDir);
+	if (slugs.size === 0) return ["- Wiki `pages/` directory does not exist yet. Start ingesting sources."];
+	const pageEntries = parseIndexEntries(readFileOrEmpty(indexFile));
+	const indexedSlugs = new Set(pageEntries.map((entry) => entry.slug));
+	const pageFiles = [...slugs.values()];
+	const fileSlugs = new Set(slugs.keys());
+	const issues = [];
+	issues.push(...findOrphanPages(fileSlugs, indexedSlugs));
+	issues.push(...findMissingFiles(pageEntries, fileSlugs));
+	const contents = await Promise.all(pageFiles.map(async (fileName) => await readTextSafe(path.join(pagesDir, fileName)) ?? ""));
+	const frontmatterTagsBySlug = /* @__PURE__ */ new Map();
+	for (let i = 0; i < pageFiles.length; i++) {
+		issues.push(...findBrokenLinksInPage(pageFiles[i], contents[i], fileSlugs));
+		const slug = pageFiles[i].replace(/\.md$/i, "").toLowerCase();
+		frontmatterTagsBySlug.set(slug, parseFrontmatterTags(contents[i]));
+	}
+	issues.push(...findTagDrift(pageEntries, frontmatterTagsBySlug));
+	return issues;
 }
 //#endregion
-export { wikiSlugFromAbsPath };
+export { __resetPageIndexCache, collectLintIssues, getPageIndex, loadWikiGraph, parseFrontmatter, parseFrontmatterTags, pickFuzzyMatch, readWikiIndex, readWikiLog, readWikiPage, resolvePagePath, wikiDirs, wikiSlugFromAbsPath };
 
 //# sourceMappingURL=index.js.map

package/dist/wiki/server/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","names":[],"sources":["../../../src/wiki/server/paths.ts"],"sourcesContent":["// Node-only wiki-page helpers — anything that needs `node:path`\n// lives here so the rest of `@mulmoclaude/core/wiki` stays pure\n// (string-only, importable from both browser and Node bundles).\n// Frontend code MUST NOT import this file directly; use the pure\n// `@mulmoclaude/core/wiki` modules instead.\n\nimport path from \"node:path\";\nimport { isSafeSlug } from \"../slug.js\";\n\n/** Given an absolute path and the absolute `pagesDir`, return the\n *  slug if `absPath` is a direct `.md` child of `pagesDir`, else\n *  null. Pure path-string math — no fs IO, no symlink resolution.\n *\n *  Caller responsibility: pass already-realpath'd values for both\n *  arguments. Mixing a realpath'd `absPath` with a symlinked\n *  `pagesDir` (or vice versa) silently mismatches because\n *  `path.relative` is plain string arithmetic. The trap caused\n *  #883 review-iter-1 — a symlinked workspace silently routed\n *  wiki writes through the generic writer. */\nexport function wikiSlugFromAbsPath(absPath: string, pagesDir: string): string | null {\n  const rel = path.relative(pagesDir, absPath);\n  if (rel.length === 0) return null;\n  if (path.isAbsolute(rel)) return null;\n  // Direct child only — no nested layout today. Any separator\n  // means the path either escapes (`../secret.md`) or descends\n  // (`subdir/foo.md`). A literal page name like `..foo.md` is a\n  // single segment without a separator and is allowed (codex\n  // iter-3 #883 — the prior `startsWith(\"..\")` rule wrongly\n  // rejected it).\n  if (rel.includes(path.sep)) return null;\n  if (!rel.endsWith(\".md\")) return null;\n  const slug = rel.slice(0, -\".md\".length);\n  if (!isSafeSlug(slug)) return null;\n  return slug;\n}\n"],"mappings":";;;;;;;;;;;;;AAmBA,SAAgB,oBAAoB,SAAiB,UAAiC;CACpF,MAAM,MAAM,KAAK,SAAS,UAAU,OAAO;CAC3C,IAAI,IAAI,WAAW,GAAG,OAAO;CAC7B,IAAI,KAAK,WAAW,GAAG,GAAG,OAAO;CAOjC,IAAI,IAAI,SAAS,KAAK,GAAG,GAAG,OAAO;CACnC,IAAI,CAAC,IAAI,SAAS,KAAK,GAAG,OAAO;CACjC,MAAM,OAAO,IAAI,MAAM,GAAG,EAAa;CACvC,IAAI,CAAC,WAAW,IAAI,GAAG,OAAO;CAC9B,OAAO;AACT"}
+{"version":3,"file":"index.js","names":[],"sources":["../../../src/wiki/server/fs.ts","../../../src/wiki/server/pageIndex.ts","../../../src/wiki/server/frontmatter.ts","../../../src/wiki/server/engine.ts"],"sourcesContent":["// Minimal ENOENT-swallowing fs wrappers for the wiki read-engine.\n// Self-contained (core can't reach the host's `server/utils/files/safe.ts`);\n// only the handful of helpers the wiki engine needs. Same \"return\n// null / [] on any error\" contract so callers branch on the value\n// instead of try/catch.\n\nimport type { Dirent, Stats } from \"node:fs\";\nimport { readFileSync } from \"node:fs\";\nimport { readFile, readdir, stat } from \"node:fs/promises\";\n\nexport async function readTextSafe(absPath: string): Promise<string | null> {\n  try {\n    return await readFile(absPath, \"utf-8\");\n  } catch {\n    return null;\n  }\n}\n\nexport function readTextSafeSync(absPath: string): string | null {\n  try {\n    return readFileSync(absPath, \"utf-8\");\n  } catch {\n    return null;\n  }\n}\n\nexport async function statSafeAsync(absPath: string): Promise<Stats | null> {\n  try {\n    return await stat(absPath);\n  } catch {\n    return null;\n  }\n}\n\nexport async function readDirSafeAsync(absPath: string): Promise<Dirent[]> {\n  try {\n    return await readdir(absPath, { withFileTypes: true });\n  } catch {\n    return [];\n  }\n}\n","// In-memory index of `<pagesDir>/*.md` keyed by slug (= filename\n// without the `.md` extension). Kept fresh via `pagesDir` mtime —\n// adding, removing, or renaming a file under `pagesDir` advances the\n// directory's mtime on every major filesystem we target (macOS APFS,\n// Linux ext4, Windows NTFS), so one cheap `stat()` per request is\n// enough to decide whether to rebuild.\n\nimport { readDirSafeAsync, statSafeAsync } from \"./fs.js\";\n\nexport interface PageIndex {\n  mtimeMs: number;\n  /** slug → filename (e.g. \"sakura-internet\" → \"sakura-internet.md\"). */\n  slugs: Map<string, string>;\n}\n\n// Keyed by `pagesDir`: the engine is workspace-injected and may be\n// called with more than one pages directory in a single process. A\n// single global slot would let one workspace's slug map be returned\n// for another whenever their mtimes happen to tie (Codex P2 on #1876).\nconst cache = new Map<string, PageIndex>();\n\n/**\n * Get the page index for `pagesDir`. Returns a cached value as long as\n * THAT directory's mtime hasn't advanced; otherwise rebuilds. Safe to\n * call concurrently — racing builds produce the same result.\n */\nexport async function getPageIndex(pagesDir: string): Promise<PageIndex> {\n  const stat = await statSafeAsync(pagesDir);\n  if (!stat) {\n    // Dir doesn't exist yet (never ingested). Return empty but don't\n    // cache a stale-forever value — the next call re-stats.\n    return { mtimeMs: 0, slugs: new Map() };\n  }\n  const cached = cache.get(pagesDir);\n  if (cached && cached.mtimeMs >= stat.mtimeMs) return cached;\n  const entries = await readDirSafeAsync(pagesDir);\n  const slugs = new Map<string, string>();\n  for (const entry of entries) {\n    if (!entry.isFile()) continue;\n    const { name } = entry;\n    if (!name.endsWith(\".md\")) continue;\n    slugs.set(name.slice(0, -\".md\".length), name);\n  }\n  const built: PageIndex = { mtimeMs: stat.mtimeMs, slugs };\n  cache.set(pagesDir, built);\n  return built;\n}\n\n/** Test-only: drop the module-level cache (all directories). */\nexport function __resetPageIndexCache(): void {\n  cache.clear();\n}\n","// Read-side YAML frontmatter parsing for the wiki engine. Mirrors the\n// host's `server/utils/markdown/frontmatter.ts` parser (value-preserving\n// FAILSAFE_SCHEMA) so MulmoClaude and MulmoTerminal read `tags:` (and\n// any other field) identically. Only the READ path lives here — the\n// serialize/merge write side stays host-side until a host needs it.\n\nimport { FAILSAFE_SCHEMA, load as yamlLoad } from \"js-yaml\";\n\nconst FRONTMATTER_OPEN = /^---\\r?\\n/;\n// `(?:^|\\r?\\n)` lets the closing fence sit at the very start of\n// `afterOpen` — needed for the empty-envelope case `---\\n---\\n`.\nconst FRONTMATTER_CLOSE = /(?:^|\\r?\\n)---\\s*(?:\\r?\\n|$)/;\n\n/** Parse `---\\n…\\n---\\n` frontmatter. Never throws; malformed YAML in a\n *  well-formed envelope yields `{ meta: {}, hasHeader: false }`. */\nexport function parseFrontmatter(raw: string): { meta: Record<string, unknown>; hasHeader: boolean } {\n  if (!FRONTMATTER_OPEN.test(raw)) return { meta: {}, hasHeader: false };\n  const afterOpen = raw.replace(FRONTMATTER_OPEN, \"\");\n  const closeMatch = FRONTMATTER_CLOSE.exec(afterOpen);\n  if (!closeMatch || closeMatch.index === undefined) return { meta: {}, hasHeader: false };\n  const meta = safeYamlLoad(afterOpen.slice(0, closeMatch.index));\n  if (meta === null) return { meta: {}, hasHeader: false };\n  return { meta, hasHeader: true };\n}\n\nfunction safeYamlLoad(text: string): Record<string, unknown> | null {\n  // js-yaml throws on empty/whitespace-only input; an empty header\n  // (`---\\n---\\n`) means \"no metadata\", not \"malformed\".\n  if (text.trim() === \"\") return {};\n  try {\n    // FAILSAFE_SCHEMA keeps every scalar a string (no YAML-1.1 date\n    // coercion, no numeric-string truncation) — matches the host.\n    const loaded = yamlLoad(text, { schema: FAILSAFE_SCHEMA });\n    if (loaded === null || loaded === undefined) return {};\n    if (typeof loaded !== \"object\" || Array.isArray(loaded)) return null;\n    return loaded as Record<string, unknown>;\n  } catch {\n    return null;\n  }\n}\n\nfunction cleanTagToken(token: string): string {\n  return token\n    .trim()\n    .replace(/^['\"]|['\"]$/g, \"\")\n    .replace(/^#/, \"\")\n    .toLowerCase();\n}\n\n/** Narrow `tags:` reader. Handles flow (`tags: [a, b]`) and block-list\n *  style; anything unparseable returns `[]` (best-effort, never throws). */\nexport function parseFrontmatterTags(content: string): string[] {\n  const parsed = parseFrontmatter(content);\n  if (!parsed.hasHeader) return [];\n  const tagsValue = parsed.meta.tags;\n  if (!Array.isArray(tagsValue)) return [];\n  return tagsValue\n    .filter((item): item is string => typeof item === \"string\")\n    .map(cleanTagToken)\n    .filter((token) => token.length > 0);\n}\n","// Workspace-injected wiki read-engine — the filesystem layer that feeds\n// the pure helpers in `@mulmoclaude/core/wiki`. Shared by every host so\n// the two apps reading the same `data/wiki/` can't disagree on slug\n// resolution, graph edges, or lint findings. Mirrors the bodies that\n// previously lived in MulmoClaude's `server/api/routes/wiki.ts`; the\n// hosts keep only their HTTP response shaping on top.\n//\n// The read/write WRITE side (writeWikiPage / snapshots) stays host-side\n// until a host needs it shared.\n\nimport path from \"node:path\";\nimport { parseWikiLink } from \"../link.js\";\nimport { wikiSlugify } from \"../slug.js\";\nimport { type WikiPageEntry, parseIndexEntries } from \"../index-parse.js\";\nimport { findBrokenLinksInPage, findMissingFiles, findOrphanPages, findTagDrift } from \"../lint.js\";\nimport { type WikiGraph, buildWikiGraph } from \"../graph.js\";\nimport { readTextSafe, readTextSafeSync } from \"./fs.js\";\nimport { getPageIndex } from \"./pageIndex.js\";\nimport { parseFrontmatterTags } from \"./frontmatter.js\";\nimport { wikiDirs } from \"./paths.js\";\n\n// Below this length the fuzzy `includes` step is skipped — CJK /\n// emoji-only / very-short page names slugify down to a short noise\n// tail that partial-matches almost anything; the index.md title-match\n// fallback still handles the legitimate non-ASCII case (#1194).\nconst MIN_FUZZY_SLUG_LEN = 6;\n\nfunction readFileOrEmpty(absPath: string): string {\n  return readTextSafeSync(absPath) ?? \"\";\n}\n\n/** Walk every indexed slug for an `includes`-style match. Returns the\n *  single best candidate, or null when the slug is too short OR several\n *  candidates tie at the top score (ambiguous → defer to the caller's\n *  title-match fallback). Score = min/max length, decoupled from Map\n *  iteration order so resolution is deterministic across hosts. */\nexport function pickFuzzyMatch(slug: string, slugs: ReadonlyMap<string, string>): string | null {\n  if (slug.length < MIN_FUZZY_SLUG_LEN) return null;\n  let bestFile: string | null = null;\n  let bestScore = 0;\n  let bestIsTied = false;\n  for (const [key, file] of slugs) {\n    if (!slug.includes(key) && !key.includes(slug)) continue;\n    const shorter = Math.min(slug.length, key.length);\n    const longer = Math.max(slug.length, key.length);\n    const score = shorter / longer;\n    if (score > bestScore) {\n      bestScore = score;\n      bestFile = file;\n      bestIsTied = false;\n    } else if (score === bestScore) {\n      bestIsTied = true;\n    }\n  }\n  return bestIsTied ? null : bestFile;\n}\n\n/** Resolve a page name to an absolute `.md` path: exact slug → fuzzy →\n *  index-title fallback (for non-ASCII names that slugify to empty).\n *  `pageName` may carry the `[[target|display]]` form; `parseWikiLink`\n *  strips the display half so the lookup uses just the target. */\nexport async function resolvePagePath(workspace: string, pageName: string): Promise<string | null> {\n  const { pagesDir, indexFile } = wikiDirs(workspace);\n  const { slugs } = await getPageIndex(pagesDir);\n  if (slugs.size === 0) return null;\n\n  const { target } = parseWikiLink(pageName);\n  const slug = wikiSlugify(target);\n\n  if (slug.length > 0) {\n    const exact = slugs.get(slug);\n    if (exact) return path.join(pagesDir, exact);\n    const fuzzy = pickFuzzyMatch(slug, slugs);\n    if (fuzzy) return path.join(pagesDir, fuzzy);\n  }\n\n  const entries = parseIndexEntries(readFileOrEmpty(indexFile));\n  const titleMatch = entries.find((entry) => entry.title === target);\n  if (titleMatch) {\n    const file = slugs.get(titleMatch.slug);\n    if (file) return path.join(pagesDir, file);\n  }\n  return null;\n}\n\n/** Raw `index.md` content + its parsed entries. */\nexport function readWikiIndex(workspace: string): { content: string; entries: WikiPageEntry[] } {\n  const content = readFileOrEmpty(wikiDirs(workspace).indexFile);\n  return { content, entries: parseIndexEntries(content) };\n}\n\n/** Raw `log.md` content (empty string if absent). */\nexport function readWikiLog(workspace: string): string {\n  return readFileOrEmpty(wikiDirs(workspace).logFile);\n}\n\nexport interface WikiPageRead {\n  /** Absolute path of the resolved file, or null when nothing matched. */\n  filePath: string | null;\n  /** File body (empty when missing OR when the file is an empty placeholder). */\n  content: string;\n  /** True iff a page file resolved (distinct from empty content). */\n  exists: boolean;\n  /** Title to display — the resolved filename stem, or the raw pageName. */\n  resolvedTitle: string;\n}\n\n/** Resolve + read a page. Distinguishes missing (`exists: false`) from\n *  empty-but-present (`exists: true`, `content: \"\"`). */\nexport async function readWikiPage(workspace: string, pageName: string): Promise<WikiPageRead> {\n  const filePath = await resolvePagePath(workspace, pageName);\n  const content = filePath ? readFileOrEmpty(filePath) : \"\";\n  const resolvedTitle = filePath ? path.basename(filePath, \".md\") : pageName;\n  return { filePath, content, exists: Boolean(filePath), resolvedTitle };\n}\n\n/** Read every page + the index and build the page→page link graph.\n *  No cache: the graph is requested explicitly and a content edit does\n *  not advance the pagesDir mtime the page index caches on. */\nexport async function loadWikiGraph(workspace: string): Promise<WikiGraph> {\n  const { pagesDir, indexFile } = wikiDirs(workspace);\n  const { slugs } = await getPageIndex(pagesDir);\n  const fileEntries = [...slugs.entries()];\n  const contents = await Promise.all(fileEntries.map(async ([, fileName]) => (await readTextSafe(path.join(pagesDir, fileName))) ?? \"\"));\n  const pages = fileEntries.map(([slug], i) => ({ slug, content: contents[i] }));\n  const indexEntries = parseIndexEntries(readFileOrEmpty(indexFile));\n  return buildWikiGraph(pages, indexEntries);\n}\n\n/** Run every lint rule over the on-disk wiki, returning issue strings. */\nexport async function collectLintIssues(workspace: string): Promise<string[]> {\n  const { pagesDir, indexFile } = wikiDirs(workspace);\n  const { slugs } = await getPageIndex(pagesDir);\n  if (slugs.size === 0) {\n    return [\"- Wiki `pages/` directory does not exist yet. Start ingesting sources.\"];\n  }\n  const pageEntries = parseIndexEntries(readFileOrEmpty(indexFile));\n  const indexedSlugs = new Set(pageEntries.map((entry) => entry.slug));\n  const pageFiles = [...slugs.values()];\n  const fileSlugs = new Set(slugs.keys());\n\n  const issues: string[] = [];\n  issues.push(...findOrphanPages(fileSlugs, indexedSlugs));\n  issues.push(...findMissingFiles(pageEntries, fileSlugs));\n  const contents = await Promise.all(pageFiles.map(async (fileName) => (await readTextSafe(path.join(pagesDir, fileName))) ?? \"\"));\n  const frontmatterTagsBySlug = new Map<string, string[]>();\n  for (let i = 0; i < pageFiles.length; i++) {\n    issues.push(...findBrokenLinksInPage(pageFiles[i], contents[i], fileSlugs));\n    // Lowercase the key so a `MyPage.md` filename matches an\n    // `entry.slug` of `mypage`; `findTagDrift` lowercases the lookup.\n    const slug = pageFiles[i].replace(/\\.md$/i, \"\").toLowerCase();\n    frontmatterTagsBySlug.set(slug, parseFrontmatterTags(contents[i]));\n  }\n  issues.push(...findTagDrift(pageEntries, frontmatterTagsBySlug));\n  return issues;\n}\n"],"mappings":"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"}

package/dist/wiki/server/pageIndex.d.ts

@@ -0,0 +1,13 @@
+export interface PageIndex {
+    mtimeMs: number;
+    /** slug → filename (e.g. "sakura-internet" → "sakura-internet.md"). */
+    slugs: Map<string, string>;
+}
+/**
+ * Get the page index for `pagesDir`. Returns a cached value as long as
+ * THAT directory's mtime hasn't advanced; otherwise rebuilds. Safe to
+ * call concurrently — racing builds produce the same result.
+ */
+export declare function getPageIndex(pagesDir: string): Promise<PageIndex>;
+/** Test-only: drop the module-level cache (all directories). */
+export declare function __resetPageIndexCache(): void;