@cortexkit/magic-context 0.46.0 → 0.47.0

package/dist/index.js

@@ -2973,7 +2973,7 @@ function sortJson(value) {
   if (value && typeof value === "object") {
     const sorted = {};
     for (const key of Object.keys(value).sort()) {
-      if (key === "protected_tags")
+      if (key === "protected_tags" || key === "clear_reasoning_age")
         continue;
       sorted[key] = sortJson(value[key]);
     }
@@ -3108,7 +3108,9 @@ function migrateConfigFile(opts) {
     let migratedContent = first.content;
     let strippedProtectedTags = false;
     try {
-      const stripped = removeJsoncValue(first.content, ["protected_tags"]);
+      const stripped = removeJsoncValue(removeJsoncValue(first.content, ["protected_tags"]), [
+        "clear_reasoning_age"
+      ]);
       if (stripped !== first.content) {
         migratedContent = stripped;
         strippedProtectedTags = true;
@@ -3116,7 +3118,10 @@ function migrateConfigFile(opts) {
     } catch {}
     atomicWriteConfigFile(opts.targetPath, migratedContent);
     if (strippedProtectedTags) {
-      info?.(`Stripped deprecated "protected_tags" key during config location migration`);
+      if (first.content.includes('"protected_tags"'))
+        info?.(`Stripped deprecated "protected_tags" key during config location migration`);
+      if (first.content.includes('"clear_reasoning_age"'))
+        info?.(`Stripped deprecated "clear_reasoning_age" key during config location migration`);
     }
     info?.(`Migrated Magic Context ${opts.scope} config from ${first.path} to ${opts.targetPath}`);
     warnings.push(...markLegacySourcesMovedAside(sources, opts.targetPath, opts.logger));
@@ -8694,7 +8699,7 @@ class Parser {
       } else
         break;
     }
-    const expression = { steps, cap: 300 };
+    const expression = { steps };
     if (this.take(".each(")) {
       if (relative)
         return this.error();
@@ -8760,9 +8765,23 @@ function compiled(source) {
 function oneLine(value) {
   return value.replace(/[\r\n\u2028\u2029]+/g, " ");
 }
-function truncate(value, cap) {
+function truncate(value, cap, legacyPreview = false) {
   const chars = Array.from(oneLine(value));
-  return chars.length > cap ? `${chars.slice(0, cap).join("")}…` : chars.join("");
+  if (cap === undefined || chars.length <= cap)
+    return chars.join("");
+  if (legacyPreview)
+    return `${chars.slice(0, cap).join("")}…`;
+  let end = 0;
+  for (let i = 0;i < Math.min(cap, chars.length); i++) {
+    if (!".!?。！？".includes(chars[i]))
+      continue;
+    let next = i + 1;
+    while (next < chars.length && `"'”’)]`.includes(chars[next]))
+      next++;
+    if (next <= cap && ("。！？".includes(chars[i]) || next === chars.length || /[ \t]/.test(chars[next])))
+      end = next;
+  }
+  return `${end ? `${chars.slice(0, end).join("")} ` : ""}[… ${chars.length - end} more characters]`;
 }
 function scalar(value) {
   if (value === undefined)
@@ -8779,10 +8798,11 @@ function compactJson(value) {
 function field(value, key) {
   return value !== null && typeof value === "object" && !Array.isArray(value) && Object.hasOwn(value, key) ? value[key] : undefined;
 }
-function render(nodes, root) {
+function render(nodes, root, legacyPreview) {
   return nodes.map((node) => {
     if (typeof node === "string")
       return node;
+    const cap = node.cap ?? (legacyPreview ? 300 : undefined);
     let value = root;
     let list = false;
     for (const step of node.steps) {
@@ -8796,19 +8816,19 @@ function render(nodes, root) {
       }
     }
     if (node.count)
-      return truncate(Array.isArray(value) ? String(value.length) : "", node.cap);
+      return truncate(Array.isArray(value) ? String(value.length) : "", cap, legacyPreview);
     if (node.each || list || node.join !== undefined) {
       if (!Array.isArray(value))
         return "";
-      const elements = value.slice(0, 10).map((item) => truncate(node.each ? render(node.each, item) : scalar(item), 300));
-      if (value.length > 10)
+      const elements = value.slice(0, legacyPreview ? 10 : undefined).map((item) => truncate(node.each ? render(node.each, item, legacyPreview) : scalar(item), legacyPreview ? 300 : undefined, legacyPreview));
+      if (legacyPreview && value.length > 10)
         elements.push(`… +${value.length - 10} more`);
-      return truncate(elements.join(node.join ?? (node.each ? "; " : ", ")), node.cap);
+      return truncate(elements.join(node.join ?? (node.each ? "; " : ", ")), cap, legacyPreview);
     }
-    return truncate(scalar(value), node.cap);
+    return truncate(scalar(value), cap, legacyPreview);
   }).join("");
 }
-function renderToolTemplate(source, input, output) {
+function renderToolTemplate(source, input, output, legacyPreview = false) {
   const nodes = compiled(source);
   if (!nodes)
     return null;
@@ -8823,8 +8843,8 @@ function renderToolTemplate(source, input, output) {
     }
   }
   const root = { input, output: structured };
-  const bareOutputNodes = nodes.map((node) => typeof node !== "string" && node.steps.length === 1 && ("field" in node.steps[0]) && node.steps[0].field === "output" && !node.each && !node.count && node.join === undefined ? truncate(text ?? "", node.cap) : node);
-  return truncate(render(bareOutputNodes, root), 1000);
+  const bareOutputNodes = nodes.map((node) => typeof node !== "string" && node.steps.length === 1 && ("field" in node.steps[0]) && node.steps[0].field === "output" && !node.each && !node.count && node.join === undefined ? truncate(text ?? "", node.cap ?? (legacyPreview ? 300 : undefined), legacyPreview) : node);
+  return truncate(render(bareOutputNodes, root, legacyPreview), legacyPreview ? 1000 : undefined, legacyPreview);
 }
 var templates;
 var init_historian_tool_template = __esm(() => {
@@ -9166,6 +9186,7 @@ var init_magic_context = __esm(() => {
     maxTokens: true
   });
   DreamerConfigSchema = AgentMetadataSchema.extend({
+    disable: boolean2().optional().describe("Disable this agent"),
     runner: _enum(["broca", "host"]).optional().describe(`Which side runs the dreamer completions the Rust module routes (classify-memories) in Rust transform mode: "host" runs them on this process's carrier, "broca" routes them to the Broca module. When unset, historian.runner applies, and when that is unset too the harness decides the same way it does for the historian. User-level config only.`),
     opencode: DreamerOpenCodeHarnessBlockSchema.optional(),
     pi: DreamerPiHarnessBlockSchema.optional(),
@@ -9181,7 +9202,7 @@ var init_magic_context = __esm(() => {
           ctx.addIssue({ code: "custom", message: error });
       }),
       literal(false)
-    ])).optional().describe('Readable historian tool expansions, keyed by exact host tool name. Templates override built-in defaults; false disables an expansion. Supports ${input.path}, ${output.path}, bare ${output}, array [N], [*].field, .each("${field}"), .join("separator"), .count and final .truncate(N). Missing fields are empty; placeholders default to 300 characters, lists to 10 elements, expansions to 1000 characters. Valid in user and project config; affects historian/recomp and verbose ctx_expand only, never the wire or default ctx_expand transcript.'),
+    ])).optional().describe('Readable historian tool expansions, keyed by exact host tool name. Templates override built-in defaults; false disables an expansion. Supports ${input.path}, ${output.path}, bare ${output}, array [N], [*].field, .each("${field}"), .join("separator"), .count and final .truncate(N). Missing fields are empty. Historian text and lists have no implicit caps; explicit .truncate(N) keeps complete sentences and marks omitted characters, or emits only the marker if no sentence fits. When the ctx_expand history-recovery tool is called in verbose mode, its tool-call previews retain their original built-in templates and limits (300 characters per placeholder, 10 list elements, 1000 characters per expansion). Valid in user and project config; never changes the wire or default ctx_expand transcript.'),
     opencode: OpenCodeHarnessBlockSchema.optional(),
     pi: PiHarnessBlockSchema.optional(),
     omp: OmpHarnessBlockSchema.optional(),
@@ -9325,7 +9346,11 @@ var init_magic_context = __esm(() => {
     }).catchall(number2().min(5000).max(2000000)).optional().describe("Absolute token thresholds per model. When matched, overrides execute_threshold_percentage for that model. Accepts `default` for all models or per-model keys. Values above 90% × context_limit are clamped with a warning log. Min 5_000, max 2_000_000."),
     protected_tokens: number2().int().min(PROTECTED_TOKENS_MIN).max(1e6).optional().describe("Positive integer token floor to protect from automatic reclaim (min: 4_000, max: 1_000_000). When omitted, the derived default is clamp(round(0.05 × usableSoft), min(16_000, round(0.08 × usableSoft)), 64_000)."),
     protected_tags: unknown().optional().describe("Deprecated: number of recent tags to protect. Ignored for behaviour; use protected_tokens instead.").meta({ deprecated: true }),
-    clear_reasoning_age: number2().min(10).default(50).describe("Clear reasoning/thinking blocks older than N tags (default: 50)"),
+    clear_reasoning_age: unknown().optional().describe("Deprecated and ignored. Use keep_reasoning_tokens instead.").meta({ deprecated: true }),
+    keep_reasoning_tokens: union([
+      number2().int().min(0).max(1e6),
+      object({ default: number2().int().min(0).max(1e6).optional() }).catchall(number2().int().min(0).max(1e6))
+    ]).optional().describe("Reasoning tokens to keep on rebuilding passes. Number or per-model object; exact, shorter model keys, provider/*, then default. Omitted: fixed 10,000. 0 removes all eligible historical reasoning; newest and exempt steps always stay."),
     history_budget_percentage: number2().min(0.05).max(0.5).default(DEFAULT_HISTORY_BUDGET_PERCENTAGE).describe("Fraction of usable context (context_limit × execute_threshold) reserved for the session history block (default: 0.15)"),
     historian_timeout_ms: number2().min(60000).default(DEFAULT_HISTORIAN_TIMEOUT_MS).describe("Timeout for each historian prompt call in both TypeScript and Rust transform modes, in milliseconds (default: 600000)"),
     commit_cluster_trigger: object({
@@ -9424,6 +9449,7 @@ var init_magic_context = __esm(() => {
     "commit_cluster_trigger.enabled",
     "commit_cluster_trigger.min_clusters",
     "memory.auto_promote",
+    "dreamer.disable",
     "dreamer.maxTokens",
     "dreamer.opencode.model",
     "dreamer.opencode.fallback_models",
@@ -10889,6 +10915,11 @@ function warnProtectedTagsDeprecationOnce() {
 function parsePluginConfig(rawConfig, recoveredTopLevelKeys = []) {
   const preMigrationWarnings = [];
   const configWithoutRemovedAgent = stripRemovedAgentConfig(rawConfig, preMigrationWarnings);
+  if (Object.hasOwn(rawConfig, "clear_reasoning_age")) {
+    const warning = "clear_reasoning_age is deprecated and ignored. Magic Context now keeps reasoning up to a token budget, keep_reasoning_tokens (default 10,000). Remove the key, or set keep_reasoning_tokens to a token count.";
+    preMigrationWarnings.push(warning);
+    log(`[magic-context] ${warning}`);
+  }
   if (Object.hasOwn(rawConfig, "protected_tags")) {
     warnProtectedTagsDeprecationOnce();
     preMigrationWarnings.push("protected_tags is deprecated and ignored; use protected_tokens instead.");
@@ -12820,9 +12851,12 @@ __export(exports_sqlite, {
   Database: () => Database,
   SqliteAcquisitionBusyError: () => SqliteAcquisitionBusyError,
   SqliteRuntimeUnavailableError: () => SqliteRuntimeUnavailableError,
+  assertTransformWrite: () => assertTransformWrite,
   beginSqliteWriterAsync: () => beginSqliteWriterAsync,
   detectSqliteRuntime: () => detectSqliteRuntime,
+  getSqliteDatabasePath: () => getSqliteDatabasePath,
   getSqliteMemoryStats: () => getSqliteMemoryStats,
+  guardSqliteTransformPass: () => guardSqliteTransformPass,
   isTransientSqliteError: () => isTransientSqliteError,
   loadSqliteModule: () => loadSqliteModule,
   prepareCachedStatement: () => prepareCachedStatement,
@@ -12883,6 +12917,8 @@ function installTransactionRouting(db, readonly) {
     configurable: true,
     writable: true,
     value: (sql) => {
+      if (/^\s*(?:COMMIT|END)\b/i.test(sql))
+        assertTransformWrite();
       if (/^\s*BEGIN\s+(?:IMMEDIATE|EXCLUSIVE)(?:\s+TRANSACTION)?\s*;?\s*$/i.test(sql)) {
         openWriterTransactions.delete(db);
         if (transformPassScope.getStore()?.active || backgroundWriterScope.getStore())
@@ -13012,6 +13048,14 @@ function buildNodeSqliteDatabaseClass(DatabaseSync) {
   }
   return NodeSqliteDatabase;
 }
+function getSqliteDatabasePath(db) {
+  for (const connection of trackedSqliteConnections.values()) {
+    if (connection.reference.deref() === db) {
+      return connection.filename === ":memory:" || connection.filename === "<buffer>" ? null : connection.filename;
+    }
+  }
+  return null;
+}
 function pragmaValue(db, name) {
   const row = db.prepare(`PRAGMA ${name}`).get();
   if (!row)
@@ -13164,6 +13208,15 @@ function withSqliteTransformPass(operation) {
 function withoutSqliteTransformPass(operation) {
   return transformPassScope.run(undefined, operation);
 }
+function guardSqliteTransformPass(guard) {
+  const lease = transformPassScope.getStore();
+  if (lease)
+    lease.guard = guard;
+}
+function assertTransformWrite() {
+  if (!backgroundWriterScope.getStore())
+    transformPassScope.getStore()?.guard?.assert();
+}
 function isTransientSqliteError(error) {
   if (!error || typeof error !== "object")
     return false;
@@ -13175,6 +13228,7 @@ function foregroundWaitLease() {
   return lease?.active && !admissionScope.getStore() && !backgroundWriterScope.getStore() ? lease : undefined;
 }
 function withAutocommitTimeout(db, operation) {
+  assertTransformWrite();
   const lease = foregroundWaitLease();
   if (isInTransaction(db) || !lease && !backgroundWriterScope.getStore())
     return operation();
@@ -13195,6 +13249,7 @@ function withAutocommitTimeout(db, operation) {
   }
 }
 function acquireShort(db, acquire, site) {
+  assertTransformWrite();
   const started = performance.now();
   const previous = pragmaNumber(db, "busy_timeout");
   const outer = writerAcquisitionScope.getStore();
@@ -13206,7 +13261,7 @@ function acquireShort(db, acquire, site) {
   let acquiredAt;
   try {
     const lease = foregroundWaitLease();
-    const timeout = lease ? Math.floor(lease.remainingWaitMs) : SHORT_BUSY_TIMEOUT_MS;
+    const timeout = Math.floor(Math.min(lease ? lease.remainingWaitMs : SHORT_BUSY_TIMEOUT_MS, owner?.remainingMs?.() ?? lease?.guard?.remainingMs() ?? Infinity));
     db.exec(`PRAGMA busy_timeout=${timeout}`);
     acquire();
     acquiredAt = performance.now();
@@ -13279,29 +13334,53 @@ async function beginSqliteWriterAsync(db, site) {
     }
   }
 }
-async function withAsyncPrivilegedWriter(db, operation) {
+async function withAsyncPrivilegedWriter(db, operation, options = {}) {
   const started = performance.now();
+  const budgetMs = Math.max(0, Math.min(FOREGROUND_ACQUISITION_BUDGET_MS, options.budgetMs ?? Infinity));
   let attempts = 0;
   for (;; ) {
+    options.signal?.throwIfAborted();
+    options.assertCurrentPass?.();
     attempts++;
+    let entered = false;
     try {
       const acquisition = {
         site: "privileged_writer",
         lane: "foreground",
         startedAt: started,
         attempts,
-        claimed: false
+        claimed: false,
+        remainingMs: () => Math.max(0, budgetMs - (performance.now() - started))
       };
-      return admissionScope.run(true, () => withSqliteTransformPass(() => writerAcquisitionScope.run(acquisition, () => withPrivilegedWriter(db, operation))));
+      return admissionScope.run(true, () => withSqliteTransformPass(() => writerAcquisitionScope.run(acquisition, () => withPrivilegedWriter(db, () => {
+        entered = true;
+        return operation();
+      }))));
     } catch (error) {
-      if (!(error instanceof SqliteAcquisitionBusyError))
+      if (entered || !(error instanceof SqliteAcquisitionBusyError))
         throw error;
+      options.beforeRetry?.(error);
       const elapsed = performance.now() - started;
-      if (elapsed >= FOREGROUND_ACQUISITION_BUDGET_MS) {
+      if (elapsed >= budgetMs) {
         reportSqliteDiagnostic(`sqlite writer site=privileged_writer lane=foreground acquire_ms=${Math.round(elapsed)} attempts=${attempts} outcome=busy`);
         throw error;
       }
-      await new Promise((resolve) => setTimeout(resolve, Math.min(attempts === 1 ? 500 : 1000, FOREGROUND_ACQUISITION_BUDGET_MS - elapsed)));
+      const backoff = attempts === 1 ? 500 : 1000;
+      const delay = Math.min(options.jitter ? backoff * (0.8 + Math.random() * 0.4) : backoff, budgetMs - elapsed);
+      await new Promise((resolve, reject) => {
+        const abort = () => {
+          clearTimeout(timer);
+          options.signal?.removeEventListener("abort", abort);
+          reject(options.signal?.reason ?? new Error("Writer wait aborted"));
+        };
+        const timer = setTimeout(() => {
+          options.signal?.removeEventListener("abort", abort);
+          resolve();
+        }, delay);
+        options.signal?.addEventListener("abort", abort, { once: true });
+        if (options.signal?.aborted)
+          abort();
+      });
     }
   }
 }
@@ -29798,6 +29877,24 @@ var init_storage_tags = __esm(() => {
 var historian_tool_defaults_default;
 var init_historian_tool_defaults = __esm(() => {
   historian_tool_defaults_default = {
+    ctx_note: "Note ${input.action} ${input.note_ids}: ${input.content} → ${output.truncate(160)}",
+    ctx_memory: "Memory ${input.action} ${input.category} ${input.ids}: ${input.content} → ${output.truncate(160)}",
+    todowrite: 'Todos (${input.todos.count}): ${input.todos.each("${status}: ${content}")}',
+    question: 'Asked user: ${input.questions[*].question.join(" / ")} → ${output}',
+    task: "Task ${input.subagent_type}: ${input.prompt.truncate(600)} → ${output.truncate(200)}",
+    ask: 'Asked: ${input.question} [options: ${input.options.join(" / ")}] ${input.text}${input.resolution} → ${output.truncate(300)}',
+    peer_send: "PM ${input.recipient}: ${input.message}",
+    board: 'Board ${input.verb}${input.board_lane}: ${input.ops.each("${op} ${lane_label} ${item}${props.text}${lane.items} ${state}${props.state}${lane.status}${id}${title}")}',
+    room: "Room ${input.action} ${input.room_label}: ${input.room_detail}",
+    work: "Work ${input.action} ${input.title}${input.id}: ${input.prompt.truncate(600)}${input.notes.truncate(600)} → ${output.truncate(160)}",
+    knowhow: "Looked up how-to: ${input.query}${input.id}"
+  };
+});
+
+// ../plugin/src/shared/historian-tool-preview-defaults.json
+var historian_tool_preview_defaults_default;
+var init_historian_tool_preview_defaults = __esm(() => {
+  historian_tool_preview_defaults_default = {
     ctx_note: "Note ${input.action} ${input.note_ids}: ${input.content} → ${output.truncate(160)}",
     ctx_memory: "Memory ${input.action} ${input.category} ${input.ids}: ${input.content} → ${output.truncate(160)}",
     todowrite: 'Todos (${input.todos.count}): ${input.todos.each("${status}: ${content}")}',
@@ -29813,20 +29910,52 @@ var init_historian_tool_defaults = __esm(() => {
 });
 
 // ../plugin/src/shared/historian-tool-expansions.ts
-function expandToolPart(part, overrides) {
+function builtinInput(tool, input) {
+  if (!input || typeof input !== "object")
+    return input;
+  const i = input;
+  if (tool === "peer_send") {
+    const external = i.external;
+    const recipient = i.reply_to_pmid ? `reply to ${i.reply_to_pmid}` : i.agent || i.agent_id ? `to ${i.agent || i.agent_id}` : external?.session_id || i.session_id ? `to session ${external?.session_id || i.session_id}` : "to unknown recipient";
+    return { ...i, recipient };
+  }
+  if (tool === "room") {
+    return {
+      ...i,
+      room_label: i.room_id || i.title,
+      room_detail: i.action === "create" || i.action === "invite" ? `invitees: ${renderToolTemplate("${input.invitees}", i)}` : i.text
+    };
+  }
+  if (tool === "board") {
+    return {
+      ...i,
+      board_lane: i.lane ? ` ${i.lane}` : "",
+      ops: Array.isArray(i.ops) ? i.ops.map((op) => op && typeof op === "object" ? {
+        ...op,
+        lane_label: typeof op.lane === "string" ? op.lane : op.lane?.title || op.lane?.id
+      } : op) : i.ops
+    };
+  }
+  return input;
+}
+function expandToolPart(part, overrides, legacyPreview = false) {
   if (!part || typeof part !== "object")
     return null;
   const p = part;
   if (p.type !== "tool" || typeof p.tool !== "string")
     return null;
-  const template = overrides && Object.hasOwn(overrides, p.tool) ? overrides[p.tool] : Object.hasOwn(historian_tool_defaults_default, p.tool) ? historian_tool_defaults_default[p.tool] : undefined;
+  const builtinDefaults = legacyPreview ? historian_tool_preview_defaults_default : historian_tool_defaults_default;
+  const overridden = overrides && Object.hasOwn(overrides, p.tool);
+  const template = overridden ? overrides[p.tool] : Object.hasOwn(builtinDefaults, p.tool) ? builtinDefaults[p.tool] : undefined;
   if (typeof template !== "string")
     return null;
   const state = p.state;
-  return renderToolTemplate(template, state?.input, state?.output ?? state?.error);
+  const input = overridden || legacyPreview ? state?.input : builtinInput(p.tool, state?.input);
+  return renderToolTemplate(template, input, state?.output ?? state?.error, legacyPreview);
 }
 var init_historian_tool_expansions = __esm(() => {
   init_historian_tool_defaults();
+  init_historian_tool_preview_defaults();
   init_historian_tool_template();
 });
 
@@ -30589,7 +30718,8 @@ var init_overflow_detection = __esm(() => {
   PREFIX_BOUND_THINKING_MODELS = [
     ["fable", 5, 1],
     ["opus", 5, 5],
-    ["sonnet", 5, 5]
+    ["sonnet", 5, 5],
+    ["haiku", 5, 5]
   ];
   PREFIX_BOUND_THINKING_PATTERN = new RegExp(`(?:^|[-_.:/])(?:${PREFIX_BOUND_THINKING_MODELS.map(([family, major, minor]) => `${family}[-_.]?${major}[-_.]${minor}`).join("|")})(?:$|[-_.:/@])`, "i");
 });
@@ -42622,6 +42752,9 @@ function mergeRawConfigs(base, override) {
 }
 function parsePiConfig(rawConfig, recoveredTopLevelKeys = []) {
   const preMigrationWarnings = [];
+  if (Object.hasOwn(rawConfig, "clear_reasoning_age")) {
+    preMigrationWarnings.push("clear_reasoning_age is deprecated and ignored. Magic Context now keeps reasoning up to a token budget, keep_reasoning_tokens (default 10,000). Remove the key, or set keep_reasoning_tokens to a token count.");
+  }
   const configWithoutRemovedAgent = stripRemovedAgentConfig(rawConfig, preMigrationWarnings);
   const hasDeprecatedProtectedTags = Object.hasOwn(rawConfig, "protected_tags");
   if (hasDeprecatedProtectedTags) {
@@ -46797,6 +46930,20 @@ function formatUnresolvedCompartmentSession(session) {
   return `session=${session.sessionId} unresolved=${session.count}`;
 }
 
+// src/commands/reasoning-config-migration.ts
+function removeDeprecatedReasoningAge(config) {
+  if (!Object.hasOwn(config, "clear_reasoning_age"))
+    return [];
+  const age = config.clear_reasoning_age;
+  delete config.clear_reasoning_age;
+  const messages = [
+    "Removed deprecated clear_reasoning_age (reasoning is now kept up to a token budget, keep_reasoning_tokens, default 10,000)."
+  ];
+  if (typeof age === "number" && age < 50)
+    messages.push("You had set a lower age to keep less reasoning; set keep_reasoning_tokens (for example 8000) to keep less than the default.");
+  return messages;
+}
+
 // src/commands/doctor-opencode.ts
 import { spawnSync as spawnSync10 } from "node:child_process";
 import { existsSync as existsSync45, mkdtempSync as mkdtempSync3, readFileSync as readFileSync28, rmSync as rmSync8 } from "node:fs";
@@ -47613,6 +47760,13 @@ async function runDoctor2(options = {}) {
         log3.success("Removed deprecated compaction_markers (always-on since v0.21.4)");
         fixed++;
       }
+      const reasoningMessages = removeDeprecatedReasoningAge(mcConfig);
+      if (reasoningMessages.length > 0) {
+        mcChanged = true;
+        fixed++;
+        for (const message of reasoningMessages)
+          log3.success(message);
+      }
       for (const deadKey of ["auto_drop_tool_age", "drop_tool_structure"]) {
         if (deadKey in mcConfig) {
           delete mcConfig[deadKey];
@@ -49124,7 +49278,8 @@ async function runHealthChecks2(options) {
   const repairPlan = {
     addPackageEntry: false,
     writeUserConfig: false,
-    clearCachePaths: []
+    clearCachePaths: [],
+    reasoningAgeConfigPaths: []
   };
   const self = options.deps.selfVersion();
   const pi = options.deps.detectPiBinary();
@@ -49195,6 +49350,10 @@ async function runHealthChecks2(options) {
       continue;
     }
     const parsed = readMagicContextJsonc(path, label);
+    if (!parsed.error && Object.hasOwn(parsed.value, "clear_reasoning_age")) {
+      repairPlan.reasoningAgeConfigPaths.push(path);
+      add2(results, "warn", `${label} clear_reasoning_age is deprecated and ignored; doctor removes it`);
+    }
     if (parsed.error)
       add2(results, "fail", `${label} magic-context.jsonc is invalid JSONC: ${parsed.error}`);
     else
@@ -49450,6 +49609,21 @@ function writeDefaultMagicContextConfig(path) {
 }
 function repair2(plan, prompts) {
   let fixed = 0;
+  for (const path of plan.reasoningAgeConfigPaths) {
+    const content = readFileSync30(path, "utf8");
+    const parsed = readJsonc2(path);
+    if (parsed.error)
+      continue;
+    const messages = removeDeprecatedReasoningAge(parsed.value);
+    if (messages.length === 0)
+      continue;
+    writeFileAtomic(path, removeJsoncValue(content, ["clear_reasoning_age"]), {
+      ownerOnly: true
+    });
+    for (const message of messages)
+      prompts.log.success(message);
+    fixed++;
+  }
   if (plan.addPackageEntry) {
     const settingsPath = getPiUserExtensionsPath();
     try {
@@ -49676,6 +49850,7 @@ var init_doctor_pi = __esm(async () => {
   init_tick_failure();
   init_embedding_synapse();
   init_data_path();
+  init_jsonc_edit();
   init_jsonc_parser();
   init_config2();
   init_model_chain_health();

package/package.json

@@ -1,6 +1,6 @@
 {
     "name": "@cortexkit/magic-context",
-    "version": "0.46.0",
+    "version": "0.47.0",
     "description": "Unified CLI for Magic Context — setup, doctor, and migration across OpenCode, Pi, and OMP",
     "keywords": [
         "opencode",