@cortexkit/opencode-magic-context 0.14.1 → 0.14.2

package/dist/cli/diagnostics.d.ts

@@ -37,12 +37,45 @@ export interface DiagnosticReport {
     historianDumps: {
         dir: string;
         count: number;
-        recent: {
-            name: string;
-            ageMinutes: number;
-            sizeKb: number;
-        }[];
+        recent: HistorianDumpSummary[];
     };
+    /** Most recent historian-failure rows from session_meta across all sessions. */
+    historianFailures: HistorianFailureSummary[];
+}
+export interface HistorianDumpSummary {
+    name: string;
+    ageMinutes: number;
+    sizeKb: number;
+    /** Parsed metadata — only structural fields, never raw XML content. */
+    meta?: HistorianDumpMeta;
+    /** If the XML could not be parsed, reason for failure. */
+    parseError?: string;
+}
+export interface HistorianDumpMeta {
+    /** Number of <compartment> elements found. */
+    compartmentCount: number;
+    /** Smallest start ordinal across compartments, or null if none. */
+    minStart: number | null;
+    /** Largest end ordinal across compartments, or null if none. */
+    maxEnd: number | null;
+    /** Value of <unprocessed_from> tag, if present. */
+    unprocessedFrom: number | null;
+    /** Number of <fact> items grouped by category. */
+    factCountByCategory: Record<string, number>;
+    /** Number of <user_observations> items. */
+    userObservationCount: number;
+    /** Total number of compartment ordinal gaps (missing ranges between consecutive compartments). */
+    ordinalGapCount: number;
+    /** Total number of overlapping compartment ranges. */
+    ordinalOverlapCount: number;
+}
+export interface HistorianFailureSummary {
+    sessionId: string;
+    failureCount: number;
+    /** Sanitized truncated last-error text. May be empty if never set. */
+    lastError: string;
+    /** ISO timestamp of last failure, or empty if never failed. */
+    lastFailureAt: string;
 }
 export declare function collectDiagnostics(): Promise<DiagnosticReport>;
 export declare function renderDiagnosticsMarkdown(report: DiagnosticReport): string;

package/dist/cli/diagnostics.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"diagnostics.d.ts","sourceRoot":"","sources":["../../src/cli/diagnostics.ts"],"names":[],"mappings":"AAMA,OAAO,EAAE,KAAK,WAAW,EAAqB,MAAM,gBAAgB,CAAC;AAMrE,MAAM,WAAW,gBAAgB;IAC7B,SAAS,EAAE,MAAM,CAAC;IAClB,QAAQ,EAAE,MAAM,CAAC;IACjB,IAAI,EAAE,MAAM,CAAC;IACb,WAAW,EAAE,MAAM,CAAC;IACpB,aAAa,EAAE,MAAM,CAAC;IACtB,iBAAiB,EAAE,OAAO,CAAC;IAC3B,eAAe,EAAE,MAAM,GAAG,IAAI,CAAC;IAC/B,WAAW,EAAE,WAAW,CAAC;IACzB,uBAAuB,EAAE,OAAO,CAAC;IACjC,kBAAkB,EAAE,OAAO,CAAC;IAC5B,kBAAkB,EAAE;QAChB,MAAM,EAAE,OAAO,CAAC;QAChB,UAAU,CAAC,EAAE,MAAM,CAAC;QACpB,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;KAClC,CAAC;IACF,WAAW,EAAE;QACT,IAAI,EAAE,MAAM,CAAC;QACb,MAAM,CAAC,EAAE,MAAM,CAAC;QAChB,MAAM,CAAC,EAAE,MAAM,CAAC;KACnB,CAAC;IACF,UAAU,EAAE;QACR,IAAI,EAAE,MAAM,CAAC;QACb,MAAM,EAAE,OAAO,CAAC;QAChB,kBAAkB,EAAE,MAAM,CAAC;KAC9B,CAAC;IACF,SAAS,EAAE;QACP,WAAW,EAAE,OAAO,CAAC;QACrB,OAAO,EAAE,MAAM,EAAE,CAAC;KACrB,CAAC;IACF,OAAO,EAAE;QACL,IAAI,EAAE,MAAM,CAAC;QACb,MAAM,EAAE,OAAO,CAAC;QAChB,MAAM,EAAE,MAAM,CAAC;KAClB,CAAC;IACF,cAAc,EAAE;QACZ,GAAG,EAAE,MAAM,CAAC;QACZ,KAAK,EAAE,MAAM,CAAC;QACd,MAAM,EAAE;YAAE,IAAI,EAAE,MAAM,CAAC;YAAC,UAAU,EAAE,MAAM,CAAC;YAAC,MAAM,EAAE,MAAM,CAAA;SAAE,EAAE,CAAC;KAClE,CAAC;CACL;AAgKD,wBAAsB,kBAAkB,IAAI,OAAO,CAAC,gBAAgB,CAAC,CA+CpE;AASD,wBAAgB,yBAAyB,CAAC,MAAM,EAAE,gBAAgB,GAAG,MAAM,CAwE1E"}
+{"version":3,"file":"diagnostics.d.ts","sourceRoot":"","sources":["../../src/cli/diagnostics.ts"],"names":[],"mappings":"AAQA,OAAO,EAAE,KAAK,WAAW,EAAqB,MAAM,gBAAgB,CAAC;AAMrE,MAAM,WAAW,gBAAgB;IAC7B,SAAS,EAAE,MAAM,CAAC;IAClB,QAAQ,EAAE,MAAM,CAAC;IACjB,IAAI,EAAE,MAAM,CAAC;IACb,WAAW,EAAE,MAAM,CAAC;IACpB,aAAa,EAAE,MAAM,CAAC;IACtB,iBAAiB,EAAE,OAAO,CAAC;IAC3B,eAAe,EAAE,MAAM,GAAG,IAAI,CAAC;IAC/B,WAAW,EAAE,WAAW,CAAC;IACzB,uBAAuB,EAAE,OAAO,CAAC;IACjC,kBAAkB,EAAE,OAAO,CAAC;IAC5B,kBAAkB,EAAE;QAChB,MAAM,EAAE,OAAO,CAAC;QAChB,UAAU,CAAC,EAAE,MAAM,CAAC;QACpB,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;KAClC,CAAC;IACF,WAAW,EAAE;QACT,IAAI,EAAE,MAAM,CAAC;QACb,MAAM,CAAC,EAAE,MAAM,CAAC;QAChB,MAAM,CAAC,EAAE,MAAM,CAAC;KACnB,CAAC;IACF,UAAU,EAAE;QACR,IAAI,EAAE,MAAM,CAAC;QACb,MAAM,EAAE,OAAO,CAAC;QAChB,kBAAkB,EAAE,MAAM,CAAC;KAC9B,CAAC;IACF,SAAS,EAAE;QACP,WAAW,EAAE,OAAO,CAAC;QACrB,OAAO,EAAE,MAAM,EAAE,CAAC;KACrB,CAAC;IACF,OAAO,EAAE;QACL,IAAI,EAAE,MAAM,CAAC;QACb,MAAM,EAAE,OAAO,CAAC;QAChB,MAAM,EAAE,MAAM,CAAC;KAClB,CAAC;IACF,cAAc,EAAE;QACZ,GAAG,EAAE,MAAM,CAAC;QACZ,KAAK,EAAE,MAAM,CAAC;QACd,MAAM,EAAE,oBAAoB,EAAE,CAAC;KAClC,CAAC;IACF,gFAAgF;IAChF,iBAAiB,EAAE,uBAAuB,EAAE,CAAC;CAChD;AAED,MAAM,WAAW,oBAAoB;IACjC,IAAI,EAAE,MAAM,CAAC;IACb,UAAU,EAAE,MAAM,CAAC;IACnB,MAAM,EAAE,MAAM,CAAC;IACf,uEAAuE;IACvE,IAAI,CAAC,EAAE,iBAAiB,CAAC;IACzB,0DAA0D;IAC1D,UAAU,CAAC,EAAE,MAAM,CAAC;CACvB;AAED,MAAM,WAAW,iBAAiB;IAC9B,8CAA8C;IAC9C,gBAAgB,EAAE,MAAM,CAAC;IACzB,mEAAmE;IACnE,QAAQ,EAAE,MAAM,GAAG,IAAI,CAAC;IACxB,gEAAgE;IAChE,MAAM,EAAE,MAAM,GAAG,IAAI,CAAC;IACtB,mDAAmD;IACnD,eAAe,EAAE,MAAM,GAAG,IAAI,CAAC;IAC/B,kDAAkD;IAClD,mBAAmB,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAC5C,2CAA2C;IAC3C,oBAAoB,EAAE,MAAM,CAAC;IAC7B,kGAAkG;IAClG,eAAe,EAAE,MAAM,CAAC;IACxB,sDAAsD;IACtD,mBAAmB,EAAE,MAAM,CAAC;CAC/B;AAED,MAAM,WAAW,uBAAuB;IACpC,SAAS,EAAE,MAAM,CAAC;IAClB,YAAY,EAAE,MAAM,CAAC;IACrB,sEAAsE;IACtE,SAAS,EAAE,MAAM,CAAC;IAClB,+DAA+D;IAC/D,aAAa,EAAE,MAAM,CAAC;CACzB;AA+OD,wBAAsB,kBAAkB,IAAI,OAAO,CAAC,gBAAgB,CAAC,CAgDpE;AASD,wBAAgB,yBAAyB,CAAC,MAAM,EAAE,gBAAgB,GAAG,MAAM,CA8E1E"}

package/dist/cli/logs.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"logs.d.ts","sourceRoot":"","sources":["../../src/cli/logs.ts"],"names":[],"mappings":"AAGA,OAAO,EAAE,KAAK,gBAAgB,EAA6B,MAAM,eAAe,CAAC;AAMjF;;;GAGG;AACH,wBAAgB,kBAAkB,CAAC,OAAO,EAAE,MAAM,GAAG,MAAM,CAe1D;AAeD,MAAM,WAAW,kBAAkB;IAC/B,IAAI,EAAE,MAAM,CAAC;IACb,YAAY,EAAE,MAAM,CAAC;CACxB;AAED,wBAAsB,iBAAiB,CACnC,MAAM,EAAE,gBAAgB,EACxB,WAAW,EAAE,MAAM,EACnB,MAAM,EAAE,MAAM,GACf,OAAO,CAAC,kBAAkB,CAAC,CAsC7B"}
+{"version":3,"file":"logs.d.ts","sourceRoot":"","sources":["../../src/cli/logs.ts"],"names":[],"mappings":"AAGA,OAAO,EAAE,KAAK,gBAAgB,EAA6B,MAAM,eAAe,CAAC;AAMjF;;;GAGG;AACH,wBAAgB,kBAAkB,CAAC,OAAO,EAAE,MAAM,GAAG,MAAM,CAe1D;AAeD,MAAM,WAAW,kBAAkB;IAC/B,IAAI,EAAE,MAAM,CAAC;IACb,YAAY,EAAE,MAAM,CAAC;CACxB;AA0CD,wBAAsB,iBAAiB,CACnC,MAAM,EAAE,gBAAgB,EACxB,WAAW,EAAE,MAAM,EACnB,MAAM,EAAE,MAAM,GACf,OAAO,CAAC,kBAAkB,CAAC,CAkD7B"}

package/dist/cli.js

@@ -8656,11 +8656,59 @@ function detectConfigPaths() {
 
 // src/cli/diagnostics.ts
 var import_comment_json2 = __toESM(require_src2(), 1);
+import { Database } from "bun:sqlite";
 import { existsSync as existsSync6, readdirSync, readFileSync as readFileSync4, statSync } from "node:fs";
 import { createRequire as createRequire2 } from "node:module";
 import { homedir as homedir4, tmpdir as tmpdir2, userInfo } from "node:os";
 import { join as join7 } from "node:path";
 
+// src/hooks/magic-context/compartment-parser.ts
+var COMPARTMENT_REGEX = /<compartment\s+(?:id="[^"]*"\s+)?start="(\d+)"\s+end="(\d+)"\s+title="([^"]+)"\s*>(.*?)<\/compartment>/gs;
+var CATEGORY_BLOCK_REGEX = /<(WORKFLOW_RULES|ARCHITECTURE_DECISIONS|CONSTRAINTS|CONFIG_DEFAULTS|KNOWN_ISSUES|ENVIRONMENT|NAMING|USER_PREFERENCES|USER_DIRECTIVES)>(.*?)<\/\1>/gs;
+var FACT_ITEM_REGEX = /^\s*\*\s*(.+)$/gm;
+var UNPROCESSED_REGEX = /<unprocessed_from>(\d+)<\/unprocessed_from>/;
+var USER_OBSERVATIONS_REGEX = /<user_observations>(.*?)<\/user_observations>/s;
+var USER_OBS_ITEM_REGEX = /^\s*\*\s*(.+)$/gm;
+function parseCompartmentOutput(text) {
+  const compartments = [];
+  const facts = [];
+  for (const match of text.matchAll(COMPARTMENT_REGEX)) {
+    const startMessage = parseInt(match[1], 10);
+    const endMessage = parseInt(match[2], 10);
+    const title = unescapeXml(match[3]);
+    const content = unescapeXml(match[4].trim());
+    if (!Number.isNaN(startMessage) && !Number.isNaN(endMessage) && title && content) {
+      compartments.push({ startMessage, endMessage, title, content });
+    }
+  }
+  for (const categoryMatch of text.matchAll(CATEGORY_BLOCK_REGEX)) {
+    const category = categoryMatch[1];
+    const blockContent = categoryMatch[2];
+    for (const itemMatch of blockContent.matchAll(FACT_ITEM_REGEX)) {
+      const content = unescapeXml(itemMatch[1].trim());
+      if (content) {
+        facts.push({ category, content });
+      }
+    }
+  }
+  const unprocessedMatch = text.match(UNPROCESSED_REGEX);
+  const unprocessedFrom = unprocessedMatch ? parseInt(unprocessedMatch[1], 10) : null;
+  const userObservations = [];
+  const userObsMatch = text.match(USER_OBSERVATIONS_REGEX);
+  if (userObsMatch) {
+    for (const itemMatch of userObsMatch[1].matchAll(USER_OBS_ITEM_REGEX)) {
+      const obs = unescapeXml(itemMatch[1].trim());
+      if (obs)
+        userObservations.push(obs);
+    }
+  }
+  compartments.sort((a, b) => a.startMessage - b.startMessage);
+  return { compartments, facts, unprocessedFrom, userObservations };
+}
+function unescapeXml(s) {
+  return s.replace(/&amp;/g, "&").replace(/&apos;/g, "'").replace(/&quot;/g, '"').replace(/&lt;/g, "<").replace(/&gt;/g, ">");
+}
+
 // src/cli/opencode-helpers.ts
 import { execSync } from "node:child_process";
 function isOpenCodeInstalled() {
@@ -8840,6 +8888,40 @@ function configHasPluginEntry(config) {
     return false;
   });
 }
+function parseHistorianDumpMeta(path2) {
+  try {
+    const xml = readFileSync4(path2, "utf-8");
+    const parsed = parseCompartmentOutput(xml);
+    const factCountByCategory = {};
+    for (const fact of parsed.facts) {
+      factCountByCategory[fact.category] = (factCountByCategory[fact.category] ?? 0) + 1;
+    }
+    const starts = parsed.compartments.map((c) => c.startMessage);
+    const ends = parsed.compartments.map((c) => c.endMessage);
+    let gaps = 0;
+    let overlaps = 0;
+    for (let i = 1;i < parsed.compartments.length; i++) {
+      const prev = parsed.compartments[i - 1];
+      const curr = parsed.compartments[i];
+      if (curr.startMessage > prev.endMessage + 1)
+        gaps += 1;
+      else if (curr.startMessage <= prev.endMessage)
+        overlaps += 1;
+    }
+    return {
+      compartmentCount: parsed.compartments.length,
+      minStart: starts.length > 0 ? Math.min(...starts) : null,
+      maxEnd: ends.length > 0 ? Math.max(...ends) : null,
+      unprocessedFrom: parsed.unprocessedFrom,
+      factCountByCategory,
+      userObservationCount: parsed.userObservations.length,
+      ordinalGapCount: gaps,
+      ordinalOverlapCount: overlaps
+    };
+  } catch (error) {
+    return { error: error instanceof Error ? error.message : String(error) };
+  }
+}
 function collectHistorianDumps() {
   const dir = join7(tmpdir2(), "magic-context-historian");
   if (!existsSync6(dir)) {
@@ -8855,16 +8937,49 @@ function collectHistorianDumps() {
       };
     }).sort((a, b) => b.mtime - a.mtime);
     const now = Date.now();
-    const recent = entries.slice(0, 3).map((entry) => ({
-      name: entry.name,
-      ageMinutes: Math.round((now - entry.mtime) / 60000),
-      sizeKb: entry.sizeKb
-    }));
+    const recent = entries.slice(0, 5).map((entry) => {
+      const meta = parseHistorianDumpMeta(join7(dir, entry.name));
+      const summary = {
+        name: entry.name,
+        ageMinutes: Math.round((now - entry.mtime) / 60000),
+        sizeKb: entry.sizeKb
+      };
+      if ("error" in meta) {
+        summary.parseError = meta.error;
+      } else {
+        summary.meta = meta;
+      }
+      return summary;
+    });
     return { dir, count: entries.length, recent };
   } catch {
     return { dir, count: 0, recent: [] };
   }
 }
+function collectHistorianFailures(storageDirPath) {
+  const contextDbPath = join7(storageDirPath, "context.db");
+  if (!existsSync6(contextDbPath))
+    return [];
+  let db = null;
+  try {
+    db = new Database(contextDbPath, { readonly: true });
+    const rows = db.prepare("SELECT session_id, historian_failure_count, historian_last_error, historian_last_failure_at FROM session_meta WHERE historian_failure_count > 0 ORDER BY historian_last_failure_at DESC LIMIT 10").all();
+    return rows.map((row) => {
+      const sessionId = typeof row.session_id === "string" ? row.session_id : "<unknown>";
+      const failureCount = typeof row.historian_failure_count === "number" ? row.historian_failure_count : 0;
+      const rawError = typeof row.historian_last_error === "string" ? row.historian_last_error : "";
+      const lastAt = typeof row.historian_last_failure_at === "number" ? new Date(row.historian_last_failure_at).toISOString() : "";
+      const lastError = sanitizeString(rawError.replace(/\s+/g, " ").trim().slice(0, 400));
+      return { sessionId, failureCount, lastError, lastFailureAt: lastAt };
+    });
+  } catch {
+    return [];
+  } finally {
+    try {
+      db?.close();
+    } catch {}
+  }
+}
 async function collectDiagnostics() {
   const pluginVersion = getSelfVersion();
   const configPaths = detectConfigPaths();
@@ -8907,7 +9022,8 @@ async function collectDiagnostics() {
       exists: existsSync6(logPath),
       sizeKb: Math.round(logFileSize / 1024)
     },
-    historianDumps: collectHistorianDumps()
+    historianDumps: collectHistorianDumps(),
+    historianFailures: collectHistorianFailures(storageDirPath)
   };
 }
 function formatBytes(bytes) {
@@ -8976,9 +9092,14 @@ function renderDiagnosticsMarkdown(report) {
     "```",
     "",
     "### Historian dumps",
+    "(Metadata only — XML content is not included in this report.)",
     "```json",
     JSON.stringify(historianDumps, null, 2),
     "```",
+    "",
+    "### Historian failures (session_meta)",
+    report.historianFailures.length === 0 ? "_No sessions with historian failures._" : ["```json", JSON.stringify(report.historianFailures, null, 2), "```"].join(`
+`),
     "",
     "### Log file",
     `- Path: ${sanitizeString(report.logFile.path)}`,
@@ -9022,11 +9143,36 @@ function formatTimestamp(date) {
     pad(date.getSeconds())
   ].join("");
 }
+var HISTORIAN_LOG_PATTERNS = [
+  /historian failure:/,
+  /historian failure recorded:/,
+  /historian prompt failed:/,
+  /## Historian alert/,
+  /historian alert suppressed/,
+  /EMERGENCY: aborting session/,
+  /historian: prompt attempt \d+ failed:/
+];
+function isHistorianLogLine(line) {
+  return HISTORIAN_LOG_PATTERNS.some((rx) => rx.test(line));
+}
+function extractHistorianFailureLines(sanitized, limit = 30) {
+  const matches = [];
+  const lines = sanitized.split(/\r?\n/);
+  for (let i = lines.length - 1;i >= 0 && matches.length < limit; i -= 1) {
+    if (isHistorianLogLine(lines[i])) {
+      matches.push(lines[i]);
+    }
+  }
+  return matches.reverse();
+}
 async function bundleIssueReport(report, description, _title) {
-  const LOG_TAIL_LINES = 200;
+  const LOG_TAIL_LINES = 400;
   const logLines = report.logFile.exists ? readFileSync5(report.logFile.path, "utf-8").split(/\r?\n/) : [];
   const recentLog = sanitizeLogContent(logLines.slice(-LOG_TAIL_LINES).join(`
 `)).trim();
+  const historianScanWindow = sanitizeLogContent(logLines.slice(-4000).join(`
+`));
+  const historianFailureLines = extractHistorianFailureLines(historianScanWindow, 30);
   const configBody = JSON.stringify(report.magicContextConfig.flags, null, 2);
   const sanitizedConfigPath = report.configPaths.magicContextConfig.replace(homedir5(), "~");
   const bodyMarkdown = [
@@ -9047,6 +9193,11 @@ async function bundleIssueReport(report, description, _title) {
     "",
     "## Diagnostics",
     renderDiagnosticsMarkdown(report),
+    "",
+    "## Historian failure signals (log, sanitized)",
+    historianFailureLines.length === 0 ? "_No historian failure log lines found in recent history._" : ["```", historianFailureLines.join(`
+`), "```"].join(`
+`),
     "",
     `## Log (last ${LOG_TAIL_LINES} lines, sanitized)`,
     "```",

package/dist/features/magic-context/storage-meta-persisted.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"storage-meta-persisted.d.ts","sourceRoot":"","sources":["../../../src/features/magic-context/storage-meta-persisted.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"storage-meta-persisted.d.ts","sourceRoot":"","sources":["../../../src/features/magic-context/storage-meta-persisted.ts"],"names":[],"mappings":"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"}

package/dist/hooks/magic-context/compartment-runner-incremental.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"compartment-runner-incremental.d.ts","sourceRoot":"","sources":["../../../src/hooks/magic-context/compartment-runner-incremental.ts"],"names":[],"mappings":"AAyBA,OAAO,KAAK,EAAE,qBAAqB,EAAE,MAAM,4BAA4B,CAAC;AAoBxE,+DAA+D;AAC/D,wBAAgB,wBAAwB,CAAC,SAAS,EAAE,MAAM,GAAG,IAAI,CAEhE;AAED,wBAAsB,mBAAmB,CAAC,IAAI,EAAE,qBAAqB,GAAG,OAAO,CAAC,IAAI,CAAC,CA0OpF"}
+{"version":3,"file":"compartment-runner-incremental.d.ts","sourceRoot":"","sources":["../../../src/hooks/magic-context/compartment-runner-incremental.ts"],"names":[],"mappings":"AAyBA,OAAO,KAAK,EAAE,qBAAqB,EAAE,MAAM,4BAA4B,CAAC;AAoBxE,+DAA+D;AAC/D,wBAAgB,wBAAwB,CAAC,SAAS,EAAE,MAAM,GAAG,IAAI,CAEhE;AAED,wBAAsB,mBAAmB,CAAC,IAAI,EAAE,qBAAqB,GAAG,OAAO,CAAC,IAAI,CAAC,CAoQpF"}

package/dist/hooks/magic-context/nudger.d.ts

@@ -1,4 +1,4 @@
-import { getOrCreateSessionMeta, getTopNBySize } from "../../features/magic-context/storage";
+import { getOrCreateSessionMeta, type getTopNBySize } from "../../features/magic-context/storage";
 import type { ContextUsage, SessionMeta, TagEntry } from "../../features/magic-context/types";
 type ContextDatabase = Parameters<typeof getOrCreateSessionMeta>[0];
 export type ContextNudge = {

package/dist/hooks/magic-context/nudger.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"nudger.d.ts","sourceRoot":"","sources":["../../../src/hooks/magic-context/nudger.ts"],"names":[],"mappings":"AAAA,OAAO,EACH,sBAAsB,EAGtB,aAAa,EAEhB,MAAM,sCAAsC,CAAC;AAC9C,OAAO,KAAK,EAAE,YAAY,EAAE,WAAW,EAAE,QAAQ,EAAE,MAAM,oCAAoC,CAAC;AAY9F,KAAK,eAAe,GAAG,UAAU,CAAC,OAAO,sBAAsB,CAAC,CAAC,CAAC,CAAC,CAAC;AACpE,MAAM,MAAM,YAAY,GAAG;IAAE,IAAI,EAAE,WAAW,CAAC;IAAC,IAAI,EAAE,MAAM,CAAA;CAAE,CAAC;AAC/D,eAAO,MAAM,2BAA2B,QAAgB,CAAC;AA+BzD,wBAAgB,YAAY,CAAC,MAAM,EAAE;IACjC,cAAc,EAAE,MAAM,CAAC;IACvB,qBAAqB,EAAE,MAAM,CAAC;IAC9B,yBAAyB,EAAE,MAAM,CAAC;IAClC,4BAA4B,EAAE,MAAM,GAAG;QAAE,OAAO,EAAE,MAAM,CAAC;QAAC,CAAC,QAAQ,EAAE,MAAM,GAAG,MAAM,CAAA;KAAE,CAAC;IACvF,GAAG,CAAC,EAAE,MAAM,MAAM,CAAC;IACnB,qBAAqB,CAAC,EAAE,GAAG,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;CAC/C,IAIO,WAAW,MAAM,EACjB,cAAc,YAAY,EAC1B,IAAI,eAAe,EACnB,QAAQ,OAAO,aAAa,EAC5B,gBAAgB,QAAQ,EAAE,EAC1B,wBAAwB,MAAM,EAC9B,uBAAuB,WAAW,KACnC,YAAY,GAAG,IAAI,CAyIzB"}
+{"version":3,"file":"nudger.d.ts","sourceRoot":"","sources":["../../../src/hooks/magic-context/nudger.ts"],"names":[],"mappings":"AAAA,OAAO,EACH,sBAAsB,EAGtB,KAAK,aAAa,EAErB,MAAM,sCAAsC,CAAC;AAC9C,OAAO,KAAK,EAAE,YAAY,EAAE,WAAW,EAAE,QAAQ,EAAE,MAAM,oCAAoC,CAAC;AAY9F,KAAK,eAAe,GAAG,UAAU,CAAC,OAAO,sBAAsB,CAAC,CAAC,CAAC,CAAC,CAAC;AACpE,MAAM,MAAM,YAAY,GAAG;IAAE,IAAI,EAAE,WAAW,CAAC;IAAC,IAAI,EAAE,MAAM,CAAA;CAAE,CAAC;AAC/D,eAAO,MAAM,2BAA2B,QAAgB,CAAC;AA+BzD,wBAAgB,YAAY,CAAC,MAAM,EAAE;IACjC,cAAc,EAAE,MAAM,CAAC;IACvB,qBAAqB,EAAE,MAAM,CAAC;IAC9B,yBAAyB,EAAE,MAAM,CAAC;IAClC,4BAA4B,EAAE,MAAM,GAAG;QAAE,OAAO,EAAE,MAAM,CAAC;QAAC,CAAC,QAAQ,EAAE,MAAM,GAAG,MAAM,CAAA;KAAE,CAAC;IACvF,GAAG,CAAC,EAAE,MAAM,MAAM,CAAC;IACnB,qBAAqB,CAAC,EAAE,GAAG,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;CAC/C,IAIO,WAAW,MAAM,EACjB,cAAc,YAAY,EAC1B,IAAI,eAAe,EACnB,QAAQ,OAAO,aAAa,EAC5B,gBAAgB,QAAQ,EAAE,EAC1B,wBAAwB,MAAM,EAC9B,uBAAuB,WAAW,KACnC,YAAY,GAAG,IAAI,CAyIzB"}

package/dist/index.js

@@ -15615,6 +15615,77 @@ var init_data_path = () => {};
 function getErrorMessage(error48) {
   return error48 instanceof Error ? error48.message : String(error48);
 }
+function readString(value) {
+  if (typeof value === "string" && value.length > 0)
+    return value;
+  if (typeof value === "number")
+    return String(value);
+  return;
+}
+function clip(value, max) {
+  if (value.length <= max)
+    return value;
+  return `${value.slice(0, max)}\u2026`;
+}
+function describeError(error48) {
+  const stringForm = clip(safeString(error48), 400);
+  if (!(error48 instanceof Error) && !(error48 && typeof error48 === "object")) {
+    return {
+      name: typeof error48,
+      message: "",
+      stringForm,
+      brief: stringForm || "<empty>"
+    };
+  }
+  const obj = error48;
+  const nameFromField = readString(obj.name);
+  const nameFromCtor = error48?.constructor?.name;
+  const name = nameFromField ?? nameFromCtor ?? "Error";
+  const message = readString(obj.message) ?? "";
+  const status = readString(obj.status) ?? readString(obj.statusCode);
+  const code = readString(obj.code);
+  let causeName;
+  const cause = obj.cause;
+  if (cause && typeof cause === "object") {
+    const causeRecord = cause;
+    causeName = readString(causeRecord.name) ?? cause.constructor?.name;
+  }
+  const stack = readString(obj.stack);
+  const stackHead = stack ? stack.split(`
+`).slice(0, 4).map((l) => l.trim()).filter((l) => l.length > 0).join(" | ") : undefined;
+  const briefParts = [];
+  if (name)
+    briefParts.push(name);
+  if (message)
+    briefParts.push(`message="${clip(message, 200)}"`);
+  if (status)
+    briefParts.push(`status=${status}`);
+  if (code)
+    briefParts.push(`code=${code}`);
+  if (causeName)
+    briefParts.push(`cause=${causeName}`);
+  if (!message && stringForm && stringForm !== name) {
+    briefParts.push(`str="${clip(stringForm, 200)}"`);
+  }
+  const brief = briefParts.join(" ") || stringForm || name;
+  return {
+    name,
+    message,
+    ...status ? { status } : {},
+    ...code ? { code } : {},
+    ...causeName ? { causeName } : {},
+    ...stackHead ? { stackHead } : {},
+    stringForm,
+    brief
+  };
+}
+function safeString(value) {
+  try {
+    return String(value);
+  } catch {
+    return "<unstringifiable>";
+  }
+}
 
 // src/features/magic-context/memory/storage-memory-embeddings.ts
 function isEmbeddingBlob(value) {
@@ -151183,7 +151254,10 @@ function incrementHistorianFailure(db, sessionId, error48) {
   db.transaction(() => {
     ensureSessionMetaRow(db, sessionId);
     const current = getHistorianFailureState(db, sessionId);
-    db.prepare("UPDATE session_meta SET historian_failure_count = ?, historian_last_error = ?, historian_last_failure_at = ? WHERE session_id = ?").run(current.failureCount + 1, error48, Date.now(), sessionId);
+    const nextCount = current.failureCount + 1;
+    db.prepare("UPDATE session_meta SET historian_failure_count = ?, historian_last_error = ?, historian_last_failure_at = ? WHERE session_id = ?").run(nextCount, error48, Date.now(), sessionId);
+    const reason = error48.replace(/\s+/g, " ").trim().slice(0, 300);
+    sessionLog(sessionId, `historian failure recorded: count=${nextCount} reason="${reason}"`);
   })();
 }
 function clearHistorianFailureState(db, sessionId) {
@@ -151267,6 +151341,7 @@ function removeStrippedPlaceholderId(db, sessionId, messageId) {
   return true;
 }
 var init_storage_meta_persisted = __esm(() => {
+  init_logger();
   init_storage_meta_shared();
 });
 
@@ -152157,14 +152232,12 @@ async function runHistorianPrompt(args) {
     const dumpPath = dumpHistorianResponse(parentSessionId, dumpLabel ?? "historian-response", result);
     return { ok: true, result, dumpPath };
   } catch (modelError) {
-    const modelMsg = getErrorMessage(modelError);
-    const modelStack = modelError instanceof Error ? modelError.stack : undefined;
-    sessionLog(parentSessionId, "compartment agent: historian attempt failed", {
-      error: modelMsg,
-      promptLength: prompt.length,
-      stack: modelStack
-    });
-    return { ok: false, error: `Historian failed while processing this session: ${modelMsg}` };
+    const desc = describeError(modelError);
+    sessionLog(parentSessionId, `historian prompt failed: ${desc.brief} promptLength=${prompt.length}${desc.stackHead ? ` stackHead="${desc.stackHead}"` : ""}`);
+    return {
+      ok: false,
+      error: `Historian failed while processing this session: ${desc.brief}`
+    };
   } finally {
     if (agentSessionId) {
       await client.session.delete({ path: { id: agentSessionId }, query: { directory: sessionDirectory } }).catch((e) => {
@@ -154317,6 +154390,7 @@ async function runCompartmentAgent(deps) {
     const priorFacts = existingFacts;
     const existingValidationError = validateStoredCompartments(priorCompartments);
     if (existingValidationError) {
+      sessionLog(sessionId, `historian failure: source=existing-validation reason="${existingValidationError}"`);
       await notifyHistorianIssue(`## Historian alert
 
 Historian skipped this session because existing stored compartments are invalid: ${existingValidationError}
@@ -154335,6 +154409,7 @@ No new compartments or facts were written. Rebuild or clear the broken compartme
     }
     const chunkCoverageError = validateChunkCoverage(chunk);
     if (chunkCoverageError) {
+      sessionLog(sessionId, `historian failure: source=chunk-coverage reason="${chunkCoverageError}" chunkRange=${chunk.startIndex}-${chunk.endIndex}`);
       await notifyHistorianIssue(`## Historian alert
 
 Historian skipped this session because the raw chunk could not be represented safely: ${chunkCoverageError}
@@ -154370,6 +154445,7 @@ ${chunk.text}`);
       twoPass: deps.historianTwoPass
     });
     if (!validatedPass.ok) {
+      sessionLog(sessionId, `historian failure: source=validation reason="${validatedPass.error}" chunkRange=${chunk.startIndex}-${chunk.endIndex} fallbackModel=${deps.fallbackModelId ?? "<none>"} twoPass=${deps.historianTwoPass ? "true" : "false"}`);
       incrementHistorianFailure(db, sessionId, validatedPass.error);
       await notifyHistorianIssue(`## Historian alert
 
@@ -154381,6 +154457,8 @@ No new compartments or facts were written. Check the historian model/output and
     const newCompartments = validatedPass.compartments;
     const lastNewEnd = newCompartments[newCompartments.length - 1]?.endMessage ?? 0;
     if (lastNewEnd + 1 <= offset) {
+      sessionLog(sessionId, `historian failure: source=no-progress reason="historian returned compartments that did not advance past raw message ${offset - 1}" newCompartmentCount=${newCompartments.length} lastNewEnd=${lastNewEnd} priorEnd=${offset - 1}`);
+      incrementHistorianFailure(db, sessionId, `no forward progress beyond raw message ${offset - 1}`);
       await notifyHistorianIssue(`## Historian alert
 
 Historian returned compartments that made no forward progress beyond raw message ${offset - 1}.
@@ -154434,11 +154512,13 @@ No new compartments or facts were written. Check the historian model/output and
       }
     }
   } catch (error48) {
-    const msg = getErrorMessage(error48);
+    const desc = describeError(error48);
+    sessionLog(sessionId, `historian failure: source=exception ${desc.brief}${desc.stackHead ? ` stackHead="${desc.stackHead}"` : ""}`);
     if (!issueNotified) {
+      incrementHistorianFailure(db, sessionId, desc.brief);
       await notifyHistorianIssue(`## Historian alert
 
-Historian failed unexpectedly: ${msg}
+Historian failed unexpectedly: ${desc.brief}
 
 No new compartments or facts were written. Check the historian model/output and try again.`);
     }

package/dist/shared/error-message.d.ts

@@ -1,2 +1,32 @@
 export declare function getErrorMessage(error: unknown): string;
+/**
+ * Produce a rich, safe-to-log description of any thrown value.
+ *
+ * Motivated by SDK errors whose `.message` is empty while `.name`/`toString()`
+ * carry the actual signal (e.g. `NotFoundError` with no message on OpenCode
+ * session-delete races). Using {@link getErrorMessage} alone erases that signal.
+ *
+ * Captures:
+ * - `name` from the Error (defaults to `constructor.name`)
+ * - `message` (may be empty)
+ * - first few stack frames
+ * - `String(error)` so objects and custom toString surfaces are visible
+ * - Common HTTP-shape fields (`status`, `statusCode`, `code`)
+ * - `cause` chain summary (first level only)
+ *
+ * Returns a compact, single-line-friendly string suitable for log lines,
+ * plus a structured object for callers that want individual fields.
+ */
+export interface ErrorDescription {
+    name: string;
+    message: string;
+    status?: string;
+    code?: string;
+    causeName?: string;
+    stackHead?: string;
+    stringForm: string;
+    /** Best short summary for human-readable logs. Never empty. */
+    brief: string;
+}
+export declare function describeError(error: unknown): ErrorDescription;
 //# sourceMappingURL=error-message.d.ts.map

package/dist/shared/error-message.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"error-message.d.ts","sourceRoot":"","sources":["../../src/shared/error-message.ts"],"names":[],"mappings":"AAAA,wBAAgB,eAAe,CAAC,KAAK,EAAE,OAAO,GAAG,MAAM,CAEtD"}
+{"version":3,"file":"error-message.d.ts","sourceRoot":"","sources":["../../src/shared/error-message.ts"],"names":[],"mappings":"AAAA,wBAAgB,eAAe,CAAC,KAAK,EAAE,OAAO,GAAG,MAAM,CAEtD;AAED;;;;;;;;;;;;;;;;;GAiBG;AACH,MAAM,WAAW,gBAAgB;IAC7B,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,EAAE,MAAM,CAAC;IAChB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,UAAU,EAAE,MAAM,CAAC;IACnB,+DAA+D;IAC/D,KAAK,EAAE,MAAM,CAAC;CACjB;AAaD,wBAAgB,aAAa,CAAC,KAAK,EAAE,OAAO,GAAG,gBAAgB,CA6D9D"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@cortexkit/opencode-magic-context",
-  "version": "0.14.1",
+  "version": "0.14.2",
   "type": "module",
   "description": "OpenCode plugin for Magic Context — cross-session memory and context management",
   "main": "dist/index.js",

package/src/shared/error-message.test.ts

@@ -0,0 +1,94 @@
+import { describe, expect, it } from "bun:test";
+import { describeError, getErrorMessage } from "./error-message";
+
+describe("describeError", () => {
+    it("extracts name and message from standard Error", () => {
+        const err = new TypeError("boom");
+        const desc = describeError(err);
+        expect(desc.name).toBe("TypeError");
+        expect(desc.message).toBe("boom");
+        expect(desc.brief).toContain("TypeError");
+        expect(desc.brief).toContain('message="boom"');
+    });
+
+    it("surfaces class name when message is empty (NotFoundError case)", () => {
+        class NotFoundError extends Error {
+            constructor() {
+                super("");
+                this.name = "NotFoundError";
+            }
+        }
+        const err = new NotFoundError();
+        const desc = describeError(err);
+        expect(desc.name).toBe("NotFoundError");
+        expect(desc.message).toBe("");
+        // brief must still carry a useful signal even with empty message
+        expect(desc.brief).toContain("NotFoundError");
+    });
+
+    it("falls back to constructor.name when .name is missing", () => {
+        // Simulate an SDK-shaped object where .name is an empty string
+        const err = Object.assign(new Error("x"), { name: "" });
+        const desc = describeError(err);
+        // Falls back to constructor.name ("Error")
+        expect(desc.name).toBe("Error");
+    });
+
+    it("extracts status/code fields from HTTP-style errors", () => {
+        const err = Object.assign(new Error("not found"), {
+            status: 404,
+            code: "ENOTFOUND",
+        });
+        const desc = describeError(err);
+        expect(desc.status).toBe("404");
+        expect(desc.code).toBe("ENOTFOUND");
+        expect(desc.brief).toContain("status=404");
+        expect(desc.brief).toContain("code=ENOTFOUND");
+    });
+
+    it("captures first stack frames in stackHead", () => {
+        const err = new Error("with stack");
+        const desc = describeError(err);
+        expect(desc.stackHead).toBeDefined();
+        expect(desc.stackHead?.length).toBeGreaterThan(0);
+    });
+
+    it("handles non-Error thrown values", () => {
+        const desc = describeError("plain string");
+        expect(desc.brief).toContain("plain string");
+        expect(desc.stringForm).toContain("plain string");
+    });
+
+    it("handles objects without .message", () => {
+        const desc = describeError({ name: "WeirdError" });
+        expect(desc.name).toBe("WeirdError");
+        expect(desc.message).toBe("");
+        expect(desc.brief).toContain("WeirdError");
+    });
+
+    it("handles undefined/null", () => {
+        expect(describeError(undefined).brief).toBeTruthy();
+        expect(describeError(null).brief).toBeTruthy();
+    });
+
+    it("surfaces cause name when present", () => {
+        const cause = new TypeError("inner");
+        const outer = new Error("outer");
+        (outer as unknown as { cause: unknown }).cause = cause;
+        const desc = describeError(outer);
+        expect(desc.causeName).toBe("TypeError");
+        expect(desc.brief).toContain("cause=TypeError");
+    });
+
+    it("clips very long messages in brief", () => {
+        const long = "x".repeat(1000);
+        const err = new Error(long);
+        const desc = describeError(err);
+        expect(desc.brief.length).toBeLessThan(500);
+    });
+
+    it("getErrorMessage still works as before", () => {
+        expect(getErrorMessage(new Error("foo"))).toBe("foo");
+        expect(getErrorMessage("bar")).toBe("bar");
+    });
+});

package/src/shared/error-message.ts

@@ -1,3 +1,115 @@
 export function getErrorMessage(error: unknown): string {
     return error instanceof Error ? error.message : String(error);
 }
+
+/**
+ * Produce a rich, safe-to-log description of any thrown value.
+ *
+ * Motivated by SDK errors whose `.message` is empty while `.name`/`toString()`
+ * carry the actual signal (e.g. `NotFoundError` with no message on OpenCode
+ * session-delete races). Using {@link getErrorMessage} alone erases that signal.
+ *
+ * Captures:
+ * - `name` from the Error (defaults to `constructor.name`)
+ * - `message` (may be empty)
+ * - first few stack frames
+ * - `String(error)` so objects and custom toString surfaces are visible
+ * - Common HTTP-shape fields (`status`, `statusCode`, `code`)
+ * - `cause` chain summary (first level only)
+ *
+ * Returns a compact, single-line-friendly string suitable for log lines,
+ * plus a structured object for callers that want individual fields.
+ */
+export interface ErrorDescription {
+    name: string;
+    message: string;
+    status?: string;
+    code?: string;
+    causeName?: string;
+    stackHead?: string;
+    stringForm: string;
+    /** Best short summary for human-readable logs. Never empty. */
+    brief: string;
+}
+
+function readString(value: unknown): string | undefined {
+    if (typeof value === "string" && value.length > 0) return value;
+    if (typeof value === "number") return String(value);
+    return undefined;
+}
+
+function clip(value: string, max: number): string {
+    if (value.length <= max) return value;
+    return `${value.slice(0, max)}…`;
+}
+
+export function describeError(error: unknown): ErrorDescription {
+    const stringForm = clip(safeString(error), 400);
+
+    if (!(error instanceof Error) && !(error && typeof error === "object")) {
+        return {
+            name: typeof error,
+            message: "",
+            stringForm,
+            brief: stringForm || "<empty>",
+        };
+    }
+
+    const obj = error as Record<string, unknown>;
+    const nameFromField = readString(obj.name);
+    const nameFromCtor = error?.constructor?.name;
+    const name = nameFromField ?? nameFromCtor ?? "Error";
+
+    const message = readString(obj.message) ?? "";
+    const status = readString(obj.status) ?? readString(obj.statusCode);
+    const code = readString(obj.code);
+
+    let causeName: string | undefined;
+    const cause = obj.cause;
+    if (cause && typeof cause === "object") {
+        const causeRecord = cause as Record<string, unknown>;
+        causeName =
+            readString(causeRecord.name) ??
+            (cause as { constructor?: { name?: string } }).constructor?.name;
+    }
+
+    const stack = readString(obj.stack);
+    const stackHead = stack
+        ? stack
+              .split("\n")
+              .slice(0, 4)
+              .map((l) => l.trim())
+              .filter((l) => l.length > 0)
+              .join(" | ")
+        : undefined;
+
+    const briefParts: string[] = [];
+    if (name) briefParts.push(name);
+    if (message) briefParts.push(`message="${clip(message, 200)}"`);
+    if (status) briefParts.push(`status=${status}`);
+    if (code) briefParts.push(`code=${code}`);
+    if (causeName) briefParts.push(`cause=${causeName}`);
+    if (!message && stringForm && stringForm !== name) {
+        briefParts.push(`str="${clip(stringForm, 200)}"`);
+    }
+    const brief = briefParts.join(" ") || stringForm || name;
+
+    return {
+        name,
+        message,
+        ...(status ? { status } : {}),
+        ...(code ? { code } : {}),
+        ...(causeName ? { causeName } : {}),
+        ...(stackHead ? { stackHead } : {}),
+        stringForm,
+        brief,
+    };
+}
+
+function safeString(value: unknown): string {
+    try {
+        return String(value);
+    } catch {
+        return "<unstringifiable>";
+    }
+}