@jossuealcala/madre 1.0.0 → 1.0.2

package/src/setup.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 { createInterface } from 'node:readline/promises';
 import { stdin, stdout } from 'node:process';

package/src/smtp.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
 // SMTP, enough of it to send one message over TLS. No dependencies, by the same rule as the rest
 // of MADRE: a library that handles the human's mail password is a library somebody has to read.
 //

package/src/tour.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 welcome of MADRE 1.0 (2026-10-11): one bonjour per person and per major version, then the
 // chapters that tell everything new, at the person's own pace (docs: the «Recorrido de MADRE 1.0»
 // decision, option B with two pieces of C — the one-line hints and the sheet of gestures).
@@ -20,14 +22,24 @@ import { createInterface } from 'node:readline';
 import { oneAtATime, writeWhole } from './json-file.mjs';
 import { PROJECT_HOMES, associateProject, projectRoomId, salasRoomId } from './salas.mjs';
 
-export const TOUR_VERSION = '1.0';
-// The chapters, in their order; «moved» is only for whoever comes from 0.7.2.
-export const CHAPTERS = ['moved', 'home', 'project', 'talk', 'modes', 'coordinator', 'links', 'maps', 'settings', 'modules', 'phone', 'gestures'];
-// The places that confuse most, each told once in one line (from option C).
-export const HINTS = ['switch', 'links', 'key4'];
-const PATHS = ['new', 'back'];
+// 1.1 (2026-10-14): the same welcome, a third way through it. Whoever read the tour of 1.0 is told
+// what changed since (path «since»): the clearer names, Home as a board, its widgets and the local
+// AI chosen project by project. A tour.json of 1.0 is that person; it is started again for 1.1 and
+// remembers where it came from (`before`).
+export const TOUR_VERSION = '1.1';
+// The chapters, in their order; «moved» is only for whoever comes from 0.7.2, «renamed» only for
+// whoever comes from 1.0.
+export const CHAPTERS = ['moved', 'home', 'renamed', 'board', 'widgets', 'project', 'talk', 'modes', 'coordinator', 'links', 'maps', 'settings', 'modules', 'local', 'phone', 'gestures'];
+// The places that confuse most, each told once in one line (from option C); then, from 1.1, what
+// each key of Home's bar opens, the first time it opens, and what each widget of Home shows. (A
+// project's bar says it with its own first-touch cards, public/app.js, FIRST_TOUCH.)
+export const HINTS = ['switch', 'links', 'key4',
+  'home-links', 'home-map', 'home-settings', 'home-add',
+  'w-system', 'w-servers', 'w-memory', 'w-coordinator', 'w-models', 'w-usage'];
+const PATHS = ['new', 'back', 'since'];
+const BEFORE = ['1.0'];
 
-const fresh = () => ({ version: TOUR_VERSION, path: null, bonjourAt: null, done: [], at: null, closed: false, finished: null, hints: {}, held: null });
+const fresh = (before = null) => ({ version: TOUR_VERSION, path: null, bonjourAt: null, done: [], at: null, closed: false, finished: null, hints: {}, held: null, before });
 // A tab that shows the bonjour or the chapters says so every few seconds; another tab that finds it
 // said within this long tells the person it is open there, instead of a second bonjour.
 export const HELD_MS = 45 * 1000;
@@ -38,7 +50,10 @@ const tourFile = (stateRoot) => join(stateRoot, 'tour.json');
 // what it says correctly and nothing else. A file for another version starts the tour again.
 export async function readTour(stateRoot) {
   const raw = await readFile(tourFile(stateRoot), 'utf8').then((text) => JSON.parse(text)).catch(() => null);
-  if (!raw || typeof raw !== 'object' || raw.version !== TOUR_VERSION) return fresh();
+  if (!raw || typeof raw !== 'object') return fresh();
+  // The tour of 1.0, read or not: this person had 1.0, and 1.1 starts again for them.
+  if (raw.version === '1.0') return fresh('1.0');
+  if (raw.version !== TOUR_VERSION) return fresh();
   const iso = (value) => (typeof value === 'string' && !Number.isNaN(Date.parse(value)) ? value : null);
   return {
     version: TOUR_VERSION,
@@ -50,6 +65,7 @@ export async function readTour(stateRoot) {
     finished: iso(raw.finished),
     hints: Object.fromEntries(HINTS.filter((id) => iso(raw.hints?.[id])).map((id) => [id, raw.hints[id]])),
     held: raw.held && TAB.test(String(raw.held.by ?? '')) && iso(raw.held.at) ? { by: raw.held.by, at: raw.held.at } : null,
+    before: BEFORE.includes(raw.before) ? raw.before : null,
   };
 }
 
@@ -67,7 +83,8 @@ export function changeTour(stateRoot, change, now = new Date()) {
 }
 async function applyChange(stateRoot, change, now) {
   if (!change || typeof change !== 'object') return { error: 'change' };
-  if (change.reset === true) return writeTour(stateRoot, fresh());
+  // Again from the start, as the same person: whoever came from 1.0 still did.
+  if (change.reset === true) return writeTour(stateRoot, fresh((await readTour(stateRoot)).before));
   const state = await readTour(stateRoot);
   const at = new Date(now).toISOString();
   if (change.path !== undefined) {

package/src/updates.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
 // Release channel: is there a newer MADRE on npm? One read of the public registry, at most
 // once a day, cached in ~/.pulse/updates.json. It sends the package name and nothing else,
 // the same request `npx` makes; PULSE_UPDATE_CHECK=0 or the switch in MU/TH/UR turns it off.

package/src/usage-sentinel.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 { t } from './i18n.mjs';
 
 const severity = { normal: 0, warning: 1, critical: 2, exhausted: 3 };

package/src/vault.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 vault: where a connector's secret lives.
 //
 // Until now MADRE held none. A key for Gemini or OpenCode is written where THAT CLI looks for it

package/src/verdict.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
 // One sentence about where a room stands, and one thing to do about it.
 //
 // Everything needed to say it was already being measured: six readings of what the archive is
@@ -28,7 +30,7 @@ export function verdictFor({ maturity = null, exams = {}, cold = null, asks = 0
     return {
       headline: stage?.label ?? null,
       says: consistency.says,
-      next: { text: t('Settle the {n} contradictions EYECAT is holding. Until they are settled, everything built on this archive inherits them.', { n: consistency.open }), where: where('nostromo') },
+      next: { text: (consistency.open === 1 ? t('Settle the contradiction the memory reviewer found. Until it is settled, everything built on this memory inherits it.') : t('Settle the {n} contradictions the memory reviewer found. Until they are settled, everything built on this memory inherits them.', { n: consistency.open })), where: where('nostromo') },
     };
   }
 

package/src/whats-new.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 version brings, said to the person who just got it.
 //
 // After an update the room opens once on a sheet of what is new: a few things, each said plainly,
@@ -51,9 +53,9 @@ export const NOTES = {
         id: 'mother',
         icon: 'check',
         image: '/assets/news/1.0/mother.webp',
-        title: { es: 'Diagnóstico te da el remedio', en: 'Diagnostics gives you the remedy' },
+        title: { es: 'Diagnóstico te da la solución', en: 'Diagnostics gives you the remedy' },
         body: {
-          es: 'Escribe lo que pasa con tus palabras y ves qué hacer, con la tecla que lo resuelve sin salir del proyecto. Lo que falló en este proyecto aparece primero y marcado, para que no tengas que adivinar.',
+          es: 'Describe con tus palabras lo que pasa y te dice qué hacer, con la tecla que lo resuelve sin salir del proyecto. Lo que falló en este proyecto aparece primero y marcado, para que no tengas que adivinar.',
           en: 'Describe what is happening in your own words and you see what to do, with the key that fixes it without leaving the project. What failed in this project shows first and marked, so you do not have to guess.',
         },
         where: { es: 'El botón DIAGNÓSTICO de la barra', en: 'The DIAGNOSTICS button in the bar' },
@@ -65,7 +67,7 @@ export const NOTES = {
         image: '/assets/news/1.0/intents.webp',
         title: { es: 'Intenciones aprende de tu uso', en: 'Intenciones learns from how you work' },
         body: {
-          es: 'Mientras escribes, sugiere cuánto debe pensar cada agente para lo que pides, a partir de tus propios turnos y sin gastar tokens. Puede proponerte un nivel más bajo para un solo mensaje, y si se quedó corto vuelve a subir.',
+          es: 'Mientras escribes, sugiere cuánto debe pensar cada agente para lo que pides, según cómo has trabajado y sin gastar tokens. Puede proponerte un nivel más bajo para un solo mensaje y, si se quedó corto, vuelve a subir.',
           en: 'As you write, it suggests how hard each agent should think for what you ask, learned from your own turns at no token cost. It can offer a lower level for a single message, and if that fell short it goes back up.',
         },
         where: { es: 'Bajo la caja de texto · Módulos › Intenciones', en: 'Under the message box · Modules › Intenciones' },
@@ -77,7 +79,7 @@ export const NOTES = {
         image: '/assets/news/1.0/permissions.webp',
         title: { es: 'Permisos a tu manera', en: 'Permissions your way' },
         body: {
-          es: 'Elige qué abre #3 y #4: el nombre del proyecto, una frase tuya o, en #3, solo confirmar. Una llave aceptada puede valer unos minutos, y el modo máximo de cada agente cabe en una sola tabla.',
+          es: 'Elige cómo confirmas #3 y #4: con el nombre del proyecto, con una frase tuya o, en #3, solo confirmando. Una confirmación puede valer unos minutos, y el permiso máximo de cada agente cabe en una sola tabla.',
           en: 'Choose what unlocks #3 and #4: the project name, a phrase of your own or, for #3, just a confirmation. An accepted key can hold for a few minutes, and every agent’s highest mode fits in one table.',
         },
         where: { es: 'Ajustes › Permisos', en: 'Settings › Permissions' },
@@ -89,7 +91,7 @@ export const NOTES = {
         image: '/assets/news/1.0/github.webp',
         title: { es: 'GitHub en el proyecto', en: 'GitHub in the project' },
         body: {
-          es: 'Revisa pull requests, CI e issues con /gh, usando la sesión de gh que ya tienes. Antes de publicar algo te enseña qué saldría y te pregunta, y los agentes solo publican en #4.',
+          es: 'Revisa pull requests, pruebas automáticas (CI) e issues con /gh, usando la sesión de gh que ya tienes. Antes de publicar algo te muestra qué saldría y te pregunta; los agentes solo publican en #4.',
           en: 'Check pull requests, CI and issues with /gh, using the gh session you already have. Before anything is posted it shows you what would go out and asks, and agents only post in #4.',
         },
         where: { es: 'Módulos › GitHub · luego /gh en la caja', en: 'Modules › GitHub · then /gh in the box' },
@@ -125,7 +127,7 @@ export const NOTES = {
         image: '/assets/news/1.0/nostromo.webp',
         title: { es: 'El Mapa de memoria a un clic', en: 'The Memory map one click away' },
         body: {
-          es: 'El cerebro de la memoria tiene su propio botón en la barra. Las conexiones entre memorias se ven aunque Ollama esté apagado.',
+          es: 'El Mapa de memoria tiene su propio botón en la barra. Los vínculos entre memorias se ven aunque Ollama esté apagado.',
           en: 'The memory brain has its own button in the bar. The links between memories show even with Ollama off.',
         },
         where: { es: 'El botón Mapa de memoria de la barra', en: 'The Memory map button in the bar' },
@@ -137,17 +139,17 @@ export const NOTES = {
         image: '/assets/news/1.0/room.webp',
         title: { es: 'El proyecto, acomodado a tu gusto', en: 'The project, arranged your way' },
         body: {
-          es: 'Cada panel se abre al lado o en una ventana que mueves. Varias conversaciones trabajan a la vez, los servidores de tu proyecto viven dentro del proyecto y el visor edita código.',
+          es: 'Cada panel se abre al lado o en una ventana que mueves. Varias conversaciones trabajan a la vez, los servidores de tu proyecto corren dentro del proyecto y el visor también edita código.',
           en: 'Every panel opens beside you or in a window you move. Several conversations work at once, your project’s servers live inside the project, and the viewer edits code.',
         },
-        where: { es: 'El encabezado de cada panel · Ajustes › Proyecto y turnos', en: 'The header of every panel · Settings › Project and turns' },
+        where: { es: 'El encabezado de cada panel · Ajustes › Proyecto y respuestas', en: 'The header of every panel · Settings › Project and turns' },
         action: 'room',
       },
       {
         id: 'looks',
         icon: 'star',
         image: '/assets/news/1.0/looks.webp',
-        title: { es: '17 acentos y 12 fondos', en: '17 accents and 12 wallpapers' },
+        title: { es: '17 colores de acento y 12 fondos', en: '17 accents and 12 wallpapers' },
         body: {
           es: 'Cada uno pensado para tema claro y oscuro. Las respuestas se leen sobre vidrio esmerilado encima de tu fondo, y las tarjetas tienen un relieve suave.',
           en: 'Each one made for light and dark themes. Replies read on frosted glass over your wallpaper, and cards stand out in soft relief.',
@@ -161,7 +163,7 @@ export const NOTES = {
         image: '/assets/news/1.0/alerts.webp',
         title: { es: 'Alertas más claras', en: 'Clearer alerts' },
         body: {
-          es: 'Las confirmaciones y las llaves de #3 y #4 llegan en una sola hoja clara, con lo que vas a aprobar a la vista. El menú «revisarlo con» ya no se corta.',
+          es: 'Las confirmaciones de #3 y #4 llegan en una sola hoja clara, con lo que vas a aprobar a la vista. El menú «revisarlo con» ya no se corta.',
           en: 'Confirmations and the keys for #3 and #4 arrive as one clear sheet, with what you are approving in view. The “review it with” menu is no longer cut off.',
         },
         where: { es: 'Aparecen solas cuando el proyecto necesita tu palabra', en: 'They appear on their own when the project needs your word' },

package/docs/madre-banner.svg

@@ -1,25 +0,0 @@
-<svg xmlns="http://www.w3.org/2000/svg" width="1200" height="300" viewBox="0 0 1200 300" role="img" aria-label="MADRE · MU/TH/UR 6000 · INTERFACE 2037">
-  <defs>
-    <linearGradient id="bg" x1="0" y1="0" x2="0" y2="1"><stop offset="0" stop-color="#050605"/><stop offset="1" stop-color="#0b0d0b"/></linearGradient>
-    <pattern id="scan" width="4" height="4" patternUnits="userSpaceOnUse"><rect width="4" height="1" fill="#9bff66" fill-opacity="0.06"/></pattern>
-    <filter id="glow" x="-20%" y="-50%" width="140%" height="200%"><feGaussianBlur stdDeviation="4" result="b"/><feMerge><feMergeNode in="b"/><feMergeNode in="SourceGraphic"/></feMerge></filter>
-    <filter id="glowSoft" x="-20%" y="-50%" width="140%" height="200%"><feGaussianBlur stdDeviation="10"/></filter>
-  </defs>
-  <rect width="1200" height="300" fill="url(#bg)"/>
-  <rect width="1200" height="300" fill="url(#scan)"/>
-  <rect x="0.5" y="0.5" width="1199" height="299" fill="none" stroke="#9bff66" stroke-opacity="0.18"/>
-  <g transform="translate(90 150)" stroke="#9bff66" fill="none" stroke-width="5" stroke-linecap="round" stroke-linejoin="round">
-    <path d="M0 0 H140 L176 0 L208 -70 L248 70 L284 0 L312 0 L330 -36 L348 0 H460" stroke-opacity="0.25" filter="url(#glowSoft)" stroke-width="14"/>
-    <path d="M0 0 H140 L176 0 L208 -70 L248 70 L284 0 L312 0 L330 -36 L348 0 H460" filter="url(#glow)"/>
-    <circle cx="520" cy="0" r="12" fill="#9bff66" stroke="none" filter="url(#glow)"/>
-  </g>
-  <g font-family="SF Mono, Menlo, Consolas, monospace" fill="#9bff66">
-    <text x="690" y="150" font-size="84" font-weight="700" letter-spacing="14" filter="url(#glow)">MADRE</text>
-    <text x="692" y="194" font-size="15" letter-spacing="6" fill-opacity="0.75">MU/TH/UR 6000 · INTERFACE 2037</text>
-    <text x="692" y="224" font-size="13" letter-spacing="3" fill-opacity="0.55">ONE ROOM · FOUR AGENTS · ONE MEMORY</text>
-  </g>
-  <g font-family="SF Mono, Menlo, Consolas, monospace" font-size="11" letter-spacing="4" fill="#9bff66" fill-opacity="0.45">
-    <text x="90" y="262">CODEX · CLAUDE CODE · GEMINI CLI · OPENCODE</text>
-    <text x="1110" y="262" text-anchor="end">PULSE CHANNEL · LOCAL FIRST</text>
-  </g>
-</svg>