@memnexus-ai/cli 1.7.220 → 1.7.222

package/dist/commands/memories.d.ts

@@ -1,5 +1,5 @@
 import { Command } from 'commander';
-import { isRateLimitError, isServiceUnavailableError, isQuotaError, getRetryAfterMs, sleep } from '../lib/retry';
+import { isRateLimitError, isServiceUnavailableError, isQuotaError, isNameConflictError, getRetryAfterMs, sleep } from '../lib/retry';
 /** Number of deletions within the window that triggers the guard. */
 export declare const BULK_DELETE_GUARD_THRESHOLD = 5;
 /** Rolling window in milliseconds (60 seconds). */
@@ -67,7 +67,7 @@ export declare function parseBatchIds(values: string[] | undefined): string[];
 export declare function isValidIsoDate(value: string): boolean;
 /** Split ids into pages of at most `size` (default 100). */
 export declare function chunkIds(ids: string[], size?: number): string[][];
-export { isRateLimitError, isServiceUnavailableError, isQuotaError, getRetryAfterMs, sleep };
+export { isRateLimitError, isServiceUnavailableError, isQuotaError, isNameConflictError, getRetryAfterMs, sleep, };
 export interface BulkDeleteDeps {
     /** Deletes one page (≤100 ids) and returns the server's counts. */
     deleteFn: (ids: string[]) => Promise<BulkDeleteResult>;

package/dist/commands/memories.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"memories.d.ts","sourceRoot":"","sources":["../../src/commands/memories.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAMpC,OAAO,EACL,gBAAgB,EAChB,yBAAyB,EACzB,YAAY,EACZ,eAAe,EACf,KAAK,EAGN,MAAM,cAAc,CAAC;AAqBtB,qEAAqE;AACrE,eAAO,MAAM,2BAA2B,IAAI,CAAC;AAC7C,mDAAmD;AACnD,eAAO,MAAM,2BAA2B,QAAS,CAAC;AAElD,mDAAmD;AACnD,wBAAgB,sBAAsB,IAAI,MAAM,CAE/C;AAED;;;;;;GAMG;AACH,wBAAgB,yBAAyB,CAAC,SAAS,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,GAAG,MAAM,EAAE,CAYlF;AAED;;;GAGG;AACH,wBAAgB,cAAc,CAAC,SAAS,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,GAAG,IAAI,CASnE;AAED;;;;;;GAMG;AACH,wBAAgB,oBAAoB,CAAC,SAAS,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,GAAG,OAAO,CA0B5E;AA0CD;;;;;;GAMG;AACH,wBAAgB,oBAAoB,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CA0BzE;AA8RD,sFAAsF;AACtF,eAAO,MAAM,mBAAmB,MAAM,CAAC;AACvC,2EAA2E;AAC3E,eAAO,MAAM,yBAAyB,MAAM,CAAC;AAC7C,oDAAoD;AACpD,eAAO,MAAM,uBAAuB,IAAI,CAAC;AACzC,iDAAiD;AACjD,eAAO,MAAM,0BAA0B,MAAM,CAAC;AAE9C,MAAM,WAAW,gBAAgB;IAC/B,OAAO,EAAE,MAAM,CAAC;IAChB,MAAM,EAAE,MAAM,CAAC;IACf,MAAM,EAAE;QAAE,EAAE,EAAE,MAAM,CAAC;QAAC,KAAK,EAAE,MAAM,CAAA;KAAE,EAAE,CAAC;CACzC;AAED;;;;GAIG;AACH,wBAAgB,aAAa,CAAC,MAAM,EAAE,MAAM,EAAE,GAAG,SAAS,GAAG,MAAM,EAAE,CAUpE;AAED;;;;;;GAMG;AACH,wBAAgB,cAAc,CAAC,KAAK,EAAE,MAAM,GAAG,OAAO,CAIrD;AAED,4DAA4D;AAC5D,wBAAgB,QAAQ,CAAC,GAAG,EAAE,MAAM,EAAE,EAAE,IAAI,GAAE,MAA4B,GAAG,MAAM,EAAE,EAAE,CAMtF;AAMD,OAAO,EAAE,gBAAgB,EAAE,yBAAyB,EAAE,YAAY,EAAE,eAAe,EAAE,KAAK,EAAE,CAAC;AAyD7F,MAAM,WAAW,cAAc;IAC7B,mEAAmE;IACnE,QAAQ,EAAE,CAAC,GAAG,EAAE,MAAM,EAAE,KAAK,OAAO,CAAC,gBAAgB,CAAC,CAAC;IACvD,6CAA6C;IAC7C,KAAK,EAAE,CAAC,EAAE,EAAE,MAAM,KAAK,OAAO,CAAC,IAAI,CAAC,CAAC;IACrC,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,uEAAuE;IACvE,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,+DAA+D;IAC/D,aAAa,CAAC,EAAE,CAAC,MAAM,EAAE,MAAM,KAAK,IAAI,CAAC;CAC1C;AAED;;;GAGG;AACH,wBAAsB,mBAAmB,CACvC,GAAG,EAAE,MAAM,EAAE,EACb,IAAI,EAAE,cAAc,GACnB,OAAO,CAAC,gBAAgB,CAAC,CAkB3B;AAED,MAAM,WAAW,qBAAsB,SAAQ,gBAAgB;IAC7D,wEAAwE;IACxE,YAAY,EAAE,MAAM,CAAC;IACrB,yDAAyD;IACzD,gBAAgB,EAAE,MAAM,CAAC;IACzB,6EAA6E;IAC7E,OAAO,EAAE,OAAO,CAAC;IACjB,2EAA2E;IAC3E,YAAY,EAAE,MAAM,CAAC;CACtB;AAaD;;;;;;;;;;GAUG;AACH,wBAAsB,kBAAkB,CACtC,GAAG,EAAE,MAAM,EAAE,EACb,IAAI,EAAE,IAAI,CAAC,cAAc,EAAE,eAAe,CAAC,GAAG;IAC5C,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,MAAM,CAAC,EAAE,CAAC,SAAS,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM,EAAE,MAAM,EAAE,gBAAgB,KAAK,IAAI,CAAC;CACpF,GACA,OAAO,CAAC,qBAAqB,CAAC,CA8ChC;AAED;;;GAGG;AACH,wBAAsB,mBAAmB,CACvC,MAAM,EAAE,CAAC,MAAM,EAAE,GAAG,KAAK,OAAO,CAAC,GAAG,CAAC,EACrC,YAAY,GAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAM,EAC1C,QAAQ,GAAE,MAAmC,GAC5C,OAAO,CAAC,MAAM,EAAE,CAAC,CAcnB;AAwKD,oEAAoE;AACpE,eAAO,MAAM,gCAAgC,IAAI,CAAC;AAClD,yFAAyF;AACzF,eAAO,MAAM,4BAA4B,IAAI,CAAC;AAC9C,eAAO,MAAM,4BAA4B,IAAI,CAAC;AAC9C,+EAA+E;AAC/E,eAAO,MAAM,wBAAwB,IAAI,CAAC;AAC1C;;;;;;GAMG;AACH,eAAO,MAAM,4BAA4B,QAAoB,CAAC;AAC9D;;;;;GAKG;AACH,eAAO,MAAM,2BAA2B,QAAc,CAAC;AAEvD;;;;;;GAMG;AACH,eAAO,MAAM,yBAAyB,aAapC,CAAC;AAEH,mFAAmF;AACnF,wBAAgB,sBAAsB,CAAC,KAAK,EAAE,GAAG,GAAG,OAAO,CAE1D;AAED,MAAM,WAAW,eAAe;IAC9B,iFAAiF;IACjF,IAAI,EAAE,MAAM,CAAC;IACb,+EAA+E;IAC/E,IAAI,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAC/B,0DAA0D;IAC1D,UAAU,CAAC,EAAE,MAAM,CAAC;CACrB;AAED;;;;;;;;GAQG;AACH,MAAM,MAAM,qBAAqB,GAC7B,aAAa,GACb,eAAe,GACf,eAAe,GACf,eAAe,GACf,eAAe,CAAC;AAEpB,MAAM,WAAW,iBAAiB;IAChC,IAAI,EAAE,MAAM,CAAC;IACb,EAAE,EAAE,OAAO,CAAC;IACZ,EAAE,CAAC,EAAE,MAAM,CAAC;IACZ,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,yCAAyC;IACzC,IAAI,CAAC,EAAE,qBAAqB,CAAC;CAC9B;AAED,MAAM,WAAW,kBAAkB;IACjC,KAAK,EAAE,MAAM,CAAC;IACd,EAAE,EAAE,MAAM,CAAC;IACX,MAAM,EAAE,MAAM,CAAC;IACf,oFAAoF;IACpF,YAAY,EAAE,MAAM,CAAC;IACrB,gDAAgD;IAChD,YAAY,EAAE,OAAO,CAAC;IACtB,+DAA+D;IAC/D,gBAAgB,EAAE,MAAM,CAAC;IACzB,oFAAoF;IACpF,SAAS,EAAE,MAAM,CAAC;IAClB,qEAAqE;IACrE,YAAY,EAAE,OAAO,CAAC;CACvB;AAED;;;;;;;GAOG;AACH,wBAAgB,oBAAoB,CAAC,GAAG,EAAE,MAAM,GAAG;IACjD,IAAI,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAC/B,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB,CAuFA;AAED;;;;;GAKG;AACH,wBAAgB,wBAAwB,CACtC,GAAG,EAAE,MAAM,GAAG,SAAS,EACvB,IAAI,GAAE,CAAC,GAAG,EAAE,MAAM,KAAK,IAA2C,GACjE,MAAM,CAoBR;AAED,MAAM,WAAW,mBAAmB;IAClC,QAAQ,EAAE,CAAC,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,KAAK,OAAO,CAAC;QAAE,EAAE,CAAC,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;IACtE,KAAK,EAAE,CAAC,EAAE,EAAE,MAAM,KAAK,OAAO,CAAC,IAAI,CAAC,CAAC;IACrC,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,aAAa,CAAC,EAAE,CAAC,MAAM,EAAE,MAAM,KAAK,IAAI,CAAC;CAC1C;AAED;;;;GAIG;AACH,wBAAsB,oBAAoB,CACxC,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAC7B,IAAI,EAAE,mBAAmB,GACxB,OAAO,CAAC;IAAE,EAAE,CAAC,EAAE,MAAM,CAAA;CAAE,CAAC,CAmB1B;AAED,MAAM,WAAW,kBAAmB,SAAQ,mBAAmB;IAC7D,4EAA4E;IAC5E,WAAW,EAAE,MAAM,CAAC;IACpB,iFAAiF;IACjF,QAAQ,CAAC,EAAE,CAAC,MAAM,EAAE,iBAAiB,KAAK,IAAI,CAAC;CAChD;AAED;;;;;;;;;;;;;;;;;;;GAmBG;AACH,wBAAsB,cAAc,CAClC,KAAK,EAAE,eAAe,EAAE,EACxB,IAAI,EAAE,kBAAkB,GACvB,OAAO,CAAC,kBAAkB,CAAC,CA0G7B;AAED;;;;GAIG;AACH,wBAAgB,qBAAqB,CAAC,GAAG,EAAE,MAAM,GAAG,eAAe,EAAE,CAUpE;AAED,0EAA0E;AAC1E,qBAAa,kBAAmB,SAAQ,KAAK;aAGzB,KAAK,EAAE,MAAM;aACb,KAAK,EAAE,MAAM;IAH/B,QAAQ,CAAC,IAAI,qBAAqB;gBAEhB,KAAK,EAAE,MAAM,EACb,KAAK,EAAE,MAAM;CAKhC;AAED;;;;;;GAMG;AACH,wBAAsB,YAAY,CAChC,QAAQ,GAAE,MAAqC,GAC9C,OAAO,CAAC,MAAM,CAAC,CA+BjB;AAaD;;;;;;;;;;GAUG;AACH,wBAAsB,qBAAqB,CACzC,aAAa,GAAE,MAAqC,GACnD,OAAO,CAAC,IAAI,CAAC,CAqFf;AAED;;;GAGG;AACH,wBAAgB,wBAAwB,CAAC,OAAO,EAAE,OAAO,GAAG,IAAI,CAknD/D;AA0YD;;;GAGG;AACH,wBAAgB,kCAAkC,CAAC,QAAQ,EAAE,OAAO,GAAG,IAAI,CAsN1E;AAED;;;GAGG;AACH,wBAAgB,6BAA6B,CAAC,QAAQ,EAAE,OAAO,GAAG,IAAI,CA0ErE;AAED;;;GAGG;AACH,wBAAgB,kCAAkC,CAAC,QAAQ,EAAE,OAAO,GAAG,IAAI,CAsE1E;AA0DD;;;GAGG;AACH,wBAAgB,qBAAqB,CAAC,QAAQ,EAAE,OAAO,GAAG,IAAI,CA2H7D;AAED;;;GAGG;AACH,wBAAgB,qBAAqB,CAAC,QAAQ,EAAE,OAAO,GAAG,IAAI,CAwF7D;AAoGD;;;GAGG;AACH,wBAAgB,oBAAoB,CAAC,QAAQ,EAAE,OAAO,GAAG,IAAI,CAyH5D;AAkOD;;;GAGG;AACH,wBAAgB,2BAA2B,CAAC,QAAQ,EAAE,OAAO,GAAG,IAAI,CAyNnE"}
+{"version":3,"file":"memories.d.ts","sourceRoot":"","sources":["../../src/commands/memories.ts"],"names":[],"mappings":"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"}

package/dist/commands/memories.js

@@ -36,7 +36,7 @@ var __importDefault = (this && this.__importDefault) || function (mod) {
     return (mod && mod.__esModule) ? mod : { "default": mod };
 };
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.StdinTooLargeError = exports.BATCH_CREATE_ALLOWED_KEYS = exports.BATCH_CREATE_MAX_LINE_BYTES = exports.BATCH_CREATE_MAX_STDIN_BYTES = exports.BATCH_CREATE_MAX_RETRIES = exports.BATCH_CREATE_CONCURRENCY_MAX = exports.BATCH_CREATE_CONCURRENCY_MIN = exports.BATCH_CREATE_DEFAULT_CONCURRENCY = exports.sleep = exports.getRetryAfterMs = exports.isQuotaError = exports.isServiceUnavailableError = exports.isRateLimitError = exports.BULK_DELETE_LIST_PAGE_SIZE = exports.BULK_DELETE_MAX_RETRIES = exports.BULK_DELETE_PAGE_PAUSE_MS = exports.BULK_DELETE_MAX_IDS = exports.BULK_DELETE_GUARD_WINDOW_MS = exports.BULK_DELETE_GUARD_THRESHOLD = void 0;
+exports.StdinTooLargeError = exports.BATCH_CREATE_ALLOWED_KEYS = exports.BATCH_CREATE_MAX_LINE_BYTES = exports.BATCH_CREATE_MAX_STDIN_BYTES = exports.BATCH_CREATE_MAX_RETRIES = exports.BATCH_CREATE_CONCURRENCY_MAX = exports.BATCH_CREATE_CONCURRENCY_MIN = exports.BATCH_CREATE_DEFAULT_CONCURRENCY = exports.sleep = exports.getRetryAfterMs = exports.isNameConflictError = exports.isQuotaError = exports.isServiceUnavailableError = exports.isRateLimitError = exports.BULK_DELETE_LIST_PAGE_SIZE = exports.BULK_DELETE_MAX_RETRIES = exports.BULK_DELETE_PAGE_PAUSE_MS = exports.BULK_DELETE_MAX_IDS = exports.BULK_DELETE_GUARD_WINDOW_MS = exports.BULK_DELETE_GUARD_THRESHOLD = void 0;
 exports.getBulkDeleteGuardPath = getBulkDeleteGuardPath;
 exports.readDeleteGuardTimestamps = readDeleteGuardTimestamps;
 exports.recordDeletion = recordDeletion;
@@ -73,6 +73,7 @@ const retry_1 = require("../lib/retry");
 Object.defineProperty(exports, "isRateLimitError", { enumerable: true, get: function () { return retry_1.isRateLimitError; } });
 Object.defineProperty(exports, "isServiceUnavailableError", { enumerable: true, get: function () { return retry_1.isServiceUnavailableError; } });
 Object.defineProperty(exports, "isQuotaError", { enumerable: true, get: function () { return retry_1.isQuotaError; } });
+Object.defineProperty(exports, "isNameConflictError", { enumerable: true, get: function () { return retry_1.isNameConflictError; } });
 Object.defineProperty(exports, "getRetryAfterMs", { enumerable: true, get: function () { return retry_1.getRetryAfterMs; } });
 Object.defineProperty(exports, "sleep", { enumerable: true, get: function () { return retry_1.sleep; } });
 const formatters_1 = require("../lib/formatters");
@@ -1342,8 +1343,7 @@ function registerMemoriesCommands(program) {
             if (options.last) {
                 limit = parseInt(options.last, 10);
                 if (isNaN(limit) || limit < 1) {
-                    console.log(chalk_1.default.red('Error: --last must be a positive number'));
-                    return;
+                    throw (0, errors_1.validationError)('--last must be a positive number');
                 }
                 sortField = 'createdAt';
                 sortOrder = 'desc';
@@ -1354,17 +1354,14 @@ function registerMemoriesCommands(program) {
                 const validFields = ['createdAt', 'eventTime'];
                 const validOrders = ['asc', 'desc'];
                 if (sortParts.length !== 2) {
-                    console.log(chalk_1.default.red('Error: --sort must be in format field:order (e.g., createdAt:desc)'));
-                    return;
+                    throw (0, errors_1.validationError)('--sort must be in format field:order (e.g., createdAt:desc)');
                 }
                 const [field, order] = sortParts;
                 if (!validFields.includes(field)) {
-                    console.log(chalk_1.default.red(`Error: Sort field must be one of: ${validFields.join(', ')}`));
-                    return;
+                    throw (0, errors_1.validationError)(`Sort field must be one of: ${validFields.join(', ')}`);
                 }
                 if (!validOrders.includes(order)) {
-                    console.log(chalk_1.default.red(`Error: Sort order must be one of: ${validOrders.join(', ')}`));
-                    return;
+                    throw (0, errors_1.validationError)(`Sort order must be one of: ${validOrders.join(', ')}`);
                 }
                 sortField = field;
                 sortOrder = order;
@@ -1387,9 +1384,7 @@ function registerMemoriesCommands(program) {
             if (recentDuration) {
                 const recentTs = (0, date_utils_1.getRecentTimestamp)(recentDuration);
                 if (!recentTs) {
-                    console.log(chalk_1.default.red(`Error: Invalid duration format: ${recentDuration}`));
-                    console.log(chalk_1.default.yellow('Supported formats: 30m, 1h, 7d, 2w'));
-                    return;
+                    throw (0, errors_1.validationError)(`Invalid duration format: ${recentDuration}. Supported formats: 30m, 1h, 7d, 2w`);
                 }
                 listParams.from = recentTs;
             }
@@ -1479,7 +1474,7 @@ function registerMemoriesCommands(program) {
                 }));
                 const memory = response.data?.data;
                 if (!memory) {
-                    spinner.fail(`No memory found with name '${options.name}'`);
+                    spinner.softFail(`No memory found with name '${options.name}'`);
                     return;
                 }
                 spinner.succeed(`Found named memory '${options.name}' (v${memory.version || 1})`);
@@ -1498,14 +1493,12 @@ function registerMemoriesCommands(program) {
             // Remove duplicates while preserving order
             allIds = [...new Set(allIds)].filter((id) => id.trim().length > 0);
             if (allIds.length === 0) {
-                console.log(chalk_1.default.red('Error: No memory IDs provided'));
-                return;
+                throw (0, errors_1.validationError)('No memory IDs provided');
             }
             // Discovery options only work with single ID
             const hasDiscoveryOptions = options.similar || options.conversation || options.related;
             if (hasDiscoveryOptions && allIds.length > 1) {
-                console.log(chalk_1.default.red('Error: --similar, --conversation, and --related options only work with a single memory ID'));
-                return;
+                throw (0, errors_1.validationError)('--similar, --conversation, and --related options only work with a single memory ID');
             }
             // Single ID mode - use existing logic with short ID support
             if (allIds.length === 1) {
@@ -1521,7 +1514,7 @@ function registerMemoriesCommands(program) {
                         }));
                         const memory = response.data?.data;
                         if (!memory) {
-                            spinner.fail(`No memory found with name '${singleId}'`);
+                            spinner.softFail(`No memory found with name '${singleId}'`);
                             return;
                         }
                         spinner.succeed(`Found named memory '${singleId}' (v${memory.version || 1})`);
@@ -1531,7 +1524,16 @@ function registerMemoriesCommands(program) {
                         return;
                     }
                     catch (e) {
-                        spinner.fail(`No memory found with name '${singleId}'`);
+                        // Only a genuine 404 is "no such name" (exit 0 + banner — a fleet
+                        // hook substring-matches this line). Every other failure (5xx,
+                        // network, auth) previously rendered as the same banner and exited
+                        // 0, which reported an outage as an empty store. Rethrow those to
+                        // handleError. Mirrors the explicit --name path above, which has
+                        // no catch and always propagates.
+                        if (!(0, errors_1.isNotFoundError)(e)) {
+                            throw e;
+                        }
+                        spinner.softFail(`No memory found with name '${singleId}'`);
                         console.log(chalk_1.default.gray(`  Tip: use --name explicitly or pass a UUID/prefix`));
                         return;
                     }
@@ -1539,9 +1541,8 @@ function registerMemoriesCommands(program) {
                 const isShortId = singleId.length < 36;
                 const MIN_PREFIX_LENGTH = 6;
                 if (isShortId && singleId.length < MIN_PREFIX_LENGTH) {
-                    console.log(chalk_1.default.red(`Error: ID prefix must be at least ${MIN_PREFIX_LENGTH} characters`));
-                    console.log(chalk_1.default.yellow('Example: mx memories get 2d09116a'));
-                    return;
+                    throw (0, errors_1.validationError)(`ID prefix must be at least ${MIN_PREFIX_LENGTH} characters. ` +
+                        'Example: mx memories get 2d09116a');
                 }
                 let memoryId = singleId;
                 let resolvedMemory = null;
@@ -1554,7 +1555,7 @@ function registerMemoriesCommands(program) {
                     }));
                     const matches = listResponse.data?.data || [];
                     if (matches.length === 0) {
-                        spinner.fail(`No memory found with ID prefix: ${singleId}`);
+                        spinner.softFail(`No memory found with ID prefix: ${singleId}`);
                         return;
                     }
                     if (matches.length > 1) {
@@ -1750,14 +1751,13 @@ function registerMemoriesCommands(program) {
             else {
                 // Direct mode - validate conversationId is provided
                 if (!options.conversationId) {
-                    console.log(chalk_1.default.red('Error: --conversation-id is required'));
-                    console.log(chalk_1.default.yellow('\nTo create a new conversation, use:'));
-                    console.log(chalk_1.default.cyan('  mx memories create --conversation-id NEW --content "Your message"'));
-                    console.log(chalk_1.default.yellow('\nTo add to an existing conversation, use:'));
-                    console.log(chalk_1.default.cyan('  mx memories create --conversation-id conv_abc123 --content "Your message"'));
-                    console.log(chalk_1.default.yellow('\nOr use interactive mode:'));
-                    console.log(chalk_1.default.cyan('  mx memories create --interactive'));
-                    return;
+                    throw (0, errors_1.validationError)('--conversation-id is required.\n' +
+                        '\nTo create a new conversation, use:\n' +
+                        '  mx memories create --conversation-id NEW --content "Your message"\n' +
+                        '\nTo add to an existing conversation, use:\n' +
+                        '  mx memories create --conversation-id conv_abc123 --content "Your message"\n' +
+                        '\nOr use interactive mode:\n' +
+                        '  mx memories create --interactive');
                 }
                 // Auto-detect Claude Code session ID for conversation grouping
                 const claudeSession = config_1.config.isAIAgentContext() ? (0, session_reader_1.readSessionContext)() : undefined;
@@ -1792,9 +1792,20 @@ function registerMemoriesCommands(program) {
                 response = await retryWrite(() => (0, api_client_1.getSdk)().memories.createMemory(memoryData));
             }
             catch (createError) {
-                // 409 = named memory already exists → auto-upsert via updateNamedMemory
-                const status = createError.status ?? createError.statusCode ?? createError.response?.status;
-                if (status === 409 && memoryData.name) {
+                // 409 is OVERLOADED: it is returned both for "named memory already
+                // exists" (retry as an upsert) and for QUOTA_EXCEEDED (do not retry).
+                // This branch used to test the bare status, so a free-tier user at
+                // their cap creating a NAMED memory had the quota rejection retried
+                // against PUT /named/:name — which applies the same quota gate and
+                // rejects again. Two rejections burned, and the failure was reported as
+                // a name collision when the actual cause was capacity. Branch on the
+                // code (see isQuotaError / isNameConflictError in lib/retry.ts), the
+                // same way mcp-server's create_memory does (#2925).
+                if ((0, retry_1.isQuotaError)(createError)) {
+                    spinner.fail('Memory limit reached');
+                    throw createError;
+                }
+                if ((0, retry_1.isNameConflictError)(createError) && memoryData.name) {
                     // v3.85 (named-memory operation integrity): the auto-upsert retry must
                     // PRESERVE every field the user did not explicitly provide and FORWARD
                     // every field they did. The previous body (a) re-sent the truthy-
@@ -1843,6 +1854,15 @@ function registerMemoriesCommands(program) {
             // Response is properly typed as CreateMemoryResponse with data and meta fields
             const memory = response.data?.data;
             const meta = response.data?.meta;
+            // A 2xx without an id means nothing was persisted that we can address.
+            // The success lines below used to render "ID: undefined", and the
+            // --supersedes step below is gated on `memory?.id` so it silently did
+            // nothing — the caller saw a success glyph for a write that produced no
+            // usable memory (v4.04).
+            if (!memory?.id) {
+                spinner.stop();
+                throw (0, errors_1.unusableResponseError)(upserted ? 'Named memory update' : 'Memory creation', responseShape(response.data));
+            }
             if (upserted) {
                 const version = meta?.version || 'new';
                 spinner.succeed(`Named memory '${memoryData.name}' updated (v${version}) via auto-upsert. ID: ${memory?.id}`);
@@ -1880,9 +1900,13 @@ function registerMemoriesCommands(program) {
                 }
                 catch (relError) {
                     relSpinner.fail(`Failed to create relationship: ${relError.message || 'Unknown error'}`);
+                    // Partial failure: the memory exists but the SUPERSEDES edge does
+                    // not. relSpinner.fail() has already set a non-zero exit code so the
+                    // caller cannot mistake this for a clean create. Recovery guidance
+                    // goes to stderr — stdout still carries the created-memory body.
                     if (options.format !== 'json' && options.format !== 'yaml') {
-                        console.log(chalk_1.default.yellow('Memory was created successfully. You can manually create the relationship with:'));
-                        console.log(chalk_1.default.cyan(`  mx memories relationships create ${memory.id} --target ${options.supersedes} --type SUPERSEDES`));
+                        console.error(chalk_1.default.yellow('Memory was created successfully. You can manually create the relationship with:'));
+                        console.error(chalk_1.default.cyan(`  mx memories relationships create ${memory.id} --target ${options.supersedes} --type SUPERSEDES`));
                     }
                 }
             }
@@ -1912,13 +1936,11 @@ function registerMemoriesCommands(program) {
         .action(async (id, options) => {
         try {
             if (!id && !options.name) {
-                console.log(chalk_1.default.red('Error: Provide a memory ID or use --name <name>'));
-                return;
+                throw (0, errors_1.validationError)('Provide a memory ID or use --name <name>');
             }
             // --assign-name and --rename are mutually exclusive
             if (options.assignName && options.rename) {
-                console.log(chalk_1.default.red('Error: Cannot use --assign-name and --rename together'));
-                return;
+                throw (0, errors_1.validationError)('Cannot use --assign-name and --rename together');
             }
             const updates = {};
             if (options.content)
@@ -1937,8 +1959,7 @@ function registerMemoriesCommands(program) {
             // --assign-name: assign a name to an existing memory by ID
             if (options.assignName) {
                 if (!id) {
-                    console.log(chalk_1.default.red('Error: --assign-name requires a memory ID'));
-                    return;
+                    throw (0, errors_1.validationError)('--assign-name requires a memory ID');
                 }
                 updates.name = options.assignName;
                 const spinner = (0, spinner_1.createSpinner)('Assigning name...', options.format).start();
@@ -1976,8 +1997,7 @@ function registerMemoriesCommands(program) {
                     (0, formatters_1.printOutput)(memory, options.format);
                     return;
                 }
-                console.log(chalk_1.default.red('Error: --rename requires a memory ID or --name <current-name>'));
-                return;
+                throw (0, errors_1.validationError)('--rename requires a memory ID or --name <current-name>');
             }
             if (Object.keys(updates).length === 0) {
                 console.log(chalk_1.default.yellow('No updates provided. Use --help to see available options.'));
@@ -2029,7 +2049,7 @@ function registerMemoriesCommands(program) {
             const response = await retryRead(() => (0, api_client_1.getSdk)().memories.getNamedMemoryHistory(name));
             const data = response.data;
             if (!data?.versions?.length) {
-                spinner.fail(`No memory found with name '${name}'`);
+                spinner.softFail(`No memory found with name '${name}'`);
                 return;
             }
             const limit = parseInt(options.limit, 10) || 20;
@@ -2288,41 +2308,34 @@ function registerMemoriesCommands(program) {
         .action(async (options, command) => {
         try {
             if (!options.query) {
-                console.log(chalk_1.default.red('Error: --query is required'));
-                return;
+                throw (0, errors_1.validationError)('--query is required');
             }
             // Validate search method
             const validMethods = ['keyword', 'semantic', 'hybrid'];
             if (options.method && !validMethods.includes(options.method)) {
-                console.log(chalk_1.default.red(`Error: --method must be one of: ${validMethods.join(', ')}`));
-                return;
+                throw (0, errors_1.validationError)(`--method must be one of: ${validMethods.join(', ')}`);
             }
             // Validate search mode
             const validModes = ['unified', 'content', 'facts'];
             if (options.mode && !validModes.includes(options.mode)) {
-                console.log(chalk_1.default.red(`Error: --mode must be one of: ${validModes.join(', ')}`));
-                return;
+                throw (0, errors_1.validationError)(`--mode must be one of: ${validModes.join(', ')}`);
             }
             // Validate memory type (before spinner starts)
             const validTypes = ['episodic', 'semantic', 'procedural'];
             if (options.type && !validTypes.includes(options.type)) {
-                console.log(chalk_1.default.red(`Error: --type must be one of: ${validTypes.join(', ')}`));
-                return;
+                throw (0, errors_1.validationError)(`--type must be one of: ${validTypes.join(', ')}`);
             }
             // Validate --group-by field
             const validGroupByFields = ['conversation'];
             if (options.groupBy && !validGroupByFields.includes(options.groupBy)) {
-                console.log(chalk_1.default.red(`Error: --group-by must be one of: ${validGroupByFields.join(', ')}`));
-                return;
+                throw (0, errors_1.validationError)(`--group-by must be one of: ${validGroupByFields.join(', ')}`);
             }
             // Handle --recent duration shortcut
             let recentTimestamp = null;
             if (options.recent) {
                 recentTimestamp = (0, date_utils_1.getRecentTimestamp)(options.recent);
                 if (!recentTimestamp) {
-                    console.log(chalk_1.default.red(`Error: Invalid duration format: ${options.recent}`));
-                    console.log(chalk_1.default.yellow('Supported formats: 30m, 1h, 7d, 2w'));
-                    return;
+                    throw (0, errors_1.validationError)(`Invalid duration format: ${options.recent}. Supported formats: 30m, 1h, 7d, 2w`);
                 }
             }
             // Handle --brief preset: apply quick lookup defaults
@@ -2434,8 +2447,7 @@ function registerMemoriesCommands(program) {
             if (options.sort) {
                 const validSortFields = ['score', 'createdAt', 'updatedAt', 'eventTime'];
                 if (!validSortFields.includes(options.sort)) {
-                    console.log(chalk_1.default.red(`Error: --sort must be one of: ${validSortFields.join(', ')}`));
-                    return;
+                    throw (0, errors_1.validationError)(`--sort must be one of: ${validSortFields.join(', ')}`);
                 }
                 if (options.sort !== 'score') {
                     searchRequest.sortBy = options.sort;
@@ -2444,14 +2456,21 @@ function registerMemoriesCommands(program) {
             if (options.order) {
                 const validOrders = ['asc', 'desc'];
                 if (!validOrders.includes(options.order)) {
-                    console.log(chalk_1.default.red(`Error: --order must be one of: ${validOrders.join(', ')}`));
-                    return;
+                    throw (0, errors_1.validationError)(`--order must be one of: ${validOrders.join(', ')}`);
                 }
                 searchRequest.order = options.order;
             }
             // Use GET endpoint for better performance (Issue #79)
             const response = await retryRead(() => (0, api_client_1.getSdk)().memories.searchMemoriesGet(searchRequest));
             const searchData = response.data;
+            // A 2xx with no results array is NOT an empty result set: the search did
+            // not return data. Rendering it as "Found 0 results" (exit 0) made a
+            // backend outage look like an empty store (v4.04). A genuine zero-hit
+            // search returns `data: []` and still reports "Found 0 results".
+            if (!searchData || !Array.isArray(searchData.data)) {
+                spinner?.stop();
+                throw (0, errors_1.unusableResponseError)('Memory search', responseShape(searchData));
+            }
             // Normalize: API may return flat objects or {memory, score} wrappers.
             // Ensure consistent {memory, score, matchedVia} shape for display code.
             if (searchData?.data) {
@@ -2977,8 +2996,7 @@ function registerMemoryRelationshipCommands(memories) {
         try {
             const validDirections = ['outgoing', 'incoming', 'both'];
             if (!validDirections.includes(options.direction)) {
-                console.log(chalk_1.default.red(`Error: --direction must be one of: ${validDirections.join(', ')}`));
-                return;
+                throw (0, errors_1.validationError)(`--direction must be one of: ${validDirections.join(', ')}`);
             }
             const spinner = (0, spinner_1.createSpinner)('Fetching relationships...', options.format).start();
             const response = await retryRead(() => (0, api_client_1.getSdk)().memories.getMemoryRelationships(id, {
@@ -3078,8 +3096,7 @@ function registerMemoryRelationshipCommands(memories) {
             }
             else {
                 if (!validTypes.includes(options.type.toUpperCase())) {
-                    console.log(chalk_1.default.red(`Error: --type must be one of: ${validTypes.join(', ')}`));
-                    return;
+                    throw (0, errors_1.validationError)(`--type must be one of: ${validTypes.join(', ')}`);
                 }
                 relationshipData = {
                     targetMemoryId: options.target,
@@ -3337,12 +3354,10 @@ function registerDigestCommand(memories) {
         .action(async (options) => {
         try {
             if (!options.query) {
-                console.log(chalk_1.default.red('Error: --query is required'));
-                return;
+                throw (0, errors_1.validationError)('--query is required');
             }
             if (!validDigestFormats.includes(options.digestFormat)) {
-                console.log(chalk_1.default.red(`Error: --digest-format must be one of: ${validDigestFormats.join(', ')}`));
-                return;
+                throw (0, errors_1.validationError)(`--digest-format must be one of: ${validDigestFormats.join(', ')}`);
             }
             const spinner = (0, spinner_1.createSpinner)('Generating digest...', options.format).start();
             const body = {
@@ -3377,12 +3392,24 @@ function registerDigestCommand(memories) {
                     sdk.config.timeoutMs = prevTimeout;
             }
             const data = response.data;
-            if (!data) {
-                spinner.fail('No response data received');
-                return;
+            // A 2xx with no body means the digest was never produced. Reporting it
+            // as a soft failure and exiting 0 made an outage look like "nothing to
+            // say" (v4.04).
+            if (!data || !data.metadata) {
+                spinner.stop();
+                throw (0, errors_1.unusableResponseError)('Digest generation', responseShape(data));
             }
             const { digest, metadata, sources, keyFacts, entities, effectiveStateBreakdown } = data;
-            spinner.succeed(`Digest generated from ${metadata.sourcesUsed} memories across ${metadata.conversationsSpanned} conversations`);
+            if (metadata.sourcesUsed === 0) {
+                // Zero sources is a genuine empty result (exit 0), but it is not a
+                // success: the old "Digest generated from 0 memories" success glyph
+                // read as "here is your answer" when nothing was retrieved.
+                spinner.info('No sources met the relevance threshold for this query');
+            }
+            else {
+                spinner.succeed(`Digest generated from ${metadata.sourcesUsed} memories across ${metadata.conversationsSpanned} conversations`);
+            }
+            printRetrievalCaveats(metadata, data.meta);
             // JSON/YAML output
             if (options.format === 'json' || options.format === 'yaml') {
                 (0, formatters_1.printOutput)(data, options.format);
@@ -3429,13 +3456,11 @@ function registerStatusCommand(memories) {
         .action(async (options) => {
         try {
             if (!options.query) {
-                console.log(chalk_1.default.red('Error: --query is required'));
-                return;
+                throw (0, errors_1.validationError)('--query is required');
             }
             const maxSources = parseInt(options.maxSources, 10);
             if (isNaN(maxSources) || maxSources < 1) {
-                console.log(chalk_1.default.red('Error: --max-sources must be a positive integer'));
-                return;
+                throw (0, errors_1.validationError)('--max-sources must be a positive integer');
             }
             const spinner = (0, spinner_1.createSpinner)('Generating status report...', options.format).start();
             const body = {
@@ -3466,12 +3491,21 @@ function registerStatusCommand(memories) {
                     sdk.config.timeoutMs = prevTimeout;
             }
             const data = response.data;
-            if (!data) {
-                spinner.fail('No response data received');
-                return;
+            // A 2xx with no body means the digest was never produced. Reporting it
+            // as a soft failure and exiting 0 made an outage look like "nothing to
+            // say" (v4.04).
+            if (!data || !data.metadata) {
+                spinner.stop();
+                throw (0, errors_1.unusableResponseError)('Status report generation', responseShape(data));
             }
             const { digest, metadata, sources, keyFacts, entities, effectiveStateBreakdown } = data;
-            spinner.succeed(`Status report from ${metadata.sourcesUsed} memories across ${metadata.conversationsSpanned} conversations`);
+            if (metadata.sourcesUsed === 0) {
+                spinner.info('No sources met the relevance threshold for this query');
+            }
+            else {
+                spinner.succeed(`Status report from ${metadata.sourcesUsed} memories across ${metadata.conversationsSpanned} conversations`);
+            }
+            printRetrievalCaveats(metadata, data.meta);
             if (options.format === 'json' || options.format === 'yaml') {
                 (0, formatters_1.printOutput)(data, options.format);
                 return;
@@ -3487,6 +3521,68 @@ function registerStatusCommand(memories) {
         }
     });
 }
+/**
+ * Describe an unusable response body for the DEBUG-only details payload.
+ *
+ * Never pass the body itself: it can hold memory content and transcript text,
+ * and DEBUG=1 stderr is collected by CI and agent harnesses. A shape summary
+ * is what actually helps diagnosis — which keys came back, and what the data
+ * field was.
+ */
+function responseShape(body) {
+    const keys = body && typeof body === 'object' && !Array.isArray(body) ? Object.keys(body) : [];
+    const data = body?.data;
+    const dataType = Array.isArray(data) ? 'array' : data === null ? 'null' : typeof data;
+    return { responseKeys: keys, dataType };
+}
+/**
+ * Surface retrieval-quality caveats that travel with a digest/status response.
+ *
+ * The server sets these when it fell back to weak or heterogeneous matches
+ * (core-api/src/schemas/digest.schema.ts — "Consumers should surface a warning
+ * to the calling agent"). Without them a loosely-related digest reads exactly
+ * like a well-matched one.
+ *
+ * Caveats go to STDERR so they reach the caller in every output format,
+ * including `--format json`, where the digest body must remain the only
+ * top-level JSON on stdout.
+ *
+ * @param metadata - DigestMetadata from the response
+ * @param meta - Optional response-level meta (forward-compat, see below)
+ */
+function printRetrievalCaveats(metadata, meta) {
+    const avg = typeof metadata?.averageRelevance === 'number' ? metadata.averageRelevance : null;
+    const avgLabel = avg === null ? 'unknown' : avg.toFixed(3);
+    if (metadata?.narrowWindowFallback) {
+        console.error(chalk_1.default.yellow(`⚠ Low-relevance results: average relevance ${avgLabel} is below the confidence ` +
+            'threshold — this digest was synthesised from weak matches and may be only ' +
+            'loosely related to your query.'));
+    }
+    if (metadata?.crossProjectFallback) {
+        console.error(chalk_1.default.yellow(`⚠ Cross-project results: average relevance ${avgLabel} is below the confidence ` +
+            'threshold and the sources span more than one project — this content may come ' +
+            'from a different project than the one you are working in.'));
+    }
+    // Forward-compat with the retrieval team's degraded-retrieval contract
+    // (meta.degraded / meta.branchFailures). Both fields are absent on today's
+    // responses, so every access is guarded.
+    if (meta?.degraded) {
+        const failures = Array.isArray(meta.branchFailures) ? meta.branchFailures : [];
+        // Branch names are server-supplied and land on stderr, which agents read.
+        // Constrain them to an identifier shape and cap the count rather than
+        // echoing arbitrary text: an unbounded string here is an injection channel
+        // into agent context (and can carry ANSI escapes from a hostile apiUrl).
+        const names = failures
+            .map((b) => (typeof b === 'string' ? b : b?.branch || b?.name))
+            .filter((n) => typeof n === 'string' && /^[A-Za-z0-9_-]{1,32}$/.test(n))
+            .slice(0, 8);
+        const detail = names.length
+            ? `failed branches: ${names.join(', ')}`
+            : 'one or more retrieval branches failed';
+        console.error(chalk_1.default.yellow(`⚠ Degraded retrieval — ${detail}. These results are incomplete; re-run before ` +
+            'treating them as a full answer.'));
+    }
+}
 /**
  * Display a formatted digest with header box and metadata footer
  */
@@ -3578,9 +3674,8 @@ function registerRecapCommand(memories) {
             // Calculate time filter
             const recentTimestamp = (0, date_utils_1.getRecentTimestamp)(options.recent);
             if (!recentTimestamp) {
-                spinner.fail(`Invalid duration format: ${options.recent}`);
-                console.log(chalk_1.default.yellow('Supported formats: 30m, 1h, 7d, 2w'));
-                return;
+                spinner.stop();
+                throw (0, errors_1.validationError)(`Invalid duration format: ${options.recent}. Supported formats: 30m, 1h, 7d, 2w`);
             }
             const fetchLimit = parseInt(options.limit, 10);
             // Build exclude-topics value (used by both paths)
@@ -3860,10 +3955,15 @@ function registerBuildContextCommand(memories) {
             }
             const sdk = (0, api_client_1.getSdk)();
             const response = await retryRead(() => sdk.memories.buildContext(body));
-            const data = response?.data || response;
-            if (!data) {
-                spinner.fail('No response data received');
-                return;
+            // `|| response` used to make the guard below unreachable: on a 2xx with
+            // an empty body it fell back to the truthy response envelope, so the
+            // command printed "Context briefing ready" and an empty briefing (exit
+            // 0). Unwrap first, then test what we actually got (v4.04).
+            const envelope = response;
+            const data = envelope && typeof envelope === 'object' && 'data' in envelope ? envelope.data : envelope;
+            if (!data || typeof data !== 'object') {
+                spinner.stop();
+                throw (0, errors_1.unusableResponseError)('Context briefing', responseShape(data));
             }
             spinner.succeed('Context briefing ready');
             // JSON output
@@ -3945,8 +4045,7 @@ function registerBuildContextCommand(memories) {
         try {
             const validDimensions = ['day', 'week', 'month', 'topic'];
             if (!options.groupBy || !validDimensions.includes(options.groupBy)) {
-                console.log(chalk_1.default.red('Error: --group-by is required and must be one of: day, week, month, topic'));
-                return;
+                throw (0, errors_1.validationError)('--group-by is required and must be one of: day, week, month, topic');
             }
             const spinner = (0, spinner_1.createSpinner)('Fetching memory stats...', options.format).start();
             const apiUrl = config_1.config.getApiUrl();