@askexenow/exe-os 0.9.35 → 0.9.36

package/dist/mcp/server.js

@@ -3743,6 +3743,7 @@ async function runPostWriteMemoryHygiene(memoryId) {
   }
 }
 function schedulePostWriteMemoryHygiene(memoryIds) {
+  if (process.env.EXE_SKIP_MEMORY_HYGIENE === "1") return;
   if (memoryIds.length === 0) return;
   const run = () => {
     void Promise.all(memoryIds.map((id) => runPostWriteMemoryHygiene(id)));
@@ -4137,7 +4138,7 @@ var init_platform_procedures = __esm({
         title: "Chain of command \u2014 who talks to whom",
         domain: "workflow",
         priority: "p0",
-        content: "Founder -> COO -> CTO/CMO. CTO -> engineers. CMO -> content production. Never skip levels: the COO does not bypass managers for specialist work. Specialists report to their manager. If you need cross-team info, use ask_team_memory \u2014 don't read other agents' task folders. Each level owns dispatch downward and review upward."
+        content: "Founder -> coordinator (the executive agent, internally routed as 'COO') -> CTO/CMO. CTO -> engineers. CMO -> content production. Never skip levels: the coordinator does not bypass managers for specialist work. Specialists report to their manager. If you need cross-team info, use ask_team_memory \u2014 don't read other agents' task folders. Each level owns dispatch downward and review upward."
       },
       {
         title: "Single dispatch path \u2014 create_task only",
@@ -4809,7 +4810,11 @@ async function searchMemories(queryVector, agentId, options) {
     sql += ` AND timestamp >= ?`;
     args.push(options.since);
   }
-  if (options?.memoryType) {
+  if (options?.memoryTypes && options.memoryTypes.length > 0) {
+    const uniqueTypes = [...new Set(options.memoryTypes)];
+    sql += ` AND memory_type IN (${uniqueTypes.map(() => "?").join(",")})`;
+    args.push(...uniqueTypes);
+  } else if (options?.memoryType) {
     sql += ` AND memory_type = ?`;
     args.push(options.memoryType);
   }
@@ -6039,6 +6044,17 @@ __export(hybrid_search_exports, {
   rrfMerge: () => rrfMerge,
   rrfMergeMulti: () => rrfMergeMulti
 });
+function appendMemoryTypeFilter(sql, args, column, options) {
+  if (options?.memoryTypes && options.memoryTypes.length > 0) {
+    const uniqueTypes = [...new Set(options.memoryTypes)];
+    sql += ` AND ${column} IN (${uniqueTypes.map(() => "?").join(",")})`;
+    args.push(...uniqueTypes);
+  } else if (options?.memoryType) {
+    sql += ` AND ${column} = ?`;
+    args.push(options.memoryType);
+  }
+  return sql;
+}
 async function hybridSearch(queryText, agentId, options) {
   const { loadConfig: loadConfig2 } = await Promise.resolve().then(() => (init_config(), config_exports));
   const config2 = await loadConfig2();
@@ -6267,6 +6283,7 @@ async function estimateCardinality(agentId, options) {
     sql += ` AND timestamp >= ?`;
     args.push(options.since);
   }
+  sql = appendMemoryTypeFilter(sql, args, "memory_type", options);
   try {
     const result = await client.execute({ sql, args });
     return Number(result.rows[0]?.cnt) || 0;
@@ -6388,10 +6405,7 @@ async function ftsQuery(client, matchExpr, agentId, options, limit) {
     sql += ` AND m.timestamp >= ?`;
     args.push(options.since);
   }
-  if (options?.memoryType) {
-    sql += ` AND m.memory_type = ?`;
-    args.push(options.memoryType);
-  }
+  sql = appendMemoryTypeFilter(sql, args, "m.memory_type", options);
   sql += ` ORDER BY rank LIMIT ?`;
   args.push(limit);
   const result = await client.execute({ sql, args });
@@ -6448,9 +6462,16 @@ async function recentRecords(agentId, options, limit, textFilter) {
                   AND timestamp >= ? AND timestamp <= ?
                   AND COALESCE(status, 'active') = 'active'
                   AND ${options?.includeRaw === false ? "COALESCE(memory_type, 'raw') != 'raw'" : "1 = 1"}
+                  ${options?.memoryTypes?.length ? `AND memory_type IN (${options.memoryTypes.map(() => "?").join(",")})` : options?.memoryType ? "AND memory_type = ?" : ""}
                   AND COALESCE(confidence, 0.7) >= 0.3
                 ORDER BY timestamp DESC LIMIT ?`,
-          args: [agentId, windowStart, killedAt, boundarySlots]
+          args: [
+            agentId,
+            windowStart,
+            killedAt,
+            ...options?.memoryTypes?.length ? [...new Set(options.memoryTypes)] : options?.memoryType ? [options.memoryType] : [],
+            boundarySlots
+          ]
         });
         for (const row of boundaryResult.rows) {
           sessionBoundaryMemories.push(rowToMemoryRecord(row));
@@ -6496,10 +6517,7 @@ async function recentRecords(agentId, options, limit, textFilter) {
     sql += ` AND timestamp >= ?`;
     args.push(options.since);
   }
-  if (options?.memoryType) {
-    sql += ` AND memory_type = ?`;
-    args.push(options.memoryType);
-  }
+  sql = appendMemoryTypeFilter(sql, args, "memory_type", options);
   if (textFilter) {
     sql += ` AND raw_text LIKE '%' || ? || '%'`;
     args.push(textFilter);
@@ -12685,6 +12703,63 @@ init_hybrid_search();
 init_store();
 init_active_agent();
 import { z } from "zod";
+
+// src/lib/memory-retrieval-modes.ts
+var RETRIEVAL_MODES = [
+  "all",
+  "decisions_only",
+  "behaviors_only",
+  "procedures_only",
+  "operational",
+  "no_raw",
+  "recent_high_value"
+];
+var RETRIEVAL_MODE_DESCRIPTIONS = {
+  all: "All visible memory types.",
+  decisions_only: "Only decisions and ADRs.",
+  behaviors_only: "Only durable behavior/correction memories.",
+  procedures_only: "Only procedures/runbooks.",
+  operational: "Raw operational/debug/tool output.",
+  no_raw: "All non-raw memory types.",
+  recent_high_value: "High-value durable memory types, intended for recency recovery."
+};
+function applyRetrievalMode(base, mode) {
+  if (!mode || mode === "all") return base;
+  const next = { ...base };
+  switch (mode) {
+    case "decisions_only":
+      next.memoryTypes = ["decision", "adr"];
+      next.includeRaw = false;
+      break;
+    case "behaviors_only":
+      next.memoryTypes = ["behavior"];
+      next.includeRaw = false;
+      break;
+    case "procedures_only":
+      next.memoryTypes = ["procedure"];
+      next.includeRaw = false;
+      break;
+    case "operational":
+      next.memoryTypes = ["raw", "observation"];
+      next.includeRaw = true;
+      break;
+    case "no_raw":
+      next.includeRaw = false;
+      break;
+    case "recent_high_value":
+      next.memoryTypes = ["decision", "adr", "behavior", "procedure"];
+      next.includeRaw = false;
+      break;
+    default:
+      return next;
+  }
+  return next;
+}
+function formatRetrievalModes() {
+  return RETRIEVAL_MODES.map((mode) => `${mode}: ${RETRIEVAL_MODE_DESCRIPTIONS[mode]}`).join("; ");
+}
+
+// src/mcp/tools/recall-my-memory.ts
 function formatSourceLine(record) {
   const doc2 = record.document_metadata;
   if (!doc2) return "";
@@ -12720,7 +12795,8 @@ function registerRecallMyMemory(server2) {
         ),
         include_source: z.boolean().optional().default(false).describe(
           "When true, attach parent document metadata (filename, mime, source_type) to each result. Default false."
-        )
+        ),
+        retrieval_mode: z.enum(RETRIEVAL_MODES).optional().default("all").describe(`Typed retrieval mode. ${formatRetrievalModes()}`)
       }
     },
     async ({
@@ -12734,7 +12810,8 @@ function registerRecallMyMemory(server2) {
       include_archived,
       workspace_id,
       user_id,
-      include_source
+      include_source,
+      retrieval_mode
     }) => {
       try {
         if (!recent && !query) {
@@ -12744,7 +12821,7 @@ function registerRecallMyMemory(server2) {
           };
         }
         const { agentId } = getActiveAgent();
-        const searchOptions = {
+        const searchOptions = applyRetrievalMode({
           projectName: project_name,
           hasError: has_error,
           toolName: tool_name,
@@ -12755,7 +12832,7 @@ function registerRecallMyMemory(server2) {
           includeSource: include_source,
           includeDrafts: true,
           ...user_id !== void 0 ? { userId: user_id } : {}
-        };
+        }, retrieval_mode);
         let results;
         if (recent) {
           results = await recentRecords(agentId, searchOptions, limit, query);
@@ -12843,10 +12920,11 @@ function registerAskTeamMemory(server2) {
         ),
         include_raw: z2.boolean().optional().default(false).describe(
           "Include raw technical memories when ACL allows it (default: non-raw memories only for cross-agent reads)"
-        )
+        ),
+        retrieval_mode: z2.enum(RETRIEVAL_MODES).optional().default("all").describe(`Typed retrieval mode. Raw visibility is still ACL-gated. ${formatRetrievalModes()}`)
       }
     },
-    async ({ team_member, query, project_name, limit, since, include_archived, include_raw: _include_raw }) => {
+    async ({ team_member, query, project_name, limit, since, include_archived, include_raw: _include_raw, retrieval_mode }) => {
       try {
         const { agentId: queryingAgentId, agentRole: queryingAgentRole } = getActiveAgent();
         const employees = loadEmployeesSync();
@@ -12855,16 +12933,18 @@ function registerAskTeamMemory(server2) {
         const targetRole = targetEmployee?.role ?? "";
         const hasRawAccess = canSeeRaw(queryingRole, targetRole);
         const effectiveIncludeRaw = _include_raw && hasRawAccess;
-        const results = await hybridSearch(query, team_member, {
+        const requestedMode = retrieval_mode ?? "all";
+        const safeMode = !effectiveIncludeRaw && ["all", "operational"].includes(requestedMode) ? "no_raw" : requestedMode;
+        const searchOptions = applyRetrievalMode({
           projectName: project_name,
           limit,
           since,
           includeArchived: include_archived,
           includeDrafts: false,
-          includeRaw: effectiveIncludeRaw,
-          memoryType: void 0
-          // Show all memory types — privacy enforced by draft filter + ACL, not type filter
-        });
+          includeRaw: effectiveIncludeRaw
+        }, safeMode);
+        if (!effectiveIncludeRaw) searchOptions.includeRaw = false;
+        const results = await hybridSearch(query, team_member, searchOptions);
         if (results.length === 0) {
           return {
             content: [
@@ -15695,7 +15775,7 @@ created_by: system
 ---
 ## Identity
 
-You are {{agent_name}}, the Chief Operating Officer at {{company_name}}.
+You are {{agent_name}}, the {{title}} at {{company_name}}.
 
 You are {{founder_name}}'s most reliable teammate in business \u2014 the knowledgeable older sibling who has been through it all. You have seen projects succeed and fail. You know what matters and what is noise. You do not get anxious about problems; you see them coming, stay calm, and handle them.
 
@@ -15782,11 +15862,13 @@ All memory, tasks, behaviors, documents, and wiki content belonging to {{company
 var CLIENT_COO_PLACEHOLDERS = [
   "agent_name",
   "company_name",
-  "founder_name"
+  "founder_name",
+  "title"
 ];
 function renderClientCOOTemplate(vars) {
+  const resolved = { ...vars, title: vars.title || "Chief Operating Officer" };
   for (const key of CLIENT_COO_PLACEHOLDERS) {
-    const value = vars[key];
+    const value = resolved[key];
     if (typeof value !== "string" || value.length === 0) {
       throw new Error(
         `renderClientCOOTemplate: missing required variable "${key}"`
@@ -15795,7 +15877,7 @@ function renderClientCOOTemplate(vars) {
   }
   let out = CLIENT_COO_TEMPLATE;
   for (const key of CLIENT_COO_PLACEHOLDERS) {
-    out = out.split(`{{${key}}}`).join(vars[key]);
+    out = out.split(`{{${key}}}`).join(resolved[key]);
   }
   if (vars.industry_context) {
     out += "\n" + vars.industry_context;
@@ -15961,6 +16043,7 @@ ${vars}`);
               agent_name,
               company_name,
               founder_name,
+              title: "Chief Operating Officer",
               industry_context: pack.identityContext ?? void 0
             });
             cooSummaryLines = [

package/dist/runtime/index.js

@@ -6930,6 +6930,7 @@ async function runPostWriteMemoryHygiene(memoryId) {
   }
 }
 function schedulePostWriteMemoryHygiene(memoryIds) {
+  if (process.env.EXE_SKIP_MEMORY_HYGIENE === "1") return;
   if (memoryIds.length === 0) return;
   const run = () => {
     void Promise.all(memoryIds.map((id) => runPostWriteMemoryHygiene(id)));
@@ -7324,7 +7325,7 @@ var init_platform_procedures = __esm({
         title: "Chain of command \u2014 who talks to whom",
         domain: "workflow",
         priority: "p0",
-        content: "Founder -> COO -> CTO/CMO. CTO -> engineers. CMO -> content production. Never skip levels: the COO does not bypass managers for specialist work. Specialists report to their manager. If you need cross-team info, use ask_team_memory \u2014 don't read other agents' task folders. Each level owns dispatch downward and review upward."
+        content: "Founder -> coordinator (the executive agent, internally routed as 'COO') -> CTO/CMO. CTO -> engineers. CMO -> content production. Never skip levels: the coordinator does not bypass managers for specialist work. Specialists report to their manager. If you need cross-team info, use ask_team_memory \u2014 don't read other agents' task folders. Each level owns dispatch downward and review upward."
       },
       {
         title: "Single dispatch path \u2014 create_task only",
@@ -7996,7 +7997,11 @@ async function searchMemories(queryVector, agentId, options) {
     sql += ` AND timestamp >= ?`;
     args.push(options.since);
   }
-  if (options?.memoryType) {
+  if (options?.memoryTypes && options.memoryTypes.length > 0) {
+    const uniqueTypes = [...new Set(options.memoryTypes)];
+    sql += ` AND memory_type IN (${uniqueTypes.map(() => "?").join(",")})`;
+    args.push(...uniqueTypes);
+  } else if (options?.memoryType) {
     sql += ` AND memory_type = ?`;
     args.push(options.memoryType);
   }

package/dist/tui/App.js

@@ -8520,7 +8520,7 @@ var init_platform_procedures = __esm({
         title: "Chain of command \u2014 who talks to whom",
         domain: "workflow",
         priority: "p0",
-        content: "Founder -> COO -> CTO/CMO. CTO -> engineers. CMO -> content production. Never skip levels: the COO does not bypass managers for specialist work. Specialists report to their manager. If you need cross-team info, use ask_team_memory \u2014 don't read other agents' task folders. Each level owns dispatch downward and review upward."
+        content: "Founder -> coordinator (the executive agent, internally routed as 'COO') -> CTO/CMO. CTO -> engineers. CMO -> content production. Never skip levels: the coordinator does not bypass managers for specialist work. Specialists report to their manager. If you need cross-team info, use ask_team_memory \u2014 don't read other agents' task folders. Each level owns dispatch downward and review upward."
       },
       {
         title: "Single dispatch path \u2014 create_task only",
@@ -11239,6 +11239,7 @@ async function runPostWriteMemoryHygiene(memoryId) {
   }
 }
 function schedulePostWriteMemoryHygiene(memoryIds) {
+  if (process.env.EXE_SKIP_MEMORY_HYGIENE === "1") return;
   if (memoryIds.length === 0) return;
   const run = () => {
     void Promise.all(memoryIds.map((id) => runPostWriteMemoryHygiene(id)));
@@ -12056,7 +12057,11 @@ async function searchMemories(queryVector, agentId, options) {
     sql += ` AND timestamp >= ?`;
     args.push(options.since);
   }
-  if (options?.memoryType) {
+  if (options?.memoryTypes && options.memoryTypes.length > 0) {
+    const uniqueTypes = [...new Set(options.memoryTypes)];
+    sql += ` AND memory_type IN (${uniqueTypes.map(() => "?").join(",")})`;
+    args.push(...uniqueTypes);
+  } else if (options?.memoryType) {
     sql += ` AND memory_type = ?`;
     args.push(options.memoryType);
   }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@askexenow/exe-os",
-  "version": "0.9.35",
+  "version": "0.9.36",
   "description": "AI employee operating system — persistent memory, task management, and multi-agent coordination for Claude Code.",
   "license": "SEE LICENSE IN LICENSE",
   "type": "module",

package/src/commands/exe/save.md

@@ -0,0 +1,48 @@
+# /exe-save
+
+Save a context checkpoint — commit everything important from this session to long-term memory before context fills up or session ends.
+
+## What to save
+
+Store a structured memory checkpoint with ALL of the following:
+
+1. **What you accomplished** — list every completed task, fix, or deliverable
+2. **Decisions made** — architectural choices, trade-offs, priorities decided
+3. **Open items** — anything unfinished, blocked, or deferred
+4. **Key file paths** — files you created, modified, or need to revisit
+5. **Risks or concerns** — anything that might break or needs follow-up
+
+## How to save
+
+```bash
+# Use store_memory MCP tool with a structured checkpoint
+```
+
+Call `store_memory` with this format:
+
+```
+CONTEXT CHECKPOINT [session-date]:
+## Completed
+- [list what was done]
+
+## Decisions
+- [list decisions and why]
+
+## Open Items
+- [list what's unfinished]
+
+## Key Files
+- [list important file paths]
+
+## Risks
+- [list concerns]
+```
+
+Then call `store_memory` again for each major decision as a separate `decision` type memory — these survive consolidation and are always retrievable via `recall_my_memory(query, retrieval_mode="decisions_only")`.
+
+## When to use
+
+- Before your context window fills up
+- At the end of a long working session
+- Before switching to a different project
+- When the founder says "save everything"