@remnic/core 9.45.3 → 9.45.5

package/dist/chunk-7YQ6ESEA.js

@@ -0,0 +1,322 @@
+// src/external-wiki.ts
+import { constants } from "fs";
+import { open, opendir, realpath, stat } from "fs/promises";
+import path from "path";
+var DEFAULT_MAX_INDEX_BYTES = 1048576;
+var DEFAULT_MAX_PAGE_BYTES = 1048576;
+var DEFAULT_MAX_CATALOG_ENTRIES = 1e4;
+var DEFAULT_MAX_DIRECTORY_DEPTH = 32;
+var MAX_READ_BYTES = 16777216;
+var MAX_CATALOG_ENTRIES = 1e5;
+var MAX_DIRECTORY_DEPTH = 128;
+var MIN_VISITED_ENTRIES = 100;
+var MAX_VISITED_ENTRIES = 1e6;
+function assertPositiveInteger(value, keyName, maximum) {
+  if (!Number.isSafeInteger(value) || value <= 0) {
+    throw new Error(`${keyName} must be a positive integer`);
+  }
+  if (maximum !== void 0 && value > maximum) {
+    throw new Error(`${keyName} must be at most ${maximum}`);
+  }
+}
+function isInside(baseDir, candidate) {
+  const relative = path.relative(baseDir, candidate);
+  return relative === "" || relative !== ".." && !relative.startsWith(`..${path.sep}`) && !path.isAbsolute(relative);
+}
+function resolveInside(baseDir, relativePath, keyName) {
+  const resolved = path.resolve(baseDir, relativePath);
+  if (!isInside(baseDir, resolved) || resolved === baseDir) {
+    throw new Error(`${keyName} must stay within ${baseDir}`);
+  }
+  return resolved;
+}
+async function requireDirectory(candidate, rootDir, description) {
+  let canonical;
+  try {
+    canonical = await realpath(candidate);
+  } catch (error) {
+    if (error.code === "ENOENT") {
+      throw new Error(`${description} does not exist: ${candidate}`);
+    }
+    throw error;
+  }
+  if (!isInside(rootDir, canonical)) throw new Error(`${description} escapes rootDir`);
+  if (!(await stat(canonical)).isDirectory()) throw new Error(`${description} is not a directory`);
+  return canonical;
+}
+async function optionalDirectory(rootDir, name) {
+  const candidate = path.join(rootDir, name);
+  let canonical;
+  try {
+    canonical = await realpath(candidate);
+  } catch (error) {
+    if (error.code === "ENOENT") return void 0;
+    throw error;
+  }
+  if (!isInside(rootDir, canonical)) throw new Error(`${name} directory escapes rootDir`);
+  if (!(await stat(canonical)).isDirectory()) throw new Error(`${name} path is not a directory`);
+  return canonical;
+}
+async function optionalIndexFile(candidate, rootDir) {
+  let canonical;
+  try {
+    canonical = await realpath(candidate);
+  } catch (error) {
+    if (error.code === "ENOENT") return void 0;
+    throw error;
+  }
+  if (!isInside(rootDir, canonical)) throw new Error("catalog index escapes rootDir");
+  if (!(await stat(canonical)).isFile()) throw new Error("catalog index is not a file");
+  return canonical;
+}
+async function validateExternalWikiLayout(config) {
+  let rootDir;
+  try {
+    rootDir = await realpath(config.rootDir);
+  } catch (error) {
+    if (error.code === "ENOENT") {
+      throw new Error(`external wiki root does not exist: ${config.rootDir}`);
+    }
+    throw error;
+  }
+  if (!(await stat(rootDir)).isDirectory()) throw new Error("external wiki root is not a directory");
+  const pagesDir = await requireDirectory(
+    resolveInside(rootDir, config.pagesDir, "pages directory"),
+    rootDir,
+    "pages directory"
+  );
+  const configuredIndexFile = resolveInside(rootDir, config.indexFile, "catalog index");
+  const canonicalIndexFile = await optionalIndexFile(configuredIndexFile, rootDir);
+  const [rawDir, outputsDir] = await Promise.all([
+    optionalDirectory(rootDir, "raw"),
+    optionalDirectory(rootDir, "outputs")
+  ]);
+  return {
+    rootDir,
+    pagesDir,
+    indexFile: canonicalIndexFile ?? configuredIndexFile,
+    indexPresent: canonicalIndexFile !== void 0,
+    ...rawDir === void 0 ? {} : { rawDir },
+    ...outputsDir === void 0 ? {} : { outputsDir }
+  };
+}
+function normalizeCatalogPath(target, config, base) {
+  let decoded;
+  try {
+    decoded = decodeURIComponent(target.trim());
+  } catch {
+    return null;
+  }
+  const withoutFragment = decoded.split(/[?#]/, 1)[0] ?? "";
+  if (withoutFragment.length === 0 || withoutFragment.startsWith("/") || withoutFragment.includes("\\") || /^[a-z][a-z0-9+.-]*:/i.test(withoutFragment)) {
+    return null;
+  }
+  const pagesDir = path.posix.normalize(config.pagesDir);
+  let relative;
+  if (base === "index") {
+    const baseDir = path.posix.dirname(config.indexFile);
+    const rootRelativeTarget = path.posix.normalize(path.posix.join(baseDir, withoutFragment));
+    relative = path.posix.relative(pagesDir, rootRelativeTarget);
+  } else {
+    const pagesPrefix = pagesDir === "." ? "" : `${pagesDir}/`;
+    const stripped = pagesPrefix.length > 0 && withoutFragment.startsWith(pagesPrefix) ? withoutFragment.slice(pagesPrefix.length) : withoutFragment;
+    relative = path.posix.normalize(stripped);
+  }
+  if (relative === ".." || relative.startsWith("../") || path.posix.isAbsolute(relative) || relative === "." || !relative.toLowerCase().endsWith(".md")) {
+    return null;
+  }
+  return relative;
+}
+function catalogBlurb(line, matchEnd) {
+  const blurb = line.slice(matchEnd).trim().replace(/^[-:|]\s*/, "").trim();
+  return blurb.length === 0 ? void 0 : blurb;
+}
+function parseExternalWikiCatalog(content, config, limits = {}) {
+  const maxEntries = limits.maxEntries ?? DEFAULT_MAX_CATALOG_ENTRIES;
+  assertPositiveInteger(maxEntries, "maxEntries", MAX_CATALOG_ENTRIES);
+  const entries = [];
+  const seenPaths = /* @__PURE__ */ new Set();
+  for (const [lineIndex, line] of content.split(/\r?\n/).entries()) {
+    const markdownMatch = /\[([^\]]+)]\(([^)\s]+)(?:\s+"[^"]*")?\)/.exec(line);
+    const wikiMatch = /\[\[([^\]|]+)(?:\|([^\]]+))?]]/.exec(line);
+    let target;
+    let title;
+    let matchEnd;
+    let pathBase;
+    if (markdownMatch) {
+      title = markdownMatch[1]?.trim() ?? "";
+      target = markdownMatch[2]?.trim() ?? "";
+      matchEnd = (markdownMatch.index ?? 0) + markdownMatch[0].length;
+      pathBase = "index";
+    } else if (wikiMatch) {
+      const wikiTarget = wikiMatch[1]?.trim() ?? "";
+      title = wikiMatch[2]?.trim() || humanizePagePath(wikiTarget);
+      target = wikiTarget.toLowerCase().endsWith(".md") ? wikiTarget : `${wikiTarget}.md`;
+      matchEnd = (wikiMatch.index ?? 0) + wikiMatch[0].length;
+      pathBase = "pages";
+    } else {
+      continue;
+    }
+    const pagePath = normalizeCatalogPath(target, config, pathBase);
+    if (!pagePath || title.length === 0 || seenPaths.has(pagePath)) continue;
+    if (entries.length >= maxEntries) {
+      throw new Error(`catalog contains more than ${maxEntries} entries`);
+    }
+    seenPaths.add(pagePath);
+    const indexBlurb = catalogBlurb(line, matchEnd);
+    entries.push({
+      title,
+      path: pagePath,
+      ...indexBlurb === void 0 ? {} : { indexBlurb },
+      indexLine: lineIndex + 1
+    });
+  }
+  return entries;
+}
+async function canonicalOpenedFile(handle, filePath, displayPath) {
+  if (process.platform === "linux") {
+    const descriptorPath = await realpath(`/proc/self/fd/${handle.fd}`).catch(() => void 0);
+    if (descriptorPath !== void 0) return descriptorPath;
+  }
+  let canonical;
+  try {
+    canonical = await realpath(filePath);
+  } catch {
+    throw new Error(`${displayPath} changed while being opened`);
+  }
+  const [openedStat, pathStat] = await Promise.all([handle.stat(), stat(canonical)]);
+  if (openedStat.dev !== pathStat.dev || openedStat.ino !== pathStat.ino) {
+    throw new Error(`${displayPath} changed while being opened`);
+  }
+  return canonical;
+}
+async function readBoundedUtf8(filePath, allowedRoot, maxBytes, displayPath) {
+  assertPositiveInteger(maxBytes, "maxBytes", MAX_READ_BYTES);
+  const handle = await open(filePath, constants.O_RDONLY | constants.O_NOFOLLOW);
+  try {
+    const openedStat = await handle.stat();
+    if (!openedStat.isFile()) throw new Error(`${displayPath} is not a file`);
+    const canonical = await canonicalOpenedFile(handle, filePath, displayPath);
+    if (!isInside(allowedRoot, canonical)) {
+      throw new Error(`${displayPath} escapes configured root`);
+    }
+    const buffer = Buffer.allocUnsafe(maxBytes + 1);
+    const { bytesRead } = await handle.read(buffer, 0, buffer.length, 0);
+    if (bytesRead > maxBytes) throw new Error(`${displayPath} exceeds ${maxBytes} bytes`);
+    let content;
+    try {
+      content = new TextDecoder("utf-8", { fatal: true }).decode(buffer.subarray(0, bytesRead));
+    } catch {
+      throw new Error(`${displayPath} is not valid UTF-8`);
+    }
+    return { content, bytes: bytesRead };
+  } finally {
+    await handle.close();
+  }
+}
+function humanizePagePath(pagePath) {
+  const stem = path.posix.basename(pagePath, path.posix.extname(pagePath));
+  const words = stem.replace(/[-_]+/g, " ").trim();
+  return words.length === 0 ? stem : `${words[0]?.toUpperCase() ?? ""}${words.slice(1)}`;
+}
+async function listMarkdownPages(pagesDir, maxEntries, maxDepth) {
+  assertPositiveInteger(maxEntries, "maxEntries", MAX_CATALOG_ENTRIES);
+  assertPositiveInteger(maxDepth, "maxDepth", MAX_DIRECTORY_DEPTH);
+  const paths = [];
+  const maxVisitedEntries = Math.min(MAX_VISITED_ENTRIES, Math.max(MIN_VISITED_ENTRIES, maxEntries * 100));
+  let visitedEntries = 0;
+  const walk = async (directory, relativeDirectory, depth) => {
+    if (depth > maxDepth) throw new Error(`pages directory exceeds maxDepth ${maxDepth}`);
+    const dir = await opendir(directory);
+    for await (const entry of dir) {
+      visitedEntries += 1;
+      if (visitedEntries > maxVisitedEntries) {
+        throw new Error(`pages directory contains more than ${maxVisitedEntries} filesystem entries`);
+      }
+      const relativePath = relativeDirectory ? path.posix.join(relativeDirectory, entry.name) : entry.name;
+      if (entry.isDirectory()) {
+        await walk(path.join(directory, entry.name), relativePath, depth + 1);
+      } else if (entry.isFile() && entry.name.toLowerCase().endsWith(".md")) {
+        if (paths.length >= maxEntries) {
+          throw new Error(`pages directory contains more than ${maxEntries} markdown files`);
+        }
+        paths.push(relativePath);
+      }
+    }
+  };
+  await walk(pagesDir, "", 1);
+  return paths.sort((left, right) => left.localeCompare(right)).map((pagePath) => ({
+    title: humanizePagePath(pagePath),
+    path: pagePath
+  }));
+}
+function assertWikiEnabled(config) {
+  if (!config.enabled) throw new Error(`external wiki "${config.id}" is disabled`);
+}
+async function loadExternalWikiCatalog(config, limits = {}) {
+  assertWikiEnabled(config);
+  const maxIndexBytes = limits.maxIndexBytes ?? DEFAULT_MAX_INDEX_BYTES;
+  const maxEntries = limits.maxEntries ?? DEFAULT_MAX_CATALOG_ENTRIES;
+  const maxDepth = limits.maxDepth ?? DEFAULT_MAX_DIRECTORY_DEPTH;
+  assertPositiveInteger(maxEntries, "maxEntries", MAX_CATALOG_ENTRIES);
+  assertPositiveInteger(maxDepth, "maxDepth", MAX_DIRECTORY_DEPTH);
+  const layout = await validateExternalWikiLayout(config);
+  const entries = layout.indexPresent ? parseExternalWikiCatalog(
+    (await readBoundedUtf8(layout.indexFile, layout.rootDir, maxIndexBytes, config.indexFile)).content,
+    config,
+    { maxEntries }
+  ) : await listMarkdownPages(layout.pagesDir, maxEntries, maxDepth);
+  return { wikiId: config.id, indexPresent: layout.indexPresent, entries };
+}
+function normalizePagePath(relativePath) {
+  if (relativePath.includes("\\")) {
+    throw new Error("page path must use POSIX separators");
+  }
+  const normalized = path.posix.normalize(relativePath);
+  if (normalized === "." || normalized === ".." || normalized.startsWith("../") || normalized.startsWith("/")) {
+    throw new Error("page path must stay within the pages directory");
+  }
+  if (!normalized.toLowerCase().endsWith(".md")) {
+    throw new Error("page path must end in .md");
+  }
+  return normalized;
+}
+function pageTitle(content, pagePath) {
+  const heading = /^#\s+(.+?)\s*$/m.exec(content)?.[1]?.trim();
+  return heading && heading.length > 0 ? heading : humanizePagePath(pagePath);
+}
+async function readExternalWikiPage(config, relativePath, maxBytes = DEFAULT_MAX_PAGE_BYTES) {
+  assertWikiEnabled(config);
+  const pagePath = normalizePagePath(relativePath);
+  const layout = await validateExternalWikiLayout(config);
+  const candidate = resolveInside(layout.pagesDir, pagePath, "page path");
+  let canonical;
+  try {
+    canonical = await realpath(candidate);
+  } catch (error) {
+    if (error.code === "ENOENT") {
+      throw new Error(`external wiki page does not exist: ${pagePath}`);
+    }
+    throw error;
+  }
+  if (!isInside(layout.pagesDir, canonical)) {
+    throw new Error("page path must stay within the pages directory");
+  }
+  if (!(await stat(canonical)).isFile()) throw new Error(`external wiki page is not a file: ${pagePath}`);
+  const page = await readBoundedUtf8(canonical, layout.pagesDir, maxBytes, pagePath);
+  return {
+    wikiId: config.id,
+    path: pagePath,
+    title: pageTitle(page.content, pagePath),
+    content: page.content,
+    bytes: page.bytes
+  };
+}
+
+export {
+  validateExternalWikiLayout,
+  parseExternalWikiCatalog,
+  loadExternalWikiCatalog,
+  readExternalWikiPage
+};
+//# sourceMappingURL=chunk-7YQ6ESEA.js.map

package/dist/chunk-7YQ6ESEA.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/external-wiki.ts"],"sourcesContent":["import { constants } from \"node:fs\";\nimport { open, opendir, realpath, stat } from \"node:fs/promises\";\nimport type { FileHandle } from \"node:fs/promises\";\nimport path from \"node:path\";\nimport type { ExternalWikiRoot } from \"./external-wiki-config.js\";\n\nconst DEFAULT_MAX_INDEX_BYTES = 1_048_576;\nconst DEFAULT_MAX_PAGE_BYTES = 1_048_576;\nconst DEFAULT_MAX_CATALOG_ENTRIES = 10_000;\nconst DEFAULT_MAX_DIRECTORY_DEPTH = 32;\nconst MAX_READ_BYTES = 16_777_216;\nconst MAX_CATALOG_ENTRIES = 100_000;\nconst MAX_DIRECTORY_DEPTH = 128;\nconst MIN_VISITED_ENTRIES = 100;\nconst MAX_VISITED_ENTRIES = 1_000_000;\n\nexport type { ExternalWikiRoot } from \"./external-wiki-config.js\";\n\nexport interface ExternalWikiLayout {\n  rootDir: string;\n  pagesDir: string;\n  indexFile: string;\n  indexPresent: boolean;\n  rawDir?: string;\n  outputsDir?: string;\n}\n\nexport interface ExternalWikiCatalogEntry {\n  title: string;\n  path: string;\n  indexBlurb?: string;\n  indexLine?: number;\n}\n\nexport interface ExternalWikiCatalog {\n  wikiId: string;\n  indexPresent: boolean;\n  entries: ExternalWikiCatalogEntry[];\n}\n\nexport interface ExternalWikiCatalogLimits {\n  maxIndexBytes?: number;\n  maxEntries?: number;\n  maxDepth?: number;\n}\n\nexport interface ExternalWikiPage {\n  wikiId: string;\n  path: string;\n  title: string;\n  content: string;\n  bytes: number;\n}\n\nfunction assertPositiveInteger(value: number, keyName: string, maximum?: number): void {\n  if (!Number.isSafeInteger(value) || value <= 0) {\n    throw new Error(`${keyName} must be a positive integer`);\n  }\n  if (maximum !== undefined && value > maximum) {\n    throw new Error(`${keyName} must be at most ${maximum}`);\n  }\n}\n\nfunction isInside(baseDir: string, candidate: string): boolean {\n  const relative = path.relative(baseDir, candidate);\n  return relative === \"\" || (relative !== \"..\" && !relative.startsWith(`..${path.sep}`) && !path.isAbsolute(relative));\n}\n\nfunction resolveInside(baseDir: string, relativePath: string, keyName: string): string {\n  const resolved = path.resolve(baseDir, relativePath);\n  if (!isInside(baseDir, resolved) || resolved === baseDir) {\n    throw new Error(`${keyName} must stay within ${baseDir}`);\n  }\n  return resolved;\n}\n\nasync function requireDirectory(candidate: string, rootDir: string, description: string): Promise<string> {\n  let canonical: string;\n  try {\n    canonical = await realpath(candidate);\n  } catch (error) {\n    if ((error as NodeJS.ErrnoException).code === \"ENOENT\") {\n      throw new Error(`${description} does not exist: ${candidate}`);\n    }\n    throw error;\n  }\n  if (!isInside(rootDir, canonical)) throw new Error(`${description} escapes rootDir`);\n  if (!(await stat(canonical)).isDirectory()) throw new Error(`${description} is not a directory`);\n  return canonical;\n}\n\nasync function optionalDirectory(rootDir: string, name: \"raw\" | \"outputs\"): Promise<string | undefined> {\n  const candidate = path.join(rootDir, name);\n  let canonical: string;\n  try {\n    canonical = await realpath(candidate);\n  } catch (error) {\n    if ((error as NodeJS.ErrnoException).code === \"ENOENT\") return undefined;\n    throw error;\n  }\n  if (!isInside(rootDir, canonical)) throw new Error(`${name} directory escapes rootDir`);\n  if (!(await stat(canonical)).isDirectory()) throw new Error(`${name} path is not a directory`);\n  return canonical;\n}\n\nasync function optionalIndexFile(candidate: string, rootDir: string): Promise<string | undefined> {\n  let canonical: string;\n  try {\n    canonical = await realpath(candidate);\n  } catch (error) {\n    if ((error as NodeJS.ErrnoException).code === \"ENOENT\") return undefined;\n    throw error;\n  }\n  if (!isInside(rootDir, canonical)) throw new Error(\"catalog index escapes rootDir\");\n  if (!(await stat(canonical)).isFile()) throw new Error(\"catalog index is not a file\");\n  return canonical;\n}\n\nexport async function validateExternalWikiLayout(config: ExternalWikiRoot): Promise<ExternalWikiLayout> {\n  let rootDir: string;\n  try {\n    rootDir = await realpath(config.rootDir);\n  } catch (error) {\n    if ((error as NodeJS.ErrnoException).code === \"ENOENT\") {\n      throw new Error(`external wiki root does not exist: ${config.rootDir}`);\n    }\n    throw error;\n  }\n  if (!(await stat(rootDir)).isDirectory()) throw new Error(\"external wiki root is not a directory\");\n\n  const pagesDir = await requireDirectory(\n    resolveInside(rootDir, config.pagesDir, \"pages directory\"),\n    rootDir,\n    \"pages directory\"\n  );\n  const configuredIndexFile = resolveInside(rootDir, config.indexFile, \"catalog index\");\n  const canonicalIndexFile = await optionalIndexFile(configuredIndexFile, rootDir);\n  const [rawDir, outputsDir] = await Promise.all([\n    optionalDirectory(rootDir, \"raw\"),\n    optionalDirectory(rootDir, \"outputs\"),\n  ]);\n\n  return {\n    rootDir,\n    pagesDir,\n    indexFile: canonicalIndexFile ?? configuredIndexFile,\n    indexPresent: canonicalIndexFile !== undefined,\n    ...(rawDir === undefined ? {} : { rawDir }),\n    ...(outputsDir === undefined ? {} : { outputsDir }),\n  };\n}\n\ntype CatalogPathBase = \"index\" | \"pages\";\n\nfunction normalizeCatalogPath(target: string, config: ExternalWikiRoot, base: CatalogPathBase): string | null {\n  let decoded: string;\n  try {\n    decoded = decodeURIComponent(target.trim());\n  } catch {\n    return null;\n  }\n  const withoutFragment = decoded.split(/[?#]/, 1)[0] ?? \"\";\n  if (\n    withoutFragment.length === 0 ||\n    withoutFragment.startsWith(\"/\") ||\n    withoutFragment.includes(\"\\\\\") ||\n    /^[a-z][a-z0-9+.-]*:/i.test(withoutFragment)\n  ) {\n    return null;\n  }\n\n  const pagesDir = path.posix.normalize(config.pagesDir);\n  let relative: string;\n  if (base === \"index\") {\n    const baseDir = path.posix.dirname(config.indexFile);\n    const rootRelativeTarget = path.posix.normalize(path.posix.join(baseDir, withoutFragment));\n    relative = path.posix.relative(pagesDir, rootRelativeTarget);\n  } else {\n    const pagesPrefix = pagesDir === \".\" ? \"\" : `${pagesDir}/`;\n    const stripped = pagesPrefix.length > 0 && withoutFragment.startsWith(pagesPrefix)\n      ? withoutFragment.slice(pagesPrefix.length)\n      : withoutFragment;\n    relative = path.posix.normalize(stripped);\n  }\n  if (\n    relative === \"..\" ||\n    relative.startsWith(\"../\") ||\n    path.posix.isAbsolute(relative) ||\n    relative === \".\" ||\n    !relative.toLowerCase().endsWith(\".md\")\n  ) {\n    return null;\n  }\n  return relative;\n}\n\nfunction catalogBlurb(line: string, matchEnd: number): string | undefined {\n  const blurb = line\n    .slice(matchEnd)\n    .trim()\n    .replace(/^[-:|]\\s*/, \"\")\n    .trim();\n  return blurb.length === 0 ? undefined : blurb;\n}\n\nexport function parseExternalWikiCatalog(\n  content: string,\n  config: ExternalWikiRoot,\n  limits: Pick<ExternalWikiCatalogLimits, \"maxEntries\"> = {}\n): ExternalWikiCatalogEntry[] {\n  const maxEntries = limits.maxEntries ?? DEFAULT_MAX_CATALOG_ENTRIES;\n  assertPositiveInteger(maxEntries, \"maxEntries\", MAX_CATALOG_ENTRIES);\n  const entries: ExternalWikiCatalogEntry[] = [];\n  const seenPaths = new Set<string>();\n\n  for (const [lineIndex, line] of content.split(/\\r?\\n/).entries()) {\n    const markdownMatch = /\\[([^\\]]+)]\\(([^)\\s]+)(?:\\s+\"[^\"]*\")?\\)/.exec(line);\n    const wikiMatch = /\\[\\[([^\\]|]+)(?:\\|([^\\]]+))?]]/.exec(line);\n    let target: string;\n    let title: string;\n    let matchEnd: number;\n    let pathBase: CatalogPathBase;\n    if (markdownMatch) {\n      title = markdownMatch[1]?.trim() ?? \"\";\n      target = markdownMatch[2]?.trim() ?? \"\";\n      matchEnd = (markdownMatch.index ?? 0) + markdownMatch[0].length;\n      pathBase = \"index\";\n    } else if (wikiMatch) {\n      const wikiTarget = wikiMatch[1]?.trim() ?? \"\";\n      title = wikiMatch[2]?.trim() || humanizePagePath(wikiTarget);\n      target = wikiTarget.toLowerCase().endsWith(\".md\") ? wikiTarget : `${wikiTarget}.md`;\n      matchEnd = (wikiMatch.index ?? 0) + wikiMatch[0].length;\n      pathBase = \"pages\";\n    } else {\n      continue;\n    }\n\n    const pagePath = normalizeCatalogPath(target, config, pathBase);\n    if (!pagePath || title.length === 0 || seenPaths.has(pagePath)) continue;\n    if (entries.length >= maxEntries) {\n      throw new Error(`catalog contains more than ${maxEntries} entries`);\n    }\n    seenPaths.add(pagePath);\n    const indexBlurb = catalogBlurb(line, matchEnd);\n    entries.push({\n      title,\n      path: pagePath,\n      ...(indexBlurb === undefined ? {} : { indexBlurb }),\n      indexLine: lineIndex + 1,\n    });\n  }\n  return entries;\n}\n\ninterface BoundedUtf8Read {\n  content: string;\n  bytes: number;\n}\n\nasync function canonicalOpenedFile(handle: FileHandle, filePath: string, displayPath: string): Promise<string> {\n  if (process.platform === \"linux\") {\n    const descriptorPath = await realpath(`/proc/self/fd/${handle.fd}`).catch(() => undefined);\n    if (descriptorPath !== undefined) return descriptorPath;\n  }\n\n  let canonical: string;\n  try {\n    canonical = await realpath(filePath);\n  } catch {\n    throw new Error(`${displayPath} changed while being opened`);\n  }\n  const [openedStat, pathStat] = await Promise.all([handle.stat(), stat(canonical)]);\n  if (openedStat.dev !== pathStat.dev || openedStat.ino !== pathStat.ino) {\n    throw new Error(`${displayPath} changed while being opened`);\n  }\n  return canonical;\n}\n\nasync function readBoundedUtf8(\n  filePath: string,\n  allowedRoot: string,\n  maxBytes: number,\n  displayPath: string\n): Promise<BoundedUtf8Read> {\n  assertPositiveInteger(maxBytes, \"maxBytes\", MAX_READ_BYTES);\n  const handle = await open(filePath, constants.O_RDONLY | constants.O_NOFOLLOW);\n  try {\n    const openedStat = await handle.stat();\n    if (!openedStat.isFile()) throw new Error(`${displayPath} is not a file`);\n    const canonical = await canonicalOpenedFile(handle, filePath, displayPath);\n    if (!isInside(allowedRoot, canonical)) {\n      throw new Error(`${displayPath} escapes configured root`);\n    }\n    const buffer = Buffer.allocUnsafe(maxBytes + 1);\n    const { bytesRead } = await handle.read(buffer, 0, buffer.length, 0);\n    if (bytesRead > maxBytes) throw new Error(`${displayPath} exceeds ${maxBytes} bytes`);\n    let content: string;\n    try {\n      content = new TextDecoder(\"utf-8\", { fatal: true }).decode(buffer.subarray(0, bytesRead));\n    } catch {\n      throw new Error(`${displayPath} is not valid UTF-8`);\n    }\n    return { content, bytes: bytesRead };\n  } finally {\n    await handle.close();\n  }\n}\n\nfunction humanizePagePath(pagePath: string): string {\n  const stem = path.posix.basename(pagePath, path.posix.extname(pagePath));\n  const words = stem.replace(/[-_]+/g, \" \").trim();\n  return words.length === 0 ? stem : `${words[0]?.toUpperCase() ?? \"\"}${words.slice(1)}`;\n}\n\nasync function listMarkdownPages(\n  pagesDir: string,\n  maxEntries: number,\n  maxDepth: number\n): Promise<ExternalWikiCatalogEntry[]> {\n  assertPositiveInteger(maxEntries, \"maxEntries\", MAX_CATALOG_ENTRIES);\n  assertPositiveInteger(maxDepth, \"maxDepth\", MAX_DIRECTORY_DEPTH);\n  const paths: string[] = [];\n  const maxVisitedEntries = Math.min(MAX_VISITED_ENTRIES, Math.max(MIN_VISITED_ENTRIES, maxEntries * 100));\n  let visitedEntries = 0;\n  const walk = async (directory: string, relativeDirectory: string, depth: number): Promise<void> => {\n    if (depth > maxDepth) throw new Error(`pages directory exceeds maxDepth ${maxDepth}`);\n    const dir = await opendir(directory);\n    for await (const entry of dir) {\n      visitedEntries += 1;\n      if (visitedEntries > maxVisitedEntries) {\n        throw new Error(`pages directory contains more than ${maxVisitedEntries} filesystem entries`);\n      }\n      const relativePath = relativeDirectory ? path.posix.join(relativeDirectory, entry.name) : entry.name;\n      if (entry.isDirectory()) {\n        await walk(path.join(directory, entry.name), relativePath, depth + 1);\n      } else if (entry.isFile() && entry.name.toLowerCase().endsWith(\".md\")) {\n        if (paths.length >= maxEntries) {\n          throw new Error(`pages directory contains more than ${maxEntries} markdown files`);\n        }\n        paths.push(relativePath);\n      }\n    }\n  };\n  await walk(pagesDir, \"\", 1);\n  return paths\n    .sort((left, right) => left.localeCompare(right))\n    .map((pagePath) => ({\n      title: humanizePagePath(pagePath),\n      path: pagePath,\n    }));\n}\n\nfunction assertWikiEnabled(config: ExternalWikiRoot): void {\n  if (!config.enabled) throw new Error(`external wiki \"${config.id}\" is disabled`);\n}\n\nexport async function loadExternalWikiCatalog(\n  config: ExternalWikiRoot,\n  limits: ExternalWikiCatalogLimits = {}\n): Promise<ExternalWikiCatalog> {\n  assertWikiEnabled(config);\n  const maxIndexBytes = limits.maxIndexBytes ?? DEFAULT_MAX_INDEX_BYTES;\n  const maxEntries = limits.maxEntries ?? DEFAULT_MAX_CATALOG_ENTRIES;\n  const maxDepth = limits.maxDepth ?? DEFAULT_MAX_DIRECTORY_DEPTH;\n  assertPositiveInteger(maxEntries, \"maxEntries\", MAX_CATALOG_ENTRIES);\n  assertPositiveInteger(maxDepth, \"maxDepth\", MAX_DIRECTORY_DEPTH);\n  const layout = await validateExternalWikiLayout(config);\n  const entries = layout.indexPresent\n    ? parseExternalWikiCatalog(\n        (await readBoundedUtf8(layout.indexFile, layout.rootDir, maxIndexBytes, config.indexFile)).content,\n        config,\n        { maxEntries }\n      )\n    : await listMarkdownPages(layout.pagesDir, maxEntries, maxDepth);\n  return { wikiId: config.id, indexPresent: layout.indexPresent, entries };\n}\n\nfunction normalizePagePath(relativePath: string): string {\n  if (relativePath.includes(\"\\\\\")) {\n    throw new Error(\"page path must use POSIX separators\");\n  }\n  const normalized = path.posix.normalize(relativePath);\n  if (normalized === \".\" || normalized === \"..\" || normalized.startsWith(\"../\") || normalized.startsWith(\"/\")) {\n    throw new Error(\"page path must stay within the pages directory\");\n  }\n  if (!normalized.toLowerCase().endsWith(\".md\")) {\n    throw new Error(\"page path must end in .md\");\n  }\n  return normalized;\n}\n\nfunction pageTitle(content: string, pagePath: string): string {\n  const heading = /^#\\s+(.+?)\\s*$/m.exec(content)?.[1]?.trim();\n  return heading && heading.length > 0 ? heading : humanizePagePath(pagePath);\n}\n\nexport async function readExternalWikiPage(\n  config: ExternalWikiRoot,\n  relativePath: string,\n  maxBytes = DEFAULT_MAX_PAGE_BYTES\n): Promise<ExternalWikiPage> {\n  assertWikiEnabled(config);\n  const pagePath = normalizePagePath(relativePath);\n  const layout = await validateExternalWikiLayout(config);\n  const candidate = resolveInside(layout.pagesDir, pagePath, \"page path\");\n  let canonical: string;\n  try {\n    canonical = await realpath(candidate);\n  } catch (error) {\n    if ((error as NodeJS.ErrnoException).code === \"ENOENT\") {\n      throw new Error(`external wiki page does not exist: ${pagePath}`);\n    }\n    throw error;\n  }\n  if (!isInside(layout.pagesDir, canonical)) {\n    throw new Error(\"page path must stay within the pages directory\");\n  }\n  if (!(await stat(canonical)).isFile()) throw new Error(`external wiki page is not a file: ${pagePath}`);\n  const page = await readBoundedUtf8(canonical, layout.pagesDir, maxBytes, pagePath);\n  return {\n    wikiId: config.id,\n    path: pagePath,\n    title: pageTitle(page.content, pagePath),\n    content: page.content,\n    bytes: page.bytes,\n  };\n}\n"],"mappings":"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","names":[]}

package/dist/{chunk-DNWXFTLD.js → chunk-A4IJCD2Z.js}

@@ -1,6 +1,6 @@
 import {
   StorageManager
-} from "./chunk-E6PNLPGJ.js";
+} from "./chunk-FUCYDRE5.js";
 import {
   composeMemoryEnvelope
 } from "./chunk-CGASUJVP.js";
@@ -546,4 +546,4 @@ export {
   setSemanticRulePromotionTestHooks,
   promoteSemanticRuleFromMemory
 };
-//# sourceMappingURL=chunk-DNWXFTLD.js.map
+//# sourceMappingURL=chunk-A4IJCD2Z.js.map

package/dist/{chunk-3CE77VAP.js → chunk-A4JMGKCD.js}

@@ -1,6 +1,6 @@
 import {
   createVersion
-} from "./chunk-DLVPUX7U.js";
+} from "./chunk-7YKVM5H3.js";
 import {
   bumpMemoryCorpusVersionForDir
 } from "./chunk-IJ7HK452.js";
@@ -10,8 +10,9 @@ import {
   classifyEntityRefWritePath,
   readEntityRefFromFrontmatter,
   repairContentAfterJournalMove,
-  requestEntityCanonicalIdReconcile
-} from "./chunk-4J7G5SY4.js";
+  requestEntityCanonicalIdReconcile,
+  withRawEntityPageMutation
+} from "./chunk-NZBZ7IS2.js";
 import {
   parseExportBundle
 } from "./chunk-WEHSQBFR.js";
@@ -160,82 +161,94 @@ async function importCapsule(opts) {
     (a, b) => a.path.localeCompare(b.path)
   );
   let reconcileNeeded = false;
-  for (const rec of sortedRecords) {
-    const targetRel = computeTargetPath(rec.path, mode, capsule.id);
-    const targetAbs = path.join(rootReal, fromPosixRelPath(targetRel));
-    const exists = await fileExistsAt(targetAbs);
-    if ((mode === "skip" || mode === "fork") && exists) {
-      skipped.push({ path: rec.path, reason: "exists" });
-      continue;
-    }
-    let snapshotted = false;
-    if (mode === "overwrite" && exists) {
-      if (opts.versioning && opts.versioning.enabled) {
-        const prior = await readFile(targetAbs, "utf-8").catch(() => "");
-        await createVersion(
-          targetAbs,
-          prior,
-          "manual",
-          opts.versioning,
-          opts.log,
-          `capsule-import: ${capsule.id}`,
-          rootReal
-        );
-        snapshotted = true;
+  const applyRecords = async () => {
+    for (const rec of sortedRecords) {
+      const targetRel = computeTargetPath(rec.path, mode, capsule.id);
+      const targetAbs = path.join(rootReal, fromPosixRelPath(targetRel));
+      const exists = await fileExistsAt(targetAbs);
+      if ((mode === "skip" || mode === "fork") && exists) {
+        skipped.push({ path: rec.path, reason: "exists" });
+        continue;
       }
-    }
-    let contentToWrite = rec.content;
-    let rewroteId = false;
-    if (mode === "fork") {
-      const forked = rewriteFrontmatterIdForFork(contentToWrite, capsule.id, opts.now);
-      contentToWrite = forked.content;
-      rewroteId = forked.rewrote;
-    }
-    await mkdir(path.dirname(targetAbs), { recursive: true });
-    const targetKind = classifyEntityRefWritePath(rootReal, targetAbs);
-    const rawRef = targetKind === "memory" ? readEntityRefFromFrontmatter(contentToWrite) : null;
-    if (targetKind === "memory" && rawRef !== null && capsuleEntityIds.has(rawRef)) {
-      await writeFile(targetAbs, contentToWrite, "utf-8");
-      reconcileNeeded = true;
-    } else if (targetKind === "memory") {
-      const idsAtWrite = historicalIdCache.get(journalStateDir);
-      const rawRecord = contentToWrite;
-      contentToWrite = canonicalizeEntityRefFrontmatter(rawRecord, idsAtWrite);
-      const originalBytes = await readFile(targetAbs, "utf-8").catch(() => null);
-      await writeFile(targetAbs, contentToWrite, "utf-8");
-      try {
-        await repairContentAfterJournalMove({
-          stateDir: journalStateDir,
-          cache: historicalIdCache,
-          idsAtWrite,
-          rawContent: rawRecord,
-          lastWritten: contentToWrite,
-          rewrite: (content) => writeFile(targetAbs, content, "utf-8")
-        });
-      } catch (err) {
-        if (originalBytes === null) {
-          await unlink(targetAbs).catch(() => void 0);
-        } else {
-          await writeFile(targetAbs, originalBytes, "utf-8").catch(() => void 0);
+      let snapshotted = false;
+      if (mode === "overwrite" && exists) {
+        if (opts.versioning && opts.versioning.enabled) {
+          const prior = await readFile(targetAbs, "utf-8").catch(() => "");
+          await createVersion(
+            targetAbs,
+            prior,
+            "manual",
+            opts.versioning,
+            opts.log,
+            `capsule-import: ${capsule.id}`,
+            rootReal
+          );
+          snapshotted = true;
         }
-        throw err;
       }
-    } else {
-      await writeFile(targetAbs, contentToWrite, "utf-8");
-      if (targetKind === "entity") {
+      let contentToWrite = rec.content;
+      let rewroteId = false;
+      if (mode === "fork") {
+        const forked = rewriteFrontmatterIdForFork(contentToWrite, capsule.id, opts.now);
+        contentToWrite = forked.content;
+        rewroteId = forked.rewrote;
+      }
+      await mkdir(path.dirname(targetAbs), { recursive: true });
+      const targetKind = classifyEntityRefWritePath(rootReal, targetAbs);
+      const rawRef = targetKind === "memory" ? readEntityRefFromFrontmatter(contentToWrite) : null;
+      if (targetKind === "memory" && rawRef !== null && capsuleEntityIds.has(rawRef)) {
+        await writeFile(targetAbs, contentToWrite, "utf-8");
         reconcileNeeded = true;
+      } else if (targetKind === "memory") {
+        const idsAtWrite = historicalIdCache.get(journalStateDir);
+        const rawRecord = contentToWrite;
+        contentToWrite = canonicalizeEntityRefFrontmatter(rawRecord, idsAtWrite);
+        const originalBytes = await readFile(targetAbs, "utf-8").catch(() => null);
+        await writeFile(targetAbs, contentToWrite, "utf-8");
+        try {
+          await repairContentAfterJournalMove({
+            stateDir: journalStateDir,
+            cache: historicalIdCache,
+            idsAtWrite,
+            rawContent: rawRecord,
+            lastWritten: contentToWrite,
+            rewrite: (content) => writeFile(targetAbs, content, "utf-8")
+          });
+        } catch (err) {
+          if (originalBytes === null) {
+            await unlink(targetAbs).catch(() => void 0);
+          } else {
+            await writeFile(targetAbs, originalBytes, "utf-8").catch(() => void 0);
+          }
+          throw err;
+        }
+      } else {
+        await writeFile(targetAbs, contentToWrite, "utf-8");
+        if (targetKind === "entity") {
+          reconcileNeeded = true;
+        }
       }
+      bumpMemoryCorpusVersionForDir(rootReal);
+      imported.push({
+        sourcePath: rec.path,
+        targetPath: targetRel,
+        snapshotted,
+        rewroteId
+      });
     }
-    bumpMemoryCorpusVersionForDir(rootReal);
-    imported.push({
-      sourcePath: rec.path,
-      targetPath: targetRel,
-      snapshotted,
-      rewroteId
-    });
-  }
-  if (reconcileNeeded) {
-    await requestEntityCanonicalIdReconcile(journalStateDir);
+    if (reconcileNeeded) {
+      await requestEntityCanonicalIdReconcile(journalStateDir);
+    }
+  };
+  const firstEntityId = capsuleEntityIds.values().next().value;
+  if (firstEntityId === void 0) {
+    await applyRecords();
+  } else {
+    await withRawEntityPageMutation(
+      rootReal,
+      path.join(rootReal, "entities", `${firstEntityId}.md`),
+      applyRecords
+    );
   }
   skipped.sort((a, b) => a.path.localeCompare(b.path));
   return { imported, skipped, manifest };
@@ -281,4 +294,4 @@ function mintForkId(capsuleId, originalId, now) {
 export {
   importCapsule
 };
-//# sourceMappingURL=chunk-3CE77VAP.js.map
+//# sourceMappingURL=chunk-A4JMGKCD.js.map