@jossuealcala/madre 1.0.5 → 1.1.0

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 (278) hide show
  1. package/ADDITIONAL-TERMS.md +7 -2
  2. package/CHANGELOG.en.md +47 -1
  3. package/CHANGELOG.md +47 -1
  4. package/CONTRIBUTING.md +2 -2
  5. package/LICENSE +111 -661
  6. package/NOTICE +28 -23
  7. package/README.en.md +30 -101
  8. package/README.md +30 -103
  9. package/SECURITY.md +1 -0
  10. package/TRADEMARKS.en.md +13 -14
  11. package/TRADEMARKS.md +24 -26
  12. package/bin/madre.cjs +2 -2
  13. package/bin/madre.mjs +112 -40
  14. package/docs/REFERENCE.md +52 -5
  15. package/docs/SDK.md +21 -3
  16. package/docs/en/REFERENCE.md +52 -5
  17. package/docs/en/SDK.md +22 -3
  18. package/docs/sdk/hello-module.mjs +3 -0
  19. package/package.json +3 -2
  20. package/public/abduction.js +6 -6
  21. package/public/activity.js +425 -0
  22. package/public/app.js +2468 -435
  23. package/public/assets/abduction-cat-blink.webp +0 -0
  24. package/public/assets/abduction-cat-control-left.webp +0 -0
  25. package/public/assets/abduction-cat-control-right.webp +0 -0
  26. package/public/assets/abduction-cat.webp +0 -0
  27. package/public/assets/manual/shots/en-agents.webp +0 -0
  28. package/public/assets/manual/shots/en-chats.webp +0 -0
  29. package/public/assets/manual/shots/en-code.webp +0 -0
  30. package/public/assets/manual/shots/en-composer.webp +0 -0
  31. package/public/assets/manual/shots/en-connectors.webp +0 -0
  32. package/public/assets/manual/shots/en-continuity.webp +0 -0
  33. package/public/assets/manual/shots/en-coordinator.webp +0 -0
  34. package/public/assets/manual/shots/en-copilot.webp +0 -0
  35. package/public/assets/manual/shots/en-diagnostics.webp +0 -0
  36. package/public/assets/manual/shots/en-home.webp +0 -0
  37. package/public/assets/manual/shots/en-local.webp +0 -0
  38. package/public/assets/manual/shots/en-market.webp +0 -0
  39. package/public/assets/manual/shots/en-memory.webp +0 -0
  40. package/public/assets/manual/shots/en-modes.webp +0 -0
  41. package/public/assets/manual/shots/en-notes.webp +0 -0
  42. package/public/assets/manual/shots/en-settings.webp +0 -0
  43. package/public/assets/manual/shots/en-welcome.webp +0 -0
  44. package/public/assets/manual/shots/en-windows.webp +0 -0
  45. package/public/assets/manual/shots/es-agents.webp +0 -0
  46. package/public/assets/manual/shots/es-chats.webp +0 -0
  47. package/public/assets/manual/shots/es-code.webp +0 -0
  48. package/public/assets/manual/shots/es-composer.webp +0 -0
  49. package/public/assets/manual/shots/es-connectors.webp +0 -0
  50. package/public/assets/manual/shots/es-continuity.webp +0 -0
  51. package/public/assets/manual/shots/es-coordinator.webp +0 -0
  52. package/public/assets/manual/shots/es-copilot.webp +0 -0
  53. package/public/assets/manual/shots/es-diagnostics.webp +0 -0
  54. package/public/assets/manual/shots/es-home.webp +0 -0
  55. package/public/assets/manual/shots/es-local.webp +0 -0
  56. package/public/assets/manual/shots/es-market.webp +0 -0
  57. package/public/assets/manual/shots/es-memory.webp +0 -0
  58. package/public/assets/manual/shots/es-modes.webp +0 -0
  59. package/public/assets/manual/shots/es-notes.webp +0 -0
  60. package/public/assets/manual/shots/es-settings.webp +0 -0
  61. package/public/assets/manual/shots/es-welcome.webp +0 -0
  62. package/public/assets/manual/shots/es-windows.webp +0 -0
  63. package/public/assets/news/1.1/en/chats.webp +0 -0
  64. package/public/assets/news/1.1/en/home.webp +0 -0
  65. package/public/assets/news/1.1/en/maps.webp +0 -0
  66. package/public/assets/news/1.1/en/market.webp +0 -0
  67. package/public/assets/news/1.1/en/permissions.webp +0 -0
  68. package/public/assets/news/1.1/en/privacy.webp +0 -0
  69. package/public/assets/news/1.1/en/welcome.webp +0 -0
  70. package/public/assets/news/1.1/es/chats.webp +0 -0
  71. package/public/assets/news/1.1/es/home.webp +0 -0
  72. package/public/assets/news/1.1/es/maps.webp +0 -0
  73. package/public/assets/news/1.1/es/market.webp +0 -0
  74. package/public/assets/news/1.1/es/permissions.webp +0 -0
  75. package/public/assets/news/1.1/es/privacy.webp +0 -0
  76. package/public/assets/news/1.1/es/welcome.webp +0 -0
  77. package/public/attribution.js +15 -16
  78. package/public/brands.js +2 -2
  79. package/public/code-tools.js +2 -2
  80. package/public/editor.js +13 -13
  81. package/public/en.js +413 -4
  82. package/public/es.js +1345 -483
  83. package/public/hardware.js +2 -2
  84. package/public/i18n.js +2 -2
  85. package/public/icons.js +158 -0
  86. package/public/index.html +66 -48
  87. package/public/inquiry.js +2 -2
  88. package/public/loader.js +271 -2
  89. package/public/macroverso.js +60 -21
  90. package/public/manual-content.js +412 -169
  91. package/public/manual-shots.js +38 -34
  92. package/public/manual.css +20 -2
  93. package/public/manual.html +1 -1
  94. package/public/manual.js +54 -25
  95. package/public/market-art.js +47 -45
  96. package/public/market-view.js +111 -33
  97. package/public/market.js +132 -30
  98. package/public/mcp-catalog.js +2 -2
  99. package/public/neural.js +64 -8
  100. package/public/nostromo-engine.js +709 -40
  101. package/public/page-errors.js +29 -0
  102. package/public/power.js +350 -11
  103. package/public/remedy.js +89 -0
  104. package/public/resay.js +3 -2
  105. package/public/review-ask.js +12 -7
  106. package/public/routing.js +3 -3
  107. package/public/salas-mac.css +703 -24
  108. package/public/salas-mac.html +26 -14
  109. package/public/salas-mac.js +1254 -289
  110. package/public/salas.css +2 -2
  111. package/public/salas.html +3 -3
  112. package/public/salas.js +3 -3
  113. package/public/styles.css +2404 -291
  114. package/public/syntax.js +2 -2
  115. package/public/terms.js +152 -0
  116. package/public/touch.js +2 -2
  117. package/public/tour-chapters.js +10 -10
  118. package/public/tour.js +56 -8
  119. package/public/troubleshooting.js +182 -11
  120. package/public/wallpaper.js +4 -3
  121. package/public/welcome.js +923 -0
  122. package/src/activity.mjs +85 -0
  123. package/src/adapters/claude.mjs +61 -35
  124. package/src/adapters/codex.mjs +18 -5
  125. package/src/adapters/cursor.mjs +5 -3
  126. package/src/adapters/gemini.mjs +5 -3
  127. package/src/adapters/madre.mjs +3 -3
  128. package/src/adapters/opencode.mjs +73 -10
  129. package/src/adapters/process.mjs +14 -13
  130. package/src/adapters/subagents.mjs +159 -0
  131. package/src/asking.mjs +8 -2
  132. package/src/auth-probe.mjs +27 -10
  133. package/src/bridge/devices.mjs +2 -2
  134. package/src/bridge/handoff.mjs +2 -2
  135. package/src/bridge/host.mjs +2 -2
  136. package/src/bridge/network.mjs +2 -2
  137. package/src/bridge/policy.mjs +3 -3
  138. package/src/bridge/qr.mjs +2 -2
  139. package/src/bridge/server.mjs +2 -2
  140. package/src/builtin-updates.mjs +87 -0
  141. package/src/capabilities.mjs +2 -2
  142. package/src/chats.mjs +51 -2
  143. package/src/checkpoint.mjs +67 -9
  144. package/src/choices.mjs +2 -2
  145. package/src/cli-args.mjs +2 -2
  146. package/src/cold.mjs +2 -2
  147. package/src/commands.mjs +2 -2
  148. package/src/config.mjs +2 -2
  149. package/src/conversation-context.mjs +2 -2
  150. package/src/credentials.mjs +56 -16
  151. package/src/dataset.mjs +2 -2
  152. package/src/directives.mjs +2 -2
  153. package/src/distiller.mjs +2 -2
  154. package/src/embeddings.mjs +2 -2
  155. package/src/enlaces.mjs +2 -2
  156. package/src/environment.mjs +147 -0
  157. package/src/event-store.mjs +2 -2
  158. package/src/exam.mjs +2 -2
  159. package/src/extensions.mjs +2 -2
  160. package/src/eyecat-watch.mjs +2 -2
  161. package/src/eyecat.mjs +2 -2
  162. package/src/file-ops.mjs +2 -2
  163. package/src/files.mjs +2 -2
  164. package/src/github.mjs +2 -2
  165. package/src/heartbeat.mjs +2 -2
  166. package/src/history.mjs +2 -2
  167. package/src/i18n.mjs +9 -2
  168. package/src/image-studio.mjs +2 -2
  169. package/src/install-metrics.mjs +109 -0
  170. package/src/json-file.mjs +2 -2
  171. package/src/launch.mjs +2 -2
  172. package/src/lease.mjs +15 -4
  173. package/src/lobby-work.mjs +11 -4
  174. package/src/local-ai.mjs +2 -2
  175. package/src/looks.mjs +2 -2
  176. package/src/market-check.mjs +165 -0
  177. package/src/market-key.mjs +10 -2
  178. package/src/market-license.mjs +4 -4
  179. package/src/market-remote.mjs +54 -12
  180. package/src/maturity.mjs +2 -2
  181. package/src/mcp/connect.mjs +2 -2
  182. package/src/mcp/github-server.mjs +2 -2
  183. package/src/mcp/image-server.mjs +2 -2
  184. package/src/mcp/memory-server.mjs +2 -2
  185. package/src/mcp/proxy.mjs +2 -2
  186. package/src/mcp/smtp-server.mjs +2 -2
  187. package/src/memory-dashboard.mjs +2 -2
  188. package/src/memory-tools.mjs +2 -2
  189. package/src/memory.mjs +2 -2
  190. package/src/models.mjs +33 -3
  191. package/src/module-scope.mjs +2 -2
  192. package/src/modules/ahp.mjs +2 -2
  193. package/src/modules/ash-policy.mjs +2 -2
  194. package/src/modules/ash.mjs +2 -2
  195. package/src/modules/bishop-exam.mjs +2 -2
  196. package/src/modules/bishop-plan.mjs +2 -2
  197. package/src/modules/bishop.mjs +9 -3
  198. package/src/modules/choices.mjs +2 -2
  199. package/src/modules/correo.mjs +2 -2
  200. package/src/modules/enlaces.mjs +2 -2
  201. package/src/modules/git-pulse.mjs +2 -2
  202. package/src/modules/github.mjs +2 -2
  203. package/src/modules/helpers.mjs +2 -2
  204. package/src/modules/image-studio.mjs +2 -2
  205. package/src/modules/index.mjs +90 -5
  206. package/src/modules/intents-calibration.mjs +2 -2
  207. package/src/modules/intents-desk.mjs +4 -3
  208. package/src/modules/intents-observe.mjs +2 -2
  209. package/src/modules/intents-policy.mjs +2 -2
  210. package/src/modules/intents-try.mjs +2 -2
  211. package/src/modules/intents.mjs +2 -2
  212. package/src/modules/local-models.mjs +14 -11
  213. package/src/modules/mcp-connect.mjs +2 -2
  214. package/src/modules/notes.mjs +159 -20
  215. package/src/modules/ollama.mjs +9 -3
  216. package/src/modules/playwright.mjs +2 -2
  217. package/src/modules/reminders.mjs +356 -37
  218. package/src/modules/ripley.mjs +3 -3
  219. package/src/modules/runs.mjs +2 -2
  220. package/src/modules/sdk.mjs +38 -6
  221. package/src/modules/updates.mjs +2 -2
  222. package/src/mother.mjs +2 -2
  223. package/src/npm-launch.mjs +2 -2
  224. package/src/ollama.mjs +6 -4
  225. package/src/opencode-health.mjs +26 -6
  226. package/src/outbound.mjs +10 -2
  227. package/src/override.mjs +27 -22
  228. package/src/ports.mjs +2 -2
  229. package/src/prices.mjs +2 -2
  230. package/src/privacy.mjs +2 -2
  231. package/src/quota-monitor.mjs +2 -2
  232. package/src/quota-sources.mjs +2 -2
  233. package/src/request-guard.mjs +2 -2
  234. package/src/review-ask.mjs +4 -3
  235. package/src/room/archivist.mjs +2 -2
  236. package/src/room/attachments.mjs +2 -2
  237. package/src/room/budget.mjs +2 -2
  238. package/src/room/context.mjs +2 -2
  239. package/src/room/control.mjs +2 -2
  240. package/src/room/copilot.mjs +2 -2
  241. package/src/room/economy.mjs +2 -2
  242. package/src/room/escalation.mjs +2 -2
  243. package/src/room/ghost.mjs +2 -2
  244. package/src/room/guard.mjs +6 -4
  245. package/src/room/prompt.mjs +3 -3
  246. package/src/room/returns.mjs +2 -2
  247. package/src/room/runs.mjs +6 -4
  248. package/src/room/vectors.mjs +2 -2
  249. package/src/room.mjs +127 -31
  250. package/src/router.mjs +2 -2
  251. package/src/runs.mjs +2 -2
  252. package/src/runtime-detection.mjs +31 -5
  253. package/src/salas.mjs +31 -6
  254. package/src/sentinel-errors.mjs +13 -4
  255. package/src/server-sentinel.mjs +2 -2
  256. package/src/server.mjs +689 -80
  257. package/src/setup-trouble.mjs +33 -0
  258. package/src/setup.mjs +4 -4
  259. package/src/smtp.mjs +2 -2
  260. package/src/telemetry.mjs +266 -0
  261. package/src/terms.mjs +43 -0
  262. package/src/tour.mjs +39 -5
  263. package/src/uninstall.mjs +225 -0
  264. package/src/updates.mjs +2 -2
  265. package/src/usage-sentinel.mjs +2 -2
  266. package/src/vault.mjs +2 -2
  267. package/src/verdict.mjs +13 -10
  268. package/src/whats-new.mjs +97 -3
  269. package/public/assets/abduction-cat-blink.png +0 -0
  270. package/public/assets/abduction-cat-control-left.png +0 -0
  271. package/public/assets/abduction-cat-control-right.png +0 -0
  272. package/public/assets/abduction-cat.png +0 -0
  273. package/public/assets/manual/madre-manual-en.pdf +0 -0
  274. package/public/assets/manual/madre-manual-es.pdf +0 -0
  275. package/public/assets/manual/shots/en-modules.webp +0 -0
  276. package/public/assets/manual/shots/es-modules.webp +0 -0
  277. package/src/mcp/notes-server.mjs +0 -120
  278. package/src/reminder-time.mjs +0 -127
package/bin/madre.cjs CHANGED
@@ -1,6 +1,6 @@
1
1
  #!/usr/bin/env node
2
- // SPDX-License-Identifier: AGPL-3.0-only
3
- // MADRE · © 2026 Jossue Alcalá · GNU AGPL v3 with additional terms (Section 7): ADDITIONAL-TERMS.md
2
+ // SPDX-License-Identifier: BUSL-1.1
3
+ // MADRE · © 2026 Jossue Alcalá · Business Source License 1.1: LICENSE
4
4
  // The door `madre` and `npx @jossuealcala/madre` come in by (2026-10-18). It only asks which Node is
5
5
  // running, in words any Node can read, and then hands over to bin/madre.mjs.
6
6
  //
package/bin/madre.mjs CHANGED
@@ -1,6 +1,6 @@
1
1
  #!/usr/bin/env node
2
- // SPDX-License-Identifier: AGPL-3.0-only
3
- // MADRE · © 2026 Jossue Alcalá · GNU AGPL v3 with additional terms (Section 7): ADDITIONAL-TERMS.md
2
+ // SPDX-License-Identifier: BUSL-1.1
3
+ // MADRE · © 2026 Jossue Alcalá · Business Source License 1.1: LICENSE
4
4
 
5
5
  import { join, resolve } from 'node:path';
6
6
  import { homedir } from 'node:os';
@@ -23,6 +23,43 @@ forgetNpxLaunch(process.env);
23
23
 
24
24
  const cli = parseArgs(process.argv.slice(2));
25
25
  const { command } = cli;
26
+
27
+ // WINDOWS (1.1.0, docs/WINDOWS.md D-001): on Windows, MADRE runs inside WSL2, not on Windows itself —
28
+ // what it promises about permissions (the write bit, process groups, each agent's sandbox) does not
29
+ // exist there the same way, and a start halfway is worse than none. A native start says how to get
30
+ // there, in three steps and in the person's language, and stops. PULSE_WINDOWS_NATIVE=1 lets a
31
+ // developer go on anyway.
32
+ if (process.platform === 'win32' && process.env.PULSE_WINDOWS_NATIVE !== '1' && command !== 'help') {
33
+ const spanish = /^es\b/i.test(Intl.DateTimeFormat().resolvedOptions().locale ?? '');
34
+ console.log(spanish ? `
35
+ MADRE en Windows funciona dentro de WSL2 (un Linux que viene con Windows). Son tres pasos, una sola vez:
36
+
37
+ 1. Abre PowerShell como administrador, escribe esto y reinicia la computadora:
38
+ wsl --install
39
+ 2. Abre «Ubuntu» desde el menú Inicio y crea tu usuario.
40
+ 3. Dentro de Ubuntu, instala Node.js y abre MADRE:
41
+ curl -fsSL https://deb.nodesource.com/setup_22.x | sudo -E bash -
42
+ sudo apt install -y nodejs
43
+ npx @jossuealcala/madre
44
+
45
+ MADRE se abre en tu navegador de Windows, como cualquier página.
46
+ Guía con imágenes: https://madre.run/manual/#windows
47
+ ` : `
48
+ On Windows, MADRE runs inside WSL2 (a Linux that comes with Windows). Three steps, once:
49
+
50
+ 1. Open PowerShell as administrator, type this and restart the computer:
51
+ wsl --install
52
+ 2. Open «Ubuntu» from the Start menu and create your user.
53
+ 3. Inside Ubuntu, install Node.js and open MADRE:
54
+ curl -fsSL https://deb.nodesource.com/setup_22.x | sudo -E bash -
55
+ sudo apt install -y nodejs
56
+ npx @jossuealcala/madre
57
+
58
+ MADRE opens in your Windows browser, like any page.
59
+ Guide with pictures: https://madre.run/en/manual/#windows
60
+ `);
61
+ process.exit(1);
62
+ }
26
63
  const option = (name, fallback) => cli.option(name.replace(/^--/, ''), fallback);
27
64
 
28
65
  // Is a MADRE already serving this very project nearby? `start` walks ports, so look along the
@@ -50,6 +87,31 @@ const has = (name) => cli.has(name.replace(/^--/, ''));
50
87
  // means finding the agents, opening the archive and waking the memory, and doing all of that only
51
88
  // to then refuse is a wait nobody needed. The real bind below stays the authority: this only
52
89
  // saves the waiting.
90
+ // What `madre --help` says, in the language MADRE speaks (src/i18n.mjs).
91
+ const HELP_TEXT = `MADRE
92
+
93
+ madre [--port 4317] [--no-open]
94
+ Opens Home: every project on this computer, in one place.
95
+ madre start [--project PATH] [--port 4317] [--no-open] [--setup]
96
+ Opens the project in this folder (or PATH) directly.
97
+ Without --port, a busy 4317 falls through to the next free port.
98
+ madre lobby [--port 4317] [--no-open] (also: madre salas; opens Home)
99
+ madre setup [--project PATH] [--port 4317] [--no-open]
100
+ madre doctor [--project PATH] [--json]
101
+ madre check-module --file <module.mjs> [--entry <entrada.json>] [--json] [--lang es]
102
+
103
+ (none) Opens Home. From there you add projects, connect the agents
104
+ and enter any project. The Coordinator lives there.
105
+ start Opens the project in this folder. From your home folder, Home.
106
+ setup Detects the agents on this computer, shows who has a session,
107
+ and runs each agent's own sign-in from here.
108
+ doctor Prints the same diagnosis without the wizard.
109
+ `;
110
+
111
+ // Where a room without --port starts looking (QA 1.1.0, GEN-02): 4317, or PULSE_PORT_BASE for the
112
+ // test suite and for whoever keeps another program on 4317.
113
+ const DEFAULT_PORT = /^\d{2,5}$/.test(String(process.env.PULSE_PORT_BASE ?? '')) ? String(process.env.PULSE_PORT_BASE) : '4317';
114
+
53
115
  function portTaken(port, host = '127.0.0.1') {
54
116
  return new Promise((resolve) => {
55
117
  const probe = createServer();
@@ -64,7 +126,7 @@ async function openRoom(options) {
64
126
  const explicit = cli.explicit('port');
65
127
  let port = options.port;
66
128
  if (explicit && await portTaken(port)) {
67
- console.error(`\n MOTHER › port ${port} is already in use. Another MADRE may be open there; try --port ${port + 1} or omit --port to pick one automatically.\n`);
129
+ console.error(`\n MADRE › port ${port} is already in use. Another MADRE may be open there; try --port ${port + 1} or omit --port to pick one automatically.\n`);
68
130
  process.exit(2);
69
131
  }
70
132
  for (let attempt = 0; attempt < 20; attempt += 1) {
@@ -72,17 +134,17 @@ async function openRoom(options) {
72
134
  return await startPulse({ ...options, port });
73
135
  } catch (error) {
74
136
  // The room itself says it is taken, whatever port this attempt used.
75
- if (error.code === 'ROOM_IN_USE') { console.error(`\n MOTHER › ${error.message}\n`); process.exit(2); }
137
+ if (error.code === 'ROOM_IN_USE') { console.error(`\n MADRE › ${error.message}\n`); process.exit(2); }
76
138
  if (error.code !== 'EADDRINUSE') throw error;
77
139
  if (explicit) {
78
- console.error(`\n MOTHER › port ${port} is already in use. Another MADRE may be open there; try --port ${port + 1} or omit --port to pick one automatically.\n`);
140
+ console.error(`\n MADRE › port ${port} is already in use. Another MADRE may be open there; try --port ${port + 1} or omit --port to pick one automatically.\n`);
79
141
  process.exit(2);
80
142
  }
81
- console.error(` MOTHER › port ${port} in use, trying ${port + 1}.`);
143
+ console.error(` MADRE › port ${port} in use, trying ${port + 1}.`);
82
144
  port += 1;
83
145
  }
84
146
  }
85
- console.error(`\n MOTHER › no free port between ${options.port} and ${port}. Pass --port explicitly.\n`);
147
+ console.error(`\n MADRE › no free port between ${options.port} and ${port}. Pass --port explicitly.\n`);
86
148
  process.exit(2);
87
149
  }
88
150
 
@@ -97,7 +159,7 @@ const projectRoot = projectRootFor({ command, named: cli.named, project: option(
97
159
  const openPath = isSalasRoom(projectRoot, salasHome) ? '/salas' : '';
98
160
  const [nodeMajor, nodeMinor] = process.versions.node.split('.').map(Number);
99
161
  if (nodeMajor < 22 || (nodeMajor === 22 && nodeMinor < 5)) {
100
- console.error(`\n MOTHER › MADRE needs Node 22.5 or newer (found ${process.version}): the room's memory runs on node:sqlite.\n`);
162
+ console.error(`\n MADRE › MADRE needs Node 22.5 or newer (found ${process.version}): the room's memory runs on node:sqlite.\n`);
101
163
  process.exit(2);
102
164
  }
103
165
  if (has('--version') || has('-v') || command === 'version') {
@@ -108,17 +170,25 @@ if (has('--version') || has('-v') || command === 'version') {
108
170
  console.log(`madre ${pkg.version}${commit ? ` · ${commit}` : ''} · node ${process.version}`);
109
171
  process.exit(0);
110
172
  }
111
- if (command !== 'help') {
173
+ // A command that only reads leaves nothing behind (QA 1.1.0, NUE-37): after uninstalling, `madre
174
+ // doctor` made ~/.pulse again, with Home's folder and the update cache in it.
175
+ const onlyReads = command === 'doctor' || command === 'check-module';
176
+ if (command !== 'help' && !(onlyReads && isSalasRoom(projectRoot, salasHome))) {
112
177
  // The notebook of Salas is MADRE's own folder: made here, empty, the first time it is opened
113
178
  // (D-S08). If it cannot be made, the check below says so, as for any folder that is not there.
114
- if (isSalasRoom(projectRoot, salasHome)) await ensureSalasProject(salasHome).catch((error) => console.error(` MOTHER › could not make the folder of Salas at ${projectRoot}: ${error.message}`));
179
+ if (isSalasRoom(projectRoot, salasHome)) await ensureSalasProject(salasHome).catch((error) => console.error(` MADRE › could not make the folder of Salas at ${projectRoot}: ${error.message}`));
115
180
  const stats = await stat(projectRoot).catch(() => null);
116
181
  if (!stats?.isDirectory()) {
117
- console.error(`\n MOTHER › project folder not found: ${projectRoot}\n Pass an existing directory with --project, or run MADRE from inside the project.\n`);
182
+ console.error(`\n MADRE › project folder not found: ${projectRoot}\n Pass an existing directory with --project, or run MADRE from inside the project.\n`);
118
183
  process.exit(2);
119
184
  }
120
185
  }
121
- applyConfigToEnv(await loadConfig(stateRoot));
186
+ const startConfig = await loadConfig(stateRoot);
187
+ applyConfigToEnv(startConfig);
188
+ // The terminal speaks the language MADRE was set to (QA 1.1.0, NUE-36): Spanish until someone
189
+ // chooses English, as the room does. PULSE_LANGUAGE still wins.
190
+ const { setLanguage: speakIn, t } = await import('../src/i18n.mjs');
191
+ speakIn(process.env.PULSE_LANGUAGE ?? startConfig?.language ?? 'es');
122
192
 
123
193
  if (command === 'doctor' && (has('--catalog') || has('--conditions'))) {
124
194
  // The same knowledge base MU/TH/UR uses in the room, printed for this platform.
@@ -175,36 +245,38 @@ if (command === 'doctor' && (has('--catalog') || has('--conditions'))) {
175
245
  const { checkForUpdate, detectInstall, updateCommand } = await import('../src/updates.mjs');
176
246
  const { join: joinPath } = await import('node:path');
177
247
  const { homedir } = await import('node:os');
178
- const check = await checkForUpdate({ name: pkg.name, current: pkg.version, cacheFile: joinPath(process.env.PULSE_HOME ?? joinPath(homedir(), '.pulse'), 'updates.json'), enabled: process.env.PULSE_UPDATE_CHECK !== '0' });
248
+ const stateFolder = process.env.PULSE_HOME ?? joinPath(homedir(), '.pulse');
249
+ const kept = await stat(stateFolder).then((found) => found.isDirectory(), () => false);
250
+ const check = await checkForUpdate({ name: pkg.name, current: pkg.version, cacheFile: kept ? joinPath(stateFolder, 'updates.json') : null, enabled: process.env.PULSE_UPDATE_CHECK !== '0' });
179
251
  const update = { ...check, command: updateCommand(detectInstall({ projectRoot }), pkg.name, check.latest ?? 'latest') };
180
252
  result.update = update;
181
253
 
182
254
  if (has('--json')) {
183
255
  console.log(JSON.stringify(result, null, 2));
184
256
  } else {
185
- console.log('\nMADRE doctor\n');
257
+ console.log(`\n${t('MADRE doctor')}\n`);
186
258
  for (const agent of report) {
187
- const mark = agent.ready ? 'ready' : agent.detected ? 'detected' : 'not found';
259
+ const mark = agent.ready ? t('ready') : agent.detected ? t('detected') : t('not found');
188
260
  const session = agent.detected ? ` · ${agent.session.state}${agent.session.detail ? ` (${agent.session.detail})` : ''}` : '';
189
261
  console.log(` ${agent.label.padEnd(10)} ${mark}${agent.version ? ` · ${agent.version}` : ''}${session}`);
190
262
  }
191
- console.log(` ${'Ollama'.padEnd(10)} ${ollama.disabled ? 'ignored (PULSE_OLLAMA=0)' : ollama.running ? `running${ollama.chatModel ? ` · @madre with ${ollama.chatModel}` : ' · no chat model yet'}${ollama.embedModel ? ` · embeddings ${ollama.embedModel}` : ''}` : 'not running · optional'}`);
192
- console.log(` ${'MADRE'.padEnd(10)} ${update.current}${update.available ? ` · ${update.latest} available · ${update.command}` : update.latest ? ' · up to date' : update.enabled ? ' · npm not reachable' : ' · update check off (PULSE_UPDATE_CHECK=0)'}`);
193
- console.log(`\n Project ${result.project}`);
194
- console.log(result.ok ? '\nReady to start. Known conditions and fixes: `madre doctor --catalog [query]`.\n' : '\nNo agent is online yet. Run `madre start`: the room opens anyway and walks you through installing and signing one in. Known conditions and fixes: `madre doctor --catalog`.\n');
263
+ console.log(` ${'Ollama'.padEnd(10)} ${ollama.disabled ? t('ignored (PULSE_OLLAMA=0)') : ollama.running ? `${t('running')}${ollama.chatModel ? ` · ${t('@madre with {model}', { model: ollama.chatModel })}` : ` · ${t('no chat model yet')}`}${ollama.embedModel ? ` · ${t('embeddings {model}', { model: ollama.embedModel })}` : ''}` : t('not running · optional')}`);
264
+ console.log(` ${'MADRE'.padEnd(10)} ${update.current}${update.available ? ` · ${t('{version} available', { version: update.latest })} · ${update.command}` : update.latest ? ` · ${t('up to date')}` : update.enabled ? ` · ${t('npm not reachable')}` : ` · ${t('update check off (PULSE_UPDATE_CHECK=0)')}`}`);
265
+ console.log(`\n ${t('Project').padEnd(10)} ${result.project}`);
266
+ console.log(result.ok ? `\n${t('Ready to start. Known conditions and fixes: `madre doctor --catalog [query]`.')}\n` : `\n${t('No agent is online yet. Run `madre`: Home opens anyway and walks you through installing and connecting one. Known conditions and fixes: `madre doctor --catalog`.')}\n`);
195
267
  }
196
268
  process.exitCode = result.ok ? 0 : 1;
197
269
  } else if (command === 'setup') {
198
270
  const { action, online } = await runSetup({ projectRoot, stateRoot });
199
271
  if (action === 'start') {
200
- await openRoom({ port: Number(option('--port', '4317')), projectRoot, openBrowser: !has('--no-open'), openPath });
272
+ await openRoom({ port: Number(option('--port', DEFAULT_PORT)), projectRoot, openBrowser: !has('--no-open'), openPath });
201
273
  } else {
202
274
  process.exitCode = action === 'report' && !online ? 1 : 0;
203
275
  }
204
276
  } else if (command === 'start' || command === 'salas' || command === 'lobby') {
205
277
  // `madre salas` is `madre start` on the notebook of Salas (projectRoot, above): the same look
206
278
  // for a room already open, the same walk up the ports, the same browser unless --no-open.
207
- const port = Number(option('--port', '4317'));
279
+ const port = Number(option('--port', DEFAULT_PORT));
208
280
  const noOpen = has('--no-open');
209
281
  // First contact happens in the room, not here: MADRE opens even with nobody online and the
210
282
  // bridge walks the human through installing and signing in. `madre setup` keeps the terminal
@@ -217,29 +289,29 @@ if (command === 'doctor' && (has('--catalog') || has('--conditions'))) {
217
289
  const running = await roomAlreadyOpen(port, projectRoot);
218
290
  if (running) {
219
291
  console.log(`\nMADRE is already open for this project\n\n ${running.url}${openPath}\n Project: ${projectRoot}\n Close that room first if you want a fresh one.\n`);
220
- if (!noOpen) openUrl(`${running.url}${openPath}`);
292
+ if (!noOpen) await openUrl(`${running.url}${openPath}`);
221
293
  process.exit(0);
222
294
  }
223
295
  await openRoom({ port, projectRoot, openBrowser: !noOpen, openPath });
296
+ } else if (command === 'check-module') {
297
+ // The community Market's check (src/market-check.mjs): what the madre-mercado repository's CI runs on
298
+ // every pull request, and what anyone can run before sending one.
299
+ const file = option('--file', null);
300
+ const entryFile = option('--entry', null);
301
+ if (!file) { console.error('Usage: madre check-module --file <module.mjs> [--entry <entrada.json>] [--json] [--lang es]'); process.exit(2); }
302
+ // In English unless asked otherwise, whatever MADRE speaks elsewhere: this check runs in the
303
+ // madre-mercado repository's CI, whose pull requests' summary is asked for in Spanish (--lang es).
304
+ (await import('../src/i18n.mjs')).setLanguage(option('--lang', 'en'));
305
+ const { checkSubmission } = await import('../src/market-check.mjs');
306
+ const text = await readFile(file, 'utf8');
307
+ const entry = entryFile ? JSON.parse(await readFile(entryFile, 'utf8')) : null;
308
+ const { basename: fileName } = await import('node:path');
309
+ const result = await checkSubmission({ text, entry, name: fileName(file) });
310
+ if (has('--json')) console.log(JSON.stringify({ ...result, markdown: undefined }, null, 2));
311
+ else console.log(result.markdown);
312
+ process.exitCode = result.ok ? 0 : 1;
224
313
  } else if (command === 'help') {
225
- console.log(`MADRE
226
-
227
- madre [--port 4317] [--no-open]
228
- Opens Home: every project on this computer, in one place.
229
- madre start [--project PATH] [--port 4317] [--no-open] [--setup]
230
- Opens the project in this folder (or PATH) directly.
231
- Without --port, a busy 4317 falls through to the next free port.
232
- madre lobby [--port 4317] [--no-open] (also: madre salas; opens Home)
233
- madre setup [--project PATH] [--port 4317] [--no-open]
234
- madre doctor [--project PATH] [--json]
235
-
236
- (none) Opens Home. From there you add projects, connect the agents
237
- and enter any project. The Coordinator lives there.
238
- start Opens the project in this folder. From your home folder, Home.
239
- setup Detects the agents on this computer, shows who has a session,
240
- and runs each agent's own sign-in from here.
241
- doctor Prints the same diagnosis without the wizard.
242
- `);
314
+ console.log(t(HELP_TEXT));
243
315
  } else {
244
316
  console.error(`Unknown command: ${command}`);
245
317
  process.exitCode = 1;
package/docs/REFERENCE.md CHANGED
@@ -55,7 +55,7 @@ Luego abre `http://127.0.0.1:4317/salas` en el navegador de tu computadora. Los
55
55
  | `@codex`, `@claude`, `@gemini`, `@opencode`, `@madre` | Menciona a un agente; `@` abre la lista |
56
56
  | `!src/room.mjs:12-20` | Adjunta un archivo del proyecto, con líneas si las das; `!` busca entre los archivos |
57
57
  | `#0` a `#4` | Fija el modo de permiso de ese mensaje. `#3` y `#4` abren el desbloqueo, igual que el chip: un modo que pide dos llaves con el ratón no sale gratis por teclearlo |
58
- | `/create …`, `/image …`, `/stopall`, `/git …`, `/ahp …` | Comandos; `/` abre el menú. `/git push` muestra qué saldría; solo `/git push confirm` lo envía |
58
+ | `/image …`, `/detener` (o `/stopall`), `/coordinador` (o `/bishop`), `/git …`, `/ahp …` | Comandos; `/` abre el menú. `/git push` muestra qué saldría; solo `/git push confirm` lo envía |
59
59
  | `STOPALL` | Freno maestro |
60
60
  | Clip, arrastrar o pegar una imagen | Adjunto para el proyecto, nunca dentro de su carpeta |
61
61
  | `@madre, pregúntale a los agentes …` | Preguntar a todos: un paso por agente en línea, cierre citado |
@@ -66,11 +66,13 @@ Un segundo clic en la esfera elegida, o el chip `default model ▾`, elige el mo
66
66
 
67
67
  **Código.** La tecla `CÓDIGO` de la barra abre el visor junto a la conversación como espacio de código: los archivos del proyecto con su buscador, pestañas (hasta 12, que siguen ahí al recargar) y, sobre el código, la ruta y la función donde está el cursor. ⌘P (Ctrl+P fuera de macOS) abre un archivo por su nombre. Cambiar de pestaña no pierde lo que escribiste: el borrador se queda en su pestaña, marcado con un punto, hasta que guardas o descartas. Lo que un agente cambió en su último turno de `#3` EDITAR queda marcado en su color, con una tarjeta por cambio: **Conservar** (deja de marcarse), **Deshacer** (vuelve a poner lo que había solo en esas líneas; el resto del turno se queda) y **Preguntar por qué** (se lo pregunta al agente en la conversación). Un turno deshecho con `DESHACER`, o líneas que reescribiste tú, ya no se marcan. Al pedir revisión de unas líneas, `REVISAR CON` ofrece Explicar, Mejorar, Escribir pruebas y Arreglar. **Al lado** pone junto al código el Markdown renderizado mientras escribes, o la página HTML recargada al guardar (esta con Vista previa encendida). Lo conservado se guarda en `code-reviewed.json`, junto al registro del proyecto (`GET /api/files/changes`, `POST /api/files/changes/review`).
68
68
 
69
+ **En marcha.** La tecla con la línea de pulso, en la barra de cada proyecto y de Inicio, dice cuántas cosas corren en todos los proyectos abiertos de esta computadora (un plan cuenta una vez; sus pasos van dentro). Su panel tiene tres partes: **Ahora** (cada IA respondiendo con lo que se le pidió, el tiempo contra su límite y sus subagentes; cada plan con sus pasos; cada comando o servidor que corre; lo que se instala), **Terminado hace poco** (la última media hora: respondió, no pudo o lo detuviste, con el error si lo hubo) y **Recordatorios por venir** (las próximas 24 horas). Cada fila se abre: **Ir al chat** abre esa conversación en ese mensaje, en su proyecto (otro proyecto se abre en su pestaña, con la dirección `#chat=<id>:<mensaje>`); **Detener** para ese turno, plan o servidor; **Detener todo**, con confirmación, frena todo en todos los proyectos. En pantallas angostas se abre como hoja desde abajo. Pregunta cada 1,5 s con el panel abierto, cada 5 s para el número, y nada mientras la pestaña está oculta (`GET /api/activity?everywhere=1`, `POST /api/activity/stop`, `POST /api/activity/stop-all`; un proyecto con una MADRE anterior se nombra aparte). Desde el teléfono no se detiene otro proyecto.
70
+
69
71
  **Tema.** Sol/luna en la barra: automático, claro u oscuro. El claro no brilla; la pantalla de Diagnóstico sigue siendo fósforo.
70
72
 
71
73
  **Idioma.** El proyecto habla **español** por defecto. El botón `EN` de la barra lo pasa a inglés y el navegador lo recuerda; `PULSE_LANGUAGE=en` manda sobre el config en el siguiente arranque. Un idioma es solo cómo se lee: lo que quedó escrito en el ledger conserva las palabras con que se escribió, y al mostrarse se vuelve a decir en el idioma del proyecto.
72
74
 
73
- La **terminal sigue en inglés a propósito**: `madre doctor` y el arranque imprimen lo que la gente pega en un issue o busca en un motor, y en inglés se encuentra. Lo que imprime un CLI por su cuenta tampoco se toca nunca.
75
+ Desde 1.1.0 la **terminal habla el idioma que elegiste** (español mientras no elijas otro; `PULSE_LANGUAGE` manda): el arranque, `madre --help` y `madre doctor`. Siguen en inglés `madre doctor --json` y `madre check-module`, que leen otros programas. Lo que imprime un CLI por su cuenta nunca se toca.
74
76
 
75
77
  ---
76
78
 
@@ -118,6 +120,23 @@ Cada mensaje sale con un modo. Tu modo es el techo de cualquier plan que ese men
118
120
 
119
121
  El acceso web es un permiso permanente por agente, apagado por defecto, que se enciende en Ajustes → Agentes, con Acceso a la web.
120
122
 
123
+ ### Subagentes de cada IA
124
+
125
+ Desde 1.1.0, de **#1 a #3**, Claude, OpenCode y Codex pueden repartir su trabajo entre sus propios subagentes. Cada subagente trabaja con **exactamente el permiso del turno**: en #1 solo lee, en #2 crea, en #3 edita, nunca toca `.git`, `.pulse`, `.madre` ni `.env`, y lo que cambia entra en el mismo punto de restauración y se deshace con **Deshacer**. En **#4** solo trabaja la IA principal.
126
+
127
+ | | De #1 a #3 | En #4 |
128
+ |---|---|---|
129
+ | **Claude** | Herramienta `Agent`: el subagente hereda las mismas herramientas y reglas (`--tools`, `--allowedTools`, `dontAsk`) | Sin `Agent` |
130
+ | **OpenCode** | Solo `explore` y `general`, cada uno con los permisos del turno y sin poder llamar a otro (los de fábrica de OpenCode escriben y corren comandos) | `task` negado |
131
+ | **Codex** | Sus subagentes quedan dentro de la misma caja de arena | Límite de un hilo: `features.multi_agent_v2.max_concurrent_threads_per_session=1` |
132
+ | **Gemini** · **Cursor** | No | No |
133
+
134
+ Probado con las IAs reales (Claude 2.1.267, OpenCode 1.18.4, Codex 0.161): en #1 el subagente lee y no escribe; en #3 escribe en el proyecto, `.pulse/` lo rechaza y no hay comandos; en #4 Codex responde «agent thread limit reached».
135
+
136
+ **Cómo se ven.** Mientras trabajan, un chip por subagente bajo «trabajando…» (en vivo, `turn.subagents`, nunca en el registro); al responder, «Ayudaron N subagentes» plegado bajo la respuesta, con el encargo, lo que leyó, buscó o cambió y lo que reportó, guardado en `message.created.subagents` tras el filtro de privacidad (`src/adapters/subagents.mjs`). Claude lo dice todo (salida `stream-json`: inicio, cada herramienta, fin y resumen; sus tokens se suman de sus dos respuestas cuando un subagente corrió en segundo plano). OpenCode dice cada uno al terminar. Codex solo dice que trabajó con subagentes.
137
+
138
+ **Una pregunta a varias IAs.** Un mensaje que empieza con varias (`@opencode @madre ¿…?`) va a cada una que tenga sesión, en un turno propio, hasta #2; el registro los liga con `together` y la página muestra la pregunta una vez, con todas las IAs tras la flecha.
139
+
121
140
  ---
122
141
 
123
142
  ## PLANES
@@ -191,7 +210,7 @@ El botón de la barra abre la pantalla de diagnóstico. Escribe un síntoma, un
191
210
  | En el encabezado | Qué hace |
192
211
  |---|---|
193
212
  | Mapa de memoria (cerebro) | La memoria en un mapa. También está en la barra de arriba |
194
- | Ajustes (engrane) | Abre Ajustes › Versión y reportes, donde vive el centinela: los fallos que ninguna condición explica y las caídas del proceso, con rutas, usuarios, correos y claves eliminados. Cada reporte se lee antes de enviarse; el autorreporte viene apagado |
213
+ | Ajustes (engrane) | Abre Ajustes › Versión y reportes, donde vive el centinela: los fallos que ninguna condición explica y las caídas del proceso, con rutas, usuarios, correos y claves eliminados. El autorreporte viene encendido desde 1.1.0, junto con el diagnóstico anónimo, y se apaga ahí mismo |
195
214
  | ¿No se arregló? | Al pie de cada remedio: reporta que no funcionó, con el código de la condición |
196
215
  | `?` | El recorrido de cinco paradas, el mismo que se abre la primera vez. Si dejaste a medias la lista de primeros pasos y la ocultaste, también la regresa |
197
216
 
@@ -305,6 +324,19 @@ Cada proyecto recuerda dónde está su carpeta (`project.json`, junto a su regis
305
324
 
306
325
  Los planes viven en `bishop-plans.json` junto al registro del proyecto del Coordinador (los últimos 40) y cada orden recibida se cuenta en `enlaces.jsonl` del proyecto que la recibió.
307
326
 
327
+ ### Desinstalar MADRE
328
+
329
+ En **Inicio › Ajustes › Versión › Desinstalar MADRE** (`src/uninstall.mjs`, `public/power.js`). Antes de tocar nada muestra la lista entera (`GET /api/madre/uninstall`); con tu sí (`POST`, solo desde la página de Inicio en esta computadora) cierra cada proyecto abierto como «Apagar MADRE» y, si alguno no cierra, no borra nada. Con todo cerrado, Inicio se cierra y borra:
330
+
331
+ | Se borra | Se queda |
332
+ |---|---|
333
+ | La carpeta de MADRE (`~/.pulse` o `PULSE_HOME`): chats, memoria, ajustes, módulos, catálogo, identificador de la copia y las IAs que instaló en su carpeta (`tools/`) | Tus proyectos y sus archivos |
334
+ | `.pulse/` dentro de cada proyecto que MADRE conoce, menos `.pulse/out/` (lo que crearon las IAs en #2) salvo que marques la casilla | `.madre/` dentro de un proyecto: los módulos que escribiste |
335
+ | Los puntos de restauración de esos proyectos (`$TMPDIR/madre-shadow-<uid>/…`) | Tus IAs y sus sesiones, Ollama y sus modelos, la caché de npm |
336
+ | La copia que descargó `npx` (`~/.npm/_npx/<hash>` con solo MADRE) | Con `npm -g` o dentro de un proyecto, el programa: la pantalla final da el comando (`npm uninstall -g @jossuealcala/madre`). Desde el código, su carpeta |
337
+
338
+ La carpeta de MADRE se borra entera solo si es suya sin duda: ruta absoluta, nunca tu carpeta personal ni una que la contenga, y con algo que MADRE siempre escribe (`install-id`, `config.json`, `rooms`, `salas`).
339
+
308
340
  ---
309
341
 
310
342
  ## LO QUE SALE DE LA MÁQUINA
@@ -312,7 +344,21 @@ Los planes viven en `bishop-plans.json` junto al registro del proyecto del Coord
312
344
  - **Sin nube ni cuenta.** MADRE no tiene cuenta ni backend que guarde lo tuyo. No guarda credenciales de proveedores.
313
345
  - **Lo que un agente lee, viaja a su proveedor.** Codex a OpenAI, Claude Code a Anthropic, Gemini CLI a Google, OpenCode a quien tenga configurado. Si `OPENAI_BASE_URL` o `ANTHROPIC_BASE_URL` cambia ese destino, MADRE enseña solo el hostname y bloquea el turno antes de armar el briefing; un gateway verificado se autoriza por agente con `PULSE_ALLOW_CUSTOM_AGENT_ENDPOINTS`. Aplican la cuenta, los límites y los términos del destino efectivo. `@madre` y el archivista con Ollama no salen de la máquina.
314
346
  - **Un aviso diario de que sigue en uso, siempre encendido.** Una vez al día cada copia le dice a madre.run que está en uso: un identificador al azar que la copia creó para sí (`~/.pulse/install-id`), la versión de MADRE, el sistema y la versión mayor de Node. Nada más: ni nombre, ni correo, ni proyecto, ni rutas, ni agentes, ni nada de lo que se dice en un proyecto; madre.run no guarda la IP. Es la forma en que el autor sabe cuántas personas usan MADRE, qué versiones corren y si regresan. Sale por el mismo registro que todo lo demás, así que aparece en «Lo que se envía». Sin red, falla en silencio. (`src/heartbeat.mjs`)
315
- - **Dos envíos propios bajo tu interruptor.** El sentinel, apagado por defecto, envía reportes redactados al colector del proyecto. El canal de liberación, encendido por defecto, pregunta a npm por la última versión: viaja el nombre del paquete, nada más, la misma petición que hace `npx`. `PULSE_UPDATE_CHECK=0` lo apaga.
347
+ - **Diagnóstico anónimo, encendido salvo que lo apagues.** Desde 2026-10-28, cada copia guarda en `~/.pulse/telemetry/` las fallas que encuentra (las que Diagnóstico conoce, con su código MU, y las que nadie ha catalogado; fallos del proceso, rutas que se rompen, errores de la página, instalaciones que no terminan) y cuántos turnos, modos y funciones se usaron. Una vez al día, y poco después de una falla nunca vista, lo manda a madre.run con los mismos cuatro datos del aviso diario, su arquitectura y si corre en WSL; después lo borra. Los mensajes van sin rutas (cada una sale como `<path>`), sin nombres de usuario, llaves ni correos, y de cada falla solo las líneas del código de MADRE por donde pasó. Nunca lo que escribes, tus proyectos ni tus archivos. Se apaga en Ajustes › Versión e informes › «Enviar diagnóstico anónimo» (y se borra lo que esperaba) o con `PULSE_TELEMETRY=0`; ahí mismo se ve el lote exacto que saldría. (`src/telemetry.mjs`, `public/page-errors.js`)
348
+ - **Cómo corre cada copia, su ciclo de vida y si está encendida ahora (desde 1.1.0, dentro del diagnóstico anónimo y con su mismo interruptor).**
349
+ - **Entorno**, como números y nombres de partes de MADRE:
350
+ - núcleos y memoria en GB;
351
+ - el idioma de MADRE y cómo se instaló (npx, global, dentro de un proyecto o desde el código fuente);
352
+ - el nombre de la terminal (zsh, bash…);
353
+ - si Ollama está encendido y cuántos modelos tiene;
354
+ - qué agentes están instalados y cuáles listos;
355
+ - cuántos proyectos hay y cuántos abiertos;
356
+ - qué módulos propios de MADRE están encendidos (uno escrito por la persona solo cuenta como «otro»);
357
+ - cuántos días tiene la copia.
358
+ - **Ciclo de vida:** instalada (una copia que nunca tuvo identificador), actualizada (una versión más nueva abierta por primera vez, según `~/.pulse/lifecycle.json`), desinstalada (desde Ajustes, enviado antes de borrar nada) y cada vez que se abre Inicio.
359
+ - **Presencia:** mientras MADRE está abierta, cada cinco minutos manda a `madre.run/api/presence` solo el identificador al azar, la versión y el sistema, para saber cuántas copias están encendidas ahora; uno solo de sus procesos lo dice. Ninguna ruta, nombre de proyecto, archivo ni nada que escribas.
360
+ - **Se apaga igual que el diagnóstico.** Las copias del autor no mandan presencia, y madre.run tampoco las cuenta. (`src/install-metrics.mjs`)
361
+ - **Envíos propios bajo tu interruptor.** El sentinel, encendido por defecto desde 1.1.0 (y apagado si apagas el diagnóstico anónimo), envía reportes redactados al colector del proyecto. El canal de liberación, encendido por defecto, pregunta a npm por la última versión: viaja el nombre del paquete, nada más, la misma petición que hace `npx`. `PULSE_UPDATE_CHECK=0` lo apaga.
316
362
  - **Escritura.** En `#1` nadie escribe. En `#2` solo se añade: lo que existía se restaura al terminar el turno. En `#3` todo el proyecto salvo las zonas prohibidas, con punto de restauración y `DESHACER`. En un proyecto sin git, MADRE guarda sus fotografías en un repositorio sombra fuera del proyecto. Un comando que pide un agente lo corres tú, con punto de restauración antes y `DESHACER` después.
317
363
  - **Memoria.** Todo lo dicho fuera de INCÓGNITO queda en `~/.pulse/rooms/<sala>/` y vuelve a los prompts de todos los agentes de ese proyecto. INCÓGNITO es la salida para lo que no debe recordarse; PRIVACY, para los nombres que nunca deben aparecer.
318
364
 
@@ -350,7 +396,8 @@ Los planes viven en `bishop-plans.json` junto al registro del proyecto del Coord
350
396
  | `PULSE_PRIVATE_TERMS` · `PULSE_PRIVATE_MARKER` | — · `[ENTIDAD-ORG]` | Datos ocultos extra y su marcador |
351
397
  | `PULSE_UPDATE_CHECK` | `1` | `0` apaga la consulta diaria a npm |
352
398
  | `PULSE_GH` | `1` | `0` hace que el módulo GitHub ignore la sesión de `gh` y entre solo con el token que pegaste |
353
- | `PULSE_REPORT_URL` · `PULSE_AUTO_REPORT` | colector del proyecto · `0` | Sentinel |
399
+ | `PULSE_REPORT_URL` · `PULSE_AUTO_REPORT` | colector del proyecto · como el diagnóstico anónimo (`0` lo apaga) | Sentinel |
400
+ | `PULSE_TERMS` | `accepted` da la licencia por aceptada (pruebas, capturas y casas de QA; `src/terms.mjs`) | Licencia |
354
401
  | `PULSE_AGENT_TIMEOUT_MS` · `PULSE_<AGENTE>_TIMEOUT_MS` | `180000` · — | Timeouts |
355
402
  | `PULSE_ALLOW_CUSTOM_AGENT_ENDPOINTS` | — | Lista separada por comas (`codex`, `claude`) de gateways que el humano verificó y permite; sin ella, una dirección base no oficial se bloquea |
356
403
  | `PULSE_MAX_MESSAGE_CHARS` | `20000` | Tamaño máximo de un mensaje |
package/docs/SDK.md CHANGED
@@ -54,7 +54,7 @@ export default ({ defineModule }) => defineModule({
54
54
 
55
55
  ## Lo que un módulo puede declarar
56
56
 
57
- Esta tabla es **el contrato completo**: 39 campos, ni uno más. Cualquier otro que escribas MADRE
57
+ Esta tabla es **el contrato completo**: 41 campos, ni uno más. Cualquier otro que escribas MADRE
58
58
  te lo dice al instalar («no entendí estos campos») en vez de ignorarlo en silencio. Una prueba de
59
59
  la suite compara esta tabla contra el código, así que si alguna vez se separan, es un fallo.
60
60
 
@@ -63,6 +63,7 @@ la suite compara esta tabla contra el código, así que si alguna vez se separan
63
63
  |---|---|
64
64
  | `id`, `name`, `vendor`, `summary`, `creates`, `requires` | Su ficha en MODULES. `summary` es una frase: qué hace. `creates` y `requires` son líneas cortas, una idea cada una. `name` y `summary` —y en `slash`, `summary`, `usage` y `title`— pueden ir en los dos idiomas, `{ es, en }`: MADRE muestra el de la sala. Lo que tu módulo escribe al correr (la tarjeta de un comando, una página) va en `ctx.language`, `'es'` o `'en'`, el idioma en que habla la sala |
65
65
  | `version` | La tuya, y empieza en `1.0.0`. Si no la declaras, la ficha muestra la fecha del archivo |
66
+ | `sdk` | El contrato del SDK para el que escribiste tu módulo, un número entero: `1` (hasta MADRE 1.0.5) o `2` (`ctx.t`, `ctx.services.ollama.generate` y un módulo de un solo archivo que no importa nada de MADRE). Sin él, es `1`. Una MADRE que no conoce tu contrato no lo carga y te dice por qué; el Mercado solo se lo ofrece a las que sí. El número cuenta lo que MADRE le da a un módulo, no la versión de MADRE: una MADRE nueva sigue entendiendo los contratos anteriores |
66
67
  | `tracks` | Si tu módulo envuelve algo de fuera, su versión no es la tuya: es la de esa cosa. Declara `{ name, npm }` o `{ name, github }` y devuelve la versión encontrada en `status(ctx)` como `runs: [{ name, version }]`. MADRE muestra esa versión y busca una más nueva sola, una vez al día, con el botón ↻ de la ficha para mirar ahora |
67
68
  | `updatePlan(ctx, { latest })` | Cómo se trae esa versión nueva a esta computadora: `{ command, args, display, note, after }`. MADRE enseña `display` y no corre nada hasta que la humana lo leyó; la salida cae en la sala línea por línea. Sin comando, devuelve `{ command: null, note, download }` y la ficha manda a descargarlo |
68
69
  | `updates` | `{ url }` https donde publicas **tu propio módulo**. Con eso su ficha trae un botón que va por el archivo, lo verifica igual que una instalación y lo reemplaza si pasa. Si lo instalaste desde un archivo, MADRE recuerda cuál y no necesitas declarar nada: edítalo y pide una copia nueva |
@@ -74,6 +75,7 @@ la suite compara esta tabla contra el código, así que si alguna vez se separan
74
75
  | `ready(ctx)` | Lo que pides antes de encender, en un proyecto o en todos (desde el Mercado también): `null` si está listo, `{ status, body: { error } }` si no. Apagar nunca lo pregunta |
75
76
  | `footer` | Hasta dos teclas junto a la versión de MADRE, abajo a la derecha, mientras tu módulo está encendido: `[{ icon: 'heart' \| 'star' \| 'link', label, text, action, url }]`. Los textos pueden ser una frase o `{ es, en }`; `url` tiene que ser https y se abre en otra pestaña. MADRE la dibuja: al pasar el ratón muestra `text` y un botón con `action` |
76
77
  | `credit` | De quién fue la idea, si no fue tuya: un nombre. MADRE lo dice en la ficha del módulo y en el Mercado («Idea de …») |
78
+ | `icon` | El ícono de tu módulo: `{ svg, color }`. `svg` es el dibujo —sus formas (`<path d="…"/>`) o un `<svg>` entero, en la cuadrícula que quieras— y `color` el de su mosaico, `#rrggbb`. MADRE lo ajusta solo para que se vea como los suyos: lo centra y lo escala al mismo cuadro, lo pinta en blanco y de un solo color, usa el color de MADRE más parecido al tuyo y quita lo que no sea dibujo (scripts, imágenes, enlaces, estilos, degradados). Sin `icon`, tu módulo lleva la pieza de rompecabezas en gris. Hasta 8000 caracteres |
77
79
  | `slash` | Comandos `/nombre` que corren en el servidor con tu `ctx` y devuelven `{ ok, title, text, link }`. La sala los muestra como tarjeta y los agentes los leen. `link` es opcional: `{ href, label }` con una ruta tuya (`/api/x/<id>/…`), y la tarjeta la ofrece como botón que abre otra pestaña; una dirección fuera de tus rutas se ignora |
78
80
  | `toolsForTurn(ctx, turn)` | Servidores MCP para el turno de un agente: `[{ name, command, args, env, tools, sends, brief }]`. MADRE los adjunta a la CLI en su corrida aislada y describe `brief` al agente. `turn` trae el agente, el modo, el arriendo, la carpeta, el puerto y `turn.turn`: el id de la respuesta que ese turno escribirá. Si tu servidor llama de vuelta a la sala en nombre del turno, manda ese id; `ctx.room.runningTurn(id)` dice si sigue corriendo y para qué agente |
79
81
  | `toolsForTurn` → `sends` | Cuáles de tus herramientas **mandan algo fuera**. El núcleo las retira por debajo de `#4` AIRLOCK: ni se le cuenta al modelo que existen. Ver abajo |
@@ -236,6 +238,19 @@ La ficha de un módulo tuyo trae **GET A NEWER FILE**: MADRE va por el archivo
236
238
 
237
239
  Y en la cabecera de MODULES hay **+ ADD A MODULE** para instalar el `.mjs` de alguien más. Pasa por la misma puerta que todo lo demás. Dicho claro, porque es lo que es: un módulo corre **dentro de MADRE, con los permisos de quien la abre**. MADRE comprueba que cargue y que no se salga de su corral —id propio, rutas solo bajo `/api/x/<id>/`, jamás encima de un módulo de MADRE—; lo que el código *pretende* no lo puede comprobar nadie más que tú.
238
240
 
241
+ ### En el Mercado, para todos
242
+
243
+ Un módulo tuyo puede estar en el Mercado de MADRE, gratis, con tu nombre. Es curado: el autor de MADRE lee el código, lo firma y lo publica; nada llega al Mercado sin que una persona lo lea.
244
+
245
+ 1. En la ficha de tu módulo, **Enviar al Mercado › Preparar**. Escribe lo que mostrará el Mercado —nombre, una línea y qué hace, en español y en inglés—, el estante, tu nombre y tu usuario de GitHub, y la licencia de tu código.
246
+ 2. **Revisar** lo comprueba igual que lo comprobará el Mercado: que cargue como carga cualquier módulo, que la entrada diga el mismo id y la misma versión, y qué alcanza su código (comandos, la red, archivos, variables de entorno). Si habla con la red, declara `reaches`.
247
+ 3. **Preparar los archivos** deja los dos que pide el repositorio, `<id>.module.mjs` y `entrada.json`, en una carpeta propia, y te la muestra.
248
+ 4. **Abrir GitHub** lleva a la carpeta `modulos/<id>/` del repositorio público `madre-mercado`. Arrastra los dos archivos y pulsa *Propose changes*: GitHub hace la copia y el *pull request* por ti, sin terminal.
249
+
250
+ En el *pull request* corre la misma revisión y deja el resumen para quien lo lee. Ya firmado, aparece en el Mercado con la etiqueta **Comunidad** y **Desarrollado por** tu nombre; quien lo instala lee antes lo que declara. Para una versión nueva, sube `version` en el módulo y envíalo otra vez.
251
+
252
+ Desde la terminal, la misma revisión: `npx @jossuealcala/madre check-module --file <id>.module.mjs --entry entrada.json`.
253
+
239
254
  ## La ficha
240
255
 
241
256
  No dibujas nada: declaras, y MADRE arma tu módulo igual que los suyos. En MÓDULOS cada módulo es una tarjeta del tablero y, al tocarla, una ficha con los mismos bloques que AJUSTES. Por eso el tuyo se lee igual que los que trae MADRE.
@@ -264,7 +279,10 @@ ctx = {
264
279
  env, agents, room, // agentes detectados; la sala (room.capabilities(), room.record(...))
265
280
  readConfig(), updateConfig(patch),
266
281
  record(type, payload), // escribe un evento en el ledger; tipo "algo.algo", nunca message.* ni agent.*
267
- services: { history, imageKey, ollama, … }, // lo que el servidor ofrece
282
+ language, t(text, vars), // el idioma de la sala, 'es' o 'en', y tus palabras en él (sdk: 2):
283
+ // una frase en inglés que MADRE ya conoce, o la tuya en { es, en }
284
+ services: { history, imageKey, ollama: { state, generate }, … }, // lo que el servidor ofrece;
285
+ // ollama.generate({ system, prompt, json }) contesta con el modelo local (sdk: 2)
268
286
  vault: { get, held, keep, forget } // tus secretos, y solo los tuyos
269
287
  }
270
288
  ```
@@ -301,7 +319,7 @@ Los textos llegan recortados a 600 caracteres. Es la base de un módulo que info
301
319
 
302
320
  ## Que lo construya tu IA, en la sala
303
321
 
304
- Escribe `/module <lo que debe hacer>` en el compositor. Es la entrada explícita al flujo guiado: si `#2 CREATE` no está activo, MADRE te pide elegirlo y conserva intacta tu petición. Con `#2` activo, mantiene el agente que elegiste y le entrega el contrato del SDK y el ejemplo. El agente debe escribir **un solo archivo** llamado `<id>.module.mjs` en su carpeta de borrador; no puede instalarlo por su cuenta.
322
+ Escribe `/module <lo que debe hacer>` en el compositor. Es la entrada explícita al flujo guiado: si `#2 CREATE` no está activo, MADRE te pide elegirlo y conserva intacta tu petición. Con `#2` activo, mantiene el agente que elegiste y le entrega el contrato del SDK y el ejemplo. El agente debe escribir **un solo archivo** llamado `<id>.module.mjs` en su carpeta de borrador; no puede instalarlo por su cuenta. Ese archivo trae su `icon`: el agente lo dibuja junto con el resto del módulo y MADRE lo ajusta al mosaico.
305
323
 
306
324
  MADRE reconoce ese nombre y pone una tarjeta en la sala: `INSTALL FOR EVERY ROOM` o `INSTALL FOR THIS PROJECT`. Léelo, decide, un clic. MADRE lo valida en una copia, lo guarda como `<id>.mjs` en la carpeta que elegiste y aparece en MÓDULOS con la etiqueta «Tuyo». También puedes pedir lo mismo en lenguaje natural mientras estés en `#2` o más; `/module` hace explícito el formato y no concede permisos por sí solo.
307
325
 
@@ -55,7 +55,7 @@ Then open `http://127.0.0.1:4317/salas` in your computer's browser. The agents a
55
55
  | `@codex`, `@claude`, `@gemini`, `@opencode`, `@madre` | Mentions an agent; `@` opens the list |
56
56
  | `!src/room.mjs:12-20` | Attaches a project file, with lines if you give them; `!` searches the files |
57
57
  | `#0` to `#4` | Sets that message's permission mode. `#3` and `#4` open the unlock, just like the chip: a mode that asks for two keys with the mouse does not come free by typing it |
58
- | `/create …`, `/image …`, `/stopall`, `/git …`, `/ahp …` | Commands; `/` opens the menu. `/git push` shows what would go out; only `/git push confirm` sends it |
58
+ | `/image …`, `/stopall`, `/coordinator` (or `/bishop`), `/git …`, `/ahp …` | Commands; `/` opens the menu. `/git push` shows what would go out; only `/git push confirm` sends it |
59
59
  | `STOPALL` | Master brake |
60
60
  | Clip, drag or paste an image | Attachment for the project, never inside its folder |
61
61
  | `@madre, pregúntale a los agentes …` | Ask everyone: one step per online agent, with a cited wrap-up |
@@ -66,11 +66,13 @@ A second click on the chosen sphere, or the `default model ▾` chip, picks the
66
66
 
67
67
  **Code.** The `CODE` key in the bar opens the viewer beside the conversation as a code workspace: the project's files with their search, tabs (up to 12, still there after a reload) and, above the code, the path and the function the caret is in. ⌘P (Ctrl+P outside macOS) opens a file by its name. Switching tabs never loses what you wrote: the draft stays in its tab, marked with a dot, until you save or discard it. What an agent changed in its last `#3` EDIT turn is marked in its colour, with one card per change: **Keep** (it stops being marked), **Undo** (puts back what was there in those lines only; the rest of the turn stays) and **Ask why** (asks the agent in the conversation). A turn taken back with `UNDO`, or lines you rewrote yourself, are no longer marked. When you ask for a review of some lines, `REVIEW WITH` offers Explain, Improve, Write tests and Fix. **Side by side** puts the rendered Markdown next to the code as you write, or the HTML page reloaded when you save (the latter with Preview on). What you kept is stored in `code-reviewed.json`, next to the project's record (`GET /api/files/changes`, `POST /api/files/changes/review`).
68
68
 
69
+ **Running now.** The key with the pulse line, on the bar of every project and of Home, says how many things run in all the projects open on this computer (a plan counts once; its steps are inside it). Its panel has three parts: **Now** (each AI answering with what it was asked, its time against its limit and its subagents; each plan with its steps; each command or server running; what is installing), **Ended a moment ago** (the last half hour: answered, could not, or you stopped it, with the error if there was one) and **Reminders coming up** (the next 24 hours). Each row opens: **Go to the chat** opens that conversation at that message, in its project (another project opens in its own tab, at the address `#chat=<id>:<message>`); **Stop** stops that turn, plan or server; **Stop everything**, confirmed, brakes everything in every project. On narrow screens it opens as a sheet from the bottom. It asks every 1.5 s with the panel open, every 5 s for the number, and not at all while the tab is hidden (`GET /api/activity?everywhere=1`, `POST /api/activity/stop`, `POST /api/activity/stop-all`; a project on an older MADRE is named apart). A phone never stops another project.
70
+
69
71
  **Theme.** Sun/moon in the bar: automatic, light or dark. The light theme does not glare; the Diagnostics screen stays phosphor.
70
72
 
71
73
  **Language.** The project speaks **Spanish** by default. The `EN` button in the bar switches it to English and the browser remembers it; `PULSE_LANGUAGE=en` overrides the config on the next start. A language is only how things read: what was written in the ledger keeps the words it was written with, and when shown it is said again in the project's language.
72
74
 
73
- The **terminal stays in English on purpose**: `madre doctor` and the startup print what people paste into an issue or search for in a search engine, and in English it can be found. What a CLI prints on its own is never touched either.
75
+ Since 1.1.0 the **terminal speaks the language you chose** (Spanish until you choose another; `PULSE_LANGUAGE` wins): the startup, `madre --help` and `madre doctor`. `madre doctor --json` and `madre check-module`, which other programs read, stay in English. What a CLI prints on its own is never touched.
74
76
 
75
77
  ---
76
78
 
@@ -118,6 +120,23 @@ Every message goes out with a mode. Your mode is the ceiling of any plan that me
118
120
 
119
121
  Web access is a permanent per-agent permission, off by default, turned on in Settings → Agents, with Web access.
120
122
 
123
+ ### Each AI's subagents
124
+
125
+ Since 1.1.0, from **#1 to #3**, Claude, OpenCode and Codex may split their work among their own subagents. Each subagent works with **exactly the turn's permission**: in #1 it only reads, in #2 it creates, in #3 it edits, it never touches `.git`, `.pulse`, `.madre` or `.env`, and what it changes is in the same restore point and undone with **Undo**. In **#4** only the main AI works.
126
+
127
+ | | From #1 to #3 | In #4 |
128
+ |---|---|---|
129
+ | **Claude** | The `Agent` tool: the subagent inherits the same tools and rules (`--tools`, `--allowedTools`, `dontAsk`) | No `Agent` |
130
+ | **OpenCode** | Only `explore` and `general`, each with the turn's permissions and unable to call another (OpenCode's own write and run commands) | `task` denied |
131
+ | **Codex** | Its subagents stay inside the same sandbox | A one-thread limit: `features.multi_agent_v2.max_concurrent_threads_per_session=1` |
132
+ | **Gemini** · **Cursor** | No | No |
133
+
134
+ Tried with the real AIs (Claude 2.1.267, OpenCode 1.18.4, Codex 0.161): in #1 the subagent reads and does not write; in #3 it writes in the project, `.pulse/` refuses it and there are no commands; in #4 Codex answers «agent thread limit reached».
135
+
136
+ **How they show.** While they work, a chip for each subagent under «working…» (live, `turn.subagents`, never in the record); once it answers, «Helped by N subagents» folded under the reply, with each one's task, what it read, searched or changed and what it reported, kept in `message.created.subagents` after the privacy guard (`src/adapters/subagents.mjs`). Claude says everything (`stream-json` output: start, each tool, end and summary; its tokens are summed over both answers when a subagent ran in the background). OpenCode says each one when it ends. Codex only says it worked with subagents.
137
+
138
+ **One question to several AIs.** A message that starts with several (`@opencode @madre …?`) goes to each one that is signed in, in a turn of its own, up to #2; the record ties them with `together` and the page shows the question once, with every AI after the arrow.
139
+
121
140
  ---
122
141
 
123
142
  ## PLANS
@@ -191,7 +210,7 @@ The button in the bar opens the diagnostics screen. Type a symptom, an agent or
191
210
  | In the header | What it does |
192
211
  |---|---|
193
212
  | Memory map (brain) | The memory as a map. It is also in the top bar |
194
- | Settings (gear) | Opens Settings › Version and reports, where the sentinel lives: the failures no condition explains and the process crashes, with paths, users, emails and keys removed. Each report is read before it is sent; auto-reporting comes turned off |
213
+ | Settings (gear) | Opens Settings › Version and reports, where the sentinel lives: the failures no condition explains and the process crashes, with paths, users, emails and keys removed. Auto-reporting comes on since 1.1.0, with the anonymous diagnostics, and is turned off right there |
195
214
  | Not fixed? | At the foot of each remedy: reports that it did not work, with the condition's code |
196
215
  | `?` | The five-stop tour, the same one that opens the first time. If you left the First steps list half done and hid it, it also brings it back |
197
216
 
@@ -305,6 +324,19 @@ Each project remembers where its folder is (`project.json`, next to its record);
305
324
 
306
325
  Plans live in `bishop-plans.json` next to the record of the Coordinator's project (the last 40) and each order received is counted in `enlaces.jsonl` of the project that received it.
307
326
 
327
+ ### Uninstalling MADRE
328
+
329
+ In **Home › Settings › Version › Uninstall MADRE** (`src/uninstall.mjs`, `public/power.js`). Before touching anything it shows the whole list (`GET /api/madre/uninstall`); on your yes (`POST`, only from Home's page on this computer) it closes every open project the way «Turn MADRE off» does and, if one does not close, removes nothing. With everything closed, Home closes and takes away:
330
+
331
+ | Goes | Stays |
332
+ |---|---|
333
+ | MADRE's folder (`~/.pulse` or `PULSE_HOME`): chats, memory, settings, modules, catalog, this copy's identifier and the AIs it installed in its own folder (`tools/`) | Your projects and their files |
334
+ | `.pulse/` inside each project MADRE knows, except `.pulse/out/` (what the AIs created at #2) unless you tick the box | `.madre/` inside a project: the modules you wrote |
335
+ | Those projects' restore points (`$TMPDIR/madre-shadow-<uid>/…`) | Your AIs and their sign-ins, Ollama and its models, npm's cache |
336
+ | The copy `npx` downloaded (`~/.npm/_npx/<hash>` holding only MADRE) | With `npm -g` or inside a project, the program: the last screen gives the command (`npm uninstall -g @jossuealcala/madre`). From source, its folder |
337
+
338
+ MADRE's folder is only taken away whole when it is MADRE's beyond doubt: an absolute path, never your home folder or one holding it, and with something MADRE always writes (`install-id`, `config.json`, `rooms`, `salas`).
339
+
308
340
  ---
309
341
 
310
342
  ## WHAT LEAVES THE MACHINE
@@ -312,7 +344,21 @@ Plans live in `bishop-plans.json` next to the record of the Coordinator's projec
312
344
  - **No cloud, no account.** MADRE has no account and no backend that stores your things. It does not store provider credentials.
313
345
  - **What an agent reads travels to its provider.** Codex to OpenAI, Claude Code to Anthropic, Gemini CLI to Google, OpenCode to whatever it is configured with. If `OPENAI_BASE_URL` or `ANTHROPIC_BASE_URL` changes that destination, MADRE shows only the hostname and blocks the turn before building the briefing; a verified gateway is authorized per agent with `PULSE_ALLOW_CUSTOM_AGENT_ENDPOINTS`. The account, limits and terms of the effective destination apply. `@madre` and the archivist with Ollama do not leave the machine.
314
346
  - **A daily notice that it is still in use, always on.** Once a day each copy tells madre.run that it is in use: a random identifier the copy created for itself (`~/.pulse/install-id`), the MADRE version, the operating system and the Node major version. Nothing else: no name, no email, no project, no paths, no agents, nothing of what is said in a project; madre.run does not keep the IP. It is how the author knows how many people use MADRE, which versions are running and whether they come back. It goes out through the same record as everything else, so it appears in "What is sent". Without a network, it fails silently. (`src/heartbeat.mjs`)
315
- - **Two sends of its own under your switch.** The sentinel, off by default, sends redacted reports to the project's collector. The release channel, on by default, asks npm for the latest version: only the package name travels, the same request `npx` makes. `PULSE_UPDATE_CHECK=0` turns it off.
347
+ - **Anonymous diagnostics, on unless you turn them off.** Since 2026-10-28 each copy keeps in `~/.pulse/telemetry/` the failures it meets (the ones Diagnostics knows, with their MU code, and the ones nobody catalogued) and how many turns, modes and features were used. Once a day, and soon after a failure never seen before, it sends them to madre.run with the four facts of the daily notice, its architecture and whether it runs in WSL, then deletes them. Messages leave without paths, user names, keys or emails. Never what you write, your projects or your files. Turned off in Settings › Version and reports › «Send anonymous diagnostics», or with `PULSE_TELEMETRY=0`. (`src/telemetry.mjs`, `public/page-errors.js`)
348
+ - **How each copy runs, its life and whether it is on right now (since 1.1.0, inside the anonymous diagnostics, under the same switch).**
349
+ - **Environment**, as numbers and names of MADRE's own parts:
350
+ - cores and memory in GB;
351
+ - MADRE's language and how it was installed (npx, global, inside a project or from source);
352
+ - the shell's name;
353
+ - whether Ollama is on and how many models it has;
354
+ - which agents are installed and which are ready;
355
+ - how many projects and how many are open;
356
+ - which of MADRE's own modules are on (one the person wrote only counts as «another»);
357
+ - how many days the copy has.
358
+ - **Life:** installed (a copy that never had an identifier), updated (a newer version opened for the first time, per `~/.pulse/lifecycle.json`), uninstalled (from Settings, sent before anything is removed) and each time Home opens.
359
+ - **Presence:** while MADRE is open, every five minutes it sends `madre.run/api/presence` only the random identifier, the version and the system, so the author knows how many copies are on now; only one of its processes says it. No path, project name, file or anything you write.
360
+ - **It turns off like the diagnostics.** The author's copies send no presence, and madre.run does not count them either. (`src/install-metrics.mjs`)
361
+ - **Sends of its own under your switch.** The sentinel, on by default since 1.1.0 (and off if you turn the anonymous diagnostics off), sends redacted reports to the project's collector. The release channel, on by default, asks npm for the latest version: only the package name travels, the same request `npx` makes. `PULSE_UPDATE_CHECK=0` turns it off.
316
362
  - **Writing.** In `#1` no one writes. In `#2` things are only added: what existed is restored when the turn ends. In `#3` the whole project except the forbidden zones, with a restore point and `UNDO`. In a project without git, MADRE keeps its snapshots in a shadow repository outside the project. A command an agent asks for is run by you, with a restore point before and `UNDO` after.
317
363
  - **Memory.** Everything said outside INCOGNITO stays in `~/.pulse/rooms/<sala>/` and comes back into the prompts of all the agents in that project. INCOGNITO is the way out for what must not be remembered; PRIVACY, for names that must never appear.
318
364
 
@@ -350,7 +396,8 @@ Plans live in `bishop-plans.json` next to the record of the Coordinator's projec
350
396
  | `PULSE_PRIVATE_TERMS` · `PULSE_PRIVATE_MARKER` | — · `[ENTIDAD-ORG]` | Extra hidden data and its marker |
351
397
  | `PULSE_UPDATE_CHECK` | `1` | `0` turns off the daily npm check |
352
398
  | `PULSE_GH` | `1` | `0` makes the GitHub module ignore the `gh` session and sign in only with the token you pasted |
353
- | `PULSE_REPORT_URL` · `PULSE_AUTO_REPORT` | the project's collector · `0` | Sentinel |
399
+ | `PULSE_REPORT_URL` · `PULSE_AUTO_REPORT` | the project's collector · as the anonymous diagnostics (`0` turns it off) | Sentinel |
400
+ | `PULSE_TERMS` | `accepted` takes the license as accepted (tests, screenshots and QA houses; `src/terms.mjs`) | License |
354
401
  | `PULSE_AGENT_TIMEOUT_MS` · `PULSE_<AGENTE>_TIMEOUT_MS` | `180000` · — | Timeouts |
355
402
  | `PULSE_ALLOW_CUSTOM_AGENT_ENDPOINTS` | — | Comma-separated list (`codex`, `claude`) of gateways the human verified and allows; without it, an unofficial base address is blocked |
356
403
  | `PULSE_MAX_MESSAGE_CHARS` | `20000` | Maximum size of a message |