@askexenow/exe-os 0.9.102 → 0.9.104

package/dist/index.js

@@ -2482,9 +2482,79 @@ __export(database_exports, {
   isInitialized: () => isInitialized,
   setExternalClient: () => setExternalClient
 });
-import { chmodSync as chmodSync2 } from "fs";
+import { chmodSync as chmodSync2, existsSync as existsSync9, statSync as statSync2, copyFileSync, unlinkSync as unlinkSync3, openSync as openSync2, closeSync as closeSync2, mkdirSync as mkdirSync4 } from "fs";
 import { createClient } from "@libsql/client";
+import { homedir } from "os";
+import { join } from "path";
+function logCatchDebug(context, err) {
+  if (_debugDb) {
+    process.stderr.write(
+      `[database] ${context}: ${err instanceof Error ? err.message : String(err)}
+`
+    );
+  }
+}
+function acquireDbLock() {
+  mkdirSync4(join(homedir(), ".exe-os"), { recursive: true });
+  try {
+    _lockFd = openSync2(DB_LOCK_PATH, "wx");
+  } catch (err) {
+    if (err && typeof err === "object" && "code" in err && err.code === "EEXIST") {
+      try {
+        const lockStat = statSync2(DB_LOCK_PATH);
+        if (Date.now() - lockStat.mtimeMs > 6e4) {
+          unlinkSync3(DB_LOCK_PATH);
+          _lockFd = openSync2(DB_LOCK_PATH, "wx");
+          return;
+        }
+      } catch (e) {
+        logCatchDebug("stale lock check", e);
+      }
+      process.stderr.write(
+        "[database] WARN: Another process holds db.lock \u2014 waiting briefly then proceeding.\n"
+      );
+      return;
+    }
+    throw err;
+  }
+}
+function releaseDbLock() {
+  if (_lockFd !== null) {
+    try {
+      closeSync2(_lockFd);
+    } catch (e) {
+      logCatchDebug("lock close", e);
+    }
+    _lockFd = null;
+  }
+  try {
+    unlinkSync3(DB_LOCK_PATH);
+  } catch (e) {
+    logCatchDebug("lock unlink", e);
+  }
+}
 async function initDatabase(config2) {
+  acquireDbLock();
+  if (existsSync9(config2.dbPath)) {
+    const dbStat = statSync2(config2.dbPath);
+    if (dbStat.size === 0) {
+      const walPath = config2.dbPath + "-wal";
+      if (existsSync9(walPath) && statSync2(walPath).size > 0) {
+        const backupPath = config2.dbPath + ".zeroed-" + Date.now();
+        copyFileSync(config2.dbPath, backupPath);
+        unlinkSync3(config2.dbPath);
+        process.stderr.write(
+          `[database] CRITICAL: DB was 0 bytes. Moved to ${backupPath}, attempting WAL recovery.
+`
+        );
+      } else {
+        process.stderr.write(
+          `[database] CRITICAL: DB is 0 bytes and no WAL available for recovery. Data may be lost. Check backups at ${config2.dbPath}.bak
+`
+        );
+      }
+    }
+  }
   if (_walCheckpointTimer) {
     clearInterval(_walCheckpointTimer);
     _walCheckpointTimer = null;
@@ -2511,10 +2581,8 @@ async function initDatabase(config2) {
   _client = createClient(opts);
   _resilientClient = wrapWithRetry(_client);
   _adapterClient = _resilientClient;
-  _client.execute("PRAGMA busy_timeout = 30000").catch(() => {
-  });
-  _client.execute("PRAGMA journal_mode = WAL").catch(() => {
-  });
+  await _client.execute("PRAGMA busy_timeout = 30000");
+  await _client.execute("PRAGMA journal_mode = WAL");
   if (_walCheckpointTimer) clearInterval(_walCheckpointTimer);
   _walCheckpointTimer = setInterval(() => {
     _client?.execute("PRAGMA wal_checkpoint(PASSIVE)").catch(() => {
@@ -2529,11 +2597,16 @@ async function initDatabase(config2) {
     for (const suffix of ["-wal", "-shm"]) {
       try {
         chmodSync2(config2.dbPath + suffix, 384);
-      } catch {
+      } catch (chmodErr) {
+        process.stderr.write(`[database] chmod ${suffix} failed: ${chmodErr instanceof Error ? chmodErr.message : String(chmodErr)}
+`);
       }
     }
-  } catch {
+  } catch (chmodErr) {
+    process.stderr.write(`[database] chmod db failed: ${chmodErr instanceof Error ? chmodErr.message : String(chmodErr)}
+`);
   }
+  releaseDbLock();
 }
 function isInitialized() {
   return _adapterClient !== null || _client !== null;
@@ -2588,7 +2661,8 @@ async function ensureSchema() {
   await client.execute("PRAGMA wal_autocheckpoint = 1000");
   try {
     await client.execute("PRAGMA libsql_vector_search_ef = 128");
-  } catch {
+  } catch (e) {
+    logCatchDebug("migration", e);
   }
   await client.executeMultiple(`
     CREATE TABLE IF NOT EXISTS memories (
@@ -2653,6 +2727,23 @@ async function ensureSchema() {
       INSERT INTO memories_fts(memories_fts, rowid, raw_text) VALUES('delete', old.rowid, old.raw_text);
     END;
   `);
+  try {
+    await client.execute("SELECT COUNT(*) FROM memories_fts LIMIT 1");
+  } catch (ftsErr) {
+    process.stderr.write(
+      `[database] WARN: memories_fts corrupted (${ftsErr instanceof Error ? ftsErr.message : String(ftsErr)}) \u2014 rebuilding FTS index.
+`
+    );
+    try {
+      await client.execute("INSERT INTO memories_fts(memories_fts) VALUES('rebuild')");
+      process.stderr.write("[database] FTS index rebuilt successfully.\n");
+    } catch (rebuildErr) {
+      process.stderr.write(
+        `[database] ERROR: FTS rebuild failed: ${rebuildErr instanceof Error ? rebuildErr.message : String(rebuildErr)}
+`
+      );
+    }
+  }
   await client.executeMultiple(`
     CREATE TABLE IF NOT EXISTS sync_meta (
       key   TEXT PRIMARY KEY,
@@ -2711,35 +2802,40 @@ async function ensureSchema() {
         });
       }
     }
-  } catch {
+  } catch (seedErr) {
+    logCatchDebug("behavior seed", seedErr);
   }
   try {
     await client.execute({
       sql: `ALTER TABLE behaviors ADD COLUMN priority TEXT DEFAULT 'p1'`,
       args: []
     });
-  } catch {
+  } catch (e) {
+    logCatchDebug("migration", e);
   }
   try {
     await client.execute({
       sql: `ALTER TABLE behaviors ADD COLUMN vector F32_BLOB(${EMBEDDING_DIM})`,
       args: []
     });
-  } catch {
+  } catch (e) {
+    logCatchDebug("migration", e);
   }
   try {
     await client.execute({
       sql: `ALTER TABLE tasks ADD COLUMN blocked_by TEXT`,
       args: []
     });
-  } catch {
+  } catch (e) {
+    logCatchDebug("migration", e);
   }
   try {
     await client.execute({
       sql: `ALTER TABLE tasks ADD COLUMN parent_task_id TEXT`,
       args: []
     });
-  } catch {
+  } catch (e) {
+    logCatchDebug("migration", e);
   }
   try {
     await client.execute({
@@ -2748,98 +2844,112 @@ async function ensureSchema() {
               WHERE parent_task_id IS NOT NULL`,
       args: []
     });
-  } catch {
+  } catch (e) {
+    logCatchDebug("migration", e);
   }
   try {
     await client.execute({
       sql: `UPDATE tasks SET status = 'done' WHERE status = 'completed'`,
       args: []
     });
-  } catch {
+  } catch (e) {
+    logCatchDebug("migration", e);
   }
   try {
     await client.execute({
       sql: `ALTER TABLE tasks ADD COLUMN reviewer TEXT`,
       args: []
     });
-  } catch {
+  } catch (e) {
+    logCatchDebug("migration", e);
   }
   try {
     await client.execute({
       sql: `ALTER TABLE tasks ADD COLUMN context TEXT`,
       args: []
     });
-  } catch {
+  } catch (e) {
+    logCatchDebug("migration", e);
   }
   try {
     await client.execute({
       sql: `ALTER TABLE tasks ADD COLUMN result TEXT`,
       args: []
     });
-  } catch {
+  } catch (e) {
+    logCatchDebug("migration", e);
   }
   try {
     await client.execute({
       sql: `ALTER TABLE tasks ADD COLUMN assigned_tmux TEXT`,
       args: []
     });
-  } catch {
+  } catch (e) {
+    logCatchDebug("migration", e);
   }
   try {
     await client.execute({
       sql: `ALTER TABLE tasks ADD COLUMN checkpoint TEXT`,
       args: []
     });
-  } catch {
+  } catch (e) {
+    logCatchDebug("migration", e);
   }
   try {
     await client.execute({
       sql: `ALTER TABLE tasks ADD COLUMN checkpoint_count INTEGER NOT NULL DEFAULT 0`,
       args: []
     });
-  } catch {
+  } catch (e) {
+    logCatchDebug("migration", e);
   }
   try {
     await client.execute({
       sql: `ALTER TABLE tasks ADD COLUMN complexity TEXT NOT NULL DEFAULT 'standard'`,
       args: []
     });
-  } catch {
+  } catch (e) {
+    logCatchDebug("migration", e);
   }
   try {
     await client.execute({
       sql: `ALTER TABLE tasks ADD COLUMN session_scope TEXT`,
       args: []
     });
-  } catch {
+  } catch (e) {
+    logCatchDebug("migration", e);
   }
   try {
     await client.execute({
       sql: `ALTER TABLE memories ADD COLUMN task_id TEXT`,
       args: []
     });
-  } catch {
+  } catch (e) {
+    logCatchDebug("migration", e);
   }
   try {
     await client.execute({
       sql: `ALTER TABLE memories ADD COLUMN consolidated INTEGER NOT NULL DEFAULT 0`,
       args: []
     });
-  } catch {
+  } catch (e) {
+    logCatchDebug("migration", e);
   }
   try {
     await client.execute({
       sql: `ALTER TABLE memories ADD COLUMN author_device_id TEXT`,
       args: []
     });
-  } catch {
+  } catch (e) {
+    logCatchDebug("migration", e);
   }
   try {
     await client.execute({
       sql: `ALTER TABLE memories ADD COLUMN scope TEXT NOT NULL DEFAULT 'business'`,
       args: []
     });
-  } catch {
+  } catch (e) {
+    logCatchDebug("migration", e);
   }
   await client.executeMultiple(`
     CREATE TABLE IF NOT EXISTS consolidations (
@@ -2944,14 +3054,16 @@ async function ensureSchema() {
       sql: `ALTER TABLE notifications ADD COLUMN session_scope TEXT`,
       args: []
     });
-  } catch {
+  } catch (e) {
+    logCatchDebug("migration", e);
   }
   try {
     await client.execute({
       sql: `ALTER TABLE messages ADD COLUMN session_scope TEXT`,
       args: []
     });
-  } catch {
+  } catch (e) {
+    logCatchDebug("migration", e);
   }
   await client.executeMultiple(`
     CREATE INDEX IF NOT EXISTS idx_notifications_agent_scope_read
@@ -2977,7 +3089,8 @@ async function ensureSchema() {
       sql: `UPDATE tasks SET project_name = 'exe-os' WHERE project_name = 'worker'`,
       args: []
     });
-  } catch {
+  } catch (e) {
+    logCatchDebug("migration", e);
   }
   await client.executeMultiple(`
     CREATE TABLE IF NOT EXISTS trajectories (
@@ -3001,7 +3114,8 @@ async function ensureSchema() {
   `);
   try {
     await client.execute("ALTER TABLE trajectories ADD COLUMN skill_id TEXT");
-  } catch {
+  } catch (e) {
+    logCatchDebug("migration", e);
   }
   await client.executeMultiple(`
     CREATE TABLE IF NOT EXISTS consolidations (
@@ -3038,63 +3152,72 @@ async function ensureSchema() {
       sql: `ALTER TABLE memories ADD COLUMN consolidated INTEGER NOT NULL DEFAULT 0`,
       args: []
     });
-  } catch {
+  } catch (e) {
+    logCatchDebug("migration", e);
   }
   try {
     await client.execute({
       sql: `ALTER TABLE memories ADD COLUMN importance INTEGER DEFAULT 5`,
       args: []
     });
-  } catch {
+  } catch (e) {
+    logCatchDebug("migration", e);
   }
   try {
     await client.execute({
       sql: `ALTER TABLE memories ADD COLUMN status TEXT DEFAULT 'active'`,
       args: []
     });
-  } catch {
+  } catch (e) {
+    logCatchDebug("migration", e);
   }
   try {
     await client.execute({
       sql: `ALTER TABLE memories ADD COLUMN deleted_at TEXT`,
       args: []
     });
-  } catch {
+  } catch (e) {
+    logCatchDebug("migration", e);
   }
   try {
     await client.execute({
       sql: `ALTER TABLE memories ADD COLUMN confidence REAL DEFAULT 0.7`,
       args: []
     });
-  } catch {
+  } catch (e) {
+    logCatchDebug("migration", e);
   }
   try {
     await client.execute({
       sql: `ALTER TABLE memories ADD COLUMN last_accessed TEXT`,
       args: []
     });
-  } catch {
+  } catch (e) {
+    logCatchDebug("migration", e);
   }
   try {
     await client.execute({
       sql: `UPDATE memories SET last_accessed = timestamp WHERE last_accessed IS NULL`,
       args: []
     });
-  } catch {
+  } catch (e) {
+    logCatchDebug("migration", e);
   }
   try {
     await client.execute({
       sql: `ALTER TABLE memories ADD COLUMN wiki_synced INTEGER DEFAULT 0`,
       args: []
     });
-  } catch {
+  } catch (e) {
+    logCatchDebug("migration", e);
   }
   try {
     await client.execute({
       sql: `ALTER TABLE memories ADD COLUMN graph_extracted INTEGER DEFAULT 0`,
       args: []
     });
-  } catch {
+  } catch (e) {
+    logCatchDebug("migration", e);
   }
   for (const col of [
     "ALTER TABLE memories ADD COLUMN content_hash TEXT",
@@ -3102,14 +3225,16 @@ async function ensureSchema() {
   ]) {
     try {
       await client.execute(col);
-    } catch {
+    } catch (e) {
+      logCatchDebug("migration", e);
     }
   }
   try {
     await client.execute(
       `CREATE INDEX IF NOT EXISTS idx_memories_content_hash ON memories(content_hash, agent_id)`
     );
-  } catch {
+  } catch (e) {
+    logCatchDebug("migration", e);
   }
   try {
     await client.execute(
@@ -3117,7 +3242,8 @@ async function ensureSchema() {
          ON memories(content_hash, agent_id, project_name, memory_type)
          WHERE content_hash IS NOT NULL`
     );
-  } catch {
+  } catch (e) {
+    logCatchDebug("migration", e);
   }
   await client.executeMultiple(`
     CREATE TABLE IF NOT EXISTS entities (
@@ -3193,7 +3319,8 @@ async function ensureSchema() {
   `);
   try {
     await client.execute("INSERT INTO entities_fts(entities_fts) VALUES('rebuild')");
-  } catch {
+  } catch (e) {
+    logCatchDebug("migration", e);
   }
   await client.executeMultiple(`
     CREATE TABLE IF NOT EXISTS entity_aliases (
@@ -3208,14 +3335,16 @@ async function ensureSchema() {
   ]) {
     try {
       await client.execute(col);
-    } catch {
+    } catch (e) {
+      logCatchDebug("migration", e);
     }
   }
   try {
     await client.execute(
       `CREATE INDEX IF NOT EXISTS idx_memories_status ON memories(status)`
     );
-  } catch {
+  } catch (e) {
+    logCatchDebug("migration", e);
   }
   await client.executeMultiple(`
     CREATE TABLE IF NOT EXISTS identity (
@@ -3314,7 +3443,8 @@ async function ensureSchema() {
         sql: `ALTER TABLE memories ADD COLUMN ${column}`,
         args: []
       });
-    } catch {
+    } catch (e) {
+      logCatchDebug("migration", e);
     }
   }
   for (const col of [
@@ -3323,7 +3453,8 @@ async function ensureSchema() {
   ]) {
     try {
       await client.execute(col);
-    } catch {
+    } catch (e) {
+      logCatchDebug("migration", e);
     }
   }
   await client.executeMultiple(`
@@ -3508,56 +3639,64 @@ async function ensureSchema() {
         args: []
       });
     }
-  } catch {
+  } catch (e) {
+    logCatchDebug("session_agent_map backfill", e);
   }
   try {
     await client.execute({
       sql: `ALTER TABLE session_agent_map ADD COLUMN cache_cold_count INTEGER NOT NULL DEFAULT 0`,
       args: []
     });
-  } catch {
+  } catch (e) {
+    logCatchDebug("migration", e);
   }
   try {
     await client.execute({
       sql: `ALTER TABLE tasks ADD COLUMN budget_tokens INTEGER`,
       args: []
     });
-  } catch {
+  } catch (e) {
+    logCatchDebug("migration", e);
   }
   try {
     await client.execute({
       sql: `ALTER TABLE tasks ADD COLUMN budget_fallback_model TEXT`,
       args: []
     });
-  } catch {
+  } catch (e) {
+    logCatchDebug("migration", e);
   }
   try {
     await client.execute({
       sql: `ALTER TABLE tasks ADD COLUMN tokens_used INTEGER DEFAULT 0`,
       args: []
     });
-  } catch {
+  } catch (e) {
+    logCatchDebug("migration", e);
   }
   try {
     await client.execute({
       sql: `ALTER TABLE tasks ADD COLUMN tokens_warned_at INTEGER`,
       args: []
     });
-  } catch {
+  } catch (e) {
+    logCatchDebug("migration", e);
   }
   try {
     await client.execute({
       sql: `ALTER TABLE tasks ADD COLUMN spawn_runtime TEXT`,
       args: []
     });
-  } catch {
+  } catch (e) {
+    logCatchDebug("migration", e);
   }
   try {
     await client.execute({
       sql: `ALTER TABLE tasks ADD COLUMN spawn_model TEXT`,
       args: []
     });
-  } catch {
+  } catch (e) {
+    logCatchDebug("migration", e);
   }
   await client.executeMultiple(`
     CREATE VIRTUAL TABLE IF NOT EXISTS conversations_fts USING fts5(
@@ -3756,13 +3895,15 @@ async function ensureSchema() {
       sql: `ALTER TABLE memories ADD COLUMN tier INTEGER DEFAULT 3`,
       args: []
     });
-  } catch {
+  } catch (e) {
+    logCatchDebug("migration", e);
   }
   try {
     await client.execute(
       `CREATE INDEX IF NOT EXISTS idx_memories_tier ON memories(tier)`
     );
-  } catch {
+  } catch (e) {
+    logCatchDebug("migration", e);
   }
   try {
     await client.execute({
@@ -3773,20 +3914,23 @@ async function ensureSchema() {
       sql: `UPDATE memories SET tier = 2 WHERE tool_name IN ('store_memory', 'manual') AND importance >= 5 AND tier = 3`,
       args: []
     });
-  } catch {
+  } catch (e) {
+    logCatchDebug("migration", e);
   }
   try {
     await client.execute({
       sql: `ALTER TABLE memories ADD COLUMN supersedes_id TEXT`,
       args: []
     });
-  } catch {
+  } catch (e) {
+    logCatchDebug("migration", e);
   }
   try {
     await client.execute(
       `CREATE INDEX IF NOT EXISTS idx_memories_supersedes ON memories(supersedes_id) WHERE supersedes_id IS NOT NULL`
     );
-  } catch {
+  } catch (e) {
+    logCatchDebug("migration", e);
   }
   for (const col of [
     "ALTER TABLE tasks ADD COLUMN checkpoint TEXT",
@@ -3794,7 +3938,8 @@ async function ensureSchema() {
   ]) {
     try {
       await client.execute(col);
-    } catch {
+    } catch (e) {
+      logCatchDebug("migration", e);
     }
   }
   try {
@@ -3802,13 +3947,15 @@ async function ensureSchema() {
       sql: `ALTER TABLE memories ADD COLUMN draft INTEGER DEFAULT 0`,
       args: []
     });
-  } catch {
+  } catch (e) {
+    logCatchDebug("migration", e);
   }
   try {
     await client.execute(
       `CREATE INDEX IF NOT EXISTS idx_memories_draft ON memories(draft) WHERE draft = 1`
     );
-  } catch {
+  } catch (e) {
+    logCatchDebug("migration", e);
   }
   for (const col of [
     "ALTER TABLE memories ADD COLUMN valid_from TEXT",
@@ -3816,7 +3963,8 @@ async function ensureSchema() {
   ]) {
     try {
       await client.execute(col);
-    } catch {
+    } catch (e) {
+      logCatchDebug("migration", e);
     }
   }
   try {
@@ -3824,27 +3972,31 @@ async function ensureSchema() {
       sql: `UPDATE memories SET valid_from = timestamp WHERE valid_from IS NULL`,
       args: []
     });
-  } catch {
+  } catch (e) {
+    logCatchDebug("migration", e);
   }
   try {
     await client.execute({
       sql: `ALTER TABLE memories ADD COLUMN memory_type TEXT DEFAULT 'raw'`,
       args: []
     });
-  } catch {
+  } catch (e) {
+    logCatchDebug("migration", e);
   }
   try {
     await client.execute(
       `CREATE INDEX IF NOT EXISTS idx_memories_type ON memories(memory_type)`
     );
-  } catch {
+  } catch (e) {
+    logCatchDebug("migration", e);
   }
   try {
     await client.execute({
       sql: `ALTER TABLE memories ADD COLUMN trajectory TEXT`,
       args: []
     });
-  } catch {
+  } catch (e) {
+    logCatchDebug("migration", e);
   }
   for (const col of [
     "ALTER TABLE memories ADD COLUMN intent TEXT",
@@ -3865,7 +4017,8 @@ async function ensureSchema() {
   ]) {
     try {
       await client.execute(col);
-    } catch {
+    } catch (e) {
+      logCatchDebug("migration", e);
     }
   }
   try {
@@ -3873,14 +4026,16 @@ async function ensureSchema() {
       sql: `ALTER TABLE memories ADD COLUMN procedure_for TEXT`,
       args: []
     });
-  } catch {
+  } catch (e) {
+    logCatchDebug("migration", e);
   }
   try {
     await client.execute({
       sql: `UPDATE tasks SET status = 'closed' WHERE status = 'done' AND result IS NOT NULL`,
       args: []
     });
-  } catch {
+  } catch (e) {
+    logCatchDebug("migration", e);
   }
 }
 async function disposeDatabase() {
@@ -3891,7 +4046,8 @@ async function disposeDatabase() {
   if (_client) {
     try {
       await _client.execute("PRAGMA wal_checkpoint(PASSIVE)");
-    } catch {
+    } catch (e) {
+      logCatchDebug("WAL checkpoint", e);
     }
   }
   if (_daemonClient) {
@@ -3907,8 +4063,9 @@ async function disposeDatabase() {
     _client = null;
     _resilientClient = null;
   }
+  releaseDbLock();
 }
-var _client, _resilientClient, _walCheckpointTimer, _daemonClient, _adapterClient, initTurso, SOFT_DELETE_RETENTION_DAYS, disposeTurso;
+var _debugDb, _client, _resilientClient, _walCheckpointTimer, _daemonClient, _adapterClient, _lockFd, DB_LOCK_PATH, initTurso, SOFT_DELETE_RETENTION_DAYS, disposeTurso;
 var init_database = __esm({
   "src/lib/database.ts"() {
     "use strict";
@@ -3916,11 +4073,14 @@ var init_database = __esm({
     init_employees();
     init_database_adapter();
     init_memory();
+    _debugDb = process.env.EXE_DEBUG === "1";
     _client = null;
     _resilientClient = null;
     _walCheckpointTimer = null;
     _daemonClient = null;
     _adapterClient = null;
+    _lockFd = null;
+    DB_LOCK_PATH = join(homedir(), ".exe-os", "db.lock");
     initTurso = initDatabase;
     SOFT_DELETE_RETENTION_DAYS = 7;
     disposeTurso = disposeDatabase;
@@ -3928,7 +4088,7 @@ var init_database = __esm({
 });
 
 // src/lib/license.ts
-import { readFileSync as readFileSync8, writeFileSync as writeFileSync6, existsSync as existsSync9, mkdirSync as mkdirSync4 } from "fs";
+import { readFileSync as readFileSync8, writeFileSync as writeFileSync6, existsSync as existsSync10, mkdirSync as mkdirSync5 } from "fs";
 import { randomUUID as randomUUID3 } from "crypto";
 import { createRequire as createRequire2 } from "module";
 import { pathToFileURL as pathToFileURL2 } from "url";
@@ -3955,11 +4115,11 @@ var init_license = __esm({
 });
 
 // src/lib/plan-limits.ts
-import { readFileSync as readFileSync9, existsSync as existsSync10 } from "fs";
+import { readFileSync as readFileSync9, existsSync as existsSync11 } from "fs";
 import path11 from "path";
 function getLicenseSync() {
   try {
-    if (!existsSync10(CACHE_PATH2)) return freeLicense();
+    if (!existsSync11(CACHE_PATH2)) return freeLicense();
     const raw = JSON.parse(readFileSync9(CACHE_PATH2, "utf8"));
     if (!raw.token || typeof raw.token !== "string") return freeLicense();
     const parts = raw.token.split(".");
@@ -3998,7 +4158,7 @@ function assertEmployeeLimitSync(rosterPath) {
   const filePath = rosterPath ?? EMPLOYEES_PATH;
   let count = 0;
   try {
-    if (existsSync10(filePath)) {
+    if (existsSync11(filePath)) {
       const raw = readFileSync9(filePath, "utf8");
       const employees = JSON.parse(raw);
       count = Array.isArray(employees) ? employees.length : 0;
@@ -4036,9 +4196,9 @@ var init_plan_limits = __esm({
 import os9 from "os";
 import path12 from "path";
 import {
-  existsSync as existsSync11,
+  existsSync as existsSync12,
   lstatSync,
-  mkdirSync as mkdirSync5,
+  mkdirSync as mkdirSync6,
   readlinkSync as readlinkSync2,
   symlinkSync as symlinkSync2
 } from "fs";
@@ -4054,8 +4214,8 @@ function claudeAgentLinkPath(homeDir, agentId) {
 function ensureAgentSymlink(agentId, homeDir = os9.homedir()) {
   const target = identitySourcePath(homeDir, agentId);
   const link = claudeAgentLinkPath(homeDir, agentId);
-  mkdirSync5(claudeAgentsDir(homeDir), { recursive: true });
-  if (existsSync11(link)) {
+  mkdirSync6(claudeAgentsDir(homeDir), { recursive: true });
+  if (existsSync12(link)) {
     let stat;
     try {
       stat = lstatSync(link);
@@ -4142,8 +4302,8 @@ import os10 from "os";
 import {
   readFileSync as readFileSync10,
   readdirSync,
-  unlinkSync as unlinkSync3,
-  existsSync as existsSync12,
+  unlinkSync as unlinkSync4,
+  existsSync as existsSync13,
   rmdirSync
 } from "fs";
 async function writeNotification(notification) {
@@ -4391,7 +4551,7 @@ import path15 from "path";
 import os11 from "os";
 import { execSync as execSync7 } from "child_process";
 import { mkdir as mkdir3, writeFile as writeFile3, appendFile } from "fs/promises";
-import { existsSync as existsSync13, readFileSync as readFileSync11 } from "fs";
+import { existsSync as existsSync14, readFileSync as readFileSync11 } from "fs";
 async function writeCheckpoint(input) {
   const client = getClient();
   const row = await resolveTask(client, input.taskId);
@@ -4632,7 +4792,7 @@ ${scopeMismatchWarning}` : scopeMismatchWarning;
       const EXE_OS_DIR = path15.join(os11.homedir(), ".exe-os");
       const mdPath = path15.join(EXE_OS_DIR, taskFile);
       const mdDir = path15.dirname(mdPath);
-      if (!existsSync13(mdDir)) await mkdir3(mdDir, { recursive: true });
+      if (!existsSync14(mdDir)) await mkdir3(mdDir, { recursive: true });
       const reviewer = input.reviewer ?? input.assignedBy;
       const mdContent = `# ${input.title}
 
@@ -4938,7 +5098,7 @@ async function deleteTaskCore(taskId, _baseDir) {
 async function ensureArchitectureDoc(baseDir, projectName) {
   const archPath = path15.join(baseDir, "exe", "ARCHITECTURE.md");
   try {
-    if (existsSync13(archPath)) return;
+    if (existsSync14(archPath)) return;
     const template = [
       `# ${projectName} \u2014 System Architecture`,
       "",
@@ -4973,7 +5133,7 @@ async function ensureArchitectureDoc(baseDir, projectName) {
 async function ensureGitignoreExe(baseDir) {
   const gitignorePath = path15.join(baseDir, ".gitignore");
   try {
-    if (existsSync13(gitignorePath)) {
+    if (existsSync14(gitignorePath)) {
       const content = readFileSync11(gitignorePath, "utf-8");
       if (/^\/?exe\/?$/m.test(content)) return;
       await appendFile(gitignorePath, "\n# Employee task assignments (private)\n/exe/\n");
@@ -5018,7 +5178,7 @@ __export(tasks_review_exports, {
   listPendingReviews: () => listPendingReviews
 });
 import path16 from "path";
-import { existsSync as existsSync14, readdirSync as readdirSync2, unlinkSync as unlinkSync4 } from "fs";
+import { existsSync as existsSync15, readdirSync as readdirSync2, unlinkSync as unlinkSync5 } from "fs";
 function formatAge(isoTimestamp) {
   if (!isoTimestamp) return "";
   const ms = Date.now() - new Date(isoTimestamp).getTime();
@@ -5288,10 +5448,10 @@ async function cleanupReviewFile(row, taskFile, _baseDir) {
   }
   try {
     const cacheDir = path16.join(EXE_AI_DIR, "session-cache");
-    if (existsSync14(cacheDir)) {
+    if (existsSync15(cacheDir)) {
       for (const f of readdirSync2(cacheDir)) {
         if (f.startsWith("review-notified-")) {
-          unlinkSync4(path16.join(cacheDir, f));
+          unlinkSync5(path16.join(cacheDir, f));
         }
       }
     }
@@ -5514,10 +5674,10 @@ async function disposeEmbedder() {
 async function embedDirect(text) {
   const llamaCpp = await import("node-llama-cpp");
   const { MODELS_DIR: MODELS_DIR2 } = await Promise.resolve().then(() => (init_config(), config_exports));
-  const { existsSync: existsSync19 } = await import("fs");
+  const { existsSync: existsSync20 } = await import("fs");
   const path24 = await import("path");
   const modelPath = path24.join(MODELS_DIR2, "jina-embeddings-v5-small-q4_k_m.gguf");
-  if (!existsSync19(modelPath)) {
+  if (!existsSync20(modelPath)) {
     throw new Error(`Embedding model not found at ${modelPath}. Run '/exe-setup' to download it.`);
   }
   const llama = await llamaCpp.getLlama();
@@ -5955,7 +6115,7 @@ __export(tasks_exports, {
   writeCheckpoint: () => writeCheckpoint
 });
 import path18 from "path";
-import { writeFileSync as writeFileSync7, mkdirSync as mkdirSync6, unlinkSync as unlinkSync5 } from "fs";
+import { writeFileSync as writeFileSync7, mkdirSync as mkdirSync7, unlinkSync as unlinkSync6 } from "fs";
 async function createTask(input) {
   const result = await createTaskCore(input);
   if (!input.skipDispatch && result.status !== "blocked" && !process.env.VITEST) {
@@ -5977,11 +6137,11 @@ async function updateTask(input) {
     const cacheDir = path18.join(EXE_AI_DIR, "session-cache");
     const cachePath = path18.join(cacheDir, `current-task-${agent}.json`);
     if (input.status === "in_progress") {
-      mkdirSync6(cacheDir, { recursive: true });
+      mkdirSync7(cacheDir, { recursive: true });
       writeFileSync7(cachePath, JSON.stringify({ taskId, title: String(row.title) }));
     } else if (input.status === "done" || input.status === "blocked" || input.status === "cancelled" || input.status === "closed") {
       try {
-        unlinkSync5(cachePath);
+        unlinkSync6(cachePath);
       } catch {
       }
     }
@@ -6449,11 +6609,11 @@ __export(tmux_routing_exports, {
   verifyPaneAtCapacity: () => verifyPaneAtCapacity
 });
 import { execFileSync as execFileSync2, execSync as execSync8 } from "child_process";
-import { readFileSync as readFileSync12, writeFileSync as writeFileSync8, mkdirSync as mkdirSync7, existsSync as existsSync15, appendFileSync, readdirSync as readdirSync3 } from "fs";
+import { readFileSync as readFileSync12, writeFileSync as writeFileSync8, mkdirSync as mkdirSync8, existsSync as existsSync16, appendFileSync, readdirSync as readdirSync3 } from "fs";
 import path19 from "path";
 import os12 from "os";
 import { fileURLToPath as fileURLToPath2 } from "url";
-import { unlinkSync as unlinkSync6 } from "fs";
+import { unlinkSync as unlinkSync7 } from "fs";
 function spawnLockPath(sessionName) {
   return path19.join(SPAWN_LOCK_DIR, `${sessionName}.lock`);
 }
@@ -6466,11 +6626,11 @@ function isProcessAlive(pid) {
   }
 }
 function acquireSpawnLock2(sessionName) {
-  if (!existsSync15(SPAWN_LOCK_DIR)) {
-    mkdirSync7(SPAWN_LOCK_DIR, { recursive: true });
+  if (!existsSync16(SPAWN_LOCK_DIR)) {
+    mkdirSync8(SPAWN_LOCK_DIR, { recursive: true });
   }
   const lockFile = spawnLockPath(sessionName);
-  if (existsSync15(lockFile)) {
+  if (existsSync16(lockFile)) {
     try {
       const lock = JSON.parse(readFileSync12(lockFile, "utf8"));
       const age = Date.now() - lock.timestamp;
@@ -6485,7 +6645,7 @@ function acquireSpawnLock2(sessionName) {
 }
 function releaseSpawnLock2(sessionName) {
   try {
-    unlinkSync6(spawnLockPath(sessionName));
+    unlinkSync7(spawnLockPath(sessionName));
   } catch {
   }
 }
@@ -6498,7 +6658,7 @@ function resolveBehaviorsExporterScript() {
       "bin",
       "exe-export-behaviors.js"
     );
-    return existsSync15(scriptPath) ? scriptPath : null;
+    return existsSync16(scriptPath) ? scriptPath : null;
   } catch {
     return null;
   }
@@ -6564,8 +6724,8 @@ function extractRootExe(name) {
   return parts.length > 0 ? parts[parts.length - 1] : null;
 }
 function registerParentExe(sessionKey, parentExe, dispatchedBy) {
-  if (!existsSync15(SESSION_CACHE)) {
-    mkdirSync7(SESSION_CACHE, { recursive: true });
+  if (!existsSync16(SESSION_CACHE)) {
+    mkdirSync8(SESSION_CACHE, { recursive: true });
   }
   const rootExe = extractRootExe(parentExe) ?? parentExe;
   const filePath = path19.join(SESSION_CACHE, `parent-exe-${sessionKey}.json`);
@@ -6595,11 +6755,13 @@ function getDispatchedBy(sessionKey) {
   }
 }
 function resolveExeSession() {
-  if (process.env.EXE_SESSION_NAME) {
-    return extractRootExe(process.env.EXE_SESSION_NAME) ?? process.env.EXE_SESSION_NAME;
-  }
   const mySession = getMySession();
-  if (!mySession) return null;
+  if (!mySession) {
+    if (process.env.EXE_SESSION_NAME) {
+      return extractRootExe(process.env.EXE_SESSION_NAME) ?? process.env.EXE_SESSION_NAME;
+    }
+    return null;
+  }
   const fromSessionName = extractRootExe(mySession);
   let candidate = null;
   try {
@@ -6694,7 +6856,7 @@ async function verifyPaneAtCapacity(sessionName) {
 }
 function readDebounceState() {
   try {
-    if (!existsSync15(DEBOUNCE_FILE)) return {};
+    if (!existsSync16(DEBOUNCE_FILE)) return {};
     const raw = JSON.parse(readFileSync12(DEBOUNCE_FILE, "utf8"));
     const state = {};
     for (const [key, val] of Object.entries(raw)) {
@@ -6711,7 +6873,7 @@ function readDebounceState() {
 }
 function writeDebounceState(state) {
   try {
-    if (!existsSync15(SESSION_CACHE)) mkdirSync7(SESSION_CACHE, { recursive: true });
+    if (!existsSync16(SESSION_CACHE)) mkdirSync8(SESSION_CACHE, { recursive: true });
     writeFileSync8(DEBOUNCE_FILE, JSON.stringify(state));
   } catch {
   }
@@ -6812,7 +6974,7 @@ function sendIntercom(targetSession) {
         const rawAgent = targetSession.split("-")[0] ?? targetSession;
         const agent = baseAgentName(rawAgent);
         const markerPath = path19.join(SESSION_CACHE, `current-task-${agent}.json`);
-        if (existsSync15(markerPath)) {
+        if (existsSync16(markerPath)) {
           logIntercom(`SKIP \u2192 ${targetSession} (has in_progress task marker + not idle \u2014 will auto-chain)`);
           return "debounced";
         }
@@ -6823,7 +6985,7 @@ function sendIntercom(targetSession) {
       const rawAgent = targetSession.split("-")[0] ?? targetSession;
       const agent = baseAgentName(rawAgent);
       const taskDir = path19.join(process.cwd(), "exe", agent);
-      if (existsSync15(taskDir)) {
+      if (existsSync16(taskDir)) {
         const files = readdirSync3(taskDir).filter(
           (f) => f.endsWith(".md") && f !== "DONE.txt"
         );
@@ -6984,15 +7146,15 @@ function spawnEmployee(employeeName, exeSession, projectDir, opts) {
   const instanceLabel = opts?.instance != null && opts.instance > 0 ? `${employeeName}${opts.instance}` : employeeName;
   const logDir = path19.join(os12.homedir(), ".exe-os", "session-logs");
   const logFile = path19.join(logDir, `${instanceLabel}-${Date.now()}.log`);
-  if (!existsSync15(logDir)) {
-    mkdirSync7(logDir, { recursive: true });
+  if (!existsSync16(logDir)) {
+    mkdirSync8(logDir, { recursive: true });
   }
   transport.kill(sessionName);
   let cleanupSuffix = "";
   try {
     const thisFile = fileURLToPath2(import.meta.url);
     const cleanupScript = path19.join(path19.dirname(thisFile), "..", "bin", "exe-session-cleanup.js");
-    if (existsSync15(cleanupScript)) {
+    if (existsSync16(cleanupScript)) {
       cleanupSuffix = `; ${process.execPath} "${cleanupScript}" "${employeeName}" "${exeSession}"`;
     }
   } catch {
@@ -7047,7 +7209,7 @@ function spawnEmployee(employeeName, exeSession, projectDir, opts) {
     if (changed) {
       perms.allow = allow;
       settings.permissions = perms;
-      mkdirSync7(projSettingsDir, { recursive: true });
+      mkdirSync8(projSettingsDir, { recursive: true });
       writeFileSync8(settingsPath, JSON.stringify(settings, null, 2) + "\n");
     }
   } catch {
@@ -7085,7 +7247,7 @@ function spawnEmployee(employeeName, exeSession, projectDir, opts) {
 `
         );
       }
-    } else if (existsSync15(identityPath)) {
+    } else if (existsSync16(identityPath)) {
       identityFlag = ` --append-system-prompt-file ${identityPath}`;
       legacyFallbackWarned = true;
     }
@@ -7107,7 +7269,7 @@ function spawnEmployee(employeeName, exeSession, projectDir, opts) {
   let sessionContextFlag = "";
   try {
     const ctxDir = path19.join(os12.homedir(), ".exe-os", "session-cache");
-    mkdirSync7(ctxDir, { recursive: true });
+    mkdirSync8(ctxDir, { recursive: true });
     const ctxFile = path19.join(ctxDir, `session-context-${sessionName}.md`);
     const ctxContent = [
       `## Session Context`,
@@ -7290,7 +7452,7 @@ var init_tmux_routing = __esm({
 
 // src/lib/keychain.ts
 import { readFile as readFile4, writeFile as writeFile5, unlink, mkdir as mkdir4, chmod as chmod2 } from "fs/promises";
-import { existsSync as existsSync16, statSync as statSync2 } from "fs";
+import { existsSync as existsSync17, statSync as statSync3 } from "fs";
 import { execSync as execSync9 } from "child_process";
 import path20 from "path";
 import os13 from "os";
@@ -7325,7 +7487,7 @@ function isRootOnlyTrustedServerKeyFile(keyPath) {
   if (process.platform !== "linux") return false;
   try {
     const uid = typeof os13.userInfo().uid === "number" ? os13.userInfo().uid : -1;
-    const st = statSync2(keyPath);
+    const st = statSync3(keyPath);
     if (!st.isFile() || (st.mode & 63) !== 0) return false;
     if (uid === 0) return true;
     const exeOsDir = process.env.EXE_OS_DIR;
@@ -7526,7 +7688,7 @@ async function getMasterKey() {
     }
   }
   const keyPath = getKeyPath();
-  if (!existsSync16(keyPath)) {
+  if (!existsSync17(keyPath)) {
     process.stderr.write(
       `[keychain] Key not found at ${keyPath} (HOME=${os13.homedir()}, EXE_OS_DIR=${process.env.EXE_OS_DIR ?? "unset"})
 `
@@ -7806,18 +7968,54 @@ __export(shard_manager_exports, {
   shardExists: () => shardExists
 });
 import path21 from "path";
-import { existsSync as existsSync17, mkdirSync as mkdirSync8, readdirSync as readdirSync4, renameSync as renameSync4, statSync as statSync3 } from "fs";
+import { existsSync as existsSync18, mkdirSync as mkdirSync9, readdirSync as readdirSync4, renameSync as renameSync4, statSync as statSync4 } from "fs";
 import { createClient as createClient2 } from "@libsql/client";
 function initShardManager(encryptionKey) {
   _encryptionKey = encryptionKey;
-  if (!existsSync17(SHARDS_DIR)) {
-    mkdirSync8(SHARDS_DIR, { recursive: true });
+  _keyValidated = false;
+  _keyValidationPromise = null;
+  if (!existsSync18(SHARDS_DIR)) {
+    mkdirSync9(SHARDS_DIR, { recursive: true });
+  }
+  const existingShards = readdirSync4(SHARDS_DIR).filter((f) => f.endsWith(".db"));
+  if (existingShards.length === 0) {
+    _keyValidated = true;
   }
   _shardingEnabled = true;
   if (_evictionTimer) clearInterval(_evictionTimer);
   _evictionTimer = setInterval(evictIdleShards, EVICTION_INTERVAL_MS);
   _evictionTimer.unref();
 }
+async function validateEncryptionKey() {
+  if (_keyValidated) return true;
+  if (!_encryptionKey) return false;
+  const existingShards = readdirSync4(SHARDS_DIR).filter((f) => f.endsWith(".db"));
+  if (existingShards.length === 0) {
+    _keyValidated = true;
+    return true;
+  }
+  for (const shardFile of existingShards.slice(0, 3)) {
+    const dbPath = path21.join(SHARDS_DIR, shardFile);
+    const testClient = createClient2({ url: `file:${dbPath}`, encryptionKey: _encryptionKey });
+    try {
+      await testClient.execute("SELECT COUNT(*) FROM sqlite_schema");
+      testClient.close();
+      _keyValidated = true;
+      return true;
+    } catch {
+      try {
+        testClient.close();
+      } catch {
+      }
+    }
+  }
+  process.stderr.write(
+    `[shard-manager] WARNING: encryption key cannot read any existing shards (${existingShards.length} found). New shard creation disabled to prevent stranded files. Run /exe-doctor to audit.
+`
+  );
+  _shardingEnabled = false;
+  return false;
+}
 function isShardingEnabled() {
   return _shardingEnabled;
 }
@@ -7851,13 +8049,13 @@ function getShardClient(projectName) {
 }
 function shardExists(projectName) {
   const safeName = safeShardName(projectName);
-  return existsSync17(path21.join(SHARDS_DIR, `${safeName}.db`));
+  return existsSync18(path21.join(SHARDS_DIR, `${safeName}.db`));
 }
 function safeShardName(projectName) {
   return projectName.replace(/[^a-zA-Z0-9_-]/g, "_");
 }
 function listShards() {
-  if (!existsSync17(SHARDS_DIR)) return [];
+  if (!existsSync18(SHARDS_DIR)) return [];
   return readdirSync4(SHARDS_DIR).filter((f) => f.endsWith(".db")).map((f) => f.replace(".db", ""));
 }
 async function auditShardHealth(options = {}) {
@@ -7870,7 +8068,7 @@ async function auditShardHealth(options = {}) {
   const shards = [];
   for (const name of names) {
     const dbPath = path21.join(SHARDS_DIR, `${name}.db`);
-    const stat = statSync3(dbPath);
+    const stat = statSync4(dbPath);
     const item = {
       name,
       path: dbPath,
@@ -8110,6 +8308,17 @@ async function ensureShardSchema(client) {
   }
 }
 async function getReadyShardClient(projectName) {
+  if (!_keyValidated) {
+    if (!_keyValidationPromise) {
+      _keyValidationPromise = validateEncryptionKey();
+    }
+    const valid = await _keyValidationPromise;
+    if (!valid) {
+      throw new Error(
+        `Shard creation blocked: encryption key mismatch with existing shards. Run /exe-doctor to audit.`
+      );
+    }
+  }
   const safeName = safeShardName(projectName);
   let client = getShardClient(projectName);
   try {
@@ -8122,8 +8331,8 @@ async function getReadyShardClient(projectName) {
     _shards.delete(safeName);
     _shardLastAccess.delete(safeName);
     const dbPath = path21.join(SHARDS_DIR, `${safeName}.db`);
-    if (existsSync17(dbPath)) {
-      const stat = statSync3(dbPath);
+    if (existsSync18(dbPath)) {
+      const stat = statSync4(dbPath);
       const stamp = (/* @__PURE__ */ new Date()).toISOString().replace(/[:.]/g, "-");
       const archivedPath = path21.join(SHARDS_DIR, `${safeName}.db.broken-${stamp}`);
       renameSync4(dbPath, archivedPath);
@@ -8188,7 +8397,7 @@ function disposeShards() {
   _shardingEnabled = false;
   _encryptionKey = null;
 }
-var SHARDS_DIR, SHARD_IDLE_MS, MAX_OPEN_SHARDS, EVICTION_INTERVAL_MS, _shards, _shardLastAccess, _evictionTimer, _encryptionKey, _shardingEnabled;
+var SHARDS_DIR, SHARD_IDLE_MS, MAX_OPEN_SHARDS, EVICTION_INTERVAL_MS, _shards, _shardLastAccess, _evictionTimer, _encryptionKey, _shardingEnabled, _keyValidated, _keyValidationPromise;
 var init_shard_manager = __esm({
   "src/lib/shard-manager.ts"() {
     "use strict";
@@ -8202,6 +8411,8 @@ var init_shard_manager = __esm({
     _evictionTimer = null;
     _encryptionKey = null;
     _shardingEnabled = false;
+    _keyValidated = false;
+    _keyValidationPromise = null;
   }
 });
 
@@ -8397,6 +8608,18 @@ var init_platform_procedures = __esm({
         priority: "p0",
         content: "create_task is dispatch + delivery. Task lifecycle: open \u2192 in_progress (you start) \u2192 done (update_task when finished) \u2192 needs_review (reviewer nudged) \u2192 closed (COO only via close_task). DB is the reliable delivery \u2014 intercom is just a speedup nudge. If you finish a task, self-chain: check for next task immediately (step 7). Never wait for a nudge. Never say 'standing by.'"
       },
+      {
+        title: "Review chain \u2014 managers must actively pull completed work, never wait for nudges",
+        domain: "workflow",
+        priority: "p0",
+        content: "When you dispatch work, you OWN the review. Check list_tasks(status='needs_review') on EVERY prompt \u2014 don't wait for intercom nudges (they're unreliable). When a task shows needs_review: (1) read the deliverable (git diff in worktree, exe/output/ files, or task result summary), (2) verify it works (tsc, build, run), (3) close_task if good or create a fix task if not. Reviews sitting >30 minutes is a pipeline stall. The whole chain: worker calls update_task(done) \u2192 system flags needs_review \u2192 manager pulls and verifies \u2192 close_task \u2192 COO reviews manager's work \u2192 merge to main. Every level actively pulls \u2014 nobody waits."
+      },
+      {
+        title: "Bug fix lifecycle \u2014 triage upstream after every verified fix so customers see the status",
+        domain: "workflow",
+        priority: "p0",
+        content: "When a bug from support(action='list_bugs') is fixed and verified, the reviewer MUST triage it upstream: support(action='triage_bug', id='<bug-id>', notes='<what was fixed>', fixed_version='<version>', linked_commit='<hash>'). This closes the bug in the customer's view \u2014 their COO checks list_my_bugs and sees status change from open \u2192 closed with the fix version. Without triage, customers see 'open' forever even after the fix ships. Same for feature requests: support(action='triage_feature', ..., shipped_version='<version>'). Triage is part of the review gate \u2014 a fix is not done until the upstream report is closed."
+      },
       {
         title: "Intercom is a speedup, not delivery \u2014 DB is the source of truth",
         domain: "architecture",
@@ -8994,6 +9217,20 @@ __export(store_exports, {
   vectorToBlob: () => vectorToBlob,
   writeMemory: () => writeMemory
 });
+function logStoreDebug(context, err) {
+  if (_debugStore) {
+    process.stderr.write(
+      `[store] ${context}: ${err instanceof Error ? err.message : String(err)}
+`
+    );
+  }
+}
+function logStoreWarn(context, err) {
+  process.stderr.write(
+    `[store] WARN ${context}: ${err instanceof Error ? err.message : String(err)}
+`
+  );
+}
 function isBusyError2(err) {
   if (err instanceof Error) {
     const msg = err.message.toLowerCase();
@@ -9048,13 +9285,15 @@ async function initStore(options) {
   try {
     const { initDaemonClient: initDaemonClient2 } = await Promise.resolve().then(() => (init_database(), database_exports));
     await initDaemonClient2();
-  } catch {
+  } catch (e) {
+    logStoreWarn("catch", e);
   }
   if (!options?.lightweight) {
     try {
       const { initShardManager: initShardManager2 } = await Promise.resolve().then(() => (init_shard_manager(), shard_manager_exports));
       initShardManager2(hexKey);
-    } catch {
+    } catch (e) {
+      logStoreWarn("catch", e);
     }
     const client = getClient();
     const vResult = await retryOnBusy2(
@@ -9065,7 +9304,8 @@ async function initStore(options) {
     try {
       const { loadGlobalProcedures: loadGlobalProcedures2 } = await Promise.resolve().then(() => (init_global_procedures(), global_procedures_exports));
       await loadGlobalProcedures2();
-    } catch {
+    } catch (e) {
+      logStoreWarn("catch", e);
     }
   }
 }
@@ -9125,7 +9365,8 @@ async function writeMemory(record) {
       memoryType
     });
     if (existing) return;
-  } catch {
+  } catch (e) {
+    logStoreWarn("catch", e);
   }
   const dbRow = {
     id: record.id,
@@ -9326,12 +9567,14 @@ async function flushBatch() {
     try {
       const { insertMemoryCardsForBatch: insertMemoryCardsForBatch2 } = await Promise.resolve().then(() => (init_memory_cards(), memory_cards_exports));
       await insertMemoryCardsForBatch2(batch);
-    } catch {
+    } catch (e) {
+      logStoreWarn("catch", e);
     }
     try {
       const { insertOntologyForBatch: insertOntologyForBatch2 } = await Promise.resolve().then(() => (init_agentic_ontology(), agentic_ontology_exports));
       await insertOntologyForBatch2(batch);
-    } catch {
+    } catch (e) {
+      logStoreWarn("catch", e);
     }
     schedulePostWriteMemoryHygiene(batch.map((row) => row.id));
     _pendingRecords.splice(0, batch.length);
@@ -9370,7 +9613,8 @@ ${err.stack.split("\n").slice(1, 3).join("\n")}` : ""}` : String(err);
           }
         }
       }
-    } catch {
+    } catch (e) {
+      logStoreWarn("catch", e);
     }
     return batch.length;
   } finally {
@@ -9412,7 +9656,8 @@ async function searchMemories(queryVector, agentId, options) {
     } else {
       client = getClient();
     }
-  } catch {
+  } catch (e) {
+    logStoreDebug("shard routing fallback", e);
     client = getClient();
   }
   const limit = options?.limit ?? 10;
@@ -9528,7 +9773,8 @@ async function attachDocumentMetadata(records) {
       if (!record.document_id) continue;
       record.document_metadata = byId.get(record.document_id) ?? null;
     }
-  } catch {
+  } catch (e) {
+    logStoreWarn("catch", e);
   }
   return records;
 }
@@ -9589,11 +9835,12 @@ async function getMemoryCardinality(agentId) {
       args: [agentId]
     });
     return Number(result.rows[0]?.cnt) || 0;
-  } catch {
+  } catch (e) {
+    logStoreWarn("getMemoryCardinality", e);
     return 0;
   }
 }
-var INIT_MAX_RETRIES, INIT_RETRY_DELAY_MS, _pendingRecords, _batchSize, _flushIntervalMs, _flushTimer, _flushing, _nextVersion;
+var _debugStore, INIT_MAX_RETRIES, INIT_RETRY_DELAY_MS, _pendingRecords, _batchSize, _flushIntervalMs, _flushTimer, _flushing, _nextVersion;
 var init_store = __esm({
   "src/lib/store.ts"() {
     "use strict";
@@ -9603,6 +9850,7 @@ var init_store = __esm({
     init_config();
     init_state_bus();
     init_memory_write_governor();
+    _debugStore = process.env.EXE_DEBUG === "1";
     INIT_MAX_RETRIES = 3;
     INIT_RETRY_DELAY_MS = 1e3;
     _pendingRecords = [];
@@ -11369,8 +11617,8 @@ __export(whatsapp_accounts_exports, {
   loadAccounts: () => loadAccounts
 });
 import { readFileSync as readFileSync13 } from "fs";
-import { join as join2 } from "path";
-import { homedir as homedir2 } from "os";
+import { join as join3 } from "path";
+import { homedir as homedir3 } from "os";
 function loadAccounts() {
   if (cachedAccounts !== null) return cachedAccounts;
   try {
@@ -11408,7 +11656,7 @@ var CONFIG_PATH2, cachedAccounts;
 var init_whatsapp_accounts = __esm({
   "src/gateway/whatsapp-accounts.ts"() {
     "use strict";
-    CONFIG_PATH2 = join2(homedir2(), ".exe-os", "whatsapp-accounts.json");
+    CONFIG_PATH2 = join3(homedir3(), ".exe-os", "whatsapp-accounts.json");
     cachedAccounts = null;
   }
 });
@@ -15604,14 +15852,14 @@ var OllamaProvider = class {
 
 // src/gateway/adapters/whatsapp.ts
 import { randomUUID as randomUUID9 } from "crypto";
-import { homedir } from "os";
-import { join } from "path";
-import { mkdirSync as mkdirSync9 } from "fs";
+import { homedir as homedir2 } from "os";
+import { join as join2 } from "path";
+import { mkdirSync as mkdirSync10 } from "fs";
 var INITIAL_BACKOFF_MS = 1e3;
 var MAX_BACKOFF_MS = 3e5;
 var BACKOFF_MULTIPLIER = 2;
 var JITTER_FACTOR = 0.25;
-var AUTH_DIR = join(homedir(), ".exe-os", "whatsapp-auth");
+var AUTH_DIR = join2(homedir2(), ".exe-os", "whatsapp-auth");
 function createBaileysLogger(accountName) {
   const prefix = accountName ? `[whatsapp:${accountName}]` : "[whatsapp]";
   let logger;
@@ -15651,7 +15899,7 @@ var WhatsAppAdapter = class {
   disconnectedAt = 0;
   async connect(config2) {
     this.authDir = config2.credentials.authDir ?? AUTH_DIR;
-    mkdirSync9(this.authDir, { recursive: true });
+    mkdirSync10(this.authDir, { recursive: true });
     const baileys = await import("@whiskeysockets/baileys");
     const { makeWASocket, useMultiFileAuthState, fetchLatestBaileysVersion, DisconnectReason, makeCacheableSignalKeyStore } = baileys;
     const { state, saveCreds } = await useMultiFileAuthState(this.authDir);
@@ -17785,7 +18033,7 @@ async function ensureCRMContact(info) {
 }
 
 // src/automation/trigger-engine.ts
-import { readFileSync as readFileSync14, writeFileSync as writeFileSync9, existsSync as existsSync18, mkdirSync as mkdirSync10 } from "fs";
+import { readFileSync as readFileSync14, writeFileSync as writeFileSync9, existsSync as existsSync19, mkdirSync as mkdirSync11 } from "fs";
 import { randomUUID as randomUUID15 } from "crypto";
 import path23 from "path";
 import os15 from "os";
@@ -17843,7 +18091,7 @@ function evaluateConditions(conditions, record) {
   return conditions.every((c) => evaluateCondition(c, record));
 }
 function loadTriggers(project) {
-  if (!existsSync18(TRIGGERS_PATH)) return [];
+  if (!existsSync19(TRIGGERS_PATH)) return [];
   try {
     const raw = readFileSync14(TRIGGERS_PATH, "utf-8");
     const all = JSON.parse(raw);