@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.
- package/ADDITIONAL-TERMS.md +7 -2
- package/CHANGELOG.en.md +152 -1
- package/CHANGELOG.md +152 -1
- package/CONTRIBUTING.md +2 -2
- package/LICENSE +111 -661
- package/NOTICE +59 -24
- package/README.en.md +36 -204
- package/README.md +36 -210
- package/SECURITY.md +1 -0
- package/TRADEMARKS.en.md +13 -14
- package/TRADEMARKS.md +42 -26
- package/bin/madre.cjs +2 -2
- package/bin/madre.mjs +114 -42
- package/docs/REFERENCE.md +53 -6
- package/docs/SDK.md +44 -5
- package/docs/en/REFERENCE.md +53 -6
- package/docs/en/SDK.md +43 -4
- package/docs/madre-banner.png +0 -0
- 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 +3519 -647
- 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 +483 -0
- package/public/es.js +1817 -598
- package/public/hardware.js +2 -2
- package/public/i18n.js +47 -9
- package/public/icons.js +158 -0
- package/public/index.html +68 -51
- package/public/inquiry.js +2 -2
- package/public/loader.js +271 -2
- package/public/macroverso.js +60 -21
- package/public/manual-content.js +900 -0
- package/public/manual-shots.js +47 -0
- package/public/manual.css +246 -0
- package/public/manual.html +15 -0
- package/public/manual.js +427 -0
- package/public/market-art.js +99 -41
- package/public/market-view.js +243 -47
- package/public/market.js +139 -26
- package/public/mcp-catalog.js +62 -0
- package/public/neural.js +64 -8
- package/public/nostromo-engine.js +709 -40
- package/public/page-errors.js +29 -0
- package/public/power.js +350 -11
- package/public/remedy.js +89 -0
- package/public/resay.js +4 -2
- package/public/review-ask.js +12 -7
- package/public/routing.js +3 -3
- package/public/salas-mac.css +875 -48
- package/public/salas-mac.html +27 -15
- package/public/salas-mac.js +1668 -338
- package/public/salas.css +2 -2
- package/public/salas.html +3 -3
- package/public/salas.js +3 -3
- package/public/styles.css +2694 -323
- package/public/syntax.js +2 -2
- package/public/terms.js +152 -0
- package/public/touch.js +2 -2
- package/public/tour-chapters.js +100 -92
- package/public/tour.js +118 -28
- package/public/troubleshooting.js +327 -21
- 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 +60 -9
- package/src/adapters/gemini.mjs +17 -4
- package/src/adapters/madre.mjs +30 -9
- package/src/adapters/opencode.mjs +73 -10
- package/src/adapters/process.mjs +19 -15
- package/src/adapters/subagents.mjs +159 -0
- package/src/asking.mjs +8 -2
- package/src/auth-probe.mjs +47 -11
- 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 +3 -3
- package/src/builtin-updates.mjs +87 -0
- package/src/capabilities.mjs +5 -5
- 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 +80 -18
- 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 +76 -0
- package/src/i18n.mjs +32 -3
- 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 +12 -4
- package/src/looks.mjs +19 -7
- package/src/market-check.mjs +165 -0
- package/src/market-key.mjs +10 -2
- package/src/market-license.mjs +104 -0
- package/src/market-remote.mjs +71 -13
- 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 +16 -5
- 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 +115 -12
- 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 +92 -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 +41 -10
- package/src/modules/mcp-connect.mjs +2 -2
- package/src/modules/notes.mjs +281 -0
- package/src/modules/ollama.mjs +48 -13
- package/src/modules/playwright.mjs +16 -5
- package/src/modules/reminders.mjs +664 -0
- package/src/modules/ripley.mjs +3 -3
- package/src/modules/runs.mjs +2 -2
- package/src/modules/sdk.mjs +57 -9
- package/src/modules/updates.mjs +2 -2
- package/src/mother.mjs +13 -3
- package/src/npm-launch.mjs +2 -2
- package/src/ollama.mjs +8 -6
- package/src/opencode-health.mjs +83 -0
- package/src/outbound.mjs +35 -3
- 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 +144 -36
- package/src/router.mjs +2 -2
- package/src/runs.mjs +2 -2
- package/src/runtime-detection.mjs +36 -6
- package/src/salas.mjs +31 -6
- package/src/sentinel-errors.mjs +17 -7
- package/src/server-sentinel.mjs +2 -2
- package/src/server.mjs +980 -139
- package/src/setup-trouble.mjs +33 -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 +60 -7
- 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/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,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
|
|
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
|
|
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
|
|
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(`
|
|
143
|
+
console.error(` MADRE › port ${port} in use, trying ${port + 1}.`);
|
|
82
144
|
port += 1;
|
|
83
145
|
}
|
|
84
146
|
}
|
|
85
|
-
console.error(`\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
|
|
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
|
-
|
|
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(`
|
|
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
|
|
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
|
-
|
|
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,
|
|
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('--') ?
|
|
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
|
|
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('
|
|
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 ?
|
|
192
|
-
console.log(` ${'MADRE'.padEnd(10)} ${update.current}${update.available ? ` · ${update.latest}
|
|
193
|
-
console.log(`\n Project
|
|
194
|
-
console.log(result.ok ? '
|
|
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',
|
|
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',
|
|
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(
|
|
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
|
-
| `/
|
|
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 |
|
|
@@ -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-
|
|
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**:
|
|
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
|
-
| `
|
|
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
|
-
|
|
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
|
|