@jossuealcala/madre 1.0.1 → 1.0.3

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
@@ -22,6 +24,8 @@ import { CHAPTERS, GESTURES, ORDER } from './tour-chapters.js';
 const say = (pair) => (typeof pair === 'string' ? pair : pair?.[language()] ?? pair?.es ?? '');
 const fill = (template, vars) => template.replace(/\{(\w+)\}/g, (whole, name) => (Object.hasOwn(vars, name) ? String(vars[name]) : whole));
 const still = () => typeof matchMedia === 'function' && matchMedia('(prefers-reduced-motion: reduce)').matches;
+// Up, turned for down: the way to a hint whose place is out of view.
+const ARROW_UP = '<svg viewBox="0 0 20 20" aria-hidden="true"><path d="M10 15.5V4.5M5.5 9 10 4.5 14.5 9" fill="none" stroke="currentColor" stroke-width="1.7" stroke-linecap="round" stroke-linejoin="round"/></svg>';
 const CLOSE_ICON = '<svg viewBox="0 0 20 20" aria-hidden="true"><path d="M5.5 5.5l9 9M14.5 5.5l-9 9" fill="none" stroke="currentColor" stroke-width="1.6" stroke-linecap="round"/></svg>';
 const FOLDER = '<svg viewBox="0 0 32 26" aria-hidden="true"><path d="M2 5.5A2.5 2.5 0 0 1 4.5 3h7.2l3 3.2h12.8A2.5 2.5 0 0 1 30 8.7v12.8a2.5 2.5 0 0 1-2.5 2.5h-23A2.5 2.5 0 0 1 2 21.5z" fill="currentColor"/></svg>';
 const ROBOT = '<svg viewBox="0 0 24 24" aria-hidden="true"><rect x="5" y="8" width="14" height="11" rx="3.5" fill="none" stroke="currentColor" stroke-width="1.8"/><path d="M12 4.5V8M3 13v2M21 13v2" stroke="currentColor" stroke-width="1.8" stroke-linecap="round"/><circle cx="9.5" cy="13.5" r="1.3" fill="currentColor"/><circle cx="14.5" cy="13.5" r="1.3" fill="currentColor"/></svg>';
@@ -75,6 +79,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, node: spot };
+}
+
 // `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 +214,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,14 +518,23 @@ 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;
+    let away = null;
+    let follow = null;
     const done = () => {
       if (!hintNode) return;
       void keep({ hint: id });
+      spot?.remove();
       card.remove();
+      away?.remove();
       hintNode = null;
       document.removeEventListener('keydown', onKey, true);
+      if (follow) { window.removeEventListener('scroll', follow, true); window.removeEventListener('resize', follow); }
     };
-    const onKey = (event) => { if (event.key === 'Escape' && hintNode && !inside) { event.stopPropagation(); done(); } };
+    // Esc puts away the hint in sight, or the one its way-there key speaks of; one hidden under a
+    // layer (the Project map) is not the one meant.
+    const shown = (node) => Boolean(node?.isConnected) && getComputedStyle(node).display !== 'none';
+    const onKey = (event) => { if (event.key === 'Escape' && hintNode && !inside && (shown(card) || shown(away))) { event.stopPropagation(); done(); } };
     card.append(key('tour-btn small primary', t('Got it'), done));
     hintNode = card;
     if (inside) {
@@ -505,10 +550,44 @@ export function startTour({ page, go = {}, ready = () => true, phone = false, de
     const width = Math.min(300, window.innerWidth - 24);
     card.style.width = `${width}px`;
     const height = card.getBoundingClientRect().height;
-    const onTheRight = box.left + box.width / 2 > window.innerWidth / 2;
-    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` });
+    // When the place is scrolled out of view (or was never in it: a widget below the fold), the
+    // bubble does not stay behind on its own, out of reach (2026-10-17): it steps aside, and a key at
+    // the edge the place went past says where it is and takes the page there.
+    away = key('tour-hint-away', '', () => anchor.scrollIntoView?.({ block: 'center', behavior: still() ? 'auto' : 'smooth' }));
+    away.hidden = true;
+    if (typeof away.showPopover === 'function') away.popover = 'manual';
+    document.body.append(away);
+    const sayAway = (up) => {
+      away.dataset.side = up ? 'up' : 'down';
+      away.innerHTML = ARROW_UP; // trusted: our own SVG string
+      away.append(el('b', null, title), el('span', null, up ? t('Scroll up to see it') : t('Scroll down to see it')));
+      away.setAttribute('aria-label', `${title} · ${up ? t('Scroll up to see it') : t('Scroll down to see it')}`);
+    };
+    const place = () => {
+      if (!anchor.isConnected) { done(); return; }
+      const at = anchor.getBoundingClientRect();
+      const out = at.bottom < 8 ? 'up' : at.top > window.innerHeight - 8 ? 'down' : null;
+      card.hidden = Boolean(out);
+      if (out && away.dataset.side !== out) sayAway(out === 'up');
+      if (out && away.hidden) { away.hidden = false; try { away.showPopover?.(); } catch { /* on the page */ } }
+      if (!out && !away.hidden) { away.hidden = true; delete away.dataset.side; try { away.hidePopover?.(); } catch { /* on the page */ } }
+      if (out) return;
+      const onTheRight = at.left + at.width / 2 > window.innerWidth / 2;
+      const left = Math.max(12, Math.min(window.innerWidth - width - 12, onTheRight ? at.right - width : at.left));
+      const below = at.bottom + 10 + height < window.innerHeight;
+      Object.assign(card.style, { left: `${left}px`, top: `${below ? at.bottom + 10 : Math.max(12, at.top - height - 10)}px` });
+    };
+    spot = spotlight(anchor);
+    follow = () => place();
+    window.addEventListener('scroll', follow, true);
+    window.addEventListener('resize', follow);
+    place();
+    // Where it points: on the page, or on a layer over it (Home's Project map). A layer opened over
+    // the page hides the hints that point under it, and they come back when it closes (salas-mac.css).
+    const layer = anchor.closest?.('.mv') ? 'map' : 'page';
+    card.dataset.under = layer;
+    away.dataset.under = layer;
+    if (spot.node) spot.node.dataset.under = layer;
     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
@@ -34,6 +36,10 @@ const installAgent = {
     darwin: ['brew install opencode', '# or: npm install -g opencode-ai'],
     linux: ['curl -fsSL https://opencode.ai/install | bash', '# or: npm install -g opencode-ai']
   },
+  cursor: {
+    darwin: ['curl https://cursor.com/install -fsS | bash'],
+    linux: ['curl https://cursor.com/install -fsS | bash']
+  },
 };
 
 const loginAgent = {
@@ -41,6 +47,7 @@ const loginAgent = {
   claude: { darwin: ['claude auth login', 'claude auth status --text'], linux: ['claude auth login', 'claude auth status --text']},
   gemini: { darwin: ['gemini', '# inside gemini: /auth  → "Use Gemini API key" or Google login'], linux: ['gemini', '# inside gemini: /auth']},
   opencode: { darwin: ['opencode auth login', 'opencode auth list'], linux: ['opencode auth login', 'opencode auth list']},
+  cursor: { darwin: ['cursor-agent login', 'cursor-agent status'], linux: ['cursor-agent login', 'cursor-agent status']},
 };
 
 const same = (commands) => ({ darwin: commands, linux: commands });
@@ -244,7 +251,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 +320,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 +331,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 +342,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 +360,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 +382,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 +392,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 +487,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 +507,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 +520,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 +573,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 +605,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']),
   },
@@ -704,7 +711,7 @@ export const allConditions = () => CONDITIONS.map(said);
 
 // Lowercase and without accents: «limite» finds «límite», and a person types what they type.
 const fold = (text) => String(text ?? '').normalize('NFD').replace(/[\u0300-\u036f]/g, '').toLowerCase();
-const AGENT_WORDS = new Set(['codex', 'claude', 'gemini', 'opencode', 'madre', 'ollama']);
+const AGENT_WORDS = new Set(['codex', 'claude', 'gemini', 'opencode', 'cursor', 'madre', 'ollama']);
 
 export function searchConditions(query) {
   const words = fold(query).split(/[^a-z0-9#.@_-]+/).filter(Boolean);

package/public/wallpaper.js

@@ -0,0 +1,275 @@
+// SPDX-License-Identifier: AGPL-3.0-only
+// MADRE · © 2026 Jossue Alcalá · GNU AGPL v3 with additional terms (Section 7): ADDITIONAL-TERMS.md
+// Your own wallpaper (1.0.3): a picture of yours behind MADRE, fitted to the screen like the ones
+// that ship. The page does here what was done by hand for each of those (wallpapers/ →
+// public/assets/wallpapers, and their colours in styles.css): it reads the picture, keeps its
+// longest side at SIDE, encodes it, and takes its colours for the veil, the mesh and the tint. The
+// server keeps it once for every page (src/looks.mjs); each page still chooses it or not. Shared by
+// the room (app.js) and Home (salas-mac.js), which each draw it with their own keys.
+import { t } from './i18n.js';
+
+export const CUSTOM_WALL = 'custom';
+const SIDE = 2880;
+const READ_MAX = 40 * 1024 * 1024;
+const SEND_MAX = 8 * 1024 * 1024;
+const META_KEY = 'pulse.wallpaper.custom';
+const PLUS_ICON = '<svg viewBox="0 0 20 20" aria-hidden="true"><path d="M10 4.5v11M4.5 10h11" fill="none" stroke="currentColor" stroke-width="1.6" stroke-linecap="round"/></svg>';
+
+const node = (tag, className, text) => {
+  const made = document.createElement(tag);
+  if (className) made.className = className;
+  if (text !== undefined && text !== null) made.textContent = text;
+  return made;
+};
+
+let current = null;
+export const customWall = () => current;
+// The last picture this browser knew, so a page paints with it before the server answers.
+export function rememberedWall() {
+  try { return JSON.parse(localStorage.getItem(META_KEY) ?? 'null'); } catch { return null; }
+}
+
+// The picture and its colours, as variables on the root (styles.css, --wpc-*): every wallpaper rule
+// reads them. `null` takes them away; a page that had chosen it then wears no picture.
+const VARIABLES = ['--wpc-url', '--wpc-pos', '--wpc-veil-d', '--wpc-veil-l', '--wpc-tint-d', '--wpc-tint-l', '--wpc-m1-d', '--wpc-m2-d', '--wpc-m3-d', '--wpc-m1-l', '--wpc-m2-l', '--wpc-m3-l'];
+export function paintCustomWall(meta, root = globalThis.document?.documentElement) {
+  current = meta ?? null;
+  try { if (current) localStorage.setItem(META_KEY, JSON.stringify(current)); else localStorage.removeItem(META_KEY); } catch { /* this page only */ }
+  const style = root?.style;
+  if (!style?.setProperty) return;
+  if (!current) { for (const name of VARIABLES) style.removeProperty(name); return; }
+  const rgb = (colour) => colour.join(' ');
+  const { dark, light } = current.palette;
+  style.setProperty('--wpc-url', `url("/api/looks/wallpaper?v=${current.v}")`);
+  style.setProperty('--wpc-pos', `${current.focus.x}% ${current.focus.y}%`);
+  style.setProperty('--wpc-veil-d', rgb(dark.veil));
+  style.setProperty('--wpc-veil-l', rgb(light.veil));
+  style.setProperty('--wpc-tint-d', rgb(dark.tint));
+  style.setProperty('--wpc-tint-l', rgb(light.tint));
+  dark.mesh.forEach((colour, index) => style.setProperty(`--wpc-m${index + 1}-d`, rgb(colour)));
+  light.mesh.forEach((colour, index) => style.setProperty(`--wpc-m${index + 1}-l`, rgb(colour)));
+}
+
+// Its colours, the way the shipped ones were taken: the whole for the veil and the tint, and three
+// corners for the mesh (top left, right, bottom), each pressed towards the theme's ground.
+function paletteOf(source) {
+  const canvas = node('canvas');
+  canvas.width = 48;
+  canvas.height = 32;
+  const ink = canvas.getContext('2d', { willReadFrequently: true });
+  ink.drawImage(source, 0, 0, 48, 32);
+  const { data } = ink.getImageData(0, 0, 48, 32);
+  const average = (x0, y0, x1, y1) => {
+    const sum = [0, 0, 0];
+    let count = 0;
+    for (let y = y0; y < y1; y += 1) {
+      for (let x = x0; x < x1; x += 1) {
+        const at = (y * 48 + x) * 4;
+        if (data[at + 3] < 16) continue;
+        sum[0] += data[at]; sum[1] += data[at + 1]; sum[2] += data[at + 2];
+        count += 1;
+      }
+    }
+    return count ? sum.map((value) => value / count) : [128, 128, 128];
+  };
+  const toward = (colour, ground, k) => colour.map((value, index) => Math.max(0, Math.min(255, Math.round(value * (1 - k) + ground[index] * k))));
+  const black = [0, 0, 0];
+  const white = [255, 255, 255];
+  const whole = average(0, 0, 48, 32);
+  const corners = [average(0, 0, 20, 13), average(28, 0, 48, 19), average(8, 20, 40, 32)];
+  return {
+    dark: { veil: toward(whole, black, 0.93), tint: toward(whole, black, 0.86), mesh: [toward(corners[0], black, 0.76), toward(corners[1], black, 0.66), toward(corners[2], black, 0.88)] },
+    light: { veil: toward(whole, white, 0.94), tint: toward(whole, white, 0.95), mesh: [toward(corners[0], white, 0.88), toward(corners[1], white, 0.92), toward(corners[2], white, 0.86)] },
+  };
+}
+
+const encode = (canvas, type, quality) => new Promise((resolve) => canvas.toBlob(resolve, type, quality));
+// The picture fitted and encoded, with its size and its colours. WebP where the browser writes it,
+// JPEG where it does not; smaller again if it still weighs more than the server keeps.
+export async function prepareWallpaper(file) {
+  if (!file) throw new Error(t('Choose a picture: a PNG, JPEG or WebP file.'));
+  if (file.size > READ_MAX) throw new Error(t('That picture is too large to read (more than 40 MB).'));
+  let bitmap;
+  try { bitmap = await createImageBitmap(file); } catch { throw new Error(t('That picture could not be read. Try a PNG, JPEG or WebP.')); }
+  const scale = Math.min(1, SIDE / Math.max(bitmap.width, bitmap.height));
+  const w = Math.max(1, Math.round(bitmap.width * scale));
+  const h = Math.max(1, Math.round(bitmap.height * scale));
+  const canvas = node('canvas');
+  canvas.width = w;
+  canvas.height = h;
+  const ink = canvas.getContext('2d');
+  ink.imageSmoothingQuality = 'high';
+  ink.drawImage(bitmap, 0, 0, w, h);
+  const palette = paletteOf(bitmap);
+  bitmap.close?.();
+  let blob = await encode(canvas, 'image/webp', 0.86);
+  if (!blob || blob.type !== 'image/webp') blob = await encode(canvas, 'image/jpeg', 0.88);
+  for (const quality of [0.74, 0.6]) if (blob && blob.size > SEND_MAX) blob = await encode(canvas, blob.type, quality);
+  if (!blob || blob.size > SEND_MAX) throw new Error(t('That picture could not be prepared.'));
+  return { blob, w, h, palette };
+}
+
+export async function uploadWallpaper(file, { focus = { x: 50, y: 50 } } = {}) {
+  const { blob, w, h, palette } = await prepareWallpaper(file);
+  const response = await fetch('/api/looks/wallpaper', {
+    method: 'PUT',
+    headers: { 'content-type': blob.type, 'x-madre-wallpaper': encodeURIComponent(JSON.stringify({ w, h, focus, palette })) },
+    body: blob,
+  });
+  const answer = await response.json().catch(() => ({}));
+  if (!response.ok || !answer.custom) throw new Error(answer.error ?? t('That picture could not be kept.'));
+  return answer.custom;
+}
+async function sendFrame(focus) {
+  const response = await fetch('/api/looks/wallpaper/frame', { method: 'POST', headers: { 'content-type': 'application/json' }, body: JSON.stringify(focus) });
+  const answer = await response.json().catch(() => ({}));
+  return response.ok ? answer.custom ?? null : null;
+}
+async function dropWallpaper() {
+  await fetch('/api/looks/wallpaper', { method: 'DELETE' }).catch(() => null);
+}
+
+// The browser's own chooser, opened from the press that asked for it.
+export function pickPicture() {
+  return new Promise((resolve) => {
+    const input = node('input');
+    input.type = 'file';
+    input.accept = 'image/png,image/jpeg,image/webp,image/avif,image/gif';
+    input.addEventListener('change', () => resolve(input.files?.[0] ?? null), { once: true });
+    input.addEventListener('cancel', () => resolve(null), { once: true });
+    input.click();
+  });
+}
+
+// The tile among the wallpapers: the picture when there is one; a «+» to add it when there is not.
+export function customTile(paper, meta) {
+  paper.dataset.wp = CUSTOM_WALL;
+  paper.classList.toggle('paper-add', !meta);
+  const swatch = node('span', 'paper-swatch');
+  if (!meta) swatch.innerHTML = PLUS_ICON; // trusted: our own SVG string
+  paper.append(swatch, node('span', 'paper-name', t('Your picture')));
+  if (!meta) paper.title = t('Choose a picture of yours as the wallpaper');
+  return paper;
+}
+
+// Adding it: the chooser, the picture prepared and kept, and then it is this page's wallpaper.
+// `busy` marks the tile while that happens; `chosen` hands the kept picture back.
+export async function addPicture({ busy = null, chosen, failed }) {
+  const file = await pickPicture();
+  if (!file) return;
+  busy?.classList.add('busy');
+  busy?.setAttribute('aria-busy', 'true');
+  try {
+    const meta = await uploadWallpaper(file);
+    paintCustomWall(meta);
+    chosen(meta);
+  } catch (error) {
+    failed(error.message);
+  } finally {
+    busy?.classList.remove('busy');
+    busy?.removeAttribute('aria-busy');
+  }
+}
+
+// The frame drawn last follows the window's proportions; one listener for the page, not one per drawing.
+let placeFrame = null;
+globalThis.addEventListener?.('resize', () => placeFrame?.());
+
+// Under the tiles while it is chosen: where the screen falls on the picture, and the picture
+// changed or taken away. The whole picture, and over it the part the screen shows, in the screen's
+// own proportions; carried by hand (or by the arrows) to the part that should stay in view.
+export function customTools(meta, { changed, removed, failed, button }) {
+  const box = node('div', 'wall-tools');
+  const head = node('div', 'wall-tools-head');
+  const words = node('div', 'wall-tools-words');
+  words.append(node('b', null, t('Framing')));
+  const hint = node('span', 'wall-tools-hint');
+  words.append(hint);
+  head.append(words);
+  const frame = node('div', 'wall-frame');
+  const fit = node('span', 'wall-frame-fit');
+  const picture = node('img', 'wall-frame-pic');
+  picture.alt = '';
+  picture.src = `/api/looks/wallpaper?v=${meta.v}`;
+  picture.draggable = false;
+  const view = node('span', 'wall-frame-view');
+  view.tabIndex = 0;
+  view.setAttribute('role', 'slider');
+  view.setAttribute('aria-label', t('Framing of your picture'));
+  fit.append(picture, view);
+  frame.append(fit);
+  let focus = { ...meta.focus };
+  const sides = () => {
+    const pictureRatio = meta.w / meta.h;
+    const screen = (globalThis.innerWidth || 16) / (globalThis.innerHeight || 9);
+    return { fw: Math.min(1, screen / pictureRatio), fh: Math.min(1, pictureRatio / screen) };
+  };
+  const free = () => { const { fw, fh } = sides(); return fw < 0.995 ? 'x' : fh < 0.995 ? 'y' : null; };
+  const place = () => {
+    const { fw, fh } = sides();
+    view.style.width = `${fw * 100}%`;
+    view.style.height = `${fh * 100}%`;
+    view.style.left = `${(1 - fw) * focus.x}%`;
+    view.style.top = `${(1 - fh) * focus.y}%`;
+    const axis = free();
+    frame.dataset.free = axis ?? 'none';
+    hint.textContent = axis ? t('Drag the frame to choose which part of your picture stays in view.') : t('Your picture fills the screen as it is.');
+    view.setAttribute('aria-valuetext', `${Math.round(axis === 'y' ? focus.y : focus.x)}%`);
+  };
+  const live = () => globalThis.document?.documentElement?.style?.setProperty('--wpc-pos', `${focus.x}% ${focus.y}%`);
+  const settle = async () => {
+    const kept = await sendFrame(focus);
+    if (kept) { paintCustomWall(kept); changed(kept, { reframed: true }); } else failed(t('The framing could not be kept.'));
+  };
+  const clamp = (value) => Math.max(0, Math.min(100, Math.round(value * 10) / 10));
+  const follow = (event) => {
+    const area = fit.getBoundingClientRect();
+    const { fw, fh } = sides();
+    const u = (event.clientX - area.left) / area.width;
+    const v = (event.clientY - area.top) / area.height;
+    if (fw < 0.995) focus.x = clamp(((u - fw / 2) / (1 - fw)) * 100);
+    if (fh < 0.995) focus.y = clamp(((v - fh / 2) / (1 - fh)) * 100);
+    place();
+    live();
+  };
+  fit.addEventListener('pointerdown', (event) => {
+    if (!free()) return;
+    event.preventDefault();
+    fit.setPointerCapture?.(event.pointerId);
+    frame.classList.add('moving');
+    follow(event);
+    const move = (next) => follow(next);
+    const up = () => {
+      fit.removeEventListener('pointermove', move);
+      frame.classList.remove('moving');
+      void settle();
+    };
+    fit.addEventListener('pointermove', move);
+    fit.addEventListener('pointerup', up, { once: true });
+    fit.addEventListener('pointercancel', up, { once: true });
+  });
+  view.addEventListener('keydown', (event) => {
+    const axis = free();
+    const step = { ArrowLeft: -5, ArrowUp: -5, ArrowRight: 5, ArrowDown: 5 }[event.key];
+    if (!axis || step === undefined) return;
+    event.preventDefault();
+    focus[axis] = clamp(focus[axis] + step);
+    place();
+    live();
+    void settle();
+  });
+  picture.addEventListener('load', place, { once: true });
+  placeFrame = place;
+  place();
+  const acts = node('div', 'wall-tools-acts');
+  const change = button(t('Change picture'), () => void addPicture({ busy: change, chosen: (kept) => changed(kept, { reframed: false }), failed }));
+  const remove = button(t('Remove'), async () => {
+    remove.disabled = true;
+    await dropWallpaper();
+    paintCustomWall(null);
+    removed();
+  });
+  acts.append(change, remove);
+  box.append(head, frame, acts);
+  return box;
+}

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';