@askexenow/exe-os 0.9.36 → 0.9.37

package/dist/lib/hybrid-search.js

@@ -3042,6 +3042,9 @@ function classifyMemoryType(input) {
   if (tool.includes("commit") || text.includes("adr-") || text.includes("architectural decision")) return "adr";
   if (tool.includes("store_behavior") || tool.includes("behavior")) return "behavior";
   if (tool.includes("global_procedure") || text.includes("organization-wide procedures")) return "procedure";
+  if (tool.includes("checkpoint") || text.startsWith("context checkpoint")) return "checkpoint";
+  if (tool.includes("sessionsummary") || tool.includes("session-summary")) return "summary";
+  if (tool.includes("sessionend") || text.startsWith("session ended")) return "summary";
   if (tool.includes("send_whatsapp") || tool.includes("conversation")) return "conversation";
   if (tool === "store_memory" || tool === "manual") return "observation";
   return "raw";
@@ -5653,7 +5656,7 @@ async function hybridSearch(queryText, agentId, options) {
   }
   if (lists.length === 0) return [];
   if (lists.length === 1 && !effectiveIsBroad) return lists[0].slice(0, limit);
-  const rrfLimit = effectiveIsBroad ? Math.max(limit * 5, 150) : limit;
+  const rrfLimit = effectiveIsBroad ? Math.max(limit * 5, broadFetchTopK) : limit;
   let merged = lists.length === 1 ? lists[0].slice(0, rrfLimit) : rrfMergeMulti(lists, rrfLimit, RRF_K, weights);
   let graphContextMap = /* @__PURE__ */ new Map();
   let entityBoostRan = false;
@@ -5674,6 +5677,7 @@ async function hybridSearch(queryText, agentId, options) {
     returnTopK: 5
   };
   let rerankedAndBlended = null;
+  const rerankReturnLimit = Math.max(limit, auto.returnTopK ?? 5);
   if (effectiveIsBroad && auto.enabled && rerankerAvailable) {
     const cardinality2 = await estimateCardinality(agentId, effectiveOptions);
     if (cardinality2 > auto.broadQueryMinCardinality) {
@@ -5685,16 +5689,16 @@ async function hybridSearch(queryText, agentId, options) {
             text: m.raw_text,
             context: graphContextMap.get(m.id)
           }));
-          const scored = await rerankWithContext2(effectiveQuery, candidates, auto.returnTopK);
+          const scored = await rerankWithContext2(effectiveQuery, candidates, rerankReturnLimit);
           rerankedRecords = scored.map((s) => merged[s.index]);
         } else {
           const { rerank: rerank2 } = await Promise.resolve().then(() => (init_reranker(), reranker_exports));
-          rerankedRecords = await rerank2(effectiveQuery, merged, auto.returnTopK);
+          rerankedRecords = await rerank2(effectiveQuery, merged, rerankReturnLimit);
         }
         if (rerankedRecords.length > 0) {
           rerankedAndBlended = rrfMergeMulti(
             [rerankedRecords],
-            auto.returnTopK,
+            rerankReturnLimit,
             RRF_K
           );
         }
@@ -5702,10 +5706,7 @@ async function hybridSearch(queryText, agentId, options) {
       }
     }
   }
-  const finalResults = (rerankedAndBlended ?? merged).slice(
-    0,
-    rerankedAndBlended ? auto.returnTopK : limit
-  );
+  const finalResults = (rerankedAndBlended ?? merged).slice(0, limit);
   if (options?.includeSource && finalResults.length > 0) {
     await attachDocumentMetadata(finalResults);
   }

package/dist/lib/store.js

@@ -3426,6 +3426,9 @@ function classifyMemoryType(input) {
   if (tool.includes("commit") || text.includes("adr-") || text.includes("architectural decision")) return "adr";
   if (tool.includes("store_behavior") || tool.includes("behavior")) return "behavior";
   if (tool.includes("global_procedure") || text.includes("organization-wide procedures")) return "procedure";
+  if (tool.includes("checkpoint") || text.startsWith("context checkpoint")) return "checkpoint";
+  if (tool.includes("sessionsummary") || tool.includes("session-summary")) return "summary";
+  if (tool.includes("sessionend") || text.startsWith("session ended")) return "summary";
   if (tool.includes("send_whatsapp") || tool.includes("conversation")) return "conversation";
   if (tool === "store_memory" || tool === "manual") return "observation";
   return "raw";

package/dist/mcp/server.js

@@ -3601,6 +3601,9 @@ function classifyMemoryType(input) {
   if (tool.includes("commit") || text.includes("adr-") || text.includes("architectural decision")) return "adr";
   if (tool.includes("store_behavior") || tool.includes("behavior")) return "behavior";
   if (tool.includes("global_procedure") || text.includes("organization-wide procedures")) return "procedure";
+  if (tool.includes("checkpoint") || text.startsWith("context checkpoint")) return "checkpoint";
+  if (tool.includes("sessionsummary") || tool.includes("session-summary")) return "summary";
+  if (tool.includes("sessionend") || text.startsWith("session ended")) return "summary";
   if (tool.includes("send_whatsapp") || tool.includes("conversation")) return "conversation";
   if (tool === "store_memory" || tool === "manual") return "observation";
   return "raw";
@@ -6150,7 +6153,7 @@ async function hybridSearch(queryText, agentId, options) {
   }
   if (lists.length === 0) return [];
   if (lists.length === 1 && !effectiveIsBroad) return lists[0].slice(0, limit);
-  const rrfLimit = effectiveIsBroad ? Math.max(limit * 5, 150) : limit;
+  const rrfLimit = effectiveIsBroad ? Math.max(limit * 5, broadFetchTopK) : limit;
   let merged = lists.length === 1 ? lists[0].slice(0, rrfLimit) : rrfMergeMulti(lists, rrfLimit, RRF_K, weights);
   let graphContextMap = /* @__PURE__ */ new Map();
   let entityBoostRan = false;
@@ -6171,6 +6174,7 @@ async function hybridSearch(queryText, agentId, options) {
     returnTopK: 5
   };
   let rerankedAndBlended = null;
+  const rerankReturnLimit = Math.max(limit, auto.returnTopK ?? 5);
   if (effectiveIsBroad && auto.enabled && rerankerAvailable) {
     const cardinality2 = await estimateCardinality(agentId, effectiveOptions);
     if (cardinality2 > auto.broadQueryMinCardinality) {
@@ -6182,16 +6186,16 @@ async function hybridSearch(queryText, agentId, options) {
             text: m.raw_text,
             context: graphContextMap.get(m.id)
           }));
-          const scored = await rerankWithContext2(effectiveQuery, candidates, auto.returnTopK);
+          const scored = await rerankWithContext2(effectiveQuery, candidates, rerankReturnLimit);
           rerankedRecords = scored.map((s) => merged[s.index]);
         } else {
           const { rerank: rerank2 } = await Promise.resolve().then(() => (init_reranker(), reranker_exports));
-          rerankedRecords = await rerank2(effectiveQuery, merged, auto.returnTopK);
+          rerankedRecords = await rerank2(effectiveQuery, merged, rerankReturnLimit);
         }
         if (rerankedRecords.length > 0) {
           rerankedAndBlended = rrfMergeMulti(
             [rerankedRecords],
-            auto.returnTopK,
+            rerankReturnLimit,
             RRF_K
           );
         }
@@ -6199,10 +6203,7 @@ async function hybridSearch(queryText, agentId, options) {
       }
     }
   }
-  const finalResults = (rerankedAndBlended ?? merged).slice(
-    0,
-    rerankedAndBlended ? auto.returnTopK : limit
-  );
+  const finalResults = (rerankedAndBlended ?? merged).slice(0, limit);
   if (options?.includeSource && finalResults.length > 0) {
     await attachDocumentMetadata(finalResults);
   }

package/dist/runtime/index.js

@@ -6788,6 +6788,9 @@ function classifyMemoryType(input) {
   if (tool.includes("commit") || text.includes("adr-") || text.includes("architectural decision")) return "adr";
   if (tool.includes("store_behavior") || tool.includes("behavior")) return "behavior";
   if (tool.includes("global_procedure") || text.includes("organization-wide procedures")) return "procedure";
+  if (tool.includes("checkpoint") || text.startsWith("context checkpoint")) return "checkpoint";
+  if (tool.includes("sessionsummary") || tool.includes("session-summary")) return "summary";
+  if (tool.includes("sessionend") || text.startsWith("session ended")) return "summary";
   if (tool.includes("send_whatsapp") || tool.includes("conversation")) return "conversation";
   if (tool === "store_memory" || tool === "manual") return "observation";
   return "raw";
@@ -10233,20 +10236,28 @@ function createExeOSHooks(config) {
     async onSessionEnd(_context, summary) {
       try {
         const { writeMemory: writeMemory2 } = await Promise.resolve().then(() => (init_store(), store_exports));
-        if (summary) {
-          await writeMemory2({
-            id: randomUUID5(),
-            agent_id: config.agentId,
-            agent_role: "employee",
-            session_id: `api-${config.agentId}`,
-            timestamp: (/* @__PURE__ */ new Date()).toISOString(),
-            tool_name: "SessionEnd",
-            project_name: config.projectName,
-            has_error: false,
-            raw_text: `Session ended. Summary: ${summary}`,
-            vector: null
-          });
-        }
+        await writeMemory2({
+          id: randomUUID5(),
+          agent_id: config.agentId,
+          agent_role: "employee",
+          session_id: `api-${config.agentId}`,
+          timestamp: (/* @__PURE__ */ new Date()).toISOString(),
+          tool_name: "SessionEnd",
+          project_name: config.projectName,
+          has_error: false,
+          raw_text: [
+            "CONTEXT CHECKPOINT [auto:session-end]",
+            `Agent: ${config.agentId}`,
+            `Project: ${config.projectName}`,
+            `Time: ${(/* @__PURE__ */ new Date()).toISOString()}`,
+            "",
+            "## Runtime Summary",
+            summary || "Session ended. No runtime summary was provided."
+          ].join("\n"),
+          vector: null,
+          importance: 8,
+          memory_type: "checkpoint"
+        });
       } catch (err) {
         process.stderr.write(
           `[exe-hooks] session summary store failed: ${err instanceof Error ? err.message : String(err)}

package/dist/tui/App.js

@@ -11097,6 +11097,9 @@ function classifyMemoryType(input) {
   if (tool.includes("commit") || text.includes("adr-") || text.includes("architectural decision")) return "adr";
   if (tool.includes("store_behavior") || tool.includes("behavior")) return "behavior";
   if (tool.includes("global_procedure") || text.includes("organization-wide procedures")) return "procedure";
+  if (tool.includes("checkpoint") || text.startsWith("context checkpoint")) return "checkpoint";
+  if (tool.includes("sessionsummary") || tool.includes("session-summary")) return "summary";
+  if (tool.includes("sessionend") || text.startsWith("session ended")) return "summary";
   if (tool.includes("send_whatsapp") || tool.includes("conversation")) return "conversation";
   if (tool === "store_memory" || tool === "manual") return "observation";
   return "raw";

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@askexenow/exe-os",
-  "version": "0.9.36",
+  "version": "0.9.37",
   "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

@@ -1,6 +1,12 @@
 # /exe-save
 
-Save a context checkpoint — commit everything important from this session to long-term memory before context fills up or session ends.
+Manual escape hatch for saving a context checkpoint.
+
+Normally you do **not** need this. Exe OS automatically creates structured
+`CONTEXT CHECKPOINT` memories in the background during meaningful work, before
+compaction/context pressure, and at session end. Use `/exe-save` only when the
+founder explicitly says "save everything" or you want an immediate extra
+checkpoint before risky manual work.
 
 ## What to save
 
@@ -42,7 +48,5 @@ Then call `store_memory` again for each major decision as a separate `decision`
 
 ## 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"
+- When the founder explicitly asks to save everything
+- Before risky/manual infrastructure work where an extra checkpoint is useful