@jossuealcala/madre 1.0.4 → 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 (273) hide show
  1. package/ADDITIONAL-TERMS.md +7 -2
  2. package/CHANGELOG.en.md +152 -1
  3. package/CHANGELOG.md +152 -1
  4. package/CONTRIBUTING.md +2 -2
  5. package/LICENSE +111 -661
  6. package/NOTICE +59 -24
  7. package/README.en.md +36 -204
  8. package/README.md +36 -210
  9. package/SECURITY.md +1 -0
  10. package/TRADEMARKS.en.md +13 -14
  11. package/TRADEMARKS.md +42 -26
  12. package/bin/madre.cjs +2 -2
  13. package/bin/madre.mjs +114 -42
  14. package/docs/REFERENCE.md +53 -6
  15. package/docs/SDK.md +44 -5
  16. package/docs/en/REFERENCE.md +53 -6
  17. package/docs/en/SDK.md +43 -4
  18. package/docs/madre-banner.png +0 -0
  19. package/docs/sdk/hello-module.mjs +3 -0
  20. package/package.json +3 -2
  21. package/public/abduction.js +6 -6
  22. package/public/activity.js +425 -0
  23. package/public/app.js +3519 -647
  24. package/public/assets/abduction-cat-blink.webp +0 -0
  25. package/public/assets/abduction-cat-control-left.webp +0 -0
  26. package/public/assets/abduction-cat-control-right.webp +0 -0
  27. package/public/assets/abduction-cat.webp +0 -0
  28. package/public/assets/manual/shots/en-agents.webp +0 -0
  29. package/public/assets/manual/shots/en-chats.webp +0 -0
  30. package/public/assets/manual/shots/en-code.webp +0 -0
  31. package/public/assets/manual/shots/en-composer.webp +0 -0
  32. package/public/assets/manual/shots/en-connectors.webp +0 -0
  33. package/public/assets/manual/shots/en-continuity.webp +0 -0
  34. package/public/assets/manual/shots/en-coordinator.webp +0 -0
  35. package/public/assets/manual/shots/en-copilot.webp +0 -0
  36. package/public/assets/manual/shots/en-diagnostics.webp +0 -0
  37. package/public/assets/manual/shots/en-home.webp +0 -0
  38. package/public/assets/manual/shots/en-local.webp +0 -0
  39. package/public/assets/manual/shots/en-market.webp +0 -0
  40. package/public/assets/manual/shots/en-memory.webp +0 -0
  41. package/public/assets/manual/shots/en-modes.webp +0 -0
  42. package/public/assets/manual/shots/en-notes.webp +0 -0
  43. package/public/assets/manual/shots/en-settings.webp +0 -0
  44. package/public/assets/manual/shots/en-welcome.webp +0 -0
  45. package/public/assets/manual/shots/en-windows.webp +0 -0
  46. package/public/assets/manual/shots/es-agents.webp +0 -0
  47. package/public/assets/manual/shots/es-chats.webp +0 -0
  48. package/public/assets/manual/shots/es-code.webp +0 -0
  49. package/public/assets/manual/shots/es-composer.webp +0 -0
  50. package/public/assets/manual/shots/es-connectors.webp +0 -0
  51. package/public/assets/manual/shots/es-continuity.webp +0 -0
  52. package/public/assets/manual/shots/es-coordinator.webp +0 -0
  53. package/public/assets/manual/shots/es-copilot.webp +0 -0
  54. package/public/assets/manual/shots/es-diagnostics.webp +0 -0
  55. package/public/assets/manual/shots/es-home.webp +0 -0
  56. package/public/assets/manual/shots/es-local.webp +0 -0
  57. package/public/assets/manual/shots/es-market.webp +0 -0
  58. package/public/assets/manual/shots/es-memory.webp +0 -0
  59. package/public/assets/manual/shots/es-modes.webp +0 -0
  60. package/public/assets/manual/shots/es-notes.webp +0 -0
  61. package/public/assets/manual/shots/es-settings.webp +0 -0
  62. package/public/assets/manual/shots/es-welcome.webp +0 -0
  63. package/public/assets/manual/shots/es-windows.webp +0 -0
  64. package/public/assets/news/1.1/en/chats.webp +0 -0
  65. package/public/assets/news/1.1/en/home.webp +0 -0
  66. package/public/assets/news/1.1/en/maps.webp +0 -0
  67. package/public/assets/news/1.1/en/market.webp +0 -0
  68. package/public/assets/news/1.1/en/permissions.webp +0 -0
  69. package/public/assets/news/1.1/en/privacy.webp +0 -0
  70. package/public/assets/news/1.1/en/welcome.webp +0 -0
  71. package/public/assets/news/1.1/es/chats.webp +0 -0
  72. package/public/assets/news/1.1/es/home.webp +0 -0
  73. package/public/assets/news/1.1/es/maps.webp +0 -0
  74. package/public/assets/news/1.1/es/market.webp +0 -0
  75. package/public/assets/news/1.1/es/permissions.webp +0 -0
  76. package/public/assets/news/1.1/es/privacy.webp +0 -0
  77. package/public/assets/news/1.1/es/welcome.webp +0 -0
  78. package/public/attribution.js +15 -16
  79. package/public/brands.js +2 -2
  80. package/public/code-tools.js +2 -2
  81. package/public/editor.js +13 -13
  82. package/public/en.js +483 -0
  83. package/public/es.js +1817 -598
  84. package/public/hardware.js +2 -2
  85. package/public/i18n.js +47 -9
  86. package/public/icons.js +158 -0
  87. package/public/index.html +68 -51
  88. package/public/inquiry.js +2 -2
  89. package/public/loader.js +271 -2
  90. package/public/macroverso.js +60 -21
  91. package/public/manual-content.js +900 -0
  92. package/public/manual-shots.js +47 -0
  93. package/public/manual.css +246 -0
  94. package/public/manual.html +15 -0
  95. package/public/manual.js +427 -0
  96. package/public/market-art.js +99 -41
  97. package/public/market-view.js +243 -47
  98. package/public/market.js +139 -26
  99. package/public/mcp-catalog.js +62 -0
  100. package/public/neural.js +64 -8
  101. package/public/nostromo-engine.js +709 -40
  102. package/public/page-errors.js +29 -0
  103. package/public/power.js +350 -11
  104. package/public/remedy.js +89 -0
  105. package/public/resay.js +4 -2
  106. package/public/review-ask.js +12 -7
  107. package/public/routing.js +3 -3
  108. package/public/salas-mac.css +875 -48
  109. package/public/salas-mac.html +27 -15
  110. package/public/salas-mac.js +1668 -338
  111. package/public/salas.css +2 -2
  112. package/public/salas.html +3 -3
  113. package/public/salas.js +3 -3
  114. package/public/styles.css +2694 -323
  115. package/public/syntax.js +2 -2
  116. package/public/terms.js +152 -0
  117. package/public/touch.js +2 -2
  118. package/public/tour-chapters.js +100 -92
  119. package/public/tour.js +118 -28
  120. package/public/troubleshooting.js +327 -21
  121. package/public/wallpaper.js +4 -3
  122. package/public/welcome.js +923 -0
  123. package/src/activity.mjs +85 -0
  124. package/src/adapters/claude.mjs +61 -35
  125. package/src/adapters/codex.mjs +18 -5
  126. package/src/adapters/cursor.mjs +60 -9
  127. package/src/adapters/gemini.mjs +17 -4
  128. package/src/adapters/madre.mjs +30 -9
  129. package/src/adapters/opencode.mjs +73 -10
  130. package/src/adapters/process.mjs +19 -15
  131. package/src/adapters/subagents.mjs +159 -0
  132. package/src/asking.mjs +8 -2
  133. package/src/auth-probe.mjs +47 -11
  134. package/src/bridge/devices.mjs +2 -2
  135. package/src/bridge/handoff.mjs +2 -2
  136. package/src/bridge/host.mjs +2 -2
  137. package/src/bridge/network.mjs +2 -2
  138. package/src/bridge/policy.mjs +3 -3
  139. package/src/bridge/qr.mjs +2 -2
  140. package/src/bridge/server.mjs +3 -3
  141. package/src/builtin-updates.mjs +87 -0
  142. package/src/capabilities.mjs +5 -5
  143. package/src/chats.mjs +51 -2
  144. package/src/checkpoint.mjs +67 -9
  145. package/src/choices.mjs +2 -2
  146. package/src/cli-args.mjs +2 -2
  147. package/src/cold.mjs +2 -2
  148. package/src/commands.mjs +2 -2
  149. package/src/config.mjs +2 -2
  150. package/src/conversation-context.mjs +2 -2
  151. package/src/credentials.mjs +80 -18
  152. package/src/dataset.mjs +2 -2
  153. package/src/directives.mjs +2 -2
  154. package/src/distiller.mjs +2 -2
  155. package/src/embeddings.mjs +2 -2
  156. package/src/enlaces.mjs +2 -2
  157. package/src/environment.mjs +147 -0
  158. package/src/event-store.mjs +2 -2
  159. package/src/exam.mjs +2 -2
  160. package/src/extensions.mjs +2 -2
  161. package/src/eyecat-watch.mjs +2 -2
  162. package/src/eyecat.mjs +2 -2
  163. package/src/file-ops.mjs +2 -2
  164. package/src/files.mjs +2 -2
  165. package/src/github.mjs +2 -2
  166. package/src/heartbeat.mjs +2 -2
  167. package/src/history.mjs +76 -0
  168. package/src/i18n.mjs +32 -3
  169. package/src/image-studio.mjs +2 -2
  170. package/src/install-metrics.mjs +109 -0
  171. package/src/json-file.mjs +2 -2
  172. package/src/launch.mjs +2 -2
  173. package/src/lease.mjs +15 -4
  174. package/src/lobby-work.mjs +11 -4
  175. package/src/local-ai.mjs +12 -4
  176. package/src/looks.mjs +19 -7
  177. package/src/market-check.mjs +165 -0
  178. package/src/market-key.mjs +10 -2
  179. package/src/market-license.mjs +104 -0
  180. package/src/market-remote.mjs +71 -13
  181. package/src/maturity.mjs +2 -2
  182. package/src/mcp/connect.mjs +2 -2
  183. package/src/mcp/github-server.mjs +2 -2
  184. package/src/mcp/image-server.mjs +2 -2
  185. package/src/mcp/memory-server.mjs +2 -2
  186. package/src/mcp/proxy.mjs +16 -5
  187. package/src/mcp/smtp-server.mjs +2 -2
  188. package/src/memory-dashboard.mjs +2 -2
  189. package/src/memory-tools.mjs +2 -2
  190. package/src/memory.mjs +2 -2
  191. package/src/models.mjs +115 -12
  192. package/src/module-scope.mjs +2 -2
  193. package/src/modules/ahp.mjs +2 -2
  194. package/src/modules/ash-policy.mjs +2 -2
  195. package/src/modules/ash.mjs +2 -2
  196. package/src/modules/bishop-exam.mjs +2 -2
  197. package/src/modules/bishop-plan.mjs +2 -2
  198. package/src/modules/bishop.mjs +9 -3
  199. package/src/modules/choices.mjs +2 -2
  200. package/src/modules/correo.mjs +2 -2
  201. package/src/modules/enlaces.mjs +2 -2
  202. package/src/modules/git-pulse.mjs +2 -2
  203. package/src/modules/github.mjs +2 -2
  204. package/src/modules/helpers.mjs +2 -2
  205. package/src/modules/image-studio.mjs +2 -2
  206. package/src/modules/index.mjs +92 -5
  207. package/src/modules/intents-calibration.mjs +2 -2
  208. package/src/modules/intents-desk.mjs +4 -3
  209. package/src/modules/intents-observe.mjs +2 -2
  210. package/src/modules/intents-policy.mjs +2 -2
  211. package/src/modules/intents-try.mjs +2 -2
  212. package/src/modules/intents.mjs +2 -2
  213. package/src/modules/local-models.mjs +41 -10
  214. package/src/modules/mcp-connect.mjs +2 -2
  215. package/src/modules/notes.mjs +281 -0
  216. package/src/modules/ollama.mjs +48 -13
  217. package/src/modules/playwright.mjs +16 -5
  218. package/src/modules/reminders.mjs +664 -0
  219. package/src/modules/ripley.mjs +3 -3
  220. package/src/modules/runs.mjs +2 -2
  221. package/src/modules/sdk.mjs +57 -9
  222. package/src/modules/updates.mjs +2 -2
  223. package/src/mother.mjs +13 -3
  224. package/src/npm-launch.mjs +2 -2
  225. package/src/ollama.mjs +8 -6
  226. package/src/opencode-health.mjs +83 -0
  227. package/src/outbound.mjs +35 -3
  228. package/src/override.mjs +27 -22
  229. package/src/ports.mjs +2 -2
  230. package/src/prices.mjs +2 -2
  231. package/src/privacy.mjs +2 -2
  232. package/src/quota-monitor.mjs +2 -2
  233. package/src/quota-sources.mjs +2 -2
  234. package/src/request-guard.mjs +2 -2
  235. package/src/review-ask.mjs +4 -3
  236. package/src/room/archivist.mjs +2 -2
  237. package/src/room/attachments.mjs +2 -2
  238. package/src/room/budget.mjs +2 -2
  239. package/src/room/context.mjs +2 -2
  240. package/src/room/control.mjs +2 -2
  241. package/src/room/copilot.mjs +2 -2
  242. package/src/room/economy.mjs +2 -2
  243. package/src/room/escalation.mjs +2 -2
  244. package/src/room/ghost.mjs +2 -2
  245. package/src/room/guard.mjs +6 -4
  246. package/src/room/prompt.mjs +3 -3
  247. package/src/room/returns.mjs +2 -2
  248. package/src/room/runs.mjs +6 -4
  249. package/src/room/vectors.mjs +2 -2
  250. package/src/room.mjs +144 -36
  251. package/src/router.mjs +2 -2
  252. package/src/runs.mjs +2 -2
  253. package/src/runtime-detection.mjs +36 -6
  254. package/src/salas.mjs +31 -6
  255. package/src/sentinel-errors.mjs +17 -7
  256. package/src/server-sentinel.mjs +2 -2
  257. package/src/server.mjs +980 -139
  258. package/src/setup-trouble.mjs +33 -0
  259. package/src/setup.mjs +4 -4
  260. package/src/smtp.mjs +2 -2
  261. package/src/telemetry.mjs +266 -0
  262. package/src/terms.mjs +43 -0
  263. package/src/tour.mjs +60 -7
  264. package/src/uninstall.mjs +225 -0
  265. package/src/updates.mjs +2 -2
  266. package/src/usage-sentinel.mjs +2 -2
  267. package/src/vault.mjs +2 -2
  268. package/src/verdict.mjs +13 -10
  269. package/src/whats-new.mjs +97 -3
  270. package/public/assets/abduction-cat-blink.png +0 -0
  271. package/public/assets/abduction-cat-control-left.png +0 -0
  272. package/public/assets/abduction-cat-control-right.png +0 -0
  273. package/public/assets/abduction-cat.png +0 -0
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,24 +170,32 @@ 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.
125
- const { CONDITIONS, fixesFor, searchConditions, PLATFORMS } = await import('../public/troubleshooting.js');
195
+ const { CONDITIONS, findConditions, fixesFor, PLATFORMS } = await import('../public/troubleshooting.js');
126
196
  const query = option('--catalog', '') || option('--conditions', '') || '';
127
197
  const platform = PLATFORMS[process.platform] ? process.platform : 'linux';
128
- const list = query && !query.startsWith('--') ? searchConditions(query) : CONDITIONS;
198
+ const list = query && !query.startsWith('--') ? findConditions(query) : CONDITIONS;
129
199
  console.log(`\nDIAGNOSTICS · KNOWN CONDITIONS · ${list.length} OF ${CONDITIONS.length} · ${PLATFORMS[platform].label.toUpperCase()} / ${PLATFORMS[platform].shell.toUpperCase()}\n`);
130
200
  for (const condition of list) {
131
201
  console.log(`▌ ${condition.title}`);
@@ -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 |
@@ -358,7 +405,7 @@ Los planes viven en `bishop-plans.json` junto al registro del proyecto del Coord
358
405
  | `PULSE_ESCALATION_MS` | `180000` | Cronómetro de la solicitud de permiso |
359
406
  | `PULSE_OPENCODE_MODEL` | del config | `proveedor/modelo` para OpenCode |
360
407
  | `PULSE_CLAUDE_USAGE` · `PULSE_OFFICIAL_QUOTA` | `0` · `1` | Cuota oficial de Claude (lee el llavero); `0` apaga todas las lecturas de proveedor |
361
- | `PULSE_GEMINI_IDLE_MS` · `PULSE_GEMINI_RETRIES` · `PULSE_GEMINI_FALLBACK_MODEL` | `90000` · `1` · `gemini-2.5-flash` | Gemini bajo carga |
408
+ | `PULSE_GEMINI_IDLE_MS` · `PULSE_GEMINI_RETRIES` · `PULSE_GEMINI_FALLBACK_MODEL` | `90000` · `1` · `gemini-3-flash-preview` (vacío: sin respaldo) | Gemini bajo carga |
362
409
 
363
410
  Cómo funcionan por dentro el ledger, el stream, la memoria, los adaptadores y la recuperación: [`docs/INTERNALS.md`](INTERNALS.md).
364
411
 
package/docs/SDK.md CHANGED
@@ -54,15 +54,16 @@ export default ({ defineModule }) => defineModule({
54
54
 
55
55
  ## Lo que un módulo puede declarar
56
56
 
57
- Esta tabla es **el contrato completo**: 38 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
 
61
61
 
62
62
  | Campo | Qué es |
63
63
  |---|---|
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 |
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 |
@@ -73,7 +74,9 @@ la suite compara esta tabla contra el código, así que si alguna vez se separan
73
74
  | `onToggle(ctx, enabled)` | Reacciona al interruptor |
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
- | `slash` | Comandos `/nombre` que corren en el servidor con tu `ctx` y devuelven `{ ok, title, text }`. La sala los muestra como tarjeta y los agentes los leen |
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 |
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 |
77
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 |
78
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 |
79
82
  | `reaches` | A dónde llega tu módulo, en las mismas cuatro respuestas que da MADRE de las suyas. Ver abajo |
@@ -235,6 +238,19 @@ La ficha de un módulo tuyo trae **GET A NEWER FILE**: MADRE va por el archivo
235
238
 
236
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ú.
237
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
+
238
254
  ## La ficha
239
255
 
240
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.
@@ -263,11 +279,34 @@ ctx = {
263
279
  env, agents, room, // agentes detectados; la sala (room.capabilities(), room.record(...))
264
280
  readConfig(), updateConfig(patch),
265
281
  record(type, payload), // escribe un evento en el ledger; tipo "algo.algo", nunca message.* ni agent.*
266
- services: { 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)
267
286
  vault: { get, held, keep, forget } // tus secretos, y solo los tuyos
268
287
  }
269
288
  ```
270
289
 
290
+ ### El historial del proyecto
291
+
292
+ `await ctx.services.history({ since, until })` devuelve lo que pasó en el proyecto en ese periodo (fechas ISO; sin ellas, todo). Solo lee, nunca escribe, y lo dicho en `#0` GHOST no aparece:
293
+
294
+ ```
295
+ {
296
+ project, since, until,
297
+ requests: [{ at, chat, to, mode, text }], // lo que pidió la humana y a quién
298
+ answers: [{ at, chat, agent, text }], // las respuestas de cada agente
299
+ changes: [{ at, chat, agent, mode, files: [{ status, path }], undone }],
300
+ files: [{ path, status }], // lo que cambió y se quedó (sin lo deshecho)
301
+ decisions: [{ at, text, agent }], // las decisiones que guardó la memoria
302
+ agents: { codex: { turns, failed, tokens, costUsd, local } },
303
+ conversations: [{ id, title, requests }],
304
+ totals: { requests, answers, tokens, costUsd }
305
+ }
306
+ ```
307
+
308
+ Los textos llegan recortados a 600 caracteres. Es la base de un módulo que informa sobre el trabajo, como el Informe de trabajo del Mercado.
309
+
271
310
  `turn`, en `toolsForTurn`: `{ agent, mode, lease, scratchDir, port, roomDir }`. `mode` va de 0 a 4; en 0 (GHOST) nada se guarda, decide si quieres entregar herramientas ahí.
272
311
 
273
312
  ## Reglas de la casa
@@ -280,7 +319,7 @@ ctx = {
280
319
 
281
320
  ## Que lo construya tu IA, en la sala
282
321
 
283
- 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.
284
323
 
285
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.
286
325