@silicajs/next 0.2.2 → 0.3.1

package/dist/server-data.js

@@ -1,7 +1,16 @@
 import path from "node:path";
-import fs from "fs-extra";
-import { createWikiLinkResolutionIndex } from "@silicajs/core/runtime";
-let pageRuntimeDataCache;
+import fs from "node:fs";
+import Database from "better-sqlite3";
+import {
+  asFullSlug,
+  normalizeAssetReference,
+  normalizeSlug,
+  resolveRelativeAsset,
+  resolveRelative,
+  slugToHref
+} from "@silicajs/core/runtime";
+const VAULT_DATABASE_FILENAME = "vault.db";
+let loadedVaultDb;
 function getProjectRoot() {
   const projectRoot = process.env.SILICA_PROJECT_ROOT;
   if (!projectRoot) {
@@ -12,79 +21,309 @@ function getProjectRoot() {
 function getSilicaRoot() {
   return path.join(getProjectRoot(), ".silica");
 }
-async function loadManifest() {
-  const manifest = await fs.readJson(
-    path.join(getSilicaRoot(), "manifest.json")
-  );
-  const entries = manifest.entries.map((entry) => ({
-    ...entry,
-    file: path.isAbsolute(entry.file) ? entry.file : path.join(getProjectRoot(), entry.file)
-  }));
+function getVaultDatabasePath() {
+  return path.join(getSilicaRoot(), VAULT_DATABASE_FILENAME);
+}
+function loadVaultDb() {
+  const databasePath = getVaultDatabasePath();
+  const stat = fs.statSync(databasePath);
+  if (loadedVaultDb?.databasePath === databasePath && loadedVaultDb.mtimeMs === stat.mtimeMs) {
+    return loadedVaultDb;
+  }
+  loadedVaultDb?.close();
+  const db = new Database(databasePath, {
+    fileMustExist: true,
+    readonly: true
+  });
+  db.pragma("query_only = ON");
+  const metadata = readMetadata(db);
+  loadedVaultDb = {
+    databasePath,
+    generatedAt: metadata.generatedAt,
+    renderEnvironmentHash: metadata.renderEnvironmentHash,
+    config: metadata.config,
+    cacheState: metadata.cacheState,
+    mtimeMs: stat.mtimeMs,
+    db,
+    close: () => {
+      db.close();
+      if (loadedVaultDb?.db === db) loadedVaultDb = void 0;
+    }
+  };
+  return loadedVaultDb;
+}
+function getPage(slug) {
+  const row = loadVaultDb().db.prepare("SELECT * FROM notes WHERE slug = ?").get(slug);
+  return row ? noteRowToEntry(row) : void 0;
+}
+function getPageRuntimeData(slug) {
+  const entry = getPage(slug);
+  if (!entry) return void 0;
+  return {
+    entry,
+    config: getConfig(),
+    cacheState: getCacheState()
+  };
+}
+function getRenderKey(slug) {
+  const loaded = loadVaultDb();
+  const row = loaded.db.prepare("SELECT render_hash FROM notes WHERE slug = ?").get(slug);
+  return {
+    renderHash: row?.render_hash ?? "missing",
+    renderEnvironmentHash: loaded.renderEnvironmentHash
+  };
+}
+function loadRenderEnvironmentHash() {
+  return loadVaultDb().renderEnvironmentHash;
+}
+function getPrerenderSlugs() {
+  return loadVaultDb().db.prepare(
+    "SELECT slug FROM notes WHERE prerender = 1 ORDER BY COALESCE(sort_key, slug), slug"
+  ).all().map((row) => row.slug);
+}
+function getAllSlugs() {
+  return loadVaultDb().db.prepare("SELECT slug FROM notes ORDER BY slug").all().map((row) => row.slug);
+}
+function getNavigation() {
+  const entries = loadVaultDb().db.prepare(
+    `
+      SELECT slug, menu_label AS title, sort_key
+      FROM notes
+      WHERE listed = 1
+      ORDER BY COALESCE(sort_key, slug), slug
+    `
+  ).all();
   return {
-    ...manifest,
-    entries,
-    allSlugs: manifest.allSlugs ?? entries.map((entry) => entry.slug),
-    bySlug: manifest.bySlug ?? Object.fromEntries(entries.map((entry) => [entry.slug, entry]))
+    version: 1,
+    entries: entries.map((entry) => ({
+      slug: entry.slug,
+      title: entry.title,
+      sortKey: entry.sort_key ?? void 0
+    }))
   };
 }
-async function loadGraph() {
-  return fs.readJson(
-    path.join(getSilicaRoot(), "graph.json")
-  );
-}
-async function loadNavigation() {
-  return fs.readJson(
-    path.join(getSilicaRoot(), "navigation.json")
-  );
-}
-async function loadBuildId() {
-  return (await fs.readFile(path.join(getSilicaRoot(), "build-id.txt"), "utf8")).trim();
-}
-async function loadResolvedConfig() {
-  return fs.readJson(
-    path.join(getSilicaRoot(), "config.json")
-  );
-}
-async function loadPageRuntimeData() {
-  const buildId = await loadBuildId();
-  const cacheKey = `${getProjectRoot()}:${buildId}`;
-  if (pageRuntimeDataCache?.cacheKey === cacheKey) {
-    return pageRuntimeDataCache.promise;
+function getBacklinks(slug) {
+  return loadVaultDb().db.prepare(
+    `
+      SELECT n.slug, n.title
+      FROM links l
+      JOIN notes n ON n.slug = l.source_slug
+      WHERE l.target_slug = ?
+        AND l.kind = 'link'
+      ORDER BY n.title COLLATE NOCASE ASC, n.slug
+    `
+  ).all(slug);
+}
+function getConfig() {
+  return loadVaultDb().config;
+}
+function getCacheState() {
+  return loadVaultDb().cacheState;
+}
+function getTagSlugs() {
+  return loadVaultDb().db.prepare("SELECT DISTINCT tag FROM note_tags ORDER BY tag").all().map((row) => row.tag);
+}
+function getEntriesForTag(tag) {
+  return loadVaultDb().db.prepare(
+    `
+      SELECT n.*
+      FROM notes n
+      WHERE n.listed = 1
+        AND EXISTS (
+          SELECT 1
+          FROM note_tags nt
+          WHERE nt.slug = n.slug
+            AND nt.tag = ?
+        )
+      ORDER BY n.title COLLATE NOCASE ASC, n.slug
+    `
+  ).all(tag).map((row) => noteRowToEntry(row));
+}
+function getRelatedTagsForEntries(slugs, tag) {
+  if (slugs.length === 0) return [];
+  return loadVaultDb().db.prepare(
+    `
+      SELECT nt.tag, COUNT(*) AS count
+      FROM note_tags nt
+      WHERE nt.slug IN (${slugs.map(() => "?").join(", ")})
+        AND nt.tag != ?
+      GROUP BY nt.tag
+      ORDER BY count DESC, nt.tag ASC
+      LIMIT 12
+    `
+  ).all(...slugs, tag).map((row) => row.tag);
+}
+function resolveWikiLinkFromDb(currentSlug, target, strategy, ordering) {
+  const [rawPath] = target.split("#");
+  const slugOptions = ordering ?? getConfig().ordering;
+  const normalizedTarget = normalizeSlug(rawPath ?? target, slugOptions);
+  const db = loadVaultDb().db;
+  if (strategy === "absolute") {
+    return lookupAlias(db, "absolute", normalizedTarget);
   }
-  const promise = Promise.all([
-    loadManifest(),
-    loadGraph(),
-    loadResolvedConfig()
-  ]).then(([manifest, graph, config]) => ({
-    buildId,
-    manifest,
-    graph,
-    config,
-    wikilinkIndex: createWikiLinkResolutionIndex(
-      manifest.allSlugs,
-      config.ordering
-    )
-  }));
-  pageRuntimeDataCache = { cacheKey, promise };
-  promise.catch(() => {
-    if (pageRuntimeDataCache?.cacheKey === cacheKey) {
-      pageRuntimeDataCache = void 0;
-    }
-  });
-  return promise;
+  if (strategy === "relative") {
+    const relative = resolveRelative(
+      asFullSlug(currentSlug),
+      normalizedTarget,
+      slugOptions
+    );
+    const resolved = lookupAlias(db, "absolute", relative);
+    if (resolved) return resolved;
+  }
+  return lookupAlias(db, "absolute", normalizedTarget) ?? lookupAlias(db, "absolute", `${normalizedTarget}/index`) ?? lookupAlias(db, "shortest", normalizedTarget.split("/").at(-1) ?? "");
+}
+function resolveAssetFromDb(currentSourcePath, target, strategy, ordering) {
+  const assetOptions = ordering ?? getConfig().ordering;
+  const normalizedTarget = normalizeAssetReference(target, assetOptions);
+  if (!normalizedTarget) return void 0;
+  const db = loadVaultDb().db;
+  const isExplicitRelative = isExplicitRelativeAssetReference(target);
+  if (isExplicitRelative || strategy === "relative") {
+    const relative = resolveRelativeAsset(
+      currentSourcePath,
+      target,
+      assetOptions
+    );
+    const resolved = lookupAssetAlias(db, "absolute", relative);
+    if (resolved || isExplicitRelative) return resolved;
+  }
+  if (strategy === "absolute") {
+    return lookupAssetAlias(db, "absolute", normalizedTarget);
+  }
+  return lookupAssetAlias(db, "absolute", normalizedTarget) ?? lookupAssetAlias(db, "shortest", normalizedTarget.split("/").at(-1) ?? "");
+}
+function getBreadcrumbs(slug) {
+  if (slug === "index" || !slug.includes("/")) return [];
+  const breadcrumbs = [
+    { label: "Home", href: "/" }
+  ];
+  const segments = slug.split("/").slice(0, -1);
+  let acc = "";
+  for (const segment of segments) {
+    acc = acc ? `${acc}/${segment}` : segment;
+    breadcrumbs.push({
+      label: prettySegment(segment),
+      href: breadcrumbSegmentHref(acc)
+    });
+  }
+  return breadcrumbs;
+}
+function loadSearchIndex() {
+  const loaded = loadVaultDb();
+  return {
+    databasePath: loaded.databasePath,
+    db: loaded.db,
+    close: () => void 0
+  };
 }
 function normalizeRouteSlug(slug) {
   return slug?.length ? slug.join("/") : "index";
 }
+function readMetadata(db) {
+  const rows = db.prepare("SELECT key, value FROM vault_metadata").all();
+  const metadata = Object.fromEntries(rows.map((row) => [row.key, row.value]));
+  return {
+    generatedAt: metadata.generatedAt ?? "",
+    renderEnvironmentHash: metadata.renderEnvironmentHash ?? "silica",
+    config: parseConfigMetadata(metadata.configJson),
+    cacheState: JSON.parse(metadata.cacheStateJson ?? "{}")
+  };
+}
+function parseConfigMetadata(value) {
+  if (!value) throw new Error("vault.db is missing configJson metadata.");
+  return JSON.parse(value);
+}
+function lookupAlias(db, strategy, alias) {
+  const row = db.prepare(
+    `
+      SELECT slug
+      FROM slug_aliases
+      WHERE strategy_key = ?
+        AND alias = ?
+      ORDER BY sort_key, slug
+      LIMIT 2
+    `
+  ).all(strategy, alias);
+  return row.length === 1 ? row[0]?.slug : void 0;
+}
+function lookupAssetAlias(db, strategy, alias) {
+  const row = db.prepare(
+    `
+      SELECT asset_path
+      FROM asset_aliases
+      WHERE strategy_key = ?
+        AND alias = ?
+      ORDER BY sort_key, asset_path
+      LIMIT 2
+    `
+  ).all(strategy, alias);
+  return row.length === 1 ? row[0]?.asset_path : void 0;
+}
+function isExplicitRelativeAssetReference(value) {
+  const withoutSuffix = value.split(/[?#]/)[0] ?? "";
+  const normalized = withoutSuffix.replace(/\\/g, "/").replace(/^\/+/, "").replace(/\/+$/, "");
+  return /^\.{1,2}\//.test(normalized);
+}
+function noteRowToEntry(row) {
+  return {
+    slug: row.slug,
+    title: row.title,
+    menuLabel: row.menu_label,
+    description: row.description ?? void 0,
+    generatedDescription: row.generated_description ?? void 0,
+    tags: parseJsonArray(row.tags_json),
+    file: path.isAbsolute(row.file) ? row.file : path.join(getProjectRoot(), row.file),
+    sourcePath: row.source_path,
+    sortKey: row.sort_key ?? void 0,
+    created: row.created ?? void 0,
+    modified: row.modified ?? void 0,
+    frontmatter: parseObject(row.frontmatter_json),
+    contentHash: row.content_hash,
+    embeds: getEmbeds(row.slug)
+  };
+}
+function getEmbeds(slug) {
+  return loadVaultDb().db.prepare(
+    "SELECT target_slug FROM links WHERE source_slug = ? AND kind = 'embed' ORDER BY target_slug"
+  ).all(slug).map((row) => row.target_slug);
+}
+function breadcrumbSegmentHref(segmentPath) {
+  if (getPage(segmentPath)) return slugToHref(segmentPath);
+  const indexSlug = `${segmentPath}/index`;
+  if (getPage(indexSlug)) return slugToHref(indexSlug);
+  return void 0;
+}
+function prettySegment(segment) {
+  return segment.replace(/[-_]/g, " ").replace(/\b\w/g, (letter) => letter.toUpperCase());
+}
+function parseObject(value) {
+  return JSON.parse(value);
+}
+function parseJsonArray(value) {
+  return JSON.parse(value);
+}
 export {
+  getAllSlugs,
+  getBacklinks,
+  getBreadcrumbs,
+  getCacheState,
+  getConfig,
+  getEntriesForTag,
+  getNavigation,
+  getPage,
+  getPageRuntimeData,
+  getPrerenderSlugs,
   getProjectRoot,
+  getRelatedTagsForEntries,
+  getRenderKey,
   getSilicaRoot,
-  loadBuildId,
-  loadGraph,
-  loadManifest,
-  loadNavigation,
-  loadPageRuntimeData,
-  loadResolvedConfig,
-  normalizeRouteSlug
+  getTagSlugs,
+  getVaultDatabasePath,
+  loadRenderEnvironmentHash,
+  loadSearchIndex,
+  loadVaultDb,
+  normalizeRouteSlug,
+  resolveAssetFromDb,
+  resolveWikiLinkFromDb
 };
 //# sourceMappingURL=server-data.js.map

package/dist/server-data.js.map

@@ -1 +1 @@
-{"version":3,"sources":["../src/server-data.ts"],"sourcesContent":["import path from \"node:path\";\nimport fs from \"fs-extra\";\nimport type {\n  Graph,\n  Manifest,\n  Navigation,\n  ResolvedSilicaConfig,\n  WikiLinkResolutionIndex,\n} from \"@silicajs/core/runtime\";\nimport { createWikiLinkResolutionIndex } from \"@silicajs/core/runtime\";\n\nexport type PageRuntimeData = {\n  buildId: string;\n  manifest: Manifest;\n  graph: Graph;\n  config: ResolvedSilicaConfig;\n  wikilinkIndex: WikiLinkResolutionIndex;\n};\n\nlet pageRuntimeDataCache:\n  | { cacheKey: string; promise: Promise<PageRuntimeData> }\n  | undefined;\n\nexport function getProjectRoot(): string {\n  const projectRoot = process.env.SILICA_PROJECT_ROOT;\n  if (!projectRoot) {\n    throw new Error(\"SILICA_PROJECT_ROOT must be set by the Silica CLI.\");\n  }\n\n  return projectRoot;\n}\n\nexport function getSilicaRoot(): string {\n  return path.join(getProjectRoot(), \".silica\");\n}\n\nexport async function loadManifest(): Promise<Manifest> {\n  const manifest = (await fs.readJson(\n    path.join(getSilicaRoot(), \"manifest.json\"),\n  )) as Omit<Manifest, \"allSlugs\" | \"bySlug\"> &\n    Partial<Pick<Manifest, \"allSlugs\" | \"bySlug\">>;\n  const entries = manifest.entries.map((entry) => ({\n    ...entry,\n    file: path.isAbsolute(entry.file)\n      ? entry.file\n      : path.join(getProjectRoot(), entry.file),\n  }));\n  return {\n    ...manifest,\n    entries,\n    allSlugs: manifest.allSlugs ?? entries.map((entry) => entry.slug),\n    bySlug:\n      manifest.bySlug ??\n      Object.fromEntries(entries.map((entry) => [entry.slug, entry])),\n  };\n}\n\nexport async function loadGraph(): Promise<Graph> {\n  return fs.readJson(\n    path.join(getSilicaRoot(), \"graph.json\"),\n  ) as Promise<Graph>;\n}\n\nexport async function loadNavigation(): Promise<Navigation> {\n  return fs.readJson(\n    path.join(getSilicaRoot(), \"navigation.json\"),\n  ) as Promise<Navigation>;\n}\n\nexport async function loadBuildId(): Promise<string> {\n  return (\n    await fs.readFile(path.join(getSilicaRoot(), \"build-id.txt\"), \"utf8\")\n  ).trim();\n}\n\nexport async function loadResolvedConfig() {\n  return fs.readJson(\n    path.join(getSilicaRoot(), \"config.json\"),\n  ) as Promise<ResolvedSilicaConfig>;\n}\n\nexport async function loadPageRuntimeData(): Promise<PageRuntimeData> {\n  const buildId = await loadBuildId();\n  const cacheKey = `${getProjectRoot()}:${buildId}`;\n  if (pageRuntimeDataCache?.cacheKey === cacheKey) {\n    return pageRuntimeDataCache.promise;\n  }\n\n  const promise = Promise.all([\n    loadManifest(),\n    loadGraph(),\n    loadResolvedConfig(),\n  ]).then(([manifest, graph, config]) => ({\n    buildId,\n    manifest,\n    graph,\n    config,\n    wikilinkIndex: createWikiLinkResolutionIndex(\n      manifest.allSlugs,\n      config.ordering,\n    ),\n  }));\n\n  pageRuntimeDataCache = { cacheKey, promise };\n  promise.catch(() => {\n    if (pageRuntimeDataCache?.cacheKey === cacheKey) {\n      pageRuntimeDataCache = undefined;\n    }\n  });\n  return promise;\n}\n\nexport function normalizeRouteSlug(slug?: string[]): string {\n  return slug?.length ? slug.join(\"/\") : \"index\";\n}\n"],"mappings":"AAAA,OAAO,UAAU;AACjB,OAAO,QAAQ;AAQf,SAAS,qCAAqC;AAU9C,IAAI;AAIG,SAAS,iBAAyB;AACvC,QAAM,cAAc,QAAQ,IAAI;AAChC,MAAI,CAAC,aAAa;AAChB,UAAM,IAAI,MAAM,oDAAoD;AAAA,EACtE;AAEA,SAAO;AACT;AAEO,SAAS,gBAAwB;AACtC,SAAO,KAAK,KAAK,eAAe,GAAG,SAAS;AAC9C;AAEA,eAAsB,eAAkC;AACtD,QAAM,WAAY,MAAM,GAAG;AAAA,IACzB,KAAK,KAAK,cAAc,GAAG,eAAe;AAAA,EAC5C;AAEA,QAAM,UAAU,SAAS,QAAQ,IAAI,CAAC,WAAW;AAAA,IAC/C,GAAG;AAAA,IACH,MAAM,KAAK,WAAW,MAAM,IAAI,IAC5B,MAAM,OACN,KAAK,KAAK,eAAe,GAAG,MAAM,IAAI;AAAA,EAC5C,EAAE;AACF,SAAO;AAAA,IACL,GAAG;AAAA,IACH;AAAA,IACA,UAAU,SAAS,YAAY,QAAQ,IAAI,CAAC,UAAU,MAAM,IAAI;AAAA,IAChE,QACE,SAAS,UACT,OAAO,YAAY,QAAQ,IAAI,CAAC,UAAU,CAAC,MAAM,MAAM,KAAK,CAAC,CAAC;AAAA,EAClE;AACF;AAEA,eAAsB,YAA4B;AAChD,SAAO,GAAG;AAAA,IACR,KAAK,KAAK,cAAc,GAAG,YAAY;AAAA,EACzC;AACF;AAEA,eAAsB,iBAAsC;AAC1D,SAAO,GAAG;AAAA,IACR,KAAK,KAAK,cAAc,GAAG,iBAAiB;AAAA,EAC9C;AACF;AAEA,eAAsB,cAA+B;AACnD,UACE,MAAM,GAAG,SAAS,KAAK,KAAK,cAAc,GAAG,cAAc,GAAG,MAAM,GACpE,KAAK;AACT;AAEA,eAAsB,qBAAqB;AACzC,SAAO,GAAG;AAAA,IACR,KAAK,KAAK,cAAc,GAAG,aAAa;AAAA,EAC1C;AACF;AAEA,eAAsB,sBAAgD;AACpE,QAAM,UAAU,MAAM,YAAY;AAClC,QAAM,WAAW,GAAG,eAAe,CAAC,IAAI,OAAO;AAC/C,MAAI,sBAAsB,aAAa,UAAU;AAC/C,WAAO,qBAAqB;AAAA,EAC9B;AAEA,QAAM,UAAU,QAAQ,IAAI;AAAA,IAC1B,aAAa;AAAA,IACb,UAAU;AAAA,IACV,mBAAmB;AAAA,EACrB,CAAC,EAAE,KAAK,CAAC,CAAC,UAAU,OAAO,MAAM,OAAO;AAAA,IACtC;AAAA,IACA;AAAA,IACA;AAAA,IACA;AAAA,IACA,eAAe;AAAA,MACb,SAAS;AAAA,MACT,OAAO;AAAA,IACT;AAAA,EACF,EAAE;AAEF,yBAAuB,EAAE,UAAU,QAAQ;AAC3C,UAAQ,MAAM,MAAM;AAClB,QAAI,sBAAsB,aAAa,UAAU;AAC/C,6BAAuB;AAAA,IACzB;AAAA,EACF,CAAC;AACD,SAAO;AACT;AAEO,SAAS,mBAAmB,MAAyB;AAC1D,SAAO,MAAM,SAAS,KAAK,KAAK,GAAG,IAAI;AACzC;","names":[]}
+{"version":3,"sources":["../src/server-data.ts"],"sourcesContent":["import path from \"node:path\";\nimport fs from \"node:fs\";\nimport Database from \"better-sqlite3\";\nimport type { LoadedSearchIndex } from \"@silicajs/search\";\nimport type {\n  Navigation,\n  ManifestEntry,\n  RenderCacheState,\n  ResolvedSilicaConfig,\n} from \"@silicajs/core/runtime\";\nimport {\n  asFullSlug,\n  normalizeAssetReference,\n  normalizeSlug,\n  resolveRelativeAsset,\n  resolveRelative,\n  slugToHref,\n} from \"@silicajs/core/runtime\";\n\nconst VAULT_DATABASE_FILENAME = \"vault.db\";\n\nexport type LoadedVaultDb = {\n  databasePath: string;\n  generatedAt: string;\n  renderEnvironmentHash: string;\n  config: ResolvedSilicaConfig;\n  cacheState: RenderCacheState;\n  mtimeMs: number;\n  db: Database.Database;\n  close(): void;\n};\n\nexport type VaultPageData = {\n  cacheState: RenderCacheState;\n  config: ResolvedSilicaConfig;\n  entry: ManifestEntry;\n};\n\ntype MetadataRows = {\n  generatedAt: string;\n  renderEnvironmentHash: string;\n  config: ResolvedSilicaConfig;\n  cacheState: RenderCacheState;\n};\n\ntype NoteRow = {\n  slug: string;\n  file: string;\n  source_path: string;\n  title: string;\n  menu_label: string;\n  description: string | null;\n  generated_description: string | null;\n  frontmatter_json: string;\n  tags_json: string;\n  created: string | null;\n  modified: string | null;\n  sort_key: string | null;\n  listed: 0 | 1;\n  content_hash: string;\n  render_hash: string;\n  prerender: 0 | 1;\n};\n\ntype NavigationRow = {\n  slug: string;\n  title: string;\n  sort_key: string | null;\n};\n\ntype BacklinkRow = {\n  slug: string;\n  title: string;\n};\n\nlet loadedVaultDb: LoadedVaultDb | undefined;\n\nexport function getProjectRoot(): string {\n  const projectRoot = process.env.SILICA_PROJECT_ROOT;\n  if (!projectRoot) {\n    throw new Error(\"SILICA_PROJECT_ROOT must be set by the Silica CLI.\");\n  }\n\n  return projectRoot;\n}\n\nexport function getSilicaRoot(): string {\n  return path.join(getProjectRoot(), \".silica\");\n}\n\nexport function getVaultDatabasePath(): string {\n  return path.join(getSilicaRoot(), VAULT_DATABASE_FILENAME);\n}\n\nexport function loadVaultDb(): LoadedVaultDb {\n  const databasePath = getVaultDatabasePath();\n  const stat = fs.statSync(databasePath);\n  if (\n    loadedVaultDb?.databasePath === databasePath &&\n    loadedVaultDb.mtimeMs === stat.mtimeMs\n  ) {\n    return loadedVaultDb;\n  }\n\n  loadedVaultDb?.close();\n\n  const db = new Database(databasePath, {\n    fileMustExist: true,\n    readonly: true,\n  });\n  db.pragma(\"query_only = ON\");\n  const metadata = readMetadata(db);\n  loadedVaultDb = {\n    databasePath,\n    generatedAt: metadata.generatedAt,\n    renderEnvironmentHash: metadata.renderEnvironmentHash,\n    config: metadata.config,\n    cacheState: metadata.cacheState,\n    mtimeMs: stat.mtimeMs,\n    db,\n    close: () => {\n      db.close();\n      if (loadedVaultDb?.db === db) loadedVaultDb = undefined;\n    },\n  };\n  return loadedVaultDb;\n}\n\nexport function getPage(slug: string): ManifestEntry | undefined {\n  const row = loadVaultDb()\n    .db.prepare(\"SELECT * FROM notes WHERE slug = ?\")\n    .get(slug) as NoteRow | undefined;\n  return row ? noteRowToEntry(row) : undefined;\n}\n\nexport function getPageRuntimeData(slug: string): VaultPageData | undefined {\n  const entry = getPage(slug);\n  if (!entry) return undefined;\n  return {\n    entry,\n    config: getConfig(),\n    cacheState: getCacheState(),\n  };\n}\n\nexport function getRenderKey(slug: string): {\n  renderHash: string;\n  renderEnvironmentHash: string;\n} {\n  const loaded = loadVaultDb();\n  const row = loaded.db\n    .prepare(\"SELECT render_hash FROM notes WHERE slug = ?\")\n    .get(slug) as { render_hash: string } | undefined;\n  return {\n    renderHash: row?.render_hash ?? \"missing\",\n    renderEnvironmentHash: loaded.renderEnvironmentHash,\n  };\n}\n\nexport function loadRenderEnvironmentHash(): string {\n  return loadVaultDb().renderEnvironmentHash;\n}\n\nexport function getPrerenderSlugs(): string[] {\n  return loadVaultDb()\n    .db.prepare(\n      \"SELECT slug FROM notes WHERE prerender = 1 ORDER BY COALESCE(sort_key, slug), slug\",\n    )\n    .all()\n    .map((row) => (row as { slug: string }).slug);\n}\n\nexport function getAllSlugs(): string[] {\n  return loadVaultDb()\n    .db.prepare(\"SELECT slug FROM notes ORDER BY slug\")\n    .all()\n    .map((row) => (row as { slug: string }).slug);\n}\n\nexport function getNavigation(): Navigation {\n  const entries = loadVaultDb()\n    .db.prepare(\n      `\n      SELECT slug, menu_label AS title, sort_key\n      FROM notes\n      WHERE listed = 1\n      ORDER BY COALESCE(sort_key, slug), slug\n    `,\n    )\n    .all() as NavigationRow[];\n  return {\n    version: 1,\n    entries: entries.map((entry) => ({\n      slug: entry.slug,\n      title: entry.title,\n      sortKey: entry.sort_key ?? undefined,\n    })),\n  };\n}\n\nexport function getBacklinks(slug: string): BacklinkRow[] {\n  return loadVaultDb()\n    .db.prepare(\n      `\n      SELECT n.slug, n.title\n      FROM links l\n      JOIN notes n ON n.slug = l.source_slug\n      WHERE l.target_slug = ?\n        AND l.kind = 'link'\n      ORDER BY n.title COLLATE NOCASE ASC, n.slug\n    `,\n    )\n    .all(slug) as BacklinkRow[];\n}\n\nexport function getConfig(): ResolvedSilicaConfig {\n  return loadVaultDb().config;\n}\n\nexport function getCacheState(): RenderCacheState {\n  return loadVaultDb().cacheState;\n}\n\nexport function getTagSlugs(): string[] {\n  return loadVaultDb()\n    .db.prepare(\"SELECT DISTINCT tag FROM note_tags ORDER BY tag\")\n    .all()\n    .map((row) => (row as { tag: string }).tag);\n}\n\nexport function getEntriesForTag(tag: string): ManifestEntry[] {\n  return loadVaultDb()\n    .db.prepare(\n      `\n      SELECT n.*\n      FROM notes n\n      WHERE n.listed = 1\n        AND EXISTS (\n          SELECT 1\n          FROM note_tags nt\n          WHERE nt.slug = n.slug\n            AND nt.tag = ?\n        )\n      ORDER BY n.title COLLATE NOCASE ASC, n.slug\n    `,\n    )\n    .all(tag)\n    .map((row) => noteRowToEntry(row as NoteRow));\n}\n\nexport function getRelatedTagsForEntries(\n  slugs: string[],\n  tag: string,\n): string[] {\n  if (slugs.length === 0) return [];\n  return loadVaultDb()\n    .db.prepare(\n      `\n      SELECT nt.tag, COUNT(*) AS count\n      FROM note_tags nt\n      WHERE nt.slug IN (${slugs.map(() => \"?\").join(\", \")})\n        AND nt.tag != ?\n      GROUP BY nt.tag\n      ORDER BY count DESC, nt.tag ASC\n      LIMIT 12\n    `,\n    )\n    .all(...slugs, tag)\n    .map((row) => (row as { tag: string }).tag);\n}\n\nexport function resolveWikiLinkFromDb(\n  currentSlug: string,\n  target: string,\n  strategy: \"absolute\" | \"relative\" | \"shortest\",\n  ordering?: { numericPrefixes?: boolean },\n): string | undefined {\n  const [rawPath] = target.split(\"#\");\n  const slugOptions = ordering ?? getConfig().ordering;\n  const normalizedTarget = normalizeSlug(rawPath ?? target, slugOptions);\n  const db = loadVaultDb().db;\n\n  if (strategy === \"absolute\") {\n    return lookupAlias(db, \"absolute\", normalizedTarget);\n  }\n\n  if (strategy === \"relative\") {\n    const relative = resolveRelative(\n      asFullSlug(currentSlug),\n      normalizedTarget,\n      slugOptions,\n    );\n    const resolved = lookupAlias(db, \"absolute\", relative);\n    if (resolved) return resolved;\n  }\n\n  return (\n    lookupAlias(db, \"absolute\", normalizedTarget) ??\n    lookupAlias(db, \"absolute\", `${normalizedTarget}/index`) ??\n    lookupAlias(db, \"shortest\", normalizedTarget.split(\"/\").at(-1) ?? \"\")\n  );\n}\n\nexport function resolveAssetFromDb(\n  currentSourcePath: string,\n  target: string,\n  strategy: \"absolute\" | \"relative\" | \"shortest\",\n  ordering?: { numericPrefixes?: boolean },\n): string | undefined {\n  const assetOptions = ordering ?? getConfig().ordering;\n  const normalizedTarget = normalizeAssetReference(target, assetOptions);\n  if (!normalizedTarget) return undefined;\n  const db = loadVaultDb().db;\n  const isExplicitRelative = isExplicitRelativeAssetReference(target);\n\n  if (isExplicitRelative || strategy === \"relative\") {\n    const relative = resolveRelativeAsset(\n      currentSourcePath,\n      target,\n      assetOptions,\n    );\n    const resolved = lookupAssetAlias(db, \"absolute\", relative);\n    if (resolved || isExplicitRelative) return resolved;\n  }\n\n  if (strategy === \"absolute\") {\n    return lookupAssetAlias(db, \"absolute\", normalizedTarget);\n  }\n\n  return (\n    lookupAssetAlias(db, \"absolute\", normalizedTarget) ??\n    lookupAssetAlias(db, \"shortest\", normalizedTarget.split(\"/\").at(-1) ?? \"\")\n  );\n}\n\nexport function getBreadcrumbs(slug: string) {\n  if (slug === \"index\" || !slug.includes(\"/\")) return [];\n\n  const breadcrumbs: Array<{ label: string; href?: string }> = [\n    { label: \"Home\", href: \"/\" },\n  ];\n  const segments = slug.split(\"/\").slice(0, -1);\n  let acc = \"\";\n  for (const segment of segments) {\n    acc = acc ? `${acc}/${segment}` : segment;\n    breadcrumbs.push({\n      label: prettySegment(segment),\n      href: breadcrumbSegmentHref(acc),\n    });\n  }\n  return breadcrumbs;\n}\n\nexport function loadSearchIndex(): LoadedSearchIndex {\n  const loaded = loadVaultDb();\n  return {\n    databasePath: loaded.databasePath,\n    db: loaded.db,\n    close: () => undefined,\n  };\n}\n\nexport function normalizeRouteSlug(slug?: string[]): string {\n  return slug?.length ? slug.join(\"/\") : \"index\";\n}\n\nfunction readMetadata(db: Database.Database): MetadataRows {\n  const rows = db\n    .prepare(\"SELECT key, value FROM vault_metadata\")\n    .all() as Array<{ key: string; value: string }>;\n  const metadata = Object.fromEntries(rows.map((row) => [row.key, row.value]));\n  return {\n    generatedAt: metadata.generatedAt ?? \"\",\n    renderEnvironmentHash: metadata.renderEnvironmentHash ?? \"silica\",\n    config: parseConfigMetadata(metadata.configJson),\n    cacheState: JSON.parse(metadata.cacheStateJson ?? \"{}\") as RenderCacheState,\n  };\n}\n\nfunction parseConfigMetadata(value: string | undefined): ResolvedSilicaConfig {\n  if (!value) throw new Error(\"vault.db is missing configJson metadata.\");\n  return JSON.parse(value) as ResolvedSilicaConfig;\n}\n\nfunction lookupAlias(\n  db: Database.Database,\n  strategy: string,\n  alias: string,\n): string | undefined {\n  const row = db\n    .prepare(\n      `\n      SELECT slug\n      FROM slug_aliases\n      WHERE strategy_key = ?\n        AND alias = ?\n      ORDER BY sort_key, slug\n      LIMIT 2\n    `,\n    )\n    .all(strategy, alias) as Array<{ slug: string }>;\n  return row.length === 1 ? row[0]?.slug : undefined;\n}\n\nfunction lookupAssetAlias(\n  db: Database.Database,\n  strategy: string,\n  alias: string,\n): string | undefined {\n  const row = db\n    .prepare(\n      `\n      SELECT asset_path\n      FROM asset_aliases\n      WHERE strategy_key = ?\n        AND alias = ?\n      ORDER BY sort_key, asset_path\n      LIMIT 2\n    `,\n    )\n    .all(strategy, alias) as Array<{ asset_path: string }>;\n  return row.length === 1 ? row[0]?.asset_path : undefined;\n}\n\nfunction isExplicitRelativeAssetReference(value: string): boolean {\n  const withoutSuffix = value.split(/[?#]/)[0] ?? \"\";\n  const normalized = withoutSuffix\n    .replace(/\\\\/g, \"/\")\n    .replace(/^\\/+/, \"\")\n    .replace(/\\/+$/, \"\");\n  return /^\\.{1,2}\\//.test(normalized);\n}\n\nfunction noteRowToEntry(row: NoteRow): ManifestEntry {\n  return {\n    slug: row.slug,\n    title: row.title,\n    menuLabel: row.menu_label,\n    description: row.description ?? undefined,\n    generatedDescription: row.generated_description ?? undefined,\n    tags: parseJsonArray(row.tags_json),\n    file: path.isAbsolute(row.file)\n      ? row.file\n      : path.join(getProjectRoot(), row.file),\n    sourcePath: row.source_path,\n    sortKey: row.sort_key ?? undefined,\n    created: row.created ?? undefined,\n    modified: row.modified ?? undefined,\n    frontmatter: parseObject(row.frontmatter_json),\n    contentHash: row.content_hash,\n    embeds: getEmbeds(row.slug),\n  };\n}\n\nfunction getEmbeds(slug: string): string[] {\n  return loadVaultDb()\n    .db.prepare(\n      \"SELECT target_slug FROM links WHERE source_slug = ? AND kind = 'embed' ORDER BY target_slug\",\n    )\n    .all(slug)\n    .map((row) => (row as { target_slug: string }).target_slug);\n}\n\nfunction breadcrumbSegmentHref(segmentPath: string): string | undefined {\n  if (getPage(segmentPath)) return slugToHref(segmentPath);\n  const indexSlug = `${segmentPath}/index`;\n  if (getPage(indexSlug)) return slugToHref(indexSlug);\n  return undefined;\n}\n\nfunction prettySegment(segment: string): string {\n  return segment\n    .replace(/[-_]/g, \" \")\n    .replace(/\\b\\w/g, (letter) => letter.toUpperCase());\n}\n\nfunction parseObject(value: string): Record<string, unknown> {\n  return JSON.parse(value) as Record<string, unknown>;\n}\n\nfunction parseJsonArray(value: string): string[] {\n  return JSON.parse(value) as string[];\n}\n"],"mappings":"AAAA,OAAO,UAAU;AACjB,OAAO,QAAQ;AACf,OAAO,cAAc;AAQrB;AAAA,EACE;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,OACK;AAEP,MAAM,0BAA0B;AAwDhC,IAAI;AAEG,SAAS,iBAAyB;AACvC,QAAM,cAAc,QAAQ,IAAI;AAChC,MAAI,CAAC,aAAa;AAChB,UAAM,IAAI,MAAM,oDAAoD;AAAA,EACtE;AAEA,SAAO;AACT;AAEO,SAAS,gBAAwB;AACtC,SAAO,KAAK,KAAK,eAAe,GAAG,SAAS;AAC9C;AAEO,SAAS,uBAA+B;AAC7C,SAAO,KAAK,KAAK,cAAc,GAAG,uBAAuB;AAC3D;AAEO,SAAS,cAA6B;AAC3C,QAAM,eAAe,qBAAqB;AAC1C,QAAM,OAAO,GAAG,SAAS,YAAY;AACrC,MACE,eAAe,iBAAiB,gBAChC,cAAc,YAAY,KAAK,SAC/B;AACA,WAAO;AAAA,EACT;AAEA,iBAAe,MAAM;AAErB,QAAM,KAAK,IAAI,SAAS,cAAc;AAAA,IACpC,eAAe;AAAA,IACf,UAAU;AAAA,EACZ,CAAC;AACD,KAAG,OAAO,iBAAiB;AAC3B,QAAM,WAAW,aAAa,EAAE;AAChC,kBAAgB;AAAA,IACd;AAAA,IACA,aAAa,SAAS;AAAA,IACtB,uBAAuB,SAAS;AAAA,IAChC,QAAQ,SAAS;AAAA,IACjB,YAAY,SAAS;AAAA,IACrB,SAAS,KAAK;AAAA,IACd;AAAA,IACA,OAAO,MAAM;AACX,SAAG,MAAM;AACT,UAAI,eAAe,OAAO,GAAI,iBAAgB;AAAA,IAChD;AAAA,EACF;AACA,SAAO;AACT;AAEO,SAAS,QAAQ,MAAyC;AAC/D,QAAM,MAAM,YAAY,EACrB,GAAG,QAAQ,oCAAoC,EAC/C,IAAI,IAAI;AACX,SAAO,MAAM,eAAe,GAAG,IAAI;AACrC;AAEO,SAAS,mBAAmB,MAAyC;AAC1E,QAAM,QAAQ,QAAQ,IAAI;AAC1B,MAAI,CAAC,MAAO,QAAO;AACnB,SAAO;AAAA,IACL;AAAA,IACA,QAAQ,UAAU;AAAA,IAClB,YAAY,cAAc;AAAA,EAC5B;AACF;AAEO,SAAS,aAAa,MAG3B;AACA,QAAM,SAAS,YAAY;AAC3B,QAAM,MAAM,OAAO,GAChB,QAAQ,8CAA8C,EACtD,IAAI,IAAI;AACX,SAAO;AAAA,IACL,YAAY,KAAK,eAAe;AAAA,IAChC,uBAAuB,OAAO;AAAA,EAChC;AACF;AAEO,SAAS,4BAAoC;AAClD,SAAO,YAAY,EAAE;AACvB;AAEO,SAAS,oBAA8B;AAC5C,SAAO,YAAY,EAChB,GAAG;AAAA,IACF;AAAA,EACF,EACC,IAAI,EACJ,IAAI,CAAC,QAAS,IAAyB,IAAI;AAChD;AAEO,SAAS,cAAwB;AACtC,SAAO,YAAY,EAChB,GAAG,QAAQ,sCAAsC,EACjD,IAAI,EACJ,IAAI,CAAC,QAAS,IAAyB,IAAI;AAChD;AAEO,SAAS,gBAA4B;AAC1C,QAAM,UAAU,YAAY,EACzB,GAAG;AAAA,IACF;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,EAMF,EACC,IAAI;AACP,SAAO;AAAA,IACL,SAAS;AAAA,IACT,SAAS,QAAQ,IAAI,CAAC,WAAW;AAAA,MAC/B,MAAM,MAAM;AAAA,MACZ,OAAO,MAAM;AAAA,MACb,SAAS,MAAM,YAAY;AAAA,IAC7B,EAAE;AAAA,EACJ;AACF;AAEO,SAAS,aAAa,MAA6B;AACxD,SAAO,YAAY,EAChB,GAAG;AAAA,IACF;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,EAQF,EACC,IAAI,IAAI;AACb;AAEO,SAAS,YAAkC;AAChD,SAAO,YAAY,EAAE;AACvB;AAEO,SAAS,gBAAkC;AAChD,SAAO,YAAY,EAAE;AACvB;AAEO,SAAS,cAAwB;AACtC,SAAO,YAAY,EAChB,GAAG,QAAQ,iDAAiD,EAC5D,IAAI,EACJ,IAAI,CAAC,QAAS,IAAwB,GAAG;AAC9C;AAEO,SAAS,iBAAiB,KAA8B;AAC7D,SAAO,YAAY,EAChB,GAAG;AAAA,IACF;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,EAYF,EACC,IAAI,GAAG,EACP,IAAI,CAAC,QAAQ,eAAe,GAAc,CAAC;AAChD;AAEO,SAAS,yBACd,OACA,KACU;AACV,MAAI,MAAM,WAAW,EAAG,QAAO,CAAC;AAChC,SAAO,YAAY,EAChB,GAAG;AAAA,IACF;AAAA;AAAA;AAAA,0BAGoB,MAAM,IAAI,MAAM,GAAG,EAAE,KAAK,IAAI,CAAC;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,EAMrD,EACC,IAAI,GAAG,OAAO,GAAG,EACjB,IAAI,CAAC,QAAS,IAAwB,GAAG;AAC9C;AAEO,SAAS,sBACd,aACA,QACA,UACA,UACoB;AACpB,QAAM,CAAC,OAAO,IAAI,OAAO,MAAM,GAAG;AAClC,QAAM,cAAc,YAAY,UAAU,EAAE;AAC5C,QAAM,mBAAmB,cAAc,WAAW,QAAQ,WAAW;AACrE,QAAM,KAAK,YAAY,EAAE;AAEzB,MAAI,aAAa,YAAY;AAC3B,WAAO,YAAY,IAAI,YAAY,gBAAgB;AAAA,EACrD;AAEA,MAAI,aAAa,YAAY;AAC3B,UAAM,WAAW;AAAA,MACf,WAAW,WAAW;AAAA,MACtB;AAAA,MACA;AAAA,IACF;AACA,UAAM,WAAW,YAAY,IAAI,YAAY,QAAQ;AACrD,QAAI,SAAU,QAAO;AAAA,EACvB;AAEA,SACE,YAAY,IAAI,YAAY,gBAAgB,KAC5C,YAAY,IAAI,YAAY,GAAG,gBAAgB,QAAQ,KACvD,YAAY,IAAI,YAAY,iBAAiB,MAAM,GAAG,EAAE,GAAG,EAAE,KAAK,EAAE;AAExE;AAEO,SAAS,mBACd,mBACA,QACA,UACA,UACoB;AACpB,QAAM,eAAe,YAAY,UAAU,EAAE;AAC7C,QAAM,mBAAmB,wBAAwB,QAAQ,YAAY;AACrE,MAAI,CAAC,iBAAkB,QAAO;AAC9B,QAAM,KAAK,YAAY,EAAE;AACzB,QAAM,qBAAqB,iCAAiC,MAAM;AAElE,MAAI,sBAAsB,aAAa,YAAY;AACjD,UAAM,WAAW;AAAA,MACf;AAAA,MACA;AAAA,MACA;AAAA,IACF;AACA,UAAM,WAAW,iBAAiB,IAAI,YAAY,QAAQ;AAC1D,QAAI,YAAY,mBAAoB,QAAO;AAAA,EAC7C;AAEA,MAAI,aAAa,YAAY;AAC3B,WAAO,iBAAiB,IAAI,YAAY,gBAAgB;AAAA,EAC1D;AAEA,SACE,iBAAiB,IAAI,YAAY,gBAAgB,KACjD,iBAAiB,IAAI,YAAY,iBAAiB,MAAM,GAAG,EAAE,GAAG,EAAE,KAAK,EAAE;AAE7E;AAEO,SAAS,eAAe,MAAc;AAC3C,MAAI,SAAS,WAAW,CAAC,KAAK,SAAS,GAAG,EAAG,QAAO,CAAC;AAErD,QAAM,cAAuD;AAAA,IAC3D,EAAE,OAAO,QAAQ,MAAM,IAAI;AAAA,EAC7B;AACA,QAAM,WAAW,KAAK,MAAM,GAAG,EAAE,MAAM,GAAG,EAAE;AAC5C,MAAI,MAAM;AACV,aAAW,WAAW,UAAU;AAC9B,UAAM,MAAM,GAAG,GAAG,IAAI,OAAO,KAAK;AAClC,gBAAY,KAAK;AAAA,MACf,OAAO,cAAc,OAAO;AAAA,MAC5B,MAAM,sBAAsB,GAAG;AAAA,IACjC,CAAC;AAAA,EACH;AACA,SAAO;AACT;AAEO,SAAS,kBAAqC;AACnD,QAAM,SAAS,YAAY;AAC3B,SAAO;AAAA,IACL,cAAc,OAAO;AAAA,IACrB,IAAI,OAAO;AAAA,IACX,OAAO,MAAM;AAAA,EACf;AACF;AAEO,SAAS,mBAAmB,MAAyB;AAC1D,SAAO,MAAM,SAAS,KAAK,KAAK,GAAG,IAAI;AACzC;AAEA,SAAS,aAAa,IAAqC;AACzD,QAAM,OAAO,GACV,QAAQ,uCAAuC,EAC/C,IAAI;AACP,QAAM,WAAW,OAAO,YAAY,KAAK,IAAI,CAAC,QAAQ,CAAC,IAAI,KAAK,IAAI,KAAK,CAAC,CAAC;AAC3E,SAAO;AAAA,IACL,aAAa,SAAS,eAAe;AAAA,IACrC,uBAAuB,SAAS,yBAAyB;AAAA,IACzD,QAAQ,oBAAoB,SAAS,UAAU;AAAA,IAC/C,YAAY,KAAK,MAAM,SAAS,kBAAkB,IAAI;AAAA,EACxD;AACF;AAEA,SAAS,oBAAoB,OAAiD;AAC5E,MAAI,CAAC,MAAO,OAAM,IAAI,MAAM,0CAA0C;AACtE,SAAO,KAAK,MAAM,KAAK;AACzB;AAEA,SAAS,YACP,IACA,UACA,OACoB;AACpB,QAAM,MAAM,GACT;AAAA,IACC;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,EAQF,EACC,IAAI,UAAU,KAAK;AACtB,SAAO,IAAI,WAAW,IAAI,IAAI,CAAC,GAAG,OAAO;AAC3C;AAEA,SAAS,iBACP,IACA,UACA,OACoB;AACpB,QAAM,MAAM,GACT;AAAA,IACC;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,EAQF,EACC,IAAI,UAAU,KAAK;AACtB,SAAO,IAAI,WAAW,IAAI,IAAI,CAAC,GAAG,aAAa;AACjD;AAEA,SAAS,iCAAiC,OAAwB;AAChE,QAAM,gBAAgB,MAAM,MAAM,MAAM,EAAE,CAAC,KAAK;AAChD,QAAM,aAAa,cAChB,QAAQ,OAAO,GAAG,EAClB,QAAQ,QAAQ,EAAE,EAClB,QAAQ,QAAQ,EAAE;AACrB,SAAO,aAAa,KAAK,UAAU;AACrC;AAEA,SAAS,eAAe,KAA6B;AACnD,SAAO;AAAA,IACL,MAAM,IAAI;AAAA,IACV,OAAO,IAAI;AAAA,IACX,WAAW,IAAI;AAAA,IACf,aAAa,IAAI,eAAe;AAAA,IAChC,sBAAsB,IAAI,yBAAyB;AAAA,IACnD,MAAM,eAAe,IAAI,SAAS;AAAA,IAClC,MAAM,KAAK,WAAW,IAAI,IAAI,IAC1B,IAAI,OACJ,KAAK,KAAK,eAAe,GAAG,IAAI,IAAI;AAAA,IACxC,YAAY,IAAI;AAAA,IAChB,SAAS,IAAI,YAAY;AAAA,IACzB,SAAS,IAAI,WAAW;AAAA,IACxB,UAAU,IAAI,YAAY;AAAA,IAC1B,aAAa,YAAY,IAAI,gBAAgB;AAAA,IAC7C,aAAa,IAAI;AAAA,IACjB,QAAQ,UAAU,IAAI,IAAI;AAAA,EAC5B;AACF;AAEA,SAAS,UAAU,MAAwB;AACzC,SAAO,YAAY,EAChB,GAAG;AAAA,IACF;AAAA,EACF,EACC,IAAI,IAAI,EACR,IAAI,CAAC,QAAS,IAAgC,WAAW;AAC9D;AAEA,SAAS,sBAAsB,aAAyC;AACtE,MAAI,QAAQ,WAAW,EAAG,QAAO,WAAW,WAAW;AACvD,QAAM,YAAY,GAAG,WAAW;AAChC,MAAI,QAAQ,SAAS,EAAG,QAAO,WAAW,SAAS;AACnD,SAAO;AACT;AAEA,SAAS,cAAc,SAAyB;AAC9C,SAAO,QACJ,QAAQ,SAAS,GAAG,EACpB,QAAQ,SAAS,CAAC,WAAW,OAAO,YAAY,CAAC;AACtD;AAEA,SAAS,YAAY,OAAwC;AAC3D,SAAO,KAAK,MAAM,KAAK;AACzB;AAEA,SAAS,eAAe,OAAyB;AAC/C,SAAO,KAAK,MAAM,KAAK;AACzB;","names":[]}

package/dist/template-files/generated-app/app/(site)/[[...slug]]/page.tsx

@@ -1,5 +1,6 @@
 import theme from "../../../silica-theme";
 import { VaultContent } from "@silicajs/next/routes/page";
+import { getRenderKey, normalizeRouteSlug } from "@silicajs/next/server-data";
 export {
   generateMetadata,
   generateStaticParams,
@@ -11,8 +12,14 @@ export default async function Page({
   params: Promise<{ slug?: string[] }> | { slug?: string[] };
 }) {
   const resolvedParams = await params;
-  const slug = resolvedParams?.slug?.length
-    ? resolvedParams.slug.join("/")
-    : "index";
-  return <VaultContent slug={slug} theme={theme} />;
+  const slug = normalizeRouteSlug(resolvedParams?.slug);
+  const renderKey = getRenderKey(slug);
+  return (
+    <VaultContent
+      slug={slug}
+      renderHash={renderKey.renderHash}
+      renderEnvironmentHash={renderKey.renderEnvironmentHash}
+      theme={theme}
+    />
+  );
 }

package/dist/template-files/generated-app/cache-handlers/filesystem-cache.js

@@ -0,0 +1 @@
+export { default } from "@silicajs/next/cache-handlers/filesystem";

package/dist/template-files/next.config.ts

@@ -1,8 +1,32 @@
+import fs from "node:fs";
+import path from "node:path";
+import { createRequire } from "node:module";
+import { fileURLToPath } from "node:url";
 import type { NextConfig } from "next";
 /* __SILICA_CONFIG_IMPORT__ */
 
+const require = createRequire(import.meta.url);
+const nextRoot = path.dirname(fileURLToPath(import.meta.url));
+const silicaRoot = path.resolve(nextRoot, "..");
+const vaultMetadata = readVaultMetadata(path.join(silicaRoot, "vault.db"));
+type VaultConfig = {
+  render?: { cache?: { storage?: "memory" | "filesystem" } };
+};
+const resolvedConfig = parseJson<VaultConfig>(vaultMetadata.configJson);
+const useFilesystemCache = resolvedConfig?.render?.cache?.storage !== "memory";
+
 const baseNextConfig: NextConfig = {
   cacheComponents: true,
+  ...(useFilesystemCache
+    ? {
+        cacheHandlers: {
+          default: require.resolve("./cache-handlers/filesystem-cache.js"),
+          remote: require.resolve("./cache-handlers/filesystem-cache.js"),
+        },
+      }
+    : {}),
+  generateBuildId: async () => vaultMetadata.renderEnvironmentHash ?? "silica",
+  deploymentId: process.env.SILICA_DEPLOYMENT_ID,
   output: "standalone",
   transpilePackages: [
     "@silicajs/core",
@@ -15,15 +39,7 @@ const baseNextConfig: NextConfig = {
   ],
   serverExternalPackages: ["better-sqlite3"],
   outputFileTracingIncludes: {
-    "/*": [
-      "../content/**/*",
-      "../manifest.json",
-      "../navigation.json",
-      "../graph.json",
-      "../config.json",
-      "../search.db",
-      "../build-id.txt",
-    ],
+    "/*": ["../content/**/*", "../vault.db"],
   },
   experimental: {
     externalDir: true,
@@ -31,6 +47,30 @@ const baseNextConfig: NextConfig = {
   },
 };
 
+function readVaultMetadata(databasePath: string): {
+  renderEnvironmentHash?: string;
+  configJson?: string;
+} {
+  if (!fs.existsSync(databasePath)) return {};
+  const Database = require("better-sqlite3") as typeof import("better-sqlite3");
+  const db = new Database(databasePath, {
+    fileMustExist: true,
+    readonly: true,
+  });
+  try {
+    const rows = db
+      .prepare("SELECT key, value FROM vault_metadata")
+      .all() as Array<{ key: string; value: string }>;
+    return Object.fromEntries(rows.map((row) => [row.key, row.value]));
+  } finally {
+    db.close();
+  }
+}
+
+function parseJson<T>(value: string | undefined): T | undefined {
+  return value ? (JSON.parse(value) as T) : undefined;
+}
+
 /* __SILICA_CONFIG_OVERRIDE__ */
 
 export default nextConfig;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@silicajs/next",
-  "version": "0.2.2",
+  "version": "0.3.1",
   "description": "Next.js runtime, routes, templates, and proxy for Silica.",
   "type": "module",
   "license": "MIT",
@@ -60,6 +60,14 @@
       "types": "./dist/dev-reload-client.d.ts",
       "import": "./dist/dev-reload-client.js"
     },
+    "./server-data": {
+      "types": "./dist/server-data.d.ts",
+      "import": "./dist/server-data.js"
+    },
+    "./cache-handlers/filesystem": {
+      "types": "./dist/cache-handlers/filesystem.d.ts",
+      "import": "./dist/cache-handlers/filesystem.js"
+    },
     "./proxy": {
       "types": "./dist/proxy.d.ts",
       "import": "./dist/proxy.js"
@@ -88,11 +96,12 @@
   },
   "dependencies": {
     "@silicajs/auth": "^0.1.1",
-    "@silicajs/components": "^0.2.2",
-    "@silicajs/core": "^0.4.0",
+    "@silicajs/components": "^0.2.4",
+    "@silicajs/core": "^0.6.0",
     "@silicajs/remark-obsidian": "^0.1.0",
-    "@silicajs/search": "^0.2.0",
+    "@silicajs/search": "^0.3.1",
     "better-auth": "1.6.11",
+    "better-sqlite3": "^12.10.0",
     "jiti": "^2.7.0",
     "katex": "^0.17.0"
   },