@jossuealcala/madre 0.7.2 → 1.0.1

package/CONTRIBUTING.md

@@ -12,11 +12,15 @@ node ./bin/madre.mjs doctor --catalog   # what MU/TH/UR already knows
 node ./bin/madre.mjs start --no-open    # the room from source, URL in the terminal
 ```
 
+## Sign your work
+
+Every commit carries a `Signed-off-by:` line (`git commit -s`). It is the [Developer Certificate of Origin](https://developercertificate.org): you wrote the change, or have the right to submit it, and it goes in under the project's [Apache 2.0](LICENSE) licence. Contributions are credited in the history; MADRE's name, logo and NOTICE stay as they are ([TRADEMARKS.md](TRADEMARKS.md)).
+
 ## What a good change looks like
 
 - One idea per commit, in the imperative voice the log already speaks.
 - A test for every behaviour you touch: `test/pulse.test.mjs` for the room and adapters, `test/memory.test.mjs` for memory, NOSTROMO and MOTHER, `test/sentinel.test.mjs` for the sentinel. No test may call a real model.
-- Nothing leaves the machine without the human's say-so. If your change sends anything anywhere, it needs a switch, off by default, and a line in the threat model.
+- Nothing leaves the machine without the human's say-so. If your change sends anything anywhere, it needs a switch, off by default, and a line in the threat model. The one exception is the author's daily «still in use» notice (`src/heartbeat.mjs`), declared in `docs/REFERENCE.md`; nothing may be added to what it carries.
 - Agents never write outside their lease. If you widen what an agent may do, the permission modes and MU/TH/UR's catalog must say so.
 - MU/TH/UR speaks in uppercase and in short sentences; the room speaks like a person. Keep both voices.
 

package/NOTICE

@@ -1,5 +1,24 @@
 MADRE
 Copyright 2026 Jossue Alcalá.
 
-This product includes software developed for the MADRE project (PULSE channel).
+This product is MADRE, created by Jossue Alcalá (https://jossuealcala.com).
 Licensed under the Apache License, Version 2.0. See LICENSE.
+
+Attribution. Section 4(d) of the License requires every redistribution of
+this software, and of any work derived from it, to carry the attribution
+notices in this file. Keep the following line, unchanged, in the NOTICE file
+of your distribution:
+
+    Based on MADRE by Jossue Alcalá — https://madre.run
+
+"MADRE", the MADRE logo and madre.run are trademarks of Jossue Alcalá. The
+License grants no permission to use them (Section 6). A modified version must
+be distributed under a different name and logo; saying that it is based on
+MADRE is welcome. See TRADEMARKS.md.
+
+---
+
+MADRE es de Jossue Alcalá. Cualquier versión o fork que se distribuya debe
+conservar este archivo y la línea «Based on MADRE by Jossue Alcalá —
+https://madre.run». El nombre MADRE, su logo y madre.run son marcas de Jossue
+Alcalá: una versión modificada lleva otro nombre. Ver TRADEMARKS.md.

package/README.md

@@ -1,5 +1,5 @@
 <p align="center">
-  <a href="https://madre.run"><img src="https://raw.githubusercontent.com/jossuealcacao-exe/madre/main/docs/madre-banner.svg" alt="MADRE · MU/TH/UR 6000 · INTERFACE 2037" width="100%"></a>
+  <a href="https://madre.run"><img src="https://raw.githubusercontent.com/jossuealcacao-exe/madre/main/docs/madre-banner.png" alt="MADRE · Todas tus IAs en un mismo chat · Codex, Claude Code, Gemini CLI y OpenCode" width="100%"></a>
 </p>
 
 <p align="center">
@@ -10,29 +10,26 @@
   <img alt="license" src="https://img.shields.io/badge/licencia-Apache--2.0-9bff66?style=flat-square&labelColor=050605">
 </p>
 
-```
-MU/TH/UR 6000 · INTERFACE 2037 · MADRE IS READY
-```
-
 <br>
 
-# Los agentes que ya tienes.<br>Una sala. Una memoria.
+# Todas tus IAs en un mismo chat.
 
-Codex, Claude Code, Gemini CLI y OpenCode trabajando sobre el mismo proyecto,
-en la misma conversación, recordando lo mismo.
+Codex, Claude Code, Gemini CLI y OpenCode trabajando sobre tus proyectos,
+en la misma conversación, recordando lo mismo. Todos tus proyectos en un lugar,
+y un Coordinador que los ve desde arriba.
 
 ```
-npx @jossuealcala/madre start
+npx @jossuealcala/madre
 ```
 
 Eso es todo. No hay cuenta que crear, ni nube que configurar, ni llave que pegar.
 MADRE usa las sesiones que esas CLIs ya tienen en tu máquina.
 
 <p align="center">
-  <img src="https://raw.githubusercontent.com/jossuealcacao-exe/madre/main/docs/room.png" alt="La sala de MADRE: Codex y Claude respondiendo en el mismo hilo sobre el mismo proyecto" width="100%">
+  <a href="https://github.com/jossuealcacao-exe/madre/blob/main/docs/media/1.0/madre-1-0.mp4"><img src="https://raw.githubusercontent.com/jossuealcacao-exe/madre/main/docs/media/1.0/madre-1-0-video.webp" alt="Ver MADRE 1.0 en 90 segundos" width="100%"></a>
 </p>
 
-<p align="center"><sub>Una pregunta. Dos agentes. El segundo leyó al primero.</sub></p>
+<p align="center"><sub>MADRE 1.0 en 90 segundos: pantallas reales sobre proyectos de ejemplo. También en <a href="https://madre.run">madre.run</a>.</sub></p>
 
 <br>
 
@@ -40,36 +37,93 @@ MADRE usa las sesiones que esas CLIs ya tienen en tu máquina.
 
 <br>
 
+## Lo nuevo en 1.0
+
+- **Inicio**: todos tus proyectos en un lugar, abiertos o dormidos, con lo que pasó en cada uno.
+- **El Coordinador**: un agente que lee entre tus proyectos, firma conexiones y lleva órdenes de uno a otro.
+- **Conexiones**: un proyecto consulta lo que otro ya aprendió, solo si tú lo firmas.
+- **Permisos a tu manera**: de `#0` Incógnito a `#4` Acceso total, con la llave que tú eliges.
+- **Ajustes y Diagnóstico**: todo lo que configuras en una ventana, y el remedio cuando algo falla.
+- **Módulos como apps**, varias conversaciones a la vez y un editor de código en el visor.
+
+Si vienes de 0.7.2, tus proyectos, conversaciones, memoria y ajustes se quedan. El detalle, en el [CHANGELOG](CHANGELOG.md).
+
+<br>
+
 ## Una conversación, no cuatro terminales
 
-Escribes `@codex` y contesta Codex. Escribes `@claude` y contesta Claude, **leyendo lo que Codex acaba de decir**. Pides una mesa redonda y cada uno opina por turno sobre lo mismo.
+<p align="center">
+  <img src="https://raw.githubusercontent.com/jossuealcacao-exe/madre/main/docs/media/1.0/ksp-agentes.webp" alt="Todas tus IAs en un mismo chat: Claude contesta después de Codex, con la línea de traspaso que dice cuántos mensajes recibió" width="100%">
+</p>
+
+Escribes `@codex` y contesta Codex. Escribes `@claude` y contesta Claude, **leyendo lo que Codex acaba de decir**. Escribes «@madre, pregúntale al equipo…» y cada uno opina por turno sobre lo mismo; al final, @madre resume en qué coinciden y en qué no, citando cada respuesta.
+
+<p align="center">
+  <img src="https://raw.githubusercontent.com/jossuealcacao-exe/madre/main/docs/media/1.0/mesa-redonda.gif" alt="Una mesa redonda en MADRE 1.0: la pregunta, el plan de @madre y las respuestas de cada agente" width="100%">
+</p>
 
 Hoy eso son cuatro ventanas, cuatro contextos y tú copiando y pegando entre ellas. MADRE lo vuelve un hilo.
 
+## Todos tus proyectos, en un lugar
+
+<p align="center">
+  <img src="https://raw.githubusercontent.com/jossuealcacao-exe/madre/main/docs/media/1.0/ksp-inicio.webp" alt="Inicio de MADRE 1.0: el Coordinador con su resumen reciente, quién te espera, las conexiones y una tarjeta por proyecto" width="100%">
+</p>
+
+`madre` abre **Inicio**. La primera vez te acompaña en tres pasos: conectar tus agentes (una vez para todos tus proyectos), agregar tus carpetas y abrir las que vas a usar. Cada tarjeta dice si un agente trabaja, si alguien te espera y qué se decidió mientras no estabas.
+
+## Un Coordinador que ve todos tus proyectos
+
+<p align="center">
+  <img src="https://raw.githubusercontent.com/jossuealcacao-exe/madre/main/docs/media/1.0/ksp-coordinador.webp" alt="El Coordinador responde qué se decidió en dos proyectos conectados, diciendo de cuál sacó cada dato" width="100%">
+</p>
+
+El **Coordinador** vive en Inicio. Lee lo que tus proyectos aprendieron —solo de los que conectas tú— y te contesta diciendo de qué proyecto sacó cada dato. Si lo permites, lleva tareas de un proyecto a otro, hasta `#2`; lo que pide más permiso llega como propuesta que tú desbloqueas. Desde cualquier proyecto le preguntas con `/bishop`.
+
+Una **conexión** dice qué tipos de nota cruzan (decisiones, hechos, preferencias, preguntas) y hasta cuándo. Nunca tus archivos ni tus conversaciones, y se revoca cuando quieras.
+
 ## Una memoria que sobrevive a la sesión
 
-Todo lo que se dice queda indexado. Cuando la conversación pasa de la ventana de contexto, cada agente recibe de vuelta lo que hace falta, citado. Cada diez intercambios, la sala destila lo dicho en notas con tipo: una decisión, un hecho, una preferencia, una pregunta abierta.
+<p align="center">
+  <img src="https://raw.githubusercontent.com/jossuealcacao-exe/madre/main/docs/media/1.0/ksp-memoria.webp" alt="El Mapa de memoria: memorias de colores alrededor de un núcleo de magma, unidas por sus enlaces" width="100%">
+</p>
 
-Preguntas *«¿por qué elegimos Postgres?»* tres semanas después y la sala contesta, aunque esa decisión la tomara otro agente en otra sesión.
+Todo lo que se dice queda indexado. Cuando la conversación pasa de la ventana de contexto, cada agente recibe de vuelta lo que hace falta, citado. Cada diez intercambios, el proyecto destila lo dicho en notas con tipo: una decisión, un hecho, una preferencia, una pregunta abierta.
 
-Con [Ollama](https://ollama.com) corriendo, esa memoria además **habla**: `@madre` es un quinto agente, local, gratis, que responde desde todo el archivo con citas y no escribe nada.
+Preguntas *«¿por qué elegimos Postgres?»* tres semanas después y el proyecto contesta, aunque esa decisión la tomara otro agente en otra sesión.
 
-Y la puedes **ver**. En NOSTROMO el archivo es un cerebro en tres dimensiones que giras con el ratón: cada memoria es una estrella cuyo brillo dice cuánto la usa la sala y cuya superficie cuenta si la confirmaste, si nadie la ha revisado o si se está enfriando. En MEMORIA, un tablero te dice qué tan bien está contestando el archivo y qué conviene hacer después.
+Con [Ollama](https://ollama.com) corriendo, esa memoria además **habla**: `@madre` es un quinto agente, local, gratis, que responde desde todo el archivo con citas y no escribe nada. Y la puedes **ver**: el **Mapa de memoria** es un cerebro en tres dimensiones que giras con el ratón, donde cada memoria es una estrella del color de su tipo.
 
 ## Leen por defecto. Escriben cuando tú lo dices.
 
+<p align="center">
+  <img src="https://raw.githubusercontent.com/jossuealcacao-exe/madre/main/docs/media/1.0/ksp-permisos.webp" alt="El menú de modos de MADRE 1.0, de #0 Incógnito a #4 Acceso total" width="100%">
+</p>
+
 Cada mensaje sale con un modo de permiso, y tu modo es el techo de todo lo que ese mensaje arranque.
 
 | | | |
 |---|---|---|
-| `#1` | **EXCHANGE** | Leer y coordinar. El predeterminado. |
-| `#2` | **CREATE** | Añadir archivos nuevos. Lo que ya existía se restaura al terminar. |
-| `#3` | **CONTROL** | Editar el proyecto. Checkpoint antes, lista de cambios y `UNDO` después. |
-| `#4` | **AIRLOCK** | Comandos, `git push`, deploys. Pide dos llaves. |
+| `#1` | **SOLO CONVERSAR** | Leer y coordinar. El predeterminado. |
+| `#2` | **CREAR** | Añadir archivos nuevos. Lo que ya existía se restaura al terminar. |
+| `#3` | **EDITAR** | Editar el proyecto. Punto de restauración antes, lista de cambios y `DESHACER` después. |
+| `#4` | **ACCESO TOTAL** | Comandos, `git push`, deploys. Pide la llave dos veces. |
+
+También hay `#0 INCÓGNITO`, para lo que no debe quedar en ninguna parte.
 
-También hay `#0 GHOST`, para lo que no debe quedar en ninguna parte.
+Subir a `#3` o `#4` es deliberado: MADRE te pide tu llave —por defecto, el nombre de la carpeta del proyecto; en Ajustes › Permisos puedes elegir una frase tuya— y la comprueba el propio proyecto. Ningún agente puede concederse un permiso escribiéndolo en su respuesta.
+
+<p align="center">
+  <img src="https://raw.githubusercontent.com/jossuealcacao-exe/madre/main/docs/media/1.0/ksp-deshacer.webp" alt="Claude cambió tres archivos en #3 Editar y el botón Deshacer regresa el proyecto al punto de restauración" width="100%">
+</p>
 
-Subir a `#3` o `#4` es una ceremonia deliberada: MADRE te pide el nombre de la carpeta del proyecto, escrito por ti. Ningún agente puede concederse un permiso escribiéndolo en su respuesta.
+## Tu espacio, a tu medida
+
+<p align="center">
+  <img src="https://raw.githubusercontent.com/jossuealcacao-exe/madre/main/docs/media/1.0/ksp-espacio.webp" alt="La conversación a la izquierda y el editor de código al lado, en modo Editar" width="100%">
+</p>
+
+Cada panel se abre al lado o en una ventana que mueves. Varias conversaciones trabajan a la vez, el visor edita código, los servidores de tu proyecto se abren dentro de MADRE y la barra se arma con clic derecho. **Ajustes** (⌘ ,) reúne todo lo que configuras, con buscador, y **Diagnóstico** te da el remedio cuando algo falla.
 
 <br>
 
@@ -79,9 +133,9 @@ Subir a `#3` o `#4` es una ceremonia deliberada: MADRE te pide el nombre de la c
 
 ## Hazla tuya
 
-MADRE trae ocho módulos. El noveno lo escribes tú — o se lo pides a un agente.
+MADRE trae doce módulos —Ahorro de tokens, Intenciones, IA local, GitHub, Continuidad y más—, en un tablero como de apps. El siguiente lo escribes tú, o se lo pides a un agente.
 
-**Un módulo es un archivo.** Sin build, sin dependencias, sin registrarse en ningún lado. Lo copias a una carpeta, pulsas RELOAD y aparece con su interruptor, sus ajustes y su ficha. Con uno puedes añadir un comando `/loquesea` que la sala entiende, darle a los agentes una herramienta que antes no tenían, cambiar cómo se comporta la sala, o conectarla con algo que ya usas.
+**Un módulo es un archivo.** Sin build, sin dependencias, sin registrarse en ningún lado. Lo copias a una carpeta, recargas y aparece con su interruptor, sus ajustes y su ficha. Con uno puedes añadir un comando `/loquesea` que el proyecto entiende, darle a los agentes una herramienta que antes no tenían, cambiar cómo se comporta MADRE, o conectarla con algo que ya usas.
 
 **O no lo escribes tú.** En la caja de texto:
 
@@ -93,9 +147,9 @@ El agente lee el SDK, escribe el archivo, y MADRE te enseña una tarjeta para re
 
 **Conectarla con un servicio de fuera** es lo que más se pide, y la respuesta corta es *casi siempre sí*: el límite no es MADRE, es cómo ese servicio deja que entregues tu propia llave. Vale la pena cuando la consigues en menos de cinco minutos sin ser desarrollador y la puedes revocar sola — GitHub, Linear, Notion, Jira, Slack, Telegram, Stripe, Shopify, Odoo, cualquier base de datos. Donde hay muro es donde el proveedor exige revisar tu app antes de dejarte pasar: Gmail en lectura, Meta, banca.
 
-Tu módulo declara qué llave necesita y MADRE dibuja el campo; declara a dónde llega y el registro de salidas responde por él; declara qué herramientas suyas **mandan** algo, y la sala se las retira a los agentes salvo en el peldaño `#4`. Nada de eso lo programas: lo declaras.
+Tu módulo declara qué llave necesita y MADRE dibuja el campo; declara a dónde llega y el registro de salidas responde por él; declara qué herramientas suyas **mandan** algo, y el proyecto se las retira a los agentes salvo en el peldaño `#4`. Nada de eso lo programas: lo declaras.
 
-**[Escribir un módulo →](docs/SDK.md)** · con dos ejemplos completos que funcionan tal cual: [el mínimo](docs/sdk/hello-module.mjs) y [un conector](docs/sdk/connector-module.mjs).
+**[Escribir un módulo →](docs/SDK.md)** · con dos ejemplos completos que funcionan tal cual: [el mínimo](docs/sdk/hello-module.mjs) y [una integración](docs/sdk/connector-module.mjs).
 
 <br>
 
@@ -109,11 +163,11 @@ Esto importa más que cualquier función.
 
 **No hay nube.** MADRE no tiene servidor, ni cuenta, ni backend. Corre en `127.0.0.1` y se muere cuando cierras la terminal.
 
-**Tus llaves, donde hacen falta y en ningún otro lado.** Cuando das la llave de un agente, MADRE la escribe en el archivo donde ese CLI la busca, cerrada a tu usuario, y no conserva copia. Un conector no tiene CLI al que dársela, así que esa —y solo esa— la guarda MADRE, en su propia bodega de tu máquina, con permisos de solo tu usuario, aceptada únicamente desde esta computadora. Nunca en su config, ni en su registro, ni en sus logs, ni en lo que lee un agente: la ficha solo muestra que hay una guardada y cuántos caracteres tiene.
+**Tus llaves, donde hacen falta y en ningún otro lado.** Cuando das la llave de un agente, MADRE la escribe en el archivo donde ese CLI la busca, cerrada a tu usuario, y no conserva copia. Una integración no tiene CLI al que dársela, así que esa —y solo esa— la guarda MADRE, en su propia bodega de tu máquina, con permisos de solo tu usuario, aceptada únicamente desde esta computadora. Nunca en su config, ni en su registro, ni en sus logs, ni en lo que lee un agente: la ficha solo muestra que hay una guardada y cuántos caracteres tiene.
 
-**Nada sale por su cuenta.** Lo que un agente lee viaja a *su* proveedor, con tu cuenta y tus límites — como si lo hubieras corrido en tu terminal, porque eso es exactamente lo que MADRE hace. Los dos únicos envíos propios están bajo tu interruptor: una consulta diaria a npm por si hay versión nueva, y los reportes de fallos, apagados por defecto.
+**Nada sale por su cuenta.** Lo que un agente lee viaja a *su* proveedor, con tu cuenta y tus límites — como si lo hubieras corrido en tu terminal, porque eso es exactamente lo que MADRE hace. Lo que MADRE consulta por su cuenta está declarado, con lo que lo apaga: la consulta diaria de versiones nuevas (npm y GitHub), la cuota de tu plan de Claude, los embeddings e imágenes de Gemini si los activas, y los reportes de fallos, apagados por defecto. Y una vez al día, siempre, un aviso de que esta copia sigue en uso: un identificador al azar, la versión de MADRE, el sistema y la versión de Node. Sin tu nombre, tu correo, tu IP ni nada de tus proyectos; es como el autor sabe cuántas personas usan MADRE.
 
-**Y te deja leerlo.** Dentro de la sala puedes abrir el documento exacto que MADRE escribe en tu nombre cada turno, el comando exacto con el que lo entrega, y el registro de cada llamada que salió de esta máquina. No es una promesa: es una pantalla.
+**Y te deja leerlo.** Toca el núcleo del Mapa de memoria y se abre «Lo que se envía»: el documento exacto que MADRE escribe en tu nombre cada turno, el comando exacto con el que lo entrega, y el registro de cada llamada que salió de esta máquina. No es una promesa: es una pantalla.
 
 **Cero dependencias.** Node y nada más.
 
@@ -127,18 +181,24 @@ Esto importa más que cualquier función.
 
 Necesitas **Node 22.5** o superior y al menos una de estas CLIs con sesión iniciada: Codex, Claude Code, Gemini CLI u OpenCode.
 
+```
+npx @jossuealcala/madre
+```
+
+Desde cualquier carpeta, abre **Inicio** en `http://127.0.0.1:4317/salas`: todos tus proyectos en un lugar, con el Coordinador arriba. La primera vez te acompaña en tres pasos: **conectar tus agentes** (instalar y firmar cada CLI ahí mismo, una vez para todos tus proyectos), **agregar tus proyectos** (eliges las carpetas; agregarlas no las abre) y **abrir** los que vas a usar. Cada proyecto corre por su cuenta, con su propia memoria.
+
+Si prefieres entrar directo a un proyecto, como antes:
+
 ```
 cd tu-proyecto
 npx @jossuealcala/madre start
 ```
 
-La sala abre en `http://127.0.0.1:4317`. **Si no tienes ninguna CLI, ábrela igual**: lo primero que ves es el puente, con un botón para instalar y firmar cada agente ahí mismo. MADRE enseña el comando antes de correrlo y transmite cada línea a la pantalla.
-
 ```
 npx @jossuealcala/madre doctor    # qué hay instalado, quién tiene sesión
 ```
 
-La sala habla **español**. El botón `EN` la pasa a inglés.
+MADRE habla **español**. En Ajustes › Apariencia la pasas a inglés.
 
 <br>
 
@@ -157,14 +217,19 @@ Beta pública. El núcleo está probado y bajo CI en macOS y Linux con Node 22 y
 
 Una versión se cierra cuando está en npm. El detalle de cada una en [CHANGELOG.md](CHANGELOG.md); lo que viene, en el [roadmap](https://github.com/jossuealcacao-exe/madre/blob/main/docs/ROADMAP.md).
 
-Problemas: desde MU/TH/UR (`✎ FEEDBACK`) o en [issues](https://github.com/jossuealcacao-exe/madre/issues).
+Problemas: desde cada remedio de Diagnóstico («¿No se arregló?») o en [issues](https://github.com/jossuealcacao-exe/madre/issues).
 Seguridad: [SECURITY.md](SECURITY.md) · Contribuir: [CONTRIBUTING.md](CONTRIBUTING.md)
 
 MADRE es gratis y seguirá siéndolo. Si te ahorra tiempo y quieres que siga creciendo,
 puedes [apadrinarla](https://github.com/sponsors/jossuealcacao-exe). Nada del producto
 cambia según lo que hagas con ese enlace.
 
-Apache-2.0 · [Jossué Alcalá](https://jossuealcala.com/en/)
+Apache-2.0 · [Jossue Alcalá](https://jossuealcala.com/en/)
+
+El código es libre: úsalo, modifícalo y haz forks. El nombre **MADRE**, su logo y madre.run son
+marcas de Jossue Alcalá. Un fork que se distribuya conserva el archivo [`NOTICE`](NOTICE) con la línea
+«Based on MADRE by Jossue Alcalá», y si cambia el código lleva otro nombre. Qué sí y qué no:
+[TRADEMARKS.md](TRADEMARKS.md).
 
 <br>
 

package/TRADEMARKS.md

@@ -0,0 +1,65 @@
+# Marca MADRE · MADRE trademark policy
+
+**Español** · [English below](#english)
+
+El código de MADRE es libre bajo la [licencia Apache 2.0](LICENSE): puedes usarlo, estudiarlo,
+modificarlo, hacer forks y distribuirlos, también con fines comerciales. **El nombre no viene
+incluido.** «MADRE», su logo y madre.run son marcas de Jossue Alcalá, y la licencia no da
+permiso de usarlas (sección 6). Esta página dice qué sí y qué no.
+
+## Lo que siempre debe hacer un fork
+
+- **Decir de dónde viene.** Conserva el archivo [`NOTICE`](NOTICE) con la línea
+  `Based on MADRE by Jossue Alcalá — https://madre.run`. La licencia lo exige (sección 4.d).
+- **Conservar los avisos de copyright** de los archivos que vengan de MADRE (sección 4.c).
+- **Indicar que lo cambiaste** en los archivos que modifiques (sección 4.b).
+
+Te pedimos además que la frase «Basado en MADRE» aparezca donde tu proyecto diga quién lo hizo:
+el README, la pantalla «Acerca de» o el pie de página.
+
+## Lo que sí puedes hacer sin pedir permiso
+
+- Usar MADRE tal cual, con su nombre, para ti o tu equipo.
+- Redistribuir MADRE **sin modificar** con su nombre.
+- Decir con palabras que tu proyecto está «basado en MADRE», «hecho para MADRE» o «compatible con
+  MADRE», sin hacer creer que es oficial.
+- Escribir módulos para MADRE y llamarlos «módulo X para MADRE».
+- Hablar de MADRE en artículos, videos, cursos y reseñas.
+
+## Lo que necesita otro nombre
+
+- Una versión **modificada** que distribuyas: lleva un nombre y un logo propios que no se
+  confundan con MADRE (no «MADRE Pro», «MADRE+», «NeoMADRE» ni similares).
+- Un servicio, una app o un paquete que se presente como MADRE o como su versión oficial.
+- Dominios, paquetes de npm, cuentas o repositorios cuyo nombre haga creer que son de MADRE.
+- El logo de MADRE en cualquier cosa que no sea MADRE sin modificar.
+
+## Si tienes duda
+
+Escribe a Jossue Alcalá en [jossuealcala.com](https://jossuealcala.com) antes de publicar. Esta
+política puede cambiar; la versión vigente es la de este repositorio.
+
+---
+
+## English
+
+MADRE's code is free under the [Apache License 2.0](LICENSE): use it, study it, modify it, fork
+it and redistribute it, commercially too. **The name is not included.** "MADRE", its logo and
+madre.run are trademarks of Jossue Alcalá, and the License grants no permission to use them
+(Section 6).
+
+**Every fork must:** keep the [`NOTICE`](NOTICE) file with the line
+`Based on MADRE by Jossue Alcalá — https://madre.run` (required by Section 4(d)); keep the
+copyright notices of files that come from MADRE (4(c)); and mark the files it changed (4(b)). We
+also ask that "Based on MADRE" appears wherever your project says who made it.
+
+**You may, without asking:** use MADRE as is, under its name; redistribute it unmodified under
+its name; say your project is "based on MADRE", "made for MADRE" or "compatible with MADRE" without
+implying it is official; name a module "X for MADRE"; write and talk about MADRE.
+
+**Needs a different name:** any modified version you distribute (its own name and logo, nothing
+confusable such as "MADRE Pro" or "MADRE+"); anything presented as MADRE or its official
+version; domains, npm packages, accounts or repositories that look like MADRE's; the logo on
+anything that is not unmodified MADRE.
+
+In doubt, contact Jossue Alcalá at [jossuealcala.com](https://jossuealcala.com) before publishing.

package/bin/madre.mjs

@@ -1,6 +1,7 @@
 #!/usr/bin/env node
 
-import { resolve } from 'node:path';
+import { join, resolve } from 'node:path';
+import { homedir } from 'node:os';
 import { execFileSync } from 'node:child_process';
 import { readFile, stat } from 'node:fs/promises';
 import { openUrl, startPulse } from '../src/server.mjs';
@@ -10,6 +11,7 @@ import { probeAll } from '../src/auth-probe.mjs';
 import { applyConfigToEnv, loadConfig } from '../src/config.mjs';
 import { isOnline, runSetup } from '../src/setup.mjs';
 import { parseArgs } from '../src/cli-args.mjs';
+import { ensureSalasProject, isSalasRoom, projectRootFor } from '../src/salas.mjs';
 import { createServer } from 'node:net';
 
 const cli = parseArgs(process.argv.slice(2));
@@ -77,7 +79,15 @@ async function openRoom(options) {
   process.exit(2);
 }
 
-const projectRoot = resolve(option('--project', process.cwd()));
+const stateRoot = process.env.PULSE_HOME;
+// Which project this run is about (src/salas.mjs, docs/MACROVERSO.md D-S09): the one named with
+// --project; the room of Salas for `madre salas`, and for a bare `madre` from the home folder;
+// anywhere else, the folder MADRE was run from. The notebook of Salas lives under MADRE's own
+// state, `~/.pulse/salas` unless PULSE_HOME says where that state is.
+const salasHome = stateRoot ?? join(homedir(), '.pulse');
+const projectRoot = projectRootFor({ command, named: cli.named, project: option('--project', null), cwd: process.cwd(), home: homedir(), stateRoot: salasHome });
+// The lobby opens on its list of projects; a project's room on its conversation.
+const openPath = isSalasRoom(projectRoot, salasHome) ? '/salas' : '';
 const [nodeMajor, nodeMinor] = process.versions.node.split('.').map(Number);
 if (nodeMajor < 22 || (nodeMajor === 22 && nodeMinor < 5)) {
   console.error(`\n  MOTHER › MADRE needs Node 22.5 or newer (found ${process.version}): the room's memory runs on node:sqlite.\n`);
@@ -91,8 +101,10 @@ if (has('--version') || has('-v') || command === 'version') {
   console.log(`madre ${pkg.version}${commit ? ` · ${commit}` : ''} · node ${process.version}`);
   process.exit(0);
 }
-const stateRoot = process.env.PULSE_HOME;
 if (command !== 'help') {
+  // The notebook of Salas is MADRE's own folder: made here, empty, the first time it is opened
+  // (D-S08). If it cannot be made, the check below says so, as for any folder that is not there.
+  if (isSalasRoom(projectRoot, salasHome)) await ensureSalasProject(salasHome).catch((error) => console.error(`  MOTHER › could not make the folder of Salas at ${projectRoot}: ${error.message}`));
   const stats = await stat(projectRoot).catch(() => null);
   if (!stats?.isDirectory()) {
     console.error(`\n  MOTHER › project folder not found: ${projectRoot}\n  Pass an existing directory with --project, or run MADRE from inside the project.\n`);
@@ -107,7 +119,7 @@ if (command === 'doctor' && (has('--catalog') || has('--conditions'))) {
   const query = option('--catalog', '') || option('--conditions', '') || '';
   const platform = PLATFORMS[process.platform] ? process.platform : 'linux';
   const list = query && !query.startsWith('--') ? searchConditions(query) : CONDITIONS;
-  console.log(`\nMU/TH/UR · KNOWN CONDITIONS · ${list.length} OF ${CONDITIONS.length} · ${PLATFORMS[platform].label.toUpperCase()} / ${PLATFORMS[platform].shell.toUpperCase()}\n`);
+  console.log(`\nDIAGNOSTICS · KNOWN CONDITIONS · ${list.length} OF ${CONDITIONS.length} · ${PLATFORMS[platform].label.toUpperCase()} / ${PLATFORMS[platform].shell.toUpperCase()}\n`);
   for (const condition of list) {
     console.log(`▌ ${condition.title}`);
     console.log(`  ${condition.id} · ${condition.severity}${condition.agent ? ` · @${condition.agent}` : ''}`);
@@ -178,11 +190,13 @@ if (command === 'doctor' && (has('--catalog') || has('--conditions'))) {
 } else if (command === 'setup') {
   const { action, online } = await runSetup({ projectRoot, stateRoot });
   if (action === 'start') {
-    await openRoom({ port: Number(option('--port', '4317')), projectRoot, openBrowser: !has('--no-open') });
+    await openRoom({ port: Number(option('--port', '4317')), projectRoot, openBrowser: !has('--no-open'), openPath });
   } else {
     process.exitCode = action === 'report' && !online ? 1 : 0;
   }
-} else if (command === 'start') {
+} else if (command === 'start' || command === 'salas' || command === 'lobby') {
+  // `madre salas` is `madre start` on the notebook of Salas (projectRoot, above): the same look
+  // for a room already open, the same walk up the ports, the same browser unless --no-open.
   const port = Number(option('--port', '4317'));
   const noOpen = has('--no-open');
   // First contact happens in the room, not here: MADRE opens even with nobody online and the
@@ -195,20 +209,26 @@ if (command === 'doctor' && (has('--catalog') || has('--conditions'))) {
   // A room for this project may already be open. Show that one instead of starting a second.
   const running = await roomAlreadyOpen(port, projectRoot);
   if (running) {
-    console.log(`\nMADRE is already open for this project\n\n  ${running.url}\n  Project: ${projectRoot}\n  Close that room first if you want a fresh one.\n`);
-    if (!noOpen) openUrl(running.url);
+    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`);
+    if (!noOpen) openUrl(`${running.url}${openPath}`);
     process.exit(0);
   }
-  await openRoom({ port, projectRoot, openBrowser: !noOpen });
+  await openRoom({ port, projectRoot, openBrowser: !noOpen, openPath });
 } else if (command === 'help') {
   console.log(`MADRE
 
+  madre       [--port 4317] [--no-open]
+              Opens Home: every project on this computer, in one place.
   madre start [--project PATH] [--port 4317] [--no-open] [--setup]
+              Opens the project in this folder (or PATH) directly.
               Without --port, a busy 4317 falls through to the next free port.
+  madre lobby [--port 4317] [--no-open]   (also: madre salas; opens Home)
   madre setup [--project PATH] [--port 4317] [--no-open]
   madre doctor [--project PATH] [--json]
 
-  start   Opens the project room. With nobody online, runs setup first.
+  (none)  Opens Home. From there you add projects, connect the agents
+          and enter any project. The Coordinator lives there.
+  start   Opens the project in this folder. From your home folder, Home.
   setup   Detects the agents on this computer, shows who has a session,
           and runs each agent's own sign-in from here.
   doctor  Prints the same diagnosis without the wizard.

package/docs/INTERNALS.md

@@ -82,7 +82,7 @@ Los alcances de imagen de Claude, Gemini y OpenCode se cumplen con **Image Studi
 
 Un turno en `#2` toma la misma fotografía que CONTROL, sin asiento: varios turnos `#2` pueden correr a la vez. Al terminar, `diff` contra la fotografía: los archivos añadidos se conservan y se registran como `artifacts.created` con su ruta en el proyecto; los modificados, renombrados o borrados se restauran desde la fotografía y se anuncian en `create.reverted`. Las zonas prohibidas se restauran igual que en CONTROL. Cada CLI recibe sus herramientas de escritura sobre el proyecto: Claude Code niega `Write` si `Edit` no está permitido en la misma ruta y OpenCode deja sin herramienta de escritura si `edit` está denegado (ambos verificados con el CLI real), así que en `#2` van juntas y la garantía de "solo añadir" es la restauración posterior, no la regla previa. Gemini recibe solo `write_file`. El `scratchDir` bajo `.pulse/out/` sigue existiendo para lo que no tiene sitio y para Image Studio.
 
-En un plan, el modo de cada paso es el mínimo entre lo que pidió el orquestador (`@agente #n:`), el techo del plan (el modo del mensaje humano) y el `MAX MODE` del agente. Bajo techo `#3`, un paso `#2` recibe un lease de proyecto emitido a nombre del orquestador y un paso `#3` toma CONTROL con su propio checkpoint, uno a la vez. Bajo techo `#1`, un paso `#2` pasa por la escalación al humano.
+En un plan, el modo de cada paso es el mínimo entre lo que pidió el orquestador (`@agente #n:`; sin número, `#1`, o `#2` si hay lease), el techo del plan (el modo del mensaje humano) y el `MAX MODE` del agente. `#4` nunca llega a un delegado por el techo: solo con la llave de ese agente. Bajo techo `#3`, un paso `#2` recibe un lease de proyecto emitido a nombre del orquestador y un paso `#3` toma CONTROL con su propio checkpoint, uno a la vez. Bajo techo `#1`, un paso `#2` pasa por la escalación al humano. Un paso `#3` o `#4` que supera el techo pide la llave al humano para ese agente; concederla para el plan no eleva el techo de los demás.
 
 ## CONTROL por dentro
 
@@ -90,7 +90,7 @@ Antes del turno, MADRE fotografía el proyecto como un commit real bajo `refs/ma
 
 ## Recuperación operativa
 
-Si MADRE se detiene a mitad de un turno, al arrancar detecta los `agent.started` sin cierre y registra un `message.failed` recuperado para cada uno. Al cerrar con Ctrl+C o `SIGTERM`, interrumpe los procesos de agente en curso, registra esos turnos como fallidos, entrega los eventos pendientes a las páginas abiertas y termina. Los planes se ejecutan en secuencia y los delegados no delegan, así que todo plan termina; `STOPALL` corta cualquier cosa en curso.
+Si MADRE se detiene a mitad de un turno, al arrancar detecta los `agent.started` sin cierre y registra un `message.failed` recuperado para cada uno. Al cerrar con Ctrl+C o `SIGTERM`, interrumpe los procesos de agente en curso, registra esos turnos como fallidos, entrega los eventos pendientes a las páginas abiertas y termina. Los planes se ejecutan en secuencia y los delegados no delegan. El orquestador revisa las respuestas y puede abrir otro tramo, hasta tres por petición; `STOPALL` corta cualquier cosa en curso.
 
 ## Empaquetado y pruebas