@jossuealcala/madre 1.1.2 → 1.1.3

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (101) hide show
  1. package/CHANGELOG.en.md +21 -1
  2. package/CHANGELOG.md +21 -1
  3. package/README.en.md +3 -3
  4. package/README.md +3 -3
  5. package/SECURITY.md +11 -6
  6. package/bin/madre.mjs +74 -11
  7. package/docs/REFERENCE.md +13 -7
  8. package/docs/SDK.md +8 -8
  9. package/docs/en/REFERENCE.md +10 -6
  10. package/docs/en/SDK.md +8 -8
  11. package/docs/en/training/README.md +1 -1
  12. package/docs/sdk/connector-module.mjs +1 -1
  13. package/docs/sdk/hello-module.mjs +1 -1
  14. package/docs/training/README.md +1 -1
  15. package/docs/training/train.sh +3 -0
  16. package/package.json +4 -2
  17. package/public/activity.js +9 -0
  18. package/public/app.js +988 -171
  19. package/public/attribution.js +9 -0
  20. package/public/brands.js +27 -13
  21. package/public/en.js +1 -2
  22. package/public/es.js +834 -257
  23. package/public/index.html +3 -0
  24. package/public/macroverso.js +24 -5
  25. package/public/manual-content.js +32 -2
  26. package/public/market-view.js +116 -9
  27. package/public/market.js +15 -0
  28. package/public/news-scenes.js +185 -0
  29. package/public/notices.js +66 -0
  30. package/public/power.js +1 -1
  31. package/public/resay.js +3 -0
  32. package/public/salas-mac.css +229 -26
  33. package/public/salas-mac.html +3 -0
  34. package/public/salas-mac.js +454 -37
  35. package/public/styles.css +393 -17
  36. package/public/tips.js +124 -0
  37. package/public/tour-chapters.js +75 -75
  38. package/public/tour.js +36 -8
  39. package/public/troubleshooting.js +215 -22
  40. package/public/welcome-scene.js +358 -0
  41. package/public/welcome.js +514 -273
  42. package/src/adapters/gemini-rest.mjs +236 -0
  43. package/src/adapters/gemini.mjs +9 -7
  44. package/src/adapters/grok.mjs +288 -0
  45. package/src/adapters/process.mjs +14 -3
  46. package/src/auth-probe.mjs +32 -0
  47. package/src/bridge/policy.mjs +1 -1
  48. package/src/capabilities.mjs +30 -0
  49. package/src/checkpoint.mjs +115 -1
  50. package/src/codex-route.mjs +113 -0
  51. package/src/credentials.mjs +46 -8
  52. package/src/dataset.mjs +18 -7
  53. package/src/event-store.mjs +10 -2
  54. package/src/ficha.mjs +142 -0
  55. package/src/files.mjs +36 -2
  56. package/src/lease.mjs +5 -0
  57. package/src/market-check.mjs +1 -1
  58. package/src/market-remote.mjs +135 -1
  59. package/src/mcp/image-server.mjs +1 -1
  60. package/src/mcp/memory-server.mjs +10 -0
  61. package/src/memory-tools.mjs +3 -0
  62. package/src/memory.mjs +29 -4
  63. package/src/models.mjs +21 -3
  64. package/src/modules/ahp.mjs +8 -3
  65. package/src/modules/bishop-exam.mjs +41 -12
  66. package/src/modules/bishop.mjs +2 -2
  67. package/src/modules/choices.mjs +12 -10
  68. package/src/modules/fetch-alone.mjs +7 -0
  69. package/src/modules/helpers.mjs +23 -5
  70. package/src/modules/image-studio.mjs +13 -27
  71. package/src/modules/index.mjs +54 -11
  72. package/src/modules/isolated.mjs +160 -0
  73. package/src/modules/ollama.mjs +35 -6
  74. package/src/modules/playwright.mjs +46 -17
  75. package/src/modules/run-alone.mjs +122 -0
  76. package/src/modules/runs.mjs +11 -8
  77. package/src/modules/sdk.mjs +4 -2
  78. package/src/notices-key.mjs +8 -0
  79. package/src/notices.mjs +185 -0
  80. package/src/ollama.mjs +57 -15
  81. package/src/outbound.mjs +45 -8
  82. package/src/room/archivist.mjs +30 -5
  83. package/src/room/busy.mjs +16 -0
  84. package/src/room/control.mjs +36 -6
  85. package/src/room/guard.mjs +32 -2
  86. package/src/room/prompt.mjs +32 -5
  87. package/src/room/vectors.mjs +7 -1
  88. package/src/room.mjs +94 -28
  89. package/src/router.mjs +1 -1
  90. package/src/runs.mjs +39 -0
  91. package/src/runtime-detection.mjs +46 -6
  92. package/src/salas.mjs +151 -15
  93. package/src/server.mjs +577 -80
  94. package/src/service.mjs +116 -0
  95. package/src/setup-trouble.mjs +20 -1
  96. package/src/skill-check.mjs +269 -0
  97. package/src/skills-import.mjs +128 -0
  98. package/src/skills.mjs +492 -0
  99. package/src/tour.mjs +14 -3
  100. package/src/whats-new.mjs +48 -0
  101. package/src/rumbo.mjs +0 -337
package/src/ficha.mjs ADDED
@@ -0,0 +1,142 @@
1
+ // SPDX-License-Identifier: BUSL-1.1
2
+ // MADRE · © 2026 Jossue Alcalá · Business Source License 1.1: LICENSE
3
+ // The ficha: what a request to MADRE carries to show it comes from the person (2026-11-02,
4
+ // external review #5).
5
+ //
6
+ // MADRE listens on 127.0.0.1, and request-guard.mjs keeps other web pages out. It did not keep out
7
+ // other programs: any process of this computer — of any user, and in WSL2 any program of Windows —
8
+ // could read a project's conversations, install a module that runs with the person's permissions,
9
+ // or open #4 by writing an Origin header by hand. Now every request that reads or changes something
10
+ // carries the ficha: a random secret in `~/.pulse/credentials/ficha.json`, readable only by the
11
+ // person's own user (0600 inside 0700), as Jupyter does with its token.
12
+ //
13
+ // · The browser gets it once, in the address MADRE opens (`?ficha=…`): the page answers with a
14
+ // cookie (HttpOnly, SameSite=Strict) and the same address without it. Cookies do not tell ports
15
+ // apart, so the one cookie serves Home and every project of this computer.
16
+ // · MADRE's own processes (the CLI, Home asking a project, a project asking another) read the file
17
+ // and send it in the `x-madre-ficha` header.
18
+ // · Home makes a new one each time it starts and opens the browser itself, so a ficha lives as
19
+ // long as that run. A restart with no browser (an update, a project Home opens) keeps it, and
20
+ // so do the tabs already open.
21
+ //
22
+ // What it does not stop, and is said in SECURITY.md: a program running as the person can read the
23
+ // file, as it can read everything else of theirs; and the cookie travels to any other port of
24
+ // 127.0.0.1 this browser visits.
25
+ import { createHmac, randomBytes, randomUUID, timingSafeEqual } from 'node:crypto';
26
+ import { fchmodSync, openSync } from 'node:fs';
27
+ import { chmod, mkdir, readFile, rename, rm, stat, writeFile } from 'node:fs/promises';
28
+ import { homedir } from 'node:os';
29
+ import { join } from 'node:path';
30
+
31
+ export const FICHA_HEADER = 'x-madre-ficha';
32
+ export const FICHA_COOKIE = 'madre_ficha';
33
+ export const FICHA_PARAM = 'ficha';
34
+ // What a 401 says in its headers, so the page knows to reload into the page that explains it.
35
+ export const FICHA_NEEDED = 'needed';
36
+ const OWNER_ONLY = 0o600;
37
+ const OWNER_DIR = 0o700;
38
+ const FICHA_HEX = /^[0-9a-f]{64}$/;
39
+
40
+ export const defaultStateRoot = (env = process.env) => env.PULSE_HOME ?? join(homedir(), '.pulse');
41
+ export const fichaFile = (stateRoot) => join(stateRoot, 'credentials', 'ficha.json');
42
+
43
+ // The ficha on file, or null when there is none (or it is not one).
44
+ export async function readFicha(stateRoot) {
45
+ try {
46
+ const parsed = JSON.parse(await readFile(fichaFile(stateRoot), 'utf8'));
47
+ return typeof parsed?.ficha === 'string' && FICHA_HEX.test(parsed.ficha) ? parsed.ficha : null;
48
+ } catch { return null; }
49
+ }
50
+
51
+ // The ficha this run uses: the one on file, or a new one when there is none or `renew` asks for it.
52
+ // Written whole beside the name and renamed over it, so nobody reads half a ficha.
53
+ export async function ensureFicha(stateRoot, { renew = false } = {}) {
54
+ if (!renew) {
55
+ const kept = await readFicha(stateRoot);
56
+ if (kept) return kept;
57
+ }
58
+ const dir = join(stateRoot, 'credentials');
59
+ await mkdir(dir, { recursive: true, mode: OWNER_DIR });
60
+ // An older credentials directory may predate this mode (src/vault.mjs does the same).
61
+ await chmod(dir, OWNER_DIR).catch(() => {});
62
+ const file = fichaFile(stateRoot);
63
+ const draft = `${file}.${process.pid}.${randomUUID()}.tmp`;
64
+ const ficha = randomBytes(32).toString('hex');
65
+ try {
66
+ await writeFile(draft, `${JSON.stringify({ ficha, at: new Date().toISOString() })}\n`, { mode: OWNER_ONLY });
67
+ await rename(draft, file);
68
+ } finally {
69
+ await rm(draft, { force: true });
70
+ }
71
+ await chmod(file, OWNER_ONLY).catch(() => {});
72
+ return ficha;
73
+ }
74
+
75
+ // The ficha as the server checks it: read again when the file changes (Home renewed it while this
76
+ // project was open), never more than once a second.
77
+ export function fichaReader(stateRoot, { everyMs = 1000 } = {}) {
78
+ let value = null;
79
+ let seen = null;
80
+ let checked = 0;
81
+ return async () => {
82
+ const now = Date.now();
83
+ if (value && now - checked < everyMs) return value;
84
+ checked = now;
85
+ const info = await stat(fichaFile(stateRoot)).catch(() => null);
86
+ const stamp = info ? `${info.mtimeMs}:${info.size}` : null;
87
+ if (stamp !== seen || !value) { value = await readFicha(stateRoot); seen = stamp; }
88
+ return value;
89
+ };
90
+ }
91
+
92
+ // A log a MADRE process writes on its way up (start.log, restart.log, update.log) holds the address
93
+ // with the ficha that process prints: kept for the person alone, as the ficha is. One written
94
+ // before this rule, open to every user of the computer, is closed the next time it is opened
95
+ // (2026-11-03, the ficha's test).
96
+ export function openPrivateLog(file) {
97
+ const fd = openSync(file, 'a', OWNER_ONLY);
98
+ try { fchmodSync(fd, OWNER_ONLY); } catch { /* a filesystem without modes */ }
99
+ return fd;
100
+ }
101
+
102
+ // The header a MADRE process sends to another, or nothing when this computer has no ficha yet (a
103
+ // MADRE that does not ask for one does not need it).
104
+ export async function fichaHeaders(stateRoot = defaultStateRoot()) {
105
+ const ficha = await readFicha(stateRoot);
106
+ return ficha ? { [FICHA_HEADER]: ficha } : {};
107
+ }
108
+
109
+ // The address MADRE opens and prints: the page's own, with the ficha for the browser to keep.
110
+ export function withFicha(url, ficha) {
111
+ if (!ficha) return url;
112
+ const address = new URL(url);
113
+ address.searchParams.set(FICHA_PARAM, ficha);
114
+ return address.toString();
115
+ }
116
+
117
+ // Constant time, and never a throw on something that is not a string.
118
+ export function sameFicha(given, ficha) {
119
+ if (typeof given !== 'string' || typeof ficha !== 'string' || !given || given.length !== ficha.length) return false;
120
+ return timingSafeEqual(Buffer.from(given), Buffer.from(ficha));
121
+ }
122
+
123
+ export function cookieFicha(cookieHeader) {
124
+ for (const part of String(cookieHeader ?? '').split(';')) {
125
+ const [name, ...rest] = part.trim().split('=');
126
+ if (name === FICHA_COOKIE) return rest.join('=');
127
+ }
128
+ return null;
129
+ }
130
+
131
+ // Whether a request carries this ficha, in its header or in the page's cookie.
132
+ export function carriesFicha(headers = {}, ficha) {
133
+ return sameFicha(headers[FICHA_HEADER], ficha) || sameFicha(cookieFicha(headers.cookie), ficha);
134
+ }
135
+
136
+ export const fichaCookie = (ficha) => `${FICHA_COOKIE}=${ficha}; Path=/; HttpOnly; SameSite=Strict; Max-Age=2592000`;
137
+
138
+ // RIPLEY's preview runs in a sealed frame, whose requests carry no cookie, and the agents' headless
139
+ // browser (src/modules/playwright.mjs) has none either. Its pages are served under a key of their own,
140
+ // made from the ficha: it opens the preview of this project's files and nothing else, and it says
141
+ // nothing of the ficha it comes from.
142
+ export const previewKey = (ficha) => createHmac('sha256', ficha).update('madre preview').digest('hex').slice(0, 32);
package/src/files.mjs CHANGED
@@ -1,7 +1,7 @@
1
1
  // SPDX-License-Identifier: BUSL-1.1
2
2
  // MADRE · © 2026 Jossue Alcalá · Business Source License 1.1: LICENSE
3
3
  import { createHash, randomUUID } from 'node:crypto';
4
- import { mkdir, readdir, readFile, realpath, stat, writeFile } from 'node:fs/promises';
4
+ import { copyFile, mkdir, readdir, readFile, realpath, rm, stat, writeFile } from 'node:fs/promises';
5
5
  import { dirname, extname, join, resolve, sep } from 'node:path';
6
6
 
7
7
  // Read-only file access for the room UI, and human attachments.
@@ -237,7 +237,41 @@ export async function createEmptyFile(root, relative) {
237
237
  return { status: 201, path: parts.join('/') };
238
238
  }
239
239
 
240
+ // Where an attachment never goes, whatever is typed after: judged part by part, as createEmptyFile
241
+ // splits them («datos\.env» is datos/.env too). Asked before the project's name, so nobody types it
242
+ // to be refused anyway.
243
+ export const ATTACHMENT_REFUSED = 'That place is MADRE\'s own or a secret\'s: choose another folder.';
244
+ export function attachmentPlaceRefused(to) {
245
+ return String(to ?? '').split(/[/\\]+/).some((part) => /^\.(pulse|madre|git)$/i.test(part) || /^\.env(\.|$)/i.test(part));
246
+ }
247
+
248
+ // An attachment of the conversation, saved into the project where the person says (L-2, Carlos's
249
+ // server, 2026-11-04): a patient's photo into pacientes/…/fotos/, a guide into conocimiento/. Until
250
+ // now a PDF or a photo stayed in MADRE's store; copying it in took a `cp`, which is #4. The person
251
+ // chooses the place, so no mode is asked. The same fence as a new file (createEmptyFile), never
252
+ // into MADRE's own folders, a repository's or a .env, and an existing file is never replaced.
253
+ export async function keepAttachment({ attachmentsRoot, projectRoot, fileName, to }) {
254
+ const from = await resolveInside(attachmentsRoot, String(fileName ?? ''));
255
+ if (!from || !(await stat(from).catch(() => null))?.isFile()) return { status: 404, error: 'That attachment is no longer here.' };
256
+ const clean = String(to ?? '').trim().replace(/^[/\\]+/, '');
257
+ if (attachmentPlaceRefused(clean)) return { status: 403, error: ATTACHMENT_REFUSED };
258
+ // Fenced and checked the way a new, empty file is; then the attachment is copied over it.
259
+ const made = await createEmptyFile(projectRoot, clean);
260
+ if (made.status !== 201) return made;
261
+ const canonicalRoot = await realpath(projectRoot);
262
+ const target = join(canonicalRoot, ...made.path.split('/'));
263
+ // A copy that fails takes back the empty file it was going into: the next try is not refused as
264
+ // «already there».
265
+ try { await copyFile(from, target); } catch (error) { await rm(target, { force: true }).catch(() => {}); return { status: 400, error: error.message }; }
266
+ const info = await stat(target);
267
+ return { status: 201, path: made.path, bytes: info.size };
268
+ }
269
+
240
270
  const safeName = (name) => String(name ?? 'file').replace(/[^\w.\- ]+/g, '_').replace(/^\.+/, '').slice(0, 120) || 'file';
271
+ // The name a person reads and is offered to save with (Q-5): «guía de curación.pdf» stays as it was
272
+ // written, accents and eñes included. Only what could break a line or a path is taken out; the file
273
+ // on disk keeps the plain name above.
274
+ const shownName = (name) => String(name ?? 'file').normalize('NFC').replace(/[\u0000-\u001f\u007f/\\]+/g, '_').replace(/^\.+/, '').trim().slice(0, 120) || 'file';
241
275
 
242
276
  export async function storeAttachment(attachmentsRoot, { name, bytes }) {
243
277
  if (!Buffer.isBuffer(bytes) || bytes.length === 0) throw new Error('Attachment is empty.');
@@ -249,7 +283,7 @@ export async function storeAttachment(attachmentsRoot, { name, bytes }) {
249
283
  await writeFile(path, bytes, { mode: 0o600 });
250
284
  return {
251
285
  id,
252
- name: safeName(name),
286
+ name: shownName(name),
253
287
  fileName,
254
288
  path,
255
289
  size: bytes.length,
package/src/lease.mjs CHANGED
@@ -103,6 +103,10 @@ export function diffSnapshots(before, after, { relativeDir }) {
103
103
  // the ones whose adapter hands a subagent exactly the turn's permissions (src/adapters/claude.mjs,
104
104
  // opencode.mjs; Codex's subagents inherit its sandbox). Never in #4.
105
105
  export const SUBAGENT_AGENTS = new Set(['claude', 'opencode', 'codex']);
106
+ // Where MADRE puts the images Grok generates (2026-11-08, the author's choice): its image tool saves
107
+ // them in Grok's own folder, outside the project, and with no terminal below #4 it cannot copy them.
108
+ // At #2 the turn's draft folder; at #3 and #4 `imagenes/` at the project's root.
109
+ export const grokImagesDir = (lease = {}) => lease?.scratchDir || 'imagenes';
106
110
  export const subagentsAllowed = (agentId, { airlock = false } = {}) => !airlock && SUBAGENT_AGENTS.has(agentId);
107
111
 
108
112
  export function leaseInstructions({ outDir, agentId, scopes = { write: true, imageGen: agentId === 'codex' }, capable = null, imageStudio = null, control = false, create = false, airlock = false, scratchDir = null }) {
@@ -124,6 +128,7 @@ export function leaseInstructions({ outDir, agentId, scopes = { write: true, ima
124
128
  : 'Write every file you produce there (images, code, documents); paths elsewhere are denied.',
125
129
  airlock ? 'End with the commands you ran, what left the machine, and the files you changed.' : control ? 'End with a short list of the files you changed and why.' : create ? 'End with a short list of the files you created, with their paths, and why there.' : 'Reading the project stays allowed. Do not modify project files.',
126
130
  imageStudio ? `You can generate images with the MCP tool ${imageStudio.tool} (server ${imageStudio.name}): pass a detailed prompt and a file_name; it saves the PNG${scratch ? ` into ${scratch}` : ' into the lease directory'} and returns the path.`
131
+ : canImage && agentId === 'grok' ? `You can generate images with your image_gen tool. It saves each image in your own folder, outside this project; when your turn ends MADRE copies every image you generated into ${outDir}/${grokImagesDir({ scratchDir })}. Do not try to copy, convert or move it yourself, and do not write a file in its place: say what you generated and that it will be in ${grokImagesDir({ scratchDir })}/.`
127
132
  : canImage ? `You can generate images; save them${create ? ' where images live in this project, or in the scratch folder,' : ' into the lease directory'} with a descriptive file name.`
128
133
  : couldImage ? 'Image generation is switched off for this request; if asked for an image, say so and do not attempt it.'
129
134
  : 'You cannot generate images from this CLI; if asked for one, say so plainly instead of attempting it.',
@@ -122,7 +122,7 @@ export function submissionMarkdown(result, entry = {}) {
122
122
  lines.push(result.reaches.length ? result.reaches.map((one) => `- ${one.words}`).join('\n') : `- ${t('Nothing beyond what MADRE hands every module.')}`);
123
123
  for (const one of result.undeclared) lines.push(`- ⚠️ ${one}`);
124
124
  if (result.module?.unknown?.length) lines.push(`- ⚠️ ${t('Fields MADRE does not know: {list}', { list: result.module.unknown.join(', ') })}`);
125
- lines.push('', `_${t('Checked by MADRE (src/market-check.mjs). A person still reads the code before it is signed: a module runs with the permissions of whoever opens MADRE.')}_`);
125
+ lines.push('', `_${t('Checked by MADRE (src/market-check.mjs). A person still reads the code before it is signed: an installed module runs in a separate process, but Node cannot guarantee containment of malicious code.')}_`);
126
126
  return lines.join('\n');
127
127
  }
128
128
 
@@ -26,6 +26,7 @@ import { join } from 'node:path';
26
26
  import { t } from './i18n.mjs';
27
27
  import { MARKET_PUBLIC_KEY } from './market-key.mjs';
28
28
  import { mayInstall } from './market-license.mjs';
29
+ import { MARKET_MAX_FILES as MAX_SKILL_FILES, SKILL_FILES, installSkill, declaredBy as skillDeclares, readSkillText, removeSkill, runnable, safePath } from './skills.mjs';
29
30
 
30
31
  export const MARKET_URL = 'https://madre.run/mercado/catalogo.json';
31
32
  const MAX_CATALOG = 1024 * 1024;
@@ -147,10 +148,42 @@ export function readCatalog(text, { url = MARKET_URL } = {}) {
147
148
  if (!href || !SHA.test(raw.file?.sha256 ?? '') || typeof raw.file?.factory !== 'string' || raw.file.factory.length > MAX_SIGNATURE) continue;
148
149
  builtins.push({ id: raw.id, version: raw.version, sdk: raw.sdk, changes: words(raw.changes, 400), file: { url: href, sha256: raw.file.sha256, size: Number(raw.file.size) || null, factory: raw.file.factory.trim() } });
149
150
  }
151
+ // SKILLS (2026-11-08, H-4): ways of working, not code. A list of their own, like `builtins`, so a
152
+ // MADRE that does not know them (1.1.2 and before) never sees one as a module to install. Each
153
+ // file is pinned by its own sha256 — there is no archive to unpack, so there is no path to climb
154
+ // out of and no bomb to unzip — and every path is checked as the installer checks it.
155
+ const skills = [];
156
+ for (const raw of (Array.isArray(data.skills) ? data.skills : []).slice(0, 200)) {
157
+ if (!ID.test(raw?.id ?? '') || typeof raw.version !== 'string' || !/^\d+\.\d+\.\d+$/.test(raw.version)) continue;
158
+ const files = [];
159
+ let weight = 0;
160
+ for (const file of (Array.isArray(raw.files) ? raw.files : []).slice(0, MAX_SKILL_FILES)) {
161
+ const href = fileUrl(file?.url, url);
162
+ if (!href || !safePath(file?.path) || !SHA.test(file?.sha256 ?? '')) { files.length = 0; break; }
163
+ weight += Number(file.size) || 0;
164
+ files.push({ path: String(file.path), url: href, sha256: file.sha256, size: Number(file.size) || null });
165
+ }
166
+ // Its own page is what makes it a skill; without it there is nothing to read and nothing to run.
167
+ if (!files.length || !files.some((file) => SKILL_FILES.includes(file.path)) || weight > MAX_MODULE) continue;
168
+ skills.push({
169
+ id: raw.id, version: raw.version, files,
170
+ shelf: ID.test(raw.shelf ?? '') ? raw.shelf : null,
171
+ name: words(raw.name, 60), line: words(raw.line, 140), summary: words(raw.summary, 1200),
172
+ changes: words(raw.changes, 400), credit: words(raw.credit, 60),
173
+ minMadre: typeof raw.minMadre === 'string' && /^\d+\.\d+\.\d+$/.test(raw.minMadre) ? raw.minMadre : null,
174
+ hue: Array.isArray(raw.hue) && raw.hue.length === 2 && raw.hue.every((one) => COLOR.test(one)) ? raw.hue : null,
175
+ icon: typeof raw.icon === 'string' && raw.icon.length <= 8000 ? raw.icon : null,
176
+ community: raw.community === true,
177
+ author: raw.author && typeof raw.author === 'object' && typeof raw.author.name === 'string' && raw.author.name.trim()
178
+ ? { name: raw.author.name.trim().slice(0, 60), github: /^[A-Za-z0-9](?:[A-Za-z0-9-]{0,38})$/.test(raw.author.github ?? '') ? raw.author.github : null }
179
+ : null,
180
+ spdx: typeof raw.spdx === 'string' && /^[A-Za-z0-9.+-]{2,40}$/.test(raw.spdx) ? raw.spdx : null,
181
+ });
182
+ }
150
183
  // TAKEN BACK: a module, or one version of it, that must not run anywhere any more. A module got
151
184
  // from the Market is removed; a newer file of one of MADRE's own goes back to the one MADRE came with.
152
185
  const revoked = (Array.isArray(data.revoked) ? data.revoked : []).filter((one) => ID.test(one?.id ?? '')).map((one) => ({ id: one.id, version: typeof one.version === 'string' && /^\d+\.\d+\.\d+$/.test(one.version) ? one.version : null, why: words(one.why, 240) })).slice(0, 100);
153
- return { schema: 1, issued: new Date(issued).toISOString(), shelves, featured, modules, news, builtins, revoked };
186
+ return { schema: 1, issued: new Date(issued).toISOString(), shelves, featured, modules, news, builtins, skills, revoked };
154
187
  }
155
188
 
156
189
  export async function bytesFrom(url, { fetchImpl, max }) {
@@ -328,3 +361,104 @@ export async function updateFromMarket({ stateRoot, projectRoot, catalog, madre,
328
361
  }
329
362
  return updated;
330
363
  }
364
+
365
+ // ---- SKILLS FROM THE MARKET (2026-11-08, H-4). The same chain of trust a module travels on: the
366
+ // catalog is signed with the author's key, each file is pinned by its own sha256, and a version the
367
+ // person never accepted is not installed on its own. What is different is what arrives — words, not
368
+ // code — and that it arrives as several files instead of one, so what the person accepts is a seal
369
+ // over all of them together.
370
+ const SKILL_SEAL = (files) => sha256(Buffer.from([...files].map((file) => `${file.path}\0${file.sha256}`).sort().join('\n')));
371
+ export const installedSkills = async (stateRoot) => (await readJson(join(folder(stateRoot), 'skills.json'))) ?? {};
372
+
373
+ // One skill from the catalog onto this computer, for every project (each one says when it comes in).
374
+ // Two steps, as a module's are: asked with `review`, every file is fetched and checked and what it
375
+ // says comes back with its seal, and nothing is written; installed only when the person accepted
376
+ // that very seal, so what is installed is what was read.
377
+ export async function installSkillFromMarket({ stateRoot, projectRoot, id, catalog, madre, fetchImpl = globalThis.fetch, review = false, accept = null, accepted = false }) {
378
+ const entry = catalog?.skills?.find((one) => one.id === id);
379
+ if (!entry) throw new Error(t('The Market has no skill «{id}» to install.', { id }));
380
+ if (!fitsVersion(madre, entry.minMadre)) throw new Error(t('This skill needs MADRE {version} or newer.', { version: entry.minMadre }));
381
+ const files = [];
382
+ for (const file of entry.files) {
383
+ const bytes = await bytesFrom(file.url, { fetchImpl, max: MAX_MODULE });
384
+ if (sha256(bytes) !== file.sha256) throw new Error(t('A file of this skill is not the one the Market signed, so MADRE did not install it.'));
385
+ files.push({ path: file.path, text: bytes });
386
+ }
387
+ const main = files.find((file) => SKILL_FILES.includes(file.path));
388
+ const read = readSkillText(main.text.toString('utf8'), { id });
389
+ if (read.id !== id) throw new Error(t('The file says it is «{found}», not «{id}», so MADRE did not install it.', { found: read.id, id }));
390
+ if (read.version !== entry.version) throw new Error(t('The skill says {found} and the Market said {said}, so MADRE did not install it.', { found: read.version ?? '—', said: entry.version }));
391
+ const shape = files.map((file) => ({ path: file.path, bytes: file.text.length, runs: runnable(file.path) }));
392
+ const declares = skillDeclares({ ...read, files: shape, scripts: shape.filter((file) => file.runs).map((file) => file.path) });
393
+ const seal = SKILL_SEAL(entry.files);
394
+ if (review) return { review: true, id, name: read.name, version: entry.version, seal, declares, body: read.body, files: shape };
395
+ if (!accepted && accept !== seal) throw Object.assign(new Error(t('Read what {name} tells your agents before installing it.', { name: read.name ?? id })), { code: 'REVIEW_FIRST' });
396
+ const done = await installSkill({ files, scope: 'user', stateRoot, projectRoot, source: { kind: 'market', from: entry.files.find((file) => SKILL_FILES.includes(file.path))?.url ?? null, id } });
397
+ const kept = await installedSkills(stateRoot);
398
+ // The programs by name, not by how many: what the person accepted is these files, and a version
399
+ // that swaps one for another is asking for something new even when the count has not moved.
400
+ kept[id] = { version: entry.version, seal, scripts: declares.scripts, at: new Date().toISOString() };
401
+ await writeAtomic(join(folder(stateRoot), 'skills.json'), JSON.stringify(kept, null, 2));
402
+ return { ...done, version: entry.version, declares };
403
+ }
404
+
405
+ // A skill removed by hand is no longer the Market's to update.
406
+ export async function forgetSkillFromMarket(stateRoot, id) {
407
+ const kept = await installedSkills(stateRoot);
408
+ if (!kept[id]) return false;
409
+ delete kept[id];
410
+ await writeAtomic(join(folder(stateRoot), 'skills.json'), JSON.stringify(kept, null, 2));
411
+ return true;
412
+ }
413
+
414
+ // What a newer version asks for that the one the person accepted did not. For a skill there is one
415
+ // thing that matters: PROGRAMS. Its words can be read and changed freely between versions, and the
416
+ // mode of the turn still rules them; a file an agent could run at #4 is the one thing accepting
417
+ // version 1.0.0 never agreed to. One that brings a program, or more of them, waits for the person.
418
+ export function widensSkill(before = {}, after = {}) {
419
+ const had = new Set(before?.scripts ?? []);
420
+ return (after?.scripts ?? []).filter((path) => !had.has(path)).map((path) => ({ what: 'script', name: path }));
421
+ }
422
+
423
+ // Every skill got from the Market whose signed files changed: the new one, installed, and a line for
424
+ // the person. Taken back first. One that would bring a program the person never accepted is not
425
+ // installed on its own: it waits, and they are told once what it wants.
426
+ export async function updateSkillsFromMarket({ stateRoot, projectRoot, catalog, madre, fetchImpl = globalThis.fetch }) {
427
+ const kept = await installedSkills(stateRoot);
428
+ const updated = [];
429
+ const removed = [];
430
+ const held = [];
431
+ for (const [id, have] of Object.entries({ ...kept })) {
432
+ const taken = (catalog?.revoked ?? []).find((one) => one.id === id && (!one.version || one.version === have.version));
433
+ if (!taken) continue;
434
+ await removeSkill({ id, stateRoot, projectRoot }).catch(() => null);
435
+ await forgetSkillFromMarket(stateRoot, id);
436
+ delete kept[id];
437
+ removed.push({ id, name: catalog?.skills?.find((one) => one.id === id)?.name ?? id, kind: 'removed', version: have.version ?? null, why: taken.why ?? null, at: new Date().toISOString() });
438
+ }
439
+ for (const [id, have] of Object.entries(kept)) {
440
+ const entry = catalog?.skills?.find((one) => one.id === id);
441
+ if (!entry || SKILL_SEAL(entry.files) === have.seal || !fitsVersion(madre, entry.minMadre)) continue;
442
+ try {
443
+ const seal = SKILL_SEAL(entry.files);
444
+ if (have.held === seal) continue;
445
+ const fresh = await installSkillFromMarket({ stateRoot, projectRoot, id, catalog, madre, fetchImpl, review: true });
446
+ const more = widensSkill({ scripts: Array.isArray(have.scripts) ? have.scripts : [] }, fresh.declares);
447
+ if (more.length) {
448
+ const now = await installedSkills(stateRoot);
449
+ now[id] = { ...(now[id] ?? have), held: seal };
450
+ await writeAtomic(join(folder(stateRoot), 'skills.json'), JSON.stringify(now, null, 2));
451
+ held.push({ id, name: fresh.name ?? id, kind: 'held', from: have.version ?? null, to: entry.version, more, at: new Date().toISOString() });
452
+ continue;
453
+ }
454
+ await installSkillFromMarket({ stateRoot, projectRoot, id, catalog, madre, fetchImpl, accepted: true });
455
+ updated.push({ id, name: fresh.name ?? id, from: have.version ?? null, to: entry.version, changes: entry.changes ?? null, at: new Date().toISOString() });
456
+ } catch { /* tried again the next time MADRE opens */ }
457
+ }
458
+ const told = [...updated, ...removed, ...held];
459
+ if (told.length) {
460
+ const news = [...(await marketNews(stateRoot)).filter((one) => !told.some((fresh) => fresh.id === one.id)), ...told];
461
+ await writeAtomic(join(folder(stateRoot), 'updates.json'), JSON.stringify(news, null, 2));
462
+ }
463
+ return { updated, removed, held };
464
+ }
@@ -34,7 +34,7 @@ const FAKE_PNG = Buffer.from('iVBORw0KGgoAAAANSUhEUgAAAAEAAAABCAYAAAAfFcSJAAAADU
34
34
  // the CLI's own sign-in put it there. Leaving the file out meant MADRE saved a key in a place it
35
35
  // then refused to look, and on Linux, where there is no keychain, that was the only place it
36
36
  // could have been: Image Studio could never find a key there at all.
37
- async function keyFromGeminiEnvFile(env) {
37
+ export async function keyFromGeminiEnvFile(env) {
38
38
  const home = env.GEMINI_CLI_HOME ?? homedir();
39
39
  let text;
40
40
  try { text = await readFile(join(home, '.gemini', '.env'), 'utf8'); } catch { return null; }
@@ -20,6 +20,7 @@ import { createEmbedder } from '../embeddings.mjs';
20
20
  import { loadConfig } from '../config.mjs';
21
21
  import { Privacy, privacySettings } from '../privacy.mjs';
22
22
  import { resolveGeminiKey } from './image-server.mjs';
23
+ import { OutboundLog } from '../outbound.mjs';
23
24
 
24
25
  const SERVER_NAME = 'pulse-memory';
25
26
  const SERVER_VERSION = '0.1.0';
@@ -228,9 +229,18 @@ export function serve({ input = process.stdin, output = process.stdout, context
228
229
  input.on('end', () => { ended = true; finish(); });
229
230
  }
230
231
 
232
+ // What this process sends lands in the room's «What leaves» (RX-20, external review #20): the
233
+ // searches it embeds with Gemini went to Google from here, outside the log that promises to see
234
+ // every fetch. Bodies and queries are never written, only where it went and whether it answered.
235
+ export function watchOutbound(env = process.env, target = globalThis) {
236
+ if (!env.PULSE_OUTBOUND_LOG) return null;
237
+ return new OutboundLog({ file: env.PULSE_OUTBOUND_LOG }).install(target);
238
+ }
239
+
231
240
  const invokedDirectly = process.argv[1] && (await realpath(process.argv[1]).catch(() => process.argv[1])) === (await realpath(new URL(import.meta.url).pathname).catch(() => null));
232
241
  if (invokedDirectly) {
233
242
  try {
243
+ watchOutbound();
234
244
  const memory = await openMemory();
235
245
  serve({ context: { memory, projectRoot: process.env.PULSE_PROJECT_ROOT, agent: process.env.PULSE_MEMORY_AGENT ?? 'agent', mode: process.env.PULSE_MEMORY_MODE ?? '1', messageId: process.env.PULSE_MEMORY_MESSAGE ?? null } });
236
246
  } catch (error) {
@@ -38,6 +38,9 @@ export function memoryServerFor({ dbFile, projectRoot, env = process.env }) {
38
38
  ...(env.PULSE_EMBED_FAKE ? { PULSE_EMBED_FAKE: env.PULSE_EMBED_FAKE } : {}),
39
39
  ...(env.PULSE_EMBED_MODEL ? { PULSE_EMBED_MODEL: env.PULSE_EMBED_MODEL } : {}),
40
40
  ...(env.PULSE_EMBED_DIMS ? { PULSE_EMBED_DIMS: env.PULSE_EMBED_DIMS } : {}),
41
+ // Where this server writes what it sends (RX-20): the room's own «What leaves», as the mail,
42
+ // GitHub and image servers do. A search embedded by Gemini from here was the one send missing.
43
+ ...(env.PULSE_OUTBOUND_LOG ? { PULSE_OUTBOUND_LOG: env.PULSE_OUTBOUND_LOG } : {}),
41
44
  },
42
45
  };
43
46
  }
package/src/memory.mjs CHANGED
@@ -556,7 +556,11 @@ export class RoomMemory {
556
556
  const target = this.#refutedBy(text);
557
557
  if (target) {
558
558
  this.#db.prepare('UPDATE memories SET contradicts = ? WHERE id = ?').run(target, id);
559
- this.#db.prepare(`UPDATE memories SET refuted_by = ?, zone = '${JETTISONED}' WHERE id = ? AND refuted_by IS NULL`).run(id, target);
559
+ // An agent's word with no sources does not take down what the human confirmed (external
560
+ // review #17, 2026-11-03): the two stay linked, the confirmed note keeps standing, and
561
+ // the claim waits in quarantine for the human, who can retire it from the map.
562
+ const confirmed = origin === 'noted' && !sources.length && this.#db.prepare('SELECT zone FROM memories WHERE id = ?').get(target)?.zone === BRIDGE;
563
+ if (!confirmed) this.#db.prepare(`UPDATE memories SET refuted_by = ?, zone = '${JETTISONED}' WHERE id = ? AND refuted_by IS NULL`).run(id, target);
560
564
  }
561
565
  }
562
566
  }
@@ -1137,12 +1141,33 @@ export function normalizeMemory(text) {
1137
1141
  }
1138
1142
 
1139
1143
  // The block an agent reads for distilled memories: kind, where it came from, the note.
1144
+ // A note an agent wrote with memory_note and no sources (external review #15, 2026-11-03). It is
1145
+ // kept with the last number of the history as its span, which reads exactly like a note distilled
1146
+ // from that exchange: it is never shown with that number, only as what it is.
1147
+ export function unsourced(memory) {
1148
+ if (memory?.origin !== 'noted') return false;
1149
+ let sources = memory.sources;
1150
+ if (typeof sources === 'string') { try { sources = JSON.parse(sources); } catch { sources = []; } }
1151
+ return !(Array.isArray(sources) && sources.length);
1152
+ }
1153
+ // Where the span of a note points, or that it points nowhere.
1154
+ export function memorySpan(memory) {
1155
+ if (unsourced(memory)) return 'no source';
1156
+ return memory.fromSequence === memory.throughSequence ? `#${memory.fromSequence}` : `#${memory.fromSequence}–#${memory.throughSequence}`;
1157
+ }
1158
+ // Where a note came from, said to the agent that reads it (external review #15): distilled from the
1159
+ // history is the usual and goes unsaid; written by an agent, or confirmed by the human, is said.
1160
+ const provenance = (memory) => [
1161
+ memory.origin === 'noted' && memory.agent ? `noted by @${memory.agent}` : null,
1162
+ memory.zone === BRIDGE ? 'confirmed by the human' : null,
1163
+ ].filter(Boolean).map((words) => ` · ${words}`).join('');
1164
+
1140
1165
  export function formatMemories(list) {
1141
1166
  if (!list?.length) return '';
1142
1167
  return list.map((memory) => {
1143
- const span = memory.fromSequence === memory.throughSequence ? `#${memory.fromSequence}` : `#${memory.fromSequence}–#${memory.throughSequence}`;
1144
- if (memory.kind === ABERRATION) return `- [${memory.kind} · ${span}] FALSE: ${memory.text}${memory.correction ? ` — what is true: ${memory.correction}` : ''}`;
1145
- return `- [${memory.kind} · ${span}] ${memory.text}`;
1168
+ const span = memorySpan(memory);
1169
+ if (memory.kind === ABERRATION) return `- [${memory.kind} · ${span}${provenance(memory)}] FALSE: ${memory.text}${memory.correction ? ` — what is true: ${memory.correction}` : ''}`;
1170
+ return `- [${memory.kind} · ${span}${provenance(memory)}] ${memory.text}`;
1146
1171
  }).join('\n');
1147
1172
  }
1148
1173
 
package/src/models.mjs CHANGED
@@ -12,9 +12,14 @@ import { OPENCODE_PROVIDERS } from './credentials.mjs';
12
12
 
13
13
  export const CURSOR_FREE_NOTE = 'Your Cursor plan answers only with Auto: the other models need a paid plan.';
14
14
  export const KNOWN_MODELS = {
15
+ // No names of its own (2026-11-03): with no cache to read, the four written here were offered to
16
+ // ChatGPT accounts that refuse them, and the turn failed («The 'gpt-5.5' model is not supported
17
+ // when using Codex with a ChatGPT account», 6 copies of 1.1.2). Codex writes its list after its
18
+ // first turn; until then «default» is the choice.
15
19
  codex: {
16
- defaults: ['gpt-5.6-sol', 'gpt-5.6-luna', 'gpt-5.6-terra', 'gpt-5.5'],
20
+ defaults: [],
17
21
  note: 'The models your plan offers in Codex. «default» is the one Codex uses on its own.',
22
+ unread: 'Codex lists your plan\'s models after its first answer. Until then, «default» uses the one Codex chooses.',
18
23
  },
19
24
  claude: {
20
25
  defaults: ['fable', 'opus', 'sonnet', 'haiku'],
@@ -37,6 +42,13 @@ export const KNOWN_MODELS = {
37
42
  defaults: ['auto'],
38
43
  note: '«auto» lets Cursor choose. The others are the ones your Cursor account lists; a free plan answers only with Auto.',
39
44
  },
45
+ // Read from the account itself (`grok models`, 2026-11-06): xAI renames and retires models every
46
+ // few months, so none is written here. Until the list is read, Grok uses its own default.
47
+ grok: {
48
+ defaults: [],
49
+ note: 'The models your Grok account lists. Without one chosen, Grok uses its own default.',
50
+ unread: 'Grok lists your plan\'s models once it is signed in. Until then, it uses its own default.',
51
+ },
40
52
  };
41
53
 
42
54
  // How hard the model thinks before it answers, for the CLIs that take it per run. Claude Code
@@ -97,7 +109,8 @@ export function parseCodexModelCache(json) {
97
109
  const slugs = new Set();
98
110
  const walk = (node) => {
99
111
  if (!node || typeof node !== 'object') return;
100
- if (typeof node.slug === 'string' && /^gpt-/.test(node.slug) && !/reserve|auto-review/.test(node.slug)) slugs.add(node.slug);
112
+ // What Codex itself hides from its chooser is not offered either.
113
+ if (typeof node.slug === 'string' && /^gpt-/.test(node.slug) && !/reserve|auto-review/.test(node.slug) && node.visibility !== 'hide') slugs.add(node.slug);
101
114
  for (const value of Object.values(node)) walk(value);
102
115
  };
103
116
  walk(data);
@@ -220,7 +233,7 @@ export function parseCursorModels(text) {
220
233
  return ids.includes('auto') ? ['auto', ...ids.filter((id) => id !== 'auto')] : ids;
221
234
  }
222
235
 
223
- export async function discoverModels({ agents = [], config = {}, home = homedir(), listOpenCode = async () => [], listCursor = async () => [], cursorOnlyAuto = () => false, listGemini = async () => [] } = {}) {
236
+ export async function discoverModels({ agents = [], config = {}, home = homedir(), listOpenCode = async () => [], listCursor = async () => [], cursorOnlyAuto = () => false, listGemini = async () => [], listGrok = async () => ({ models: [], default: null }) } = {}) {
224
237
  const result = {};
225
238
  for (const agent of agents) {
226
239
  const known = KNOWN_MODELS[agent.id] ?? { defaults: [], note: '' };
@@ -272,6 +285,11 @@ export async function discoverModels({ agents = [], config = {}, home = homedir(
272
285
  // A free plan refuses every named model (adapters/cursor.mjs): then Auto is all there is.
273
286
  discovered = cursorOnlyAuto() ? ['auto'] : await listCursor(agent).catch(() => []);
274
287
  }
288
+ if (agent.id === 'grok' && agent.detected && !agent.foreign) {
289
+ const listed = await listGrok(agent).catch(() => ({ models: [], default: null }));
290
+ discovered = listed.models ?? [];
291
+ cliDefault = process.env.PULSE_GROK_MODEL || listed.default || null;
292
+ }
275
293
  const custom = Array.isArray(config.models?.[agent.id]) ? config.models[agent.id] : [];
276
294
  // OpenCode speaks to many providers: what `opencode models` lists is already only the ones
277
295
  // signed in plus OpenCode's own. The person may hide a provider from the chooser (AJUSTES ›
@@ -10,7 +10,7 @@ import { promisify } from 'node:util';
10
10
  import { t } from '../i18n.mjs';
11
11
  import { realpath } from 'node:fs/promises';
12
12
  import { defineModule } from './sdk.mjs';
13
- import { readJson, gitToplevel, findOnPath, packageVersion } from './helpers.mjs';
13
+ import { readJson, gitToplevel, gitRefused, findOnPath, packageVersion } from './helpers.mjs';
14
14
 
15
15
  // AHP+ platform names for the agents MADRE knows about. Gemini has no AHP+
16
16
  // adapter yet, so it is simply not requested.
@@ -46,14 +46,19 @@ export async function gitReady({ platform = process.platform, find = findOnPath,
46
46
  // first when it can do it for the person (2026-10-17): a project that does not use git yet gets
47
47
  // `git init` from MADRE, in the same confirmed install, instead of a trip to the terminal. A Mac
48
48
  // with no git gets the key that opens Apple's own installer.
49
- async function preflight(projectRoot, { toplevel = gitToplevel, npx = findOnPath, git = gitReady, platform = process.platform } = {}) {
49
+ // A repository git refuses to read is not a project without git (D-10, two copies in WSL; seen with
50
+ // git's own switch for it): MADRE ran `git init` over it, git only said «Reinitialized», and AHP+
51
+ // stopped with GIT_REQUIRED. Said before anything runs, with the line that lets git read it.
52
+ async function preflight(projectRoot, { toplevel = gitToplevel, refused = gitRefused, npx = findOnPath, git = gitReady, platform = process.platform } = {}) {
50
53
  const root = await realpath(projectRoot).catch(() => resolve(projectRoot));
51
54
  const problems = [];
52
55
  const prepare = [];
53
56
  let fix = null;
54
57
  if (!(await npx('npx'))) problems.push(t('npx is not on PATH for the MADRE server; start MADRE from a terminal where `npx --version` works.'));
55
58
  const top = await toplevel(root);
56
- if (!top) {
59
+ if (!top && await refused(root) === 'dubious-ownership') {
60
+ problems.push(t('Git refuses to read this project because its folder belongs to another user of this computer («dubious ownership»), as a project under /mnt/c can in WSL. Let git read it with `git config --global --add safe.directory \'{root}\'`, then come back here.', { root }));
61
+ } else if (!top) {
57
62
  if (await git()) {
58
63
  prepare.push({ command: 'git', args: ['init'], display: 'git init', note: t('The project does not use git yet. MADRE runs `git init` in it first: it adds a .git folder and leaves your files as they are.') });
59
64
  } else if (platform === 'darwin') {