latticesql 4.2.0 → 4.2.1

package/dist/cli.js

@@ -205,10 +205,10 @@ function getOrCreateMasterKey() {
 }
 function readIdentity() {
   const dir = ensureConfigDir();
-  const path2 = join2(dir, IDENTITY_FILENAME);
-  if (!existsSync2(path2)) return { ...EMPTY_IDENTITY };
+  const path3 = join2(dir, IDENTITY_FILENAME);
+  if (!existsSync2(path3)) return { ...EMPTY_IDENTITY };
   try {
-    const parsed = JSON.parse(readFileSync(path2, "utf8"));
+    const parsed = JSON.parse(readFileSync(path3, "utf8"));
     return {
       display_name: typeof parsed.display_name === "string" ? parsed.display_name : "",
       email: typeof parsed.email === "string" ? parsed.email : ""
@@ -219,26 +219,26 @@ function readIdentity() {
 }
 function writeIdentity(identity) {
   const dir = ensureConfigDir();
-  const path2 = join2(dir, IDENTITY_FILENAME);
+  const path3 = join2(dir, IDENTITY_FILENAME);
   const body = JSON.stringify(
     { display_name: identity.display_name, email: identity.email },
     null,
     2
   );
-  writeFileSync(path2, body + "\n", "utf8");
+  writeFileSync(path3, body + "\n", "utf8");
   if (platform2() !== "win32") {
     try {
-      chmodSync2(path2, 384);
+      chmodSync2(path3, 384);
     } catch {
     }
   }
 }
 function readPreferences() {
   const dir = ensureConfigDir();
-  const path2 = join2(dir, PREFERENCES_FILENAME);
-  if (!existsSync2(path2)) return { ...DEFAULT_PREFERENCES };
+  const path3 = join2(dir, PREFERENCES_FILENAME);
+  if (!existsSync2(path3)) return { ...DEFAULT_PREFERENCES };
   try {
-    const parsed = JSON.parse(readFileSync(path2, "utf8"));
+    const parsed = JSON.parse(readFileSync(path3, "utf8"));
     const agg = typeof parsed.aggressiveness === "number" ? parsed.aggressiveness : NaN;
     return {
       show_system_tables: typeof parsed.show_system_tables === "boolean" ? parsed.show_system_tables : DEFAULT_PREFERENCES.show_system_tables,
@@ -252,7 +252,7 @@ function readPreferences() {
 }
 function writePreferences(prefs) {
   const dir = ensureConfigDir();
-  const path2 = join2(dir, PREFERENCES_FILENAME);
+  const path3 = join2(dir, PREFERENCES_FILENAME);
   const body = JSON.stringify(
     {
       show_system_tables: prefs.show_system_tables,
@@ -263,10 +263,10 @@ function writePreferences(prefs) {
     null,
     2
   );
-  writeFileSync(path2, body + "\n", "utf8");
+  writeFileSync(path3, body + "\n", "utf8");
   if (platform2() !== "win32") {
     try {
-      chmodSync2(path2, 384);
+      chmodSync2(path3, 384);
     } catch {
     }
   }
@@ -330,8 +330,8 @@ function withCredentialLock(fn) {
     }
   }
 }
-function writeFileAtomic(path2, data) {
-  const tmp = `${path2}.${String(process.pid)}.${randomBytes2(4).toString("hex")}.tmp`;
+function writeFileAtomic(path3, data) {
+  const tmp = `${path3}.${String(process.pid)}.${randomBytes2(4).toString("hex")}.tmp`;
   writeFileSync(tmp, data, "utf8");
   if (platform2() !== "win32") {
     try {
@@ -339,7 +339,7 @@ function writeFileAtomic(path2, data) {
     } catch {
     }
   }
-  renameSync(tmp, path2);
+  renameSync(tmp, path3);
 }
 function mutateCredentials(mutate) {
   withCredentialLock(() => {
@@ -350,11 +350,11 @@ function mutateCredentials(mutate) {
 }
 function loadCredentials() {
   const dir = ensureConfigDir();
-  const path2 = join2(dir, DB_CREDENTIALS_FILENAME);
-  if (!existsSync2(path2)) return {};
+  const path3 = join2(dir, DB_CREDENTIALS_FILENAME);
+  if (!existsSync2(path3)) return {};
   const key = deriveKey(getOrCreateMasterKey());
   try {
-    const ciphertext = readFileSync(path2, "utf8").trim();
+    const ciphertext = readFileSync(path3, "utf8").trim();
     const plaintext = decrypt(ciphertext, key);
     const parsed = JSON.parse(plaintext);
     if (parsed && typeof parsed === "object" && !Array.isArray(parsed)) {
@@ -369,10 +369,10 @@ function loadCredentials() {
 }
 function saveCredentials(creds) {
   const dir = ensureConfigDir();
-  const path2 = join2(dir, DB_CREDENTIALS_FILENAME);
+  const path3 = join2(dir, DB_CREDENTIALS_FILENAME);
   const key = deriveKey(getOrCreateMasterKey());
   const ciphertext = encrypt(JSON.stringify(creds), key);
-  writeFileAtomic(path2, ciphertext + "\n");
+  writeFileAtomic(path3, ciphertext + "\n");
 }
 function listDbCredentials() {
   return Object.keys(loadCredentials()).sort();
@@ -420,11 +420,11 @@ function healRawDbUrl(configPath) {
 }
 function loadS3Configs() {
   const dir = ensureConfigDir();
-  const path2 = join2(dir, S3_CONFIG_FILENAME);
-  if (!existsSync2(path2)) return {};
+  const path3 = join2(dir, S3_CONFIG_FILENAME);
+  if (!existsSync2(path3)) return {};
   const key = deriveKey(getOrCreateMasterKey());
   try {
-    const parsed = JSON.parse(decrypt(readFileSync(path2, "utf8").trim(), key));
+    const parsed = JSON.parse(decrypt(readFileSync(path3, "utf8").trim(), key));
     if (parsed && typeof parsed === "object" && !Array.isArray(parsed)) {
       return parsed;
     }
@@ -438,12 +438,12 @@ function loadS3Configs() {
 }
 function saveS3Configs(cfgs) {
   const dir = ensureConfigDir();
-  const path2 = join2(dir, S3_CONFIG_FILENAME);
+  const path3 = join2(dir, S3_CONFIG_FILENAME);
   const key = deriveKey(getOrCreateMasterKey());
-  writeFileSync(path2, encrypt(JSON.stringify(cfgs), key) + "\n", "utf8");
+  writeFileSync(path3, encrypt(JSON.stringify(cfgs), key) + "\n", "utf8");
   if (platform2() !== "win32") {
     try {
-      chmodSync2(path2, 384);
+      chmodSync2(path3, 384);
     } catch {
     }
   }
@@ -463,11 +463,11 @@ function deleteDbCredential(label) {
 }
 function loadAssistantCredentials() {
   const dir = ensureConfigDir();
-  const path2 = join2(dir, ASSISTANT_CREDENTIALS_FILENAME);
-  if (!existsSync2(path2)) return {};
+  const path3 = join2(dir, ASSISTANT_CREDENTIALS_FILENAME);
+  if (!existsSync2(path3)) return {};
   const key = deriveKey(getOrCreateMasterKey());
   try {
-    const ciphertext = readFileSync(path2, "utf8").trim();
+    const ciphertext = readFileSync(path3, "utf8").trim();
     const plaintext = decrypt(ciphertext, key);
     const parsed = JSON.parse(plaintext);
     if (parsed && typeof parsed === "object" && !Array.isArray(parsed)) {
@@ -482,13 +482,13 @@ function loadAssistantCredentials() {
 }
 function saveAssistantCredentials(creds) {
   const dir = ensureConfigDir();
-  const path2 = join2(dir, ASSISTANT_CREDENTIALS_FILENAME);
+  const path3 = join2(dir, ASSISTANT_CREDENTIALS_FILENAME);
   const key = deriveKey(getOrCreateMasterKey());
   const ciphertext = encrypt(JSON.stringify(creds), key);
-  writeFileSync(path2, ciphertext + "\n", "utf8");
+  writeFileSync(path3, ciphertext + "\n", "utf8");
   if (platform2() !== "win32") {
     try {
-      chmodSync2(path2, 384);
+      chmodSync2(path3, 384);
     } catch {
     }
   }
@@ -999,10 +999,10 @@ function manifestPath(outputDir) {
   return join5(outputDir, ".lattice", "manifest.json");
 }
 function readManifest(outputDir) {
-  const path2 = manifestPath(outputDir);
-  if (!existsSync5(path2)) return null;
+  const path3 = manifestPath(outputDir);
+  if (!existsSync5(path3)) return null;
   try {
-    return JSON.parse(readFileSync4(path2, "utf8"));
+    return JSON.parse(readFileSync4(path3, "utf8"));
   } catch {
     return null;
   }
@@ -1190,20 +1190,130 @@ var init_render_cursor = __esm({
   }
 });
 
+// src/db/load-sqlite.ts
+import path from "path";
+import { createRequire } from "module";
+import { spawnSync } from "child_process";
+function runtimeRequire() {
+  const importMetaUrl = import.meta.url;
+  return importMetaUrl ? createRequire(importMetaUrl) : (
+    // CJS fallback — Node provides `require` on every CJS module scope. Under
+    // tsup's CJS output `import.meta.url` is rewritten to undefined, so this
+    // branch keeps the loader working in the published .cjs bundle.
+    __require
+  );
+}
+function asCtor(mod) {
+  return mod.default ?? mod;
+}
+function isAbiMismatch(err) {
+  const message = err instanceof Error ? err.message : String(err);
+  const code = err.code;
+  return message.includes("NODE_MODULE_VERSION") || code === "ERR_DLOPEN_FAILED" || message.includes("was compiled against a different Node.js version");
+}
+function autoRebuildDisabled() {
+  const v2 = process.env.LATTICE_SQLITE_NO_AUTOREBUILD;
+  if (!v2) return false;
+  const normalized = v2.trim().toLowerCase();
+  return normalized !== "" && normalized !== "0" && normalized !== "false" && normalized !== "no";
+}
+function installRootFor(req) {
+  const pkgJsonPath = req.resolve("better-sqlite3/package.json");
+  return path.resolve(path.dirname(pkgJsonPath), "..", "..");
+}
+function defaultRebuild(installRoot) {
+  const npmBin = process.platform === "win32" ? "npm.cmd" : "npm";
+  const res = spawnSync(npmBin, ["rebuild", "better-sqlite3"], {
+    cwd: installRoot,
+    stdio: ["ignore", "pipe", "pipe"],
+    encoding: "utf8",
+    timeout: 5 * 60 * 1e3
+  });
+  if (res.error) {
+    return { ok: false, reason: res.error.message };
+  }
+  if (res.status !== 0) {
+    const stderr = res.stderr.trim();
+    const tail = stderr ? stderr.slice(-300) : `npm rebuild exited with code ${String(res.status)}`;
+    return { ok: false, reason: tail };
+  }
+  return { ok: true };
+}
+function resolveSqliteCtor(options = {}) {
+  const req = options.require ?? runtimeRequire();
+  const rebuild = options.rebuild ?? defaultRebuild;
+  const resolveInstallRoot = options.installRoot ?? installRootFor;
+  const log = options.log ?? ((msg) => process.stderr.write(msg + "\n"));
+  let firstError;
+  try {
+    return asCtor(req("better-sqlite3"));
+  } catch (err) {
+    firstError = err;
+  }
+  if (!isAbiMismatch(firstError)) {
+    throw new Error(PEER_DEP_MISSING_MESSAGE);
+  }
+  if (autoRebuildDisabled()) {
+    throw new Error(
+      rebuildFailedMessage("automatic rebuild is disabled (LATTICE_SQLITE_NO_AUTOREBUILD)")
+    );
+  }
+  log("[latticesql] SQLite engine built for a different Node runtime \u2014 rebuilding better-sqlite3\u2026");
+  let installRoot;
+  try {
+    installRoot = resolveInstallRoot(req);
+  } catch (err) {
+    throw new Error(
+      rebuildFailedMessage(
+        "could not locate the better-sqlite3 install root (" + (err instanceof Error ? err.message : String(err)) + ")"
+      )
+    );
+  }
+  const outcome = rebuild(installRoot);
+  if (!outcome.ok) {
+    throw new Error(rebuildFailedMessage(outcome.reason));
+  }
+  try {
+    return asCtor(req("better-sqlite3"));
+  } catch (err) {
+    throw new Error(
+      rebuildFailedMessage(
+        "the rebuilt module still failed to load (" + (err instanceof Error ? err.message : String(err)) + ")"
+      )
+    );
+  }
+}
+function rebuildFailedMessage(reason) {
+  return "latticesql: the better-sqlite3 native module doesn\u2019t match this Node runtime and an automatic rebuild did not complete (" + reason + "). Run `npm rebuild better-sqlite3` (or reinstall) and retry.";
+}
+function loadSqlite() {
+  if (_ctor) return _ctor;
+  _ctor = resolveSqliteCtor();
+  return _ctor;
+}
+var PEER_DEP_MISSING_MESSAGE, _ctor;
+var init_load_sqlite = __esm({
+  "src/db/load-sqlite.ts"() {
+    "use strict";
+    PEER_DEP_MISSING_MESSAGE = "better-sqlite3 is a required peer dependency of latticesql \u2014 install it (npm install better-sqlite3).";
+    _ctor = null;
+  }
+});
+
 // src/db/sqlite.ts
-import Database from "better-sqlite3";
 var SQLiteAdapter;
 var init_sqlite = __esm({
   "src/db/sqlite.ts"() {
     "use strict";
+    init_load_sqlite();
     SQLiteAdapter = class {
       dialect = "sqlite";
       _db = null;
       _path;
       _wal;
       _busyTimeout;
-      constructor(path2, options) {
-        this._path = path2;
+      constructor(path3, options) {
+        this._path = path3;
         this._wal = options?.wal ?? true;
         this._busyTimeout = options?.busyTimeout ?? 5e3;
       }
@@ -1212,7 +1322,8 @@ var init_sqlite = __esm({
         return this._db;
       }
       open() {
-        this._db = new Database(this._path);
+        const Ctor = loadSqlite();
+        this._db = new Ctor(this._path);
         this._db.pragma(`busy_timeout = ${this._busyTimeout.toString()}`);
         if (this._wal) {
           this._db.pragma("journal_mode = WAL");
@@ -1384,16 +1495,16 @@ var init_sqlite = __esm({
 });
 
 // src/db/postgres.ts
-import path from "path";
+import path2 from "path";
 import { fileURLToPath } from "url";
-import { createRequire } from "module";
+import { createRequire as createRequire2 } from "module";
 function moduleContext() {
   if (_moduleContext) return _moduleContext;
   const importMetaUrl = import.meta.url;
   if (importMetaUrl) {
     _moduleContext = {
-      dir: path.dirname(fileURLToPath(importMetaUrl)),
-      require: createRequire(importMetaUrl)
+      dir: path2.dirname(fileURLToPath(importMetaUrl)),
+      require: createRequire2(importMetaUrl)
     };
   } else {
     _moduleContext = { dir: __dirname, require: __require };
@@ -3322,14 +3433,14 @@ var init_core = __esm({
       columnRef(f6) {
         const col = `"${ident(f6.col)}"`;
         if (f6.jsonPath === void 0) return { sql: col, params: [] };
-        const path2 = Array.isArray(f6.jsonPath) ? f6.jsonPath : [f6.jsonPath];
+        const path3 = Array.isArray(f6.jsonPath) ? f6.jsonPath : [f6.jsonPath];
         const numeric = isNumericComparison(f6);
         if (this.adapter.dialect === "postgres") {
           const extract2 = `((${col})::jsonb #>> ?::text[])`;
           const sql2 = numeric ? `(${extract2})::numeric` : extract2;
-          return { sql: sql2, params: [path2] };
+          return { sql: sql2, params: [path3] };
         }
-        const jsonpath = `$.${path2.join(".")}`;
+        const jsonpath = `$.${path3.join(".")}`;
         const extract = `json_extract(${col}, ?)`;
         const sql = numeric ? `CAST(${extract} AS REAL)` : extract;
         return { sql, params: [jsonpath] };
@@ -5904,8 +6015,8 @@ var init_pipeline = __esm({
 
 // src/render/interpolate.ts
 function interpolate(template, row) {
-  return template.replace(/\{\{([^}]+)\}\}/g, (_, path2) => {
-    const parts = path2.trim().split(".");
+  return template.replace(/\{\{([^}]+)\}\}/g, (_, path3) => {
+    const parts = path3.trim().split(".");
     let val = row;
     for (const part of parts) {
       if (val == null || typeof val !== "object") return "";
@@ -6054,13 +6165,13 @@ function uniqueDirName(displayName, existing) {
   }
 }
 function readRegistry(root6) {
-  const path2 = registryPath(root6);
-  if (!existsSync11(path2)) return { ...EMPTY_REGISTRY, workspaces: [] };
+  const path3 = registryPath(root6);
+  if (!existsSync11(path3)) return { ...EMPTY_REGISTRY, workspaces: [] };
   let parsed;
   try {
-    parsed = JSON.parse(readFileSync8(path2, "utf-8"));
+    parsed = JSON.parse(readFileSync8(path3, "utf-8"));
   } catch (e6) {
-    throw new Error(`Lattice: corrupt workspace registry at "${path2}": ${e6.message}`);
+    throw new Error(`Lattice: corrupt workspace registry at "${path3}": ${e6.message}`);
   }
   const reg = parsed;
   return {
@@ -6070,11 +6181,11 @@ function readRegistry(root6) {
   };
 }
 function writeRegistry(root6, registry) {
-  const path2 = registryPath(root6);
-  const tmp = `${path2}.tmp-${String(process.pid)}`;
+  const path3 = registryPath(root6);
+  const tmp = `${path3}.tmp-${String(process.pid)}`;
   writeFileSync4(tmp, `${JSON.stringify(registry, null, 2)}
 `, "utf-8");
-  renameSync3(tmp, path2);
+  renameSync3(tmp, path3);
 }
 function listWorkspaces(root6) {
   return readRegistry(root6).workspaces;
@@ -7794,18 +7905,18 @@ function computedColumnOrder(table, computed) {
   const names = new Set(Object.keys(computed));
   const order = [];
   const state2 = /* @__PURE__ */ new Map();
-  const visit = (name, path2) => {
+  const visit = (name, path3) => {
     const st = state2.get(name);
     if (st === "done") return;
     if (st === "visiting") {
-      const start = path2.indexOf(name);
-      throw new ComputedColumnCycleError(table, [...path2.slice(start), name]);
+      const start = path3.indexOf(name);
+      throw new ComputedColumnCycleError(table, [...path3.slice(start), name]);
     }
     state2.set(name, "visiting");
     const spec = computed[name];
     if (spec) {
       for (const dep of spec.deps) {
-        if (names.has(dep)) visit(dep, [...path2, name]);
+        if (names.has(dep)) visit(dep, [...path3, name]);
       }
     }
     state2.set(name, "done");
@@ -15373,11 +15484,11 @@ function stripHtml(html) {
   const text = decodeXmlEntities(stripTags(noScript));
   return text.replace(/[ \t\f\r]+/g, " ").replace(/ *\n */g, "\n").replace(/\n{3,}/g, "\n\n").trim();
 }
-async function unzip(path2) {
+async function unzip(path3) {
   const fflate = await loadParser("fflate");
   if (!fflate || typeof fflate.unzipSync !== "function") return null;
   try {
-    const buf = await readFile(path2);
+    const buf = await readFile(path3);
     let total = 0;
     return fflate.unzipSync(new Uint8Array(buf.buffer, buf.byteOffset, buf.byteLength), {
       filter: (file) => {
@@ -15406,35 +15517,35 @@ var init_helpers2 = __esm({
 
 // src/gui/ai/doc/ooxml.ts
 import { readFile as readFile2 } from "fs/promises";
-async function extractDocx(path2) {
+async function extractDocx(path3) {
   const mod = await loadParser("mammoth");
   const lib = mod?.default ?? mod;
   if (!lib || typeof lib.extractRawText !== "function") return null;
   try {
-    const { value } = await lib.extractRawText({ path: path2 });
+    const { value } = await lib.extractRawText({ path: path3 });
     return nullIfEmpty(value);
   } catch {
     return null;
   }
 }
-async function extractDoc(path2) {
+async function extractDoc(path3) {
   const mod = await loadParser(
     "word-extractor"
   );
   const Ctor = mod && "default" in mod ? mod.default : mod;
   if (typeof Ctor !== "function") return null;
   try {
-    const doc = await new Ctor().extract(path2);
+    const doc = await new Ctor().extract(path3);
     return nullIfEmpty(doc.getBody());
   } catch {
     return null;
   }
 }
-async function extractPdf(path2) {
+async function extractPdf(path3) {
   const unpdf = await loadParser("unpdf");
   if (!unpdf || typeof unpdf.getDocumentProxy !== "function") return null;
   try {
-    const buf = await readFile2(path2);
+    const buf = await readFile2(path3);
     const data = new Uint8Array(buf.buffer, buf.byteOffset, buf.byteLength);
     const text = await withTimeout(
       (async () => {
@@ -15466,8 +15577,8 @@ function slideText(xml) {
   }
   return paras.join("\n");
 }
-async function extractPptx(path2) {
-  const entries = await unzip(path2);
+async function extractPptx(path3) {
+  const entries = await unzip(path3);
   if (!entries) return null;
   const slides = Object.keys(entries).filter((n3) => /^ppt\/slides\/slide\d+\.xml$/.test(n3)).sort((a6, b6) => partNumber(a6) - partNumber(b6));
   if (slides.length === 0) return null;
@@ -15485,8 +15596,8 @@ async function extractPptx(path2) {
   }
   return nullIfEmpty(parts.join("\n\n"));
 }
-async function extractXlsx(path2) {
-  const entries = await unzip(path2);
+async function extractXlsx(path3) {
+  const entries = await unzip(path3);
   if (!entries) return null;
   const shared = [];
   const ssBytes = entries["xl/sharedStrings.xml"];
@@ -15544,8 +15655,8 @@ function odfWhitespace(s2) {
 function odfParagraph(inner) {
   return decodeXmlEntities(stripTags(odfWhitespace(inner))).trim();
 }
-async function extractOdfText(path2) {
-  const entries = await unzip(path2);
+async function extractOdfText(path3) {
+  const entries = await unzip(path3);
   if (!entries) return null;
   const contentBytes = entries["content.xml"];
   if (!contentBytes) return null;
@@ -15567,8 +15678,8 @@ async function extractOdfText(path2) {
   }
   return nullIfEmpty(lines.join("\n"));
 }
-async function extractOds(path2) {
-  const entries = await unzip(path2);
+async function extractOds(path3) {
+  const entries = await unzip(path3);
   if (!entries) return null;
   const contentBytes = entries["content.xml"];
   if (!contentBytes) return null;
@@ -15627,8 +15738,8 @@ function resolveHref(baseDir, href) {
   }
   return normalizeZipPath(baseDir + h6);
 }
-async function extractEpub(path2) {
-  const entries = await unzip(path2);
+async function extractEpub(path3) {
+  const entries = await unzip(path3);
   if (!entries) return null;
   let order = [];
   const container = entries["META-INF/container.xml"];
@@ -15712,9 +15823,9 @@ function rtfToText(rtf) {
   s2 = s2.replace(/[{}]/g, "");
   return s2.replace(/[ \t]+/g, (m4) => m4.includes("	") ? "	" : " ").replace(/[ \t]\n/g, "\n").replace(/\n{3,}/g, "\n\n").trim();
 }
-async function extractRtf(path2) {
+async function extractRtf(path3) {
   try {
-    const raw = await readFile3(path2, "latin1");
+    const raw = await readFile3(path3, "latin1");
     if (!raw.startsWith("{\\rtf")) return null;
     return nullIfEmpty(rtfToText(raw));
   } catch {
@@ -15760,27 +15871,27 @@ var init_other = __esm({
 });
 
 // src/gui/ai/doc-extractors.ts
-async function extractDocument(path2, ext) {
+async function extractDocument(path3, ext) {
   switch (ext) {
     case ".docx":
-      return extractDocx(path2);
+      return extractDocx(path3);
     case ".doc":
-      return extractDoc(path2);
+      return extractDoc(path3);
     case ".pdf":
-      return extractPdf(path2);
+      return extractPdf(path3);
     case ".pptx":
-      return extractPptx(path2);
+      return extractPptx(path3);
     case ".xlsx":
-      return extractXlsx(path2);
+      return extractXlsx(path3);
     case ".odt":
     case ".odp":
-      return extractOdfText(path2);
+      return extractOdfText(path3);
     case ".ods":
-      return extractOds(path2);
+      return extractOds(path3);
     case ".epub":
-      return extractEpub(path2);
+      return extractEpub(path3);
     case ".rtf":
-      return extractRtf(path2);
+      return extractRtf(path3);
     default:
       return null;
   }
@@ -15803,17 +15914,17 @@ function languageOf(name) {
 function truncate(s2) {
   return s2.length > MAX_TEXT2 ? s2.slice(0, MAX_TEXT2) : s2;
 }
-async function parseFile(path2, mimeHint, originalName) {
-  const name = originalName ?? basename4(path2);
+async function parseFile(path3, mimeHint, originalName) {
+  const name = originalName ?? basename4(path3);
   const ext = extname(name).toLowerCase();
   const lang = languageOf(name);
   if (lang) {
-    return { text: truncate(await readFile4(path2, "utf8")), language: lang };
+    return { text: truncate(await readFile4(path3, "utf8")), language: lang };
   }
   if (mimeHint && TEXT_MIME.test(mimeHint) || TEXT_EXT.has(ext)) {
-    return { text: truncate(await readFile4(path2, "utf8")) };
+    return { text: truncate(await readFile4(path3, "utf8")) };
   }
-  const doc = await extractDocument(path2, ext);
+  const doc = await extractDocument(path3, ext);
   if (doc != null) {
     return { text: truncate(doc) };
   }
@@ -15883,7 +15994,7 @@ var init_extract = __esm({
 });
 
 // src/ai/llm-client.ts
-import { createRequire as createRequire3 } from "module";
+import { createRequire as createRequire4 } from "module";
 var DEFAULT_MODEL;
 var init_llm_client = __esm({
   "src/ai/llm-client.ts"() {
@@ -16437,7 +16548,7 @@ var init_url_safety = __esm({
 import { JSDOM } from "jsdom";
 import { Readability } from "@mozilla/readability";
 import { basename as basename5 } from "path";
-import { createRequire as createRequire4 } from "module";
+import { createRequire as createRequire5 } from "module";
 async function crawlUrl(rawUrl, opts = {}) {
   const u2 = await assertSafeUrl(rawUrl, opts.allowPrivate ?? false);
   const fetchImpl = opts.fetcher ?? fetch;
@@ -16684,7 +16795,7 @@ async function renderViaPlaywright(url, timeoutMs, warnIfMissing = false) {
   let chromium;
   try {
     const importMetaUrl = import.meta.url;
-    const req = importMetaUrl ? createRequire4(importMetaUrl) : __require;
+    const req = importMetaUrl ? createRequire5(importMetaUrl) : __require;
     const pw = req("playwright");
     chromium = pw.chromium;
   } catch {
@@ -16856,8 +16967,8 @@ function isWriteConflict(e6) {
 function normalizeUrl(s2) {
   try {
     const u2 = new URL(s2.trim());
-    const path2 = u2.pathname.replace(/\/+$/, "");
-    return `${u2.protocol}//${u2.host.toLowerCase()}${path2}${u2.search}`;
+    const path3 = u2.pathname.replace(/\/+$/, "");
+    return `${u2.protocol}//${u2.host.toLowerCase()}${path3}${u2.search}`;
   } catch {
     return null;
   }
@@ -17615,7 +17726,7 @@ var init_tools = __esm({
 });
 
 // src/gui/ai/chat.ts
-import { createRequire as createRequire5 } from "module";
+import { createRequire as createRequire6 } from "module";
 function capToolResult(s2) {
   if (s2.length <= MAX_TOOL_RESULT_CHARS) return s2;
   if (s2.length > MAX_TOOL_RESULT_SKIP)
@@ -17848,7 +17959,7 @@ async function* runChat(opts) {
 function loadSdk() {
   if (!_sdk) {
     const importMetaUrl = import.meta.url;
-    const req = importMetaUrl ? createRequire5(importMetaUrl) : __require;
+    const req = importMetaUrl ? createRequire6(importMetaUrl) : __require;
     try {
       _sdk = req("@anthropic-ai/sdk");
     } catch (err) {
@@ -21675,14 +21786,14 @@ var init_readFile = __esm({
     "use strict";
     filePromises = {};
     fileIntercept = {};
-    readFile6 = (path2, options) => {
-      if (fileIntercept[path2] !== void 0) {
-        return fileIntercept[path2];
+    readFile6 = (path3, options) => {
+      if (fileIntercept[path3] !== void 0) {
+        return fileIntercept[path3];
       }
-      if (!filePromises[path2] || options?.ignoreCache) {
-        filePromises[path2] = fsReadFile(path2, "utf8");
+      if (!filePromises[path3] || options?.ignoreCache) {
+        filePromises[path3] = fsReadFile(path3, "utf8");
       }
-      return filePromises[path2];
+      return filePromises[path3];
     };
   }
 });
@@ -21800,8 +21911,8 @@ var init_externalDataInterceptor = __esm({
       getFileRecord() {
         return fileIntercept;
       },
-      interceptFile(path2, contents) {
-        fileIntercept[path2] = Promise.resolve(contents);
+      interceptFile(path3, contents) {
+        fileIntercept[path3] = Promise.resolve(contents);
       },
       getTokenRecord() {
         return tokenIntercept;
@@ -22135,13 +22246,13 @@ var init_resolveDefaultsModeConfig = __esm({
       }
       return { hostname: "169.254.169.254", path: "/" };
     };
-    imdsHttpGet = async ({ hostname, path: path2 }) => {
+    imdsHttpGet = async ({ hostname, path: path3 }) => {
       const { request } = await import("http");
       return new Promise((resolve17, reject) => {
         const req = request({
           method: "GET",
           hostname: hostname.replace(/^\[(.+)]$/, "$1"),
-          path: path2,
+          path: path3,
           timeout: 1e3,
           signal: AbortSignal.timeout(1e3)
         });
@@ -22342,8 +22453,8 @@ var init_createConfigValueProvider = __esm({
               return endpoint.url.href;
             }
             if ("hostname" in endpoint) {
-              const { protocol, hostname, port, path: path2 } = endpoint;
-              return `${protocol}//${hostname}${port ? ":" + port : ""}${path2}`;
+              const { protocol, hostname, port, path: path3 } = endpoint;
+              return `${protocol}//${hostname}${port ? ":" + port : ""}${path3}`;
             }
           }
           return endpoint;
@@ -22780,18 +22891,18 @@ var init_getAttrPathList = __esm({
   "node_modules/@smithy/core/dist-es/submodules/endpoints/util-endpoints/lib/getAttrPathList.js"() {
     "use strict";
     init_types3();
-    getAttrPathList = (path2) => {
-      const parts = path2.split(".");
+    getAttrPathList = (path3) => {
+      const parts = path3.split(".");
       const pathList = [];
       for (const part of parts) {
         const squareBracketIndex = part.indexOf("[");
         if (squareBracketIndex !== -1) {
           if (part.indexOf("]") !== part.length - 1) {
-            throw new EndpointError(`Path: '${path2}' does not end with ']'`);
+            throw new EndpointError(`Path: '${path3}' does not end with ']'`);
           }
           const arrayIndex = part.slice(squareBracketIndex + 1, -1);
           if (Number.isNaN(parseInt(arrayIndex))) {
-            throw new EndpointError(`Invalid array index: '${arrayIndex}' in path: '${path2}'`);
+            throw new EndpointError(`Invalid array index: '${arrayIndex}' in path: '${path3}'`);
           }
           if (squareBracketIndex !== 0) {
             pathList.push(part.slice(0, squareBracketIndex));
@@ -22813,9 +22924,9 @@ var init_getAttr = __esm({
     "use strict";
     init_types3();
     init_getAttrPathList();
-    getAttr = (value, path2) => getAttrPathList(path2).reduce((acc, index) => {
+    getAttr = (value, path3) => getAttrPathList(path3).reduce((acc, index) => {
       if (typeof acc !== "object") {
-        throw new EndpointError(`Index '${index}' in '${path2}' not found in '${JSON.stringify(value)}'`);
+        throw new EndpointError(`Index '${index}' in '${path3}' not found in '${JSON.stringify(value)}'`);
       } else if (Array.isArray(acc)) {
         const i6 = parseInt(index);
         return acc[i6 < 0 ? acc.length + i6 : i6];
@@ -22881,8 +22992,8 @@ var init_parseURL = __esm({
             return value;
           }
           if (typeof value === "object" && "hostname" in value) {
-            const { hostname: hostname2, port, protocol: protocol2 = "", path: path2 = "", query = {} } = value;
-            const url = new URL(`${protocol2}//${hostname2}${port ? `:${port}` : ""}${path2}`);
+            const { hostname: hostname2, port, protocol: protocol2 = "", path: path3 = "", query = {} } = value;
+            const url = new URL(`${protocol2}//${hostname2}${port ? `:${port}` : ""}${path3}`);
             url.search = Object.entries(query).map(([k6, v2]) => `${k6}=${v2}`).join("&");
             return url;
           }
@@ -25993,11 +26104,11 @@ var init_HttpBindingProtocol = __esm({
           const opTraits = translateTraits(operationSchema.traits);
           if (opTraits.http) {
             request.method = opTraits.http[0];
-            const [path2, search] = opTraits.http[1].split("?");
+            const [path3, search] = opTraits.http[1].split("?");
             if (request.path == "/") {
-              request.path = path2;
+              request.path = path3;
             } else {
-              request.path += path2;
+              request.path += path3;
             }
             const traitSearchParams = new URLSearchParams(search ?? "");
             for (const [key, value] of traitSearchParams) {
@@ -27976,9 +28087,9 @@ var init_createPaginator = __esm({
       command = withCommand(command) ?? command;
       return await client.send(command, ...args);
     };
-    get2 = (fromObject, path2) => {
+    get2 = (fromObject, path3) => {
       let cursor = fromObject;
-      const pathComponents = path2.split(".");
+      const pathComponents = path3.split(".");
       for (const step of pathComponents) {
         if (!cursor || typeof cursor !== "object") {
           return void 0;
@@ -30470,10 +30581,10 @@ ${longDate}
 ${credentialScope}
 ${toHex(hashedRequest)}`;
       }
-      getCanonicalPath({ path: path2 }) {
+      getCanonicalPath({ path: path3 }) {
         if (this.uriEscapePath) {
           const normalizedPathSegments = [];
-          for (const pathSegment of path2.split("/")) {
+          for (const pathSegment of path3.split("/")) {
             if (pathSegment?.length === 0)
               continue;
             if (pathSegment === ".")
@@ -30484,11 +30595,11 @@ ${toHex(hashedRequest)}`;
               normalizedPathSegments.push(pathSegment);
             }
           }
-          const normalizedPath = `${path2?.startsWith("/") ? "/" : ""}${normalizedPathSegments.join("/")}${normalizedPathSegments.length > 0 && path2?.endsWith("/") ? "/" : ""}`;
+          const normalizedPath = `${path3?.startsWith("/") ? "/" : ""}${normalizedPathSegments.join("/")}${normalizedPathSegments.length > 0 && path3?.endsWith("/") ? "/" : ""}`;
           const doubleEncoded = escapeUri(normalizedPath);
           return doubleEncoded.replace(/%2F/g, "/");
         }
-        return path2;
+        return path3;
       }
       validateResolvedCredentials(credentials) {
         if (typeof credentials !== "object" || typeof credentials.accessKeyId !== "string" || typeof credentials.secretAccessKey !== "string") {
@@ -35405,16 +35516,16 @@ var init_Matcher = __esm({
        * @returns {string|undefined}
        */
       getCurrentTag() {
-        const path2 = this._matcher.path;
-        return path2.length > 0 ? path2[path2.length - 1].tag : void 0;
+        const path3 = this._matcher.path;
+        return path3.length > 0 ? path3[path3.length - 1].tag : void 0;
       }
       /**
        * Get current namespace.
        * @returns {string|undefined}
        */
       getCurrentNamespace() {
-        const path2 = this._matcher.path;
-        return path2.length > 0 ? path2[path2.length - 1].namespace : void 0;
+        const path3 = this._matcher.path;
+        return path3.length > 0 ? path3[path3.length - 1].namespace : void 0;
       }
       /**
        * Get current node's attribute value.
@@ -35422,9 +35533,9 @@ var init_Matcher = __esm({
        * @returns {*}
        */
       getAttrValue(attrName) {
-        const path2 = this._matcher.path;
-        if (path2.length === 0) return void 0;
-        return path2[path2.length - 1].values?.[attrName];
+        const path3 = this._matcher.path;
+        if (path3.length === 0) return void 0;
+        return path3[path3.length - 1].values?.[attrName];
       }
       /**
        * Check if current node has an attribute.
@@ -35432,9 +35543,9 @@ var init_Matcher = __esm({
        * @returns {boolean}
        */
       hasAttr(attrName) {
-        const path2 = this._matcher.path;
-        if (path2.length === 0) return false;
-        const current = path2[path2.length - 1];
+        const path3 = this._matcher.path;
+        if (path3.length === 0) return false;
+        const current = path3[path3.length - 1];
         return current.values !== void 0 && attrName in current.values;
       }
       /**
@@ -35442,18 +35553,18 @@ var init_Matcher = __esm({
        * @returns {number}
        */
       getPosition() {
-        const path2 = this._matcher.path;
-        if (path2.length === 0) return -1;
-        return path2[path2.length - 1].position ?? 0;
+        const path3 = this._matcher.path;
+        if (path3.length === 0) return -1;
+        return path3[path3.length - 1].position ?? 0;
       }
       /**
        * Get current node's repeat counter (occurrence count of this tag name).
        * @returns {number}
        */
       getCounter() {
-        const path2 = this._matcher.path;
-        if (path2.length === 0) return -1;
-        return path2[path2.length - 1].counter ?? 0;
+        const path3 = this._matcher.path;
+        if (path3.length === 0) return -1;
+        return path3[path3.length - 1].counter ?? 0;
       }
       /**
        * Get current node's sibling index (alias for getPosition).
@@ -47219,12 +47330,12 @@ or increase socketAcquisitionWarningTimeout=(millis) in the NodeHttpHandler conf
             const password = request.password ?? "";
             auth = `${username}:${password}`;
           }
-          let path2 = request.path;
+          let path3 = request.path;
           if (queryString) {
-            path2 += `?${queryString}`;
+            path3 += `?${queryString}`;
           }
           if (request.fragment) {
-            path2 += `#${request.fragment}`;
+            path3 += `#${request.fragment}`;
           }
           let hostname = request.hostname ?? "";
           if (hostname[0] === "[" && hostname.endsWith("]")) {
@@ -47236,7 +47347,7 @@ or increase socketAcquisitionWarningTimeout=(millis) in the NodeHttpHandler conf
             headers: request.headers,
             host: hostname,
             method: request.method,
-            path: path2,
+            path: path3,
             port: request.port,
             agent,
             auth
@@ -58203,12 +58314,12 @@ init_postgres();
 
 // src/gui/realtime.ts
 import { EventEmitter } from "events";
-import { createRequire as createRequire2 } from "module";
+import { createRequire as createRequire3 } from "module";
 var _pgModule = null;
 function loadPg() {
   if (_pgModule) return _pgModule;
   const importMetaUrl = import.meta.url;
-  const requireFromHere = importMetaUrl ? createRequire2(importMetaUrl) : (
+  const requireFromHere = importMetaUrl ? createRequire3(importMetaUrl) : (
     // CJS fallback — Node provides `require` on every CJS module scope.
     __require
   );
@@ -59582,7 +59693,7 @@ async function applySchemaConfig(active, entry, direction, autoRender) {
   const doc = loadConfigDoc(active.configPath);
   const inv = direction === "inverse";
   const ddl = [];
-  const has = (path2) => doc.getIn(path2) !== void 0;
+  const has = (path3) => doc.getIn(path3) !== void 0;
   const reAddEntity = async (name, def) => {
     if (has(["entities", name])) {
       throw new Error(`Cannot restore "${name}": an entity with that name already exists`);
@@ -70125,9 +70236,9 @@ function rewriteDbLine(configPath, newValue) {
 function parseSaveBody(body) {
   const type = body.type;
   if (type === "sqlite") {
-    const path2 = typeof body.path === "string" && body.path.trim() ? body.path.trim() : "";
-    if (!path2) return null;
-    return { type: "sqlite", path: path2 };
+    const path3 = typeof body.path === "string" && body.path.trim() ? body.path.trim() : "";
+    if (!path3) return null;
+    return { type: "sqlite", path: path3 };
   }
   if (type === "postgres") {
     const label = typeof body.label === "string" && body.label.trim() ? body.label.trim() : "";
@@ -71865,12 +71976,12 @@ import { basename as basename11, extname as extname2, resolve as resolve11, join
 
 // src/ai/vision.ts
 init_llm_client();
-import { createRequire as createRequire6 } from "module";
+import { createRequire as createRequire7 } from "module";
 import { readFile as readFile8 } from "fs/promises";
 var DEFAULT_PROMPT = "Describe this image for a knowledge base in 2-4 factual sentences: what it shows, any visible text, and notable details. No preamble.";
 var MAX_DIM = 1568;
-async function describeImage(auth, path2, opts = {}) {
-  const data = (await normalizeImage(path2, opts.maxBytes ?? 14e5)).toString("base64");
+async function describeImage(auth, path3, opts = {}) {
+  const data = (await normalizeImage(path3, opts.maxBytes ?? 14e5)).toString("base64");
   const sender = opts.sender ?? defaultSender(auth);
   const text = await sender({
     media_type: "image/jpeg",
@@ -71881,8 +71992,8 @@ async function describeImage(auth, path2, opts = {}) {
   return text.trim();
 }
 var DEFAULT_PDF_PROMPT = "Read this document for a knowledge base. First transcribe its readable text, then add a 2-4 sentence factual summary of what it is and its key details. It may be a scanned/image-only PDF \u2014 read the text from the page images. No preamble.";
-async function describePdf(auth, path2, opts = {}) {
-  const buf = await readFile8(path2);
+async function describePdf(auth, path3, opts = {}) {
+  const buf = await readFile8(path3);
   const maxBytes = opts.maxBytes ?? 3e7;
   if (buf.length > maxBytes) {
     throw new Error(
@@ -71897,19 +72008,19 @@ async function describePdf(auth, path2, opts = {}) {
   });
   return text.trim();
 }
-async function normalizeImage(path2, maxBytes) {
+async function normalizeImage(path3, maxBytes) {
   const sharpMod = await import("sharp");
   const sharp = sharpMod.default;
   let quality = 80;
-  let buf = await renderJpeg(sharp, path2, quality);
+  let buf = await renderJpeg(sharp, path3, quality);
   while (buf.length > maxBytes && quality > 35) {
     quality -= 15;
-    buf = await renderJpeg(sharp, path2, quality);
+    buf = await renderJpeg(sharp, path3, quality);
   }
   return buf;
 }
-function renderJpeg(sharp, path2, quality) {
-  return sharp(path2).rotate().resize({ width: MAX_DIM, height: MAX_DIM, fit: "inside", withoutEnlargement: true }).jpeg({ quality }).toBuffer();
+function renderJpeg(sharp, path3, quality) {
+  return sharp(path3).rotate().resize({ width: MAX_DIM, height: MAX_DIM, fit: "inside", withoutEnlargement: true }).jpeg({ quality }).toBuffer();
 }
 function buildVisionAnthropicConfig(auth) {
   const config = {};
@@ -71927,7 +72038,7 @@ function buildVisionAnthropicConfig(auth) {
 function defaultSender(auth) {
   return async (input) => {
     const importMetaUrl = import.meta.url;
-    const req = importMetaUrl ? createRequire6(importMetaUrl) : __require;
+    const req = importMetaUrl ? createRequire7(importMetaUrl) : __require;
     const sdk = req("@anthropic-ai/sdk");
     const Anthropic = sdk.Anthropic ?? sdk.default;
     if (!Anthropic) throw new Error("Could not resolve Anthropic from '@anthropic-ai/sdk'");
@@ -71954,7 +72065,7 @@ function defaultSender(auth) {
 function defaultPdfSender(auth) {
   return async (input) => {
     const importMetaUrl = import.meta.url;
-    const req = importMetaUrl ? createRequire6(importMetaUrl) : __require;
+    const req = importMetaUrl ? createRequire7(importMetaUrl) : __require;
     const sdk = req("@anthropic-ai/sdk");
     const Anthropic = sdk.Anthropic ?? sdk.default;
     if (!Anthropic) throw new Error("Could not resolve Anthropic from '@anthropic-ai/sdk'");
@@ -73275,28 +73386,28 @@ ${err.stack ?? ""}`
     return null;
   }
 }
-async function extractImage(db, path2, mime) {
+async function extractImage(db, path3, mime) {
   if (!mime.startsWith("image/")) return null;
   const auth = await resolveClaudeAuth(db);
   if (!auth) return null;
   try {
-    const text = await describeImage(auth, path2);
+    const text = await describeImage(auth, path3);
     return text.trim() ? { text, skip: false } : null;
   } catch (e6) {
     console.warn("[ingest] image vision failed:", e6.message);
     return null;
   }
 }
-async function extractSource(db, path2, mime, name) {
-  const vision = await extractImage(db, path2, mime);
+async function extractSource(db, path3, mime, name) {
+  const vision = await extractImage(db, path3, mime);
   if (vision) return vision;
-  const parsed = await parseFile(path2, mime, name);
+  const parsed = await parseFile(path3, mime, name);
   if (!parsed.skip) return parsed;
   if (mime === "application/pdf") {
     const auth = await resolveClaudeAuth(db);
     if (auth) {
       try {
-        const text = await describePdf(auth, path2);
+        const text = await describePdf(auth, path3);
         if (text.trim()) return { ...parsed, text, skip: false };
       } catch (e6) {
         console.warn("[ingest] Claude PDF read failed:", e6.message);
@@ -73709,11 +73820,11 @@ async function readImportSourceFromFile(db, fileId, latticeRoot) {
     [fileId]
   );
   if (!row) throw badRequest("Unknown import file: " + fileId);
-  const path2 = localPathOf2(row, latticeRoot);
-  if (!path2 || !existsSync27(path2)) {
+  const path3 = localPathOf2(row, latticeRoot);
+  if (!path3 || !existsSync27(path3)) {
     throw badRequest("The import file\u2019s bytes are not available locally.");
   }
-  const sizeBytes = statSync9(path2).size;
+  const sizeBytes = statSync9(path3).size;
   if (sizeBytes > MAX_INGEST_BYTES) {
     throw badRequest(
       `The import file is too large (${String(Math.round(sizeBytes / 1e6))} MB); the limit is ${String(Math.round(MAX_INGEST_BYTES / 1e6))} MB.`
@@ -73722,11 +73833,11 @@ async function readImportSourceFromFile(db, fileId, latticeRoot) {
   const name = row.original_name ?? "";
   const mime = row.mime ?? "";
   if (/\.xlsx?$/i.test(name) || mime.includes("spreadsheet") || mime.includes("excel")) {
-    return excelToRecords(path2);
+    return excelToRecords(path3);
   }
   let parsed;
   try {
-    parsed = JSON.parse(readFileSync23(path2, "utf8"));
+    parsed = JSON.parse(readFileSync23(path3, "utf8"));
   } catch {
     throw badRequest("The import file is not valid JSON.");
   }
@@ -76506,7 +76617,7 @@ function printHelp() {
   );
 }
 function getVersion() {
-  if (true) return "4.2.0";
+  if (true) return "4.2.1";
   try {
     const pkgPath = new URL("../package.json", import.meta.url).pathname;
     const pkg = JSON.parse(readFileSync25(pkgPath, "utf-8"));