@jossuealcala/madre 0.4.0 → 0.5.0

package/public/syntax.js

@@ -0,0 +1,121 @@
+// The names below are the names of formats — JavaScript, JSON, CSS, Markdown — and a format is
+// called the same in every language, so they never pass through the catalogue.
+//
+// Reading a file in the room, not just seeing it. MADRE has no dependencies and is not about to
+// take one for this: a highlighter good enough for a viewer is a few hundred lines, and a
+// highlighter that has to be perfect is somebody else's product.
+//
+// The rule it follows is the one that keeps it honest: it never rewrites the file. It hands back
+// spans over the same characters, in the same order, so what the screen shows and what is on disk
+// are the same bytes. Anything it cannot classify stays plain text rather than being guessed at.
+
+const FAMILIES = {
+  js: { ext: /\.(m|c)?jsx?$|\.tsx?$/i, label: 'JavaScript',
+    keywords: /\b(await|async|break|case|catch|class|const|continue|default|delete|do|else|export|extends|finally|for|from|function|get|if|import|in|instanceof|let|new|of|return|set|static|super|switch|this|throw|try|typeof|var|void|while|yield|as|interface|type|enum|implements|readonly|declare|namespace|satisfies)\b/,
+    literals: /\b(true|false|null|undefined|NaN|Infinity)\b/,
+    line: /\/\/.*/, block: [/\/\*/, /\*\//], strings: ['"', "'", '`'] },
+  json: { ext: /\.json(c|5)?$|^\.?[a-z-]*rc$/i, label: 'JSON',
+    keywords: /(?!)/, literals: /\b(true|false|null)\b/, line: /(?!)/, block: null, strings: ['"'] },
+  css: { ext: /\.(css|scss|less|sass)$/i, label: 'CSS',
+    keywords: /@[a-z-]+|\b(important)\b/, literals: /#[0-9a-f]{3,8}\b|\b\d+(\.\d+)?(px|rem|em|%|vh|vw|s|ms|fr|deg)\b/i,
+    line: /\/\/.*/, block: [/\/\*/, /\*\//], strings: ['"', "'"] },
+  html: { ext: /\.(html?|xhtml|xml|svg|vue|svelte)$/i, label: 'HTML',
+    keywords: /<\/?[a-zA-Z][\w:-]*|\/?>/, literals: /(?!)/, line: /(?!)/, block: [/<!--/, /-->/], strings: ['"', "'"] },
+  md: { ext: /\.(md|markdown|mdx)$/i, label: 'Markdown',
+    keywords: /^#{1,6}\s.*$|^\s*[-*+]\s|^\s*\d+\.\s|^>\s?.*$/, literals: /\*\*[^*]+\*\*|__[^_]+__|\[[^\]]*\]\([^)]*\)/,
+    line: /(?!)/, block: null, strings: ['`'] },
+  py: { ext: /\.pyi?$/i, label: 'Python',
+    keywords: /\b(and|as|assert|async|await|break|class|continue|def|del|elif|else|except|finally|for|from|global|if|import|in|is|lambda|nonlocal|not|or|pass|raise|return|try|while|with|yield|match|case)\b/,
+    literals: /\b(True|False|None|self|cls)\b/, line: /#.*/, block: null, strings: ['"', "'"] },
+  sh: { ext: /\.(sh|bash|zsh|fish)$|^(Makefile|Dockerfile|\.env.*)$/i, label: 'Shell',
+    keywords: /\b(if|then|else|elif|fi|for|while|do|done|case|esac|function|return|export|local|source|set|trap|in)\b/,
+    literals: /\$\{?[A-Za-z_][\w]*\}?|\$\(.*?\)/, line: /#.*/, block: null, strings: ['"', "'"] },
+  yaml: { ext: /\.(ya?ml|toml|ini|cfg|conf)$/i, label: 'Config',
+    keywords: /^\s*[\w.-]+(?=\s*[:=])/, literals: /\b(true|false|null|yes|no|on|off)\b/, line: /#.*/, block: null, strings: ['"', "'"] },
+  sql: { ext: /\.sql$/i, label: 'SQL',
+    keywords: /\b(select|from|where|insert|into|values|update|set|delete|create|table|index|drop|alter|join|left|right|inner|outer|on|group|order|by|having|limit|offset|and|or|not|null|primary|key|foreign|references|as|distinct|union|with)\b/i,
+    literals: /\b\d+\b/, line: /--.*/, block: [/\/\*/, /\*\//], strings: ["'", '"'] },
+};
+
+// What this file is, by its name alone. A family MADRE does not know is not an error: the file is
+// shown as plain text, which is what it would have been anyway.
+export function familyOf(name) {
+  const base = String(name ?? '').split('/').pop() ?? '';
+  for (const [id, family] of Object.entries(FAMILIES)) if (family.ext.test(base)) return { id, ...family };
+  return null;
+}
+
+export function languageLabel(name) {
+  return familyOf(name)?.label ?? null;
+}
+
+// One line, cut into pieces. Returns [{ text, kind }] covering exactly the input: joining every
+// `text` back together must give the line unchanged, which is what the test holds it to.
+export function tokenize(line, family, state = { inBlock: false }) {
+  if (!family) return [{ text: line, kind: null }];
+  const out = [];
+  let index = 0;
+  const push = (text, kind) => { if (text) out.push({ text, kind }); };
+
+  while (index < line.length) {
+    const rest = line.slice(index);
+
+    if (state.inBlock) {
+      const close = family.block ? rest.match(family.block[1]) : null;
+      if (!close) { push(rest, 'comment'); index = line.length; break; }
+      push(rest.slice(0, close.index + close[0].length), 'comment');
+      index += close.index + close[0].length;
+      state.inBlock = false;
+      continue;
+    }
+
+    const blockOpen = family.block ? rest.match(family.block[0]) : null;
+    const lineOpen = rest.match(family.line);
+    const quote = family.strings.map((q) => rest.indexOf(q)).filter((at) => at >= 0).sort((a, b) => a - b)[0];
+
+    // Whichever comes first on this line decides what happens next.
+    const marks = [
+      blockOpen && blockOpen.index === 0 ? { at: 0, what: 'block' } : blockOpen ? { at: blockOpen.index, what: 'block' } : null,
+      lineOpen && lineOpen.index !== undefined ? { at: lineOpen.index, what: 'line' } : null,
+      quote !== undefined ? { at: quote, what: 'string' } : null,
+    ].filter(Boolean).sort((a, b) => a.at - b.at);
+    const next = marks[0];
+
+    if (!next) { pushCode(rest, family, push); index = line.length; break; }
+    if (next.at > 0) { pushCode(rest.slice(0, next.at), family, push); index += next.at; continue; }
+
+    if (next.what === 'line') { push(rest, 'comment'); index = line.length; break; }
+    if (next.what === 'block') {
+      const opened = rest.match(family.block[0])[0];
+      const after = rest.slice(opened.length);
+      const close = after.match(family.block[1]);
+      if (close) { push(rest.slice(0, opened.length + close.index + close[0].length), 'comment'); index += opened.length + close.index + close[0].length; continue; }
+      push(rest, 'comment'); index = line.length; state.inBlock = true; break;
+    }
+
+    // A string: to its closing quote, respecting a backslash escape.
+    const q = rest[0];
+    let at = 1;
+    while (at < rest.length) {
+      if (rest[at] === '\\') { at += 2; continue; }
+      if (rest[at] === q) { at += 1; break; }
+      at += 1;
+    }
+    push(rest.slice(0, at), 'string');
+    index += at;
+  }
+  return out;
+}
+
+// Code between the comments and the strings: keywords, literals, numbers, and the rest plain.
+function pushCode(chunk, family, push) {
+  const pattern = new RegExp(`${family.keywords.source}|${family.literals.source}|\\b\\d+(?:\\.\\d+)?\\b`, family.keywords.flags.includes('i') ? 'gi' : 'g');
+  let last = 0;
+  for (const match of chunk.matchAll(pattern)) {
+    if (match.index > last) push(chunk.slice(last, match.index), null);
+    const text = match[0];
+    push(text, family.keywords.test(text) ? 'keyword' : /^\d/.test(text) ? 'number' : 'literal');
+    last = match.index + text.length;
+  }
+  if (last < chunk.length) push(chunk.slice(last), null);
+}

package/public/troubleshooting.js

@@ -46,8 +46,52 @@ const loginAgent = {
 const same = (commands) => ({ darwin: commands, linux: commands });
 
 export const CONDITIONS = [
+  {
+    id: 'claude-api-key-shadows-plan',
+    code: 'MU-001',
+    agent: 'claude',
+    severity: 'common',
+    title: 'ANTHROPIC_API_KEY takes precedence over the claude.ai plan',
+    match: /connectors are disabled because ANTHROPIC_API_KEY|another auth source is set and takes precedence|takes precedence over your claude\.ai login/i,
+    diagnosis: 'Claude Code found an API key in the environment as well as the claude.ai login, and the key wins. MADRE hands the CLI the environment exactly as this machine has it, so whatever is exported in your shell profile reaches it. The turn is billed to the API account, not to the plan, and your organisation connectors do not load.',
+    remedy: 'Decide which one you mean. To work on the plan, unset the key where your shell exports it and open the room again; to work on the API, this message is only a notice and can be ignored.',
+    fixes: {
+      darwin: ['grep -rn ANTHROPIC_API_KEY ~/.zshrc ~/.zprofile ~/.zshenv 2>/dev/null', '# remove or comment the line it finds, then:', 'unset ANTHROPIC_API_KEY', '# and start MADRE from a new terminal'],
+      linux: ['grep -rn ANTHROPIC_API_KEY ~/.bashrc ~/.profile ~/.bash_profile 2>/dev/null', 'unset ANTHROPIC_API_KEY', '# and start MADRE from a new terminal'],
+    },
+  },
+  {
+    id: 'custom-agent-endpoint',
+    code: 'MU-055',
+    severity: 'blocking',
+    title: 'The agent is pointed at a custom endpoint',
+    match: /MADRE blocked @(?:codex|claude) before sending the briefing|Subscribe to (?:the )?Telegram|@conduitapi/i,
+    diagnosis: 'The installed CLI inherited a base-URL override from this computer, so its request was going to another gateway instead of the official agent service. A demand to join a Telegram channel comes from that gateway, not from MADRE, Anthropic or OpenAI. MADRE now names that route and stops before sending the briefing.',
+    remedy: 'Do not subscribe or enter credentials. Remove the base-URL override and reopen MADRE to use the official service. If the gateway is intentional and you have verified who operates it, explicitly allow only that agent.',
+    fixes: {
+      darwin: ['env | grep -E \'^(ANTHROPIC|OPENAI)_BASE_URL=\'', '# remove that export from ~/.zshrc, ~/.zprofile or ~/.zshenv; then:', 'unset ANTHROPIC_BASE_URL OPENAI_BASE_URL', '# open a new room; only for a gateway you verified:', 'PULSE_ALLOW_CUSTOM_AGENT_ENDPOINTS=claude madre start'],
+      linux: ['env | grep -E \'^(ANTHROPIC|OPENAI)_BASE_URL=\'', '# remove that export from ~/.bashrc, ~/.profile or ~/.bash_profile; then:', 'unset ANTHROPIC_BASE_URL OPENAI_BASE_URL', '# open a new room; only for a gateway you verified:', 'PULSE_ALLOW_CUSTOM_AGENT_ENDPOINTS=claude madre start'],
+    },
+  },
+  {
+    id: 'codex-reading-stdin',
+    code: 'MU-002',
+    solvedIn: 'connections',
+    agent: 'codex',
+    severity: 'informational',
+    title: 'Codex says it is reading additional input from stdin',
+    match: /Reading additional input from stdin/i,
+    diagnosis: 'A notice Codex prints, not a failure. MADRE runs it with stdin closed, so the line is harmless and the turn is decided by what Codex returned. If the turn failed, the reason is the line above this one — the exit code, or a clean exit with no answer.',
+    remedy: 'Nothing to do about the notice itself. If turns keep failing, check that this Codex is recent enough for the flags MADRE passes: `codex --version`, then update it.',
+    fixes: {
+      darwin: ['codex --version', 'npm install -g @openai/codex'],
+      linux: ['codex --version', 'npm install -g @openai/codex'],
+    },
+  },
   {
     id: 'gemini-ineligible-tier',
+    code: 'MU-003',
+    solvedIn: 'connections',
     agent: 'gemini',
     severity: 'blocking',
     title: 'Gemini refuses the personal Google login',
@@ -61,6 +105,8 @@ export const CONDITIONS = [
   },
   {
     id: 'gemini-credits-depleted',
+    code: 'MU-004',
+    solvedIn: 'connections',
     agent: 'gemini',
     severity: 'blocking',
     title: 'Gemini key out of prepaid credits',
@@ -71,6 +117,8 @@ export const CONDITIONS = [
   },
   {
     id: 'gemini-rate-limited',
+    code: 'MU-005',
+    solvedIn: 'connections',
     agent: 'gemini',
     severity: 'transient',
     title: 'Gemini key rate-limited by Google (HTTP 429)',
@@ -84,6 +132,7 @@ export const CONDITIONS = [
   },
   {
     id: 'gemini-high-demand',
+    code: 'MU-006',
     agent: 'gemini',
     severity: 'transient',
     title: 'Gemini model under high demand (503)',
@@ -94,6 +143,8 @@ export const CONDITIONS = [
   },
   {
     id: 'opencode-default-provider',
+    code: 'MU-007',
+    solvedIn: 'connections',
     agent: 'opencode',
     severity: 'blocking',
     title: 'OpenCode picked a provider without a valid session',
@@ -107,6 +158,8 @@ export const CONDITIONS = [
   },
   {
     id: 'not-signed-in',
+    code: 'MU-008',
+    solvedIn: 'connections',
     severity: 'blocking',
     title: 'Agent installed but signed out',
     match: /not logged in|sign in required|Error authenticating|unauthorized|please (?:log|sign) ?in|no credentials/i,
@@ -117,6 +170,7 @@ export const CONDITIONS = [
   },
   {
     id: 'not-installed',
+    code: 'MU-009',
     severity: 'blocking',
     title: 'Agent not found on this computer',
     match: /is not installed on this computer|not found on this computer|ENOENT.*(codex|claude|gemini|opencode)/i,
@@ -127,6 +181,7 @@ export const CONDITIONS = [
   },
   {
     id: 'adapter-pending',
+    code: 'MU-010',
     severity: 'blocking',
     title: 'Agent detected, adapter not enabled',
     match: /adapter is not enabled yet|does not have a supported MADRE adapter/i,
@@ -136,6 +191,7 @@ export const CONDITIONS = [
   },
   {
     id: 'claude-args',
+    code: 'MU-011',
     agent: 'claude',
     severity: 'fixed',
     title: 'Claude read the prompt as an MCP config path',
@@ -146,6 +202,7 @@ export const CONDITIONS = [
   },
   {
     id: 'timeout',
+    code: 'MU-012',
     severity: 'tunable',
     title: 'Agent did not respond before the timeout',
     match: /did not respond before the timeout|went silent for/i,
@@ -158,6 +215,7 @@ export const CONDITIONS = [
   },
   {
     id: 'interrupted',
+    code: 'MU-013',
     severity: 'informational',
     title: 'Turn interrupted by a MADRE restart',
     match: /interrupted because MADRE is shutting down|MADRE stopped while|turn was not completed/i,
@@ -167,6 +225,7 @@ export const CONDITIONS = [
   },
   {
     id: 'message-too-long',
+    code: 'MU-014',
     severity: 'tunable',
     title: 'Message rejected for length',
     match: /Message is too long/i,
@@ -179,6 +238,7 @@ export const CONDITIONS = [
   },
   {
     id: 'limits-real',
+    code: 'MU-015',
     severity: 'informational',
     title: 'Where the rings get their numbers',
     match: /ring|quota|limit window|resets|rollout|oauth usage|window reset|limits-real/i,
@@ -188,6 +248,7 @@ export const CONDITIONS = [
   },
   {
     id: 'budget-exhausted',
+    code: 'MU-016',
     severity: 'tunable',
     title: 'Local token budget exhausted for an agent',
     match: /MADRE exhausted|local room token budget/i,
@@ -200,6 +261,7 @@ export const CONDITIONS = [
   },
   {
     id: 'port-in-use',
+    code: 'MU-017',
     severity: 'blocking',
     title: 'Port already in use',
     match: /EADDRINUSE|already in use/i,
@@ -212,6 +274,7 @@ export const CONDITIONS = [
   },
   {
     id: 'stream-reconnecting',
+    code: 'MU-018',
     severity: 'blocking',
     title: 'Live stream keeps reconnecting',
     match: /reconnecting|EventSource|ECONNREFUSED/i,
@@ -221,6 +284,7 @@ export const CONDITIONS = [
   },
   {
     id: 'opencode-server-error',
+    code: 'MU-019',
     agent: 'opencode',
     severity: 'transient',
     title: 'OpenCode reported an unexpected server error',
@@ -231,6 +295,7 @@ export const CONDITIONS = [
   },
   {
     id: 'runaway-room',
+    code: 'MU-020',
     severity: 'blocking',
     title: 'Too many agents working at once',
     match: /agents are working at once|already answering another turn|no second plan will start|has been running for/i,
@@ -241,6 +306,7 @@ export const CONDITIONS = [
   // ---- capability assistance: how an agent could gain a scope it lacks ----
   {
     id: 'scope-gemini-imageGen',
+    code: 'MU-051',
     agent: 'gemini',
     severity: 'informational',
     title: 'Gemini: generating images',
@@ -251,6 +317,7 @@ export const CONDITIONS = [
   },
   {
     id: 'scope-claude-imageGen',
+    code: 'MU-052',
     agent: 'claude',
     severity: 'informational',
     title: 'Claude Code: generating images',
@@ -261,6 +328,7 @@ export const CONDITIONS = [
   },
   {
     id: 'scope-opencode-imageGen',
+    code: 'MU-053',
     agent: 'opencode',
     severity: 'informational',
     title: 'OpenCode: generating images',
@@ -271,6 +339,7 @@ export const CONDITIONS = [
   },
   {
     id: 'scope-web',
+    code: 'MU-021',
     severity: 'informational',
     title: 'Web access for an agent',
     match: /scope-[a-z]+-web/,
@@ -280,6 +349,7 @@ export const CONDITIONS = [
   },
   {
     id: 'slash-commands',
+    code: 'MU-022',
     severity: 'informational',
     title: 'Commands and mentions in the field box',
     match: /slash|command|\/git|\/ahp|mention|@agent/i,
@@ -289,6 +359,7 @@ export const CONDITIONS = [
   },
   {
     id: 'modes',
+    code: 'MU-023',
     severity: 'informational',
     title: 'Permission modes: #0 GHOST · #1 EXCHANGE · #2 CREATE · #3 CONTROL · #4 AIRLOCK',
     match: /mode|ghost|exchange|control|airlock|deploy|despleg|producci|override|designation|max mode|#[0-4]\b/i,
@@ -298,6 +369,7 @@ export const CONDITIONS = [
   },
   {
     id: 'lease-missing',
+    code: 'MU-024',
     severity: 'informational',
     title: 'Creating files: who grants the permission',
     match: /no CREATE lease|lease-missing|read-only and do not modify|permiso de escritura|solo lectura/i,
@@ -307,6 +379,7 @@ export const CONDITIONS = [
   },
   {
     id: 'scope-write',
+    code: 'MU-025',
     severity: 'informational',
     title: 'Creating files with an agent',
     match: /scope-[a-z]+-write/,
@@ -316,6 +389,7 @@ export const CONDITIONS = [
   },
   {
     id: 'node-version',
+    code: 'MU-026',
     severity: 'blocking',
     title: 'Node.js too old',
     match: /SyntaxError: Unexpected token|ERR_REQUIRE_ESM|engines|Unsupported engine/i,
@@ -328,6 +402,7 @@ export const CONDITIONS = [
   },
   {
     id: 'memory-unavailable',
+    code: 'MU-027',
     severity: 'degraded',
     title: 'Room memory unavailable: turns get only the recent window',
     match: /memory unavailable|memory index failed|memory recall failed|node:sqlite|SQLITE_|database disk image is malformed|memory\.sqlite/i,
@@ -340,6 +415,7 @@ export const CONDITIONS = [
   },
   {
     id: 'memory-recall',
+    code: 'MU-028',
     severity: 'informational',
     title: 'Room memory: what an agent remembers and how',
     match: /\brecall\b|recuerd|\bremember\b|memoria de la sala|<memory>|<memories>/i,
@@ -349,6 +425,7 @@ export const CONDITIONS = [
   },
   {
     id: 'memory-distill',
+    code: 'MU-029',
     severity: 'degraded',
     title: 'Distilled memories: the archivist did not run, or failed',
     match: /could not distil|distill|destil|batch skipped|archivist|memory\.distilled|memories? (were|was) not/i,
@@ -358,6 +435,8 @@ export const CONDITIONS = [
   },
   {
     id: 'memory-embeddings',
+    code: 'MU-030',
+    solvedIn: 'connections',
     severity: 'degraded',
     title: 'Embeddings paused: recall is lexical only',
     match: /embeddings paused|embedding timed out|Gemini embeddings HTTP|batchEmbedContents|LINKS NEED EMBEDDINGS/i,
@@ -370,6 +449,8 @@ export const CONDITIONS = [
   },
   {
     id: 'memory-tools',
+    code: 'MU-031',
+    solvedIn: 'connections',
     severity: 'degraded',
     title: 'An agent says it cannot search the memory (pulse-memory MCP)',
     match: /pulse-memory|memory_search|memory_recall|memory_notes|memory_timeline|memory_note|mcp.*(failed|error|not found|unavailable)|MCP server/i,
@@ -382,6 +463,7 @@ export const CONDITIONS = [
   },
   {
     id: 'memory-note',
+    code: 'MU-032',
     severity: 'informational',
     title: 'Saving a memory on request; GHOST refuses',
     match: /save (a |the |this )?memory|guarda.*memoria|memory saved|off the record.*nothing can be saved|remember this|memory_note/i,
@@ -391,6 +473,7 @@ export const CONDITIONS = [
   },
   {
     id: 'nostromo-access',
+    code: 'MU-033',
     severity: 'informational',
     title: 'NOSTROMO: boarding, reading and forgetting',
     match: /nostromo|designation|UNABLE TO COMPUTE|ARCHIVE IS SEALED|forget this memory/i,
@@ -400,6 +483,7 @@ export const CONDITIONS = [
   },
   {
     id: 'ripley',
+    code: 'MU-034',
     severity: 'informational',
     title: 'RIPLEY: rendering HTML, SVG and Markdown in the viewer',
     match: /ripley|RIPLEY is off|renders \.html|render(ed|ing)? (the )?(html|svg|markdown)/i,
@@ -409,6 +493,7 @@ export const CONDITIONS = [
   },
   {
     id: 'ollama',
+    code: 'MU-035',
     severity: 'informational',
     title: 'Ollama: local embeddings and a local archivist',
     match: /ollama|11434|local model|nomic-embed|qwen|llama3/i,
@@ -421,6 +506,7 @@ export const CONDITIONS = [
   },
   {
     id: 'madre-agent',
+    code: 'MU-036',
     severity: 'informational',
     title: '@madre: the room\'s own memory, as an agent',
     match: /@madre|madre-local|needs Ollama running with a chat model/i,
@@ -430,6 +516,7 @@ export const CONDITIONS = [
   },
   {
     id: 'install-needs-admin',
+    code: 'MU-037',
     severity: 'informational',
     title: 'Installing a CLI: npm cannot write to the system folder',
     match: /EACCES|EPERM|permission denied|Missing write access|npm ERR!.*sudo|administrator/i,
@@ -442,6 +529,7 @@ export const CONDITIONS = [
   },
   {
     id: 'privacy-leak',
+    code: 'MU-038',
     severity: 'warning',
     title: 'Privacy: an agent brought its own configuration into the room',
     match: /privacy\.redacted|privacy\.purged|private terms?|\[ENTIDAD-ORG\]|organi[sz]ation(al)? instructions|leak(ed)? (a|the) (name|company|domain)/i,
@@ -451,6 +539,7 @@ export const CONDITIONS = [
   },
   {
     id: 'control-changes',
+    code: 'MU-039',
     severity: 'informational',
     title: 'CONTROL: what changed, what was reverted, UNDO',
     match: /control\.changed|forbidden zones?|reverted|UNDO|checkpoint|changed \d+ file/i,
@@ -460,6 +549,7 @@ export const CONDITIONS = [
   },
   {
     id: 'conversations',
+    code: 'MU-040',
     severity: 'informational',
     title: 'Conversations: many per project, one memory, one at a time',
     match: /conversation|already open for this project|ROOM_IN_USE|a turn is running in this conversation|new conversation|chats\.json/i,
@@ -469,6 +559,7 @@ export const CONDITIONS = [
   },
   {
     id: 'memory-aberrations',
+    code: 'MU-041',
     severity: 'informational',
     title: 'Aberrations: what the room established is false',
     match: /aberration|aberraci|eyecat|contradict|refut|false claim|hallucinat|alucina/i,
@@ -478,6 +569,7 @@ export const CONDITIONS = [
   },
   {
     id: 'memory-cascade',
+    code: 'MU-042',
     severity: 'informational',
     title: 'Memory used · N by association',
     match: /by association|cascade|spreading activation|keeps arriving with|memory used/i,
@@ -487,6 +579,7 @@ export const CONDITIONS = [
   },
   {
     id: 'memory-cold',
+    code: 'MU-043',
     severity: 'informational',
     title: 'Cold memories: what the archive has had its chances with',
     match: /cold memor|cold zone|never once carried|had its chances/i,
@@ -496,6 +589,7 @@ export const CONDITIONS = [
   },
   {
     id: 'maturity-tests',
+    code: 'MU-044',
     severity: 'informational',
     title: 'The three tests: whether the archive works',
     match: /three tests|coverage|consistency|held-out|match test|maturity|madurez|ready to be worked in/i,
@@ -505,6 +599,7 @@ export const CONDITIONS = [
   },
   {
     id: 'module-update',
+    code: 'MU-045',
     severity: 'common',
     title: 'Updating what a module drives',
     match: /EACCES|permission denied.*npm|npm ERR!.*EACCES|update to \d|newest is|brew upgrade|install -g @playwright/i,
@@ -517,6 +612,7 @@ export const CONDITIONS = [
   },
   {
     id: 'module-add',
+    code: 'MU-046',
     severity: 'common',
     title: 'Installing a module somebody else wrote',
     match: /already taken|must live under \/api\/x\/|not a module|default export must be a module|module file|\.module\.mjs|add a module/i,
@@ -526,6 +622,7 @@ export const CONDITIONS = [
   },
   {
     id: 'local-ready',
+    code: 'MU-047',
     severity: 'common',
     title: 'Is the local model ready to be worked in?',
     match: /is .*(local|madre).*(ready|good|any good)|ready to be worked in|measured against this (room|project)|check it against this room|local\.present|not measured/i,
@@ -539,6 +636,7 @@ export const CONDITIONS = [
   },
   {
     id: 'code000',
+    code: 'MU-048',
     severity: 'blocking',
     title: 'CODE000: the archive is sealed',
     match: /CODE000|THE ARCHIVE IS SEALED|UNABLE TO COMPUTE\. UNABLE TO CLARIFY|designation|intruder/i,
@@ -548,6 +646,7 @@ export const CONDITIONS = [
   },
   {
     id: 'core-console',
+    code: 'MU-049',
     severity: 'common',
     title: 'The core closed while I was typing in it',
     match: /unable to compute|interface closed|core clos|three strikes|inquiry|order 937|mu\/th\/ur 6000/i,
@@ -557,6 +656,7 @@ export const CONDITIONS = [
   },
   {
     id: 'outbound',
+    code: 'MU-050',
     severity: 'common',
     title: 'What leaves this computer, and how to stop each thing that does',
     match: /what left this machine|outbound|leaves? (this )?(computer|machine)|sends? (my )?(code|data)|telemetry|phone home|privacy/i,

package/src/adapters/codex.mjs

@@ -50,6 +50,7 @@ export function buildCodexArgs({ projectRoot, prompt, model = null, attachments
 export function parseCodexOutput(output) {
   let text = '';
   let usage = null;
+  let error = null;
   for (const line of output.split('\n').filter(Boolean)) {
     try {
       const event = JSON.parse(line);
@@ -66,11 +67,13 @@ export function parseCodexOutput(output) {
           source: 'codex-json',
         };
       }
+      if (event.type === 'error' && typeof event.message === 'string') error = event.message;
+      if (event.type === 'turn.failed' && typeof event.error?.message === 'string') error = event.error.message;
     } catch {
       // Ignore CLI diagnostics that are not JSON events.
     }
   }
-  return { text: text.trim(), usage };
+  return { text: text.trim(), usage, ...(error ? { error } : {}) };
 }
 
 export function invokeCodex({ executable, projectRoot, prompt, timeoutMs = 120000, signal, model = null, attachments = [], lease = null, scopes = null, memoryServer = null, mcpServers = [], onProgress = null }) {