@cortexkit/opencode-magic-context 0.42.3 → 0.42.5

package/dist/v2/store-reader.d.ts

@@ -58,6 +58,8 @@ export declare class V2StoreReader {
     idleRows(sessionID: string, after?: number): StoreRow<"idle">[];
     /** Include the completed checkpoint itself, matching the host history cut. */
     window(sessionID: string): StoreRow[];
+    /** Full retained source is needed to restore unarchived rows hidden by a host cut. */
+    history(sessionID: string): StoreRow[];
     private all;
 }
 //# sourceMappingURL=store-reader.d.ts.map

package/dist/v2/store-reader.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"store-reader.d.ts","sourceRoot":"","sources":["../../src/v2/store-reader.ts"],"names":[],"mappings":"AAGA;;;GAGG;AACH,wBAAgB,sBAAsB,CAClC,OAAO,EAAE,MAAM,EACf,GAAG,GAAE,MAAM,CAAC,UAAwB,GACrC,MAAM,CASR;AAED,iFAAiF;AACjF,wBAAgB,cAAc,CAC1B,QAAQ,EAAE,MAAM,EAChB,OAAO,SAAW,EAClB,GAAG,GAAE,MAAM,CAAC,UAAwB,GACrC,MAAM,CAGR;AAGD,MAAM,MAAM,WAAW,GACjB,gBAAgB,GAChB,gBAAgB,GAChB,mBAAmB,GACnB,MAAM,GACN,WAAW,GACX,QAAQ,GACR,OAAO,GACP,OAAO,GACP,WAAW,GACX,YAAY,GACZ,MAAM,CAAC;AACb,MAAM,WAAW,WAAW;IACxB,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC;IACvB,OAAO,CAAC,EAAE,KAAK,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,CAAC;IACzC,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,MAAM,CAAC,EAAE;QACL,KAAK,EAAE,MAAM,CAAC;QACd,MAAM,EAAE,MAAM,CAAC;QACf,SAAS,EAAE,MAAM,CAAC;QAClB,KAAK,EAAE;YAAE,IAAI,EAAE,MAAM,CAAC;YAAC,KAAK,EAAE,MAAM,CAAA;SAAE,CAAC;KAC1C,CAAC;IACF,IAAI,CAAC,EAAE;QAAE,OAAO,EAAE,MAAM,CAAC;QAAC,SAAS,CAAC,EAAE,MAAM,CAAC;QAAC,QAAQ,CAAC,EAAE,MAAM,CAAA;KAAE,CAAC;CACrE;AACD,MAAM,WAAW,QAAS,SAAQ,WAAW;IACzC,OAAO,EAAE,WAAW,GAAG,QAAQ,GAAG,aAAa,CAAC;CACnD;AACD,MAAM,WAAW,cAAe,SAAQ,WAAW;IAC/C,MAAM,EAAE,MAAM,CAAC;IACf,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,MAAM,CAAC,EAAE,MAAM,CAAC;CACnB;AACD,MAAM,WAAW,QAAQ,CAAC,CAAC,SAAS,WAAW,GAAG,WAAW;IACzD,EAAE,EAAE,MAAM,CAAC;IACX,UAAU,EAAE,MAAM,CAAC;IACnB,IAAI,EAAE,CAAC,CAAC;IACR,GAAG,EAAE,MAAM,CAAC;IACZ,IAAI,EAAE,CAAC,SAAS,MAAM,GAAG,QAAQ,GAAG,CAAC,SAAS,YAAY,GAAG,cAAc,GAAG,WAAW,CAAC;CAC7F;AAmBD,0GAA0G;AAC1G,qBAAa,aAAa;IACtB,OAAO,CAAC,QAAQ,CAAC,EAAE,CAAW;gBAClB,IAAI,EAAE,MAAM;IAGxB,KAAK,IAAI,IAAI;IAIb,kFAAkF;IAClF,IAAI,CACA,SAAS,EAAE,MAAM,EACjB,OAAO,GAAE;QAAE,KAAK,CAAC,EAAE,MAAM,CAAC;QAAC,KAAK,CAAC,EAAE,MAAM,CAAC;QAAC,IAAI,CAAC,EAAE,WAAW,CAAA;KAAO,GACrE;QAAE,IAAI,EAAE,QAAQ,EAAE,CAAC;QAAC,MAAM,EAAE,MAAM,GAAG,SAAS,CAAA;KAAE;IAoBnD,gBAAgB,CAAC,SAAS,EAAE,MAAM,GAAG,QAAQ,CAAC,YAAY,CAAC,GAAG,SAAS;IAQvE,QAAQ,CAAC,SAAS,EAAE,MAAM,EAAE,KAAK,SAAK,GAAG,QAAQ,CAAC,MAAM,CAAC,EAAE;IAG3D,8EAA8E;IAC9E,MAAM,CAAC,SAAS,EAAE,MAAM,GAAG,QAAQ,EAAE;IAMrC,OAAO,CAAC,GAAG;CASd"}
+{"version":3,"file":"store-reader.d.ts","sourceRoot":"","sources":["../../src/v2/store-reader.ts"],"names":[],"mappings":"AAGA;;;GAGG;AACH,wBAAgB,sBAAsB,CAClC,OAAO,EAAE,MAAM,EACf,GAAG,GAAE,MAAM,CAAC,UAAwB,GACrC,MAAM,CASR;AAED,iFAAiF;AACjF,wBAAgB,cAAc,CAC1B,QAAQ,EAAE,MAAM,EAChB,OAAO,SAAW,EAClB,GAAG,GAAE,MAAM,CAAC,UAAwB,GACrC,MAAM,CAGR;AAGD,MAAM,MAAM,WAAW,GACjB,gBAAgB,GAChB,gBAAgB,GAChB,mBAAmB,GACnB,MAAM,GACN,WAAW,GACX,QAAQ,GACR,OAAO,GACP,OAAO,GACP,WAAW,GACX,YAAY,GACZ,MAAM,CAAC;AACb,MAAM,WAAW,WAAW;IACxB,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC;IACvB,OAAO,CAAC,EAAE,KAAK,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,CAAC;IACzC,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,MAAM,CAAC,EAAE;QACL,KAAK,EAAE,MAAM,CAAC;QACd,MAAM,EAAE,MAAM,CAAC;QACf,SAAS,EAAE,MAAM,CAAC;QAClB,KAAK,EAAE;YAAE,IAAI,EAAE,MAAM,CAAC;YAAC,KAAK,EAAE,MAAM,CAAA;SAAE,CAAC;KAC1C,CAAC;IACF,IAAI,CAAC,EAAE;QAAE,OAAO,EAAE,MAAM,CAAC;QAAC,SAAS,CAAC,EAAE,MAAM,CAAC;QAAC,QAAQ,CAAC,EAAE,MAAM,CAAA;KAAE,CAAC;CACrE;AACD,MAAM,WAAW,QAAS,SAAQ,WAAW;IACzC,OAAO,EAAE,WAAW,GAAG,QAAQ,GAAG,aAAa,CAAC;CACnD;AACD,MAAM,WAAW,cAAe,SAAQ,WAAW;IAC/C,MAAM,EAAE,MAAM,CAAC;IACf,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,MAAM,CAAC,EAAE,MAAM,CAAC;CACnB;AACD,MAAM,WAAW,QAAQ,CAAC,CAAC,SAAS,WAAW,GAAG,WAAW;IACzD,EAAE,EAAE,MAAM,CAAC;IACX,UAAU,EAAE,MAAM,CAAC;IACnB,IAAI,EAAE,CAAC,CAAC;IACR,GAAG,EAAE,MAAM,CAAC;IACZ,IAAI,EAAE,CAAC,SAAS,MAAM,GAAG,QAAQ,GAAG,CAAC,SAAS,YAAY,GAAG,cAAc,GAAG,WAAW,CAAC;CAC7F;AAmBD,0GAA0G;AAC1G,qBAAa,aAAa;IACtB,OAAO,CAAC,QAAQ,CAAC,EAAE,CAAW;gBAClB,IAAI,EAAE,MAAM;IAGxB,KAAK,IAAI,IAAI;IAIb,kFAAkF;IAClF,IAAI,CACA,SAAS,EAAE,MAAM,EACjB,OAAO,GAAE;QAAE,KAAK,CAAC,EAAE,MAAM,CAAC;QAAC,KAAK,CAAC,EAAE,MAAM,CAAC;QAAC,IAAI,CAAC,EAAE,WAAW,CAAA;KAAO,GACrE;QAAE,IAAI,EAAE,QAAQ,EAAE,CAAC;QAAC,MAAM,EAAE,MAAM,GAAG,SAAS,CAAA;KAAE;IAoBnD,gBAAgB,CAAC,SAAS,EAAE,MAAM,GAAG,QAAQ,CAAC,YAAY,CAAC,GAAG,SAAS;IAQvE,QAAQ,CAAC,SAAS,EAAE,MAAM,EAAE,KAAK,SAAK,GAAG,QAAQ,CAAC,MAAM,CAAC,EAAE;IAG3D,8EAA8E;IAC9E,MAAM,CAAC,SAAS,EAAE,MAAM,GAAG,QAAQ,EAAE;IAMrC,sFAAsF;IACtF,OAAO,CAAC,SAAS,EAAE,MAAM,GAAG,QAAQ,EAAE;IAGtC,OAAO,CAAC,GAAG;CASd"}

package/index.js

@@ -0,0 +1 @@
+export { default } from "./dist/index.js";

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@cortexkit/opencode-magic-context",
-  "version": "0.42.3",
+  "version": "0.42.5",
   "type": "module",
   "description": "OpenCode plugin for Magic Context — cross-session memory and context management",
   "main": "dist/index.js",
@@ -24,6 +24,7 @@
   },
   "files": [
     "dist",
+    "index.js",
     "src/tui",
     "src/tui-compiled",
     "src/shared",
@@ -34,16 +35,16 @@
     "README.md"
   ],
   "scripts": {
-    "build": "tsc -p ../retina-local-fs/tsconfig.build.json && bun run build:tui && rm -f dist/index.js dist/transformers-web.js dist/transformers-node-wasm.js dist/*-*.js && bun build src/features/magic-context/memory/transformers-web-entry.ts --outfile dist/transformers-web.js --target browser --format esm --external onnxruntime-web && bun scripts/build-transformers-node-wasm.ts dist && bun build src/index.ts --outdir dist --target node --format esm --splitting --external @opencode-ai/plugin --external onnxruntime-node --external onnxruntime-web --external sharp --external bun:sqlite --external node:sqlite && bun run build:v2 && tsc --emitDeclarationOnly",
+    "build": "bun ../../scripts/check-bun.mjs && tsc -p ../retina-local-fs/tsconfig.build.json && bun run build:tui && rm -f dist/index.js dist/transformers-web.js dist/transformers-node-wasm.js dist/*-*.js && bun build src/features/magic-context/memory/transformers-web-entry.ts --outfile dist/transformers-web.js --target browser --format esm --external onnxruntime-web && bun scripts/build-transformers-node-wasm.ts dist && bun build src/index.ts --outdir dist --target node --format esm --splitting --external @opencode-ai/plugin --external onnxruntime-node --external onnxruntime-web --external sharp --external bun:sqlite --external node:sqlite && bun run build:v2 && tsc --emitDeclarationOnly",
     "build:v2": "bun build src/v2/server.ts --outfile dist/v2/server.js --target node --format esm --external @opencode/plugin && bun test src/v2/server.test.ts",
     "build:tui": "bun scripts/build-tui.ts",
     "check:tui-compiled": "bun run build:tui && git diff --exit-code -- src/tui-compiled && test -z \"$(git status --porcelain -- src/tui-compiled)\"",
     "check:transformers-node-wasm": "bun scripts/verify-transformers-node-wasm.ts",
     "typecheck": "tsc -p ../retina-local-fs/tsconfig.build.json && tsc --noEmit && tsc -p tsconfig.scripts.json",
-    "test": "bun install --frozen-lockfile && bun test --parallel --timeout 30000",
+    "test": "bun ../../scripts/check-bun.mjs && bun install --frozen-lockfile && bun test --parallel --timeout 30000",
     "test:serial": "bun install --frozen-lockfile && bun test --timeout 30000",
     "test:parallel:probe": "bun scripts/verify-parallel-db-isolation.ts",
-    "lint": "biome check .",
+    "lint": "bun ../../scripts/check-bun.mjs && biome check .",
     "lint:fix": "biome check --write .",
     "format": "biome format --write .",
     "format:check": "biome format .",

package/src/features/magic-context/dreamer/task-registry.ts

@@ -8,6 +8,8 @@
  * concurrently while memory-mutating tasks serialize. See lease.ts + the A+B spec.
  */
 
+import type { CurateMemoryCategory } from "./curate-category-rotation";
+
 export const CANONICAL_DREAM_TASKS = [
     // map-memories runs BEFORE verify (it records the file mappings verify gates
     // on) and shares the memory lease, so it leads the canonical order.
@@ -27,12 +29,33 @@ export const CANONICAL_DREAM_TASKS = [
 
 export type DreamTaskName = (typeof CANONICAL_DREAM_TASKS)[number];
 
+export const DREAM_TASK_CAPABILITIES: Record<DreamTaskName, { requiresTools: boolean }> = {
+    // A single manifest is not a tool-free task: mapping and verification need
+    // read-only tools to inspect backing code before they can change memory state.
+    "map-memories": { requiresTools: true },
+    verify: { requiresTools: true },
+    "verify-broad": { requiresTools: true },
+    curate: { requiresTools: true },
+    // mural/compress-cues.ts is a zero-tool transform; its child transport
+    // still needs substitution before the generate executor can dispatch it.
+    "compress-cues": { requiresTools: false },
+    "classify-memories": { requiresTools: false },
+    retrospective: { requiresTools: true },
+    "maintain-docs": { requiresTools: true },
+    "evaluate-smart-notes": { requiresTools: true },
+    "review-user-memories": { requiresTools: true },
+    "promote-primers": { requiresTools: true },
+    "refresh-primers": { requiresTools: true },
+};
+
 /** Cheap, read-only work counts for one Dreamer task. */
 export interface DreamTaskBacklog {
     /** Items selected by the task's current backlog predicate. */
     pending: number;
     /** Total items in the task's candidate pool. */
     total: number;
+    /** Curate's one-category scope for this run/window. */
+    category?: CurateMemoryCategory;
 }
 
 /** Backlog counts keyed by canonical task name. */
@@ -47,6 +70,9 @@ export function formatDreamTaskBacklogs(
         .filter((task) => backlogs[task] !== undefined)
         .map((task) => {
             const backlog = backlogs[task];
+            if (task === "curate" && backlog?.category) {
+                return `- curate: ${backlog.category} (${backlog.pending})`;
+            }
             return `- ${task}: ${backlog?.pending ?? 0} pending / ${backlog?.total ?? 0} total`;
         })
         .join("\n");
@@ -58,6 +84,8 @@ export interface DreamTaskProgress {
     processed: number;
     total: number;
     startedAt: number;
+    /** Curate's one-category scope. */
+    category?: CurateMemoryCategory;
     /** Update/archive verdicts refused by host-side verification safety gates during the current run. */
     refused?: number;
 }
@@ -69,6 +97,7 @@ export interface DreamTaskRunBacklog {
     pendingAtEnd: number;
     totalAtEnd: number;
     processed: number;
+    category?: CurateMemoryCategory;
 }
 
 /** Use the decrease in the persisted backlog between the start and end snapshots as the per-run progress count, clamped to zero when the backlog does not decrease. */

package/src/shared/harness.ts

@@ -13,13 +13,14 @@
  * happens:
  * - OpenCode plugin: relies on the default ("opencode") — no setHarness call
  *   needed
+ * - OpenCode 2 plugin: calls `setHarness("opencode2")` before opening the database
  * - Pi-compatible plugin: resolves the host and calls `setHarness("pi" | "omp")` before opening the database
  *
  * NEVER read this from configuration or session state — it is a
  * boot-time constant per plugin instance. Cross-harness leakage is a
  * correctness bug, not a feature.
  */
-export type HarnessId = "opencode" | "pi" | "omp";
+export type HarnessId = "opencode" | "opencode2" | "pi" | "omp";
 
 let currentHarness: HarnessId = "opencode";
 let harnessLocked = false;

package/src/shared/model-suggestion-retry.ts

@@ -6,7 +6,11 @@ import type { ModelInput } from "./model-resolution";
 import { sanitizeDiagnosticText } from "./redaction";
 import { parseProviderModel, toModelEntry } from "./resolve-fallbacks";
 
-type Client = ReturnType<typeof createOpencodeClient>;
+type Client = ReturnType<typeof createOpencodeClient> | undefined;
+
+export type PromptTransport = ((args: PromptArgs) => Promise<void>) & {
+    readonly childSessionId?: string;
+};
 
 /** Max time to wait for the best-effort child-session abort HTTP call before
  *  giving up on its response (the abort still proceeds server-side). Keeps a
@@ -50,6 +54,7 @@ export interface PromptAttemptInfo {
 }
 
 export interface PromptRetryOptions {
+    transport?: PromptTransport;
     timeoutMs?: number;
     /** External abort signal — cancels the in-flight LLM prompt immediately when aborted */
     signal?: AbortSignal;
@@ -200,6 +205,7 @@ async function promptWithTimeout(
     args: PromptArgs,
     timeoutMs: number,
     signal?: AbortSignal,
+    transport?: PromptTransport,
 ): Promise<void> {
     // Bail immediately if the caller's signal is already aborted (e.g.
     // lease loss before this attempt was scheduled). Per spec
@@ -218,23 +224,29 @@ async function promptWithTimeout(
     signal?.addEventListener("abort", onExternalAbort);
 
     try {
-        await client.session.prompt({
-            ...args,
-            signal: controller.signal,
-        } as Parameters<typeof client.session.prompt>[0]);
+        const request = { ...args, signal: controller.signal };
+        if (transport) await transport(request);
+        else {
+            if (!client) throw new Error("Hidden completion transport is unavailable");
+            await client.session.prompt(request as Parameters<typeof client.session.prompt>[0]);
+        }
     } catch (error) {
         if (signal?.aborted) {
             // External abort (e.g. dreamer lease loss): the child run loop is an
             // independent SERVER-SIDE fiber — cancelling our client fetch alone
             // leaves it looping the LLM forever (issue #154). Force-stop it.
-            await abortChildRun(client, args.path.id);
+            if (!transport || transport.childSessionId) {
+                await abortChildRun(client, transport?.childSessionId ?? args.path.id);
+            }
             throw new Error("prompt aborted by external signal");
         }
         if (controller.signal.aborted) {
             // Our timeout fired. Same problem: abort the server-side run loop, not
             // just our fetch, or the child keeps re-calling the LLM past the
             // timeout (uncancellable by the user's ESC — issue #154).
-            await abortChildRun(client, args.path.id);
+            if (!transport || transport.childSessionId) {
+                await abortChildRun(client, transport?.childSessionId ?? args.path.id);
+            }
             throw new Error(`prompt timed out after ${timeoutMs}ms`);
         }
         throw error;
@@ -251,6 +263,7 @@ async function promptWithTimeout(
  * a failure here must not mask the original timeout/abort error.
  */
 async function abortChildRun(client: Client, sessionId: string): Promise<void> {
+    if (!client) return;
     try {
         // Bound the abort call: it's best-effort cleanup, and if the abort
         // endpoint itself stalls (the runner is wedged) an unbounded await here
@@ -342,6 +355,7 @@ function throwWithPromptFailure(
     failedAttempts: FailedAttempt[],
     args: PromptArgs,
     timeoutMs: number,
+    transport?: PromptTransport,
 ): never {
     const error =
         legacyError instanceof Error ? legacyError : new Error(extractMessage(legacyError));
@@ -357,7 +371,7 @@ function throwWithPromptFailure(
         modelsTried: failedAttempts.map((failure) => failure.attempt.label),
         providerError,
         timeoutMs: failureClass === "provider_timeout" ? timeoutMs : null,
-        childSessionId: args.path.id || null,
+        childSessionId: transport ? (transport.childSessionId ?? null) : args.path.id || null,
     });
     throw error;
 }
@@ -374,6 +388,7 @@ async function attemptOnce(
     signal: AbortSignal | undefined,
     callContext: string,
     label: string,
+    transport?: PromptTransport,
 ): Promise<void> {
     // Keep this snapshot separate from the object passed to the client. A
     // failed prompt facade may rewrite its request body before rejecting; the
@@ -381,7 +396,7 @@ async function attemptOnce(
     const originalBody = { ...args.body };
     const attemptArgs = copyPromptArgs(args, originalBody);
     try {
-        await promptWithTimeout(client, attemptArgs, timeoutMs, signal);
+        await promptWithTimeout(client, attemptArgs, timeoutMs, signal, transport);
         return;
     } catch (error) {
         // If non-retryable (abort, overflow, timeout), bubble up immediately.
@@ -411,6 +426,7 @@ async function attemptOnce(
             }),
             timeoutMs,
             signal,
+            transport,
         );
     }
 }
@@ -460,6 +476,7 @@ export async function promptSyncWithModelSuggestionRetry(
             options.signal,
             callContext,
             explicitPrimaryLabel,
+            options.transport,
         );
         return;
     } catch (error) {
@@ -496,7 +513,15 @@ export async function promptSyncWithModelSuggestionRetry(
         });
 
         try {
-            await attemptOnce(client, attemptArgs, timeoutMs, options.signal, callContext, label);
+            await attemptOnce(
+                client,
+                attemptArgs,
+                timeoutMs,
+                options.signal,
+                callContext,
+                label,
+                options.transport,
+            );
             log(
                 `[${callContext}] fallback succeeded with ${label} (attempt ${i + 2}/${fallbacks.length + 1})`,
             );
@@ -533,7 +558,15 @@ async function attemptAndValidate<TOutput, TValidated>(
     options: ValidatedPromptRetryOptions<TOutput, TValidated>,
 ): Promise<ValidatedPromptRetryResult<TOutput, TValidated>> {
     try {
-        await attemptOnce(client, args, timeoutMs, signal, callContext, attempt.label);
+        await attemptOnce(
+            client,
+            args,
+            timeoutMs,
+            signal,
+            callContext,
+            attempt.label,
+            options.transport,
+        );
     } catch (error) {
         throw {
             error,
@@ -615,11 +648,23 @@ export async function promptSyncWithValidatedOutputRetry<TOutput, TValidated = T
         firstError = failure.error;
         lastError = failure.error;
         if (isNonRetryable(failure.error, options.signal)) {
-            throwWithPromptFailure(failure.error, failedAttempts, args, timeoutMs);
+            throwWithPromptFailure(
+                failure.error,
+                failedAttempts,
+                args,
+                timeoutMs,
+                options.transport,
+            );
         }
 
         if (fallbacks.length === 0) {
-            throwWithPromptFailure(failure.error, failedAttempts, args, timeoutMs);
+            throwWithPromptFailure(
+                failure.error,
+                failedAttempts,
+                args,
+                timeoutMs,
+                options.transport,
+            );
         }
 
         log(
@@ -669,7 +714,13 @@ export async function promptSyncWithValidatedOutputRetry<TOutput, TValidated = T
             failedAttempts.push(failure);
             lastError = failure.error;
             if (isNonRetryable(failure.error, options.signal)) {
-                throwWithPromptFailure(failure.error, failedAttempts, args, timeoutMs);
+                throwWithPromptFailure(
+                    failure.error,
+                    failedAttempts,
+                    args,
+                    timeoutMs,
+                    options.transport,
+                );
             }
 
             const remaining = fallbacks.length - i - 1;
@@ -689,5 +740,6 @@ export async function promptSyncWithValidatedOutputRetry<TOutput, TValidated = T
         failedAttempts,
         args,
         timeoutMs,
+        options.transport,
     );
 }

package/src/shared/prompt-surface-runtime.ts

@@ -105,7 +105,11 @@ function resolveUserConfigDirectory(options: CreatePromptSurfaceRuntimeOptions):
     if (options.harness) {
         const legacy = resolveLegacyConfigSourcesForHarness(
             options.directory ?? process.cwd(),
-            options.harness === "omp" ? "pi" : options.harness,
+            options.harness === "omp"
+                ? "pi"
+                : options.harness === "opencode2"
+                  ? "opencode"
+                  : options.harness,
         ).user.find((source) => existsSync(source.path));
         if (legacy) return dirname(legacy.path);
     }

package/src/shared/rpc-types.ts

@@ -149,6 +149,19 @@ export interface SidebarSnapshot {
 export interface StatusDetail extends SidebarSnapshot {
     /** True when Rust authority has rerouted host tool and historian paths to the module. */
     hostBackendsModuleSide?: boolean;
+    /** Host cursor compared with the module changefeed frontier. */
+    memoryMirror?: {
+        cursor: number;
+        cursorUpdatedAt: number | null;
+        cursorAgeMs: number | null;
+        liveRows: number;
+        feedHead: number | null;
+        pendingRows: number | null;
+        stalled: boolean;
+        code: "MC-M01" | null;
+    };
+    /** A durable host marker whose live module status no longer reports module ownership. */
+    memoryAuthorityMismatch?: boolean;
     /** User-owned model profile selected for this project, or null for the base config. */
     activeProfile: string | null;
     tagCounter: number;

package/src/shared/status-detail-text.test.ts

@@ -157,6 +157,32 @@ describe("status detail text", () => {
         expect(summary).toContain("(MC-H01)");
     });
 
+    test("shows stalled mirror and authority mismatch codes in summary and diagnostics", () => {
+        const detail = {
+            ...STATUS_FIXTURE,
+            hostBackendsModuleSide: true,
+            memoryMirror: {
+                cursor: 3726,
+                cursorUpdatedAt: 1,
+                cursorAgeMs: 40_000,
+                liveRows: 275,
+                feedHead: 4850,
+                pendingRows: 1124,
+                stalled: true,
+                code: "MC-M01" as const,
+            },
+            memoryAuthorityMismatch: true,
+        };
+        const summary = formatStatusDetailMarkdown(detail);
+        const diagnostics = formatStatusDiagnosticsMarkdown(detail);
+
+        expect(summary).toContain("(MC-M01)");
+        expect(summary).toContain("(MC-M02)");
+        expect(diagnostics).toContain("cursor 3,726 / 4,850");
+        expect(diagnostics).toContain("stalled (MC-M01)");
+        expect(diagnostics).toContain("(MC-M02)");
+    });
+
     test("does not expose module routing in the summary", () => {
         const rustStatus = formatStatusDetailMarkdown({
             ...STATUS_FIXTURE,

package/src/shared/status-detail-text.ts

@@ -67,6 +67,11 @@ export function formatStatusDiagnosticsMarkdown(detail: StatusDetail): string {
         `- **${formatCacheTtlDisplay({ value: detail.cacheTtl, source: detail.cacheTtlSource ?? "session", modelKey: detail.cacheTtlModelKey })}**; ${formatCacheLane(detail)}`,
         `- **Historian:** ${[historianState, ...historianDetails].join("; ")}`,
         ...(detail.hostBackendsModuleSide ? [`- ${RUST_MODE_HOST_PATHS_LINE}`] : []),
+        ...(detail.memoryMirror
+            ? [
+                  `- **Memory mirror:** cursor ${formatCount(detail.memoryMirror.cursor)} / ${detail.memoryMirror.feedHead === null ? "unknown" : formatCount(detail.memoryMirror.feedHead)}; ${formatCount(detail.memoryMirror.liveRows)} live rows; ${detail.memoryMirror.stalled ? `stalled (${detail.memoryMirror.code})` : "advancing or caught up"}`,
+              ]
+            : []),
         `- **Memory:** ${formatCount(detail.memoryCount)} active; ${formatCount(detail.memoryBlockCount)} injected`,
         `- **Tags:** ${formatCount(detail.activeTags)} active, ${formatCount(detail.droppedTags)} dropped; ${formatCount(detail.pendingOpsCount)} pending drops`,
         `- **Execute threshold:** ${detail.executeThreshold.toFixed(1)}%${detail.executeThresholdClamped ? " (clamped)" : ""}`,
@@ -80,6 +85,12 @@ export function formatStatusDiagnosticsMarkdown(detail: StatusDetail): string {
     if (detail.lastTransformError) {
         lines.push(`- **Warning:** ${renderUserFacingFailure("transform_update_failed")}`);
     }
+    if (detail.memoryMirror?.stalled) {
+        lines.push(`- **Warning:** ${renderUserFacingFailure("memory_mirror_stalled")}`);
+    }
+    if (detail.memoryAuthorityMismatch) {
+        lines.push(`- **Warning:** ${renderUserFacingFailure("memory_authority_mismatch")}`);
+    }
 
     return lines.join("\n");
 }

package/src/shared/status-summary.ts

@@ -49,6 +49,8 @@ export function statusSummaryFromDetail(detail: StatusDetail): UserStatusSummary
     if ((detail.loggerDiagnostics?.swallowedWriteCount ?? 0) > 0) {
         warnings.push("status_log_unavailable");
     }
+    if (detail.memoryMirror?.stalled) warnings.push("memory_mirror_stalled");
+    if (detail.memoryAuthorityMismatch) warnings.push("memory_authority_mismatch");
 
     return {
         inputTokens: detail.inputTokens,

package/src/shared/user-facing-codes.test.ts

@@ -43,7 +43,7 @@ describe("user-facing failure codes", () => {
         const entries = Object.values(USER_FACING_FAILURES);
         expect(new Set(entries.map((entry) => entry.code)).size).toBe(entries.length);
         for (const [key, entry] of Object.entries(USER_FACING_FAILURES)) {
-            expect(entry.code).toMatch(/^MC-[CHDERS]\d{2}$/);
+            expect(entry.code).toMatch(/^MC-[CHDERSM]\d{2}$/);
             expect(entry.sentence).toEndWith(".");
             expect(entry.action).toEndWith(".");
             expect(renderUserFacingFailure(key as keyof typeof USER_FACING_FAILURES)).toBe(

package/src/shared/user-facing-codes.ts

@@ -177,6 +177,16 @@ export const USER_FACING_FAILURES = {
         sentence: "Magic Context is temporarily unavailable.",
         action: "Retry in a moment.",
     },
+    memory_mirror_stalled: {
+        code: "MC-M01",
+        sentence: "Memory synchronization stopped before the host mirror caught up.",
+        action: "Send another message to resume it, or run `ck doctor drain-authority`.",
+    },
+    memory_authority_mismatch: {
+        code: "MC-M02",
+        sentence: "Memory authority is inconsistent between the host and module.",
+        action: "Run `ck doctor drain-authority` before changing Rust mode.",
+    },
 } as const;
 
 export type UserFacingFailureKey = keyof typeof USER_FACING_FAILURES;