@jossuealcala/madre 1.0.1 → 1.0.2

package/public/syntax.js

@@ -1,3 +1,5 @@
+// SPDX-License-Identifier: AGPL-3.0-only
+// MADRE · © 2026 Jossue Alcalá · GNU AGPL v3 with additional terms (Section 7): ADDITIONAL-TERMS.md
 // 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.
 //

package/public/touch.js

@@ -1,3 +1,5 @@
+// SPDX-License-Identifier: AGPL-3.0-only
+// MADRE · © 2026 Jossue Alcalá · GNU AGPL v3 with additional terms (Section 7): ADDITIONAL-TERMS.md
 // A tap is not a hover (2026-10-11). On a screen with no pointer (a phone, a tablet without a
 // trackpad), the browser gives :hover to whatever was tapped and keeps it until the next tap lands
 // somewhere else: a button looked pressed after it was let go. So, where nothing can hover, the

package/public/tour-chapters.js

@@ -1,3 +1,5 @@
+// SPDX-License-Identifier: AGPL-3.0-only
+// MADRE · © 2026 Jossue Alcalá · GNU AGPL v3 with additional terms (Section 7): ADDITIONAL-TERMS.md
 // What the welcome of MADRE 1.0 says (2026-10-11): twelve chapters and the sheet of gestures, in
 // both languages side by side, as the cards of What's new are (src/whats-new.mjs). Each chapter
 // fits on one view: a short scene, a line, three sentences, its gestures and «Take me there».

package/public/tour.js

@@ -1,3 +1,5 @@
+// SPDX-License-Identifier: AGPL-3.0-only
+// MADRE · © 2026 Jossue Alcalá · GNU AGPL v3 with additional terms (Section 7): ADDITIONAL-TERMS.md
 // The welcome of MADRE 1.0 (2026-10-11), in Home and in every project: option B of «Recorrido de
 // MADRE 1.0» — a bonjour, then a window of chapters read at the person's own pace — with two
 // pieces of option C: a one-line hint the first time someone reaches a place that confuses, and
@@ -75,6 +77,36 @@ const SCENES = {
   gestures: () => `<div class="ts-caps"><span class="ts-cap c0">⌘ ,</span><span class="ts-cap c1">Esc</span><span class="ts-cap c2">?</span></div>`,
 };
 
+// What a first-time card speaks of, lit, and the rest of the page a shade quieter: the card needs
+// no beak to say where it points (2026-10-15). A ring laid over the place, never the place itself
+// lifted (a key inside the bar cannot leave the bar's layer). `place()` follows it when it moves;
+// `remove()` takes it away with the card.
+export function spotlight(node) {
+  const none = { place() {}, remove() {} };
+  if (!node?.getBoundingClientRect || typeof document === 'undefined') return none;
+  const spot = document.createElement('div');
+  spot.className = 'hint-spot';
+  spot.setAttribute('aria-hidden', 'true');
+  document.body.append(spot);
+  const place = () => {
+    if (!node.isConnected) { remove(); return; }
+    const box = node.getBoundingClientRect();
+    spot.hidden = !box.width && !box.height;
+    if (spot.hidden) return;
+    const radius = Number.parseFloat(getComputedStyle(node).borderTopLeftRadius) || 10;
+    Object.assign(spot.style, { left: `${box.left - 4}px`, top: `${box.top - 4}px`, width: `${box.width + 8}px`, height: `${box.height + 8}px`, borderRadius: `${Math.min(radius + 4, (box.height + 8) / 2)}px` });
+  };
+  function remove() {
+    window.removeEventListener('resize', place);
+    window.removeEventListener('scroll', place, true);
+    spot.remove();
+  }
+  window.addEventListener('resize', place);
+  window.addEventListener('scroll', place, true);
+  place();
+  return { place, remove };
+}
+
 // `onChange` hears the kept state each time it is known or changes (null if it could not be read).
 // `phone`: none of it here (a phone, or the right half of a split window); `device`: this page is a
 // phone, which gets one card the first time instead of the bonjour.
@@ -180,6 +212,8 @@ export function startTour({ page, go = {}, ready = () => true, phone = false, de
     const done = list.filter((chapter) => state.done.includes(chapter.id)).length;
     const pill = el('span', 'tour-pill');
     const open = key('tour-pill-go', fill(t('Continue the tour · {n} of {total}'), { n: done, total: list.length }), () => openChapters(state.at));
+    // On a narrow bar it says only where it goes and how far (styles.css, .tour-pill-go[data-short]).
+    open.dataset.short = fill(t('Tour · {n}/{total}'), { n: done, total: list.length });
     const away = key('tour-pill-x', null, () => { void keep({ finished: true }); });
     away.innerHTML = CLOSE_ICON; // trusted: our own SVG string
     away.setAttribute('aria-label', t('Hide the tour'));
@@ -482,9 +516,11 @@ export function startTour({ page, go = {}, ready = () => true, phone = false, de
     const card = el('section', `tour-hint${inside ? ' inline' : ''}`);
     card.setAttribute('role', 'note');
     card.append(el('span', 'tour-hint-eyebrow', t('The first time')), el('b', null, title), el('p', null, text));
+    let spot = null;
     const done = () => {
       if (!hintNode) return;
       void keep({ hint: id });
+      spot?.remove();
       card.remove();
       hintNode = null;
       document.removeEventListener('keydown', onKey, true);
@@ -509,6 +545,7 @@ export function startTour({ page, go = {}, ready = () => true, phone = false, de
     const left = Math.max(12, Math.min(window.innerWidth - width - 12, onTheRight ? box.right - width : box.left));
     const below = box.bottom + 10 + height < window.innerHeight;
     Object.assign(card.style, { left: `${left}px`, top: `${below ? box.bottom + 10 : Math.max(12, box.top - height - 10)}px` });
+    spot = spotlight(anchor);
     document.addEventListener('keydown', onKey, true);
     return true;
   }

package/public/troubleshooting.js

@@ -1,3 +1,5 @@
+// SPDX-License-Identifier: AGPL-3.0-only
+// MADRE · © 2026 Jossue Alcalá · GNU AGPL v3 with additional terms (Section 7): ADDITIONAL-TERMS.md
 import { t } from './i18n.js';
 
 // MU/TH/UR knowledge base: known conditions, how to recognise them in the
@@ -244,7 +246,7 @@ export const CONDITIONS = [
     severity: 'informational',
     title: 'Where the usage numbers come from',
     match: /ring|quota|limit window|resets|rollout|oauth usage|window reset|limits-real/i,
-    diagnosis: 'Each sphere\'s usage shows the provider\'s real limit when the CLI publishes it: Codex writes its 5-hour and weekly windows (used %, reset time) into every session rollout under ~/.codex/sessions; Claude Code\'s /usage comes from Anthropic\'s OAuth usage endpoint; MADRE can ask it with the token Claude Code keeps in the keychain when you start with PULSE_CLAUDE_USAGE=1 (macOS may ask once to allow the keychain read). Gemini and OpenCode publish nothing locally, so their usage shows MADRE\'s own rolling 5-hour window of budget tokens. A window whose reset time has passed counts as empty until the CLI reports again, and the sentinel says "clear" when a full window resets.',
+    diagnosis: 'Each sphere\'s usage shows the provider\'s real limit when the CLI publishes it: Codex writes its 5-hour and weekly windows (used %, reset time) into every session rollout under ~/.codex/sessions; Claude Code\'s /usage comes from Anthropic\'s OAuth usage endpoint; MADRE can ask it with the token Claude Code keeps in the keychain when you start with PULSE_CLAUDE_USAGE=1 (macOS may ask once to allow the keychain read). Gemini and OpenCode publish nothing locally, so their usage shows MADRE\'s own rolling 5-hour window of budget tokens. A window whose reset time has passed counts as empty until the CLI reports again, and the failure monitor says "clear" when a full window resets.',
     remedy: 'Click a sphere to see both windows and when they reset. If a sphere\'s usage looks stale, run one turn with that agent: Codex only rewrites its limits when it runs. Set PULSE_OFFICIAL_QUOTA=0 to stop reading provider limits altogether.',
     fixes: same(['# click the sphere → 5h / 7d windows and reset times', 'PULSE_CLAUDE_USAGE=1 madre start     # also read Claude Code\'s usage windows', 'PULSE_OFFICIAL_QUOTA=0 madre start   # local window only']),
   },
@@ -313,7 +315,7 @@ export const CONDITIONS = [
     severity: 'informational',
     title: 'Gemini: generating images',
     match: /scope-gemini-imageGen/,
-    diagnosis: 'Gemini CLI 0.60 has no image-generation tool in headless mode, even though Google offers image models. MADRE fills the gap with the Images module: its own MCP server exposing generate_image on the Gemini API image models, attached to Gemini only inside a creation lease with the image scope on, billing your Gemini key.',
+    diagnosis: 'Gemini CLI 0.60 has no image-generation tool in headless mode, even though Google offers image models. MADRE fills the gap with the Images module: its own MCP server exposing generate_image on the Gemini API image models, attached to Gemini only inside a permission to create with images on, billing your Gemini key.',
     remedy: 'Turn Images on in Modules (it needs a Gemini API key with credits), then switch on Generate images for Gemini in Settings → Agents. Without the module, ask @codex or let the orchestrator route the image step to it.',
     fixes: same(['# Modules → Images → Active', '# Settings → Agents → Gemini → Generate images', '# then: CREATE + "generate … as name.png"']),
   },
@@ -324,7 +326,7 @@ export const CONDITIONS = [
     severity: 'informational',
     title: 'Claude Code: generating images',
     match: /scope-claude-imageGen/,
-    diagnosis: 'Claude Code has no image-generation tool; Claude models describe and reason about images, they do not render them. The Images module gives Claude the MCP tool generate_image (MADRE\'s own server on the Gemini API), attached with --mcp-config only inside a creation lease.',
+    diagnosis: 'Claude Code has no image-generation tool; Claude models describe and reason about images, they do not render them. The Images module gives Claude the MCP tool generate_image (MADRE\'s own server on the Gemini API), attached with --mcp-config only inside a permission to create.',
     remedy: 'Turn Images on in Modules, switch on Generate images for Claude in Settings → Agents, then use CREATE. Or route the image step to @codex.',
     fixes: same(['# Modules → Images → Active', '# Settings → Agents → Claude → Generate images']),
   },
@@ -335,7 +337,7 @@ export const CONDITIONS = [
     severity: 'informational',
     title: 'OpenCode: generating images',
     match: /scope-opencode-imageGen/,
-    diagnosis: 'OpenCode exposes no image-generation tool of its own. The Images module adds MADRE\'s MCP image server to OpenCode\'s ephemeral config inside a creation lease.',
+    diagnosis: 'OpenCode exposes no image-generation tool of its own. The Images module adds MADRE\'s MCP image server to OpenCode\'s ephemeral config inside a permission to create.',
     remedy: 'Turn Images on in Modules, switch on Generate images for OpenCode in Settings → Agents, then use CREATE. Or route the image step to @codex.',
     fixes: same(['# Modules → Images → Active', '# Settings → Agents → OpenCode → Generate images']),
   },
@@ -353,11 +355,11 @@ export const CONDITIONS = [
     id: 'slash-commands',
     code: 'MU-022',
     severity: 'informational',
-    title: 'Commands and mentions in the field box',
+    title: 'Commands and mentions in the Write box',
     match: /slash|command|\/git|\/ahp|mention|@agent/i,
-    diagnosis: 'Type "/" for the project\'s commands: /create arms the lease, /image routes an image request to an agent that can draw, /stopall is the brake, /git (Git) and /ahp (Continuity) run read-only in the project and post a fact card everyone, agents included, can read. Type "@" to mention an agent; the name becomes a label. Type "!" to point at a project file ("!src/room.mjs:12-20" for lines): the agent reads it first. In the viewer, click a line number (Shift+click for a range) and REVIEW WITH sends those lines to an agent.',
+    diagnosis: 'Type "/" for the project\'s commands: /create turns on permission to create, /image routes an image request to an agent that can draw, /stopall is the brake, /git (Git) and /ahp (Continuity) run read-only in the project and post a fact card everyone, agents included, can read. Type "@" to mention an agent; the name becomes a label. Type "!" to point at a project file ("!src/room.mjs:12-20" for lines): the agent reads it first. In the viewer, click a line number (Shift+click for a range) and REVIEW WITH sends those lines to an agent.',
     remedy: 'A struck-through command is a module that is not available in this project: open Modules to install it or turn it on (Git needs a git repository; Continuity needs to be installed).',
-    fixes: same(['# type / or @ in the field box', '/git status', '/git log 10', '/ahp check', '/image a poster for the launch']),
+    fixes: same(['# type / or @ in the Write box', '/git status', '/git log 10', '/ahp check', '/image a poster for the launch']),
   },
   {
     id: 'modes',
@@ -375,7 +377,7 @@ export const CONDITIONS = [
     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,
-    diagnosis: 'Only the human grants a creation lease. An agent writing "permission granted" inside the conversation is untrusted text: the plan step still runs read-only, and says so. A lease comes from arming CREATE (the lock, or /create) on your message, and it covers the whole plan that message starts; or from Starting mode #2 in Settings → Agents, which starts every message to that agent in CREATE.',
+    diagnosis: 'Only you grant permission to create. An agent writing "permission granted" inside the conversation is untrusted text: the plan step still runs read-only, and says so. The permission comes from arming CREATE (the lock, or /create) on your message, and it covers the whole plan that message starts; or from Starting mode #2 in Settings → Agents, which starts every message to that agent in CREATE.',
     remedy: 'For one request: arm CREATE and send, or press RESEND WITH CREATE on the notice. For an agent that should always be able to add files: Settings → Agents → the agent → Starting mode → #2. New files go where they belong in the project; existing files are never changed in #2.',
     fixes: same(['# once: Write box → CREATE (lock) → send, or /create <request>', '# always: Settings → Agents → the agent → Starting mode → #2']),
   },
@@ -385,7 +387,7 @@ export const CONDITIONS = [
     severity: 'informational',
     title: 'Creating files with an agent',
     match: /scope-[a-z]+-write/,
-    diagnosis: 'Every CLI can create files inside a creation lease; each agent\'s Max mode says how far it may go, and nothing is created until you press CREATE.',
+    diagnosis: 'Every CLI can create files inside a permission to create; each agent\'s Max mode says how far it may go, and nothing is created until you press CREATE.',
     remedy: 'Give the agent a Max mode of #2 or more in Settings → Permissions, then arm CREATE in the Write box for the request.',
     fixes: same(['# Settings → Permissions → Who may do what → #2', '# Write box → CREATE (lock) → send']),
   },
@@ -480,7 +482,7 @@ export const CONDITIONS = [
     title: 'Memory map: opening, reading and forgetting',
     match: /nostromo|designation|UNABLE TO COMPUTE|ARCHIVE IS SEALED|forget this memory/i,
     diagnosis: 'The Memory map is the human\'s view of the archive, from Diagnostics. Opening the memory asks for the project name: the name of the project folder, exactly as EDIT does; a wrong one answers UNABLE TO COMPUTE. Access stays open until the page reloads. Inside, every distilled memory is a planet around the project\'s core; drag to move, wheel to zoom, click a planet for its card. The only edit is FORGET (two presses): the note leaves every future turn, the ledger stays. If the archive answers SEALED with a number of minutes, wait them out: repeated strikes at the core close it for a while and the Write box reads INTRUDER until it opens again.',
-    remedy: 'Type the folder name shown in the project header as the project name. To find a memory quickly, ask an agent to search instead. Do not strike the core.',
+    remedy: 'Type the folder name shown in the project header as the project name. To find a memory quickly, ask an agent to search instead. Avoid guessing names: several wrong ones in a row lock the Memory map for a while.',
     fixes: same(['# Diagnostics → Memory map → project name = folder name', 'basename "$PWD"']),
   },
   {
@@ -500,7 +502,7 @@ export const CONDITIONS = [
     severity: 'informational',
     title: '@madre: the project\'s own memory, as an agent',
     // Older rooms recorded @madre leaving as "madre is not installed": it is this condition, not MU-009.
-    match: /@madre|madre-local|needs Ollama running with a chat model|\bmadre is not installed on this computer|@madre left the room/i,
+    match: /@madre|madre-local|needs Ollama running with a chat model|\bmadre is not installed on this computer|@madre left the (room|project)/i,
     diagnosis: 'When Ollama runs with a chat model, a fifth agent joins the project: @madre. It answers from the whole archive (distilled notes and exact quotes, cited as [#n]) and from what the message carries, locally, for free. It never writes, draws, browses or makes plans; when the project never discussed something it says so. Other agents may give it a plan step to check what was decided. It leaves the project when Ollama stops, and Diagnostics says so.',
     remedy: 'Start Ollama and download a chat model from Local AI in Modules; its @madre in the project switch turns the agent off if you do not want it. Ask it "what did we decide about …" or "did we ever discuss …".',
     fixes: same(['ollama serve', 'ollama pull qwen2.5:3b', '@madre what did we decide about the webhook?']),
@@ -513,7 +515,7 @@ export const CONDITIONS = [
     title: 'Ollama: local smart search and a local archivist',
     match: /ollama|11434|local model|nomic-embed|qwen|llama3/i,
     diagnosis: 'When Ollama runs on this machine with an embedding model and a chat model, MADRE embeds the memory locally (recall by meaning without any key) and distils memories with the local model first, before Gemini and the others. Nothing leaves the machine for remembering. Off or absent, everything falls back to the providers. The Local AI module, in Modules, shows what Ollama has, downloads the recommended models, and switches each role.',
-    remedy: 'Install Ollama (ollama.com), start it, then open Local AI in Modules, press Check again and download the models it suggests. Set PULSE_OLLAMA_MODEL or PULSE_OLLAMA_EMBED_MODEL to prefer others; PULSE_EMBED_PROVIDER=gemini keeps embeddings on Gemini even with Ollama running.',
+    remedy: 'Install Ollama (ollama.com), start it, then open Local AI in Modules, press RECHECK and download the models it suggests. Set PULSE_OLLAMA_MODEL or PULSE_OLLAMA_EMBED_MODEL to prefer others; PULSE_EMBED_PROVIDER=gemini keeps embeddings on Gemini even with Ollama running.',
     fixes: {
       darwin: ['brew install ollama', 'ollama serve', 'ollama pull nomic-embed-text', 'ollama pull qwen2.5:3b'],
       linux: ['curl -fsSL https://ollama.com/install.sh | sh', 'ollama serve', 'ollama pull nomic-embed-text', 'ollama pull qwen2.5:3b']
@@ -566,11 +568,11 @@ export const CONDITIONS = [
     id: 'memory-aberrations',
     code: 'MU-041',
     severity: 'informational',
-    title: 'Aberrations: what the project established is false',
+    title: 'Doubtful memories: what the project established is false',
     match: /aberration|aberraci|eyecat|contradict|refut|false claim|hallucinat|alucina/i,
-    diagnosis: 'An aberration is a claim the project established is false, kept on purpose rather than deleted: it is what the local model learns not to repeat. It never travels into a turn, and the note it refutes is taken out of circulation with it — a refuted memory is never recalled again, by words or by meaning. EYECAT watches for two agents saying opposite things about the same subject and raises the pair for a third agent to judge, one that took no part in either side. Confirming files the aberration and quarantines what it refutes; dismissing says the project was right and the pair is never raised again. Forgetting an aberration gives its note back.',
+    diagnosis: 'A doubtful memory is a claim the project established is false, kept on purpose rather than deleted: it is what the local model learns not to repeat. It never travels into a turn, and the note it refutes is taken out of circulation with it — a refuted memory is never recalled again, by words or by meaning. The memory reviewer watches for two agents saying opposite things about the same subject and raises the pair for a third agent to judge, one that took no part in either side. Confirming files the doubtful memory and quarantines what it refutes; dismissing says the project was right and the pair is never raised again. Forgetting a doubtful memory puts the note it refuted back in use.',
     remedy: 'The Memory map shows them as collapsed bodies: open one to read what it took down, or clear it if the project was wrong about being wrong. The second test of the Memory review, in Settings → Memory, reports open contradictions.',
-    fixes: same(['# Diagnostics → Memory map → the dark bodies are aberrations', '# Settings → Memory → Analysis and tests → the second test']),
+    fixes: same(['# Diagnostics → Memory map → the dark bodies are doubtful memories', '# Settings → Memory → Analysis and tests → the second test']),
   },
   {
     id: 'memory-cascade',
@@ -598,7 +600,7 @@ export const CONDITIONS = [
     severity: 'informational',
     title: 'Memory review: whether the archive works',
     match: /three tests|coverage|consistency|held-out|match test|maturity|madurez|ready to be worked in/i,
-    diagnosis: 'The six readings count what the archive is made of; they cannot say whether it works, because nothing about a pile of notes says whether the right one comes back when it is needed. COVERAGE takes real questions from this project, runs recall at the exact point each was asked, and scores what came back against the reply that was actually given. CONSISTENCY reads the contradictions EYECAT still holds and whether aberrations are being filed more often lately. MATCH puts real questions a frontier CLI answered back to the local model with this archive behind it. All three measure against a control, because everything in one project is about the same handful of subjects and any two pieces of it read as close to an embedder: to count, what the archive handed over has to beat what it would have handed over for a different question.',
+    diagnosis: 'The six readings count what the archive is made of; they cannot say whether it works, because nothing about a pile of notes says whether the right one comes back when it is needed. COVERAGE takes real questions from this project, runs recall at the exact point each was asked, and scores what came back against the reply that was actually given. CONSISTENCY reads the contradictions the memory reviewer still holds and whether doubtful memories are being filed more often lately. MATCH asks the local model, with this archive behind it, real questions that one of your agents (Codex, Claude, Gemini or OpenCode) already answered. All three measure against a control, because everything in one project is about the same handful of subjects and any two pieces of it look alike to search by meaning: to count, what the archive handed over has to beat what it would have handed over for a different question.',
     remedy: 'Read the one sentence and the one instruction at the top of Settings → Memory; the readings and the tests are in Analysis and tests, below it. The free test is read as the panel opens, the cheap one keeps itself fresh once a day while the embeddings are local, and the slow one is yours to start and to stop. None of them spends a provider turn.',
     fixes: same(['# Settings → Memory → Analysis and tests → Memory review', '# MATCH needs Ollama running with a chat model, and smart search on']),
   },

package/src/adapters/claude.mjs

@@ -1,3 +1,5 @@
+// SPDX-License-Identifier: AGPL-3.0-only
+// MADRE · © 2026 Jossue Alcalá · GNU AGPL v3 with additional terms (Section 7): ADDITIONAL-TERMS.md
 import { runReadonlyProcess } from './process.mjs';
 
 // dontAsk denies any tool use that is not pre-approved, so under a lease the

package/src/adapters/codex.mjs

@@ -1,3 +1,5 @@
+// SPDX-License-Identifier: AGPL-3.0-only
+// MADRE · © 2026 Jossue Alcalá · GNU AGPL v3 with additional terms (Section 7): ADDITIONAL-TERMS.md
 import { readdir } from 'node:fs/promises';
 import { homedir } from 'node:os';
 import { join } from 'node:path';

package/src/adapters/gemini.mjs

@@ -1,3 +1,5 @@
+// SPDX-License-Identifier: AGPL-3.0-only
+// MADRE · © 2026 Jossue Alcalá · GNU AGPL v3 with additional terms (Section 7): ADDITIONAL-TERMS.md
 import { priceTokens, PRICES_CHECKED } from '../prices.mjs';
 import { copyFile, mkdir, mkdtemp, readFile, rm, writeFile } from 'node:fs/promises';
 import { t } from '../i18n.mjs';
@@ -288,7 +290,7 @@ export function diagnoseGeminiStderr(stderr) {
   if (/Unauthorized tool call:\s*'?invoke_agent'?|Blocked call:[^\n]*invoke_agent/i.test(text)) {
     return {
       code: 'SUBAGENT_BLOCKED',
-      message: t('Gemini tried to hand this turn to one of its own subagents. MADRE does not allow that: a subagent answers outside the lease, so nothing it wrote would be checked, shown or undoable.'),
+      message: t('Gemini tried to hand this task to one of its own subagents. MADRE does not allow that: a subagent answers outside the permission MADRE controls, so nothing it wrote would be checked, shown or undoable.'),
       hint: t('Ask again saying it should do the work itself, without subagents.'),
     };
   }

package/src/adapters/madre.mjs

@@ -1,3 +1,5 @@
+// SPDX-License-Identifier: AGPL-3.0-only
+// MADRE · © 2026 Jossue Alcalá · GNU AGPL v3 with additional terms (Section 7): ADDITIONAL-TERMS.md
 // @madre: the room's own intelligence. A local model (Ollama) that answers
 // from what the room remembers: the whole archive, not only the recent window,
 // plus the files the human points at. It never writes, never delegates, never
@@ -264,7 +266,7 @@ export async function gather(memory, text, { maxChars = 7000 } = {}) {
 export function madreInvoker({ memory, ollama, fetchImpl = globalThis.fetch }) {
   return async ({ prompt, text = '', timeoutMs = 180000, model = null, requester = 'you', crew = [], delegation = false, maxSteps = 4, round = null, bishop = null }) => {
     const state = typeof ollama === 'function' ? ollama() : ollama;
-    if (!state?.running || !state.chatModel) throw new Error('@madre left the room: Ollama is not running. Start Ollama, or open Ollama in Modules.');
+    if (!state?.running || !state.chatModel) throw new Error('@madre left the project: Ollama is not running. Start Ollama, or open Local AI in Modules.');
     const question = text || prompt.match(/User message: ([\s\S]*)$/)?.[1] || prompt.slice(-2000);
     const local = localReply(question, { requester, crew, delegation, maxSteps, model: model ?? state.chatModel });
     if (local) return { text: local.text, usage: { ...NO_USAGE }, grounded: { notes: 0, quotes: 0 }, synthetic: local.kind, declined: local.kind === 'declined' ? 'action' : undefined };

package/src/adapters/opencode.mjs

@@ -1,3 +1,5 @@
+// SPDX-License-Identifier: AGPL-3.0-only
+// MADRE · © 2026 Jossue Alcalá · GNU AGPL v3 with additional terms (Section 7): ADDITIONAL-TERMS.md
 import { runReadonlyProcess } from './process.mjs';
 
 const readonlyConfig = {
@@ -21,13 +23,15 @@ const readonlyConfig = {
 // Optional provider/model override (e.g. "openai/gpt-5.6-sol"). Without it,
 // OpenCode picks its own default provider, which may not be the one the user
 // actually signed in to.
-export function buildOpenCodeArgs({ projectRoot, prompt, model = process.env.PULSE_OPENCODE_MODEL, attachments = [] }) {
+export function buildOpenCodeArgs({ projectRoot, prompt, model = process.env.PULSE_OPENCODE_MODEL, effort = null, attachments = [] }) {
   return [
     '--pure',
     'run',
     '--format', 'json',
     '--agent', 'pulse-readonly',
     ...(model ? ['--model', model] : []),
+    // The model's reasoning rung, as OpenCode names it (`--variant`, 1.18).
+    ...(effort ? ['--variant', effort] : []),
     ...attachments.flatMap((file) => ['--file', file.path]),
     '--dir', projectRoot,
     prompt,
@@ -154,11 +158,11 @@ export function parseOpenCodeOutput(output) {
   return { text: text.join('').trim(), usage, ...(error ? { error } : {}) };
 }
 
-export function invokeOpenCode({ executable, projectRoot, prompt, timeoutMs = 120000, signal, model = null, attachments = [], lease = null, scopes = null, imageStudio = null, memoryServer = null, mcpServers = [], onProgress = null }) {
+export function invokeOpenCode({ executable, projectRoot, prompt, timeoutMs = 120000, signal, model = null, effort = null, attachments = [], lease = null, scopes = null, imageStudio = null, memoryServer = null, mcpServers = [], onProgress = null }) {
   return runReadonlyProcess({
     onProgress: onProgress ? (out) => onProgress({ chars: out.length }) : null,
     executable,
-    args: buildOpenCodeArgs({ projectRoot, prompt, attachments, ...(model ? { model } : {}) }),
+    args: buildOpenCodeArgs({ projectRoot, prompt, attachments, effort, ...(model ? { model } : {}) }),
     cwd: projectRoot,
     env: openCodeEnvironment(process.env, { lease, scopes, imageStudio, memoryServer, mcpServers }),
     timeoutMs,

package/src/adapters/process.mjs

@@ -1,3 +1,5 @@
+// SPDX-License-Identifier: AGPL-3.0-only
+// MADRE · © 2026 Jossue Alcalá · GNU AGPL v3 with additional terms (Section 7): ADDITIONAL-TERMS.md
 import { spawn } from 'node:child_process';
 import { t } from '../i18n.mjs';
 

package/src/asking.mjs

@@ -1,3 +1,5 @@
+// SPDX-License-Identifier: AGPL-3.0-only
+// MADRE · © 2026 Jossue Alcalá · GNU AGPL v3 with additional terms (Section 7): ADDITIONAL-TERMS.md
 // What the room should ask next.
 //
 // The maturity reading says where the archive is thin; it does not say what to do about it on a

package/src/auth-probe.mjs

@@ -1,3 +1,5 @@
+// SPDX-License-Identifier: AGPL-3.0-only
+// MADRE · © 2026 Jossue Alcalá · GNU AGPL v3 with additional terms (Section 7): ADDITIONAL-TERMS.md
 import { execFile } from 'node:child_process';
 import { t } from './i18n.mjs';
 import { access, readFile } from 'node:fs/promises';
@@ -121,7 +123,7 @@ export const AGENT_SETUP = {
   gemini: {
     install: ['npm install -g @google/gemini-cli'],
     login: [],
-    loginNote: 'Gemini signs in from its own prompt: run `gemini`, type /auth, pick "Use Gemini API key" (get one at aistudio.google.com/app/apikey) or Google login.',
+    loginNote: 'Gemini signs in from your terminal: run `gemini`, type /auth, pick "Use Gemini API key" (get one at aistudio.google.com/app/apikey) or Google login.',
     interactive: true,
     vendor: 'Google',
     account: 'Signs in with a Google account and has a free tier. A Gemini API key from AI Studio works too.',

package/src/bridge/devices.mjs

@@ -1,3 +1,5 @@
+// SPDX-License-Identifier: AGPL-3.0-only
+// MADRE · © 2026 Jossue Alcalá · GNU AGPL v3 with additional terms (Section 7): ADDITIONAL-TERMS.md
 // The phones that may reach this Mac, and the networks where they may.
 //
 // One file, `~/.pulse/devices.json`, owner-only, shared by every room on this Mac: any of them can

package/src/bridge/handoff.mjs

@@ -1,3 +1,5 @@
+// SPDX-License-Identifier: AGPL-3.0-only
+// MADRE · © 2026 Jossue Alcalá · GNU AGPL v3 with additional terms (Section 7): ADDITIONAL-TERMS.md
 // Where the person was, on the Mac and on the phone (docs/MOBILE.md, MOV-005).
 //
 // One small file for the whole Mac, `~/.pulse/handoff.json`, owner-only: the last place each side

package/src/bridge/host.mjs

@@ -1,3 +1,5 @@
+// SPDX-License-Identifier: AGPL-3.0-only
+// MADRE · © 2026 Jossue Alcalá · GNU AGPL v3 with additional terms (Section 7): ADDITIONAL-TERMS.md
 // Who keeps the bridge up. Every room on this Mac offers to; the port decides.
 //
 // No process of its own and nothing to start: each room, every few seconds, asks whether a phone

package/src/bridge/network.mjs

@@ -1,3 +1,5 @@
+// SPDX-License-Identifier: AGPL-3.0-only
+// MADRE · © 2026 Jossue Alcalá · GNU AGPL v3 with additional terms (Section 7): ADDITIONAL-TERMS.md
 // Which network this Mac is on, and how a phone on it reaches the Mac.
 //
 // A network is known by its router: the hardware address of the default gateway, hashed. Two

package/src/bridge/policy.mjs

@@ -1,3 +1,5 @@
+// SPDX-License-Identifier: AGPL-3.0-only
+// MADRE · © 2026 Jossue Alcalá · GNU AGPL v3 with additional terms (Section 7): ADDITIONAL-TERMS.md
 // What a phone may do in a room (docs/MOBILE.md, section 4).
 //
 // A list of what passes, not of what does not: a route the room grows tomorrow stays on the Mac
@@ -15,7 +17,7 @@ import { t } from '../i18n.mjs';
 
 // Every file the room's page loads: one missing here and app.js cannot import it, so the whole page
 // stops on the phone (test/phone-bridge.test.mjs reads app.js's imports to keep this whole).
-const STATIC = new Set(['/', '/app.js', '/nostromo-engine.js', '/brands.js', '/troubleshooting.js', '/inquiry.js', '/i18n.js', '/es.js', '/resay.js', '/syntax.js', '/editor.js', '/routing.js', '/abduction.js', '/styles.css', '/review-ask.js', '/loader.js', '/tour.js', '/tour-chapters.js', '/touch.js']);
+const STATIC = new Set(['/', '/app.js', '/nostromo-engine.js', '/brands.js', '/troubleshooting.js', '/inquiry.js', '/i18n.js', '/es.js', '/resay.js', '/syntax.js', '/editor.js', '/routing.js', '/abduction.js', '/styles.css', '/review-ask.js', '/loader.js', '/tour.js', '/tour-chapters.js', '/touch.js', '/attribution.js']);
 
 const READ = new Set([
   '/api/state', '/api/events', '/api/chats', '/api/version', '/api/whats-new', '/api/glance', '/api/handoff',

package/src/bridge/qr.mjs

@@ -1,3 +1,5 @@
+// SPDX-License-Identifier: AGPL-3.0-only
+// MADRE · © 2026 Jossue Alcalá · GNU AGPL v3 with additional terms (Section 7): ADDITIONAL-TERMS.md
 // The QR a phone scans to pair with this Mac: text in, a grid of dark and light modules out, and
 // an SVG of that grid the room sizes and colours with CSS.
 //

package/src/bridge/server.mjs

@@ -1,3 +1,5 @@
+// SPDX-License-Identifier: AGPL-3.0-only
+// MADRE · © 2026 Jossue Alcalá · GNU AGPL v3 with additional terms (Section 7): ADDITIONAL-TERMS.md
 // The bridge: the one thing on this Mac a phone can reach (docs/MOBILE.md, MOV-001).
 //
 // Rooms keep listening on 127.0.0.1 and keep refusing anything that does not call them by that

package/src/capabilities.mjs

@@ -1,3 +1,5 @@
+// SPDX-License-Identifier: AGPL-3.0-only
+// MADRE · © 2026 Jossue Alcalá · GNU AGPL v3 with additional terms (Section 7): ADDITIONAL-TERMS.md
 // What each CLI can do from MADRE, verified against the installed versions on
 // 2026-09-16 (Codex 0.153, Claude Code 2.1, Gemini CLI 0.60, OpenCode 1.18).
 // The room shows this so a human knows whom to ask for what, and an

package/src/chats.mjs

@@ -1,3 +1,5 @@
+// SPDX-License-Identifier: AGPL-3.0-only
+// MADRE · © 2026 Jossue Alcalá · GNU AGPL v3 with additional terms (Section 7): ADDITIONAL-TERMS.md
 // A project has one memory and many conversations.
 //
 // The archive, the crew, the modules and the privacy list belong to the project: they are what

package/src/checkpoint.mjs

@@ -1,3 +1,5 @@
+// SPDX-License-Identifier: AGPL-3.0-only
+// MADRE · © 2026 Jossue Alcalá · GNU AGPL v3 with additional terms (Section 7): ADDITIONAL-TERMS.md
 import { execFile } from 'node:child_process';
 import { access, mkdir, mkdtemp, readFile, readdir, rm, rmdir, stat, unlink, writeFile } from 'node:fs/promises';
 import { tmpdir } from 'node:os';

package/src/choices.mjs

@@ -1,3 +1,5 @@
+// SPDX-License-Identifier: AGPL-3.0-only
+// MADRE · © 2026 Jossue Alcalá · GNU AGPL v3 with additional terms (Section 7): ADDITIONAL-TERMS.md
 // An agent asking the human to choose.
 //
 // The room already has one fenced channel, ```pulse, and it puts other agents to work. This is

package/src/cli-args.mjs

@@ -1,3 +1,5 @@
+// SPDX-License-Identifier: AGPL-3.0-only
+// MADRE · © 2026 Jossue Alcalá · GNU AGPL v3 with additional terms (Section 7): ADDITIONAL-TERMS.md
 // Tiny argv reader for the MADRE CLI. Accepts `--name value` and
 // `--name=value`, and remembers which options the user set explicitly so the
 // room can choose sensible defaults (like the next free port) only when they

package/src/cold.mjs

@@ -1,3 +1,5 @@
+// SPDX-License-Identifier: AGPL-3.0-only
+// MADRE · © 2026 Jossue Alcalá · GNU AGPL v3 with additional terms (Section 7): ADDITIONAL-TERMS.md
 // Cold zones: the part of the archive nothing has ever reached for.
 //
 // A memory is cold when three things are true at once, and the three together are what make the

package/src/commands.mjs

@@ -1,3 +1,5 @@
+// SPDX-License-Identifier: AGPL-3.0-only
+// MADRE · © 2026 Jossue Alcalá · GNU AGPL v3 with additional terms (Section 7): ADDITIONAL-TERMS.md
 import { execFile } from 'node:child_process';
 import { access } from 'node:fs/promises';
 import { join } from 'node:path';

package/src/config.mjs

@@ -1,3 +1,5 @@
+// SPDX-License-Identifier: AGPL-3.0-only
+// MADRE · © 2026 Jossue Alcalá · GNU AGPL v3 with additional terms (Section 7): ADDITIONAL-TERMS.md
 import { randomUUID } from 'node:crypto';
 import { copyFile, mkdir, open, readFile, rename, rm, stat, writeFile } from 'node:fs/promises';
 import { homedir } from 'node:os';

package/src/conversation-context.mjs

@@ -1,3 +1,17 @@
+// SPDX-License-Identifier: AGPL-3.0-only
+// MADRE · © 2026 Jossue Alcalá · GNU AGPL v3 with additional terms (Section 7): ADDITIONAL-TERMS.md
+// What a command's output may weigh in the shared window, and which part of it. It used to be the
+// first 6000 characters: five outputs filled the 16 000 of the window, the request that asked for
+// them went out of it, and the agent lost the thread (2026-10-14). Now it is the start and the end
+// — a test run says what it is at the top and how it went at the bottom — and the agent that asked
+// gets the fuller output in a turn of its own (src/room/returns.mjs).
+const COMMAND_HEAD = 300;
+const COMMAND_TAIL = 900;
+function commandEnds(text) {
+  if (text.length <= COMMAND_HEAD + COMMAND_TAIL) return text;
+  return `${text.slice(0, COMMAND_HEAD)}\n… ${text.length - COMMAND_HEAD - COMMAND_TAIL} characters left out …\n${text.slice(-COMMAND_TAIL)}`;
+}
+
 export function messageEntry(event) {
   if (event.type === 'message.failed') {
     // Failures are part of the conversation: an orchestrator closing a plan
@@ -9,7 +23,7 @@ export function messageEntry(event) {
   if (event.type === 'command.output') {
     const { name, title, text } = event.payload;
     if (typeof text !== 'string' || !text.trim()) return null;
-    return { sequence: event.sequence, messageId: `${event.id}:command`, role: 'command', sender: `/${name}`, target: 'room', text: `${title}\n${text.trim()}`.slice(0, 6000) };
+    return { sequence: event.sequence, messageId: `${event.id}:command`, role: 'command', sender: `/${name}`, target: 'room', text: `${title}\n${commandEnds(text.trim())}` };
   }
   if (event.type !== 'message.created') return null;
   const { messageId, role, sender, target, text } = event.payload;

package/src/credentials.mjs

@@ -1,3 +1,5 @@
+// SPDX-License-Identifier: AGPL-3.0-only
+// MADRE · © 2026 Jossue Alcalá · GNU AGPL v3 with additional terms (Section 7): ADDITIONAL-TERMS.md
 // Handing a provider key to a CLI that signs in from its own prompt.
 //
 // MADRE keeps its promise: it never stores a credential of its own. The key the human pastes is
@@ -36,6 +38,32 @@ export const OPENCODE_PROVIDERS = [
   { id: 'google', label: 'Google AI Studio', keyUrl: 'https://aistudio.google.com/app/apikey' },
 ];
 
+// The rest of the providers OpenCode knows (2026-10-14): its own catalogue, models.dev, which it
+// caches itself. Those a single key opens can be wired from MADRE; the ones that need an account
+// id, a region or a second secret stay with `opencode auth login`. Read only, never fetched.
+export const OPENCODE_FEATURED = ['anthropic', 'openai', 'google', 'openrouter', 'groq', 'deepseek', 'mistral', 'xai', 'togetherai', 'fireworks-ai', 'cerebras', 'perplexity', 'huggingface', 'deepinfra', 'moonshotai', 'zai', 'cohere', 'vercel'];
+export async function readOpenCodeCatalog({ home = homedir(), env = process.env } = {}) {
+  const raw = await readIfThere(join(env.XDG_CACHE_HOME || join(home, '.cache'), 'opencode', 'models.json'));
+  let data = {};
+  try { data = JSON.parse(raw ?? '{}') ?? {}; } catch { data = {}; }
+  if (!data || typeof data !== 'object' || Array.isArray(data)) return [];
+  const out = [];
+  for (const [id, one] of Object.entries(data)) {
+    if (!/^[\w.-]{1,60}$/.test(id) || !one || typeof one !== 'object' || !Array.isArray(one.env) || one.env.length !== 1) continue;
+    out.push({ id, label: typeof one.name === 'string' && one.name.trim() ? one.name.trim().slice(0, 60) : id, docUrl: typeof one.doc === 'string' && /^https:\/\//.test(one.doc) ? one.doc : null });
+  }
+  return out;
+}
+// Every provider a key can be pasted for: MADRE's own four first (their key pages), then the
+// catalogue's, each once, the popular ones marked.
+export async function openCodeKeyProviders({ home = homedir(), env = process.env } = {}) {
+  const catalog = await readOpenCodeCatalog({ home, env });
+  const byId = new Map(OPENCODE_PROVIDERS.map((one) => [one.id, { ...one, featured: true }]));
+  for (const one of catalog) if (!byId.has(one.id)) byId.set(one.id, { id: one.id, label: one.label, keyUrl: one.docUrl, featured: OPENCODE_FEATURED.includes(one.id) });
+  const rank = (one) => { const at = OPENCODE_FEATURED.indexOf(one.id); return at < 0 ? Infinity : at; };
+  return [...byId.values()].sort((a, b) => Number(b.featured) - Number(a.featured) || rank(a) - rank(b));
+}
+
 // What the room offers for each agent that cannot be signed in with a click.
 export function keyPlanFor(id) {
   if (id === 'claude') {
@@ -140,7 +168,7 @@ async function applyClaudeKey(key, { home, probe }) {
 
 // ---- OpenCode: an entry in its auth.json, confirmed by asking `opencode auth list`.
 async function applyOpenCodeKey(key, { home, provider, executable, run }) {
-  const known = OPENCODE_PROVIDERS.some((item) => item.id === provider);
+  const known = typeof provider === 'string' ? (await openCodeKeyProviders({ home })).find((item) => item.id === provider) : null;
   if (!known) return { ok: false, error: 'Pick the provider this key belongs to.' };
   const file = join(home, '.local', 'share', 'opencode', 'auth.json');
   await mkdir(join(home, '.local', 'share', 'opencode'), { recursive: true });
@@ -153,8 +181,9 @@ async function applyOpenCodeKey(key, { home, provider, executable, run }) {
     await chmod(file, OWNER_ONLY).catch(() => {});
     // OpenCode itself is the judge: if its own listing does not show the provider, the shape
     // MADRE wrote is not the shape it reads, and nothing should be left behind.
-    const listed = await run(executable, ['auth', 'list']);
-    if (!new RegExp(provider, 'i').test(listed)) {
+    // It lists the provider by its name («Together AI»), sometimes by its id.
+    const listed = String(await run(executable, ['auth', 'list'])).toLowerCase();
+    if (!listed.includes(provider.toLowerCase()) && !listed.includes(String(known.label).toLowerCase())) {
       await restore(file, before);
       return { ok: false, error: `OpenCode does not list ${provider} after the key was written, so MADRE put the file back. Run \`opencode auth login\` in a terminal for this one.` };
     }

package/src/dataset.mjs

@@ -1,3 +1,5 @@
+// SPDX-License-Identifier: AGPL-3.0-only
+// MADRE · © 2026 Jossue Alcalá · GNU AGPL v3 with additional terms (Section 7): ADDITIONAL-TERMS.md
 // The dataset behind MADRE AI: every exchange the room kept (never GHOST),
 // redacted, as chat pairs a small model can learn from, plus the distilled
 // notes. Written next to the room's ledger in the format mlx-lm and most

package/src/directives.mjs

@@ -1,3 +1,5 @@
+// SPDX-License-Identifier: AGPL-3.0-only
+// MADRE · © 2026 Jossue Alcalá · GNU AGPL v3 with additional terms (Section 7): ADDITIONAL-TERMS.md
 // Agent-to-agent delegation. An agent answering in the room may end its reply
 // with a fenced block that puts other agents to work, in order:
 //

package/src/distiller.mjs

@@ -1,3 +1,5 @@
+// SPDX-License-Identifier: AGPL-3.0-only
+// MADRE · © 2026 Jossue Alcalá · GNU AGPL v3 with additional terms (Section 7): ADDITIONAL-TERMS.md
 // The archivist's turn: every so often the cheapest agent in the room reads
 // the exchanges nobody has distilled yet and writes the few notes worth
 // keeping for every later turn. Pure functions here; the room schedules and

package/src/embeddings.mjs

@@ -1,3 +1,5 @@
+// SPDX-License-Identifier: AGPL-3.0-only
+// MADRE · © 2026 Jossue Alcalá · GNU AGPL v3 with additional terms (Section 7): ADDITIONAL-TERMS.md
 // Embeddings for the room memory: meaning-aware recall on top of the lexical
 // index. Gemini's embedding model through the user's own key (the same key
 // Image Studio and the Gemini CLI use); no key, no embeddings, and recall stays