wiki-graph-core 0.3.1 → 0.4.0

package/dist/document/home-schema-upgrade.js

@@ -0,0 +1,529 @@
+import { mkdir, rm, stat } from "fs/promises";
+import { dirname, join, resolve } from "path";
+import {
+  resolveWikiGraphCacheDatabasePath,
+  resolveWikiGraphCacheDirectoryPath,
+  resolveWikiGraphCoreDatabasePath,
+  resolveWikiGraphJobsDirectoryPath,
+  resolveWikiGraphStagingDirectoryPath,
+  resolveWikiGraphTempRootDirectoryPath
+} from "../runtime/common/wiki-graph/dir.js";
+import { isNodeError } from "../utils/node-error.js";
+import { Database } from "./database.js";
+const CURRENT_HOME_SCHEMA_VERSION = 2;
+const LOCK_STALE_TIMEOUT_MS = 5 * 60 * 1e3;
+const SEARCH_INDEX_DATABASE_PATH = "fts.db";
+let homeSchemaUpgradeInFlight;
+let currentHomeSchemaDatabaseMemo;
+const HOME_SCHEMA_SQL = `
+  CREATE TABLE IF NOT EXISTS schema_versions (
+    scope TEXT PRIMARY KEY,
+    version INTEGER NOT NULL,
+    updated_at TEXT NOT NULL
+  );
+`;
+async function ensureWikiGraphHomeSchemaCurrent() {
+  const coreDatabasePath = resolveWikiGraphCoreDatabasePath();
+  const resolvedCoreDatabasePath = resolve(coreDatabasePath);
+  const fingerprint = await readHomeSchemaDatabaseFingerprint(coreDatabasePath);
+  if (isCurrentHomeSchemaDatabaseMemo(resolvedCoreDatabasePath, fingerprint)) {
+    return;
+  }
+  if (homeSchemaUpgradeInFlight !== void 0) {
+    await homeSchemaUpgradeInFlight;
+    const refreshedFingerprint2 = await readHomeSchemaDatabaseFingerprint(coreDatabasePath);
+    if (isCurrentHomeSchemaDatabaseMemo(
+      resolvedCoreDatabasePath,
+      refreshedFingerprint2
+    )) {
+      return;
+    }
+  }
+  const refreshedFingerprint = await readHomeSchemaDatabaseFingerprint(coreDatabasePath);
+  if (homeSchemaUpgradeInFlight !== void 0) {
+    await homeSchemaUpgradeInFlight;
+    return ensureWikiGraphHomeSchemaCurrent();
+  }
+  if (isCurrentHomeSchemaDatabaseMemo(
+    resolvedCoreDatabasePath,
+    refreshedFingerprint
+  )) {
+    return;
+  }
+  homeSchemaUpgradeInFlight = (async () => {
+    if (!await pathExists(coreDatabasePath)) {
+      await writeHomeSchemaVersion(
+        coreDatabasePath,
+        CURRENT_HOME_SCHEMA_VERSION
+      );
+      await memoizeCurrentHomeSchemaDatabase(resolvedCoreDatabasePath);
+      return;
+    }
+    const schemaVersion = await readWikiGraphHomeSchemaVersion(coreDatabasePath);
+    if (schemaVersion > CURRENT_HOME_SCHEMA_VERSION) {
+      throw new Error(
+        `Unsupported Wiki Graph home schema version: ${schemaVersion}.`
+      );
+    }
+    if (schemaVersion < CURRENT_HOME_SCHEMA_VERSION) {
+      await assertHomeUpgradeSafeBeforeCleanup();
+      await cleanupHomeDerivedData();
+      await assertNoNonDerivedCoordinatorOverlays();
+      await writeHomeSchemaVersion(
+        coreDatabasePath,
+        CURRENT_HOME_SCHEMA_VERSION
+      );
+    }
+    await memoizeCurrentHomeSchemaDatabase(resolvedCoreDatabasePath);
+  })();
+  try {
+    await homeSchemaUpgradeInFlight;
+    return;
+  } finally {
+    homeSchemaUpgradeInFlight = void 0;
+  }
+}
+async function memoizeCurrentHomeSchemaDatabase(resolvedCoreDatabasePath) {
+  const fingerprint = await readHomeSchemaDatabaseFingerprint(
+    resolvedCoreDatabasePath
+  );
+  if (fingerprint === void 0) {
+    currentHomeSchemaDatabaseMemo = void 0;
+    return;
+  }
+  currentHomeSchemaDatabaseMemo = {
+    fingerprint,
+    path: resolvedCoreDatabasePath
+  };
+}
+async function readHomeSchemaDatabaseFingerprint(coreDatabasePath) {
+  try {
+    const stats = await stat(coreDatabasePath);
+    return {
+      dev: stats.dev,
+      ino: stats.ino,
+      mtimeMs: stats.mtimeMs,
+      size: stats.size
+    };
+  } catch (error) {
+    if (isNodeError(error) && error.code === "ENOENT") {
+      return void 0;
+    }
+    throw error;
+  }
+}
+function isCurrentHomeSchemaDatabaseMemo(resolvedCoreDatabasePath, fingerprint) {
+  if (fingerprint === void 0 || currentHomeSchemaDatabaseMemo === void 0) {
+    return false;
+  }
+  return currentHomeSchemaDatabaseMemo.path === resolvedCoreDatabasePath && isSameHomeSchemaDatabaseFingerprint(
+    currentHomeSchemaDatabaseMemo.fingerprint,
+    fingerprint
+  );
+}
+function isSameHomeSchemaDatabaseFingerprint(left, right) {
+  return left.dev === right.dev && left.ino === right.ino && left.mtimeMs === right.mtimeMs && left.size === right.size;
+}
+async function readWikiGraphHomeSchemaVersion(coreDatabasePath = resolveWikiGraphCoreDatabasePath()) {
+  if (!await pathExists(coreDatabasePath)) {
+    return 0;
+  }
+  const database = await Database.open(coreDatabasePath, "", {
+    readonly: true
+  });
+  try {
+    if (!await tableExists(database, "schema_versions")) {
+      return 1;
+    }
+    const version = await database.queryOne(
+      "SELECT version FROM schema_versions WHERE scope = ?",
+      ["home"],
+      (row) => Number(row.version)
+    );
+    return version ?? 1;
+  } finally {
+    await database.close();
+  }
+}
+function isWikiGraphHomeSchemaGateDatabasePath(databasePath) {
+  const resolvedDatabasePath = resolve(databasePath);
+  return getWikiGraphHomeSchemaGateDatabasePaths().some(
+    (gatePath) => resolvedDatabasePath === resolve(gatePath)
+  );
+}
+function getWikiGraphHomeSchemaGateDatabasePaths() {
+  const cacheDirectoryPath = resolveWikiGraphCacheDirectoryPath();
+  return [
+    resolveWikiGraphCoreDatabasePath(),
+    join(cacheDirectoryPath, "search-sessions.sqlite"),
+    join(cacheDirectoryPath, "continuation-cursors.sqlite"),
+    resolveWikiGraphCacheDatabasePath(),
+    join(resolveWikiGraphJobsDirectoryPath(), "job.sqlite"),
+    join(resolveWikiGraphTempRootDirectoryPath(), "gc.sqlite"),
+    join(resolveWikiGraphStagingDirectoryPath(), "staging.sqlite")
+  ];
+}
+async function writeHomeSchemaVersion(coreDatabasePath, version) {
+  await mkdir(dirname(coreDatabasePath), { recursive: true });
+  const database = await Database.open(coreDatabasePath);
+  try {
+    await database.run(HOME_SCHEMA_SQL);
+    await database.run(
+      `
+        INSERT INTO schema_versions (scope, version, updated_at)
+        VALUES (?, ?, ?)
+        ON CONFLICT(scope) DO UPDATE SET
+          version = excluded.version,
+          updated_at = excluded.updated_at
+      `,
+      ["home", version, (/* @__PURE__ */ new Date()).toISOString()]
+    );
+  } finally {
+    await database.close();
+  }
+}
+async function cleanupHomeDerivedData() {
+  const cacheDirectoryPath = resolveWikiGraphCacheDirectoryPath();
+  const stagingDirectoryPath = resolveWikiGraphStagingDirectoryPath();
+  const jobsDirectoryPath = resolveWikiGraphJobsDirectoryPath();
+  const tempDirectoryPath = resolveWikiGraphTempRootDirectoryPath();
+  await deletePathIfExists(join(cacheDirectoryPath, "search-sessions.sqlite"));
+  await deletePathIfExists(
+    join(cacheDirectoryPath, "continuation-cursors.sqlite")
+  );
+  await deletePathIfExists(resolveWikiGraphCacheDatabasePath());
+  await deletePathIfExists(join(stagingDirectoryPath, "library"));
+  await deletePathIfExists(join(tempDirectoryPath, "gc.sqlite"));
+  await deletePathIfExists(join(tempDirectoryPath, "gc.last-run"));
+  await deletePathIfExists(join(jobsDirectoryPath, "cache"));
+  await deletePathIfExists(join(jobsDirectoryPath, "job.sqlite"));
+  const stagingDatabasePath = join(stagingDirectoryPath, "staging.sqlite");
+  if (await pathExists(stagingDatabasePath)) {
+    await removeArchiveSearchIndexOverlays(stagingDatabasePath);
+    await removeOrphanedSqliteCacheOverlays(stagingDatabasePath);
+  }
+}
+async function assertHomeUpgradeSafeBeforeCleanup() {
+  await assertCoreLocksSafe();
+  await assertGcLockSafe();
+  await assertCoordinatorActiveStateSafe();
+  await assertBuildQueueSafe();
+}
+async function assertCoreLocksSafe() {
+  const coreDatabasePath = resolveWikiGraphCoreDatabasePath();
+  if (!await pathExists(coreDatabasePath)) {
+    return;
+  }
+  const database = await Database.open(coreDatabasePath, "", {
+    readonly: true
+  });
+  try {
+    if (await tableExists(database, "library_locks")) {
+      const rows = await database.queryAll(
+        `
+          SELECT owner_pid, heartbeat_at
+          FROM library_locks
+        `,
+        void 0,
+        (row) => ({
+          heartbeatAt: Number(row.heartbeat_at),
+          ownerPid: Number(row.owner_pid)
+        })
+      );
+      if (rows.some((row) => isActiveLock(row.ownerPid, row.heartbeatAt))) {
+        throw new Error("Cannot upgrade home with active library locks.");
+      }
+    }
+    if (!await tableExists(database, "state_locks")) {
+      return;
+    }
+    const stateLockRows = await database.queryAll(
+      `
+        SELECT owner_pid, heartbeat_at
+        FROM state_locks
+        WHERE scope = 'library'
+      `,
+      void 0,
+      (row) => ({
+        heartbeatAt: Number(row.heartbeat_at),
+        ownerPid: Number(row.owner_pid)
+      })
+    );
+    if (stateLockRows.some((row) => isActiveLock(row.ownerPid, row.heartbeatAt))) {
+      throw new Error("Cannot upgrade home with active library locks.");
+    }
+  } finally {
+    await database.close();
+  }
+}
+async function assertGcLockSafe() {
+  const gcDatabasePath = join(
+    resolveWikiGraphTempRootDirectoryPath(),
+    "gc.sqlite"
+  );
+  if (!await pathExists(gcDatabasePath)) {
+    return;
+  }
+  const database = await Database.open(gcDatabasePath, "", {
+    readonly: true
+  });
+  try {
+    if (!await tableExists(database, "gc_locks")) {
+      return;
+    }
+    const rows = await database.queryAll(
+      "SELECT owner_pid, heartbeat_at FROM gc_locks",
+      void 0,
+      (row) => ({
+        heartbeatAt: Number(row.heartbeat_at),
+        ownerPid: Number(row.owner_pid)
+      })
+    );
+    if (rows.some((row) => isActiveLock(row.ownerPid, row.heartbeatAt))) {
+      throw new Error("Cannot upgrade home with an active GC lock.");
+    }
+  } finally {
+    await database.close();
+  }
+}
+async function assertCoordinatorActiveStateSafe() {
+  const stagingDatabasePath = join(
+    resolveWikiGraphStagingDirectoryPath(),
+    "staging.sqlite"
+  );
+  if (!await pathExists(stagingDatabasePath)) {
+    return;
+  }
+  const database = await Database.open(stagingDatabasePath, "", {
+    readonly: true
+  });
+  try {
+    for (const tableName of [
+      "archive_owners",
+      "entry_locks",
+      "entry_sqlite_leases",
+      "archive_commit_locks"
+    ]) {
+      if (!await tableExists(database, tableName)) {
+        continue;
+      }
+      const rows = await database.queryAll(
+        `
+          SELECT owner_pid, heartbeat_at
+          FROM ${tableName}
+        `,
+        void 0,
+        (row) => ({
+          heartbeatAt: Number(row.heartbeat_at),
+          ownerPid: Number(row.owner_pid)
+        })
+      );
+      if (rows.some((row) => isActiveLock(row.ownerPid, row.heartbeatAt))) {
+        throw new Error(
+          `Cannot upgrade home with active coordinator state: ${tableName}.`
+        );
+      }
+    }
+  } finally {
+    await database.close();
+  }
+}
+async function assertNoNonDerivedCoordinatorOverlays() {
+  const stagingDatabasePath = join(
+    resolveWikiGraphStagingDirectoryPath(),
+    "staging.sqlite"
+  );
+  if (!await pathExists(stagingDatabasePath)) {
+    return;
+  }
+  const database = await Database.open(stagingDatabasePath, "", {
+    readonly: true
+  });
+  try {
+    if (!await tableExists(database, "entry_overlays")) {
+      return;
+    }
+    const overlays = await database.queryAll(
+      `
+        SELECT entry_path
+        FROM entry_overlays
+      `,
+      void 0,
+      (row) => String(row.entry_path)
+    );
+    const problematicOverlay = overlays.find(
+      (entryPath) => entryPath !== SEARCH_INDEX_DATABASE_PATH
+    );
+    if (problematicOverlay !== void 0) {
+      throw new Error(
+        "Cannot upgrade home with non-derived coordinator overlays."
+      );
+    }
+  } finally {
+    await database.close();
+  }
+}
+async function assertBuildQueueSafe() {
+  const jobsDatabasePath = join(
+    resolveWikiGraphJobsDirectoryPath(),
+    "job.sqlite"
+  );
+  if (!await pathExists(jobsDatabasePath)) {
+    return;
+  }
+  const database = await Database.open(jobsDatabasePath, "", {
+    readonly: true
+  });
+  try {
+    if (await tableExists(database, "build_jobs")) {
+      const activeJobs = await database.queryAll(
+        `
+          SELECT job_id
+          FROM build_jobs
+          WHERE state IN ('queued', 'running', 'canceling', 'paused')
+        `,
+        void 0,
+        (row) => String(row.job_id)
+      );
+      if (activeJobs.length > 0) {
+        throw new Error("Cannot upgrade home with active build jobs.");
+      }
+    }
+    if (await tableExists(database, "build_worker_lease")) {
+      const lease = await database.queryOne(
+        `
+          SELECT owner_pid, heartbeat_at
+          FROM build_worker_lease
+          WHERE id = 1
+        `,
+        void 0,
+        (row) => ({
+          heartbeatAt: row.heartbeat_at === null ? void 0 : Number(row.heartbeat_at),
+          ownerPid: row.owner_pid === null ? void 0 : Number(row.owner_pid)
+        })
+      );
+      if (lease?.ownerPid !== void 0 && lease.heartbeatAt !== void 0 && isActiveLock(lease.ownerPid, lease.heartbeatAt)) {
+        throw new Error(
+          "Cannot upgrade home with an active build worker lease."
+        );
+      }
+    }
+  } finally {
+    await database.close();
+  }
+}
+async function removeArchiveSearchIndexOverlays(stagingDatabasePath, archiveKey) {
+  const database = await Database.open(stagingDatabasePath);
+  try {
+    if (!await tableExists(database, "entry_overlays")) {
+      return;
+    }
+    const whereClause = archiveKey === void 0 ? "WHERE entry_path = ?" : "WHERE archive_key = ? AND entry_path = ?";
+    const parameters = archiveKey === void 0 ? [SEARCH_INDEX_DATABASE_PATH] : [archiveKey, SEARCH_INDEX_DATABASE_PATH];
+    const overlays = await database.queryAll(
+      `
+        SELECT archive_key, workspace_path
+        FROM entry_overlays
+        ${whereClause}
+      `,
+      parameters,
+      (row) => ({
+        archiveKey: String(row.archive_key),
+        workspacePath: row.workspace_path === null ? void 0 : String(row.workspace_path)
+      })
+    );
+    for (const overlay of overlays) {
+      if (overlay.workspacePath !== void 0) {
+        await deletePathIfExists(overlay.workspacePath);
+      }
+    }
+    await database.run(
+      `
+        DELETE FROM entry_overlays
+        ${whereClause}
+      `,
+      parameters
+    );
+  } finally {
+    await database.close();
+  }
+}
+async function removeOrphanedSqliteCacheOverlays(stagingDatabasePath) {
+  const database = await Database.open(stagingDatabasePath);
+  try {
+    if (!await tableExists(database, "entry_overlays")) {
+      return;
+    }
+    const overlays = await database.queryAll(
+      `
+        SELECT archive_key, archive_path, entry_path, workspace_path
+        FROM entry_overlays
+        WHERE entry_path IN (?, ?)
+      `,
+      ["database.db", SEARCH_INDEX_DATABASE_PATH],
+      (row) => ({
+        archiveKey: String(row.archive_key),
+        archivePath: String(row.archive_path),
+        entryPath: String(row.entry_path),
+        workspacePath: row.workspace_path === null ? void 0 : String(row.workspace_path)
+      })
+    );
+    for (const overlay of overlays) {
+      if (await pathExists(overlay.archivePath)) {
+        continue;
+      }
+      if (overlay.workspacePath !== void 0) {
+        await deletePathIfExists(overlay.workspacePath);
+      }
+      await database.run(
+        `
+          DELETE FROM entry_overlays
+          WHERE archive_key = ? AND entry_path = ?
+        `,
+        [overlay.archiveKey, overlay.entryPath]
+      );
+    }
+  } finally {
+    await database.close();
+  }
+}
+async function tableExists(database, tableName) {
+  const row = await database.queryOne(
+    `
+      SELECT 1 AS present
+      FROM sqlite_master
+      WHERE type = 'table' AND name = ?
+    `,
+    [tableName],
+    () => true
+  );
+  return row === true;
+}
+function isActiveLock(ownerPid, heartbeatAt) {
+  return Date.now() - heartbeatAt <= LOCK_STALE_TIMEOUT_MS && isProcessAlive(ownerPid);
+}
+function isProcessAlive(pid) {
+  try {
+    process.kill(pid, 0);
+    return true;
+  } catch {
+    return false;
+  }
+}
+async function deletePathIfExists(path) {
+  await rm(path, { force: true, recursive: true });
+}
+async function pathExists(path) {
+  try {
+    await stat(path);
+    return true;
+  } catch {
+    return false;
+  }
+}
+export {
+  ensureWikiGraphHomeSchemaCurrent,
+  isWikiGraphHomeSchemaGateDatabasePath,
+  readWikiGraphHomeSchemaVersion
+};
+//# sourceMappingURL=home-schema-upgrade.js.map

package/dist/document/home-schema-upgrade.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../src/document/home-schema-upgrade.ts"],"sourcesContent":["import { mkdir, rm, stat } from \"fs/promises\";\nimport { dirname, join, resolve } from \"path\";\n\nimport {\n  resolveWikiGraphCacheDatabasePath,\n  resolveWikiGraphCacheDirectoryPath,\n  resolveWikiGraphCoreDatabasePath,\n  resolveWikiGraphJobsDirectoryPath,\n  resolveWikiGraphStagingDirectoryPath,\n  resolveWikiGraphTempRootDirectoryPath,\n} from \"../runtime/common/wiki-graph/dir.js\";\nimport { isNodeError } from \"../utils/node-error.js\";\n\nimport { Database } from \"./database.js\";\n\nconst CURRENT_HOME_SCHEMA_VERSION = 2;\nconst LOCK_STALE_TIMEOUT_MS = 5 * 60 * 1000;\nconst SEARCH_INDEX_DATABASE_PATH = \"fts.db\";\nlet homeSchemaUpgradeInFlight: Promise<void> | undefined;\nlet currentHomeSchemaDatabaseMemo: HomeSchemaDatabaseMemo | undefined;\nconst HOME_SCHEMA_SQL = `\n  CREATE TABLE IF NOT EXISTS schema_versions (\n    scope TEXT PRIMARY KEY,\n    version INTEGER NOT NULL,\n    updated_at TEXT NOT NULL\n  );\n`;\n\ninterface HomeSchemaDatabaseFingerprint {\n  readonly dev: number;\n  readonly ino: number;\n  readonly mtimeMs: number;\n  readonly size: number;\n}\n\ninterface HomeSchemaDatabaseMemo {\n  readonly fingerprint: HomeSchemaDatabaseFingerprint;\n  readonly path: string;\n}\n\nexport async function ensureWikiGraphHomeSchemaCurrent(): Promise<void> {\n  const coreDatabasePath = resolveWikiGraphCoreDatabasePath();\n  const resolvedCoreDatabasePath = resolve(coreDatabasePath);\n  const fingerprint = await readHomeSchemaDatabaseFingerprint(coreDatabasePath);\n\n  if (isCurrentHomeSchemaDatabaseMemo(resolvedCoreDatabasePath, fingerprint)) {\n    return;\n  }\n\n  if (homeSchemaUpgradeInFlight !== undefined) {\n    await homeSchemaUpgradeInFlight;\n    const refreshedFingerprint =\n      await readHomeSchemaDatabaseFingerprint(coreDatabasePath);\n    if (\n      isCurrentHomeSchemaDatabaseMemo(\n        resolvedCoreDatabasePath,\n        refreshedFingerprint,\n      )\n    ) {\n      return;\n    }\n  }\n\n  const refreshedFingerprint =\n    await readHomeSchemaDatabaseFingerprint(coreDatabasePath);\n\n  if (homeSchemaUpgradeInFlight !== undefined) {\n    await homeSchemaUpgradeInFlight;\n    return ensureWikiGraphHomeSchemaCurrent();\n  }\n\n  if (\n    isCurrentHomeSchemaDatabaseMemo(\n      resolvedCoreDatabasePath,\n      refreshedFingerprint,\n    )\n  ) {\n    return;\n  }\n\n  homeSchemaUpgradeInFlight = (async () => {\n    if (!(await pathExists(coreDatabasePath))) {\n      await writeHomeSchemaVersion(\n        coreDatabasePath,\n        CURRENT_HOME_SCHEMA_VERSION,\n      );\n      await memoizeCurrentHomeSchemaDatabase(resolvedCoreDatabasePath);\n      return;\n    }\n\n    const schemaVersion =\n      await readWikiGraphHomeSchemaVersion(coreDatabasePath);\n\n    if (schemaVersion > CURRENT_HOME_SCHEMA_VERSION) {\n      throw new Error(\n        `Unsupported Wiki Graph home schema version: ${schemaVersion}.`,\n      );\n    }\n\n    if (schemaVersion < CURRENT_HOME_SCHEMA_VERSION) {\n      await assertHomeUpgradeSafeBeforeCleanup();\n      await cleanupHomeDerivedData();\n      await assertNoNonDerivedCoordinatorOverlays();\n      await writeHomeSchemaVersion(\n        coreDatabasePath,\n        CURRENT_HOME_SCHEMA_VERSION,\n      );\n    }\n\n    await memoizeCurrentHomeSchemaDatabase(resolvedCoreDatabasePath);\n  })();\n\n  try {\n    await homeSchemaUpgradeInFlight;\n    return;\n  } finally {\n    homeSchemaUpgradeInFlight = undefined;\n  }\n}\n\nasync function memoizeCurrentHomeSchemaDatabase(\n  resolvedCoreDatabasePath: string,\n): Promise<void> {\n  const fingerprint = await readHomeSchemaDatabaseFingerprint(\n    resolvedCoreDatabasePath,\n  );\n\n  if (fingerprint === undefined) {\n    currentHomeSchemaDatabaseMemo = undefined;\n    return;\n  }\n\n  currentHomeSchemaDatabaseMemo = {\n    fingerprint,\n    path: resolvedCoreDatabasePath,\n  };\n}\n\nasync function readHomeSchemaDatabaseFingerprint(\n  coreDatabasePath: string,\n): Promise<HomeSchemaDatabaseFingerprint | undefined> {\n  try {\n    const stats = await stat(coreDatabasePath);\n\n    return {\n      dev: stats.dev,\n      ino: stats.ino,\n      mtimeMs: stats.mtimeMs,\n      size: stats.size,\n    };\n  } catch (error) {\n    if (isNodeError(error) && error.code === \"ENOENT\") {\n      return undefined;\n    }\n\n    throw error;\n  }\n}\n\nfunction isCurrentHomeSchemaDatabaseMemo(\n  resolvedCoreDatabasePath: string,\n  fingerprint: HomeSchemaDatabaseFingerprint | undefined,\n): boolean {\n  if (\n    fingerprint === undefined ||\n    currentHomeSchemaDatabaseMemo === undefined\n  ) {\n    return false;\n  }\n\n  return (\n    currentHomeSchemaDatabaseMemo.path === resolvedCoreDatabasePath &&\n    isSameHomeSchemaDatabaseFingerprint(\n      currentHomeSchemaDatabaseMemo.fingerprint,\n      fingerprint,\n    )\n  );\n}\n\nfunction isSameHomeSchemaDatabaseFingerprint(\n  left: HomeSchemaDatabaseFingerprint,\n  right: HomeSchemaDatabaseFingerprint,\n): boolean {\n  return (\n    left.dev === right.dev &&\n    left.ino === right.ino &&\n    left.mtimeMs === right.mtimeMs &&\n    left.size === right.size\n  );\n}\n\nexport async function readWikiGraphHomeSchemaVersion(\n  coreDatabasePath = resolveWikiGraphCoreDatabasePath(),\n): Promise<number> {\n  if (!(await pathExists(coreDatabasePath))) {\n    return 0;\n  }\n\n  const database = await Database.open(coreDatabasePath, \"\", {\n    readonly: true,\n  });\n\n  try {\n    if (!(await tableExists(database, \"schema_versions\"))) {\n      return 1;\n    }\n\n    const version = await database.queryOne(\n      \"SELECT version FROM schema_versions WHERE scope = ?\",\n      [\"home\"],\n      (row) => Number(row.version),\n    );\n\n    return version ?? 1;\n  } finally {\n    await database.close();\n  }\n}\n\nexport function isWikiGraphHomeSchemaGateDatabasePath(\n  databasePath: string,\n): boolean {\n  const resolvedDatabasePath = resolve(databasePath);\n\n  return getWikiGraphHomeSchemaGateDatabasePaths().some(\n    (gatePath) => resolvedDatabasePath === resolve(gatePath),\n  );\n}\n\nfunction getWikiGraphHomeSchemaGateDatabasePaths(): readonly string[] {\n  const cacheDirectoryPath = resolveWikiGraphCacheDirectoryPath();\n\n  return [\n    resolveWikiGraphCoreDatabasePath(),\n    join(cacheDirectoryPath, \"search-sessions.sqlite\"),\n    join(cacheDirectoryPath, \"continuation-cursors.sqlite\"),\n    resolveWikiGraphCacheDatabasePath(),\n    join(resolveWikiGraphJobsDirectoryPath(), \"job.sqlite\"),\n    join(resolveWikiGraphTempRootDirectoryPath(), \"gc.sqlite\"),\n    join(resolveWikiGraphStagingDirectoryPath(), \"staging.sqlite\"),\n  ];\n}\n\nasync function writeHomeSchemaVersion(\n  coreDatabasePath: string,\n  version: number,\n): Promise<void> {\n  await mkdir(dirname(coreDatabasePath), { recursive: true });\n  const database = await Database.open(coreDatabasePath);\n\n  try {\n    await database.run(HOME_SCHEMA_SQL);\n    await database.run(\n      `\n        INSERT INTO schema_versions (scope, version, updated_at)\n        VALUES (?, ?, ?)\n        ON CONFLICT(scope) DO UPDATE SET\n          version = excluded.version,\n          updated_at = excluded.updated_at\n      `,\n      [\"home\", version, new Date().toISOString()],\n    );\n  } finally {\n    await database.close();\n  }\n}\n\nasync function cleanupHomeDerivedData(): Promise<void> {\n  const cacheDirectoryPath = resolveWikiGraphCacheDirectoryPath();\n  const stagingDirectoryPath = resolveWikiGraphStagingDirectoryPath();\n  const jobsDirectoryPath = resolveWikiGraphJobsDirectoryPath();\n  const tempDirectoryPath = resolveWikiGraphTempRootDirectoryPath();\n\n  await deletePathIfExists(join(cacheDirectoryPath, \"search-sessions.sqlite\"));\n  await deletePathIfExists(\n    join(cacheDirectoryPath, \"continuation-cursors.sqlite\"),\n  );\n  await deletePathIfExists(resolveWikiGraphCacheDatabasePath());\n  await deletePathIfExists(join(stagingDirectoryPath, \"library\"));\n  await deletePathIfExists(join(tempDirectoryPath, \"gc.sqlite\"));\n  await deletePathIfExists(join(tempDirectoryPath, \"gc.last-run\"));\n  await deletePathIfExists(join(jobsDirectoryPath, \"cache\"));\n  await deletePathIfExists(join(jobsDirectoryPath, \"job.sqlite\"));\n\n  const stagingDatabasePath = join(stagingDirectoryPath, \"staging.sqlite\");\n  if (await pathExists(stagingDatabasePath)) {\n    await removeArchiveSearchIndexOverlays(stagingDatabasePath);\n    await removeOrphanedSqliteCacheOverlays(stagingDatabasePath);\n  }\n}\n\nasync function assertHomeUpgradeSafeBeforeCleanup(): Promise<void> {\n  await assertCoreLocksSafe();\n  await assertGcLockSafe();\n  await assertCoordinatorActiveStateSafe();\n  await assertBuildQueueSafe();\n}\n\nasync function assertCoreLocksSafe(): Promise<void> {\n  const coreDatabasePath = resolveWikiGraphCoreDatabasePath();\n\n  if (!(await pathExists(coreDatabasePath))) {\n    return;\n  }\n\n  const database = await Database.open(coreDatabasePath, \"\", {\n    readonly: true,\n  });\n\n  try {\n    if (await tableExists(database, \"library_locks\")) {\n      const rows = await database.queryAll(\n        `\n          SELECT owner_pid, heartbeat_at\n          FROM library_locks\n        `,\n        undefined,\n        (row) => ({\n          heartbeatAt: Number(row.heartbeat_at),\n          ownerPid: Number(row.owner_pid),\n        }),\n      );\n\n      if (rows.some((row) => isActiveLock(row.ownerPid, row.heartbeatAt))) {\n        throw new Error(\"Cannot upgrade home with active library locks.\");\n      }\n    }\n\n    if (!(await tableExists(database, \"state_locks\"))) {\n      return;\n    }\n\n    const stateLockRows = await database.queryAll(\n      `\n        SELECT owner_pid, heartbeat_at\n        FROM state_locks\n        WHERE scope = 'library'\n      `,\n      undefined,\n      (row) => ({\n        heartbeatAt: Number(row.heartbeat_at),\n        ownerPid: Number(row.owner_pid),\n      }),\n    );\n\n    if (\n      stateLockRows.some((row) => isActiveLock(row.ownerPid, row.heartbeatAt))\n    ) {\n      throw new Error(\"Cannot upgrade home with active library locks.\");\n    }\n  } finally {\n    await database.close();\n  }\n}\n\nasync function assertGcLockSafe(): Promise<void> {\n  const gcDatabasePath = join(\n    resolveWikiGraphTempRootDirectoryPath(),\n    \"gc.sqlite\",\n  );\n\n  if (!(await pathExists(gcDatabasePath))) {\n    return;\n  }\n\n  const database = await Database.open(gcDatabasePath, \"\", {\n    readonly: true,\n  });\n\n  try {\n    if (!(await tableExists(database, \"gc_locks\"))) {\n      return;\n    }\n\n    const rows = await database.queryAll(\n      \"SELECT owner_pid, heartbeat_at FROM gc_locks\",\n      undefined,\n      (row) => ({\n        heartbeatAt: Number(row.heartbeat_at),\n        ownerPid: Number(row.owner_pid),\n      }),\n    );\n\n    if (rows.some((row) => isActiveLock(row.ownerPid, row.heartbeatAt))) {\n      throw new Error(\"Cannot upgrade home with an active GC lock.\");\n    }\n  } finally {\n    await database.close();\n  }\n}\n\nasync function assertCoordinatorActiveStateSafe(): Promise<void> {\n  const stagingDatabasePath = join(\n    resolveWikiGraphStagingDirectoryPath(),\n    \"staging.sqlite\",\n  );\n\n  if (!(await pathExists(stagingDatabasePath))) {\n    return;\n  }\n\n  const database = await Database.open(stagingDatabasePath, \"\", {\n    readonly: true,\n  });\n\n  try {\n    for (const tableName of [\n      \"archive_owners\",\n      \"entry_locks\",\n      \"entry_sqlite_leases\",\n      \"archive_commit_locks\",\n    ]) {\n      if (!(await tableExists(database, tableName))) {\n        continue;\n      }\n\n      const rows = await database.queryAll(\n        `\n          SELECT owner_pid, heartbeat_at\n          FROM ${tableName}\n        `,\n        undefined,\n        (row) => ({\n          heartbeatAt: Number(row.heartbeat_at),\n          ownerPid: Number(row.owner_pid),\n        }),\n      );\n\n      if (rows.some((row) => isActiveLock(row.ownerPid, row.heartbeatAt))) {\n        throw new Error(\n          `Cannot upgrade home with active coordinator state: ${tableName}.`,\n        );\n      }\n    }\n  } finally {\n    await database.close();\n  }\n}\n\nasync function assertNoNonDerivedCoordinatorOverlays(): Promise<void> {\n  const stagingDatabasePath = join(\n    resolveWikiGraphStagingDirectoryPath(),\n    \"staging.sqlite\",\n  );\n\n  if (!(await pathExists(stagingDatabasePath))) {\n    return;\n  }\n\n  const database = await Database.open(stagingDatabasePath, \"\", {\n    readonly: true,\n  });\n\n  try {\n    if (!(await tableExists(database, \"entry_overlays\"))) {\n      return;\n    }\n\n    const overlays = await database.queryAll(\n      `\n        SELECT entry_path\n        FROM entry_overlays\n      `,\n      undefined,\n      (row) => String(row.entry_path),\n    );\n\n    const problematicOverlay = overlays.find(\n      (entryPath) => entryPath !== SEARCH_INDEX_DATABASE_PATH,\n    );\n    if (problematicOverlay !== undefined) {\n      throw new Error(\n        \"Cannot upgrade home with non-derived coordinator overlays.\",\n      );\n    }\n  } finally {\n    await database.close();\n  }\n}\n\nasync function assertBuildQueueSafe(): Promise<void> {\n  const jobsDatabasePath = join(\n    resolveWikiGraphJobsDirectoryPath(),\n    \"job.sqlite\",\n  );\n\n  if (!(await pathExists(jobsDatabasePath))) {\n    return;\n  }\n\n  const database = await Database.open(jobsDatabasePath, \"\", {\n    readonly: true,\n  });\n\n  try {\n    if (await tableExists(database, \"build_jobs\")) {\n      const activeJobs = await database.queryAll(\n        `\n          SELECT job_id\n          FROM build_jobs\n          WHERE state IN ('queued', 'running', 'canceling', 'paused')\n        `,\n        undefined,\n        (row) => String(row.job_id),\n      );\n\n      if (activeJobs.length > 0) {\n        throw new Error(\"Cannot upgrade home with active build jobs.\");\n      }\n    }\n\n    if (await tableExists(database, \"build_worker_lease\")) {\n      const lease = await database.queryOne(\n        `\n          SELECT owner_pid, heartbeat_at\n          FROM build_worker_lease\n          WHERE id = 1\n        `,\n        undefined,\n        (row) => ({\n          heartbeatAt:\n            row.heartbeat_at === null ? undefined : Number(row.heartbeat_at),\n          ownerPid: row.owner_pid === null ? undefined : Number(row.owner_pid),\n        }),\n      );\n\n      if (\n        lease?.ownerPid !== undefined &&\n        lease.heartbeatAt !== undefined &&\n        isActiveLock(lease.ownerPid, lease.heartbeatAt)\n      ) {\n        throw new Error(\n          \"Cannot upgrade home with an active build worker lease.\",\n        );\n      }\n    }\n  } finally {\n    await database.close();\n  }\n}\n\nasync function removeArchiveSearchIndexOverlays(\n  stagingDatabasePath: string,\n  archiveKey?: string,\n): Promise<void> {\n  const database = await Database.open(stagingDatabasePath);\n\n  try {\n    if (!(await tableExists(database, \"entry_overlays\"))) {\n      return;\n    }\n\n    const whereClause =\n      archiveKey === undefined\n        ? \"WHERE entry_path = ?\"\n        : \"WHERE archive_key = ? AND entry_path = ?\";\n    const parameters =\n      archiveKey === undefined\n        ? [SEARCH_INDEX_DATABASE_PATH]\n        : [archiveKey, SEARCH_INDEX_DATABASE_PATH];\n    const overlays = await database.queryAll(\n      `\n        SELECT archive_key, workspace_path\n        FROM entry_overlays\n        ${whereClause}\n      `,\n      parameters,\n      (row) => ({\n        archiveKey: String(row.archive_key),\n        workspacePath:\n          row.workspace_path === null ? undefined : String(row.workspace_path),\n      }),\n    );\n\n    for (const overlay of overlays) {\n      if (overlay.workspacePath !== undefined) {\n        await deletePathIfExists(overlay.workspacePath);\n      }\n    }\n\n    await database.run(\n      `\n        DELETE FROM entry_overlays\n        ${whereClause}\n      `,\n      parameters,\n    );\n  } finally {\n    await database.close();\n  }\n}\n\nasync function removeOrphanedSqliteCacheOverlays(\n  stagingDatabasePath: string,\n): Promise<void> {\n  const database = await Database.open(stagingDatabasePath);\n\n  try {\n    if (!(await tableExists(database, \"entry_overlays\"))) {\n      return;\n    }\n\n    const overlays = await database.queryAll(\n      `\n        SELECT archive_key, archive_path, entry_path, workspace_path\n        FROM entry_overlays\n        WHERE entry_path IN (?, ?)\n      `,\n      [\"database.db\", SEARCH_INDEX_DATABASE_PATH],\n      (row) => ({\n        archiveKey: String(row.archive_key),\n        archivePath: String(row.archive_path),\n        entryPath: String(row.entry_path),\n        workspacePath:\n          row.workspace_path === null ? undefined : String(row.workspace_path),\n      }),\n    );\n\n    for (const overlay of overlays) {\n      if (await pathExists(overlay.archivePath)) {\n        continue;\n      }\n\n      if (overlay.workspacePath !== undefined) {\n        await deletePathIfExists(overlay.workspacePath);\n      }\n\n      await database.run(\n        `\n          DELETE FROM entry_overlays\n          WHERE archive_key = ? AND entry_path = ?\n        `,\n        [overlay.archiveKey, overlay.entryPath],\n      );\n    }\n  } finally {\n    await database.close();\n  }\n}\n\nasync function tableExists(\n  database: Database,\n  tableName: string,\n): Promise<boolean> {\n  const row = await database.queryOne(\n    `\n      SELECT 1 AS present\n      FROM sqlite_master\n      WHERE type = 'table' AND name = ?\n    `,\n    [tableName],\n    () => true,\n  );\n\n  return row === true;\n}\n\nfunction isActiveLock(ownerPid: number, heartbeatAt: number): boolean {\n  return (\n    Date.now() - heartbeatAt <= LOCK_STALE_TIMEOUT_MS &&\n    isProcessAlive(ownerPid)\n  );\n}\n\nfunction isProcessAlive(pid: number): boolean {\n  try {\n    process.kill(pid, 0);\n    return true;\n  } catch {\n    return false;\n  }\n}\n\nasync function deletePathIfExists(path: string): Promise<void> {\n  await rm(path, { force: true, recursive: true });\n}\n\nasync function pathExists(path: string): Promise<boolean> {\n  try {\n    await stat(path);\n    return true;\n  } catch {\n    return false;\n  }\n}\n"],"mappings":"AAAA,SAAS,OAAO,IAAI,YAAY;AAChC,SAAS,SAAS,MAAM,eAAe;AAEvC;AAAA,EACE;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,OACK;AACP,SAAS,mBAAmB;AAE5B,SAAS,gBAAgB;AAEzB,MAAM,8BAA8B;AACpC,MAAM,wBAAwB,IAAI,KAAK;AACvC,MAAM,6BAA6B;AACnC,IAAI;AACJ,IAAI;AACJ,MAAM,kBAAkB;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAoBxB,eAAsB,mCAAkD;AACtE,QAAM,mBAAmB,iCAAiC;AAC1D,QAAM,2BAA2B,QAAQ,gBAAgB;AACzD,QAAM,cAAc,MAAM,kCAAkC,gBAAgB;AAE5E,MAAI,gCAAgC,0BAA0B,WAAW,GAAG;AAC1E;AAAA,EACF;AAEA,MAAI,8BAA8B,QAAW;AAC3C,UAAM;AACN,UAAMA,wBACJ,MAAM,kCAAkC,gBAAgB;AAC1D,QACE;AAAA,MACE;AAAA,MACAA;AAAA,IACF,GACA;AACA;AAAA,IACF;AAAA,EACF;AAEA,QAAM,uBACJ,MAAM,kCAAkC,gBAAgB;AAE1D,MAAI,8BAA8B,QAAW;AAC3C,UAAM;AACN,WAAO,iCAAiC;AAAA,EAC1C;AAEA,MACE;AAAA,IACE;AAAA,IACA;AAAA,EACF,GACA;AACA;AAAA,EACF;AAEA,+BAA6B,YAAY;AACvC,QAAI,CAAE,MAAM,WAAW,gBAAgB,GAAI;AACzC,YAAM;AAAA,QACJ;AAAA,QACA;AAAA,MACF;AACA,YAAM,iCAAiC,wBAAwB;AAC/D;AAAA,IACF;AAEA,UAAM,gBACJ,MAAM,+BAA+B,gBAAgB;AAEvD,QAAI,gBAAgB,6BAA6B;AAC/C,YAAM,IAAI;AAAA,QACR,+CAA+C,aAAa;AAAA,MAC9D;AAAA,IACF;AAEA,QAAI,gBAAgB,6BAA6B;AAC/C,YAAM,mCAAmC;AACzC,YAAM,uBAAuB;AAC7B,YAAM,sCAAsC;AAC5C,YAAM;AAAA,QACJ;AAAA,QACA;AAAA,MACF;AAAA,IACF;AAEA,UAAM,iCAAiC,wBAAwB;AAAA,EACjE,GAAG;AAEH,MAAI;AACF,UAAM;AACN;AAAA,EACF,UAAE;AACA,gCAA4B;AAAA,EAC9B;AACF;AAEA,eAAe,iCACb,0BACe;AACf,QAAM,cAAc,MAAM;AAAA,IACxB;AAAA,EACF;AAEA,MAAI,gBAAgB,QAAW;AAC7B,oCAAgC;AAChC;AAAA,EACF;AAEA,kCAAgC;AAAA,IAC9B;AAAA,IACA,MAAM;AAAA,EACR;AACF;AAEA,eAAe,kCACb,kBACoD;AACpD,MAAI;AACF,UAAM,QAAQ,MAAM,KAAK,gBAAgB;AAEzC,WAAO;AAAA,MACL,KAAK,MAAM;AAAA,MACX,KAAK,MAAM;AAAA,MACX,SAAS,MAAM;AAAA,MACf,MAAM,MAAM;AAAA,IACd;AAAA,EACF,SAAS,OAAO;AACd,QAAI,YAAY,KAAK,KAAK,MAAM,SAAS,UAAU;AACjD,aAAO;AAAA,IACT;AAEA,UAAM;AAAA,EACR;AACF;AAEA,SAAS,gCACP,0BACA,aACS;AACT,MACE,gBAAgB,UAChB,kCAAkC,QAClC;AACA,WAAO;AAAA,EACT;AAEA,SACE,8BAA8B,SAAS,4BACvC;AAAA,IACE,8BAA8B;AAAA,IAC9B;AAAA,EACF;AAEJ;AAEA,SAAS,oCACP,MACA,OACS;AACT,SACE,KAAK,QAAQ,MAAM,OACnB,KAAK,QAAQ,MAAM,OACnB,KAAK,YAAY,MAAM,WACvB,KAAK,SAAS,MAAM;AAExB;AAEA,eAAsB,+BACpB,mBAAmB,iCAAiC,GACnC;AACjB,MAAI,CAAE,MAAM,WAAW,gBAAgB,GAAI;AACzC,WAAO;AAAA,EACT;AAEA,QAAM,WAAW,MAAM,SAAS,KAAK,kBAAkB,IAAI;AAAA,IACzD,UAAU;AAAA,EACZ,CAAC;AAED,MAAI;AACF,QAAI,CAAE,MAAM,YAAY,UAAU,iBAAiB,GAAI;AACrD,aAAO;AAAA,IACT;AAEA,UAAM,UAAU,MAAM,SAAS;AAAA,MAC7B;AAAA,MACA,CAAC,MAAM;AAAA,MACP,CAAC,QAAQ,OAAO,IAAI,OAAO;AAAA,IAC7B;AAEA,WAAO,WAAW;AAAA,EACpB,UAAE;AACA,UAAM,SAAS,MAAM;AAAA,EACvB;AACF;AAEO,SAAS,sCACd,cACS;AACT,QAAM,uBAAuB,QAAQ,YAAY;AAEjD,SAAO,wCAAwC,EAAE;AAAA,IAC/C,CAAC,aAAa,yBAAyB,QAAQ,QAAQ;AAAA,EACzD;AACF;AAEA,SAAS,0CAA6D;AACpE,QAAM,qBAAqB,mCAAmC;AAE9D,SAAO;AAAA,IACL,iCAAiC;AAAA,IACjC,KAAK,oBAAoB,wBAAwB;AAAA,IACjD,KAAK,oBAAoB,6BAA6B;AAAA,IACtD,kCAAkC;AAAA,IAClC,KAAK,kCAAkC,GAAG,YAAY;AAAA,IACtD,KAAK,sCAAsC,GAAG,WAAW;AAAA,IACzD,KAAK,qCAAqC,GAAG,gBAAgB;AAAA,EAC/D;AACF;AAEA,eAAe,uBACb,kBACA,SACe;AACf,QAAM,MAAM,QAAQ,gBAAgB,GAAG,EAAE,WAAW,KAAK,CAAC;AAC1D,QAAM,WAAW,MAAM,SAAS,KAAK,gBAAgB;AAErD,MAAI;AACF,UAAM,SAAS,IAAI,eAAe;AAClC,UAAM,SAAS;AAAA,MACb;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,MAOA,CAAC,QAAQ,UAAS,oBAAI,KAAK,GAAE,YAAY,CAAC;AAAA,IAC5C;AAAA,EACF,UAAE;AACA,UAAM,SAAS,MAAM;AAAA,EACvB;AACF;AAEA,eAAe,yBAAwC;AACrD,QAAM,qBAAqB,mCAAmC;AAC9D,QAAM,uBAAuB,qCAAqC;AAClE,QAAM,oBAAoB,kCAAkC;AAC5D,QAAM,oBAAoB,sCAAsC;AAEhE,QAAM,mBAAmB,KAAK,oBAAoB,wBAAwB,CAAC;AAC3E,QAAM;AAAA,IACJ,KAAK,oBAAoB,6BAA6B;AAAA,EACxD;AACA,QAAM,mBAAmB,kCAAkC,CAAC;AAC5D,QAAM,mBAAmB,KAAK,sBAAsB,SAAS,CAAC;AAC9D,QAAM,mBAAmB,KAAK,mBAAmB,WAAW,CAAC;AAC7D,QAAM,mBAAmB,KAAK,mBAAmB,aAAa,CAAC;AAC/D,QAAM,mBAAmB,KAAK,mBAAmB,OAAO,CAAC;AACzD,QAAM,mBAAmB,KAAK,mBAAmB,YAAY,CAAC;AAE9D,QAAM,sBAAsB,KAAK,sBAAsB,gBAAgB;AACvE,MAAI,MAAM,WAAW,mBAAmB,GAAG;AACzC,UAAM,iCAAiC,mBAAmB;AAC1D,UAAM,kCAAkC,mBAAmB;AAAA,EAC7D;AACF;AAEA,eAAe,qCAAoD;AACjE,QAAM,oBAAoB;AAC1B,QAAM,iBAAiB;AACvB,QAAM,iCAAiC;AACvC,QAAM,qBAAqB;AAC7B;AAEA,eAAe,sBAAqC;AAClD,QAAM,mBAAmB,iCAAiC;AAE1D,MAAI,CAAE,MAAM,WAAW,gBAAgB,GAAI;AACzC;AAAA,EACF;AAEA,QAAM,WAAW,MAAM,SAAS,KAAK,kBAAkB,IAAI;AAAA,IACzD,UAAU;AAAA,EACZ,CAAC;AAED,MAAI;AACF,QAAI,MAAM,YAAY,UAAU,eAAe,GAAG;AAChD,YAAM,OAAO,MAAM,SAAS;AAAA,QAC1B;AAAA;AAAA;AAAA;AAAA,QAIA;AAAA,QACA,CAAC,SAAS;AAAA,UACR,aAAa,OAAO,IAAI,YAAY;AAAA,UACpC,UAAU,OAAO,IAAI,SAAS;AAAA,QAChC;AAAA,MACF;AAEA,UAAI,KAAK,KAAK,CAAC,QAAQ,aAAa,IAAI,UAAU,IAAI,WAAW,CAAC,GAAG;AACnE,cAAM,IAAI,MAAM,gDAAgD;AAAA,MAClE;AAAA,IACF;AAEA,QAAI,CAAE,MAAM,YAAY,UAAU,aAAa,GAAI;AACjD;AAAA,IACF;AAEA,UAAM,gBAAgB,MAAM,SAAS;AAAA,MACnC;AAAA;AAAA;AAAA;AAAA;AAAA,MAKA;AAAA,MACA,CAAC,SAAS;AAAA,QACR,aAAa,OAAO,IAAI,YAAY;AAAA,QACpC,UAAU,OAAO,IAAI,SAAS;AAAA,MAChC;AAAA,IACF;AAEA,QACE,cAAc,KAAK,CAAC,QAAQ,aAAa,IAAI,UAAU,IAAI,WAAW,CAAC,GACvE;AACA,YAAM,IAAI,MAAM,gDAAgD;AAAA,IAClE;AAAA,EACF,UAAE;AACA,UAAM,SAAS,MAAM;AAAA,EACvB;AACF;AAEA,eAAe,mBAAkC;AAC/C,QAAM,iBAAiB;AAAA,IACrB,sCAAsC;AAAA,IACtC;AAAA,EACF;AAEA,MAAI,CAAE,MAAM,WAAW,cAAc,GAAI;AACvC;AAAA,EACF;AAEA,QAAM,WAAW,MAAM,SAAS,KAAK,gBAAgB,IAAI;AAAA,IACvD,UAAU;AAAA,EACZ,CAAC;AAED,MAAI;AACF,QAAI,CAAE,MAAM,YAAY,UAAU,UAAU,GAAI;AAC9C;AAAA,IACF;AAEA,UAAM,OAAO,MAAM,SAAS;AAAA,MAC1B;AAAA,MACA;AAAA,MACA,CAAC,SAAS;AAAA,QACR,aAAa,OAAO,IAAI,YAAY;AAAA,QACpC,UAAU,OAAO,IAAI,SAAS;AAAA,MAChC;AAAA,IACF;AAEA,QAAI,KAAK,KAAK,CAAC,QAAQ,aAAa,IAAI,UAAU,IAAI,WAAW,CAAC,GAAG;AACnE,YAAM,IAAI,MAAM,6CAA6C;AAAA,IAC/D;AAAA,EACF,UAAE;AACA,UAAM,SAAS,MAAM;AAAA,EACvB;AACF;AAEA,eAAe,mCAAkD;AAC/D,QAAM,sBAAsB;AAAA,IAC1B,qCAAqC;AAAA,IACrC;AAAA,EACF;AAEA,MAAI,CAAE,MAAM,WAAW,mBAAmB,GAAI;AAC5C;AAAA,EACF;AAEA,QAAM,WAAW,MAAM,SAAS,KAAK,qBAAqB,IAAI;AAAA,IAC5D,UAAU;AAAA,EACZ,CAAC;AAED,MAAI;AACF,eAAW,aAAa;AAAA,MACtB;AAAA,MACA;AAAA,MACA;AAAA,MACA;AAAA,IACF,GAAG;AACD,UAAI,CAAE,MAAM,YAAY,UAAU,SAAS,GAAI;AAC7C;AAAA,MACF;AAEA,YAAM,OAAO,MAAM,SAAS;AAAA,QAC1B;AAAA;AAAA,iBAES,SAAS;AAAA;AAAA,QAElB;AAAA,QACA,CAAC,SAAS;AAAA,UACR,aAAa,OAAO,IAAI,YAAY;AAAA,UACpC,UAAU,OAAO,IAAI,SAAS;AAAA,QAChC;AAAA,MACF;AAEA,UAAI,KAAK,KAAK,CAAC,QAAQ,aAAa,IAAI,UAAU,IAAI,WAAW,CAAC,GAAG;AACnE,cAAM,IAAI;AAAA,UACR,sDAAsD,SAAS;AAAA,QACjE;AAAA,MACF;AAAA,IACF;AAAA,EACF,UAAE;AACA,UAAM,SAAS,MAAM;AAAA,EACvB;AACF;AAEA,eAAe,wCAAuD;AACpE,QAAM,sBAAsB;AAAA,IAC1B,qCAAqC;AAAA,IACrC;AAAA,EACF;AAEA,MAAI,CAAE,MAAM,WAAW,mBAAmB,GAAI;AAC5C;AAAA,EACF;AAEA,QAAM,WAAW,MAAM,SAAS,KAAK,qBAAqB,IAAI;AAAA,IAC5D,UAAU;AAAA,EACZ,CAAC;AAED,MAAI;AACF,QAAI,CAAE,MAAM,YAAY,UAAU,gBAAgB,GAAI;AACpD;AAAA,IACF;AAEA,UAAM,WAAW,MAAM,SAAS;AAAA,MAC9B;AAAA;AAAA;AAAA;AAAA,MAIA;AAAA,MACA,CAAC,QAAQ,OAAO,IAAI,UAAU;AAAA,IAChC;AAEA,UAAM,qBAAqB,SAAS;AAAA,MAClC,CAAC,cAAc,cAAc;AAAA,IAC/B;AACA,QAAI,uBAAuB,QAAW;AACpC,YAAM,IAAI;AAAA,QACR;AAAA,MACF;AAAA,IACF;AAAA,EACF,UAAE;AACA,UAAM,SAAS,MAAM;AAAA,EACvB;AACF;AAEA,eAAe,uBAAsC;AACnD,QAAM,mBAAmB;AAAA,IACvB,kCAAkC;AAAA,IAClC;AAAA,EACF;AAEA,MAAI,CAAE,MAAM,WAAW,gBAAgB,GAAI;AACzC;AAAA,EACF;AAEA,QAAM,WAAW,MAAM,SAAS,KAAK,kBAAkB,IAAI;AAAA,IACzD,UAAU;AAAA,EACZ,CAAC;AAED,MAAI;AACF,QAAI,MAAM,YAAY,UAAU,YAAY,GAAG;AAC7C,YAAM,aAAa,MAAM,SAAS;AAAA,QAChC;AAAA;AAAA;AAAA;AAAA;AAAA,QAKA;AAAA,QACA,CAAC,QAAQ,OAAO,IAAI,MAAM;AAAA,MAC5B;AAEA,UAAI,WAAW,SAAS,GAAG;AACzB,cAAM,IAAI,MAAM,6CAA6C;AAAA,MAC/D;AAAA,IACF;AAEA,QAAI,MAAM,YAAY,UAAU,oBAAoB,GAAG;AACrD,YAAM,QAAQ,MAAM,SAAS;AAAA,QAC3B;AAAA;AAAA;AAAA;AAAA;AAAA,QAKA;AAAA,QACA,CAAC,SAAS;AAAA,UACR,aACE,IAAI,iBAAiB,OAAO,SAAY,OAAO,IAAI,YAAY;AAAA,UACjE,UAAU,IAAI,cAAc,OAAO,SAAY,OAAO,IAAI,SAAS;AAAA,QACrE;AAAA,MACF;AAEA,UACE,OAAO,aAAa,UACpB,MAAM,gBAAgB,UACtB,aAAa,MAAM,UAAU,MAAM,WAAW,GAC9C;AACA,cAAM,IAAI;AAAA,UACR;AAAA,QACF;AAAA,MACF;AAAA,IACF;AAAA,EACF,UAAE;AACA,UAAM,SAAS,MAAM;AAAA,EACvB;AACF;AAEA,eAAe,iCACb,qBACA,YACe;AACf,QAAM,WAAW,MAAM,SAAS,KAAK,mBAAmB;AAExD,MAAI;AACF,QAAI,CAAE,MAAM,YAAY,UAAU,gBAAgB,GAAI;AACpD;AAAA,IACF;AAEA,UAAM,cACJ,eAAe,SACX,yBACA;AACN,UAAM,aACJ,eAAe,SACX,CAAC,0BAA0B,IAC3B,CAAC,YAAY,0BAA0B;AAC7C,UAAM,WAAW,MAAM,SAAS;AAAA,MAC9B;AAAA;AAAA;AAAA,UAGI,WAAW;AAAA;AAAA,MAEf;AAAA,MACA,CAAC,SAAS;AAAA,QACR,YAAY,OAAO,IAAI,WAAW;AAAA,QAClC,eACE,IAAI,mBAAmB,OAAO,SAAY,OAAO,IAAI,cAAc;AAAA,MACvE;AAAA,IACF;AAEA,eAAW,WAAW,UAAU;AAC9B,UAAI,QAAQ,kBAAkB,QAAW;AACvC,cAAM,mBAAmB,QAAQ,aAAa;AAAA,MAChD;AAAA,IACF;AAEA,UAAM,SAAS;AAAA,MACb;AAAA;AAAA,UAEI,WAAW;AAAA;AAAA,MAEf;AAAA,IACF;AAAA,EACF,UAAE;AACA,UAAM,SAAS,MAAM;AAAA,EACvB;AACF;AAEA,eAAe,kCACb,qBACe;AACf,QAAM,WAAW,MAAM,SAAS,KAAK,mBAAmB;AAExD,MAAI;AACF,QAAI,CAAE,MAAM,YAAY,UAAU,gBAAgB,GAAI;AACpD;AAAA,IACF;AAEA,UAAM,WAAW,MAAM,SAAS;AAAA,MAC9B;AAAA;AAAA;AAAA;AAAA;AAAA,MAKA,CAAC,eAAe,0BAA0B;AAAA,MAC1C,CAAC,SAAS;AAAA,QACR,YAAY,OAAO,IAAI,WAAW;AAAA,QAClC,aAAa,OAAO,IAAI,YAAY;AAAA,QACpC,WAAW,OAAO,IAAI,UAAU;AAAA,QAChC,eACE,IAAI,mBAAmB,OAAO,SAAY,OAAO,IAAI,cAAc;AAAA,MACvE;AAAA,IACF;AAEA,eAAW,WAAW,UAAU;AAC9B,UAAI,MAAM,WAAW,QAAQ,WAAW,GAAG;AACzC;AAAA,MACF;AAEA,UAAI,QAAQ,kBAAkB,QAAW;AACvC,cAAM,mBAAmB,QAAQ,aAAa;AAAA,MAChD;AAEA,YAAM,SAAS;AAAA,QACb;AAAA;AAAA;AAAA;AAAA,QAIA,CAAC,QAAQ,YAAY,QAAQ,SAAS;AAAA,MACxC;AAAA,IACF;AAAA,EACF,UAAE;AACA,UAAM,SAAS,MAAM;AAAA,EACvB;AACF;AAEA,eAAe,YACb,UACA,WACkB;AAClB,QAAM,MAAM,MAAM,SAAS;AAAA,IACzB;AAAA;AAAA;AAAA;AAAA;AAAA,IAKA,CAAC,SAAS;AAAA,IACV,MAAM;AAAA,EACR;AAEA,SAAO,QAAQ;AACjB;AAEA,SAAS,aAAa,UAAkB,aAA8B;AACpE,SACE,KAAK,IAAI,IAAI,eAAe,yBAC5B,eAAe,QAAQ;AAE3B;AAEA,SAAS,eAAe,KAAsB;AAC5C,MAAI;AACF,YAAQ,KAAK,KAAK,CAAC;AACnB,WAAO;AAAA,EACT,QAAQ;AACN,WAAO;AAAA,EACT;AACF;AAEA,eAAe,mBAAmB,MAA6B;AAC7D,QAAM,GAAG,MAAM,EAAE,OAAO,MAAM,WAAW,KAAK,CAAC;AACjD;AAEA,eAAe,WAAW,MAAgC;AACxD,MAAI;AACF,UAAM,KAAK,IAAI;AACf,WAAO;AAAA,EACT,QAAQ;AACN,WAAO;AAAA,EACT;AACF;","names":["refreshedFingerprint"]}

package/dist/document/index.d.ts

@@ -1,13 +1,32 @@
 export { Database } from './database.js';
 export { ensureSharedStateDatabaseInitialized, openSharedStateDatabase } from './shared-state-database.js';
-export { ReadonlyTextStreams as ReadonlyFragments, ReadonlySerialTextStream as ReadonlySerialFragments, ReadonlySerialTextStream, ReadonlyTextStreams, SerialTextStream, TextStreams } from './text-streams.js';
-export { FragmentDraft, Fragments, SerialFragments } from './fragments.js';
-export { DirectoryDocument, Document, DocumentContext, ReadonlyDocument } from './document.js';
-export { SCHEMA_SQL } from './schema.js';
-export { ChunkStore, FragmentGroupStore, GraphBuildParameterStore, MentionLinkStore, MentionStore, ObjectMetadataStore, ReadingEdgeStore, ReadonlyChunkStore, ReadonlyFragmentGroupStore, ReadonlyGraphBuildParameterStore, ReadonlyMentionLinkStore, ReadonlyMentionStore, ReadonlyObjectMetadataStore, ReadonlyReadingEdgeStore, ReadonlySerialStore, ReadonlySnakeChunkStore, ReadonlySnakeEdgeStore, ReadonlySnakeStore, SerialStore, SnakeChunkStore, SnakeEdgeStore, SnakeStore } from './stores.js';
+export { TextStreams } from './text-streams/core.js';
 export { ChunkImportance, ChunkRecord, ChunkRetention, CreateSnakeRecord, FragmentRecord, GraphBuildParameterRecord, MentionLinkRecord, MentionRecord, ObjectMetadataKind, ObjectMetadataTarget, ReadingEdgeRecord, SentenceGroupRecord, SentenceId, SentenceRecord, SerialRecord, SnakeChunkRecord, SnakeEdgeRecord, SnakeRecord, expectChunkImportance, expectChunkRetention, isChunkImportance, isChunkRetention } from './types.js';
+export { SerialTextStream } from './text-streams/serial.js';
+export { ReadonlyTextStreams as ReadonlyFragments, ReadonlySerialTextStream as ReadonlySerialFragments, ReadonlySerialTextStream, ReadonlyTextStreams } from './text-streams/types.js';
+export { Fragments } from './fragments/core.js';
+export { FragmentDraft } from './fragments/draft.js';
+export { SerialFragments } from './fragments/serial.js';
+export { D as DirectoryDocument } from '../core-Cv8a8viI.js';
+export { Document, DocumentContext, ReadonlyDocument } from './directory/types.js';
+export { createFragmentBackedDocument } from './fragment-backed.js';
+export { SCHEMA_SQL } from './schema.js';
+export { ChunkStore } from './stores/chunk.js';
+export { FragmentGroupStore } from './stores/fragment-group.js';
+export { GraphBuildParameterStore } from './stores/graph-build-parameter.js';
+export { MentionLinkStore } from './stores/mention-link.js';
+export { MentionStore } from './stores/mention.js';
+export { ObjectMetadataStore } from './stores/object-metadata.js';
+export { ReadingEdgeStore } from './stores/reading-edge.js';
+export { SerialStore } from './stores/serial.js';
+export { SnakeChunkStore } from './stores/snake/chunk.js';
+export { SnakeStore } from './stores/snake/core.js';
+export { SnakeEdgeStore } from './stores/snake/edge.js';
+export { ReadonlyChunkStore, ReadonlyFragmentGroupStore, ReadonlyGraphBuildParameterStore, ReadonlyMentionLinkStore, ReadonlyMentionStore, ReadonlyObjectMetadataStore, ReadonlyReadingEdgeStore, ReadonlySerialStore, ReadonlySnakeChunkStore, ReadonlySnakeEdgeStore, ReadonlySnakeStore } from './stores/types.js';
 import 'sqlite3';
-import '../source/meta.js';
+import './text-streams/draft.js';
+import './fragments/types.js';
+import '../text/source/meta.js';
 import 'zod';
-import '../source/toc.js';
-import '../source/types.js';
+import '../text/source/toc.js';
+import '../text/source/types.js';

package/dist/document/index.js

@@ -3,9 +3,14 @@ import {
   ensureSharedStateDatabaseInitialized,
   openSharedStateDatabase
 } from "./shared-state-database.js";
-import { TextStreams, SerialTextStream } from "./text-streams.js";
-import { FragmentDraft, Fragments, SerialFragments } from "./fragments.js";
-import { DirectoryDocument } from "./document.js";
+import { TextStreams, SerialTextStream } from "./text-streams/index.js";
+import {
+  FragmentDraft,
+  Fragments,
+  SerialFragments
+} from "./fragments/index.js";
+import { DirectoryDocument } from "./directory/index.js";
+import { createFragmentBackedDocument } from "./fragment-backed.js";
 import { SCHEMA_SQL } from "./schema.js";
 import {
   ChunkStore,
@@ -19,7 +24,7 @@ import {
   SnakeChunkStore,
   SnakeEdgeStore,
   SnakeStore
-} from "./stores.js";
+} from "./stores/index.js";
 import {
   ChunkImportance,
   ChunkRetention,
@@ -52,6 +57,7 @@ export {
   SnakeEdgeStore,
   SnakeStore,
   TextStreams,
+  createFragmentBackedDocument,
   ensureSharedStateDatabaseInitialized,
   expectChunkImportance,
   expectChunkRetention,

package/dist/document/index.js.map

@@ -1 +1 @@
-{"version":3,"sources":["../../src/document/index.ts"],"sourcesContent":["export { Database } from \"./database.js\";\nexport {\n  ensureSharedStateDatabaseInitialized,\n  openSharedStateDatabase,\n} from \"./shared-state-database.js\";\nexport { TextStreams, SerialTextStream } from \"./text-streams.js\";\nexport { FragmentDraft, Fragments, SerialFragments } from \"./fragments.js\";\nexport type {\n  ReadonlySerialTextStream,\n  ReadonlySerialTextStream as ReadonlySerialFragments,\n  ReadonlyTextStreams,\n  ReadonlyTextStreams as ReadonlyFragments,\n} from \"./text-streams.js\";\nexport { DirectoryDocument } from \"./document.js\";\nexport type {\n  Document,\n  DocumentContext,\n  ReadonlyDocument,\n} from \"./document.js\";\nexport { SCHEMA_SQL } from \"./schema.js\";\nexport {\n  ChunkStore,\n  FragmentGroupStore,\n  GraphBuildParameterStore,\n  ReadingEdgeStore,\n  MentionLinkStore,\n  MentionStore,\n  ObjectMetadataStore,\n  SerialStore,\n  SnakeChunkStore,\n  SnakeEdgeStore,\n  SnakeStore,\n} from \"./stores.js\";\nexport type {\n  ReadonlyChunkStore,\n  ReadonlyFragmentGroupStore,\n  ReadonlyGraphBuildParameterStore,\n  ReadonlyReadingEdgeStore,\n  ReadonlyMentionLinkStore,\n  ReadonlyMentionStore,\n  ReadonlyObjectMetadataStore,\n  ReadonlySerialStore,\n  ReadonlySnakeChunkStore,\n  ReadonlySnakeEdgeStore,\n  ReadonlySnakeStore,\n} from \"./stores.js\";\nexport {\n  ChunkImportance,\n  ChunkRetention,\n  expectChunkImportance,\n  expectChunkRetention,\n  isChunkImportance,\n  isChunkRetention,\n  ObjectMetadataKind,\n} from \"./types.js\";\nexport type {\n  ChunkRecord,\n  CreateSnakeRecord,\n  FragmentRecord,\n  GraphBuildParameterRecord,\n  ReadingEdgeRecord,\n  MentionLinkRecord,\n  MentionRecord,\n  ObjectMetadataTarget,\n  SerialRecord,\n  SentenceId,\n  SentenceGroupRecord,\n  SentenceRecord,\n  SnakeChunkRecord,\n  SnakeEdgeRecord,\n  SnakeRecord,\n} from \"./types.js\";\n"],"mappings":"AAAA,SAAS,gBAAgB;AACzB;AAAA,EACE;AAAA,EACA;AAAA,OACK;AACP,SAAS,aAAa,wBAAwB;AAC9C,SAAS,eAAe,WAAW,uBAAuB;AAO1D,SAAS,yBAAyB;AAMlC,SAAS,kBAAkB;AAC3B;AAAA,EACE;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,OACK;AAcP;AAAA,EACE;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,OACK;","names":[]}
+{"version":3,"sources":["../../src/document/index.ts"],"sourcesContent":["export { Database } from \"./database.js\";\nexport {\n  ensureSharedStateDatabaseInitialized,\n  openSharedStateDatabase,\n} from \"./shared-state-database.js\";\nexport { TextStreams, SerialTextStream } from \"./text-streams/index.js\";\nexport {\n  FragmentDraft,\n  Fragments,\n  SerialFragments,\n} from \"./fragments/index.js\";\nexport type {\n  ReadonlySerialTextStream,\n  ReadonlySerialTextStream as ReadonlySerialFragments,\n  ReadonlyTextStreams,\n  ReadonlyTextStreams as ReadonlyFragments,\n} from \"./text-streams/index.js\";\nexport { DirectoryDocument } from \"./directory/index.js\";\nexport { createFragmentBackedDocument } from \"./fragment-backed.js\";\nexport type {\n  Document,\n  DocumentContext,\n  ReadonlyDocument,\n} from \"./directory/index.js\";\nexport { SCHEMA_SQL } from \"./schema.js\";\nexport {\n  ChunkStore,\n  FragmentGroupStore,\n  GraphBuildParameterStore,\n  ReadingEdgeStore,\n  MentionLinkStore,\n  MentionStore,\n  ObjectMetadataStore,\n  SerialStore,\n  SnakeChunkStore,\n  SnakeEdgeStore,\n  SnakeStore,\n} from \"./stores/index.js\";\nexport type {\n  ReadonlyChunkStore,\n  ReadonlyFragmentGroupStore,\n  ReadonlyGraphBuildParameterStore,\n  ReadonlyReadingEdgeStore,\n  ReadonlyMentionLinkStore,\n  ReadonlyMentionStore,\n  ReadonlyObjectMetadataStore,\n  ReadonlySerialStore,\n  ReadonlySnakeChunkStore,\n  ReadonlySnakeEdgeStore,\n  ReadonlySnakeStore,\n} from \"./stores/index.js\";\nexport {\n  ChunkImportance,\n  ChunkRetention,\n  expectChunkImportance,\n  expectChunkRetention,\n  isChunkImportance,\n  isChunkRetention,\n  ObjectMetadataKind,\n} from \"./types.js\";\nexport type {\n  ChunkRecord,\n  CreateSnakeRecord,\n  FragmentRecord,\n  GraphBuildParameterRecord,\n  ReadingEdgeRecord,\n  MentionLinkRecord,\n  MentionRecord,\n  ObjectMetadataTarget,\n  SerialRecord,\n  SentenceId,\n  SentenceGroupRecord,\n  SentenceRecord,\n  SnakeChunkRecord,\n  SnakeEdgeRecord,\n  SnakeRecord,\n} from \"./types.js\";\n"],"mappings":"AAAA,SAAS,gBAAgB;AACzB;AAAA,EACE;AAAA,EACA;AAAA,OACK;AACP,SAAS,aAAa,wBAAwB;AAC9C;AAAA,EACE;AAAA,EACA;AAAA,EACA;AAAA,OACK;AAOP,SAAS,yBAAyB;AAClC,SAAS,oCAAoC;AAM7C,SAAS,kBAAkB;AAC3B;AAAA,EACE;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,OACK;AAcP;AAAA,EACE;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,OACK;","names":[]}