@cerefox/memory 1.15.2 → 1.15.3

package/dist/bin/cerefox.js

@@ -5318,7 +5318,7 @@ var init_cli_core = __esm(() => {
 });
 
 // src/meta.ts
-var PKG_VERSION = "1.15.2";
+var PKG_VERSION = "1.15.3";
 var init_meta = () => {};
 
 // ../../_shared/config/paths.ts
@@ -23799,7 +23799,7 @@ var init__utils = __esm(() => {
 });
 
 // ../../_shared/server-assets/index.ts
-import { existsSync as existsSync5 } from "node:fs";
+import { existsSync as existsSync5, readFileSync as readFileSync5 } from "node:fs";
 import { dirname as dirname2, join as join5 } from "node:path";
 import { fileURLToPath } from "node:url";
 import { cwd as processCwd2 } from "node:process";
@@ -23845,7 +23845,20 @@ function resolveServerAssets(opts = {}) {
   }
   return sourceServerAssets(join5(here, "..", ".."));
 }
-var init_server_assets = () => {};
+function bundledSchemaVersion(opts = {}) {
+  try {
+    const assets = resolveServerAssets(opts);
+    if (!existsSync5(assets.schemaFile))
+      return null;
+    return readFileSync5(assets.schemaFile, "utf8").match(SCHEMA_VERSION_RE)?.[1] ?? null;
+  } catch {
+    return null;
+  }
+}
+var SCHEMA_VERSION_RE;
+var init_server_assets = __esm(() => {
+  SCHEMA_VERSION_RE = /^--\s*@version:\s*(\S+)/m;
+});
 
 // ../../node_modules/.bun/postgres@3.4.9/node_modules/postgres/src/query.js
 function cachedError(xs) {
@@ -26142,7 +26155,7 @@ var init__projects = __esm(() => {
 });
 
 // src/cli/util/bundled-docs.ts
-import { existsSync as existsSync8, readdirSync as readdirSync3, readFileSync as readFileSync6, statSync } from "node:fs";
+import { existsSync as existsSync8, readdirSync as readdirSync3, readFileSync as readFileSync7, statSync } from "node:fs";
 import { dirname as dirname3, join as join7, resolve as resolve2 } from "node:path";
 import { fileURLToPath as fileURLToPath2 } from "node:url";
 function findPackageRoot() {
@@ -26151,7 +26164,7 @@ function findPackageRoot() {
     const pkgJson = join7(dir, "package.json");
     if (existsSync8(pkgJson)) {
       try {
-        const parsed = JSON.parse(readFileSync6(pkgJson, "utf8"));
+        const parsed = JSON.parse(readFileSync7(pkgJson, "utf8"));
         if (parsed.name === "@cerefox/memory")
           return dir;
       } catch {}
@@ -26226,7 +26239,7 @@ function readBundledDoc(topic) {
   return {
     topic: entry.topic,
     path: entry.path,
-    content: readFileSync6(entry.path, "utf8")
+    content: readFileSync7(entry.path, "utf8")
   };
 }
 var PACKAGE_ROOT;
@@ -26235,7 +26248,7 @@ var init_bundled_docs = __esm(() => {
 });
 
 // ../../_shared/ef-meta/index.ts
-var EF_VERSION = "1.15.2", CEREFOX_VERSION = "1.15.2", EF_LAST_CHANGED = "1.15.2";
+var EF_VERSION = "1.15.3", CEREFOX_VERSION = "1.15.3", EF_LAST_CHANGED = "1.15.3";
 var init_ef_meta = () => {};
 
 // ../../_shared/compatibility/index.ts
@@ -26380,6 +26393,7 @@ __export(exports_onnx_embedder, {
   ONNX_MODEL_ID: () => ONNX_MODEL_ID,
   ONNX_MODEL_NAME: () => ONNX_MODEL_NAME,
   buildPrefixedInputs: () => buildPrefixedInputs,
+  isModelCached: () => isModelCached,
   nomicPrefix: () => nomicPrefix,
   onnxEmbed: () => onnxEmbed,
   warmup: () => warmup
@@ -26394,6 +26408,9 @@ function buildPrefixedInputs(texts, role) {
   const p = nomicPrefix(role);
   return texts.map((t) => p + t);
 }
+function isModelCached(dir = getCacheDir()) {
+  return MODEL_FILES.every((f) => existsSync10(join9(dir, f)));
+}
 function getCacheDir() {
   const env = globalThis.process?.env ?? {};
   if (env.CEREFOX_MODELS_DIR)
@@ -26436,6 +26453,12 @@ async function ensurePipeline() {
     return pipelinePromise;
   pipelinePromise = (async () => {
     const transformers = await loadTransformers();
+    if (isModelCached()) {
+      const pipe = await transformers.pipeline("feature-extraction", ONNX_MODEL_ID, {
+        dtype: ONNX_MODEL_DTYPE
+      });
+      return pipe;
+    }
     const mb = ONNX_MODEL_APPROX_MB;
     const fmt = (s) => s < 60 ? `${s}s` : `${Math.round(s / 60)}m`;
     process.stderr.write(`[cerefox-embed] loading "${ONNX_MODEL_NAME}" from HuggingFace (~${mb} MB; est. ${fmt(Math.round(mb * 8 / 50))}-${fmt(Math.round(mb * 8 / 10))} at 50-10 Mbps; first-run only)…
@@ -26559,8 +26582,15 @@ async function onnxEmbed(texts, role) {
   }
   return vectors;
 }
-var ONNX_MODEL_ID = "nomic-ai/nomic-embed-text-v1.5", ONNX_MODEL_NAME = "nomic-embed-text-v1.5", ONNX_MODEL_DTYPE = "q8", ONNX_MODEL_DIM = 768, ONNX_MODEL_APPROX_MB = 130, transformersModule = null, pipelinePromise = null, DEFAULT_ONNX_BATCH = 4;
-var init_onnx_embedder = () => {};
+var ONNX_MODEL_ID = "nomic-ai/nomic-embed-text-v1.5", ONNX_MODEL_NAME = "nomic-embed-text-v1.5", ONNX_MODEL_DTYPE = "q8", ONNX_MODEL_DIM = 768, ONNX_MODEL_APPROX_MB = 130, MODEL_FILES, transformersModule = null, pipelinePromise = null, DEFAULT_ONNX_BATCH = 4;
+var init_onnx_embedder = __esm(() => {
+  MODEL_FILES = [
+    "config.json",
+    "tokenizer.json",
+    "tokenizer_config.json",
+    `onnx/model_quantized.onnx`
+  ].map((f) => join9(ONNX_MODEL_ID, f));
+});
 
 // ../../_shared/embeddings/index.ts
 function openaiEmbeddingConfig() {
@@ -51652,6 +51682,7 @@ async function handler6(supabase, args, ctx) {
     throw new McpInvalidParams('metadata must be a JSON object of key/value pairs, e.g. {"type":"note"} — not a string, number, or array');
   }
   const update_if_exists = args.update_if_exists ?? false;
+  const overrideNote = args.update_if_exists === false ? " Note: update_if_exists flag was overridden by document_id." : "";
   const author = callerIdentity(args) ?? DEFAULT_IDENTITY;
   const author_type = "agent";
   const expected_content_hash = args.expected_content_hash?.trim() || null;
@@ -51677,7 +51708,7 @@ async function handler6(supabase, args, ctx) {
       throw new McpInvalidParams(`Document ${document_id} ("${existingDoc.title}") is soft-deleted (in the trash). ` + `A trashed document cannot be updated — restore it first with ` + `cerefox_restore_document, then retry, or create a new document instead.`);
     }
     if (existingDoc.content_hash === contentHash) {
-      const note = update_if_exists ? "" : " Note: update_if_exists flag was overridden by document_id.";
+      const note = overrideNote;
       return `Document already up-to-date: "${existingDoc.title}" (id: ${existingDoc.id}). Content hash unchanged (${contentHash}).${note}`;
     }
     if (!last_write_wins && expected_content_hash && expected_content_hash !== existingDoc.content_hash) {
@@ -51727,7 +51758,7 @@ async function handler6(supabase, args, ctx) {
     } else if (project_name) {
       await ensureDocumentInProject(supabase, existingDoc.id, project_name, { author, authorType: author_type });
     }
-    const note = update_if_exists ? "" : " Note: update_if_exists flag was overridden by document_id.";
+    const note = overrideNote;
     return `Document updated: "${title}" (id: ${existingDoc.id}), ${chunks.length} chunk(s), ${totalChars} chars. New content_hash: ${contentHash}.${note}${escapedContentNote(content)}`;
   }
   if (update_if_exists) {
@@ -53467,7 +53498,7 @@ var require_cli_progress = __commonJS(function(exports, module) {
 });
 
 // src/cli/commands/sync-self-docs.ts
-import { readFileSync as readFileSync12 } from "node:fs";
+import { readFileSync as readFileSync13 } from "node:fs";
 import { basename as basename4, extname as extname5 } from "node:path";
 async function runSyncSelfDocs(options = {}) {
   const project = options.project ?? "_cerefox-self-docs";
@@ -53494,7 +53525,7 @@ async function runSyncSelfDocs(options = {}) {
   const authorType = resolveAuthorType("agent");
   const outcomes = [];
   for (const doc of docs) {
-    const content = readFileSync12(doc.path, "utf8");
+    const content = readFileSync13(doc.path, "utf8");
     const m = content.match(/^#\s+(.+)$/m);
     const title = m ? m[1].trim() : basename4(doc.path, extname5(doc.path));
     try {
@@ -63058,7 +63089,6 @@ var init_stdio2 = __esm(() => {
 });
 
 // src/server.ts
-import { existsSync as existsSync13, readFileSync as readFileSync14 } from "node:fs";
 function buildServer() {
   const settings = loadSettings();
   if (!settings.supabaseUrl || !settings.supabaseKey) {
@@ -63109,14 +63139,7 @@ async function warnIfSchemaVersionMismatch(supabase) {
     const deployed = typeof data === "string" ? data : null;
     if (!deployed)
       return;
-    let bundled = null;
-    try {
-      const assets = resolveServerAssets();
-      if (existsSync13(assets.schemaFile)) {
-        const m = readFileSync14(assets.schemaFile, "utf8").match(SCHEMA_VERSION_RE2);
-        bundled = m ? m[1] : null;
-      }
-    } catch {}
+    const bundled = bundledSchemaVersion();
     if (!bundled)
       return;
     if (compareSemver(deployed, bundled) < 0) {
@@ -63125,7 +63148,7 @@ async function warnIfSchemaVersionMismatch(supabase) {
     }
   } catch {}
 }
-var SERVER_NAME = "cerefox", SCHEMA_VERSION_RE2;
+var SERVER_NAME = "cerefox";
 var init_server3 = __esm(() => {
   init_server2();
   init_stdio2();
@@ -63136,7 +63159,6 @@ var init_server3 = __esm(() => {
   init_server_assets();
   init_mcp_tools();
   init_meta();
-  SCHEMA_VERSION_RE2 = /^--\s*@version:\s*(\S+)/m;
 });
 
 // src/bin/cerefox.ts
@@ -67439,7 +67461,7 @@ import { readdirSync as readdirSync2 } from "node:fs";
 
 // ../../_shared/db-deploy/index.ts
 init_src();
-import { existsSync as existsSync6, readFileSync as readFileSync5, readdirSync } from "node:fs";
+import { existsSync as existsSync6, readFileSync as readFileSync6, readdirSync } from "node:fs";
 import { join as join6 } from "node:path";
 var RESET_SQL = `
 DROP TABLE IF EXISTS cerefox_chunks      CASCADE;
@@ -67462,8 +67484,8 @@ function listMigrationFiles(migrationsDir) {
   return readdirSync(migrationsDir).filter((n) => n.endsWith(".sql")).sort();
 }
 function buildDeploySteps(assets, opts = {}) {
-  const schemaSql = readFileSync5(assets.schemaFile, "utf8");
-  const rpcsSql = readFileSync5(assets.rpcsFile, "utf8");
+  const schemaSql = readFileSync6(assets.schemaFile, "utf8");
+  const rpcsSql = readFileSync6(assets.rpcsFile, "utf8");
   const steps = [];
   if (opts.reset) {
     steps.push({ label: "Reset: drop existing Cerefox objects", sql: RESET_SQL });
@@ -67575,7 +67597,7 @@ async function runDbMigrate(opts) {
     }
     const applied = [];
     for (const f of pending) {
-      const body = readFileSync5(join6(opts.assets.migrationsDir, f), "utf8");
+      const body = readFileSync6(join6(opts.assets.migrationsDir, f), "utf8");
       log(`Applying ${f}…`);
       try {
         await sql.begin(async (tx) => {
@@ -67605,7 +67627,7 @@ async function applyRpcs(opts) {
   log("Refresh RPCs (rpcs.sql)…");
   if (opts.dryRun)
     return { ok: true };
-  const rpcsSql = readFileSync5(opts.assets.rpcsFile, "utf8");
+  const rpcsSql = readFileSync6(opts.assets.rpcsFile, "utf8");
   const sql = src_default(opts.dbUrl, { prepare: false, onnotice: () => {} });
   try {
     await sql.unsafe(rpcsSql);
@@ -71723,7 +71745,7 @@ init_config();
 init_config();
 init_compatibility();
 init_server_assets();
-import { existsSync as existsSync11, readFileSync as readFileSync8, realpathSync, statSync as statSync2 } from "node:fs";
+import { existsSync as existsSync11, readFileSync as readFileSync9, realpathSync, statSync as statSync2 } from "node:fs";
 import { homedir as homedir7 } from "node:os";
 import { join as join10 } from "node:path";
 
@@ -71733,7 +71755,7 @@ import {
   existsSync as existsSync9,
   mkdirSync as mkdirSync3,
   openSync,
-  readFileSync as readFileSync7,
+  readFileSync as readFileSync8,
   rmSync,
   writeFileSync as writeFileSync4
 } from "node:fs";
@@ -71757,7 +71779,7 @@ function readPidFile() {
   if (!existsSync9(PID_FILE))
     return null;
   try {
-    const parsed = JSON.parse(readFileSync7(PID_FILE, "utf8"));
+    const parsed = JSON.parse(readFileSync8(PID_FILE, "utf8"));
     if (typeof parsed.pid !== "number")
       return null;
     return {
@@ -72153,18 +72175,6 @@ async function checkOpenAI() {
     };
   }
 }
-var SCHEMA_VERSION_RE = /^--\s*@version:\s*(\S+)/m;
-function readBundledSchemaVersion() {
-  try {
-    const assets = resolveServerAssets();
-    if (!existsSync11(assets.schemaFile))
-      return null;
-    const m = readFileSync8(assets.schemaFile, "utf8").match(SCHEMA_VERSION_RE);
-    return m ? m[1] : null;
-  } catch {
-    return null;
-  }
-}
 var SCHEMA_CHECK_NAME = "schema + RPCs";
 async function checkSchemaVersion() {
   const settings = loadSettings();
@@ -72195,7 +72205,7 @@ async function checkSchemaVersion() {
       };
     }
     const deployed = await resp.json();
-    const bundled = readBundledSchemaVersion();
+    const bundled = bundledSchemaVersion();
     const level = classifyCompat(deployed, COMPATIBILITY.minSchema, bundled);
     switch (level) {
       case "below-min":
@@ -72405,7 +72415,7 @@ function hasCerefoxInJsonFile(path) {
   if (!existsSync11(path))
     return false;
   try {
-    const parsed = JSON.parse(readFileSync8(path, "utf8"));
+    const parsed = JSON.parse(readFileSync9(path, "utf8"));
     const mcpServers = parsed.mcpServers;
     return Boolean(mcpServers && typeof mcpServers === "object" && "cerefox" in mcpServers);
   } catch {
@@ -73059,11 +73069,11 @@ function registerGetDoc(program) {
 init_dist4();
 init_cli_core();
 init_config();
-import { readFileSync as readFileSync10 } from "node:fs";
+import { readFileSync as readFileSync11 } from "node:fs";
 import { basename as basename2, extname as extname3 } from "node:path";
 
 // src/ingestion/pipeline.ts
-import { readFileSync as readFileSync9 } from "node:fs";
+import { readFileSync as readFileSync10 } from "node:fs";
 import { basename, extname as extname2, resolve as resolve3 } from "node:path";
 // ../../_shared/ingest/pipeline-helpers.ts
 import { createHash } from "node:crypto";
@@ -73389,6 +73399,10 @@ async function fileToMarkdown(filename, data) {
 }
 
 // src/ingestion/pipeline.ts
+function updateByIdNote(updateExisting) {
+  return updateExisting === false ? "document_id provided; update_if_exists flag was overridden" : undefined;
+}
+
 class IngestionPipeline {
   db;
   apiKey;
@@ -73453,9 +73467,9 @@ class IngestionPipeline {
           result.projectIds = await this.db.getDocumentProjectIds(documentId);
         }
       }
-      if (!updateExisting) {
-        result.note = "document_id provided; update_if_exists flag was overridden";
-      }
+      const note = updateByIdNote(opts.updateExisting);
+      if (note)
+        result.note = note;
       return result;
     }
     if (updateExisting) {
@@ -73729,7 +73743,7 @@ class IngestionPipeline {
     };
   }
   async ingestFile(path, opts = {}) {
-    const text = await fileToMarkdown(path, readFileSync9(path));
+    const text = await fileToMarkdown(path, readFileSync10(path));
     const absPath = resolve3(path);
     const stem = basename(absPath, extname2(absPath));
     return this.ingestText({
@@ -73764,7 +73778,7 @@ async function readContent(path, paste) {
   }
   let content;
   try {
-    content = readFileSync10(path, "utf8");
+    content = readFileSync11(path, "utf8");
   } catch (err) {
     const msg = err instanceof Error ? err.message : String(err);
     throw userError(`Cannot read ${path}: ${msg}`);
@@ -73822,7 +73836,7 @@ async function action20(path, options) {
       projectName: options.projectName ?? null,
       projectNames: projectNames ?? null,
       metadata: metadata ?? null,
-      updateExisting: Boolean(options.updateIfExists),
+      updateExisting: options.updateIfExists ? true : undefined,
       documentId: options.documentId ?? null,
       author,
       authorType,
@@ -73836,7 +73850,7 @@ async function action20(path, options) {
       projectName: options.projectName ?? null,
       projectNames: projectNames ?? null,
       metadata: metadata ?? null,
-      updateExisting: Boolean(options.updateIfExists),
+      updateExisting: options.updateIfExists ? true : undefined,
       documentId: options.documentId ?? null,
       author,
       authorType,
@@ -73874,14 +73888,14 @@ init_cli_core();
 init_mcp_tools();
 init_config();
 init_client();
-import { readFileSync as readFileSync11 } from "node:fs";
+import { readFileSync as readFileSync12 } from "node:fs";
 function resolveText(value, what) {
   if (value === undefined)
     throw userError(`${what} is required.`);
   if (value === "-")
-    return readFileSync11(0, "utf8");
+    return readFileSync12(0, "utf8");
   if (value.startsWith("@"))
-    return readFileSync11(value.slice(1), "utf8");
+    return readFileSync12(value.slice(1), "utf8");
   return value;
 }
 function context() {
@@ -74014,7 +74028,7 @@ async function action21(dir, options) {
         sourceOnCreate: "cli",
         projectName: options.projectName ?? null,
         metadata: metadata ?? null,
-        updateExisting: Boolean(options.updateIfExists),
+        updateExisting: options.updateIfExists ? true : undefined,
         author,
         authorType,
         lastWriteWins: true
@@ -74057,7 +74071,7 @@ import {
   copyFileSync as copyFileSync2,
   existsSync as existsSync12,
   mkdirSync as mkdirSync5,
-  readFileSync as readFileSync13,
+  readFileSync as readFileSync14,
   writeFileSync as writeFileSync5
 } from "node:fs";
 import { homedir as homedir8 } from "node:os";
@@ -74068,7 +74082,7 @@ async function readConfigFile(path) {
   }
   let parsed;
   try {
-    parsed = JSON.parse(readFileSync13(path, "utf8"));
+    parsed = JSON.parse(readFileSync14(path, "utf8"));
   } catch (err) {
     throw userError(`--config: invalid JSON in ${path}: ${err instanceof Error ? err.message : String(err)}`);
   }
@@ -74110,7 +74124,7 @@ function parseDotEnvFile(content) {
   return map;
 }
 function answersFromEnvFile(path) {
-  const parsed = parseDotEnvFile(readFileSync13(path, "utf8"));
+  const parsed = parseDotEnvFile(readFileSync14(path, "utf8"));
   const required = ["CEREFOX_SUPABASE_URL", "CEREFOX_SUPABASE_KEY", "OPENAI_API_KEY"];
   for (const key of required) {
     if (!parsed[key] || parsed[key].trim() === "") {
@@ -75046,7 +75060,7 @@ function registerMigrateFormat(program) {
 // src/cli/commands/restore.ts
 init_cli_core();
 init_client();
-import { existsSync as existsSync14, readFileSync as readFileSync15, readdirSync as readdirSync5, statSync as statSync4 } from "node:fs";
+import { existsSync as existsSync13, readFileSync as readFileSync15, readdirSync as readdirSync5, statSync as statSync4 } from "node:fs";
 import { homedir as homedir9 } from "node:os";
 import { join as join13, resolve as resolve4 } from "node:path";
 function expandHome2(path) {
@@ -75058,7 +75072,7 @@ function expandHome2(path) {
 }
 function resolveBackupFile(target) {
   const path = resolve4(expandHome2(target));
-  if (!existsSync14(path)) {
+  if (!existsSync13(path)) {
     throw userError(`Backup path not found: ${target}`);
   }
   const stat = statSync4(path);
@@ -75549,7 +75563,7 @@ init_config();
 import { randomBytes } from "node:crypto";
 
 // src/cli/util/env-file.ts
-import { copyFileSync as copyFileSync3, existsSync as existsSync15, readFileSync as readFileSync16, writeFileSync as writeFileSync6 } from "node:fs";
+import { copyFileSync as copyFileSync3, existsSync as existsSync14, readFileSync as readFileSync16, writeFileSync as writeFileSync6 } from "node:fs";
 import { dirname as dirname5 } from "node:path";
 import { spawnSync as spawnSync6 } from "node:child_process";
 function escapeRegExp(s) {
@@ -75559,7 +75573,7 @@ function upsertEnvVar(path, key, value, opts = {}) {
   const line = `${key}=${value}`;
   const header = opts.comment ? `# ${opts.comment}
 ` : "";
-  if (!existsSync15(path)) {
+  if (!existsSync14(path)) {
     writeFileSync6(path, `${header}${line}
 `, { mode: 384 });
     return { path, action: "created" };
@@ -75589,7 +75603,7 @@ ${header}${line}
   return { path, action, backupPath };
 }
 function readEnvVar(path, key) {
-  if (!existsSync15(path))
+  if (!existsSync14(path))
     return null;
   const m = readFileSync16(path, "utf8").match(new RegExp(`^\\s*${escapeRegExp(key)}=(.*)$`, "m"));
   return m ? m[1].trim() : null;
@@ -75612,7 +75626,7 @@ function envGitignoreWarning(path) {
 }
 
 // src/web/auth.ts
-import { existsSync as existsSync16 } from "node:fs";
+import { existsSync as existsSync15 } from "node:fs";
 
 // ../../node_modules/.bun/@hono+node-server@2.1.1+2ac783cc5e75a70c/node_modules/@hono/node-server/dist/conninfo.mjs
 var getConnInfo = (c) => {
@@ -75677,7 +75691,7 @@ var LOOPBACK_ADDRESSES = new Set([
 ]);
 function isContainerised() {
   try {
-    return existsSync16("/.dockerenv");
+    return existsSync15("/.dockerenv");
   } catch {
     return false;
   }
@@ -77556,7 +77570,7 @@ var _baseMimes = {
 var baseMimes = _baseMimes;
 
 // ../../node_modules/.bun/@hono+node-server@2.1.1+2ac783cc5e75a70c/node_modules/@hono/node-server/dist/serve-static.mjs
-import { createReadStream, existsSync as existsSync17, statSync as statSync5 } from "node:fs";
+import { createReadStream, existsSync as existsSync16, statSync as statSync5 } from "node:fs";
 import { join as join14 } from "node:path";
 var COMPRESSIBLE_CONTENT_TYPE_REGEX = /^\s*(?:text\/[^;\s]+|application\/(?:javascript|json|xml|xml-dtd|ecmascript|dart|postscript|rtf|tar|toml|vnd\.dart|vnd\.ms-fontobject|vnd\.ms-opentype|wasm|x-httpd-php|x-javascript|x-ns-proxy-autoconfig|x-sh|x-tar|x-virtualbox-hdd|x-virtualbox-ova|x-virtualbox-ovf|x-virtualbox-vbox|x-virtualbox-vdi|x-virtualbox-vhd|x-virtualbox-vmdk|x-www-form-urlencoded)|font\/(?:otf|ttf)|image\/(?:bmp|vnd\.adobe\.photoshop|vnd\.microsoft\.icon|vnd\.ms-dds|x-icon|x-ms-bmp)|message\/rfc822|model\/gltf-binary|x-shader\/x-fragment|x-shader\/x-vertex|[^;\s]+?\+(?:json|text|xml|yaml))(?:[;\s]|$)/i;
 var ENCODINGS = {
@@ -77630,7 +77644,7 @@ var tryDecodeURI = (str) => tryDecode(str, decodeURI);
 var serveStatic = (options = { root: "" }) => {
   const root = options.root || "";
   const optionPath = options.path;
-  if (root !== "" && !existsSync17(root))
+  if (root !== "" && !existsSync16(root))
     console.error(`serveStatic: root path '${root}' is not found, are you sure it's correct?`);
   return async (c, next) => {
     if (c.finalized)
@@ -77713,7 +77727,7 @@ var serveStatic = (options = { root: "" }) => {
 };
 
 // src/web/server.ts
-import { existsSync as existsSync21 } from "node:fs";
+import { existsSync as existsSync20 } from "node:fs";
 import { readFileSync as readFileSync19, statSync as statSync8 } from "node:fs";
 import { join as join18 } from "node:path";
 
@@ -80790,7 +80804,7 @@ function registerIngestRoutes(app, ctx) {
         projectNames: Array.isArray(body.project_names) ? body.project_names : null,
         projectName: typeof body.project_name === "string" ? body.project_name : null,
         metadata: body.metadata ?? null,
-        updateExisting: body.update_existing === true || body.update_if_exists === true,
+        updateExisting: body.update_existing == null && body.update_if_exists == null ? undefined : body.update_existing === true || body.update_if_exists === true,
         documentId: body.document_id ?? null,
         author: who.identity.author,
         authorType: who.identity.authorType,
@@ -80955,12 +80969,13 @@ function registerIngestRoutes(app, ctx) {
 }
 
 // src/web/routes/meta.ts
+init_server_assets();
 init_meta();
 import { execFileSync } from "node:child_process";
 
 // src/web/docs.ts
 import {
-  existsSync as existsSync18,
+  existsSync as existsSync17,
   readFileSync as readFileSync17,
   readdirSync as readdirSync6,
   statSync as statSync6
@@ -80993,7 +81008,7 @@ function resolveDocsRoots() {
   let pkgTopLevel = null;
   for (const pkg of pkgRootCandidates) {
     const guides = join15(pkg, "docs", "guides");
-    if (existsSync18(guides) && statSync6(guides).isDirectory()) {
+    if (existsSync17(guides) && statSync6(guides).isDirectory()) {
       pkgGuides = guides;
       pkgTopLevel = pkg;
       break;
@@ -81005,8 +81020,8 @@ function resolveDocsRoots() {
   return {
     pkgGuides,
     pkgTopLevel,
-    repoGuides: existsSync18(repoGuides) ? repoGuides : null,
-    repoTopLevel: existsSync18(join15(repoTopLevel, "README.md")) ? repoTopLevel : null
+    repoGuides: existsSync17(repoGuides) ? repoGuides : null,
+    repoTopLevel: existsSync17(join15(repoTopLevel, "README.md")) ? repoTopLevel : null
   };
 }
 function readH1(filePath) {
@@ -81032,7 +81047,7 @@ function listBundledDocs2() {
   if (topRoot) {
     for (const t of TOP_LEVEL_DOCS) {
       const abs = join15(topRoot, t.filename);
-      if (existsSync18(abs)) {
+      if (existsSync17(abs)) {
         entries.push(entryForFile(abs, t.path, t.category));
       }
     }
@@ -81059,7 +81074,7 @@ function readDoc(docPath) {
   if (!candidate.startsWith(rootResolved + "/") && candidate !== rootResolved) {
     return null;
   }
-  if (existsSync18(candidate) && statSync6(candidate).isFile()) {
+  if (existsSync17(candidate) && statSync6(candidate).isFile()) {
     try {
       return readFileSync17(candidate, "utf8");
     } catch {
@@ -81068,6 +81083,18 @@ function readDoc(docPath) {
   }
   return null;
 }
+function readOpenApiDocument() {
+  const here = moduleDir2();
+  const candidates = [
+    join15(here, "..", "..", "docs", "api", "openapi.json"),
+    join15(here, "..", "..", "..", "..", "docs", "api", "openapi.json")
+  ];
+  for (const p of candidates) {
+    if (existsSync17(p))
+      return readFileSync17(p, "utf8");
+  }
+  return null;
+}
 
 // src/web/routes/meta.ts
 init_compatibility();
@@ -81090,7 +81117,6 @@ var VERSION_INFO = {
   git_commit_short: resolveGitCommitShort(),
   build_date: process.env.CEREFOX_BUILD_DATE ?? null
 };
-var SCHEMA_VERSION_RE3 = /^--\s*@version:\s*(\S+)/m;
 function registerMetaRoutes(app, ctx) {
   app.get("/api/v1/version", (c) => {
     const label = (process.env.CEREFOX_ENV_LABEL ?? "").trim();
@@ -81107,28 +81133,15 @@ function registerMetaRoutes(app, ctx) {
       "Content-Type": "text/markdown; charset=utf-8"
     });
   });
-  app.get("/api/v1/schema-version", async (c) => {
-    let bundled = null;
-    try {
-      const { readFileSync, existsSync } = await import("node:fs");
-      const { fileURLToPath } = await import("node:url");
-      const { dirname, join } = await import("node:path");
-      const here = dirname(fileURLToPath(import.meta.url));
-      const candidates = [
-        join(here, "..", "..", "..", "db", "schema.sql"),
-        join(here, "..", "..", "..", "..", "..", "src", "cerefox", "db", "schema.sql")
-      ];
-      for (const path of candidates) {
-        if (existsSync(path)) {
-          const sql = readFileSync(path, "utf8");
-          const match = sql.match(SCHEMA_VERSION_RE3);
-          bundled = match ? match[1] : null;
-          break;
-        }
-      }
-    } catch {
-      bundled = null;
+  app.get("/api/v1/openapi.json", (c) => {
+    const doc = readOpenApiDocument();
+    if (doc === null) {
+      return c.json({ detail: "The OpenAPI document is not bundled with this build." }, 404);
     }
+    return c.body(doc, 200, { "Content-Type": "application/json; charset=utf-8" });
+  });
+  app.get("/api/v1/schema-version", async (c) => {
+    const bundled = bundledSchemaVersion();
     let deployed = null;
     if (ctx) {
       try {
@@ -81157,8 +81170,8 @@ function registerMetaRoutes(app, ctx) {
         }
       } catch {}
     }
-    const mismatch = Boolean(bundled && deployed && bundled !== deployed);
     const level = classifyCompat(deployed, COMPATIBILITY.minSchema, bundled);
+    const mismatch = level === "above-min-but-old";
     return c.json({
       bundled,
       deployed,
@@ -81216,7 +81229,7 @@ function registerPostgrestProxy(app) {
 
 // src/web/routes/preferences.ts
 init_config();
-import { existsSync as existsSync19, mkdirSync as mkdirSync6, readFileSync as readFileSync18, writeFileSync as writeFileSync7 } from "node:fs";
+import { existsSync as existsSync18, mkdirSync as mkdirSync6, readFileSync as readFileSync18, writeFileSync as writeFileSync7 } from "node:fs";
 import { join as join16 } from "node:path";
 function isTheme(v) {
   return v === "auto" || v === "light" || v === "dark";
@@ -81242,7 +81255,7 @@ function registerPreferencesRoutes(app) {
     const next = { ...readPrefs(), theme: body.theme };
     try {
       const dir = userStateDir();
-      if (!existsSync19(dir))
+      if (!existsSync18(dir))
         mkdirSync6(dir, { recursive: true });
       writeFileSync7(prefsFile(), `${JSON.stringify(next, null, 2)}
 `);
@@ -81379,14 +81392,14 @@ function registerProjectsRoutes(app, ctx) {
 }
 
 // src/web/static.ts
-import { existsSync as existsSync20, statSync as statSync7 } from "node:fs";
+import { existsSync as existsSync19, statSync as statSync7 } from "node:fs";
 import { dirname as dirname7, join as join17 } from "node:path";
 import { fileURLToPath as fileURLToPath4 } from "node:url";
 function moduleDir3() {
   return dirname7(fileURLToPath4(import.meta.url));
 }
 function isUsableSpaDir(dir) {
-  return existsSync20(dir) && statSync7(dir).isDirectory() && existsSync20(join17(dir, "index.html"));
+  return existsSync19(dir) && statSync7(dir).isDirectory() && existsSync19(join17(dir, "index.html"));
 }
 function resolveSpaDist() {
   const here = moduleDir3();
@@ -81408,7 +81421,7 @@ function resolveStaticDir() {
     join17(here, "..", "..", "..", "..", "web", "static")
   ];
   for (const c of candidates) {
-    if (existsSync20(c) && statSync7(c).isDirectory())
+    if (existsSync19(c) && statSync7(c).isDirectory())
       return c;
   }
   return null;
@@ -81455,11 +81468,16 @@ init_ef_meta();
 init_cli_core();
 init_config();
 init_compatibility();
+var OPENAPI_PATH = "/api/v1/openapi.json";
 function buildApp(ctx = buildWebContext()) {
   const app = new Hono2;
   if (true) {
     app.use(logger((message, ...rest) => console.log(`${localTimestamp()}  ${message}`, ...rest)));
   }
+  app.use("/api/v1/*", async (c, next) => {
+    await next();
+    c.res.headers.set("Link", `<${OPENAPI_PATH}>; rel="service-desc"`);
+  });
   app.use("/api/v1/*", apiAuth());
   app.use("/rest/v1/*", apiAuth());
   registerMetaRoutes(app, ctx);
@@ -81500,7 +81518,7 @@ function buildApp(ctx = buildWebContext()) {
     }));
     app.get("/app/assets/*", (c) => c.text("Not found", 404));
     const indexPath = join18(spaDist, "index.html");
-    if (existsSync21(indexPath)) {
+    if (existsSync20(indexPath)) {
       let cached = null;
       const readIndex = () => {
         try {