@memnexus-ai/cli 1.7.221 → 1.7.223

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":"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"}
+{"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,9 +73,11 @@ 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");
+const renderable_retrieval_1 = require("../lib/renderable-retrieval");
 const js_yaml_1 = __importDefault(require("js-yaml"));
 const spinner_1 = require("../lib/spinner");
 const date_utils_1 = require("../lib/date-utils");
@@ -1791,9 +1793,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-
@@ -2459,26 +2472,40 @@ function registerMemoriesCommands(program) {
                 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) {
-                searchData.data = searchData.data.map((r) => r.memory ? r : { memory: r, score: r.score, matchedVia: r.matchedVia });
+            // Every render path below takes the renderable, never the raw body: the
+            // factory normalizes {memory, score, matchedVia} AND maps meta.degraded
+            // once, so no format can render a degraded result as healthy (#5124).
+            const search = renderable_retrieval_1.RenderableSearchResult.fromApiResponse(searchData);
+            // The headline is the first thing a caller reads and was unconditional:
+            // "Found N results" over an incomplete gather reads as a full answer.
+            if (search.health.degraded) {
+                spinner?.warn(`Found ${search.results.length} results${(0, renderable_retrieval_1.degradationHeadlineSuffix)(search.health)}`);
+            }
+            else {
+                spinner?.succeed(`Found ${search.results.length} results`);
+            }
+            // Degradation marker — stderr, before any format branch, so it reaches
+            // the caller in every output mode including --id-only and --format json
+            // where stdout must stay machine-parseable.
+            const degradedLine = (0, renderable_retrieval_1.degradationWarningLine)(search.health);
+            if (degradedLine) {
+                console.error(chalk_1.default.yellow(degradedLine));
             }
-            spinner?.succeed(`Found ${searchData?.data?.length || 0} results`);
             // Surface extraction failures (#2862). Failed memories are invisible to
             // fact/entity search, so flag them on stderr where they won't pollute
             // piped JSON. Callers in table mode also see an inline indicator below.
-            const failedResultCount = (searchData?.data || []).filter((r) => {
+            const failedResultCount = search.results.filter((r) => {
                 const m = r?.memory ?? r;
                 return m && m.extractionStatus === 'failed';
             }).length;
             if (failedResultCount > 0 && !options.idOnly) {
-                const total = searchData?.data?.length || 0;
+                const total = search.results.length;
                 console.error(chalk_1.default.yellow(`⚠ ${failedResultCount} of ${total} results have failed extraction (won\u2019t appear in fact/entity searches).`));
             }
-            // --id-only mode: output only IDs for piping
+            // --id-only mode: output only IDs for piping. The degradation marker
+            // already went to stderr above, so it survives the pipe.
             if (options.idOnly) {
-                const ids = (searchData?.data || [])
+                const ids = search.results
                     .map((result) => result.memory?.id)
                     .filter((id) => id);
                 console.log(ids.join('\n'));
@@ -2486,12 +2513,12 @@ function registerMemoriesCommands(program) {
             }
             // --timeline mode: chronological display with timestamps and effective state
             if (options.timeline) {
-                displayTimelineResults(searchData?.data || [], options.query, previewLength);
+                displayTimelineResults(search.results, options.query, previewLength, search.health);
                 return;
             }
             // --group-by conversation: group results by conversation ID
             if (options.groupBy === 'conversation') {
-                const results = searchData?.data || [];
+                const results = search.results;
                 const grouped = groupByConversation(results);
                 if (effectiveFormat === 'json' || effectiveFormat === 'yaml') {
                     // Convert Map to array for JSON/YAML serialization
@@ -2500,10 +2527,13 @@ function registerMemoriesCommands(program) {
                         memoryCount: memories.length,
                         memories: memories,
                     }));
+                    // Array-shaped payload: adding a health object would change the
+                    // top-level shape, so the marker for this path is the stderr line
+                    // emitted above.
                     (0, formatters_1.printOutput)(groupedArray, effectiveFormat);
                 }
                 else {
-                    displayGroupedSearch(grouped, options.query);
+                    displayGroupedSearch(grouped, options.query, search.health);
                 }
                 return;
             }
@@ -2511,7 +2541,7 @@ function registerMemoriesCommands(program) {
             if (effectiveFormat === 'llm') {
                 // LLM format: clean markdown without ANSI codes
                 // Extract nested memory objects for formatting
-                const llmData = (searchData?.data || []).map((result) => {
+                const llmData = search.results.map((result) => {
                     const m = result.memory;
                     return {
                         id: m.id,
@@ -2520,15 +2550,19 @@ function registerMemoriesCommands(program) {
                         createdAt: m.createdAt,
                     };
                 });
+                const llmMarker = (0, renderable_retrieval_1.degradationSummaryLine)(search.health);
+                if (llmMarker) {
+                    console.log(llmMarker);
+                }
                 (0, formatters_1.printOutput)(llmData, 'llm', undefined, {
-                    totalCount: searchData?.meta?.total ?? llmData.length,
+                    totalCount: search.total,
                     previewLength: Math.min(previewLength, 100), // Shorter preview for LLM
                     title: 'Search Results',
                 });
             }
             else if (effectiveFormat === 'compact') {
                 // Compact format: ID + date + first line
-                const compactData = (searchData?.data || []).map((result) => {
+                const compactData = search.results.map((result) => {
                     const m = result.memory;
                     return {
                         id: m.id,
@@ -2536,13 +2570,17 @@ function registerMemoriesCommands(program) {
                         createdAt: m.createdAt,
                     };
                 });
+                const compactMarker = (0, renderable_retrieval_1.degradationSummaryLine)(search.health);
+                if (compactMarker) {
+                    console.log(chalk_1.default.yellow(compactMarker));
+                }
                 (0, formatters_1.printOutput)(compactData, 'compact');
             }
             else if (effectiveFormat === 'table' || !effectiveFormat) {
                 // Table format: default display with colors and borders
                 // Extract nested memory object from search results
                 // API returns: {data: [{memory: {...}, score: 0.66}]}
-                const tableData = (searchData?.data || []).map((result) => {
+                const tableData = search.results.map((result) => {
                     const m = result.memory; // Extract the nested memory object
                     const score = result.score;
                     // Smart truncation with term highlighting
@@ -2578,19 +2616,23 @@ function registerMemoriesCommands(program) {
                     columnWidths: tableWidths,
                 });
                 // Show search metadata
-                const resultCount = searchData?.meta?.total || searchData?.data?.length || 0;
-                const searchMethodUsed = searchData?.meta?.searchMethod || effectiveMethod;
+                const resultCount = search.total;
+                const searchMethodUsed = search.searchMethod || effectiveMethod;
                 // Detect graph branches used
                 const allBranches = new Set();
-                for (const r of searchData?.data || []) {
+                for (const r of search.results) {
                     if (r.matchedVia) {
                         r.matchedVia.forEach((b) => allBranches.add(b));
                     }
                 }
                 const branchInfo = allBranches.size > 2 ? ` (branches: ${[...allBranches].join(', ')})` : '';
                 console.log(chalk_1.default.gray(`\nFound ${resultCount} results using ${searchMethodUsed} search${branchInfo}`));
+                const tableMarker = (0, renderable_retrieval_1.degradationSummaryLine)(search.health);
+                if (tableMarker) {
+                    console.log(chalk_1.default.yellow(tableMarker));
+                }
                 // Show temporal filters if applied
-                const temporal = searchData?.meta?.temporalMetadata;
+                const temporal = search.temporalMetadata;
                 if (temporal?.temporalFieldsIncluded) {
                     const filters = [];
                     if (temporal.eventTimeRange?.from)
@@ -2605,7 +2647,9 @@ function registerMemoriesCommands(program) {
             else {
                 // JSON/YAML formats: pass raw or content-only data
                 if (options.contentOnly) {
-                    const contentOnlyData = (searchData?.data || []).map((result) => {
+                    // Array-shaped payload by contract ({id, createdAt, topics,
+                    // content}); the marker for this path is the stderr line above.
+                    const contentOnlyData = search.results.map((result) => {
                         const m = result.memory;
                         const obj = {
                             id: m.id,
@@ -2621,7 +2665,8 @@ function registerMemoriesCommands(program) {
                     (0, formatters_1.printOutput)(contentOnlyData, effectiveFormat);
                 }
                 else {
-                    (0, formatters_1.printOutput)(searchData, effectiveFormat);
+                    // Object-shaped payload: carries the health object when degraded.
+                    (0, formatters_1.printOutput)(search.toSerializable(), effectiveFormat);
                 }
             }
         }
@@ -2725,7 +2770,13 @@ function escapeRegex(str) {
 /**
  * Display search results in timeline format (chronological with timestamps and state)
  */
-function displayTimelineResults(results, query, previewLength) {
+function displayTimelineResults(results, query, previewLength, health) {
+    // The marker prints before the "no results" return: an empty timeline over a
+    // degraded gather is exactly the case that must not read as "nothing exists".
+    const marker = (0, renderable_retrieval_1.degradationSummaryLine)(health);
+    if (marker) {
+        console.log(chalk_1.default.yellow(`\n${marker}`));
+    }
     if (results.length === 0) {
         console.log(chalk_1.default.yellow('\nNo results found.'));
         return;
@@ -3387,20 +3438,28 @@ function registerDigestCommand(memories) {
                 spinner.stop();
                 throw (0, errors_1.unusableResponseError)('Digest generation', responseShape(data));
             }
-            const { digest, metadata, sources, keyFacts, entities, effectiveStateBreakdown } = data;
+            // One construction path; the meta-vs-metadata mapping lives in the
+            // factory (#5124).
+            const renderable = renderable_retrieval_1.RenderableDigestResult.fromApiResponse(data);
+            const { digest, metadata, sources, keyFacts, entities, effectiveStateBreakdown } = renderable;
             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 if (renderable.health.degraded) {
+                spinner.warn(`Digest generated from ${metadata.sourcesUsed} memories across ` +
+                    `${metadata.conversationsSpanned} conversations` +
+                    (0, renderable_retrieval_1.degradationHeadlineSuffix)(renderable.health));
+            }
             else {
                 spinner.succeed(`Digest generated from ${metadata.sourcesUsed} memories across ${metadata.conversationsSpanned} conversations`);
             }
-            printRetrievalCaveats(metadata, data.meta);
+            printRetrievalCaveats(renderable);
             // JSON/YAML output
             if (options.format === 'json' || options.format === 'yaml') {
-                (0, formatters_1.printOutput)(data, options.format);
+                (0, formatters_1.printOutput)(renderable.toSerializable(), options.format);
                 return;
             }
             // LLM output — raw digest text only
@@ -3409,7 +3468,7 @@ function registerDigestCommand(memories) {
                 return;
             }
             // Default display with box formatting
-            displayDigest(digest, metadata, sources, options, keyFacts, entities, effectiveStateBreakdown);
+            displayDigest(digest, metadata, sources, options, keyFacts, entities, effectiveStateBreakdown, renderable.health);
         }
         catch (error) {
             // KI-77: name the ceiling and give a narrower-query fix instead of the SDK's
@@ -3486,23 +3545,29 @@ function registerStatusCommand(memories) {
                 spinner.stop();
                 throw (0, errors_1.unusableResponseError)('Status report generation', responseShape(data));
             }
-            const { digest, metadata, sources, keyFacts, entities, effectiveStateBreakdown } = data;
+            const renderable = renderable_retrieval_1.RenderableDigestResult.fromApiResponse(data);
+            const { digest, metadata, sources, keyFacts, entities, effectiveStateBreakdown } = renderable;
             if (metadata.sourcesUsed === 0) {
                 spinner.info('No sources met the relevance threshold for this query');
             }
+            else if (renderable.health.degraded) {
+                spinner.warn(`Status report from ${metadata.sourcesUsed} memories across ` +
+                    `${metadata.conversationsSpanned} conversations` +
+                    (0, renderable_retrieval_1.degradationHeadlineSuffix)(renderable.health));
+            }
             else {
                 spinner.succeed(`Status report from ${metadata.sourcesUsed} memories across ${metadata.conversationsSpanned} conversations`);
             }
-            printRetrievalCaveats(metadata, data.meta);
+            printRetrievalCaveats(renderable);
             if (options.format === 'json' || options.format === 'yaml') {
-                (0, formatters_1.printOutput)(data, options.format);
+                (0, formatters_1.printOutput)(renderable.toSerializable(), options.format);
                 return;
             }
             if (options.format === 'llm') {
                 console.log(digest);
                 return;
             }
-            displayDigest(digest, metadata, sources, options, keyFacts, entities, effectiveStateBreakdown);
+            displayDigest(digest, metadata, sources, options, keyFacts, entities, effectiveStateBreakdown, renderable.health);
         }
         catch (error) {
             (0, errors_1.handleError)(error);
@@ -3535,10 +3600,16 @@ function responseShape(body) {
  * 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)
+ * #5124: the degraded branch below read `meta.degraded` on a response that
+ * carries the flag at `metadata.degraded`, so it had never fired on any real
+ * response. It now reads `renderable.health`, which the factory populates from
+ * the field the wire actually uses. Taking the renderable rather than two loose
+ * `any` bags is what stops the same mistake being made again.
+ *
+ * @param renderable - The digest response, health already mapped
  */
-function printRetrievalCaveats(metadata, meta) {
+function printRetrievalCaveats(renderable) {
+    const metadata = renderable.metadata;
     const avg = typeof metadata?.averageRelevance === 'number' ? metadata.averageRelevance : null;
     const avgLabel = avg === null ? 'unknown' : avg.toFixed(3);
     if (metadata?.narrowWindowFallback) {
@@ -3551,30 +3622,18 @@ function printRetrievalCaveats(metadata, meta) {
             '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.'));
+    // Degraded retrieval. Branch-name sanitising (identifier shape, capped count)
+    // lives in the renderable factory now — branch names are server-supplied and
+    // land on stderr, which agents read.
+    const degradedLine = (0, renderable_retrieval_1.degradationWarningLine)(renderable.health);
+    if (degradedLine) {
+        console.error(chalk_1.default.yellow(degradedLine));
     }
 }
 /**
  * Display a formatted digest with header box and metadata footer
  */
-function displayDigest(digest, metadata, sources, options, keyFacts, entities, effectiveStateBreakdown) {
+function displayDigest(digest, metadata, sources, options, keyFacts, entities, effectiveStateBreakdown, health) {
     const width = 66;
     const border = '═'.repeat(width);
     // Format header info
@@ -3588,6 +3647,12 @@ function displayDigest(digest, metadata, sources, options, keyFacts, entities, e
     console.log(chalk_1.default.cyan(`║  ${headerLine1.padEnd(width - 2)}║`));
     console.log(chalk_1.default.cyan(`║  ${headerLine2.padEnd(width - 2)}║`));
     console.log(chalk_1.default.cyan(`╚${border}╝`));
+    // Degradation marker inside the box output, so a reader of the digest text
+    // itself sees it — not only the caller reading stderr.
+    const digestMarker = (0, renderable_retrieval_1.degradationSummaryLine)(health);
+    if (digestMarker) {
+        console.log(chalk_1.default.yellow(digestMarker));
+    }
     // Digest content
     console.log('');
     console.log(digest);
@@ -3676,7 +3741,7 @@ function registerRecapCommand(memories) {
                 : undefined;
             // Fetch memories: list endpoint (time-range browse) when no query is given;
             // search endpoint (semantic ranking) when --query is provided.
-            let results;
+            let renderable;
             if (options.query) {
                 const searchRequest = {
                     q: options.query,
@@ -3689,8 +3754,8 @@ function registerRecapCommand(memories) {
                 if (excludeTopicsParam)
                     searchRequest.excludeTopics = excludeTopicsParam;
                 const response = await retryRead(() => (0, api_client_1.getSdk)().memories.searchMemoriesGet(searchRequest));
-                // Normalize: API may return flat objects or {memory, score} wrappers.
-                results = (response.data?.data || []).map((r) => r.memory ? r : { memory: r, score: r.score, matchedVia: r.matchedVia });
+                // Normalisation and the meta.degraded mapping both live in the factory.
+                renderable = renderable_retrieval_1.RenderableSearchResult.fromApiResponse(response.data);
             }
             else {
                 // Issue #1628: search endpoint requires a query string; use list endpoint for
@@ -3705,9 +3770,12 @@ function registerRecapCommand(memories) {
                 if (excludeTopicsParam)
                     listRequest.excludeTopics = excludeTopicsParam;
                 const response = await retryRead(() => (0, api_client_1.getSdk)().memories.listMemories(listRequest));
-                // Wrap in search-result shape expected by groupByConversation / displayRecap
-                results = (response.data?.data || []).map((m) => ({ memory: m }));
+                // Wrap in search-result shape expected by groupByConversation / displayRecap.
+                // The list endpoint runs no search branches, so it is healthy by construction.
+                renderable = renderable_retrieval_1.RenderableSearchResult.fromListResponse(response.data);
             }
+            const health = renderable.health;
+            let results = [...renderable.results];
             // Client-side filtering as fallback (API exclude may not work with wildcard query)
             if (options.excludeTopics) {
                 const excludeSet = new Set(options.excludeTopics.split(',').map((t) => t.trim().toLowerCase()));
@@ -3717,7 +3785,18 @@ function registerRecapCommand(memories) {
                 });
             }
             const truncated = results.length >= fetchLimit;
-            spinner.succeed(`Found ${results.length} memories`);
+            if (health.degraded) {
+                spinner.warn(`Found ${results.length} memories${(0, renderable_retrieval_1.degradationHeadlineSuffix)(health)}`);
+            }
+            else {
+                spinner.succeed(`Found ${results.length} memories`);
+            }
+            // stderr, before the zero-result return: "no memories in the last 24h"
+            // over an incomplete gather is the exact wrong conclusion to record.
+            const recapDegraded = (0, renderable_retrieval_1.degradationWarningLine)(health);
+            if (recapDegraded) {
+                console.error(chalk_1.default.yellow(recapDegraded));
+            }
             if (results.length === 0) {
                 console.log(chalk_1.default.yellow(`\nNo memories found in the last ${options.recent}.`));
                 return;
@@ -3734,7 +3813,7 @@ function registerRecapCommand(memories) {
             // Group memories by conversation
             const conversations = groupByConversation(results);
             // Display recap
-            displayRecap(conversations, options.recent);
+            displayRecap(conversations, options.recent, health);
         }
         catch (error) {
             (0, errors_1.handleError)(error);
@@ -3767,8 +3846,12 @@ function groupByConversation(results) {
 /**
  * Display recap output grouped by conversation
  */
-function displayRecap(conversations, duration) {
+function displayRecap(conversations, duration, health) {
     console.log(chalk_1.default.cyan(`\n📅 Work Recap (last ${duration})`));
+    const recapMarker = (0, renderable_retrieval_1.degradationSummaryLine)(health);
+    if (recapMarker) {
+        console.log(chalk_1.default.yellow(recapMarker));
+    }
     console.log(chalk_1.default.gray('═'.repeat(60)));
     // Sort conversations by most recent activity
     const sortedConversations = Array.from(conversations.entries()).sort((a, b) => {
@@ -3864,8 +3947,12 @@ function extractReferences(memories) {
 /**
  * Display search results grouped by conversation
  */
-function displayGroupedSearch(conversations, query) {
+function displayGroupedSearch(conversations, query, health) {
     console.log(chalk_1.default.cyan(`\n🔍 Search Results for "${query}" (grouped by conversation)`));
+    const groupedMarker = (0, renderable_retrieval_1.degradationSummaryLine)(health);
+    if (groupedMarker) {
+        console.log(chalk_1.default.yellow(groupedMarker));
+    }
     console.log(chalk_1.default.gray('═'.repeat(60)));
     // Sort conversations by most recent activity
     const sortedConversations = Array.from(conversations.entries()).sort((a, b) => {
@@ -3953,17 +4040,36 @@ function registerBuildContextCommand(memories) {
                 spinner.stop();
                 throw (0, errors_1.unusableResponseError)('Context briefing', responseShape(data));
             }
-            spinner.succeed('Context briefing ready');
+            // The API has been sending meta.degraded (with timedOutSections /
+            // failedSections) here all along; the CLI dropped it. A briefing missing
+            // its gotchas section reads exactly like a project with no gotchas.
+            const briefing = renderable_retrieval_1.RenderableContextBriefing.fromApiResponse(data);
+            const briefingHealth = briefing.health;
+            if (briefingHealth.degraded) {
+                spinner.warn(`Context briefing ready${(0, renderable_retrieval_1.degradationHeadlineSuffix)(briefingHealth)}`);
+            }
+            else {
+                spinner.succeed('Context briefing ready');
+            }
+            const briefingDegraded = (0, renderable_retrieval_1.degradationWarningLine)(briefingHealth);
+            if (briefingDegraded) {
+                console.error(chalk_1.default.yellow(briefingDegraded));
+            }
             // JSON output
             if (options.format === 'json' || options.format === 'yaml') {
-                (0, formatters_1.printOutput)(data, options.format);
+                (0, formatters_1.printOutput)(briefing.toSerializable(), options.format);
                 return;
             }
             // Human-readable output
             console.log('');
+            const briefingMarker = (0, renderable_retrieval_1.degradationSummaryLine)(briefingHealth);
+            if (briefingMarker) {
+                console.log(chalk_1.default.yellow(briefingMarker));
+                console.log('');
+            }
             // Active Work
-            if (data.activeWork) {
-                const aw = data.activeWork;
+            if (briefing.data.activeWork) {
+                const aw = briefing.data.activeWork;
                 console.log(chalk_1.default.yellow.bold('Active Work'));
                 console.log(`  You were working on: ${chalk_1.default.white(aw.title || '(untitled)')} (${chalk_1.default.gray(aw.conversationId)})`);
                 if (aw.lastMemory?.summary) {
@@ -3972,43 +4078,43 @@ function registerBuildContextCommand(memories) {
                 console.log('');
             }
             // Key Facts
-            if (data.relevantFacts?.length) {
+            if (briefing.data.relevantFacts?.length) {
                 console.log(chalk_1.default.cyan.bold('Key Facts'));
-                for (const f of data.relevantFacts) {
+                for (const f of briefing.data.relevantFacts) {
                     console.log(`  ${chalk_1.default.gray('•')} ${f.subject} ${f.predicate} ${f.object}`);
                 }
                 console.log('');
             }
             // Gotchas
-            if (data.gotchas?.length) {
+            if (briefing.data.gotchas?.length) {
                 console.log(chalk_1.default.red.bold('Gotchas'));
-                for (const g of data.gotchas) {
+                for (const g of briefing.data.gotchas) {
                     console.log(`  ${chalk_1.default.red('⚠')} ${chalk_1.default.bold(g.fact)} ${chalk_1.default.gray(`(${g.sourceCount} sources)`)}`);
                 }
                 console.log('');
             }
             // Recent Activity
-            if (data.recentActivity?.length) {
-                const hours = data.meta?.recentHours || 24;
+            if (briefing.data.recentActivity?.length) {
+                const hours = briefing.data.meta?.recentHours || 24;
                 console.log(chalk_1.default.green.bold(`Recent Activity (last ${hours}h)`));
-                for (const a of data.recentActivity) {
+                for (const a of briefing.data.recentActivity) {
                     const date = a.date ? (0, date_utils_1.formatApiDate)(a.date) : '';
                     console.log(`  ${chalk_1.default.gray('•')} ${a.summary} ${chalk_1.default.gray(`(${date})`)}`);
                 }
                 console.log('');
             }
             // Patterns
-            if (data.relatedPatterns?.length) {
+            if (briefing.data.relatedPatterns?.length) {
                 console.log(chalk_1.default.magenta.bold('Relevant Patterns'));
-                for (const p of data.relatedPatterns) {
+                for (const p of briefing.data.relatedPatterns) {
                     const conf = p.confidence != null ? chalk_1.default.gray(` (${(p.confidence * 100).toFixed(0)}%)`) : '';
                     console.log(`  ${chalk_1.default.gray('•')} ${p.pattern}${conf}`);
                 }
                 console.log('');
             }
             // Meta
-            if (data.meta?.contextTerms?.length) {
-                console.log(chalk_1.default.gray(`Search terms: ${data.meta.contextTerms.join(', ')}`));
+            if (briefing.data.meta?.contextTerms?.length) {
+                console.log(chalk_1.default.gray(`Search terms: ${briefing.data.meta.contextTerms.join(', ')}`));
             }
         }
         catch (error) {