@jossuealcala/madre 1.0.5 → 1.1.1
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.
- package/ADDITIONAL-TERMS.md +7 -2
- package/CHANGELOG.en.md +62 -1
- package/CHANGELOG.md +62 -1
- package/CONTRIBUTING.md +2 -2
- package/LICENSE +111 -661
- package/NOTICE +28 -23
- package/README.en.md +27 -102
- package/README.md +27 -104
- package/SECURITY.md +1 -0
- package/TRADEMARKS.en.md +13 -14
- package/TRADEMARKS.md +24 -26
- package/bin/madre.cjs +2 -2
- package/bin/madre.mjs +111 -40
- package/docs/REFERENCE.md +52 -5
- package/docs/SDK.md +21 -3
- package/docs/en/REFERENCE.md +52 -5
- package/docs/en/SDK.md +22 -3
- package/docs/sdk/hello-module.mjs +3 -0
- package/package.json +3 -2
- package/public/abduction.js +6 -6
- package/public/activity.js +425 -0
- package/public/app.js +2477 -438
- package/public/assets/abduction-cat-blink.webp +0 -0
- package/public/assets/abduction-cat-control-left.webp +0 -0
- package/public/assets/abduction-cat-control-right.webp +0 -0
- package/public/assets/abduction-cat.webp +0 -0
- package/public/assets/manual/shots/en-agents.webp +0 -0
- package/public/assets/manual/shots/en-chats.webp +0 -0
- package/public/assets/manual/shots/en-code.webp +0 -0
- package/public/assets/manual/shots/en-composer.webp +0 -0
- package/public/assets/manual/shots/en-connectors.webp +0 -0
- package/public/assets/manual/shots/en-continuity.webp +0 -0
- package/public/assets/manual/shots/en-coordinator.webp +0 -0
- package/public/assets/manual/shots/en-copilot.webp +0 -0
- package/public/assets/manual/shots/en-diagnostics.webp +0 -0
- package/public/assets/manual/shots/en-home.webp +0 -0
- package/public/assets/manual/shots/en-local.webp +0 -0
- package/public/assets/manual/shots/en-market.webp +0 -0
- package/public/assets/manual/shots/en-memory.webp +0 -0
- package/public/assets/manual/shots/en-modes.webp +0 -0
- package/public/assets/manual/shots/en-notes.webp +0 -0
- package/public/assets/manual/shots/en-settings.webp +0 -0
- package/public/assets/manual/shots/en-welcome.webp +0 -0
- package/public/assets/manual/shots/en-windows.webp +0 -0
- package/public/assets/manual/shots/es-agents.webp +0 -0
- package/public/assets/manual/shots/es-chats.webp +0 -0
- package/public/assets/manual/shots/es-code.webp +0 -0
- package/public/assets/manual/shots/es-composer.webp +0 -0
- package/public/assets/manual/shots/es-connectors.webp +0 -0
- package/public/assets/manual/shots/es-continuity.webp +0 -0
- package/public/assets/manual/shots/es-coordinator.webp +0 -0
- package/public/assets/manual/shots/es-copilot.webp +0 -0
- package/public/assets/manual/shots/es-diagnostics.webp +0 -0
- package/public/assets/manual/shots/es-home.webp +0 -0
- package/public/assets/manual/shots/es-local.webp +0 -0
- package/public/assets/manual/shots/es-market.webp +0 -0
- package/public/assets/manual/shots/es-memory.webp +0 -0
- package/public/assets/manual/shots/es-modes.webp +0 -0
- package/public/assets/manual/shots/es-notes.webp +0 -0
- package/public/assets/manual/shots/es-settings.webp +0 -0
- package/public/assets/manual/shots/es-welcome.webp +0 -0
- package/public/assets/manual/shots/es-windows.webp +0 -0
- package/public/assets/news/1.1/en/chats.webp +0 -0
- package/public/assets/news/1.1/en/home.webp +0 -0
- package/public/assets/news/1.1/en/maps.webp +0 -0
- package/public/assets/news/1.1/en/market.webp +0 -0
- package/public/assets/news/1.1/en/permissions.webp +0 -0
- package/public/assets/news/1.1/en/privacy.webp +0 -0
- package/public/assets/news/1.1/en/welcome.webp +0 -0
- package/public/assets/news/1.1/es/chats.webp +0 -0
- package/public/assets/news/1.1/es/home.webp +0 -0
- package/public/assets/news/1.1/es/maps.webp +0 -0
- package/public/assets/news/1.1/es/market.webp +0 -0
- package/public/assets/news/1.1/es/permissions.webp +0 -0
- package/public/assets/news/1.1/es/privacy.webp +0 -0
- package/public/assets/news/1.1/es/welcome.webp +0 -0
- package/public/attribution.js +15 -16
- package/public/brands.js +2 -2
- package/public/code-tools.js +2 -2
- package/public/editor.js +13 -13
- package/public/en.js +413 -4
- package/public/es.js +1354 -483
- package/public/hardware.js +2 -2
- package/public/i18n.js +2 -2
- package/public/icons.js +158 -0
- package/public/index.html +66 -48
- package/public/inquiry.js +2 -2
- package/public/loader.js +271 -2
- package/public/macroverso.js +64 -22
- package/public/manual-content.js +416 -169
- package/public/manual-shots.js +38 -34
- package/public/manual.css +20 -2
- package/public/manual.html +1 -1
- package/public/manual.js +54 -25
- package/public/market-art.js +47 -45
- package/public/market-view.js +111 -33
- package/public/market.js +132 -30
- package/public/mcp-catalog.js +2 -2
- package/public/neural.js +64 -8
- package/public/nostromo-engine.js +709 -40
- package/public/page-errors.js +31 -0
- package/public/power.js +350 -11
- package/public/remedy.js +89 -0
- package/public/resay.js +3 -2
- package/public/review-ask.js +12 -7
- package/public/routing.js +3 -3
- package/public/salas-mac.css +703 -24
- package/public/salas-mac.html +26 -14
- package/public/salas-mac.js +1261 -291
- package/public/salas.css +2 -2
- package/public/salas.html +3 -3
- package/public/salas.js +3 -3
- package/public/styles.css +2404 -291
- package/public/syntax.js +2 -2
- package/public/terms.js +152 -0
- package/public/touch.js +2 -2
- package/public/tour-chapters.js +10 -10
- package/public/tour.js +56 -8
- package/public/troubleshooting.js +200 -13
- package/public/wallpaper.js +4 -3
- package/public/welcome.js +923 -0
- package/src/activity.mjs +85 -0
- package/src/adapters/claude.mjs +61 -35
- package/src/adapters/codex.mjs +18 -5
- package/src/adapters/cursor.mjs +5 -3
- package/src/adapters/gemini.mjs +5 -3
- package/src/adapters/madre.mjs +3 -3
- package/src/adapters/opencode.mjs +73 -10
- package/src/adapters/process.mjs +14 -13
- package/src/adapters/subagents.mjs +159 -0
- package/src/asking.mjs +8 -2
- package/src/auth-probe.mjs +27 -10
- package/src/bridge/devices.mjs +2 -2
- package/src/bridge/handoff.mjs +2 -2
- package/src/bridge/host.mjs +2 -2
- package/src/bridge/network.mjs +2 -2
- package/src/bridge/policy.mjs +3 -3
- package/src/bridge/qr.mjs +2 -2
- package/src/bridge/server.mjs +2 -2
- package/src/builtin-updates.mjs +87 -0
- package/src/capabilities.mjs +2 -2
- package/src/chats.mjs +51 -2
- package/src/checkpoint.mjs +67 -9
- package/src/choices.mjs +2 -2
- package/src/cli-args.mjs +2 -2
- package/src/cold.mjs +2 -2
- package/src/commands.mjs +2 -2
- package/src/config.mjs +2 -2
- package/src/conversation-context.mjs +2 -2
- package/src/credentials.mjs +56 -16
- package/src/dataset.mjs +2 -2
- package/src/directives.mjs +2 -2
- package/src/distiller.mjs +2 -2
- package/src/embeddings.mjs +2 -2
- package/src/enlaces.mjs +2 -2
- package/src/environment.mjs +147 -0
- package/src/event-store.mjs +2 -2
- package/src/exam.mjs +2 -2
- package/src/extensions.mjs +2 -2
- package/src/eyecat-watch.mjs +2 -2
- package/src/eyecat.mjs +2 -2
- package/src/file-ops.mjs +2 -2
- package/src/files.mjs +2 -2
- package/src/github.mjs +2 -2
- package/src/heartbeat.mjs +2 -2
- package/src/history.mjs +2 -2
- package/src/i18n.mjs +9 -2
- package/src/image-studio.mjs +2 -2
- package/src/install-metrics.mjs +109 -0
- package/src/json-file.mjs +2 -2
- package/src/launch.mjs +2 -2
- package/src/lease.mjs +15 -4
- package/src/lobby-work.mjs +11 -4
- package/src/local-ai.mjs +2 -2
- package/src/looks.mjs +2 -2
- package/src/market-check.mjs +165 -0
- package/src/market-key.mjs +10 -2
- package/src/market-license.mjs +4 -4
- package/src/market-remote.mjs +54 -12
- package/src/maturity.mjs +2 -2
- package/src/mcp/connect.mjs +2 -2
- package/src/mcp/github-server.mjs +2 -2
- package/src/mcp/image-server.mjs +2 -2
- package/src/mcp/memory-server.mjs +2 -2
- package/src/mcp/proxy.mjs +2 -2
- package/src/mcp/smtp-server.mjs +2 -2
- package/src/memory-dashboard.mjs +2 -2
- package/src/memory-tools.mjs +2 -2
- package/src/memory.mjs +2 -2
- package/src/models.mjs +33 -3
- package/src/module-scope.mjs +2 -2
- package/src/modules/ahp.mjs +2 -2
- package/src/modules/ash-policy.mjs +2 -2
- package/src/modules/ash.mjs +2 -2
- package/src/modules/bishop-exam.mjs +2 -2
- package/src/modules/bishop-plan.mjs +2 -2
- package/src/modules/bishop.mjs +9 -3
- package/src/modules/choices.mjs +2 -2
- package/src/modules/correo.mjs +2 -2
- package/src/modules/enlaces.mjs +2 -2
- package/src/modules/git-pulse.mjs +2 -2
- package/src/modules/github.mjs +2 -2
- package/src/modules/helpers.mjs +2 -2
- package/src/modules/image-studio.mjs +2 -2
- package/src/modules/index.mjs +90 -5
- package/src/modules/intents-calibration.mjs +2 -2
- package/src/modules/intents-desk.mjs +4 -3
- package/src/modules/intents-observe.mjs +2 -2
- package/src/modules/intents-policy.mjs +2 -2
- package/src/modules/intents-try.mjs +2 -2
- package/src/modules/intents.mjs +2 -2
- package/src/modules/local-models.mjs +14 -11
- package/src/modules/mcp-connect.mjs +2 -2
- package/src/modules/notes.mjs +159 -20
- package/src/modules/ollama.mjs +23 -11
- package/src/modules/playwright.mjs +2 -2
- package/src/modules/reminders.mjs +356 -37
- package/src/modules/ripley.mjs +3 -3
- package/src/modules/runs.mjs +2 -2
- package/src/modules/sdk.mjs +38 -6
- package/src/modules/updates.mjs +2 -2
- package/src/mother.mjs +2 -2
- package/src/npm-launch.mjs +2 -2
- package/src/ollama.mjs +6 -4
- package/src/opencode-health.mjs +26 -6
- package/src/outbound.mjs +10 -2
- package/src/override.mjs +27 -22
- package/src/ports.mjs +2 -2
- package/src/prices.mjs +2 -2
- package/src/privacy.mjs +2 -2
- package/src/quota-monitor.mjs +2 -2
- package/src/quota-sources.mjs +2 -2
- package/src/request-guard.mjs +2 -2
- package/src/review-ask.mjs +4 -3
- package/src/room/archivist.mjs +2 -2
- package/src/room/attachments.mjs +2 -2
- package/src/room/budget.mjs +2 -2
- package/src/room/context.mjs +2 -2
- package/src/room/control.mjs +2 -2
- package/src/room/copilot.mjs +2 -2
- package/src/room/economy.mjs +2 -2
- package/src/room/escalation.mjs +2 -2
- package/src/room/ghost.mjs +2 -2
- package/src/room/guard.mjs +6 -4
- package/src/room/prompt.mjs +3 -3
- package/src/room/returns.mjs +2 -2
- package/src/room/runs.mjs +6 -4
- package/src/room/vectors.mjs +2 -2
- package/src/room.mjs +127 -31
- package/src/router.mjs +2 -2
- package/src/runs.mjs +2 -2
- package/src/runtime-detection.mjs +31 -5
- package/src/salas.mjs +31 -6
- package/src/sentinel-errors.mjs +17 -5
- package/src/server-sentinel.mjs +2 -2
- package/src/server.mjs +706 -84
- package/src/setup-trouble.mjs +35 -0
- package/src/setup.mjs +4 -4
- package/src/smtp.mjs +2 -2
- package/src/telemetry.mjs +266 -0
- package/src/terms.mjs +43 -0
- package/src/tour.mjs +39 -5
- package/src/uninstall.mjs +225 -0
- package/src/updates.mjs +2 -2
- package/src/usage-sentinel.mjs +2 -2
- package/src/vault.mjs +2 -2
- package/src/verdict.mjs +13 -10
- package/src/whats-new.mjs +97 -3
- package/public/assets/abduction-cat-blink.png +0 -0
- package/public/assets/abduction-cat-control-left.png +0 -0
- package/public/assets/abduction-cat-control-right.png +0 -0
- package/public/assets/abduction-cat.png +0 -0
- package/public/assets/manual/madre-manual-en.pdf +0 -0
- package/public/assets/manual/madre-manual-es.pdf +0 -0
- package/public/assets/manual/shots/en-modules.webp +0 -0
- package/public/assets/manual/shots/es-modules.webp +0 -0
- package/src/mcp/notes-server.mjs +0 -120
- package/src/reminder-time.mjs +0 -127
package/bin/madre.mjs
CHANGED
|
@@ -1,6 +1,6 @@
|
|
|
1
1
|
#!/usr/bin/env node
|
|
2
|
-
// SPDX-License-Identifier:
|
|
3
|
-
// MADRE · © 2026 Jossue Alcalá ·
|
|
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,42 @@ 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 points at the
|
|
30
|
+
// installer (1.1.1, WIN-033: one file, a double click, no terminal), keeps the terminal way below it
|
|
31
|
+
// for whoever prefers it, in the person's language, and stops. PULSE_WINDOWS_NATIVE=1 lets a
|
|
32
|
+
// developer go on anyway.
|
|
33
|
+
if (process.platform === 'win32' && process.env.PULSE_WINDOWS_NATIVE !== '1' && command !== 'help') {
|
|
34
|
+
const spanish = /^es\b/i.test(Intl.DateTimeFormat().resolvedOptions().locale ?? '');
|
|
35
|
+
console.log(spanish ? `
|
|
36
|
+
MADRE en Windows se instala con su instalador: descárgalo y ábrelo con doble clic.
|
|
37
|
+
|
|
38
|
+
https://madre.run/windows
|
|
39
|
+
|
|
40
|
+
Hace todo solo: enciende WSL (el Linux que viene con Windows), prepara el Linux de MADRE
|
|
41
|
+
y deja «MADRE» en el menú Inicio. Sin terminal.
|
|
42
|
+
|
|
43
|
+
¿Prefieres la terminal? Dentro de Ubuntu (WSL2):
|
|
44
|
+
curl -fsSL https://deb.nodesource.com/setup_22.x | sudo -E bash -
|
|
45
|
+
sudo apt install -y nodejs zstd
|
|
46
|
+
npx @jossuealcala/madre
|
|
47
|
+
` : `
|
|
48
|
+
On Windows, MADRE installs with its installer: download it and open it with a double click.
|
|
49
|
+
|
|
50
|
+
https://madre.run/en/windows
|
|
51
|
+
|
|
52
|
+
It does everything by itself: turns on WSL (the Linux that comes with Windows), prepares
|
|
53
|
+
MADRE's Linux and leaves «MADRE» in the Start menu. No terminal.
|
|
54
|
+
|
|
55
|
+
Prefer the terminal? Inside Ubuntu (WSL2):
|
|
56
|
+
curl -fsSL https://deb.nodesource.com/setup_22.x | sudo -E bash -
|
|
57
|
+
sudo apt install -y nodejs zstd
|
|
58
|
+
npx @jossuealcala/madre
|
|
59
|
+
`);
|
|
60
|
+
process.exit(1);
|
|
61
|
+
}
|
|
26
62
|
const option = (name, fallback) => cli.option(name.replace(/^--/, ''), fallback);
|
|
27
63
|
|
|
28
64
|
// Is a MADRE already serving this very project nearby? `start` walks ports, so look along the
|
|
@@ -50,6 +86,31 @@ const has = (name) => cli.has(name.replace(/^--/, ''));
|
|
|
50
86
|
// means finding the agents, opening the archive and waking the memory, and doing all of that only
|
|
51
87
|
// to then refuse is a wait nobody needed. The real bind below stays the authority: this only
|
|
52
88
|
// saves the waiting.
|
|
89
|
+
// What `madre --help` says, in the language MADRE speaks (src/i18n.mjs).
|
|
90
|
+
const HELP_TEXT = `MADRE
|
|
91
|
+
|
|
92
|
+
madre [--port 4317] [--no-open]
|
|
93
|
+
Opens Home: every project on this computer, in one place.
|
|
94
|
+
madre start [--project PATH] [--port 4317] [--no-open] [--setup]
|
|
95
|
+
Opens the project in this folder (or PATH) directly.
|
|
96
|
+
Without --port, a busy 4317 falls through to the next free port.
|
|
97
|
+
madre lobby [--port 4317] [--no-open] (also: madre salas; opens Home)
|
|
98
|
+
madre setup [--project PATH] [--port 4317] [--no-open]
|
|
99
|
+
madre doctor [--project PATH] [--json]
|
|
100
|
+
madre check-module --file <module.mjs> [--entry <entrada.json>] [--json] [--lang es]
|
|
101
|
+
|
|
102
|
+
(none) Opens Home. From there you add projects, connect the agents
|
|
103
|
+
and enter any project. The Coordinator lives there.
|
|
104
|
+
start Opens the project in this folder. From your home folder, Home.
|
|
105
|
+
setup Detects the agents on this computer, shows who has a session,
|
|
106
|
+
and runs each agent's own sign-in from here.
|
|
107
|
+
doctor Prints the same diagnosis without the wizard.
|
|
108
|
+
`;
|
|
109
|
+
|
|
110
|
+
// Where a room without --port starts looking (QA 1.1.0, GEN-02): 4317, or PULSE_PORT_BASE for the
|
|
111
|
+
// test suite and for whoever keeps another program on 4317.
|
|
112
|
+
const DEFAULT_PORT = /^\d{2,5}$/.test(String(process.env.PULSE_PORT_BASE ?? '')) ? String(process.env.PULSE_PORT_BASE) : '4317';
|
|
113
|
+
|
|
53
114
|
function portTaken(port, host = '127.0.0.1') {
|
|
54
115
|
return new Promise((resolve) => {
|
|
55
116
|
const probe = createServer();
|
|
@@ -64,7 +125,7 @@ async function openRoom(options) {
|
|
|
64
125
|
const explicit = cli.explicit('port');
|
|
65
126
|
let port = options.port;
|
|
66
127
|
if (explicit && await portTaken(port)) {
|
|
67
|
-
console.error(`\n
|
|
128
|
+
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
129
|
process.exit(2);
|
|
69
130
|
}
|
|
70
131
|
for (let attempt = 0; attempt < 20; attempt += 1) {
|
|
@@ -72,17 +133,17 @@ async function openRoom(options) {
|
|
|
72
133
|
return await startPulse({ ...options, port });
|
|
73
134
|
} catch (error) {
|
|
74
135
|
// The room itself says it is taken, whatever port this attempt used.
|
|
75
|
-
if (error.code === 'ROOM_IN_USE') { console.error(`\n
|
|
136
|
+
if (error.code === 'ROOM_IN_USE') { console.error(`\n MADRE › ${error.message}\n`); process.exit(2); }
|
|
76
137
|
if (error.code !== 'EADDRINUSE') throw error;
|
|
77
138
|
if (explicit) {
|
|
78
|
-
console.error(`\n
|
|
139
|
+
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
140
|
process.exit(2);
|
|
80
141
|
}
|
|
81
|
-
console.error(`
|
|
142
|
+
console.error(` MADRE › port ${port} in use, trying ${port + 1}.`);
|
|
82
143
|
port += 1;
|
|
83
144
|
}
|
|
84
145
|
}
|
|
85
|
-
console.error(`\n
|
|
146
|
+
console.error(`\n MADRE › no free port between ${options.port} and ${port}. Pass --port explicitly.\n`);
|
|
86
147
|
process.exit(2);
|
|
87
148
|
}
|
|
88
149
|
|
|
@@ -97,7 +158,7 @@ const projectRoot = projectRootFor({ command, named: cli.named, project: option(
|
|
|
97
158
|
const openPath = isSalasRoom(projectRoot, salasHome) ? '/salas' : '';
|
|
98
159
|
const [nodeMajor, nodeMinor] = process.versions.node.split('.').map(Number);
|
|
99
160
|
if (nodeMajor < 22 || (nodeMajor === 22 && nodeMinor < 5)) {
|
|
100
|
-
console.error(`\n
|
|
161
|
+
console.error(`\n MADRE › MADRE needs Node 22.5 or newer (found ${process.version}): the room's memory runs on node:sqlite.\n`);
|
|
101
162
|
process.exit(2);
|
|
102
163
|
}
|
|
103
164
|
if (has('--version') || has('-v') || command === 'version') {
|
|
@@ -108,17 +169,25 @@ if (has('--version') || has('-v') || command === 'version') {
|
|
|
108
169
|
console.log(`madre ${pkg.version}${commit ? ` · ${commit}` : ''} · node ${process.version}`);
|
|
109
170
|
process.exit(0);
|
|
110
171
|
}
|
|
111
|
-
|
|
172
|
+
// A command that only reads leaves nothing behind (QA 1.1.0, NUE-37): after uninstalling, `madre
|
|
173
|
+
// doctor` made ~/.pulse again, with Home's folder and the update cache in it.
|
|
174
|
+
const onlyReads = command === 'doctor' || command === 'check-module';
|
|
175
|
+
if (command !== 'help' && !(onlyReads && isSalasRoom(projectRoot, salasHome))) {
|
|
112
176
|
// The notebook of Salas is MADRE's own folder: made here, empty, the first time it is opened
|
|
113
177
|
// (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(`
|
|
178
|
+
if (isSalasRoom(projectRoot, salasHome)) await ensureSalasProject(salasHome).catch((error) => console.error(` MADRE › could not make the folder of Salas at ${projectRoot}: ${error.message}`));
|
|
115
179
|
const stats = await stat(projectRoot).catch(() => null);
|
|
116
180
|
if (!stats?.isDirectory()) {
|
|
117
|
-
console.error(`\n
|
|
181
|
+
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
182
|
process.exit(2);
|
|
119
183
|
}
|
|
120
184
|
}
|
|
121
|
-
|
|
185
|
+
const startConfig = await loadConfig(stateRoot);
|
|
186
|
+
applyConfigToEnv(startConfig);
|
|
187
|
+
// The terminal speaks the language MADRE was set to (QA 1.1.0, NUE-36): Spanish until someone
|
|
188
|
+
// chooses English, as the room does. PULSE_LANGUAGE still wins.
|
|
189
|
+
const { setLanguage: speakIn, t } = await import('../src/i18n.mjs');
|
|
190
|
+
speakIn(process.env.PULSE_LANGUAGE ?? startConfig?.language ?? 'es');
|
|
122
191
|
|
|
123
192
|
if (command === 'doctor' && (has('--catalog') || has('--conditions'))) {
|
|
124
193
|
// The same knowledge base MU/TH/UR uses in the room, printed for this platform.
|
|
@@ -175,36 +244,38 @@ if (command === 'doctor' && (has('--catalog') || has('--conditions'))) {
|
|
|
175
244
|
const { checkForUpdate, detectInstall, updateCommand } = await import('../src/updates.mjs');
|
|
176
245
|
const { join: joinPath } = await import('node:path');
|
|
177
246
|
const { homedir } = await import('node:os');
|
|
178
|
-
const
|
|
247
|
+
const stateFolder = process.env.PULSE_HOME ?? joinPath(homedir(), '.pulse');
|
|
248
|
+
const kept = await stat(stateFolder).then((found) => found.isDirectory(), () => false);
|
|
249
|
+
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
250
|
const update = { ...check, command: updateCommand(detectInstall({ projectRoot }), pkg.name, check.latest ?? 'latest') };
|
|
180
251
|
result.update = update;
|
|
181
252
|
|
|
182
253
|
if (has('--json')) {
|
|
183
254
|
console.log(JSON.stringify(result, null, 2));
|
|
184
255
|
} else {
|
|
185
|
-
console.log('
|
|
256
|
+
console.log(`\n${t('MADRE doctor')}\n`);
|
|
186
257
|
for (const agent of report) {
|
|
187
|
-
const mark = agent.ready ? 'ready' : agent.detected ? 'detected' : 'not found';
|
|
258
|
+
const mark = agent.ready ? t('ready') : agent.detected ? t('detected') : t('not found');
|
|
188
259
|
const session = agent.detected ? ` · ${agent.session.state}${agent.session.detail ? ` (${agent.session.detail})` : ''}` : '';
|
|
189
260
|
console.log(` ${agent.label.padEnd(10)} ${mark}${agent.version ? ` · ${agent.version}` : ''}${session}`);
|
|
190
261
|
}
|
|
191
|
-
console.log(` ${'Ollama'.padEnd(10)} ${ollama.disabled ? 'ignored (PULSE_OLLAMA=0)' : ollama.running ?
|
|
192
|
-
console.log(` ${'MADRE'.padEnd(10)} ${update.current}${update.available ? ` · ${update.latest}
|
|
193
|
-
console.log(`\n Project
|
|
194
|
-
console.log(result.ok ? '
|
|
262
|
+
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')}`);
|
|
263
|
+
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)')}`}`);
|
|
264
|
+
console.log(`\n ${t('Project').padEnd(10)} ${result.project}`);
|
|
265
|
+
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
266
|
}
|
|
196
267
|
process.exitCode = result.ok ? 0 : 1;
|
|
197
268
|
} else if (command === 'setup') {
|
|
198
269
|
const { action, online } = await runSetup({ projectRoot, stateRoot });
|
|
199
270
|
if (action === 'start') {
|
|
200
|
-
await openRoom({ port: Number(option('--port',
|
|
271
|
+
await openRoom({ port: Number(option('--port', DEFAULT_PORT)), projectRoot, openBrowser: !has('--no-open'), openPath });
|
|
201
272
|
} else {
|
|
202
273
|
process.exitCode = action === 'report' && !online ? 1 : 0;
|
|
203
274
|
}
|
|
204
275
|
} else if (command === 'start' || command === 'salas' || command === 'lobby') {
|
|
205
276
|
// `madre salas` is `madre start` on the notebook of Salas (projectRoot, above): the same look
|
|
206
277
|
// for a room already open, the same walk up the ports, the same browser unless --no-open.
|
|
207
|
-
const port = Number(option('--port',
|
|
278
|
+
const port = Number(option('--port', DEFAULT_PORT));
|
|
208
279
|
const noOpen = has('--no-open');
|
|
209
280
|
// First contact happens in the room, not here: MADRE opens even with nobody online and the
|
|
210
281
|
// bridge walks the human through installing and signing in. `madre setup` keeps the terminal
|
|
@@ -217,29 +288,29 @@ if (command === 'doctor' && (has('--catalog') || has('--conditions'))) {
|
|
|
217
288
|
const running = await roomAlreadyOpen(port, projectRoot);
|
|
218
289
|
if (running) {
|
|
219
290
|
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}`);
|
|
291
|
+
if (!noOpen) await openUrl(`${running.url}${openPath}`);
|
|
221
292
|
process.exit(0);
|
|
222
293
|
}
|
|
223
294
|
await openRoom({ port, projectRoot, openBrowser: !noOpen, openPath });
|
|
295
|
+
} else if (command === 'check-module') {
|
|
296
|
+
// The community Market's check (src/market-check.mjs): what the madre-mercado repository's CI runs on
|
|
297
|
+
// every pull request, and what anyone can run before sending one.
|
|
298
|
+
const file = option('--file', null);
|
|
299
|
+
const entryFile = option('--entry', null);
|
|
300
|
+
if (!file) { console.error('Usage: madre check-module --file <module.mjs> [--entry <entrada.json>] [--json] [--lang es]'); process.exit(2); }
|
|
301
|
+
// In English unless asked otherwise, whatever MADRE speaks elsewhere: this check runs in the
|
|
302
|
+
// madre-mercado repository's CI, whose pull requests' summary is asked for in Spanish (--lang es).
|
|
303
|
+
(await import('../src/i18n.mjs')).setLanguage(option('--lang', 'en'));
|
|
304
|
+
const { checkSubmission } = await import('../src/market-check.mjs');
|
|
305
|
+
const text = await readFile(file, 'utf8');
|
|
306
|
+
const entry = entryFile ? JSON.parse(await readFile(entryFile, 'utf8')) : null;
|
|
307
|
+
const { basename: fileName } = await import('node:path');
|
|
308
|
+
const result = await checkSubmission({ text, entry, name: fileName(file) });
|
|
309
|
+
if (has('--json')) console.log(JSON.stringify({ ...result, markdown: undefined }, null, 2));
|
|
310
|
+
else console.log(result.markdown);
|
|
311
|
+
process.exitCode = result.ok ? 0 : 1;
|
|
224
312
|
} else if (command === 'help') {
|
|
225
|
-
console.log(
|
|
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
|
-
`);
|
|
313
|
+
console.log(t(HELP_TEXT));
|
|
243
314
|
} else {
|
|
244
315
|
console.error(`Unknown command: ${command}`);
|
|
245
316
|
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
|
-
| `/
|
|
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
|
-
|
|
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.
|
|
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
|
-
- **
|
|
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**:
|
|
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
|
-
|
|
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
|
|
package/docs/en/REFERENCE.md
CHANGED
|
@@ -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
|
-
| `/
|
|
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
|
-
|
|
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.
|
|
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
|
-
- **
|
|
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 |
|