@cerefox/memory 1.0.0-beta.2 → 1.0.0-beta.4

package/dist/bin/cerefox.js

@@ -7184,7 +7184,7 @@ var exports_meta = {};
 __export(exports_meta, {
   PKG_VERSION: () => PKG_VERSION
 });
-var PKG_VERSION = "1.0.0-beta.2";
+var PKG_VERSION = "1.0.0-beta.4";
 var init_meta = () => {};
 
 // ../../node_modules/.bun/tslib@2.8.1/node_modules/tslib/tslib.js
@@ -22959,6 +22959,55 @@ var init_client = __esm(() => {
   init_cli_core();
 });
 
+// ../../_shared/server-assets/index.ts
+import { existsSync as existsSync5 } 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";
+function moduleDir() {
+  return dirname2(fileURLToPath(import.meta.url));
+}
+function bundledServerAssets(serverAssetsRoot) {
+  return {
+    schemaFile: join5(serverAssetsRoot, "db", "schema.sql"),
+    rpcsFile: join5(serverAssetsRoot, "db", "rpcs.sql"),
+    migrationsDir: join5(serverAssetsRoot, "db", "migrations"),
+    functionsDir: join5(serverAssetsRoot, "supabase", "functions"),
+    layout: "bundled"
+  };
+}
+function sourceServerAssets(repoRoot) {
+  const dbDir = join5(repoRoot, "src", "cerefox", "db");
+  return {
+    schemaFile: join5(dbDir, "schema.sql"),
+    rpcsFile: join5(dbDir, "rpcs.sql"),
+    migrationsDir: join5(dbDir, "migrations"),
+    functionsDir: join5(repoRoot, "supabase", "functions"),
+    layout: "source"
+  };
+}
+function serverAssetsUsable(p) {
+  return existsSync5(p.schemaFile) && existsSync5(p.rpcsFile);
+}
+function resolveServerAssets(opts = {}) {
+  if (opts.assetsDir) {
+    return { ...bundledServerAssets(opts.assetsDir), layout: "explicit" };
+  }
+  const here = opts.moduleDirOverride ?? moduleDir();
+  const cwd = opts.cwd ?? processCwd2();
+  const candidates = [
+    bundledServerAssets(join5(here, "..", "server-assets")),
+    sourceServerAssets(join5(here, "..", "..")),
+    sourceServerAssets(cwd)
+  ];
+  for (const candidate of candidates) {
+    if (serverAssetsUsable(candidate))
+      return candidate;
+  }
+  return sourceServerAssets(join5(here, "..", ".."));
+}
+var init_server_assets = () => {};
+
 // ../../node_modules/.bun/postgres@3.4.9/node_modules/postgres/src/query.js
 function cachedError(xs) {
   if (originCache.has(xs))
@@ -25193,127 +25242,296 @@ var init_bundled_docs = __esm(() => {
   PACKAGE_ROOT = findPackageRoot();
 });
 
-// ../../_shared/ingest/chunker.ts
-function cpLen(s) {
-  let n = 0;
-  for (const _ of s)
-    n++;
-  return n;
+// ../../_shared/compatibility/index.ts
+function compareSemver(a, b2) {
+  const norm = (v) => v.split(/[.-]/).slice(0, 3).map((p) => Number.parseInt(p, 10)).map((n) => Number.isFinite(n) ? n : 0);
+  const pa = norm(a);
+  const pb = norm(b2);
+  for (let i = 0;i < 3; i++) {
+    const x = pa[i] ?? 0;
+    const y = pb[i] ?? 0;
+    if (x !== y)
+      return x < y ? -1 : 1;
+  }
+  return 0;
 }
-function rstripHash(s) {
-  let i = s.length;
-  while (i > 0 && s[i - 1] === "#")
-    i--;
-  return s.slice(0, i);
+function classifyCompat(deployed, min, bundled) {
+  if (!deployed)
+    return "unknown";
+  if (compareSemver(deployed, min) < 0)
+    return "below-min";
+  if (bundled && compareSemver(deployed, bundled) < 0)
+    return "above-min-but-old";
+  return "ok";
 }
-function findHeadings(doc) {
-  const out = [];
-  const re = /^(#{1,3})[ \t]+(.+)$/gm;
-  let m;
-  while ((m = re.exec(doc)) !== null) {
-    out.push({ offset: m.index, level: m[1].length, text: rstripHash(m[2]).trim() });
-  }
-  return out;
+function aggregatorUrlFor(supabaseUrl) {
+  const base = supabaseUrl.replace(/\/$/, "");
+  return `${base}/functions/v1/cerefox-mcp/version?peers=true`;
 }
-function activeHeadings(headings, offset) {
-  const stack = [];
-  for (const h of headings) {
-    if (h.offset > offset)
-      break;
-    while (stack.length && stack[stack.length - 1].level >= h.level)
-      stack.pop();
-    stack.push(h);
+async function checkServerCompatibility(opts) {
+  const fetchImpl = opts.fetchImpl ?? fetch;
+  const result = {
+    schema: { deployed: null, min: COMPATIBILITY.minSchema, level: "unknown" },
+    edgeFunctions: {
+      deployed: null,
+      min: COMPATIBILITY.minEdgeFunctions,
+      level: "unknown",
+      errors: []
+    },
+    blocking: false,
+    efProbeSkipped: false
+  };
+  if (!opts.bearer) {
+    result.efProbeSkipped = true;
+    result.efSkipReason = "No CEREFOX_ACCESS_TOKEN configured; Edge Function version check skipped.";
+    return result;
   }
-  return stack;
-}
-function hardSplitCp(s, maxCp) {
-  const out = [];
-  let buf = "";
-  let n = 0;
-  for (const ch of s) {
-    if (n >= maxCp) {
-      out.push(buf);
-      buf = "";
-      n = 0;
+  let agg = null;
+  try {
+    const ctrl = new AbortController;
+    const timer2 = setTimeout(() => ctrl.abort(), opts.timeoutMs ?? 6000);
+    try {
+      const resp = await fetchImpl(opts.aggregatorUrl, {
+        method: "GET",
+        headers: { Authorization: `Bearer ${opts.bearer}`, apikey: opts.bearer },
+        signal: ctrl.signal
+      });
+      if (resp.ok) {
+        agg = await resp.json();
+      } else {
+        result.efProbeSkipped = true;
+        result.efSkipReason = resp.status === 404 || resp.status === 405 ? "Edge Functions predate v0.8 (no /version route). Redeploy with `cerefox server deploy --functions-only` to enable version checks." : `Aggregator returned HTTP ${resp.status}; Edge Function version check skipped.`;
+      }
+    } finally {
+      clearTimeout(timer2);
     }
-    buf += ch;
-    n++;
+  } catch (err) {
+    result.efProbeSkipped = true;
+    result.efSkipReason = `Could not reach the version aggregator: ${err instanceof Error ? err.message : String(err)}`;
   }
-  if (buf)
-    out.push(buf);
+  if (!agg)
+    return result;
+  result.schema.deployed = agg.schema ?? null;
+  result.schema.level = classifyCompat(result.schema.deployed, COMPATIBILITY.minSchema, opts.bundledSchema);
+  const versions = [];
+  if (agg.version)
+    versions.push(agg.version);
+  for (const ef of agg.efs ?? [])
+    versions.push(ef.version);
+  result.edgeFunctions.errors = agg.errors ?? [];
+  if (versions.length > 0) {
+    const weakest = versions.reduce((lo, v) => compareSemver(v, lo) < 0 ? v : lo);
+    result.edgeFunctions.deployed = weakest;
+    result.edgeFunctions.level = classifyCompat(weakest, COMPATIBILITY.minEdgeFunctions, opts.bundledEf);
+  } else {
+    result.edgeFunctions.level = "unknown";
+    result.efProbeSkipped = true;
+    result.efSkipReason = "Aggregator reported no Edge Function versions; check skipped.";
+  }
+  result.blocking = result.schema.level === "below-min" || result.edgeFunctions.level === "below-min";
+  return result;
+}
+var COMPATIBILITY;
+var init_compatibility = __esm(() => {
+  COMPATIBILITY = {
+    minSchema: "0.3.1",
+    minEdgeFunctions: "0.6.0"
+  };
+});
+
+// ../../_shared/embeddings/onnx-embedder.ts
+var exports_onnx_embedder = {};
+__export(exports_onnx_embedder, {
+  warmup: () => warmup,
+  onnxEmbed: () => onnxEmbed,
+  nomicPrefix: () => nomicPrefix,
+  buildPrefixedInputs: () => buildPrefixedInputs,
+  ONNX_MODEL_NAME: () => ONNX_MODEL_NAME,
+  ONNX_MODEL_ID: () => ONNX_MODEL_ID,
+  ONNX_MODEL_DTYPE: () => ONNX_MODEL_DTYPE,
+  ONNX_MODEL_DIM: () => ONNX_MODEL_DIM,
+  ONNX_MODEL_APPROX_MB: () => ONNX_MODEL_APPROX_MB
+});
+import { existsSync as existsSync9, mkdirSync as mkdirSync3 } from "node:fs";
+import { homedir as homedir5 } from "node:os";
+import { join as join8 } from "node:path";
+function nomicPrefix(role) {
+  return role === "query" ? "search_query: " : "search_document: ";
+}
+function buildPrefixedInputs(texts, role) {
+  const p = nomicPrefix(role);
+  return texts.map((t) => p + t);
+}
+function getCacheDir() {
+  const env4 = globalThis.process?.env ?? {};
+  if (env4.CEREFOX_MODELS_DIR)
+    return env4.CEREFOX_MODELS_DIR;
+  return join8(homedir5(), ".cerefox", "models");
+}
+async function loadTransformers() {
+  if (transformersModule)
+    return transformersModule;
+  const spec = "@huggingface/transformers";
+  transformersModule = await import(spec);
+  const dir = getCacheDir();
+  if (!existsSync9(dir))
+    mkdirSync3(dir, { recursive: true });
+  transformersModule.env.cacheDir = dir;
+  transformersModule.env.allowLocalModels = true;
+  transformersModule.env.allowRemoteModels = true;
+  return transformersModule;
+}
+function makeBar(pct, width = 20) {
+  const clamped = Math.max(0, Math.min(100, pct));
+  const filled = Math.round(clamped / 100 * width);
+  return `[${"█".repeat(filled)}${"░".repeat(width - filled)}]`;
+}
+function l2Normalise(v) {
+  let sum = 0;
+  for (let i = 0;i < v.length; i++)
+    sum += v[i] * v[i];
+  const norm = Math.sqrt(sum);
+  if (norm === 0)
+    return v;
+  const out = new Float32Array(v.length);
+  for (let i = 0;i < v.length; i++)
+    out[i] = v[i] / norm;
   return out;
 }
-function chunkMarkdown(text, maxChunkChars = 4000, _minChunkChars = 100) {
-  const doc = text.trim();
-  if (!doc)
+async function ensurePipeline() {
+  if (pipelinePromise)
+    return pipelinePromise;
+  pipelinePromise = (async () => {
+    const transformers = await loadTransformers();
+    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)…
+`);
+    const progressState = new Map;
+    let activeFile = null;
+    const isTty = !!process.stderr.isTTY;
+    const RENDER_INTERVAL_MS = 250;
+    const fmtMb = (n) => (n / 1024 / 1024).toFixed(1);
+    const renderInPlace = (line) => {
+      if (isTty)
+        process.stderr.write(`\r\x1B[K${line}`);
+      else
+        process.stderr.write(`${line}
+`);
+    };
+    const finalizeLine = () => {
+      if (isTty && activeFile !== null)
+        process.stderr.write(`
+`);
+      activeFile = null;
+    };
+    const progressCallback = (info3) => {
+      const file = info3.file ?? info3.name ?? "(unknown)";
+      const now = Date.now();
+      if (info3.status === "progress") {
+        const total = info3.total ?? 0;
+        const loaded = info3.loaded ?? 0;
+        if (total === 0 && loaded === 0)
+          return;
+        const prior = progressState.get(file) ?? {
+          loaded: 0,
+          total: 0,
+          done: false,
+          indeterminate: false,
+          lastRenderAt: 0,
+          lastRenderedPct: -1
+        };
+        const indeterminate = prior.indeterminate || prior.total > 0 && total > prior.total;
+        const next = {
+          loaded,
+          total,
+          done: false,
+          indeterminate,
+          lastRenderAt: prior.lastRenderAt,
+          lastRenderedPct: prior.lastRenderedPct
+        };
+        if (activeFile !== file) {
+          finalizeLine();
+          activeFile = file;
+        }
+        if (indeterminate) {
+          if (now - prior.lastRenderAt >= RENDER_INTERVAL_MS) {
+            renderInPlace(`[cerefox-embed] [streaming...]  ${fmtMb(loaded)} MB  ${file}`);
+            next.lastRenderAt = now;
+          }
+        } else if (total > 0) {
+          const pct = Math.floor(loaded / total * 100);
+          const stepBumped = pct >= prior.lastRenderedPct + 5;
+          const timeBumped = isTty && now - prior.lastRenderAt >= RENDER_INTERVAL_MS && pct !== prior.lastRenderedPct;
+          if (stepBumped || timeBumped) {
+            renderInPlace(`[cerefox-embed] ${makeBar(pct)} ${pct.toString().padStart(3)}%  ${fmtMb(loaded)}/${fmtMb(total)} MB  ${file}`);
+            next.lastRenderedPct = pct;
+            next.lastRenderAt = now;
+          }
+        }
+        progressState.set(file, next);
+      } else if (info3.status === "done") {
+        const prior = progressState.get(file);
+        finalizeLine();
+        const finalSize = prior && prior.loaded > 0 ? `${fmtMb(prior.loaded)} MB` : info3.total && info3.total > 0 ? `${fmtMb(info3.total)} MB` : "cached";
+        process.stderr.write(`[cerefox-embed] ✓ ${file}  (${finalSize})
+`);
+        if (prior)
+          progressState.set(file, { ...prior, done: true });
+      }
+    };
+    const pipe = await transformers.pipeline("feature-extraction", ONNX_MODEL_ID, {
+      dtype: ONNX_MODEL_DTYPE,
+      progress_callback: progressCallback
+    });
+    process.stderr.write(`[cerefox-embed] embedder ready.
+`);
+    return pipe;
+  })();
+  pipelinePromise.catch(() => {
+    pipelinePromise = null;
+  });
+  return pipelinePromise;
+}
+async function warmup() {
+  await ensurePipeline();
+}
+async function onnxEmbed(texts, role) {
+  if (texts.length === 0)
     return [];
-  if (cpLen(doc) <= maxChunkChars) {
-    return [
-      { chunk_index: 0, heading_path: [], heading_level: 0, title: "", content: doc, char_count: cpLen(doc) }
-    ];
+  const pipeline = await ensurePipeline();
+  const inputs = buildPrefixedInputs(texts, role);
+  const out = await pipeline(inputs, { pooling: "mean", normalize: true });
+  const dim2 = out.dims[out.dims.length - 1];
+  if (dim2 !== ONNX_MODEL_DIM) {
+    throw new Error(`OnnxEmbedder: expected dim=${ONNX_MODEL_DIM} (schema vector(768)), got ${dim2} from model`);
   }
-  const headings = findHeadings(doc);
-  const parts = doc.split(/(\n{2,})/);
-  const atoms = [];
-  for (let i = 0;i < parts.length; i += 2) {
-    const unit = (parts[i] ?? "") + (parts[i + 1] ?? "");
-    if (unit === "")
-      continue;
-    if (cpLen(unit) > maxChunkChars)
-      atoms.push(...hardSplitCp(unit, maxChunkChars));
-    else
-      atoms.push(unit);
+  const vectors = [];
+  for (let i = 0;i < inputs.length; i++) {
+    const slice = out.data.slice(i * dim2, (i + 1) * dim2);
+    vectors.push(Array.from(l2Normalise(slice)));
   }
-  const chunks = [];
-  let buf = "";
-  let bufCp = 0;
-  let bufStart = 0;
-  let offset = 0;
-  const flush = () => {
-    if (buf === "")
-      return;
-    const stack = activeHeadings(headings, bufStart);
-    chunks.push({
-      chunk_index: chunks.length,
-      heading_path: stack.map((h) => h.text),
-      heading_level: stack.length ? stack[stack.length - 1].level : 0,
-      title: stack.length ? stack[stack.length - 1].text : "",
-      content: buf,
-      char_count: bufCp
-    });
-    buf = "";
-    bufCp = 0;
-  };
-  for (const atom of atoms) {
-    const cp = cpLen(atom);
-    if (buf === "") {
-      bufStart = offset;
-      buf = atom;
-      bufCp = cp;
-    } else if (bufCp + cp <= maxChunkChars) {
-      buf += atom;
-      bufCp += cp;
-    } else {
-      flush();
-      bufStart = offset;
-      buf = atom;
-      bufCp = cp;
-    }
-    offset += atom.length;
-  }
-  flush();
-  return chunks;
-}
-function embeddingInputFor(docTitle, chunk) {
-  const breadcrumb = chunk.heading_path.join(" > ");
-  const head2 = breadcrumb ? `# ${docTitle}
-${breadcrumb}` : `# ${docTitle}`;
-  return `${head2}
-${chunk.content}`;
+  return vectors;
 }
-var CONTENT_FORMAT_BLIND_STITCH = 2;
+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;
+var init_onnx_embedder = () => {};
 
 // ../../_shared/embeddings/index.ts
+var exports_embeddings = {};
+__export(exports_embeddings, {
+  resolveEmbedderKind: () => resolveEmbedderKind,
+  openaiEmbeddingConfig: () => openaiEmbeddingConfig,
+  getEmbedding: () => getEmbedding,
+  embeddingMaxInputChars: () => embeddingMaxInputChars,
+  embedBatch: () => embedBatch,
+  capEmbeddingInput: () => capEmbeddingInput,
+  activeEmbedderName: () => activeEmbedderName,
+  OPENAI_MODEL: () => OPENAI_MODEL,
+  OPENAI_EMBEDDING_URL: () => OPENAI_EMBEDDING_URL,
+  EMBEDDING_DIMENSIONS: () => EMBEDDING_DIMENSIONS,
+  EMBEDDING_BATCH_SIZE: () => EMBEDDING_BATCH_SIZE,
+  DEFAULT_EMBED_MAX_INPUT_CHARS: () => DEFAULT_EMBED_MAX_INPUT_CHARS
+});
 function openaiEmbeddingConfig() {
   const env4 = globalThis.process?.env ?? {};
   const base = env4.CEREFOX_OPENAI_BASE_URL?.replace(/\/+$/, "");
@@ -25340,7 +25558,22 @@ function capEmbeddingInput(text) {
   console.warn(`[embeddings] truncated an embedding input: ${text.length} → ${cut.length} chars ` + `(cap CEREFOX_EMBED_MAX_INPUT_CHARS=${max}). The full content is stored and reconstructed ` + `untouched; only this chunk's embedding uses the prefix (degraded search for this chunk).`);
   return cut;
 }
+function resolveEmbedderKind() {
+  const env4 = globalThis.process?.env ?? {};
+  return env4.CEREFOX_EMBEDDER === "local" ? "local" : "openai";
+}
+function activeEmbedderName() {
+  return resolveEmbedderKind() === "local" ? "nomic-embed-text-v1.5" : openaiEmbeddingConfig().model;
+}
+async function onnxModule() {
+  return await Promise.resolve().then(() => (init_onnx_embedder(), exports_onnx_embedder));
+}
 async function getEmbedding(text, apiKey) {
+  if (resolveEmbedderKind() === "local") {
+    const onnx = await onnxModule();
+    const [vec] = await onnx.onnxEmbed([capEmbeddingInput(text)], "query");
+    return vec;
+  }
   let lastError = null;
   const cfg = openaiEmbeddingConfig();
   const input = capEmbeddingInput(text);
@@ -25432,6 +25665,10 @@ async function embedBatchSingleCall(texts, apiKey) {
 async function embedBatch(texts, apiKey, batchSize = EMBEDDING_BATCH_SIZE) {
   if (texts.length === 0)
     return [];
+  if (resolveEmbedderKind() === "local") {
+    const onnx = await onnxModule();
+    return onnx.onnxEmbed(texts.map(capEmbeddingInput), "document");
+  }
   if (texts.length <= batchSize) {
     return embedBatchSingleCall(texts, apiKey);
   }
@@ -25446,6 +25683,126 @@ async function embedBatch(texts, apiKey, batchSize = EMBEDDING_BATCH_SIZE) {
 }
 var OPENAI_EMBEDDING_URL = "https://api.openai.com/v1/embeddings", OPENAI_MODEL = "text-embedding-3-small", EMBEDDING_DIMENSIONS = 768, DEFAULT_EMBED_MAX_INPUT_CHARS = 20000, EMBEDDING_MAX_RETRIES = 3, EMBEDDING_INITIAL_BACKOFF_MS = 500, EMBEDDING_BATCH_SIZE = 96;
 
+// ../../_shared/ingest/chunker.ts
+function cpLen(s) {
+  let n = 0;
+  for (const _ of s)
+    n++;
+  return n;
+}
+function rstripHash(s) {
+  let i = s.length;
+  while (i > 0 && s[i - 1] === "#")
+    i--;
+  return s.slice(0, i);
+}
+function findHeadings(doc) {
+  const out = [];
+  const re = /^(#{1,3})[ \t]+(.+)$/gm;
+  let m;
+  while ((m = re.exec(doc)) !== null) {
+    out.push({ offset: m.index, level: m[1].length, text: rstripHash(m[2]).trim() });
+  }
+  return out;
+}
+function activeHeadings(headings, offset) {
+  const stack = [];
+  for (const h of headings) {
+    if (h.offset > offset)
+      break;
+    while (stack.length && stack[stack.length - 1].level >= h.level)
+      stack.pop();
+    stack.push(h);
+  }
+  return stack;
+}
+function hardSplitCp(s, maxCp) {
+  const out = [];
+  let buf = "";
+  let n = 0;
+  for (const ch of s) {
+    if (n >= maxCp) {
+      out.push(buf);
+      buf = "";
+      n = 0;
+    }
+    buf += ch;
+    n++;
+  }
+  if (buf)
+    out.push(buf);
+  return out;
+}
+function chunkMarkdown(text, maxChunkChars = 4000, _minChunkChars = 100) {
+  const doc = text.trim();
+  if (!doc)
+    return [];
+  if (cpLen(doc) <= maxChunkChars) {
+    return [
+      { chunk_index: 0, heading_path: [], heading_level: 0, title: "", content: doc, char_count: cpLen(doc) }
+    ];
+  }
+  const headings = findHeadings(doc);
+  const parts = doc.split(/(\n{2,})/);
+  const atoms = [];
+  for (let i = 0;i < parts.length; i += 2) {
+    const unit = (parts[i] ?? "") + (parts[i + 1] ?? "");
+    if (unit === "")
+      continue;
+    if (cpLen(unit) > maxChunkChars)
+      atoms.push(...hardSplitCp(unit, maxChunkChars));
+    else
+      atoms.push(unit);
+  }
+  const chunks = [];
+  let buf = "";
+  let bufCp = 0;
+  let bufStart = 0;
+  let offset = 0;
+  const flush = () => {
+    if (buf === "")
+      return;
+    const stack = activeHeadings(headings, bufStart);
+    chunks.push({
+      chunk_index: chunks.length,
+      heading_path: stack.map((h) => h.text),
+      heading_level: stack.length ? stack[stack.length - 1].level : 0,
+      title: stack.length ? stack[stack.length - 1].text : "",
+      content: buf,
+      char_count: bufCp
+    });
+    buf = "";
+    bufCp = 0;
+  };
+  for (const atom of atoms) {
+    const cp = cpLen(atom);
+    if (buf === "") {
+      bufStart = offset;
+      buf = atom;
+      bufCp = cp;
+    } else if (bufCp + cp <= maxChunkChars) {
+      buf += atom;
+      bufCp += cp;
+    } else {
+      flush();
+      bufStart = offset;
+      buf = atom;
+      bufCp = cp;
+    }
+    offset += atom.length;
+  }
+  flush();
+  return chunks;
+}
+function embeddingInputFor(docTitle, chunk) {
+  const breadcrumb = chunk.heading_path.join(" > ");
+  const head2 = breadcrumb ? `# ${docTitle}
+${breadcrumb}` : `# ${docTitle}`;
+  return `${head2}
+${chunk.content}`;
+}
+var CONTENT_FORMAT_BLIND_STITCH = 2;
+
 // ../../node_modules/.bun/underscore@1.13.8/node_modules/underscore/underscore-node-f.cjs
 var require_underscore_node_f = __commonJS((exports) => {
   Object.defineProperty(exports, "__esModule", { value: true });
@@ -32746,7 +33103,7 @@ var require_BufferList = __commonJS((exports, module) => {
       this.head = this.tail = null;
       this.length = 0;
     };
-    BufferList.prototype.join = function join9(s) {
+    BufferList.prototype.join = function join10(s) {
       if (this.length === 0)
         return "";
       var p = this.head;
@@ -54469,6 +54826,9 @@ async function handler4(supabase, args, ctx) {
   const project_names_raw = args.project_names;
   const source = args.source ?? "agent";
   const metadata = args.metadata ?? null;
+  if (metadata !== null && (typeof metadata !== "object" || Array.isArray(metadata))) {
+    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 author = args.author ?? "mcp-agent";
   const author_type = "agent";
@@ -54481,7 +54841,7 @@ async function handler4(supabase, args, ctx) {
     throw new McpInvalidParams("project_names must be a JSON array of strings; for a single project use project_name (string)");
   }
   const project_names = Array.isArray(project_names_raw) ? project_names_raw.filter((s) => typeof s === "string" && s.length > 0) : null;
-  if (!ctx.openaiApiKey) {
+  if (!ctx.openaiApiKey && resolveEmbedderKind() !== "local") {
     throw new Error("OpenAI API key not configured. Set OPENAI_API_KEY (Edge Function) or CEREFOX_OPENAI_API_KEY (.env, local).");
   }
   const contentHash2 = await sha256hex(normalizeContent(content));
@@ -54503,7 +54863,7 @@ async function handler4(supabase, args, ctx) {
     if (chunks2.length === 0)
       throw new Error("Content produced no chunks");
     const texts2 = chunks2.map((c2) => embeddingInputFor(title, c2));
-    const embeddings2 = await embedBatch(texts2, ctx.openaiApiKey);
+    const embeddings2 = await embedBatch(texts2, ctx.openaiApiKey ?? "");
     const totalChars2 = chunks2.reduce((s, c2) => s + c2.char_count, 0);
     const chunkData2 = chunks2.map((chunk, i) => ({
       chunk_index: i,
@@ -54513,7 +54873,7 @@ async function handler4(supabase, args, ctx) {
       content: chunk.content,
       char_count: chunk.char_count,
       embedding: embeddings2[i],
-      embedder: OPENAI_MODEL
+      embedder: activeEmbedderName()
     }));
     const { error: ingestErr2 } = await supabase.rpc("cerefox_ingest_document", {
       p_document_id: existingDoc.id,
@@ -54561,7 +54921,7 @@ async function handler4(supabase, args, ctx) {
       if (chunks2.length === 0)
         throw new Error("Content produced no chunks");
       const texts2 = chunks2.map((c2) => embeddingInputFor(title, c2));
-      const embeddings2 = await embedBatch(texts2, ctx.openaiApiKey);
+      const embeddings2 = await embedBatch(texts2, ctx.openaiApiKey ?? "");
       const totalChars2 = chunks2.reduce((s, c2) => s + c2.char_count, 0);
       const chunkData2 = chunks2.map((chunk, i) => ({
         chunk_index: i,
@@ -54571,7 +54931,7 @@ async function handler4(supabase, args, ctx) {
         content: chunk.content,
         char_count: chunk.char_count,
         embedding: embeddings2[i],
-        embedder: OPENAI_MODEL
+        embedder: activeEmbedderName()
       }));
       const { error: ingestErr2 } = await supabase.rpc("cerefox_ingest_document", {
         p_document_id: existingDoc.id,
@@ -54613,7 +54973,7 @@ async function handler4(supabase, args, ctx) {
   if (chunks.length === 0)
     throw new Error("Content produced no chunks");
   const texts = chunks.map((c2) => embeddingInputFor(title, c2));
-  const embeddings = await embedBatch(texts, ctx.openaiApiKey);
+  const embeddings = await embedBatch(texts, ctx.openaiApiKey ?? "");
   const totalChars = chunks.reduce((s, c2) => s + c2.char_count, 0);
   const chunkData = chunks.map((chunk, i) => ({
     chunk_index: i,
@@ -54623,7 +54983,7 @@ async function handler4(supabase, args, ctx) {
     content: chunk.content,
     char_count: chunk.char_count,
     embedding: embeddings[i],
-    embedder: OPENAI_MODEL
+    embedder: activeEmbedderName()
   }));
   const { data: ingestResult, error: ingestErr } = await supabase.rpc("cerefox_ingest_document", {
     p_document_id: null,
@@ -54960,7 +55320,7 @@ async function handler9(supabase, args, ctx) {
   }
   if (!query?.trim())
     throw new McpInvalidParams("query is required");
-  if (mode !== "fts" && !ctx.openaiApiKey) {
+  if (mode !== "fts" && !ctx.openaiApiKey && resolveEmbedderKind() !== "local") {
     throw new Error("OpenAI API key not configured. Set OPENAI_API_KEY (Edge Function) or CEREFOX_OPENAI_API_KEY (.env, local).");
   }
   let projectId = null;
@@ -54971,7 +55331,7 @@ async function handler9(supabase, args, ctx) {
   }
   let embedding = null;
   if (mode !== "fts") {
-    embedding = await getEmbedding(query, ctx.openaiApiKey);
+    embedding = await getEmbedding(query, ctx.openaiApiKey ?? "");
   }
   const metaFilterParam = metadata_filter && Object.keys(metadata_filter).length > 0 ? { p_metadata_filter: metadata_filter } : {};
   let rpcName;
@@ -68266,6 +68626,7 @@ var exports_server = {};
 __export(exports_server, {
   buildServer: () => buildServer
 });
+import { existsSync as existsSync12, readFileSync as readFileSync12 } from "node:fs";
 function buildServer() {
   const settings = loadSettings();
   if (!settings.supabaseUrl || !settings.supabaseKey) {
@@ -68314,21 +68675,36 @@ async function warnIfSchemaVersionMismatch(supabase) {
   try {
     const { data } = await supabase.rpc("cerefox_schema_version");
     const deployed = typeof data === "string" ? data : null;
-    if (deployed && deployed !== PKG_VERSION) {
-      process.stderr.write(`[cerefox-mcp] ⚠  schema version mismatch: bundled ${PKG_VERSION}, ` + `deployed ${deployed}. Run \`uv run python scripts/db_deploy.py\` ` + `to update the database. Tools may behave unexpectedly until then.
+    if (!deployed)
+      return;
+    let bundled = null;
+    try {
+      const assets = resolveServerAssets();
+      if (existsSync12(assets.schemaFile)) {
+        const m = readFileSync12(assets.schemaFile, "utf8").match(SCHEMA_VERSION_RE2);
+        bundled = m ? m[1] : null;
+      }
+    } catch {}
+    if (!bundled)
+      return;
+    if (compareSemver(deployed, bundled) < 0) {
+      process.stderr.write(`[cerefox-mcp] ⚠  schema version mismatch: this client bundles v${bundled} ` + `but the deployed schema is v${deployed}. Run \`cerefox server deploy\` ` + `to update it. Tools may behave unexpectedly until then.
 `);
     }
   } catch {}
 }
-var SERVER_NAME = "cerefox";
+var SERVER_NAME = "cerefox", SCHEMA_VERSION_RE2;
 var init_server3 = __esm(() => {
   init_server2();
   init_stdio2();
   init_types4();
   init_dist4();
+  init_compatibility();
   init_config();
+  init_server_assets();
   init_mcp_tools();
   init_meta();
+  SCHEMA_VERSION_RE2 = /^--\s*@version:\s*(\S+)/m;
 });
 
 // src/bin/cerefox.ts
@@ -68414,8 +68790,8 @@ async function action(options) {
   println(c.green("✓ ") + `Backup written: ${dest}`);
   println(c.dim(`  documents: ${docs.length} · chunks: ${chunkTotal}`));
   if (options.git) {
-    println(c.yellow("⚠ ") + "--git commit option not yet ported to the TS CLI.");
-    println(c.dim("  For git-aware backups, run `uv run cerefox backup --git` from a clone."));
+    println(c.yellow("⚠ ") + "--git commit is not implemented; the snapshot was written without a git checkpoint.");
+    println(c.dim("  Commit the backup directory yourself if you want it version-controlled."));
   }
 }
 function registerBackup(program2) {
@@ -70166,58 +70542,11 @@ function registerDeleteProject(program2) {
 // src/cli/commands/deploy-server.ts
 init_cli_core();
 init_config();
+init_server_assets();
 import { spawnSync as spawnSync2 } from "node:child_process";
 import { existsSync as existsSync7 } from "node:fs";
 import { readdirSync as readdirSync2 } from "node:fs";
 
-// ../../_shared/server-assets/index.ts
-import { existsSync as existsSync5 } 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";
-function moduleDir() {
-  return dirname2(fileURLToPath(import.meta.url));
-}
-function bundledServerAssets(serverAssetsRoot) {
-  return {
-    schemaFile: join5(serverAssetsRoot, "db", "schema.sql"),
-    rpcsFile: join5(serverAssetsRoot, "db", "rpcs.sql"),
-    migrationsDir: join5(serverAssetsRoot, "db", "migrations"),
-    functionsDir: join5(serverAssetsRoot, "supabase", "functions"),
-    layout: "bundled"
-  };
-}
-function sourceServerAssets(repoRoot) {
-  const dbDir = join5(repoRoot, "src", "cerefox", "db");
-  return {
-    schemaFile: join5(dbDir, "schema.sql"),
-    rpcsFile: join5(dbDir, "rpcs.sql"),
-    migrationsDir: join5(dbDir, "migrations"),
-    functionsDir: join5(repoRoot, "supabase", "functions"),
-    layout: "source"
-  };
-}
-function serverAssetsUsable(p) {
-  return existsSync5(p.schemaFile) && existsSync5(p.rpcsFile);
-}
-function resolveServerAssets(opts = {}) {
-  if (opts.assetsDir) {
-    return { ...bundledServerAssets(opts.assetsDir), layout: "explicit" };
-  }
-  const here = opts.moduleDirOverride ?? moduleDir();
-  const cwd = opts.cwd ?? processCwd2();
-  const candidates = [
-    bundledServerAssets(join5(here, "..", "server-assets")),
-    sourceServerAssets(join5(here, "..", "..")),
-    sourceServerAssets(cwd)
-  ];
-  for (const candidate of candidates) {
-    if (serverAssetsUsable(candidate))
-      return candidate;
-  }
-  return sourceServerAssets(join5(here, "..", ".."));
-}
-
 // ../../_shared/db-deploy/index.ts
 init_src();
 import { existsSync as existsSync6, readFileSync as readFileSync5, readdirSync } from "node:fs";
@@ -74276,112 +74605,18 @@ init_cli_core();
 
 // src/cli/util/checks.ts
 init_meta();
-import { existsSync as existsSync9, readFileSync as readFileSync7, realpathSync, statSync as statSync2 } from "node:fs";
-import { homedir as homedir5 } from "node:os";
-import { join as join8 } from "node:path";
+import { existsSync as existsSync10, readFileSync as readFileSync7, realpathSync, statSync as statSync2 } from "node:fs";
+import { homedir as homedir6 } from "node:os";
+import { join as join9 } from "node:path";
 
 // ../../_shared/ef-meta/index.ts
-var EF_VERSION = "1.0.0-beta.2";
+var EF_VERSION = "1.0.0-beta.4";
 
 // src/cli/util/checks.ts
 init_config();
 init_config();
-
-// ../../_shared/compatibility/index.ts
-var COMPATIBILITY = {
-  minSchema: "0.3.1",
-  minEdgeFunctions: "0.6.0"
-};
-function compareSemver(a, b2) {
-  const norm = (v) => v.split(/[.-]/).slice(0, 3).map((p) => Number.parseInt(p, 10)).map((n) => Number.isFinite(n) ? n : 0);
-  const pa = norm(a);
-  const pb = norm(b2);
-  for (let i = 0;i < 3; i++) {
-    const x = pa[i] ?? 0;
-    const y = pb[i] ?? 0;
-    if (x !== y)
-      return x < y ? -1 : 1;
-  }
-  return 0;
-}
-function classifyCompat(deployed, min, bundled) {
-  if (!deployed)
-    return "unknown";
-  if (compareSemver(deployed, min) < 0)
-    return "below-min";
-  if (bundled && compareSemver(deployed, bundled) < 0)
-    return "above-min-but-old";
-  return "ok";
-}
-function aggregatorUrlFor(supabaseUrl) {
-  const base = supabaseUrl.replace(/\/$/, "");
-  return `${base}/functions/v1/cerefox-mcp/version?peers=true`;
-}
-async function checkServerCompatibility(opts) {
-  const fetchImpl = opts.fetchImpl ?? fetch;
-  const result = {
-    schema: { deployed: null, min: COMPATIBILITY.minSchema, level: "unknown" },
-    edgeFunctions: {
-      deployed: null,
-      min: COMPATIBILITY.minEdgeFunctions,
-      level: "unknown",
-      errors: []
-    },
-    blocking: false,
-    efProbeSkipped: false
-  };
-  if (!opts.bearer) {
-    result.efProbeSkipped = true;
-    result.efSkipReason = "No CEREFOX_ACCESS_TOKEN configured; Edge Function version check skipped.";
-    return result;
-  }
-  let agg = null;
-  try {
-    const ctrl = new AbortController;
-    const timer2 = setTimeout(() => ctrl.abort(), opts.timeoutMs ?? 6000);
-    try {
-      const resp = await fetchImpl(opts.aggregatorUrl, {
-        method: "GET",
-        headers: { Authorization: `Bearer ${opts.bearer}`, apikey: opts.bearer },
-        signal: ctrl.signal
-      });
-      if (resp.ok) {
-        agg = await resp.json();
-      } else {
-        result.efProbeSkipped = true;
-        result.efSkipReason = resp.status === 404 || resp.status === 405 ? "Edge Functions predate v0.8 (no /version route). Redeploy with `cerefox server deploy --functions-only` to enable version checks." : `Aggregator returned HTTP ${resp.status}; Edge Function version check skipped.`;
-      }
-    } finally {
-      clearTimeout(timer2);
-    }
-  } catch (err) {
-    result.efProbeSkipped = true;
-    result.efSkipReason = `Could not reach the version aggregator: ${err instanceof Error ? err.message : String(err)}`;
-  }
-  if (!agg)
-    return result;
-  result.schema.deployed = agg.schema ?? null;
-  result.schema.level = classifyCompat(result.schema.deployed, COMPATIBILITY.minSchema, opts.bundledSchema);
-  const versions = [];
-  if (agg.version)
-    versions.push(agg.version);
-  for (const ef of agg.efs ?? [])
-    versions.push(ef.version);
-  result.edgeFunctions.errors = agg.errors ?? [];
-  if (versions.length > 0) {
-    const weakest = versions.reduce((lo, v) => compareSemver(v, lo) < 0 ? v : lo);
-    result.edgeFunctions.deployed = weakest;
-    result.edgeFunctions.level = classifyCompat(weakest, COMPATIBILITY.minEdgeFunctions, opts.bundledEf);
-  } else {
-    result.edgeFunctions.level = "unknown";
-    result.efProbeSkipped = true;
-    result.efSkipReason = "Aggregator reported no Edge Function versions; check skipped.";
-  }
-  result.blocking = result.schema.level === "below-min" || result.edgeFunctions.level === "below-min";
-  return result;
-}
-
-// src/cli/util/checks.ts
+init_compatibility();
+init_server_assets();
 function checkBinary() {
   return {
     name: "binary",
@@ -74432,7 +74667,7 @@ function checkConfig() {
       hint: "Run `cerefox init` to bootstrap."
     };
   }
-  if (!existsSync9(envPath)) {
+  if (!existsSync10(envPath)) {
     return {
       name: "config",
       status: "error",
@@ -74514,6 +74749,14 @@ async function checkSupabase() {
 async function checkOpenAI() {
   const settings = loadSettings();
   if (!settings.openaiApiKey) {
+    const { resolveEmbedderKind: resolveEmbedderKind2 } = await Promise.resolve().then(() => exports_embeddings);
+    if (resolveEmbedderKind2() === "local") {
+      return {
+        name: "openai",
+        status: "skipped",
+        detail: "no key set — not needed (local embedder active; see the embedder check)."
+      };
+    }
     return {
       name: "openai",
       status: "warn",
@@ -74560,7 +74803,7 @@ var SCHEMA_VERSION_RE = /^--\s*@version:\s*(\S+)/m;
 function readBundledSchemaVersion() {
   try {
     const assets = resolveServerAssets();
-    if (!existsSync9(assets.schemaFile))
+    if (!existsSync10(assets.schemaFile))
       return null;
     const m = readFileSync7(assets.schemaFile, "utf8").match(SCHEMA_VERSION_RE);
     return m ? m[1] : null;
@@ -74630,6 +74873,46 @@ async function checkSchemaVersion() {
     };
   }
 }
+var EMBEDDER_CHECK_NAME = "embedder";
+async function checkEmbedderMismatch() {
+  const settings = loadSettings();
+  if (!settings.supabaseUrl || !settings.supabaseKey) {
+    return { name: EMBEDDER_CHECK_NAME, status: "skipped", detail: "Supabase config missing; skipped." };
+  }
+  const { activeEmbedderName: activeEmbedderName2 } = await Promise.resolve().then(() => exports_embeddings);
+  const active = activeEmbedderName2();
+  try {
+    const url = `${settings.supabaseUrl.replace(/\/$/, "")}/rest/v1/cerefox_chunks?version_id=is.null&embedder_primary=not.is.null&select=embedder_primary&limit=1000`;
+    const resp = await fetch(url, {
+      headers: { apikey: settings.supabaseKey, Authorization: `Bearer ${settings.supabaseKey}` }
+    });
+    if (!resp.ok) {
+      return { name: EMBEDDER_CHECK_NAME, status: "skipped", detail: `chunk probe returned ${resp.status}; skipped.` };
+    }
+    const rows = await resp.json();
+    const recorded = [...new Set(rows.map((r) => r.embedder_primary))];
+    const stale = recorded.filter((r) => r !== active);
+    if (stale.length === 0) {
+      return {
+        name: EMBEDDER_CHECK_NAME,
+        status: "ok",
+        detail: `configured "${active}"${recorded.length ? " — matches all existing chunks" : " (no embedded chunks yet)"}`
+      };
+    }
+    return {
+      name: EMBEDDER_CHECK_NAME,
+      status: "warn",
+      detail: `configured "${active}" but existing chunks were embedded with ${stale.map((r) => `"${r}"`).join(", ")} — semantic search across them is broken.`,
+      hint: "Run `cerefox server reindex` to re-embed everything with the configured embedder."
+    };
+  } catch (err) {
+    return {
+      name: EMBEDDER_CHECK_NAME,
+      status: "skipped",
+      detail: `probe failed: ${err instanceof Error ? err.message : String(err)}`
+    };
+  }
+}
 var CONTENT_FORMAT_CHECK_NAME = "content format";
 async function checkContentFormat() {
   const settings = loadSettings();
@@ -74679,7 +74962,7 @@ async function checkContentFormat() {
   }
 }
 function hasCerefoxInJsonFile(path) {
-  if (!existsSync9(path))
+  if (!existsSync10(path))
     return false;
   try {
     const parsed = JSON.parse(readFileSync7(path, "utf8"));
@@ -74690,10 +74973,10 @@ function hasCerefoxInJsonFile(path) {
   }
 }
 function checkMcpConfigs() {
-  const home = homedir5();
-  const claudeCodeUser = join8(home, ".claude.json");
-  const claudeCodeProj = join8(process.cwd(), ".mcp.json");
-  const claudeDesktop = process.platform === "darwin" ? join8(home, "Library", "Application Support", "Claude", "claude_desktop_config.json") : process.platform === "win32" ? join8(process.env.APPDATA ?? "", "Claude", "claude_desktop_config.json") : join8(home, ".config", "Claude", "claude_desktop_config.json");
+  const home = homedir6();
+  const claudeCodeUser = join9(home, ".claude.json");
+  const claudeCodeProj = join9(process.cwd(), ".mcp.json");
+  const claudeDesktop = process.platform === "darwin" ? join9(home, "Library", "Application Support", "Claude", "claude_desktop_config.json") : process.platform === "win32" ? join9(process.env.APPDATA ?? "", "Claude", "claude_desktop_config.json") : join9(home, ".config", "Claude", "claude_desktop_config.json");
   const found = [];
   if (hasCerefoxInJsonFile(claudeCodeUser))
     found.push("Claude Code (user)");
@@ -74716,10 +74999,10 @@ function checkMcpConfigs() {
   };
 }
 function checkLegacyShadowEnv() {
-  const home = homedir5();
-  const homeEnv = join8(home, USER_STATE_DIR_NAME, ".env");
-  const cwdEnv = join8(process.cwd(), ".env");
-  if (!existsSync9(homeEnv) || !existsSync9(cwdEnv))
+  const home = homedir6();
+  const homeEnv = join9(home, USER_STATE_DIR_NAME, ".env");
+  const cwdEnv = join9(process.cwd(), ".env");
+  if (!existsSync10(homeEnv) || !existsSync10(cwdEnv))
     return null;
   try {
     if (realpathSync(homeEnv) === realpathSync(cwdEnv))
@@ -74729,7 +75012,7 @@ function checkLegacyShadowEnv() {
     name: "legacy env",
     status: "skipped",
     detail: `${cwdEnv} (shadowed by ~/.cerefox/.env)`,
-    hint: "Python `uv run cerefox …` still reads this file during the v0.5–v0.7 migration window. " + "Safe to delete once Python support is removed (v0.9+)."
+    hint: "Shadowed by ~/.cerefox/.env and no longer read by anything (Python was removed at v1.0.0). Safe to delete."
   };
 }
 async function checkPostgres() {
@@ -74866,6 +75149,7 @@ async function runAllChecks(opts = {}) {
     { name: "supabase", phase: "Probing Supabase Data API", run: () => checkSupabase() },
     { name: "openai", phase: "Probing OpenAI embeddings", run: () => checkOpenAI() },
     { name: "schema + RPCs", phase: "Reading schema + RPC version", run: () => checkSchemaVersion() },
+    { name: "embedder", phase: "Checking embedder consistency", run: () => checkEmbedderMismatch() },
     { name: "content format", phase: "Checking chunk reconstruction format", run: () => checkContentFormat() },
     { name: "edge functions", phase: "Probing Edge Function versions", run: () => checkEdgeFunctionsCompat() },
     { name: "postgres", phase: "Probing Postgres DDL endpoint", run: () => checkPostgres() },
@@ -75316,7 +75600,7 @@ class IngestionPipeline {
   constructor(deps) {
     this.db = new IngestionDbBridge(deps.supabase);
     this.apiKey = deps.openAiApiKey;
-    this.embedderModel = deps.embedderModel ?? "text-embedding-3-small";
+    this.embedderModel = deps.embedderModel ?? activeEmbedderName();
     this.settings = { ...loadPipelineSettings(), ...deps.settings ?? {} };
   }
   async ingestText(opts) {
@@ -75681,7 +75965,7 @@ async function action18(path, options) {
   if (!settings.supabaseUrl || !settings.supabaseKey) {
     throw userError("Supabase credentials not configured — run `cerefox init` first.");
   }
-  if (!settings.openaiApiKey) {
+  if (!settings.openaiApiKey && resolveEmbedderKind() !== "local") {
     throw userError("OPENAI_API_KEY not set — required for embeddings during ingest.");
   }
   const supabase = createClient(settings.supabaseUrl, settings.supabaseKey, {
@@ -75744,7 +76028,7 @@ init_cli_core();
 init_config();
 var import_cli_progress = __toESM(require_cli_progress(), 1);
 import { readdirSync as readdirSync4, statSync as statSync3 } from "node:fs";
-import { basename as basename3, extname as extname4, join as join9 } from "node:path";
+import { basename as basename3, extname as extname4, join as join10 } from "node:path";
 function walk(dir, extensions) {
   let entries;
   try {
@@ -75754,7 +76038,7 @@ function walk(dir, extensions) {
   }
   const files = [];
   for (const name of entries) {
-    const full = join9(dir, name);
+    const full = join10(dir, name);
     let stat;
     try {
       stat = statSync3(full);
@@ -75788,7 +76072,7 @@ async function action19(dir, options) {
   if (!settings.supabaseUrl || !settings.supabaseKey) {
     throw userError("Supabase credentials not configured — run `cerefox init` first.");
   }
-  if (!settings.openaiApiKey) {
+  if (!settings.openaiApiKey && resolveEmbedderKind() !== "local") {
     throw userError("OPENAI_API_KEY not set — required for embeddings during ingest.");
   }
   const supabase = createClient(settings.supabaseUrl, settings.supabaseKey, {
@@ -75851,19 +76135,20 @@ function registerIngestDir(program2) {
 // src/cli/commands/init.ts
 init_cli_core();
 init_config();
+init_compatibility();
 import { spawnSync as spawnSync4 } from "node:child_process";
 import {
   chmodSync,
   copyFileSync as copyFileSync2,
-  existsSync as existsSync10,
-  mkdirSync as mkdirSync3,
+  existsSync as existsSync11,
+  mkdirSync as mkdirSync4,
   readFileSync as readFileSync11,
   writeFileSync as writeFileSync4
 } from "node:fs";
-import { homedir as homedir6 } from "node:os";
-import { dirname as dirname4, join as join10 } from "node:path";
+import { homedir as homedir7 } from "node:os";
+import { dirname as dirname4, join as join11 } from "node:path";
 async function readConfigFile(path) {
-  if (!existsSync10(path)) {
+  if (!existsSync11(path)) {
     throw userError(`--config file not found: ${path}`);
   }
   let parsed;
@@ -75959,7 +76244,7 @@ async function promptForAnswers() {
   });
   println("");
   println(c.cyan("▶ Step 4/5 — Direct Postgres connection (optional for npm-installed users)"));
-  println(c.dim("  Only needed for `uv run python scripts/db_deploy.py` (schema deploy + migrations).\n" + `  npm-installed users without Python can skip — press Enter.
+  println(c.dim("  Only needed for `cerefox server deploy` (schema deploy + migrations).\n" + `  You can skip this and set CEREFOX_DATABASE_URL later — press Enter.
 ` + "  Format: postgresql://postgres.<project-ref>:<pw>@…:5432/postgres?sslmode=require"));
   const databaseUrl = await ask({
     type: "text",
@@ -76045,16 +76330,15 @@ function printMigrationMenu(cwdEnv, homeEnv) {
   println("");
   println(c.yellow(`⚠ Found existing config at ${cwdEnv}.`));
   println("");
-  println("This may be from a previous Python install. The TS CLI can use the");
+  println("This may be from an earlier install. The CLI can use the");
   println("same .env — env-var names are identical, no rewrite needed.");
   println("");
   println("  " + c.bold("[c]") + " Copy to " + homeEnv + "  " + c.green("(recommended)"));
-  println(c.dim("      • TS reads the new home from now on"));
-  println(c.dim("      • Python keeps reading " + cwdEnv + " (backward compat)"));
+  println(c.dim("      • The CLI reads the new home from now on"));
   println(c.dim("      • Edit ~/.cerefox/.env going forward; the repo .env is legacy"));
   println("");
   println("  " + c.bold("[u]") + " Use " + cwdEnv + " as-is, skip writing anything");
-  println(c.dim("      • Both TS and Python keep reading the existing file"));
+  println(c.dim("      • The CLI keeps reading the existing file"));
   println(c.dim("      • Defer the migration"));
   println("");
   println("  " + c.bold("[f]") + " Fresh start — interactive prompts, write to " + homeEnv);
@@ -76166,7 +76450,7 @@ async function postWriteLifecycle(envPath, options) {
   println(c.dim(`  Config in effect: ${envPath}`));
 }
 function writeAnswersTo(target, answers) {
-  mkdirSync3(dirname4(target), { recursive: true });
+  mkdirSync4(dirname4(target), { recursive: true });
   writeFileSync4(target, buildEnvFile(answers), "utf8");
   if (process.platform !== "win32") {
     try {
@@ -76177,12 +76461,12 @@ function writeAnswersTo(target, answers) {
   }
 }
 async function action21(options) {
-  const homeEnv = join10(homedir6(), USER_STATE_DIR_NAME, ".env");
-  const cwdEnv = join10(process.cwd(), ".env");
+  const homeEnv = join11(homedir7(), USER_STATE_DIR_NAME, ".env");
+  const cwdEnv = join11(process.cwd(), ".env");
   const explicitDir = (process.env.CEREFOX_CONFIG_DIR ?? "").trim();
   if (explicitDir) {
     const target2 = resolveEnvFile();
-    if (existsSync10(target2) && !options.force) {
+    if (existsSync11(target2) && !options.force) {
       println(c.yellow(`⚠ Config already exists at ${target2}.`));
       const ok2 = await confirm("Overwrite?", true);
       if (!ok2) {
@@ -76204,7 +76488,7 @@ async function action21(options) {
     await postWriteLifecycle(target2, options);
     return;
   }
-  if (existsSync10(homeEnv) && !options.force) {
+  if (existsSync11(homeEnv) && !options.force) {
     println(c.yellow(`⚠ Config already exists at ${homeEnv}.`));
     const ok2 = await confirm("Overwrite?", true);
     if (!ok2) {
@@ -76225,12 +76509,12 @@ async function action21(options) {
     await postWriteLifecycle(homeEnv, options);
     return;
   }
-  if (existsSync10(cwdEnv) && !options.force && !options.config) {
+  if (existsSync11(cwdEnv) && !options.force && !options.config) {
     printMigrationMenu(cwdEnv, homeEnv);
     const ch = await promptMigrationChoice();
     println("");
     if (ch === "c") {
-      mkdirSync3(dirname4(homeEnv), { recursive: true });
+      mkdirSync4(dirname4(homeEnv), { recursive: true });
       copyFileSync2(cwdEnv, homeEnv);
       if (process.platform !== "win32") {
         try {
@@ -76240,7 +76524,7 @@ async function action21(options) {
         }
       }
       println(c.green(`✓ Copied ${cwdEnv} → ${homeEnv}`));
-      println(c.dim(`  Repo file unchanged — Python still reads it during migration.`));
+      println(c.dim(`  Repo file left unchanged — safe to delete once the new location works.`));
       println("");
       const answers2 = answersFromEnvFile(homeEnv);
       println(c.bold("Validating credentials…"));
@@ -76479,6 +76763,23 @@ function registerMcp(program2) {
   });
 }
 
+// src/cli/commands/embedder-warmup.ts
+function registerEmbedderWarmup(program2) {
+  program2.command("embedder-warmup", { hidden: true }).description("Download + warm the local ONNX embedding model (Cerefox Local).").action(async () => {
+    if (process.env.CEREFOX_EMBEDDER !== "local") {
+      process.stderr.write(`embedder-warmup: CEREFOX_EMBEDDER is not 'local' — nothing to warm (the OpenAI embedder has no local model).
+`);
+      process.exitCode = 1;
+      return;
+    }
+    const onnx = await Promise.resolve().then(() => (init_onnx_embedder(), exports_onnx_embedder));
+    await onnx.warmup();
+    const [vec] = await onnx.onnxEmbed(["warmup"], "query");
+    process.stderr.write(`[cerefox-embed] warm — ${vec.length}-dim vectors ready.
+`);
+  });
+}
+
 // src/cli/commands/metadata-search.ts
 init_cli_core();
 init_client();
@@ -76638,35 +76939,35 @@ function registerReindex(program2) {
 // src/cli/commands/restore.ts
 init_cli_core();
 init_client();
-import { existsSync as existsSync11, readFileSync as readFileSync12, readdirSync as readdirSync5, statSync as statSync4 } from "node:fs";
-import { homedir as homedir7 } from "node:os";
-import { join as join11, resolve as resolve4 } from "node:path";
+import { existsSync as existsSync13, readFileSync as readFileSync13, readdirSync as readdirSync5, statSync as statSync4 } from "node:fs";
+import { homedir as homedir8 } from "node:os";
+import { join as join12, resolve as resolve4 } from "node:path";
 function expandHome2(path) {
   if (path === "~")
-    return homedir7();
+    return homedir8();
   if (path.startsWith("~/"))
-    return join11(homedir7(), path.slice(2));
+    return join12(homedir8(), path.slice(2));
   return path;
 }
 function resolveBackupFile(target) {
   const path = resolve4(expandHome2(target));
-  if (!existsSync11(path)) {
+  if (!existsSync13(path)) {
     throw userError(`Backup path not found: ${target}`);
   }
   const stat = statSync4(path);
   if (stat.isFile())
     return path;
-  const candidates = readdirSync5(path).filter((n) => n.endsWith(".json") && n.startsWith("cerefox-")).map((n) => ({ name: n, mtime: statSync4(join11(path, n)).mtimeMs })).sort((a, b2) => b2.mtime - a.mtime);
+  const candidates = readdirSync5(path).filter((n) => n.endsWith(".json") && n.startsWith("cerefox-")).map((n) => ({ name: n, mtime: statSync4(join12(path, n)).mtimeMs })).sort((a, b2) => b2.mtime - a.mtime);
   if (candidates.length === 0) {
     throw userError(`No cerefox-*.json files in ${path}`);
   }
-  return join11(path, candidates[0].name);
+  return join12(path, candidates[0].name);
 }
 async function action28(target, options) {
   const file = resolveBackupFile(target);
   let payload;
   try {
-    payload = JSON.parse(readFileSync12(file, "utf8"));
+    payload = JSON.parse(readFileSync13(file, "utf8"));
   } catch (err) {
     throw userError(`Could not parse backup file ${file}: ${err instanceof Error ? err.message : String(err)}`);
   }
@@ -76731,7 +77032,7 @@ init_config();
 async function embedQuery(query) {
   const settings = loadSettings();
   const apiKey = settings.openaiApiKey;
-  if (!apiKey) {
+  if (!apiKey && resolveEmbedderKind() !== "local") {
     throw userError("OPENAI_API_KEY (or CEREFOX_OPENAI_API_KEY) is required for search.", "Set the key in your .env, or run `cerefox init` to bootstrap.");
   }
   try {
@@ -77046,7 +77347,7 @@ import { randomBytes } from "node:crypto";
 import { spawnSync as spawnSync7 } from "node:child_process";
 
 // src/cli/util/env-file.ts
-import { copyFileSync as copyFileSync3, existsSync as existsSync12, readFileSync as readFileSync13, writeFileSync as writeFileSync5 } from "node:fs";
+import { copyFileSync as copyFileSync3, existsSync as existsSync14, readFileSync as readFileSync14, writeFileSync as writeFileSync5 } from "node:fs";
 import { dirname as dirname5 } from "node:path";
 import { spawnSync as spawnSync6 } from "node:child_process";
 function escapeRegExp(s) {
@@ -77056,12 +77357,12 @@ function upsertEnvVar(path, key, value, opts = {}) {
   const line = `${key}=${value}`;
   const header = opts.comment ? `# ${opts.comment}
 ` : "";
-  if (!existsSync12(path)) {
+  if (!existsSync14(path)) {
     writeFileSync5(path, `${header}${line}
 `, { mode: 384 });
     return { path, action: "created" };
   }
-  const original = readFileSync13(path, "utf8");
+  const original = readFileSync14(path, "utf8");
   let backupPath;
   if (!opts.noBackup) {
     backupPath = `${path}.pre-cerefox.bak`;
@@ -77086,9 +77387,9 @@ ${header}${line}
   return { path, action: action32, backupPath };
 }
 function readEnvVar(path, key) {
-  if (!existsSync12(path))
+  if (!existsSync14(path))
     return null;
-  const m = readFileSync13(path, "utf8").match(new RegExp(`^\\s*${escapeRegExp(key)}=(.*)$`, "m"));
+  const m = readFileSync14(path, "utf8").match(new RegExp(`^\\s*${escapeRegExp(key)}=(.*)$`, "m"));
   return m ? m[1].trim() : null;
 }
 function envGitignoreWarning(path) {
@@ -78556,8 +78857,8 @@ var _baseMimes = {
 var baseMimes = _baseMimes;
 
 // ../../node_modules/.bun/@hono+node-server@2.0.8+68404363cdc13251/node_modules/@hono/node-server/dist/serve-static.mjs
-import { createReadStream, existsSync as existsSync13, statSync as statSync5 } from "node:fs";
-import { join as join12 } from "node:path";
+import { createReadStream, existsSync as existsSync15, statSync as statSync5 } from "node:fs";
+import { join as join13 } 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 = {
   br: ".br",
@@ -78589,7 +78890,7 @@ var tryDecodeURI = (str) => tryDecode(str, decodeURI);
 var serveStatic = (options = { root: "" }) => {
   const root = options.root || "";
   const optionPath = options.path;
-  if (root !== "" && !existsSync13(root))
+  if (root !== "" && !existsSync15(root))
     console.error(`serveStatic: root path '${root}' is not found, are you sure it's correct?`);
   return async (c2, next) => {
     if (c2.finalized)
@@ -78606,11 +78907,11 @@ var serveStatic = (options = { root: "" }) => {
         await options.onNotFound?.(c2.req.path, c2);
         return next();
       }
-    let path = join12(root, !optionPath && options.rewriteRequestPath ? options.rewriteRequestPath(filename, c2) : filename);
+    let path = join13(root, !optionPath && options.rewriteRequestPath ? options.rewriteRequestPath(filename, c2) : filename);
     let stats = getStats(path);
     if (stats && stats.isDirectory()) {
       const indexFile = options.index ?? "index.html";
-      path = join12(path, indexFile);
+      path = join13(path, indexFile);
       stats = getStats(path);
     }
     if (!stats) {
@@ -78667,9 +78968,9 @@ var serveStatic = (options = { root: "" }) => {
 };
 
 // src/web/server.ts
-import { existsSync as existsSync17 } from "node:fs";
-import { readFileSync as readFileSync16 } from "node:fs";
-import { join as join16 } from "node:path";
+import { existsSync as existsSync19 } from "node:fs";
+import { readFileSync as readFileSync17 } from "node:fs";
+import { join as join17 } from "node:path";
 
 // ../../node_modules/.bun/hono@4.12.29/node_modules/hono/dist/compose.js
 var compose = (middleware, onError, onNotFound) => {
@@ -80698,7 +80999,7 @@ async function runSearch(ctx, opts) {
       throw error4;
     return (data2 ?? []).map(projectChunkResult);
   }
-  if (!ctx.openAiApiKey) {
+  if (!ctx.openAiApiKey && resolveEmbedderKind() !== "local") {
     throw new HttpError(503, "Embedder not available");
   }
   const embedding = await getEmbedding(query, ctx.openAiApiKey);
@@ -81239,7 +81540,6 @@ function registerDocumentReadRoutes(app, ctx) {
     return c2.json({ exists: false });
   });
 }
-
 // src/web/routes/documents-write.ts
 async function createAuditEntry(ctx, args) {
   try {
@@ -81290,7 +81590,7 @@ function registerDocumentWriteRoutes(app, ctx) {
     const proposedHash = content.trim() ? contentHash(content) : null;
     const contentChanged = proposedHash !== null && currentHash !== null && proposedHash !== currentHash;
     if (contentChanged) {
-      if (!ctx.openAiApiKey) {
+      if (!ctx.openAiApiKey && resolveEmbedderKind() !== "local") {
         return c2.json({
           success: false,
           error: "Embedder not available — set OPENAI_API_KEY in your config"
@@ -81446,14 +81746,13 @@ function registerDocumentWriteRoutes(app, ctx) {
     return c2.json({ archived });
   });
 }
-
 // src/web/routes/ingest.ts
 function notReady(error3) {
   return { success: false, error: error3 };
 }
 function registerIngestRoutes(app, ctx) {
   app.post("/api/v1/ingest", async (c2) => {
-    if (!ctx.openAiApiKey) {
+    if (!ctx.openAiApiKey && resolveEmbedderKind() !== "local") {
       return c2.json(notReady("Embedder not available"), 503);
     }
     let body;
@@ -81501,7 +81800,7 @@ function registerIngestRoutes(app, ctx) {
     }
   });
   app.post("/api/v1/ingest/file", async (c2) => {
-    if (!ctx.openAiApiKey) {
+    if (!ctx.openAiApiKey && resolveEmbedderKind() !== "local") {
       return c2.json(notReady("Embedder not available"), 503);
     }
     let form;
@@ -81563,7 +81862,7 @@ function registerIngestRoutes(app, ctx) {
     }
   });
   app.post("/api/v1/documents/:document_id/upload", async (c2) => {
-    if (!ctx.openAiApiKey) {
+    if (!ctx.openAiApiKey && resolveEmbedderKind() !== "local") {
       return c2.json(notReady("Embedder not available"), 503);
     }
     const documentId = c2.req.param("document_id");
@@ -81618,12 +81917,12 @@ import { execFileSync } from "node:child_process";
 
 // src/web/docs.ts
 import {
-  existsSync as existsSync14,
-  readFileSync as readFileSync14,
+  existsSync as existsSync16,
+  readFileSync as readFileSync15,
   readdirSync as readdirSync6,
   statSync as statSync6
 } from "node:fs";
-import { basename as basename5, dirname as dirname6, join as join13, resolve as resolve5 } from "node:path";
+import { basename as basename5, dirname as dirname6, join as join14, resolve as resolve5 } from "node:path";
 import { fileURLToPath as fileURLToPath3 } from "node:url";
 var TOP_LEVEL_DOCS = [
   { filename: "README.md", path: "README.md", category: "readme" },
@@ -81644,32 +81943,32 @@ function moduleDir2() {
 function resolveDocsRoots() {
   const here = moduleDir2();
   const pkgRootCandidates = [
-    join13(here, "..", ".."),
-    join13(here, "..", "..", "..", "..")
+    join14(here, "..", ".."),
+    join14(here, "..", "..", "..", "..")
   ];
   let pkgGuides = null;
   let pkgTopLevel = null;
   for (const pkg of pkgRootCandidates) {
-    const guides = join13(pkg, "docs", "guides");
-    if (existsSync14(guides) && statSync6(guides).isDirectory()) {
+    const guides = join14(pkg, "docs", "guides");
+    if (existsSync16(guides) && statSync6(guides).isDirectory()) {
       pkgGuides = guides;
       pkgTopLevel = pkg;
       break;
     }
   }
-  const repoCandidate = join13(here, "..", "..", "..", "..");
-  const repoGuides = join13(repoCandidate, "docs", "guides");
+  const repoCandidate = join14(here, "..", "..", "..", "..");
+  const repoGuides = join14(repoCandidate, "docs", "guides");
   const repoTopLevel = repoCandidate;
   return {
     pkgGuides,
     pkgTopLevel,
-    repoGuides: existsSync14(repoGuides) ? repoGuides : null,
-    repoTopLevel: existsSync14(join13(repoTopLevel, "README.md")) ? repoTopLevel : null
+    repoGuides: existsSync16(repoGuides) ? repoGuides : null,
+    repoTopLevel: existsSync16(join14(repoTopLevel, "README.md")) ? repoTopLevel : null
   };
 }
 function readH1(filePath) {
   try {
-    const content = readFileSync14(filePath, "utf8");
+    const content = readFileSync15(filePath, "utf8");
     const match2 = content.match(/^#\s+(.+?)\s*$/m);
     return match2 ? match2[1] : null;
   } catch {
@@ -81689,8 +81988,8 @@ function listBundledDocs2() {
   const topRoot = pkgTopLevel ?? repoTopLevel;
   if (topRoot) {
     for (const t of TOP_LEVEL_DOCS) {
-      const abs = join13(topRoot, t.filename);
-      if (existsSync14(abs)) {
+      const abs = join14(topRoot, t.filename);
+      if (existsSync16(abs)) {
         entries.push(entryForFile(abs, t.path, t.category));
       }
     }
@@ -81699,7 +81998,7 @@ function listBundledDocs2() {
   if (guidesRoot) {
     const names = readdirSync6(guidesRoot).filter((n) => n.endsWith(".md")).sort();
     for (const name of names) {
-      const abs = join13(guidesRoot, name);
+      const abs = join14(guidesRoot, name);
       entries.push(entryForFile(abs, `guides/${name}`, "guide"));
     }
   }
@@ -81717,9 +82016,9 @@ function readDoc(docPath) {
   if (!candidate.startsWith(rootResolved + "/") && candidate !== rootResolved) {
     return null;
   }
-  if (existsSync14(candidate) && statSync6(candidate).isFile()) {
+  if (existsSync16(candidate) && statSync6(candidate).isFile()) {
     try {
-      return readFileSync14(candidate, "utf8");
+      return readFileSync15(candidate, "utf8");
     } catch {
       return null;
     }
@@ -81728,6 +82027,7 @@ function readDoc(docPath) {
 }
 
 // src/web/routes/meta.ts
+init_compatibility();
 function resolveGitCommitShort() {
   const env4 = process.env.CEREFOX_GIT_COMMIT;
   if (env4)
@@ -81747,7 +82047,7 @@ var VERSION_INFO = {
   git_commit_short: resolveGitCommitShort(),
   build_date: process.env.CEREFOX_BUILD_DATE ?? null
 };
-var SCHEMA_VERSION_RE2 = /^--\s*@version:\s*(\S+)/m;
+var SCHEMA_VERSION_RE3 = /^--\s*@version:\s*(\S+)/m;
 function registerMetaRoutes(app, ctx) {
   app.get("/api/v1/version", (c2) => c2.json(VERSION_INFO));
   app.get("/api/v1/docs", (c2) => c2.json(listBundledDocs2()));
@@ -81764,18 +82064,18 @@ function registerMetaRoutes(app, ctx) {
   app.get("/api/v1/schema-version", async (c2) => {
     let bundled = null;
     try {
-      const { readFileSync: readFileSync15, existsSync: existsSync15 } = await import("node:fs");
+      const { readFileSync: readFileSync16, existsSync: existsSync17 } = await import("node:fs");
       const { fileURLToPath: fileURLToPath4 } = await import("node:url");
-      const { dirname: dirname7, join: join14 } = await import("node:path");
+      const { dirname: dirname7, join: join15 } = await import("node:path");
       const here = dirname7(fileURLToPath4(import.meta.url));
       const candidates = [
-        join14(here, "..", "..", "..", "db", "schema.sql"),
-        join14(here, "..", "..", "..", "..", "..", "src", "cerefox", "db", "schema.sql")
+        join15(here, "..", "..", "..", "db", "schema.sql"),
+        join15(here, "..", "..", "..", "..", "..", "src", "cerefox", "db", "schema.sql")
       ];
       for (const path of candidates) {
-        if (existsSync15(path)) {
-          const sql = readFileSync15(path, "utf8");
-          const match2 = sql.match(SCHEMA_VERSION_RE2);
+        if (existsSync17(path)) {
+          const sql = readFileSync16(path, "utf8");
+          const match2 = sql.match(SCHEMA_VERSION_RE3);
           bundled = match2 ? match2[1] : null;
           break;
         }
@@ -81870,17 +82170,17 @@ function registerPostgrestProxy(app) {
 
 // src/web/routes/preferences.ts
 init_config();
-import { existsSync as existsSync15, mkdirSync as mkdirSync4, readFileSync as readFileSync15, writeFileSync as writeFileSync6 } from "node:fs";
-import { join as join14 } from "node:path";
+import { existsSync as existsSync17, mkdirSync as mkdirSync5, readFileSync as readFileSync16, writeFileSync as writeFileSync6 } from "node:fs";
+import { join as join15 } from "node:path";
 function isTheme(v) {
   return v === "auto" || v === "light" || v === "dark";
 }
 function prefsFile() {
-  return join14(userStateDir(), "web-prefs.json");
+  return join15(userStateDir(), "web-prefs.json");
 }
 function readPrefs() {
   try {
-    const raw2 = JSON.parse(readFileSync15(prefsFile(), "utf8"));
+    const raw2 = JSON.parse(readFileSync16(prefsFile(), "utf8"));
     if (isTheme(raw2.theme))
       return { theme: raw2.theme };
   } catch {}
@@ -81896,8 +82196,8 @@ function registerPreferencesRoutes(app) {
     const next = { ...readPrefs(), theme: body.theme };
     try {
       const dir = userStateDir();
-      if (!existsSync15(dir))
-        mkdirSync4(dir, { recursive: true });
+      if (!existsSync17(dir))
+        mkdirSync5(dir, { recursive: true });
       writeFileSync6(prefsFile(), `${JSON.stringify(next, null, 2)}
 `);
     } catch (err) {
@@ -81968,21 +82268,21 @@ function registerProjectsRoutes(app, ctx) {
 }
 
 // src/web/static.ts
-import { existsSync as existsSync16, statSync as statSync7 } from "node:fs";
-import { dirname as dirname7, join as join15 } from "node:path";
+import { existsSync as existsSync18, statSync as statSync7 } from "node:fs";
+import { dirname as dirname7, join as join16 } from "node:path";
 import { fileURLToPath as fileURLToPath4 } from "node:url";
 function moduleDir3() {
   return dirname7(fileURLToPath4(import.meta.url));
 }
 function isUsableSpaDir(dir) {
-  return existsSync16(dir) && statSync7(dir).isDirectory() && existsSync16(join15(dir, "index.html"));
+  return existsSync18(dir) && statSync7(dir).isDirectory() && existsSync18(join16(dir, "index.html"));
 }
 function resolveSpaDist() {
   const here = moduleDir3();
   const candidates = [
-    join15(here, "..", "frontend"),
-    join15(here, "..", "..", "..", "..", "frontend", "dist"),
-    join15(here, "..", "..", "dist", "frontend")
+    join16(here, "..", "frontend"),
+    join16(here, "..", "..", "..", "..", "frontend", "dist"),
+    join16(here, "..", "..", "dist", "frontend")
   ];
   for (const c2 of candidates) {
     if (isUsableSpaDir(c2))
@@ -81993,11 +82293,11 @@ function resolveSpaDist() {
 function resolveStaticDir() {
   const here = moduleDir3();
   const candidates = [
-    join15(here, "..", "static"),
-    join15(here, "..", "..", "..", "..", "web", "static")
+    join16(here, "..", "static"),
+    join16(here, "..", "..", "..", "..", "web", "static")
   ];
   for (const c2 of candidates) {
-    if (existsSync16(c2) && statSync7(c2).isDirectory())
+    if (existsSync18(c2) && statSync7(c2).isDirectory())
       return c2;
   }
   return null;
@@ -82042,6 +82342,7 @@ var ROOT_REDIRECT_HTML = `<!DOCTYPE html>
 init_meta();
 init_cli_core();
 init_config();
+init_compatibility();
 function buildApp(ctx = buildWebContext()) {
   const app = new Hono2;
   if (true) {
@@ -82083,9 +82384,9 @@ function buildApp(ctx = buildWebContext()) {
       root: spaDist,
       rewriteRequestPath: (path) => path.replace(/^\/app/, "") || "/"
     }));
-    const indexPath = join16(spaDist, "index.html");
-    if (existsSync17(indexPath)) {
-      const indexHtml = readFileSync16(indexPath, "utf8");
+    const indexPath = join17(spaDist, "index.html");
+    if (existsSync19(indexPath)) {
+      const indexHtml = readFileSync17(indexPath, "utf8");
       app.get("/app/*", (c2) => c2.html(indexHtml));
     }
   }
@@ -82143,28 +82444,28 @@ async function buildWebServer(options = {}) {
 // src/web/daemon.ts
 import { spawn } from "node:child_process";
 import {
-  existsSync as existsSync18,
-  mkdirSync as mkdirSync5,
+  existsSync as existsSync20,
+  mkdirSync as mkdirSync6,
   openSync,
-  readFileSync as readFileSync17,
+  readFileSync as readFileSync18,
   rmSync,
   writeFileSync as writeFileSync7
 } from "node:fs";
-import { homedir as homedir8 } from "node:os";
-import { join as join17 } from "node:path";
-var STATE_DIR = join17(homedir8(), ".cerefox");
-var PID_FILE = join17(STATE_DIR, "web.pid");
-var LOG_FILE = join17(STATE_DIR, "web.log");
+import { homedir as homedir9 } from "node:os";
+import { join as join18 } from "node:path";
+var STATE_DIR = join18(homedir9(), ".cerefox");
+var PID_FILE = join18(STATE_DIR, "web.pid");
+var LOG_FILE = join18(STATE_DIR, "web.log");
 var daemonPaths = { stateDir: STATE_DIR, pidFile: PID_FILE, logFile: LOG_FILE };
 function ensureStateDir() {
-  if (!existsSync18(STATE_DIR))
-    mkdirSync5(STATE_DIR, { recursive: true });
+  if (!existsSync20(STATE_DIR))
+    mkdirSync6(STATE_DIR, { recursive: true });
 }
 function readPidFile() {
-  if (!existsSync18(PID_FILE))
+  if (!existsSync20(PID_FILE))
     return null;
   try {
-    const parsed = JSON.parse(readFileSync17(PID_FILE, "utf8"));
+    const parsed = JSON.parse(readFileSync18(PID_FILE, "utf8"));
     if (typeof parsed.pid !== "number")
       return null;
     return {
@@ -82475,6 +82776,7 @@ Learn more:
   registerConfigureAgent(program2);
   registerSelfUpdate(program2);
   registerMcp(program2);
+  registerEmbedderWarmup(program2);
   registerWeb(program2);
   registerCompletion(program2);
   registerToken(program2);
@@ -82528,7 +82830,7 @@ Learn more:
 
 // src/bin/cerefox.ts
 async function bareEntryPoint() {
-  const { existsSync: existsSync19 } = await import("node:fs");
+  const { existsSync: existsSync21 } = await import("node:fs");
   const { resolveEnvFile: resolveEnvFile2 } = await Promise.resolve().then(() => (init_config(), exports_config));
   const { c: c2, println: println2 } = await Promise.resolve().then(() => (init_cli_core(), exports_cli_core));
   const { PKG_VERSION: PKG_VERSION2 } = await Promise.resolve().then(() => (init_meta(), exports_meta));
@@ -82537,7 +82839,7 @@ async function bareEntryPoint() {
   println2("");
   let configExists = false;
   try {
-    configExists = existsSync19(resolveEnvFile2());
+    configExists = existsSync21(resolveEnvFile2());
   } catch {}
   if (!configExists) {
     println2(c2.yellow("⚠ No config detected."));