@askexenow/exe-os 0.9.102 → 0.9.104

package/dist/lib/hybrid-search.js

@@ -1671,9 +1671,79 @@ __export(database_exports, {
   isInitialized: () => isInitialized,
   setExternalClient: () => setExternalClient
 });
-import { chmodSync as chmodSync2 } from "fs";
+import { chmodSync as chmodSync2, existsSync as existsSync6, statSync as statSync2, copyFileSync, unlinkSync as unlinkSync3, openSync as openSync2, closeSync as closeSync2, mkdirSync as mkdirSync2 } 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() {
+  mkdirSync2(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(config) {
+  acquireDbLock();
+  if (existsSync6(config.dbPath)) {
+    const dbStat = statSync2(config.dbPath);
+    if (dbStat.size === 0) {
+      const walPath = config.dbPath + "-wal";
+      if (existsSync6(walPath) && statSync2(walPath).size > 0) {
+        const backupPath = config.dbPath + ".zeroed-" + Date.now();
+        copyFileSync(config.dbPath, backupPath);
+        unlinkSync3(config.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 ${config.dbPath}.bak
+`
+        );
+      }
+    }
+  }
   if (_walCheckpointTimer) {
     clearInterval(_walCheckpointTimer);
     _walCheckpointTimer = null;
@@ -1700,10 +1770,8 @@ async function initDatabase(config) {
   _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(() => {
@@ -1718,11 +1786,16 @@ async function initDatabase(config) {
     for (const suffix of ["-wal", "-shm"]) {
       try {
         chmodSync2(config.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;
@@ -1777,7 +1850,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 (
@@ -1842,6 +1916,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,
@@ -1900,35 +1991,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({
@@ -1937,98 +2033,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 (
@@ -2133,14 +2243,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
@@ -2166,7 +2278,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 (
@@ -2190,7 +2303,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 (
@@ -2227,63 +2341,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",
@@ -2291,14 +2414,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(
@@ -2306,7 +2431,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 (
@@ -2382,7 +2508,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 (
@@ -2397,14 +2524,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 (
@@ -2503,7 +2632,8 @@ async function ensureSchema() {
         sql: `ALTER TABLE memories ADD COLUMN ${column}`,
         args: []
       });
-    } catch {
+    } catch (e) {
+      logCatchDebug("migration", e);
     }
   }
   for (const col of [
@@ -2512,7 +2642,8 @@ async function ensureSchema() {
   ]) {
     try {
       await client.execute(col);
-    } catch {
+    } catch (e) {
+      logCatchDebug("migration", e);
     }
   }
   await client.executeMultiple(`
@@ -2697,56 +2828,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(
@@ -2945,13 +3084,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({
@@ -2962,20 +3103,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",
@@ -2983,7 +3127,8 @@ async function ensureSchema() {
   ]) {
     try {
       await client.execute(col);
-    } catch {
+    } catch (e) {
+      logCatchDebug("migration", e);
     }
   }
   try {
@@ -2991,13 +3136,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",
@@ -3005,7 +3152,8 @@ async function ensureSchema() {
   ]) {
     try {
       await client.execute(col);
-    } catch {
+    } catch (e) {
+      logCatchDebug("migration", e);
     }
   }
   try {
@@ -3013,27 +3161,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",
@@ -3054,7 +3206,8 @@ async function ensureSchema() {
   ]) {
     try {
       await client.execute(col);
-    } catch {
+    } catch (e) {
+      logCatchDebug("migration", e);
     }
   }
   try {
@@ -3062,14 +3215,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() {
@@ -3080,7 +3235,8 @@ async function disposeDatabase() {
   if (_client) {
     try {
       await _client.execute("PRAGMA wal_checkpoint(PASSIVE)");
-    } catch {
+    } catch (e) {
+      logCatchDebug("WAL checkpoint", e);
     }
   }
   if (_daemonClient) {
@@ -3096,8 +3252,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";
@@ -3105,11 +3262,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;
@@ -3118,7 +3278,7 @@ var init_database = __esm({
 
 // src/lib/keychain.ts
 import { readFile as readFile3, writeFile as writeFile3, unlink, mkdir as mkdir3, chmod as chmod2 } from "fs/promises";
-import { existsSync as existsSync6, statSync as statSync2 } from "fs";
+import { existsSync as existsSync7, statSync as statSync3 } from "fs";
 import { execSync as execSync3 } from "child_process";
 import path6 from "path";
 import os5 from "os";
@@ -3153,7 +3313,7 @@ function isRootOnlyTrustedServerKeyFile(keyPath) {
   if (process.platform !== "linux") return false;
   try {
     const uid = typeof os5.userInfo().uid === "number" ? os5.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;
@@ -3354,7 +3514,7 @@ async function getMasterKey() {
     }
   }
   const keyPath = getKeyPath();
-  if (!existsSync6(keyPath)) {
+  if (!existsSync7(keyPath)) {
     process.stderr.write(
       `[keychain] Key not found at ${keyPath} (HOME=${os5.homedir()}, EXE_OS_DIR=${process.env.EXE_OS_DIR ?? "unset"})
 `
@@ -3689,18 +3849,54 @@ __export(shard_manager_exports, {
   shardExists: () => shardExists
 });
 import path7 from "path";
-import { existsSync as existsSync7, mkdirSync as mkdirSync2, readdirSync, renameSync as renameSync3, statSync as statSync3 } from "fs";
+import { existsSync as existsSync8, mkdirSync as mkdirSync3, readdirSync, renameSync as renameSync3, statSync as statSync4 } from "fs";
 import { createClient as createClient2 } from "@libsql/client";
 function initShardManager(encryptionKey) {
   _encryptionKey = encryptionKey;
-  if (!existsSync7(SHARDS_DIR)) {
-    mkdirSync2(SHARDS_DIR, { recursive: true });
+  _keyValidated = false;
+  _keyValidationPromise = null;
+  if (!existsSync8(SHARDS_DIR)) {
+    mkdirSync3(SHARDS_DIR, { recursive: true });
+  }
+  const existingShards = readdirSync(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 = readdirSync(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 = path7.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;
 }
@@ -3734,13 +3930,13 @@ function getShardClient(projectName) {
 }
 function shardExists(projectName) {
   const safeName = safeShardName(projectName);
-  return existsSync7(path7.join(SHARDS_DIR, `${safeName}.db`));
+  return existsSync8(path7.join(SHARDS_DIR, `${safeName}.db`));
 }
 function safeShardName(projectName) {
   return projectName.replace(/[^a-zA-Z0-9_-]/g, "_");
 }
 function listShards() {
-  if (!existsSync7(SHARDS_DIR)) return [];
+  if (!existsSync8(SHARDS_DIR)) return [];
   return readdirSync(SHARDS_DIR).filter((f) => f.endsWith(".db")).map((f) => f.replace(".db", ""));
 }
 async function auditShardHealth(options = {}) {
@@ -3753,7 +3949,7 @@ async function auditShardHealth(options = {}) {
   const shards = [];
   for (const name of names) {
     const dbPath = path7.join(SHARDS_DIR, `${name}.db`);
-    const stat = statSync3(dbPath);
+    const stat = statSync4(dbPath);
     const item = {
       name,
       path: dbPath,
@@ -3993,6 +4189,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 {
@@ -4005,8 +4212,8 @@ async function getReadyShardClient(projectName) {
     _shards.delete(safeName);
     _shardLastAccess.delete(safeName);
     const dbPath = path7.join(SHARDS_DIR, `${safeName}.db`);
-    if (existsSync7(dbPath)) {
-      const stat = statSync3(dbPath);
+    if (existsSync8(dbPath)) {
+      const stat = statSync4(dbPath);
       const stamp = (/* @__PURE__ */ new Date()).toISOString().replace(/[:.]/g, "-");
       const archivedPath = path7.join(SHARDS_DIR, `${safeName}.db.broken-${stamp}`);
       renameSync3(dbPath, archivedPath);
@@ -4071,7 +4278,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";
@@ -4085,6 +4292,8 @@ var init_shard_manager = __esm({
     _evictionTimer = null;
     _encryptionKey = null;
     _shardingEnabled = false;
+    _keyValidated = false;
+    _keyValidationPromise = null;
   }
 });
 
@@ -4280,6 +4489,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",
@@ -4877,6 +5098,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();
@@ -4931,13 +5166,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(
@@ -4948,7 +5185,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);
     }
   }
 }
@@ -5008,7 +5246,8 @@ async function writeMemory(record) {
       memoryType
     });
     if (existing) return;
-  } catch {
+  } catch (e) {
+    logStoreWarn("catch", e);
   }
   const dbRow = {
     id: record.id,
@@ -5209,12 +5448,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);
@@ -5253,7 +5494,8 @@ ${err.stack.split("\n").slice(1, 3).join("\n")}` : ""}` : String(err);
           }
         }
       }
-    } catch {
+    } catch (e) {
+      logStoreWarn("catch", e);
     }
     return batch.length;
   } finally {
@@ -5295,7 +5537,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;
@@ -5411,7 +5654,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;
 }
@@ -5472,11 +5716,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";
@@ -5486,6 +5731,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 = [];
@@ -5597,7 +5843,7 @@ __export(reranker_exports, {
   rerankWithScores: () => rerankWithScores
 });
 import path8 from "path";
-import { existsSync as existsSync8 } from "fs";
+import { existsSync as existsSync9 } from "fs";
 function resetIdleTimer() {
   if (_idleTimer) clearTimeout(_idleTimer);
   _idleTimer = setTimeout(() => {
@@ -5608,7 +5854,7 @@ function resetIdleTimer() {
   }
 }
 function isRerankerAvailable() {
-  return existsSync8(path8.join(MODELS_DIR, RERANKER_MODEL_FILE));
+  return existsSync9(path8.join(MODELS_DIR, RERANKER_MODEL_FILE));
 }
 function getRerankerModelPath() {
   return path8.join(MODELS_DIR, RERANKER_MODEL_FILE);
@@ -5619,7 +5865,7 @@ async function ensureLoaded() {
     return;
   }
   const modelPath = path8.join(MODELS_DIR, RERANKER_MODEL_FILE);
-  if (!existsSync8(modelPath)) {
+  if (!existsSync9(modelPath)) {
     throw new Error(
       `Reranker model not found at ${modelPath}. Run /exe-setup to download it.`
     );
@@ -5752,10 +5998,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: existsSync10 } = await import("fs");
+  const { existsSync: existsSync11 } = await import("fs");
   const path11 = await import("path");
   const modelPath = path11.join(MODELS_DIR2, "jina-embeddings-v5-small-q4_k_m.gguf");
-  if (!existsSync10(modelPath)) {
+  if (!existsSync11(modelPath)) {
     throw new Error(`Embedding model not found at ${modelPath}. Run '/exe-setup' to download it.`);
   }
   const llama = await llamaCpp.getLlama();
@@ -5840,7 +6086,7 @@ __export(file_grep_exports, {
   grepProjectFiles: () => grepProjectFiles
 });
 import { execSync as execSync5 } from "child_process";
-import { readFileSync as readFileSync5, readdirSync as readdirSync2, statSync as statSync4, existsSync as existsSync9 } from "fs";
+import { readFileSync as readFileSync5, readdirSync as readdirSync2, statSync as statSync5, existsSync as existsSync10 } from "fs";
 import path10 from "path";
 import crypto2 from "crypto";
 function hasRipgrep() {
@@ -5957,7 +6203,7 @@ function grepWithNodeFs(pattern, projectRoot, patterns) {
   for (const filePath of files.slice(0, MAX_FILES)) {
     const absPath = path10.join(projectRoot, filePath);
     try {
-      const stat = statSync4(absPath);
+      const stat = statSync5(absPath);
       if (stat.size > MAX_FILE_SIZE) continue;
       const content = readFileSync5(absPath, "utf8");
       const lines = content.split("\n");
@@ -6031,7 +6277,7 @@ function matchGlob(filePath, pattern) {
 function buildSnippet(hit, projectRoot) {
   try {
     const absPath = path10.join(projectRoot, hit.filePath);
-    if (!existsSync9(absPath)) return hit.matchLine;
+    if (!existsSync10(absPath)) return hit.matchLine;
     const lines = readFileSync5(absPath, "utf8").split("\n");
     const start = Math.max(0, hit.lineNumber - 3);
     const end = Math.min(lines.length, hit.lineNumber + 2);
@@ -6956,7 +7202,8 @@ function rrfMergeMulti(lists, limit, k = RRF_K, weights) {
     const confidence = sourceConfidence(e.record);
     const frecency = frecencyBoost(e.record.last_accessed, e.record.timestamp);
     const baseScore = e.rrfScore * 0.45 + recency * 0.24 + importance * 0.21 + confidence * 0.1;
-    const finalScore = baseScore * (1 + 0.3 * frecency);
+    const procedureBoost = e.record.memory_type === "procedure" ? 0.1 : 0;
+    const finalScore = (baseScore + procedureBoost) * (1 + 0.3 * frecency);
     return { score: finalScore, record: e.record };
   });
   return entries.sort((a, b) => b.score - a.score).slice(0, limit).map((e) => e.record);
@@ -7008,7 +7255,7 @@ async function ftsQuery(client, matchExpr, agentId, options, limit) {
                     m.importance, m.status, m.confidence, m.last_accessed,
                     m.workspace_id, m.document_id, m.user_id,
                     m.char_offset, m.page_number,
-                    m.source_path, m.source_type
+                    m.source_path, m.source_type, m.memory_type
              FROM memories m
              JOIN memories_fts fts ON m.rowid = fts.rowid
              WHERE memories_fts MATCH ?
@@ -7066,7 +7313,8 @@ async function ftsQuery(client, matchExpr, agentId, options, limit) {
     char_offset: row.char_offset ?? null,
     page_number: row.page_number ?? null,
     source_path: row.source_path ?? null,
-    source_type: row.source_type ?? null
+    source_type: row.source_type ?? null,
+    memory_type: row.memory_type ?? void 0
   }));
 }
 async function recentRecords(agentId, options, limit, textFilter) {
@@ -7091,7 +7339,7 @@ async function recentRecords(agentId, options, limit, textFilter) {
                        importance, status, confidence, last_accessed,
                        workspace_id, document_id, user_id,
                        char_offset, page_number,
-                       source_path, source_type
+                       source_path, source_type, memory_type
                 FROM memories
                 WHERE agent_id = ?
                   AND timestamp >= ? AND timestamp <= ?
@@ -7125,7 +7373,7 @@ async function recentRecords(agentId, options, limit, textFilter) {
                     importance, status, confidence, last_accessed,
                     workspace_id, document_id, user_id,
                     char_offset, page_number,
-                    source_path, source_type
+                    source_path, source_type, memory_type
              FROM memories
              WHERE agent_id = ?${statusFilter}${draftFilter}
                AND COALESCE(confidence, 0.7) >= 0.3`;
@@ -7200,7 +7448,8 @@ function rowToMemoryRecord(row) {
     char_offset: row.char_offset ?? null,
     page_number: row.page_number ?? null,
     source_path: row.source_path ?? null,
-    source_type: row.source_type ?? null
+    source_type: row.source_type ?? null,
+    memory_type: row.memory_type ?? void 0
   };
 }
 var KNOWN_TOOLS = /* @__PURE__ */ new Set([
@@ -7239,7 +7488,7 @@ async function trajectoryBypass(queryText, agentId, options, limit) {
                       importance, status, confidence, last_accessed,
                       workspace_id, document_id, user_id,
                       char_offset, page_number,
-                      source_path, source_type
+                      source_path, source_type, memory_type
                FROM memories
                WHERE trajectory IS NOT NULL
                  AND json_extract(trajectory, '$.tool') = ?
@@ -7285,7 +7534,8 @@ async function trajectoryBypass(queryText, agentId, options, limit) {
       char_offset: row.char_offset ?? null,
       page_number: row.page_number ?? null,
       source_path: row.source_path ?? null,
-      source_type: row.source_type ?? null
+      source_type: row.source_type ?? null,
+      memory_type: row.memory_type ?? void 0
     }));
   } catch {
     return null;