@askexenow/exe-os 0.9.166 → 0.9.167

package/dist/{chunk-T5YULDDO.js → chunk-FVI4UBKO.js}

@@ -1,11 +1,34 @@
 import {
   getClient
-} from "./chunk-5RSYY7BE.js";
+} from "./chunk-SJYOPYXH.js";
 
 // src/lib/session-kill-telemetry.ts
 import crypto from "crypto";
+import { appendFileSync } from "fs";
+import path from "path";
+import os from "os";
+var KILL_FILE_LOG = path.join(os.homedir(), ".exe-os", "logs", "session-kills.jsonl");
 var TOKENS_PER_IDLE_MINUTE = 50;
 async function recordSessionKill(input) {
+  const killedAt = (/* @__PURE__ */ new Date()).toISOString();
+  const id = crypto.randomUUID();
+  try {
+    const logEntry = JSON.stringify({
+      id,
+      timestamp: killedAt,
+      session: input.sessionName,
+      agent: input.agentId,
+      reason: input.reason,
+      ticksIdle: input.ticksIdle ?? null,
+      tokensSaved: input.estimatedTokensSaved ?? null
+    });
+    appendFileSync(KILL_FILE_LOG, logEntry + "\n");
+  } catch {
+    process.stderr.write(
+      `[session-kill-telemetry] file log write failed for ${input.sessionName}
+`
+    );
+  }
   try {
     const client = getClient();
     await client.execute({
@@ -14,10 +37,10 @@ async function recordSessionKill(input) {
                ticks_idle, estimated_tokens_saved)
             VALUES (?, ?, ?, ?, ?, ?, ?)`,
       args: [
-        crypto.randomUUID(),
+        id,
         input.sessionName,
         input.agentId,
-        (/* @__PURE__ */ new Date()).toISOString(),
+        killedAt,
         input.reason,
         input.ticksIdle ?? null,
         input.estimatedTokensSaved ?? null
@@ -25,7 +48,7 @@ async function recordSessionKill(input) {
     });
   } catch (err) {
     process.stderr.write(
-      `[session-kill-telemetry] write failed: ${err instanceof Error ? err.message : String(err)}
+      `[session-kill-telemetry] DB write failed: ${err instanceof Error ? err.message : String(err)}
 `
     );
   }

package/dist/{chunk-ESRI7MFI.js → chunk-GAN7PW6G.js}

@@ -54,7 +54,7 @@ var ToolCapabilityIndex = class {
    * @param registerFn - function that registers tools on a server (e.g. registerAllTools)
    * @param categoryMap - optional map of registerFnName → category (from tool-gates TOOL_CATEGORIES)
    */
-  async buildIndex(registerFn, categoryMap) {
+  async buildIndex(registerFn, categoryMap, directEmbedFn) {
     const captured = [];
     const fakeServer = {
       registerTool(name, config, _handler) {
@@ -66,35 +66,39 @@ var ToolCapabilityIndex = class {
       }
     };
     registerFn(fakeServer);
-    let embedFn = null;
-    try {
-      const { embed } = await import("./lib/embedder.js");
-      const test = await embed("test");
-      if (test.length === EMBEDDING_DIM) {
-        embedFn = embed;
-      }
-    } catch {
-    }
-    const capabilities = [];
+    const capabilityDocs = [];
     for (const tool of captured) {
       const paramSummary = extractParamNames(tool.inputSchema);
       const category = categoryMap ? categoryForToolName(tool.name, categoryMap) : "unknown";
-      const capabilityDoc = `${tool.name}: ${tool.description}. Parameters: ${paramSummary}`;
-      let vector = null;
-      if (embedFn) {
-        try {
-          vector = await embedFn(capabilityDoc);
-        } catch {
+      const doc = `${tool.name}: ${tool.description}. Parameters: ${paramSummary}`;
+      capabilityDocs.push({ name: tool.name, description: tool.description, category, paramSummary, doc });
+    }
+    let vectors = capabilityDocs.map(() => null);
+    try {
+      if (directEmbedFn) {
+        const allVectors = await directEmbedFn(capabilityDocs.map((c) => c.doc));
+        vectors = allVectors.map((v) => v.length === EMBEDDING_DIM ? v : null);
+      } else {
+        const { embed } = await import("./lib/embedder.js");
+        const test = await embed("test");
+        if (test.length === EMBEDDING_DIM) {
+          for (let i = 0; i < capabilityDocs.length; i++) {
+            try {
+              vectors[i] = await embed(capabilityDocs[i].doc);
+            } catch {
+            }
+          }
         }
       }
-      capabilities.push({
-        name: tool.name,
-        description: tool.description,
-        category,
-        vector,
-        paramSummary
-      });
+    } catch {
     }
+    const capabilities = capabilityDocs.map((c, i) => ({
+      name: c.name,
+      description: c.description,
+      category: c.category,
+      vector: vectors[i] ?? null,
+      paramSummary: c.paramSummary
+    }));
     this.capabilities = capabilities;
     this.initialized = true;
     process.stderr.write(

package/dist/{chunk-K4OWYJSP.js → chunk-GM2WZTG3.js}

@@ -1,9 +1,9 @@
 import {
   storeBehavior
-} from "./chunk-PJGHBANY.js";
+} from "./chunk-TTJE7CCU.js";
 import {
   getClient
-} from "./chunk-5RSYY7BE.js";
+} from "./chunk-SJYOPYXH.js";
 import {
   loadConfig
 } from "./chunk-4GXRETYL.js";

package/dist/{chunk-TAB5QGIK.js → chunk-GZYQTPTF.js}

@@ -1,13 +1,13 @@
 import {
   deactivateBehavior
-} from "./chunk-PJGHBANY.js";
+} from "./chunk-TTJE7CCU.js";
 import {
   getActiveAgent
-} from "./chunk-6WG2VIKC.js";
+} from "./chunk-LM7H6XU4.js";
 import {
   canCoordinate,
   getClient
-} from "./chunk-5RSYY7BE.js";
+} from "./chunk-SJYOPYXH.js";
 
 // src/mcp/tools/deactivate-behavior.ts
 import { z } from "zod";

package/dist/{chunk-CXDU5DE3.js → chunk-IAUNGATJ.js}

@@ -1,7 +1,7 @@
 import {
   getCurrentSessionScope,
   strictSessionScopeFilter
-} from "./chunk-W7SDGBEC.js";
+} from "./chunk-MFI5OXYW.js";
 import {
   getProjectName
 } from "./chunk-OPU3NYOO.js";

package/dist/{chunk-YS63NS6M.js → chunk-IHSM5GR4.js}

@@ -1,6 +1,6 @@
 import {
   loadEmployees
-} from "./chunk-5RSYY7BE.js";
+} from "./chunk-SJYOPYXH.js";
 
 // src/lib/agent-symlinks.ts
 import os from "os";

package/dist/{chunk-23PTS2ZD.js → chunk-IP7KJAUW.js}

@@ -3,14 +3,13 @@ import {
   buildRawVisibilityFilter,
   buildWikiScopeFilter,
   searchMemories
-} from "./chunk-6BURHBE6.js";
+} from "./chunk-ZXB44R3E.js";
 import {
   getClient
-} from "./chunk-5RSYY7BE.js";
+} from "./chunk-SJYOPYXH.js";
 
 // src/lib/hybrid-search.ts
 var RRF_K = 60;
-var lastSearchDegraded = false;
 var _cardinalityCache = /* @__PURE__ */ new Map();
 var CARDINALITY_TTL_MS = 6e4;
 async function getCachedCardinality(agentId) {
@@ -49,6 +48,76 @@ function appendMemoryTypeFilter(sql, args, column, options) {
   }
   return sql;
 }
+async function graphSearch(query, agentId, _options, limit) {
+  const client = getClient();
+  const queryWords = query.toLowerCase().split(/\s+/).filter((w) => w.length >= 3).map((w) => w.replace(/[^a-z0-9_-]/g, "")).filter((w) => w.length >= 3);
+  if (queryWords.length === 0) return [];
+  let entityIds = [];
+  try {
+    const matchExpr = queryWords.map((w) => `${w}*`).join(" OR ");
+    const ftsResult = await client.execute({
+      sql: `SELECT e.id FROM entities e
+            JOIN entities_fts fts ON e.rowid = fts.rowid
+            WHERE entities_fts MATCH ?
+            ORDER BY rank LIMIT 10`,
+      args: [matchExpr]
+    });
+    entityIds = ftsResult.rows.map((r) => String(r.id));
+  } catch {
+    try {
+      const conditions = queryWords.map(() => `LOWER(name) LIKE ?`);
+      const args = queryWords.map((w) => `%${w}%`);
+      const likeResult = await client.execute({
+        sql: `SELECT id FROM entities WHERE ${conditions.join(" OR ")} LIMIT 10`,
+        args: [...args]
+      });
+      entityIds = likeResult.rows.map((r) => String(r.id));
+    } catch {
+      return [];
+    }
+  }
+  if (entityIds.length === 0) return [];
+  const allEntityIds = new Set(entityIds);
+  try {
+    const placeholders2 = entityIds.map(() => "?").join(",");
+    const neighborResult = await client.execute({
+      sql: `SELECT DISTINCT target_entity_id FROM relationships
+            WHERE source_entity_id IN (${placeholders2})
+            UNION
+            SELECT DISTINCT source_entity_id FROM relationships
+            WHERE target_entity_id IN (${placeholders2})
+            LIMIT 30`,
+      args: [...entityIds, ...entityIds]
+    });
+    for (const row of neighborResult.rows) {
+      allEntityIds.add(String(row.target_entity_id ?? row.source_entity_id));
+    }
+  } catch {
+  }
+  const entityIdArr = Array.from(allEntityIds);
+  const placeholders = entityIdArr.map(() => "?").join(",");
+  try {
+    const memResult = await client.execute({
+      sql: `SELECT DISTINCT m.id, m.agent_id, m.agent_role, m.session_id, m.timestamp,
+                   m.tool_name, m.project_name, m.has_error, m.raw_text, m.vector,
+                   m.task_id, 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.memory_type, m.strength
+            FROM memories m
+            JOIN entity_memories em ON m.id = em.memory_id
+            WHERE em.entity_id IN (${placeholders})
+              AND (m.agent_id = ? OR m.agent_id = 'wiki')
+              AND COALESCE(m.status, 'active') = 'active'
+              AND COALESCE(m.confidence, 0.7) >= 0.3
+            ORDER BY m.importance DESC, m.timestamp DESC
+            LIMIT ?`,
+      args: [...entityIdArr, agentId, limit]
+    });
+    return memResult.rows.map((row) => rowToMemoryRecord(row));
+  } catch {
+    return [];
+  }
+}
 function extractEntitySubqueries(query) {
   const subqueries = [];
   const quoted = query.match(/"([^"]+)"/g);
@@ -174,9 +243,7 @@ async function hybridSearch(queryText, agentId, options) {
   try {
     const { embed } = await import("./lib/embedder.js");
     queryVector = await embed(effectiveQuery);
-    lastSearchDegraded = false;
   } catch {
-    lastSearchDegraded = true;
     if (!process.env.VITEST) {
       process.stderr.write("[hybrid-search] Embed daemon unavailable \u2014 FTS-only mode\n");
     }
@@ -203,12 +270,18 @@ async function hybridSearch(queryText, agentId, options) {
     (sq) => lightweightSearch(sq, agentId, { ...fetchOptions, limit: Math.min(fetchLimit, 20) }).catch(() => [])
   );
   const includeStructuredCards = effectiveIsBroad || effectiveOptions.includeStructuredCards === true;
-  const [ftsResults, vectorResults, cardResults, reflectionResults, grepResults, ...subqueryResults] = await Promise.all([
+  const [ftsResults, vectorResults, graphResults, cardResults, reflectionResults, grepResults, ...subqueryResults] = await Promise.all([
     lightweightSearch(effectiveQuery, agentId, fetchOptions),
     queryVector ? searchMemories(queryVector, agentId, fetchOptions) : Promise.resolve([]),
+    // Graph search: first-class parallel signal via entity → memory linkage.
+    // Non-blocking with 2s timeout — graph is a bonus, not a requirement.
+    Promise.race([
+      graphSearch(effectiveQuery, agentId, fetchOptions, Math.min(fetchLimit, 20)),
+      new Promise((resolve) => setTimeout(() => resolve([]), 2e3))
+    ]).catch(() => []),
     includeStructuredCards ? (async () => {
       try {
-        const { searchMemoryCards } = await import("./memory-cards-V3DKSRWL.js");
+        const { searchMemoryCards } = await import("./memory-cards-SFDKDIAW.js");
         return await searchMemoryCards(effectiveQuery, agentId, fetchOptions);
       } catch {
         return [];
@@ -217,7 +290,7 @@ async function hybridSearch(queryText, agentId, options) {
     // Reflection insights: patterns, contradictions, summaries across sessions
     includeStructuredCards ? (async () => {
       try {
-        const { searchReflections } = await import("./memory-reflection-HTDAUUE5.js");
+        const { searchReflections } = await import("./memory-reflection-MTPRQNI6.js");
         const insights = await searchReflections(effectiveQuery, agentId, 5);
         return insights.map((ins) => ({
           id: ins.id,
@@ -235,6 +308,24 @@ async function hybridSearch(queryText, agentId, options) {
     grepPromise,
     ...subqueryPromises
   ]);
+  for (const r of ftsResults) {
+    r._source = "fts";
+  }
+  for (const r of vectorResults) {
+    r._source = "embed";
+  }
+  for (const r of graphResults) {
+    r._source = "graph";
+  }
+  for (const r of cardResults) {
+    r._source = "card";
+  }
+  for (const r of reflectionResults) {
+    r._source = "reflection";
+  }
+  for (const r of grepResults) {
+    r._source = "grep";
+  }
   const lists = [];
   const weights = [];
   if (ftsResults.length > 0) {
@@ -245,6 +336,10 @@ async function hybridSearch(queryText, agentId, options) {
     lists.push(vectorResults);
     weights.push(1);
   }
+  if (graphResults.length > 0) {
+    lists.push(graphResults);
+    weights.push(0.9);
+  }
   if (reflectionResults.length > 0) {
     lists.push(reflectionResults);
     weights.push(0.65);
@@ -271,7 +366,7 @@ async function hybridSearch(queryText, agentId, options) {
   let entityBoostRan = false;
   if (merged.length > 0) {
     try {
-      const { applyEntityBoost } = await import("./entity-boost-GHFPE6A2.js");
+      const { applyEntityBoost } = await import("./entity-boost-5FIRFRDC.js");
       const boosted = await applyEntityBoost(merged, effectiveQuery, getClient());
       merged = boosted.results;
       graphContextMap = boosted.graphContext;
@@ -340,6 +435,7 @@ async function hybridSearch(queryText, agentId, options) {
       signals: {
         fts: ftsResults.length,
         vector: vectorResults.length,
+        graph: graphResults.length,
         cards: cardResults.length,
         reflections: reflectionResults.length,
         grep: grepResults.length,
@@ -472,11 +568,17 @@ function rrfMergeMulti(lists, limit, k = RRF_K, weights) {
     const weight = weights?.[listIdx] ?? 1;
     for (let i = 0; i < list.length; i++) {
       const rec = list[i];
-      const entry = scores.get(rec.id) ?? { rrfScore: 0, record: rec };
+      const entry = scores.get(rec.id) ?? { rrfScore: 0, record: rec, sources: /* @__PURE__ */ new Set() };
       entry.rrfScore += weight * (1 / (k + i + 1));
+      if (rec._source) entry.sources.add(rec._source);
       scores.set(rec.id, entry);
     }
   }
+  for (const entry of scores.values()) {
+    if (entry.sources.size > 0) {
+      entry.record._source = Array.from(entry.sources).sort().join("+");
+    }
+  }
   const entries = Array.from(scores.values()).map((e) => {
     const recency = recencyScore(e.record.timestamp);
     const importance = normalizedImportance(e.record.importance);
@@ -593,10 +695,11 @@ async function lightweightSearch(queryText, agentId, options) {
   }
   const prefixTerms = terms.map((t) => `${t}*`);
   const useAnd = terms.length >= 3;
-  const matchExpr = useAnd ? prefixTerms.join(" AND ") : prefixTerms.join(" OR ");
+  const innerExpr = useAnd ? prefixTerms.join(" AND ") : prefixTerms.join(" OR ");
+  const matchExpr = `{raw_text keywords}: ${innerExpr}`;
   const results = await ftsQuery(client, matchExpr, agentId, options, limit);
   if (useAnd && results.length < limit) {
-    const orExpr = prefixTerms.join(" OR ");
+    const orExpr = `{raw_text keywords}: ${prefixTerms.join(" OR ")}`;
     const orResults = await ftsQuery(client, orExpr, agentId, options, limit);
     const seen = new Set(results.map((r) => r.id));
     for (const r of orResults) {
@@ -611,7 +714,7 @@ async function lightweightSearch(queryText, agentId, options) {
   }
   if (options?.includeStructuredCards !== true) return results;
   try {
-    const { searchMemoryCards } = await import("./memory-cards-V3DKSRWL.js");
+    const { searchMemoryCards } = await import("./memory-cards-SFDKDIAW.js");
     const cardResults = await searchMemoryCards(queryText, agentId, options);
     if (cardResults.length > 0) {
       return rrfMergeMulti([results, cardResults], limit, RRF_K, [1, 0.85]);
@@ -672,7 +775,7 @@ async function ftsQuery(client, matchExpr, agentId, options, limit) {
     sql += ` AND (m.session_scope = ? OR m.session_scope IS NULL)`;
     args.push(options.sessionScope);
   }
-  sql += ` ORDER BY rank LIMIT ?`;
+  sql += ` ORDER BY bm25(memories_fts, 1.0, 3.0) LIMIT ?`;
   args.push(limit);
   let result;
   try {
@@ -969,7 +1072,6 @@ async function trajectoryBypass(queryText, agentId, options, limit) {
 }
 
 export {
-  lastSearchDegraded,
   hybridSearch,
   estimateCardinality,
   rrfMerge,

package/dist/{chunk-D6IMJAV2.js → chunk-J64P2LB2.js}

@@ -1,10 +1,10 @@
 import {
   initStore
-} from "./chunk-6BURHBE6.js";
+} from "./chunk-ZXB44R3E.js";
 import {
   getClient,
   isInitialized
-} from "./chunk-5RSYY7BE.js";
+} from "./chunk-SJYOPYXH.js";
 
 // src/lib/schedules.ts
 import crypto from "crypto";

package/dist/{chunk-CXAVSQZM.js → chunk-JXMSCKRM.js}

@@ -1,6 +1,6 @@
 import {
   completeReminder
-} from "./chunk-TH22QIEC.js";
+} from "./chunk-6A4COFDG.js";
 
 // src/mcp/tools/complete-reminder.ts
 import { z } from "zod";

package/dist/{chunk-RQMK3IQH.js → chunk-K4OTJP6N.js}

@@ -1,9 +1,13 @@
 import {
   vectorToBlob
-} from "./chunk-6BURHBE6.js";
+} from "./chunk-ZXB44R3E.js";
+import {
+  extractKeywords,
+  keywordsToString
+} from "./chunk-CHCA3ZM2.js";
 import {
   isCoordinatorName
-} from "./chunk-5RSYY7BE.js";
+} from "./chunk-SJYOPYXH.js";
 
 // src/lib/consolidation.ts
 import { randomUUID } from "crypto";
@@ -131,6 +135,8 @@ ${snippets}
 
 ${rolePrompt}
 
+IMPORTANT: Preserve all specific names, file paths, technical terms, and proper nouns exactly as they appear. Front-load the most important terms in the first sentence of your summary. Never replace specific terms with generic descriptions (e.g. write "hybrid-search.ts" not "the search file", write "extractKeywords" not "the extraction function").
+
 Format each as a single sentence. Be specific \u2014 include file names,
 function names, and concrete details. Skip if no insight for a category.`;
 }
@@ -162,14 +168,15 @@ ${synthesisText}`;
   const memoryType = dominantMemoryType(cluster.memories);
   const scopes = new Set(cluster.memories.map((m) => m.session_scope ?? null));
   const sessionScope = scopes.size === 1 ? cluster.memories[0]?.session_scope ?? null : null;
+  const keywords = keywordsToString(extractKeywords(rawText));
   const insertSql = vector ? `INSERT INTO memories
         (id, agent_id, agent_role, session_id, timestamp,
-         tool_name, project_name, has_error, raw_text, vector, version, consolidated, importance, memory_type, session_scope)
-        VALUES (?, ?, 'consolidation', 'daemon-consolidation', ?, 'consolidation', ?, 0, ?, vector32(?), 0, 1, 9, ?, ?)` : `INSERT INTO memories
+         tool_name, project_name, has_error, raw_text, vector, version, consolidated, importance, memory_type, session_scope, keywords)
+        VALUES (?, ?, 'consolidation', 'daemon-consolidation', ?, 'consolidation', ?, 0, ?, vector32(?), 0, 1, 9, ?, ?, ?)` : `INSERT INTO memories
         (id, agent_id, agent_role, session_id, timestamp,
-         tool_name, project_name, has_error, raw_text, vector, version, consolidated, importance, memory_type, session_scope)
-        VALUES (?, ?, 'consolidation', 'daemon-consolidation', ?, 'consolidation', ?, 0, ?, NULL, 0, 1, 9, ?, ?)`;
-  const insertArgs = vector ? [consolidatedId, cluster.agentId, now, cluster.projectName, rawText, vectorToBlob(vector), memoryType, sessionScope] : [consolidatedId, cluster.agentId, now, cluster.projectName, rawText, memoryType, sessionScope];
+         tool_name, project_name, has_error, raw_text, vector, version, consolidated, importance, memory_type, session_scope, keywords)
+        VALUES (?, ?, 'consolidation', 'daemon-consolidation', ?, 'consolidation', ?, 0, ?, NULL, 0, 1, 9, ?, ?, ?)`;
+  const insertArgs = vector ? [consolidatedId, cluster.agentId, now, cluster.projectName, rawText, vectorToBlob(vector), memoryType, sessionScope, keywords] : [consolidatedId, cluster.agentId, now, cluster.projectName, rawText, memoryType, sessionScope, keywords];
   await client.execute({ sql: insertSql, args: insertArgs });
   const sourceIds = cluster.memories.map((m) => m.id);
   const linkStmts = sourceIds.map((sourceId) => ({

package/dist/{chunk-L7ROZR2H.js → chunk-KXAUMIOX.js}

@@ -1,6 +1,6 @@
 import {
   loadEmployeesSync
-} from "./chunk-5RSYY7BE.js";
+} from "./chunk-SJYOPYXH.js";
 
 // src/adapters/mcp-http-config.ts
 import { chmodSync, existsSync, mkdirSync, readFileSync, writeFileSync } from "fs";

package/dist/{chunk-TPC3LAP7.js → chunk-LGY2BIOT.js}

@@ -193,6 +193,13 @@ var PLATFORM_PROCEDURES = [
     priority: "p1",
     content: "Fresh install: `npm install -g @askexenow/exe-os` then run `exe` to start the setup wizard. The wizard prompts for: encryption passphrase (creates master key), license key (exe_sk_* from AskExe team), COO name, and optional team members. No license key = free tier (1 employee, 5K memories). After setup: hooks install automatically, MCP server registers in ~/.claude.json, daemon starts. Verify health: run `exe-os healthcheck` or use mcp_ping() tool."
   },
+  // --- Observability ---
+  {
+    title: "Daemon logs and session lifecycle \u2014 full transparency for debugging",
+    domain: "operations",
+    priority: "p1",
+    content: "The exe-os daemon logs EVERYTHING to ~/.exe-os/logs/exed-launchd.log. This is your primary debugging tool. What you can see: (1) Session spawns \u2014 when and why each employee session started. (2) Idle kill decisions \u2014 which sessions were killed, why, how many idle ticks elapsed. (3) Graceful shutdown \u2014 agents get a 90-second warning before idle kill to store memories and checkpoint. (4) Event loop health \u2014 if the daemon blocks >3s, it logs a warning; >10s logs CRITICAL with duration. (5) Task enforcement \u2014 every 60s, logs each agent's state (open tasks, pane idle/active, action taken). (6) Intercom delivery \u2014 every message sent/queued/failed with timestamps and reasons. (7) MCP sessions \u2014 connections, disconnections, duplicate evictions, session cap events. (8) Cloud sync \u2014 push/pull counts, errors, version conflicts. To read logs: `tail -100 ~/.exe-os/logs/exed-launchd.log` or use /exe-doctor which checks logs automatically. Enforcement audit trail: ~/.exe-os/enforcement-audit.jsonl (structured JSONL, every nudge decision). If an agent seems stuck or was killed unexpectedly, READ THE LOGS FIRST before reporting a bug. The system is fully transparent \u2014 no black box behavior. If you can't explain what happened from the logs, THAT is the bug."
+  },
   // --- Operations ---
   {
     title: "Managers must supervise deployed workers",
@@ -224,6 +231,12 @@ var PLATFORM_PROCEDURES = [
     priority: "p0",
     content: "Before broad repo exploration, symbol tracing, blast-radius review, or codebase Q&A, agents MUST use code_context and graph MCP tools instead of manual grep/read loops. code_context: action=index or stats to refresh/check the index; action=search with query, limit, offset, languages, paths, refresh_index for fresh multi-language code/doc search; action=trace for symbol imports/dependents; action=blast_radius for impact analysis before edits. graph: action=query_relationships to find entity connections; action=hot_entities for most-referenced entities; action=entity_neighbors to explore direct connections; action=stats for entity/relationship counts. NEVER brute-force grep a codebase without checking code_context first \u2014 the index has every file, every symbol, every import relationship. All entity relationships should be mapped in the graph relations database. CLI parity exists via exe-os code-context init|index|status|stats|search|doctor. Keep code_context separate from durable employee memory: promote only validated decisions, procedures, or lessons into store_memory/commit_memory."
   },
+  {
+    title: "Retrieval architecture \u2014 three pillars, embeddings optional",
+    domain: "tool-use",
+    priority: "p1",
+    content: "Exe OS retrieval has THREE equal pillars: (1) Keyword search (FTS5 full-text), (2) Graph search (entity relationships), (3) Vector search (embedding similarity). All three run in parallel on every recall \u2014 results merge via Reciprocal Rank Fusion. CRITICAL: Keyword + Graph are FIRST-CLASS, not fallbacks. On 8-16 GB machines where the embedding model cannot load, retrieval is STILL excellent using FTS5 + Graph alone. The embed daemon is optional \u2014 when unavailable, the system automatically runs in FTS-only mode with graph boost. You lose semantic similarity (finding conceptually related but differently-worded memories) but keyword matching, entity traversal, bi-temporal filtering, and retrieval_mode all work perfectly. Do NOT tell users they need to download or run the embedding model to use memory effectively. Do NOT treat 'Embed daemon unavailable' warnings as errors \u2014 the system is working as designed. For 8 GB RAM: FTS + Graph only (no model). For 16 GB: FTS + Graph + optional 0.6B model if user opts in via /exe-setup. For 32+ GB: full hybrid with 4B model. The experience degrades gracefully \u2014 never breaks."
+  },
   {
     title: "Commit discipline \u2014 commit after every completed track, never batch",
     domain: "workflow",

package/dist/{chunk-RPIDSBK7.js → chunk-LLHRJEE4.js}

@@ -1,9 +1,9 @@
 import {
   updateTask
-} from "./chunk-ZWS6XQER.js";
+} from "./chunk-F5AKOE4P.js";
 import {
   TASK_ALREADY_CLAIMED_PREFIX
-} from "./chunk-W7SDGBEC.js";
+} from "./chunk-MFI5OXYW.js";
 
 // src/mcp/tools/update-task.ts
 import { z } from "zod";
@@ -23,7 +23,7 @@ function registerUpdateTask(server) {
       const status = rawStatus;
       let callerAgentId;
       try {
-        const { getActiveAgent: getAgent } = await import("./active-agent-CYMM3QQA.js");
+        const { getActiveAgent: getAgent } = await import("./active-agent-HVMLG6FH.js");
         callerAgentId = getAgent().agentId;
       } catch {
       }

package/dist/{chunk-6WG2VIKC.js → chunk-LM7H6XU4.js}

@@ -9,7 +9,7 @@ import {
   getCoordinatorEmployee,
   getEmployee,
   loadEmployeesSync
-} from "./chunk-5RSYY7BE.js";
+} from "./chunk-SJYOPYXH.js";
 import {
   EXE_AI_DIR
 } from "./chunk-4GXRETYL.js";