memorix 1.0.9 → 1.0.10

package/dist/cli/index.js

@@ -3212,7 +3212,7 @@ ${import_picocolors.default.gray(m3)}  ${s2}
 
 // src/cli/version.ts
 function getCliVersion() {
-  return true ? "1.0.9" : pkg.version;
+  return true ? "1.0.10" : pkg.version;
 }
 var init_version = __esm({
   "src/cli/version.ts"() {
@@ -4000,15 +4000,15 @@ function getDocumentProperties(doc, paths) {
   const properties = {};
   const pathsLength = paths.length;
   for (let i2 = 0; i2 < pathsLength; i2++) {
-    const path25 = paths[i2];
-    const pathTokens = path25.split(".");
+    const path26 = paths[i2];
+    const pathTokens = path26.split(".");
     let current = doc;
     const pathTokensLength = pathTokens.length;
     for (let j3 = 0; j3 < pathTokensLength; j3++) {
       current = current[pathTokens[j3]];
       if (typeof current === "object") {
         if (current !== null && "lat" in current && "lon" in current && typeof current.lat === "number" && typeof current.lon === "number") {
-          current = properties[path25] = current;
+          current = properties[path26] = current;
           break;
         } else if (!Array.isArray(current) && current !== null && j3 === pathTokensLength - 1) {
           current = void 0;
@@ -4020,14 +4020,14 @@ function getDocumentProperties(doc, paths) {
       }
     }
     if (typeof current !== "undefined") {
-      properties[path25] = current;
+      properties[path26] = current;
     }
   }
   return properties;
 }
-function getNested(obj, path25) {
-  const props = getDocumentProperties(obj, [path25]);
-  return props[path25];
+function getNested(obj, path26) {
+  const props = getDocumentProperties(obj, [path26]);
+  return props[path26];
 }
 function convertDistanceToMeters(distance, unit) {
   const ratio = mapDistanceToMeters[unit];
@@ -4043,10 +4043,10 @@ function removeVectorsFromHits(searchResult, vectorProperties) {
       ...result.document,
       // Remove embeddings from the result
       ...vectorProperties.reduce((acc, prop) => {
-        const path25 = prop.split(".");
-        const lastKey = path25.pop();
+        const path26 = prop.split(".");
+        const lastKey = path26.pop();
         let obj = acc;
-        for (const key of path25) {
+        for (const key of path26) {
           obj[key] = obj[key] ?? {};
           obj = obj[key];
         }
@@ -4778,15 +4778,15 @@ var init_avl = __esm({
         if (node === null) {
           return new AVLNode(key, [value]);
         }
-        const path25 = [];
+        const path26 = [];
         let current = node;
         let parent = null;
         while (current !== null) {
-          path25.push({ parent, node: current });
+          path26.push({ parent, node: current });
           if (key < current.k) {
             if (current.l === null) {
               current.l = new AVLNode(key, [value]);
-              path25.push({ parent: current, node: current.l });
+              path26.push({ parent: current, node: current.l });
               break;
             } else {
               parent = current;
@@ -4795,7 +4795,7 @@ var init_avl = __esm({
           } else if (key > current.k) {
             if (current.r === null) {
               current.r = new AVLNode(key, [value]);
-              path25.push({ parent: current, node: current.r });
+              path26.push({ parent: current, node: current.r });
               break;
             } else {
               parent = current;
@@ -4810,8 +4810,8 @@ var init_avl = __esm({
         if (this.insertCount++ % rebalanceThreshold === 0) {
           needRebalance = true;
         }
-        for (let i2 = path25.length - 1; i2 >= 0; i2--) {
-          const { parent: parent2, node: currentNode } = path25[i2];
+        for (let i2 = path26.length - 1; i2 >= 0; i2--) {
+          const { parent: parent2, node: currentNode } = path26[i2];
           currentNode.updateHeight();
           if (needRebalance) {
             const rebalancedNode = this.rebalanceNode(currentNode);
@@ -4917,10 +4917,10 @@ var init_avl = __esm({
       removeNode(node, key) {
         if (node === null)
           return null;
-        const path25 = [];
+        const path26 = [];
         let current = node;
         while (current !== null && current.k !== key) {
-          path25.push(current);
+          path26.push(current);
           if (key < current.k) {
             current = current.l;
           } else {
@@ -4932,10 +4932,10 @@ var init_avl = __esm({
         }
         if (current.l === null || current.r === null) {
           const child = current.l ? current.l : current.r;
-          if (path25.length === 0) {
+          if (path26.length === 0) {
             node = child;
           } else {
-            const parent = path25[path25.length - 1];
+            const parent = path26[path26.length - 1];
             if (parent.l === current) {
               parent.l = child;
             } else {
@@ -4958,13 +4958,13 @@ var init_avl = __esm({
           }
           current = successorParent;
         }
-        path25.push(current);
-        for (let i2 = path25.length - 1; i2 >= 0; i2--) {
-          const currentNode = path25[i2];
+        path26.push(current);
+        for (let i2 = path26.length - 1; i2 >= 0; i2--) {
+          const currentNode = path26[i2];
           currentNode.updateHeight();
           const rebalancedNode = this.rebalanceNode(currentNode);
           if (i2 > 0) {
-            const parent = path25[i2 - 1];
+            const parent = path26[i2 - 1];
             if (parent.l === currentNode) {
               parent.l = rebalancedNode;
             } else if (parent.r === currentNode) {
@@ -6131,15 +6131,15 @@ function create2(orama, sharedInternalDocumentStore, schema, index, prefix = "")
     };
   }
   for (const [prop, type] of Object.entries(schema)) {
-    const path25 = `${prefix}${prefix ? "." : ""}${prop}`;
+    const path26 = `${prefix}${prefix ? "." : ""}${prop}`;
     if (typeof type === "object" && !Array.isArray(type)) {
-      create2(orama, sharedInternalDocumentStore, type, index, path25);
+      create2(orama, sharedInternalDocumentStore, type, index, path26);
       continue;
     }
     if (isVectorType(type)) {
-      index.searchableProperties.push(path25);
-      index.searchablePropertiesWithTypes[path25] = type;
-      index.vectorIndexes[path25] = {
+      index.searchableProperties.push(path26);
+      index.searchablePropertiesWithTypes[path26] = type;
+      index.vectorIndexes[path26] = {
         type: "Vector",
         node: new VectorIndex(getVectorSize(type)),
         isArray: false
@@ -6149,32 +6149,32 @@ function create2(orama, sharedInternalDocumentStore, schema, index, prefix = "")
       switch (type) {
         case "boolean":
         case "boolean[]":
-          index.indexes[path25] = { type: "Bool", node: new BoolNode(), isArray };
+          index.indexes[path26] = { type: "Bool", node: new BoolNode(), isArray };
           break;
         case "number":
         case "number[]":
-          index.indexes[path25] = { type: "AVL", node: new AVLTree(0, []), isArray };
+          index.indexes[path26] = { type: "AVL", node: new AVLTree(0, []), isArray };
           break;
         case "string":
         case "string[]":
-          index.indexes[path25] = { type: "Radix", node: new RadixTree(), isArray };
-          index.avgFieldLength[path25] = 0;
-          index.frequencies[path25] = {};
-          index.tokenOccurrences[path25] = {};
-          index.fieldLengths[path25] = {};
+          index.indexes[path26] = { type: "Radix", node: new RadixTree(), isArray };
+          index.avgFieldLength[path26] = 0;
+          index.frequencies[path26] = {};
+          index.tokenOccurrences[path26] = {};
+          index.fieldLengths[path26] = {};
           break;
         case "enum":
         case "enum[]":
-          index.indexes[path25] = { type: "Flat", node: new FlatTree(), isArray };
+          index.indexes[path26] = { type: "Flat", node: new FlatTree(), isArray };
           break;
         case "geopoint":
-          index.indexes[path25] = { type: "BKD", node: new BKDTree(), isArray };
+          index.indexes[path26] = { type: "BKD", node: new BKDTree(), isArray };
           break;
         default:
-          throw createError("INVALID_SCHEMA_TYPE", Array.isArray(type) ? "array" : type, path25);
+          throw createError("INVALID_SCHEMA_TYPE", Array.isArray(type) ? "array" : type, path26);
       }
-      index.searchableProperties.push(path25);
-      index.searchablePropertiesWithTypes[path25] = type;
+      index.searchableProperties.push(path26);
+      index.searchablePropertiesWithTypes[path26] = type;
     }
   }
   return index;
@@ -6745,12 +6745,12 @@ function innerCreate(orama, sharedInternalDocumentStore, schema, sortableDeniedP
     sorts: {}
   };
   for (const [prop, type] of Object.entries(schema)) {
-    const path25 = `${prefix}${prefix ? "." : ""}${prop}`;
-    if (sortableDeniedProperties.includes(path25)) {
+    const path26 = `${prefix}${prefix ? "." : ""}${prop}`;
+    if (sortableDeniedProperties.includes(path26)) {
       continue;
     }
     if (typeof type === "object" && !Array.isArray(type)) {
-      const ret = innerCreate(orama, sharedInternalDocumentStore, type, sortableDeniedProperties, path25);
+      const ret = innerCreate(orama, sharedInternalDocumentStore, type, sortableDeniedProperties, path26);
       safeArrayPush(sorter.sortableProperties, ret.sortableProperties);
       sorter.sorts = {
         ...sorter.sorts,
@@ -6767,9 +6767,9 @@ function innerCreate(orama, sharedInternalDocumentStore, schema, sortableDeniedP
         case "boolean":
         case "number":
         case "string":
-          sorter.sortableProperties.push(path25);
-          sorter.sortablePropertiesWithTypes[path25] = type;
-          sorter.sorts[path25] = {
+          sorter.sortableProperties.push(path26);
+          sorter.sortablePropertiesWithTypes[path26] = type;
+          sorter.sorts[path26] = {
             docs: /* @__PURE__ */ new Map(),
             orderedDocsToRemove: /* @__PURE__ */ new Map(),
             orderedDocs: [],
@@ -6785,7 +6785,7 @@ function innerCreate(orama, sharedInternalDocumentStore, schema, sortableDeniedP
         case "string[]":
           continue;
         default:
-          throw createError("INVALID_SORT_SCHEMA_TYPE", Array.isArray(type) ? "array" : type, path25);
+          throw createError("INVALID_SORT_SCHEMA_TYPE", Array.isArray(type) ? "array" : type, path26);
       }
     }
   }
@@ -8630,8 +8630,8 @@ function innerFullTextSearch(orama, params, language) {
 function escapeRegex(str2) {
   return str2.replace(/[.*+?^${}()|[\]\\]/g, "\\$&");
 }
-function getPropValue(obj, path25) {
-  const keys = path25.split(".");
+function getPropValue(obj, path26) {
+  const keys = path26.split(".");
   let value = obj;
   for (const key of keys) {
     if (value && typeof value === "object" && key in value) {
@@ -15771,6 +15771,7 @@ var require_gray_matter = __commonJS({
 // src/config/yaml-loader.ts
 var yaml_loader_exports = {};
 __export(yaml_loader_exports, {
+  clearProjectRoot: () => clearProjectRoot,
   initProjectRoot: () => initProjectRoot,
   loadYamlConfig: () => loadYamlConfig,
   resetYamlConfigCache: () => resetYamlConfigCache
@@ -15782,6 +15783,9 @@ function initProjectRoot(root) {
   globalProjectRoot = root;
   configCache.delete(root);
 }
+function clearProjectRoot() {
+  globalProjectRoot = null;
+}
 function loadYamlConfig(projectRoot) {
   const resolvedRoot = projectRoot === null ? null : projectRoot ?? globalProjectRoot ?? null;
   const cached3 = configCache.get(resolvedRoot ?? null);
@@ -15809,6 +15813,7 @@ function loadYamlConfig(projectRoot) {
     ...projectConfig,
     // Deep merge for nested objects where both exist
     llm: { ...userConfig.llm, ...projectConfig.llm },
+    agent: { ...userConfig.agent, ...projectConfig.agent },
     embedding: { ...userConfig.embedding, ...projectConfig.embedding },
     git: { ...userConfig.git, ...projectConfig.git },
     behavior: { ...userConfig.behavior, ...projectConfig.behavior },
@@ -15926,7 +15931,7 @@ var require_main = __commonJS({
     "use strict";
     init_esm_shims();
     var fs21 = __require("fs");
-    var path25 = __require("path");
+    var path26 = __require("path");
     var os5 = __require("os");
     var crypto3 = __require("crypto");
     var packageJson = require_package();
@@ -16072,7 +16077,7 @@ var require_main = __commonJS({
           possibleVaultPath = options2.path.endsWith(".vault") ? options2.path : `${options2.path}.vault`;
         }
       } else {
-        possibleVaultPath = path25.resolve(process.cwd(), ".env.vault");
+        possibleVaultPath = path26.resolve(process.cwd(), ".env.vault");
       }
       if (fs21.existsSync(possibleVaultPath)) {
         return possibleVaultPath;
@@ -16080,7 +16085,7 @@ var require_main = __commonJS({
       return null;
     }
     function _resolveHome(envPath) {
-      return envPath[0] === "~" ? path25.join(os5.homedir(), envPath.slice(1)) : envPath;
+      return envPath[0] === "~" ? path26.join(os5.homedir(), envPath.slice(1)) : envPath;
     }
     function _configVault(options2) {
       const debug = parseBoolean(process.env.DOTENV_CONFIG_DEBUG || options2 && options2.debug);
@@ -16097,7 +16102,7 @@ var require_main = __commonJS({
       return { parsed };
     }
     function configDotenv(options2) {
-      const dotenvPath = path25.resolve(process.cwd(), ".env");
+      const dotenvPath = path26.resolve(process.cwd(), ".env");
       let encoding = "utf8";
       let processEnv = process.env;
       if (options2 && options2.processEnv != null) {
@@ -16125,13 +16130,13 @@ var require_main = __commonJS({
       }
       let lastError;
       const parsedAll = {};
-      for (const path26 of optionPaths) {
+      for (const path27 of optionPaths) {
         try {
-          const parsed = DotenvModule.parse(fs21.readFileSync(path26, { encoding }));
+          const parsed = DotenvModule.parse(fs21.readFileSync(path27, { encoding }));
           DotenvModule.populate(parsedAll, parsed, options2);
         } catch (e3) {
           if (debug) {
-            _debug(`Failed to load ${path26} ${e3.message}`);
+            _debug(`Failed to load ${path27} ${e3.message}`);
           }
           lastError = e3;
         }
@@ -16144,7 +16149,7 @@ var require_main = __commonJS({
         const shortPaths = [];
         for (const filePath of optionPaths) {
           try {
-            const relative = path25.relative(process.cwd(), filePath);
+            const relative = path26.relative(process.cwd(), filePath);
             shortPaths.push(relative);
           } catch (e3) {
             if (debug) {
@@ -16307,6 +16312,10 @@ var init_dotenv_loader = __esm({
 // src/config.ts
 var config_exports = {};
 __export(config_exports, {
+  getAgentLLMApiKey: () => getAgentLLMApiKey,
+  getAgentLLMBaseUrl: () => getAgentLLMBaseUrl,
+  getAgentLLMModel: () => getAgentLLMModel,
+  getAgentLLMProvider: () => getAgentLLMProvider,
   getEmbeddingApiKey: () => getEmbeddingApiKey,
   getEmbeddingBaseUrl: () => getEmbeddingBaseUrl,
   getEmbeddingDimensions: () => getEmbeddingDimensions,
@@ -16366,6 +16375,23 @@ function getLLMModel(providerDefault) {
 function getLLMBaseUrl(providerDefault) {
   return process.env.MEMORIX_LLM_BASE_URL || loadYamlConfig().llm?.baseUrl || loadFileConfig().llm?.baseUrl || providerDefault;
 }
+function getAgentLLMApiKey() {
+  return process.env.MEMORIX_AGENT_LLM_API_KEY || loadYamlConfig().agent?.apiKey || loadFileConfig().agent?.apiKey || getLLMApiKey();
+}
+function getAgentLLMProvider() {
+  if (process.env.MEMORIX_AGENT_LLM_PROVIDER) return process.env.MEMORIX_AGENT_LLM_PROVIDER;
+  const yml = loadYamlConfig();
+  if (yml.agent?.provider) return yml.agent.provider;
+  const cfg = loadFileConfig();
+  if (cfg.agent?.provider) return cfg.agent.provider;
+  return getLLMProvider();
+}
+function getAgentLLMModel(providerDefault) {
+  return process.env.MEMORIX_AGENT_LLM_MODEL || loadYamlConfig().agent?.model || loadFileConfig().agent?.model || getLLMModel(providerDefault);
+}
+function getAgentLLMBaseUrl(providerDefault) {
+  return process.env.MEMORIX_AGENT_LLM_BASE_URL || loadYamlConfig().agent?.baseUrl || loadFileConfig().agent?.baseUrl || getLLMBaseUrl(providerDefault);
+}
 function getEmbeddingMode() {
   const env2 = process.env.MEMORIX_EMBEDDING?.toLowerCase()?.trim();
   if (env2 === "fastembed" || env2 === "transformers" || env2 === "api" || env2 === "auto") return env2;
@@ -17686,20 +17712,20 @@ async function* callLLMWithToolsStream(messages, tools) {
   }
   yield* callOpenAIWithToolsStream(messages, tools);
 }
-function initLLM() {
-  const { getLLMApiKey: getLLMApiKey2, getLLMProvider: getLLMProvider2, getLLMModel: getLLMModel2, getLLMBaseUrl: getLLMBaseUrl2 } = (init_config(), __toCommonJS(config_exports));
-  const apiKey = getLLMApiKey2();
+function initLLM(options2 = {}) {
+  const scope = options2.scope ?? "memory";
+  const apiKey = scope === "agent" ? getAgentLLMApiKey() : getLLMApiKey();
   if (!apiKey) {
     currentConfig = null;
     return null;
   }
-  const provider2 = getLLMProvider2();
+  const provider2 = scope === "agent" ? getAgentLLMProvider() : getLLMProvider();
   const defaults = PROVIDER_DEFAULTS[provider2] ?? PROVIDER_DEFAULTS.openai;
   currentConfig = {
     provider: provider2,
     apiKey,
-    model: getLLMModel2(defaults.model),
-    baseUrl: getLLMBaseUrl2(defaults.baseUrl)
+    model: scope === "agent" ? getAgentLLMModel(defaults.model) : getLLMModel(defaults.model),
+    baseUrl: scope === "agent" ? getAgentLLMBaseUrl(defaults.baseUrl) : getLLMBaseUrl(defaults.baseUrl)
   };
   return currentConfig;
 }
@@ -18206,6 +18232,7 @@ var init_provider2 = __esm({
   "src/llm/provider.ts"() {
     "use strict";
     init_esm_shims();
+    init_config();
     LLM_TIMEOUT_DEFAULT_MS = 3e4;
     LLM_TIMEOUT_MIN_MS = 1e3;
     LLM_TIMEOUT_MAX_MS = 3e5;
@@ -20841,7 +20868,18 @@ __export(engine_exports, {
 });
 async function compactSearch(options2) {
   const entries = await searchObservations(options2);
-  const formatted = formatIndexTable(entries, options2.query, !options2.projectId);
+  let formatted = formatIndexTable(entries, options2.query, !options2.projectId);
+  if (entries.length === 0 && options2.projectId) {
+    const allObservations = getAllObservations();
+    const projectHasStoredMemory = allObservations.some((obs) => obs.projectId === options2.projectId);
+    if (!projectHasStoredMemory) {
+      formatted = `This project does not have any Memorix memories yet.
+
+It looks like a fresh project: the tool call worked, but there is nothing stored to retrieve yet.
+
+Memories will start appearing after observations, session summaries, hook captures, or git-memory are written.`;
+    }
+  }
   const totalTokens = countTextTokens(formatted);
   return { entries, formatted, totalTokens };
 }
@@ -21293,7 +21331,7 @@ async function askMemoryQuestion(question, history = []) {
   const project = detectProject(process.cwd());
   if (!project) {
     loadDotenv(process.cwd());
-    initLLM();
+    initLLM({ scope: "agent" });
     if (!isLLMEnabled()) {
       return {
         question: trimmedQuestion,
@@ -21324,7 +21362,7 @@ async function askMemoryQuestion(question, history = []) {
     };
   }
   loadDotenv(project.rootPath);
-  initLLM();
+  initLLM({ scope: "agent" });
   const dataDir = await getProjectDataDir(project.id);
   await prepareProjectSearch(project.id, dataDir);
   const searchMode = normalizeSearchMode(getLastSearchMode(project.id) || "fulltext");
@@ -21420,7 +21458,7 @@ async function askMemoryQuestionStream(question, history = [], callbacks, signal
   const project = detectProject(process.cwd());
   if (!project) {
     loadDotenv(process.cwd());
-    initLLM();
+    initLLM({ scope: "agent" });
     if (!isLLMEnabled()) {
       return {
         question: trimmedQuestion,
@@ -21453,7 +21491,7 @@ async function askMemoryQuestionStream(question, history = [], callbacks, signal
     };
   }
   loadDotenv(project.rootPath);
-  initLLM();
+  initLLM({ scope: "agent" });
   const dataDir = await getProjectDataDir(project.id);
   await prepareProjectSearch(project.id, dataDir);
   const searchMode = normalizeSearchMode(getLastSearchMode(project.id) || "fulltext");
@@ -22223,7 +22261,7 @@ function generateKiroHookFiles() {
         when: { type: "promptSubmit" },
         then: {
           type: "askAgent",
-          prompt: "Before responding, load context:\n1. Call memorix_session_start to get previous session summary and key memories\n2. Call memorix_search with a query related to the user's prompt for additional context\n3. If search results are found, use memorix_detail to fetch the most relevant ones\n4. Reference relevant memories naturally in your response"
+          prompt: "Before responding, load useful project context:\n1. Call memorix_search with a query related to the user's prompt for relevant memories\n2. If search results are found, use memorix_detail to fetch the most relevant ones\n3. If memorix_search says this is a fresh project with no Memorix memories yet, do not repeat memorix_search again in the same turn unless the user explicitly asks for history/context or new memories were written\n4. Call memorix_session_start only when explicit session semantics are useful, such as handoff, long-running work, team coordination, or HTTP project binding\n5. Reference relevant memories naturally in your response"
         }
       }, null, 2)
     },
@@ -22834,20 +22872,18 @@ alwaysApply: true
 
 You have access to Memorix memory tools. Follow these rules to maintain persistent context across sessions.
 
-## RULE 1: Session Start \u2014 Bind Project, Then Load Context
+## RULE 1: Use Memory When Useful
 
-At the **beginning of every conversation**, BEFORE responding to the user:
+At the beginning of a conversation, use Memorix when prior project context would materially help the task. Do not require a session bind for every conversation.
 
-1. Call \`memorix_session_start\` with parameters:
-   - \`agent\`: your agent identifier (e.g. "windsurf", "codex", "antigravity")
-   - \`projectRoot\`: the **absolute path** of the current workspace or repo root
-   This binds the session to the correct project. Without \`projectRoot\`, memories may go to the wrong bucket.
-2. Then call \`memorix_search\` with a query related to the user's first message for additional context
-3. If search results are found, use \`memorix_detail\` to fetch the most relevant ones
-4. Reference relevant memories naturally \u2014 the user should feel you "remember" them
+1. Call \`memorix_search\` with a query related to the user's first message or current task.
+2. If search results are found, use \`memorix_detail\` to fetch the most relevant ones.
+3. If \`memorix_search\` says this is a fresh project with no Memorix memories yet, treat that as a successful cold-start signal. Do not repeat \`memorix_search\` again in the same turn unless the user explicitly asks for history/context or new memories were written.
+4. Call \`memorix_session_start\` only when explicit session semantics are useful: handoff, long-running work, team coordination, restoring prior session context, or HTTP project binding.
+5. Reference relevant memories naturally \u2014 the user should feel you understand the project, not that you are following a ritual.
 
 **Important:** \`projectRoot\` is a detection anchor only; Git remains the source of truth for project identity.
-In HTTP control-plane mode (\`memorix serve-http\` / \`memorix background start\`), explicit \`projectRoot\` binding is required for correct multi-project isolation.
+In HTTP control-plane mode (\`memorix serve-http\` / \`memorix background start\`), explicit \`projectRoot\` binding is recommended when the workspace path is available and required for correct multi-project isolation.
 \`memorix_session_start\` is lightweight by default: it starts memory/session context only. Do not set \`joinTeam\` unless the user explicitly needs autonomous Agent Team tasks, messages, file locks, or orchestrated CLI-agent workflows.
 
 ## RULE 2: Store Important Context
@@ -29037,8 +29073,8 @@ var init_parseUtil = __esm({
     init_errors2();
     init_en();
     makeIssue = (params) => {
-      const { data, path: path25, errorMaps, issueData } = params;
-      const fullPath = [...path25, ...issueData.path || []];
+      const { data, path: path26, errorMaps, issueData } = params;
+      const fullPath = [...path26, ...issueData.path || []];
       const fullIssue = {
         ...issueData,
         path: fullPath
@@ -29352,11 +29388,11 @@ var init_types3 = __esm({
     init_parseUtil();
     init_util2();
     ParseInputLazyPath = class {
-      constructor(parent, value, path25, key) {
+      constructor(parent, value, path26, key) {
         this._cachedPath = [];
         this.parent = parent;
         this.data = value;
-        this._path = path25;
+        this._path = path26;
         this._key = key;
       }
       get path() {
@@ -34032,6 +34068,189 @@ var init_poll2 = __esm({
   }
 });
 
+// src/cli/receipt-service.ts
+var receipt_service_exports = {};
+__export(receipt_service_exports, {
+  buildHandoffReceipt: () => buildHandoffReceipt,
+  formatHandoffReceipt: () => formatHandoffReceipt
+});
+import { createHash as createHash3 } from "crypto";
+import { existsSync as existsSync8, readFileSync as readFileSync7 } from "fs";
+import path17 from "path";
+function sha256(value) {
+  return `sha256:${createHash3("sha256").update(value).digest("hex")}`;
+}
+function hashId(projectId, id) {
+  return sha256(`${projectId}:obs:${id}`);
+}
+function inferWritePolicy(observations2) {
+  if (observations2.length === 0) return "not_observed";
+  if (observations2.some((obs) => obs.sourceDetail === "hook")) return "hook";
+  if (observations2.some((obs) => obs.sourceDetail === "explicit")) return "explicit_tool";
+  if (observations2.some((obs) => obs.source === "manual")) return "cli";
+  if (observations2.some((obs) => obs.source === "git" || obs.sourceDetail === "git-ingest")) return "git_ingest";
+  return "agent_or_unknown";
+}
+function inferWriteTrigger(count3) {
+  return count3 > 0 ? "memory_written" : "not_triggered";
+}
+function safeJsonArray(value) {
+  if (Array.isArray(value)) return value;
+  if (!value) return [];
+  try {
+    const parsed = JSON.parse(value);
+    return Array.isArray(parsed) ? parsed.map(String) : [];
+  } catch {
+    return [];
+  }
+}
+async function loadReceiptObservations(dataDir, projectId) {
+  const dbPath = path17.join(dataDir, "memorix.db");
+  if (existsSync8(dbPath)) {
+    try {
+      const DB = loadBetterSqlite3();
+      const db2 = new DB(dbPath, { readonly: true, fileMustExist: true });
+      try {
+        return db2.prepare(`
+          SELECT id, status, source, sourceDetail, title, narrative, facts
+          FROM observations
+          WHERE projectId = ?
+        `).all(projectId);
+      } finally {
+        db2.close();
+      }
+    } catch {
+    }
+  }
+  const jsonPath = path17.join(dataDir, "observations.json");
+  if (!existsSync8(jsonPath)) return [];
+  try {
+    const parsed = JSON.parse(readFileSync7(jsonPath, "utf-8"));
+    if (!Array.isArray(parsed)) return [];
+    return parsed.filter((obs) => obs?.projectId === projectId);
+  } catch {
+    return [];
+  }
+}
+function probeMatches(obs, probe) {
+  const query = probe.toLowerCase();
+  const facts = safeJsonArray(obs.facts).join(" ");
+  const text = [obs.title ?? "", obs.narrative ?? "", facts].join(" ").toLowerCase();
+  return query.split(/\s+/).filter(Boolean).some((term) => text.includes(term));
+}
+async function buildHandoffReceipt(options2 = {}) {
+  const cwd = options2.cwd ?? process.cwd();
+  const transport = options2.transport ?? "cli";
+  const detection = detectProjectWithDiagnostics(cwd);
+  if (!detection.project) {
+    const detail = detection.failure?.detail ?? "No git repository found in the current directory.";
+    throw new Error(detail);
+  }
+  const project = detection.project;
+  const dataDir = await getProjectDataDir(project.id);
+  const observations2 = (await loadReceiptObservations(dataDir, project.id)).filter((obs) => (obs.status ?? "active") === "active");
+  const recent = observations2.slice(-10).reverse();
+  const receipt = {
+    version: 1,
+    "project.has_git": true,
+    "project.name_hash": sha256(project.name),
+    "project.identity_hash": sha256(project.id),
+    "project.root_hash": sha256(project.rootPath),
+    "runtime.transport": transport,
+    "runtime.cwd_hash": sha256(cwd),
+    write_policy: inferWritePolicy(recent),
+    "write.trigger": inferWriteTrigger(observations2.length),
+    "memory.write.count": observations2.length,
+    "memory.write.ids_hash": recent.map((obs) => hashId(project.id, obs.id)),
+    boundary: "shared memory means stored memories are searchable across clients in the same project; chat messages are not mirrored automatically",
+    privacy: {
+      omitted: [
+        "raw_chat_transcript",
+        "raw_memory_text",
+        "raw_search_query",
+        "tool_arguments",
+        "tool_results",
+        "local_file_paths"
+      ]
+    }
+  };
+  const probe = options2.probe?.trim();
+  if (probe) {
+    const search3 = observations2.filter((obs) => probeMatches(obs, probe)).slice(0, 10);
+    receipt["memory.search.query_hash"] = sha256(probe);
+    receipt["memory.search.result_count"] = search3.length;
+    receipt["memory.search.result_ids_hash"] = search3.map((entry) => hashId(project.id, entry.id));
+  }
+  return receipt;
+}
+function formatHandoffReceipt(receipt) {
+  const lines = [
+    "",
+    "\u250C\u2500 Memory Handoff Receipt \u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500",
+    `  Project identity: ${receipt["project.identity_hash"]}`,
+    `  Git project: ${receipt["project.has_git"] ? "yes" : "no"}`,
+    `  Transport: ${receipt["runtime.transport"]}`,
+    `  Write policy: ${receipt.write_policy}`,
+    `  Write trigger: ${receipt["write.trigger"]}`,
+    `  Stored memories: ${receipt["memory.write.count"]}`
+  ];
+  if (typeof receipt["memory.search.result_count"] === "number") {
+    lines.push(`  Probe result count: ${receipt["memory.search.result_count"]}`);
+  }
+  lines.push("");
+  lines.push(`  Boundary: ${receipt.boundary}`);
+  lines.push("  Privacy: raw chat, memory text, queries, tool payloads, and local paths are omitted.");
+  lines.push("");
+  return lines.join("\n");
+}
+var init_receipt_service = __esm({
+  "src/cli/receipt-service.ts"() {
+    "use strict";
+    init_esm_shims();
+    init_detector();
+    init_persistence();
+    init_sqlite_db();
+  }
+});
+
+// src/cli/commands/receipt.ts
+var receipt_exports = {};
+__export(receipt_exports, {
+  default: () => receipt_default
+});
+var receipt_default;
+var init_receipt = __esm({
+  "src/cli/commands/receipt.ts"() {
+    "use strict";
+    init_esm_shims();
+    init_dist2();
+    init_receipt_service();
+    init_operator_shared();
+    receipt_default = defineCommand({
+      meta: {
+        name: "receipt",
+        description: "Generate a privacy-safe memory handoff receipt"
+      },
+      args: {
+        json: { type: "boolean", description: "Emit machine-readable JSON output" },
+        probe: { type: "string", description: "Optional search probe; only its hash is emitted" }
+      },
+      run: async ({ args }) => {
+        const asJson = !!args.json;
+        try {
+          const receipt = await buildHandoffReceipt({
+            probe: args.probe,
+            transport: "cli"
+          });
+          emitResult(receipt, formatHandoffReceipt(receipt), asJson);
+        } catch (error2) {
+          emitError(error2 instanceof Error ? error2.message : String(error2), asJson);
+        }
+      }
+    });
+  }
+});
+
 // src/server/tool-profile.ts
 function isToolInProfile(toolName, profile) {
   const profiles = TOOL_PROFILES[toolName];
@@ -34315,10 +34534,10 @@ function assignProp(target, prop, value) {
     configurable: true
   });
 }
-function getElementAtPath(obj, path25) {
-  if (!path25)
+function getElementAtPath(obj, path26) {
+  if (!path26)
     return obj;
-  return path25.reduce((acc, key) => acc?.[key], obj);
+  return path26.reduce((acc, key) => acc?.[key], obj);
 }
 function promiseAllObject(promisesObj) {
   const keys = Object.keys(promisesObj);
@@ -34567,11 +34786,11 @@ function aborted(x3, startIndex = 0) {
   }
   return false;
 }
-function prefixIssues(path25, issues) {
+function prefixIssues(path26, issues) {
   return issues.map((iss) => {
     var _a;
     (_a = iss).path ?? (_a.path = []);
-    iss.path.unshift(path25);
+    iss.path.unshift(path26);
     return iss;
   });
 }
@@ -46855,8 +47074,8 @@ var require_utils2 = __commonJS({
       }
       return ind;
     }
-    function removeDotSegments(path25) {
-      let input = path25;
+    function removeDotSegments(path26) {
+      let input = path26;
       const output = [];
       let nextSlash = -1;
       let len = 0;
@@ -47056,8 +47275,8 @@ var require_schemes = __commonJS({
         wsComponent.secure = void 0;
       }
       if (wsComponent.resourceName) {
-        const [path25, query] = wsComponent.resourceName.split("?");
-        wsComponent.path = path25 && path25 !== "/" ? path25 : void 0;
+        const [path26, query] = wsComponent.resourceName.split("?");
+        wsComponent.path = path26 && path26 !== "/" ? path26 : void 0;
         wsComponent.query = query;
         wsComponent.resourceName = void 0;
       }
@@ -52041,9 +52260,9 @@ var init_auto_relations = __esm({
 });
 
 // src/rules/utils.ts
-import { createHash as createHash3 } from "crypto";
+import { createHash as createHash4 } from "crypto";
 function hashContent(content) {
-  return createHash3("sha256").update(content.trim()).digest("hex").substring(0, 16);
+  return createHash4("sha256").update(content.trim()).digest("hex").substring(0, 16);
 }
 function generateRuleId(source, filePath) {
   const sanitized = filePath.replace(/[\/\\]/g, "-").replace(/^\./, "");
@@ -52740,7 +52959,7 @@ __export(syncer_exports, {
   RulesSyncer: () => RulesSyncer
 });
 import { promises as fs13 } from "fs";
-import path17 from "path";
+import path18 from "path";
 var RulesSyncer;
 var init_syncer = __esm({
   "src/rules/syncer.ts"() {
@@ -52786,7 +53005,7 @@ var init_syncer = __esm({
             for (const filePath of found) {
               try {
                 const content = await fs13.readFile(filePath, "utf-8");
-                const relativePath = path17.relative(this.projectRoot, filePath).replace(/\\/g, "/");
+                const relativePath = path18.relative(this.projectRoot, filePath).replace(/\\/g, "/");
                 const parsed = entry.adapter.parse(relativePath, content);
                 rules.push(...parsed);
               } catch {
@@ -52854,7 +53073,7 @@ var init_syncer = __esm({
         const entries = [];
         for (const adapter of this.adapters.values()) {
           const absolutePaths = adapter.filePatterns.map(
-            (p2) => path17.join(this.projectRoot, p2)
+            (p2) => path18.join(this.projectRoot, p2)
           );
           entries.push({ adapter, paths: absolutePaths });
         }
@@ -52862,8 +53081,8 @@ var init_syncer = __esm({
       }
       /** Find files matching a glob-like path (simple implementation) */
       async findFiles(pattern) {
-        const dir = path17.dirname(pattern);
-        const fileGlob = path17.basename(pattern);
+        const dir = path18.dirname(pattern);
+        const fileGlob = path18.basename(pattern);
         try {
           const stat = await fs13.stat(dir);
           if (!stat.isDirectory()) {
@@ -52886,14 +53105,14 @@ var init_syncer = __esm({
           try {
             const files = await fs13.readdir(dir);
             const ext = fileGlob.replace("*", "");
-            return files.filter((f4) => ext ? f4.endsWith(ext) : true).map((f4) => path17.join(dir, f4));
+            return files.filter((f4) => ext ? f4.endsWith(ext) : true).map((f4) => path18.join(dir, f4));
           } catch {
             return [];
           }
         }
         try {
-          await fs13.access(path17.join(dir, fileGlob));
-          return [path17.join(dir, fileGlob)];
+          await fs13.access(path18.join(dir, fileGlob));
+          return [path18.join(dir, fileGlob)];
         } catch {
           return [];
         }
@@ -53812,7 +54031,7 @@ var init_sanitizer = __esm({
 });
 
 // src/workspace/applier.ts
-import { existsSync as existsSync8, mkdirSync as mkdirSync3, copyFileSync, writeFileSync as writeFileSync3, unlinkSync, renameSync } from "fs";
+import { existsSync as existsSync9, mkdirSync as mkdirSync3, copyFileSync, writeFileSync as writeFileSync3, unlinkSync, renameSync } from "fs";
 import { dirname as dirname3 } from "path";
 var WorkspaceSyncApplier;
 var init_applier = __esm({
@@ -53843,7 +54062,7 @@ var init_applier = __esm({
         for (const file of files) {
           try {
             const dir = dirname3(file.filePath);
-            if (!existsSync8(dir)) {
+            if (!existsSync9(dir)) {
               mkdirSync3(dir, { recursive: true });
             }
           } catch (err) {
@@ -53852,7 +54071,7 @@ var init_applier = __esm({
           }
         }
         for (const file of files) {
-          if (existsSync8(file.filePath)) {
+          if (existsSync9(file.filePath)) {
             try {
               const backupPath = file.filePath + `.backup-${Date.now()}`;
               copyFileSync(file.filePath, backupPath);
@@ -53903,7 +54122,7 @@ var init_applier = __esm({
       cleanBackups(backups) {
         for (const backup of backups) {
           try {
-            if (existsSync8(backup.backupPath)) {
+            if (existsSync9(backup.backupPath)) {
               unlinkSync(backup.backupPath);
             }
           } catch {
@@ -53919,7 +54138,7 @@ var engine_exports3 = {};
 __export(engine_exports3, {
   WorkspaceSyncEngine: () => WorkspaceSyncEngine
 });
-import { readFileSync as readFileSync7, readdirSync as readdirSync3, existsSync as existsSync9, cpSync, mkdirSync as mkdirSync4 } from "fs";
+import { readFileSync as readFileSync8, readdirSync as readdirSync3, existsSync as existsSync10, cpSync, mkdirSync as mkdirSync4 } from "fs";
 import { join as join21 } from "path";
 import { homedir as homedir21 } from "os";
 var WorkspaceSyncEngine;
@@ -53986,10 +54205,10 @@ var init_engine3 = __esm({
             pathsToCheck.push(join21(homedir21(), ".gemini", "antigravity", "mcp_config.json"));
           }
           const merged = /* @__PURE__ */ new Map();
-          for (const path25 of pathsToCheck) {
-            if (existsSync9(path25)) {
+          for (const path26 of pathsToCheck) {
+            if (existsSync10(path26)) {
               try {
-                const content = readFileSync7(path25, "utf-8");
+                const content = readFileSync8(path26, "utf-8");
                 const servers = adapter.parse(content);
                 for (const s2 of servers) {
                   if (!merged.has(s2.name)) merged.set(s2.name, s2);
@@ -54041,9 +54260,9 @@ var init_engine3 = __esm({
           const adapter = this.adapters.get(target);
           const configPath = adapter.getConfigPath(this.projectRoot);
           let configContent;
-          if (target === "antigravity" && existsSync9(configPath)) {
+          if (target === "antigravity" && existsSync10(configPath)) {
             try {
-              const existing = JSON.parse(readFileSync7(configPath, "utf-8"));
+              const existing = JSON.parse(readFileSync8(configPath, "utf-8"));
               const generated = JSON.parse(adapter.generate(result.mcpServers.scanned));
               existing.mcpServers = { ...existing.mcpServers ?? {}, ...generated.mcpServers };
               configContent = JSON.stringify(existing, null, 2);
@@ -54114,16 +54333,16 @@ var init_engine3 = __esm({
               join21(home, dir)
             ];
             for (const skillsRoot of paths) {
-              if (!existsSync9(skillsRoot)) continue;
+              if (!existsSync10(skillsRoot)) continue;
               try {
                 const entries = readdirSync3(skillsRoot, { withFileTypes: true });
                 for (const entry of entries) {
                   if (!entry.isDirectory()) continue;
                   const skillMd = join21(skillsRoot, entry.name, "SKILL.md");
-                  if (!existsSync9(skillMd)) continue;
+                  if (!existsSync10(skillMd)) continue;
                   let description = "";
                   try {
-                    const content = readFileSync7(skillMd, "utf-8");
+                    const content = readFileSync8(skillMd, "utf-8");
                     const match = content.match(/^---[\s\S]*?description:\s*["']?(.+?)["']?\s*$/m);
                     if (match) description = match[1];
                   } catch {
@@ -54169,7 +54388,7 @@ var init_engine3 = __esm({
         for (const skill of skills) {
           if (skill.sourceAgent === target) continue;
           const dest = join21(targetDir, skill.name);
-          if (existsSync9(dest)) {
+          if (existsSync10(dest)) {
             skipped.push(`${skill.name} (already exists in ${target})`);
             continue;
           }
@@ -54185,12 +54404,12 @@ var init_engine3 = __esm({
       scanWorkflows() {
         const workflows = [];
         const wfDir = join21(this.projectRoot, ".windsurf", "workflows");
-        if (!existsSync9(wfDir)) return workflows;
+        if (!existsSync10(wfDir)) return workflows;
         try {
           const files = readdirSync3(wfDir).filter((f4) => f4.endsWith(".md"));
           for (const file of files) {
             try {
-              const content = readFileSync7(join21(wfDir, file), "utf-8");
+              const content = readFileSync8(join21(wfDir, file), "utf-8");
               workflows.push(this.workflowSyncer.parseWindsurfWorkflow(file, content));
             } catch {
             }
@@ -54322,14 +54541,14 @@ __export(behavior_exports, {
   getBehaviorConfig: () => getBehaviorConfig,
   resetBehaviorConfigCache: () => resetBehaviorConfigCache
 });
-import { readFileSync as readFileSync8 } from "fs";
+import { readFileSync as readFileSync9 } from "fs";
 import { join as join22 } from "path";
 import { homedir as homedir22 } from "os";
 function getBehaviorConfig() {
   if (cached2) return cached2;
   try {
     const configPath = join22(homedir22(), ".memorix", "config.json");
-    const raw = readFileSync8(configPath, "utf-8");
+    const raw = readFileSync9(configPath, "utf-8");
     const config2 = JSON.parse(raw);
     const behavior = config2.behavior ?? {};
     cached2 = {
@@ -54863,11 +55082,12 @@ var init_knowledge_graph = __esm({
 // src/dashboard/server.ts
 var server_exports = {};
 __export(server_exports, {
+  prepareDashboardConfig: () => prepareDashboardConfig,
   startDashboard: () => startDashboard
 });
 import { createServer } from "http";
 import { promises as fs14 } from "fs";
-import path18 from "path";
+import path19 from "path";
 import { exec } from "child_process";
 function sendJson(res, data, status = 200) {
   res.writeHead(status, {
@@ -54888,6 +55108,25 @@ function isActiveStatus(status) {
 function filterActiveByProject(items, projectId) {
   return items.filter((item) => item.projectId === projectId && isActiveStatus(item.status));
 }
+function prepareDashboardConfig(projectRoot) {
+  if (!projectRoot) {
+    if (preparedDashboardProjectRoot !== null) {
+      resetDotenv();
+      preparedDashboardProjectRoot = null;
+    }
+    clearProjectRoot();
+    return;
+  }
+  try {
+    if (preparedDashboardProjectRoot !== null && preparedDashboardProjectRoot !== projectRoot) {
+      resetDotenv();
+    }
+    initProjectRoot(projectRoot);
+    loadDotenv(projectRoot);
+    preparedDashboardProjectRoot = projectRoot;
+  } catch {
+  }
+}
 function computeProjectGraphCounts(allEntities, allRelations, projectObs) {
   const entityNames = new Set(
     projectObs.filter((o3) => (o3.status ?? "active") === "active" && o3.entityName).map((o3) => o3.entityName)
@@ -54913,6 +55152,7 @@ async function handleApi(req, res, dataDir, projectId, projectName, baseDir, pro
     effectiveProjectResolved = true;
     effectiveProjectRoot = null;
   }
+  prepareDashboardConfig(effectiveProjectRoot);
   try {
     switch (apiPath) {
       case "/projects": {
@@ -55161,13 +55401,13 @@ async function handleApi(req, res, dataDir, projectId, projectName, baseDir, pro
       }
       case "/config": {
         const os5 = await import("os");
-        const { existsSync: existsSync18 } = await import("fs");
+        const { existsSync: existsSync19 } = await import("fs");
         const { join: join29 } = await import("path");
         let yml = {};
         const configProjectRoot = effectiveProjectRoot;
         try {
           const { loadYamlConfig: loadYamlConfig2 } = await Promise.resolve().then(() => (init_yaml_loader(), yaml_loader_exports));
-          yml = loadYamlConfig2();
+          yml = configProjectRoot ? loadYamlConfig2(configProjectRoot) : loadYamlConfig2(null);
         } catch {
         }
         if (configProjectRoot) {
@@ -55197,7 +55437,7 @@ async function handleApi(req, res, dataDir, projectId, projectName, baseDir, pro
             if (fpath === null) {
               files[key] = { exists: false, path: "unavailable", unavailable: true };
             } else {
-              files[key] = { exists: existsSync18(fpath), path: fpath };
+              files[key] = { exists: existsSync19(fpath), path: fpath };
             }
           }
         } catch {
@@ -55230,6 +55470,19 @@ async function handleApi(req, res, dataDir, projectId, projectName, baseDir, pro
         } else {
           values.push({ key: "llm.apiKey", value: "not set", source: "none" });
         }
+        const agentProvider = process.env.MEMORIX_AGENT_LLM_PROVIDER || yml.agent?.provider;
+        if (agentProvider) values.push({ key: "agent.llm.provider", value: agentProvider, source: await getEnvSource("MEMORIX_AGENT_LLM_PROVIDER", yml.agent?.provider ? "memorix.yml" : void 0) });
+        const agentModel = process.env.MEMORIX_AGENT_LLM_MODEL || yml.agent?.model;
+        if (agentModel) values.push({ key: "agent.llm.model", value: agentModel, source: await getEnvSource("MEMORIX_AGENT_LLM_MODEL", yml.agent?.model ? "memorix.yml" : void 0) });
+        const agentKey = process.env.MEMORIX_AGENT_LLM_API_KEY || yml.agent?.apiKey;
+        if (agentKey) {
+          let src2 = "unknown";
+          if (process.env.MEMORIX_AGENT_LLM_API_KEY) src2 = await getEnvSource("MEMORIX_AGENT_LLM_API_KEY");
+          else if (yml.agent?.apiKey) src2 = "memorix.yml (move to .env!)";
+          values.push({ key: "agent.llm.apiKey", value: "****" + agentKey.slice(-4), source: src2, sensitive: true });
+        } else {
+          values.push({ key: "agent.llm.apiKey", value: "fallback to llm.apiKey", source: "default" });
+        }
         const embProvider = process.env.MEMORIX_EMBEDDING || yml.embedding?.provider || "off";
         values.push({ key: "embedding.provider", value: embProvider, source: await getEnvSource("MEMORIX_EMBEDDING", yml.embedding?.provider ? "memorix.yml" : void 0) });
         values.push({ key: "git.autoHook", value: String(yml.git?.autoHook ?? false), source: yml.git?.autoHook !== void 0 ? "memorix.yml" : "default" });
@@ -55268,7 +55521,7 @@ async function handleApi(req, res, dataDir, projectId, projectName, baseDir, pro
           const aliasModule = await Promise.resolve().then(() => (init_aliases(), aliases_exports));
           canonicalId = await aliasModule.getCanonicalId(effectiveProjectId);
           const { promises: fsP } = await import("fs");
-          const registryPath = path18.join(baseDir, ".project-aliases.json");
+          const registryPath = path19.join(baseDir, ".project-aliases.json");
           const raw = await fsP.readFile(registryPath, "utf-8");
           const registry2 = JSON.parse(raw);
           aliasGroups = registry2.groups || [];
@@ -55385,14 +55638,14 @@ async function serveStatic(req, res, staticDir) {
   if (urlPath === "/" || !urlPath.includes(".")) {
     urlPath = "/index.html";
   }
-  const filePath = path18.join(staticDir, urlPath);
+  const filePath = path19.join(staticDir, urlPath);
   if (!filePath.startsWith(staticDir)) {
     sendError(res, "Forbidden", 403);
     return;
   }
   try {
     const data = await fs14.readFile(filePath);
-    const ext = path18.extname(filePath);
+    const ext = path19.extname(filePath);
     res.writeHead(200, {
       "Content-Type": MIME_TYPES[ext] || "application/octet-stream",
       "Cache-Control": "no-store, no-cache, must-revalidate, max-age=0",
@@ -55402,7 +55655,7 @@ async function serveStatic(req, res, staticDir) {
     res.end(data);
   } catch {
     try {
-      const indexData = await fs14.readFile(path18.join(staticDir, "index.html"));
+      const indexData = await fs14.readFile(path19.join(staticDir, "index.html"));
       res.writeHead(200, {
         "Content-Type": "text/html; charset=utf-8",
         "Cache-Control": "no-store, no-cache, must-revalidate, max-age=0",
@@ -55665,7 +55918,7 @@ async function startDashboard(dataDir, port, staticDir, projectId, projectName,
     });
   });
 }
-var MIME_TYPES;
+var MIME_TYPES, preparedDashboardProjectRoot;
 var init_server3 = __esm({
   "src/dashboard/server.ts"() {
     "use strict";
@@ -55674,6 +55927,10 @@ var init_server3 = __esm({
     init_obs_store();
     init_session_store();
     init_graph_store();
+    init_dotenv_loader();
+    init_dotenv_loader();
+    init_yaml_loader();
+    init_yaml_loader();
     MIME_TYPES = {
       ".html": "text/html; charset=utf-8",
       ".css": "text/css; charset=utf-8",
@@ -55683,6 +55940,7 @@ var init_server3 = __esm({
       ".png": "image/png",
       ".ico": "image/x-icon"
     };
+    preparedDashboardProjectRoot = null;
   }
 });
 
@@ -55834,23 +56092,23 @@ __export(hooks_path_exports, {
   resolveGitDir: () => resolveGitDir,
   resolveHooksDir: () => resolveHooksDir
 });
-import { existsSync as existsSync10, readFileSync as readFileSync9, statSync as statSync2, mkdirSync as mkdirSync5 } from "fs";
-import path19 from "path";
+import { existsSync as existsSync11, readFileSync as readFileSync10, statSync as statSync2, mkdirSync as mkdirSync5 } from "fs";
+import path20 from "path";
 function resolveGitDir(projectRoot) {
-  const dotGit = path19.join(projectRoot, ".git");
-  if (!existsSync10(dotGit)) return null;
+  const dotGit = path20.join(projectRoot, ".git");
+  if (!existsSync11(dotGit)) return null;
   const stat = statSync2(dotGit);
   if (stat.isDirectory()) {
     return dotGit;
   }
   if (stat.isFile()) {
     try {
-      const content = readFileSync9(dotGit, "utf-8").trim();
+      const content = readFileSync10(dotGit, "utf-8").trim();
       const match = content.match(/^gitdir:\s*(.+)$/);
       if (match) {
         const gitdir = match[1].trim();
-        const resolved = path19.isAbsolute(gitdir) ? gitdir : path19.resolve(projectRoot, gitdir);
-        if (existsSync10(resolved)) {
+        const resolved = path20.isAbsolute(gitdir) ? gitdir : path20.resolve(projectRoot, gitdir);
+        if (existsSync11(resolved)) {
           return resolved;
         }
       }
@@ -55862,10 +56120,10 @@ function resolveGitDir(projectRoot) {
 function resolveHooksDir(projectRoot) {
   const gitDir = resolveGitDir(projectRoot);
   if (!gitDir) return null;
-  const hooksDir = path19.join(gitDir, "hooks");
+  const hooksDir = path20.join(gitDir, "hooks");
   return {
     hooksDir,
-    hookPath: path19.join(hooksDir, "post-commit")
+    hookPath: path20.join(hooksDir, "post-commit")
   };
 }
 function ensureHooksDir(projectRoot) {
@@ -55886,7 +56144,7 @@ var server_exports2 = {};
 __export(server_exports2, {
   createMemorixServer: () => createMemorixServer
 });
-import { createHash as createHash4 } from "crypto";
+import { createHash as createHash5 } from "crypto";
 import { watchFile } from "fs";
 function withTimeout(promise, ms, label) {
   let timer;
@@ -55978,7 +56236,7 @@ function coerceObjectArray(val) {
   return [];
 }
 function createDeterministicInstanceId(projectId, agentType, agentName) {
-  const digest = createHash4("sha256").update(projectId).update("\n").update(agentType).update("\n").update(agentName ?? "").digest("hex").slice(0, 24);
+  const digest = createHash5("sha256").update(projectId).update("\n").update(agentType).update("\n").update(agentName ?? "").digest("hex").slice(0, 24);
   return `auto-${digest}`;
 }
 async function createMemorixServer(cwd, existingServer, sharedTeam, options2 = {}) {
@@ -56129,7 +56387,7 @@ The path should point to a directory containing a .git folder.`
   };
   const server = existingServer ?? new McpServer({
     name: "memorix",
-    version: true ? "1.0.9" : "1.0.1"
+    version: true ? "1.0.10" : "1.0.1"
   });
   const originalRegisterTool = server.registerTool.bind(server);
   server.registerTool = ((name, ...args) => {
@@ -57788,9 +58046,9 @@ ${skill.content}` }]
         lines.push(`- **Description**: ${sk.description}`);
         lines.push(`- **Observations**: ${sk.content.split("\n").length} lines of knowledge`);
         if (write && target) {
-          const path25 = engine.writeSkill(sk, target);
-          if (path25) {
-            lines.push(`- [OK] **Written**: \`${path25}\``);
+          const path26 = engine.writeSkill(sk, target);
+          if (path26) {
+            lines.push(`- [OK] **Written**: \`${path26}\``);
           } else {
             lines.push(`- [ERROR] Failed to write`);
           }
@@ -58931,10 +59189,10 @@ Preview: ${analysis.description.slice(0, 300)}${analysis.description.length > 30
         const { ensureHooksDir: ensureHooksDir2 } = await Promise.resolve().then(() => (init_hooks_path(), hooks_path_exports));
         const resolved = ensureHooksDir2(project.rootPath);
         if (resolved) {
-          const { existsSync: existsSync18, readFileSync: readFileSync17, writeFileSync: writeFileSync10, chmodSync: chmodSync2 } = await import("fs");
+          const { existsSync: existsSync19, readFileSync: readFileSync18, writeFileSync: writeFileSync10, chmodSync: chmodSync2 } = await import("fs");
           const { hookPath } = resolved;
           const HOOK_MARKER3 = "# [memorix-git-hook]";
-          const needsInstall = !existsSync18(hookPath) || !readFileSync17(hookPath, "utf-8").includes(HOOK_MARKER3);
+          const needsInstall = !existsSync19(hookPath) || !readFileSync18(hookPath, "utf-8").includes(HOOK_MARKER3);
           if (needsInstall) {
             const hookScript = `#!/bin/sh
 ${HOOK_MARKER3}
@@ -58943,8 +59201,8 @@ if command -v memorix >/dev/null 2>&1; then
   memorix ingest commit --auto >/dev/null 2>&1 &
 fi
 `;
-            if (existsSync18(hookPath)) {
-              const existing = readFileSync17(hookPath, "utf-8");
+            if (existsSync19(hookPath)) {
+              const existing = readFileSync18(hookPath, "utf-8");
               writeFileSync10(hookPath, existing.trimEnd() + `
 
 ${HOOK_MARKER3}
@@ -59393,10 +59651,12 @@ async function writeCache(cache4) {
   } catch {
   }
 }
-function isAutoUpdateEnabled() {
-  const env2 = process.env.MEMORIX_AUTO_UPDATE?.toLowerCase()?.trim();
-  if (env2 === "off" || env2 === "false" || env2 === "0" || env2 === "notify") return false;
-  return true;
+function parseAutoUpdateMode(raw) {
+  const env2 = raw?.toLowerCase()?.trim();
+  if (!env2 || env2 === "notify") return "notify";
+  if (env2 === "off" || env2 === "false" || env2 === "0") return "off";
+  if (env2 === "install" || env2 === "true" || env2 === "1") return "install";
+  return "notify";
 }
 function parseAutoUpdateTimeoutMs(raw) {
   const value = raw?.trim();
@@ -59489,7 +59749,8 @@ function installUpdateInBackground(targetVersion, currentVersion, cache4) {
 }
 async function checkForUpdates() {
   try {
-    if (!isAutoUpdateEnabled()) return;
+    const mode = parseAutoUpdateMode(process.env.MEMORIX_AUTO_UPDATE);
+    if (mode === "off") return;
     const cache4 = await readCache();
     const now = Date.now();
     if (cache4 && now - cache4.lastCheck < CHECK_INTERVAL_MS) {
@@ -59513,8 +59774,14 @@ async function checkForUpdates() {
     };
     await writeCache(updatedCache);
     if (isNewer(latestVersion, currentVersion)) {
-      console.error(`[memorix] v${latestVersion} available (current: v${currentVersion}), auto-updating...`);
-      installUpdateInBackground(latestVersion, currentVersion, updatedCache);
+      if (mode === "install") {
+        console.error(`[memorix] v${latestVersion} available (current: v${currentVersion}), auto-updating...`);
+        installUpdateInBackground(latestVersion, currentVersion, updatedCache);
+      } else {
+        console.error(
+          `[memorix] v${latestVersion} available (current: v${currentVersion}). Run "npm install -g memorix@latest" to update, or set MEMORIX_AUTO_UPDATE=install for background install.`
+        );
+      }
     }
   } catch {
   }
@@ -59537,7 +59804,7 @@ var init_update_checker = __esm({
       CACHE_FILE: CACHE_FILE3,
       CHECK_INTERVAL_MS,
       DEFAULT_AUTO_UPDATE_TIMEOUT_MS,
-      isAutoUpdateEnabled,
+      parseAutoUpdateMode,
       parseAutoUpdateTimeoutMs,
       describeAutoUpdateFailure,
       fetchLatestVersion,
@@ -59599,14 +59866,14 @@ var init_serve = __esm({
         } catch {
           safeCwd = homedir25();
         }
-        const { existsSync: existsSync18, readFileSync: readFileSync17 } = await import("fs");
-        const path25 = await import("path");
-        const lastRootFile = path25.join(homedir25(), ".memorix", "last-project-root");
+        const { existsSync: existsSync19, readFileSync: readFileSync18 } = await import("fs");
+        const path26 = await import("path");
+        const lastRootFile = path26.join(homedir25(), ".memorix", "last-project-root");
         let lastKnownProjectRoot;
-        if (existsSync18(lastRootFile)) {
+        if (existsSync19(lastRootFile)) {
           try {
-            const lastRoot = readFileSync17(lastRootFile, "utf-8").trim();
-            if (lastRoot && existsSync18(lastRoot)) {
+            const lastRoot = readFileSync18(lastRootFile, "utf-8").trim();
+            if (lastRoot && existsSync19(lastRoot)) {
               lastKnownProjectRoot = lastRoot;
             }
           } catch {
@@ -59636,9 +59903,9 @@ var init_serve = __esm({
         if (detected) {
           try {
             const { writeFileSync: writeFileSync10, mkdirSync: mkdirSync10 } = await import("fs");
-            const memorixDir = path25.join(homedir25(), ".memorix");
+            const memorixDir = path26.join(homedir25(), ".memorix");
             mkdirSync10(memorixDir, { recursive: true });
-            writeFileSync10(path25.join(memorixDir, "last-project-root"), detected.rootPath, "utf-8");
+            writeFileSync10(path26.join(memorixDir, "last-project-root"), detected.rootPath, "utf-8");
           } catch {
           }
         }
@@ -61012,7 +61279,7 @@ var init_serve_http = __esm({
         const { isInitializeRequest: isInitializeRequest2 } = await Promise.resolve().then(() => (init_types4(), types_exports));
         const { createMemorixServer: createMemorixServer2 } = await Promise.resolve().then(() => (init_server4(), server_exports2));
         const { findGitInSubdirs: findGitInSubdirs2, detectProjectWithDiagnostics: detectProjectWithDiagnostics2 } = await Promise.resolve().then(() => (init_detector(), detector_exports));
-        const { existsSync: existsSync18, readFileSync: readFileSync17, writeFileSync: writeFileSync10, mkdirSync: mkdirSync10 } = await import("fs");
+        const { existsSync: existsSync19, readFileSync: readFileSync18, writeFileSync: writeFileSync10, mkdirSync: mkdirSync10 } = await import("fs");
         const { homedir: homedir25 } = await import("os");
         const earlyPath = await import("path");
         const port = parseInt(args.port || "3211", 10);
@@ -61027,10 +61294,10 @@ var init_serve_http = __esm({
         let projectRoot = args.cwd || process.env.MEMORIX_PROJECT_ROOT || safeCwd;
         const lastRootFile = earlyPath.join(homedir25(), ".memorix", "last-project-root");
         const initialCheck = detectProjectWithDiagnostics2(projectRoot);
-        if (!initialCheck.project && existsSync18(lastRootFile)) {
+        if (!initialCheck.project && existsSync19(lastRootFile)) {
           try {
-            const lastRoot = readFileSync17(lastRootFile, "utf-8").trim();
-            if (lastRoot && existsSync18(lastRoot)) {
+            const lastRoot = readFileSync18(lastRootFile, "utf-8").trim();
+            if (lastRoot && existsSync19(lastRoot)) {
               const lastCheck = detectProjectWithDiagnostics2(lastRoot);
               if (lastCheck.project) {
                 console.error(`[memorix] No git at "${projectRoot}", restored last known project: ${lastRoot}`);
@@ -61729,7 +61996,7 @@ var init_serve_http = __esm({
             if (apiPath === "/config") {
               const { projectId: configProjectId } = await resolveRequestProject(url);
               const os5 = await import("os");
-              const { existsSync: existsSync19 } = await import("fs");
+              const { existsSync: existsSync20 } = await import("fs");
               const { join: join29 } = await import("path");
               const { loadYamlConfig: loadYamlConfig2 } = await Promise.resolve().then(() => (init_yaml_loader(), yaml_loader_exports));
               const { loadFileConfig: loadFileConfig2, loadDotenv: loadDotenv2, getLoadedEnvFiles: getLoadedEnvFiles2 } = await Promise.resolve().then(() => (init_config(), config_exports));
@@ -61751,7 +62018,7 @@ var init_serve_http = __esm({
                   "legacy config.json": join29(home, ".memorix", "config.json")
                 };
                 for (const [key, fpath] of Object.entries(paths)) {
-                  files[key] = { exists: existsSync19(fpath), path: fpath };
+                  files[key] = { exists: existsSync20(fpath), path: fpath };
                 }
               } else {
                 files["project memorix.yml"] = { exists: false, path: "unavailable", unavailable: true };
@@ -61762,7 +62029,7 @@ var init_serve_http = __esm({
                   "legacy config.json": join29(home, ".memorix", "config.json")
                 };
                 for (const [key, fpath] of Object.entries(userPaths)) {
-                  files[key] = { exists: existsSync19(fpath), path: fpath };
+                  files[key] = { exists: existsSync20(fpath), path: fpath };
                 }
               }
               const values = [];
@@ -61794,6 +62061,32 @@ var init_serve_http = __esm({
               } else {
                 values.push({ key: "llm.apiKey", value: "not set", source: "none" });
               }
+              const agentProvider = process.env.MEMORIX_AGENT_LLM_PROVIDER || yml.agent?.provider || legacy.agent?.provider;
+              if (agentProvider) {
+                values.push({
+                  key: "agent.llm.provider",
+                  value: agentProvider,
+                  source: process.env.MEMORIX_AGENT_LLM_PROVIDER ? "env:MEMORIX_AGENT_LLM_PROVIDER" : yml.agent?.provider ? "memorix.yml" : "config.json"
+                });
+              }
+              const agentModel = process.env.MEMORIX_AGENT_LLM_MODEL || yml.agent?.model || legacy.agent?.model;
+              if (agentModel) {
+                values.push({
+                  key: "agent.llm.model",
+                  value: agentModel,
+                  source: process.env.MEMORIX_AGENT_LLM_MODEL ? "env:MEMORIX_AGENT_LLM_MODEL" : yml.agent?.model ? "memorix.yml" : "config.json"
+                });
+              }
+              const agentKey = process.env.MEMORIX_AGENT_LLM_API_KEY || yml.agent?.apiKey || legacy.agent?.apiKey;
+              if (agentKey) {
+                let src2 = "unknown";
+                if (process.env.MEMORIX_AGENT_LLM_API_KEY) src2 = "env:MEMORIX_AGENT_LLM_API_KEY";
+                else if (yml.agent?.apiKey) src2 = "memorix.yml (move to .env!)";
+                else if (legacy.agent?.apiKey) src2 = "config.json (legacy)";
+                values.push({ key: "agent.llm.apiKey", value: "****" + agentKey.slice(-4), source: src2, sensitive: true });
+              } else {
+                values.push({ key: "agent.llm.apiKey", value: "fallback to llm.apiKey", source: "default" });
+              }
               const embProvider = process.env.MEMORIX_EMBEDDING || yml.embedding?.provider || legacy.embedding || "off";
               values.push({
                 key: "embedding.provider",
@@ -62204,7 +62497,7 @@ var init_status = __esm({
         const { RulesSyncer: RulesSyncer2 } = await Promise.resolve().then(() => (init_syncer(), syncer_exports));
         const { getProjectDataDir: getProjectDataDir2 } = await Promise.resolve().then(() => (init_persistence(), persistence_exports));
         const { getEmbeddingProvider: getEmbeddingProvider2 } = await Promise.resolve().then(() => (init_provider(), provider_exports));
-        const { existsSync: existsSync18, readFileSync: readFileSync17 } = await import("fs");
+        const { existsSync: existsSync19, readFileSync: readFileSync18 } = await import("fs");
         const { join: join29 } = await import("path");
         we("memorix status");
         const project = detectProject2();
@@ -62279,11 +62572,11 @@ Embedding: ${embeddingStatus}${embeddingHint}`,
           const userEnv = join29(os5.homedir(), ".memorix", ".env");
           const legacyJson = join29(os5.homedir(), ".memorix", "config.json");
           diagLines.push("Config files:");
-          diagLines.push(`  memorix.yml (project): ${existsSync18(projectYml) ? "[OK] " + projectYml : "[ERROR] not found"}`);
-          diagLines.push(`  memorix.yml (user):    ${existsSync18(userYml) ? "[OK] " + userYml : "\u2014 not found"}`);
-          diagLines.push(`  .env (project):        ${existsSync18(projectEnv) ? "[OK] " + projectEnv : "\u2014 not found"}`);
-          diagLines.push(`  .env (user):           ${existsSync18(userEnv) ? "[OK] " + userEnv : "\u2014 not found"}`);
-          diagLines.push(`  config.json (legacy):  ${existsSync18(legacyJson) ? "[WARN]  " + legacyJson : "\u2014 not found"}`);
+          diagLines.push(`  memorix.yml (project): ${existsSync19(projectYml) ? "[OK] " + projectYml : "[ERROR] not found"}`);
+          diagLines.push(`  memorix.yml (user):    ${existsSync19(userYml) ? "[OK] " + userYml : "\u2014 not found"}`);
+          diagLines.push(`  .env (project):        ${existsSync19(projectEnv) ? "[OK] " + projectEnv : "\u2014 not found"}`);
+          diagLines.push(`  .env (user):           ${existsSync19(userEnv) ? "[OK] " + userEnv : "\u2014 not found"}`);
+          diagLines.push(`  config.json (legacy):  ${existsSync19(legacyJson) ? "[WARN]  " + legacyJson : "\u2014 not found"}`);
           const loadedEnv = getLoadedEnvFiles2();
           if (loadedEnv.length > 0) {
             diagLines.push(`  Loaded .env files:     ${loadedEnv.join(", ")}`);
@@ -62312,6 +62605,23 @@ Embedding: ${embeddingStatus}${embeddingHint}`,
           } else {
             diagLines.push(`  LLM API key:   not set`);
           }
+          const agentProvider = process.env.MEMORIX_AGENT_LLM_PROVIDER || yml.agent?.provider || legacy.agent?.provider;
+          if (agentProvider) {
+            const src2 = process.env.MEMORIX_AGENT_LLM_PROVIDER ? "env:MEMORIX_AGENT_LLM_PROVIDER" : yml.agent?.provider ? "memorix.yml" : "config.json";
+            diagLines.push(`  Agent LLM provider: ${agentProvider} (\u2190 ${src2})`);
+          }
+          const agentModel = process.env.MEMORIX_AGENT_LLM_MODEL || yml.agent?.model || legacy.agent?.model;
+          if (agentModel) {
+            const src2 = process.env.MEMORIX_AGENT_LLM_MODEL ? "env:MEMORIX_AGENT_LLM_MODEL" : yml.agent?.model ? "memorix.yml" : "config.json";
+            diagLines.push(`  Agent LLM model:    ${agentModel} (\u2190 ${src2})`);
+          }
+          const agentKey = process.env.MEMORIX_AGENT_LLM_API_KEY || yml.agent?.apiKey || legacy.agent?.apiKey;
+          if (agentKey) {
+            const src2 = process.env.MEMORIX_AGENT_LLM_API_KEY ? "env:MEMORIX_AGENT_LLM_API_KEY" : yml.agent?.apiKey ? "memorix.yml (consider moving to .env)" : "config.json (legacy)";
+            diagLines.push(`  Agent LLM API key:  ${"*".repeat(8)}...${agentKey.slice(-4)} (\u2190 ${src2})`);
+          } else {
+            diagLines.push(`  Agent LLM:     falls back to LLM config`);
+          }
           const embMode = process.env.MEMORIX_EMBEDDING || yml.embedding?.provider || legacy.embedding || "off";
           const embSrc = process.env.MEMORIX_EMBEDDING ? "env" : yml.embedding?.provider ? "memorix.yml" : legacy.embedding ? "config.json" : "default";
           diagLines.push(`  Embedding:     ${embMode} (\u2190 ${embSrc})`);
@@ -62326,8 +62636,8 @@ Embedding: ${embeddingStatus}${embeddingHint}`,
           try {
             const { resolveHooksDir: resolveHooksDir2 } = await Promise.resolve().then(() => (init_hooks_path(), hooks_path_exports));
             const resolved = resolveHooksDir2(project.rootPath);
-            if (resolved && existsSync18(resolved.hookPath)) {
-              const hookContent = readFileSync17(resolved.hookPath, "utf-8");
+            if (resolved && existsSync19(resolved.hookPath)) {
+              const hookContent = readFileSync18(resolved.hookPath, "utf-8");
               if (hookContent.includes("# [memorix-git-hook]")) {
                 diagLines.push(`  Git hook:      installed [OK]`);
               } else {
@@ -62338,7 +62648,7 @@ Embedding: ${embeddingStatus}${embeddingHint}`,
             }
           } catch {
           }
-          if (!existsSync18(projectYml)) {
+          if (!existsSync19(projectYml)) {
             diagLines.push("");
             diagLines.push('[TIP] Run "memorix init" to create memorix.yml + .env');
           }
@@ -62529,7 +62839,7 @@ var init_sync = __esm({
         const { detectProject: detectProject2 } = await Promise.resolve().then(() => (init_detector(), detector_exports));
         const { RulesSyncer: RulesSyncer2 } = await Promise.resolve().then(() => (init_syncer(), syncer_exports));
         const { promises: fs21 } = await import("fs");
-        const path25 = await import("path");
+        const path26 = await import("path");
         we("memorix sync");
         const project = detectProject2();
         if (!project) {
@@ -62601,8 +62911,8 @@ var init_sync = __esm({
           process.exit(0);
         }
         for (const file of files) {
-          const fullPath = path25.join(project.rootPath, file.filePath);
-          await fs21.mkdir(path25.dirname(fullPath), { recursive: true });
+          const fullPath = path26.join(project.rootPath, file.filePath);
+          await fs21.mkdir(path26.dirname(fullPath), { recursive: true });
           await fs21.writeFile(fullPath, file.content, "utf-8");
           v3.success(`Written: ${file.filePath}`);
         }
@@ -63583,9 +63893,9 @@ ${lines.join("\n")}`;
   }
   let systemMessage;
   if (injectMode === "full" && contextSummary) {
-    systemMessage = `Previous session context available. Use memorix_search if needed.${contextSummary}`;
+    systemMessage = `Previous session context may be available. Use memorix_search when prior project context would materially help. If search reports a fresh project with no Memorix memories yet, treat that as a cold-start signal and do not repeat the search in the same turn.${contextSummary}`;
   } else {
-    systemMessage = "Previous session context available. Use memorix_search if needed.";
+    systemMessage = "Previous session context may be available. Use memorix_search when prior project context would materially help. If search reports a fresh project with no Memorix memories yet, do not repeat the search in the same turn.";
   }
   return {
     observation: null,
@@ -64038,7 +64348,7 @@ __export(hooks_preview_exports, {
   default: () => hooks_preview_default
 });
 import * as fs15 from "fs/promises";
-import * as path20 from "path";
+import * as path21 from "path";
 function estimateFileSize(agent, configPath) {
   const sizes = {
     claude: "~2KB",
@@ -64058,30 +64368,30 @@ function getRulesPath(agent, cwd, global2) {
   if (global2) {
     switch (agent) {
       case "cursor":
-        return path20.join(home, ".cursor", "rules", "memorix.mdc");
+        return path21.join(home, ".cursor", "rules", "memorix.mdc");
       case "codex":
-        return path20.join(home, ".codex", "AGENTS.md");
+        return path21.join(home, ".codex", "AGENTS.md");
       case "opencode":
-        return path20.join(home, ".opencode", "AGENTS.md");
+        return path21.join(home, ".opencode", "AGENTS.md");
       case "antigravity":
-        return path20.join(home, ".gemini", "GEMINI.md");
+        return path21.join(home, ".gemini", "GEMINI.md");
       case "trae":
-        return path20.join(home, ".trae", "rules", "project_rules.md");
+        return path21.join(home, ".trae", "rules", "project_rules.md");
       default:
         return "";
     }
   } else {
     switch (agent) {
       case "cursor":
-        return path20.join(cwd, ".cursor", "rules", "memorix.mdc");
+        return path21.join(cwd, ".cursor", "rules", "memorix.mdc");
       case "codex":
-        return path20.join(cwd, ".codex", "AGENTS.md");
+        return path21.join(cwd, ".codex", "AGENTS.md");
       case "opencode":
-        return path20.join(cwd, ".opencode", "AGENTS.md");
+        return path21.join(cwd, ".opencode", "AGENTS.md");
       case "antigravity":
-        return path20.join(cwd, ".gemini", "GEMINI.md");
+        return path21.join(cwd, ".gemini", "GEMINI.md");
       case "trae":
-        return path20.join(cwd, ".trae", "rules", "project_rules.md");
+        return path21.join(cwd, ".trae", "rules", "project_rules.md");
       default:
         return "";
     }
@@ -64170,10 +64480,10 @@ var init_hooks_preview = __esm({
             }
           }
           if (agent === "kiro") {
-            const hooksDir = path20.dirname(configPath);
+            const hooksDir = path21.dirname(configPath);
             previewItems.push({
               agent,
-              path: path20.join(hooksDir, "*.kiro.hook"),
+              path: path21.join(hooksDir, "*.kiro.hook"),
               action: "create",
               size: "~500B each"
             });
@@ -64931,10 +65241,10 @@ var ingest_image_exports = {};
 __export(ingest_image_exports, {
   default: () => ingest_image_default
 });
-import { readFileSync as readFileSync10 } from "fs";
-import path21 from "path";
+import { readFileSync as readFileSync11 } from "fs";
+import path22 from "path";
 function inferMimeType(filePath) {
-  const ext = path21.extname(filePath).toLowerCase();
+  const ext = path22.extname(filePath).toLowerCase();
   switch (ext) {
     case ".jpg":
     case ".jpeg":
@@ -64976,9 +65286,9 @@ var init_ingest_image = __esm({
             return;
           }
           const { project } = await getCliProjectContext();
-          const resolvedPath = path21.resolve(process.cwd(), imagePath);
-          const base642 = readFileSync10(resolvedPath).toString("base64");
-          const filename = path21.basename(resolvedPath);
+          const resolvedPath = path22.resolve(process.cwd(), imagePath);
+          const base642 = readFileSync11(resolvedPath).toString("base64");
+          const filename = path22.basename(resolvedPath);
           const analysis = await analyzeImage({
             base64: base642,
             filename,
@@ -65062,7 +65372,7 @@ var git_hook_install_exports = {};
 __export(git_hook_install_exports, {
   default: () => git_hook_install_default
 });
-import { existsSync as existsSync11, readFileSync as readFileSync11, writeFileSync as writeFileSync4, chmodSync } from "fs";
+import { existsSync as existsSync12, readFileSync as readFileSync12, writeFileSync as writeFileSync4, chmodSync } from "fs";
 function generateHookScript() {
   return `${HOOK_MARKER}
 # Memorix: Auto-ingest git commits as memories
@@ -65109,8 +65419,8 @@ var init_git_hook_install = __esm({
           return;
         }
         const { hookPath } = resolved;
-        if (existsSync11(hookPath)) {
-          const existing = readFileSync11(hookPath, "utf-8");
+        if (existsSync12(hookPath)) {
+          const existing = readFileSync12(hookPath, "utf-8");
           if (existing.includes(HOOK_MARKER)) {
             v3.warn("Memorix git hook is already installed.");
             fe2("Use `memorix git-hook uninstall` to remove it first.");
@@ -65159,7 +65469,7 @@ var git_hook_uninstall_exports = {};
 __export(git_hook_uninstall_exports, {
   default: () => git_hook_uninstall_default
 });
-import { existsSync as existsSync12, readFileSync as readFileSync12, writeFileSync as writeFileSync5, unlinkSync as unlinkSync2 } from "fs";
+import { existsSync as existsSync13, readFileSync as readFileSync13, writeFileSync as writeFileSync5, unlinkSync as unlinkSync2 } from "fs";
 var HOOK_MARKER2, git_hook_uninstall_default;
 var init_git_hook_uninstall = __esm({
   "src/cli/commands/git-hook-uninstall.ts"() {
@@ -65191,12 +65501,12 @@ var init_git_hook_uninstall = __esm({
           return;
         }
         const { hookPath } = resolved;
-        if (!existsSync12(hookPath)) {
+        if (!existsSync13(hookPath)) {
           v3.warn("No post-commit hook found.");
           fe2("Nothing to uninstall.");
           return;
         }
-        const content = readFileSync12(hookPath, "utf-8");
+        const content = readFileSync13(hookPath, "utf-8");
         if (!content.includes(HOOK_MARKER2)) {
           v3.warn("Post-commit hook exists but does not contain memorix hook.");
           fe2("Nothing to uninstall.");
@@ -65777,10 +66087,15 @@ var init_doctor = __esm({
           type: "boolean",
           description: "Output as JSON instead of human-readable text",
           default: false
+        },
+        receipt: {
+          type: "boolean",
+          description: "Include privacy-safe memory handoff receipt",
+          default: false
         }
       },
       run: async ({ args }) => {
-        const { existsSync: existsSync18, readFileSync: readFileSync17 } = await import("fs");
+        const { existsSync: existsSync19, readFileSync: readFileSync18 } = await import("fs");
         const { join: join29, basename: basename4 } = await import("path");
         const { homedir: homedir25 } = await import("os");
         const { execSync: execSync10 } = await import("child_process");
@@ -65849,8 +66164,8 @@ var init_doctor = __esm({
         let bgPort = 0;
         let bgPid = 0;
         try {
-          if (existsSync18(bgStatePath)) {
-            const bgState = JSON.parse(readFileSync17(bgStatePath, "utf-8"));
+          if (existsSync19(bgStatePath)) {
+            const bgState = JSON.parse(readFileSync18(bgStatePath, "utf-8"));
             bgPid = bgState.pid;
             bgPort = bgState.port;
             try {
@@ -65942,8 +66257,8 @@ var init_doctor = __esm({
             }
             try {
               const cachePath = join29(memorixDir, "embedding-cache.json");
-              if (existsSync18(cachePath)) {
-                const cache4 = JSON.parse(readFileSync17(cachePath, "utf-8"));
+              if (existsSync19(cachePath)) {
+                const cache4 = JSON.parse(readFileSync18(cachePath, "utf-8"));
                 const cacheCount = Object.keys(cache4).length;
                 lines.push(info(`Cached embeddings: ${cacheCount}`));
                 report.embedding.cachedEmbeddings = cacheCount;
@@ -65957,7 +66272,7 @@ var init_doctor = __esm({
         }
         lines.push("");
         lines.push("\u250C\u2500 Data Status \u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500");
-        if (dataDir && existsSync18(dataDir)) {
+        if (dataDir && existsSync19(dataDir)) {
           let obsCount = 0;
           let activeCount = 0;
           let ranCount = 0;
@@ -66021,9 +66336,9 @@ var init_doctor = __esm({
         let conflictsFound = false;
         if (dataDir) {
           const lockFile = join29(dataDir, ".memorix.lock");
-          if (existsSync18(lockFile)) {
+          if (existsSync19(lockFile)) {
             try {
-              const lockData = JSON.parse(readFileSync17(lockFile, "utf-8"));
+              const lockData = JSON.parse(readFileSync18(lockFile, "utf-8"));
               const lockAge = Date.now() - lockData.time;
               if (lockAge < 1e4) {
                 lines.push(warn(`Active file lock (PID ${lockData.pid}, age ${Math.round(lockAge / 1e3)}s)`));
@@ -66080,15 +66395,32 @@ var init_doctor = __esm({
           } else {
             lines.push(info("No update checks recorded yet"));
           }
-          const autoEnabled = !["off", "false", "0", "notify"].includes(
-            (process.env.MEMORIX_AUTO_UPDATE ?? "").toLowerCase().trim()
-          );
-          lines.push(info(`Auto-update: ${autoEnabled ? "enabled (install)" : "disabled"}`));
-          report.autoUpdate = { enabled: autoEnabled, currentVersion: curVer, cache: cache4 };
+          const modeRaw = (process.env.MEMORIX_AUTO_UPDATE ?? "").toLowerCase().trim();
+          const autoUpdateMode = !modeRaw || modeRaw === "notify" ? "notify" : ["off", "false", "0"].includes(modeRaw) ? "off" : ["install", "true", "1"].includes(modeRaw) ? "install" : "notify";
+          lines.push(info(
+            autoUpdateMode === "off" ? "Auto-update: disabled" : autoUpdateMode === "install" ? "Auto-update: enabled (background install)" : "Auto-update: enabled (notify only)"
+          ));
+          report.autoUpdate = { enabled: autoUpdateMode !== "off", mode: autoUpdateMode, currentVersion: curVer, cache: cache4 };
         } catch {
           lines.push(info("Auto-update status unavailable"));
           report.autoUpdate = { enabled: false };
         }
+        if (args.receipt && projectId) {
+          lines.push("");
+          lines.push("\u250C\u2500 Memory Handoff Receipt \u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500");
+          try {
+            const { buildHandoffReceipt: buildHandoffReceipt2 } = await Promise.resolve().then(() => (init_receipt_service(), receipt_service_exports));
+            const receipt = await buildHandoffReceipt2({ cwd: projectRoot || process.cwd(), transport: "cli" });
+            lines.push(ok(`Project identity: ${receipt["project.identity_hash"]}`));
+            lines.push(ok(`Stored memories: ${receipt["memory.write.count"]}`));
+            lines.push(info(String(receipt.boundary)));
+            report.receipt = receipt;
+          } catch (e3) {
+            const message = e3 instanceof Error ? e3.message : String(e3);
+            lines.push(warn(`Receipt unavailable: ${message}`));
+            report.receipt = { error: message };
+          }
+        }
         lines.push("");
         lines.push("\u250C\u2500 Summary \u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500");
         if (issues.length === 0) {
@@ -66125,7 +66457,7 @@ __export(dashboard_exports, {
   default: () => dashboard_default
 });
 import { fileURLToPath as fileURLToPath2 } from "url";
-import path22 from "path";
+import path23 from "path";
 var dashboard_default;
 var init_dashboard = __esm({
   "src/cli/commands/dashboard.ts"() {
@@ -66155,8 +66487,8 @@ var init_dashboard = __esm({
         }
         const dataDir = await getProjectDataDir2(project.id);
         const port = parseInt(args.port, 10) || 3210;
-        const cliDir = path22.dirname(fileURLToPath2(import.meta.url));
-        const staticDir = path22.join(cliDir, "..", "dashboard", "static");
+        const cliDir = path23.dirname(fileURLToPath2(import.meta.url));
+        const staticDir = path23.join(cliDir, "..", "dashboard", "static");
         await startDashboard2(dataDir, port, staticDir, project.id, project.name, true, void 0, project.rootPath, true);
         await new Promise(() => {
         });
@@ -66393,7 +66725,7 @@ __export(uninstall_exports, {
   default: () => uninstall_default
 });
 import * as fs17 from "fs";
-import * as path23 from "path";
+import * as path24 from "path";
 import * as os4 from "os";
 function exists(p2) {
   try {
@@ -66427,100 +66759,100 @@ function getMCPConfigEntries(home, cwd) {
   const entries = [];
   entries.push({
     agent: "Claude Code",
-    path: path23.join(home, ".claude.json"),
+    path: path24.join(home, ".claude.json"),
     kind: "global",
     format: "json",
-    detected: checkJSON(path23.join(home, ".claude.json")),
+    detected: checkJSON(path24.join(home, ".claude.json")),
     note: 'Remove the "memorix" key from mcpServers in this file.'
   });
   entries.push({
     agent: "Claude Code",
-    path: path23.join(cwd, ".claude", "settings.json"),
+    path: path24.join(cwd, ".claude", "settings.json"),
     kind: "project",
     format: "json",
-    detected: checkJSON(path23.join(cwd, ".claude", "settings.json")),
+    detected: checkJSON(path24.join(cwd, ".claude", "settings.json")),
     note: 'Remove the "memorix" key from mcpServers in this file.'
   });
   entries.push({
     agent: "Cursor",
-    path: path23.join(home, ".cursor", "mcp.json"),
+    path: path24.join(home, ".cursor", "mcp.json"),
     kind: "global",
     format: "json",
-    detected: checkJSON(path23.join(home, ".cursor", "mcp.json")),
+    detected: checkJSON(path24.join(home, ".cursor", "mcp.json")),
     note: 'Remove the "memorix" key from mcpServers in this file.'
   });
   entries.push({
     agent: "Cursor",
-    path: path23.join(cwd, ".cursor", "mcp.json"),
+    path: path24.join(cwd, ".cursor", "mcp.json"),
     kind: "project",
     format: "json",
-    detected: checkJSON(path23.join(cwd, ".cursor", "mcp.json")),
+    detected: checkJSON(path24.join(cwd, ".cursor", "mcp.json")),
     note: 'Remove the "memorix" key from mcpServers in this file.'
   });
   entries.push({
     agent: "Windsurf",
-    path: path23.join(home, ".codeium", "windsurf", "mcp_config.json"),
+    path: path24.join(home, ".codeium", "windsurf", "mcp_config.json"),
     kind: "global",
     format: "json",
-    detected: checkJSON(path23.join(home, ".codeium", "windsurf", "mcp_config.json")),
+    detected: checkJSON(path24.join(home, ".codeium", "windsurf", "mcp_config.json")),
     note: 'Remove the "memorix" key from mcpServers in this file.'
   });
   entries.push({
     agent: "Codex",
-    path: path23.join(home, ".codex", "config.toml"),
+    path: path24.join(home, ".codex", "config.toml"),
     kind: "global",
     format: "toml",
-    detected: checkTOML(path23.join(home, ".codex", "config.toml")),
+    detected: checkTOML(path24.join(home, ".codex", "config.toml")),
     note: "Remove the [mcp_servers.memorix] section from this file."
   });
   entries.push({
     agent: "VS Code / Copilot",
-    path: path23.join(home, ".vscode", "mcp.json"),
+    path: path24.join(home, ".vscode", "mcp.json"),
     kind: "global",
     format: "json",
-    detected: checkJSON(path23.join(home, ".vscode", "mcp.json")),
+    detected: checkJSON(path24.join(home, ".vscode", "mcp.json")),
     note: 'Remove the "memorix" key from servers in this file.'
   });
   entries.push({
     agent: "VS Code / Copilot",
-    path: path23.join(cwd, ".vscode", "mcp.json"),
+    path: path24.join(cwd, ".vscode", "mcp.json"),
     kind: "project",
     format: "json",
-    detected: checkJSON(path23.join(cwd, ".vscode", "mcp.json")),
+    detected: checkJSON(path24.join(cwd, ".vscode", "mcp.json")),
     note: 'Remove the "memorix" key from servers in this file.'
   });
   entries.push({
     agent: "Kiro",
-    path: path23.join(home, ".kiro", "settings", "mcp.json"),
+    path: path24.join(home, ".kiro", "settings", "mcp.json"),
     kind: "global",
     format: "json",
-    detected: checkJSON(path23.join(home, ".kiro", "settings", "mcp.json")),
+    detected: checkJSON(path24.join(home, ".kiro", "settings", "mcp.json")),
     note: 'Remove the "memorix" key from mcpServers in this file.'
   });
   entries.push({
     agent: "Kiro",
-    path: path23.join(cwd, ".kiro", "settings", "mcp.json"),
+    path: path24.join(cwd, ".kiro", "settings", "mcp.json"),
     kind: "project",
     format: "json",
-    detected: checkJSON(path23.join(cwd, ".kiro", "settings", "mcp.json")),
+    detected: checkJSON(path24.join(cwd, ".kiro", "settings", "mcp.json")),
     note: 'Remove the "memorix" key from mcpServers in this file.'
   });
   entries.push({
     agent: "Gemini CLI / Antigravity",
-    path: path23.join(home, ".gemini", "settings.json"),
+    path: path24.join(home, ".gemini", "settings.json"),
     kind: "global",
     format: "json",
-    detected: checkJSON(path23.join(home, ".gemini", "settings.json")),
+    detected: checkJSON(path24.join(home, ".gemini", "settings.json")),
     note: 'Remove the "memorix" key from mcpServers in this file.'
   });
   const traeCfg = (() => {
     if (process.platform === "win32") {
-      return path23.join(process.env.APPDATA || path23.join(home, "AppData", "Roaming"), "Trae", "User", "mcp.json");
+      return path24.join(process.env.APPDATA || path24.join(home, "AppData", "Roaming"), "Trae", "User", "mcp.json");
     }
     if (process.platform === "darwin") {
-      return path23.join(home, "Library", "Application Support", "Trae", "User", "mcp.json");
+      return path24.join(home, "Library", "Application Support", "Trae", "User", "mcp.json");
     }
-    return path23.join(home, ".config", "Trae", "User", "mcp.json");
+    return path24.join(home, ".config", "Trae", "User", "mcp.json");
   })();
   entries.push({
     agent: "Trae",
@@ -66533,7 +66865,7 @@ function getMCPConfigEntries(home, cwd) {
   return entries;
 }
 function checkBackground(home) {
-  const statePath = path23.join(home, ".memorix", "background.json");
+  const statePath = path24.join(home, ".memorix", "background.json");
   try {
     const data = fs17.readFileSync(statePath, "utf-8");
     const state = JSON.parse(data);
@@ -66674,7 +67006,7 @@ var init_uninstall = __esm({
       },
       async run({ args }) {
         const home = os4.homedir();
-        const memorixDir = path23.join(home, ".memorix");
+        const memorixDir = path24.join(home, ".memorix");
         const dryRun = args["dry-run"];
         const yes = args.yes;
         const doHooks = args.hooks;
@@ -67173,14 +67505,14 @@ var init_claude_stream = __esm({
 
 // src/orchestrate/adapters/claude.ts
 import * as fs18 from "fs";
-import * as path24 from "path";
+import * as path25 from "path";
 function resolveMcpConfigPath(projectDir2) {
-  const localPath = path24.join(projectDir2, ".claude", "settings.local.json");
+  const localPath = path25.join(projectDir2, ".claude", "settings.local.json");
   try {
     if (fs18.existsSync(localPath)) return localPath;
   } catch {
   }
-  const settingsPath = path24.join(projectDir2, ".claude", "settings.json");
+  const settingsPath = path25.join(projectDir2, ".claude", "settings.json");
   try {
     if (fs18.existsSync(settingsPath)) return settingsPath;
   } catch {
@@ -67189,7 +67521,7 @@ function resolveMcpConfigPath(projectDir2) {
     mcpServers: {
       memorix: {
         command: process.execPath,
-        args: [path24.resolve(path24.dirname(process.execPath), "..", "lib", "node_modules", "memorix", "dist", "index.js"), "serve", "--transport", "stdio"]
+        args: [path25.resolve(path25.dirname(process.execPath), "..", "lib", "node_modules", "memorix", "dist", "index.js"), "serve", "--transport", "stdio"]
       }
     }
   };
@@ -67199,9 +67531,9 @@ function resolveMcpConfigPath(projectDir2) {
     args: ["serve", "--transport", "stdio"]
   };
   try {
-    const claudeDir = path24.join(projectDir2, ".claude");
+    const claudeDir = path25.join(projectDir2, ".claude");
     fs18.mkdirSync(claudeDir, { recursive: true });
-    const tempPath = path24.join(claudeDir, "settings.local.json");
+    const tempPath = path25.join(claudeDir, "settings.local.json");
     fs18.writeFileSync(tempPath, JSON.stringify(mcpConfig, null, 2), "utf-8");
     return tempPath;
   } catch {
@@ -68031,7 +68363,7 @@ var init_pipeline_trace = __esm({
 
 // src/orchestrate/worktree.ts
 import { execSync as execSync7 } from "child_process";
-import { existsSync as existsSync15, rmSync as rmSync2 } from "fs";
+import { existsSync as existsSync16, rmSync as rmSync2 } from "fs";
 import { join as join27, basename as basename3 } from "path";
 function createWorktree(projectDir2, taskId, pipelineId) {
   const shortId2 = taskId.slice(0, 8);
@@ -68092,7 +68424,7 @@ function removeWorktree(projectDir2, worktreePath, branch) {
       timeout: 1e4
     });
   } catch {
-    if (existsSync15(worktreePath)) {
+    if (existsSync16(worktreePath)) {
       try {
         rmSync2(worktreePath, { recursive: true, force: true });
       } catch {
@@ -68590,9 +68922,9 @@ function writePipelineSummary(projectDir2, summary) {
     return null;
   }
 }
-function safeWrite(path25, content) {
+function safeWrite(path26, content) {
   try {
-    writeFileSync8(path25, content, "utf-8");
+    writeFileSync8(path26, content, "utf-8");
   } catch {
   }
 }
@@ -68722,7 +69054,7 @@ var init_permission = __esm({
 });
 
 // src/orchestrate/memorix-bridge.ts
-import { createHash as createHash5 } from "crypto";
+import { createHash as createHash6 } from "crypto";
 async function getStoreObservation() {
   if (!_storeObservation) {
     const mod = await Promise.resolve().then(() => (init_observations(), observations_exports));
@@ -68860,7 +69192,7 @@ function sanitizeErrorPattern(text) {
 }
 function hashErrorPattern(errorOutput) {
   const sanitized = sanitizeErrorPattern(errorOutput).slice(0, 500);
-  return createHash5("sha256").update(sanitized).digest("hex").slice(0, 12);
+  return createHash6("sha256").update(sanitized).digest("hex").slice(0, 12);
 }
 function sleep2(ms) {
   return new Promise((resolve2) => setTimeout(() => resolve2([]), ms));
@@ -69965,8 +70297,8 @@ var init_orchestrate = __esm({
         const { getProjectDataDir: getProjectDataDir2 } = await Promise.resolve().then(() => (init_persistence(), persistence_exports));
         const { resolveAdapters: resolveAdapters2, parseAgentQuotas: parseAgentQuotas2, buildQuotaMap: buildQuotaMap2 } = await Promise.resolve().then(() => (init_adapters(), adapters_exports));
         const { runCoordinationLoop: runCoordinationLoop2 } = await Promise.resolve().then(() => (init_coordinator(), coordinator_exports));
-        const path25 = await import("path");
-        const projectDir2 = args.project ? path25.resolve(args.project) : process.cwd();
+        const path26 = await import("path");
+        const projectDir2 = args.project ? path26.resolve(args.project) : process.cwd();
         const proj = detectProject2(projectDir2);
         if (!proj) {
           console.error("[ERROR] Not a git repository. Run `git init` first.");
@@ -73901,14 +74233,14 @@ function WorkbenchApp({ version: version2, onExitForInteractive }) {
           }
           try {
             const { resolveHooksDir: resolveHooksDir2 } = await Promise.resolve().then(() => (init_hooks_path(), hooks_path_exports));
-            const { existsSync: existsSync18, readFileSync: readFileSync17, writeFileSync: writeFileSync10, unlinkSync: unlinkSync4 } = await import("fs");
+            const { existsSync: existsSync19, readFileSync: readFileSync18, writeFileSync: writeFileSync10, unlinkSync: unlinkSync4 } = await import("fs");
             const resolved = resolveHooksDir2(proj.rootPath);
             const hookMarker = "# [memorix-git-hook]";
-            if (!resolved || !existsSync18(resolved.hookPath)) {
+            if (!resolved || !existsSync19(resolved.hookPath)) {
               setActionStatus("No post-commit hook found.");
               return;
             }
-            const content = readFileSync17(resolved.hookPath, "utf-8");
+            const content = readFileSync18(resolved.hookPath, "utf-8");
             if (!content.includes(hookMarker)) {
               setActionStatus("No memorix hook installed.");
               return;
@@ -74059,7 +74391,7 @@ function WorkbenchApp({ version: version2, onExitForInteractive }) {
           break;
         }
         case "3": {
-          const { existsSync: existsSync18, readFileSync: readFileSync17, writeFileSync: writeFileSync10, chmodSync: chmodSync2 } = await import("fs");
+          const { existsSync: existsSync19, readFileSync: readFileSync18, writeFileSync: writeFileSync10, chmodSync: chmodSync2 } = await import("fs");
           const { ensureHooksDir: ensureHooksDir2 } = await Promise.resolve().then(() => (init_hooks_path(), hooks_path_exports));
           const hookMarker = "# [memorix-git-hook]";
           const resolved = ensureHooksDir2(cwd);
@@ -74073,12 +74405,12 @@ if command -v memorix >/dev/null 2>&1; then
   memorix ingest commit --auto >/dev/null 2>&1 &
 fi
 `;
-          if (existsSync18(resolved.hookPath)) {
-            if (readFileSync17(resolved.hookPath, "utf-8").includes(hookMarker)) {
+          if (existsSync19(resolved.hookPath)) {
+            if (readFileSync18(resolved.hookPath, "utf-8").includes(hookMarker)) {
               setActionStatus("Post-commit hook already installed.");
               break;
             }
-            writeFileSync10(resolved.hookPath, `${readFileSync17(resolved.hookPath, "utf-8").trimEnd()}
+            writeFileSync10(resolved.hookPath, `${readFileSync18(resolved.hookPath, "utf-8").trimEnd()}
 
 ${hookScript}`, "utf-8");
           } else {
@@ -74093,15 +74425,15 @@ ${hookScript}`, "utf-8");
           break;
         }
         case "4": {
-          const { existsSync: existsSync18, readFileSync: readFileSync17, writeFileSync: writeFileSync10, unlinkSync: unlinkSync4 } = await import("fs");
+          const { existsSync: existsSync19, readFileSync: readFileSync18, writeFileSync: writeFileSync10, unlinkSync: unlinkSync4 } = await import("fs");
           const { resolveHooksDir: resolveHooksDir2 } = await Promise.resolve().then(() => (init_hooks_path(), hooks_path_exports));
           const hookMarker = "# [memorix-git-hook]";
           const resolved = resolveHooksDir2(cwd);
-          if (!resolved || !existsSync18(resolved.hookPath)) {
+          if (!resolved || !existsSync19(resolved.hookPath)) {
             setActionStatus("No post-commit hook found.");
             break;
           }
-          const content = readFileSync17(resolved.hookPath, "utf-8");
+          const content = readFileSync18(resolved.hookPath, "utf-8");
           if (!content.includes(hookMarker)) {
             setActionStatus("No memorix hook installed.");
             break;
@@ -74833,6 +75165,7 @@ var main = defineCommand({
     lock: () => Promise.resolve().then(() => (init_lock(), lock_exports)).then((m4) => m4.default),
     handoff: () => Promise.resolve().then(() => (init_handoff2(), handoff_exports2)).then((m4) => m4.default),
     poll: () => Promise.resolve().then(() => (init_poll2(), poll_exports2)).then((m4) => m4.default),
+    receipt: () => Promise.resolve().then(() => (init_receipt(), receipt_exports)).then((m4) => m4.default),
     serve: () => Promise.resolve().then(() => (init_serve(), serve_exports)).then((m4) => m4.default),
     "serve-http": () => Promise.resolve().then(() => (init_serve_http(), serve_http_exports)).then((m4) => m4.default),
     status: () => Promise.resolve().then(() => (init_status(), status_exports)).then((m4) => m4.default),
@@ -74882,6 +75215,7 @@ var main = defineCommand({
       "lock",
       "handoff",
       "poll",
+      "receipt",
       "serve",
       "serve-http",
       "status",
@@ -74928,6 +75262,7 @@ var main = defineCommand({
       console.error("  lock       Manage advisory file locks");
       console.error("  handoff    Create durable handoff artifacts");
       console.error("  poll       Snapshot project coordination state");
+      console.error("  receipt    Privacy-safe memory handoff diagnostic");
       console.error("  serve-http Start HTTP MCP + dashboard control plane");
       console.error("  serve      Start MCP server on stdio");
       console.error("  init       Create global defaults or project config");