@jossuealcala/madre 1.1.2 → 1.1.3

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (101) hide show
  1. package/CHANGELOG.en.md +21 -1
  2. package/CHANGELOG.md +21 -1
  3. package/README.en.md +3 -3
  4. package/README.md +3 -3
  5. package/SECURITY.md +11 -6
  6. package/bin/madre.mjs +74 -11
  7. package/docs/REFERENCE.md +13 -7
  8. package/docs/SDK.md +8 -8
  9. package/docs/en/REFERENCE.md +10 -6
  10. package/docs/en/SDK.md +8 -8
  11. package/docs/en/training/README.md +1 -1
  12. package/docs/sdk/connector-module.mjs +1 -1
  13. package/docs/sdk/hello-module.mjs +1 -1
  14. package/docs/training/README.md +1 -1
  15. package/docs/training/train.sh +3 -0
  16. package/package.json +4 -2
  17. package/public/activity.js +9 -0
  18. package/public/app.js +988 -171
  19. package/public/attribution.js +9 -0
  20. package/public/brands.js +27 -13
  21. package/public/en.js +1 -2
  22. package/public/es.js +834 -257
  23. package/public/index.html +3 -0
  24. package/public/macroverso.js +24 -5
  25. package/public/manual-content.js +32 -2
  26. package/public/market-view.js +116 -9
  27. package/public/market.js +15 -0
  28. package/public/news-scenes.js +185 -0
  29. package/public/notices.js +66 -0
  30. package/public/power.js +1 -1
  31. package/public/resay.js +3 -0
  32. package/public/salas-mac.css +229 -26
  33. package/public/salas-mac.html +3 -0
  34. package/public/salas-mac.js +454 -37
  35. package/public/styles.css +393 -17
  36. package/public/tips.js +124 -0
  37. package/public/tour-chapters.js +75 -75
  38. package/public/tour.js +36 -8
  39. package/public/troubleshooting.js +215 -22
  40. package/public/welcome-scene.js +358 -0
  41. package/public/welcome.js +514 -273
  42. package/src/adapters/gemini-rest.mjs +236 -0
  43. package/src/adapters/gemini.mjs +9 -7
  44. package/src/adapters/grok.mjs +288 -0
  45. package/src/adapters/process.mjs +14 -3
  46. package/src/auth-probe.mjs +32 -0
  47. package/src/bridge/policy.mjs +1 -1
  48. package/src/capabilities.mjs +30 -0
  49. package/src/checkpoint.mjs +115 -1
  50. package/src/codex-route.mjs +113 -0
  51. package/src/credentials.mjs +46 -8
  52. package/src/dataset.mjs +18 -7
  53. package/src/event-store.mjs +10 -2
  54. package/src/ficha.mjs +142 -0
  55. package/src/files.mjs +36 -2
  56. package/src/lease.mjs +5 -0
  57. package/src/market-check.mjs +1 -1
  58. package/src/market-remote.mjs +135 -1
  59. package/src/mcp/image-server.mjs +1 -1
  60. package/src/mcp/memory-server.mjs +10 -0
  61. package/src/memory-tools.mjs +3 -0
  62. package/src/memory.mjs +29 -4
  63. package/src/models.mjs +21 -3
  64. package/src/modules/ahp.mjs +8 -3
  65. package/src/modules/bishop-exam.mjs +41 -12
  66. package/src/modules/bishop.mjs +2 -2
  67. package/src/modules/choices.mjs +12 -10
  68. package/src/modules/fetch-alone.mjs +7 -0
  69. package/src/modules/helpers.mjs +23 -5
  70. package/src/modules/image-studio.mjs +13 -27
  71. package/src/modules/index.mjs +54 -11
  72. package/src/modules/isolated.mjs +160 -0
  73. package/src/modules/ollama.mjs +35 -6
  74. package/src/modules/playwright.mjs +46 -17
  75. package/src/modules/run-alone.mjs +122 -0
  76. package/src/modules/runs.mjs +11 -8
  77. package/src/modules/sdk.mjs +4 -2
  78. package/src/notices-key.mjs +8 -0
  79. package/src/notices.mjs +185 -0
  80. package/src/ollama.mjs +57 -15
  81. package/src/outbound.mjs +45 -8
  82. package/src/room/archivist.mjs +30 -5
  83. package/src/room/busy.mjs +16 -0
  84. package/src/room/control.mjs +36 -6
  85. package/src/room/guard.mjs +32 -2
  86. package/src/room/prompt.mjs +32 -5
  87. package/src/room/vectors.mjs +7 -1
  88. package/src/room.mjs +94 -28
  89. package/src/router.mjs +1 -1
  90. package/src/runs.mjs +39 -0
  91. package/src/runtime-detection.mjs +46 -6
  92. package/src/salas.mjs +151 -15
  93. package/src/server.mjs +577 -80
  94. package/src/service.mjs +116 -0
  95. package/src/setup-trouble.mjs +20 -1
  96. package/src/skill-check.mjs +269 -0
  97. package/src/skills-import.mjs +128 -0
  98. package/src/skills.mjs +492 -0
  99. package/src/tour.mjs +14 -3
  100. package/src/whats-new.mjs +48 -0
  101. package/src/rumbo.mjs +0 -337
package/public/tips.js ADDED
@@ -0,0 +1,124 @@
1
+ // SPDX-License-Identifier: BUSL-1.1
2
+ // MADRE · © 2026 Jossue Alcalá · Business Source License 1.1: LICENSE
3
+ // TIPS (2026-11-07): one small, solid label for every key that explains itself, in Home and in every
4
+ // project, instead of the browser's own (late, and drawn differently by each one). A key keeps
5
+ // saying what it says through `title`: when the pointer rests on it or the keyboard lands on it,
6
+ // the words move to `data-tip` for as long as the tip shows (so the browser's tip does not show
7
+ // too) and go back after. A key with no words of its own keeps them as its accessible name.
8
+ //
9
+ // One element for the whole page, under the key or over it when there is no room, never under the
10
+ // pointer's way, gone at the first press, scroll or key. Nothing shows on touch.
11
+
12
+ const SHOW_AFTER = 380; // ms resting on a key before its tip shows
13
+ const AGAIN_WITHIN = 600; // ms after one hides in which the next shows at once
14
+ const GAP = 7;
15
+
16
+ let tip = null;
17
+ let current = null;
18
+ let timer = null;
19
+ let hiddenAt = 0;
20
+ let pending = null; // the key a tip is waiting to show for
21
+
22
+ // A key that already shows its own label (an agent's sphere in the crew's column) says `data-tip-off`.
23
+ const keyOf = (target) => {
24
+ const key = target?.closest?.('button[title], [role="button"][title], a[title], label[title], summary[title], [data-tip]') ?? null;
25
+ return key && !key.closest('[data-tip-off]') ? key : null;
26
+ };
27
+
28
+ function ensure() {
29
+ if (tip?.isConnected) return tip;
30
+ tip = document.createElement('div');
31
+ tip.className = 'madre-tip';
32
+ tip.setAttribute('role', 'tooltip');
33
+ tip.hidden = true;
34
+ document.body.append(tip);
35
+ return tip;
36
+ }
37
+
38
+ function words(key) {
39
+ const said = key.getAttribute('title');
40
+ if (said) {
41
+ // The words leave `title` while the tip is up, and the key keeps a name if it had none.
42
+ key.dataset.tip = said;
43
+ key.removeAttribute('title');
44
+ if (!key.getAttribute('aria-label') && !key.textContent.trim()) key.setAttribute('aria-label', said);
45
+ }
46
+ return key.dataset.tip ?? '';
47
+ }
48
+
49
+ function restore(key) {
50
+ if (!key?.dataset?.tip) return;
51
+ key.setAttribute('title', key.dataset.tip);
52
+ delete key.dataset.tip;
53
+ }
54
+
55
+ function place(key) {
56
+ const node = ensure();
57
+ const box = key.getBoundingClientRect();
58
+ node.hidden = false;
59
+ node.classList.remove('shown');
60
+ const own = node.getBoundingClientRect();
61
+ const below = box.bottom + GAP + own.height <= window.innerHeight - 4;
62
+ const top = below ? box.bottom + GAP : box.top - GAP - own.height;
63
+ const left = Math.min(Math.max(4, box.left + box.width / 2 - own.width / 2), window.innerWidth - own.width - 4);
64
+ node.style.transform = `translate(${Math.round(left)}px, ${Math.round(top)}px)`;
65
+ node.dataset.side = below ? 'below' : 'above';
66
+ requestAnimationFrame(() => node.classList.add('shown'));
67
+ }
68
+
69
+ function show(key) {
70
+ const said = words(key);
71
+ if (!said) return;
72
+ current = key;
73
+ const node = ensure();
74
+ node.textContent = said;
75
+ place(key);
76
+ }
77
+
78
+ export function hideTip() {
79
+ clearTimeout(timer);
80
+ timer = null;
81
+ pending = null;
82
+ if (current) { restore(current); hiddenAt = performance.now(); }
83
+ current = null;
84
+ if (tip) { tip.classList.remove('shown'); tip.hidden = true; }
85
+ }
86
+
87
+ function arm(key) {
88
+ if (key === current) return;
89
+ hideTip();
90
+ const soon = performance.now() - hiddenAt < AGAIN_WITHIN;
91
+ pending = key;
92
+ timer = setTimeout(() => { pending = null; show(key); }, soon ? 0 : SHOW_AFTER);
93
+ }
94
+
95
+ export function installTips(root = globalThis.document) {
96
+ // A page without a document or events (the tests' stand-in window) has no tips to show.
97
+ if (!root || typeof root.addEventListener !== 'function' || typeof globalThis.window?.addEventListener !== 'function' || root.__madreTips) return;
98
+ root.__madreTips = true;
99
+ root.addEventListener('pointerover', (event) => {
100
+ if (event.pointerType === 'touch') return;
101
+ const key = keyOf(event.target);
102
+ if (key) arm(key);
103
+ });
104
+ root.addEventListener('pointerout', (event) => {
105
+ const key = keyOf(event.target);
106
+ if (!key || key.contains(event.relatedTarget)) return;
107
+ hideTip();
108
+ });
109
+ root.addEventListener('focusin', (event) => {
110
+ const key = keyOf(event.target);
111
+ if (key && key.matches(':focus-visible')) arm(key);
112
+ });
113
+ root.addEventListener('focusout', () => hideTip());
114
+ for (const type of ['pointerdown', 'keydown', 'wheel']) root.addEventListener(type, () => hideTip(), { capture: true, passive: true });
115
+ // Only a scroll that moves the key hides its tip: the room has rows that scroll on their own (the
116
+ // suggestions), and every one of their steps used to hide the tip before it ever showed.
117
+ window.addEventListener('scroll', (event) => {
118
+ const key = current ?? pending;
119
+ if (!key) return;
120
+ const moved = event.target === document || event.target === document.documentElement || event.target?.contains?.(key);
121
+ if (moved) hideTip();
122
+ }, { capture: true, passive: true });
123
+ window.addEventListener('blur', () => hideTip());
124
+ }
@@ -56,18 +56,18 @@ export const CHAPTERS = [
56
56
  {
57
57
  id: 'home',
58
58
  title: { es: 'Inicio', en: 'Home' },
59
- lead: { es: 'Aquí ves todos tus proyectos. Un clic abre uno.', en: 'Here you see all your projects. One click opens one.' },
59
+ lead: { es: 'Aquí viven todos tus proyectos. Le das clic a uno y entras.', en: 'All your projects live here. Click one and you are in.' },
60
60
  news: { kind: 'new', es: 'En 0.7.2 cada proyecto se abría por su cuenta con <code>madre start</code>; Inicio los reúne a todos.', en: 'In 0.7.2 each project opened on its own with <code>madre start</code>; Home gathers them all.' },
61
61
  points: {
62
62
  es: [
63
- 'Agrega la carpeta de cada proyecto. Ninguno se abre hasta que tú lo pidas, y agregarla no cambia nada de lo que hay dentro.',
64
- 'Con clic derecho o ⋯ en un proyecto lo anclas a la barra o lo quitas de MADRE. Su carpeta se queda como está.',
65
- 'Acomoda Inicio a tu gusto: arrastra las tarjetas o haz clic derecho en una para cambiarla de tamaño. «Te necesita» y «Resumen reciente» te cuentan qué pasó mientras no estabas.',
63
+ 'Cada proyecto es una carpeta tuya. Traerla aquí no la mueve ni le cambia nada, y no se abre hasta que tú quieras.',
64
+ '¿Uno que usas diario? Clic derecho (o ⋯) y lo anclas a la barra de arriba. Desde ese mismo menú lo quitas de MADRE si ya no lo quieres aquí; su carpeta se queda intacta.',
65
+ 'Inicio se acomoda como tu escritorio: arrastra las tarjetas o cámbiales el tamaño con clic derecho. «Te necesita» y «Resumen reciente» te cuentan lo que pasó mientras no estabas.',
66
66
  ],
67
67
  en: [
68
- 'Add the folder of each project. None opens until you ask, and adding it changes nothing inside.',
69
- 'Right-click or ⋯ on a project to pin it to the bar or take it out of MADRE. Its folder stays as it is.',
70
- 'Arrange Home your way: drag the cards, or right-click one to change its size. «Needs you» and «Recent summary» tell you what happened while you were away.',
68
+ 'Each project is a folder of yours. Bringing it here does not move it or change anything in it, and it does not open until you want it to.',
69
+ 'One you use every day? Right-click it (or ⋯) and pin it to the bar at the top. From that same menu you take it out of MADRE if you no longer want it here; its folder stays untouched.',
70
+ 'Home arranges itself like your desk: drag the cards, or right-click one to change its size. «Needs you» and «Recent summary» tell you what happened while you were away.',
71
71
  ],
72
72
  },
73
73
  keys: [
@@ -129,23 +129,23 @@ export const CHAPTERS = [
129
129
  {
130
130
  id: 'widgets',
131
131
  title: { es: 'Widgets', en: 'Widgets' },
132
- lead: { es: 'Tarjetas que te dicen cómo va tu Mac y cada proyecto. Solo aparecen las que tienen algo que contar.', en: 'Cards that tell you how your Mac and each project are doing. Only those with something to tell show up.' },
132
+ lead: { es: 'Tarjetas pequeñas que te cuentan cómo va tu Mac y cada proyecto. Solo aparecen cuando tienen algo que decirte.', en: 'Small cards that tell you how your Mac and each project are doing. They only show up when they have something to say.' },
133
133
  news: { kind: 'new', es: 'Nuevos: tarjetas con lo que pasa en tu Mac y en tus proyectos. Se agregan con clic derecho en Inicio › Agregar a Inicio.', en: 'New: cards with what happens on your Mac and in your projects. Add them with right-click in Home › Add to Home.' },
134
134
  since: { kind: 'new', es: 'Llegaron después de 1.0. Se agregan con clic derecho en Inicio › Agregar a Inicio.', en: 'They came after 1.0. Add them with right-click in Home › Add to Home.' },
135
135
  points: {
136
136
  es: [
137
- '<b>Recursos del sistema</b>: qué tan ocupada está tu Mac y cuánta memoria le queda libre.',
138
- '<b>Servidores</b>: las páginas y apps que tus proyectos tienen encendidas, y si responden. Para verlas, enciende la Vista previa en el proyecto.',
139
- '<b>Calidad de la memoria</b>: cuánto ha aprendido cada proyecto abierto y qué le falta.',
140
- '<b>Entrenamiento del Coordinador</b>: cuánto le falta al Coordinador para tener un modelo propio.',
141
- '<b>Modelos locales</b>: la IA que corre en tu Mac, sus modelos y cuántos ejemplos lleva cada proyecto para aprender a tu manera (8/300 quiere decir 8 de 300). Ahí mismo eliges qué proyectos la usan.',
137
+ '<b>Recursos del sistema</b>: qué tan cargada está tu Mac y cuánta memoria le queda.',
138
+ '<b>Servidores</b>: las páginas y apps que tus proyectos tienen prendidas, y si contestan. Para verlas, prende la Vista previa dentro del proyecto.',
139
+ '<b>Calidad de la memoria</b>: cuánto ha aprendido cada proyecto abierto y qué le falta saber.',
140
+ '<b>Entrenamiento del Coordinador</b>: cuánto le falta al Coordinador para tener su propio modelo.',
141
+ '<b>Modelos locales</b>: la IA que corre en tu Mac, sus modelos y cuántos ejemplos junta cada proyecto para aprender cómo trabajas (8/300 es 8 de 300). Ahí mismo eliges qué proyectos la usan.',
142
142
  ],
143
143
  en: [
144
- '<b>System resources</b>: how busy your Mac is and how much memory it has free.',
145
- '<b>Servers</b>: the pages and apps your projects have running, and whether they answer. To see them, turn Preview on in the project.',
146
- '<b>Memory quality</b>: how much each open project has learned and what it still lacks.',
144
+ '<b>System resources</b>: how busy your Mac is and how much memory it has left.',
145
+ '<b>Servers</b>: the pages and apps your projects have running, and whether they answer. To see them, turn Preview on inside the project.',
146
+ '<b>Memory quality</b>: how much each open project has learned and what it still needs to know.',
147
147
  '<b>Coordinator training</b>: how far the Coordinator is from a model of its own.',
148
- '<b>Local models</b>: the AI that runs on your Mac, its models and how many examples each project has to learn your way (8/300 means 8 of 300). Right there you choose which projects use it.',
148
+ '<b>Local models</b>: the AI that runs on your Mac, its models and how many examples each project gathers to learn how you work (8/300 is 8 of 300). Right there you choose which projects use it.',
149
149
  ],
150
150
  },
151
151
  keys: [
@@ -157,18 +157,18 @@ export const CHAPTERS = [
157
157
  {
158
158
  id: 'project',
159
159
  title: { es: 'Tu proyecto', en: 'Your project' },
160
- lead: { es: 'Dentro de un proyecto están sus chats, sus archivos y su memoria.', en: 'Inside a project are its chats, its files and its memory.' },
160
+ lead: { es: 'Al entrar a un proyecto tienes todo junto: tus conversaciones, tus archivos y lo que MADRE recuerda de él.', en: 'Inside a project you have it all together: your conversations, your files and what MADRE remembers about it.' },
161
161
  news: { kind: 'changed', es: 'Hay una segunda barra y un panel para cambiar de proyecto. Además, los paneles se abren al lado o en una ventana que puedes mover.', en: 'The second bar and Switch project are new, and panels open beside you or in a window you move.' },
162
162
  points: {
163
163
  es: [
164
- 'La barra de arriba te lleva a Inicio, a otro proyecto abierto o a Ajustes.',
165
- 'El botón de proyectos te muestra los que tienes abiertos. Una luz te avisa si alguien te espera, si un agente está trabajando o si algo ya terminó.',
166
- 'Puedes abrir otro chat al lado o en una ventana aparte, y mover cada ventana adonde menos estorbe.',
164
+ 'La barra de arriba es tu camino de regreso: a Inicio, a otro proyecto abierto o a Ajustes.',
165
+ 'El botón de proyectos te enseña los que tienes abiertos. Una lucecita te avisa si alguien te espera, si una IA está trabajando o si algo ya quedó.',
166
+ '¿Quieres dos conversaciones a la vez? Abre otra al lado o en su propia ventana, y mueve cada una adonde no te estorbe.',
167
167
  ],
168
168
  en: [
169
- 'The bar at the top takes you to Home, to another open project or to Settings.',
170
- 'The projects key shows the ones you have open. A light tells you if someone is waiting for you, if an agent is working or if something is done.',
171
- 'You can open another chat beside this one or in a window of its own, and move each window to where it is least in the way.',
169
+ 'The bar at the top is your way back: to Home, to another open project or to Settings.',
170
+ 'The projects key shows the ones you have open. A small light tells you if someone is waiting for you, if an AI is working or if something is done.',
171
+ 'Two conversations at once? Open another beside this one or in a window of its own, and move each one to where it is not in your way.',
172
172
  ],
173
173
  },
174
174
  keys: [
@@ -181,18 +181,18 @@ export const CHAPTERS = [
181
181
  {
182
182
  id: 'talk',
183
183
  title: { es: 'Hablar con los agentes', en: 'Talking to your agents' },
184
- lead: { es: 'Escribes en la caja de abajo y el agente que elegiste te contesta.', en: 'You write in the box at the bottom and the agent you chose answers.' },
184
+ lead: { es: 'Escribes en la caja de abajo, como le escribirías a alguien, y la IA que elegiste te contesta.', en: 'You write in the box at the bottom, the way you would write to someone, and the AI you chose answers.' },
185
185
  news: { kind: 'changed', es: 'Llegan dos módulos: Esfuerzo sugerido, que te propone bajo la caja cuánto debe pensar cada agente, y GitHub, que agrega el comando /gh.', en: 'New here: the Suggested effort module, which proposes under the box how hard each agent should think, and /gh, with the GitHub module.' },
186
186
  points: {
187
187
  es: [
188
- 'Elige con quién hablar en el círculo junto a la caja de texto. Debajo de la caja decides cuánto puede hacer, qué modelo usa y cuánto debe pensar.',
189
- 'Atajos al escribir: @ para llamar a un agente, # para el permiso, ! para señalar un archivo y / para un comando.',
190
- 'Cada respuesta se puede copiar, calificar o contestar.',
188
+ 'En el círculo junto a la caja escoges con quién hablar. Debajo decides cuánto puede hacer, qué modelo usa y qué tanto debe pensar antes de contestar.',
189
+ 'Unos atajos mientras escribes: @ llama a una IA, # cambia el permiso, ! señala un archivo y / abre un comando.',
190
+ 'Cada respuesta la puedes copiar, calificar o contestar directo.',
191
191
  ],
192
192
  en: [
193
- 'Choose who to talk to in the circle beside the text box. Under the box you decide how much it may do, which model it uses and how hard it should think.',
194
- 'Shortcuts as you type: @ to call an agent, # for the permission, ! to point at a file and / for a command.',
195
- 'Every answer can be copied, rated or replied to.',
193
+ 'In the circle beside the box you choose who to talk to. Under it you decide how much it may do, which model it uses and how hard it should think before answering.',
194
+ 'A few shortcuts as you type: @ calls an AI, # changes the permission, ! points at a file and / opens a command.',
195
+ 'Every answer can be copied, rated or replied to right there.',
196
196
  ],
197
197
  },
198
198
  keys: [
@@ -206,18 +206,18 @@ export const CHAPTERS = [
206
206
  {
207
207
  id: 'modes',
208
208
  title: { es: 'Modos y permisos', en: 'Modes and permissions' },
209
- lead: { es: 'Cada mensaje lleva un permiso: lo que el agente puede hacer con él.', en: 'Every message carries a permission: what the agent may do with it.' },
209
+ lead: { es: 'Cada mensaje lleva un permiso: hasta dónde puede llegar la IA con lo que le pides.', en: 'Every message carries a permission: how far the AI may go with what you ask.' },
210
210
  news: { kind: 'changed', es: '#4 AIRLOCK ahora se llama #4 Acceso total. Tú eliges cómo confirmar #3 y #4, y una confirmación puede valer unos minutos.', en: '#4 AIRLOCK is now #4 Full access. You choose which key opens #3 and #4, and an accepted key can last a few minutes.' },
211
211
  points: {
212
212
  es: [
213
- 'Hay cinco niveles, de menos a más: #0 Incógnito, #1 Solo conversar, #2 Crear, #3 Editar y #4 Acceso total.',
214
- 'Con #3 y #4, MADRE te pide confirmar antes de que el agente toque algo, y con #4 te lo pide dos veces. Cómo confirmas lo eliges en Ajustes › Permisos.',
215
- 'Si quieres, una confirmación puede durar unos minutos. Mientras dura, la ves junto a la caja de texto.',
213
+ 'Son cinco niveles, de menos a más: #0 Incógnito, #1 Solo conversar, #2 Crear, #3 Editar y #4 Acceso total. Si solo quieres platicar, con #1 basta.',
214
+ 'Con #3 y #4 la IA puede cambiar lo que ya existe, así que MADRE te pide confirmar antes; con #4, dos veces. Cómo confirmas lo eliges en Ajustes › Permisos.',
215
+ 'Si vas a trabajar un buen rato, una confirmación puede durar unos minutos. Mientras dura, la ves junto a la caja.',
216
216
  ],
217
217
  en: [
218
- 'There are five levels, from least to most: #0 Incognito, #1 Chat only, #2 Create, #3 Edit and #4 Full access.',
219
- 'With #3 and #4, MADRE asks you to confirm before the agent touches anything, and with #4 it asks twice. How you confirm, you choose in Settings › Permissions.',
220
- 'If you like, a confirmation can last a few minutes. While it does, you see it beside the text box.',
218
+ 'There are five levels, from least to most: #0 Incognito, #1 Chat only, #2 Create, #3 Edit and #4 Full access. If you only want to talk, #1 is enough.',
219
+ 'With #3 and #4 the AI can change what already exists, so MADRE asks you to confirm first; with #4, twice. How you confirm, you choose in Settings › Permissions.',
220
+ 'If you are going to work for a while, a confirmation can last a few minutes. While it does, you see it beside the box.',
221
221
  ],
222
222
  },
223
223
  keys: [[{ es: 'Elegir el modo al escribir', en: 'Choose the mode as you type' }, '#']],
@@ -226,18 +226,18 @@ export const CHAPTERS = [
226
226
  {
227
227
  id: 'coordinator',
228
228
  title: { es: 'El Coordinador', en: 'The Coordinator' },
229
- lead: { es: 'Un agente que ve todos tus proyectos y puede pasar instrucciones de uno a otro.', en: 'An agent that sees all your projects and can pass instructions from one to another.' },
229
+ lead: { es: 'El que ve todos tus proyectos a la vez y puede pasar encargos de uno a otro.', en: 'The one that sees all your projects at once and can pass tasks from one to another.' },
230
230
  news: { kind: 'new', es: 'En 0.7.2 cada proyecto trabajaba por su cuenta; ahora un agente los ve todos.', en: 'In 0.7.2 each project worked on its own; now one agent sees them all.' },
231
231
  points: {
232
232
  es: [
233
- 'Le hablas en su propio espacio, desde Inicio. Puede consultar lo que pasa en cada proyecto.',
234
- 'Desde cualquier proyecto le preguntas con /bishop. Su respuesta solo la ves tú.',
235
- 'Por su cuenta llega hasta #2. Si algo necesita #3 o #4, te deja una propuesta y tú decides en ese proyecto.',
233
+ 'Le hablas en su propio espacio, desde Inicio, y puede asomarse a lo que pasa en cada proyecto. Pregúntale, por ejemplo, «¿qué quedó pendiente esta semana?».',
234
+ 'Desde cualquier proyecto le preguntas escribiendo /bishop. Su respuesta solo la ves tú.',
235
+ 'Por su cuenta llega hasta #2. Si algo necesita #3 o #4, te deja la propuesta y tú decides en ese proyecto.',
236
236
  ],
237
237
  en: [
238
- 'You talk to it in its own space, from Home. It can look up what is going on in each project.',
239
- 'From any project you ask it with /bishop. Only you see its answer.',
240
- 'On its own it goes up to #2. If something needs #3 or #4, it leaves you a proposal and you decide in that project.',
238
+ 'You talk to it in its own space, from Home, and it can look into what is going on in each project. Ask it, for example, «what was left pending this week?».',
239
+ 'From any project you ask it by writing /bishop. Only you see its answer.',
240
+ 'On its own it goes up to #2. If something needs #3 or #4, it leaves you the proposal and you decide in that project.',
241
241
  ],
242
242
  },
243
243
  keys: [[{ es: 'Preguntarle desde un proyecto', en: 'Ask it from a project' }, '/bishop']],
@@ -246,18 +246,18 @@ export const CHAPTERS = [
246
246
  {
247
247
  id: 'links',
248
248
  title: { es: 'Conexiones', en: 'Connections' },
249
- lead: { es: 'Un proyecto puede aprender de otro, si tú lo permites.', en: 'One project can learn from another, if you allow it.' },
249
+ lead: { es: 'Un proyecto puede aprender de otro, solo si tú le das permiso.', en: 'One project can learn from another, only if you give it permission.' },
250
250
  news: { kind: 'new', es: 'En 0.7.2, «Conexiones» era iniciar sesión de tus agentes; ahora une dos proyectos.', en: 'In 0.7.2, «Connections» was signing your agents in; now it joins two projects.' },
251
251
  points: {
252
252
  es: [
253
- 'Tú firmas cada conexión: qué puede consultar, por cuánto tiempo y si el Coordinador puede dar instrucciones.',
254
- 'Solo se comparten notas que ya se usan, sin datos privados. Tus archivos y tus chats nunca salen del proyecto.',
255
- 'En Conexiones, en Inicio, cada una se ve como en el mapa: quién consulta a quién, qué comparte y hasta cuándo. Cada opción dice qué hace, y «Cancelar conexión» la termina cuando quieras.',
253
+ 'Cada conexión la firmas tú: qué puede consultar, por cuánto tiempo y si el Coordinador puede pasar encargos.',
254
+ 'Solo se comparten notas que ya están en uso, sin datos privados. Tus archivos y tus conversaciones nunca salen de su proyecto.',
255
+ 'En Conexiones, en Inicio, ves cada una como en el mapa: quién consulta a quién, qué comparte y hasta cuándo. «Cancelar conexión» la termina cuando quieras.',
256
256
  ],
257
257
  en: [
258
- 'You sign every connection: what it may look up, for how long and whether the Coordinator may give instructions.',
259
- 'Only notes already in use are shared, without private data. Your files and your chats never leave the project.',
260
- 'In Connections, in Home, each one reads as on the map: who looks up whom, what it shares and until when. Each option says what it does, and «Cancel the connection» ends it whenever you want.',
258
+ 'You sign every connection: what it may look up, for how long and whether the Coordinator may pass tasks.',
259
+ 'Only notes already in use are shared, without private data. Your files and your conversations never leave their project.',
260
+ 'In Connections, in Home, you see each one as on the map: who looks up whom, what it shares and until when. «Cancel the connection» ends it whenever you want.',
261
261
  ],
262
262
  },
263
263
  since: { kind: 'changed', es: 'El mapa de Conexiones en Inicio ahora es un cielo: cada proyecto es una estrella y cada conexión, un flujo de luz. Ábrelo en una ventana para explorarlo.', en: 'The Connections map in Home is now a sky: every project is a star and every connection a flow of light. Open it in a window to explore it.' },
@@ -267,13 +267,13 @@ export const CHAPTERS = [
267
267
  {
268
268
  id: 'maps',
269
269
  title: { es: 'Los mapas', en: 'The maps' },
270
- lead: { es: 'Dos dibujos: lo que MADRE recuerda de un proyecto y cómo se conectan tus proyectos.', en: 'Two drawings: what MADRE remembers about a project, and how your projects connect.' },
270
+ lead: { es: 'Dos dibujos para ver de un vistazo lo que MADRE recuerda de un proyecto y cómo se conectan tus proyectos.', en: 'Two drawings to see at a glance what MADRE remembers about a project and how your projects connect.' },
271
271
  news: { kind: 'changed', es: 'NOSTROMO ahora es el Mapa de memoria, con su tecla en la barra; el Mapa de proyectos es nuevo.', en: 'NOSTROMO is now the Memory map, with its key on the bar; the Project map is new.' },
272
272
  points: {
273
273
  es: [
274
- 'El Mapa de memoria, en la barra del proyecto, dibuja como una estrella cada cosa que MADRE recuerda de él.',
275
- 'El Mapa de proyectos, en Inicio, muestra tus proyectos y sus conexiones. Necesita una pantalla de al menos 900 px de ancho.',
276
- 'Para conectar dos proyectos, arrastra uno sobre el otro en el Mapa de proyectos.',
274
+ 'El Mapa de memoria, en la barra del proyecto, pinta como una estrella cada cosa que MADRE recuerda de él.',
275
+ 'El Mapa de proyectos, en Inicio, enseña tus proyectos y sus conexiones. Necesita una pantalla de al menos 900 px de ancho.',
276
+ 'Para conectar dos proyectos, arrastra uno encima del otro en el Mapa de proyectos.',
277
277
  ],
278
278
  en: [
279
279
  'The Memory map, on the project\'s bar, draws as a star each thing MADRE remembers about it.',
@@ -292,19 +292,19 @@ export const CHAPTERS = [
292
292
  {
293
293
  id: 'settings',
294
294
  title: { es: 'Diagnóstico y Ajustes', en: 'Diagnostics and Settings' },
295
- lead: { es: 'En Ajustes cambias cómo se ve y cómo trabaja MADRE. Diagnóstico te ayuda cuando algo falla.', en: 'In Settings you change how MADRE looks and works. Diagnostics helps when something fails.' },
295
+ lead: { es: 'Ajustes es donde cambias cómo se ve y cómo trabaja MADRE. Diagnóstico te ayuda cuando algo falla.', en: 'Settings is where you change how MADRE looks and works. Diagnostics helps you when something fails.' },
296
296
  since: { kind: 'changed', es: 'Los Ajustes de Inicio suman IA local. En Ajustes › Agentes cada agente se pliega, y OpenCode agrupa sus modelos por proveedor.', en: 'Home\'s Settings gain Local AI. In Settings › Agents each agent folds, and OpenCode groups its models by provider.' },
297
297
  news: { kind: 'new', es: 'Lo que estaba repartido entre MU/TH/UR, ⚙ CONEXIONES y la barra ahora está en una ventana con buscador, y Diagnóstico te da la solución.', en: 'What was spread across MU/TH/UR, ⚙ CONNECTIONS and the bar now lives in one window with a search, and Diagnostics gives you the remedy.' },
298
298
  points: {
299
299
  es: [
300
- 'Ábrelos con ⌘ , y escribe / para buscar cualquier ajuste. Lo que cambias se aplica en ese momento.',
301
- 'En Apariencia eliges los colores, el fondo, el tema claro u oscuro y el idioma.',
302
- 'Si algo no funciona, abre Diagnóstico y cuéntale qué pasa con tus palabras: te dice qué hacer y te da el botón para arreglarlo. Cuando algo falla al instalar, «Ver cómo arreglarlo» te da los pasos para tu sistema.',
300
+ 'Ábrelos con ⌘ , y escribe / para encontrar cualquier ajuste. Lo que cambias se aplica al instante.',
301
+ 'En Apariencia escoges colores, fondo, tema claro u oscuro e idioma. En Automático, MADRE se pone clara u oscura igual que tu sistema.',
302
+ '¿Algo no funciona? Abre Diagnóstico y cuéntale qué pasa con tus palabras: te dice qué hacer y te da el botón para arreglarlo. Si algo falla al instalar, «Ver cómo arreglarlo» te da los pasos para tu sistema.',
303
303
  ],
304
304
  en: [
305
- 'Open them with ⌘ , and type / to find any setting. What you change applies right away.',
306
- 'In Appearance you choose the colours, the background, light or dark and the language.',
307
- 'If something does not work, open Diagnostics and tell it what happens in your own words: it says what to do and gives you the key that fixes it. When an install fails, «See how to fix it» gives you the steps for your system.',
305
+ 'Open them with ⌘ , and type / to find any setting. What you change applies at once.',
306
+ 'In Appearance you choose colours, background, light or dark and language. On Automatic, MADRE goes light or dark the same as your system.',
307
+ 'Something not working? Open Diagnostics and tell it what happens in your own words: it says what to do and gives you the key that fixes it. When an install fails, «See how to fix it» gives you the steps for your system.',
308
308
  ],
309
309
  },
310
310
  keys: [
@@ -317,16 +317,16 @@ export const CHAPTERS = [
317
317
  {
318
318
  id: 'modules',
319
319
  title: { es: 'Módulos', en: 'Modules' },
320
- lead: { es: 'Funciones que enciendes cuando las necesitas. Apagadas, no hacen nada.', en: 'Features you turn on when you need them. While off, they do nothing.' },
320
+ lead: { es: 'Funciones extra que prendes cuando las necesitas. Apagadas, ni se notan.', en: 'Extra features you turn on when you need them. While off, you will not notice them.' },
321
321
  news: { kind: 'changed', es: 'Ahora son un tablero de mosaicos, como apps. ash ahora se llama Ahorro de tokens, y llegan Esfuerzo sugerido y GitHub.', en: 'They are now a board of tiles, like apps; ash is Token saver, and Suggested effort and GitHub join them.' },
322
322
  points: {
323
323
  es: [
324
- 'Cada mosaico tiene su interruptor. Tócalo para ver qué hace antes de encenderlo.',
324
+ 'Cada mosaico tiene su interruptor. Tócalo primero para ver qué hace, antes de prenderlo.',
325
325
  'Algunos, como Ahorro de tokens, Esfuerzo sugerido y Notas, se abren en su propia ventana.',
326
- 'Antes de encender uno, MADRE te dice qué va a escribir y qué necesita. En el Mercado encuentras más.',
326
+ 'Antes de prender uno, MADRE te dice qué va a escribir y qué necesita. En el Mercado hay más.',
327
327
  ],
328
328
  en: [
329
- 'Every tile has its switch. Press it to see what it does before you turn it on.',
329
+ 'Every tile has its switch. Press the tile first to see what it does, before you turn it on.',
330
330
  'Some, such as Token saver, Suggested effort and Notes, open in their own window.',
331
331
  'Before you turn one on, MADRE tells you what it will write and what it needs. The Market has more.',
332
332
  ],
@@ -337,19 +337,19 @@ export const CHAPTERS = [
337
337
  {
338
338
  id: 'local',
339
339
  title: { es: 'IA local por proyecto', en: 'Local AI by project' },
340
- lead: { es: 'Una IA que corre en tu Mac, gratis y sin internet. Tú eliges qué proyectos la usan.', en: 'An AI that runs on your Mac, free and offline. You choose which projects use it.' },
340
+ lead: { es: 'Una IA que vive en tu Mac: gratis, sin internet, y tú decides qué proyectos la usan.', en: 'An AI that lives on your Mac: free, offline, and you decide which projects use it.' },
341
341
  news: { kind: 'changed', es: 'En 0.7.2 la IA local era todo o nada; ahora se elige proyecto por proyecto.', en: 'In 0.7.2 the local AI was all or nothing; now it is chosen project by project.' },
342
342
  since: { kind: 'new', es: 'En 1.0 la IA local era todo o nada; ahora se elige proyecto por proyecto.', en: 'In 1.0 the local AI was all or nothing; now it is chosen project by project.' },
343
343
  points: {
344
344
  es: [
345
- 'Se configura en Inicio › Ajustes › IA local. Ahí eliges si la usan todos tus proyectos, solo los que tú enciendas, o si cada proyecto lo decide; y en «Dirección de Ollama», la de otra computadora de tu red.',
346
- 'MADRE te recomienda los modelos que caben en tu equipo y te dice cuánto pesan antes de descargarlos. Una descarga se puede cancelar: lo que ya bajó se queda y sigue desde ahí.',
347
- 'Un proyecto sin IA local sigue trabajando con tus agentes. Solo deja de buscar por significado, de resumir su memoria y de usar a @madre.',
345
+ 'Se ajusta en Inicio › Ajustes › IA local. Ahí escoges si la usan todos tus proyectos, solo los que prendas o si cada uno decide. Si en tu red hay otra computadora más potente, la conectas en «Dirección de Ollama».',
346
+ 'MADRE te recomienda los modelos que caben en tu equipo y te dice cuánto pesan antes de bajarlos. Si cancelas una descarga, lo que ya bajó se queda y sigue desde ahí.',
347
+ 'Un proyecto sin IA local sigue trabajando con tus IAs de siempre. Solo deja de buscar por significado, de resumir su memoria y de usar a @madre.',
348
348
  ],
349
349
  en: [
350
- 'It is set in Home › Settings › Local AI. There you choose whether all your projects use it, only the ones you switch on, or each project decides; and in «Ollama address», another computer\'s on your network.',
351
- 'MADRE recommends the models that fit your computer and tells you how big they are before you download them. A download can be cancelled: what arrived stays, and it picks up from there.',
352
- 'A project without the local AI keeps working with your agents. It only stops searching by meaning, summing up its memory and using @madre.',
350
+ 'It is set in Home › Settings › Local AI. There you choose whether all your projects use it, only the ones you switch on, or each one decides. If there is a more powerful computer on your network, you connect it in «Ollama address».',
351
+ 'MADRE recommends the models that fit your computer and tells you how big they are before you download them. If you cancel a download, what arrived stays, and it picks up from there.',
352
+ 'A project without the local AI keeps working with your usual AIs. It only stops searching by meaning, summing up its memory and using @madre.',
353
353
  ],
354
354
  },
355
355
  keys: [[{ es: 'Elegir proyectos', en: 'Choose projects' }, { es: 'Ajustes › IA local', en: 'Settings › Local AI' }]],
@@ -379,7 +379,7 @@ export const CHAPTERS = [
379
379
  {
380
380
  id: 'gestures',
381
381
  title: { es: 'Gestos y atajos', en: 'Gestures and shortcuts' },
382
- lead: { es: 'Todos los atajos en una hoja. La abres con la tecla ? en cualquier pantalla.', en: 'Every shortcut on one sheet. The ? key opens it on any screen.' },
382
+ lead: { es: 'Todos los atajos en una sola hoja. La abres con la tecla ? desde cualquier pantalla.', en: 'Every shortcut on one sheet. The ? key opens it from any screen.' },
383
383
  news: { kind: 'new', es: 'Los gestos y atajos de todo MADRE, juntos en una hoja por primera vez.', en: 'The gestures and shortcuts of all of MADRE, together on one sheet for the first time.' },
384
384
  since: { kind: 'changed', es: 'Suma los gestos del tablero de Inicio: acomodar, arrastrar y agregar tarjetas.', en: 'It adds the gestures of Home\'s board: arrange, drag and add cards.' },
385
385
  points: { es: [], en: [] },
package/public/tour.js CHANGED
@@ -372,8 +372,9 @@ export function startTour({ page, go = {}, ready = () => true, phone = false, de
372
372
  logo.setAttribute('aria-hidden', 'true');
373
373
  logo.innerHTML = MADRE_LOGO; // trusted: our own SVG string
374
374
  words.append(logo, el('span', 'wn-eyebrow'), title);
375
- const close = key('tour-close', null, () => windowNode.close());
376
- close.innerHTML = CLOSE_ICON; // trusted: our own SVG string
375
+ // The ✕ every window of MADRE has (1.1): it turns and goes red under the pointer.
376
+ const close = key('tour-close x-close x-only', null, () => windowNode.close());
377
+ close.innerHTML = `<span class="x-icon">${CLOSE_ICON}</span>`; // trusted: our own SVG string
377
378
  close.setAttribute('aria-label', t('Close'));
378
379
  head.append(words, close);
379
380
  const body = el('div', 'tour-body');
@@ -404,8 +405,12 @@ export function startTour({ page, go = {}, ready = () => true, phone = false, de
404
405
  current = shown;
405
406
  const back = path() === 'back';
406
407
  const since = path() === 'since';
407
- windowNode.querySelector('.tour-head .wn-eyebrow').textContent = since ? t('What is new since 1.0') : back ? t('The tour of MADRE 1.0') : t('Getting to know MADRE');
408
- windowNode.querySelector('#tour-window-title').textContent = since ? t('What changed since 1.0') : back ? t('What is new since 0.7.2') : t('The basics of MADRE');
408
+ // For someone new (1.1, 2026-11-08) the window is called what the welcome's last key called it,
409
+ // «Get to know MADRE», with nothing above it: it is the welcome's second part, not another thing.
410
+ const eyebrow = windowNode.querySelector('.tour-head .wn-eyebrow');
411
+ eyebrow.textContent = since ? t('What is new since 1.0') : back ? t('The tour of MADRE 1.0') : '';
412
+ eyebrow.hidden = !since && !back;
413
+ windowNode.querySelector('#tour-window-title').textContent = since ? t('What changed since 1.0') : back ? t('What is new since 0.7.2') : t('Getting to know MADRE');
409
414
  void keep({ chapter: chapter.id, at: chapter.id });
410
415
  if (!state.done.includes(chapter.id)) state.done = [...state.done, chapter.id];
411
416
  const list = chapters();
@@ -524,8 +529,8 @@ export function startTour({ page, go = {}, ready = () => true, phone = false, de
524
529
  const title = el('h2', null, t('Gestures and shortcuts'));
525
530
  title.id = 'tour-gestures-title';
526
531
  words.append(title);
527
- const close = key('tour-close', null, () => sheetNode.close());
528
- close.innerHTML = CLOSE_ICON; // trusted: our own SVG string
532
+ const close = key('tour-close x-close x-only', null, () => sheetNode.close());
533
+ close.innerHTML = `<span class="x-icon">${CLOSE_ICON}</span>`; // trusted: our own SVG string
529
534
  close.setAttribute('aria-label', t('Close'));
530
535
  head.append(words, close);
531
536
  const body = el('div', 'tour-gesture-body');
@@ -595,9 +600,32 @@ export function startTour({ page, go = {}, ready = () => true, phone = false, de
595
600
  card.append(keys);
596
601
  hintNode = card;
597
602
  void keep({ hint: id });
603
+ // Over a modal window (1.1, 2026-11-08): no longer inside its content, pushing it down, but a
604
+ // card of its own beside the window — on its right, else on its left, else over its top corner.
605
+ // It belongs to the window (so the window does not make it unreachable) and leaves with it.
598
606
  if (inside) {
599
- anchor.prepend(card);
600
- anchor.closest('dialog')?.addEventListener('close', done, { once: true });
607
+ const dialog = anchor.closest('dialog') ?? anchor;
608
+ card.classList.remove('inline');
609
+ card.classList.add('beside-window');
610
+ if (typeof card.showPopover === 'function') card.popover = 'manual';
611
+ dialog.append(card);
612
+ try { card.showPopover?.(); } catch { /* not a popover: inside the window */ }
613
+ const width = Math.min(300, window.innerWidth - 24);
614
+ card.style.width = `${width}px`;
615
+ const placeBeside = () => {
616
+ if (!card.isConnected) return;
617
+ const whole = dialog.getBoundingClientRect();
618
+ const framed = whole.width >= window.innerWidth - 4 && dialog.firstElementChild ? dialog.firstElementChild.getBoundingClientRect() : whole;
619
+ const height = card.getBoundingClientRect().height;
620
+ const top = Math.max(12, Math.min(window.innerHeight - height - 12, framed.top));
621
+ let left = framed.right - width - 16;
622
+ let at = top + 16;
623
+ if (window.innerWidth - framed.right >= width + 28) { left = framed.right + 16; at = top; } else if (framed.left >= width + 28) { left = framed.left - width - 16; at = top; }
624
+ Object.assign(card.style, { position: 'fixed', margin: '0', left: `${left}px`, top: `${at}px` });
625
+ };
626
+ placeBeside();
627
+ window.addEventListener('resize', placeBeside);
628
+ dialog.addEventListener('close', () => { window.removeEventListener('resize', placeBeside); done(); }, { once: true });
601
629
  return true;
602
630
  }
603
631
  if (typeof card.showPopover === 'function') card.popover = 'manual';